@mrrisega/dsh-remote 0.7.6-beta.1 → 0.7.6-beta.10

package/dsh-setup.mjs

@@ -1127,7 +1127,15 @@ const UPSTREAM_FILE = ".dsh-upstream";
  * 本次安装要**钉住**的上游（null = 不钉，运行时按 env → .dsh-upstream → 探测 取值）。
  * 见 desktopAppPort() 的注释：插件装进多个 profile 后，各宿主会互相覆盖 `.dsh-upstream`。
  */
-let PINNED_UPSTREAM = String(process.env.DSH_BRIDGE_UPSTREAM || "").trim().replace(/\/+$/, "") || null;
+// 🔴 2026-10-25 事故：以前把安装进程里的 DSH_BRIDGE_UPSTREAM（一个**当时的动态端口**）写进
+// launchd plist，之后 dsh 每次重启换端口，plist 里的旧端口就成了永久生效的"显式指定"，
+// 守护/桥永远连不上 → 设备掉线。现在默认**不钉**（运行时按 插件写的 .dsh-upstream → 探测 取值）；
+// 仅当部署方显式要求（DSH_BRIDGE_PIN_UPSTREAM=1）时才沿用旧行为。
+let PINNED_UPSTREAM = (() => {
+  const pinFlag = String(process.env.DSH_BRIDGE_PIN_UPSTREAM || "").trim().toLowerCase();
+  if (pinFlag !== "1" && pinFlag !== "true" && pinFlag !== "on") return null;
+  return String(process.env.DSH_BRIDGE_UPSTREAM || "").trim().replace(/\/+$/, "") || null;
+})();
 
 /**
  * 探测桌面端（Electron 应用）当前监听的**回环端口**。
@@ -1223,6 +1231,18 @@ async function upstreamReachable(url = upstreamUrl(), timeoutMs = 1200) {
  */
 async function isDshWebUp(timeoutMs = 1200) {
   if (await upstreamReachable(upstreamUrl(), timeoutMs)) return true;
+  // 🔴 2026-10-25（设备掉线实测）：Electron 每次启动可能换端口。端口文件由 dsh web 内的插件
+  //   在每次启动时重写，比进程内的 discoveredUpstream 缓存新 —— 先直接试文件，别被旧缓存挡住。
+  try {
+    const fromFile = String(fs.readFileSync(path.join(CONFIG_DIR, UPSTREAM_FILE), "utf8")).trim();
+    if (/^https?:\/\/[^\s]+$/i.test(fromFile)) {
+      const normalized = fromFile.replace(/\/+$/, "");
+      if (normalized !== upstreamUrl() && (await upstreamReachable(normalized, timeoutMs))) {
+        discoveredUpstream = normalized;
+        return true;
+      }
+    }
+  } catch { /* 没有端口文件：继续走动态发现 */ }
   const before = upstreamUrl();
   const after = await refreshUpstreamDiscovery(true);
   if (after === before) return false;
@@ -1659,7 +1679,22 @@ function releaseSpawnLock() {
 }
 
 // ---------- run：前台跑 bridge（带配置 + 自启动 watcher） ----------
+/** 以插件写入的 .dsh-upstream 为准校正进程内的旧上游环境变量（dsh 换端口后不再连旧端口）。 */
+function reconcileUpstreamEnvFromFile() {
+  try {
+    const fileUp = String(fs.readFileSync(path.join(CONFIG_DIR, UPSTREAM_FILE), "utf8")).trim().replace(/\/+$/, "");
+    const envUp = String(process.env.DSH_BRIDGE_UPSTREAM || "").trim().replace(/\/+$/, "");
+    if (envUp && /^https?:\/\/[^\s]+$/i.test(fileUp) && fileUp !== envUp) {
+      console.log(`[dsh-remote] 忽略旧的上游地址 ${envUp} → 使用插件写入的最新地址 ${fileUp}（防端口漂移掉线）`);
+      process.env.DSH_BRIDGE_UPSTREAM = fileUp;
+      discoveredUpstream = fileUp;
+    }
+  } catch { /* 无文件：保持原行为 */ }
+}
+
 async function runBridge() {
+  // 启动/每次拉起前都按插件写入的端口校正继承来的旧 env（旧 plist 可能钉着安装时的端口）
+  reconcileUpstreamEnvFromFile();
   // 去重（所有平台）：自启动服务、登录任务、插件半的脱离进程兜底都可能拉起 watcher，
   // 两个 bridge 会抢同一个设备登记 → 以 pid 文件为准。
   //
@@ -1856,9 +1891,13 @@ async function runBridge() {
     }
     warnedDuplicateBridge = false;
 
+    reconcileUpstreamEnvFromFile(); // dsh 可能刚重启并换了端口：拉起前再以最新端口文件为准
     const alive = await checkUpstream();
     if (alive && childStopped(bridgeProc)) {
       starting = true;
+      // dsh 重启可能换端口（Electron 每次启动端口可能变）：拉起前**强制重新发现**，
+      // 否则 discoveredUpstream 缓存旧端口 → bridge 连不上上游 → 设备掉线（2026-10-25 实测）。
+      await refreshUpstreamDiscovery(true);
       console.log("[dsh-remote] dsh web 在线，启动 bridge...");
       // 清除代理环境变量（bridge 需直连 relay，不受本机代理影响）
       const childEnv = {
@@ -1900,6 +1939,17 @@ async function runBridge() {
         // 另一个 bridge 把本连接顶掉）后会以"重复实例"退出码优雅退出（见 dsh-bridge.mjs）。
         // 这种退出**绝不能**照常 10s 重拉：本机已经有另一个实例在跑，重拉只会继续乒乓互踢。
         if (code === DUPLICATE_INSTANCE_EXIT_CODE) {
+          // 🔴 2026-10-25：升级/重启后常见「上一代 bridge 变成孤儿继续占着单实例锁」，
+          //   新 bridge 因此退出 code=4。旧逻辑一律暂停 5 分钟 → 设备在线要等 5 分钟（用户实测掉线）。
+          //   现在先**清扫同运行时的孤儿 bridge**；扫到了说明冲突已解除，3 秒后立即重试；
+          //   扫不到（多半真有另一个 watcher 的活实例）才按 5 分钟退避，避免乒乓互踢。
+          let swept = [];
+          try { swept = sweepStrayBridges(); } catch { /* 清扫失败不致命 */ }
+          if (swept.length > 0) {
+            duplicateBridgeBackoffUntil = Date.now() + 3000;
+            console.log(`[dsh-remote] bridge 因同实例冲突退出（code=${code}），已清扫 ${swept.length} 个孤儿 bridge（pid ${swept.join(", ")}）→ 3 秒后重试。`);
+            return;
+          }
           duplicateBridgeBackoffUntil = Date.now() + DUPLICATE_BRIDGE_BACKOFF_MS;
           console.log(`[dsh-remote] bridge 检测到同 deviceId 的另一个实例并退出（code=${code}）——本守护暂停 ${Math.round(DUPLICATE_BRIDGE_BACKOFF_MS / 60000)} 分钟后再试，避免两个实例反复互踢。`);
           return;
@@ -1913,6 +1963,8 @@ async function runBridge() {
       setTimeout(() => { starting = false; }, 5000);
     } else if (!alive && bridgeProc && bridgeProc.exitCode === null) {
       console.log("[dsh-remote] dsh web 离线，停止 bridge...");
+      // dsh 重启后端口可能变化：清掉进程内缓存，下一轮优先用插件新写的端口文件探测
+      discoveredUpstream = "";
       await stopChildGracefully(bridgeProc); // 同上：Windows 上 kill() 跑不到退出钩子
     }
   };
@@ -2024,9 +2076,11 @@ async function setup(argv) {
       if (!PINNED_UPSTREAM && pluginTargets.some((t) => t.name === "desktop")) {
         const p = desktopAppPort();
         if (p) {
-          PINNED_UPSTREAM = `http://127.0.0.1:${p}`;
-          try { fs.writeFileSync(path.join(CONFIG_DIR, UPSTREAM_FILE), PINNED_UPSTREAM + "\n"); } catch { /* 忽略 */ }
-          console.log(`ℹ 桌面端在 127.0.0.1:${p} 监听 → 桥的上游已钉到它（避免与 Web 版互抢）`);
+          // 🔴 2026-10-25：这里只能写运行时端口文件；**不能**回填 PINNED_UPSTREAM ——
+          // 它会被写进 launchd plist 变成永久显式指定，dsh 换端口后守护/桥永远连旧端口
+          // （用户实测 upstream_unreachable）。
+          try { fs.writeFileSync(path.join(CONFIG_DIR, UPSTREAM_FILE), `http://127.0.0.1:${p}` + "\n"); } catch { /* 忽略 */ }
+          console.log(`ℹ 桌面端在 127.0.0.1:${p} 监听 → 已写入运行时上游端口（不再钉进自启动配置）`);
         }
       }
     } catch { /* 探测失败不阻断安装 */ }
@@ -2583,6 +2637,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 +3124,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 +3148,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.1",
+  "version": "0.7.6-beta.10",
   "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

@@ -98,7 +98,7 @@ window.__ModuleLoader__.load({
       // 绝不写 :root / body —— 否则会污染整个 GUI。JS 解析出主题后往根节点写
       // data-dru-theme="dark|light"，下面按属性切换；末一条 `:not([data-dru-theme])`
       // 是 JS 尚未执行时的纯 CSS 兜底（一旦 JS 写过属性就不再参与，不会打架）。
-      ".dru-settings-section,.dru-popup,.dru-nav-remote{",
+      ".dru-settings-section,.dru-popup,.dru-nav-remote,.dru-standalone-card{",
       "  color-scheme:light;",
       "  --dru-surface:#f6f8fa;",          // 卡片底
       "  --dru-surface-2:#ffffff;",        // 抬升面（输入框/行/弹窗卡）
@@ -149,10 +149,11 @@ window.__ModuleLoader__.load({
       // 深色：JS 写的 data-dru-theme 优先；宿主属性作 JS 未执行时的兜底。
       // 取值跟着宿主的深色基色走（body 实测 #151517 / 层 1 #232324 / 层 2 #2c2c2e / 层 3 #353638），
       // 语义色**在深底上重新取值**，不是沿用亮色值（亮色的 #1a7f37 / #cf222e 在深底对比度不足）。
-      ".dru-settings-section[data-dru-theme=\"dark\"],.dru-popup[data-dru-theme=\"dark\"],.dru-nav-remote[data-dru-theme=\"dark\"],",
+      ".dru-settings-section[data-dru-theme=\"dark\"],.dru-popup[data-dru-theme=\"dark\"],.dru-nav-remote[data-dru-theme=\"dark\"],.dru-standalone-card[data-dru-theme=\"dark\"],",
       "body[data-ds-dark-theme] .dru-settings-section:not([data-dru-theme]),",
       "body[data-ds-dark-theme] .dru-popup:not([data-dru-theme]),",
-      "body[data-ds-dark-theme] .dru-nav-remote:not([data-dru-theme]){",
+      "body[data-ds-dark-theme] .dru-nav-remote:not([data-dru-theme]),",
+      "body[data-ds-dark-theme] .dru-standalone-card:not([data-dru-theme]){",
       "  color-scheme:dark;",
       "  --dru-surface:#232324;",
       "  --dru-surface-2:#2c2c2e;",
@@ -202,6 +203,15 @@ window.__ModuleLoader__.load({
       "}",
       // 设置页栏目容器（nav 选中后渲染在 settings.section 内容区）
       ".dru-settings-section{max-width:720px;display:flex;flex-direction:column;gap:14px;padding-top:2px;color:var(--dru-fg)}",
+      // 📱 独立「远程访问」弹层（2026-10-25）：入口点击不再去"猜"官方设置面板的 DOM，
+      // 直接弹我们自己的一份设置页 —— 宿主改版也影响不到它。
+      ".dru-standalone-overlay{position:fixed;inset:0;z-index:2147483000;display:flex;align-items:center;justify-content:center;padding:24px;background:var(--dru-overlay)}",
+      ".dru-standalone-card{width:min(760px,100%);max-height:88vh;overflow:auto;box-sizing:border-box;padding:18px 20px 22px;border:1px solid var(--dru-border);border-radius:14px;background:var(--dru-surface-2);color:var(--dru-fg);box-shadow:0 18px 60px var(--dru-shadow)}",
+      ".dru-standalone-head{display:flex;align-items:center;justify-content:space-between;gap:12px;margin-bottom:8px}",
+      ".dru-standalone-title{font-size:16px;font-weight:700}",
+      ".dru-standalone-close{appearance:none;border:1px solid var(--dru-border-ctl);background:var(--dru-surface-2);color:var(--dru-fg-muted);width:30px;height:30px;border-radius:8px;font-size:18px;line-height:1;cursor:pointer}",
+      ".dru-standalone-close:hover{background:var(--dru-hover);color:var(--dru-fg)}",
+      "@media (max-width:640px){.dru-standalone-overlay{padding:8px}.dru-standalone-card{max-height:94vh;border-radius:12px;padding:14px 14px 18px}}",
       ".dru-settings-head{display:flex;align-items:center;gap:10px;padding:6px 2px 2px}",
       ".dru-settings-icon{font-size:24px;line-height:1;flex:none}",
       // 标题/副标题优先沿用宿主语义令牌（自带深浅两套），取不到再退回本插件令牌
@@ -897,7 +907,10 @@ window.__ModuleLoader__.load({
         for (var i = 0; i < els.length; i++) {
           var el = els[i];
           if (!el || el.id === NAV_ENTRY_ID) continue; // 排除注入按钮自身(防递归)
-          if (!navCellLike(el)) continue;
+          // 2026-10-25：新宿主把设置面板左栏的 navCell class 换掉了 → 只认 navCellLike 会漏掉
+          // 「远程访问」栏目，导致入口点击静默失败（用户实测：只能从更多→设置里手动点）。
+          // 在**设置弹层内**时放宽为「可见、文案精确匹配」，不再依赖 class 名。
+          if (!navCellLike(el) && !(insideDialog === true && navInDialog(el))) continue;
           if (NAV_BAD_RE.test(String(el.className || ""))) continue;
           var inDlg = navInDialog(el);
           if (insideDialog === true && !inDlg) continue;
@@ -928,6 +941,9 @@ window.__ModuleLoader__.load({
           if (!el.getBoundingClientRect || el.getBoundingClientRect().width === 0) continue;
           var t = String(el.textContent || "");
           if (t.indexOf("通用设置") !== -1 || t.indexOf("General") !== -1) return true;
+          // 2026-10-25：新版桌面端设置面板里是「远程访问 / 通用设置…」；若宿主把「通用设置」
+          // 改成了别的文案，只看它就会误判「设置没打开」→ 入口点击后一路走兜底/超时。
+          if (t.indexOf("远程访问") !== -1) return true;
         }
       } catch (e) { /* 忽略 */ }
       return false;
@@ -957,6 +973,15 @@ window.__ModuleLoader__.load({
           if (!el || el.id === NAV_ENTRY_ID) continue;
           var aria = String((el.getAttribute && el.getAttribute("aria-label")) || "");
           if (/账号菜单|Account menu/i.test(aria)) return el;
+          // 2026-10-25（用户反馈「只能从更多→设置里打开」）：新宿主把设置收在**更多**菜单里，
+          // 这里补充「更多」形态的候选（aria-label / title / 文本 / ⋯ 字形）。
+          var title = String((el.getAttribute && (el.getAttribute("title") || "")) || "");
+          var txt = String((el.textContent || "")).replace(/\s+/g, "");
+          if (/更多|More|菜单|Menu/i.test(aria + " " + title)) {
+            var rMore = el.getBoundingClientRect ? el.getBoundingClientRect() : null;
+            if (!rMore || (rMore.width > 0 && rMore.height > 0)) return el;
+          }
+          if (/^(更多|More|⋯|\.\.\.)$/i.test(txt) && el.getAttribute && el.getAttribute("aria-haspopup")) return el;
           var r = el.getBoundingClientRect ? el.getBoundingClientRect() : null;
           if (!best && r && r.width > 0 && r.left < 360 && r.top > 300
               && String((el.getAttribute && el.getAttribute("aria-haspopup")) || "") === "menu") best = el;
@@ -1102,6 +1127,61 @@ window.__ModuleLoader__.load({
        0.2 实测该槽就在侧栏底部、且**当前是空的**）—— 位置、宽度、折叠态全由宿主负责。
        所以这里不再注入任何 DOM，直接注册进槽位。id 仍保留 `dru-nav-remote`：
        公告徽标 / 首次红点那套按 id 取节点的既有逻辑因此不用改。 */
+    /* 📱 独立「远程访问」弹层（2026-10-25 用户拍板）：
+       桌面端点击侧栏入口时，不再去"点官方设置/找栏目"（宿主一改版就点错或没反应，
+       实测会点到左上角「更多→浏览插件」），而是弹出我们自己的一份设置页。
+       「设置 → 远程访问」栏目保留，正常从官方设置页进入的用户仍走那条路。
+       实现上用 shell.overlay 槽（宿主最上层，不受侧栏容器裁剪），组件常驻、按事件开关。 */
+    var standaloneOverlayMounted = false;
+    function openRemoteStandalonePanel() {
+      try { window.dispatchEvent(new CustomEvent("dsh-remote:open-standalone")); } catch (e) { /* 忽略 */ }
+    }
+    function RemoteStandaloneOverlay() {
+      var st = useState(false);
+      var open = st[0];
+      var setOpen = st[1];
+      useEffect(function () {
+        standaloneOverlayMounted = true;
+        function onOpen() { try { setOpen(true); } catch (e) { /* 忽略 */ } }
+        function onKey(e) {
+          if (!e) return;
+          if (e.key === "Escape" || e.keyCode === 27) { try { setOpen(false); } catch (e2) { /* 忽略 */ } }
+        }
+        try {
+          window.addEventListener("dsh-remote:open-standalone", onOpen);
+          window.addEventListener("keydown", onKey);
+        } catch (e3) { /* 忽略 */ }
+        return function () {
+          standaloneOverlayMounted = false;
+          try {
+            window.removeEventListener("dsh-remote:open-standalone", onOpen);
+            window.removeEventListener("keydown", onKey);
+          } catch (e4) { /* 忽略 */ }
+        };
+      }, []);
+      if (!open) return null;
+      var dark = false;
+      try { dark = !!document.body && document.body.hasAttribute("data-ds-dark-theme"); } catch (e5) { /* 忽略 */ }
+      return h("div", {
+        className: "dru-standalone-overlay",
+        role: "dialog",
+        "aria-modal": "true",
+        "aria-label": "远程访问",
+        onClick: function (e) { if (e && e.target === e.currentTarget) setOpen(false); }
+      },
+        h("div", { className: "dru-standalone-card", "data-dru-theme": dark ? "dark" : "light" },
+          h("div", { className: "dru-standalone-head" },
+            h("b", { className: "dru-standalone-title" }, "📱 远程访问"),
+            h("button", {
+              type: "button",
+              className: "dru-standalone-close",
+              "aria-label": "关闭",
+              onClick: function () { setOpen(false); }
+            }, "×")),
+          h(RemoteControlSection, { standalone: true })
+        ));
+    }
+
     function RemoteNavEntry(props) {
       var wide = !(props && props.wide === false);
       var seenArr = useState(false);
@@ -1118,7 +1198,16 @@ window.__ModuleLoader__.load({
           try { e.preventDefault(); } catch (err) { /* 忽略 */ }
           setClicked(true);
           dotMarkSeen();                       // 用过入口 = 已了解位置 → 收起首次红点
-          if (remoteNavOpen) remoteNavOpen();
+          // 2026-10-25（用户拍板）：优先弹**我们自己的独立设置页**（不再依赖官方设置面板 DOM）；
+          // 只有宿主没有 shell.overlay 槽（极老版本）时才退回旧的"打开官方设置栏目"链路。
+          try {
+            openRemoteStandalonePanel();
+            setTimeout(function () {
+              if (!standaloneOverlayMounted) {
+                try { openRemoteSettings(); } catch (e2) { /* 忽略 */ }
+              }
+            }, 150);
+          } catch (errOpen) { /* 绝不因打开失败抛到宿主 */ }
         }
       }, [
         h("span", { className: "ico", key: "ico" }, "📱"),
@@ -1177,6 +1266,7 @@ window.__ModuleLoader__.load({
      * 之所以是模块级的：拉取发生在 apply() 里（组件还没挂载），而消费方有两个
      * （设置面板的卡片 / shell.overlay 上的弹窗），模块级 store 才能让两边看到同一份数据。
      */
+    var annRetryCount = 0;   // 公告首次拉取瞬态失败的有界重试计数（成功即清零）
     var annState = {
       ok: false,          // 拉取成功且结构是我们认识的那一种（老服务端 404 / 结构不符 → 一直是 false）
       bubble: false,      // bubble_enabled === true 才置真（字段缺失一律当 false = fail closed）
@@ -1339,6 +1429,7 @@ window.__ModuleLoader__.load({
         var norm = annNormalize(b);
         if (!norm) { annState.ok = false; annState.bubble = false; annState.items = []; annState.unread = 0; annEmit(); return false; }
         annState.ok = true;
+        annRetryCount = 0;
         annState.bubble = norm.bubble;
         annState.items = norm.items;
         annState.unread = norm.unread;
@@ -1347,13 +1438,24 @@ window.__ModuleLoader__.load({
         }
         annEmit();
         return true;
-      }).catch(function () {
+      }).catch(function (err) {
         // 404（老服务端）/ 不可达 / 超时：fail closed —— 不显示入口、不弹窗，**绝不抛**
         annState.ok = false;
         annState.bubble = false;
         annState.items = [];
         annState.unread = 0;
         annEmit();
+        // 2026-10-25（用户反馈「公告板块没了」）：dsh 重启后页面常常比插件宿主路由先就绪，
+        // 首次拉取失败一次，整页（sessionStorage 一次性标记）就再也没有公告入口。
+        // 这里只对**瞬态失败**做有界重试（最多 2 次、间隔 1.5s/3s）；404 明确是老服务端，不重试。
+        // 注意：这只发生在**失败后**，成功路径仍然严格"每次页面加载只拉一次"。
+        var st = Number(err && (err.status || err.statusCode));
+        if (st !== 404 && annRetryCount < 2) {
+          annRetryCount += 1;
+          try {
+            setTimeout(function () { annFetch({ openPopup: false }); }, 1500 * annRetryCount);
+          } catch (e2) { /* 忽略 */ }
+        }
         return false;
       });
     }
@@ -2739,6 +2841,70 @@ window.__ModuleLoader__.load({
       return { kind: "off", text: text };
     }
 
+    // ══ 🎉 加入用户交流群引导（实际使用满 2 小时后弹一次；2026-10-23 业主需求）═════
+    //
+    // 与手机 Web 端共用同一套企业端接口；桌面端浏览器半没有企业端用户 token 直连，
+    // 由 node 半 `/dsh-remote/community-invite/*` 用 device-login token 代调（见 lib/index.js 同名注释）。
+    //   GET  /dsh-remote/community-invite/status → { ok, show, reason, used_seconds, required_seconds, qr_url }
+    //   POST /dsh-remote/community-invite/shown  → { ok:true }（幂等）
+    //
+    // 纪律（与手机端保持同一套，别改松）：
+    // ① **弹不弹完全由服务端 show 决定**：时长口径（relay_sessions 累计 ≥ required_seconds）只在服务端算，
+    //    前端一个字节都不自己算；show 非严格 true 一律不弹（fail closed）。
+    // ② **每桌面会话一次**：sessionStorage + 内存双标记；服务端 already_shown（show:false）是第二道保险。
+    // ③ **「看过即算」**：弹层一显示就 POST shown（幂等）——用户直接关页面/不点按钮也不会被反复骚扰；
+    //    两个按钮关闭时**再调一次**同样幂等。
+    // ④ **一切失败静默**：不弹、不报错、不阻塞面板主流程（连日志都不往用户面前抛）。
+    // ⑤ 二维码降级：qr_url 为空 / 图片加载失败 → 隐藏图片但**保留文案与按钮**（绝不弹空白二维码区）。
+    var CI_SEEN_KEY = "dsh-remote-community-invite-seen-v1";
+    var ciSeenInMemory = false;   // sessionStorage 不可用（隐私模式）时的兜底：每桌面会话仍只弹一次
+    var ciReported = false;       // 已上报 shown 的本地标记（幂等；失败允许关闭时再补一次）
+    /** 本桌面会话内是否已弹过（内存 + sessionStorage 双标记）。 */
+    function ciSeen() {
+      if (ciSeenInMemory) return true;
+      try { return sessionStorage.getItem(CI_SEEN_KEY) === "1"; } catch (e) { return false; }
+    }
+    function ciMarkSeen() {
+      ciSeenInMemory = true;
+      try { sessionStorage.setItem(CI_SEEN_KEY, "1"); } catch (e) { /* 隐私模式忽略 */ }
+    }
+    /** 二维码 URL 安全化：只接受 http(s) 绝对地址或站内绝对路径；data:/javascript: 一律不加载。 */
+    function ciSafeQrUrl(raw) {
+      var s = String(raw || "").trim();
+      if (!s) return "";
+      if (/^https?:\/\//i.test(s)) return s;
+      if (s.charAt(0) === "/" && s.charAt(1) !== "/") {
+        var origin = (typeof location !== "undefined" && location && location.origin) || "";
+        return origin + s;
+      }
+      return "";
+    }
+    /** POST /dsh-remote/community-invite/shown（幂等）。失败静默，并允许关闭时再补一次。 */
+    function ciReportShown() {
+      if (ciReported) return;
+      ciReported = true;
+      api("/dsh-remote/community-invite/shown", { method: "POST", headers: { "content-type": "application/json" }, body: "{}" })
+        .then(function (b) { if (!b || b.ok === false) ciReported = false; })
+        .catch(function () { ciReported = false; /* 网络失败：关闭时再试一次即可 */ });
+    }
+    /**
+     * 问服务端要不要弹。`alive` 由 effect 的 cleanup 控制：面板卸载后回来的响应直接丢弃。
+     * @returns {Promise<{qrUrl:string}|null>} 需要弹 → 返回弹层数据；不弹/失败 → null
+     */
+    function ciMaybeShow() {
+      if (ciSeen()) return Promise.resolve(null);
+      return api("/dsh-remote/community-invite/status")
+        .then(function (b) {
+          if (!b || b.ok === false || b.show !== true) return null; // 服务端说不弹就不弹
+          return { qrUrl: ciSafeQrUrl(b.qr_url) };
+        })
+        .catch(function () { return null; }); // 静默：接口/网络/字段异常一律不弹
+    }
+
+    // 【2026-10-24 移除】业主决定：面板不再展示购买协议（协议只在**手机端支付扫码前**展示）。
+    // 相关常量 / 渲染函数 / 样式已一并删除；node 半 `GET /dsh-remote/purchase-agreement` 代理保留
+    // （手机端 / 其它端后续可复用，见 lib/index.js 同名段注释）。
+
     // ── 面板主体（渲染于设置页 settings.section 栏目内） ─────────────────────
     // 匿名装机统计的「面板打开」只上报一次/每页（node 半还会每进程去重）。
     var panelOpenedSent = false;
@@ -2886,6 +3052,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 由桌面应用托管，重启这个动作
       // 在那边**做不到也不该做**（强行退出会弹原生致命错误）。面板据此：
@@ -5065,6 +5233,23 @@ window.__ModuleLoader__.load({
       // annVer 只用于让 useSyncExternalStore 的重渲染生效，本身不参与任何计算 —— 显式丢弃，免得被读成漏用。
       void annVer;
 
+      // ── 🎉 交流群引导：hook 追加在**最后一个既有 hook 之后**（同上"hook 序号铁律"）──────
+      // 触发时机 = 「面板加载完成 + 已登录 SaaS 账号」：st 由 refresh() 拉回、loggedIn 由它派生；
+      // 这里不写定时器、不抢首屏（数据回调后再 setState 渲染弹层）。本地模式（自建）不弹：
+      // node 半对这种模式直接回 ok:false/reason:local_mode（没有企业端账号体系）。
+      var ciArr = useState(null); var ciInvite = ciArr[0]; var setCiInvite = ciArr[1]; // {qrUrl}|null
+      useEffect(function () {
+        if (!loggedIn || mode !== "saas") return undefined;
+        var alive = true;
+        ciMaybeShow().then(function (data) {
+          if (!alive || !data) return;
+          ciMarkSeen();        // 先标记再展示：同一次桌面会话绝不重复弹
+          setCiInvite(data);
+          ciReportShown();     // 看过即算（幂等）：用户不点按钮、直接关页面也不会被反复骚扰
+        });
+        return function () { alive = false; };
+      }, [loggedIn, mode, phoneKey]);
+
       /** 取消本次自动重启(按事件持久化:同一 pending 事件不再自动重启)。 */
       var cancelAutoRestart = function () {
         markAutoRestartCancelled(restartInfo.at || 0);
@@ -5095,6 +5280,42 @@ window.__ModuleLoader__.load({
         );
       }
 
+      /**
+       * 🎉 交流群引导弹层（使用满 2 小时后由服务端 show 触发；与上面的「加入交流群」二维码弹窗
+       * 共用 dru-popup 视觉，不引入新设计语言）。
+       * 关闭纪律：两个按钮 + 点遮罩都走同一个 close —— 关闭时**调用**幂等上报 shown 再收起
+       * （展示时已成功报过则本地标记跳过网络；那次失败时这里正好补报）。
+       * 展示时已经报过一次，所以即使这次上报失败（网络抖动）也已经是"看过即算"。
+       */
+      function renderCommunityInviteModal() {
+        if (!ciInvite) return null;
+        var close = function () { ciReportShown(); setCiInvite(null); };
+        var qrUrl = ciInvite.qrUrl;
+        return h("div", { className: "dru-popup", "data-dru-theme": theme, onMouseDown: function (e) { if (e.target === e.currentTarget) close(); } },
+          h("div", { className: "dru-popup-card", role: "dialog", "aria-label": "加入用户交流群" },
+            h("div", { className: "dru-popup-body" },
+              h("div", { className: "dru-popup-title" }, "🎉 加入用户交流群"),
+              h("div", { className: "dru-popup-sub" }, "在群里可以交流使用心得、提想法和建议，遇到问题也更容易找到我们"),
+              qrUrl
+                ? h("img", {
+                    className: "dru-community-qr",
+                    src: qrUrl,
+                    alt: "用户交流群二维码",
+                    // 二维码加载失败：只藏图片，文案与按钮照旧（绝不因为一张图挂了就把引导整块丢掉）
+                    onError: function (e) { try { if (e && e.target) e.target.style.display = "none"; } catch (err) { /* 忽略 */ } }
+                  })
+                : null,
+              h("div", { className: "dru-hint", style: { marginTop: 10 } },
+                qrUrl ? "用手机微信/企业微信扫码即可入群。" : "二维码暂不可用，可稍后再看（不影响正常使用）。")
+            ),
+            h("div", { className: "dru-popup-actions", style: { padding: "0 22px 20px" } },
+              h("button", { type: "button", className: "dru-btn dru-btn-primary", onClick: close }, "加入交流群"),
+              h("button", { type: "button", className: "dru-btn dru-btn-ghost", onClick: close }, "稍后再看")
+            )
+          )
+        );
+      }
+
       // ── 📣 公告（0.6.18）：面板入口卡 / 详情弹窗 / 远程访问卡里的提醒入口 ──────────
       //
       // 数据来源只有一个：模块级的 annState（由 apply() 里的一次性拉取填充，见 annPull）。
@@ -5124,8 +5345,12 @@ window.__ModuleLoader__.load({
       function renderAnnouncementsCard() {
         if (!annState.ok || !annState.bubble) return null;
         var items = annState.items;
-        if (!items.length) return null;
         var unread = annState.unread;
+        // 2026-10-25：列表为空时**保留板块**（显示「暂无公告」）而不是整卡消失 ——
+        // 板块本身是用户确认"公告功能还在"的锚点，静默消失会被当成功能坏了。
+        if (!items.length) {
+          return card("📣 公告", [h("div", { className: "dru-hint" }, "暂无公告")]);
+        }
         return card("📣 公告" + (unread > 0 ? "（" + unread + " 条未读）" : ""), [
           h("div", { className: "dru-ann-list" }, items.map(function (it) {
             return h("button", {
@@ -5192,12 +5417,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 !== "",
@@ -5249,13 +5480,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
@@ -5325,6 +5560,8 @@ window.__ModuleLoader__.load({
           }, busy === "restart" ? "重启中…" : "🔄 重启 dsh web")
         ),
         renderCommunityModal(),
+        // 🎉 使用满 2 小时的交流群引导（服务端 show 决定的自动弹层；同一层，点遮罩即收起）
+        renderCommunityInviteModal(),
         // 📣 公告详情弹窗（与交流群弹窗同一层：都挂在面板根上，点遮罩即收起）
         renderAnnouncementDetail()
       );
@@ -5984,6 +6221,13 @@ window.__ModuleLoader__.load({
         //    公告是锦上添花，**没有任何资格**把门关上 —— 任何异常都只是"这次没有弹窗"。
       }
 
+      // 📱 独立「远程访问」弹层（入口点击用；见 RemoteStandaloneOverlay 注释）
+      try {
+        ctx.slots.inject("shell.overlay", function () {
+          return ctx.slots.register({ name: "shell.overlay", id: "dsh-remote-standalone", order: 95 }, RemoteStandaloneOverlay);
+        });
+      } catch (eStand) { /* 老宿主没有 shell.overlay：入口会在 150ms 后回退到官方设置栏目链路 */ }
+
       // 📣 公告：每次页面加载**只拉一次**（sessionStorage 一次性标记，见 annPullOnce）。
       //    放在 apply() 里是刻意的：apply 跑在 app mount **之前**，所以这里**绝不能碰产品 DOM**
       //    （那时还没有），只做数据拉取；UI 全部交给上面那个槽位与面板卡片。