Files

K2cr2O1 d458413e4b feat: 添加状态监控插件和Redis原子操作支持

- 新增 `/status` 指令，展示机器人运行状态和系统指标
- 实现Redis Lua脚本支持原子化计数器操作
- 添加消息收发统计功能
- 完善文档，包括插件开发和性能优化指南
- 重构WebSocket连接池，增加健康检查机制
- 移除旧版编译脚本，优化项目结构

2026-01-23 15:54:45 +08:00

2.1 KiB

Raw Blame History

快速上手

runit

1. 你需要准备

Python 3.14: 必须是这个版本别问我为什么。。。
Git: 拉取代码
Redis: 装一个
脑子和手: 这个最重要，或者你去问问镀铬酸钾，会给你一对一教学的。。。
OneBot v11 客户端: 机器人本体，推荐用 NapCatQQ

2. 搭起来

a. 克隆代码

找个你喜欢的地方，把代码从 GitHub 上clone下来

git clone [项目仓库地址]
cd [项目目录]

b. 创建虚拟环境

别把你的系统环境搞得乱七八糟

# Windows
python -m venv venv
.\venv\Scripts\activate

# Linux / macOS
python3.14 -m venv venv
source venv/bin/activate

看到命令行前面多了个 (venv)，就说明你进来了。

c. 安装依赖

pip install -r requirements.txt

这个文件里包含了所有需要的 Python 库，比如 aiohttp (HTTP 请求), orjson (JSON 解析), jinja2 (模板渲染), psutil (系统监控) 等等。

d. 安装 Playwright 依赖

我们用 Playwright 来截图画画，它需要一个浏览器核心。

playwright install chromium

e. 编译核心 (可选，但强烈建议)

想让你的代码更快？把它的核心代码编译成 C。

python setup_mypyc.py build_ext --inplace

注：Windows 上可能需要装个 Visual Studio Build Tools，Linux 上需要 GCC。编译失败也别慌，跳过就行，JIT 也能保证不错的速度

3. 第一次

a. 修改配置

去根目录找 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

把 uri 改成你自己的 OneBot 地址。

b. 启动！

一切就绪

# 推荐开启 JIT 模式启动
python -X jit main.py

如果你看到日志刷出来，最后显示 “连接成功！”，恭喜，你成功了！

现在，试着给你的机器人发个 /help看看会返回什么东西

2.1 KiB Raw Blame History Unescape Escape