@mrrisega/dsh-remote 0.7.12-beta.6 → 0.8.1-beta.1

package/packages/dsh-remote-web/lib/index.js

@@ -27,6 +27,7 @@ import { randomUUID } from "node:crypto";
 import { homedir, tmpdir } from "node:os";
 import { fileURLToPath } from "node:url";
 import { buildFixPrompt, REPORT_TITLE, REPORT_FORMAT, REPORT_KEYS } from "./fix-prompt.js";
+import { prepareLiveUpdate, reconcilePluginLive, readPluginPackage as readLivePluginPackage, restoreFromBackup } from "./live-update.js";
 
 /** 本插件在 host 侧的服务依赖。 */
 export const inject = ["webServer"];
@@ -3162,11 +3163,36 @@ function writeRestartState(relayDir, state) {
  * 标记「需要用户动一下」的状态。kind = refresh(插件被运行时改写,刷新页面即可)。
  * 历史 kind(first-install / update)已废弃:热加载落地后,装插件与在线更新都不再需要重启 harness。
  */
-/** 桌面端「暫存插件更新」marker（dsh-setup 在应用运行时暂存；bridge 在应用退出后自动安装）。 */
+/** 当前已装插件半的版本（读 profile 里那份 package.json；读不到返回空串）。 */
+function installedPluginVersion() {
+  try {
+    const pkg = readLivePluginPackage(join(pluginProfileDir(), "dsh-remote-web-plugin"));
+    return pkg ? String(pkg.version || "") : "";
+  } catch {
+    return "";
+  }
+}
+
+/**
+ * 桌面端「暂存插件更新」marker（dsh-setup 在应用运行时暂存；bridge 在应用退出后自动安装）。
+ *
+ * 0.8.1 修正（2026-11-11 真机事故）：marker 从不与已装版本比较，导致
+ *   ① 0.8.0 已经装好了，面板仍永久提示「新版本 0.8.0 已下载，退出后生效」；
+ *   ② 陈旧 marker 还可能让 bridge 把已升到的版本再"应用"一次（无版本比较 → 静默降级）。
+ * 现在：marker 版本 ≤ 已装版本 → 视为陈旧，删 marker 并返回 null。
+ */
 function readDesktopUpdatePending(relayDir) {
+  const markerPath = join(relayDir, ".plugin-update-pending.json");
   try {
-    const m = JSON.parse(readFileSync(join(relayDir, ".plugin-update-pending.json"), "utf8"));
-    return { version: String(m.version || ""), stagedAt: Number(m.stagedAt) || 0 };
+    const m = JSON.parse(readFileSync(markerPath, "utf8"));
+    const version = String(m.version || "");
+    const installed = installedPluginVersion();
+    const cmp = version && installed ? compareVersions(version, installed) : null;
+    if (cmp !== null && cmp <= 0) {
+      try { rmSync(markerPath, { force: true }); } catch { /* ignore */ }
+      return null;
+    }
+    return { version, stagedAt: Number(m.stagedAt) || 0 };
   } catch {
     return null;
   }
@@ -4638,6 +4664,74 @@ async function resolveUpdateTarget() {
   }
 }
 
+/* ── 0.8.1：插件半「立即升级」（换文件 + 宿主 HMR 重新 import，不再等"下次打开"） ──────────────
+ *
+ * 为什么必须新增这条路（2026-11-11 真机审计，见 dsh-relay-internal/.../09-升级失败根因与改造点.md）：
+ *   旧链路在桌面端只会把新插件暂存到 `~/.dsh-remote/pending-plugin`，唯一落地者是 bridge 的 15s
+ *   watcher，而它要求「应用已经关掉 ≥30s」；应用一直开着 → marker 永远不清、用户只能退出后再 npx。
+ *   宿主本身有活体通道：`hmr.reconcileProfile()` 会按 ino:size:mtime 比对已加载模块、驱逐 ESM 缓存
+ *   并用磁盘新文件重新 import；所以正确做法是「逐文件原子换版 + reconcile」，而不是整目录 rename
+ *   （整目录会被判成 package-moved → 要求重启应用），更不能原地写半成品（HMR 重新 import 时炸掉
+ *   宿主子进程，Electron 弹「启动失败」＝用户看到的闪退）。
+ */
+
+/** 准备插件半升级：下载（镜像优先）→ 备份 → 逐文件原子替换。不触发 HMR。 */
+async function runLivePluginUpdate(relayDir) {
+  const target = await resolveUpdateTarget();
+  const profileDir = pluginProfileDir();
+  const prep = await prepareLiveUpdate({
+    relayDir,
+    profileDir,
+    tag: target.tag,
+    version: target.version,
+  });
+  if (!prep.ok) {
+    appendLogLine(relayDir, UPDATE_LOG,
+      `[update] 插件半立即升级未执行：${prep.code || "UNKNOWN"} ${prep.detail || ""}`.trim());
+    return prep;
+  }
+  appendLogLine(relayDir, UPDATE_LOG,
+    `[update] 插件半已原子换版 ${prep.fromVersion} → ${prep.toVersion}（源 ${prep.registry || "?"}；${prep.files} 文件；${prep.ms}ms；备份 ${prep.backupDir}）`);
+  return prep;
+}
+
+/**
+ * 响应之后异步触发 HMR 重新加载；成功则无需重启应用（页面刷新即可看到新版本）。
+ * 失败时回滚文件并尽量把旧版重新挂上（保证"升不上去也不会把插件弄挂"）。
+ */
+function scheduleLiveReconcile(ctx, relayDir, prep) {
+  const timer = setTimeout(async () => {
+    const r = await reconcilePluginLive(ctx);
+    if (r.applied) {
+      appendLogLine(relayDir, UPDATE_LOG, `[update] 宿主 HMR 已重新加载插件 ${prep.toVersion}（无需重启应用）`);
+      telemetryRecord(relayDir, "update_applied_live");
+      try { settleRestartState(relayDir); } catch { /* ignore */ }
+      // 运行环境/桥半仍按原链路更新（独立进程，不阻塞面板；失败不影响已生效的插件半）
+      try { runOnlineUpdate(relayDir).catch(() => {}); } catch { /* ignore */ }
+      return;
+    }
+    const installed = installedPluginVersion();
+    if (r.restartReason) {
+      const reason = `插件 ${prep.toVersion} 已就位，需要重启 DeepSeek Harness 生效（${r.restartReason}）`;
+      markRestartPending(relayDir, "restart-app", reason);
+      appendLogLine(relayDir, UPDATE_LOG, `[update] 文件已更新，但宿主要求重启：${r.restartReason}`);
+      return;
+    }
+    // 兜底：回滚文件 → 再 reconcile 一次，让旧版回到运行态
+    try {
+      restoreFromBackup(prep.backupDir, join(pluginProfileDir(), "dsh-remote-web-plugin"));
+      appendLogLine(relayDir, UPDATE_LOG, `[update] 热加载失败，已回滚 ${prep.toVersion} → ${installed || prep.fromVersion}`);
+    } catch (e) {
+      appendLogLine(relayDir, UPDATE_LOG, `[update] 热加载失败且回滚失败：${e.message}`);
+    }
+    noteUpdateFailure(relayDir, `新版本已下载但热加载失败：${r.error || "未知"}（可重试；必要时重启应用）`, "hmr_reconcile_failed");
+    telemetryRecord(relayDir, "update_failed", { fail_code: "hmr_reconcile_failed" });
+    try { await reconcilePluginLive(ctx); } catch { /* ignore */ }
+  }, 250);
+  if (timer && typeof timer.unref === "function") timer.unref();
+  return timer;
+}
+
 /**
  * 语义化版本比较（只处理本仓库用到的形态：`X.Y.Z` 与 `X.Y.Z-<pre>.<n>`）。
  * 为什么需要它：面板判断"有没有新版本"不能只用 `latest !== current` ——
@@ -8349,7 +8443,39 @@ function registerRoutes(ctx, relayDir, opts = {}) {
       method: "POST",
       path: "/dsh-remote/self/update",
       handler: async (_req, res) => {
-        sendJson(res, 200, { ok: true, ...(await runOnlineUpdate(relayDir)) });
+        // 0.8.1：先走「立即升级」——下载（镜像优先）+ 逐文件原子换版，再让宿主 HMR 重新 import。
+        // 成功：不需要退出应用、不需要 npx；页面轮询到新版本后自动刷新。
+        const live = await runLivePluginUpdate(relayDir)
+          .catch((e) => ({ ok: false, code: "LIVE_UPDATE_ERROR", detail: String((e && e.message) || e) }));
+        if (live.ok) {
+          telemetryRecord(relayDir, "update_started");
+          scheduleLiveReconcile(ctx, relayDir, live);
+          sendJson(res, 200, {
+            ok: true,
+            mode: "live",
+            fromVersion: live.fromVersion,
+            toVersion: live.toVersion,
+            requiresReload: true,
+            registry: live.registry || "",
+            detail: `已换版 ${live.fromVersion} → ${live.toVersion}（${live.registry || "registry"}），宿主正在热加载`,
+          });
+          return;
+        }
+        // 立即升级走不通（已是最新 / 网络失败 / 无 HMR / 拒绝降级）→ 记录后回退原 npx 链路，行为与旧版一致
+        appendLogLine(relayDir, UPDATE_LOG,
+          `[update] 立即升级未成功（${live.code || "UNKNOWN"}: ${live.detail || ""}），回退在线安装链路`.trim());
+        // 已是最新（或要装的是更低版本）：不要为了"做事"再去跑一遍 npx —— 那会把同版本重装一次，还可能触发暂存。
+        if (live.code === "VERSION_UNCHANGED" || live.code === "DOWNGRADE_REFUSED") {
+          sendJson(res, 200, { ok: true, mode: "current", detail: live.detail || "已是最新版本", liveCode: live.code });
+          return;
+        }
+        sendJson(res, 200, {
+          ok: true,
+          ...(await runOnlineUpdate(relayDir)),
+          liveFallback: true,
+          liveCode: live.code || "",
+          liveDetail: live.detail || "",
+        });
       },
     },
     {

package/packages/dsh-remote-web/lib/live-update.js

@@ -0,0 +1,238 @@
+/**
+ * 插件半「立即升级」：下载新版本 → 原子换文件 → 让宿主 HMR 重新 import。
+ *
+ * 为什么需要这个模块（2026-11-11 真机审计结论）：
+ *   · 现有「一键更新」在桌面端只会把新插件**暂存**到 `~/.dsh-remote/pending-plugin`，而唯一
+ *     落地者（bridge 的 15s watcher）要求「应用已经关掉 ≥30s」——应用一直开着就永远不落地，
+ *     用户只能退出应用再自己 `npx`。
+ *   · 宿主其实提供了活体升级通道：`hmr.reconcileProfile()` 会按 `ino:size:mtime` 比对本插件
+ *     已加载的模块文件，驱逐 ESM 缓存并用磁盘上的新代码重新 import（见 @deepseek-ai/dsh-hmr
+ *     lib/index.js 的 reconcileProfile 注释）。所以正确做法是「把新版本文件原地换掉 + 触发 reconcile」，
+ *     而不是「整目录 rename」——整目录会被判成 package-moved，要求重启应用。
+ *   · 换文件必须逐文件 temp+rename（不能原地写半成品）：HMR 在重新 import 时读到半个文件会让
+ *     宿主插件抛出、宿主子进程退出，Electron 随即弹「启动失败」= 用户看到的闪退。
+ *
+ * 这个模块只做文件与备份，不依赖宿主服务；reconcile 由调用方用 ctx.get('hmr') 执行。
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import { fetchTarballToStaging, resolveRegistryOrder } from "./self-update.js";
+
+/** 插件目录名（profile 内）。历史名 dsh-remote-ui-plugin 也认。 */
+export const PLUGIN_DIR_NAMES = Object.freeze(["dsh-remote-web-plugin", "dsh-remote-ui-plugin"]);
+/** npm tarball 里插件半相对路径（解包时已剥掉 tarball 顶层 package/ 前缀）。 */
+export const TARBALL_PLUGIN_SUBDIR = path.posix.join("packages", "dsh-remote-web");
+/** 必需文件（缺任何一个都判为坏包，不落盘）。 */
+export const REQUIRED_FILES = Object.freeze(["package.json", "lib/index.js", "lib/client.js", "lib/tarball-update.js"]);
+
+/** semver 比较（与 index.js 的 compareVersions 同义，独立一份避免循环依赖）。 */
+export function compareVersions(a, b) {
+  const parse = (v) => {
+    const m = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?/.exec(String(v || "").trim());
+    if (!m) return null;
+    return { nums: [Number(m[1]), Number(m[2]), Number(m[3])], pre: m[4] ? m[4].split(".") : null };
+  };
+  const x = parse(a);
+  const y = parse(b);
+  if (!x || !y) return null;
+  for (let i = 0; i < 3; i += 1) if (x.nums[i] !== y.nums[i]) return x.nums[i] > y.nums[i] ? 1 : -1;
+  if (!x.pre && !y.pre) return 0;
+  if (!x.pre) return 1;
+  if (!y.pre) return -1;
+  const len = Math.max(x.pre.length, y.pre.length);
+  for (let i = 0; i < len; i += 1) {
+    const p1 = x.pre[i];
+    const p2 = y.pre[i];
+    if (p1 === undefined) return -1;
+    if (p2 === undefined) return 1;
+    if (p1 === p2) continue;
+    const n1 = /^\d+$/.test(p1);
+    const n2 = /^\d+$/.test(p2);
+    if (n1 && n2) return Number(p1) > Number(p2) ? 1 : -1;
+    if (n1) return -1;
+    if (n2) return 1;
+    return p1 > p2 ? 1 : -1;
+  }
+  return 0;
+}
+
+export function readPluginPackage(dir) {
+  try {
+    const raw = JSON.parse(fs.readFileSync(path.join(dir, "package.json"), "utf8"));
+    return { name: String(raw.name || ""), version: String(raw.version || "") };
+  } catch {
+    return null;
+  }
+}
+
+/** 递归列出目录下所有普通文件（相对路径，POSIX 分隔）。符号链接跳过（安全：不跟随到目录外）。 */
+export function listFiles(root) {
+  const out = [];
+  const walk = (dir, rel) => {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const e of entries) {
+      const abs = path.join(dir, e.name);
+      const r = rel ? `${rel}/${e.name}` : e.name;
+      if (e.isSymbolicLink()) continue;
+      if (e.isDirectory()) walk(abs, r);
+      else if (e.isFile()) out.push(r);
+    }
+  };
+  walk(root, "");
+  return out;
+}
+
+/** 把目录完整复制成一份备份（保留权限位；不跟随符号链接）。 */
+export function copyTree(srcDir, dstDir) {
+  fs.mkdirSync(path.dirname(dstDir), { recursive: true });
+  fs.cpSync(srcDir, dstDir, { recursive: true, dereference: false, force: true, errorOnExist: false });
+}
+
+/**
+ * 逐文件原子替换：新文件先写进目标同目录的 `.tmp-*`，再逐个 rename 覆盖。
+ * rename 在同一文件系统内是原子的，HMR 重新 import 时不会看到半个文件。
+ * @returns {{files:number, dirs:number}}
+ */
+export function replaceFilesInPlace(srcDir, targetDir, { fsImpl = fs } = {}) {
+  const files = listFiles(srcDir);
+  if (files.length === 0) throw new Error("新版本里没有任何文件");
+  let dirs = 0;
+  const pending = [];
+  for (const rel of files) {
+    const src = path.join(srcDir, rel);
+    const dst = path.join(targetDir, rel);
+    const dstDir = path.dirname(dst);
+    if (!fsImpl.existsSync(dstDir)) { fsImpl.mkdirSync(dstDir, { recursive: true }); dirs += 1; }
+    const tmp = path.join(dstDir, `.tmp-${path.basename(dst)}-${process.pid}-${Math.random().toString(16).slice(2, 10)}`);
+    fsImpl.copyFileSync(src, tmp);
+    try { fsImpl.chmodSync(tmp, fsImpl.statSync(src).mode & 0o777); } catch { /* 权限位失败不致命 */ }
+    pending.push([tmp, dst]);
+  }
+  // 先写完全部临时文件，再连续 rename（窗口尽可能短）
+  for (const [tmp, dst] of pending) fsImpl.renameSync(tmp, dst);
+  return { files: files.length, dirs };
+}
+
+/** 旧版本备份目录（profile 内、插件目录外；不影响 HMR 的模块比对）。 */
+export function backupDirFor(profileDir) {
+  const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+  return path.join(profileDir, ".dsh-remote-backups", stamp);
+}
+
+/** 备份数量上限（保留最近 3 份）。 */
+export function pruneBackups(profileDir, keep = 3) {
+  const root = path.join(profileDir, ".dsh-remote-backups");
+  let names = [];
+  try { names = fs.readdirSync(root).filter((n) => !n.startsWith(".")); } catch { return 0; }
+  names.sort();
+  let removed = 0;
+  for (const n of names.slice(0, Math.max(0, names.length - keep))) {
+    try { fs.rmSync(path.join(root, n), { recursive: true, force: true }); removed += 1; } catch { /* ignore */ }
+  }
+  return removed;
+}
+
+/**
+ * 准备一次插件半升级：下载 → 校验 → 备份 → 逐文件替换。
+ * 不触发 HMR；调用方拿到结果后再决定何时 reconcile（必须在响应发出之后）。
+ * @returns {Promise<{ok:boolean, code?:string, detail?:string, fromVersion?:string, toVersion?:string, backupDir?:string, stageRoot?:string, files?:number, registry?:string, registryAttempts?:object[], ms?:number}>}
+ */
+export async function prepareLiveUpdate({
+  relayDir,
+  profileDir,
+  targetDir,
+  tag = "latest",
+  version = "",
+  stageDir = path.join(relayDir, "live-update-stage"),
+  registries = resolveRegistryOrder(),
+  timeoutMs = 20000,
+} = {}) {
+  const startedAt = Date.now();
+  const dir = targetDir || path.join(profileDir, PLUGIN_DIR_NAMES[0]);
+  const before = readPluginPackage(dir);
+  if (!before) return { ok: false, code: "TARGET_NOT_FOUND", detail: `没有找到已安装的插件目录：${dir}` };
+
+  const fetched = await fetchTarballToStaging({ tag, version, stageDir, registries, timeoutMs })
+    .catch((e) => ({
+      ok: false,
+      code: (e && e.code) || "FETCH_FAILED",
+      detail: String(e && e.message ? e.message : e),
+      attempts: e && e.attempts,
+    }));
+  if (!fetched || !fetched.ok) {
+    return { ok: false, code: (fetched && fetched.code) || "FETCH_FAILED", detail: (fetched && fetched.detail) || "下载新版本失败", attempts: fetched && fetched.attempts, ms: Date.now() - startedAt };
+  }
+  // self-update 会在 stageRoot 里给出根包（@mrrisega/dsh-remote），其中插件半在 packages/dsh-remote-web；
+  // 优先用它的 payloadRoot（若返回），否则按约定路径取。
+  const payloadRoot = fetched.payloadRoot || path.join(fetched.stageRoot, TARBALL_PLUGIN_SUBDIR);
+  const pkgDir = payloadRoot;
+  const next = readPluginPackage(pkgDir);
+  if (!next) return { ok: false, code: "BAD_TARBALL", detail: `新版本包里没有插件半：${TARBALL_PLUGIN_SUBDIR}` };
+  if (next.name && next.name !== "dsh-remote-web") return { ok: false, code: "NAME_MISMATCH", detail: `包内插件名不是 dsh-remote-web：${next.name}` };
+  for (const rel of REQUIRED_FILES) {
+    if (!fs.existsSync(path.join(pkgDir, rel))) return { ok: false, code: "BAD_TARBALL", detail: `新版本缺文件：${rel}` };
+  }
+  const cmp = compareVersions(next.version, before.version);
+  if (cmp === 0) return { ok: false, code: "VERSION_UNCHANGED", detail: `已经是最新版本 ${before.version}`, fromVersion: before.version, toVersion: next.version };
+  if (cmp !== null && cmp < 0) return { ok: false, code: "DOWNGRADE_REFUSED", detail: `拒绝降级：${before.version} → ${next.version}`, fromVersion: before.version, toVersion: next.version };
+
+  const backupDir = backupDirFor(profileDir);
+  try {
+    copyTree(dir, backupDir);
+  } catch (e) {
+    return { ok: false, code: "BACKUP_FAILED", detail: `备份旧版本失败：${e.message}` };
+  }
+  try {
+    const r = replaceFilesInPlace(pkgDir, dir);
+    const installed = readPluginPackage(dir);
+    if (!installed || installed.version !== next.version) {
+      // 读回来的版本不对 → 立即回滚，避免留下半套
+      try { restoreFromBackup(backupDir, dir); } catch { /* ignore */ }
+      return { ok: false, code: "VERIFY_FAILED", detail: `替换后版本校验失败：期望 ${next.version}，实际 ${installed && installed.version}` };
+    }
+    pruneBackups(profileDir);
+    return {
+      ok: true,
+      fromVersion: before.version,
+      toVersion: installed.version,
+      backupDir,
+      stageRoot: fetched.stageRoot,
+      files: r.files,
+      registry: fetched.registry,
+      registryAttempts: fetched.attempts,
+      ms: Date.now() - startedAt,
+    };
+  } catch (e) {
+    try { restoreFromBackup(backupDir, dir); } catch { /* ignore */ }
+    return { ok: false, code: "APPLY_FAILED", detail: `替换文件失败（已回滚）：${e.message}` };
+  }
+}
+
+/** 用备份恢复目标目录（失败路径用；目录整体替换，随后必须重新 reconcile）。 */
+export function restoreFromBackup(backupDir, targetDir) {
+  if (!fs.existsSync(backupDir)) throw new Error(`备份不存在：${backupDir}`);
+  fs.rmSync(targetDir, { recursive: true, force: true });
+  fs.cpSync(backupDir, targetDir, { recursive: true, dereference: false, force: true });
+}
+
+/**
+ * 让宿主 HMR 重新 import 插件（免重启的核心一步）。
+ * 调用方必须在 HTTP 响应已经发出之后调用，避免旧实例被停止时把响应截断。
+ * @returns {Promise<{applied:boolean, restartReason?:string, warnings?:string[], error?:string}>}
+ */
+export async function reconcilePluginLive(ctx, { entryIds = [] } = {}) {
+  let hmr = null;
+  try { hmr = typeof ctx.get === "function" ? ctx.get("hmr") : null; } catch { hmr = null; }
+  if (!hmr || typeof hmr.runExclusive !== "function" || typeof hmr.reconcileProfile !== "function") {
+    return { applied: false, error: "宿主没有 hmr 服务，无法热加载（需要重启应用）" };
+  }
+  try {
+    const result = await hmr.runExclusive(() => hmr.reconcileProfile(entryIds));
+    const restartReason = result && result.restartReason;
+    const warnings = (result && result.warnings) || [];
+    return restartReason ? { applied: false, restartReason, warnings } : { applied: true, warnings };
+  } catch (e) {
+    return { applied: false, error: String(e && e.message ? e.message : e) };
+  }
+}