dsh-selfupdater 0.3.4 → 0.4.6

package/client/settings-card.js

@@ -224,6 +224,8 @@ const CARD_CSS = `
 .dshsu-pill{font-size:12px;padding:2px 9px;border-radius:999px;white-space:nowrap}
 .dshsu-pill-ok{color:var(--dshsu-success);background:var(--dshsu-success-soft)}
 .dshsu-pill-bad{color:var(--dshsu-danger);background:var(--dshsu-danger-soft)}
+/* 待重启徽章：琥珀色提醒"新版已装好，重启后生效" */
+.dshsu-pill-new{color:var(--dshsu-warn);background:var(--dshsu-warn-soft);font-weight:600}
 /* ---- 单卡片内两个小节之间的分隔线（随主题换肤） ---- */
 .dshsu-divider{height:1px;background:var(--dshsu-border);margin:4px 0}
 /* 单卡片内的插件小节容器：只负责纵向排布，不画边框（边框属于整张卡片）。 */
@@ -280,6 +282,7 @@ const STATE_LABELS = {
     rollback: '升级失败，正在回滚…',
     done: '升级完成',
     done_failed: '已回滚到旧版本',
+    done_pending_restart: '已更新，等待重启生效',
     error: '升级出错',
 };
 
@@ -459,8 +462,10 @@ function formatTime(iso) {
  * 展示模板与 DSH 小节同款三行：当前版本 / 最新版本 / 上次检查。
  * ------------------------------------------------------------------ */
 
-/** 插件更新进行中的状态集合（与后端锁文件/state 约定一致）。 */
-const PLUGIN_BUSY_STATES = ['running', 'downloading', 'restarting', 'healthcheck', 'rollback'];
+/** 插件更新进行中的状态集合（与后端锁文件/state 约定一致）。
+ *  注意：done_pending_restart 是"已装好、等重启"的终态，不算进行中；
+ *  swapping 是 v0.4.6 进程内安装阶段的 state，需要视为忙碌。 */
+const PLUGIN_BUSY_STATES = ['running', 'downloading', 'swapping', 'healthcheck', 'rollback'];
 
 /**
  * 插件更新小节：数据契约与 DSH 小节一致
@@ -471,10 +476,12 @@ const PLUGIN_BUSY_STATES = ['running', 'downloading', 'restarting', 'healthcheck
  */
 function PluginSection({ t, plugin, busy, checking, msg, onCheck, onUpgrade }) {
     const updateAvailable = plugin?.updateAvailable === true;
-    // 结果消息的语义着色：成功绿 / 失败红 / 其余灰。
-    const msgClass = /已是最新|完成|成功/.test(msg) ? ' dshsu-msg-ok'
+    // 结果消息的语义着色：成功绿（含"待重启生效"类提示）/ 失败红 / 其余灰。
+    const msgClass = /已是最新|完成|成功|无需更新|生效/.test(msg) ? ' dshsu-msg-ok'
         : /失败|出错|错误|超时/.test(msg) ? ' dshsu-msg-bad'
             : '';
+    // 已装好新版但宿主未重启：右侧给出醒目的"待重启"徽章提示。
+    const pendingRestart = plugin?.state === 'done_pending_restart';
 
     return h('div', { className: 'dshsu-sub' },
         // 小节标题：拼图图标 + 右侧版本号徽章（有新版时变琥珀色提示）
@@ -527,6 +534,8 @@ function PluginSection({ t, plugin, busy, checking, msg, onCheck, onUpgrade }) {
                 onClick: onUpgrade,
             }, t.upgradeNow),
             h('span', { className: 'dshsu-spacer' }),
+            // 待重启徽章：提醒用户重启 DeepSeek Harness 后新版本才会生效
+            pendingRestart ? h('span', { className: 'dshsu-pill dshsu-pill-new' }, t.pendingRestart) : null,
         ),
     );
 }
@@ -545,6 +554,7 @@ const FALLBACK_DICT = {
         pluginNav: '插件更新',
         pluginUpdating: '插件更新进行中…', checkingLabel: '正在检查更新…',
         checkFailed: '检查更新失败',
+        pendingRestart: '重启后生效',
         // 侧边导航文案：现在只有一张"版本更新"卡片。
         cardNav: '版本更新',
     },
@@ -556,6 +566,7 @@ const FALLBACK_DICT = {
         pluginNav: 'Plugin Updates',
         pluginUpdating: 'Plugin update in progress…', checkingLabel: 'Checking…',
         checkFailed: 'Check failed',
+        pendingRestart: 'Restart to apply',
         // Side navigation label: there is now only one "Updates" card.
         cardNav: 'Updates',
     },
@@ -659,12 +670,12 @@ function apply(ctx) {
         }
     }
 
-    /** 一键升级全部插件：受理成功后进入 2 秒高频轮询等结果。 */
+    /** 一键升级自身：v0.4.6 起服务保持运行，更新完成后提示重启生效。 */
     async function handlePluginUpgrade() {
         try {
             await api('/plugins/update', { method: 'POST', body: '{}' });
             pluginMsg = '';
-            // 服务即将退出；进入高频轮询等新进程起来后自动恢复进度展示。
+            // 后台任务运行期间高频轮询进度，直至出现 done_pending_restart / error 终态。
             setTimeout(pluginPollLoop, POLL_ACTIVE_MS);
         } catch (err) {
             console.warn(`[${NS}] 触发插件更新失败:`, err);
@@ -716,6 +727,7 @@ function apply(ctx) {
                 updateAvailable: dict('updateAvailable'), upgraded: dict('upgraded'), failed: dict('failed'),
                 pluginNav: dict('pluginNav'),
                 pluginUpdating: dict('pluginUpdating'), checkingLabel: dict('checkingLabel'),
+                pendingRestart: dict('pendingRestart'),
             },
             status: latestStatus,
             busy: isBusyState(latestStatus),

package/lib/index.js

@@ -1,75 +1,29 @@
 /**
  * dsh-selfupdater 宿主入口：注册 HTTP 路由，桥接浏览器设置卡片与升级脚本。
  *
- * 职责边界：本文件只做"读状态 / 查版本 / 触发升级"，真正的
- * 下载-换目录-重启-回滚全部由分离进程 lib/updater.mjs 完成（原因：
- * 要替换的是 DSH 自己脚下的 node_modules，必须先让 DSH 退出）。
+ * 职责边界：
+ * - 主程序（@deepseek-ai/dsh）升级：要替换的是 DSH 自己脚下的 node_modules，
+ *   必须先让 DSH 退出，因此仍走分离进程 lib/updater.mjs（自杀→接管→复活链路）；
+ * - 插件（dsh-selfupdater 自己）更新：v0.4.6 起改为进程内原地安装
+ *   （lib/plugin-update-task.mjs），全程不杀宿主、不 rename profile，
+ *   完成后提示用户重启生效 —— 参照 dshmarket 的成熟做法，
+ *   规避与飞牛OS 守护进程拉起实例的端口竞态。
  *
  * 安全模型（与 dshmarket lib/http.js 完全一致）：
  * - POST 接口仅接受 same-origin 请求（Origin 与 Host 头一致）；
  * - 升级动作通过锁文件防并发，双端校验。
  */
 import { spawn } from 'node:child_process';
-import { createRequire } from 'node:module';
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { basename, dirname, join, resolve } from 'node:path';
+import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { fetchLatestVersion, installedSelfVersion, isNewer, runPluginUpdateTask } from './plugin-update-task.mjs';
 
 export const name = 'dsh-selfupdater';
 
 const PLUGIN_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
 /** 要升级的主程序包名。 */
 const PKG = '@deepseek-ai/dsh';
-/** npm registry 查询超时。 */
-const FETCH_TIMEOUT_MS = 15000;
-/** 国内 npm 镜像（腾讯云），registry.npmjs.org 直连超时时的第一回退。 */
-const NPM_CHINA_MIRROR = 'https://mirrors.cloud.tencent.com/npm';
-/** 插件所在的 profile 名（与 runner.js 的 DSH_PLUGIN_PROFILE 约定一致）。 */
-const PLUGIN_PROFILE = process.env.DSH_PLUGIN_PROFILE ?? 'web';
-
-/* ------------------------------------------------------------------ *
- * semver 比较（零依赖，与 updater.mjs 内实现保持一致）
- * ------------------------------------------------------------------ */
-
-const SEMVER_RE = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
-
-function parseSemver(v) {
-    const m = SEMVER_RE.exec(String(v ?? '').trim());
-    if (m === null) return null;
-    return {
-        core: [Number(m[1]), Number(m[2]), Number(m[3])],
-        pre: m[4] === undefined ? [] : m[4].split('.'),
-    };
-}
-
-/** 返回负数/0/正数；任一侧非法返回 null。 */
-function compareVersions(a, b) {
-    const pa = parseSemver(a);
-    const pb = parseSemver(b);
-    if (pa === null || pb === null) return null;
-    for (let i = 0; i < 3; i++) {
-        if (pa.core[i] !== pb.core[i]) return pa.core[i] - pb.core[i];
-    }
-    if (pa.pre.length === 0 || pb.pre.length === 0) return pb.pre.length - pa.pre.length;
-    for (let i = 0; i < Math.max(pa.pre.length, pb.pre.length); i++) {
-        const x = pa.pre[i];
-        const y = pb.pre[i];
-        if (x === undefined) return -1;
-        if (y === undefined) return 1;
-        if (x === y) continue;
-        const nx = /^\d+$/.test(x);
-        const ny = /^\d+$/.test(y);
-        if (nx && ny) return Number(x) - Number(y);
-        if (nx !== ny) return nx ? -1 : 1;
-        return x < y ? -1 : 1;
-    }
-    return 0;
-}
-
-function isNewer(latest, installed) {
-    const cmp = compareVersions(latest, installed);
-    return cmp !== null && cmp > 0;
-}
 
 /* ------------------------------------------------------------------ *
  * HTTP 工具（照搬 dshmarket lib/http.js）
@@ -105,16 +59,6 @@ function sameOrigin(request) {
  * 状态与路径解析
  * ------------------------------------------------------------------ */
 
-/** 从 --profile 参数读取宿主实际启动的 profile（与 dshmarket 相同的兜底逻辑）。 */
-function argvProfile() {
-    const argv = process.argv;
-    const flag = argv.indexOf('--profile');
-    if (flag !== -1 && flag + 1 < argv.length && !argv[flag + 1].startsWith('-')) {
-        return argv[flag + 1];
-    }
-    return undefined;
-}
-
 /**
  * 定位 DSH 应用目录（node_modules 所在处）。
  * 优先 TRIM_APPDEST 环境变量；否则从本插件安装位置向上找 node_modules 边界。
@@ -168,44 +112,6 @@ function currentDshVersion(appDir) {
     }
 }
 
-/**
- * 查询 npm registry 最新版本号（带镜像回退，参照 dshmarket regions.ts 的做法）：
- * 1. 优先走环境变量 DSHSU_REGISTRY_URL 指定的镜像（部署方可自行指定国内源）；
- * 2. 默认先试腾讯云国内镜像（飞牛OS 部署多在国内网络，直连 registry.npmjs.org
- *    经常超时——这正是"检查更新没反应"的常见原因）；
- * 3. 镜像失败后回退官方源，保证海外网络也能用。
- */
-async function fetchLatestVersion(pkg) {
-    const errors = [];
-    for (const base of registryCandidates()) {
-        try {
-            return await fetchFromRegistry(base, pkg);
-        } catch (err) {
-            errors.push(`${base}: ${err.message}`);
-        }
-    }
-    throw new Error(errors.join('；'));
-}
-
-/** 本次要依次尝试的 registry 地址列表（去重）。 */
-function registryCandidates() {
-    const custom = process.env.DSHSU_REGISTRY_URL?.replace(/\/+$/, '');
-    const list = [custom, NPM_CHINA_MIRROR, 'https://registry.npmjs.org'];
-    return [...new Set(list.filter((v) => typeof v === 'string' && v !== ''))];
-}
-
-/** 从单个 registry 取 latest 版本号。 */
-async function fetchFromRegistry(base, pkg) {
-    const res = await fetch(`${base}/${encodeURIComponent(pkg)}`, {
-        headers: { accept: 'application/json', 'user-agent': 'dsh-selfupdater' },
-        signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
-    });
-    if (!res.ok) throw new Error(`HTTP ${res.status}`);
-    const doc = await res.json();
-    const latest = doc?.['dist-tags']?.latest;
-    if (typeof latest !== 'string' || latest === '') throw new Error('未返回 latest');
-    return latest;
-}
 /** 读升级状态文件（不存在时返回空对象）。 */
 function readStatus(dshStateDir) {
     try {
@@ -232,7 +138,7 @@ function writeStatus(dshStateDir, payload) {
 }
 
 /* ------------------------------------------------------------------ *
- * 插件更新（与主程序升级共用同一入口，但走独立的状态/锁/升级脚本）
+ * 插件更新（自身一键更新；v0.4.6 起由进程内任务完成，见 plugin-update-task.mjs）
  * ------------------------------------------------------------------ */
 
 /** 读插件状态文件（不存在时返回空对象）。 */
@@ -254,21 +160,6 @@ function writePluginStatus(dshStateDir, payload) {
     }
 }
 
-/**
- * 读本插件自身的已装版本：优先 import 自己的 package.json（ESM 顶层 await
- * 不适合这里，改用 createRequire 同步读取），失败时回退硬编码兜底值。
- * 用途：让"检测更新"能覆盖 dsh-selfupdater 自己 —— 此前清单来自 profile
- * 的 dependencies，但"检测自己"语义上不依赖那份清单。
- */
-function readOwnVersion() {
-    try {
-        const require = createRequire(import.meta.url);
-        return require('../package.json').version;
-    } catch {
-        return '0.0.0';
-    }
-}
-
 /* ------------------------------------------------------------------ *
  * apply 入口
  * ------------------------------------------------------------------ */
@@ -286,9 +177,13 @@ export function apply(ctx) {
         const lockFile = join(dshStateDir, 'selfupdate.lock');
         const pluginLockFile = join(dshStateDir, 'pluginupdate.lock');
         const port = servicePort();
-        /** 本插件的包名与已装版本（用于"检测自己"的更新能力）。 */
+        /** 本插件的包名（用于"检测自己"的更新能力）。 */
         const SELF_NAME = name;
-        const SELF_INSTALLED = readOwnVersion();
+        /**
+         * 已安装的自身版本：每次请求实时读 profile 清单（而非模块加载时的快照）。
+         * 这样更新装好但宿主未重启时，UI 立即显示新版号，"检查更新"也不会误报。
+         */
+        const selfInstalled = () => installedSelfVersion(workspace);
 
         /** 升级是否正在进行（锁文件存在）。 */
         const isBusy = () => existsSync(lockFile);
@@ -411,11 +306,14 @@ export function apply(ctx) {
             const status = pluginStatusView();
             // 上次检查的缓存结果（latest / updateAvailable / checkedAt）存在 updates[SELF_NAME]。
             const cache = status.updates?.[SELF_NAME] ?? {};
+            const current = selfInstalled();
             sendJson(res, 200, {
                 name: SELF_NAME,
-                currentVersion: SELF_INSTALLED,
+                currentVersion: current,
                 latestVersion: cache.latestVersion ?? null,
-                updateAvailable: cache.updateAvailable === true,
+                // 检查缓存只对"已安装版本"有意义；若装好的新版还没重启
+                // （current 已是最新），就不能再按缓存说"有更新"。
+                updateAvailable: cache.updateAvailable === true && isNewer(cache.latestVersion, current),
                 lastCheck: cache.checkedAt ?? null,
                 busy: pluginBusy(),
                 state: status.state ?? 'idle',
@@ -433,21 +331,21 @@ export function apply(ctx) {
             // 只查自己这一个包，成功后把结果写入状态文件缓存。
             try {
                 const latestVersion = await fetchLatestVersion(SELF_NAME);
+                const hasUpdate = isNewer(latestVersion, selfInstalled());
                 writePluginStatus(dshStateDir, {
                     ...readPluginStatus(dshStateDir),
                     state: 'idle',
-                    message: isNewer(latestVersion, SELF_INSTALLED)
-                        ? `发现新版本 ${latestVersion}` : '当前已是最新',
+                    message: hasUpdate ? `发现新版本 ${latestVersion}` : '当前已是最新',
                     updates: {
                         [SELF_NAME]: {
                             latestVersion,
-                            updateAvailable: isNewer(latestVersion, SELF_INSTALLED),
+                            updateAvailable: hasUpdate,
                             checkedAt: new Date().toISOString(),
                         },
                     },
                     updatedAt: new Date().toISOString(),
                 });
-                sendJson(res, 200, { updatedCount: isNewer(latestVersion, SELF_INSTALLED) ? 1 : 0 });
+                sendJson(res, 200, { updatedCount: hasUpdate ? 1 : 0 });
             } catch (err) {
                 host.logger?.warn?.(`[dsh-selfupdater] 插件检查更新失败: ${err.message}`);
                 writePluginStatus(dshStateDir, {
@@ -461,6 +359,13 @@ export function apply(ctx) {
         });
 
         /* ---------- POST /dsh-selfupdater/plugins/update ---------- */
+        /**
+         * v0.4.6 重构：不再 spawn 分离脚本后 process.exit(0) 自杀。
+         * 旧链路（自杀→脚本接管→拉起 runner→健康检查→回滚）与飞牛OS
+         * 守护进程竞态，导致"更新失败+服务停摆+版本没变"。
+         * 新链路：202 应答后在本进程内原地安装新版（服务保持运行），
+         * 完成后状态置 done_pending_restart，由前端提示用户重启生效。
+         */
         registerRoute('POST', '/dsh-selfupdater/plugins/update', (req, res) => {
             if (!sameOrigin(req)) {
                 sendJson(res, 403, { error: 'untrusted request' });
@@ -474,7 +379,7 @@ export function apply(ctx) {
                 writePluginStatus(dshStateDir, {
                     ...readPluginStatus(dshStateDir),
                     state: 'running',
-                    message: '插件更新已受理，正在启动升级脚本…',
+                    message: '插件更新已受理…',
                     startedAt: new Date().toISOString(),
                 });
                 writeFileSync(pluginLockFile, JSON.stringify({ pid: process.pid, startedAt: Date.now(), by: 'plugin-update' }));
@@ -482,19 +387,11 @@ export function apply(ctx) {
                 sendJson(res, 500, { error: `写入锁文件失败：${err.message}` });
                 return;
             }
-            const child = spawn(process.execPath, [
-                join(PLUGIN_ROOT, 'lib', 'plugin-updater.mjs'),
-                '--pid', String(process.pid),
-                '--app-dir', appDir,
-                '--workspace', workspace,
-                '--port', String(port),
-            ], { detached: true, stdio: 'ignore', env: process.env });
-            child.unref();
-
-            host.logger?.info?.(`[dsh-selfupdater] 插件更新进程已启动 pid=${child.pid}，DSH 即将退出`);
-            // 与主程序升级一致：给 spawn 落稳时间后主动退出，让脚本接管重启链。
-            setTimeout(() => process.exit(0), 800);
-            sendJson(res, 202, { accepted: true, note: '插件更新将由分离脚本执行并自动重启服务' });
+            // fire-and-forget：任务自行写状态文件并释放锁，失败不影响应答。
+            void runPluginUpdateTask({ appDir, workspace, logger: host.logger })
+                .catch((err) => host.logger?.warn?.(`[dsh-selfupdater] 插件更新任务异常: ${err.message}`));
+            host.logger?.info?.('[dsh-selfupdater] 插件更新任务已在进程内启动（服务保持运行）');
+            sendJson(res, 202, { accepted: true, note: '更新在后台进行，完成后需重启 DeepSeek Harness 生效' });
         });
 
         host.logger?.info?.('[dsh-selfupdater] 路由已挂载');

package/lib/plugin-update-task.mjs

@@ -0,0 +1,333 @@
+/**
+ * 进程内插件更新任务（v0.4.6 起取代旧的分离进程 plugin-updater.mjs）。
+ *
+ * 【为什么改架构】旧流程：spawn 分离脚本 → DSH 自杀式 process.exit(0) →
+ * 脚本等端口释放 → 拉起 runner → 健康检查 → 失败回滚。在飞牛OS 上与系统
+ * 守护进程形成竞态：守护检测到 DSH 死亡会立刻拉起新实例占住端口，脚本随后
+ * 误判失败并触发回滚，最终表现为"更新失败 + 服务停摆 + 版本没变"。
+ *
+ * 【新流程】参照插件市场 dshmarket 的成熟做法：
+ * 全程不杀宿主进程、不 rename 现有 profile，只在原地把新版 tgz 装入
+ * profile（Node 已加载的旧代码继续运行不受影响），装完校验后置状态
+ * done_pending_restart，由前端提示用户重启 DeepSeek Harness 使新版本生效。
+ *
+ * 同时提供"检查更新"用的版本查询能力：
+ * 一律走 /latest 版本级端点 —— 整包 packument 会被 Fastly 等 CDN 长时间
+ * 缓存，导致"新版本已发布却查不到"（0.4.5 发布后被误判未发布的根因）。
+ */
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+/** 本插件包名（更新的目标就是自己）。 */
+export const SELF_NAME = 'dsh-selfupdater';
+/** npm registry 查询超时。 */
+const FETCH_TIMEOUT_MS = 15000;
+/** tgz 下载超时。 */
+const DOWNLOAD_TIMEOUT_MS = 180000;
+/** dsh plugin add 安装命令超时。 */
+const INSTALL_TIMEOUT_MS = 300000;
+/** 国内 npm 镜像（腾讯云），直连官方源超时时的第一回退。 */
+const NPM_CHINA_MIRROR = 'https://mirrors.cloud.tencent.com/npm';
+
+/* ------------------------------------------------------------------ *
+ * semver 比较（零依赖；从 index.js 迁移过来，供两处共用）
+ * ------------------------------------------------------------------ */
+
+const SEMVER_RE = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
+
+function parseSemver(v) {
+    const m = SEMVER_RE.exec(String(v ?? '').trim());
+    if (m === null) return null;
+    return {
+        core: [Number(m[1]), Number(m[2]), Number(m[3])],
+        pre: m[4] === undefined ? [] : m[4].split('.'),
+    };
+}
+
+/** 返回负数/0/正数；任一侧非法返回 null。 */
+function compareVersions(a, b) {
+    const pa = parseSemver(a);
+    const pb = parseSemver(b);
+    if (pa === null || pb === null) return null;
+    for (let i = 0; i < 3; i++) {
+        if (pa.core[i] !== pb.core[i]) return pa.core[i] - pb.core[i];
+    }
+    if (pa.pre.length === 0 || pb.pre.length === 0) return pb.pre.length - pa.pre.length;
+    for (let i = 0; i < Math.max(pa.pre.length, pb.pre.length); i++) {
+        const x = pa.pre[i];
+        const y = pb.pre[i];
+        if (x === undefined) return -1;
+        if (y === undefined) return 1;
+        if (x === y) continue;
+        const nx = /^\d+$/.test(x);
+        const ny = /^\d+$/.test(y);
+        if (nx && ny) return Number(x) - Number(y);
+        if (nx !== ny) return nx ? -1 : 1;
+        return x < y ? -1 : 1;
+    }
+    return 0;
+}
+
+/** latest 是否严格新于 installed；任一侧非法返回 false。 */
+export function isNewer(latest, installed) {
+    const cmp = compareVersions(latest, installed);
+    return cmp !== null && cmp > 0;
+}
+
+/* ------------------------------------------------------------------ *
+ * 版本查询（多 registry 回退 + /latest 版本级端点）
+ * ------------------------------------------------------------------ */
+
+/** 本次要依次尝试的 registry 地址列表（去重）。 */
+function registryCandidates() {
+    const custom = process.env.DSHSU_REGISTRY_URL?.replace(/\/+$/, '');
+    const list = [custom, NPM_CHINA_MIRROR, 'https://registry.npmjs.org'];
+    return [...new Set(list.filter((v) => typeof v === 'string' && v !== ''))];
+}
+
+/**
+ * 从单个 registry 的 /latest 版本级端点取文档（含 dist.tarball）。
+ * 用版本级端点而非整包 packument：后者会被 Fastly 等 CDN 长时间缓存，
+ * 出现"包已发布但查不到新版"的假象。
+ */
+async function fetchVersionDoc(base, pkg) {
+    const res = await fetch(`${base}/${encodeURIComponent(pkg)}/latest`, {
+        headers: { accept: 'application/json', 'user-agent': 'dsh-selfupdater' },
+        signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+    });
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+    const doc = await res.json();
+    if (typeof doc?.version !== 'string' || doc.version === '') throw new Error('响应缺少 version 字段');
+    return { version: doc.version, tarball: doc?.dist?.tarball ?? null };
+}
+
+/** 依次尝试各 registry，返回首个成功的 { version, tarball }。 */
+async function fetchLatestRelease(pkg) {
+    const errors = [];
+    for (const base of registryCandidates()) {
+        try {
+            return await fetchVersionDoc(base, pkg);
+        } catch (err) {
+            errors.push(`${base}: ${err.message}`);
+        }
+    }
+    throw new Error(errors.join('；'));
+}
+
+/** 只取最新版本号（检查更新路由使用）。 */
+export async function fetchLatestVersion(pkg) {
+    return (await fetchLatestRelease(pkg)).version;
+}
+
+/* ------------------------------------------------------------------ *
+ * 小工具
+ * ------------------------------------------------------------------ */
+
+/** 读 JSON 文件，不存在/损坏返回空对象。 */
+function readJson(file) {
+    try {
+        return JSON.parse(readFileSync(file, 'utf8'));
+    } catch {
+        return {};
+    }
+}
+
+/** 读 profile 清单里记录的本插件版本声明（可能带 ^/~ 前缀）；无记录返回 null。 */
+function profileDeclaredVersion(profileDir) {
+    const dep = readJson(join(profileDir, 'package.json'))?.dependencies?.[SELF_NAME];
+    return typeof dep === 'string' && dep !== '' ? dep : null;
+}
+
+/** 去掉 ^/~ 等范围前缀后比较是否等于目标版本。 */
+function declarationMatches(declared, expected) {
+    return declared.replace(/^[\^~>=<\s]+/, '') === expected;
+}
+
+/** 当前正在运行的自身版本（读本包 package.json；ESM 下用 createRequire 同步读）。 */
+function runningVersion() {
+    try {
+        const require = createRequire(import.meta.url);
+        return require('../package.json').version;
+    } catch {
+        return '0.0.0';
+    }
+}
+
+/**
+ * 已安装的自身版本（供"检查更新/状态展示"使用）。
+ * 优先读 profile 清单 dependencies 里声明的版本：更新装好但宿主未重启时，
+ * 它才是"已安装版本"，能让 UI 立即显示新版号并停止误报"发现新版本"；
+ * 清单里没有记录时回退到正在运行的版本（首次安装/手工部署场景）。
+ */
+export function installedSelfVersion(workspace) {
+    const profileDir = join(workspace, '.dsh', 'profiles', process.env.DSH_PLUGIN_PROFILE ?? 'web');
+    const declared = profileDeclaredVersion(profileDir);
+    return declared !== null ? declared.replace(/^[\^~>=<\s]+/, '') : runningVersion();
+}
+
+/** 定位 dsh CLI 入口：打包布局优先，其次 node_modules 标准布局。 */
+function locateDshBin(appDir) {
+    const candidates = [
+        join(appDir, 'bin', 'dsh.js'),
+        join(appDir, 'node_modules', '@deepseek-ai', 'dsh', 'bin', 'dsh.js'),
+    ];
+    for (const p of candidates) {
+        if (existsSync(p)) return p;
+    }
+    throw new Error('无法定位 dsh 命令行工具（bin/dsh.js）');
+}
+
+/** 下载 tgz 到本地暂存路径（体积小，直接缓冲写入）。 */
+async function downloadTgz(url, destFile) {
+    mkdirSync(dirname(destFile), { recursive: true });
+    const res = await fetch(url, { signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT_MS) });
+    if (!res.ok) throw new Error(`下载失败 HTTP ${res.status}`);
+    const buf = Buffer.from(await res.arrayBuffer());
+    if (buf.length < 1024) throw new Error(`下载内容过小（${buf.length} 字节），疑似损坏`);
+    writeFileSync(destFile, buf);
+}
+
+/** 阻塞式执行子命令：退出码非 0 或超时都抛错，stderr 附在错误信息里。 */
+function runCommand(file, cmdArgs, timeoutMs) {
+    return new Promise((resolveP, rejectP) => {
+        const child = spawn(file, cmdArgs, { stdio: ['ignore', 'pipe', 'pipe'] });
+        let stdout = '';
+        let stderr = '';
+        let settled = false;
+        const timer = setTimeout(() => {
+            child.kill('SIGKILL');
+            rejectP(new Error(`命令超时（${Math.round(timeoutMs / 1000)}s）`));
+        }, timeoutMs);
+        const finish = (fn, value) => {
+            if (settled) return;
+            settled = true;
+            clearTimeout(timer);
+            fn(value);
+        };
+        child.stdout.on('data', (d) => { stdout += d; });
+        child.stderr.on('data', (d) => { stderr += d; });
+        child.on('error', (err) => finish(rejectP, err));
+        child.on('close', (code) => {
+            if (code === 0) finish(resolveP, stdout.trim());
+            else finish(rejectP, new Error(`退出码 ${code}${stderr.trim() ? `：${stderr.trim().slice(-800)}` : ''}`));
+        });
+    });
+}
+
+/* ------------------------------------------------------------------ *
+ * 任务主体
+ * ------------------------------------------------------------------ */
+
+/**
+ * 执行一次插件自更新（进程内异步，不退出宿主）。
+ * @param opts.appDir - DSH 应用目录（node_modules 所在处）
+ * @param opts.workspace - 工作区目录（.dsh 落盘处）
+ * @param opts.logger - 宿主 logger（可选）
+ */
+export async function runPluginUpdateTask({ appDir, workspace, logger }) {
+    const log = (msg) => logger?.info?.(`[dsh-selfupdater] ${msg}`);
+    const warnLog = (msg) => logger?.warn?.(`[dsh-selfupdater] ${msg}`);
+
+    const dshStateDir = join(workspace, '.dsh');
+    const statusFile = join(dshStateDir, 'pluginupdate-status.json');
+    const lockFile = join(dshStateDir, 'pluginupdate.lock');
+    const profileName = process.env.DSH_PLUGIN_PROFILE ?? 'web';
+    const profileDir = join(dshStateDir, 'profiles', profileName);
+    const stagingTgz = join(dshStateDir, 'pluginupdate.staging.tgz');
+    const manifestPath = join(profileDir, 'package.json');
+
+    /**
+     * 写状态文件（保留 updates 检查缓存等历史字段；失败仅告警不断流程）。
+     * 终态约定：done_pending_restart = 装好了但需要重启生效；error = 失败可重试。
+     */
+    const setState = (state, message, extra = {}) => {
+        try {
+            mkdirSync(dshStateDir, { recursive: true });
+            writeFileSync(statusFile, JSON.stringify({
+                ...readJson(statusFile),
+                ...extra,
+                state,
+                message,
+                updatedAt: new Date().toISOString(),
+            }, null, 2));
+        } catch (err) {
+            warnLog(`插件状态文件写入失败: ${err.message}`);
+        }
+    };
+
+    /** 安装前的清单原文快照（安装失败时尽力还原，避免半成品状态）。 */
+    let manifestBackup = null;
+    try {
+        /* 0. 清理旧架构遗留的孤儿备份目录（此前 NAS 上 ENOENT 回滚报错的源头）。 */
+        const orphanBak = `${profileDir}.pluginupdate-bak`;
+        if (existsSync(orphanBak)) {
+            warnLog(`清理遗留备份目录 ${orphanBak}`);
+            rmSync(orphanBak, { recursive: true, force: true });
+        }
+
+        /* 1. 确定当前版本：优先 profile 清单记录（更新后未重启时它才是新值），
+              无记录时退回正在运行的版本。 */
+        const declared = profileDeclaredVersion(profileDir);
+        const installed = declared !== null ? declared.replace(/^[\^~>=<\s]+/, '') : runningVersion();
+        setState('running', '正在查询最新版本…', { startedAt: new Date().toISOString() });
+
+        /* 2. 查询最新版本与下载地址。 */
+        const release = await fetchLatestRelease(SELF_NAME);
+        if (!isNewer(release.version, installed)) {
+            log(`已是最新版本 ${installed}，无需更新`);
+            setState('done_pending_restart', `当前已是最新（${installed}），无需更新`);
+            return;
+        }
+
+        /* 3. 下载新版 tgz 到暂存位置。 */
+        if (!release.tarball) throw new Error('registry 未返回 tarball 下载地址');
+        setState('downloading', `正在下载 ${SELF_NAME}@${release.version}…`);
+        await downloadTgz(release.tarball, stagingTgz);
+
+        /* 4. 记录 profile 清单原文，安装失败时可还原。 */
+        manifestBackup = existsSync(manifestPath) ? readFileSync(manifestPath) : null;
+
+        /* 5. 原地安装：调 dsh CLI 把 tgz 装进现有 profile（不 rename、不停机）。
+              子进程同步等待结束，与旧版的 detached 分离脚本有本质区别。 */
+        setState('swapping', `正在安装 ${release.version}（服务保持运行）…`);
+        const dshBin = locateDshBin(appDir);
+        await runCommand(
+            process.execPath,
+            [dshBin, 'plugin', '--profile', profileName, 'add', stagingTgz],
+            INSTALL_TIMEOUT_MS,
+        );
+
+        /* 6. 校验：清单版本号一致 + 入口文件真实落盘。 */
+        const after = profileDeclaredVersion(profileDir);
+        if (after === null || !declarationMatches(after, release.version)) {
+            throw new Error(`安装后清单版本异常：期望 ${release.version}，实际 ${after ?? '缺失'}`);
+        }
+        if (!existsSync(join(profileDir, 'node_modules', SELF_NAME, 'lib', 'index.js'))) {
+            throw new Error('入口文件未落盘，安装可能不完整');
+        }
+
+        /* 7. 成功：不重启宿主，提示用户重启使新版本生效。 */
+        setState('done_pending_restart',
+            `插件已更新到 ${release.version}，请重启 DeepSeek Harness 使新版本生效`,
+            { finishedAt: new Date().toISOString(), targetVersion: release.version });
+        log(`插件更新完成（${installed} → ${release.version}），等待用户重启生效`);
+    } catch (err) {
+        /* 失败兜底：还原清单 + 落盘明确错误，锁在 finally 里释放以便重试。 */
+        warnLog(`插件更新失败: ${err.message}`);
+        if (manifestBackup !== null) {
+            try {
+                mkdirSync(dirname(manifestPath), { recursive: true });
+                writeFileSync(manifestPath, manifestBackup);
+            } catch { /* 还原是尽力而为，不掩盖原始错误 */ }
+        }
+        setState('error',
+            `插件更新失败：${err.message}。可稍后重试，或通过插件市场重新安装`,
+            { finishedAt: new Date().toISOString() });
+    } finally {
+        rmSync(stagingTgz, { force: true }); // 暂存 tgz 无论成败都清掉
+        rmSync(lockFile, { force: true });   // 释放更新锁，允许下次发起
+    }
+}

package/lib/updater.mjs

@@ -132,7 +132,7 @@ const args = parseArgs(process.argv);
 const appDir = resolve(String(args['app-dir'] ?? ''));
 /**
  * 工作区目录（存放 .dsh 状态目录）。
- * 与 index.js / plugin-updater.mjs 的推导链一致：共享目录 > HOME > TRIM_VAR > appDir。
+ * 与 index.js 的推导链一致：共享目录 > HOME > TRIM_VAR > appDir。
  * 正常情况下 index.js 已通过 --workspace 传入解析结果，这里仅兜底；
  * 不能只信 TRIM_VAR —— 飞牛部署时 .dsh 实际写在 $HOME（工作区）下。
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-selfupdater",
-  "version": "0.3.4",
-  "description": "Self-update plugin for DeepSeek Harness: check npm for newer @deepseek-ai/dsh, swap node_modules atomically, restart, health-check and roll back on failure; also supports one-click online update of installed DSH plugins. DSH 主程序与已装插件的一站式在线更新插件。",
+  "version": "0.4.6",
+  "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",
   "main": "lib/index.js",

package/lib/plugin-updater.mjs

@@ -1,437 +0,0 @@
-#!/usr/bin/env node
-/**
- * dsh-selfupdater 分离式插件升级脚本（独立进程执行，不依赖 DSH 存活）。
- *
- * 为什么必须分离进程：插件文件装在 profile 目录里且已被 DSH 进程加载进内存，
- * Windows 上运行中文件被锁、Linux 上热替换也可能出现半新半旧状态；
- * 所以插件路由只负责"触发后退出"，由本脚本完成：
- *   备份 profile → 从 npm 下载新版 tgz → dsh plugin add 安装 → 重启 → 健康检查 → 失败回滚。
- *
- * 用法（由 lib/index.js 的 POST /plugins/update 自动调用）：
- *   node plugin-updater.mjs --pid <DSH主进程PID> --app-dir <APP目录> \
- *        --workspace <工作区目录> --port <服务端口>
- */
-import { spawn } from 'node:child_process';
-import net from 'node:net';
-import { appendFileSync, copyFileSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
-import { join, resolve } from 'node:path';
-
-/* ------------------------------------------------------------------ *
- * 工具函数
- * ------------------------------------------------------------------ */
-
-/** 解析 --key value 形式的命令行参数。 */
-function parseArgs(argv) {
-    const out = {};
-    for (let i = 2; i < argv.length; i++) {
-        if (!argv[i].startsWith('--')) continue;
-        const next = argv[i + 1];
-        out[argv[i].slice(2)] = next !== undefined && !next.startsWith('--') ? next : true;
-    }
-    return out;
-}
-
-const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-
-/**
- * semver 比较（零依赖实现，与 updater.mjs 保持一致）。
- * 返回负数/0/正数；任一侧不是合法 semver 时返回 null。
- */
-const SEMVER_RE = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
-
-function compareVersions(a, b) {
-    const pa = SEMVER_RE.exec(String(a ?? '').trim());
-    const pb = SEMVER_RE.exec(String(b ?? '').trim());
-    if (pa === null || pb === null) return null;
-    for (let i = 1; i <= 3; i++) {
-        const x = Number(pa[i]);
-        const y = Number(pb[i]);
-        if (x !== y) return x - y;
-    }
-    // 有预发布段的一方更小（1.0.0-rc.1 < 1.0.0）；双方都有时逐段比较。
-    const preA = pa[4] === undefined ? [] : pa[4].split('.');
-    const preB = pb[4] === undefined ? [] : pb[4].split('.');
-    if (preA.length === 0 || preB.length === 0) return preB.length - preA.length;
-    for (let i = 0; i < Math.max(preA.length, preB.length); i++) {
-        const x = preA[i];
-        const y = preB[i];
-        if (x === undefined) return -1;
-        if (y === undefined) return 1;
-        if (x === y) continue;
-        const nx = /^\d+$/.test(x);
-        const ny = /^\d+$/.test(y);
-        if (nx && ny) return Number(x) - Number(y);
-        if (nx !== ny) return nx ? -1 : 1;
-        return x < y ? -1 : 1;
-    }
-    return 0;
-}
-
-/** 仅当 latest 严格高于 installed 才算可升级。 */
-function isNewer(latest, installed) {
-    const cmp = compareVersions(latest, installed);
-    return cmp !== null && cmp > 0;
-}
-
-/** 探测端口是否已被监听（占用=true）。 */
-function probePort(port, host = '127.0.0.1') {
-    return new Promise((resolveProbe) => {
-        const socket = net.connect({ host, port });
-        socket.on('connect', () => { socket.destroy(); resolveProbe(true); });
-        socket.on('error', () => resolveProbe(false));
-    });
-}
-
-/** 等待端口释放。 */
-async function waitPortFree(port, timeoutMs) {
-    const deadline = Date.now() + timeoutMs;
-    while (Date.now() < deadline) {
-        if (!(await probePort(port))) return true;
-        await sleep(500);
-    }
-    return false;
-}
-
-/** 进程是否仍存活（kill(pid,0) 只做权限探测不真正发信号）。 */
-function isAlive(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    } catch {
-        return false;
-    }
-}
-
-/** 结束旧 DSH 主进程：SIGTERM 给优雅退出机会，超时后 SIGKILL 兜底。 */
-async function killProcess(pid) {
-    if (!isAlive(pid)) return;
-    process.kill(pid, 'SIGTERM');
-    const deadline = Date.now() + 8000;
-    while (isAlive(pid) && Date.now() < deadline) await sleep(300);
-    if (isAlive(pid)) {
-        try { process.kill(pid, 'SIGKILL'); } catch { /* 已退出则忽略 */ }
-        await sleep(1000);
-    }
-}
-
-/* ------------------------------------------------------------------ *
- * 全局上下文与状态落盘
- * ------------------------------------------------------------------ */
-
-const args = parseArgs(process.argv);
-
-/** DSH 应用目录（含 bin/node 与 node_modules/@deepseek-ai/dsh）。 */
-const appDir = resolve(String(args['app-dir'] ?? ''));
-/**
- * 工作区目录（存放 .dsh 状态目录与插件 profile）。
- * 与 index.js 的 resolveWorkspace 推导链一致：共享目录 > HOME > TRIM_VAR > appDir。
- * index.js 已解析出正确 workspace 并通过 --workspace 传入，这里仅在参数缺失时兜底；
- * 不能只信 TRIM_VAR —— 飞牛部署时 profiles 实际写在 $HOME/.dsh 下。
- */
-const workspace = (() => {
-    if (args.workspace) return resolve(String(args.workspace));
-    const shares = (process.env.TRIM_DATA_SHARE_PATHS ?? '').split(':').map((s) => s.trim()).filter(Boolean);
-    for (const dir of [...shares, process.env.HOME ?? '', process.env.TRIM_VAR ?? '', appDir]) {
-        if (dir !== '' && existsSync(join(dir, '.dsh'))) return resolve(dir);
-    }
-    return resolve(shares[0] ?? process.env.HOME ?? process.env.TRIM_VAR ?? appDir);
-})();
-/** Web 服务端口，健康检查用。 */
-const port = parseInt(String(args.port ?? process.env.DSH_PORT ?? '3081'), 10);
-
-const NODE_BIN = join(appDir, 'bin', 'node');
-const DSH_BIN = join(appDir, 'node_modules', '@deepseek-ai', 'dsh', 'lib', 'bin.js');
-/** 插件 profile 名（与 runner.js / lib/index.js 的约定一致）。 */
-const PROFILE = process.env.DSH_PLUGIN_PROFILE ?? 'web';
-
-const dshStateDir = join(workspace, '.dsh');
-const statusFile = join(dshStateDir, 'pluginupdate-status.json');
-const logFile = join(dshStateDir, 'pluginupdate.log');
-const lockFile = join(dshStateDir, 'pluginupdate.lock');
-const stagingDir = join(dshStateDir, 'pluginupdate-staging');
-const profileDir = join(dshStateDir, 'profiles', PROFILE);
-/** 升级前的 profile 完整备份目录（失败回滚用；成功后保留一次供排查）。 */
-const bakProfileDir = profileDir + '.pluginupdate-bak';
-
-/** 国内镜像优先的 registry 候选列表（与 index.js 的策略一致）。 */
-function registryCandidates() {
-    const custom = process.env.DSHSU_REGISTRY_URL?.replace(/\/+$/, '');
-    const list = [custom, 'https://mirrors.cloud.tencent.com/npm', 'https://registry.npmjs.org'];
-    return [...new Set(list.filter((v) => typeof v === 'string' && v !== ''))];
-}
-
-/** 读插件状态文件（不存在返回空对象）。 */
-function readStatus() {
-    try { return JSON.parse(readFileSync(statusFile, 'utf8')); } catch { return {}; }
-}
-
-let status = {};
-
-/** 向日志追加一行（失败静默，日志不能阻断升级流程）。 */
-function log(message) {
-    const line = `[${new Date().toISOString()}] ${message}`;
-    try { appendFileSync(logFile, line + '\n'); } catch { /* 忽略 */ }
-    console.log(line);
-}
-
-/** 合并写入插件状态文件，供 UI 卡片轮询展示进度。 */
-function setState(state, message, extra = {}) {
-    status = { ...status, state, message: message ?? status.message, updatedAt: new Date().toISOString(), ...extra };
-    try { writeFileSync(statusFile, JSON.stringify({ ...status, pid: process.pid }, null, 2)); } catch { /* 同上 */ }
-    log(`state=${state}${message ? ` :: ${message}` : ''}`);
-}
-
-/** 终态收尾：释放锁文件并退出。 */
-function finish(exitCode = 0) {
-    try { rmSync(lockFile, { force: true }); } catch { /* 忽略 */ }
-    process.exit(exitCode);
-}
-
-/* ------------------------------------------------------------------ *
- * registry 查询与 tgz 下载
- * ------------------------------------------------------------------ */
-
-/**
- * 从单个 registry 取包的 latest 版本号与 tgz 下载地址。
- * 注意：镜像返回的 dist.tarball 可能仍指向官方源，这里不直接采用，
- * 而是按 npm 标准路径规则自行拼出镜像侧的下载地址（保证国内可达）。
- */
-async function fetchPackument(base, pkgName) {
-    const res = await fetch(`${base}/${encodeURIComponent(pkgName)}`, {
-        headers: { accept: 'application/json', 'user-agent': 'dsh-selfupdater' },
-        signal: AbortSignal.timeout(15000),
-    });
-    if (!res.ok) throw new Error(`HTTP ${res.status}`);
-    const doc = await res.json();
-    const latest = doc?.['dist-tags']?.latest;
-    if (typeof latest !== 'string' || latest === '') throw new Error('未返回 latest');
-    // tgz 文件名规则：取包名最后一段 + 版本号（@a/b@1.0.0 → b-1.0.0.tgz）。
-    const fileName = `${pkgName.split('/').pop()}-${latest}.tgz`;
-    return { latest, tgzUrl: `${base}/${pkgName}/-/${fileName}` };
-}
-
-/** 依次尝试所有 registry 候选；全部失败抛出聚合错误。 */
-async function fetchLatest(pkgName) {
-    const errors = [];
-    for (const base of registryCandidates()) {
-        try {
-            return await fetchPackument(base, pkgName);
-        } catch (err) {
-            errors.push(`${base}: ${err.message}`);
-        }
-    }
-    throw new Error(errors.join('；'));
-}
-
-/** 把 tgz 流式下载到本地 staging 文件。 */
-async function downloadTgz(url, destFile) {
-    const res = await fetch(url, {
-        headers: { 'user-agent': 'dsh-selfupdater' },
-        signal: AbortSignal.timeout(60000),
-    });
-    if (!res.ok) throw new Error(`tgz 下载失败 HTTP ${res.status}`);
-    writeFileSync(destFile, Buffer.from(await res.arrayBuffer()));
-}
-
-/* ------------------------------------------------------------------ *
- * 外部命令执行
- * ------------------------------------------------------------------ */
-
-/** 以 Promise 方式运行外部命令并收集输出。 */
-function runCommand(file, cmdArgs, opts = {}) {
-    return new Promise((resolveRun) => {
-        const child = spawn(file, cmdArgs, { stdio: ['ignore', 'pipe', 'pipe'], ...opts });
-        let stdout = '';
-        let stderr = '';
-        child.stdout?.on('data', (d) => { stdout += d; });
-        child.stderr?.on('data', (d) => { stderr += d; });
-        child.on('error', (err) => resolveRun({ code: -1, stdout: '', stderr: String(err) }));
-        child.on('close', (code) => resolveRun({ code, stdout, stderr }));
-    });
-}
-
-/**
- * 用官方 CLI 离线安装 tgz（与 runner.js 内置安装逻辑完全一致）：
- *   node bin/dsh.js plugin --profile <web> add <tgz>
- * 关键环境变量：HOME 必须指向工作区，否则 dsh 会找错用户目录。
- */
-async function dshPluginAdd(tgzFile) {
-    const result = await runCommand(NODE_BIN, [DSH_BIN, 'plugin', '--profile', PROFILE, 'add', tgzFile], {
-        cwd: workspace,
-        env: { ...process.env, HOME: workspace },
-    });
-    if (result.code !== 0) {
-        throw new Error(`dsh plugin add 退出码 ${result.code}: ${result.stderr.slice(-400)}`);
-    }
-    return result.stdout;
-}
-
-/* ------------------------------------------------------------------ *
- * 重启链与健康检查
- * ------------------------------------------------------------------ */
-
-/**
- * 按 runner.js 的方式重新拉起完整启动链（runner 会再拉起 DSH）。
- * 必须继承当前进程的全部环境变量 —— 飞牛的 TRIM_DATA_SHARE_PATHS 等
- * 变量决定工作区落点，丢失会导致重启后配置"失踪"。
- */
-function launchRunnerChain() {
-    const runnerJs = join(appDir, 'bin', 'runner.js');
-    if (!existsSync(runnerJs)) throw new Error(`找不到启动器 ${runnerJs}，无法重启`);
-    const child = spawn(process.execPath, [runnerJs], {
-        cwd: workspace,
-        detached: true,
-        stdio: 'ignore',
-        env: { ...process.env, TRIM_APPDEST: appDir },
-    });
-    child.unref();
-    log(`已拉起 runner 链 (pid=${child.pid})`);
-}
-
-/** 健康检查：轮询本地端口直到有任意 HTTP 响应即算活着。 */
-async function waitHealthy(timeoutMs) {
-    const deadline = Date.now() + timeoutMs;
-    while (Date.now() < deadline) {
-        try {
-            await fetch(`http://127.0.0.1:${port}/`, { signal: AbortSignal.timeout(3000) });
-            return true;
-        } catch { /* 未就绪继续等 */ }
-        await sleep(2000);
-    }
-    return false;
-}
-
-/** 失败回滚：还原整个 profile 目录并再次拉起服务。 */
-async function rollback() {
-    setState('rollback', '安装失败，正在回滚插件 profile …');
-    try {
-        rmSync(profileDir, { recursive: true, force: true });
-        renameSync(bakProfileDir, profileDir);
-    } catch (err) {
-        setState('error', `回滚失败：${err.message}。可手动从 ${bakProfileDir} 恢复。`);
-        return false;
-    }
-    launchRunnerChain();
-    const ok = await waitHealthy(60000);
-    setState(ok ? 'done_failed' : 'error',
-        ok ? '已回滚并恢复服务，插件保持旧版本' : '回滚后服务仍未恢复，请查看容器日志');
-    return ok;
-}
-
-/* ------------------------------------------------------------------ *
- * 主流程
- * ------------------------------------------------------------------ */
-
-async function main() {
-    mkdirSync(dshStateDir, { recursive: true });
-
-    // 锁文件双端校验：路由触发前会检查；这里再补一道防手动重复执行。
-    if (existsSync(lockFile)) throw new Error('已有一次插件更新在进行中（锁文件存在）');
-
-    /**
-     * 只更新本插件自身（dsh-selfupdater）：其他插件已有各自的更新渠道，
-     * 不再扫描 profile 的 dependencies 清单。
-     * 已装版本直接读自己脚本身旁的 package.json，最可靠。
-     */
-    let selfVersion = '';
-    try {
-        selfVersion = JSON.parse(
-            readFileSync(new URL('./../package.json', import.meta.url), 'utf8'),
-        ).version ?? '';
-    } catch { /* 读不到版本号则无事可做 */ }
-    if (selfVersion === '') {
-        setState('error', '无法读取 dsh-selfupdater 自身版本号，更新中止');
-        finish(1);
-    }
-    const installed = [{ name: 'dsh-selfupdater', version: selfVersion }];
-
-    status = { startedAt: new Date().toISOString(), trigger: 'manual' };
-    setState('downloading', '正在查询 dsh-selfupdater 的最新版本 …');
-
-    // 阶段一：并发查询每个插件的 latest，筛出真正有新版可升的子集。
-    const checks = await Promise.allSettled(installed.map(async (p) => ({ ...p, info: await fetchLatest(p.name) })));
-    const pending = [];
-    for (const c of checks) {
-        if (c.status !== 'fulfilled') {
-            log(`查询 ${c.reason?.name ?? '?'} 失败: ${c.reason?.message ?? c.reason}`);
-            continue;
-        }
-        const { name, version, info } = c.value;
-        if (isNewer(info.latest, version)) pending.push({ name, currentVersion: version, targetVersion: info.latest, tgzUrl: info.tgzUrl });
-    }
-    if (pending.length === 0) {
-        setState('idle', 'dsh-selfupdater 已是最新版本');
-        finish(0);
-    }
-    log(`待更新插件：${pending.map((p) => `${p.name}@${p.currentVersion}->${p.targetVersion}`).join(', ')}`);
-
-    // 阶段二：备份整个 profile（同分区 rename 原子完成），失败即可整体还原。
-    setState('downloading', '正在备份当前插件目录 …');
-    rmSync(bakProfileDir, { recursive: true, force: true });
-    renameSync(profileDir, bakProfileDir);
-    // 注意：不再立即还原备份！备份目录需要保留到更新成功完成，
-    // 这样如果更新失败，rollback() 函数才能从备份恢复。
-    mkdirSync(profileDir, { recursive: true });
-    mkdirSync(stagingDir, { recursive: true });
-
-    // 阶段三：逐个下载 tgz 并离线安装；任一失败立即整体回滚。
-    const updated = [];
-    for (const item of pending) {
-        setState('downloading', `正在下载 ${item.name}@${item.targetVersion} …`, { updating: item.name });
-        const tgzFile = join(stagingDir, `${item.name.split('/').pop()}-${item.targetVersion}.tgz`);
-        await downloadTgz(item.tgzUrl, tgzFile);
-        log(`开始安装 ${item.name}@${item.targetVersion}`);
-        await dshPluginAdd(tgzFile);
-        updated.push(item);
-    }
-
-    // 校验安装结果：profile 里的登记版本必须等于目标版本（防镜像滞后装了旧版）。
-    const afterDeps = JSON.parse(readFileSync(join(profileDir, 'package.json'), 'utf8')).dependencies ?? {};
-    const mismatched = pending.filter((p) => String(afterDeps[p.name] ?? '').replace(/^[~^]/, '') !== p.targetVersion);
-    if (mismatched.length > 0) {
-        throw new Error(`安装校验失败：${mismatched.map((p) => p.name).join(', ')} 版本不符`);
-    }
-
-    // 阶段四：重启 DSH 让新插件代码生效（本脚本启动时 DSH 已随插件路由退出，
-    // 但保险起见仍对传入 pid 做一次确认清理），然后等待端口就绪。
-    setState('restarting', '正在重启 DeepSeek Harness …');
-    const pid = parseInt(String(args.pid ?? ''), 10);
-    if (Number.isFinite(pid) && pid > 0) await killProcess(pid);
-    await waitPortFree(port, 20000);
-    launchRunnerChain();
-
-    setState('healthcheck', '等待服务就绪 …');
-    if (await waitHealthy(90000)) {
-        rmSync(stagingDir, { recursive: true, force: true });
-        // bak 目录保留一次作为手动救砖手段，下次升级前会自动清理。
-        setState('done',
-            `插件更新完成：dsh-selfupdater@${updated[0]?.targetVersion ?? ''}`,
-            { finishedAt: new Date().toISOString() });
-    } else {
-        await rollback();
-    }
-    finish(0);
-}
-
-// 总看门狗：任何阶段卡死都强制终态，避免 UI 永远显示"更新中"。
-setTimeout(() => {
-    setState('error', '插件更新超时（8 分钟看门狗触发），请查看 pluginupdate.log');
-    finish(2);
-}, 8 * 60 * 1000);
-
-main().catch(async (err) => {
-    log(`插件更新失败: ${err.stack ?? err}`);
-    // 只有已经动过 profile 才需要回滚；查询/下载阶段失败直接报错即可。
-    const touched = existsSync(join(dshStateDir, 'profiles')) && status.state !== 'downloading'
-        || String(status.message ?? '').includes('备份');
-    if (status.state === 'healthcheck' || status.state === 'restarting' || touched) {
-        await rollback();
-    } else {
-        setState('error', String(err.message ?? err));
-        // 若 profile 曾被挪走尚未放回，尽力恢复。
-        if (!existsSync(profileDir) && existsSync(bakProfileDir)) {
-            try { renameSync(bakProfileDir, profileDir); } catch { /* 忽略 */ }
-        }
-    }
-    finish(1);
-});