@mrrisega/dsh-remote 0.6.0-beta.9 → 0.6.0

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

@@ -5,13 +5,20 @@
 // factory 内只能 require shell 种子模块（react / react/jsx-runtime 等）。
 //
 // 功能：
-//   - settings.section：设置页「远程访问」栏目（位于「Agent 预设」下方，官方扩展点）
+//   - 双入口（2026-09 恢复侧栏注入，与官方共存不遮挡）：
+//       ① 官方「设置」→「远程访问」栏目（settings.section，位于「Agent 预设」下方，官方扩展点）；
+//       ② 左侧官方「设置」按钮旁注入独立「📱 远程访问」快捷按钮（id=dru-nav-remote，非 clone，
+//          插在其前方、同布局不覆盖官方按钮；点击直达该栏目，首次带引导红点）
 //   - 栏目内联渲染配置面板（浅色高对比 UI，遵循主流登录体验）
 //     · 登录态：已登录显示账号 + 退出登录；未登录显示 登录/注册 tabs
+//     · 🔒 修改密码（账号卡）：已登录账号经 图形验证码+短信验证码 重置（/dsh-remote/password/reset 代理）；
+//       成功后全部已授权设备/会话失效 → 本地登出并提示用新密码重新登录（覆盖本机 config 密码）
+//     · 忘记密码（登录卡）：未登录时登录表单内「忘记密码？」→ 同一套
+//       图形验证码+短信验证码 表单（手机号预填当前输入、可改），成功后本地登出并提示「请用新密码登录」
 //     · 登录要求图形验证码；注册要求两次密码 + 图形验证码
 //     · 📱 远程访问卡：一次性访问密钥（扫码/直接打开/复制 + 到期倒计时自动刷新）与已授权设备管理
 //     · bridge 状态与启停开关 + 关于 dsh-remote 说明卡片
-//   - 首次安装引导：设置页栏目旁小红点（localStorage dsh-remote-seen-dot 控制）
+//   - 首次安装引导：设置页「远程访问」栏目（官方导航 navCell）旁小红点（localStorage dsh-remote-seen-dot 控制）
 //   - shell.overlay：满意度弹窗（安装体验至少 1 小时后弹出，只弹一次）
 // 所有数据经同源 /dsh-remote/* 宿主路由读写（node 半提供）。
 window.__ModuleLoader__.load({
@@ -61,6 +68,8 @@ window.__ModuleLoader__.load({
       ".dru-btn-ghost:hover:not(:disabled){background:#f6f8fa}",
       ".dru-btn-danger{background:#ffffff;color:#cf222e;border-color:#cf222e}",
       ".dru-btn-danger:hover:not(:disabled){background:#fff0f1}",
+      ".dru-linkbtn{display:inline-block;padding:0;border:none;background:none;color:#0969da;font-size:12.5px;line-height:1.6;cursor:pointer;font-family:inherit;text-decoration:none}",
+      ".dru-linkbtn:hover{text-decoration:underline}",
       ".dru-tabs{display:flex;gap:8px;margin-bottom:12px}",
       ".dru-tab{flex:1;padding:7px 0;text-align:center;border-radius:8px;cursor:pointer;font-size:13px;font-weight:600;color:#57606a;background:#f6f8fa;border:1px solid #d0d7de;user-select:none}",
       ".dru-tab.active{color:#0969da;background:#ffffff;border-color:#0969da}",
@@ -149,175 +158,14 @@ window.__ModuleLoader__.load({
       // Phase-5:端到端加密(E2EE)状态行 —— 启用=绿字绿点,未启用=灰字(纯文字状态行,不打扰)
       ".dru-e2ee-line{display:flex;align-items:center;gap:7px;margin-top:6px;font-size:12px;line-height:1.5;color:#57606a}",
       ".dru-e2ee-line.ok{color:#1a7f37}",
-      // 左下角「远程访问」快捷小手机图标（安装后常驻；首次点击前带红点）
-      ".dru-fab{position:fixed;left:18px;bottom:18px;z-index:2147482100;width:46px;height:46px;border-radius:50%;background:#0969da;color:#fff;border:none;display:flex;align-items:center;justify-content:center;font-size:22px;line-height:1;box-shadow:0 6px 18px rgba(0,0,0,.28);cursor:pointer;font-family:inherit;padding:0}",
-      ".dru-fab:hover{background:#0860bd}",
-      ".dru-fab-dot{position:absolute;top:2px;right:2px;width:9px;height:9px;border-radius:50%;background:#e5484d;box-shadow:0 0 0 2px #fff;pointer-events:none}",
+      // 侧栏「远程访问」快捷按钮(2026-09 恢复注入,与官方「设置」按钮共存不遮挡):
+      // 独立 button(非 clone),插在官方「设置」按钮之前,同源同布局不覆盖官方热区。
+      ".dru-nav-remote{display:inline-flex;align-items:center;gap:6px;height:30px;margin:0 0 2px;padding:0 10px;border:1px solid #d0d7de;border-radius:8px;background:#ffffff;color:#0969da;font:500 12.5px/1 inherit;cursor:pointer;white-space:nowrap;user-select:none}",
+      ".dru-nav-remote:hover:not(:disabled){background:#f0f6ff;border-color:#0969da}",
+      ".dru-nav-remote-dot{position:absolute;top:-2px;right:-2px;width:8px;height:8px;border-radius:50%;background:#e5484d;box-shadow:0 0 0 2px #fff;pointer-events:none}",
     ].join("\n");
     document.head.appendChild(styleEl);
 
-    // ── 侧边栏「远程访问」快捷入口（挂到官方设置按钮上方一行，用 dsh 自身的挂载位） ──
-    // 不用 fixed 悬浮层（会遮挡官方按钮）；改为在左侧主菜单的「设置」按钮上方克隆一行同款导航项：
-    // 点击 = 打开 设置页 → 「远程访问」栏目；首次点击前该入口右上角带小红点（localStorage 一次）。
-    // 导航命中策略（兼容宿主差异）：候选 = [class*=navCell] / [role=tab] / [role=menuitem] /
-    // [aria-label]（纯图标项常只有 aria-label 可读）；文本优先取 aria-label，再取 textContent，
-    // 因此 emoji/图标前缀（如 🖥/📱）不影响子串命中。命中「远程访问」栏目项后打 data-dru-remote
-    // 标记（同一设置页生命周期内二次命中直接走标记，无需重扫）。始终排除本插件注入的侧栏项
-    // （id=dru-nav-remote），避免点到自己造成递归。
-    var NAV_SEEN_KEY = "dsh-remote-nav-seen";
-    var NAV_ENTRY_ID = "dru-nav-remote";
-    var NAV_MARK = "data-dru-remote";
-    var NAV_CAND_SEL = '[class*="navCell"], [role="tab"], [role="menuitem"], [aria-label]';
-    var NAV_ANY_SEL = 'button, a, [role="button"], [class*="nav"] button, [class*="sidebar"] a';
-
-    /** 元素导航文本：优先 aria-label（纯图标导航常见），再拼 textContent；去空白差异。 */
-    function navTextOf(el) {
-      var t = "";
-      try {
-        var al = el.getAttribute && el.getAttribute("aria-label");
-        if (al) t += " " + al;
-      } catch (e) {}
-      try { if (el.textContent) t += " " + el.textContent; } catch (e2) {}
-      return t.replace(/\s+/g, " ").trim();
-    }
-    /** 候选是否“可点导航项”：按钮/链接/tab/menuitem/navCell（排除无交互的装饰容器）。 */
-    function isNavClickable(el) {
-      try {
-        var tag = String(el.tagName || "").toLowerCase();
-        if (tag === "button" || tag === "a") return true;
-        var role = el.getAttribute && el.getAttribute("role") || "";
-        if (role === "tab" || role === "menuitem" || role === "button" || role === "link") return true;
-        return String(el.className || "").indexOf("navCell") !== -1;
-      } catch (e) { return false; }
-    }
-    /** 在候选列表里找文本含 token 的导航项并返回（命中「远程访问」时打标记）。 */
-    function pickNavHit(nodes, token, excludeId, preferMarked) {
-      try {
-        for (var i = 0; i < nodes.length; i++) {
-          var el = nodes[i];
-          if (excludeId && el.id === excludeId) continue; // 排除注入项自身，防递归
-          if (!isNavClickable(el)) continue;
-          var marked = !!el.getAttribute && el.getAttribute(NAV_MARK) === "1";
-          if (preferMarked && !marked) continue;
-          if (!preferMarked && marked) continue;
-          if (navTextOf(el).indexOf(token) === -1) continue;
-          if (token === "远程访问") { try { el.setAttribute(NAV_MARK, "1"); } catch (e) {} }
-          return el;
-        }
-      } catch (e) { /* 忽略 */ }
-      return null;
-    }
-    /**
-     * 点击“文本含 token”的导航项：① 已打 data-dru-remote 标记的（远程栏目）优先；
-     * ② [class*=navCell]/[role=tab]/[role=menuitem]/[aria-label] 语义候选；
-     * ③ 任意按钮/链接兜底。全部失败返回 false（调用方决定是否退化进「设置」）。
-     */
-    function clickNavToken(token, excludeId) {
-      try {
-        if (token === "远程访问") {
-          var all = document.querySelectorAll(NAV_CAND_SEL + ", " + NAV_ANY_SEL);
-          var hit = pickNavHit(all, token, excludeId, true);
-          if (hit) { try { hit.click(); } catch (e) {} return true; }
-        }
-        var sem = document.querySelectorAll(NAV_CAND_SEL);
-        var hit2 = pickNavHit(sem, token, excludeId, false);
-        if (hit2) { try { hit2.click(); } catch (e) {} return true; }
-        var any = document.querySelectorAll(NAV_ANY_SEL);
-        var hit3 = pickNavHit(any, token, excludeId, false);
-        if (hit3) { try { hit3.click(); } catch (e) {} return true; }
-      } catch (e) { /* 忽略 */ }
-      return false;
-    }
-    /** 「远程访问」栏目内容区是否已在 DOM（设置页已选中该栏目）。 */
-    function remoteSectionVisible() {
-      try {
-        var el = document.querySelector(".dru-settings-section");
-        return !!el && (!document.body || document.body.contains(el));
-      } catch (e) { return false; }
-    }
-    /**
-     * 打开设置页「远程访问」栏目（侧栏注入项/面板内“去设置”等共用入口）：
-     * 已在栏目内容区 → 不动；否则先找栏目项直接点；点不到 → 点「设置」进设置页，
-     * 再轮询（栏目项异步挂载）补点「远程访问」。全程排除注入项自身防递归。
-     */
-    function openRemoteSettings() {
-      if (remoteSectionVisible()) return;
-      if (clickNavToken("远程访问", NAV_ENTRY_ID)) return;
-      clickNavToken("设置", NAV_ENTRY_ID); // 进设置页（导航文字可能不同名/纯图标，交给命中器）
-      var tries = 0;
-      var iv = setInterval(function () {
-        if (remoteSectionVisible() || clickNavToken("远程访问", NAV_ENTRY_ID)) { clearInterval(iv); return; }
-        if (++tries > 40) clearInterval(iv);
-      }, 150);
-      if (typeof iv.unref === "function") iv.unref();
-    }
-    // 暴露给宿主/自动化（同一入口，避免重复实现；测试沙箱经此驱动点击流）
-    try { window.__dshRemoteNav = { open: openRemoteSettings }; } catch (e) {}
-
-    function injectSidebarRemoteEntry() {
-      try {
-        if (document.getElementById(NAV_ENTRY_ID)) return;
-        if (!document.body) { setTimeout(injectSidebarRemoteEntry, 300); return; }
-        var tries = 0;
-        var iv = setInterval(function () {
-          try {
-            if (document.getElementById(NAV_ENTRY_ID)) { clearInterval(iv); return; }
-            // 在左侧主导航找「设置」按钮：语义候选优先，文本开头为“设置”或 aria-label 恰为“设置”
-            // （兼容文字不同名/带 emoji 图标的情况：能读到的标识仍是“设置”）。
-            var nodes = document.querySelectorAll(NAV_CAND_SEL + ", " + NAV_ANY_SEL);
-            var settingsBtn = null;
-            for (var i = 0; i < nodes.length; i++) {
-              var el = nodes[i];
-              if (el.id === NAV_ENTRY_ID) continue;
-              if (!isNavClickable(el)) continue;
-              var label = (el.getAttribute && el.getAttribute("aria-label")) || "";
-              var t = (el.textContent || "").trim();
-              var hit = label === "设置" || label.indexOf("设置") === 0 ||
-                t === "设置" || t.indexOf("设置") === 0 || t.indexOf("设置 ") === 0;
-              if (!hit) continue;
-              settingsBtn = el;
-              break;
-            }
-            if (!settingsBtn || !settingsBtn.parentNode) {
-              if (++tries > 80) clearInterval(iv);
-              return;
-            }
-            var entry = settingsBtn.cloneNode(false);
-            entry.id = NAV_ENTRY_ID;
-            entry.removeAttribute("data-view");
-            entry.removeAttribute("href");
-            entry.textContent = "";
-            entry.setAttribute("role", "button");
-            entry.setAttribute("tabindex", "0");
-            entry.setAttribute("aria-label", "远程访问");
-            entry.textContent = "📱 远程访问";
-            var seen = false;
-            try { seen = !!localStorage.getItem(NAV_SEEN_KEY); } catch (e) {}
-            if (!seen) {
-              var dot = document.createElement("span");
-              dot.style.cssText = "position:absolute;top:4px;right:10px;width:8px;height:8px;border-radius:50%;background:#e5484d;pointer-events:none";
-              entry.style.position = "relative";
-              entry.appendChild(dot);
-            }
-            entry.addEventListener("click", function () {
-              try { localStorage.setItem(NAV_SEEN_KEY, "1"); } catch (e) {}
-              var d = entry.querySelector("span[style]");
-              if (d && /background:#e5484d/.test(d.getAttribute("style") || "")) d.remove();
-              openRemoteSettings();
-            });
-            settingsBtn.parentNode.insertBefore(entry, settingsBtn); // 设置在入口下方
-            clearInterval(iv);
-          } catch (e) { /* 忽略单次失败,继续重试 */ }
-        }, 300);
-        if (typeof iv.unref === "function") iv.unref();
-      } catch (e) { /* 非关键 */ }
-    }
-    if (document.readyState === "loading") {
-      document.addEventListener("DOMContentLoaded", injectSidebarRemoteEntry);
-    } else {
-      setTimeout(injectSidebarRemoteEntry, 600);
-    }
-
     // ── 首次安装引导小红点（设置页「远程访问」栏目，localStorage 控制） ────
     // 无 dsh-remote-seen-dot key 视为首次：在设置页导航栏目右上角显示 CSS 圆点；
     // 点击栏目/红点后写入 key（之后不再显示），重启 DSH Web 不复发。
@@ -381,6 +229,104 @@ window.__ModuleLoader__.load({
       dotScan();
     }
 
+    // ── 侧栏「远程访问」快捷按钮（2026-09 恢复注入：与官方「设置」按钮共存、不遮挡） ──
+    // 用户要求：左侧官方「设置」按钮旁保留「远程访问」入口。实现为独立 <button id=dru-nav-remote>
+    // （绝不 clone 官方按钮 → 不继承官方事件委托/点击热区），插在官方「设置」按钮之前；
+    // 点击 → 打开官方设置页「远程访问」栏目。全程不点工作区会话内容：
+    //   - 候选一律限定为官方导航（class 含 navCell / 位于导航容器内）+ 短文本/aria 精确匹配；
+    //   - 命中排除自身与“菜单/更多”语义节点；
+    //   - 栏目未开时先点官方「设置」，再轮询(≤3s)补点「远程访问」栏目项。
+    var NAV_ENTRY_ID = "dru-nav-remote";
+    var NAV_TEXT_MAX = 10;
+    var NAV_POLL_MAX = 20;
+    var NAV_BAD_RE = /(^|[^a-z0-9])(menu|context|more|kebab|dropdown|popover|toolbar)($|[^a-z0-9])/i;
+    function navCleanText(el) { try { return (el.textContent || "").replace(/\s+/g, " ").trim(); } catch (e) { return ""; } }
+    function navAttrOf(el) {
+      try { return String(el.getAttribute("aria-label") || el.getAttribute("title") || "").trim(); } catch (e) { return ""; }
+    }
+    function navCellLike(el) {
+      try {
+        var cls = String(el.className || "");
+        if (cls.indexOf("navCell") !== -1) return true;
+        return !!el.closest('[role="navigation"], nav, [class*="sidebar" i], [class*="sidenav" i], [class*="appnav" i], [class*="navRail" i]');
+      } catch (e) { return false; }
+    }
+    function pickNavByToken(token) {
+      try {
+        var els = document.querySelectorAll("button, [role='tab'], [role='menuitem'], [role='button'], a, [aria-label]");
+        for (var i = 0; i < els.length; i++) {
+          var el = els[i];
+          if (!el || el.id === NAV_ENTRY_ID) continue; // 排除注入按钮自身(防递归)
+          if (!navCellLike(el)) continue;
+          if (NAV_BAD_RE.test(String(el.className || ""))) continue;
+          var t = navCleanText(el);
+          if (t && !/\r|\n/.test(t) && t.length <= NAV_TEXT_MAX &&
+              (t === token || t.indexOf(token) === 0 || t.indexOf(token) !== -1)) return el;
+          var at = navAttrOf(el);
+          if (at && (at === token || at.indexOf(token) === 0)) return el;
+        }
+      } catch (e) { /* 忽略 */ }
+      return null;
+    }
+    /** 打开「远程访问」设置栏目：栏目已渲染直接点；否则先点官方「设置」再 ≤3s 轮询补点。 */
+    function openRemoteSettings() {
+      try {
+        var cell = pickNavByToken("远程访问");
+        if (cell) { cell.click(); return; }
+        var st = pickNavByToken("设置");
+        if (!st) return;
+        st.click();
+        var tries = 0;
+        var iv = setInterval(function () {
+          tries++;
+          var c2 = pickNavByToken("远程访问");
+          if (c2) { clearInterval(iv); c2.click(); }
+          else if (tries >= NAV_POLL_MAX) clearInterval(iv);
+        }, 150);
+      } catch (e) { /* 忽略 */ }
+    }
+    /** 注入侧栏按钮到官方「设置」按钮之前（独立 button；首次未见过引导红点）。 */
+    function mountNavEntry(host) {
+      try {
+        if (document.getElementById(NAV_ENTRY_ID)) return;
+        var wrap = host && host.parentNode;
+        if (!wrap || !wrap.insertBefore || !wrap.contains) return;
+        var btn = document.createElement("button");
+        btn.type = "button";
+        btn.id = NAV_ENTRY_ID;
+        btn.className = "dru-nav-remote";
+        btn.setAttribute("data-dru-remote", "1");
+        btn.title = "打开「远程访问」设置(快捷入口)";
+        btn.style.position = "relative";
+        btn.textContent = "📱 远程访问";
+        btn.addEventListener("click", function (e) {
+          try { e.stopPropagation(); e.preventDefault(); } catch (err) {}
+          dotMarkSeen(); // 用过快捷入口=已了解入口位置 → 关闭首次红点(含官方栏目红点)
+          openRemoteSettings();
+        });
+        wrap.insertBefore(btn, host);
+        if (!dotSeen()) {
+          var d = document.createElement("span");
+          d.className = "dru-nav-remote-dot";
+          btn.appendChild(d);
+        }
+      } catch (e) { /* 忽略 */ }
+    }
+    /** 常驻确保：官方「设置」按钮出现后在它前面挂一次入口(去重；2s 心跳，成本极低)。 */
+    function navEnsureStart() {
+      if (window.__dshRemoteNavStarted) return;
+      window.__dshRemoteNavStarted = true;
+      try { window.__dshRemoteNav = { open: openRemoteSettings }; } catch (e) {}
+      var iv = setInterval(function () {
+        try {
+          if (document.getElementById(NAV_ENTRY_ID)) return; // 已注入
+          var host = pickNavByToken("设置");
+          if (host) mountNavEntry(host);
+        } catch (e) { /* 忽略 */ }
+      }, 2000);
+      try { if (iv && typeof iv.unref === "function") iv.unref(); } catch (e) {} // node 测试环境不阻塞退出
+    }
+
     // ── 宿主 API ────────────────────────────────────────────────────────────
     function api(path, options) {
       return fetch(path, options).then(function (res) {
@@ -419,6 +365,10 @@ window.__ModuleLoader__.load({
     var FB_THREADS_KEY = "dsh-feedback-threads";
     var FB_POPUP_KEY = "dsh-feedback-popup";
     var FB_POPUP_DELAY_MS = 60 * 60 * 1000;   // 安装/体验后至少 1 小时才弹窗(只弹一次)
+    // 评价去重(2026-09):弹窗状态按「账号(掩码手机号)或设备」分作用域 —— 换账号/换机不重复打扰;
+    // 服务端另有 user_id/device_id 409 already_rated 兜底(同一账号/设备只收集一次 rating)。
+    var fbPopScope = "anon";
+    function setFbPopScope(scope) { fbPopScope = String(scope || "anon"); }
     var FB_CATEGORIES = [
       { value: "feature", label: "功能类" },
       { value: "bug", label: "Bug 类" },
@@ -445,10 +395,17 @@ window.__ModuleLoader__.load({
       try { localStorage.removeItem(FB_THREADS_KEY); } catch (e) {}
     }
     function fbPopState() {
-      try { return JSON.parse(localStorage.getItem(FB_POPUP_KEY) || "null"); } catch (e) { return null; }
+      try { return JSON.parse(localStorage.getItem(FB_POPUP_KEY + ":" + fbPopScope) || "null"); } catch (e) { return null; }
     }
     function fbSavePopState(s) {
-      try { localStorage.setItem(FB_POPUP_KEY, JSON.stringify(s)); } catch (e) {}
+      try { localStorage.setItem(FB_POPUP_KEY + ":" + fbPopScope, JSON.stringify(s)); } catch (e) {}
+    }
+    /** 作用域清理:旧版无作用域键也一并视为已完成,避免老用户再次被打扰。 */
+    function fbClearPopScope(scopes) {
+      try {
+        localStorage.removeItem(FB_POPUP_KEY); // 兼容旧键(无后缀)
+        if (Array.isArray(scopes)) scopes.forEach(function (sc) { localStorage.removeItem(FB_POPUP_KEY + ":" + sc); });
+      } catch (e) {}
     }
 
     /** 同源反馈代理调用（浏览器 → /dsh-remote/feedback/* → 独立反馈服务）。 */
@@ -574,7 +531,7 @@ window.__ModuleLoader__.load({
           category: cat,
           title: fbTitle.trim(),
           content: fbContent.trim(),
-          contact: contact.trim() || (cfg && cfg.phone ? cfg.phone : ""),
+          contact: contact.trim() || ((cfg && cfg.phone && cfg.phone.indexOf("*") === -1) ? cfg.phone : ""),
         };
         fbApi("/feedback", { method: "POST", body: JSON.stringify(payload) })
           .then(function (b) {
@@ -829,6 +786,7 @@ window.__ModuleLoader__.load({
           .catch(function (e) {
             var errBody = e.body && e.body.error;
             if (errBody && errBody.code === "rate_limited") { fbPopupLater(); setMessage({ kind: "err", text: "今日提交已达上限，明天再来吧" }); }
+            else if (errBody && errBody.code === "already_rated") { fbPopupDone(); setMessage({ kind: "ok", text: "你已评价过，感谢支持（同一账号/设备只收集一次）" }); }
             else setMessage({ kind: "err", text: "提交失败：" + ((errBody && errBody.message) || e.message) + "（可稍后再试）" });
           })
           .finally(function () { setBusy(""); });
@@ -1133,6 +1091,14 @@ window.__ModuleLoader__.load({
       var armedDevArr = useState(null); var armedDev = armedDevArr[0]; var setArmedDev = armedDevArr[1]; // 待二次确认的 session id（取消配对）
       var armedDelArr = useState(null); var armedDel = armedDelArr[0]; var setArmedDel = armedDelArr[1]; // 待二次确认的 session id（删除记录）
       var purgeArmedArr = useState(false); var purgeArmed = purgeArmedArr[0]; var setPurgeArmed = purgeArmedArr[1]; // 清理已解绑二次确认
+      // ── 🔒 修改密码（已登录 SaaS，短信重置）状态：放在全部既有字段之后，保持既有 hook 序号 ──
+      // 成功后企业端使该账号全部授权设备/会话失效（含 E2EE 派生口令）→ 本地登出、用新密码重新登录。
+      var pwdOpenArr = useState(false); var pwdOpen = pwdOpenArr[0]; var setPwdOpen = pwdOpenArr[1];   // 小表单展开
+      var pwdCapArr = useState(null); var pwdCap = pwdCapArr[0]; var setPwdCap = pwdCapArr[1];          // {id,svg} 图形验证码
+      var pwdCapTxtArr = useState(""); var pwdCapTxt = pwdCapTxtArr[0]; var setPwdCapTxt = pwdCapTxtArr[1];
+      var pwdSmsArr = useState(""); var pwdSms = pwdSmsArr[0]; var setPwdSms = pwdSmsArr[1];
+      var pwdSmsBtnArr = useState("获取验证码"); var pwdSmsBtn = pwdSmsBtnArr[0]; var setPwdSmsBtn = pwdSmsBtnArr[1];
+      var pwdNewArr = useState(""); var pwdNew = pwdNewArr[0]; var setPwdNew = pwdNewArr[1];            // 新密码（≥8）
 
       var refresh = useCallback(function () {
         setBusy("status");
@@ -1172,15 +1138,17 @@ window.__ModuleLoader__.load({
 
       useEffect(function () { refresh(); }, [refresh]);
       useEffect(function () {
-        if (st !== null && !loggedIn && mode === "saas" && authTab === "login" && !lcap) loadCaptcha("login");
-      }, [st, loggedIn, mode, authTab, lcap]);
+        // 展开「忘记密码」重置表单时不用预载登录表单验证码（收起的 reset 表单用独立 pwdCap）
+        if (st !== null && !loggedIn && mode === "saas" && authTab === "login" && !pwdOpen && !lcap) loadCaptcha("login");
+      }, [st, loggedIn, mode, authTab, pwdOpen, lcap]);
 
       // ── 📱 远程访问卡：常量 / 轮询 / 一次性访问密钥 / 已授权设备 ─────────────────
       var KEY_AUTO_REFRESH_MS = 25000;  // 停留栏目时约每 25s 自动轮换一把新的一次性密钥（防已用/过期）
-      var STATUS_POLL_MS = 5000;        // 连接状态行轮询间隔
+      var STATUS_POLL_MS = 30000;       // 连接状态行轮询间隔(审计降频:原 5s→30s;页面隐藏时暂停)
 
       /** 轻量状态轮询：只更新 st，不改 mode（mode 由用户 Tab 选择决定，避免轮询把自建/云端来回切）。 */
       function pollStatus() {
+        if (document.hidden) return; // 页面隐藏时不空转(审计:降低请求频率)
         api("/dsh-remote/status").then(function (body) {
           if (!body || !body.ok) return;
           setSt(body);
@@ -1362,14 +1330,17 @@ window.__ModuleLoader__.load({
         }).finally(function () { setBusy(""); });
       };
 
-      // 停留主视图（home）时：每 5s 轻量轮询连接状态 + 每秒刷新倒计时
+      // 停留主视图（home）时：轮询连接状态(15s,审计降频) + 每秒刷新倒计时;隐藏暂停、回前台立即刷新
       useEffect(function () {
         if (view !== "home") return;
         var pollIv = setInterval(function () { pollStatus(); }, STATUS_POLL_MS);
         var tickIv = setInterval(function () { setNowTick(Date.now()); }, 1000);
+        var visFn = function () { if (!document.hidden) pollStatus(); };
+        document.addEventListener("visibilitychange", visFn);
         return function () {
           clearInterval(pollIv);
           clearInterval(tickIv);
+          document.removeEventListener("visibilitychange", visFn);
         };
       }, [view]);
 
@@ -1397,6 +1368,7 @@ window.__ModuleLoader__.load({
               return post("/dsh-remote/config", { phone: phone.trim(), password: pass }).then(function (cfg) {
                 // 切换连接账号（手机号与之前不同）：清除旧账号留下的反馈线程凭据
                 if (prevPhone !== phone.trim()) fbClearThreads();
+                setPwdOpen(false); // 登录成功（可能从「忘记密码」返回）→ 收起重置表单
                 setSt(cfg); setPass(""); setLcapTxt(""); setLcap(null);
                 setMsg("ok", "✅ 登录成功，账号已保存");
               });
@@ -1447,6 +1419,7 @@ window.__ModuleLoader__.load({
           .then(function (body) {
             if (body.ok || body.status === 201 || (body.body && body.body.token)) {
               return post("/dsh-remote/config", { phone: rphone.trim(), password: rpass }).then(function (cfg) {
+                setPwdOpen(false);
                 setSt(cfg);
                 setRphone(""); setRpass(""); setRpass2(""); setRsms(""); setRcap(null); setRcapTxt(""); setRInvite("");
                 setMsg("ok", "✅ 注册成功，已自动登录");
@@ -1468,12 +1441,115 @@ window.__ModuleLoader__.load({
           // 退出登录：清除本机保存的用户反馈线程凭据（thread_token 见 FB_THREADS_KEY），
           // 反馈历史保留在服务端（按账号校验），账号身份变化后本机不再可见旧线程。
           fbClearThreads();
+          setPwdOpen(false); // 退出登录后回到登录卡，收起重置/修改密码表单
           if (clearForm) { setPhone(""); setPass(""); setLcapTxt(""); setLcap(null); setRphone(""); setRpass(""); setRpass2(""); setRsms(""); setRsmsBtn("获取验证码"); setRcapTxt(""); setRcap(null); }
           setMessage(null);
         }).catch(function (e) { setMsg("err", "退出失败: " + e.message); })
           .finally(function () { setBusy(""); });
       };
 
+      // ---------- 🔒 修改密码 / 忘记密码（共用：短信验证码重置；企业端公开 POST /api/password/reset） ----------
+      // 图形验证码 + 短信验证码复用既有 /dsh-remote/captcha、/dsh-remote/sms-code 防刷路径；
+      // 新密码 ≥8 位。成功后企业端使全部授权设备/会话失效（含 E2EE 派生口令）→ 本地登出，
+      // 提示用新密码重新登录（登录成功会把新密码写回本地 config，覆盖旧口令并重建 E2EE 派生）。
+      // 两处入口共用同一组字段/函数（pwdOpen/pwdCap/pwdCapTxt/pwdSms/pwdSmsBtn/pwdNew 与
+      // togglePwdForm/sendPwdSms/doResetPwd/renderResetPwdForm，避免重复实现）：
+      //   - 账号卡「🔒 修改密码」：fromLogin=false，手机号以当前登录账号为准（只读）；
+      //   - 登录卡「忘记密码？」：fromLogin=true，手机号预填登录输入、可改；成功后请用新密码登录。
+      var PWD_RESET_WARN = "修改后所有已授权设备/会话将失效，需重新登录与解锁";
+
+      function pwdLoadCaptcha() {
+        setPwdCap({ id: null, svg: '<span class="dru-hint">加载中</span>' });
+        fetch("/dsh-remote/captcha").then(function (r) {
+          return r.text().then(function (text) {
+            if (!r.ok) throw new Error("http " + r.status);
+            var body = null; try { body = JSON.parse(text); } catch (e) { body = null; }
+            if (body && body.captcha_id) setPwdCap({ id: body.captcha_id, svg: body.svg || "" });
+            else if (body && body.svg) setPwdCap({ id: null, svg: body.svg });
+            else setPwdCap({ id: null, svg: null });
+          });
+        }).catch(function () { setPwdCap({ id: null, svg: null }); });
+      }
+      /** 展开/收起重置密码表单（账号卡「修改密码」与登录卡「忘记密码」共用开关）。 */
+      var togglePwdForm = function () {
+        var next = !pwdOpen;
+        setPwdOpen(next);
+        setMessage(null);
+        if (next && !pwdCap) pwdLoadCaptcha();
+      };
+      /** 发送短信验证码（图形验证码防刷；captcha_invalid → 重载验证码提示重试）。ph 由调用方给出：
+       * 账号卡=当前登录手机号；登录卡「忘记密码」=表单输入手机号。 */
+      var sendPwdSms = function (ph) {
+        ph = String(ph || "").trim();
+        // 账号卡改密(隐私契约):phone 为空 = 由服务端取本机账号真号发码;仅当显式填了非法号才报错
+        if (ph && !/^1\d{10}$/.test(ph)) { setMsg("err", "请输入正确的手机号"); return; }
+        if (!pwdCap || !pwdCap.id || !pwdCapTxt.trim()) { setMsg("err", "请输入图中验证码（点击图片可刷新）"); return; }
+        setBusy("pwd-sms");
+        post("/dsh-remote/sms-code", { phone: ph, captcha_id: pwdCap.id, captcha_answer: pwdCapTxt.trim() })
+          .then(function (body) {
+            var testCode = body && (body.test_code || (body.body && body.body.test_code));
+            setPwdCap(null); setPwdCapTxt(""); // 验证码一次性：发送后失效
+            if (testCode) setMsg("ok", "验证码已发送(测试码: " + testCode + ")");
+            else setMsg("ok", "验证码已发送");
+            var s = 60; setPwdSmsBtn(s + "s");
+            var t = setInterval(function () { s--; if (s <= 0) { clearInterval(t); setPwdSmsBtn("获取验证码"); } else setPwdSmsBtn(s + "s"); }, 1000);
+          })
+          .catch(function (e) {
+            var relayError = e.body && e.body.body && e.body.body.error;
+            if (relayError && relayError.code === "captcha_invalid") {
+              setPwdCapTxt(""); pwdLoadCaptcha();
+              setMsg("err", "发送次数较多，请输入图中验证码后重试");
+            } else setMsg("err", "发送失败: " + e.message);
+          })
+          .finally(function () { setBusy(""); });
+      };
+      /**
+       * 确认重置密码：POST /dsh-remote/password/reset → 成功后本地登出，提示用新密码登录。
+       * @param {string} ph - 手机号（账号卡=当前登录账号；登录卡「忘记密码」=表单输入）。
+       * @param {boolean} fromLogin - true=登录卡「忘记密码」；false=账号卡「修改密码」。
+       */
+      var doResetPwd = function (ph, fromLogin) {
+        ph = String(ph || "").trim();
+        if (ph && !/^1\d{10}$/.test(ph)) { setMsg("err", "请输入正确的手机号"); return; }
+        if (!ph && fromLogin) { setMsg("err", "请输入正确的手机号"); return; } // 登录卡忘记密码必须显式填号
+        if (!pwdSms.trim()) { setMsg("err", "请填写短信验证码"); return; }
+        if (pwdNew.length < 8) { setMsg("err", "新密码至少 8 位"); return; }
+        setBusy("pwd-reset");
+        post("/dsh-remote/password/reset", { phone: ph, sms_code: pwdSms.trim(), new_password: pwdNew })
+          .then(function (body) {
+            var ok = !!(body && (body.ok === true || (body.body && body.body.ok === true)));
+            if (!ok) {
+              var relayBody = (body && body.body) || body || {};
+              var errText = (relayBody.error && (relayBody.error.message || relayBody.error))
+                || relayBody.detail || ("修改失败(" + ((body && body.status) || "?") + ")");
+              setMsg("err", (fromLogin ? "重置失败：" : "修改失败：") + String(errText));
+              setPwdSms(""); // 短信验证码一次性：失败后需重新获取
+              return undefined;
+            }
+            // 成功：全部授权设备/会话已失效（含 E2EE）→ 本地登出清掉 config 旧口令与本地凭据，
+            // 提示用新密码重新登录（登录会把新口令写入 config 并重启 bridge / 重建 E2EE）。
+            setBusy("pwd-logout");
+            return post("/dsh-remote/logout").then(function (lb) {
+              setSt(lb); setAccount(null); setQuota(null);
+              setAkey(null); setAkeyMsg(null);
+              fbClearThreads();
+              setPwdOpen(false); setPwdSms(""); setPwdNew(""); setPwdCap(null); setPwdCapTxt(""); setPwdSmsBtn("获取验证码");
+              if (fromLogin) {
+                // 「忘记密码」成功：本机登出完成 → 回到登录表单提示用新密码登录（手机号保留，便于直接重登）
+                setPass(""); setLcapTxt(""); setLcap(null); loadCaptcha("login");
+                setMsg("ok", "✅ 密码已重置成功：" + PWD_RESET_WARN + "，本机已退出登录。请用新密码登录。");
+              } else {
+                setMsg("ok", "✅ 密码已修改成功：所有已授权设备与会话已失效，本机已退出登录。" +
+                  "请在下方账号卡用「新密码」重新登录——登录会更新本机保存的密码并重新启用端到端加密（E2EE）。");
+              }
+            }).catch(function (e) {
+              setMsg("err", "密码已" + (fromLogin ? "重置" : "修改") + "成功，但本机退出登录失败：" + e.message + "（建议手动「退出登录」后用新密码重新登录，以更新本机配置密码）");
+            });
+          })
+          .catch(function (e) { setMsg("err", (fromLogin ? "重置失败: " : "修改失败: ") + e.message); })
+          .finally(function () { setBusy(""); });
+      };
+
       var toggleBridge = function (start) {
         setBusy(start ? "start" : "stop");
         post(start ? "/dsh-remote/start" : "/dsh-remote/stop")
@@ -1492,6 +1568,7 @@ window.__ModuleLoader__.load({
           .then(function (body) {
             // 切换到自建服务（连接账号上下文变为本地无账号）：清除 SaaS 账号的反馈线程凭据
             fbClearThreads();
+            setPwdOpen(false);
             setSt(body); setSelfHost(""); setLocalKey("");
             setMsg(body.ok ? "ok" : "err", body.ok ? "✅ 已切换到自建服务，bridge 已重启" : (body.error || (body.body && body.body.error) || "保存失败"));
           })
@@ -1553,11 +1630,53 @@ window.__ModuleLoader__.load({
               busy === "upgrade" ? "生成链接中…" : (!isMember ? "🚀 升级 PRO" : source === "trial" ? "🚀 转正式 PRO" : "🔄 续费会员")),
             h("button", { type: "button", className: "dru-btn dru-btn-ghost", disabled: busy !== "", onClick: function () { setView("invite"); loadInvite(); } }, "🎯 邀请好友赚会员"),
             h("button", { type: "button", className: "dru-btn dru-btn-ghost", disabled: busy !== "", onClick: function () { setView("feedback"); } }, "💬 用户反馈"),
+            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); } }, "退出登录")
           ),
           h("div", { className: "dru-hint", style: { marginTop: 8 } },
             "升级/续费以带登录态方式打开：点击后生成一次性访问链接并直接跳转，无需重新登录。" +
-            (endsAt && isMember ? "到期后如需继续使用会员权益，请在到期前续费。" : ""))
+            (endsAt && isMember ? "到期后如需继续使用会员权益，请在到期前续费。" : "")),
+          pwdOpen ? renderResetPwdForm(false) : null
+        );
+      }
+
+      // ---------- 🔒 修改密码 / 忘记密码 共用重置表单（图形验证码 + 短信验证码 + 新密码≥8） ----------
+      // fromLogin=false：账号卡「修改密码」手机号以当前登录账号为准（只读）；
+      // fromLogin=true：登录卡「忘记密码」手机号预填登录输入、可改（成功后返回登录表单请用新密码登录）。
+      function renderResetPwdForm(fromLogin) {
+        // 隐私审计(2026-09):账号卡「修改密码」手机号只展示掩码;发送/重置时由服务端取本机账号真实号,
+        // 浏览器端不再出现明文手机号。登录卡「忘记密码」为用户自行输入,原样使用。
+        var curPhone = ((st && st.config && st.config.phone) || "");
+        var ph = fromLogin ? phone : "";
+        return h("div", { className: "dru-card", style: { marginTop: 10, border: "1px dashed #d0d7de" } },
+          h("h3", null, fromLogin ? "忘记密码（短信重置）" : "🔒 修改密码（短信验证）"),
+          h("div", { className: "dru-hint", style: { marginBottom: 8 } },
+            fromLogin
+              ? "手机号预填当前输入，可改为其它账号；" + PWD_RESET_WARN + "。"
+              : PWD_RESET_WARN + "（E2EE 用新密码重新派生）。"),
+          field("手机号", fromLogin
+            ? input({ type: "tel", value: ph, placeholder: "11 位手机号", autoComplete: "tel", onChange: function (e) { setPhone(e.target.value); } })
+            : h("input", { className: "dru-input", type: "tel", value: curPhone, disabled: true, readOnly: true, title: "以当前登录账号为准" })),
+          field("图形验证码", h("div", { className: "dru-captcha" },
+            input({ value: pwdCapTxt, placeholder: "图中数字", autoComplete: "off", inputMode: "numeric", maxLength: 6, onChange: function (e) { setPwdCapTxt(e.target.value); } }),
+            h("div", { className: "dru-captcha-box", title: "看不清？点击刷新", onClick: function () { pwdLoadCaptcha(); }, dangerouslySetInnerHTML: pwdCap && pwdCap.svg && pwdCap.svg.indexOf("<svg") === 0 ? { __html: pwdCap.svg } : void 0 },
+              pwdCap && pwdCap.svg && pwdCap.svg.indexOf("<svg") !== 0 ? pwdCap.svg : null)
+          )),
+          field("短信验证码", h("div", { className: "dru-captcha" },
+            input({ value: pwdSms, placeholder: "6 位验证码", autoComplete: "off", inputMode: "numeric", maxLength: 6, onChange: function (e) { setPwdSms(e.target.value); } }),
+            h("button", { type: "button", className: "dru-btn dru-btn-ghost", style: { flex: "none", padding: "0 14px" }, disabled: busy !== "", onClick: function () { sendPwdSms(ph); } }, pwdSmsBtn)
+          )),
+          field("新密码（至少 8 位）", input({ type: "password", value: pwdNew, minLength: 8, autoComplete: "new-password", placeholder: "至少 8 位", onChange: function (e) { setPwdNew(e.target.value); } })),
+          h("div", { className: "dru-hint", style: { marginBottom: 8 } },
+            fromLogin
+              ? "重置成功后本机会退出登录（如有已保存的旧账号），请用新密码登录。"
+              : "修改成功后，本机保存的旧密码会被清除并退出登录；请用新密码重新登录（登录会更新本机配置密码并重新启用远程访问与端到端加密）。"),
+          h("button", { type: "button", className: "dru-btn dru-btn-danger", style: { width: "100%" }, disabled: busy !== "", onClick: function () { doResetPwd(ph, fromLogin); } },
+            busy === "pwd-reset" ? "提交中…" : busy === "pwd-logout" ? "已重置，正在退出本地登录…" : (fromLogin ? "确认重置密码" : "确认修改密码")),
+          fromLogin
+            ? h("div", { style: { textAlign: "right", marginTop: 6 } },
+                h("button", { type: "button", className: "dru-linkbtn", onClick: function () { togglePwdForm(); } }, "← 返回登录"))
+            : null
         );
       }
 
@@ -1789,19 +1908,26 @@ window.__ModuleLoader__.load({
                   ? renderAccount()
                   : h("div", null,
                       h("div", { className: "dru-tabs" },
-                        h("div", { className: "dru-tab" + (authTab === "login" ? " active" : ""), onClick: function () { setAuthTab("login"); setMessage(null); } }, "登录"),
-                        h("div", { className: "dru-tab" + (authTab === "register" ? " active" : ""), onClick: function () { setAuthTab("register"); setMessage(null); } }, "注册")
+                        h("div", { className: "dru-tab" + (authTab === "login" ? " active" : ""), onClick: function () { setAuthTab("login"); setPwdOpen(false); setMessage(null); } }, "登录"),
+                        h("div", { className: "dru-tab" + (authTab === "register" ? " active" : ""), onClick: function () { setAuthTab("register"); setPwdOpen(false); setMessage(null); } }, "注册")
                       ),
                       authTab === "login"
-                        ? h("div", null,
-                            field("手机号", input({ type: "tel", value: phone, placeholder: "11 位手机号", autoComplete: "tel", onChange: function (e) { setPhone(e.target.value); } })),
-                            field("密码", input({ type: "password", value: pass, placeholder: "密码", autoComplete: "current-password", onChange: function (e) { setPass(e.target.value); } })),
-                            field("验证码", h("div", { className: "dru-captcha" },
-                              input({ value: lcapTxt, placeholder: "图中数字", autoComplete: "off", inputMode: "numeric", maxLength: 6, onChange: function (e) { setLcapTxt(e.target.value); } }),
-                              h("div", { className: "dru-captcha-box", title: "看不清？点击刷新", onClick: function () { loadCaptcha("login"); }, dangerouslySetInnerHTML: lcap && lcap.svg && lcap.svg.indexOf("<svg") === 0 ? { __html: lcap.svg } : void 0 },
-                                lcap && lcap.svg && lcap.svg.indexOf("<svg") !== 0 ? lcap.svg : null)
-                            )),
-                            h("button", { type: "button", className: "dru-btn dru-btn-primary", style: { width: "100%" }, disabled: busy !== "", onClick: doLogin }, busy === "login" ? "登录中…" : "登录")
+                        ? (pwdOpen
+                            // 「忘记密码」展开：与账号卡「修改密码」共用同一重置表单（手机号可编辑、预填登录输入）
+                            ? renderResetPwdForm(true)
+                            : h("div", null,
+                                field("手机号", input({ type: "tel", value: phone, placeholder: "11 位手机号", autoComplete: "tel", onChange: function (e) { setPhone(e.target.value); } })),
+                                field("密码", input({ type: "password", value: pass, placeholder: "密码", autoComplete: "current-password", onChange: function (e) { setPass(e.target.value); } })),
+                                field("验证码", h("div", { className: "dru-captcha" },
+                                  input({ value: lcapTxt, placeholder: "图中数字", autoComplete: "off", inputMode: "numeric", maxLength: 6, onChange: function (e) { setLcapTxt(e.target.value); } }),
+                                  h("div", { className: "dru-captcha-box", title: "看不清？点击刷新", onClick: function () { loadCaptcha("login"); }, dangerouslySetInnerHTML: lcap && lcap.svg && lcap.svg.indexOf("<svg") === 0 ? { __html: lcap.svg } : void 0 },
+                                    lcap && lcap.svg && lcap.svg.indexOf("<svg") !== 0 ? lcap.svg : null)
+                                )),
+                                h("button", { type: "button", className: "dru-btn dru-btn-primary", style: { width: "100%" }, disabled: busy !== "", onClick: doLogin }, busy === "login" ? "登录中…" : "登录"),
+                                // 忘记密码：小字入口，点击展开短信验证码重置表单（不抢占任何官方按钮）
+                                h("div", { style: { display: "flex", justifyContent: "flex-end", marginTop: 8 } },
+                                  h("button", { type: "button", className: "dru-linkbtn", disabled: busy !== "", onClick: togglePwdForm }, "忘记密码？"))
+                              )
                           )
                         : h("div", null,
                             field("手机号", input({ type: "tel", value: rphone, placeholder: "11 位手机号", autoComplete: "tel", onChange: function (e) { setRphone(e.target.value); } })),
@@ -1911,10 +2037,18 @@ window.__ModuleLoader__.load({
 
       // 首次安装引导小红点（localStorage dsh-remote-seen-dot；点击后不再显示）
       dotWatch();
+      // 侧栏「远程访问」快捷入口（2026-09 恢复注入：与官方「设置」按钮共存不遮挡）
+      navEnsureStart();
 
       // 满意度弹窗调度：首次观察到 bridge 运行（即“安装完成并体验”）后约 10 分钟弹出；
       // 每 60 秒复查一次，避免 dsh web 启动晚于到点时间。
+      // 弹窗状态按「账号/设备」分作用域(见 fbPopScope);旧版无后缀键视为已完成并迁移,不再打扰老用户。
+      var legacyPopState = null;
+      try { legacyPopState = JSON.parse(localStorage.getItem(FB_POPUP_KEY) || "null"); } catch (e) { legacyPopState = null; }
+      try { localStorage.removeItem(FB_POPUP_KEY); } catch (e) {}
       api("/dsh-remote/status").then(function (body) {
+        if (body && body.config) setFbPopScope(body.config.phone || body.config.deviceId || "anon");
+        if (legacyPopState && legacyPopState.state === "done") fbSavePopState({ state: "done", firstSeen: legacyPopState.firstSeen || Date.now(), nextAt: 0 });
         if (body && body.service && body.service.running) {
           fbEnsureFirstSeen();
           fbMaybeOpenPopup();
@@ -1925,6 +2059,7 @@ window.__ModuleLoader__.load({
         if (!s || s.state !== "pending") { clearInterval(popupTimer); return; }
         if (!fbFirstSeenAt) {
           api("/dsh-remote/status").then(function (body) {
+            if (body && body.config) setFbPopScope(body.config.phone || body.config.deviceId || "anon");
             if (body && body.service && body.service.running) {
               fbEnsureFirstSeen();
               fbMaybeOpenPopup();