|
|
61a871cf88
|
feat(qq): 在线状态随内核阶段自动切换 + 手动设置工具
## 用户要的两件事
1. 「在不同内核工作阶段自动切换 QQ 状态，比如 toolcall 阶段切忙碌中、
生成文字阶段切思考中」
2. 失败不阻塞、不重试、只写日志（完全非致命错误）
## 取值以 NapCat 源码为准（不是我猜的）
我最初拿 `status=11` 试探，NapCat 返回 retcode=0 **但那是无效状态**
（它不校验）。拉了源码 `SetOnlineStatus.ts` 的 actionDescription 才拿到
权威取值表：
在线 status=10 ext=0 忙碌 status=50 ext=0
离开 status=30 ext=0 请勿打扰 status=70 ext=0
隐身 status=40 ext=0 搬砖中 status=10 ext=2023
学习中 status=10 ext=1018 听歌中 status=10 ext=1028
## 阶段映射
StageBeforeToolcall → 搬砖中（status=10, ext=2023）
StageBeforeOutput → 学习中（status=10, ext=1018）★ QQ 无"思考中"预置项
StageAfterOutput → 在线 （status=10, ext=0）
`after_toolcall` 不切：工具刚结束还要继续，频繁切换只会闪。
## 失败处理（用户明确要求的设计）
三个钩子**永远 return nil**，不重试：
· 不返回 error ⇒ 内核不会因状态失败而中断工具调用或改写回复
· 不重试 ⇒ NapCat 掉线时不会每轮打 HTTP + 打日志
· 失败只在 applyStatus 记日志（首次 + 每 10 次），不刷屏
## 其它
· 默认**关闭**（`status_auto`）：改 QQ 状态对外可见，属于"内核替用户
做决定"，与 offload 同类的显式特权。
· 手动工具两个：`qq_set_status`（预置状态，收中英文名）、
`qq_set_diy_status`（自定义 face_id + wording）。
· 防抖：同状态跳过、最短间隔 2s —— stage 每轮都触发，不防抖会打满 NapCat。
· `Stop()` 里恢复在线：否则停机时停在"搬砖中"，用户看到一个永久错位
且不知道是谁改的状态。★ 恢复判据用**实际应用过什么**（applied），
不能用 status_auto —— 手动工具设的状态在开关关闭时也要能恢复。
## 判据（5 条，变异 2/2 咬）
· 指向必拒绝的地址时三个钩子仍返回 nil（不阻塞）
· 开关关闭时完全不发请求
· 状态名归一化（含中文别名）
· 阶段映射用**权威取值**（忙碌必须是 50，不是 11）
· 未知状态名被拒且不发请求
## 实机验证（生产 NapCat 192.168.2.106:25570）
qq_set_status busy → map[ext_status:0 status:忙碌 status_num:50]
qq_set_status working → map[ext_status:2023 status:搬砖中 status_num:10]
qq_set_status online → map[ext_status:0 status:在线 status_num:10]
qq_set_status 乱写的 → 未知状态名: 乱写的（拒绝，未发请求）
注：`get_status` 只返回 online/good，不回显具体状态 —— 那是该接口的
特性，不是设置失败。
|
2026-10-18 14:34:17 +08:00 |
|
