QQ 审批转发 creamSGit/dsh-approval-qq

dsh-approval-qq

把 DeepSeek Harness 的审批弹窗搬到 QQ。 模型要提权执行命令时，你的手机会收到一条私聊消息：看清命令和理由，回一句「同意」就放行；电脑端的弹窗同时存在，谁先点谁生效。

- 独立插件：不依赖任何 QQ 机器人插件，直接对接 OneBot v11（NapCat / Lagrange / LLOneBot…）；
- 零运行时依赖：只用 Node 内置 fetch / WebSocket（Node ≥ 22）；
- 只认你配置的管理员 QQ，其他人回复一律忽略；
- QQ 不可用时自动退回电脑端弹窗，绝不挂住请求。

它长什么样

【审批 #4c5f89】需要你点头才能继续

我要做什么：执行一条 PowerShell 命令在哪个目录：D:\work\demo 为什么要你同意：要临时把沙箱提到「完全访问（可以修改系统任何位置）」，DSH 规定提权必须本人确认。
理由：需要读取工作区外的配置文件

命令（原样）： Get-Content "C:\ProgramData\app\config.json"

时间：2026-10-26 19:38:04 周一回复「同意」或「拒绝」即可（多条时默认处理最新一条；要指定也可加编号）

回复规则：

| 情况 | 回复 |
| 只有一条待审批 | 「同意」或「拒绝」 |
| 同时挂着多条 | 「同意」默认处理最新一条，回执会说明还剩哪几条 |
| 想指定某条 | 「同意 ab12cd」（编号 = 标题里的 #ab12cd） |

安装

从 npm（若已发布）

dsh plugin add dsh-approval-qq

从 GitHub

dsh plugin add github:<你的用户名>/dsh-approval-qq

本地包

dsh plugin add file:C:\path\to\dsh-approval-qq

装完 重启一次 DSH，然后到 设置 → 插件 → dsh-approval-qq 填配置。

配置

| 字段 | 默认 | 说明 |
| adminQq | 0 | 必填。审批人 QQ 号。不填则插件不生效（审批只在电脑端）。 |
| onebotHttpUrl | http://127.0.0.1:3000 | OneBot v11 HTTP API 地址，用于发消息 / 撤回。 |
| onebotHttpToken | 空 | HTTP API 的 access_token。 |
| onebotWsUrl | ws://127.0.0.1:3001 | 正向 WebSocket 地址，用于接收你的回复。 |
| onebotWsToken | 空 | WebSocket 的 access_token（会拼成 ?access_token=）。 |
| idLength | 6 | 审批编号长度（4~8）。 |
| showFullCommand | true | false 时命令只贴前 800 字。 |
| notifyUnauthorized | true | 别人回「同意」时是否私聊回一句「无权限」。 |
| logFile | 空 | 留空 = ~/.dsh/approval-qq/approval.log。 |

NapCat 的 HTTP 与 WS 通常不在同一个端口：HTTP 默认 3000，反向/正向 WS 默认 3001，以你自己的 NapCat 配置为准。WS 没连上时插件会跳过 QQ、直接走电脑端——不会出现「消息发出去了但没人能回复」的悬挂。

它是怎么工作的

DSH 触发 approval/request（policy=ask） ├─ 本插件：发 QQ 私聊（短 id + 人话理由 + 命令原文） └─ next()：交给组合里的下一个 answerer（通常是电脑端弹窗）

两者 Promise.race： QQ 先决定 → 返回真实 outcome，并撤回 QQ 消息电脑先决定 → 返回桌面结果，同时撤回 QQ 消息（手机上立即消失）

- 命令原文从哪来：DSH 的审批请求只带 justification，所以插件挂了 tools/pre-execute，按 callId 缓存工具原始参数，审批时取出 args.command；
- 理由：displayReason 可能是 {zh,en} 对象，插件会统一压成一句人话；
- 危险操作（删除 / 格式化 / 写系统目录 / 启进程 / 强推）会多一行 ⚠️ 警示；
- 日志：每次 asked / reply / decided / qq-unavailable 都写一行 JSON，含 id、工具、命令、来源（qq / desktop）、结果。

安全说明

- 插件不含任何账号、令牌或个人路径的默认值；adminQq 默认 0，必须自己填；
- 只有 adminQq 的私聊回复会被接受，其他人回复不会产生任何授权；
- 审批消息经你配置的 OneBot 服务转发，走本机回环地址，默认不出网（NapCat 连哪台服务器由你决定）；
- 日志默认写在 ~/.dsh/approval-qq/approval.log，里面会有命令原文，注意别把它提交到仓库。

已知边界

- 电脑端弹窗不由本插件主动关闭：QQ 先同意时请求先 resolve，桌面 UI 依赖 DSH 自身收尾；
- 不支持多人会签，只认一个管理员；
- 部分工具（如只带路径的文件操作）没有 command 字段，这时消息里只展示理由和参数 JSON；
- 如果你同时装了别的审批转发插件（例如 dsh-onebot-qq 里的 approval 子插件），会出现两条消息/两个 answerer，请只保留一个。

开发

语法自检（无构建步骤）
node --check index.js

License

MIT