Home

OFbot 2

可扩展的插件化 QQ 机器人框架：多协议多账号并存（OneBot v11/v12、Red、Satori、Mirai、QQ 官方机器人），逐群/私聊独立控制功能开关，配套 FastAPI Web 管理后台、异步 SQLite 与自研异步事件总线。

• 要求 Python >= 3.11；默认面向本地/私域部署，公网部署请阅读 Security 的安全建议。
• 仓库入口：GitHub 仓库 · README · Issues · Releases

界面预览

登录	仪表盘	连接中心

监听环境	插件市场	流程引擎

功能特性

• 多连接接入：一个实例同时接入 NapCat / LLOneBot / Lagrange / Chronocat / Mirai / 官方机器人，连接独立启停、按群绑定账号路由出站消息。
• 监听环境：每个群、私聊独立控制插件功能开关、权限覆盖、黑名单与静默模式（Web「监听环境」页三态开关矩阵）。
• 声明式插件：命令 / 定时任务 / 监听器在 plugin.json 中声明，加载自动注册与校验；插件只提供功能，开关由主用户控制。
• 参数与子命令：命令可声明类型化参数（必填/默认/可选值）与子命令（分段命令），解析错误自动给出用法提示。
• Web 后台：仪表盘、连接中心、插件管理、定时任务、流程引擎、AI 能力、记录/状态机/聚合、导出/文件/备份、审计/监控/自愈。
• 统一 AI：OpenAI 兼容（OpenAI/DeepSeek/Qwen/Moonshot/Azure）、Anthropic、Gemini、Ollama，多 Provider 切换与降级。
• 自动化流程引擎：消息/定时/Webhook/记录变更触发，动作可组合（发消息、执行命令、调 AI、写记录、导出）。
• 插件市场：内置官方插件 26 个，支持 URL / 本地双数据源，Web 或 CLI 一键安装。
• 可观测与安全：结构化日志、Prometheus 指标、审计日志、登录锁定与 CSRF、命令冷却与三级限流、异常脱敏、插件安装静态审计与可选子进程沙箱。
• 复杂插件开发：权限角色映射（permission_roles）、命令冲突自动命名空间解决（plugin conflicts）、配置模板化定时任务、config_schema 强校验、records 过滤、rest 参数、handler ctx 注入、文本转图与群文件上传。
• 插件测试工具：FakeBotHarness 假 Chronocat + 真实机器人子进程端到端夹具（plugin e2e）。
• 工程与发布：一键发版（scripts/release.py）、版本一致性门禁（CI 每次 push 校验）、插件市场制品审计（scripts/audit_plugin_repo.py），保证版本、市场与文档同步。

快速上手

Quick-Start — 3 分钟让机器人跑起来并服务你的群

Installation — pip / Git 克隆 / Docker 三种安装方式

Connections — QQ 接入方案总览与能力矩阵

install.bat
start_bot.bat

默认 Web 后台：http://127.0.0.1:8080 ；默认账户 admin / admin，首次启动后请立即修改。

Wiki 文档导航

页面	说明
Quick-Start	3 分钟上手：连接 → 插件 → 功能开关
Installation	三种安装方式与验证
Connections	QQ 协议矩阵、接入步骤、账号绑定
Plugin-Development	从零写第一个插件（教程）
Plugin-Manifest	plugin.json 全字段参考与校验错误对照
Architecture	架构分层、消息流、作用域判定、插件生命周期
FAQ	常见问题与运维排查
Troubleshooting	按症状排查指南
Security	安全说明、漏洞报告与部署清单
Glossary	术语表
Contributing	贡献指南、提交规范、插件投稿
Release-Process	发版闭环、版本一致性门禁与市场同步

仓库内完整文档（更细粒度）见 docs/ 目录。

版本线

当前版本：v1.6.0（Latest Release）。

版本	主题
v1.6.0	发版自动化与插件市场审计（当前）
v1.5.0	发布闭环与质量修复
v1.4.0	复杂插件开发体验（OFbot 重写问题修复）
v1.3.x	插件子进程沙箱、审计加固、文档专业化
v1.2.0	插件审计加固 + Web E2E
v1.1.0	自研事件总线替换 bubus
v1.0.x	首个正式发布及审查修复（1.0.0 → 1.0.8）

详见 Releases 与 CHANGELOG。

License

本项目基于 MIT 开源，详见 LICENSE。