dsh-selfupdater 0.4.27 → 0.4.29

package/lib/updater.mjs

@@ -15,6 +15,7 @@ import net from 'node:net';
 import { appendFileSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync
 , rmSync, writeFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
+import { homedir } from 'node:os';
 import { fileURLToPath } from 'node:url';
 import { applyFnosPatches } from './fnos-patches.mjs';
 
@@ -227,6 +228,35 @@ function pnpmCommand() {
     throw new Error('找不到随应用打包的 pnpm，无法在 staging 安装新版');
 }
 
+/**
+ * 确保 koffi 编译所需的 cmake 可用：koffi 的 cnoke 构建系统依赖 CMake >= 3.10，
+ * 其 npm 包内只有编译头文件、没有预编译二进制，NAS 缺 cmake 时脚本会静默失败
+ * （pnpm 对失败的构建脚本仅告警不拦截），导致换装后的宿主 boot 崩溃。
+ * - 已存在 → 返回 null（无需注入 PATH）；
+ * - 缺失 → 尝试 python3 -m pip install --user cmake（Debian 12+ 需
+ *   --break-system-packages 绕过 PEP 668），成功后把 ~/.local/bin 前置进 PATH；
+ * - 仍不可用 → 抛错并给出手动安装指引（此时尚未开始下载，升级干净中止）。
+ * @returns {Promise<string|null>} 需要前置到 PATH 的目录（无需时为 null）
+ */
+async function ensureCmake() {
+    const localBin = join(process.env.HOME || homedir(), '.local', 'bin');
+    const probe = (extraEnv) => runCommand('cmake', ['--version'],
+        extraEnv ? { env: { ...process.env, ...extraEnv } } : {});
+    if ((await probe()).code === 0) return null;
+    log('[preflight] 未检测到 cmake（koffi 编译必需），尝试 python3 -m pip install --user cmake …');
+    for (const extra of [['--break-system-packages'], []]) {
+        const r = await runCommand('python3', ['-m', 'pip', 'install', '--user', 'cmake', ...extra], {});
+        if (r.code === 0) break;
+        log(`[preflight] pip 安装 cmake 失败: ${(r.stderr || r.stdout || '').trim().slice(-200)}`);
+    }
+    const localEnv = { PATH: `${localBin}:${process.env.PATH ?? ''}` };
+    if ((await probe(localEnv)).code === 0) {
+        log('[preflight] cmake 已通过 pip --user 安装并注入本次安装的 PATH');
+        return localBin;
+    }
+    throw new Error('NAS 缺少 cmake（koffi 编译必需，自动安装失败）。请 SSH 执行: sudo apt-get update && sudo apt-get install -y cmake 后重试升级');
+}
+
 /* ------------------------------------------------------------------ *
  * 升级各阶段
  * ------------------------------------------------------------------ */
@@ -332,6 +362,9 @@ async function downloadIntoStaging(target, registryBase) {
     // 构建产物跨版本污染），保证无人值守可执行。
     writeFileSync(join(stagingDir, '.npmrc'), 'node-linker=hoisted\nside-effects-cache=false\n');
     const pnpm = pnpmCommand();
+    // koffi 需要 cmake 才能编译（fs-ext 走 node-gyp，工具链通常已随系统就绪）；
+    // 缺失时先尝试自动补齐，避免装完才发现缺产物再回滚一次。
+    const cmakePath = await ensureCmake();
     setState('downloading', `正在下载 ${PKG}@${target} …`);
     // pnpm 不认 npm 风格的 --omit/--no-audit/--no-fund（0.4.18 实测踩坑）：
     // 排除 dev 依赖用 --prod；--registry 让安装与版本查询走同一个源，
@@ -343,11 +376,21 @@ async function downloadIntoStaging(target, registryBase) {
         ...(registryBase ? ['--registry', registryBase] : []),
     ], {
         cwd: stagingDir,
-        env: { ...process.env, CI: 'true', npm_config_node_linker: 'hoisted' },
+        env: {
+            ...process.env,
+            CI: 'true',
+            npm_config_node_linker: 'hoisted',
+            ...(cmakePath ? { PATH: `${cmakePath}:${process.env.PATH ?? ''}` } : {}),
+        },
     });
     if (result.code !== 0) {
         throw new Error(`staging 安装失败(pnpm exit ${result.code}): ${result.stderr.slice(-400)}`);
     }
+    // pnpm 对失败的构建脚本仅告警不拦截（cnoke 缺 cmake 时就是这样静默失败的），
+    // 必须把输出尾部落盘，问题才可诊断。尾部保留 3000 字符：500 字符在多包
+    // 并行构建时会截掉关键包的输出（0.4.28 排查 koffi 时被截断坑了一把）。
+    if (result.stdout.trim()) log(`[pnpm] 输出尾部: ${result.stdout.trim().slice(-3000).replace(/\s*\n+\s*/g, ' | ')}`);
+    if (result.stderr.trim()) log(`[pnpm] 告警尾部: ${result.stderr.trim().slice(-3000).replace(/\s*\n+\s*/g, ' | ')}`);
     // 校验装到的确实是目标版本，防止镜像滞后悄悄装了旧版。
     const staged = JSON.parse(readFileSync(join(stagingDir, 'node_modules', PKG, 'package.json'), 'utf8')).version;
     if (staged !== target) throw new Error(`staging 版本不符：期望 ${target}，实际 ${staged}`);
@@ -356,16 +399,38 @@ async function downloadIntoStaging(target, registryBase) {
     verifyNativeModules();
 }
 
+/**
+ * koffi 原生二进制存在性校验（2.x / 3.x 双结构兼容）。
+ * - 2.x：cnoke 把 prebuild 解压到 koffi/build/koffi/<平台>/koffi.node；
+ * - 3.x 起架构重构：二进制改为 @koromix/koffi-<os>-<arch> 平台子包分发
+ *   （esbuild 模式），主包 build/ 下不再落任何 .node —— 只认老路径会把
+ *   装好的 3.x 误判为缺失（0.4.28 实测踩坑，升级被自家校验拦下）。
+ * 任一结构命中即视为齐备。
+ */
+function koffiBinaryFound() {
+    // 2.x 老结构：build/ 下递归找 .node
+    if (findFileByExt(join(stagingDir, 'node_modules', 'koffi', 'build'), '.node')) return true;
+    // 3.x 新结构：@koromix/koffi-<os>-<arch> 平台子包任一含 .node 即通过
+    try {
+        const koromixDir = join(stagingDir, 'node_modules', '@koromix');
+        for (const entry of readdirSync(koromixDir, { withFileTypes: true })) {
+            if (entry.isDirectory() && entry.name.startsWith('koffi-')
+                && findFileByExt(join(koromixDir, entry.name), '.node')) return true;
+        }
+    } catch { /* 无 @koromix 目录：2.x 或平台包未装上 */ }
+    return false;
+}
+
 /**
  * 校验 staging 内原生模块的构建产物是否齐全。
- * - koffi：cnoke --prebuild 从 vendor 解压，产物在 build/koffi/ 下的 .node；
+ * - koffi：见 koffiBinaryFound（2.x/3.x 双结构兼容）；
  * - fs-ext：node-gyp 编译，产物在 build/Release/fs-ext.node（NAS 需编译工具链）。
  * 任一缺失即抛错，终止本次升级（尚未换装，旧版原样运行，天然安全）。
  */
 function verifyNativeModules() {
     const problems = [];
-    if (!findFileByExt(join(stagingDir, 'node_modules', 'koffi', 'build'), '.node')) {
-        problems.push('koffi 缺少原生二进制（install 脚本未执行或 prebuild 解压失败）');
+    if (!koffiBinaryFound()) {
+        problems.push('koffi 缺少原生二进制（install 脚本未执行或平台子包未装上）');
     }
     const fsExtDir = join(stagingDir, 'node_modules', 'fs-ext');
     if (!existsSync(join(fsExtDir, 'fs-ext.js'))) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-selfupdater",
-  "version": "0.4.27",
+  "version": "0.4.29",
   "description": "Self-update plugin for DeepSeek Harness: DSH core upgrades via detached swap script; plugin self-update installs in-place without killing the host and prompts for restart. DSH 主程序与已装插件的一站式在线更新插件。",
   "license": "MIT",
   "type": "module",