@moonquake2004/dsh-doctor 0.4.14 → 0.4.16

package/dsh-doctor.mjs

@@ -54,11 +54,11 @@
  * 退出码：0 = 全部通过；1 = 发现可修复问题（内置 + catalog severity=error）；warn 级失败不改退出码。
  */
 import { execFileSync, spawnSync } from 'node:child_process';
-import { closeSync, existsSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, realpathSync, statSync, writeFileSync } from 'node:fs';
+import { closeSync, existsSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, realpathSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import net from 'node:net';
 import { basename, delimiter as PATH_DELIM, dirname, join, relative, resolve } from 'node:path';
-import { homedir } from 'node:os';
+import { homedir, tmpdir } from 'node:os';
 import { pathToFileURL, fileURLToPath } from 'node:url';
 
 const HOME = process.env.DSH_HOME || join(homedir(), '.dsh');
@@ -268,6 +268,38 @@ function checkEnv() {
       supported ? undefined : '升级 node 到 ^22.19.0 或 >=24.0.0（root package.json engines，见 #2259）');
   }
 
+  // E12：运行时 zstd 稳定性（#6651 的运行时线索）
+  // 锚点已核实：dsh-session-persistence-jsonl:15 直接 `import { zstdCompress, zstdDecompress,
+  // zstdDecompressSync } from "node:zlib"`（用于 :1263 / :1287 / :1368）——会话日志的读写**依赖 Node 内置 zstd**。
+  // 该 API 在部分 Node 版本上仍是实验性的；社区报告 #6651（Linux + Node 22.22.3）出现首帧损坏让
+  // `dsh web` 无法启动，换到 Node 26 后正常，怀疑写入侧不稳。故这里如实报告运行时状态，不做因果断言。
+  if (!hasDshEnvironment(HOME)) {
+    reportSkip('env', 'E12', '未发现 DSH 环境，跳过运行时 zstd 稳定性检查');
+  } else {
+    const zstdFn = (() => { try { return createRequire(import.meta.url)('node:zlib').zstdDecompressSync; } catch { return null; } })();
+    if (typeof zstdFn !== 'function') {
+      report('env', 'E12', false,
+        `当前 Node（${process.version}）没有 zlib.zstdDecompressSync——而会话持久化直接依赖它读写 .zstd 日志（#6651 同族风险）`,
+        '升级 Node 到内置 zstd 的版本（22.15+/23.8+），否则该运行时的 .zstd 会话日志无法读写');
+    } else {
+      // 用子进程观察 Node 是否对该 API 发出实验性警告（版本无关的经验判据，避免硬编码版本表）
+      let experimental = false; let probed = false;
+      try {
+        const r = spawnSync(process.execPath, ['-e', 'require("node:zlib").zstdDecompressSync(require("node:zlib").zstdCompressSync(Buffer.from("x")))'], { encoding: 'utf8', timeout: 10000 });
+        probed = true;
+        experimental = /ExperimentalWarning/.test(String(r.stderr || ''));
+      } catch { /* 探测失败 → 下面按"未探明"处理 */ }
+      if (!probed) reportSkip('env', 'E12', '运行时 zstd 实验性探测未能执行，跳过（不外推为通过）');
+      else if (experimental) {
+        report('env', 'E12', false,
+          `当前 Node（${process.version}）的 zlib zstd 仍标记为**实验性**——会话持久化直接依赖它读写日志；社区报告 #6651 在同类运行时上出现首帧损坏并导致 dsh web 无法启动（换新版 Node 后正常，因果未定）`,
+          '升级到 zstd 已稳定的 Node（本工具在 24.x 上实测无实验性警告）后再观察；同时建议先用 dsh-doctor 扫一遍会话库有无 S13 类损坏');
+      } else {
+        report('env', 'E12', true, `运行时 zstd 非实验性（Node ${process.version}）`, undefined);
+      }
+    }
+  }
+
   // E4：node-pty 原生模块完整性（#1219：pty.node 缺失 → dsh web 启动失败）
   const ptyDirs = [];
   for (const p of (process.env.PATH || '').split(PATH_DELIM)) {
@@ -1162,8 +1194,39 @@ function checkSession(targetPath) {
         `日志首行不是会话头（type=${header && header.type ? JSON.stringify(header.type) : '缺失/无法解析'}）——#6651：此类损坏会让 \`dsh web\` **整体启动失败**（corrupt Zstandard session log: first frame is not exactly …），会话列表一并损坏`,
         '优先从备份恢复该日志；无备份时把整个会话目录**移出** sessions/（隔离，勿删）后重启 dsh，再用本工具复查');
     } else {
-      report('session', 'S13', true,
-        `会话头完整（type=session, version=${header.version ?? '?'}, id=${String(header.id ?? '').slice(0, 12)}）`);
+      // 更精确的判据：harness 的读取路径是 **Node 的 `zlib.zstdDecompressSync`**，它**只解第一个帧**，
+      // 然后要求该帧明文恰好是一行（dsh-session-persistence-jsonl:1891/2185 的
+      // `plaintext.indexOf(10) !== plaintext.length - 1`）。所以最忠实的做法不是自己扫 magic 猜帧边界，
+      // 而是**用同一个解压器**复现同一个条件（2026-09 与 #6651 的运行时线索一致后再校准）。
+      let frameNote = '';
+      let frameBad = false;
+      if (target.endsWith('.zstd')) {
+        const zstdSync = (() => { try { return createRequire(import.meta.url)('node:zlib').zstdDecompressSync; } catch { return null; } })();
+        if (typeof zstdSync !== 'function') {
+          frameNote = '（本机 Node 无 zlib.zstdDecompressSync，未据此判定）';
+        } else {
+          try {
+            const first = zstdSync(readFileSync(target)).toString('utf8');
+            const exactlyOneLine = first.length > 0 && first.indexOf('\n') === first.length - 1;
+            if (!exactlyOneLine) {
+              frameBad = true;
+              const n = first.split('\n').filter((l) => l.trim()).length;
+              frameNote = `首帧明文含 ${n} 行（harness 要求恰好 1 行头）——帧边界错位/单帧容器都会触发 corrupt Zstandard session log`;
+            }
+          } catch (e) {
+            frameBad = true;
+            frameNote = `首帧无法解压（${String(e.code || e.message).slice(0, 40)}）——与 harness 读取路径一致，启动会被拒绝`;
+          }
+        }
+      }
+      if (frameBad) {
+        report('session', 'S13', false,
+          `会话头存在但**首帧边界不合规**：${frameNote}`,
+          '优先从备份恢复；无备份时把整个会话目录移出 sessions/（隔离，勿删）后重启 dsh，再用本工具复查');
+      } else {
+        report('session', 'S13', true,
+          `会话头完整（type=session, version=${header.version ?? '?'}, id=${String(header.id ?? '').slice(0, 12)}）${frameNote}`);
+      }
     }
   }
   const calls = new Map(); const results2 = new Set(); let maxSeq = -1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moonquake2004/dsh-doctor",
-  "version": "0.4.14",
+  "version": "0.4.16",
   "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": [