@mrrisega/dsh-remote 0.7.6-beta.2 → 0.7.6-beta.3

package/clients/dsh-remote/dsh-bridge.mjs

@@ -82,6 +82,7 @@ import WebSocket from "ws";
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
+import net from "node:net";
 import { execSync, spawnSync } from "node:child_process";
 import { randomBytes, generateKeyPairSync, createHash } from "node:crypto";
 import { pathToFileURL, fileURLToPath } from "node:url";
@@ -2723,9 +2724,109 @@ async function main() {
     console.log("[bridge] 单实例锁检查降级（取不到进程命令行或锁不可写）——照常启动；若出现 code=4000 互踢，本实例会自动让位。");
   }
   process.on("exit", releaseInstanceLock);
+  // 桌面端插件「暂存更新」自动安装（应用退出后生效；见 applyPendingPluginUpdate 注释）
+  startPendingPluginUpdateWatcher();
   return runTunnel();
 }
 
+// ── 桌面端插件「暫存安装」落地（2026-10-24）────────────────────────────────────────────
+// dsh-setup 在桌面应用运行时无法直接改写它的 profile（会触发应用退出/重启），改为暂存到
+// <relayDir>/pending-plugin/ 并写 marker；bridge 常驻、检测到应用退出后自动原子替换插件目录，
+// 用户下次打开应用即加载新版 —— 这样「一键更新」对桌面端也能真正生效（不再需要终端）。
+const PENDING_PLUGIN_MARKER = path.join(RELAY_DIR, ".plugin-update-pending.json");
+const PENDING_PLUGIN_REQUIRED = ["package.json", "lib/index.js", "lib/client.js", "cordis.patch.yml"];
+const PENDING_PLUGIN_DISABLED = process.env.DSH_BRIDGE_PENDING_UPDATE === "0";
+
+/** upstream 端口是否在监听（= DeepSeek Harness 桌面端在运行）。TCP 判断，跨平台。 */
+export function probeUpstreamListening({ host = "127.0.0.1", port, timeoutMs = 400 } = {}) {
+  return new Promise((resolve) => {
+    if (!port) return resolve(false);
+    const sock = net.connect({ host, port });
+    let done = false;
+    const finish = (v) => { if (done) return; done = true; try { sock.destroy(); } catch { /* 忽略 */ } resolve(v); };
+    sock.setTimeout(timeoutMs, () => finish(false));
+    sock.once("connect", () => finish(true));
+    sock.once("error", () => finish(false));
+  });
+}
+function upstreamPortOf(url) {
+  try { const u = new URL(String(url)); return Number(u.port) || (u.protocol === "https:" ? 443 : 80); } catch { return 0; }
+}
+
+/**
+ * 应用暂存的插件更新（仅在桌面应用不在运行时）。原子替换：staging → rename，失败保留旧版。
+ * @returns {{applied:boolean, reason?:string, version?:string, error?:string}}
+ */
+export async function applyPendingPluginUpdate({ relayDir = RELAY_DIR, isAppRunning, now = Date.now(), log = console } = {}) {
+  const markerPath = path.join(relayDir, ".plugin-update-pending.json");
+  let marker;
+  try { marker = JSON.parse(fs.readFileSync(markerPath, "utf8")); } catch { return { applied: false, reason: "no_pending" }; }
+  const stageDir = String(marker.stageDir || "");
+  const profileDir = String(marker.profileDir || "");
+  const name = String(marker.pluginDirName || "dsh-remote-web-plugin");
+  if (!stageDir || !profileDir || !fs.existsSync(stageDir)) {
+    try { fs.rmSync(markerPath, { force: true }); } catch { /* 忽略 */ }
+    return { applied: false, reason: "staging_missing" };
+  }
+  const running = typeof isAppRunning === "function"
+    ? await isAppRunning()
+    : await probeUpstreamListening({ port: upstreamPortOf(UPSTREAM) });
+  if (running) return { applied: false, reason: "app_running" };
+  const dest = path.join(profileDir, name);
+  const stage = `${dest}.staging-${process.pid}`;
+  const backup = `${dest}.backup-${process.pid}`;
+  try {
+    fs.rmSync(stage, { recursive: true, force: true });
+    fs.cpSync(stageDir, stage, { recursive: true });
+    for (const rel of PENDING_PLUGIN_REQUIRED) {
+      if (!fs.existsSync(path.join(stage, rel))) throw new Error(`暂存包缺少 ${rel}`);
+    }
+    fs.rmSync(backup, { recursive: true, force: true });
+    const had = fs.existsSync(dest);
+    if (had) fs.renameSync(dest, backup);
+    try {
+      fs.renameSync(stage, dest);
+    } catch (e) {
+      if (had) { try { fs.renameSync(backup, dest); } catch { /* 忽略 */ } }
+      throw e;
+    }
+    if (had) { try { fs.rmSync(backup, { recursive: true, force: true }); } catch { /* 忽略 */ } }
+    try {
+      fs.writeFileSync(
+        path.join(relayDir, ".plugin-update-applied.json"),
+        JSON.stringify({ version: marker.version, appliedAt: now, profileDir }, null, 2) + "\n"
+      );
+    } catch { /* 忽略 */ }
+    try { fs.rmSync(markerPath, { force: true }); fs.rmSync(stageDir, { recursive: true, force: true }); } catch { /* 忽略 */ }
+    log.info?.(`[bridge] ✅ 插件新版本 ${marker.version} 已自动安装到 ${profileDir}（桌面应用退出后）；重新打开应用即生效`);
+    return { applied: true, version: marker.version };
+  } catch (e) {
+    try { fs.rmSync(stage, { recursive: true, force: true }); } catch { /* 忽略 */ }
+    log.warn?.(`[bridge] 插件暂存安装失败（保留旧版可回退）：${e && e.message ? e.message : e}`);
+    return { applied: false, reason: "apply_failed", error: String((e && e.message) || e) };
+  }
+}
+
+function startPendingPluginUpdateWatcher() {
+  if (PENDING_PLUGIN_DISABLED) return null;
+  let closedStreak = 0;
+  const tick = async () => {
+    try {
+      if (!fs.existsSync(PENDING_PLUGIN_MARKER)) { closedStreak = 0; return; }
+      const running = await probeUpstreamListening({ port: upstreamPortOf(UPSTREAM) });
+      if (running) { closedStreak = 0; return; }
+      closedStreak += 1;
+      if (closedStreak < 2) return; // 连续两次（≈30s）判定不在运行才动手，避开退出/重启瞬间
+      await applyPendingPluginUpdate({});
+      closedStreak = 0;
+    } catch { /* 绝不影响隧道业务 */ }
+  };
+  const t = setInterval(tick, 15_000);
+  t.unref?.();
+  void tick();
+  return t;
+}
+
 // test hooks：镜像页加载看门狗的内部状态（给用例断言"后续请求会撤掉它"，见 test/bridge-html-inject.test.mjs）
 export function __mirrorLoadWatchState() { return mirrorLoadWatch ? { ...mirrorLoadWatch } : null; }
 export function __armMirrorLoadWatch(path) { armMirrorLoadWatch(path); }

package/clients/dsh-remote/test/pending-plugin-update.test.mjs

@@ -0,0 +1,96 @@
+/**
+ * 桌面端插件「暂存更新」自动安装（2026-10-24）契约测试。
+ *
+ * 背景：桌面端应用独占自己的 profile，运行中不能改写（会触发应用退出/重启）。
+ * 一键更新在应用运行中只能「暂存」，由常驻 bridge 在检测到应用退出后自动安装，
+ * 用户下次打开应用即生效 —— 否则就会出现「更新成功但版本没变、还得开终端」。
+ *
+ * 这里钉住四条最容易破的语义：
+ *   ① 应用还在运行 → 绝不改写 profile（返回 app_running，marker 保留等待下一轮）；
+ *   ② 应用退出 → 原子替换插件目录、写 applied marker、清掉暂存与 marker；
+ *   ③ 暂存包不完整（缺必需文件）→ 不动旧版，返回 apply_failed；
+ *   ④ 没有 marker → no_pending（定时器空转，绝不能误删东西）。
+ */
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { applyPendingPluginUpdate } from "../dsh-bridge.mjs";
+
+function mkTmpDir() {
+  return fs.mkdtempSync(path.join(os.tmpdir(), "dsh-pending-plugin-"));
+}
+
+function writeFile(p, content) {
+  fs.mkdirSync(path.dirname(p), { recursive: true });
+  fs.writeFileSync(p, content);
+}
+
+/** 造一个「旧版插件已安装 + 新版已暂存 + marker」的环境。 */
+function setupFixture({ stageComplete = true } = {}) {
+  const relayDir = mkTmpDir();
+  const profileDir = mkTmpDir();
+  const pluginName = "dsh-remote-web-plugin";
+  const dest = path.join(profileDir, pluginName);
+  // 旧版
+  writeFile(path.join(dest, "package.json"), JSON.stringify({ name: "dsh-remote-web", version: "0.7.4" }));
+  writeFile(path.join(dest, "lib", "index.js"), "// old\n");
+  writeFile(path.join(dest, "lib", "client.js"), "// old\n");
+  writeFile(path.join(dest, "cordis.patch.yml"), "old: true\n");
+  // 新版暂存
+  const stageDir = path.join(relayDir, "pending-plugin");
+  writeFile(path.join(stageDir, "lib", "index.js"), "// new\n");
+  if (stageComplete) {
+    writeFile(path.join(stageDir, "package.json"), JSON.stringify({ name: "dsh-remote-web", version: "0.7.6-beta.2" }));
+    writeFile(path.join(stageDir, "lib", "client.js"), "// new\n");
+    writeFile(path.join(stageDir, "cordis.patch.yml"), "new: true\n");
+  }
+  writeFile(
+    path.join(relayDir, ".plugin-update-pending.json"),
+    JSON.stringify({ version: "0.7.6-beta.2", profileDir, pluginDirName: pluginName, stageDir, stagedAt: Date.now() })
+  );
+  return { relayDir, profileDir, dest, stageDir, pluginName };
+}
+
+test("① 应用仍在运行 → 不改写 profile，marker 保留", async () => {
+  const { relayDir, dest } = setupFixture();
+  const r = await applyPendingPluginUpdate({ relayDir, isAppRunning: async () => true });
+  assert.equal(r.applied, false);
+  assert.equal(r.reason, "app_running");
+  assert.match(fs.readFileSync(path.join(dest, "package.json"), "utf8"), /0\.7\.4/, "旧版必须原样保留");
+  assert.ok(fs.existsSync(path.join(relayDir, ".plugin-update-pending.json")), "marker 必须保留给下一轮");
+});
+
+test("② 应用已退出 → 原子替换为新版，写 applied marker 并清理暂存", async () => {
+  const { relayDir, dest, stageDir } = setupFixture();
+  const r = await applyPendingPluginUpdate({ relayDir, isAppRunning: async () => false });
+  assert.equal(r.applied, true);
+  assert.equal(r.version, "0.7.6-beta.2");
+  assert.match(fs.readFileSync(path.join(dest, "package.json"), "utf8"), /0\.7\.6-beta\.2/, "profile 内必须是新版");
+  assert.match(fs.readFileSync(path.join(dest, "lib", "index.js"), "utf8"), /new/);
+  const applied = JSON.parse(fs.readFileSync(path.join(relayDir, ".plugin-update-applied.json"), "utf8"));
+  assert.equal(applied.version, "0.7.6-beta.2");
+  assert.equal(fs.existsSync(path.join(relayDir, ".plugin-update-pending.json")), false, "marker 必须清掉");
+  assert.equal(fs.existsSync(stageDir), false, "暂存目录必须清掉");
+  // 不留 staging/backup 垃圾
+  const leftovers = fs.readdirSync(path.dirname(dest)).filter((n) => /\.(staging|backup)-/.test(n));
+  assert.deepEqual(leftovers, []);
+});
+
+test("③ 暂存包不完整 → 保留旧版、返回 apply_failed", async () => {
+  const { relayDir, dest } = setupFixture({ stageComplete: false });
+  const r = await applyPendingPluginUpdate({ relayDir, isAppRunning: async () => false });
+  assert.equal(r.applied, false);
+  assert.equal(r.reason, "apply_failed");
+  assert.ok(r.error && /缺少/.test(r.error), "错误里要写清缺哪个文件");
+  assert.match(fs.readFileSync(path.join(dest, "package.json"), "utf8"), /0\.7\.4/, "旧版必须可回退");
+  assert.ok(fs.existsSync(path.join(relayDir, ".plugin-update-pending.json")), "marker 保留，等下次修复后重试");
+});
+
+test("④ 没有 marker → no_pending（定时器不得误动作）", async () => {
+  const relayDir = mkTmpDir();
+  const r = await applyPendingPluginUpdate({ relayDir, isAppRunning: async () => false });
+  assert.equal(r.applied, false);
+  assert.equal(r.reason, "no_pending");
+});

package/dsh-setup.mjs

@@ -2583,6 +2583,45 @@ function missingPluginFiles(dir) {
  *
  * 另外清掉上次被强杀留下的 `.staging-*` / `.backup-*`，不留垃圾。
  */
+// ── 桌面端「暫存安装」：应用运行中不能改写它的 profile（会把它弄退出/重启），
+// 但用户点「一键更新」必须能装到桌面端。做法：先整份拷到 ~/.dsh-remote/pending-plugin/ 并写 marker，
+// 由常驻的 bridge 在检测到应用退出后自动原子替换 profile 内的插件目录（见 dsh-bridge.mjs）。
+const PENDING_PLUGIN_MARKER = path.join(CONFIG_DIR, ".plugin-update-pending.json");
+const PENDING_PLUGIN_DIR = path.join(CONFIG_DIR, "pending-plugin");
+
+/** 暂存一份插件更新（供 bridge 在应用退出后安装）。返回 marker 对象。 */
+function stagePluginUpdateForProfile(profileDir, pluginDir) {
+  fs.rmSync(PENDING_PLUGIN_DIR, { recursive: true, force: true });
+  fs.mkdirSync(PENDING_PLUGIN_DIR, { recursive: true });
+  const cpOpts = {
+    recursive: true,
+    filter: (src) => {
+      if (src === pluginDir) return true;
+      const rel = String(path.relative(pluginDir, src));
+      const segs = rel.split(path.sep);
+      if (segs.some((seg) => seg === ".git" || seg === ".DS_Store")) return false;
+      const inBundledRuntime = segs[0] === "runtime";
+      if (!inBundledRuntime && segs.some((seg) => seg === "node_modules")) return false;
+      return true;
+    }
+  };
+  fs.cpSync(pluginDir, PENDING_PLUGIN_DIR, cpOpts);
+  for (const rel of PLUGIN_REQUIRED_FILES) {
+    const f = path.join(PENDING_PLUGIN_DIR, rel);
+    if (!fs.existsSync(f)) throw new Error(`暂存校验失败：缺少 ${rel}`);
+  }
+  const version = JSON.parse(fs.readFileSync(path.join(pluginDir, "package.json"), "utf8")).version;
+  const marker = {
+    version,
+    profileDir,
+    pluginDirName: PLUGIN_LOCAL_DIR,
+    stageDir: PENDING_PLUGIN_DIR,
+    stagedAt: Date.now()
+  };
+  fs.writeFileSync(PENDING_PLUGIN_MARKER, JSON.stringify(marker, null, 2) + "\n");
+  return marker;
+}
+
 function copyPluginIntoProfile(profileDir, pluginDir) {
   // 清理历史名残留目录（≤0.4.9 的 dsh-remote-ui-plugin），避免与新版并存
   for (const id of PLUGIN_LEGACY_IDS) {
@@ -3031,16 +3070,21 @@ async function pluginCmd(argv) {
   let last = null;
   let ok = 0;
   let skippedRunning = 0;
+  let stagedRunning = 0;
   const force = hasFlag(argv, "--force");
   for (const t of targets) {
     // ⚠️ 桌面应用在运行时**绝不改写它的 profile**：应用会因此退出/重启（2026-10-11 实测故障）
     if (t.name === "desktop" && !force && dshDesktopAppRunning()) {
-      console.log(`⚠️ 跳过 desktop：DeepSeek Harness 应用正在运行。`);
-      console.log(`   应用独占该 profile，运行中改写会让应用自己退出/重启。请任选其一：`);
-      console.log(`     · 完全退出应用后重跑本命令；或`);
-      console.log(`     · 在应用内「插件」页安装/更新 dsh-remote-web（官方路径，装完即热加载）。`);
-      console.log(`   （确实要强行写入：加 --force）`);
-      skippedRunning += 1;
+      console.log(`⚠️ DeepSeek Harness 应用正在运行 → 不直接改写它的 profile（会把它弄退出/重启）。`);
+      try {
+        const staged = stagePluginUpdateForProfile(t.dir, path.join(THIS_DIR, "packages", PLUGIN_ID));
+        stagedRunning += 1;
+        console.log(`   ✅ 新版本 ${staged.version} 已暂存：**退出 DeepSeek Harness 后会自动安装**，重新打开应用即生效（无需终端）。`);
+      } catch (e) {
+        console.log(`   ⚠️ 暂存失败：${e && e.message ? e.message : e}`);
+        console.log(`   请完全退出应用后重跑本命令，或在应用内「插件」页安装/更新 dsh-remote-web。`);
+        skippedRunning += 1;
+      }
       continue;
     }
     if (multi) console.log(`\n── profile: ${t.name}（${t.dir}）`);
@@ -3050,6 +3094,7 @@ async function pluginCmd(argv) {
     if (r !== undefined && r !== null) last = r;
   }
   if (ok === 0 && skippedRunning === 0) process.exit(1);
+  if (stagedRunning > 0) console.log(`ℹ 桌面端插件已暂存（${stagedRunning} 个）：退出 DeepSeek Harness 后由后台服务自动安装，重开应用生效。`);
   if (skippedRunning > 0) console.log(`ℹ 本次跳过了 ${skippedRunning} 个 profile（应用在运行）；桥与运行环境不受影响。`);
   return last;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrisega/dsh-remote",
-  "version": "0.7.6-beta.2",
+  "version": "0.7.6-beta.3",
   "description": "手机远程控制 DeepSeek Harness · Remote control DeepSeek Harness (dsh web) from any phone browser — 100% 全功能 App 级体验：发消息、看工具执行、审批权限、改设置、管凭据，含特权操作，免内网穿透。一条命令安装 npx @mrrisega/dsh-remote。Mobile remote control for DSH, self-host or SaaS, no server needed on LAN.",
   "keywords": [
     "deepseek-harness",

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

@@ -2950,6 +2950,8 @@ window.__ModuleLoader__.load({
         : "已停止";
       // 是否需要重启 DeepSeek harness（首次安装/在线更新后置顶提醒 + 底部常驻按钮）
       var restartInfo = (st && st.restart) || {};
+      // 桌面端「暫存插件更新」：新版本已下载，退出应用后由 bridge 自动安装（见 dsh-bridge 的 applier）
+      var desktopUpdatePending = (st && st.desktopUpdatePending) || null;
       var restartPending = !!restartInfo.pending;
       // 宿主形态（node 半下发）：桌面端（Electron）Host 由桌面应用托管，重启这个动作
       // 在那边**做不到也不该做**（强行退出会弹原生致命错误）。面板据此：
@@ -5309,12 +5311,18 @@ window.__ModuleLoader__.load({
           // 不该混在桌面端适配里顺手做掉。桌面端才走新文案。
           // 2026-10-17（业主）：桌面端运行环境由应用托管、更新自动热加载 ——
           // **不再引导用户重启 DeepSeek Harness**，统一只说「刷新页面即可生效」。
-          var restartRowText = (desktopHost || !isRestartHard)
-            ? "🔄 插件已更新：刷新页面即可生效"
-            : "🔄 插件已更新：重启 dsh web 后生效";
+          // 桌面端：插件更新需要退出并重新打开应用（应用独占 profile，不能热改）；
+          // 若已暂存新版本，bridge 会在应用退出后自动安装，重开即生效 —— 绝不说「刷新页面即可」。
+          var restartRowText = desktopHost
+            ? (desktopUpdatePending
+              ? "🆕 新版本已下载：退出并重新打开 DeepSeek Harness 后自动生效（无需终端）"
+              : "🔄 插件已更新：退出并重新打开 DeepSeek Harness 后生效")
+            : (!isRestartHard
+              ? "🔄 插件已更新：刷新页面即可生效"
+              : "🔄 插件已更新：重启 dsh web 后生效");
           rows.push(h("div", { className: "dru-access-tip-row", key: "restart" },
             h("span", null, restartRowText),
-            (isRefreshOnly || !desktopHost) ? h("button", {
+            (!desktopHost || isRefreshOnly) && !desktopHost ? h("button", {
               type: "button",
               className: "dru-linkbtn",
               disabled: busy !== "",
@@ -5366,13 +5374,17 @@ window.__ModuleLoader__.load({
                     // **任何情况都不再引导"重启/退出重开应用"**，只说「刷新页面即可生效」。
                     // 非桌面端（自建 dsh web）保留原有 isRestartHard 判据，文案不变。
                     desktopHost
-                      ? "插件已更新：刷新页面即可生效"
+                      ? (desktopUpdatePending
+                        ? "新版本已下载：退出并重新打开 DeepSeek Harness 后生效"
+                        : "插件已更新：退出并重新打开 DeepSeek Harness 后生效")
                       : (isRestartHard
                         ? "插件已更新，重启 dsh web 后生效"
                         : (isRefreshOnly ? "插件已更新，刷新页面即可生效" : "需要重启 dsh web 才能载入新插件"))),
                   h("div", { className: "dru-restart-alert-sub" },
                     desktopHost
-                      ? "新插件已经在磁盘上，刷新一下这个页面即可载入（手机端连接与已登录状态都不受影响）。如果刷新后仍看不到面板，在应用内「插件」页重新安装一次即可。"
+                      ? (desktopUpdatePending
+                        ? "新版本已经下载到本机；DeepSeek Harness 退出后，后台服务会自动完成安装，重新打开应用即生效（无需终端，手机端连接与已登录状态都不受影响）。"
+                        : "新插件已在磁盘上，但桌面应用仍在运行旧插件；退出 DeepSeek Harness 后重新打开即可载入新版（应用退出后后台服务会自动完成安装，无需终端）。")
                       : (isRestartHard
                         ? "新版本已经装到这台电脑上，但当前运行的 dsh web 还是旧代码（新的后台路由与面板要等它重新载入）。手机端连接与已登录状态都不受影响；重启期间页面会短暂断开，然后自动恢复。"
                         : (isRefreshOnly

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

@@ -2817,6 +2817,29 @@ function writeRestartState(relayDir, state) {
  * 标记「需要用户动一下」的状态。kind = refresh(插件被运行时改写,刷新页面即可)。
  * 历史 kind(first-install / update)已废弃:热加载落地后,装插件与在线更新都不再需要重启 harness。
  */
+/** 桌面端「暫存插件更新」marker（dsh-setup 在应用运行时暂存；bridge 在应用退出后自动安装）。 */
+function readDesktopUpdatePending(relayDir) {
+  try {
+    const m = JSON.parse(readFileSync(join(relayDir, ".plugin-update-pending.json"), "utf8"));
+    return { version: String(m.version || ""), stagedAt: Number(m.stagedAt) || 0 };
+  } catch {
+    return null;
+  }
+}
+
+/** 更新进程成功收尾后写「待生效」提示：桌面端暂存更新 → 退出应用后自动安装；其它 → 重启 dsh web。 */
+function markUpdateRestartPending(relayDir) {
+  const staged = readDesktopUpdatePending(relayDir);
+  if (staged) {
+    return markRestartPending(
+      relayDir,
+      "restart-app",
+      `新版本${staged.version ? ` ${staged.version}` : ""} 已下载：退出并重新打开 DeepSeek Harness 后自动生效（无需终端）`
+    );
+  }
+  return markRestartPending(relayDir, "restart", "插件已更新，重启 dsh web 后生效");
+}
+
 function markRestartPending(relayDir, kind, reason) {
   const cur = readRestartState(relayDir);
   if (cur.pending && cur.kind === kind) return cur; // 幂等：同一原因不反复重写
@@ -3748,6 +3771,8 @@ async function composeStatus(relayDir) {
     // 是否需要重启 DeepSeek harness（首次安装 / 在线更新后必须重启才加载插件本体）：
     // {pending, kind: first-install|update, reason, at}，供面板顶部醒目提示 + 重启按钮。
     restart: readRestartState(relayDir),
+    // 桌面端暂存的插件更新（存在 = 新版本已下载，退出应用后由 bridge 自动安装并生效）
+    desktopUpdatePending: readDesktopUpdatePending(relayDir),
     // 安装/配对自检（2026-10-17 事故）：运行时（clients/）与配对（.dsh-config.json）是否齐全、
     // 缺什么、下一步该做什么；配对主配置缺失但备份存在时给出可一键恢复的 backup.action。
     // 字段契约见 setupStateOf；connect.setup 是同一份对象（bridge-status 短轮询也能拿到）。
@@ -4586,7 +4611,7 @@ async function runOnlineUpdate(relayDir) {
           updateFailures.delete(String(relayDir));
           sweepIfSucceeded(); // C8：装完清残留（按更新前的 pid 点名 + 命令行复核）
           // 更新成功 → 落一条「必须重启 dsh web」的强提醒（见 run() 成功分支的同款注释）
-          markRestartPending(relayDir, "restart", "插件已更新，重启 dsh web 后生效");
+          markUpdateRestartPending(relayDir);
         }
       });
       child.unref();
@@ -4676,7 +4701,7 @@ async function runOnlineUpdate(relayDir) {
           // 客户端按 kind 一一对应地换文案与主按钮（见 client.js 的 restartAlert），
           // 混用一个 kind 就会再次出现"文案说刷新、状态其实是重启"。
           // settleRestartState() 靠 bootId 自动结清 —— 用户真的重启后这条提示自己消失，不需要额外清理。
-          markRestartPending(relayDir, "restart", "插件已更新，重启 dsh web 后生效");
+          markUpdateRestartPending(relayDir);
         }
       });
       child.unref();

package/packages/dsh-remote-web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-web",
-  "version": "0.7.6-beta.2",
+  "version": "0.7.6-beta.3",
   "description": "公网远程控制 DeepSeek Harness（dsh web）：安装即得专属加密地址，人在外面也能用手机访问电脑上的 dsh——无需同一局域网/WiFi、无需公网 IP 与内网穿透，全程加密；手机端 100% 还原电脑体验（对话/工具/审批/设置）。技术用户可选自建服务，流量走自己的服务器。Remote control DeepSeek Harness (dsh web) from anywhere over the public internet — install, get an encrypted URL, use it from your phone on any network (dual-half cordis plugin: Settings panel + same-origin /dsh-remote routes). (2026-09 由 dsh-remote-ui 更名 / renamed from dsh-remote-ui; dsh-remote 的 dsh web 插件半，不是纯 UI/皮肤插件)",
   "type": "module",
   "main": "lib/index.js",

package/packages/dsh-remote-web/runtime/clients/dsh-remote/dsh-bridge.mjs

@@ -82,6 +82,7 @@ import WebSocket from "ws";
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
+import net from "node:net";
 import { execSync, spawnSync } from "node:child_process";
 import { randomBytes, generateKeyPairSync, createHash } from "node:crypto";
 import { pathToFileURL, fileURLToPath } from "node:url";
@@ -2723,9 +2724,109 @@ async function main() {
     console.log("[bridge] 单实例锁检查降级（取不到进程命令行或锁不可写）——照常启动；若出现 code=4000 互踢，本实例会自动让位。");
   }
   process.on("exit", releaseInstanceLock);
+  // 桌面端插件「暂存更新」自动安装（应用退出后生效；见 applyPendingPluginUpdate 注释）
+  startPendingPluginUpdateWatcher();
   return runTunnel();
 }
 
+// ── 桌面端插件「暫存安装」落地（2026-10-24）────────────────────────────────────────────
+// dsh-setup 在桌面应用运行时无法直接改写它的 profile（会触发应用退出/重启），改为暂存到
+// <relayDir>/pending-plugin/ 并写 marker；bridge 常驻、检测到应用退出后自动原子替换插件目录，
+// 用户下次打开应用即加载新版 —— 这样「一键更新」对桌面端也能真正生效（不再需要终端）。
+const PENDING_PLUGIN_MARKER = path.join(RELAY_DIR, ".plugin-update-pending.json");
+const PENDING_PLUGIN_REQUIRED = ["package.json", "lib/index.js", "lib/client.js", "cordis.patch.yml"];
+const PENDING_PLUGIN_DISABLED = process.env.DSH_BRIDGE_PENDING_UPDATE === "0";
+
+/** upstream 端口是否在监听（= DeepSeek Harness 桌面端在运行）。TCP 判断，跨平台。 */
+export function probeUpstreamListening({ host = "127.0.0.1", port, timeoutMs = 400 } = {}) {
+  return new Promise((resolve) => {
+    if (!port) return resolve(false);
+    const sock = net.connect({ host, port });
+    let done = false;
+    const finish = (v) => { if (done) return; done = true; try { sock.destroy(); } catch { /* 忽略 */ } resolve(v); };
+    sock.setTimeout(timeoutMs, () => finish(false));
+    sock.once("connect", () => finish(true));
+    sock.once("error", () => finish(false));
+  });
+}
+function upstreamPortOf(url) {
+  try { const u = new URL(String(url)); return Number(u.port) || (u.protocol === "https:" ? 443 : 80); } catch { return 0; }
+}
+
+/**
+ * 应用暂存的插件更新（仅在桌面应用不在运行时）。原子替换：staging → rename，失败保留旧版。
+ * @returns {{applied:boolean, reason?:string, version?:string, error?:string}}
+ */
+export async function applyPendingPluginUpdate({ relayDir = RELAY_DIR, isAppRunning, now = Date.now(), log = console } = {}) {
+  const markerPath = path.join(relayDir, ".plugin-update-pending.json");
+  let marker;
+  try { marker = JSON.parse(fs.readFileSync(markerPath, "utf8")); } catch { return { applied: false, reason: "no_pending" }; }
+  const stageDir = String(marker.stageDir || "");
+  const profileDir = String(marker.profileDir || "");
+  const name = String(marker.pluginDirName || "dsh-remote-web-plugin");
+  if (!stageDir || !profileDir || !fs.existsSync(stageDir)) {
+    try { fs.rmSync(markerPath, { force: true }); } catch { /* 忽略 */ }
+    return { applied: false, reason: "staging_missing" };
+  }
+  const running = typeof isAppRunning === "function"
+    ? await isAppRunning()
+    : await probeUpstreamListening({ port: upstreamPortOf(UPSTREAM) });
+  if (running) return { applied: false, reason: "app_running" };
+  const dest = path.join(profileDir, name);
+  const stage = `${dest}.staging-${process.pid}`;
+  const backup = `${dest}.backup-${process.pid}`;
+  try {
+    fs.rmSync(stage, { recursive: true, force: true });
+    fs.cpSync(stageDir, stage, { recursive: true });
+    for (const rel of PENDING_PLUGIN_REQUIRED) {
+      if (!fs.existsSync(path.join(stage, rel))) throw new Error(`暂存包缺少 ${rel}`);
+    }
+    fs.rmSync(backup, { recursive: true, force: true });
+    const had = fs.existsSync(dest);
+    if (had) fs.renameSync(dest, backup);
+    try {
+      fs.renameSync(stage, dest);
+    } catch (e) {
+      if (had) { try { fs.renameSync(backup, dest); } catch { /* 忽略 */ } }
+      throw e;
+    }
+    if (had) { try { fs.rmSync(backup, { recursive: true, force: true }); } catch { /* 忽略 */ } }
+    try {
+      fs.writeFileSync(
+        path.join(relayDir, ".plugin-update-applied.json"),
+        JSON.stringify({ version: marker.version, appliedAt: now, profileDir }, null, 2) + "\n"
+      );
+    } catch { /* 忽略 */ }
+    try { fs.rmSync(markerPath, { force: true }); fs.rmSync(stageDir, { recursive: true, force: true }); } catch { /* 忽略 */ }
+    log.info?.(`[bridge] ✅ 插件新版本 ${marker.version} 已自动安装到 ${profileDir}（桌面应用退出后）；重新打开应用即生效`);
+    return { applied: true, version: marker.version };
+  } catch (e) {
+    try { fs.rmSync(stage, { recursive: true, force: true }); } catch { /* 忽略 */ }
+    log.warn?.(`[bridge] 插件暂存安装失败（保留旧版可回退）：${e && e.message ? e.message : e}`);
+    return { applied: false, reason: "apply_failed", error: String((e && e.message) || e) };
+  }
+}
+
+function startPendingPluginUpdateWatcher() {
+  if (PENDING_PLUGIN_DISABLED) return null;
+  let closedStreak = 0;
+  const tick = async () => {
+    try {
+      if (!fs.existsSync(PENDING_PLUGIN_MARKER)) { closedStreak = 0; return; }
+      const running = await probeUpstreamListening({ port: upstreamPortOf(UPSTREAM) });
+      if (running) { closedStreak = 0; return; }
+      closedStreak += 1;
+      if (closedStreak < 2) return; // 连续两次（≈30s）判定不在运行才动手，避开退出/重启瞬间
+      await applyPendingPluginUpdate({});
+      closedStreak = 0;
+    } catch { /* 绝不影响隧道业务 */ }
+  };
+  const t = setInterval(tick, 15_000);
+  t.unref?.();
+  void tick();
+  return t;
+}
+
 // test hooks：镜像页加载看门狗的内部状态（给用例断言"后续请求会撤掉它"，见 test/bridge-html-inject.test.mjs）
 export function __mirrorLoadWatchState() { return mirrorLoadWatch ? { ...mirrorLoadWatch } : null; }
 export function __armMirrorLoadWatch(path) { armMirrorLoadWatch(path); }

package/packages/dsh-remote-web/runtime/dsh-setup.mjs

@@ -2583,6 +2583,45 @@ function missingPluginFiles(dir) {
  *
  * 另外清掉上次被强杀留下的 `.staging-*` / `.backup-*`，不留垃圾。
  */
+// ── 桌面端「暫存安装」：应用运行中不能改写它的 profile（会把它弄退出/重启），
+// 但用户点「一键更新」必须能装到桌面端。做法：先整份拷到 ~/.dsh-remote/pending-plugin/ 并写 marker，
+// 由常驻的 bridge 在检测到应用退出后自动原子替换 profile 内的插件目录（见 dsh-bridge.mjs）。
+const PENDING_PLUGIN_MARKER = path.join(CONFIG_DIR, ".plugin-update-pending.json");
+const PENDING_PLUGIN_DIR = path.join(CONFIG_DIR, "pending-plugin");
+
+/** 暂存一份插件更新（供 bridge 在应用退出后安装）。返回 marker 对象。 */
+function stagePluginUpdateForProfile(profileDir, pluginDir) {
+  fs.rmSync(PENDING_PLUGIN_DIR, { recursive: true, force: true });
+  fs.mkdirSync(PENDING_PLUGIN_DIR, { recursive: true });
+  const cpOpts = {
+    recursive: true,
+    filter: (src) => {
+      if (src === pluginDir) return true;
+      const rel = String(path.relative(pluginDir, src));
+      const segs = rel.split(path.sep);
+      if (segs.some((seg) => seg === ".git" || seg === ".DS_Store")) return false;
+      const inBundledRuntime = segs[0] === "runtime";
+      if (!inBundledRuntime && segs.some((seg) => seg === "node_modules")) return false;
+      return true;
+    }
+  };
+  fs.cpSync(pluginDir, PENDING_PLUGIN_DIR, cpOpts);
+  for (const rel of PLUGIN_REQUIRED_FILES) {
+    const f = path.join(PENDING_PLUGIN_DIR, rel);
+    if (!fs.existsSync(f)) throw new Error(`暂存校验失败：缺少 ${rel}`);
+  }
+  const version = JSON.parse(fs.readFileSync(path.join(pluginDir, "package.json"), "utf8")).version;
+  const marker = {
+    version,
+    profileDir,
+    pluginDirName: PLUGIN_LOCAL_DIR,
+    stageDir: PENDING_PLUGIN_DIR,
+    stagedAt: Date.now()
+  };
+  fs.writeFileSync(PENDING_PLUGIN_MARKER, JSON.stringify(marker, null, 2) + "\n");
+  return marker;
+}
+
 function copyPluginIntoProfile(profileDir, pluginDir) {
   // 清理历史名残留目录（≤0.4.9 的 dsh-remote-ui-plugin），避免与新版并存
   for (const id of PLUGIN_LEGACY_IDS) {
@@ -3031,16 +3070,21 @@ async function pluginCmd(argv) {
   let last = null;
   let ok = 0;
   let skippedRunning = 0;
+  let stagedRunning = 0;
   const force = hasFlag(argv, "--force");
   for (const t of targets) {
     // ⚠️ 桌面应用在运行时**绝不改写它的 profile**：应用会因此退出/重启（2026-10-11 实测故障）
     if (t.name === "desktop" && !force && dshDesktopAppRunning()) {
-      console.log(`⚠️ 跳过 desktop：DeepSeek Harness 应用正在运行。`);
-      console.log(`   应用独占该 profile，运行中改写会让应用自己退出/重启。请任选其一：`);
-      console.log(`     · 完全退出应用后重跑本命令；或`);
-      console.log(`     · 在应用内「插件」页安装/更新 dsh-remote-web（官方路径，装完即热加载）。`);
-      console.log(`   （确实要强行写入：加 --force）`);
-      skippedRunning += 1;
+      console.log(`⚠️ DeepSeek Harness 应用正在运行 → 不直接改写它的 profile（会把它弄退出/重启）。`);
+      try {
+        const staged = stagePluginUpdateForProfile(t.dir, path.join(THIS_DIR, "packages", PLUGIN_ID));
+        stagedRunning += 1;
+        console.log(`   ✅ 新版本 ${staged.version} 已暂存：**退出 DeepSeek Harness 后会自动安装**，重新打开应用即生效（无需终端）。`);
+      } catch (e) {
+        console.log(`   ⚠️ 暂存失败：${e && e.message ? e.message : e}`);
+        console.log(`   请完全退出应用后重跑本命令，或在应用内「插件」页安装/更新 dsh-remote-web。`);
+        skippedRunning += 1;
+      }
       continue;
     }
     if (multi) console.log(`\n── profile: ${t.name}（${t.dir}）`);
@@ -3050,6 +3094,7 @@ async function pluginCmd(argv) {
     if (r !== undefined && r !== null) last = r;
   }
   if (ok === 0 && skippedRunning === 0) process.exit(1);
+  if (stagedRunning > 0) console.log(`ℹ 桌面端插件已暂存（${stagedRunning} 个）：退出 DeepSeek Harness 后由后台服务自动安装，重开应用生效。`);
   if (skippedRunning > 0) console.log(`ℹ 本次跳过了 ${skippedRunning} 个 profile（应用在运行）；桥与运行环境不受影响。`);
   return last;
 }

package/packages/dsh-remote-web/test/desktop-compat.test.mjs

@@ -167,11 +167,13 @@ test("桌面端：面板不得自动倒计时重启，且不摆点了必然失
     "自动倒计时重启必须在桌面端短路（Host 由 Electron 托管，不能替用户重启）");
   assert.match(CLIENT_SRC, /\(desktopHost && !isRefreshOnly\) \? null : h\("button"/,
     "桌面端且非'刷新即可'时不得渲染重启按钮");
-  // 2026-10-17（业主）：桌面端**不再**出现"重启 DeepSeek Harness"这类引导，
-  // 统一只说「刷新页面即可生效」；非桌面端保留原有 isRestartHard 判据（发布版文案不变）。
-  assert.doesNotMatch(CLIENT_SRC, /退出并重新打开 DeepSeek Harness/,
-    "桌面端不得再引导用户重启应用（运行环境由应用托管、更新自动热加载）");
-  assert.match(CLIENT_SRC, /插件已更新：刷新页面即可生效/);
+  // 2026-10-24（业主）：桌面端 profile 由应用独占，运行中无法改写 → 插件更新必须「退出并重开应用」；
+  // 已暂存的新版本由 bridge 在应用退出后自动安装。此前「刷新页面即可生效」的文案被证实是错的。
+  assert.match(CLIENT_SRC, /退出并重新打开 DeepSeek Harness 后自动生效/,
+    "桌面端必须如实引导：退出并重新打开应用后生效（新版本由 bridge 自动安装）");
+  assert.match(CLIENT_SRC, /desktopUpdatePending/, "面板要读桌面端暂存更新状态");
+  assert.doesNotMatch(CLIENT_SRC, /desktopHost[\s\S]{0,200}插件已更新：刷新页面即可生效/,
+    "桌面端不得再说「刷新页面即可生效」（应用在运行时根本不会加载新插件）");
 });
 
 test("桌面端：删除「重启 DeepSeek Harness」整段说明（2026-10-17 业主约定）", () => {

package/packages/dsh-remote-web/test/setup-output.test.mjs

@@ -240,7 +240,10 @@ test("★ 桌面应用在运行时，绝不改写它的 profile（否则应用
   const applyAt = src.indexOf("await pluginApplyTo(", loopAt);
   assert.ok(loopAt > 0 && guardAt > loopAt && applyAt > guardAt,
     "顺序必须是：循环 → 应用在运行？→ 跳过；否则才 pluginApplyTo()");
-  assert.match(src, /跳过 desktop：DeepSeek Harness 应用正在运行/, "要如实说明跳过了 desktop");
+  // 2026-10-24：应用在运行时不再只是"跳过"，而是把插件更新**暂存**，由 bridge 在应用退出后自动安装。
+  assert.match(src, /stagePluginUpdateForProfile\(/, "应用在运行时必须暂存插件更新（否则一键更新永远装不上桌面端）");
+  assert.match(src, /\.plugin-update-pending\.json/, "暂存要写 marker 供 bridge 落地");
+  assert.match(src, /退出 DeepSeek Harness 后会自动安装/, "要如实告诉用户：退出应用后自动安装、重开生效");
   assert.match(src, /应用内「插件」页安装/, "要给出官方替代路径（应用内插件页）");
   assert.match(src, /"--force"/, "要留 --force 逃生口");
   // sync-local 脚本同样要保护（本机同步最常用）