# MaiBot Adapter 插件

这个插件现在已经改成对接 `MaiBot 官方 API Server`，不再依赖 `WebUI 聊天页` 那套 token + ws-token + `/api/webui/ws` 流程。

## 当前能力

1. 默认把 abot 收到的群聊/私聊消息旁路发送给 MaiBot，作为上下文与记忆输入。
2. 默认不阻断其它插件链路，`ai_auto_response`、`Dify`、命令插件仍可继续照常处理。
3. 是否真的把 MaiBot 的回复发回微信，由 `enable_reply_output`、`reply_group_messages`、`reply_private_messages` 以及群功能开关共同控制。
4. 使用官方 API Server 协议：
   - WebSocket 握手头：`x-uuid` / `x-apikey` / `x-platform`
   - 消息包类型：`sys_std`
   - 负载结构：`APIMessageBase`
5. 支持把图片、语音、视频、位置、应用消息转换成文本占位符发给 MaiBot，方便它做长期上下文理解。

## 推荐定位

这套插件更适合做两件事：

1. 让 MaiBot 成为 `ai_auto_response` 之外的一条“长期对话与记忆”能力链路。
2. 先把全量消息采集给 MaiBot，等效果稳定后，再逐步提高它的主动参与度。

## 配置重点

见 `config.toml`：

1. `api_server_ws_url`
   - 例如 `ws://192.168.2.240:18009/ws`
2. `api_key`
   - 用于官方 API Server 路由
3. `enable_reply_output`
   - 控制“MaiBot 能不能实际开口说话”
4. `respect_group_feature_switch`
   - 控制群里是否还要继续受 abot 功能权限开关约束

## 现阶段建议

如果你打算逐步替代 `ai_auto_response`，建议按这个顺序推进：

1. 先保持 `collect_group_messages=true`、`enable_reply_output=false`，只观察 MaiBot 记忆与理解效果。
2. 然后打开 `enable_reply_output=true`，但先让少量测试群开启 `MAIBOT_CHAT` 功能权限。
3. 确认稳定后，再决定是让 MaiBot 成为独立对话插件，还是进一步吸收进 `ai_auto_response` 主流程。

## Dashboard / WebUI

当前远端 `192.168.2.240` 已经补好官方 dashboard 静态资源，访问地址如下：

1. WebUI 首页：`http://192.168.2.240:18001/`
2. 健康检查：`http://192.168.2.240:18001/api/webui/health`
3. 官方 API Server WebSocket：`ws://192.168.2.240:18009/ws`