@zmainer/dsh-wx-bridge 1.1.3 → 1.1.5

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-acp-approval`（审批 ↔ ACP `session/request_permission` 的线上契约）/ `--selftest-outbox`（推送信箱）/ `--selftest-files` / `--selftest-inbound` / `--selftest-presets` |
+| 自测 | **`--print-config`（只读：打印实际配置链）** / `--selftest-runtime`（运行时入口）/ `--selftest-approval`（审批卡与回复解析）/ `--selftest-acp-approval`（审批 ↔ ACP `session/request_permission` 的线上契约）/ **`--selftest-overlays`（叠层模板与生成物：预设一致 + 推送提示 + 缩进）** / `--selftest-outbox`（推送信箱）/ `--selftest-files` / `--selftest-inbound` / `--selftest-presets` |
 
 ## 常见问题 / Troubleshooting
 
@@ -266,6 +266,17 @@ ode_modules\@zmainer\dsh-wx-bridge` → 改名成 `...dsh-wx-bridge.bak` 更稳
 
 ## 最近变更
 
+- **1.1.5**：新增只读自检 `--print-config` —— 一条命令看清桥**实际认到**的配置链（dataDir / 宿主 home /
+  ACP home / 子进程 home / vault / 契约 / 预设 / 审批策略 / 权限预设 / 两个叠层路径 / 推送 CLI 与 outbox），
+  不启动主循环、不抢实例锁、不发网络请求。多 home 环境下"我改的 config 是不是桥在用的那份"用它一眼可辨。
+  运行手册侧同步记录了一条机制事实：ACP 的权限预设**自带审批策略**（`workspace-write → approval: ask`、
+  `danger-full-access → approval: never`，共同组成 `dsh-permission-presets` 里的预设），
+  所以"把预设收紧"天然就会产生可被微信应答的审批。
+- **1.1.4**：修「生成物把新预设静默顶掉」——「对话档」的 ACP 叠层（`acp-overlay-chat.gen.yml`）是**磁盘缓存**，
+  改 `acp.permPreset` 或模板后不重启桥就会继续用旧的（本机实测：模板已是 `workspace-write`，磁盘上仍是
+  `danger-full-access` ⇒ 收紧预设被无声抵消）。现在每次生成都重写、不再依赖进程内缓存，
+  并把改写逻辑抽成纯函数 `buildChatOverlayText()`；新增 `--selftest-overlays`（模板预设 == 配置、
+  生成文本带推送命令、`defaultPreset` 行不含旧值、persona 缩进未破坏，四项断言全过）。
 - **1.1.3**：新增 `--selftest-acp-approval` —— 把审批卡 ↔ ACP `session/request_permission` 的**线上契约**
   变成可离线跑的断言：按 `acp.mjs` 实际收发的帧形状构造四类选项集（三选一 / 允许+拒绝 / 只有允许 / 空），
   验证「批准 / 拒绝」映射到的 `optionId`、以及应答负载（`{outcome:{outcome:'selected',optionId}}`，

package/lib/kernel/bridge.mjs

@@ -858,29 +858,41 @@ function ensurePushHelper() {
   } catch (e) { log('push-helper-failed', { error: String(e?.message ?? e) }); return '' }
 }
 
-let chatOverlayPath = ''
+/**
+ * 把模板文本改写成实际要用的叠层文本（纯函数：可离线断言，不必真跑一遍桥）。
+ * 规则：`defaultPreset:` 一行**无论写的是什么值**都换成当前 `acp.permPreset`；
+ * 再按模板最后的缩进追加提示行（推送命令要给手机侧的 agent 看）。
+ */
+export function buildChatOverlayText(text, permPreset, hintLines) {
+  const lines = String(text ?? '').split(NL)
+  while (lines.length && !String(lines[lines.length - 1]).trim()) lines.pop()
+  const indent = (String(lines[lines.length - 1] || '').match(/^\s*/) || [''])[0]
+  const body = lines.map((l) => (/^(\s*defaultPreset:\s*)\S+\s*$/.test(l) ? l.replace(/^(\s*defaultPreset:\s*)\S+\s*$/, '$1' + permPreset) : l))
+  const hints = Array.isArray(hintLines) ? hintLines : []
+  return body.concat(hints.map((h) => indent + h)).join(NL) + NL
+}
+
 /**
  * 「普通对话」档的叠层要带上推送提示：persona 是 `>-` 折叠标量，
  * 追加同缩进的行即可（叶子行缩进从模板末尾算，别写死空格数）。
+ * ⚠️ 生成结果**缓存在磁盘**（`acp-overlay-chat.gen.yml`）：改了 `acp.permPreset` 或模板后
+ * 必须重启桥才会重写，否则老生成文件会把新预设**静默顶掉**（2026-09-24 实测踩过）。
+ * 这里**每次都重写**（一次几毫秒）：宁可多写一次，也不要让"磁盘上的旧生成物"成为隐形真源。
  */
 function ensureChatOverlay() {
   const src = join(HERE, 'acp-overlay-chat.yml')
-  if (chatOverlayPath) return chatOverlayPath
   let text = ''
-  try { text = readFileSync(src, 'utf8') } catch { chatOverlayPath = src; return src }
-  if (text.includes('wxpush.mjs')) { chatOverlayPath = src; return src }
-  const lines = text.split(NL)
-  while (lines.length && !String(lines[lines.length - 1]).trim()) lines.pop()
-  const indent = (String(lines[lines.length - 1] || '').match(/^\s*/) || [''])[0]
-  const body = lines.map((l) => (/^(\s*defaultPreset:\s*)\S+\s*$/.test(l) ? l.replace(/^(\s*defaultPreset:\s*)\S+\s*$/, '$1' + ACP_PERM_PRESET) : l))
-  const out = body.concat(pushHintLines().map((h) => indent + h)).join(NL) + NL
+  try { text = readFileSync(src, 'utf8') } catch { return src }
+  if (text.includes('wxpush.mjs')) return src
+  const out = buildChatOverlayText(text, ACP_PERM_PRESET, pushHintLines())
   try {
     const f = join(STATE_DIR, 'acp-overlay-chat.gen.yml')
     writeFileSync(f, out)
+    // 只在内容变了时记一行，避免每次 spawn 都刷日志
+    if (!chatOverlayPath) log('chat-overlay-written', { file: f, permPreset: ACP_PERM_PRESET })
     chatOverlayPath = f
-    log('chat-overlay-written', { file: f })
     return f
-  } catch (e) { log('chat-overlay-failed', { error: String(e?.message ?? e) }); chatOverlayPath = src; return src }
+  } catch (e) { log('chat-overlay-failed', { error: String(e?.message ?? e) }); return src }
 }
 
 function moveOutboxFile(file, dir, name, reason) {
@@ -2166,6 +2178,49 @@ async function main() {
     }, null, 1))
     process.exit(ok ? 0 : 1)
   }
+  if (args.includes('--selftest-overlays')) {
+    // 离线自测：两个叠层模板里的 defaultPreset 必须等于当前 acp.permPreset；
+    // 且「对话档」生成文本要保留 persona 缩进、并把推送命令带进去。
+    // 起因：生成物是**磁盘缓存**，改了预设或模板后不重启桥就会拿旧的（2026-09-24 实测）。
+    const read = (f) => { try { return readFileSync(join(HERE, f), 'utf8') } catch { return '' } }
+    const presetOf = (t) => ((t.match(/^\s*defaultPreset:\s*(\S+)\s*$/m) || [])[1] || null)
+    const rows = [
+      ['acp-overlay.yml', presetOf(read('acp-overlay.yml'))],
+      ['acp-overlay-chat.yml', presetOf(read('acp-overlay-chat.yml'))],
+    ].map(([file, got]) => ({ file, got, want: ACP_PERM_PRESET, ok: got === ACP_PERM_PRESET }))
+    const gen = buildChatOverlayText(read('acp-overlay-chat.yml'), ACP_PERM_PRESET, pushHintLines())
+    const genPreset = presetOf(gen)
+    const genRows = [
+      { name: '生成文本的 defaultPreset', got: genPreset, want: ACP_PERM_PRESET, ok: genPreset === ACP_PERM_PRESET },
+      { name: '生成文本带推送命令', got: gen.includes(PUSH_CLI) ? 'yes' : 'no', want: 'yes', ok: gen.includes(PUSH_CLI) },
+      { name: '生成文本的 defaultPreset 行不含旧值', got: (/^\s*defaultPreset:.*danger-full-access/m.test(gen)) ? 'yes' : 'no', want: 'no', ok: !/^\s*defaultPreset:.*danger-full-access/m.test(gen) },
+      { name: 'persona 缩进未破坏', got: gen.includes('      你是「手机微信通道」') ? 'ok' : 'bad', want: 'ok', ok: gen.includes('      你是「手机微信通道」') },
+    ]
+    const stale = (() => { try { return presetOf(readFileSync(join(STATE_DIR, 'acp-overlay-chat.gen.yml'), 'utf8')) } catch { return null } })()
+    const ok = [...rows, ...genRows].every((r) => r.ok)
+    console.log('[selftest-overlays] ' + JSON.stringify({
+      permPreset: ACP_PERM_PRESET, templates: rows, generated: genRows,
+      onDiskGenerated: { preset: stale, note: '磁盘上那份是上次生成的结果；与本进程不同 = 需要重启桥才会重写' },
+      pushCli: PUSH_CLI,
+    }, null, 1))
+    process.exit(ok ? 0 : 1)
+  }
+
+  if (args.includes('--print-config')) {
+    // 只读自检：把桥实际认到的配置链打出来（不启动主循环、不抢锁、不发网络）。
+    // 用途：核对"我改的那份 config.json / 预设"是不是桥正在用的那份（多 home 环境下最容易搞错）。
+    console.log('[print-config] ' + JSON.stringify({
+      dataDir: STATE_DIR, cwd: CWD,
+      hostHome: HOST_HOME || '(未指定)', acpHome: ACP_HOME, childHome: CHILD_HOME,
+      vault: VAULT_PATH || '(未指定)', contract: CONTRACT_FILE,
+      acp: { enabled: ACP_ENABLED, preset: ACP_CFG.preset || '(跟随宿主默认)', permPolicy: ACP_PERM,
+             permPreset: ACP_PERM_PRESET, approvalTimeoutMs: APPROVAL_TIMEOUT_MS, patchAcp: ACP_CFG.patchAcp !== false },
+      overlays: { presetOverlay: overlayFor(ACP_DEFAULT_PRESET), chatOverlay: ensureChatOverlay() },
+      push: { cli: PUSH_CLI, outbox: OUTBOX_DIR },
+    }, null, 1))
+    process.exit(0)
+  }
+
   acquireLock()
   // 上次进程遗留的运行态任务：本轮一启动就标成 interrupted。
   // 否则 runningCount() 永远虚高，`while (runningCount() >= MAX_CONCURRENT_TASKS)` 会把新任务永久挡住。

package/package.json

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