@mrrisega/dsh-remote 0.7.0-beta.5 → 0.7.0-beta.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrisega/dsh-remote",
-  "version": "0.7.0-beta.5",
+  "version": "0.7.0-beta.7",
   "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

@@ -834,22 +834,42 @@ window.__ModuleLoader__.load({
      *   其中 **带 aria-keyshortcuts / 文案或 aria-label 含「设置」** 的优先（语言无关 + 精确）。
      */
     function settingsTriggerCandidates() {
-      var out = [];
+      var ranked = [];
       try {
+        /* 排名而不是「谁先扫到谁」（2026-10-11 业主实测「点入口弹出的是 token 用量小弹窗」）：
+             ① 官方设置槽位里的按钮 = 确定是设置触发器（sidebar.settings / settings.launcher）
+             ② 带快捷键或文案含「设置」的弹层触发器
+             ③ 其它弹层触发器（最后兜底）
+           并且**排除我们自己所在的底部槽**（sidebar.footer.action）—— token 用量、其它插件按钮
+           都在那一块，它们同样带 aria-haspopup=dialog，正是「点错弹窗」的来源。
+           只用 closest 判容器、不做后代选择器：任何 DOM 实现（含测试替身）都支持。 */
         var cands = document.querySelectorAll('button[aria-haspopup="dialog"], [aria-haspopup="dialog"]');
-        var rest = [];
         for (var i = 0; i < cands.length; i++) {
           var el = cands[i];
           if (!el || el.id === NAV_ENTRY_ID) continue;   // 排除我们自己的入口
           if (navInDialog(el)) continue;                 // 弹层内的（关闭键/栏目）一律不要
+          try { if (el.closest && el.closest('[data-slot="sidebar.footer.action"]')) continue; } catch (eF) { /* 忽略 */ }
           if (NAV_BAD_RE.test(String(el.className || ""))) continue;
+          /* 🔴 2026-10-11 业主实测「点入口弹出的是本轮用量」：那次弹窗锚在**右上角**，
+             说明候选里混进了**顶栏**的按钮（用量/上下文那些同样带 aria-haspopup="dialog"）。
+             这里加几何闸门：只认**侧栏范围内**的候选（左侧窄条），顶栏/内容区的按钮一律不碰。 */
+          try {
+            var r0 = el.getBoundingClientRect ? el.getBoundingClientRect() : null;
+            if (r0 && (r0.width === 0 || r0.height === 0)) continue;      // 不可见
+            if (r0 && r0.left > 360) continue;                            // 明显在右侧（顶栏/内容区）
+          } catch (e0) { /* 拿不到几何信息就放行（老宿主/测试替身） */ }
+          var inSettingsSlot = false;
+          try {
+            inSettingsSlot = !!(el.closest && el.closest('[data-slot="sidebar.settings"], [data-slot="settings.launcher"]'));
+          } catch (e1) { inSettingsSlot = false; }
           var label = String(navAttrOf(el) || navCleanText(el) || "");
           var hasShortcut = !!(el.getAttribute && el.getAttribute("aria-keyshortcuts"));
-          if (hasShortcut || /设置|Settings/i.test(label)) out.push(el);
-          else rest.push(el);
+          var rank = inSettingsSlot ? 0 : ((hasShortcut || /设置|Settings/i.test(label)) ? 1 : 2);
+          ranked.push({ el: el, rank: rank, order: i });
         }
-        return out.concat(rest);   // 兜底也不能空着：实在认不出就逐个试（见 openRemoteSettings）
-      } catch (e) { return out; }
+        ranked.sort(function (a, b) { return (a.rank - b.rank) || (a.order - b.order); });
+        return ranked.map(function (x) { return x.el; });
+      } catch (e) { return ranked.map(function (x) { return x.el; }); }
     }
     /** 官方「设置」触发器（首选候选，保持旧名字给测试与调用方用）。 */
     function pickSettingsTrigger() {
@@ -887,6 +907,134 @@ window.__ModuleLoader__.load({
       } catch (e) { /* 忽略 */ }
       return null;
     }
+    /**
+     * 从**账号菜单**里进设置（桌面端的「设置」就是账号菜单里的一项）。
+     *
+     * 为什么需要：桌面端侧栏底部那颗"齿轮"在 Electron 渲染器里不一定存在 —— 业主截图里
+     * 底部只有「远程访问」+ 账号（高昂），「设置」在**账号菜单**里。所以当侧栏候选全部落空时，
+     * 必须能"打开账号菜单 → 点设置 → 再点我们的栏目"，否则入口点下去就是没反应。
+     */
+    /** 设置面板是否已经打开（可见的 dialog 且含「通用设置」——它就是设置面板的标志）。 */
+    function settingsDialogOpen() {
+      try {
+        var ds = document.querySelectorAll('[role="dialog"], [aria-modal="true"]');
+        for (var i = 0; i < ds.length; i++) {
+          var el = ds[i];
+          if (!el.getBoundingClientRect || el.getBoundingClientRect().width === 0) continue;
+          var t = String(el.textContent || "");
+          if (t.indexOf("通用设置") !== -1 || t.indexOf("General") !== -1) return true;
+        }
+      } catch (e) { /* 忽略 */ }
+      return false;
+    }
+
+    /**
+     * 这一行是不是账号菜单里的「设置」？
+     * ⚠️ **只认"以设置/Settings 开头"** —— 绝不能加"以设置结尾"：账号菜单在桌面端真实文案是
+     * 「设置 ⌥ ⌘ ,」（带快捷键），而以"设置"结尾的还有「**通用设置**」，
+     * 那会让我们把设置面板当成账号菜单、把「通用设置」当成「设置」行（2026-10-11 两个远程访问的根因）。
+     */
+    function menuRowIsSettings(el) {
+      try {
+        var t = String(el.textContent || "").replace(/\s+/g, "").trim();
+        if (!t || t.indexOf("远程访问") !== -1) return false;
+        return /^(设置|Settings)/i.test(t);
+      } catch (e) { return false; }
+    }
+
+    /** 账号菜单的触发器：桌面端是左下角那颗"头像 chip"（aria-label="账号菜单"）。 */
+    function accountMenuTrigger() {
+      try {
+        var all = document.querySelectorAll('[aria-haspopup="menu"], button, [role="button"]');
+        var best = null;
+        for (var i = 0; i < all.length; i++) {
+          var el = all[i];
+          if (!el || el.id === NAV_ENTRY_ID) continue;
+          var aria = String((el.getAttribute && el.getAttribute("aria-label")) || "");
+          if (/账号菜单|Account menu/i.test(aria)) return el;
+          var r = el.getBoundingClientRect ? el.getBoundingClientRect() : null;
+          if (!best && r && r.width > 0 && r.left < 360 && r.top > 300
+              && String((el.getAttribute && el.getAttribute("aria-haspopup")) || "") === "menu") best = el;
+        }
+        return best;
+      } catch (e) { return null; }
+    }
+
+    /**
+     * 兜底：从**账号菜单**进设置（桌面端的「设置」就在账号菜单里）。
+     * 这是唯一在真机上验证过能打开设置面板的路径 —— 但账号菜单会闪现一下，所以：
+     *   · 只在侧栏候选与快捷键都失败后才用（见 openRemoteSettings）；
+     *   · 轮询间隔压到 40ms，菜单可见时间≈一两帧，尽量不打扰。
+     */
+    function openSettingsViaAccountMenu() {
+      try {
+        var trigger = accountMenuTrigger();
+        navTrace("menu:trigger=" + (trigger ? "found" : "none"));
+        if (!trigger) return;
+        try { trigger.click(); } catch (e) { return; }
+        var tries = 0;
+        var iv = setInterval(function () {
+          tries += 1;
+          var menus = document.querySelectorAll('[role="menu"], [role="listbox"], [role="dialog"]');
+          for (var i = 0; i < menus.length; i++) {
+            var m = menus[i];
+            if (!m.getBoundingClientRect || m.getBoundingClientRect().width === 0) continue;
+            if (String(m.textContent || "").indexOf("通用设置") !== -1) continue;   // 那是设置面板，不是账号菜单
+            var items = m.querySelectorAll ? m.querySelectorAll('button, [role="menuitem"]') : [];
+            for (var k = 0; k < items.length; k++) {
+              if (!menuRowIsSettings(items[k])) continue;
+              navTrace("menu:settings-row-clicked");
+              clearInterval(iv);
+              try { items[k].click(); } catch (e2) { /* 忽略 */ }
+              var tries2 = 0;
+              var iv2 = setInterval(function () {
+                tries2 += 1;
+                var cell = pickNavByToken("远程访问", { insideDialog: true });
+                if (cell) { navTrace("menu:section-clicked"); clearInterval(iv2); cell.click(); }
+                else if (tries2 >= NAV_POLL_MAX) { navTrace("menu:section-timeout"); clearInterval(iv2); }
+              }, 120);
+              try { if (iv2 && typeof iv2.unref === "function") iv2.unref(); } catch (e3) { /* 忽略 */ }
+              return;
+            }
+          }
+          if (tries >= 30) { navTrace("menu:timeout"); clearInterval(iv); }   // 30×40ms≈1.2s
+        }, 40);
+        try { if (iv && typeof iv.unref === "function") iv.unref(); } catch (e4) { /* 忽略 */ }
+      } catch (e) { /* 忽略 */ }
+    }
+
+    /**
+     * 用**官方设置快捷键**（⌥⌘, / Alt+Meta+,）打开设置面板。
+     *
+     * 为什么用快捷键而不是"点账号菜单里的设置"（2026-10-11 业主反馈）：
+     *   桌面端侧栏没有设置齿轮，只能从账号菜单进 —— 但那会让**账号菜单先弹出来再关掉**，
+     *   业主的原话是「会触发一个小弹窗……有一瞬间会闪出一下，体验不好」。
+     *   实测（探针在桌面渲染器里验证）：向 document 派发一次
+     *   `keydown {key:",", metaKey:true, altKey:true}` 就能**直接**打开设置面板，没有任何中间弹层。
+     *   快捷键取自设置行自带的 `aria-keyshortcuts="Alt+Meta+,"`（宿主自己的约定）。
+     */
+    function openSettingsViaShortcut() {
+      try {
+        navTrace("open:shortcut-dispatch");
+        var ev = new KeyboardEvent("keydown", {
+          key: ",", code: "Comma", metaKey: true, altKey: true, bubbles: true, cancelable: true
+        });
+        document.dispatchEvent(ev);
+        var tries = 0;
+        var iv = setInterval(function () {
+          tries += 1;
+          var cell = pickNavByToken("远程访问", { insideDialog: true });
+          if (cell) { navTrace("open:shortcut-section-clicked"); clearInterval(iv); cell.click(); return; }
+          if (tries >= 6) {                     // ~0.6s 还没开 → 桌面端快捷键可能是**原生菜单加速键**（合成事件打不动）
+            clearInterval(iv);
+            if (!settingsDialogOpen()) { navTrace("open:shortcut-no-effect→account-menu"); openSettingsViaAccountMenu(); }
+            else navTrace("open:shortcut-dialog-but-no-section");
+          }
+        }, 100);
+        try { if (iv && typeof iv.unref === "function") iv.unref(); } catch (eV) { /* 忽略 */ }
+      } catch (e) { navTrace("open:shortcut-error:" + (e && e.message)); }
+    }
+
     /**
      * 打开「远程访问」设置栏目。
      * 栏目已渲染 → 直接点；否则**依次试每个"设置"候选**：点一下 → 轮询 ≤3s 看栏目出没出来 →
@@ -896,13 +1044,15 @@ window.__ModuleLoader__.load({
      */
     function openRemoteSettings() {
       try {
+        navTrace("open:enter");
         var cell = pickNavByToken("远程访问", { insideDialog: true });
-        if (cell) { cell.click(); return; }
+        if (cell) { navTrace("open:section-already-visible"); cell.click(); return; }
         var cands = settingsTriggerCandidates();
-        if (!cands.length) return;
+        navTrace("open:cands=" + cands.length);
+        if (!cands.length) { navTrace("open:no-sidebar-cands→shortcut"); return openSettingsViaShortcut(); }
         var idx = 0;
         var tryNext = function () {
-          if (idx >= cands.length) return;
+          if (idx >= cands.length) { navTrace("open:sidebar-cands-exhausted→shortcut"); return openSettingsViaShortcut(); }   // 侧栏里找不到触发器 → 走账号菜单
           var el = cands[idx++];
           try { el.click(); } catch (eClick) { return tryNext(); }
           var tries = 0;
@@ -923,6 +1073,21 @@ window.__ModuleLoader__.load({
      */
     var remoteNavOpen = null;
 
+    /**
+     * 入口点击链路的**现场追踪**（有界 40 条，挂在 `window.__druNavTrace`）。
+     * 为什么值得常驻：这类"点了没反应"的问题跨了"侧栏候选 → 账号菜单 → 设置面板"三步，
+     * 光看界面分不清卡在哪一步（本次排查就是靠它定位到「设置 ⌥⌘,」文案不匹配）。
+     * 只写内存、不含隐私，出问题时让用户执行 `copy(window.__druNavTrace)` 即可。
+     */
+    function navTrace(step) {
+      try {
+        var w = window;
+        if (!w.__druNavTrace) w.__druNavTrace = [];
+        w.__druNavTrace.push(String(step));
+        if (w.__druNavTrace.length > 40) w.__druNavTrace.shift();
+      } catch (e) { /* 忽略 */ }
+    }
+
     /* 📱 侧栏底部的「远程访问」入口（2026-10-10 三修：改用**官方槽位**）。====================
        前两次都栽在"自己找 DOM 落点"上：
          · 一修前：按文案包含「设置」找锚点 → 命中的是设置面板里的「通用设置」→ 按钮跑到设置面板顶部；
@@ -957,10 +1122,23 @@ window.__ModuleLoader__.load({
       ]);
     }
 
+    /* 📱 账号菜单里的入口（2026-10-11 业主指定位置：「放在设置那一行的上面，小弹窗里面」）。
+       ────────────────────────────────────────────────────────────────────────────
+       那个「小弹窗」= 桌面端自带的**账号菜单**（设置 / 意见反馈 / 登录 / 更多），由
+       `@deepseek-ai/dsh-client-ui-settings-account` 渲染（它只在桌面渲染器里注册，且有
+       `dshDesktop` 判断）。它**没有给插件留任何菜单槽位**（该包只注册 shell.overlay /
+       settings.models.sign-in / shell.quota-notice），所以放进它只能做 DOM 插入。
+       因此这里的写法刻意保守：
+         · 只在"确实是账号菜单"（含「意见反馈」这一独有文案）的浮层里动手，别的浮层一律不碰；
+         · 幂等（插过就跳过）；找不到「设置」那一行就**什么都不做**（绝不猜位置）；
+         · 只用自己创建的 button（**不 cloneNode** —— 克隆会继承官方事件委托，历史事故）；
+         · 整段 try/catch，任何异常都不影响面板本身。
+       失败的可见后果只是"弹窗里没有这一项"，侧栏那个官方槽位入口仍然在。 */
     function navEnsureStart() {
       if (window.__dshRemoteNavStarted) return;
       window.__dshRemoteNavStarted = true;
       try { window.__dshRemoteNav = { open: openRemoteSettings }; } catch (e) {}
+      navTrace("adapter-ready");
       // ⚠️ 这里**不再**做 DOM 注入（见 RemoteNavEntry 的注释）：入口由官方槽位渲染。
       //    保留本函数只为实现"继续暴露 window.__dshRemoteNav"（老调用方与诊断仍在用）。
       try { if (typeof openRemoteSettings === "function") remoteNavOpen = openRemoteSettings; } catch (e) { /* 忽略 */ }
@@ -2718,7 +2896,11 @@ window.__ModuleLoader__.load({
       // 在那边**做不到也不该做**（强行退出会弹原生致命错误）。面板据此：
       //   ① 不自动倒计时重启；② 保留提醒但改文案，引导"退出并重开桌面应用"。
       // 旧版 host 的响应里没有该字段 → false，行为与改动前完全一致。
-      var desktopHost = !!(st && st.desktopHost);
+      // 🔴 2026-10-11 修：node 半把该字段下在 **connect** 里（`connect.desktopHost`），
+      // 这里以前读顶层 `st.desktopHost` → **永远 false** → 桌面端被当成 Web 版：
+      // 面板照样摆「立即重启」按钮、照样走倒计时自动重启那条路（业主实测"装插件时窗口被突兀关掉"）。
+      // 兼容两种位置，桌面端的"不自动重启/只提示用户自己重启"这才真正生效。
+      var desktopHost = !!(st && (st.desktopHost || (st.connect && st.connect.desktopHost)));
       // kind === "refresh" = 插件文件在运行中被改写(装完/更新完),只需刷新页面;
       // 其余情况(极为罕见)才提重启 dsh web。
       var isRefreshOnly = restartPending && restartInfo.kind === "refresh";

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

@@ -6626,6 +6626,21 @@ function registerRoutes(ctx, relayDir) {
       handler: async (_req, res) => {
         // 首次安装/在线更新后重启 DeepSeek harness：插件本体与浏览器半在进程启动时装载，
         // 不重启则面板入口与 /dsh-remote/* 路由都不会出现。只重启承载本插件的进程。
+        //
+        // 🔴 2026-10-11 业主口径：**桌面端绝不代为重启**。
+        //   "自动重启会很突兀地把窗口给关掉，关没了……我们应该提示用户自己重启，不要由我们来重启。"
+        //   桌面端 Host 由 Electron 托管，重启 = 强杀承载窗口的进程（还会弹原生致命错误）。
+        //   这里做成**硬拒绝**（不只是前端藏按钮）：任何调用方都拿不到"被重启"的结果，
+        //   只会收到一句明确的"请手动重启"，前端据此展示提示。
+        if (IS_ELECTRON_HOST) {
+          sendJson(res, 200, {
+            ...(await composeStatus(relayDir)),
+            ok: false,
+            status: "manual-restart-required",
+            detail: "桌面端不代为重启：请手动退出并重新打开 DeepSeek Harness（自动重启会突兀地关掉窗口）",
+          });
+          return;
+        }
         const r = await restartHarness(relayDir);
         const payload = { ...(await composeStatus(relayDir)), ...r };
         if (!r.ok) payload.error = r.detail || r.status || "重启失败";

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

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

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

@@ -159,7 +159,10 @@ test("桌面端：状态接口必须下发宿主形态，面板才能自适应",
 });
 
 test("桌面端：面板不得自动倒计时重启，且不摆点了必然失败的重启按钮", () => {
-  assert.match(CLIENT_SRC, /var desktopHost = !!\(st && st\.desktopHost\)/, "面板必须读 desktopHost");
+  // ⚠️ 2026-10-11 修：node 半把这个字段下在 **connect** 里（`connect.desktopHost`），
+  // 只读顶层 `st.desktopHost` 会**永远 false** → 桌面端被当成 Web 版（照样摆重启按钮、走自动倒计时）。
+  assert.match(CLIENT_SRC, /var desktopHost = !!\(st && \(st\.desktopHost \|\| \(st\.connect && st\.connect\.desktopHost\)\)\)/,
+    "面板必须同时读顶层与 connect.desktopHost（只读顶层等于门禁失效）");
   assert.match(CLIENT_SRC, /isRestartHard \|\| desktopHost \|\| busy !== ""/,
     "自动倒计时重启必须在桌面端短路（Host 由 Electron 托管，不能替用户重启）");
   assert.match(CLIENT_SRC, /\(desktopHost && !isRefreshOnly\) \? null : h\("button"/,

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

@@ -100,7 +100,7 @@ function makeDocument(roots) {
   };
 }
 function loadNavHelpers(doc) {
-  const src = navHelpersSource() + "\nreturn { pickSettingsTrigger, pickNavByToken, navInDialog };";
+  const src = navHelpersSource() + "\nreturn { pickSettingsTrigger, settingsTriggerCandidates, pickNavByToken, navInDialog };";
   // eslint-disable-next-line no-new-func
   return new Function("document", "window", src)(doc, {});
 }
@@ -135,6 +135,30 @@ test("★ 事故锁：官方「设置」触发器只认语义锚点，且必须
   assert.equal(pickSettingsTrigger(), trigger, "必须命中侧栏那颗 aria-haspopup=dialog 的齿轮按钮");
 });
 
+test("★ 2026-10-11 业主实测：点入口弹出的是 token 用量弹窗 —— 官方设置槽位必须优先于底部槽邻居", () => {
+  // 现场：入口挂在 sidebar.footer.action，而同一底部区域的「token 本轮用量」按钮
+  // 也带 aria-haspopup="dialog"（甚至带快捷键）→ 旧实现"谁先扫到谁"就点中了它。
+  // 现在：① 官方设置槽位里的按钮排第一；② 底部槽（我们所在那块）里的候选直接排除。
+  const sidebar = new El("div", { cls: "sidebarRoot" });
+  const footSlot = new El("div", { attrs: { "data-slot": "sidebar.footer.action" } });
+  const tokenBtn = new El("button", { cls: "tokTrigger", attrs: { "aria-haspopup": "dialog", "aria-keyshortcuts": "Alt+Meta+T", "aria-label": "本轮用量" } });
+  const entry = new El("button", { id: "dru-nav-remote", cls: "dru-foot-entry", text: "📱 远程访问" });
+  footSlot.append(tokenBtn, entry);
+  const settingsArea = new El("div", { cls: "settingsArea" });
+  const settingsSlot = new El("div", { attrs: { "data-slot": "sidebar.settings" } });
+  const trigger = new El("button", { cls: "gearTrigger", attrs: { "aria-haspopup": "dialog", "aria-label": "设置" } });
+  settingsSlot.append(trigger);
+  settingsArea.append(settingsSlot);
+  sidebar.append(footSlot, settingsArea);
+
+  const doc = makeDocument([sidebar]);
+  const { pickSettingsTrigger, settingsTriggerCandidates } = loadNavHelpers(doc);
+  const cands = settingsTriggerCandidates();
+  assert.ok(!cands.includes(tokenBtn), "★ 底部槽里的 token 用量按钮必须被排除（点它会弹错窗）");
+  assert.ok(!cands.includes(entry), "我们自己的入口不能成为候选（否则点自己→再点自己）");
+  assert.equal(pickSettingsTrigger(), trigger, "★ 必须选中官方设置槽位里的齿轮，而不是 token 用量按钮");
+});
+
 test("★ 事故锁：弹层里的「通用设置」永远不能成为落点", () => {
   const { doc, general } = desktopFixture();
   const { pickSettingsTrigger, pickNavByToken } = loadNavHelpers(doc);

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

@@ -347,7 +347,8 @@ test("源码约束：侧栏注入「远程访问」按钮与官方「设置」
   assert.match(SOURCE, /data-dru-remote/);
   assert.match(SOURCE, /NAV_ENTRY_ID/);
   // 安全设计：绝不克隆官方按钮；候选限定 navCell/导航容器 + 短文本；排除自身；排除菜单语义
-  assert.doesNotMatch(SOURCE, /cloneNode/);
+  // 只禁止**调用**（注释里说明"为什么不克隆"是允许的；2026-10-11 因注释里出现该词误报过）
+  assert.doesNotMatch(SOURCE, /\.cloneNode\s*\(/);
   assert.match(SOURCE, /navCell/);
   assert.match(SOURCE, /NAV_TEXT_MAX/);
   assert.match(SOURCE, /el\.id === NAV_ENTRY_ID/);

package/packages/dsh-remote-web/test/settings-open-path.test.mjs

@@ -0,0 +1,102 @@
+/**
+ * 「点入口怎么打开设置」契约测试（2026-10-11 业主反馈后的最终形态）。
+ *
+ * 背景（业主原话）：
+ *   ① 「账号菜单里面的那个删掉。只保留官方槽位的那个。」
+ *   ② 「设置界面出现了两个远程访问菜单。」—— 因为账号菜单注入的判据里加了"以设置结尾"，
+ *      而「通用设置」正好以"设置"结尾 → 注入行被插进了**设置面板**里，多出一个"远程访问"。
+ *   ③ 「点击……会触发一个小弹窗，同时也会把设置反馈的弹窗呼出来，有一瞬间会闪出一下，体验不好。」
+ *      —— 那是"点账号菜单 → 再点设置"这条路带来的中间弹层。
+ *
+ * 现在的契约：
+ *   · **不再往账号菜单里插任何东西**（dru-menu-row / accountMenuInjectTick 一律不得回来）；
+ *   · 侧栏入口在桌面端用**官方设置快捷键**（⌥⌘, / Alt+Meta+,）直接打开设置面板，
+ *     不产生任何中间弹层；打开后自动点中我们的栏目；
+ *   · 面板里只能有**一个**「远程访问」栏目。
+ */
+
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const SOURCE = readFileSync(join(dirname(fileURLToPath(import.meta.url)), "..", "lib", "client.js"), "utf8");
+
+/** 把快捷键打开逻辑切出来，在最小环境里跑一遍。 */
+function loadShortcut({ sectionFound = true } = {}) {
+  const start = SOURCE.indexOf("function openSettingsViaShortcut()");
+  assert.ok(start > 0, "应能定位 openSettingsViaShortcut");
+  const end = SOURCE.indexOf("/**\n     * 打开「远程访问」设置栏目。", start);
+  assert.ok(end > start, "应能定位函数结尾");
+  const src = SOURCE.slice(start, end);
+
+  const dispatched = [];
+  const clicked = [];
+  class KeyboardEvent {
+    constructor(type, init) { this.type = type; Object.assign(this, init); }
+  }
+  const document = { dispatchEvent: (e) => { dispatched.push(e); return true; } };
+  const pickNavByToken = () => (sectionFound ? { click: () => clicked.push("远程访问") } : null);
+  const fn = new Function(
+    "document", "KeyboardEvent", "navTrace", "pickNavByToken", "NAV_POLL_MAX", "setInterval", "clearInterval",
+    `${src}; return openSettingsViaShortcut;`
+  )(document, KeyboardEvent, () => {}, pickNavByToken, 3, (f) => { f(); return 1; }, () => {});
+  return { run: fn, dispatched, clicked };
+}
+
+test("★ 用官方设置快捷键（⌥⌘,）直接打开：不经过任何中间弹层", () => {
+  const { run, dispatched } = loadShortcut();
+  run();
+  assert.equal(dispatched.length, 1, "应恰好派发一次快捷键事件");
+  const ev = dispatched[0];
+  assert.equal(ev.type, "keydown");
+  assert.equal(ev.key, ",");
+  assert.equal(ev.code, "Comma");
+  assert.equal(ev.metaKey, true, "必须带 Meta（⌘）");
+  assert.equal(ev.altKey, true, "必须带 Alt（⌥）—— 与设置行自带的 aria-keyshortcuts=\"Alt+Meta+,\" 一致");
+});
+
+test("★ 设置面板打开后自动点中「远程访问」栏目", () => {
+  const { run, clicked } = loadShortcut({ sectionFound: true });
+  run();
+  assert.deepEqual(clicked, ["远程访问"], "面板开了要顺手切到我们的栏目");
+});
+
+test("★ 不再往账号菜单里插任何东西（业主明确要求删掉）", () => {
+  for (const banned of ["dru-menu-row", "accountMenuInjectTick", "MENU_ENTRY_SIG"]) {
+    assert.ok(!SOURCE.includes(banned), `不得再往账号菜单里插条目：${banned}（已按业主要求删除）`);
+  }
+});
+
+test("★ 打开设置的顺序：侧栏候选 → 快捷键(验证) → 账号菜单(兜底)", () => {
+  // 桌面端的 ⌥⌘, 是**原生菜单加速键**，合成 DOM 事件打不动它（真机实测"点了没反应"）；
+  // 而"设置"只存在于账号菜单里 → 必须保留这条兜底，但只能在前面都失败后才走（它会闪一下）。
+  assert.match(SOURCE, /open:shortcut-no-effect→account-menu/, "快捷键无效时必须转投账号菜单兜底");
+  const shortcutAt = SOURCE.indexOf("function openSettingsViaShortcut()");
+  const menuAt = SOURCE.indexOf("function openSettingsViaAccountMenu()");
+  assert.ok(shortcutAt > 0 && menuAt > 0, "两条路径都要在");
+  // 菜单兜底里必须带上"不是设置面板"的排除（否则会把设置面板当成账号菜单）
+  assert.match(SOURCE, /indexOf\("通用设置"\) !== -1\) continue;/, "识别账号菜单时必须排除设置面板本身");
+});
+
+test("★ 「设置」行判据：认「设置 ⌥ ⌘ ,」，绝不认「通用设置」", () => {
+  const start = SOURCE.indexOf("function menuRowIsSettings(");
+  assert.ok(start > 0, "应有 menuRowIsSettings");
+  const end = SOURCE.indexOf("function accountMenuTrigger()", start);
+  const fn = new Function(`${SOURCE.slice(start, end)}; return menuRowIsSettings;`)();
+  const mk = (t) => ({ textContent: t });
+  assert.equal(fn(mk("设置 ⌥ ⌘ ,")), true, "真实文案带快捷键，必须认得");
+  assert.equal(fn(mk("设置")), true, "纯文案也要认得");
+  assert.equal(fn(mk("Settings")), true, "英文界面");
+  assert.equal(fn(mk("通用设置")), false, "★ 绝不能认「通用设置」——2026-10-11 两个『远程访问』就是它造成的");
+  assert.equal(fn(mk("📱 远程访问")), false, "不能认我们自己的入口");
+  assert.equal(fn(mk("意见反馈")), false);
+});
+
+test("★ 反复出现的坑：判据不得用「以设置结尾」（会命中「通用设置」）", () => {
+  // 这次设置面板里冒出两个「远程访问」，根因就是结尾匹配把「通用设置」当成了「设置」行。
+  // 直接把这种判据钉死：源码里不得再出现「以设置/Settings 结尾」的正则片段。
+  assert.ok(!SOURCE.includes("(设置|Settings)$"), "不得再用「以设置结尾」的判据");
+  assert.ok(!SOURCE.includes("(设置|Settings)/$"), "不得再用「以设置结尾」的判据（另一种写法）");
+});