@moonquake2004/dsh-doctor 0.4.28 → 0.4.30

package/dsh-doctor.mjs

@@ -310,6 +310,36 @@ function checkEnv() {
       supported ? undefined : `升级 node 到 ${rangeSrc.range}（${rangeSrc.from}，见 #2259）`);
   }
 
+  // E13：CLI 是否真的会执行（#6341 的静默失效签名）
+  // `lib/bin.js` 末尾是 `if (import.meta.main) await runCli();`，而 `import.meta.main` 只在
+  // Node **≥22.18.0 / ≥24.2.0** 存在。落在窗口外的 Node 上，**任何** dsh 命令都零输出、退出码 0。
+  // 判据（#6341 的关键观察）：连 `--version` 都静默——缺原生模块、端口占用、patch 问题都会打印东西，
+  // 只有"入口根本没执行"才会连版本号都不输出。故这里直接问一次版本号。
+  {
+    const whichCmd = process.platform === 'win32' ? 'where' : 'which';
+    const found = (() => { const r = spawnSync(whichCmd, ['dsh'], { encoding: 'utf8' }); return r.status === 0 ? String(r.stdout).split(/\r?\n/)[0].trim() : null; })();
+    if (!found) {
+      reportSkip('env', 'E13', 'PATH 中未找到 dsh，跳过 CLI 可执行性探测');
+    } else {
+      const r = spawnSync(process.platform === 'win32' ? 'dsh.cmd' : 'dsh', ['--version'], { encoding: 'utf8', timeout: 15000, shell: process.platform === 'win32' });
+      const out = String(r.stdout || '').trim();
+      const ver = /\d+\.\d+\.\d+[-\w.]*/.exec(out);
+      if (r.status === 0 && out === '') {
+        report('env', 'E13', false,
+          `dsh 在 PATH 中（${found}）但 \`dsh --version\` **零输出且退出码 0** —— 这是 #6341 的静默失效签名：`
+          + `CLI 入口被 \`if (import.meta.main) await runCli();\` 门控，而该 API 仅在 Node **≥22.18.0 / ≥24.2.0** 存在；`
+          + `（当前 Node ${process.version}；若它落在窗口外，这就是原因——本机 Node 24.20 上该 API 存在、命令正常）`,
+          '换用 Node ≥22.18.0 或 ≥24.2.0（注意：仓库声明范围 >=24.0.0 **包含** 24.0/24.1 这两个不可用版本）');
+      } else if (r.status !== 0) {
+        report('env', 'E13', false,
+          `dsh 在 PATH 中但 \`--version\` 以退出码 ${r.status} 失败：${String((r.stderr || '') + out).slice(0, 120)}`,
+          '按上面的报错定位（依赖缺失 / 入口异常）');
+      } else {
+        report('env', 'E13', true, `CLI 可执行（dsh --version → ${ver ? ver[0] : out.slice(0, 24)}）`);
+      }
+    }
+  }
+
   // E12：运行时 zstd 稳定性（#6651 的运行时线索）
   // 锚点已核实：dsh-session-persistence-jsonl:15 直接 `import { zstdCompress, zstdDecompress,
   // zstdDecompressSync } from "node:zlib"`（用于 :1263 / :1287 / :1368）——会话日志的读写**依赖 Node 内置 zstd**。
@@ -1326,10 +1356,29 @@ function checkSession(targetPath) {
   //   ② surfaceOp 为 replace 形态（{op:'replace', start/end} 或 startSeq/endSeq），
   //      但引用的位置在本日志里解析不到。
   {
-    const rows = [];
+    const rawRows = [];
     for (const ln of String(text).split('\n')) {
       if (!ln.trim()) continue;
-      try { rows.push(JSON.parse(ln)); } catch { /* 解析失败由 S11/SS4 报 */ }
+      try { rawRows.push(JSON.parse(ln)); } catch { /* 解析失败由 S11/SS4 报 */ }
+    }
+    // **判定对象必须是"打开时真正被投影的那条流"**：对需要迁移的日志（v0/v1/v2），
+    // 缺消息体可能是在**迁移过程中**产生的，磁盘行上看不出来。所以这里优先走真实迁移链取"迁移后的视图"。
+    // （2026-09 自查：初版只看磁盘行，会漏掉报告者 #6686 的实际病例。）
+    let rows = rawRows;
+    let view = '磁盘原始行';
+    const hdr = rawRows[0];
+    if (hdr && hdr.type === 'session' && hdr.version !== 3 && FORMAT_CATALOG) {
+      try {
+        const r = FORMAT_CATALOG.createRestore(hdr, { validation: 'current', recovery: 'strict' });
+        const decoded = [];
+        for (let i = 1; i < rawRows.length; i++) {
+          const d = r.decodeRow(rawRows[i]);
+          decoded.push((d && d.type) ? d : (d && d.event) ? d.event : rawRows[i]);
+        }
+        r.finish();
+        rows = decoded;
+        view = `迁移后视图（v${hdr.version} → v3，走真实迁移链）`;
+      } catch { /* 迁移被拒由 S12 报；这里退回磁盘行并注明 */ view = '磁盘原始行（迁移链未走通，见 S12）'; }
     }
     const seqs = new Set(rows.map((r) => r.seq).filter((x) => typeof x === 'number'));
     const probs = [];
@@ -1351,13 +1400,13 @@ function checkSession(targetPath) {
     }
     if (probs.length) {
       report('session', 'S14', false,
-        `检测到 ${probs.length} 处会让会话**打不开**的事件体/引用不完整（#6686：迁移成功但 project 抛错）：\n  `
+        `检测到 ${probs.length} 处会让会话**打不开**的事件体/引用不完整（#6686：迁移成功但 project 抛错；判定视图：${view}）：\n  `
         + probs.slice(0, 6).join('\n  ')
         + (probs.length > 6 ? `\n  …另有 ${probs.length - 6} 处` : ''),
         '这类会话在 GUI 里点开会报 failed to project session；上游修法（可选链 + 中性兜底）见 #6686；'
         + '在那之前可先把该会话目录移出 sessions/ 隔离，避免它影响会话列表');
     } else {
-      report('session', 'S14', true, `投影安全性预检通过（${rows.length} 个事件：消息体完整、replace 引用可解析）`);
+      report('session', 'S14', true, `投影安全性预检通过（${rows.length} 个事件：消息体完整、replace 引用可解析；判定视图：${view}）`);
     }
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moonquake2004/dsh-doctor",
-  "version": "0.4.28",
+  "version": "0.4.30",
   "description": "Offline diagnostic for DeepSeek Harness — 28 built-in + 5 catalog checks across env/profile/session (Layer A checks-as-data), self-update (Layer B), and a semi-automatic LLM observer (Layer C, --observe); Doctor panel in web UI settings.",
   "main": "lib/index.js",
   "files": [