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

package/package.json

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

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

@@ -159,55 +159,131 @@ window.__ModuleLoader__.load({
     // ── 侧边栏「远程访问」快捷入口（挂到官方设置按钮上方一行，用 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";
-    function clickTextNav(text, excludeId) {
+    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 {
-        var nodes = document.querySelectorAll('button, [role="tab"], [role="menuitem"], [class*="navCell"], [class*="nav"], [class*="sidebar"] a, a');
         for (var i = 0; i < nodes.length; i++) {
           var el = nodes[i];
-          if (excludeId && el.id === excludeId) continue;
-          var t = (el.textContent || "").trim();
-          // 含匹配(标签常带 emoji 前缀,如“📱 远程访问”);排除自身入口防递归
-          if (t.indexOf(text) !== -1) {
-            try { el.click(); return true; } catch (e) { /* 尝试下一个 */ }
-          }
+          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 (clickTextNav("远程访问", "dru-nav-remote")) return; // 已在栏目内/直接点到(排除自身)
-      if (clickTextNav("设置")) { /* 进入设置页后再轮询远程访问栏目 */ }
+      if (remoteSectionVisible()) return;
+      if (clickNavToken("远程访问", NAV_ENTRY_ID)) return;
+      clickNavToken("设置", NAV_ENTRY_ID); // 进设置页（导航文字可能不同名/纯图标，交给命中器）
       var tries = 0;
       var iv = setInterval(function () {
-        if (clickTextNav("远程访问", "dru-nav-remote")) { clearInterval(iv); return; }
+        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("dru-nav-remote")) return;
+        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("dru-nav-remote")) { clearInterval(iv); return; }
-            // 只在「设置页已打开/未打开都能出现」的左侧主导航找「设置」按钮；
-            // 取文本以“设置”开头且最可能是菜单项(避免命中标题/弹层里的“设置”文字)
-            var nodes = document.querySelectorAll('button, [role="menuitem"], a, [class*="navCell"]');
+            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();
-              if (t.indexOf("设置") === 0 || t.indexOf("设置 ") === 0 || t === "设置") { settingsBtn = el; break; }
+              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 = "dru-nav-remote";
+            entry.id = NAV_ENTRY_ID;
             entry.removeAttribute("data-view");
             entry.removeAttribute("href");
             entry.textContent = "";
@@ -983,7 +1059,7 @@ window.__ModuleLoader__.load({
         selfMsg ? h("div", { className: "dru-msg dru-msg-" + selfMsg.kind }, selfMsg.text) : null,
         h("div", { className: "dru-hint", style: { marginTop: 8 } },
           armed ? "⚠ 再次点击后即开始彻底卸载：① 移除 dsh web 配置中的插件引用与本地文件；② 停止并移除 bridge 自启动服务（macOS com.dshremote.bridge / Linux dsh-bridge）并结束残留进程；③ 清空本地配置目录（~/.dsh-remote：账号、设备密钥、固化运行时等）。此操作不可撤销，如需再次使用请在插件市场重新安装。" :
-            "插件市场没有更新/卸载按钮（dsh 官方市场暂不提供），本卡片即官方管理入口：检测新版、一键在线更新、彻底卸载都在这里完成。")
+            "检测新版、一键在线更新、彻底卸载都在本卡片完成。")
       );
     }
 
@@ -992,7 +1068,7 @@ window.__ModuleLoader__.load({
     // 见 clients/dsh-remote/e2ee-client.mjs），node 半随 /dsh-remote/status 以 service.e2ee 下发；
     // 此处只做“可读文案”映射（协议 docs/e2ee-protocol.md §2.3/§7.3）。
     var E2EE_DISABLED_COPY = {
-      server_disabled: "等待服务端开启 E2EE（灰度中，当前为加密准备）",
+      server_disabled: "端到端加密暂不可用（当前为普通安全连接 HTTPS）",
       params_unreachable: "当前为普通安全连接（HTTPS）",
       disabled_by_config: "当前为普通安全连接（HTTPS）",
       derive_failed: "账号密码已变更，需在「🔑 账号」重新登录后恢复端到端加密（当前为普通安全连接（HTTPS））",
@@ -1054,7 +1130,9 @@ window.__ModuleLoader__.load({
       var devOpenArr = useState(false); var devOpen = devOpenArr[0]; var setDevOpen = devOpenArr[1];
       var devBusyArr = useState(""); var devBusy = devBusyArr[0]; var setDevBusy = devBusyArr[1];
       var devMsgArr = useState(null); var devMsg = devMsgArr[0]; var setDevMsg = devMsgArr[1];
-      var armedDevArr = useState(null); var armedDev = armedDevArr[0]; var setArmedDev = armedDevArr[1]; // 待二次确认的 session id
+      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]; // 清理已解绑二次确认
 
       var refresh = useCallback(function () {
         setBusy("status");
@@ -1198,33 +1276,79 @@ window.__ModuleLoader__.load({
           setDevMsg({ kind: "err", text: "加载已授权设备失败：" + e.message });
         }).finally(function () { setDevBusy(""); });
       }
+      /** 操作（取消配对/删除记录/清理已解绑）成功后静默重拉列表，覆盖行内状态。 */
+      function refreshDeviceList() {
+        api("/dsh-remote/mobile-sessions").then(function (b) {
+          if (b && b.ok) setDevSessions(Array.isArray(b.sessions) ? b.sessions : []);
+        }).catch(function () {});
+      }
 
       var toggleDevices = function () {
         var next = !devOpen;
         setDevOpen(next);
         if (next && devSessions === null && devBusy === "") loadDevices();
-        if (!next) setArmedDev(null);
+        if (!next) { setArmedDev(null); setArmedDel(null); setPurgeArmed(false); }
       };
 
       /** 取消配对：先点一次进入确认态，再点一次才 POST revoke（同 SelfManageCard 二次确认风格）。 */
       var doRevokeDevice = function (id) {
         if (!id) return;
-        if (armedDev !== id) { setArmedDev(id); return; }
+        if (armedDev !== id) { setArmedDev(id); setArmedDel(null); setPurgeArmed(false); return; }
         setDevBusy("revoke:" + id);
         post("/dsh-remote/mobile-sessions/revoke", { id: id }).then(function (b) {
           if (!b || !b.ok) throw new Error((b && (b.error || (b.body && b.body.error))) || "取消失败");
           setArmedDev(null);
           setDevMsg({ kind: "ok", text: "已取消，对方需重新扫码/登录" });
-          // 刷新列表（成功即重拉，行内状态随后由列表覆盖）
-          api("/dsh-remote/mobile-sessions").then(function (lb) {
-            if (lb && lb.ok) setDevSessions(Array.isArray(lb.sessions) ? lb.sessions : []);
-          }).catch(function () {});
+          refreshDeviceList();
         }).catch(function (e) {
           setArmedDev(null);
           setDevMsg({ kind: "err", text: "取消配对失败：" + e.message });
         }).finally(function () { setDevBusy(""); });
       };
 
+      /**
+       * 删除设备记录：任意行（含已取消/历史）都可用，整行删除并拉黑 jti——
+       * DELETE /dsh-remote/mobile-sessions/delete（body {id} → 企业端 DELETE /api/mobile-sessions/:id）。
+       * 先点一次进入确认态，再点一次才发请求。
+       */
+      var doDeleteDevice = function (id) {
+        if (!id) return;
+        if (armedDel !== id) { setArmedDel(id); setArmedDev(null); setPurgeArmed(false); return; }
+        setDevBusy("delete:" + id);
+        api("/dsh-remote/mobile-sessions/delete", {
+          method: "DELETE",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify({ id: id })
+        }).then(function (b) {
+          if (!b || !b.ok) throw new Error((b && (b.error || (b.body && b.body.error))) || "删除失败");
+          setArmedDel(null);
+          setDevMsg({ kind: "ok", text: "已删除该设备的记录" });
+          refreshDeviceList();
+        }).catch(function (e) {
+          setArmedDel(null);
+          setDevMsg({ kind: "err", text: "删除记录失败：" + e.message });
+        }).finally(function () { setDevBusy(""); });
+      };
+
+      /**
+       * 清理已解绑：删除本人全部 revoked 行——POST /dsh-remote/mobile-sessions/purge（企业端 purge）。
+       * 先点一次进入确认态，再点一次才发请求；成功后刷新列表并提示清理条数。
+       */
+      var doPurgeDevices = function () {
+        if (!purgeArmed) { setPurgeArmed(true); setArmedDev(null); setArmedDel(null); return; }
+        setDevBusy("purge");
+        post("/dsh-remote/mobile-sessions/purge", {}).then(function (b) {
+          if (!b || !b.ok) throw new Error((b && (b.error || (b.body && b.body.error))) || "清理失败");
+          setPurgeArmed(false);
+          var n = b.removed != null ? Number(b.removed) : 0;
+          setDevMsg({ kind: "ok", text: n > 0 ? ("已清理 " + n + " 条已解绑记录") : "已清理全部已解绑记录" });
+          refreshDeviceList();
+        }).catch(function (e) {
+          setPurgeArmed(false);
+          setDevMsg({ kind: "err", text: "清理失败：" + e.message });
+        }).finally(function () { setDevBusy(""); });
+      };
+
       /** 升级/续费带登录态打开：取一次性访问 url，改写为 /app/promo?auth=… 后在手机端进入续费页。 */
       var openUpgradeAuth = function () {
         setBusy("upgrade");
@@ -1501,8 +1625,8 @@ window.__ModuleLoader__.load({
             : serviceRunning ? "已连接（可远程访问）" : "等待设备连接";
         var dotCls = "dru-dot " + (loggedInSaaS && serviceRunning ? "dru-dot-on" : "dru-dot-off");
         // Phase-5:端到端加密(E2EE)状态行 —— 未登录/旧 host 未下发 e2ee 一律不渲染
-        // （桌面宽屏与手机镜像共用同一面板：纯文字状态行、不弹层不打扰）；启用=绿点绿字，
-        // 未启用=灰字 + 原因映射（server_disabled 等待灰度开启 / 其余回退普通 HTTPS）。
+        // （桌面宽屏与手机镜像共用同一面板：纯文字状态行、不弹层不打扰）；启用=绿点绿字（🔒已启用），
+        // 未启用=灰字 + 中性原因文案（回退普通 HTTPS 连接，不宣称“灰度等待”）。
         function renderE2eeBadge() {
           if (!loggedInSaaS) return null;
           var e = describeE2ee(st && st.service && st.service.e2ee);
@@ -1533,15 +1657,15 @@ window.__ModuleLoader__.load({
               ),
               h("div", { className: "dru-access-col" },
                 h("div", { className: "dru-key-note" },
-                  "扫码即进入远程访问；每次生成的链接 30 分钟有效、访问一次后失效，停留栏目期间会自动更新。"),
+                  "扫码即进入，30 分钟有效、用一次即失效。"),
                 h("div", { className: "dru-actions", style: { marginTop: 2 } },
                   h("button", { type: "button", className: "dru-btn dru-btn-primary", disabled: akeyBusy, onClick: openKeyUrl }, "直接打开"),
                   h("button", { type: "button", className: "dru-btn dru-btn-ghost", disabled: akeyBusy, onClick: loadAccessKey }, akeyBusy ? "生成中…" : "刷新二维码/访问链接")
                 ),
                 h("div", { className: "dru-hint", style: { marginTop: 4 } },
                   !serviceRunning
-                    ? "本机 bridge 未运行：请先在下方「🖥 Bridge 服务」卡片启动，手机/另一台电脑才能连入本机。"
-                    : "手机上打开链接点「进入」即可像在本机一样使用 dsh web。")
+                    ? "本机 bridge 未运行：先在下方「🖥 Bridge 服务」卡启动。"
+                    : "打开链接/扫码进入即登录态；同设备重复扫码只更新授权，不新增设备。")
               )
             )
           ]) : h("div", null, [
@@ -1557,7 +1681,7 @@ window.__ModuleLoader__.load({
         ]);
       }
 
-      // ---------- 📲 已授权设备卡（展开列表 + 二次确认取消配对） ----------
+      // ---------- 📲 已授权设备卡（展开列表 + 行内 取消配对/删除记录 + 底部 清理已解绑） ----------
       function deviceLabel(s) {
         if (s && s.label) return String(s.label);
         var parts = [];
@@ -1578,10 +1702,12 @@ window.__ModuleLoader__.load({
         if (devSessions.length === 0) {
           return h("div", { className: "dru-fb-empty" }, "暂无已授权设备（手机扫码后出现）");
         }
+        var revokedCount = devSessions.filter(function (s) { return !!(s && s.revoked_at); }).length;
         return h("div", null, [
           devSessions.map(function (s) {
+            var id = s && s.id;
             var revoked = !!(s && s.revoked_at);
-            return h("div", { key: s && s.id, className: "dru-dev" },
+            return h("div", { key: id, className: "dru-dev" },
               h("div", { className: "dru-dev-top" },
                 h("span", { className: "dru-dev-name" }, deviceLabel(s)),
                 deviceMeta(s) ? h("span", { className: "dru-dev-meta" }, deviceMeta(s)) : null,
@@ -1592,18 +1718,34 @@ window.__ModuleLoader__.load({
                 (s && s.last_seen_at ? " · 最近活跃 " + fmtDT(s.last_seen_at) : "") +
                 (revoked ? " · 取消于 " + fmtDT(s.revoked_at) : "")
               ),
-              revoked ? null : h("div", { className: "dru-actions", style: { marginTop: 8 } },
-                h("button", {
+              h("div", { className: "dru-actions", style: { marginTop: 8 } },
+                revoked ? null : h("button", {
                   type: "button",
                   className: "dru-btn dru-btn-danger",
                   disabled: devBusy !== "",
-                  onClick: function () { doRevokeDevice(s && s.id); }
-                }, devBusy === "revoke:" + (s && s.id) ? "取消中…" : armedDev === (s && s.id) ? "⚠ 再点一次确认取消配对" : "取消配对")
+                  onClick: function () { doRevokeDevice(id); }
+                }, devBusy === "revoke:" + id ? "取消中…" : armedDev === id ? "⚠ 再点一次确认取消配对" : "取消配对"),
+                h("button", {
+                  type: "button",
+                  className: "dru-btn dru-btn-ghost",
+                  style: { color: "#cf222e", borderColor: "#cf222e" },
+                  disabled: devBusy !== "",
+                  onClick: function () { doDeleteDevice(id); }
+                }, devBusy === "delete:" + id ? "删除中…" : armedDel === id ? "⚠ 再点一次确认删除记录" : "删除记录")
               )
             );
           }),
           h("div", { className: "dru-hint", style: { marginTop: 4 } },
-            "取消配对后，对方需重新扫码/登录才能再次远程访问本机。")
+            "取消配对后，对方需重新扫码/登录才能再次远程访问本机。"),
+          h("div", { className: "dru-actions", style: { marginTop: 8, borderTop: "1px dashed #eaeef2", paddingTop: 8 } },
+            h("button", {
+              type: "button",
+              className: "dru-btn dru-btn-ghost",
+              disabled: devBusy !== "" || revokedCount === 0,
+              onClick: doPurgeDevices,
+              title: revokedCount > 0 ? ("清理 " + revokedCount + " 条已解绑记录") : "没有已解绑记录"
+            }, devBusy === "purge" ? "清理中…" : purgeArmed ? "⚠ 再点一次确认清理已解绑" : "清理已解绑" + (revokedCount > 0 ? "（" + revokedCount + "）" : ""))
+          )
         ]);
       }
       function renderDevicesCard() {
@@ -1727,7 +1869,7 @@ window.__ModuleLoader__.load({
             h("div", { className: "dru-hint", style: { marginBottom: 6 } }, "📱 远程访问：用手机或另一台电脑的浏览器，随时随地使用同一份 dsh web——人在哪都能用（免公网 IP、免内网穿透）；官方托管中继，4G/5G 即用，也可自建服务。"),
             h("div", { className: "dru-hint", style: { marginBottom: 6 } }, "🛠 电脑端一键安装：bridge 与「远程访问」面板一次到位——云端/自建切换、账号登录、bridge 启停、一次性扫码访问、已授权设备管理、意见反馈都在这里。"),
             h("div", { className: "dru-hint", style: { marginBottom: 6 } }, "🔒 安全与通道：HTTP / WebSocket 全量透传，一次性访问密钥认证，面板实时显示设备与已授权设备列表；服务端可配置流量配额。"),
-            h("div", { className: "dru-hint" }, "🛡 端到端加密（灰度开启中）：服务端开启后，手机↔电脑之间的消息内容用「你的账号密码派生密钥」端到端加密——密钥与密码不落服务端（仅存校验值），中继只可见路径/大小/时间（详见 README「安全与隐私」）。")
+            h("div", { className: "dru-hint" }, "🛡 端到端加密：手机↔电脑之间的消息内容用「你的账号密码派生密钥」端到端加密——密钥与密码不落服务端（仅存校验值），中继只可见路径/大小/时间（详见 README「安全与隐私」）。")
           ]),
           // 版本与更新（自管理：检测新版 / 一键在线更新 / 彻底卸载）
           h(SelfManageCard, null),

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

@@ -4,7 +4,8 @@
 //   - 读写配置目录下 .dsh-config.json（0600）
 //   - 查询/启停 bridge（launchctl，plist 缺失时自动生成，逻辑与 dsh-setup.mjs 一致）
 //   - 代理 relay API（captcha / register / login / public-config），直连、不走系统代理；
-//     另代理企业端一次性访问密钥 / 授权设备（/api/auth-key、/api/mobile-sessions、…/revoke，Bearer）供面板「📱 远程访问」卡使用
+//     另代理企业端一次性访问密钥 / 授权设备（/api/auth-key、/api/mobile-sessions、…/revoke、
+//     DELETE …/:id、POST …/purge，Bearer）供面板「📱 远程访问」卡使用
 //   - 自管理 self*（版本可见 / 新版检测 / 一键在线更新 / 彻底卸载）：插件市场没有更新卸载按钮，
 //     面板内即官方管理入口；更新=后台 npx 按 dist-tag(默认 latest,DSH_UPDATE_TAG 可切 beta/alpha)（幂等补齐运行环境并重启 bridge）；
 //     彻底卸载=profile 插件清理（uninstallSelf）+ 运行时清理（uninstallRuntime：停 bridge 自启动 /
@@ -802,6 +803,51 @@ async function proxyRevokeMobileSession(relayDir, req, res) {
   return sendJson(res, 200, { ok: true, relayStatus: (r && r.status) || 200 });
 }
 
+/**
+ * DELETE /dsh-remote/mobile-sessions/delete（body {id}）→ 删除本机该设备的授权记录
+ * （企业端 DELETE /api/mobile-sessions/:id，Bearer：本人整行删除并拉黑 jti）。
+ */
+async function proxyDeleteMobileSession(relayDir, req, res) {
+  const body = await readJsonBody(req);
+  if (body.__parseError) return sendJson(res, 400, { ok: false, error: "JSON 解析失败" });
+  const id = String(body.id ?? "").trim();
+  if (!id) return sendJson(res, 400, { ok: false, error: "缺少参数 id（会话 ID）" });
+  const token = await relayToken(relayDir).catch(() => "");
+  if (!token) return sendJson(res, 401, notLoggedInJson());
+  const r = await relayFetch(relayDir, `/api/mobile-sessions/${encodeURIComponent(id)}`, {
+    method: "DELETE",
+    headers: { authorization: `Bearer ${token}` },
+  });
+  const d = flattenRelayBody(r);
+  const ok = !!(r.ok && d.ok !== false);
+  if (!ok) {
+    return sendJson(res, (r && r.status) || 502, { ok: false, error: relayErrorMessage(r), relayStatus: (r && r.status) || 0 });
+  }
+  return sendJson(res, 200, { ok: true, relayStatus: (r && r.status) || 200 });
+}
+
+/**
+ * POST /dsh-remote/mobile-sessions/purge → 清理本人所有已解绑（revoked）记录
+ * （企业端 POST /api/mobile-sessions/purge，Bearer）。
+ */
+async function proxyPurgeMobileSessions(relayDir, res) {
+  const token = await relayToken(relayDir).catch(() => "");
+  if (!token) return sendJson(res, 401, notLoggedInJson());
+  const r = await relayFetch(relayDir, "/api/mobile-sessions/purge", {
+    method: "POST",
+    headers: { authorization: `Bearer ${token}` },
+  });
+  const d = flattenRelayBody(r);
+  const ok = !!(r.ok && d.ok !== false);
+  if (!ok) {
+    return sendJson(res, (r && r.status) || 502, { ok: false, error: relayErrorMessage(r), relayStatus: (r && r.status) || 0 });
+  }
+  const removed = Number.isInteger(d.removed) ? d.removed : null;
+  const payload = { ok: true, relayStatus: (r && r.status) || 200 };
+  if (removed !== null) payload.removed = removed;
+  return sendJson(res, 200, payload);
+}
+
 // ---------- 综合状态 ----------
 
 /**
@@ -974,7 +1020,7 @@ const PLUGIN_ID = "dsh-remote-web";
 const PLUGIN_LEGACY_IDS = ["dsh-remote-ui"];
 const PLUGIN_ALL_IDS = [PLUGIN_ID, ...PLUGIN_LEGACY_IDS];
 /** 插件自身发布版本（与 dsh-remote 根包同步递增）。 */
-const PLUGIN_VERSION = "0.6.0-beta.8";
+const PLUGIN_VERSION = "0.6.0-beta.9";
 const UPDATE_LOG = ".dsh-update.log";
 const UPDATE_MARKER = ".dsh-update-running";
 
@@ -1250,6 +1296,22 @@ function registerRoutes(ctx, relayDir) {
         await proxyRevokeMobileSession(relayDir, req, res);
       },
     },
+    // 删除已授权设备记录（整行删除并拉黑 jti；企业端 DELETE /api/mobile-sessions/:id，Bearer）
+    {
+      method: "DELETE",
+      path: "/dsh-remote/mobile-sessions/delete",
+      handler: async (req, res) => {
+        await proxyDeleteMobileSession(relayDir, req, res);
+      },
+    },
+    // 清理本人全部已解绑（revoked）记录（企业端 POST /api/mobile-sessions/purge，Bearer）
+    {
+      method: "POST",
+      path: "/dsh-remote/mobile-sessions/purge",
+      handler: async (_req, res) => {
+        await proxyPurgeMobileSessions(relayDir, res);
+      },
+    },
     {
       method: "POST",
       path: "/dsh-remote/config",

package/packages/dsh-remote-web/test/access-key-sessions.test.mjs

@@ -1,5 +1,7 @@
 // 插件 node 半新增代理回归：/dsh-remote/access-key | mobile-sessions | mobile-sessions/revoke
-// （企业端 E1 契约：POST /api/auth-key、POST /api/mobile-sessions、POST /api/mobile-sessions/:id/revoke，Bearer device-login JWT）
+// | mobile-sessions/delete | mobile-sessions/purge
+// （企业端 E1 契约：POST /api/auth-key、GET /api/mobile-sessions、POST /api/mobile-sessions/:id/revoke、
+//  DELETE /api/mobile-sessions/:id、POST /api/mobile-sessions/purge，Bearer device-login JWT）
 // 覆盖：Bearer 透传、字段扁平化、未登录 401、qr 缺失容错、上游错误透传。
 import assert from "node:assert/strict";
 import http from "node:http";
@@ -41,6 +43,9 @@ function startFakeRelay(opts = {}) {
     }
     if (req.method === "POST" && url.pathname === "/api/mobile-sessions/ms_1/revoke") return send(200, { ok: true });
     if (req.method === "POST" && url.pathname === "/api/mobile-sessions/ghost/revoke") return send(404, { error: { message: "not_found" } });
+    if (req.method === "DELETE" && url.pathname === "/api/mobile-sessions/ms_1") return send(200, { ok: true });
+    if (req.method === "DELETE" && url.pathname === "/api/mobile-sessions/ghost") return send(404, { error: { message: "not_found" } });
+    if (req.method === "POST" && url.pathname === "/api/mobile-sessions/purge") return send(200, { ok: true, removed: 2 });
     send(404, { error: { code: "not_found" } });
   });
   return new Promise((resolve) => srv.listen(0, "127.0.0.1", () => resolve({ srv, seen, port: srv.address().port })));
@@ -155,7 +160,66 @@ test("mobile-sessions/revoke 路由：body {id} 转发到 /api/mobile-sessions/:
   }
 });
 
-test("未登录（无账号配置）→ 三条路由统一 401 提示登录，不请求企业端", async () => {
+test("mobile-sessions/delete 路由：DELETE body {id} 转发到企业端 DELETE /api/mobile-sessions/:id（拉黑 jti）", async () => {
+  const relay = await startFakeRelay();
+  const { host, base, tempDir } = await bootRelay(relay.port);
+  try {
+    const r = await (await fetch(`${base}/dsh-remote/mobile-sessions/delete`, {
+      method: "DELETE",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ id: "ms_1" }),
+    })).json();
+    assert.equal(r.ok, true);
+    const up = relay.seen.find((s) => s.path === "/api/mobile-sessions/ms_1" && s.method === "DELETE");
+    assert.ok(up, "应转发到企业端 DELETE /api/mobile-sessions/ms_1");
+    assert.equal(up.authorization, "Bearer jwt-abc");
+
+    // 缺 id → 400；不存在的会话 → 透传 404 文案
+    const bad = await (await fetch(`${base}/dsh-remote/mobile-sessions/delete`, {
+      method: "DELETE",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({}),
+    })).json();
+    assert.equal(bad.ok, false);
+    assert.match(String(bad.error), /id/);
+
+    const ghost = await (await fetch(`${base}/dsh-remote/mobile-sessions/delete`, {
+      method: "DELETE",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ id: "ghost" }),
+    })).json();
+    assert.equal(ghost.ok, false);
+    assert.match(String(ghost.error), /not_found/);
+  } finally {
+    host.close();
+    relay.srv.close();
+    await rm(tempDir, { recursive: true, force: true });
+  }
+});
+
+test("mobile-sessions/purge 路由：POST → 企业端 POST /api/mobile-sessions/purge，removed 透传", async () => {
+  const relay = await startFakeRelay();
+  const { host, base, tempDir } = await bootRelay(relay.port);
+  try {
+    const r = await (await fetch(`${base}/dsh-remote/mobile-sessions/purge`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({}),
+    })).json();
+    assert.equal(r.ok, true);
+    assert.equal(r.removed, 2, "企业端返回的 removed 清理条数应透传");
+    const up = relay.seen.find((s) => s.path === "/api/mobile-sessions/purge");
+    assert.ok(up, "应转发到 /api/mobile-sessions/purge");
+    assert.equal(up.method, "POST");
+    assert.equal(up.authorization, "Bearer jwt-abc");
+  } finally {
+    host.close();
+    relay.srv.close();
+    await rm(tempDir, { recursive: true, force: true });
+  }
+});
+
+test("未登录（无账号配置）→ 五条路由统一 401 提示登录，不请求企业端", async () => {
   const relay = await startFakeRelay();
   const tempDir = await mkdtemp(path.join(os.tmpdir(), "dsh-aks-401-"));
   await writeFile(path.join(tempDir, ".dsh-config.json"), JSON.stringify({ api_url: `http://127.0.0.1:${relay.port}` }));
@@ -179,13 +243,19 @@ test("未登录（无账号配置）→ 三条路由统一 401 提示登录，
       assert.equal((await (await fetch(`${base}${p}`, { method }))).status, 401, `${p} 应返回 401`);
       assert.match(String(r.error), /尚未登录/);
     }
-    const rev = await (await fetch(`${base}/dsh-remote/mobile-sessions/revoke`, {
-      method: "POST",
-      headers: { "content-type": "application/json" },
-      body: JSON.stringify({ id: "ms_1" }),
-    })).json();
-    assert.equal(rev.ok, false);
-    assert.match(String(rev.error), /尚未登录/);
+    for (const [method, p] of [
+      ["POST", "/dsh-remote/mobile-sessions/revoke"],
+      ["DELETE", "/dsh-remote/mobile-sessions/delete"],
+      ["POST", "/dsh-remote/mobile-sessions/purge"],
+    ]) {
+      const r = await (await fetch(`${base}${p}`, {
+        method,
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ id: "ms_1" }),
+      })).json();
+      assert.equal(r.ok, false);
+      assert.match(String(r.error), /尚未登录/);
+    }
     assert.ok(!relay.seen.some((s) => s.path.startsWith("/api/auth-key") || s.path.startsWith("/api/mobile-sessions")), "未登录不应请求企业端");
   } finally {
     host.close();

package/packages/dsh-remote-web/test/e2ee-state.test.mjs

@@ -122,7 +122,7 @@ test("composeStatus：.e2ee-state.json 启用 → /dsh-remote/status 的 service
       enabled: true, reason: "ok", profile: "pbkdf2-sha256-600k", epoch: 2, caps: ["e2ee-v2"],
     });
 
-    // 2) bridge 未启用（服务端灰度关）→ 原样上报 reason，供面板映射可读文案
+    // 2) bridge 未启用（服务端关闭/不支持）→ 原样上报 reason，供面板映射可读文案
     await writeFile(stateFile, JSON.stringify({ enabled: false, reason: "server_disabled", profile: "", epoch: 0, caps: [] }));
     status = await (await fetch(`${boot.base}/dsh-remote/status`)).json();
     assert.equal(status.service.e2ee.enabled, false);

package/packages/dsh-remote-web/test/remote-access-ui.test.mjs

@@ -22,6 +22,12 @@ function find(tree, predicate) {
   return match;
 }
 
+function findAll(tree, predicate) {
+  const out = [];
+  walk(tree, (node) => { if (predicate(node)) out.push(node); });
+  return out;
+}
+
 /** 文本子节点包含子串（用于动态拼接文案断言）。 */
 function textHas(tree, substr) {
   return !!find(tree, (node) => (node.children || []).some((c) => typeof c === "string" && c.includes(substr)));
@@ -108,11 +114,19 @@ function loadPlugin(opts = {}) {
       }
       if (path === "/dsh-remote/mobile-sessions") {
         sessionsCalls++;
-        return response(200, { ok: true, sessions: sessionsCalls === 1 ? SESSIONS_1 : [] }); // 取消配对后的刷新 → 空列表
+        // 默认：首次给列表，后续刷新给空（模拟已全部清理）；测试可传 opts.sessions 固定列表
+        const list = opts.sessions !== undefined ? opts.sessions : (sessionsCalls === 1 ? SESSIONS_1 : []);
+        return response(200, { ok: true, sessions: list });
       }
       if (path === "/dsh-remote/mobile-sessions/revoke") {
         return response(200, { ok: true });
       }
+      if (path === "/dsh-remote/mobile-sessions/delete") {
+        return response(200, { ok: true });
+      }
+      if (path === "/dsh-remote/mobile-sessions/purge") {
+        return response(200, { ok: true, removed: 1 });
+      }
       if (path === "/dsh-remote/account") return response(200, { ok: true, account: { phone: "13800000000", plan: "free", plan_source: "plan", invite_code: "ABC12345" } });
       return response(200, { ok: true });
     },
@@ -172,7 +186,7 @@ test("📱 远程访问卡：bridge 在线 → 绿点文案；登录态点「生
   assert.ok(qr && qr.props?.alt === "远程访问二维码", "应渲染服务端返回的二维码 <img>");
   // 到期倒计时/有效至文案
   assert.ok(textHas(tree, "有效至") && textHas(tree, "剩余"), "应显示「有效至 HH:MM:SS / 剩余 xx:xx」倒计时");
-  assert.ok(textHas(tree, "访问一次后失效"), "应说明一次性/30 分钟语义");
+  assert.ok(textHas(tree, "用一次即失效"), "应说明一次性/30 分钟语义（精简一句）");
 });
 
 test("已授权设备：展开列表（label/os/browser/时间）→ 取消配对二次确认 → 成功提示并刷新", async () => {
@@ -216,6 +230,76 @@ test("已授权设备：展开列表（label/os/browser/时间）→ 取消配
   assert.ok(textHas(tree, "暂无已授权设备（手机扫码后出现）"), "刷新后空态文案应出现");
 });
 
+test("已授权设备行内操作：活跃行有 取消配对+删除记录，已取消行有 删除记录；删除记录二次确认 → DELETE delete {id}", async () => {
+  const plugin = loadPlugin({ sessions: SESSIONS_1 }); // 固定列表：操作后重拉仍保留，便于断言行内按钮
+  plugin.states[0] = { config: { phone: "13800000000", deviceId: "dev-x" }, service: { running: true } };
+  let tree = plugin.render();
+  const openBtn = find(tree, (n) => typeof n.props?.onClick === "function" && (n.children || []).some((c) => typeof c === "string" && c.includes("已授权设备")));
+  openBtn.props.onClick();
+  await flush();
+  await flush();
+  tree = plugin.render();
+
+  // 行内按钮：活跃行（ms_1）应有「取消配对」+「删除记录」；已取消行（ms_2）只应有「删除记录」
+  const delBtns = findAll(tree, (n) => typeof n.props?.onClick === "function" && (n.children || []).some((c) => typeof c === "string" && c.includes("删除记录")));
+  assert.ok(delBtns.length >= 2, "每行（含已取消/历史）都应有「删除记录」按钮");
+  assert.ok(find(tree, (n) => typeof n.props?.onClick === "function" && (n.children || []).some((c) => typeof c === "string" && c.includes("取消配对"))),
+    "活跃行应有「取消配对」按钮");
+  // 底部有「清理已解绑」入口（卡片底部）
+  assert.ok(textHas(tree, "清理已解绑"), "卡片底部应提供「清理已解绑」");
+
+  // 删除 ms_1：第一次点击进入确认态（不请求）
+  delBtns[0].props.onClick();
+  tree = plugin.render();
+  assert.ok(textHas(tree, "再点一次确认删除记录"), "删除记录需二次确认");
+  assert.ok(!plugin.requests.some((r) => r.path === "/dsh-remote/mobile-sessions/delete"), "首次点击不应发 DELETE");
+
+  // 第二次点击 → DELETE /dsh-remote/mobile-sessions/delete {id} → 提示 + 刷新列表
+  const listBefore = plugin.requests.filter((r) => r.path === "/dsh-remote/mobile-sessions").length;
+  find(tree, (n) => typeof n.props?.onClick === "function" && (n.children || []).some((c) => typeof c === "string" && c.includes("再点一次确认删除记录"))).props.onClick();
+  await flush();
+  await flush();
+  await flush();
+  const del = plugin.requests.find((r) => r.path === "/dsh-remote/mobile-sessions/delete");
+  assert.ok(del, "确认后应 DELETE /dsh-remote/mobile-sessions/delete");
+  assert.equal(del.method, "DELETE");
+  assert.deepEqual(del.body, { id: "ms_1" }, "行内删除应带上该行 session id");
+  assert.ok(plugin.requests.filter((r) => r.path === "/dsh-remote/mobile-sessions").length > listBefore, "删除后应重拉设备列表");
+  tree = plugin.render();
+  assert.ok(textHas(tree, "已删除该设备的记录"), "删除成功应有可读提示");
+});
+
+test("已授权设备：卡片底部「清理已解绑」→ 二次确认 → POST purge → 提示条数 + 刷新列表", async () => {
+  const plugin = loadPlugin({ sessions: SESSIONS_1 });
+  plugin.states[0] = { config: { phone: "13800000000", deviceId: "dev-x" }, service: { running: true } };
+  let tree = plugin.render();
+  const openBtn = find(tree, (n) => typeof n.props?.onClick === "function" && (n.children || []).some((c) => typeof c === "string" && c.includes("已授权设备")));
+  openBtn.props.onClick();
+  await flush();
+  await flush();
+  tree = plugin.render();
+
+  // 底部 purge 按钮：带 1 条已解绑计数
+  const purgeBtn = find(tree, (n) => typeof n.props?.onClick === "function" && (n.children || []).some((c) => typeof c === "string" && c.includes("清理已解绑")));
+  assert.ok(purgeBtn, "卡片底部应有「清理已解绑」按钮");
+  purgeBtn.props.onClick();
+  tree = plugin.render();
+  assert.ok(textHas(tree, "再点一次确认清理已解绑"), "清理已解绑需二次确认");
+  assert.ok(!plugin.requests.some((r) => r.path === "/dsh-remote/mobile-sessions/purge"), "首次点击不应发请求");
+
+  const listBefore = plugin.requests.filter((r) => r.path === "/dsh-remote/mobile-sessions").length;
+  find(tree, (n) => typeof n.props?.onClick === "function" && (n.children || []).some((c) => typeof c === "string" && c.includes("再点一次确认清理已解绑"))).props.onClick();
+  await flush();
+  await flush();
+  await flush();
+  const purge = plugin.requests.find((r) => r.path === "/dsh-remote/mobile-sessions/purge");
+  assert.ok(purge, "确认后应 POST /dsh-remote/mobile-sessions/purge");
+  assert.equal(purge.method, "POST");
+  assert.ok(plugin.requests.filter((r) => r.path === "/dsh-remote/mobile-sessions").length > listBefore, "清理后应重拉设备列表");
+  tree = plugin.render();
+  assert.ok(textHas(tree, "已清理 1 条已解绑记录"), "应提示清理条数（可读）");
+});
+
 test("升级/续费按钮：点击 → GET /dsh-remote/access-key → window.open(url)（带登录态打开）", async () => {
   const plugin = loadPlugin();
   plugin.states[0] = { config: { phone: "13800000000", deviceId: "dev-x" }, service: { running: true } };
@@ -250,6 +334,18 @@ test("二维码缺失容错 + 未登录引导文案（源码级约束）", () =>
   assert.match(SOURCE, /已连接（可远程访问）/);
   assert.match(SOURCE, /带登录态/);
   assert.match(SOURCE, /通过手机或另一台电脑远程使用同一份 dsh web/);
+  // 已授权设备管理（delete/purge 代理路由与按钮）
+  assert.match(SOURCE, /dsh-remote\/mobile-sessions\/delete/);
+  assert.match(SOURCE, /dsh-remote\/mobile-sessions\/purge/);
+  assert.match(SOURCE, /删除记录/);
+  assert.match(SOURCE, /清理已解绑/);
+  assert.match(SOURCE, /再点一次确认删除记录/);
+  assert.match(SOURCE, /再点一次确认清理已解绑/);
+  // 文案精简：二维码说明压成一句、右侧长段压成一句
+  assert.match(SOURCE, /扫码即进入，30 分钟有效、用一次即失效。/);
+  assert.match(SOURCE, /打开链接\/扫码进入即登录态；同设备重复扫码只更新授权，不新增设备。/);
+  assert.doesNotMatch(SOURCE, /每次生成的链接 30 分钟有效、访问一次后失效/);
+  assert.doesNotMatch(SOURCE, /手机上打开链接点「进入」即可像在本机一样使用 dsh web/);
 });
 
 // ---------- 端到端加密（E2EE，Phase-5）状态徽标 ----------
@@ -282,9 +378,9 @@ test("E2EE 徽标：已启用 → “🔒 端到端加密已启用（手机解
   assert.ok(textHas(tree, "手机解锁后生效"), "应提示“手机解锁后生效”（bridge 就绪、手机解锁后方生效）");
 });
 
-test("E2EE 徽标：未启用原因映射可读文案（灰度等待 / 参数不可达 / 本地关闭 / 改密 / 未知兜底）", () => {
+test("E2EE 徽标：未启用原因映射可读文案（服务端关闭 / 参数不可达 / 本地关闭 / 改密 / 未知兜底）", () => {
   const cases = [
-    [E2EE_STATE.serverDisabled, "等待服务端开启 E2EE"],
+    [E2EE_STATE.serverDisabled, "端到端加密暂不可用（当前为普通安全连接 HTTPS）"],
     [E2EE_STATE.paramsUnreachable, "当前为普通安全连接（HTTPS）"],
     [E2EE_STATE.localDisabled, "当前为普通安全连接（HTTPS）"],
     [E2EE_STATE.deriveFailed, "账号密码已变更"],
@@ -316,8 +412,9 @@ test("E2EE 徽标：未登录 / host 未下发 e2ee → 不打扰（不渲染状
 test("E2EE 徽标（源码级约束）：client 含徽标字段/文案与 reason 映射表", () => {
   assert.match(SOURCE, /service\.e2ee/);
   assert.match(SOURCE, /\.e2ee-state\.json/);
-  assert.match(SOURCE, /端到端加密已启用（手机解锁后生效）/);
-  assert.match(SOURCE, /等待服务端开启 E2EE（灰度中，当前为加密准备）/);
+  assert.match(SOURCE, /🔒 端到端加密已启用（手机解锁后生效）/);
+  assert.match(SOURCE, /端到端加密暂不可用（当前为普通安全连接 HTTPS）/);
+  assert.doesNotMatch(SOURCE, /等待服务端开启 E2EE/);   // 已正式开启，不再出现“灰度等待”措辞
   assert.match(SOURCE, /当前为普通安全连接（HTTPS）/);
   assert.match(SOURCE, /server_disabled/);
   assert.match(SOURCE, /params_unreachable/);

package/packages/dsh-remote-web/test/settings-entry.test.mjs

@@ -87,6 +87,7 @@ function loadPlugin(opts = {}) {
   });
 
   const allCreated = [];
+  const intervals = [];
   const doc = {
     createElement(tag) { const el = makeEl(tag); allCreated.push(el); return el; },
     head: makeEl("head"),
@@ -95,7 +96,11 @@ function loadPlugin(opts = {}) {
       const cls = sel.charAt(0) === "." ? sel.slice(1) : "";
       return allCreated.find((el) => el.className === cls) || null;
     },
-    querySelectorAll(sel) { return sel === "button" ? (opts.navCells || []) : []; },
+    querySelectorAll(sel) {
+      if (sel === "button") return opts.navCells || [];
+      if (typeof opts.navQuery === "function") return opts.navQuery(sel);
+      return [];
+    },
   };
 
   let lastObserver = null;
@@ -129,7 +134,7 @@ function loadPlugin(opts = {}) {
       return response(200, { body: { ok: true } });
     },
     navigator: { clipboard: { writeText: async () => {} } },
-    setInterval() { return 1; },
+    setInterval(cb, ms) { intervals.push({ cb, ms }); return intervals.length; },
     clearInterval() {},
     setTimeout() { return 1; },
     Set,
@@ -152,6 +157,8 @@ function loadPlugin(opts = {}) {
 
   return {
     registered, metas, injects, requests, removed, states, localStorage,
+    intervals,
+    navWindow: sandbox.window,
     lastObserver: () => lastObserver,
     renderSection() { hook = 0; return registered.get("dsh-remote")({ close() {} }); },
   };
@@ -203,7 +210,7 @@ test("登录态账号区：无「切换账号」，有「退出登录」，头
     "📱 远程访问：用手机或另一台电脑的浏览器，随时随地使用同一份 dsh web——人在哪都能用（免公网 IP、免内网穿透）；官方托管中继，4G/5G 即用，也可自建服务。",
     "🛠 电脑端一键安装：bridge 与「远程访问」面板一次到位——云端/自建切换、账号登录、bridge 启停、一次性扫码访问、已授权设备管理、意见反馈都在这里。",
     "🔒 安全与通道：HTTP / WebSocket 全量透传，一次性访问密钥认证，面板实时显示设备与已授权设备列表；服务端可配置流量配额。",
-    "🛡 端到端加密（灰度开启中）：服务端开启后，手机↔电脑之间的消息内容用「你的账号密码派生密钥」端到端加密——密钥与密码不落服务端（仅存校验值），中继只可见路径/大小/时间（详见 README「安全与隐私」）。",
+    "🛡 端到端加密：手机↔电脑之间的消息内容用「你的账号密码派生密钥」端到端加密——密钥与密码不落服务端（仅存校验值），中继只可见路径/大小/时间（详见 README「安全与隐私」）。",
   ];
   for (const p of points) {
     assert.ok(find(tree, (n) => n.children?.includes(p)), `说明卡片应含要点: ${p.slice(0, 12)}…`);
@@ -277,6 +284,61 @@ test("红点已看过（localStorage 有 key）时不注入，重启 DSH Web 不
   assert.equal(navCell.children.length, 0, "已看过时不应再注入红点");
 });
 
+// ---------- 侧栏入口「远程访问」点击流（openRemoteSettings） ----------
+
+/** 简易导航节点：带 aria-label/text/class/role 的“按钮”，记录点击并支持 data-dru-remote 标记。 */
+function navNode({ id = "", text = "", aria = "", cls = "", role = "", tag = "button" } = {}) {
+  const node = {
+    id,
+    className: cls,
+    textContent: text,
+    tagName: tag,
+    _attrs: {},
+    _clicked: 0,
+    getAttribute(k) { return k in this._attrs ? this._attrs[k] : null; },
+    setAttribute(k, v) { this._attrs[k] = String(v); },
+    click() { this._clicked++; },
+  };
+  if (aria) node._attrs["aria-label"] = aria;
+  if (role) node._attrs.role = role;
+  return node;
+}
+
+test("侧栏入口点击流：远程栏目项已存在（navCell/aria-label，含 emoji 前缀）→ 直接命中栏目，不点注入项自身", () => {
+  const injected = navNode({ id: "dru-nav-remote", text: "📱 远程访问", cls: "navCell-clone" }); // 注入的侧栏项
+  const settingsNav = navNode({ text: "设置", cls: "navCell-set" });
+  const remoteCell = navNode({ aria: "远程访问", cls: "VOzbGW_navCell", tag: "button" }); // 纯图标+aria-label 的栏目项
+  const nodes = [injected, settingsNav, remoteCell];
+  const plugin = loadPlugin({ navQuery: () => nodes });
+  plugin.navWindow.__dshRemoteNav.open();
+  assert.equal(remoteCell._clicked, 1, "应命中「远程访问」栏目项（aria-label 亦可读）");
+  assert.equal(remoteCell.getAttribute("data-dru-remote"), "1", "命中后应打 data-dru-remote 标记（加速二次命中）");
+  assert.equal(injected._clicked, 0, "不得点击注入的侧栏项自身（防递归）");
+  assert.equal(settingsNav._clicked, 0, "栏目已存在时无需退化点「设置」");
+  assert.equal(plugin.intervals.filter((x) => x.ms === 150).length, 0, "直接命中后不应启动轮询");
+});
+
+test("侧栏入口点击流：栏目项尚未挂载 → 先点「设置」，轮询到点后再补点「远程访问」（全程不点注入项）", () => {
+  const injected = navNode({ id: "dru-nav-remote", text: "📱 远程访问", cls: "navCell-clone" });
+  const settingsNav = navNode({ text: "设置", cls: "navCell-set" });
+  const remoteCell = navNode({ text: "📱 远程访问", cls: "VOzbGW_navCell" }); // 设置页打开后才挂载
+  const nodes = [injected, settingsNav]; // 初始只有注入项 + 「设置」
+  const plugin = loadPlugin({ navQuery: () => nodes });
+  plugin.navWindow.__dshRemoteNav.open();
+
+  assert.equal(settingsNav._clicked, 1, "栏目不可达时应点「设置」进入设置页");
+  assert.equal(injected._clicked, 0, "不得点击注入的侧栏项自身");
+  const poll = plugin.intervals.find((x) => x.ms === 150);
+  assert.ok(poll, "应启动 150ms 轮询等待栏目挂载");
+
+  nodes.push(remoteCell); // 设置页已打开，栏目项挂载
+  poll.cb();
+  assert.equal(remoteCell._clicked, 1, "轮询到点后应补点「远程访问」栏目");
+  assert.equal(remoteCell.getAttribute("data-dru-remote"), "1", "栏目命中后应打标记");
+  assert.equal(settingsNav._clicked, 1, "「设置」只应点一次");
+  assert.equal(injected._clicked, 0, "轮询过程也不得点注入项自身");
+});
+
 test("源码约束：无侧边栏入口/浮动面板/切换账号；命名统一为「远程访问」；新增访问密钥/设备路由", () => {
   // 只断言“代码形态”不存在（注释里允许出现说明文字）
   assert.doesNotMatch(SOURCE, /slots\.inject\("sidebar\.footer\.action"/);
@@ -294,6 +356,13 @@ test("源码约束：无侧边栏入口/浮动面板/切换账号；命名统一
   assert.match(SOURCE, /dsh-remote\/access-key/);
   assert.match(SOURCE, /dsh-remote\/mobile-sessions/);
   assert.match(SOURCE, /order: 30/);
+  // 侧栏入口导航加固：aria-label/role 扫描、data-dru-remote 标记、排除注入项防递归、进设置后轮询
+  assert.match(SOURCE, /data-dru-remote/);
+  assert.match(SOURCE, /dru-nav-remote/);
+  assert.match(SOURCE, /aria-label/);
+  assert.match(SOURCE, /remoteSectionVisible/);
+  assert.match(SOURCE, /openRemoteSettings/);
+  assert.match(SOURCE, /__dshRemoteNav/);
   // 清理时机：退出登录成功回调内、登录账号变化时、切换自建服务时
   assert.match(SOURCE, /post\("\/dsh-remote\/logout"\)\.then\(function \(body\) \{[\s\S]*?fbClearThreads\(\);/);
   assert.match(SOURCE, /if \(prevPhone !== phone\.trim\(\)\) fbClearThreads\(\);/);