# v6.3.18 QQ开放平台机器人版

## 改动范围

本版本只替换 v6.3.18 新增的「QQ群管理」实现。原 QQ频道账号、Token、频道同步、发布任务与热更新逻辑不改。

## QQ群管理架构

- 登录方式：QQ开放平台机器人 AppID + AppSecret。
- 鉴权：自动获取并缓存 AccessToken，过期前自动刷新。
- 事件：WebSocket 订阅 GROUP_AND_C2C_EVENT，用 GROUP_ADD_ROBOT / GROUP_DEL_ROBOT 维护群关系。
- 群标识：使用 group_openid，不使用个人 QQ 群号登录协议。
- 发送：通过官方 `/v2/groups/{group_openid}/messages` 发送文本消息。
- 定时：支持一次性和每日固定时间，并记录成功/失败、消息ID与 TraceID。
- 历史群补录：机器人已经在某个群但软件没有收到历史加群事件时，可在页面用「添加群OpenID」补录。

## 完全隔离

QQ群机器人数据使用独立 SQLite：

`data/qq_bot_manager.db`

包含：

- `qq_bot_accounts`
- `qq_bot_groups`
- `qq_bot_plans`
- `qq_bot_send_logs`
- `qq_bot_event_logs`

不会读写 QQ频道系统的 `data/local_manager.db` 中的账号、频道 Token、频道表或频道发布任务。

## 已移除的 NapCat 功能

- 不再安装 NapCat。
- 不再扫码登录个人 QQ。
- 不再启动 QQNT / NapCat Shell。
- 不再使用 OneBot HTTP。
- 不再创建或读取 `onebot11_*.json`。

旧的 NapCat 数据不会迁移进机器人数据库，也不会影响频道系统。

## 使用流程

1. 在 QQ开放平台创建机器人，并启用 QQ群场景。
2. 在「QQ群管理」点击「添加机器人」。
3. 填写 AppID / AppSecret，选择正式或沙箱环境。
4. 验证成功后保持软件运行，事件连接显示在线。
5. 在 QQ 客户端把机器人添加到群；软件收到 GROUP_ADD_ROBOT 后自动登记群。
6. 选择群后可立即发送或建立定时消息。

正式环境若启用了平台 IP 白名单，需要把运行本软件的公网 IP 加入机器人白名单。
