dsh-selfupdater 0.4.14 → 0.4.16

package/client/settings-card.js

@@ -392,8 +392,8 @@ function headBadge(text, isNew) {
 function UpdateCard({ t, status, busy, checking, onCheck, onUpgrade,
     plugin, pluginBusy, pluginChecking, pluginMsg, onPluginCheck, onPluginUpgrade }) {
 
-    const updateAvailable = status?.latestVersion != null
-        && status.latestVersion !== status.currentVersion;
+    // 与插件小节保持一致：以后端 semver 权威判定为准，避免仅靠字符串 !== 误判预发布版本号
+    const updateAvailable = status?.updateAvailable === true;
     const stage = STATE_LABELS[status?.state] ?? '';
 
     // DSH 小节结果消息的语义着色：成功绿 / 失败红 / 其余灰。

package/lib/index.js

@@ -208,14 +208,39 @@ export function apply(ctx) {
             });
         }
 
+        /**
+         * DSH 状态归一化（对齐插件 done_pending_restart 归位经验）：
+         * - 升级成功后 updater 置 state=done / done_failed 并写入 latestVersion；
+         * - 重启后当前版本已追平 latestVersion 时，"升级完成"已生效，不应一直挂着成功徽章；
+         * - 读取时若判定已生效则归位为 idle 并覆写磁盘，避免每次请求重复判定。
+         * - 最终态 done_pending_restart 理论上不会出现在 DSH 链路，但一并处理以防残留。
+         */
+        const dshStatusView = () => {
+            const raw = readStatus(dshStateDir);
+            const baseState = isBusy() ? (raw.state ?? 'running') : (raw.state ?? 'idle');
+            const finalsToSettle = ['done', 'done_failed', 'done_pending_restart'];
+            if (finalsToSettle.includes(baseState) && typeof raw.latestVersion === 'string' && raw.latestVersion !== '') {
+                const currentNow = currentDshVersion(appDir);
+                if (currentNow !== 'unknown' && isNewer(raw.latestVersion, currentNow) === false) {
+                    const settled = { ...raw, state: 'idle', message: null };
+                    writeStatus(dshStateDir, settled);
+                    return { ...settled, state: 'idle' };
+                }
+            }
+            return { ...raw, state: baseState };
+        };
+
         /* ---------- GET /dsh-selfupdater/status ---------- */
         registerRoute('GET', '/dsh-selfupdater/status', (_req, res) => {
-            const status = readStatus(dshStateDir);
+            const status = dshStatusView();
             const current = currentDshVersion(appDir);
+            const latest = status.latestVersion ?? null;
             sendJson(res, 200, {
                 currentVersion: current,
-                latestVersion: status.latestVersion ?? null,
-                state: isBusy() ? (status.state ?? 'running') : (status.state ?? 'idle'),
+                latestVersion: latest,
+                // 后端权威判定是否可更新，避免前端仅靠字符串 !== 误判预发布版本号
+                updateAvailable: typeof latest === 'string' && latest !== '' ? isNewer(latest, current) === true : false,
+                state: status.state ?? 'idle',
                 message: status.message ?? null,
                 lastCheck: status.updatedAt ?? null,
             });
@@ -266,7 +291,9 @@ export function apply(ctx) {
                 return;
             }
             // 预置锁文件：updater.mjs 启动后会校验它存在才继续。
+            // 先确保 .dsh 目录存在（首次安装/手动清理后可能尚无该目录，教训来自插件写状态 ENOENT 问题）。
             try {
+                mkdirSync(dshStateDir, { recursive: true });
                 writeFileSync(lockFile, JSON.stringify({ pid: process.pid, startedAt: Date.now(), by: 'plugin' }));
             } catch (err) {
                 sendJson(res, 500, { error: `写入锁文件失败：${err.message}` });
@@ -296,10 +323,34 @@ export function apply(ctx) {
          * 返回数据与 DSH 小节同款三行模板：当前版本 / 最新版本 / 上次检查。
          */
         const pluginBusy = () => existsSync(pluginLockFile);
-        /** 读插件状态并合并"服务端视角"的忙闲标记。 */
+        /**
+         * 读插件状态并合并"服务端视角"的忙闲标记。
+         *
+         * 【为何要归位 done_pending_restart】更新成功后 setState 把
+         * done_pending_restart 写进磁盘，但"是否已经重启"只有通过比较
+         * 真实落盘版本才能判定：重启后 resolveInstalledVersion 读到的新版本
+         * 已经等于 targetVersion（更新已生效），此时再把"请重启生效"的徽章
+         * 继续挂在界面上就是误导（用户实测"重启后还一直显示请重启"）。
+         * 这里在读取时归一化：若状态是 done_pending_restart 且当前真实
+         * 运行版本已 >= targetVersion，说明更新已生效，把 state 归位为 idle，
+         * 并顺手覆写磁盘，避免每次读都重复判定。
+         */
         const pluginStatusView = () => {
             const status = readPluginStatus(dshStateDir);
-            return { ...status, state: status.state ?? (pluginBusy() ? 'running' : 'idle') };
+            const state = status.state ?? (pluginBusy() ? 'running' : 'idle');
+            // 仅处理"待重启"终态：targetVersion 存在才可能有归位判定。
+            if (state === 'done_pending_restart' && typeof status.targetVersion === 'string' && status.targetVersion !== '') {
+                const installedNow = selfInstalled();
+                // 重启后真实版本已到目标版本 => 更新已生效，徽章不再有意义。
+                // 用 isNewer(target, installed) 判"目标是否还新于已装"：返回 false
+                // 即目标不再领先，说明已装版本已追平/超过目标（更新已生效）。
+                if (installedNow !== null && isNewer(status.targetVersion, installedNow) === false) {
+                    const settled = { ...status, state: 'idle', message: null };
+                    writePluginStatus(dshStateDir, settled);
+                    return settled;
+                }
+            }
+            return { ...status, state };
         };
 
         registerRoute('GET', '/dsh-selfupdater/plugins', (_req, res) => {

package/lib/updater.mjs

@@ -176,7 +176,10 @@ function setState(state, message, extra = {}) {
         updatedAt: new Date().toISOString(),
         ...extra,
     };
-    try { writeFileSync(statusFile, JSON.stringify({ ...status, pid: process.pid }, null, 2)); } catch { /* 同上 */ }
+    try {
+        mkdirSync(dshStateDir, { recursive: true });
+        writeFileSync(statusFile, JSON.stringify({ ...status, pid: process.pid }, null, 2));
+    } catch { /* 状态落盘失败不阻断主流程（首次运行时 .dsh 可能尚不存在） */ }
     log(`state=${state}${message ? ` :: ${message}` : ''}`);
 }
 
@@ -226,20 +229,60 @@ function pnpmCommand() {
  * 升级各阶段
  * ------------------------------------------------------------------ */
 
+/** npm registry 查询超时。 */
+const FETCH_TIMEOUT_MS = 15000;
+/** 国内 npm 镜像（腾讯云），直连官方源超时时的第一回退。 */
+const NPM_CHINA_MIRROR = 'https://mirrors.cloud.tencent.com/npm';
+
+/** 本次要依次尝试的 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 !== ''))];
+}
+
 /**
- * 从 npm registry 查询目标包的最新版本号。
- * 直接读完整 packument 的 dist-tags.latest，网络异常抛错由上层处理。
+ * 从单个 registry 的 /latest 版本级端点取文档（含 dist.tarball）。
+ * 用版本级端点而非整包 packument：后者会被 Fastly 等 CDN 长时间缓存，
+ * 出现"包已发布但查不到新版"的假象（插件 0.4.5 踩坑根因）。
  */
-async function fetchLatestVersion(pkg) {
-    const res = await fetch(`https://registry.npmjs.org/${encodeURIComponent(pkg)}`, {
+async function fetchVersionDoc(base, pkg) {
+    const res = await fetch(`${base}/${encodeURIComponent(pkg)}/latest`, {
         headers: { accept: 'application/json', 'user-agent': 'dsh-selfupdater' },
-        signal: AbortSignal.timeout(15000),
+        signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
     });
-    if (!res.ok) throw new Error(`registry 查询失败: HTTP ${res.status}`);
+    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('registry 未返回 latest 版本号');
-    return latest;
+    if (typeof doc?.version !== 'string' || doc.version === '') throw new Error('响应缺少 version 字段');
+    return { version: doc.version, tarball: doc?.dist?.tarball ?? null };
+}
+
+/**
+ * 查询最新版本与下载地址（与 plugin-update-task.mjs 完全一致）。
+ *
+ * 0.4.14 经验复用：旧实现"第一个成功的 registry 就采用"，腾讯镜像 /latest 端点
+ * CDN 缓存陈旧时仍返回旧版本，导致"检查拿到新版、执行却被旧版骗过"而误判
+ * "无需更新"。改为并行查询全部 registry、取 semver 最大的结果。
+ */
+async function fetchLatestRelease(pkg) {
+    const candidates = registryCandidates();
+    const results = await Promise.allSettled(candidates.map((base) => fetchVersionDoc(base, pkg)));
+    let best = null;
+    const errors = [];
+    results.forEach((r, i) => {
+        if (r.status === 'fulfilled') {
+            if (best === null || isNewer(r.value.version, best.version)) best = r.value;
+        } else {
+            errors.push(`${candidates[i]}: ${r.reason.message}`);
+        }
+    });
+    if (best === null) throw new Error(errors.join('；'));
+    return best;
+}
+
+/** 仅取最新版本号（主流程使用）。 */
+async function fetchLatestVersion(pkg) {
+    return (await fetchLatestRelease(pkg)).version;
 }
 
 /**

package/package.json

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