@zmainer/dsh-wx-bridge 1.0.8 → 1.0.9

package/README.md

@@ -78,6 +78,7 @@ dsh plugin --profile <profile> add @zmainer/dsh-wx-bridge
 | `dataDir` | 桥的状态/日志/工作目录 | `$DSH_HOME/wxbridge` |
 | `cwd` | 微信任务的默认工作目录 | 宿主启动目录 |
 | `vault` | Obsidian 知识库绝对路径（可选，供提示词模板占位符使用） | 空 |
+| `dshBin` | DSH 运行时入口（`<安装目录>/resources/dsh-runtime/lib/bin.js`）。**留空＝五级自动探测**：显式参数/环境变量 → 宿主自证快照 → PATH/npm 全局 → 桌面安装目录扫描 → 运行中进程嗅探 | 自动 |
 | `intervalMs` / `staleMs` | 自检间隔 / 心跳判新阈值 | 300000 |
 | `prompt` | 手机任务的**固定前置提示词**（兜底路径用；留空 = 不加任何前缀） | 空 |
 | `acp.enabled` | 关掉 ACP 路径（退回一次性 headless） | true |
@@ -146,6 +147,16 @@ dsh plugin --profile <profile> add @zmainer/dsh-wx-bridge
 
 ## 最近变更
 
+- **1.0.9**：修「手机发消息永远没答复 / 5 分钟后才报 ACP 超时」——
+  根因是**运行时入口解析不到**（桌面端装在非标准目录时三级探测全部落空），ACP 子进程拿到空路径，
+  而 `node "" --profile acp` 会进入「读 stdin」模式：**不回应协议、也不退出**，只能等满超时。
+  ① `dshBin` 改为**五级解析**：显式参数/环境变量 → **宿主自证快照**（宿主进程自己就是 `<runtime>/lib/bin.js`，
+  每次启动写 `<dataDir>/host-runtime.json`）→ PATH/npm 全局 → 桌面安装目录扫描（`%LOCALAPPDATA%\Programs\*`、
+  `Program Files*`）→ **运行中进程嗅探**（从别的 DSH 进程命令行里取 `dsh-runtime\lib\bin.js`）；
+  ② **空入口快速失败**：ACP 入口不存在直接报错（不再空跑 5 分钟），一次性兜底路径也不再盲试 `spawn('dsh')`，
+  报错文案直接给出该填什么；
+  ③ 独立 keeper 每轮自检补读快照/配置 —— 改好配置**不必重启 keeper**；
+  ④ 面板诊断新增「运行时入口」一行，`node lib/kernel/bridge.mjs --selftest-runtime` 一次看全解析链。
 - **1.0.8**：手机指令可用性打磨 ——
   ① `/help` 重写：按「看状态 / 管任务 / 会话 / 档位模型 / 工作区 / 权限」分组，每条写清**作用**；
   ② `/task` 带**进度**（已跑多久、最近在用哪个工具、多久之前），不再只显示"running"；

package/lib/client.js

@@ -269,6 +269,9 @@ window.__ModuleLoader__.load({
       const rows = [
         ['桥状态', state + '（' + (b.phase || 'n/a') + '）'],
         ['进程', b.pid ? ('pid ' + b.pid + '｜心跳 ' + (b.ageSec === null ? 'n/a' : b.ageSec + 's 前')) : '无'],
+        ['运行时入口', b.runtimeBin
+          ? (b.runtimeBin + (b.runtimeBinOk ? '' : '（⚠️ 文件不存在）'))
+          : '⚠️ 未解析（手机对话会失败，请设置 dshBin）'],
         ['数据目录', b.dataDir || 'n/a'],
         ['默认工作区', b.cwd || 'n/a'],
       ]

package/lib/index.js

@@ -84,6 +84,7 @@ export function apply(ctx, config) {
   let keeper = null
   let timer = null
   let pairing = null
+  let runtimeInfo = { bin: '', ok: false, source: '' }
 
   /** 按钮操作日志（环形缓冲）：面板要能看到"我点了什么、结果如何"。 */
   const actions = []
@@ -97,6 +98,32 @@ export function apply(ctx, config) {
     try { return JSON.parse(readFileSync(f, 'utf8')) || {} } catch { return {} }
   }
 
+  /**
+   * 宿主自己的运行时入口：**宿主进程就是 `<runtime>/lib/bin.js`**（argv[1]），
+   * 这是唯一无需猜测的权威答案（2026-09-22：其他用户装在非标准目录，三级探测全落空
+   * → ACP 子进程拿到空路径 `node "" --profile acp` → 挂死 5 分钟，手机端只收到一条失败提示）。
+   */
+  const detectHostRuntime = () => {
+    const a1 = String(process.argv[1] || '')
+    const bin = (existsSync(a1) && /(^|[\\/])bin\.js$/i.test(a1)) ? a1 : ''
+    const node = (() => { const p = String(process.execPath || ''); return existsSync(p) ? p : '' })()
+    return { bin, node, argv1: a1 }
+  }
+  /** 把宿主运行时写进 `<dataDir>/host-runtime.json`：独立 keeper / 桥 / 下次启动都读它。 */
+  const writeHostRuntime = (dataDir, rt) => {
+    if (!dataDir || !rt.bin) {
+      ctx.logger?.warn?.('wxbridge: 无法自证宿主运行时入口（argv[1]=' + (rt.argv1 || '空') + '）——手机对话可能失败')
+      return
+    }
+    try {
+      mkdirSync(dataDir, { recursive: true })
+      writeFileSync(join(dataDir, 'host-runtime.json'), JSON.stringify({
+        bin: rt.bin, node: rt.node, source: 'host-argv', hostPid: process.pid, at: new Date().toISOString(),
+      }, null, 1))
+      ctx.logger?.info?.('wxbridge: 宿主运行时入口 ' + rt.bin)
+    } catch (e) { ctx.logger?.warn?.('wxbridge: 写 host-runtime.json 失败 ' + String(e?.message ?? e)) }
+  }
+
   const boot = async () => {
     const file = readConfigFile()
     const pick = (k) => cfg[k] || file[k] || undefined
@@ -104,8 +131,12 @@ export function apply(ctx, config) {
     const vault = pick('vault')
     const cwd = pick('cwd')
     const hostHome = pick('hostHome') || process.env.DSH_HOME || ''
-    // 自动探测宿主运行时：会话 schema 必须与应用一致，否则外部写的会话在应用里打不开
-    const dshBin = pick('dshBin') || process.env.DSH_RUNTIME_BIN || ''
+    // 运行时入口：宿主自证（argv[1]）优先，其次配置/环境。找不到就明确告警——
+    // 「入口为空」的表现曾经是"手机端永远没答复"，必须当场看得见。
+    const host = detectHostRuntime()
+    const dshBin = pick('dshBin') || host.bin || process.env.DSH_RUNTIME_BIN || ''
+    runtimeInfo = { bin: dshBin, ok: !!dshBin && existsSync(dshBin), source: pick('dshBin') ? 'config' : (host.bin ? 'host-argv' : 'unresolved') }
+    if (!runtimeInfo.ok) ctx.logger?.warn?.('wxbridge: 未解析到 DSH 运行时入口（dshBin 为空）——请设置 config.dshBin，否则手机对话会快速失败')
     const ownership = cfg.lifecycle === 'host' || file.lifecycle === 'host' ? 'host' : 'standalone'
     const { createKeeper } = await import(new URL('./kernel/keeper.mjs', import.meta.url).href)
     keeper = createKeeper({
@@ -113,7 +144,7 @@ export function apply(ctx, config) {
       dshBin,
       dataDir,
       cwd,
-      node: cfg.nodePath || undefined,
+      node: cfg.nodePath || host.node || undefined,
       intervalMs: cfg.intervalMs || file.intervalMs || undefined,
       staleMs: cfg.staleMs || file.staleMs || undefined,
       bridgePath: join(KERNEL, 'bridge.mjs'),
@@ -125,6 +156,7 @@ export function apply(ctx, config) {
     })
     keeper.lifecycle = ownership
     const st = keeper.status()
+    writeHostRuntime(st.dataDir, host)
     ctx.logger?.info?.('wxbridge: data=' + st.dataDir + ' cwd=' + st.cwd + ' pid=' + st.pid + ' pidOk=' + st.pidOk)
     const standaloneKeeper = (() => { try { const j = JSON.parse(readFileSync(join(st.dataDir, 'keeper.lock'), 'utf8')); return j && j.pid ? Number(j.pid) : 0 } catch { return 0 } })()
     ctx.logger?.info?.('wxbridge: 独立 keeper pid=' + (standaloneKeeper || '无') + '（负责拉起/自愈；宿主半只做看门狗，不抢拉起）')
@@ -216,6 +248,8 @@ export function apply(ctx, config) {
 
     const bridgeView = () => {
       if (!keeper) return null
+      const rt = (keeper.runtime ? keeper.runtime() : { dshBin: runtimeInfo.bin }) || {}
+      const rtBin = rt.dshBin || runtimeInfo.bin || ''
       const st = keeper.status()
       const hb = st.heartbeat || {}
       let peers = 0, tasks = 0, allowed = 0, stateOk = false, manualStop = null
@@ -234,6 +268,7 @@ export function apply(ctx, config) {
         polls: hb.polls ?? null, boot: hb.boot ?? null, running: hb.tasks ?? 0,
         peers, tasks, allowedUsers: allowed, stateOk, manualStop,
         dataDir: st.dataDir, cwd: st.cwd, intervalMs: st.intervalMs, staleMs: st.staleMs,
+        runtimeBin: rtBin, runtimeBinOk: !!rtBin && existsSync(rtBin), runtimeSource: runtimeInfo.source,
       }
     }
 
@@ -245,6 +280,7 @@ export function apply(ctx, config) {
       out.contract = cp && existsSync(cp) ? cp : join(KERNEL, 'second-brain-contract.txt')
       const pdir = join(process.env.DSH_HOME || '', 'profiles')
       try { for (const d of readdirSync(pdir)) { const pj = join(pdir, d, 'package.json'); let nm = d; try { nm = JSON.parse(readFileSync(pj, 'utf8')).name || d } catch {} out.profiles.push(nm) } } catch {}
+      out.runtime = { bin: runtimeInfo.bin, ok: runtimeInfo.ok, source: runtimeInfo.source }
       return out
     }
 

package/lib/kernel/acp.mjs

@@ -15,6 +15,7 @@
  * 传输：stdio 上的 NDJSON（一行一个 JSON-RPC）。stdout 只有协议流量，日志在 stderr。
  */
 import { spawn } from 'node:child_process'
+import { existsSync } from 'node:fs'
 
 const PROTOCOL_VERSION = 1
 const NL = '\n'
@@ -23,6 +24,7 @@ export class AcpHost {
   /**
    * @param {object} o
    * @param {string} o.bin        dsh 入口（bin.js 绝对路径）
+   * @param {string} [o.node]      用哪个 node 跑它（默认本进程的 execPath）
    * @param {string} [o.home]     子进程 DSH_HOME（决定会话写进哪个仓库）
    * @param {string} [o.cwd]      子进程工作目录（默认进程 cwd）
    * @param {string} [o.patch]    --patch 叠加层文件（如停用宿主专属插件）
@@ -32,6 +34,7 @@ export class AcpHost {
    */
   constructor(o) {
     this.bin = o.bin
+    this.node = o.node || process.execPath
     this.home = o.home || ''
     this.cwd = o.cwd || process.cwd()
     this.patch = o.patch || ''
@@ -63,11 +66,19 @@ export class AcpHost {
   }
 
   async _start() {
+    // 入口必须先自证存在：spawn(node, ['']) 会让 node 进入「读 stdin」模式——
+    // 不回应协议、也不退出，调用方只能等满超时（2026-09-22 其他用户实况：
+    // 「手机发消息永远没答复，5 分钟后收到一条失败提示」）。宁可当场报错。
+    if (!this.bin || !existsSync(this.bin)) {
+      this.log('acp-bin-missing', { bin: this.bin || '', node: this.node })
+      throw new Error('ACP 通道不可用：DSH 运行时入口未解析（dshBin=' + (this.bin || '空') + '）。'
+        + '请把插件配置里的 dshBin 指向 <安装目录>/resources/dsh-runtime/lib/bin.js，或设环境变量 DSH_BIN 后重启。')
+    }
     const args = [this.bin, '--profile', 'acp']
     if (this.patch) args.push('--patch', this.patch)
     const env = { ...process.env }
     if (this.home) env.DSH_HOME = this.home
-    const child = spawn(process.execPath, args, { cwd: this.cwd, windowsHide: true, stdio: ['pipe', 'pipe', 'pipe'], env })
+    const child = spawn(this.node, args, { cwd: this.cwd, windowsHide: true, stdio: ['pipe', 'pipe', 'pipe'], env })
     this.child = child
     this.log('acp-spawn', { pid: child.pid, home: this.home || '(inherit)', patch: this.patch || null })
     child.stdout.on('data', (b) => this._onData(b))

package/lib/kernel/bridge.mjs

@@ -8,10 +8,11 @@
  *   --data-dir / BRIDGE_DATA / WXBRIDGE_DATA / $DSH_HOME/wxbridge   数据目录
  *   --cwd / BRIDGE_CWD                                              默认工作区
  *   --contract / CONTRACT_FILE                                      身份契约文件
- *   DSH_BIN / PATH 上的 dsh / npm 全局安装位                           DSH 入口
+ *   运行时入口 dshBin（5 级解析，见 resolveDshBin）：--dsh-bin/BRIDGE_DSH_BIN/DSH_BIN →
+ *     <dataDir>/host-runtime.json（宿主自证）→ PATH/npm 全局 → 桌面安装目录 → 运行中进程嗅探
  */
 import { readFileSync, writeFileSync, appendFileSync, existsSync, mkdirSync, renameSync, statSync, readdirSync } from 'node:fs'
-import { spawn } from 'node:child_process'
+import { spawn, execFileSync } from 'node:child_process'
 import { AcpHost } from './acp.mjs'
 import { ensureAcpPresetSupport, acpPresetSupported, acpPackageFile } from './acp-preset-shim.mjs'
 import { randomUUID, randomBytes, createHash } from 'node:crypto'
@@ -27,23 +28,101 @@ const DEBUG = args.includes('--debug')
 const NL = String.fromCharCode(10)
 const HERE = dirname(fileURLToPath(import.meta.url))
 
+function fileOk(p) { try { return !!p && existsSync(p) && statSync(p).isFile() } catch { return false } }
+function pickExisting(list) { for (const f of list) { if (fileOk(f)) return f } return '' }
+/**
+ * 宿主写下的运行时快照（宿主半每次启动都会刷新它）：
+ * 宿主进程自己就是 <runtime>/lib/bin.js，所以它给的路径**一定**和"读会话的那一端"同版本
+ *（schema 必须一致，见 E-2026-09-21-07）。
+ */
+function readHostRuntime() {
+  for (const f of [process.env.BRIDGE_HOST_RUNTIME, join(STATE_DIR, 'host-runtime.json')]) {
+    try {
+      const j = JSON.parse(readFileSync(f, 'utf8'))
+      if (j && typeof j === 'object') return j
+    } catch {}
+  }
+  return {}
+}
+const RT_RE = /[\\/]lib[\\/]bin\.js$/i
+/** 桌面发行版布局：<根>/<任意子目录>/resources/dsh-runtime/lib/bin.js（含便携解包布局）。 */
+function desktopRuntimeCandidates() {
+  const out = []
+  const roots = [
+    join(process.env.LOCALAPPDATA || join(homedir(), 'AppData', 'Local'), 'Programs'),
+    process.env.PROGRAMFILES || 'C:/Program Files',
+    process.env['PROGRAMFILES(X86)'] || 'C:/Program Files (x86)',
+    join(process.env.LOCALAPPDATA || join(homedir(), 'AppData', 'Local'), ''),
+  ]
+  for (const root of roots) {
+    let subs = []
+    try { subs = readdirSync(root) } catch { continue }
+    for (const s of subs) {
+      out.push(join(root, s, 'resources', 'dsh-runtime', 'lib', 'bin.js'))          // Electron 发行版
+      out.push(join(root, s, 'dsh-runtime', 'lib', 'bin.js'))                       // 便携解包
+      out.push(join(root, s, 'resources', 'app', 'node_modules', '@deepseek-ai', 'dsh', 'lib', 'bin.js'))
+    }
+  }
+  return out
+}
+/**
+ * 从**正在运行的进程**里嗅探运行时：桌面端无论装在哪个盘、哪个目录，只要它在跑，
+ * 命令行里就带着 `<...>/dsh-runtime/lib/bin.js`（Electron 主进程的 ExecutablePath 也能推）。
+ * 只在前面几级全落空时才动用（PowerShell 起步约 1 秒）。
+ */
+function wmiRuntimeCandidates() {
+  if (process.platform !== 'win32') return []
+  const out = []
+  try {
+    const ps = 'Get-CimInstance Win32_Process | Select-Object CommandLine,ExecutablePath | ConvertTo-Json -Compress'
+    const raw = execFileSync('powershell.exe', ['-NoProfile', '-Command', ps], { encoding: 'utf8', windowsHide: true, timeout: 20000 })
+    for (const it of [].concat(JSON.parse(raw || '[]'))) {
+      const cmd = String(it.CommandLine || '')
+      for (const m of cmd.match(/[A-Za-z]:\\[^"]*?lib\\bin\.js/gi) || []) { if (RT_RE.test(m)) out.push(m) }
+      const exe = String(it.ExecutablePath || '')
+      if (/dsh|harness/i.test(exe) && /\.exe$/i.test(exe)) {
+        const dir = dirname(exe)
+        out.push(join(dir, 'resources', 'dsh-runtime', 'lib', 'bin.js'))
+        out.push(join(dir, 'dsh-runtime', 'lib', 'bin.js'))
+      }
+    }
+  } catch {}
+  return out
+}
+/**
+ * DSH 运行时入口解析（5 级，2026-09-22 重写）：
+ *   ① --dsh-bin / BRIDGE_DSH_BIN / DSH_BIN（显式）
+ *   ② <dataDir>/host-runtime.json（宿主自证，最权威）
+ *   ③ PATH 各目录 + npm 全局安装位的 @deepseek-ai/dsh
+ *   ④ 桌面布局扫描（%LOCALAPPDATA%\Programs\*、Program Files*）
+ *   ⑤ 运行中进程嗅探（WMI）
+ * 全落空 → ''，**调用方必须快速失败**：绝不能拿空路径 spawn
+ *（`node ""` 会进入「读 stdin」模式，既不回话也不退出 → "手机永远没答复"，见 E-2026-09-22-03）。
+ */
 function resolveDshBin() {
-  // 显式指定优先：宿主自己的运行时（与应用同版本）才能写出应用读得懂的会话格式，
-  // 否则会写成另一个 schema（version 3 vs 0），会话在应用里"不存在"（2026-09-21 实测）。
-  const explicit = argOf('--dsh-bin') || process.env.BRIDGE_DSH_BIN || process.env.DSH_BIN
-  if (explicit && existsSync(explicit)) return explicit
-  const candidates = [process.env.DSH_BIN]
+  const explicit = pickExisting([argOf('--dsh-bin'), process.env.BRIDGE_DSH_BIN, process.env.DSH_BIN])
+  if (explicit) return explicit
+  const fromSnap = pickExisting([readHostRuntime().bin, readHostRuntime().dshBin])
+  if (fromSnap) return fromSnap
+  const cands = []
   for (const p of String(process.env.PATH || '').split(process.platform === 'win32' ? ';' : ':').filter(Boolean)) {
-    candidates.push(join(p, 'node_modules', '@deepseek-ai', 'dsh', 'lib', 'bin.js'))
+    cands.push(join(p, 'node_modules', '@deepseek-ai', 'dsh', 'lib', 'bin.js'))
   }
-  candidates.push(join(homedir(), 'AppData', 'Roaming', 'npm', 'node_modules', '@deepseek-ai', 'dsh', 'lib', 'bin.js'))
-  return candidates.filter(Boolean).find((f) => { try { return existsSync(f) } catch { return false } }) || ''
+  cands.push(join(homedir(), 'AppData', 'Roaming', 'npm', 'node_modules', '@deepseek-ai', 'dsh', 'lib', 'bin.js'))
+  return pickExisting(cands) || pickExisting(desktopRuntimeCandidates()) || pickExisting(wmiRuntimeCandidates())
+}
+/** 跑 ACP 子进程/一次性任务用哪个 node：显式 → 宿主快照 → 自己（进程内已证明可用）。 */
+function resolveNodeBin() {
+  return pickExisting([argOf('--node-bin'), process.env.BRIDGE_NODE_BIN]) || pickExisting([readHostRuntime().node]) || process.execPath
 }
+const RUNTIME_HINT = '找不到 DSH 运行时入口（dshBin）：显式参数/环境变量、宿主自证快照、PATH/npm 全局、'
+  + '桌面安装目录、运行中进程五级解析全部落空。请把插件配置里的 dshBin 指向 <安装目录>/resources/dsh-runtime/lib/bin.js，'
+  + '或设环境变量 DSH_BIN 后重启宿主；诊断：node <插件>/lib/kernel/bridge.mjs --selftest-runtime'
 
 const STATE_DIR = resolve(argOf('--data-dir') || process.env.BRIDGE_DATA || process.env.WXBRIDGE_DATA
   || join(process.env.DSH_HOME || join(homedir(), '.dsh'), 'wxbridge'))
 const CWD = resolve(argOf('--cwd') || process.env.BRIDGE_CWD || process.cwd())
-const DSH_BIN = resolveDshBin()
+let DSH_BIN = resolveDshBin()
 const DSH_HOME = process.env.DSH_HOME || join(homedir(), '.dsh')
 const DESKTOP_HOME = process.env.OHDSH_HOME || join(homedir(), '.ohdsh')
 
@@ -79,6 +158,26 @@ const TASKS_DIR = join(STATE_DIR, 'tasks')
 const CHILD_HOME = join(STATE_DIR, 'dsh-home')
 const DESKTOP_WS_FILE = join(DESKTOP_HOME, 'storages', 'workspace.json')
 const CLI_WS_FILE = join(DSH_HOME, 'storages', 'workspace.json')
+const NODE_BIN = resolveNodeBin()
+/**
+ * 入口缺失时按需重解析（配置修好不必重启桥）；发现成功就落盘，供独立 keeper / 下次启动直接用。
+ * 发现失败也要**出声**——这个值空着，手机侧的表现就是「永远没答复」。
+ */
+function ensureDshBin() {
+  if (fileOk(DSH_BIN)) return DSH_BIN
+  const hit = resolveDshBin()
+  if (hit) {
+    DSH_BIN = hit
+    log('runtime-resolved', { bin: hit, source: 'discovered' })
+    try {
+      const cur = readHostRuntime()
+      if (!fileOk(cur.bin)) writeFileSync(join(STATE_DIR, 'host-runtime.json'), JSON.stringify({ bin: hit, node: NODE_BIN, source: 'discovered', pid: process.pid, at: new Date().toISOString() }, null, 1))
+    } catch {}
+    return DSH_BIN
+  }
+  log('runtime-missing', { hint: RUNTIME_HINT })
+  return ''
+}
 
 const API_BASE = process.env.ILINK_BASE || 'https://ilinkai.weixin.qq.com'
 const PROTOCOL_VERSION = '2.4.6'
@@ -133,18 +232,15 @@ let ACP_PERM = ACP_CFG.permPolicy === 'reject' ? 'reject' : 'allow'
  * 否则应用读不懂外部写的会话 —— 2026-09-21 实锤的 v0/v3 分裂）。
  */
 function resolveAcpBin() {
-  const explicit = ACP_CFG.dshBin || process.env.BRIDGE_ACP_DSH_BIN
-  if (explicit && existsSync(explicit)) return explicit
+  const explicit = pickExisting([ACP_CFG.dshBin, process.env.BRIDGE_ACP_DSH_BIN, process.env.DSH_BIN])
+  if (explicit) return explicit
+  const fromSnap = pickExisting([readHostRuntime().bin])
+  if (fromSnap) return fromSnap
   if (existsSync(join(ACP_HOME, 'profiles', 'desktop'))) {
-    const local = process.env.LOCALAPPDATA || join(homedir(), 'AppData', 'Local')
-    const cands = [
-      join(local, 'Programs', 'Oh-DSH Desktop', 'resources', 'dsh-runtime', 'lib', 'bin.js'),
-      join(process.env.PROGRAMFILES || 'C:/Program Files', 'Oh-DSH Desktop', 'resources', 'dsh-runtime', 'lib', 'bin.js'),
-    ]
-    const hit = cands.filter((f) => { try { return existsSync(f) } catch { return false } })[0]
+    const hit = pickExisting(desktopRuntimeCandidates())
     if (hit) return hit
   }
-  return DSH_BIN
+  return ensureDshBin()
 }
 
 for (const d of [STATE_DIR, TASKS_DIR, CHILD_HOME]) mkdirSync(d, { recursive: true })
@@ -529,7 +625,7 @@ function flattenConfigOptions(opts) {
 function getAcpHost(key) {
   const k = String(key || ACP_DEFAULT_PRESET).trim() || ACP_DEFAULT_PRESET
   if (!acpHosts.has(k)) acpHosts.set(k, new AcpHost({
-    bin: resolveAcpBin(), home: ACP_HOME, cwd: CWD, patch: overlayFor(k),
+    bin: resolveAcpBin(), node: NODE_BIN, home: ACP_HOME, cwd: CWD, patch: overlayFor(k),
     permPolicy: ACP_PERM, promptTimeoutMs: TASK_TIMEOUT_MS, log,
   }))
   return acpHosts.get(k)
@@ -804,9 +900,17 @@ function killTree(pid) { try { spawn('taskkill', ['/PID', String(pid), '/T', '/F
 function runDsh(task, cwd, taskId) {
   return new Promise((resolve) => {
     const taskLog = join(TASKS_DIR, Date.now() + '-' + taskId + '.log')
-    const argv = DSH_BIN ? [DSH_BIN, '--profile', PROFILE, task] : ['--profile', PROFILE, task]
+    const bin = ensureDshBin()
+    // 没有入口就**当场失败**：旧写法 spawn('dsh') 靠 shell，找不到就 exit 1；
+    // 更糟的是 ACP 那边拿空路径 spawn(node, ['']) → node 进入「读 stdin」模式，挂着不吭声
+    //（2026-09-22 其他用户实况：手机 5 分钟后只收到一条"执行失败"）。
+    if (!bin) {
+      try { appendFileSync(taskLog, NL + '=== runtime missing: ' + process.argv.join(' ') + NL + RUNTIME_HINT + NL) } catch {}
+      resolve({ ok: false, text: '', error: RUNTIME_HINT, log: taskLog })
+      return
+    }
     const env = { ...process.env, DSH_HOME: (HOST_HOME || CHILD_HOME) }
-    const child = DSH_BIN ? spawn(process.execPath, argv, { cwd, windowsHide: true, env }) : spawn('dsh', argv, { cwd, windowsHide: true, env, shell: process.platform === 'win32' })
+    const child = spawn(NODE_BIN, [bin, '--profile', PROFILE, task], { cwd, windowsHide: true, env })
     const childPid = child.pid
     const rec = state.tasks[taskId]
     if (rec) { rec.pid = childPid; saveState(state) }
@@ -1203,6 +1307,17 @@ async function handleMessage(token, msg) {
 
 async function main() {
   process.on('exit', () => { for (const [, h] of acpHosts) { try { h.stop() } catch {} } })
+  if (args.includes('--selftest-runtime')) {
+    const snap = readHostRuntime()
+    console.log('[selftest-runtime] ' + JSON.stringify({
+      dshBin: DSH_BIN, dshBinOk: fileOk(DSH_BIN), node: NODE_BIN, acpBin: resolveAcpBin(), acpBinOk: fileOk(resolveAcpBin()),
+      acpHome: ACP_HOME, dataDir: STATE_DIR,
+      snapshot: { bin: snap.bin || '', node: snap.node || '', source: snap.source || '', at: snap.at || '' },
+      desktopHits: desktopRuntimeCandidates().filter(fileOk),
+      hint: fileOk(resolveAcpBin()) ? '' : RUNTIME_HINT,
+    }, null, 1))
+    process.exit(0)
+  }
   if (args.includes('--selftest-preset-check')) {
     const peer = { cwd: CWD }
     const sp = argOf('--selftest-preset-check', '')
@@ -1215,7 +1330,7 @@ async function main() {
   }
   if (args.includes('--selftest-presets')) {
     console.log('[selftest-presets] ' + JSON.stringify({ default: ACP_DEFAULT_PRESET,
-      bin: resolveAcpBin(), acpHome: ACP_HOME, roots: presetRootsDiag(),
+      bin: resolveAcpBin(), binOk: fileOk(resolveAcpBin()), acpHome: ACP_HOME, roots: presetRootsDiag(),
       roster: listPresets().map((x) => x.id + ':' + x.name) }))
     process.exit(0)
   }
@@ -1232,7 +1347,7 @@ async function main() {
     const r3 = await runViaAcp('再一次：我刚才让你记的是什么词？只回复那个词。', peer, 'SELFTEST3')
     for (const [, h] of acpHosts) h.stop()
     console.log('[selftest-acp] ' + JSON.stringify({
-      bin: resolveAcpBin(), home: ACP_HOME, preset: presetKey(peer), patch: overlayFor(presetKey(peer)),
+      bin: resolveAcpBin(), binOk: fileOk(resolveAcpBin()), home: ACP_HOME, preset: presetKey(peer), patch: overlayFor(presetKey(peer)),
       session: sessionSlot(peer, peer.acpMode).id,
       turn1: r1?.text, turn2: r2?.text, turn3: r3?.text, notice: r2?.notice || null,
     }))

package/lib/kernel/keeper.mjs

@@ -8,6 +8,7 @@
  *   BRIDGE_DATA    数据目录（必填；未给则回退 WXBRIDGE_DATA，再回退 $DSH_HOME/wxbridge）
  *   BRIDGE_CWD     桥与任务的默认工作目录（默认 process.cwd()）
  *   BRIDGE_NODE    node 可执行文件（默认 process.execPath）
+ *   <dataDir>/host-runtime.json  宿主写的运行时快照（dshBin/node 的权威来源，宿主半每次启动刷新）
  *   KEEPER_INTERVAL_MS / KEEPER_STALE_MS  自检间隔 / 心跳判新阈值（默认 5 分钟）
  *
  * 也可作为模块被宿主进程 import：导出 tick()/status()/startBridge()/stopBridge()。
@@ -22,6 +23,14 @@ import { fileURLToPath } from 'node:url'
 const NL = String.fromCharCode(10)
 const HERE = dirname(fileURLToPath(import.meta.url))
 
+/**
+ * 宿主写的运行时快照。宿主进程自己就是 <runtime>/lib/bin.js，所以它写下的路径一定与
+ * 应用同版本（会话 schema 必须对得上）。独立 keeper 可能先于宿主启动，故每轮自检都补读一次。
+ */
+export function readHostRuntimeFile(dataDir) {
+  try { return JSON.parse(readFileSync(join(dataDir || '.', 'host-runtime.json'), 'utf8')) || {} } catch { return {} }
+}
+
 /**
  * 轮询是否在推进（纯函数，可单测）。
  * 关键：进度下限必须按「桥的代次 boot」隔离——桥重启后 polls 归零，
@@ -53,7 +62,7 @@ export function createKeeper(opts = {}) {
   const file = readConfigFile()
   const DATA = resolveDataDir(opts.dataDir)
   const CWD = opts.cwd || file.cwd || process.env.BRIDGE_CWD || process.env.BRIDGE_ROOT || process.cwd()
-  const NODE = opts.node || process.env.BRIDGE_NODE || process.execPath
+  let NODE = opts.node || process.env.BRIDGE_NODE || readHostRuntimeFile(DATA).node || process.execPath
 
 
   const INTERVAL_MS = Number(opts.intervalMs || file.intervalMs || process.env.KEEPER_INTERVAL_MS || 5 * 60 * 1000)
@@ -64,7 +73,7 @@ export function createKeeper(opts = {}) {
   // 宿主 home：给了它，桥的子进程就把会话写进宿主的会话仓库（手机对话在桌面工作区可见）
   const HOST_HOME = opts.hostHome || file.hostHome || process.env.BRIDGE_HOST_HOME || ''
   // 与应用同版本的运行时路径（让会话写成应用可读的 schema）
-  const DSH_BIN = opts.dshBin || file.dshBin || process.env.BRIDGE_DSH_BIN || ''
+  let DSH_BIN = opts.dshBin || file.dshBin || process.env.BRIDGE_DSH_BIN || readHostRuntimeFile(DATA).bin || ''
   const DETACHED = opts.detached !== false
   /**
    * monitor = 只监测与报告，绝不 spawn / 杀进程（宿主半的默认）；
@@ -92,10 +101,22 @@ export function createKeeper(opts = {}) {
     BRIDGE_ROOT: DATA,
     ...(HOST_HOME ? { BRIDGE_HOST_HOME: HOST_HOME } : {}),
     ...(DSH_BIN ? { BRIDGE_DSH_BIN: DSH_BIN } : {}),
+    ...(NODE ? { BRIDGE_NODE_BIN: NODE } : {}),
   })
 
   const alive = (pid) => { try { process.kill(pid, 0); return true } catch { return false } }
 
+  /** 入口缺失/失效时按需重解析（宿主半刚写下的快照、或用户改好的配置），不必重启 keeper。 */
+  function refreshRuntime() {
+    if (DSH_BIN && existsSync(DSH_BIN)) return DSH_BIN
+    const cfg = readConfigFile()
+    const snap = readHostRuntimeFile(DATA)
+    const hit = [cfg.dshBin, snap.bin, process.env.BRIDGE_DSH_BIN]
+      .filter((x) => { try { return !!x && existsSync(x) } catch { return false } })[0]
+    if (hit) { DSH_BIN = hit; if (!opts.node && snap.node && existsSync(snap.node)) NODE = snap.node; log('runtime-picked-up ' + hit) }
+    return DSH_BIN
+  }
+
   function bridgePid() {
     try {
       if (!existsSync(LOCK)) return 0
@@ -122,10 +143,12 @@ export function createKeeper(opts = {}) {
    * 所以「宿主半的常驻守护」必须用 detached=true，只有「一次性前台探测」才用 false。
    */
   function spawnBridge(detached = true) {
+    refreshRuntime()
     const extra = [...BRIDGE_ARGS,
       ...(VAULT ? ['--vault', VAULT] : []),
       ...(HOST_HOME ? ['--host-home', HOST_HOME] : []),
-      ...(DSH_BIN ? ['--dsh-bin', DSH_BIN] : [])]
+      ...(DSH_BIN ? ['--dsh-bin', DSH_BIN] : []),
+      ...(NODE ? ['--node-bin', NODE] : [])]
     // 桥的输出必须留档：原来 stdio:'ignore' → 起不来时**一个字都看不到**，
     // 面板只能显示一个刚打印的 pid（2026-09-21 其他用户"启动不了"的排障黑洞）。
     let fd = 'ignore'
@@ -227,6 +250,7 @@ export function createKeeper(opts = {}) {
   }
 
   function tick() {
+    refreshRuntime()
     const pid = bridgePid()
     const hb = readHeartbeat()
     const pidOk = pid > 0 && alive(pid)
@@ -291,7 +315,7 @@ export function createKeeper(opts = {}) {
     setInterval(tick, INTERVAL_MS)
   }
 
-  return { run, tick, status, startBridge: startBridgeNow, spawnBridge, stopBridge, log, superviseMode: SUPERVISE, hostHome: HOST_HOME, dshBin: DSH_BIN, dataDir: DATA, cwd: CWD, bridgePath: BRIDGE, intervalMs: INTERVAL_MS, staleMs: STALE_MS, manualStop: readManualStop }
+  return { run, tick, status, startBridge: startBridgeNow, spawnBridge, stopBridge, log, superviseMode: SUPERVISE, hostHome: HOST_HOME, dshBin: DSH_BIN, runtime: () => ({ dshBin: DSH_BIN, node: NODE }), dataDir: DATA, cwd: CWD, bridgePath: BRIDGE, intervalMs: INTERVAL_MS, staleMs: STALE_MS, manualStop: readManualStop }
 }
 
 const isMain = process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]

package/package.json

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

package/scripts/build-client.mjs

@@ -28,7 +28,7 @@ mkdirSync(join(root, 'lib'), { recursive: true })
 writeFileSync(join(root, 'lib', 'client.js'), out)
 console.log('built lib/client.js (' + out.length + ' bytes) id=' + pkg.name)
 
-for (const f of ['bridge.mjs', 'keeper.mjs', 'second-brain-contract.txt', 'acp.mjs', 'acp-preset-shim.mjs', 'secure.mjs']) {
+for (const f of ['bridge.mjs', 'keeper.mjs', 'second-brain-contract.txt', 'acp.mjs', 'acp-preset-shim.mjs', 'acp-overlay.yml', 'acp-overlay-chat.yml']) {
   const p = join(root, 'lib', 'kernel', f)
   if (!existsSync(p)) throw new Error('kernel artifact missing: ' + p)
   console.log('kernel ok: lib/kernel/' + f + ' (' + readFileSync(p).length + ' bytes)')

package/src/client.js

@@ -263,6 +263,9 @@ function Panel() {
   const rows = [
     ['桥状态', state + '（' + (b.phase || 'n/a') + '）'],
     ['进程', b.pid ? ('pid ' + b.pid + '｜心跳 ' + (b.ageSec === null ? 'n/a' : b.ageSec + 's 前')) : '无'],
+    ['运行时入口', b.runtimeBin
+      ? (b.runtimeBin + (b.runtimeBinOk ? '' : '（⚠️ 文件不存在）'))
+      : '⚠️ 未解析（手机对话会失败，请设置 dshBin）'],
     ['数据目录', b.dataDir || 'n/a'],
     ['默认工作区', b.cwd || 'n/a'],
   ]