dsh-remote-web 0.7.2-beta.1 → 0.7.2

package/lib/client.js

@@ -246,7 +246,12 @@ window.__ModuleLoader__.load({
       ".dru-captcha .dru-input{flex:1;min-width:0}",
       ".dru-captcha-box{width:118px;height:44px;flex:none;border-radius:8px;border:1px solid var(--dru-border-ctl);cursor:pointer;background:var(--dru-surface);display:flex;align-items:center;justify-content:center;font-size:12px;color:var(--dru-fg-muted);overflow:hidden}",
       ".dru-captcha-box svg{display:block;width:100%;height:100%}",
-      ".dru-user{display:flex;align-items:center;gap:10px;margin-bottom:12px}",
+      ".dru-user{display:flex;align-items:center;gap:10px;margin-bottom:12px;flex-wrap:wrap}",
+      // 退出登录：跟着账号行走（业主 2026-10-17），右侧对齐、次要视觉（不抢主行动）：
+      // 触控目标 ≥40px、与账号信息 8px 间距；危险色但不用实底（它不是主行动）。
+      ".dru-user-logout{margin-left:auto;flex:none;min-height:40px;padding:8px 12px;border:1px solid var(--dru-border-ctl);border-radius:8px;background:transparent;color:var(--dru-danger);font:500 12.5px/1.2 inherit;font-family:inherit;cursor:pointer;white-space:nowrap}",
+      ".dru-user-logout:hover:not(:disabled){background:var(--dru-danger-soft);border-color:var(--dru-danger-border)}",
+      ".dru-user-logout:disabled{opacity:.55;cursor:default}",
       ".dru-avatar{width:40px;height:40px;border-radius:50%;background:var(--dru-accent-fill);color:var(--dru-on-accent);display:flex;align-items:center;justify-content:center;font-size:17px;font-weight:700;flex-shrink:0}",
       ".dru-user .mail{font-size:14px;font-weight:600;color:var(--dru-fg);word-break:break-all}",
       ".dru-user .plan{font-size:12px;color:var(--dru-fg-muted);margin-top:2px}",
@@ -1368,16 +1373,6 @@ window.__ModuleLoader__.load({
     function annReportClick(id) {
       try { post("/dsh-remote/announcements/click", { id: id }).catch(function () { /* 静默：服务端才是权威 */ }); } catch (e) { /* 忽略 */ }
     }
-    /** 本地把某条标记为已读（只为了让徽标/标签立刻更新；真正的已读在服务端）。 */
-    function annMarkReadLocal(id) {
-      var hit = false;
-      annState.items = annState.items.map(function (x) {
-        if (x.id !== id || !x.unread) return x;
-        hit = true;
-        return Object.assign({}, x, { unread: false });
-      });
-      if (hit) { annState.unread = Math.max(0, annState.unread - 1); annEmit(); }
-    }
 
     // ── 🤖 微信机器人「命令帮助」镜像 ─────────────────────────────────────────
     // ⚠️ 真身是 clients/dsh-remote/wechat-channel.mjs 的 HELP_TEXT（用户在微信里看到的唯一说明书）。
@@ -2894,7 +2889,7 @@ window.__ModuleLoader__.load({
       var restartPending = !!restartInfo.pending;
       // 宿主形态（node 半下发）：桌面端（Electron）Host 由桌面应用托管，重启这个动作
       // 在那边**做不到也不该做**（强行退出会弹原生致命错误）。面板据此：
-      //   ① 不自动倒计时重启；② 保留提醒但改文案，引导"退出并重开桌面应用"。
+      //   ① 不自动倒计时重启；② 桌面端只提示「刷新页面即可」，不引导重启/重开应用（2026-10-17）。
       // 旧版 host 的响应里没有该字段 → false，行为与改动前完全一致。
       // 🔴 2026-10-11 修：node 半把该字段下在 **connect** 里（`connect.desktopHost`），
       // 这里以前读顶层 `st.desktopHost` → **永远 false** → 桌面端被当成 Web 版：
@@ -3988,6 +3983,55 @@ window.__ModuleLoader__.load({
       // 「更多」里只留下面那两个**折叠的营销入口**（升级 PRO / 带新用户换会员），用户仍要它们收在这里。
       // 🔒 顺带更强的一条不变量：整个面板从此不渲染任何 Mbps / GB / 价格数字
       //    （「已限速 / 不限速」仍由服务端 quota.limit_enabled / quota.max_mbps 驱动，但只给定性措辞）。
+      /**
+       * 🔧 安装/配对自检提示（2026-10-17）：node 半在 /dsh-remote/status 的 `setup` 里下发
+       * `{ kind: ok|runtime_missing|pairing_missing|all_missing, text, detail, backup? }`。
+       *
+       * 由来：真机事故 —— 用户本机 `~/.dsh-remote` 被误删后，面板只显示模糊的"未运行"，
+       * 用户不知道是"运行环境没了"还是"没登录"，最后手机端干等 47 秒才报错。
+       * 所以这里**必须说清结论 + 给出下一步动作**，但绝不阻塞面板其它功能。
+       */
+      function renderSetupAlert() {
+        var setup = (st && (st.setup || (st.connect && st.connect.setup))) || null;
+        if (!setup || !setup.kind || setup.kind === "ok") return null;
+        var backup = setup.backup && setup.backup.available ? setup.backup : null;
+        return h("div", { className: "dru-restart-alert", role: "status", style: { marginBottom: 12 } },
+          h("span", { className: "dru-restart-alert-icon" }, "🔧"),
+          h("div", { style: { flex: "1" } },
+            h("div", { className: "dru-restart-alert-title" }, setup.text || "运行环境需要处理"),
+            setup.detail ? h("div", { className: "dru-restart-alert-sub" }, setup.detail) : null,
+            backup ? h("div", { className: "dru-restart-alert-sub" }, backup.text || "检测到历史配对备份，可一键恢复") : null,
+            h("div", { className: "dru-actions", style: { marginTop: 10 } },
+              backup
+                ? h("button", {
+                    type: "button",
+                    className: "dru-btn dru-btn-primary",
+                    disabled: busy !== "",
+                    onClick: function () {
+                      var action = backup.action || {};
+                      setBusy("setup");
+                      post(action.path || "/dsh-remote/config/restore", action.body || {})
+                        .then(function (body) {
+                          if (body && body.ok) setMessage({ kind: "ok", text: "已恢复历史配对，正在重新启动 bridge…" });
+                          else setMessage({ kind: "err", text: (body && body.error && body.error.message) || "恢复失败，请重试" });
+                          if (body && body.connect) setSt(body); else refresh();
+                        })
+                        .catch(function (e) { setMessage({ kind: "err", text: "恢复失败: " + e.message }); })
+                        .finally(function () { setBusy(""); });
+                    }
+                  }, busy === "setup" ? "恢复中…" : "恢复历史配对")
+                : null,
+              h("button", {
+                type: "button",
+                className: "dru-btn dru-btn-ghost",
+                disabled: busy !== "",
+                onClick: function () { refresh(); }
+              }, "刷新状态")
+            )
+          )
+        );
+      }
+
       function renderAccount() {
         var a = account;
         var plan = a ? a.plan : "free";
@@ -4038,17 +4082,11 @@ window.__ModuleLoader__.load({
         var invTipOn = !invOff && !inviteTipDismissed;
         var invTipRule = invTipOn ? inviteRuleOf() : null;
         // 【0.6.10】营销入口「在哪一层」的四个开关（约定：新用户第一次看得见，用户关掉后收进「更多」）：
-        //   · 没关过（mktFolded=false）→ 「升级 PRO」与「带新用户换会员」摆在账号卡正面（与今天一致）
-        //   · 关过（mktFolded=true）   → 正面只留一个「更多」，两条入口搬进「更多」里
-        // 两个边界：
-        //   · invOff（运营关掉拉新）→ 拉新入口**整体不渲染**，收纳前后都不出现
-        //     （老注释：否则会点进一个没有内容的邀请页）
-        //   · 付费用户的按钮是「续费 / 转正式 PRO」—— 那是账号维护、不是营销露出，收纳后仍留在正面：
-        //     把付费用户的续费入口藏进「更多」是真实风险（续费靠它，:3096-3098 的到期日也靠它提醒）
-        var showUpsellOnFace = !mktFolded || isMember;
-        var showInviteOnFace = !invOff && !mktFolded;
-        var showUpsellInMore = mktFolded && !isMember;
-        var showInviteInMore = mktFolded && !invOff;
+        // 2026-10-17 版式简化（业主：按钮太多、换行逻辑太多）：
+        //   正面**只留一行三个按钮** —— 主行动（升级/续费）+ 用户反馈 + 「更多」；
+        //   「带新用户换会员 / 修改密码 / 加入交流群」全部收进「更多」。
+        // 位置稳定 > 首次曝光：入口永远在同一个地方，用户不用记"上次在哪"，也不再需要
+        // mktFolded 那套"先摆正面、关过才收纳"的两层逻辑（气泡仍会提示一次，见 renderInviteTip）。
         return h("div", null,
           h("div", { className: "dru-user" },
             h("div", { className: "dru-avatar" }, (st.config.phone || "D").charAt(0).toUpperCase()),
@@ -4060,7 +4098,16 @@ window.__ModuleLoader__.load({
               // （「PRO 会员 · 到期 …」）讲的是**功能性**的到期时间，不是营销。
               // 免费用户这里什么都不显示 —— 把「免费档」当标签挂在脸上，正是要减少的营销露出。
               isMember ? h("div", { className: "plan" }, plan === "pro_max" ? "Pro Max" : "PRO") : null
-            )
+            ),
+            // 2026-10-17（业主）：退出登录从按钮行挪到**账号行右侧** —— 它属于"账号维护"，
+            // 与账号信息同一行动线；主按钮行也因此少一个按钮。
+            h("button", {
+              type: "button",
+              className: "dru-user-logout",
+              disabled: busy !== "",
+              title: "退出登录（电脑端后台服务与手机端连接不受影响）",
+              onClick: function () { doLogout(false); }
+            }, "退出登录")
           ),
           // 额度状态：不限量说明 / 剩余额度百分比 / 会员到期日。
           // 首屏只说「还剩多少」，不提档位名、不写带宽数值（数值在下面「更多」里）。
@@ -4069,90 +4116,57 @@ window.__ModuleLoader__.load({
             h("span", null, planText)
           ),
           h("div", { className: "dru-actions", style: { marginTop: 10 } },
-            // 升级/续费：免费用户这条是**营销入口**，用户关掉引导后搬进「更多」；
-            // 付费用户的续费/转正入口始终留在正面（账号维护，不是营销露出）。
-            showUpsellOnFace
-              ? h("button", { type: "button", className: "dru-btn dru-btn-primary", style: { display: "inline-flex", alignItems: "center" }, disabled: busy !== "", title: "升级/续费（带登录态打开）", onClick: openUpgradeAuth },
-                  busy === "upgrade" ? "生成链接中…" : (!isMember ? "🚀 升级 PRO" : source === "trial" ? "🚀 转正式 PRO" : "🔄 续费会员"))
-              : null,
-            // 拉新入口：invOff（运营关掉拉新）整体隐藏，收纳前后都不出现（否则会点进一个没有内容的邀请页）；
-            // 用户收纳过后搬进「更多」。
-            // 按钮文字自带可访问名称；气泡在屏时用 aria-describedby 把「能得多少」也读出来。
-            showInviteOnFace ? h("button", {
-              type: "button",
-              className: "dru-btn dru-btn-ghost",
-              disabled: busy !== "",
-              title: invTipRule ? "带 " + invTipRule.n + " 位新用户可得 " + invTipRule.days + " 天 PRO 会员" : "带新用户换会员",
-              "aria-describedby": invTipOn ? INVITE_TIP_ID : undefined,
-              onClick: function () { setView("invite"); loadInvite(); }
-            }, "🎁 带新用户换会员") : null,
+            // 主行动：免费=升级入口，会员=续费/转正（账号维护，永远在正面第一位）
+            h("button", {
+              type: "button", className: "dru-btn dru-btn-primary",
+              style: { display: "inline-flex", alignItems: "center" }, disabled: busy !== "",
+              onClick: openUpgradeAuth
+            },
+              busy === "upgrade" ? "生成链接中…" : (!isMember ? "🚀 升级 PRO" : source === "trial" ? "🚀 转正式 PRO" : "🔄 续费会员")),
+            // 次要：用户反馈（"联系我们"的高频入口，留在正面）
             h("button", { type: "button", className: "dru-btn dru-btn-ghost", disabled: busy !== "", onClick: function () { setView("feedback"); } }, "💬 用户反馈"),
-            // 💬 加入交流群（0.6.18 从「关于」卡搬到这里）：它和「用户反馈」是同一类东西 ——
-            // 「跟我们联系」的两个入口。原来它躺在最底下的「关于 dsh-remote」里，用户要读完
-            // 六段技术说明才找得到，而那时的位置离"有事想找人问"的场景已经很远了。
-            // 未配置二维码（后台上传才有）→ 整体不渲染，不留空壳按钮。
-            community && community.qrcode
-              ? h("button", {
-                  type: "button",
-                  className: "dru-btn dru-btn-ghost",
-                  disabled: busy !== "",
-                  onClick: function () { setCommOpen(true); }
-                }, "💬 加入交流群")
-              : null,
-            h("button", { type: "button", className: "dru-btn dru-btn-ghost", disabled: busy !== "", onClick: togglePwdForm }, pwdOpen ? "收起修改密码" : "🔒 修改密码"),
-            h("button", { type: "button", className: "dru-btn dru-btn-danger", disabled: busy !== "", onClick: function () { doLogout(false); } }, "退出登录")
+            // 「更多」变成同一行里的普通按钮（原来是一条整宽披露条，视觉重量和按钮完全不匹配）。
+            // 无障碍不变：id / aria-expanded / aria-controls 保持原样（用例按它们定位）。
+            h("button", {
+              type: "button",
+              id: MKT_MORE_TOGGLE_ID,
+              className: "dru-btn dru-btn-ghost dru-disclose-inline",
+              "aria-expanded": moreOpen ? "true" : "false",
+              "aria-controls": MKT_MORE_BODY_ID,
+              onClick: function () { setMoreOpen(!moreOpen); }
+            },
+              h("span", null, "更多"),
+              h("span", { className: "dru-disclose-caret", "aria-hidden": "true" }, moreOpen ? "▲" : "▼")
+            )
           ),
-          // 🎁 邀请收益引导气泡：紧贴上面那排按钮（不遮挡按钮、窄屏独占一行）。
-          // 它的 ✕ 同时是「营销入口收纳」的触发信号（0.6.10）：点过之后两个入口搬进下面的「更多」。
+          // 🎁 邀请引导气泡：紧跟按钮行（不遮挡按钮）。点 ✕ 只做"不再提示"，不再改变入口位置。
           renderInviteTip(),
-          h("div", { className: "dru-hint", style: { marginTop: 8 } },
-            "升级/续费以带登录态方式打开：点击后生成一次性访问链接并直接跳转，无需重新登录。" +
-            (endsAt && isMember ? "到期后如需继续使用会员权益，请在到期前续费。" : "")),
-          // 🧰 「更多」：主界面上唯一常驻的那一个营销入口（0.6.10）—— 收纳态下正面不再摆按钮行的一部分。
-          // 折叠时它就是一个 .dru-disclose 按钮：命中区 ≥44px、键盘可聚焦（焦点环见样式表末尾的
-          // :focus-visible 基线），开合状态用「展开 ▼ / 收起 ▲」**文字**加箭头表达，不靠颜色区分。
-          // 无障碍：aria-expanded 表达开合，aria-controls 指向下面的内容体（内容体始终在 DOM 里、
-          // 收起时 hidden，所以 aria-controls 永远指向一个真实存在的元素，不指向空气）。
-          // 【0.6.18】加 .dru-disclose-inline：原来它继承 .dru-disclose 的 width:100%，
-          //   在账号卡里被撑成一条横贯整卡的宽条，和上面那排按钮完全不是一个视觉重量（用户："宽而丑"）。
-          //   ⚠️ 变体只加在**这一处**：邀请页的「活动规则」披露仍是整行，那是对的（它是那一屏的主折叠）。
-          //   id / aria-controls / aria-expanded 一个都不能动 —— remote-access-ui.test.mjs 按它们定位。
-          h("button", {
-            type: "button",
-            id: MKT_MORE_TOGGLE_ID,
-            className: "dru-disclose dru-disclose-inline",
-            style: { marginTop: 10 },
-            "aria-expanded": moreOpen ? "true" : "false",
-            "aria-controls": MKT_MORE_BODY_ID,
-            onClick: function () { setMoreOpen(!moreOpen); }
-          },
-            h("span", null, "更多"),
-            h("span", { className: "dru-disclose-caret", "aria-hidden": "true" }, moreOpen ? "收起 ▲" : "展开 ▼")
-          ),
+          // 🧰 「更多」折叠体：带新用户 / 修改密码 / 加入交流群 + 修改密码表单
           h("div", {
             id: MKT_MORE_BODY_ID,
             className: "dru-more-body",
             hidden: !moreOpen
           },
-            // 【0.6.11】这里**不再**有「套餐与额度」标题与档位明细（renderPlanDetail 已删）：
-            // 用户约定 —— 本地面板不展示 PRO 的带宽/流量/价格数字。「更多」只剩下面两个折叠入口。
-            // 用户收纳过之后，两条营销入口就住在这里（正面不再摆它们）
-            (showUpsellInMore || showInviteInMore)
-              ? h("div", { className: "dru-more-actions" },
-                  showUpsellInMore
-                    ? h("button", { type: "button", className: "dru-btn dru-btn-primary", disabled: busy !== "", title: "升级/续费（带登录态打开）", onClick: openUpgradeAuth },
-                        busy === "upgrade" ? "生成链接中…" : "🚀 升级 PRO")
-                    : null,
-                  showInviteInMore
-                    ? h("button", { type: "button", className: "dru-btn dru-btn-ghost", disabled: busy !== "", title: "带新用户换会员", onClick: function () { setView("invite"); loadInvite(); } }, "🎁 带新用户换会员")
-                    : null)
-              : null
+            h("div", { className: "dru-more-actions" },
+              invOff ? null : h("button", {
+                type: "button",
+                className: "dru-btn dru-btn-ghost",
+                disabled: busy !== "",
+                title: invTipRule ? "带 " + invTipRule.n + " 位新用户可得 " + invTipRule.days + " 天 PRO 会员" : "带新用户换会员",
+                onClick: function () { setView("invite"); loadInvite(); }
+              }, "🎁 带新用户换会员"),
+              h("button", { type: "button", className: "dru-btn dru-btn-ghost", disabled: busy !== "", onClick: togglePwdForm }, pwdOpen ? "收起修改密码" : "🔒 修改密码"),
+              community && community.qrcode
+                ? h("button", {
+                    type: "button",
+                    className: "dru-btn dru-btn-ghost",
+                    disabled: busy !== "",
+                    onClick: function () { setCommOpen(true); }
+                  }, "💬 加入交流群")
+                : null
+            ),
+            pwdOpen ? renderResetPwdForm(false) : null
           ),
-          // 额度将尽 / 已被限速 → 🔀 双路块：升级套餐（转化）or 带新用户换会员时长（拉新）。
-          // 用户收纳过（mktFolded）时 renderDualPath 自己返回 null —— 那两条路这时都在「更多」里，
-          // 这里不再重复摆一遍（也不留一个没有按钮的空壳块）。
-          quotaTight ? renderDualPath("quota") : null,
-          pwdOpen ? renderResetPwdForm(false) : null
         );
       }
 
@@ -5021,7 +5035,7 @@ window.__ModuleLoader__.load({
       // 在线更新成功后出现,若照旧 15 秒自动重启,等于"更新完必定打断用户正在做的事"。
       useEffect(function () {
         // ⚠️ desktopHost 时**不自动重启**：桌面端重启 Host 由 Electron 托管，插件无权也不该做
-        // （见 node 半 restartHarness 的说明）。此时只保留文案提醒，动作交给用户「退出并重开应用」。
+        // （见 node 半 restartHarness 的说明）。此时只提示刷新页面，不再引导重开应用。
         if (!restartPending || isRefreshOnly || isRestartHard || desktopHost || busy !== "" || restartCancelled) { setRestartCountdown(null); return undefined; }
         var at = restartInfo.at || 0;
         if (autoRestartCancelled(at)) { setRestartCountdown(null); return undefined; }
@@ -5094,10 +5108,10 @@ window.__ModuleLoader__.load({
       function openAnnItem(it) {
         if (!it) return;
         setAnnOpenId(it.id);
-        if (it.unread) {
-          annReportClick(it.id);
-          annMarkReadLocal(it.id);
-        }
+        // 2026-10-17 业主约定：**点开不等于已读** —— 点开只上报「点击」，不动「已读」。
+        // 「已读」由服务端在列表/弹窗下发时记（shown），后台把已读与点击分开统计；
+        // 客户端也不在本地改 unread（下一次拉取以服务端为准，避免客户端自造已读口径）。
+        if (it.unread) annReportClick(it.id);
       }
       /**
        * 📣 公告卡：插在「🔑 账号」卡**之前**（运营要用户看到的东西，与"远程访问/账号"同属首屏）。
@@ -5130,14 +5144,6 @@ window.__ModuleLoader__.load({
               h("span", { className: "dru-ann-item-time" }, it.created_at ? fmtDate(it.created_at) : "")
             );
           })),
-          h("div", { className: "dru-hint", style: { marginTop: 8 } },
-            "点开即视为已读（后台按已读与点击分别统计）；公告顺序由后台设定。"),
-          h("div", { className: "dru-actions", style: { marginTop: 8 } },
-            h("button", {
-              type: "button",
-              className: "dru-btn dru-btn-ghost",
-              onClick: function () { annFetch({ openPopup: false }); }   // 主动刷新：只更新列表，不弹窗
-            }, "刷新公告"))
         ]);
       }
       /** 公告详情（复用 .dru-popup 视觉；点遮罩/关闭即收起）。正文按**纯文本**渲染（一期不做富文本）。 */
@@ -5155,7 +5161,6 @@ window.__ModuleLoader__.load({
               it.image ? h("img", { className: "dru-ann-img", src: it.image, alt: "公告图片" }) : null
             ),
             h("div", { className: "dru-popup-foot" },
-              h("span", null, "已读状态已同步到后台"),
               h("button", { type: "button", onClick: close }, "关闭")
             )
           )
@@ -5181,17 +5186,15 @@ window.__ModuleLoader__.load({
         if (restartPending) {
           // 桌面端：刷新类照旧（刷新页面即可）；需要重启 Host 的那一类**不给「立即重启」按钮** ——
           // 桌面端 Host 由 Electron 托管，插件点了也做不到，给个点不动的按钮只会让人以为是 bug。
-          // 改成如实引导：退出并重开 DeepSeek Harness。
+          // 改成只提示刷新页面（2026-10-17：不再引导重开应用）。
           // ⚠️ 非桌面端必须保持**原有判据 isRestartHard**：改成 isRefreshOnly 会让"历史遗留 kind"
           // 的文案从"刷新页面即可生效"变成"重启 dsh web 后生效" —— 属于发布版用户可见的文案变更，
           // 不该混在桌面端适配里顺手做掉。桌面端才走新文案。
-          var restartRowText = desktopHost
-            ? (isRefreshOnly
-              ? "🔄 插件已更新：刷新页面即可生效"
-              : "🔄 插件已更新：退出并重新打开 DeepSeek Harness 后生效")
-            : (isRestartHard
-              ? "🔄 插件已更新：重启 dsh web 后生效"
-              : "🔄 插件已更新：刷新页面即可生效");
+          // 2026-10-17（业主）：桌面端运行环境由应用托管、更新自动热加载 ——
+          // **不再引导用户重启 DeepSeek Harness**，统一只说「刷新页面即可生效」。
+          var restartRowText = (desktopHost || !isRestartHard)
+            ? "🔄 插件已更新：刷新页面即可生效"
+            : "🔄 插件已更新：重启 dsh web 后生效";
           rows.push(h("div", { className: "dru-access-tip-row", key: "restart" },
             h("span", null, restartRowText),
             (isRefreshOnly || !desktopHost) ? h("button", {
@@ -5228,6 +5231,7 @@ window.__ModuleLoader__.load({
           )
         ),
         h("div", { className: "dru-settings-body" },
+          renderSetupAlert(),
           restartPending
             // 【0.6.18】三种"待用户动一下"的情形，文案与主按钮**按 kind 一一对应**：
             //   · refresh（插件文件在运行中被改写）→ 软提示 + 主按钮「刷新页面」（零风险动作）
@@ -5238,28 +5242,25 @@ window.__ModuleLoader__.load({
                 className: "dru-restart-alert" + (isRestartHard ? " dru-restart-alert-strong" : ""),
                 role: isRestartHard ? "alert" : "status"
               },
-                h("span", { className: "dru-restart-alert-icon" }, isRestartHard ? "⚠️" : "🔔"),
+                h("span", { className: "dru-restart-alert-icon" }, (!desktopHost && isRestartHard) ? "⚠️" : "🔔"),
                 h("div", { style: { flex: "1" } },
                   h("div", { className: "dru-restart-alert-title" },
-                    // 插件已改为 patch 热加载:装插件/在线更新都不再需要重启 harness,
-                    // 唯一要用户动一下的情形是"插件文件在运行中被改写"→ 刷新页面即可。
-                    // 桌面端：需要换 Host 进程的那一类改为引导「退出并重开应用」（插件无权重启 Host）。
-                    isRestartHard
-                      ? (desktopHost ? "插件已更新，退出并重新打开 DeepSeek Harness 后生效"
-                        : "插件已更新，重启 dsh web 后生效")
-                      : isRefreshOnly ? "插件已更新，刷新页面即可生效"
-                        : (desktopHost ? "需要重新打开 DeepSeek Harness 才能载入新插件"
-                          : "需要重启 dsh web 才能载入新插件")),
+                    // 2026-10-17（业主）：桌面端运行环境由应用托管、插件安装/更新自动热加载 ——
+                    // **任何情况都不再引导"重启/退出重开应用"**，只说「刷新页面即可生效」。
+                    // 非桌面端（自建 dsh web）保留原有 isRestartHard 判据，文案不变。
+                    desktopHost
+                      ? "插件已更新：刷新页面即可生效"
+                      : (isRestartHard
+                        ? "插件已更新，重启 dsh web 后生效"
+                        : (isRefreshOnly ? "插件已更新，刷新页面即可生效" : "需要重启 dsh web 才能载入新插件"))),
                   h("div", { className: "dru-restart-alert-sub" },
-                    isRestartHard
-                      ? (desktopHost
-                        ? "新版本已经装到这台电脑上，但当前运行的 DeepSeek Harness 还是旧代码（新的后台路由与面板要等它重新载入）。桌面端的运行环境由应用本身托管，插件不能单独重启它 —— 请退出并重新打开 DeepSeek Harness 应用。手机端连接与已登录状态都不受影响。"
-                        : "新版本已经装到这台电脑上，但当前运行的 dsh web 还是旧代码（新的后台路由与面板要等它重新载入）。手机端连接与已登录状态都不受影响；重启期间页面会短暂断开，然后自动恢复。")
-                      : isRefreshOnly
-                        ? "刚装好/刚更新的插件已在磁盘上，浏览器里的面板还是旧版本。刷新一下这个页面即可（手机端连接与已登录状态都不受影响）。"
-                        : (desktopHost
-                          ? "当前运行中的 DeepSeek Harness 里还没有载入这个插件。先刷新页面；如果刷新后仍然看不到面板，请退出并重新打开 DeepSeek Harness 应用。"
-                          : "当前运行中的 dsh web 里还没有载入这个插件。先刷新页面；如果刷新后仍然看不到面板，再重启一次 dsh web。")),
+                    desktopHost
+                      ? "新插件已经在磁盘上，刷新一下这个页面即可载入（手机端连接与已登录状态都不受影响）。如果刷新后仍看不到面板，在应用内「插件」页重新安装一次即可。"
+                      : (isRestartHard
+                        ? "新版本已经装到这台电脑上，但当前运行的 dsh web 还是旧代码（新的后台路由与面板要等它重新载入）。手机端连接与已登录状态都不受影响；重启期间页面会短暂断开，然后自动恢复。"
+                        : (isRefreshOnly
+                          ? "刚装好/刚更新的插件已在磁盘上，浏览器里的面板还是旧版本。刷新一下这个页面即可（手机端连接与已登录状态都不受影响）。"
+                          : "当前运行中的 dsh web 里还没有载入这个插件。先刷新页面；如果刷新后仍然看不到面板，再重启一次 dsh web。"))),
                   // 【自动化】待重启时自动倒计时重启(用户零操作);倒计时期间可一键取消
                   restartCountdown !== null && restartCountdown > 0
                     ? h("div", { className: "dru-restart-auto", role: "status" },
@@ -5311,21 +5312,17 @@ window.__ModuleLoader__.load({
             : view === "invite" ? renderInvite()
             : renderHome()
         ),
-        // 常驻入口最底部：「重启 DeepSeek harness」按钮始终可达（首次安装/更新/排查都用它）
-        // 桌面端：Host 由 Electron 托管，重启这个动作不存在 → 不摆一个点了必然失败的按钮，
-        // 改为如实说明「退出并重开桌面应用」。后台服务与手机端连接在两种形态下都不受影响。
-        h("div", { className: "dru-restart-foot" },
-          h("div", { className: "dru-hint" }, desktopHost
-            ? "重启 DeepSeek Harness：桌面端由应用本身托管运行环境，请直接退出并重新打开应用（无需其他操作）。日常安装/更新插件已自动热加载，装完刷新页面即可；重启不影响后台服务与手机端连接。"
-            : "重启 dsh web：仅在「刷新页面后仍看不到面板」时才需要。日常安装/更新插件已自动热加载，装完刷新页面即可；重启只影响 dsh web 本身，不影响后台服务与手机端连接。"),
-          desktopHost
-            ? null
-            : h("button", {
-              type: "button",
-              className: "dru-btn " + (restartPending ? "dru-btn-primary" : "dru-btn-ghost"),
-              disabled: busy !== "",
-              onClick: function () { restartHarness(); }
-            }, busy === "restart" ? "重启中…" : "🔄 重启 dsh web")
+        // 2026-10-17（业主）：删除「重启 DeepSeek Harness」整段说明 ——
+        // 桌面端运行环境由应用本身托管、插件安装/更新自动热加载，刷新页面即可；
+        // 只有非桌面端（自建 dsh web）才保留重启入口，且文案只讲这一种场景。
+        desktopHost ? null : h("div", { className: "dru-restart-foot" },
+          h("div", { className: "dru-hint" }, "刷新页面后仍看不到面板时，才需要重启 dsh web；日常安装/更新插件会自动热加载。"),
+          h("button", {
+            type: "button",
+            className: "dru-btn " + (restartPending ? "dru-btn-primary" : "dru-btn-ghost"),
+            disabled: busy !== "",
+            onClick: function () { restartHarness(); }
+          }, busy === "restart" ? "重启中…" : "🔄 重启 dsh web")
         ),
         renderCommunityModal(),
         // 📣 公告详情弹窗（与交流群弹窗同一层：都挂在面板根上，点遮罩即收起）

package/lib/index.js

@@ -20,7 +20,7 @@
 //   - 0.1.2+ ?token 浏览器鉴权会话代持（0.4.1 起）
 //
 // 不依赖任何第三方包：只使用 node 内置模块与 cordis 注入的 webServer 服务。
-import { readFileSync, writeFileSync, mkdirSync, existsSync, realpathSync, accessSync, chmodSync, openSync, closeSync, readSync, fstatSync, rmSync, renameSync, statSync, copyFileSync, cpSync, constants as fsConstants } from "node:fs";
+import { readFileSync, writeFileSync, mkdirSync, existsSync, realpathSync, accessSync, chmodSync, openSync, closeSync, readSync, fstatSync, rmSync, renameSync, statSync, copyFileSync, cpSync, readdirSync, constants as fsConstants } from "node:fs";
 import { join, dirname, sep, delimiter, isAbsolute, relative } from "node:path";
 import { execSync, spawn, spawnSync } from "node:child_process";
 import { randomUUID } from "node:crypto";
@@ -738,6 +738,309 @@ function applySaaSMode(cfg) {
   return cfg;
 }
 
+// ---------- 安装/配对自检 + 配对信息备份（2026-10-17 事故） ----------
+//
+// 事故：用户本机 `~/.dsh-remote`（bridge 运行时 + **账号配对信息/设备密钥**）被误删 →
+// bridge 无法启动、设备离线；手机端镜像页干等 47 秒；面板状态机只显示模糊的「未运行/准备中」，
+// 用户完全不知道该**重新安装**还是该**重新登录**。
+//
+// 这一段的职责（全部只读 + 明确的下一步动作，绝不偷偷替用户做决定）：
+//   ① setupStateOf：把「运行时在不在（clients/）」「配对信息在不在（.dsh-config.json）」分开如实报告，
+//      并给出面向非技术用户的一句话结论（缺什么、下一步做什么）；
+//   ② 运行时缺失 → 复用既有 ensureRuntime 从插件自带 runtime/ 自愈补装（配对缺失**必须用户登录**，
+//      绝不自动填入任何凭据）；
+//   ③ 配对备份（**双份**，2026-10-17 二次加固）：
+//        · 配置目录：<relayDir>/backup/dsh-config-<ISO>.json；
+//        · **插件 profile 下的独立数据目录**：<profile>/dsh-remote-web-data/config-backup/。
+//      真机事故里用户删的是**整个 ~/.dsh-remote 目录** —— 只备份在 relayDir 里等于没备份，
+//      所以必须再存一份在不随 relayDir 删除、也不随插件包升级（`<id>-plugin/` 会被整体替换）
+//      消失的位置。落点与插件 profile 同源（profile 目录推导规则见 pluginProfileDir，与
+//      registerRoutes 用的是同一份），目录 700 / 文件 600 / 每处保留最近 3 份。
+//      启动时发现主配置缺失但备份存在 → **不自动恢复**（防误用旧账号/别人的账号），
+//      只在状态里提示「检测到历史配对备份（时间），可一键恢复」并给恢复入口。
+//
+// 🔒 安全边界（备份文件里是明文密码/设备私钥）：
+//   · 日志只写**文件名与时间**，绝不写内容；状态对象里也不带任何凭据字段；
+//   · 备份失败一律静默（不影响安装/登录；两份里成功一份就算成功）；
+//   · 恢复前先把"当前状态"再备份一份（可回滚）；恢复必须由用户在面板里显式点击；
+//   · 彻底卸载时 profile 数据目录里的这份也一起删（否则"已卸载"还留着账号密钥，
+//     而且重装后会提示恢复一个用户已经不要了的旧账号）。
+
+/** 配对备份目录（相对 relayDir；第二份在 profile 数据目录，见 PROFILE_* 常量）。 */
+const CONFIG_BACKUP_DIR = "backup";
+const CONFIG_BACKUP_KEEP = 3;
+const CONFIG_BACKUP_PREFIX = "dsh-config-";
+/** profile 下本插件自己的**独立数据目录**：不随 `<id>-plugin/`（升级时整体替换）消失。 */
+const PROFILE_DATA_DIR = "dsh-remote-web-data";
+const PROFILE_BACKUP_SUBDIR = "config-backup";
+/**
+ * 备份来源与优先级：`profile` = 插件 profile 数据目录（抗整目录删除），`relay` = 配置目录。
+ * 数组顺序 = 默认优先级（恢复默认选"最新的一份"，时间相同时 **profile 胜** ——
+ * 它能在 relayDir 整个被删时活下来，是同一次写入里更耐久的那份副本）。
+ */
+const CONFIG_BACKUP_SOURCES = ["profile", "relay"];
+/** 来源 → 用户可见的中文标签（只说明位置，不含凭据信息）。 */
+const CONFIG_BACKUP_SOURCE_TEXT = { profile: "插件持久目录", relay: "配置目录" };
+
+/**
+ * 本插件所在的 profile 目录（与 registerRoutes 同一份推导规则：
+ * 由插件自身文件位置推导，覆盖市场 git 安装 / 本地 include 两种形态；取不到用默认 web profile）。
+ *
+ * ⚠️ 为什么不直接用 plugin 包目录：升级/重装会整目录替换 `<profile>/<id>-plugin/`，
+ *    放在它里面的备份会跟着没 —— 所以数据目录放在 profile 下的**同级独立目录**。
+ */
+function pluginProfileDir() {
+  let dir = join(homedir(), ".dsh", "profiles", "web");
+  try {
+    const here = fileURLToPath(import.meta.url);
+    // 依次尝试两种安装布局（当前名优先，历史名兜底）；split()[0] 未命中时返回原串，需显式判断后再试下一种
+    let m = here.split("/dsh-remote-web-plugin/")[0];
+    if (m === here) m = here.split("/node_modules/dsh-remote-web/")[0];
+    if (m === here) m = here.split("/dsh-remote-ui-plugin/")[0];
+    if (m === here) m = here.split("/node_modules/dsh-remote-ui/")[0];
+    if (m !== here) dir = m;
+  } catch { /* 保持默认 */ }
+  return dir;
+}
+
+/** 某个来源的备份目录绝对路径。 */
+function configBackupDirOf(relayDir, source = "relay") {
+  if (source === "relay") return join(relayDir, CONFIG_BACKUP_DIR);
+  return join(pluginProfileDir(), PROFILE_DATA_DIR, PROFILE_BACKUP_SUBDIR);
+}
+
+/** 人类可读时间（只用于状态/日志的"时间"提示，不含任何凭据）。 */
+function fmtLocalTime(ms) {
+  const n = Number(ms);
+  if (!Number.isFinite(n) || n <= 0) return "";
+  try {
+    const d = new Date(n);
+    const p = (v) => String(v).padStart(2, "0");
+    return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`;
+  } catch { return ""; }
+}
+
+/** 备份文件名的唯一合法形态（时间戳 + 可选序号；拒绝任何路径成分）。 */
+const CONFIG_BACKUP_FILE_RE = /^dsh-config-[\w.-]+\.json$/;
+
+/**
+ * 列出**某一个来源**的备份（新 → 旧）。只读目录；**绝不读取/返回备份文件内容**。
+ * @returns {Array<{source:string, file:string, name:string, at:number, size:number}>}
+ */
+function listConfigBackupsIn(relayDir, source) {
+  try {
+    const dir = configBackupDirOf(relayDir, source);
+    const files = readdirSync(dir).filter((n) => CONFIG_BACKUP_FILE_RE.test(String(n)));
+    return files.map((file) => {
+      let at = 0;
+      let size = 0;
+      try {
+        const st = statSync(join(dir, file));
+        at = Number(st.mtimeMs) || 0;
+        size = Number(st.size) || 0;
+      } catch { /* 文件刚被删/无权限：忽略该项时间 */ }
+      // name 里体现来源：profile:<file> / relay:<file>（状态/恢复接口都用它，绝不把绝对路径发散出去）
+      return { source, file, name: `${source}:${file}`, at, size };
+    });
+  } catch { return []; }
+}
+
+/**
+ * 列出**两个来源合并**后的备份（新 → 旧）。
+ * 时间相同时 **profile 排前面**（默认优先恢复它，见 CONFIG_BACKUP_SOURCES 注释）。
+ * @returns {Array<{source:string, file:string, name:string, at:number, size:number}>}
+ */
+function listConfigBackups(relayDir) {
+  const order = new Map(CONFIG_BACKUP_SOURCES.map((s, i) => [s, i]));
+  const all = [];
+  for (const source of CONFIG_BACKUP_SOURCES) all.push(...listConfigBackupsIn(relayDir, source));
+  return all.sort((a, b) => (b.at - a.at) || ((order.get(a.source) ?? 9) - (order.get(b.source) ?? 9))
+    || String(b.file).localeCompare(String(a.file)));
+}
+
+/**
+ * 解析用户/状态给出的备份引用 → 列表里的真实条目（**只认列表内文件**，防路径穿越/任意文件读）。
+ *   · 省略 / 空串 → 默认：最新一份（时间相同优先 profile）
+ *   · `profile:<file>` / `relay:<file>` → 指定来源（状态里下发的就是这种 name）
+ *   · 裸 `<file>` → 兼容旧状态（2026-10-17 之前只写 relay 一份）：两个来源里找，命中多个时优先 profile
+ * @returns {{source:string,file:string,name:string,at:number,size:number}|null}
+ */
+function findConfigBackup(relayDir, ref = "") {
+  const raw = String(ref || "").trim();
+  const all = listConfigBackups(relayDir);
+  if (!all.length) return null;
+  if (!raw) return all[0]; // listConfigBackups 已按"新→旧、时间相同 profile 先"排好
+  if (/[\\/]/.test(raw) || raw.includes("..")) return null; // 明显是路径/穿越：直接拒绝
+  const m = /^(profile|relay):(.+)$/.exec(raw);
+  if (m) return all.find((b) => b.source === m[1] && b.file === m[2]) || null;
+  // 裸文件名（兼容旧状态）：同名的可能两份都在 → 优先 profile
+  const hits = all.filter((b) => b.file === raw);
+  return hits.find((b) => b.source === "profile") || hits[0] || null;
+}
+
+/** 只保留**每个来源**最近 CONFIG_BACKUP_KEEP 份（更老的删掉；失败静默）。 */
+function pruneConfigBackups(relayDir, keep = CONFIG_BACKUP_KEEP) {
+  for (const source of CONFIG_BACKUP_SOURCES) {
+    try {
+      const all = listConfigBackupsIn(relayDir, source);
+      for (const b of all.slice(Math.max(0, keep))) {
+        try { rmSync(join(configBackupDirOf(relayDir, source), b.file), { force: true }); } catch { /* 忽略 */ }
+      }
+    } catch { /* 单个来源失败不影响另一个 */ }
+  }
+}
+
+/**
+ * 把当前 `.dsh-config.json` **同时**复制到两处（relayDir/backup 与 profile 数据目录），
+ * 每处权限 600（目录 700）、各保留最近 3 份。
+ *
+ * 调用点：① 面板登录/配对成功（POST /dsh-remote/config）；② 运行环境安装完成（ensureRuntime 成功）；
+ *         ③ 恢复前先备份当前状态。
+ * 🔒 日志只写文件名+时间，**绝不写内容**；任何失败静默返回，绝不影响安装/登录主流程。
+ *    单个落点失败（例如 relayDir 只读）不影响另一份成功 —— 至少有一份就返回 ok。
+ * @returns {{ok:boolean, at?:number, name?:string, sources?:{profile?:string, relay?:string}, reason?:string}}
+ *          name = 默认恢复会选中的那一份（profile 优先）；sources = 两个落点各自的文件名
+ */
+function backupConfigFile(relayDir) {
+  try {
+    const src = configPathOf(relayDir);
+    if (!existsSync(src)) return { ok: false, reason: "no-config" }; // 还没配对：无可备份
+    const at = Date.now();
+    const stamp = new Date(at).toISOString().replace(/[:.]/g, "-");
+    const sources = {};
+    for (const source of CONFIG_BACKUP_SOURCES) {
+      try {
+        const dir = configBackupDirOf(relayDir, source);
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+        // 文件名只含时间戳（不含账号/手机号等任何内容）；同一毫秒重复备份时加序号，绝不覆盖已有备份
+        let file = `${CONFIG_BACKUP_PREFIX}${stamp}.json`;
+        for (let i = 2; existsSync(join(dir, file)) && i < 100; i += 1) {
+          file = `${CONFIG_BACKUP_PREFIX}${stamp}-${i}.json`;
+        }
+        copyFileSync(src, join(dir, file));
+        // 备份里是明文密码/设备私钥：POSIX 上 0600；Windows 显式收紧 ACL（mode 是空操作）
+        try { chmodSync(join(dir, file), 0o600); } catch { /* 非关键 */ }
+        try { hardenFile(join(dir, file)); } catch { /* 非关键 */ }
+        sources[source] = file;
+      } catch { /* 单个落点失败：另一份仍然有效（relayDir 只读/磁盘满等情况） */ }
+    }
+    if (!Object.keys(sources).length) return { ok: false, reason: "failed" }; // 两份都失败：静默返回
+    pruneConfigBackups(relayDir);
+    // 日志只写文件名与时间（两份各列出，便于排查到底哪一份没写成）
+    const names = CONFIG_BACKUP_SOURCES.filter((s) => sources[s]).map((s) => `${s}:${sources[s]}`).join("、");
+    appendLogLine(relayDir, AUTO_INSTALL_LOG,
+      `[dsh-remote-web] 已备份配对配置 ${names}（${fmtLocalTime(at)}，权限 600；内容不写入日志）`);
+    const preferred = sources.profile ? `profile:${sources.profile}` : `relay:${sources.relay}`;
+    return { ok: true, at, name: preferred, sources };
+  } catch {
+    return { ok: false, reason: "failed" }; // 备份失败静默：绝不影响安装/登录
+  }
+}
+
+/**
+ * 从备份恢复配对配置。**只能由用户在面板里显式触发**（绝不自动调用 —— 旧账号备份可能是
+ * 别人的/已失效的，误用会把设备绑到错误账号）。
+ * 恢复前先把当前配置再备份一份（同时写两份），失败静默。
+ * @param {string} relayDir
+ * @param {string} [name] `profile:<file>` / `relay:<file>` / 裸文件名（兼容旧状态）；省略 = 最新一份
+ * @returns {{ok:boolean, restored?:string, source?:string, at?:number, reason?:string}}
+ */
+function restoreConfigBackup(relayDir, name = "") {
+  try {
+    const list = listConfigBackups(relayDir);
+    if (!list.length) return { ok: false, reason: "no-backup" };
+    // ⚠️ 只接受**列表里真实存在**的文件名（防路径穿越/任意文件读）
+    const target = findConfigBackup(relayDir, name);
+    if (!target) return { ok: false, reason: "no-such-backup" };
+    const src = join(configBackupDirOf(relayDir, target.source), target.file);
+    if (existsSync(configPathOf(relayDir))) backupConfigFile(relayDir); // 恢复前先备份当前状态（可回滚）
+    mkdirSync(relayDir, { recursive: true });
+    copyFileSync(src, configPathOf(relayDir));
+    try { chmodSync(configPathOf(relayDir), 0o600); } catch { /* 非关键 */ }
+    try { hardenFile(configPathOf(relayDir)); } catch { /* 非关键 */ }
+    appendLogLine(relayDir, AUTO_INSTALL_LOG,
+      `[dsh-remote-web] 用户一键恢复配对配置：${target.name}`
+      + `（来自${CONFIG_BACKUP_SOURCE_TEXT[target.source] || target.source}，备份时间 ${fmtLocalTime(target.at)}；内容不写入日志）`);
+    return { ok: true, restored: target.name, source: target.source, at: target.at };
+  } catch {
+    return { ok: false, reason: "failed" };
+  }
+}
+
+/** 运行时本体是否在：`<relayDir>/clients`（插件自带 runtime/ 自愈补装的就是它）。 */
+function runtimeDirPresent(relayDir) {
+  try { return existsSync(join(relayDir, "clients")); } catch { return false; }
+}
+
+/** 配对信息是否在：`<relayDir>/.dsh-config.json`（账号密码 + 设备密钥）。 */
+function configPresent(relayDir) {
+  try { return existsSync(configPathOf(relayDir)); } catch { return false; }
+}
+
+/**
+ * 安装/配对自检（对外状态的核心）：明确区分「运行时缺失」与「配对缺失」。
+ *
+ * kind：ok | runtime_missing | pairing_missing | all_missing | uninstalled
+ * text：面向非技术用户的一句话结论（面板直接展示；旧客户端也可从 connect.detail 看到）
+ * @returns {{kind:string, runtimePresent:boolean, configPresent:boolean, text:string, detail:string,
+ *            relayDir:string, backup:null|{available:boolean,name:string,at:number,text:string,action:object}}}
+ */
+function setupStateOf(relayDir) {
+  const rt = runtimeDirPresent(relayDir);
+  const cfg = configPresent(relayDir);
+  // 两份来源合并（新→旧；时间相同 profile 先）。只要任一份存在就能恢复 ——
+  // 这正是「整个 ~/.dsh-remote 被删、但 profile 持久目录那份还在」时的救命路径。
+  const backups = listConfigBackups(relayDir);
+  const latest = backups[0] || null;
+  const backup = (!cfg && latest)
+    ? {
+        available: true,
+        name: latest.name,      // profile:<file> / relay:<file>（来源可区分）
+        source: latest.source,  // profile | relay
+        at: latest.at,
+        // 两份都在时把清单也带上（面板/诊断可以显示"还有哪一份"）；仍不含任何凭据内容
+        sources: backups.map((b) => ({ name: b.name, at: b.at })),
+        text: `检测到历史配对备份（${fmtLocalTime(latest.at) || "时间未知"}，`
+          + `${CONFIG_BACKUP_SOURCE_TEXT[latest.source] || latest.source}），可一键恢复`,
+        action: {
+          kind: "restore_config",
+          method: "POST",
+          path: "/dsh-remote/config/restore",
+          body: { backup: latest.name },
+        },
+      }
+    : null;
+  const base = { runtimePresent: rt, configPresent: cfg, relayDir, backup };
+
+  // 已彻底卸载：不再提示"重新安装"（那是用户自己的选择；重启宿主后自然回到未安装状态）
+  if (UNINSTALLED_DIRS.has(relayDir)) {
+    return { ...base, kind: "uninstalled", text: "", detail: "本插件已彻底卸载（配置与运行时已清理）" };
+  }
+
+  const RUNTIME_TEXT = "运行环境缺失：需要重新安装（应用内插件页重装或 npx @mrrisega/dsh-remote@latest）";
+  const PAIRING_TEXT = "未配对：需要在面板里登录一次（账号密码），登录后会自动重建运行环境并启动 bridge";
+  const runtimeDetail = () => {
+    const inst = installStateOf(relayDir);
+    if (inst.installing) return "插件正在后台用自带的运行环境自动补装（无需操作）；若 1~2 分钟后仍缺失，请按上面方式重新安装。";
+    return "插件会在下一轮状态查询时自动尝试用自带的运行环境补装；若补装失败，请按上面方式重新安装。";
+  };
+  const pairingDetail = () => (backup
+    ? `登录会重新生成配对信息；也可以先点「恢复历史配对备份」（${fmtLocalTime(latest.at) || "时间未知"}）再用旧配对。`
+    : "登录是唯一会写入配对信息的入口：插件绝不自动填入任何凭据。");
+
+  if (!rt && !cfg) {
+    return { ...base, kind: "all_missing", text: RUNTIME_TEXT + "\n" + PAIRING_TEXT,
+      detail: runtimeDetail() + " " + pairingDetail() };
+  }
+  if (!rt) {
+    return { ...base, kind: "runtime_missing", text: RUNTIME_TEXT, detail: runtimeDetail() };
+  }
+  if (!cfg) {
+    return { ...base, kind: "pairing_missing", text: PAIRING_TEXT, detail: pairingDetail() };
+  }
+  return { ...base, kind: "ok", text: "", detail: "" };
+}
+
 // ---------- Harness 浏览器会话代持(0.1.2-rc.1+ 的 ?token 鉴权) ----------
 
 /**
@@ -1764,6 +2067,7 @@ function ensureRuntime(relayDir) {
   if (local.ok) {
     appendLogLine(relayDir, AUTO_INSTALL_LOG,
       `[dsh-remote-web] 已用插件自带的运行环境就地补齐（v${PLUGIN_VERSION}，本地拷贝，未使用 npx）`);
+    backupConfigFile(relayDir); // 安装完成后备份配对信息（文件不存在则静默跳过；内容绝不写日志）
     telemetryRuntimeReady(relayDir);
     return true;
   }
@@ -1845,6 +2149,7 @@ function ensureRuntime(relayDir) {
       appendLogLine(relayDir, AUTO_INSTALL_LOG, `[auto-install] npx 退出 code=${code ?? "?"}`);
       if (code === 0 && runtimeReady(relayDir)) {
         noteProvisionSuccess(relayDir);
+        backupConfigFile(relayDir); // 安装完成后备份配对信息（无配置/失败都静默）
         telemetryRuntimeReady(relayDir); // 退出码 0 ≠ 装好了
       } else {
         // 退出码非 0、卡住超时、或退出码 0 但安装脚本没落盘（装到一半/装错包）→ 都算失败并进入退避
@@ -3386,6 +3691,10 @@ async function composeStatus(relayDir) {
     // 是否需要重启 DeepSeek harness（首次安装 / 在线更新后必须重启才加载插件本体）：
     // {pending, kind: first-install|update, reason, at}，供面板顶部醒目提示 + 重启按钮。
     restart: readRestartState(relayDir),
+    // 安装/配对自检（2026-10-17 事故）：运行时（clients/）与配对（.dsh-config.json）是否齐全、
+    // 缺什么、下一步该做什么；配对主配置缺失但备份存在时给出可一键恢复的 backup.action。
+    // 字段契约见 setupStateOf；connect.setup 是同一份对象（bridge-status 短轮询也能拿到）。
+    setup: setupStateOf(relayDir),
     // 连接阶段（登录后自动闭环：环境 → bridge 进程 → 设备已在中继注册）：
     // 面板用它显示「正在准备运行环境…/正在启动 Bridge…/正在连接中继…/已连接 ✅」，
     // 并用 /dsh-remote/bridge-status 以 2~3s 短轮询自动推进（无需用户点按钮或刷新页面）。
@@ -4447,6 +4756,10 @@ function uninstallSelf(relayDir, profileDir, patchFile, pkgFile) {
       rmSync(join(profileDir, `${id}-plugin`), { recursive: true, force: true });
       rmSync(join(profileDir, "node_modules", id), { recursive: true, force: true });
     }
+    // 第二份配对备份住在 profile 的独立数据目录（2026-10-17 双份加固）：里面是账号密码/设备私钥，
+    // 「彻底卸载」必须一起清掉 —— 否则卸载后仍留着凭据副本，且重装后还会提示恢复一个
+    // 用户已经明确不要了的旧账号配对。
+    rmSync(join(profileDir, PROFILE_DATA_DIR), { recursive: true, force: true });
     out.removedDir = true;
   } catch { /* ignore */ }
   return out;
@@ -4897,6 +5210,13 @@ async function composeConnect(relayDir, opts = {}) {
   const elapsed = book.lastAttemptAt ? now - book.lastAttemptAt : wait;
   const autoRetrying = phase !== "online" && phase !== "no_account" && retryable !== false;
   const nextRetryInMs = autoRetrying ? Math.max(0, wait - elapsed) : 0;
+  // 【2026-10-17 事故】把「安装/配对自检」结论作为独立字段下发：`~/.dsh-remote` 被误删后，
+  // 面板以前只能显示模糊的「未运行/准备中」，用户不知道该重装还是该重新登录。
+  // 只在**需要用户动手**的状态把结论前置到 detail（运行时缺失但插件正在自动补装时仍由既有
+  // no_runtime/installing 文案说明进度，不制造"需要重装"的误导）。
+  const setup = setupStateOf(relayDir);
+  const setupNeedsUser = setup.kind === "all_missing" || setup.kind === "pairing_missing";
+  if (setupNeedsUser) detail = detail ? setup.text + "\n" + detail : setup.text;
   const conn = {
     phase,
     online: phase === "online",
@@ -4941,6 +5261,10 @@ async function composeConnect(relayDir, opts = {}) {
     nextRetryInMs,
     error,
     bindError: bindFresh && bindError ? { code: bindError.code || "", message: bindError.message || "" } : null,
+    // 安装/配对自检（2026-10-17）：kind/text/backup.action 见 setupStateOf 的长注释。
+    // 面板据此显示「运行环境缺失：需要重新安装…」「未配对：需要在面板里登录一次…」
+    // 以及「检测到历史配对备份（时间），可一键恢复」。
+    setup,
     logPath: join(relayDir, BRIDGE_LOG_FILE),
     installLogPath: join(relayDir, AUTO_INSTALL_LOG),
   };
@@ -5179,7 +5503,21 @@ function ensureConnection(relayDir, opts = {}) {
   const now = Date.now();
   if (!opts.force && book.lastAttemptAt && now - book.lastAttemptAt < connectBackoffMs(book.attempts)) return null;
   const cfg = loadConfig(relayDir);
-  if (!hasAccountCreds(cfg)) return null; // 未登录：不补装也不拉服务，先让用户登录
+  if (!hasAccountCreds(cfg)) {
+    // 【2026-10-17 事故】旧规则「未登录 → 不补装也不拉服务」在**运行时**上必须放宽：
+    // 运行时与配对信息都住在 ~/.dsh-remote 里，用户整目录被删后，登录前 ensureRuntime 一次都不会跑，
+    // 于是「登录后自动完成剩余步骤」的第一步就永远缺失。现在：运行时缺失就先复用既有 ensureRuntime
+    // 从插件自带 runtime/ 本地补齐（零网络）；**配对信息仍然只能由用户登录重建**，
+    // 绝不自动填入任何账号/密码（安全边界），也绝不因为有备份就自动恢复旧配对。
+    if (!runtimeReady(relayDir)) {
+      if (installStateOf(relayDir).stale) clearStaleInstallMarker(relayDir);
+      book.lastAttemptAt = now;
+      book.attempts += 1;
+      ensureRuntime(relayDir);
+      return { action: "provision" };
+    }
+    return null; // 运行时已就绪但未登录：不拉服务，先让用户登录
+  }
   if (!runtimeReady(relayDir)) {
     if (installStateOf(relayDir).stale) clearStaleInstallMarker(relayDir);
     book.lastAttemptAt = now;
@@ -6412,17 +6750,9 @@ export function localRequestBlocked(req) {
 }
 
 function registerRoutes(ctx, relayDir) {
-  // 本插件所在 profile(由插件自身文件位置推导,覆盖市场 git 安装与本地 include 两种形态)
-  let profileDir = join(homedir(), ".dsh", "profiles", "web");
-  try {
-    const here = fileURLToPath(import.meta.url);
-    // 依次尝试两种安装布局（当前名优先，历史名兜底）；split()[0] 未命中时返回原串，需显式判断后再试下一种
-    let m = here.split("/dsh-remote-web-plugin/")[0];
-    if (m === here) m = here.split("/node_modules/dsh-remote-web/")[0];
-    if (m === here) m = here.split("/dsh-remote-ui-plugin/")[0];
-    if (m === here) m = here.split("/node_modules/dsh-remote-ui/")[0];
-    if (m !== here) profileDir = m;
-  } catch { /* 保持默认 */ }
+  // 本插件所在 profile：与配对备份的持久数据目录共用同一份推导（pluginProfileDir），
+  // 避免"卸载删的目录"和"备份写的目录"各算各的（2026-10-17 双份备份加固时抽出）。
+  const profileDir = pluginProfileDir();
   const routes = [
     // 自管理：版本信息 / 检查更新 / 一键更新 / 更新日志 / 彻底卸载
     {
@@ -6900,6 +7230,9 @@ function registerRoutes(ctx, relayDir) {
         // 账号/模式变化 → 先停掉旧 bridge 并作废它的注册证据，否则新账号永远等不到这台设备
         const accountFpBefore = accountFingerprintOf(loadConfig(relayDir));
         saveConfig(relayDir, cfg);
+        // 配对成功即备份（2026-10-17 事故）：.dsh-config.json 里是账号配对+设备密钥，
+        // 一旦被误删/写坏，用户可以一键恢复最近一份（不自动恢复，见 setupStateOf）。
+        backupConfigFile(relayDir);
         invalidateRelayToken(relayDir); // 账号可能变了：丢弃旧 token 缓存，立即用新账号认证
         if (accountFingerprintOf(cfg) !== accountFpBefore) resetBridgeForAccountChange(relayDir, "账号/模式已变更");
         const bridgeRestart = startBridge(relayDir);
@@ -6908,6 +7241,43 @@ function registerRoutes(ctx, relayDir) {
         sendJson(res, 200, { ok: true, bridgeRestart, ...(await composeStatus(relayDir)) });
       },
     },
+    {
+      /**
+       * 一键恢复历史配对备份（2026-10-17 事故）。
+       *
+       * 只在用户**显式点击**时调用：绝不自动恢复 —— 旧备份可能是别人的账号/已失效的凭据，
+       * 自动套用会把这台设备绑到错误账号（比"未配对"更糟）。恢复前 restoreConfigBackup 会先把
+       * 当前配置再备份一份（若存在），所以这一步随时可回滚。
+       * body = {} → 恢复最新一份；body = { backup: "<文件名>" } → 恢复指定一份。
+       */
+      method: "POST",
+      path: "/dsh-remote/config/restore",
+      handler: async (req, res) => {
+        const body = await readJsonBody(req);
+        if (body.__parseError) return sendJson(res, 400, { ok: false, error: "JSON 解析失败" });
+        const backupName = typeof body.backup === "string" ? body.backup : "";
+        const restored = restoreConfigBackup(relayDir, backupName);
+        if (!restored.ok) {
+          const msg = restored.reason === "no-backup" || restored.reason === "no-such-backup"
+            ? "没有可恢复的配对备份（备份目录为空或文件名不存在）"
+            : "恢复配对备份失败（磁盘不可写/文件损坏），请重新登录一次";
+          return sendJson(res, restored.reason === "failed" ? 500 : 404, { ok: false, code: restored.reason, error: msg });
+        }
+        // 恢复的可能是旧账号的配对：与"登录"同一套收尾 —— 旧 token 作废、旧 bridge 停掉重拉。
+        invalidateRelayToken(relayDir);
+        resetBridgeForAccountChange(relayDir, "从历史备份恢复配对信息");
+        const bridgeRestart = startBridge(relayDir);
+        // 恢复成功本身就是一次配对状态写入 → 让最新备份也指向它（保留时间线）
+        backupConfigFile(relayDir);
+        sendJson(res, 200, {
+          ok: true,
+          restored: restored.restored,
+          restoredAt: restored.at,
+          bridgeRestart,
+          ...(await composeStatus(relayDir)),
+        });
+      },
+    },
     {
       method: "POST",
       path: "/dsh-remote/logout",
@@ -7531,4 +7901,16 @@ export { pinBrowseDirectoryPicker as __pinBrowseDirectoryPicker, schedulePickerP
   linuxSystemdUnitState as __linuxSystemdUnitState,
   selfhealRestartGate as __selfhealRestartGate, noteSelfhealRestart as __noteSelfhealRestart,
   noteSelfhealBlocked as __noteSelfhealBlocked, resetSelfhealGuard as __resetSelfhealGuard,
-  selfhealGuardOf as __selfhealGuardOf, SELFHEAL_MAX_RESTARTS as __SELFHEAL_MAX_RESTARTS };
+  selfhealGuardOf as __selfhealGuardOf, SELFHEAL_MAX_RESTARTS as __SELFHEAL_MAX_RESTARTS,
+  // 2026-10-17 事故：安装/配对自检 + 配对备份/恢复。见 test/repair-backup.test.mjs
+  // （用例必须把 relayDir 指向 mkdtemp 临时目录、HOME 指向假目录，绝不能在真实
+  //   ~/.dsh-remote 或真实 ~/.dsh 上做写入测试）。
+  setupStateOf as __setupStateOf, ensureConnection as __ensureConnection,
+  backupConfigFile as __backupConfigFile, listConfigBackups as __listConfigBackups,
+  restoreConfigBackup as __restoreConfigBackup, runtimeDirPresent as __runtimeDirPresent,
+  CONFIG_BACKUP_KEEP as __CONFIG_BACKUP_KEEP, CONFIG_BACKUP_DIR as __CONFIG_BACKUP_DIR,
+  pruneConfigBackups as __pruneConfigBackups,
+  // 双份备份（relayDir + profile 独立数据目录）的落点/推导/卸载清理都要能被行为级单测钉住
+  configBackupDirOf as __configBackupDirOf, pluginProfileDir as __pluginProfileDir,
+  listConfigBackupsIn as __listConfigBackupsIn, uninstallSelf as __uninstallSelf,
+  PROFILE_DATA_DIR as __PROFILE_DATA_DIR, PROFILE_BACKUP_SUBDIR as __PROFILE_BACKUP_SUBDIR };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-web",
-  "version": "0.7.2-beta.1",
+  "version": "0.7.2",
   "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/runtime/clients/dsh-remote/mobile-adapter.mjs

@@ -554,6 +554,67 @@ div.dsh-ma-menu .dsh-ma-load-warn[hidden] { display: none !important; }
 div.dsh-ma-menu .dsh-ma-load-warn .ico { flex: none; }
 div.dsh-ma-menu .dsh-ma-load-warn .txt { min-width: 0; overflow-wrap: anywhere; }
 
+/* ===== 加载疑似卡住时的**可操作**底部提示条（2026-10-17 事故新增） =====
+   事故现场：用户本机 ~/.dsh-remote（bridge 运行时 + 账号配对信息/设备密钥）被误删 → bridge 起不来、
+   手机端镜像页第一次加载**干等 47 秒**才报错；页面上只有悬浮菜单里一行"已等 N 秒…复制给客服"，
+   没有任何可点的操作。这里补一条**底部轻量提示条**（不是全屏层、不遮挡主界面）：
+     · 只在 12 秒看门狗判定 slow 之后才**懒创建**（解析期一个节点都不往页面塞）；
+     · 只占视口底部一条、高度受限（max-height），浮层外的区域照常可点 → 用户还能继续操作；
+     · 三个按钮：重试 / 返回设备列表 / 复制诊断信息，外加 ✕ 关闭；关掉后本页不再弹；
+     · 认出官方界面后自动收起（判断错了也不会一直挂着）——失败方向仍然安全：
+       最坏只是底部多一条**可关闭**的提示，而不是"永远盖住整片界面"。
+   动画只在「支持 prefers-reduced-motion 且用户没要求减少动效」时挂上：
+   老浏览器不认识这个媒体查询 → 不匹配 → 无动画（无需用 matchMedia 判断，也不会有兼容异常）。 */
+div.dsh-ma-loadbar {
+  position: fixed;
+  left: max(10px, env(safe-area-inset-left));
+  right: max(10px, env(safe-area-inset-right));
+  bottom: calc(10px + env(safe-area-inset-bottom));
+  /* 低于 FAB(400) 与菜单(401)：提示条不得压住"自救出口"（悬浮按钮永远点得到） */
+  z-index: 399;
+  display: flex; flex-wrap: wrap; align-items: center; gap: 8px;
+  box-sizing: border-box;
+  width: auto;
+  max-height: min(38vh, 260px);
+  overflow-y: auto;
+  -webkit-overflow-scrolling: touch;
+  padding: 10px 12px;
+  border-radius: 12px;
+  background: var(--dsw-alias-bg-elevated, #fff);
+  border: .5px solid var(--dsw-alias-border-l3, rgba(127,127,127,.3));
+  box-shadow: 0 6px 24px rgba(0,0,0,.24);
+  color: var(--dsw-alias-label-primary, #111);
+  font: 400 13px/1.5 -apple-system, system-ui, sans-serif;
+}
+/* ⚠️ 必须显式写 [hidden]：UA 的 [hidden]{display:none} 会被上面的 display:flex 盖过（本仓踩过）。 */
+div.dsh-ma-loadbar[hidden] { display: none !important; }
+div.dsh-ma-loadbar .dsh-ma-loadbar-txt { flex: 1 1 160px; min-width: 0; overflow-wrap: anywhere; }
+div.dsh-ma-loadbar .dsh-ma-loadbar-actions { display: flex; flex-wrap: wrap; gap: 6px; }
+div.dsh-ma-loadbar button {
+  flex: none; padding: 8px 12px; border-radius: 9px; cursor: pointer;
+  border: .5px solid var(--dsw-alias-border-l3, rgba(127,127,127,.35));
+  background: var(--dsw-alias-button-elevated-fill, rgba(127,127,127,.08));
+  color: var(--dsw-alias-label-primary, #111);
+  font: 600 13px/1 -apple-system, system-ui, sans-serif;
+  touch-action: manipulation; -webkit-tap-highlight-color: transparent;
+}
+div.dsh-ma-loadbar button:active { transform: scale(.98); }
+div.dsh-ma-loadbar button.dsh-ma-loadbar-close {
+  padding: 6px 9px; border-color: transparent; background: transparent;
+  color: var(--dsw-alias-label-tertiary, #6b7280);
+}
+@media (prefers-reduced-motion: no-preference) {
+  div.dsh-ma-loadbar { animation: dsh-ma-loadbar-in .18s ease-out; }
+  @keyframes dsh-ma-loadbar-in {
+    from { opacity: 0; transform: translateY(6px); }
+    to { opacity: 1; transform: none; }
+  }
+}
+/* 双保险：显式要求减少动效时一律无动画（老浏览器不匹配上面的 no-preference → 天然无动画） */
+@media (prefers-reduced-motion: reduce) {
+  div.dsh-ma-loadbar { animation: none !important; transition: none !important; }
+}
+
 /* 会话过期引导条:镜像页在会话过期后只会"连不上"，这里给一句能照做的话 + 一个出口。
    非阻塞(顶部细条)，点关闭即消失；不拦截任何请求。 */
 div.dsh-ma-sessionbar {
@@ -656,21 +717,33 @@ const SCRIPT = `(() => {
     }
   })();
 
-  /* ===== 「加载疑似没完成」看门狗（2026-09-25，替代被整块删除的首屏提示层）=====
-     那个提示层是全屏覆盖 + 启发式退出 —— 判断错一次就把**已经加载完**的界面永久盖住
-     （用户实测：秒表走到 187 秒，刷新也一样）。所以这里换一条**安全的失败方向**：
+  /* ===== 「加载疑似没完成」看门狗（2026-09-25 起；2026-10-17 提速并改成**可操作**提示）=====
+     历史：0.6.14 的首屏提示层是全屏覆盖 + 启发式退出 —— 判断错一次就把**已经加载完**的界面永久盖住
+     （用户实测：秒表走到 187 秒，刷新也一样）。所以 0.6.16 换了安全的失败方向：只置 slow 标记，
+     在**已有的**悬浮菜单里多一行字。这个方向本身是对的，但**提示太晚、且没有操作入口**——
+     2026-10-17 真实事故：用户本机 ~/.dsh-remote（运行时 + 账号配对信息/设备密钥）被误删后，
+     手机端镜像页第一次加载**干等 47 秒**才报错，页面上只有一行"已等 N 秒…复制给客服"，
+     用户完全不知道该重新安装还是重新登录。
 
-       · 解析期**不创建任何 DOM**（只有几个变量 + 一个定时器）—— 页面还没过主机门，
+     现在（2026-10-17）：
+       · 解析期仍然**不创建任何 DOM**（只有几个变量 + 一个定时器）—— 页面还没过主机门，
          更不该有任何覆盖层；
-       · 25 秒后仍认不出官方界面 → 只置一个 slow 标记，**不往页面塞任何东西**；
-       · 标记生效时，往**已有的**「远程控制」悬浮菜单里多一行字（点一下复制一句话给客服），
-         并建议点菜单里本来就有的「返回设备列表」重来；
-       · 判断错了的代价 = 菜单里多一行字（用户不点开菜单完全看不到）；不会再挡住任何人。
-
-     ⚠️ 刻意**不**做成页面顶部/底部的固定细条：那种细条同样会盖住官方 UI 的一部分，
-        而且同样有"永不消失"的失败方向。菜单是被动展开的，天然没有这个问题。 */
+       · **12 秒**后仍认不出官方界面 → 置 slow + 显示**底部轻量提示条**（懒创建）：
+         文案「电脑端可能未连接 / 页面加载较慢」+ 已等待秒数；
+         按钮：重试（location.reload）/ 返回设备列表（/app/）/ 复制诊断信息 / ✕ 关闭；
+       · 提示条**不是全屏层**：只占底部一条、高度受限、浮层外照常可点、可关闭，
+         关掉后本页不再弹；认出官方界面后自动收起 —— 失败方向仍然安全；
+       · 菜单里那一行字**保留**（被动展开，不打扰，也仍可复制诊断话术）。
+
+     ⚠️ 12 秒是"开始提示"的阈值，不是"判定失败"：限速放开后正常首屏 1~3 秒，
+        12 秒既能及时帮到用户，也不至于刚打开就吓人（宁可晚一点，也别误报）。
+     ⚠️ 注入体是模板字符串：本段注释/文案**一律用「」**，不得出现反引号。 */
   var maLoadWatch = { startedAt: Date.now(), slow: false, wired: false, bound: false, warnEl: null, warnTxt: null,
-                      reported: false, reportMs: 0 };
+                      reported: false, reportMs: 0,
+                      // 2026-10-17：底部可操作提示条（barEl = 懒创建的节点；barTimer = 秒数刷新）
+                      barEl: null, barTxt: null, barTimer: 0, dismissed: false };
+  /** 看门狗阈值（毫秒）：12 秒仍认不出官方界面就开始提示。测试按常量断言，不要散落魔法数。 */
+  var MA_LOAD_WATCH_MS = 12 * 1000;
   /** 官方界面是否已经可用（只看最强信号；只用于决定"要不要多显示一行字"）。 */
   function maLoadReadyNow() {
     try {
@@ -718,8 +791,8 @@ const SCRIPT = `(() => {
    *   ② **全程静默**：任何异常都吞掉，失败绝不影响页面，也绝不做重试；
    *   ③ 只在**已有的**同一批请求之外发这一次（一次 POST，几十字节），不是测速、不轮询。
    * body = { ms, outcome, at }：ms=耗时毫秒（截到 [0,600000]，与契约一致）；outcome ∈ {ok,slow}
-   * （slow = 25 秒看门狗兜底，是"删失下限"，后台只把 ok 计入 P50/P90）；at=事件发生的 epoch ms。
-   */
+   * （slow = 12 秒看门狗兜底，是"删失下限"，后台只把 ok 计入 P50/P90）；at=事件发生的 epoch ms。
+   * ⚠️ 2026-10-17：阈值 25s→12s，**字段与一次语义一律不变**（后台契约不动）。 */
   function maReportMirrorLoad(outcome) {
     if (maLoadWatch.reported) return;
     maLoadWatch.reported = true;
@@ -748,10 +821,140 @@ const SCRIPT = `(() => {
     try { ua = String((navigator && navigator.userAgent) || "").slice(0, 120); } catch (e) { /* 忽略 */ }
     return "dsh-remote 手机端加载疑似卡住：等待 " + maLoadWaitedSec() + " 秒后仍未出现对话界面。UA=" + ua;
   }
+
+  /* ===== 底部可操作提示条（2026-10-17，见上方看门狗注释）=====
+     纪律：
+       · **懒创建**：只有 slow 且用户没关过时才创建节点；
+       · **绝不阻塞**：只占底部一条（CSS 限高），浮层外照常可点；按钮动作全部就地完成；
+       · **任何异常都吞掉**：提示层坏掉也绝不影响页面（每个入口都有 try/catch）；
+       · **只提示一次**：用户点 ✕ 后 dismissed=true，本页不再弹（不骚扰）。 */
+  /** 提示条主文案：电脑端未连接/加载慢 + 已等待秒数（秒数由 barTimer 每秒刷新）。 */
+  function maLoadBarText() {
+    return "电脑端可能未连接 / 页面加载较慢（已等待 " + maLoadWaitedSec() + " 秒）";
+  }
+  /** 收起提示条并停掉秒数刷新（不改变 dismissed：用于"认出界面后自动收起"这类临时收起）。 */
+  function maLoadHideBar() {
+    try { if (maLoadWatch.barEl) maLoadWatch.barEl.hidden = true; } catch (e) { /* 忽略 */ }
+    try {
+      if (maLoadWatch.barTimer) { clearInterval(maLoadWatch.barTimer); maLoadWatch.barTimer = 0; }
+    } catch (e2) { /* 忽略 */ }
+  }
+  /** 用户点 ✕：本页不再弹（dismissed 是**本页**语义；刷新页面会重新开始一次提示机会）。 */
+  function maLoadDismissBar() {
+    try {
+      maLoadWatch.dismissed = true;
+      maLoadHideBar();
+      maLoadRenderWarn(); // 菜单里那一行也一起收起（关闭 = 本页只提示一次）
+    } catch (e) { /* 忽略 */ }
+  }
+  /** 导航（返回设备列表）：assign 失败退回 href。 */
+  function maLoadGoto(to) {
+    try { window.location.assign(to); return; } catch (e) { /* 继续 */ }
+    try { window.location.href = to; } catch (e2) { /* 忽略 */ }
+  }
+  /** 复制诊断信息（沿用 maLoadCopyLine：含 UA 与耗时）；剪贴板不可用时把整句显示在提示条上让用户截图。 */
+  function maLoadCopyDiag() {
+    var line = maLoadCopyLine();
+    var show = function (t) {
+      try { if (maLoadWatch.barTxt) maLoadWatch.barTxt.textContent = t; } catch (e) { /* 忽略 */ }
+    };
+    try {
+      if (navigator && navigator.clipboard && navigator.clipboard.writeText) {
+        var p = navigator.clipboard.writeText(line);
+        if (p && typeof p.then === "function") {
+          p.then(function () { show("已复制诊断信息（含等待时长与机型），可直接发给客服。"); },
+                 function () { show(line); });
+          return;
+        }
+      }
+    } catch (e) { /* 落到显示 */ }
+    show(line);
+  }
+  /** 懒创建提示条（只在 slow 之后调用；解析期绝不碰 DOM）。 */
+  function maLoadMountBar() {
+    try {
+      if (maLoadWatch.barEl || maLoadWatch.dismissed) return maLoadWatch.barEl;
+      var body = document.body || document.documentElement;
+      if (!body || !body.appendChild) return null;
+      var bar = document.createElement("div");
+      bar.className = "dsh-ma-loadbar";
+      /* role=status + aria-live=polite：读屏软件会把"加载较慢"念出来，但不会抢焦点；
+         它**不是** dialog/alert，不抢键盘、不锁滚动。 */
+      bar.setAttribute("role", "status");
+      bar.setAttribute("aria-live", "polite");
+      bar.innerHTML =
+        '<div class="dsh-ma-loadbar-txt" data-role="loadbar-txt"></div>' +
+        '<div class="dsh-ma-loadbar-actions">' +
+          '<button type="button" class="dsh-ma-loadbar-btn" data-role="loadbar-retry">重试</button>' +
+          '<button type="button" class="dsh-ma-loadbar-btn" data-role="loadbar-back">返回设备列表</button>' +
+          '<button type="button" class="dsh-ma-loadbar-btn" data-role="loadbar-copy">复制诊断信息</button>' +
+        '</div>' +
+        '<button type="button" class="dsh-ma-loadbar-close" data-role="loadbar-close" aria-label="关闭提示">✕</button>';
+      bar.hidden = true;
+      maLoadWatch.barEl = bar;
+      maLoadWatch.barTxt = bar.querySelector('[data-role="loadbar-txt"]');
+      bar.addEventListener("click", function (ev) {
+        // 事件委托：真实浏览器里目标可能是按钮内的文字节点；从 target 往上找到 [data-role]
+        try {
+          if (ev && typeof ev.preventDefault === "function") ev.preventDefault();
+        } catch (e0) { /* 忽略 */ }
+        try {
+          var t = ev && ev.target ? ev.target : null;
+          var role = "";
+          var guard = 0;
+          while (t && t !== bar && guard < 16 && !role) {
+            guard += 1;
+            try {
+              if (t.getAttribute) role = String(t.getAttribute("data-role") || "");
+            } catch (e1) { role = ""; }
+            t = t.parentNode || null;
+          }
+          if (role === "loadbar-retry") {
+            try { window.location.reload(); } catch (e2) { /* 忽略 */ }
+          } else if (role === "loadbar-back") {
+            maLoadGoto("/app/"); // 绝对路径：镜像页当前路径可能是 /remote/<deviceId>/…
+          } else if (role === "loadbar-copy") {
+            maLoadCopyDiag();
+          } else if (role === "loadbar-close") {
+            maLoadDismissBar();
+          }
+        } catch (e3) { /* 提示条失败绝不影响页面 */ }
+      });
+      body.appendChild(bar);
+      return bar;
+    } catch (e) { return null; }
+  }
+  /** 按当前状态渲染提示条（slow + 未关闭 → 显示；否则收起）。 */
+  function maLoadRenderBar() {
+    try {
+      if (!maLoadWatch.slow || maLoadWatch.dismissed) { maLoadHideBar(); return; }
+      var bar = maLoadWatch.barEl || maLoadMountBar();
+      if (!bar) return;
+      if (maLoadWatch.barTxt) maLoadWatch.barTxt.textContent = maLoadBarText();
+      bar.hidden = false;
+      if (!maLoadWatch.barTimer) {
+        // 每秒刷新「已等待 N 秒」；同时复核"是不是其实早就好了"——好了就自动收起（不长期挂着）。
+        maLoadWatch.barTimer = setInterval(function () {
+          try {
+            if (!maLoadWatch.slow || maLoadWatch.dismissed) { maLoadHideBar(); return; }
+            if (maLoadReadyNow()) {
+              maLoadWatch.slow = false;
+              maLoadHideBar();
+              maLoadRenderWarn(); // 菜单那一行也一起收起
+              return;
+            }
+            if (maLoadWatch.barTxt) maLoadWatch.barTxt.textContent = maLoadBarText();
+          } catch (e) { /* 忽略 */ }
+        }, 1000);
+        try { if (maLoadWatch.barTimer && maLoadWatch.barTimer.unref) maLoadWatch.barTimer.unref(); } catch (e2) { /* 忽略 */ }
+      }
+    } catch (e) { /* 提示条失败绝不影响页面 */ }
+  }
   function maLoadRenderWarn() {
     try {
       if (!maLoadWatch.warnEl) return;
-      if (!maLoadWatch.slow) { maLoadWatch.warnEl.hidden = true; return; }
+      // 用户点过 ✕ = 本页不想再被这事打扰：菜单里那一行也一起收起（"只提示一次"）
+      if (!maLoadWatch.slow || maLoadWatch.dismissed) { maLoadWatch.warnEl.hidden = true; return; }
       if (maLoadWatch.warnTxt) {
         maLoadWatch.warnTxt.textContent = "本次页面可能没加载完整（已等 " + maLoadWaitedSec()
           + " 秒）。点这里复制一句话发给客服，或点下方「返回设备列表」重来。";
@@ -785,18 +988,18 @@ const SCRIPT = `(() => {
       }
     } catch (e) { /* 忽略 */ }
   }
-  // 25 秒后仍认不出官方界面 → 置慢标记（**只改状态，不碰 DOM**）。
-  // 阈值取得很宽松：宁可漏报（什么都不显示，与今天一致），也不要误报吓人。
-  // 同一处顺手把 mirror_load 的**兜底样本**发出去（outcome="slow"）：25 秒没就绪的页面上报的
-  // 必然是"≥25 秒"，这是**删失下限**而不是真实耗时，后台只把它单列，不混进 P50/P90。
+  // 12 秒后仍认不出官方界面 → 置慢标记 + 懒创建底部提示条（**只在这时才碰 DOM**）。
+  // 同一处顺手把 mirror_load 的**兜底样本**发出去（outcome="slow"）：12 秒没就绪的页面上报的
+  // 必然是"≥12 秒"，这是**删失下限**而不是真实耗时，后台只把它单列，不混进 P50/P90。
   setTimeout(function () {
     try {
       if (maLoadReadyNow()) return;
       maLoadWatch.slow = true;
       if (maLoadWatch.wired) maLoadRenderWarn();
+      maLoadRenderBar(); // 底部可操作提示条（重试 / 返回设备列表 / 复制诊断 / 关闭）
       maReportMirrorLoad("slow");
     } catch (e) { /* 忽略 */ }
-  }, 25 * 1000);
+  }, MA_LOAD_WATCH_MS);
 
   try {
     const HOST_RE = new RegExp(${JSON.stringify(RUNTIME_HOST_RE.source)});
@@ -2511,13 +2714,24 @@ const SCRIPT = `(() => {
       maObserver = null;
       try { if (maInterval) clearInterval(maInterval); } catch (eD2) { /* 忽略 */ }
       maInterval = 0;
+      // 加载提示条的秒数刷新也一起停掉（页面卸载/进 bfcache 后不留悬挂回调）
+      try { if (maLoadWatch.barTimer) { clearInterval(maLoadWatch.barTimer); maLoadWatch.barTimer = 0; } } catch (eD3) { /* 忽略 */ }
     };
     try { window.addEventListener("pagehide", maTeardown); } catch (ePh) { /* 忽略 */ }
     try { window.addEventListener("unload", maTeardown); } catch (eUl) { /* 忽略 */ }
     /* 手机上"切到别的 App 再切回来"走的常是 bfcache:pagehide(persisted=true) → pageshow(persisted=true)。
-       DOM 原样保留但计时器/观察者已断 —— 这里重新武装,否则回到页面后看门狗就永久失灵了。 */
+       DOM 原样保留但计时器/观察者已断 —— 这里重新武装,否则回到页面后看门狗就永久失灵了。
+       2026-10-17：加载提示条的秒数刷新也在 maTeardown 里停了，回到前台要按现状重新挂上
+       （否则用户切回来看的是"冻结的已等待 N 秒"）。 */
     try {
-      window.addEventListener("pageshow", (ev) => { try { if (ev && ev.persisted) maArm(); } catch (ePs) { /* 忽略 */ } });
+      window.addEventListener("pageshow", (ev) => {
+        try {
+          if (ev && ev.persisted) {
+            maArm();
+            if (maLoadWatch.slow && !maLoadWatch.dismissed) maLoadRenderBar();
+          }
+        } catch (ePs) { /* 忽略 */ }
+      });
     } catch (ePs2) { /* 忽略 */ }
   } catch (e) { if (window.console) console.warn("[dsh-mobile-adapter]", e && e.message); }
 })();`;