Files
NeoBot/docs/core-concepts/performance.md
K2cr2O1 7f331970dd docs: 更新文档内容,简化语言并修正格式
- 简化插件开发指南中的描述,移除冗余内容
- 调整部署文档中的Python版本说明
- 优化最佳实践文档的措辞和格式
- 更新性能优化文档,删除不准确的数据
- 重构核心概念文档,使用更简洁的语言
- 修正README中的项目描述和技术栈说明
- 更新快速上手文档,简化安装步骤
- 调整事件流转文档的描述方式
- 简化架构文档内容
- 更新指令处理文档,添加参数注入示例
- 优化单例管理器文档的表述
2026-01-13 04:49:03 +08:00

2.2 KiB
Raw Blame History

性能优化详解

NEO Bot 实际上是python有人说用Java可能更好。。。嗯但是镀铬酸钾不会Java镀铬酸钾只会python所以只能用python了

1. Playwright 页面池 (Page Pool)

痛点

之前 Bot 发图流程:

  1. 用户发指令。
  2. Bot 启动浏览器。
  3. 创建新页面。。
  4. 渲染,截图。
  5. 关闭浏览器。

这种模式下,发一张图至少要等 1 秒以上。。。

解决方案

BrowserManager 维护了一个页面池

  • 启动时: 自动预热 3 个页面(可配置),挂在后台待命。
  • 运行时: 需要截图时,直接从池里 get_page()
  • 结束后: 截图完成,页面执行 about:blank 洗白,然后 release_page() 放回池里。

收益

我不知道快了多少,也没人测试,嗯

2. Jinja2 模板缓存

痛点

每次渲染 HTML都要从硬盘读文件然后解析模板语法。硬盘 IO 是慢的,解析也是慢的。

解决方案

ImageManager 引入了内存缓存 _template_cache

  • 第一次读取模板后,编译好的 Template 对象直接存入字典。
  • 后续请求直接从内存拿对象渲染。

收益

省了硬盘IO

3. 全局 HTTP 连接复用

痛点

插件(如 B站解析每次请求 API 都创建一个新的 aiohttp.ClientSession。 这意味着每次都要进行DNS 解析 -> TCP 握手 -> SSL 握手。这在 HTTPS 下非常慢。

解决方案

我们在插件层面实现了 get_session()

  • 全局共享一个 ClientSession
  • 复用底层的 TCP 连接 (Keep-Alive)。

收益

实际上我也不知道bot没高并发的实验。。。

4. orjson 极速序列化

痛点

Python 自带的 json 库性能好像不太好,特别是在处理 OneBot 这种大量 JSON 通信的场景下。

解决方案

全面替换为 orjson

  • Rust 编写
  • 支持直接返回 bytes,减少内存复制。

5. Mypyc 编译

痛点

Python太慢了。。。

解决方案

利用 setup_mypyc.py 将核心模块编译为 C 扩展。

  • core/ws.py: WebSocket 消息处理循环。
  • core/managers/*.py: 事件分发逻辑。

这些高频调用的代码变成了机器码