@moonquake2004/dsh-doctor 0.4.25 → 0.4.27

package/dsh-doctor.mjs

@@ -246,11 +246,31 @@ function resolveProfile(name) {
  *  即 `@deepseek-ai/dsh-root`（`private: true`，非发布包）。**没有任何已发布包继承它**，
  *  所以 registry 查不到、npm 安装时既不校验也不警告；这正是社区里"没有 engines"印象的由来。
  *  我们内置的范围与之一致（等于官方声明值），但它是**手写维护**的：上游改动时需同步。 */
-function nodeInSupportedRange(v) {
+/**
+ * 支持范围。默认是**内置常量**（出处与核对日期见上一条注释）；若设置了
+ * `DSH_DOCTOR_HARNESS_ROOT` 指向 harness 检出，则**真读**其仓库根 package.json 的
+ * `engines.node` —— 这是社区建议的方向（#6651 @ciceroyang）：手维护的常量会随上游漂移，
+ * 能读元数据就别抄数字。真正的解法仍是 #2259（让**已发布**的入口包带上 engines）。
+ */
+const NODE_RANGE_FALLBACK = '^22.19.0 || >=24.0.0'; // 核对日期 2026-09-15（master）
+function nodeRangeSource() {
+  const root = process.env.DSH_DOCTOR_HARNESS_ROOT;
+  if (root) {
+    try {
+      const e = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8')).engines?.node;
+      if (typeof e === 'string' && e.trim()) return { range: e.trim(), from: `真读 ${root}/package.json` };
+    } catch { /* 落到内置常量 */ }
+  }
+  return { range: NODE_RANGE_FALLBACK, from: '内置常量（出处：仓库根 package.json engines.node，核对 2026-09-15）' };
+}
+function nodeInSupportedRange(v, range = NODE_RANGE_FALLBACK) {
   const m = /^v?(\d+)\.(\d+)\.(\d+)/.exec(String(v));
   if (!m) return false;
   const major = Number(m[1]); const minor = Number(m[2]);
-  return (major === 22 && minor >= 19) || major >= 24;
+  // 规则来自该范围本身（^22.19.0 || >=24.0.0）：22.19+ 或 24+
+  if (range === NODE_RANGE_FALLBACK) return (major === 22 && minor >= 19) || major >= 24;
+  const cur = { nums: [Number(m[1]), Number(m[2]), Number(m[3])], pre: [] };
+  return peerRangeState(String(v).replace(/^v/, ''), range).state === 'satisfied';
 }
 function checkEnv() {
   if (!wants('env')) return;
@@ -265,12 +285,29 @@ function checkEnv() {
     report('env', 'E2-env', !isDir, isDir ? `${envFile} 是目录，dsh 启动会报 failed to load .env: EISDIR（#71）` : `${envFile} 正常`, isDir ? '删除或改名该目录' : undefined);
   }
   const nv = spawnSync('node', ['-e', 'console.log(process.version)']);
+  // 支持范围：优先**从仓库根 manifest 真读**（若给了 DSH_DOCTOR_HARNESS_ROOT 或存在检出），
+  // 否则用内置常量。社区（#6651 @ciceroyang）指出：两个实现都把这个范围写成手维护常量，
+  // 上游一改就各自漂移；真正的解法在 #2259（让已发布的入口包带上 engines，从而可读安装树元数据）。
+  // 在那之前，任何写死它的地方都必须标注**出处与核对日期**。
+  const RANGE_FALLBACK = '^22.19.0 || >=24.0.0';   // 出处：deepseek-harness 仓库根 package.json engines.node（@deepseek-ai/dsh-root，private）；核对日期 2026-09-15（master）
+  const rangeInfo = (() => {
+    const root = process.env.DSH_DOCTOR_HARNESS_ROOT;
+    if (root) {
+      try {
+        const e = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8')).engines?.node;
+        if (typeof e === 'string' && e.trim()) return { range: e.trim(), from: `${root}/package.json（真读）` };
+      } catch { /* 落到内置 */ }
+    }
+    return { range: RANGE_FALLBACK, from: '内置常量（出处：仓库根 package.json engines.node；核对日期 2026-09-15）' };
+  })();
+
   if (nv.status === 0) {
     const version = String(nv.stdout).trim();
-    const supported = nodeInSupportedRange(version);
+    const rangeSrc = nodeRangeSource();
+    const supported = nodeInSupportedRange(version, rangeSrc.range);
     report('env', 'E3-node', supported,
-      supported ? `node ${version}（满足声明范围 ^22.19.0 || >=24.0.0——出处为仓库根私有 workspace package.json 的 engines，#2259）` : `node ${version} 不在支持范围（^22.19.0 || >=24.0.0，v1 词汇表）——会话日志读取等能力受限`,
-      supported ? undefined : '升级 node 到 ^22.19.0 或 >=24.0.0（仓库根 engines 声明的范围，见 #2259）');
+      supported ? `node ${version}（满足 ${rangeSrc.range}——${rangeSrc.from}；该范围声明在私有 workspace 上、无发布物继承，见 #2259/#6651）` : `node ${version} 不在支持范围（^22.19.0 || >=24.0.0，v1 词汇表）——会话日志读取等能力受限`,
+      supported ? undefined : `升级 node 到 ${rangeSrc.range}（${rangeSrc.from}，见 #2259）`);
   }
 
   // E12：运行时 zstd 稳定性（#6651 的运行时线索）
@@ -639,18 +676,34 @@ function checkProfile(name) {
         findings19.push(`${pkgName} 声明 ${hostName} ${range}，但实际提供 ${host.version}`);
       }
     }
+    // 规则 1（作者侧）：未声明 host 范围 = **无信息**，不得当作兼容。这里只做计数提示，
+    // 不生成发现——声明与否是作者的选择，消费者该做的是别把它读成"已核对"。
+    let undeclared19 = 0;
+    for (const { dir: pkgDir } of pkgDirs19) {
+      try {
+        const mf = JSON.parse(readFileSync(join(pkgDir, 'package.json'), 'utf8'));
+        const isBundle = Boolean(mf.dsh && (mf.dsh.bundle || mf.dsh.profile));
+        const hasHostPeer = Object.keys(mf.peerDependencies ?? {}).some((k) => k.startsWith('@deepseek-ai/'));
+        if (isBundle && !hasHostPeer) undeclared19++;
+      } catch { /* 忽略不可读 */ }
+    }
+    const undeclaredNote = undeclared19
+      ? `\n  （另有 ${undeclared19} 个 bundle 未声明任何 @deepseek-ai/* host 范围——按规则记为"无信息"，不代表兼容）`
+      : '';
     if (findings19.length) {
       report('profile', 'P19', false,
         `插件声明的 host peer 范围不接受实际安装的核心版本（${findings19.length} 处，共核对 ${checked19} 条 peer 声明）：\n  `
         + findings19.slice(0, 8).join('\n  ')
-        + (unknown19 ? `\n  （另有 ${unknown19} 条无法判定：区间为 * / 未声明 / host 解析不到，或纯 release 区间面对预发布版本——按"未知"处理，不计为不兼容）` : ''),
+        + undeclaredNote
+        + (unknown19 ? `\n  （另有 ${unknown19} 条无法判定：区间为 * / 不可解析 / host 解析不到，或纯 release 组面对数值满足的预发布版本——按"未知"处理，不计为不兼容）` : ''),
         '按提示升级到该插件声明支持的版本（或降级核心）。安装时不会有警告，所以升级 dsh 前先用本检查看一眼最省事');
     } else if (checked19 === 0) {
       reportSkip('profile', 'P19', '未见任何 @deepseek-ai/* 的 peer 声明，跳过 host 范围核对');
     } else {
       report('profile', 'P19', true,
         `核对 ${checked19} 条 host peer 声明，均可接受当前核心版本`
-        + (unknown19 ? `（${unknown19} 条无法判定，按未知处理未计入）` : ''));
+        + (unknown19 ? `（${unknown19} 条无法判定，按未知处理未计入）` : '')
+        + undeclaredNote.replace(/\n\s*/g, ' '));
     }
   }
 

package/package.json

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