docs: 更新性能优化文档并修复命令管理器帮助输出
更新性能优化相关文档,详细说明 Python 3.14 JIT 编译器的使用方法和原理,补充与 Mypyc 的互补策略。同时修复命令管理器中帮助信息的输出方式,移除图片发送仅保留文本输出。 调整部署文档结构,明确两种性能优化方案(AOT 和 JIT)的配置方法和适用场景。完善架构文档中关于 JIT 的原理和启用方式说明。
This commit is contained in:
@@ -24,7 +24,10 @@ pip install -r requirements.txt
|
||||
|
||||
### c. 编译核心模块 (可选,但为获得最佳性能强烈建议)
|
||||
|
||||
为了最大化性能,你可以将项目中的核心 Python 模块编译成 C 语言扩展。这将大幅提升机器人的响应速度和处理效率。
|
||||
为了最大化性能,我们提供了两层级性能优化方案:
|
||||
|
||||
#### 1. Mypyc 编译 (AOT - Ahead-of-Time)
|
||||
将核心 Python 模块编译成 C 语言扩展。这将大幅提升机器人的响应速度和处理效率。
|
||||
|
||||
```bash
|
||||
# 确保你在虚拟环境中
|
||||
@@ -35,6 +38,16 @@ python setup_mypyc.py
|
||||
|
||||
> **注意**: 编译产物是平台相关的(例如,在 Windows 上编译的 `.pyd` 文件不能在 Linux 上使用)。因此,**请务必在你最终部署的服务器环境(例如 Linux)上执行此编译步骤**。更多关于 Mypyc 编译的细节,请参考 [性能优化详解](core-concepts/performance.md)。
|
||||
|
||||
#### 2. Python 3.14 JIT (Just-In-Time)
|
||||
即使不编译核心模块,你也可以通过启用 Python 3.14 自带的 JIT 编译器来获得性能提升。JIT 会在运行时将热点代码编译为机器码。
|
||||
|
||||
**如何启用**: 在启动命令中添加 `-X jit` 参数,或者在下面的 pm2 配置中添加 JIT 参数。
|
||||
|
||||
**性能策略**:
|
||||
- **AOT (Mypyc)**: 负责静态、类型明确的核心模块(WebSocket、管理器、工具函数)
|
||||
- **JIT**: 负责动态、灵活的插件代码(B站解析、代码沙箱等业务逻辑)
|
||||
- **两者结合**: 可获得最佳性能,全面覆盖所有代码路径
|
||||
|
||||
## 2. 使用进程管理器
|
||||
|
||||
你想直接 `python main.py` 然后关掉 SSH?那机器人也跟着停了。必须用进程管理器来守护它。
|
||||
@@ -58,6 +71,7 @@ module.exports = {
|
||||
name : "neobot",
|
||||
script : "main.py",
|
||||
interpreter: "/path/to/your/bot/venv/bin/python", // 指定虚拟环境里的 python
|
||||
args: "-X jit", // 启用 Python 3.14 JIT 编译器
|
||||
max_memory_restart: "500M", // 内存超过 500M 自动重启
|
||||
env: {
|
||||
"PYTHONUNBUFFERED": "1" // 禁用 python 输出缓冲,日志能实时看
|
||||
|
||||
Reference in New Issue
Block a user