@zmainer/dsh-wx-bridge 1.1.2 → 1.1.3

package/README.md

@@ -229,7 +229,7 @@ echo "来自管道的长文本" | node "<dataDir>/wxpush.mjs" --stdin
 | Node | **`>=22.19.0`**（`package.json` 的 `engines`）：会话文件是**多帧 zstd**，逐帧解压用到 `node:zlib` 的 `zstdDecompressSync`。桌面端自带运行时（本机实测 v26）与系统 Node（本机 v22.19）都验证过 |
 | 操作系统 | **Windows 已实测**（进程树终止用 `taskkill /T /F`；运行时入口探测含 `%LOCALAPPDATA%\Programs\*` 扫描、PID 复用判断）。macOS / Linux **未实测**：内核是纯 Node，但上述几处是 Windows 实现，跨平台请先跑 `node lib/kernel/bridge.mjs --selftest-runtime` |
 | 依赖 | **零运行时依赖**（只用 Node 内建模块）；不依赖任何 `@deepseek-ai/*` 包（宿主能力通过 `ctx.inject` 取用，缺失即降级） |
-| 自测 | `--selftest-runtime`（运行时入口）/ `--selftest-approval`（审批卡与回复解析）/ `--selftest-outbox`（推送信箱）/ `--selftest-files` / `--selftest-inbound` / `--selftest-presets` |
+| 自测 | `--selftest-runtime`（运行时入口）/ `--selftest-approval`（审批卡与回复解析）/ `--selftest-acp-approval`（审批 ↔ ACP `session/request_permission` 的线上契约）/ `--selftest-outbox`（推送信箱）/ `--selftest-files` / `--selftest-inbound` / `--selftest-presets` |
 
 ## 常见问题 / Troubleshooting
 
@@ -266,6 +266,11 @@ ode_modules\@zmainer\dsh-wx-bridge` → 改名成 `...dsh-wx-bridge.bak` 更稳
 
 ## 最近变更
 
+- **1.1.3**：新增 `--selftest-acp-approval` —— 把审批卡 ↔ ACP `session/request_permission` 的**线上契约**
+  变成可离线跑的断言：按 `acp.mjs` 实际收发的帧形状构造四类选项集（三选一 / 允许+拒绝 / 只有允许 / 空），
+  验证「批准 / 拒绝」映射到的 `optionId`、以及应答负载（`{outcome:{outcome:'selected',optionId}}`，
+  挑不到时 `cancelled`）。空选项集必须两侧都为空（fail-closed）。运行日志侧另记一条协议事实：
+  iLink 的 `getupdates` **不会**回投我们自己发出的消息（2026-09-24 实测）。
 - **1.1.2**：修 `wxpush.mjs` 的**默认数据目录解析**——原来只按 `$DSH_HOME/wxbridge` 兜底，桌面端
   （Electron）里 `DSH_HOME` 常为空或指向另一个 home，于是消息被排进 `~/.dsh/wxbridge/outbox`，
   而桥在 `%APPDATA%\dsh-desktop\harness\wxbridge` 取件 ⇒ **排了队没人发**（本机实测）。

package/lib/kernel/bridge.mjs

@@ -2123,6 +2123,49 @@ async function main() {
     }, null, 1))
     process.exit(rows.every((r) => r.ok) && cli.ok ? 0 : 1)
   }
+  if (args.includes('--selftest-acp-approval')) {
+    // 离线自测：审批卡 ↔ ACP `session/request_permission` 的**线上契约**
+    // （帧形状、optionId 选择、应答负载都按 acp.mjs 里实际收发的样子构造；不连网络、不拉子进程）
+    const cases = [
+      { name: '标准三选一', options: [
+        { optionId: 'allow-once', kind: 'allow_once', name: '允许一次' },
+        { optionId: 'allow-always', kind: 'allow_always', name: '总是允许' },
+        { optionId: 'reject-once', kind: 'reject_once', name: '拒绝' }],
+        allow: 'allow-once', reject: 'reject-once' },
+      { name: '只有允许/拒绝两选', options: [
+        { optionId: 'a1', kind: 'allow', name: '允许' },
+        { optionId: 'r1', kind: 'reject', name: '拒绝' }],
+        allow: 'a1', reject: 'r1' },
+      { name: '无拒绝项（上游只给允许）', options: [{ optionId: 'a1', kind: 'allow', name: '允许' }],
+        allow: 'a1', reject: null },
+      { name: '空选项 → 两侧都必须为空（fail-closed）', options: [], allow: null, reject: null },
+    ]
+    const resolved = cases.map((c) => {
+      const opts = c.options
+      const card = formatApprovalCard({ n: 1, tool: 'Bash: 删除 build 目录', options: opts, timeoutSec: 120 })
+      const fromReply = (t) => { const p = parseApprovalReply(t); return pickOptionByDecision(opts, p.decision)?.optionId ?? null }
+      const payload = (optionId) => optionId
+        ? { jsonrpc: '2.0', id: 7, result: { outcome: { outcome: 'selected', optionId } } }
+        : { jsonrpc: '2.0', id: 7, result: { outcome: { outcome: 'cancelled' } } }
+      return {
+        name: c.name,
+        allowByReply: fromReply('批准'), expectAllow: c.allow,
+        rejectByReply: fromReply('拒绝'), expectReject: c.reject,
+        ok: fromReply('批准') === c.allow && fromReply('拒绝') === c.reject,
+        wireOnAllow: payload(c.allow),
+        cardLines: card.split(NL).length,
+      }
+    })
+    const ok = resolved.every((r) => r.ok)
+    console.log('[selftest-acp-approval] ' + JSON.stringify({
+      frame: { jsonrpc: '2.0', id: 7, method: 'session/request_permission',
+        params: { sessionId: '<peer-session>', toolCall: { title: 'Bash: 删除 build 目录' }, options: cases[0].options } },
+      timeoutSec: Math.round(APPROVAL_TIMEOUT_MS / 1000),
+      permPreset: ACP_PERM_PRESET, permPolicy: ACP_PERM,
+      resolved,
+    }, null, 1))
+    process.exit(ok ? 0 : 1)
+  }
   acquireLock()
   // 上次进程遗留的运行态任务：本轮一启动就标成 interrupted。
   // 否则 runningCount() 永远虚高，`while (runningCount() >= MAX_CONCURRENT_TASKS)` 会把新任务永久挡住。
@@ -2215,6 +2258,10 @@ async function main() {
         const key = msgKey(msg)
         if (seen.has(key)) continue
         seen.add(key); state.processed.push(key)
+        // 自回显（协议事实，2026-09-24 实测）：iLink 的 getupdates **不会**把我们自己发出的消息投回来
+        //（两条主动推送发出后无任何 inbound 回流）；但随出站下发的是 message_type=2（MESSAGE_TYPE_BOT），
+        // 若上游将来改成回显，症状是"桥把自己的回执/审批卡当成新任务反复执行"——届时在此按
+        // `message_type === MESSAGE_TYPE_BOT` 或自己的 user_id 拦截即可。
         log('inbound', { text: inboundText(msg).slice(0, 80), types: inboundItemTypes(msg) })
         try { await handleMessage(wechatToken, msg) } catch (e) { log('handle-error', { error: String(e?.message ?? e) }) }
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zmainer/dsh-wx-bridge",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "type": "module",
   "main": "./lib/index.js",
   "dsh": {