mirror of
https://gitcode.com/JianFeeeee/homeagent-sdk.git
synced 2026-10-31 06:17:25 +00:00
61a871cf88
## 用户要的两件事 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，不回显具体状态 —— 那是该接口的 特性，不是设置失败。