NekoGraph

A LangGraph-native QQ Agent Framework powered by NapCat and OneBot v11.

已实现

• OneBot v11 反向 WebSocket、数组/CQ 消息段与类型化内部模型
• Message、Message Sent、Notice、Request、Meta 全事件接收及未知扩展兼容
• 私聊、群聊唤醒及 Conversation 隔离
• LangGraph 多轮对话与 SQLite Checkpoint
• 命令路由、Tool Registry、风险审批与 Interrupt/Resume
• 本地终端聊天和 Vue 3 + FastAPI 管理界面
• OpenAI-compatible 多模型配置、导入与热切换
• SQLite 持久化定时任务（Cron、间隔、单次）、执行历史与 Dashboard 管理
• 统一 OneBot 主动发送、查询与群管理动作，支持连接复用、限流和 SQLite 审计
• B站 UP 主动态/直播监测、按群订阅、去重重试和投递记录（BiliWatch）

本地部署

需要 Python 3.12 和 uv。

git clone https://github.com/j1udu/NekoGraph.git
cd NekoGraph
uv sync
uv run nekograph dashboard

管理界面默认地址：http://127.0.0.1:5190

可在管理界面的“模型”页面添加 OpenAI-compatible 模型；未配置时使用 Fake Model。

B站推送在管理界面的“B站推送”页面配置管理员、B站 Cookie、轮询间隔和 QQ 群订阅。后台轮询不调用 LLM；需要 B 站登录 Cookie 才能稳定读取动态接口。

需要同时运行 OneBot Gateway、Dashboard 和定时任务时：

uv run nekograph serve

其他启动方式：

uv run nekograph chat     # 本地终端对话
uv run nekograph gateway  # OneBot Gateway，默认端口 8080