新增 MaiBot 对话适配插件并补充 192.168.2.240 部署说明

2026-04-29 09:04:09 +08:00
parent ec29bc7551
commit d22e380c4e
5 changed files with 712 additions and 0 deletions
@@ -0,0 +1,35 @@
+# MaiBot Adapter 插件
+
+这个插件用于把外部独立部署的 `MaiBot WebUI` 对接到 `abot` 的插件体系里。
+
+## 当前能力
+
+1. 支持命令触发：
+   - `麦麦 你好`
+   - `maibot 你是谁`
+2. 支持群聊里 `@机器人` 后把文本转发给 MaiBot。
+3. 插件内部会自动执行：
+   - `POST /api/webui/auth/verify`
+   - `GET /api/webui/ws-token`
+   - `WS /ws?token=...`
+4. 每次消息会走一个独立的 WebSocket 逻辑会话，并等待 `bot_message` 事件作为最终回复。
+
+## 配置说明
+
+见 `config.toml`：
+
+1. `server_url`
+   - MaiBot WebUI 地址，例如 `http://192.168.2.240:8001`
+2. `access_token`
+   - MaiBot WebUI 登录 token
+3. `session_scope`
+   - `room`：同群共享语境
+   - `sender`：同群内每个用户独立语境
+
+## 部署建议
+
+如果你后面要让 `ai_auto_response` 也改走 MaiBot，建议顺序如下：
+
+1. 先用这个插件验证 MaiBot 对话质量与延迟。
+2. 确认稳定后，再把 `ai_auto_response` 的“决策/生成”改成调用同一套桥接逻辑。
+3. 最后再决定是否完全下线 `ai_auto_response` 原本的 LLM 直连链路。