@moonquake2004/dsh-doctor 0.4.10 → 0.4.14

package/dsh-doctor.mjs

@@ -212,6 +212,15 @@ function readableSessionEventTypes() {
 
 const READABLE = readableSessionEventTypes();
 
+/**
+ * 是否存在值得诊断的 DSH 环境（真实用户机器有 sessions/ 或 settings.yaml；干净容器/仓库检出没有）。
+ * 以传入的 home 为准：探针应当判断"它被告知的那个环境"，而不是进程全局的 HOME ——
+ * 这样单测可以显式构造两种环境，fixture 也不会被真实 HOME 的状态污染。
+ */
+function hasDshEnvironment(home = HOME) {
+  return existsSync(join(home, 'sessions')) || existsSync(join(home, 'settings.yaml'));
+}
+
 function report(section, id, ok, detail, fix, src) {
   results.push({ section, id, ok, detail, fix, src: src ?? 'builtin' });
 }
@@ -1140,6 +1149,23 @@ function checkSession(targetPath) {
   } else {
     report('session', 'S9', true, '非 zstd 输入，跳过容器检查', undefined);
   }
+
+  // S13：会话头完整性（#6651）——首行必须是 {"type":"session",...}
+  // 实测：首行被写成事件时 dsh-doctor 的其余 S 检查**全部照常通过**（它们看的是事件流），
+  // S11 甚至会报"均健康"；而 harness 侧会 `corrupt Zstandard session log` 直接拒绝启动 `dsh web`。
+  {
+    const firstLine = String(text).split('\n').find((l) => l.trim());
+    let header = null;
+    try { header = firstLine ? JSON.parse(firstLine) : null; } catch { header = null; }
+    if (!header || header.type !== 'session') {
+      report('session', 'S13', false,
+        `日志首行不是会话头（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)}）`);
+    }
+  }
   const calls = new Map(); const results2 = new Set(); let maxSeq = -1;
   const turnStarts = new Set(); const turnEnds = new Set();
   const positions = []; const endSeedSeqs = [];
@@ -1453,11 +1479,17 @@ function scanAllSessions() {
     totalDS += ds;
     // 轻量损坏扫描：seq==index + end-seed 重放 + 未知类型
     const problems = [];
+    let firstRowSeen = false;
     let evIndex = 0, lastSeed = -1, seedIdx = -1, posList = [];
     const lines = text.split('\n');
     for (let li = 0; li < lines.length; li++) {
       const ln = lines[li]; if (!ln.trim()) continue;
       let d; try { d = JSON.parse(ln); } catch { problems.push(`行 ${li + 1} 无法解析`); continue; }
+      // #6651：首行必须是会话头——否则 harness 拒绝启动 dsh web，而其余检查看不出问题
+      if (!firstRowSeen) {
+        firstRowSeen = true;
+        if (d.type !== 'session') problems.push(`首行不是会话头（#6651 启动阻断，实际 type=${d.type}）`);
+      }
       if (!STORAGE_ROW_TYPES.has(d.type) && !READABLE.has(d.type) && d.ignorable !== true) problems.push(`未知类型 ${d.type}`);
       if (d.type === 'session/end-seed' && typeof d.seq === 'number') { lastSeed = d.seq; seedIdx = posList.length; }
       const t = d.type;
@@ -1647,8 +1679,14 @@ export function runCatalogCheck(check, ctx) {
   switch (probe.type) {
     case 'command-exists': {
       const found = findCommand(probe.cmd);
-      return found ? { ok: true, detail: check.detailOk ?? `${probe.cmd} 在 PATH: ${found}` }
-                   : { ok: false, detail: check.detailFail ?? `${probe.cmd} 不在 PATH` };
+      if (found) return { ok: true, detail: check.detailOk ?? `${probe.cmd} 在 PATH: ${found}` };
+      // 无 DSH 环境可言时 skip（2026-09）：在干净容器/仓库检出里跑本工具时，dsh 当然不在 PATH ——
+      // 那不是"用户环境有问题"，而是"这里没有被诊断的 DSH 环境"。据此报 error 会让 CI 与 fixture
+      // 得到无意义的失败（CI 三次红都源于同类检查：E4 → E1-pnpm → E7）。
+      if (!hasDshEnvironment(ctx?.home ?? HOME)) {
+        return { skipped: true, detail: `未发现 DSH 环境（无 sessions/ 与 settings.yaml），跳过 ${probe.cmd} 的 PATH 检查` };
+      }
+      return { ok: false, detail: check.detailFail ?? `${probe.cmd} 不在 PATH` };
     }
     case 'path-exists':
     case 'path-is-dir':
@@ -2021,7 +2059,13 @@ async function run() {
     console.log(JSON.stringify(out, null, 2));
     process.exit(exitCode);
   } else if (jsonOut) {
-    console.log(JSON.stringify({ ok: bad.length === 0 && secExit === 0, checks: results, catalog: catalogMeta, update: updateInfo, ...(securityMeta.enabled ? { security: securityMeta } : {}) }, null, 2));
+    // 每条检查带上 status（pass/warn/fail/skip，与 --envelope 同一词汇表）。
+    // 2026-09：此前 --json 只给 ok 布尔，消费者（含我们自己的测试助手）无法区分
+    // "warn 级失败"（如 CI 上无 pnpm → E1-pnpm warn，不翻退出码）与"error 级失败"，
+    // 于是把 warn 当成误报。状态本就不该由消费者自行推导。
+    const statusOf = (r) => (r.skip ? 'skip' : (!r.ok ? (((r.section === 'security') ? r.severity !== 'critical' : catalogSeverity.get(r.id) === 'warn') ? 'warn' : 'fail') : 'pass'));
+    const checksWithStatus = results.map((r) => ({ ...r, status: statusOf(r) }));
+    console.log(JSON.stringify({ ok: bad.length === 0 && secExit === 0, checks: checksWithStatus, catalog: catalogMeta, update: updateInfo, ...(securityMeta.enabled ? { security: securityMeta } : {}) }, null, 2));
   } else {
     const sectionOrder = { env: 0, profile: 1, session: 2, catalog: 3 };
     const ordered = [...results].sort((a, b) => (sectionOrder[a.section] ?? 9) - (sectionOrder[b.section] ?? 9));

package/package.json

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