K2cr2O1
24af862924
refactor(browser_manager): 实现页面池机制以提升性能 refactor(image_manager): 添加模板缓存并集成页面池 refactor(bili_parser): 迁移到异步HTTP请求并实现会话复用 docs: 新增性能优化、架构设计和最佳实践文档 chore: 更新requirements.txt添加新依赖
2.0 KiB
2.0 KiB
快速上手
这篇文档教你怎么把 NEO Bot 跑起来。如果你连这都搞不定，建议先去补补 Python 基础。
1. 环境准备
别拿老古董环境来跑新代码，我们用的是最新的技术栈。
-
Python: 必须
3.14或更高。- 推荐开启 JIT (
-X jit)。 - 别问为什么不用 3.8，问就是慢。
- 推荐开启 JIT (
-
Git: 拉代码用的，这都要教？
-
Redis: 必须装。
- Windows 用户自己想办法 (WSL2 或者 Memurai)。
- Linux/macOS 用户直接包管理器装。
- 没 Redis 跑不起来，别试了。
-
OneBot v11 客户端: 机器人本体。
- 强烈推荐: NapCatQQ
- 别用那些几百年不更新的协议端，出了问题别找我。
2. 安装步骤
拉代码
git clone [项目仓库地址]
cd [项目目录]
搞个虚拟环境
别把系统环境搞脏了，这是基本礼貌。
# 创建
python -m venv venv
# 激活 (Windows)
.\venv\Scripts\activate
# 激活 (Linux/macOS)
source venv/bin/activate
装依赖
pip install -r requirements.txt
装浏览器内核
我们用了 Playwright 做渲染，所以得装个 Chromium。
playwright install chromium
编译核心 (可选，但推荐)
想体验极致速度？把核心模块编译成 C 扩展。
python setup_mypyc.py build_ext --inplace
注：Windows 上需要 Visual Studio Build Tools，Linux 上需要 GCC。编译失败就跳过，反正 JIT 也够快了。
3. 配置
去根目录找 config.toml。
[napcat_ws]
# 你的 OneBot 地址
# 我们用的是正向连接，也就是 Bot 主动去连 OneBot
uri = "ws://127.0.0.1:3001"
token = ""
[redis]
host = "127.0.0.1"
port = 6379
db = 0
4. 启动
一切就绪，起飞。
# 开启 JIT 模式启动
python -X jit main.py
看到 连接成功！ 就说明跑通了。如果报错，先看日志，别上来就问。