@mrrisega/dsh-remote 0.7.0-beta.8 → 0.7.1-beta.1

package/clients/dsh-remote/mobile-adapter.mjs

@@ -52,7 +52,7 @@
  *   - JS 用结构探测(frame → 子列 → 打 dsh-ma-* 稳定类)承载布局,不以 hashed 类为唯一钩子;
  *   - 命中不到 frame 时静默跳过,页面保持官方默认,绝不报错/破坏。
  *
- * ⚠️ 官方 0.1.5-rc.2 起第三列改名(2026-09-19 线上事故,Windows 用户先撞到):
+ * ⚠️ 官方 0.1.5-rc.2 起第三列改名(2026-09-19 线上故障,Windows 用户先撞到):
  *   第三列 `pI_x6G_detailsCol` → `pI_x6G_rightbarCol`、`data-details-collapsed` →
  *   `data-rightbar-collapsed`,且折叠时不再渲染拖拽把手、`overlayLayer`(data-shell-overlay,
  *   inset:0 全屏)始终留在 frame 末尾。旧实现"详情抽屉兜底 = 取 frame 最后一个子元素"于是把
@@ -85,6 +85,30 @@
  *      ③ 遮罩不变量:只要遮罩在拦截点击而视口内没有任何可交互抽屉,立刻摘掉(800ms 看门狗 +
  *      300ms 复核),且**只摘遮罩不动展开 class**(不破坏抽屉的滑入动画与"点一下就打开")。
  *
+ * 🔴 2026-10-13 手机端设置面板「挤成一条竖线」根治(用户反馈,真机 390×844 + 本机 0.2 宿主实测):
+ *   现象:窄屏打开「设置」,左侧 nav(通用设置/模型/内置插件/…)是一条竖列,右侧内容被压成
+ *         四五字宽的竖条并向右溢出被裁。用户明确要求的目标形态:**tab 放顶部(横排)+ 下方内容满宽**。
+ *   根因(实测数字):官方设置弹层是**桌面两栏**布局 —— 本机 0.2.0-rc.2(dsh-web-frontend
+ *         0.2 + dsh-client-ui-settings-general 0.2)实测 panel 342×796、`nav` 188 宽(flex column)、
+ *         `content` 可视宽只剩 **154px**。而适配层只挂了 `[class~="VOzbGW_*"]` 精确类,那是
+ *         **0.1.2–0.1.5** 的混淆前缀;0.2 重新打包后前缀变成 **`Dws9Sa_*`**(结构、类名一一对应:
+ *         Dws9Sa_overlay/panel/nav/navTitle/navList/navCell/content/header/close/options)
+ *         → 整段设置区 CSS **静默失效**。这正是文件开头"类名变化退化策略"预言过的失效模式:
+ *         页面照常打开、只有真机看得出布局坏,而且没人会收到任何信号。
+ *   修法(三层识别,任一层命中即可成型,不再可能整段静默失效):
+ *     ① 已知前缀:`[class~="VOzbGW_*"]` 与 `[class~="Dws9Sa_*"]` 并挂(CSS 与 JS 都改);
+ *     ② **结构兜底**:JS 按 `[role=dialog]/[aria-modal] + 直接子 <nav> + 近似全屏` 认面板,
+ *        再按"子元素最多者为 tab 列表"认 navList,打 `dsh-ma-settings-*` 稳定类,由 CSS 成型
+ *        —— 前缀再改也是"仍然基本可用",而不是彻底坏掉;
+ *     ③ CSS `:has()` 兜底(`div[role="dialog"]:has(> nav)` 等):支持 :has 的浏览器连 JS 都不等。
+ *   降级诊断(**可见**,但不引入任何覆盖层 —— 护栏明令禁止):① 前缀认不出 → 报
+ *     `console.warn("[dsh-mobile-adapter]", …注意 …混淆前缀已变化…)` 一次;② 有"大弹层"却认不出
+ *     设置面板结构 → 报一次"手机端可能仍是桌面两栏布局"。两条都只在 ≤820px 发生。
+ *   同批:窄屏**通用弹层**按手机尺寸收敛(`[role=dialog]/[role=alertdialog]/[aria-modal]/.dru-popup-card`
+ *     宽 ≤ 100vw-24px、高 ≤ 100dvh-24px 且内部可滚、圆角收敛 12px),修掉"内容裁在右边"。
+ *   ⚠️ 顺序有讲究:通用弹层规则必须排在设置弹层规则**之前** —— 两者特异性相同,靠顺序让
+ *      "设置面板铺满全屏"赢(否则设置面板会被 100vw-24px 钉住,又变成带边的浮层)。
+ *
  * 开关:环境变量 DSH_MOBILE_ADAPTER=0 整体关闭(默认开启)。
  */
 
@@ -99,6 +123,17 @@ const HOST_FEATURE_RE =
 const RUNTIME_HOST_RE =
   /(data-sidebar-collapsed|data-details-collapsed|data-rightbar-collapsed|data-shell-overlay)|(pI_x6G_frame|hHd-Xa_root|hHd-Xa_toggle)/;
 
+/**
+ * 【可选】官方锚点清单 —— 供 scripts/check-ui-anchors.mjs 分类用(它直接读这个常量)。
+ * 这些名字**存在就用、不存在就按结构/几何退化**,所以它们缺失**不算故障**:
+ *   · data-details-collapsed —— 官方 0.1.5-rc.2 已改名 data-rightbar-collapsed,这里只为兼容旧版保留;
+ *   · data-sidebar-open      —— 官方是否输出这个属性本身就不确定(见下面对 sidebarAttrSeen 的注释),
+ *                               适配层刻意做了"认不到就只信几何"的分支;
+ *   · data-rtt               —— 适配层**自己**的延迟角标属性(不是官方锚点),列出只为让自检脚本不去它身上找。
+ * 约定:这里**只放**这种"缺了也无所谓"的锚点;凡是缺了会让布局坏掉的锚点,一律不要写进来。
+ */
+const OPTIONAL_UI_ANCHORS = ["data-details-collapsed", "data-sidebar-open", "data-rtt"];
+
 const STYLE = `
 
 @media (max-width: 820px) {
@@ -153,10 +188,10 @@ const STYLE = `
    ══════════════════════════════════════════════════════════════════════════════
    🚫 这里**故意什么都不写** —— 第三列（官方右栏）的显示/隐藏完全交还给官方。
    ══════════════════════════════════════════════════════════════════════════════
-   历史（2026-09-27 根治，业主拍板 B 方案）：
+   历史（2026-09-27 根治，用户拍板 B 方案）：
    0.6.13 起我们把这列改造成自绘浮层 —— position:fixed; right:0; width:min(92vw,400px);
    transform:translateX(103%)，再用 html.dsh-ma-details-open … { transform:none } 滑进来。
-   因为"自绘浮层会白框压屏"（2026-09-19 事故），又加了一道很严的闸门（必须"用户 8 秒内
+   因为"自绘浮层会白框压屏"（2026-09-19 故障），又加了一道很严的闸门（必须"用户 8 秒内
    在正文里点过"才允许滑入）；而 better-sidebar 这类插件只翻**它自己**的 store、官方
    cols.rightbar 永远是 0 → 闸门永远不开 → 于是又在悬浮菜单里补了颗「打开右侧栏」按钮。
    
@@ -188,7 +223,7 @@ const STYLE = `
     opacity: 0; pointer-events: none;
     transition: opacity .22s ease;
   }
-  /* ⚠️ 拦截点击**只认 dsh-ma-scrim-on 这一个闸**（2026-09-19 复盘）：
+  /* ⚠️ 拦截点击**只认 dsh-ma-scrim-on 这一个闸**（2026-09-19 回顾）：
      旧版还并列了一个「html.dsh-ma-details-open div.dsh-ma-scrim」规则，于是"详情展开判定出错"
      会直接变成"整屏被遮罩拦截"——官方 0.1.5 把第三列改名 rightbar 后就是这个死局。
      现在判定收口在 JS 里（必须有一个**真的在视口内、且不是全屏的**抽屉），
@@ -226,11 +261,42 @@ const STYLE = `
   div.wSkVaW_heroWorkspaceRow > * { max-width: calc(100vw - 32px); }
   div.wSkVaW_composerStack, div.wSkVaW_composerHero, div.uV2eYG_card { min-width: 0; }
 
-  /* --- 设置面板(fix2 硬化版;实测 390×844:官方模块 CSS 运行期注入在适配层之后,
-        普通规则会被官方后加载样式覆盖——nav 是 <nav> 而非 div,圆1 的 div.VOzbGW_nav
-        从未命中;overlay 被官方宽度 min(800px,84vw) 钉在左侧 328px,呈“抽屉感”。
-        故本版全部用 [class~=...] 精确类 + 几何 !important,官方前缀变化则整段静默失效) --- */
-  [class~="VOzbGW_overlay"] {
+  /* ===== 通用弹层(dialog/modal)按手机尺寸收敛(2026-10-13)=====
+     官方弹层(设置 / 审批 / 确认 / 各类 modal)在桌面上写死 px 宽高,窄屏会右溢被裁;
+     本项目自己的 .dru-popup 卡片同理。这里只加三条**尺寸**硬约束,不动配色与结构:
+       · 宽 ≤ 100vw - 24px(两侧各留 12px)—— 用户报的"内容裁在右边"根治;
+       · 高 ≤ 100dvh - 24px 且自身可滚(先写 100vh 给不认 dvh 的老浏览器兜底);
+       · 窄屏圆角收敛到 12px(官方 --dsw-radius-panel 在手机上偏大)。
+     ⚠️ 必须放在设置弹层规则**之前**:两者特异性相同,靠顺序让"设置面板铺满全屏"赢。 */
+  [role="dialog"], [role="alertdialog"], [aria-modal="true"], .dru-popup-card {
+    box-sizing: border-box;
+    max-width: calc(100vw - 24px) !important;
+    max-height: calc(100vh - 24px) !important;
+    max-height: calc(100dvh - 24px) !important;
+    border-radius: 12px !important;
+    overflow: auto !important;
+    overscroll-behavior: contain;
+    -webkit-overflow-scrolling: touch;
+  }
+  /* .dru-popup 是遮罩层,卡片 .dru-popup-card 才是"弹窗":窄屏把 24px 外边距收到 12px */
+  .dru-popup { padding: 12px !important; }
+  .dru-popup-card { width: 100% !important; max-width: calc(100vw - 24px) !important; }
+
+  /* ===== 设置弹层:窄屏「顶部横向 tab 行 + 下方内容区满宽」(2026-10-13 重写)=====
+     🔴 根因(真机 390×844 实测,用户报「设置界面挤成一条竖线」):
+        官方弹层是**桌面两栏** —— 0.2.0-rc.2 实测 panel 342×796、nav 188 宽竖排、
+        content(内容区)只剩 **154px** 可视宽 → 内容被压成竖条并向右溢出被裁。
+        旧实现只有 [class~="VOzbGW_*"](0.1.2–0.1.5 的混淆前缀);0.2.0-rc.2 重新打包后
+        前缀变成 Dws9Sa_*,**整段 CSS 静默失效** —— 页面照常打开,只有真机看得出坏。
+        所以识别分三层,任一层命中即可成型(这是"不再静默失效"的核心):
+          ① 已知前缀 [class~="VOzbGW_*"] / [class~="Dws9Sa_*"](最短路径,随版本追加);
+          ② JS 结构识别后打的稳定类 .dsh-ma-settings-*(role=dialog + 直接子 <nav> + 几何,
+             见脚本里的 maTagSettingsDialog)—— 前缀再改也照样生效;
+          ③ CSS :has() 兜底(div[role="dialog"]:has(> nav) 等),不必等 JS 就能成型。
+     ⚠️ 全部 !important:官方模块 CSS 是**运行期**注入 head 的(晚于本 <style>),
+        同特异性下后加载者赢 —— fix2 之前 nav 选择器"从未命中"正是这个原因。 */
+  [class~="VOzbGW_overlay"], [class~="Dws9Sa_overlay"], .dsh-ma-settings-overlay,
+  div[role="presentation"]:has(> div[role="dialog"] > nav) {
     position: fixed !important;
     inset: 0 !important;
     width: auto !important; max-width: none !important;
@@ -240,31 +306,37 @@ const STYLE = `
     box-sizing: border-box;
     justify-content: center; align-items: stretch;
   }
-  [class~="VOzbGW_panel"] {
+  /* 面板:nav 在上、content 在下的**竖排**,并铺满视口(圆角/外边距在窄屏收敛为 0) */
+  [class~="VOzbGW_panel"], [class~="Dws9Sa_panel"], .dsh-ma-settings-panel,
+  div[role="dialog"]:has(> nav) {
     box-sizing: border-box;
     width: 100% !important; max-width: 100% !important;
     height: 100% !important; max-height: 100% !important;
     margin: 0 !important; border-radius: 0 !important;
     flex-direction: column !important;
+    overflow: hidden !important; /* 内层 options 自己滚 */
   }
   /* 顶部 tab 行:整行铺满,字号调小(≤13px),横向可滚动 */
-  [class~="VOzbGW_nav"] {
+  [class~="VOzbGW_nav"], [class~="Dws9Sa_nav"], .dsh-ma-settings-nav,
+  div[role="dialog"] > nav {
     box-sizing: border-box;
     flex: none;
     width: 100% !important;
     flex-direction: row !important;
     align-items: center;
     gap: 4px;
-    padding: max(4px, env(safe-area-inset-top)) 4px 0;
+    padding: max(4px, env(safe-area-inset-top)) 8px 6px;
     overflow: visible;
   }
-  [class~="VOzbGW_navTitle"] {
+  [class~="VOzbGW_navTitle"], [class~="Dws9Sa_navTitle"], .dsh-ma-settings-navtitle,
+  div[role="dialog"] > nav > :first-child {
     flex: none;
     font-size: 13px !important; line-height: 1.2;
     padding: 0 4px 0 8px;
     white-space: nowrap;
   }
-  [class~="VOzbGW_navList"] {
+  [class~="VOzbGW_navList"], [class~="Dws9Sa_navList"], .dsh-ma-settings-navlist,
+  div[role="dialog"] > nav > :last-child {
     box-sizing: border-box;
     flex: 1 1 auto; min-width: 0;
     flex-direction: row !important;
@@ -274,33 +346,40 @@ const STYLE = `
     scrollbar-width: none;
     padding: 0 0 6px;
   }
-  [class~="VOzbGW_navList"]::-webkit-scrollbar { display: none; }
-  [class~="VOzbGW_navCell"] {
+  [class~="VOzbGW_navList"]::-webkit-scrollbar,
+  [class~="Dws9Sa_navList"]::-webkit-scrollbar,
+  .dsh-ma-settings-navlist::-webkit-scrollbar { display: none; }
+  [class~="VOzbGW_navCell"], [class~="Dws9Sa_navCell"], .dsh-ma-settings-cell,
+  div[role="dialog"] > nav > :last-child > * {
     flex: none; min-width: max-content;
     box-sizing: border-box;
     font-size: 13px !important;
     height: 32px !important;
     padding: 0 12px !important;
+    white-space: nowrap;
   }
   /* 内容区:全宽拉满,收敛内边距,最大化有效宽度 */
-  [class~="VOzbGW_content"] {
+  [class~="VOzbGW_content"], [class~="Dws9Sa_content"], .dsh-ma-settings-content,
+  div[role="dialog"]:has(> nav) > div {
     box-sizing: border-box;
     width: 100% !important; max-width: none !important;
     flex: 1 1 auto; min-width: 0; min-height: 0;
   }
-  [class~="VOzbGW_header"] {
+  [class~="VOzbGW_header"], [class~="Dws9Sa_header"], .dsh-ma-settings-header {
     box-sizing: border-box;
     flex: none;
-    min-height: 40px;
+    min-height: 40px; height: auto !important;
     padding: 6px 8px 4px 14px !important;
     align-items: center;
   }
-  [class~="VOzbGW_close"] { width: 32px; height: 32px; }
-  [class~="VOzbGW_options"] {
+  [class~="VOzbGW_close"], [class~="Dws9Sa_close"], .dsh-ma-settings-close {
+    width: 32px !important; height: 32px !important;
+  }
+  [class~="VOzbGW_options"], [class~="Dws9Sa_options"], .dsh-ma-settings-options {
     box-sizing: border-box;
     flex: 1 1 auto; min-height: 0; overflow-y: auto;
     -webkit-overflow-scrolling: touch;
-    padding: 2px 14px calc(14px + env(safe-area-inset-bottom)) !important;
+    padding: 4px 14px calc(14px + env(safe-area-inset-bottom)) !important;
   }
 }
 
@@ -524,7 +603,7 @@ const SCRIPT = `(() => {
   "use strict";
 
   /* ===== 【0.6.16 已删除】首屏加载提示层（0.6.14 引入，0.6.15 仍在）=====
-     为什么删掉（业主实测，2026-09-25）：「界面都已经加载完了，十几秒就把插件的接口加载好了，
+     为什么删掉（用户实测，2026-09-25）：「界面都已经加载完了，十几秒就把插件的接口加载好了，
      但这个遮罩一直不消失」—— 截图里官方 UI 就在下面透出来，秒表走到 187 秒。
 
      根因是**设计错误**，不是某个选择器写错：
@@ -535,7 +614,7 @@ const SCRIPT = `(() => {
          官方改版、会话尚未挂载输入框、或前缀变化时两组信号全不命中 → 层就永远留着。
        · 当时我给自己写的安慰是「pointer-events:none，万一移除失效也绝不挡住点击」——
          可对用户来说，**盖住视线和进不去没有区别**：刷新也一样，每次都要等 4 分钟兜底。
-     结论（业主要求）：**直接删掉这个功能**。首屏反馈交给官方自己的转圈；
+     结论（用户要求）：**直接删掉这个功能**。首屏反馈交给官方自己的转圈；
      我们不再在用户页面上放任何会覆盖整屏的东西 —— 这类层一旦判断失误就是"永远进不去"，
      代价远大于它带来的提示价值（何况限速放开后首屏本来就快了）。
 
@@ -579,7 +658,7 @@ const SCRIPT = `(() => {
 
   /* ===== 「加载疑似没完成」看门狗（2026-09-25，替代被整块删除的首屏提示层）=====
      那个提示层是全屏覆盖 + 启发式退出 —— 判断错一次就把**已经加载完**的界面永久盖住
-     （业主实测：秒表走到 187 秒，刷新也一样）。所以这里换一条**安全的失败方向**：
+     （用户实测：秒表走到 187 秒，刷新也一样）。所以这里换一条**安全的失败方向**：
 
        · 解析期**不创建任何 DOM**（只有几个变量 + 一个定时器）—— 页面还没过主机门，
          更不该有任何覆盖层；
@@ -614,13 +693,13 @@ const SCRIPT = `(() => {
     return Date.now();
   }
   /**
-   * 镜像页就绪耗时（毫秒）——**口径见 docs/TELEMETRY-CONTRACT.md / 迭代冻结文档 §2.3**：
+   * 镜像页就绪耗时（毫秒）——**约定见 docs/TELEMETRY-CONTRACT.md / 迭代冻结文档 §2.3**：
    *   · 起点 = **导航开始**（performance.now() 的零点 = performance.timeOrigin ≈ 导航开始），
    *     所以一条值同时覆盖 DNS+TLS+HTML TTFB + 解析 + 界面就绪；
    *   · **不能**用 Date.now() - maLoadWatch.startedAt：那个起点是"注入脚本解析时刻"，会**漏掉
    *     HTML TTFB**（HAR 实测那 79 秒里 TTFB 就有 8.7 秒），报出来的数会系统性小于用户体感；
-   *     而且 bfcache 恢复（pageshow persisted）不会重置 startedAt，那口径还能报出几十分钟。
-   *   · 没有 performance 时退化回 startedAt 口径（老浏览器兜底，宁可粗糙也不能漏报）。
+   *     而且 bfcache 恢复（pageshow persisted）不会重置 startedAt，那约定还能报出几十分钟。
+   *   · 没有 performance 时退化回 startedAt 约定（老浏览器兜底，宁可粗糙也不能漏报）。
    */
   function maLoadElapsedMs() {
     try {
@@ -995,13 +1074,177 @@ const SCRIPT = `(() => {
       whaleNativeDragToBottomRight();
     }
 
+    /* ===== 设置面板:结构识别 + 稳定类(2026-10-13;根因见 CSS 里那段长注释)=====
+       为什么不能只靠 [class~="VOzbGW_*"]:官方重新打包会换混淆前缀(0.1.5 = VOzbGW_,
+       0.2.0-rc.2 = Dws9Sa_),改名后整段 CSS **静默失效** —— 页面照常打开,
+       只是手机端布局坏掉,而且只有真机看得出。所以这里再按**结构 + 几何**认一遍:
+         · 面板 = [role=dialog]/[aria-modal] 且**直接子元素里有 <nav>**、尺寸接近全屏
+           (0.1.5 与 0.2 的面板都是 div[role=dialog] > nav + div 两栏,且都是固定像素宽);
+         · 列表 = nav 里子元素最多的那个孩子(单元格 ≥3 个);
+         · content = 面板里除 nav 之外的孩子;header/options = content 的首/末孩子。
+       命中 → 打 .dsh-ma-settings-* 稳定类,由 CSS 接管(前缀改名后**仍然基本可用**);
+       命中不到 → 原样放过(绝不破坏官方默认),只 warn 一次作为**可见的降级诊断**
+       —— 护栏禁止适配层引入全屏覆盖层,所以诊断只能走 console / 既有上报通道。 */
+    var MA_SETTINGS_PREFIX_RE = /(^|\s)(VOzbGW_|Dws9Sa_)/;
+    var maSettingsPanelEl = null;   // 已识别的面板(靠 isConnected 判存活,官方重渲染后自动重认)
+    var maSettingsCells = [];       // 已识别的 tab 单元格
+    var maSettingsNextScan = 0;     // 未命中时的扫描节流(见 maSettingsMaybeTag)
+    var maSettingsWarned = "";
+    function maSettingsWarn(msg) {
+      if (maSettingsWarned === msg) return;
+      maSettingsWarned = msg;
+      /* window.console 优先(镜像页里它就是页面控制台),拿不到再退到全局 console ——
+         诊断**必须**能出得来,否则"静默失效"只是换了个地方静默。 */
+      try {
+        var c = (typeof window !== "undefined" && window && window.console) || (typeof console !== "undefined" ? console : null);
+        if (c && c.warn) c.warn("[dsh-mobile-adapter]", msg);
+      } catch (eW) {}
+    }
+    function maClsOf(el) { try { return (el && typeof el.className === "string") ? el.className : ""; } catch (eC) { return ""; } }
+    function maKidsOf(el) { try { return (el && el.children) ? [].slice.call(el.children) : []; } catch (eK) { return []; } }
+    /** 面板级几何门:排除小气泡/菜单/下拉,只认接近全屏的弹层。 */
+    function maPanelSized(el) {
+      try {
+        var r = el.getBoundingClientRect();
+        if (!r || !(r.width > 0) || !(r.height > 0)) return false;
+        return r.width >= Math.max(240, window.innerWidth * 0.5) && r.height >= 160;
+      } catch (eG) { return false; }
+    }
+    /** 结构识别:找到官方设置面板(flex 两栏 = 直接子 <nav> + 另一栏)。 */
+    function maFindSettingsPanel() {
+      var cands = [];
+      try {
+        cands = [].slice.call(document.querySelectorAll('[role="dialog"], [role="alertdialog"], [aria-modal="true"]'));
+      } catch (eQ) { return null; }
+      var best = null, bestArea = 0;
+      for (var i = 0; i < cands.length; i++) {
+        var el = cands[i];
+        var kids = maKidsOf(el);
+        if (kids.length < 2) continue;              // 两栏才有 content 可谈
+        var nav = null;
+        for (var j = 0; j < kids.length; j++) { if (kids[j] && kids[j].tagName === "NAV") { nav = kids[j]; break; } }
+        if (!nav || maKidsOf(nav).length < 2) continue;  // 设置面板的 nav = 标题 + tab 列表
+        if (!maPanelSized(el)) continue;
+        var r = el.getBoundingClientRect();
+        var area = r.width * r.height;
+        if (area > bestArea) { bestArea = area; best = el; }
+      }
+      return best;
+    }
+    /** nav 里的 tab 列表 = 子元素最多的那个孩子(标题只有一个文本孩子)。 */
+    function maNavListOf(nav) {
+      var kids = maKidsOf(nav);
+      if (!kids.length) return null;
+      var best = null, bestN = 0;
+      for (var i = 0; i < kids.length; i++) {
+        var n = maKidsOf(kids[i]).length;
+        if (n > bestN) { bestN = n; best = kids[i]; }
+      }
+      return bestN >= 2 ? best : (kids.length > 1 ? kids[kids.length - 1] : null);
+    }
+    /** 当前选中项:官方状态类(任意前缀 + _active)或 aria-current —— 两者都不依赖前缀。 */
+    function maCellActive(cell) {
+      try {
+        if (cell.getAttribute && cell.getAttribute("aria-current") === "true") return true;
+        /* 只认「整段 token 以 _active 结尾」或「token 就叫 active」——
+           不能用 *active 这种宽松匹配:inactive 也会命中,会把没选中的 tab 当成当前项。
+           ⚠️ 本文件是模板字符串,注释里**不得出现反引号**(会提前闭合注入体,见 AGENTS.md)。 */
+        return /(^|\s)(?:[A-Za-z0-9_-]+_active|active)(\s|$)/.test(maClsOf(cell));
+      } catch (eA) { return false; }
+    }
+    function maMarkActiveCells() {
+      for (var i = 0; i < maSettingsCells.length; i++) {
+        var c = maSettingsCells[i];
+        try { if (c && c.isConnected && maCellActive(c)) c.classList.add("dsh-ma-settings-active"); } catch (eM) {}
+      }
+    }
+    function maTagSettingsDialog() {
+      var panel = maFindSettingsPanel();
+      if (!panel) {
+        /* 认不到面板时给一条**可见的**降级诊断:现场是"大弹层 + 首栏比次栏窄"的桌面两栏形态,
+           说明官方又换了结构(或换成了我们不认识的前缀)—— 这条 warn 就是下次定位问题的起点。 */
+        try {
+          var any = document.querySelector('[role="dialog"], [aria-modal="true"]');
+          if (any && maPanelSized(any)) {
+            maSettingsWarn("检测到大弹层但未能识别为设置面板(官方结构/类名可能已变化):手机端可能仍是桌面两栏布局。");
+          }
+        } catch (eAny) {}
+        maSettingsPanelEl = null; maSettingsCells = [];
+        return;
+      }
+      var kids = maKidsOf(panel);
+      var nav = null, content = null;
+      for (var i = 0; i < kids.length; i++) {
+        if (!nav && kids[i].tagName === "NAV") { nav = kids[i]; continue; }
+        if (!content) content = kids[i];
+      }
+      var list = nav ? maNavListOf(nav) : null;
+      var title = null;
+      var navKids = maKidsOf(nav);
+      for (var k = 0; k < navKids.length; k++) { if (navKids[k] !== list) { title = navKids[k]; break; } }
+      var contentKids = maKidsOf(content);
+      var header = contentKids[0] || null;
+      var options = contentKids.length > 1 ? contentKids[contentKids.length - 1] : null;
+      var overlay = null;
+      try {
+        var p = panel.parentElement || panel.parent || null;   // parentElement 是标准属性;parent 兜底给极简 DOM
+        if (p && p.getBoundingClientRect) {
+          var pr = p.getBoundingClientRect();
+          if (pr && pr.width >= window.innerWidth * 0.9 && pr.height >= window.innerHeight * 0.9) overlay = p;
+        }
+      } catch (eP) {}
+      try {
+        panel.classList.add("dsh-ma-settings-panel");
+        if (nav) nav.classList.add("dsh-ma-settings-nav");
+        if (title) title.classList.add("dsh-ma-settings-navtitle");
+        if (list) list.classList.add("dsh-ma-settings-navlist");
+        if (content) content.classList.add("dsh-ma-settings-content");
+        if (header) header.classList.add("dsh-ma-settings-header");
+        if (options) options.classList.add("dsh-ma-settings-options");
+        if (overlay) overlay.classList.add("dsh-ma-settings-overlay");
+        maSettingsCells = list ? maKidsOf(list) : [];
+        for (var c = 0; c < maSettingsCells.length; c++) maSettingsCells[c].classList.add("dsh-ma-settings-cell");
+        maMarkActiveCells();
+      } catch (eT) { /* 打类失败也要继续:已知前缀那条 CSS 仍可能命中 */ }
+      maSettingsPanelEl = panel;
+      /* 前缀认不出 = 官方改名的**直接信号** —— 这时布局靠结构类仍然可用,所以只警告不降级。 */
+      if (!MA_SETTINGS_PREFIX_RE.test(maClsOf(panel) + " " + maClsOf(nav))) {
+        maSettingsWarn("设置面板已按**结构**识别(官方混淆前缀已变化:既不是 VOzbGW_ 也不是 Dws9Sa_);布局仍可用,但请把新前缀补进适配层。");
+      }
+    }
+    /**
+     * 每拍调用(节流):已识别且面板还在文档里 → 只刷新选中态;否则限频重扫。
+     * 为什么要节流:未命中时每拍都要 querySelectorAll 一遍全文档,流式输出时每帧一拍。
+     */
+    function maSettingsMaybeTag() {
+      if (!NARROW()) return;
+      try {
+        if (maSettingsPanelEl && maSettingsPanelEl.isConnected) { maMarkActiveCells(); return; }
+      } catch (eLive) { /* 掉进重扫 */ }
+      var now = Date.now();
+      if (now < maSettingsNextScan) return;
+      maSettingsNextScan = now + 400;   // 未命中时最多 2.5 次/秒;命中后面板引用直接短路,不再全扫
+      maTagSettingsDialog();
+    }
+
     /* 设置面板打开时,把当前 tab 滚进横向可视区(顶部 tab 行手机横向滚动) */
     let settingsWatchOn = false;
     let settingsTick = 0;
     function scrollActiveSettingsTab() {
-      const act = document.querySelector(
-        '[class~="VOzbGW_navCell"].VOzbGW_active, [class~="VOzbGW_navCell"][aria-current="true"]'
-      );
+      /* 逐个尝试而不是写一条长选择器:结构类(前缀无关)优先,已知前缀退居兜底;
+         任何一条在旧浏览器上解析失败都不影响其余。 */
+      const SEL = [
+        ".dsh-ma-settings-cell.dsh-ma-settings-active",
+        '[class~="Dws9Sa_navCell"].Dws9Sa_active',
+        '[class~="VOzbGW_navCell"].VOzbGW_active',
+        '[class~="Dws9Sa_navCell"][aria-current="true"]',
+        '[class~="VOzbGW_navCell"][aria-current="true"]'
+      ];
+      let act = null;
+      for (const sel of SEL) {
+        try { act = document.querySelector(sel); } catch (e13a) { act = null; }
+        if (act) break;
+      }
       if (act && act.scrollIntoView) {
         try { act.scrollIntoView({ block: "nearest", inline: "nearest" }); } catch (e13) {
           try { act.scrollIntoView(); } catch (e14) {}
@@ -1014,7 +1257,12 @@ const SCRIPT = `(() => {
       try {
         const ob = new MutationObserver(function () {
           clearTimeout(settingsTick);
-          settingsTick = setTimeout(function () { if (NARROW()) scrollActiveSettingsTab(); }, 140);
+          settingsTick = setTimeout(function () {
+            if (!NARROW()) return;
+            maSettingsNextScan = 0;             // 官方刚挂上面板:别被节流挡在门外
+            try { maSettingsMaybeTag(); } catch (e16) {}
+            scrollActiveSettingsTab();
+          }, 140);
         });
         ob.observe(document.body, { childList: true, subtree: true });
       } catch (e15) {}
@@ -1030,7 +1278,7 @@ const SCRIPT = `(() => {
     let fabDone = false;
 
     /* ===== 📶 网络延迟采样器（2026-10-10 二修，与"某一代菜单 DOM"彻底解耦）=================
-       一修（0.7.0-beta.3）改掉了"亚毫秒样本被丢弃"，但业主实测**仍然一直「测速中」**，
+       一修（0.7.0-beta.3）改掉了"亚毫秒样本被丢弃"，但用户实测**仍然一直「测速中」**，
        而同一时段镜像页打了 69 次 /api/agentPresets/list 这类**完全合格**的请求 ——
        说明真根因不是样本被过滤，而是**采样根本没接上**（或渲染写进了已被替换的旧节点）。
 
@@ -1300,15 +1548,15 @@ const SCRIPT = `(() => {
          （dsh-bridge.mjs:763 → :770），两者都 splice 到 </head> 前 → adapter 的 fetch 包装在
          **内层** → 它量到的是"去掉加解密后的真实网络往返"（这正是用户想要的"网速"）。
 
-         统计口径：最近 RTT_KEEP(8) 次**成功**样本取中位数。
+         统计约定：最近 RTT_KEEP(8) 次**成功**样本取中位数。
            · 用中位数而不是均值/EWMA：偶发的一次 GC/系统调度卡顿会把均值永久带偏，
              中位数对单次离群点免疫，同时比"最小值"更贴近体感（最小值永远偏乐观）；
            · 失败（reject）/超时（>20s）/亚毫秒（同一帧内的缓存命中）都不进样本：
              前者不是网络耗时，后者会算出 0ms 这种"谎言"；
            · **无样本时显示「测速中…」而不是 0ms** —— 0ms 会让人以为网络飞快。
-         分档（2026-09-27 业主口径调整）：≤500ms 顺畅 / ≤1000ms 正常 / ≤2000ms 偏慢 / >2000ms 很慢。
+         分档（2026-09-27 用户约定调整）：≤500ms 顺畅 / ≤1000ms 正常 / ≤2000ms 偏慢 / >2000ms 很慢。
          为什么放宽：这是个**文本窗口**的远程操作界面（看输出、敲字、点按钮），
-         对往返延迟本来就宽容 —— 业主原话「500ms 以内的延迟都不叫事，1000ms 使用起来也是正常流畅的」。
+         对往返延迟本来就宽容 —— 用户原话「500ms 以内的延迟都不叫事，1000ms 使用起来也是正常流畅的」。
          旧的 120/300 分档是照"网页首屏"的体感定的，会把大量正常可用的移动网络误报成"较慢"，
          反而让用户以为哪里坏了。 */
       const RTT_KEEP = 8, RTT_MAX_MS = 20000;
@@ -1323,7 +1571,7 @@ const SCRIPT = `(() => {
         const mid = s.length >> 1;
         return s.length % 2 ? s[mid] : Math.round((s[mid - 1] + s[mid]) / 2);
       };
-      /* 分档（2026-09-27 按业主口径放宽）：文本窗口的远程操作，500ms 内都算顺畅、1000ms 内正常流畅。
+      /* 分档（2026-09-27 按用户约定放宽）：文本窗口的远程操作，500ms 内都算顺畅、1000ms 内正常流畅。
          ok=顺畅 / mid=正常 / slow=偏慢 / bad=很慢 —— 颜色只用于区分，**不把"正常"渲染成告警色**。 */
       const rttGrade = (ms) => (ms <= 500 ? "ok" : ms <= 1000 ? "mid" : ms <= 2000 ? "slow" : "bad");
       const rttLabel = (g) => (g === "ok" ? "顺畅" : g === "mid" ? "正常" : g === "slow" ? "偏慢" : "很慢");
@@ -1357,7 +1605,7 @@ const SCRIPT = `(() => {
             if (ico) ico.textContent = shown === null ? "📶" : (g === "bad" ? "📵" : "📶");
             if (txt) {
               /* 空态**说清原因**（2026-10-10）：以前只有一句「等一次网络请求后显示」，
-                 于是"采样器压根没接上"和"接上了但还没有请求"长得一模一样，业主两次反馈
+                 于是"采样器压根没接上"和"接上了但还没有请求"长得一模一样，用户两次反馈
                  我们都只能猜。现在一眼可分。 */
               txt.textContent = shown !== null ? (shown + " ms · " + rttLabel(g))
                 : (maNetPatch.ok ? "测速中…（已接上，等一次请求）" : "测速中…（采样器未接上）");
@@ -1585,7 +1833,7 @@ const SCRIPT = `(() => {
       frame.classList.add("dsh-ma-frame");
 
       /* 给 frame 子列打稳定标记(dsh-ma-*),规避官方类名前缀随构建变化。
-         ⚠️ 必须先把**不是列**的节点剔掉（2026-09-19 事故根因）：
+         ⚠️ 必须先把**不是列**的节点剔掉（2026-09-19 故障根因）：
             · overlayLayer（data-shell-overlay / *overlayLayer*）= 官方 shell.overlay 宿主，inset:0 全屏，
               在 0.1.5-rc.2 里**始终**是 frame 的最后一个子元素；
             · 拖拽把手（*handle* / [data-side]）= 8px 宽绝对定位条（折叠时官方根本不渲染）。
@@ -1622,7 +1870,7 @@ const SCRIPT = `(() => {
            ① 已经判定为第三列(rightbar/details 类名)的列,**绝不是**抽屉列;
            ② 类名含 sidebar 且不含 rightbar/details(0.1.2/0.1.5 的 pI_x6G_sidebarCol 都满足);
            ③ 退到结构信号:列里有官方侧栏组件根 .hHd-Xa_root,或有**整串**匹配的官方侧栏开合按钮
-              (精确匹配,绝不再用 *="sidebar" 这种包含匹配 —— 那正是事故来源);
+              (精确匹配,绝不再用 *="sidebar" 这种包含匹配 —— 那正是故障来源);
            ④ 同时给 CSS 加了 :not(.dsh-ma-details) 兜底:万一将来又标重,详情列的样式也必须赢。 */
       const SIDEBAR_RE = /sidebar/i;
       const NOT_SIDEBAR_RE = /rightbar|right-bar|details/i;
@@ -1742,7 +1990,7 @@ const SCRIPT = `(() => {
          只要官方属性语义与我们理解的不一致，光看属性就可能误判；而遮罩一旦拦截整屏，
          用户看到的就是"整屏阴影 + 点哪都没反应"。以实测几何为准（isDrawer），误判也不会挡住用户。 */
       /* 抽屉必须"像抽屉"：不是全屏层（overlay 层/主内容区都被排除在外）、不是拖拽把手、
-         **与视口真正相交**。任一不满足 → 它就不该让遮罩拦截点击（0.1.5 事故的结构性防线）。
+         **与视口真正相交**。任一不满足 → 它就不该让遮罩拦截点击（0.1.5 故障的结构性防线）。
          ⚠️ 2026-09-19 手机实测第二波:旧实现只查 r.right > 8,这对"向右滑出屏外"的第三列是
             **恒真**的 —— 抽屉滑出时右边坐标是很大的正数(实测 left=400,right=759,width=358),
             于是"完全看不见、一个像素都没露"的第三列被判成"展开的详情列":
@@ -1809,7 +2057,7 @@ const SCRIPT = `(() => {
       let officialExpandedSeen = false;
       let lastOfficialCollapsed = null;
       let scrimTimer = 0, scrimWatchdog = 0;
-      /* ❌ 这里曾有「详情列(第三列)在手机端的显示条件」整段判据（白框事故后打的四层闸门）。
+      /* ❌ 这里曾有「详情列(第三列)在手机端的显示条件」整段判据（白框故障后打的四层闸门）。
          2026-09-27 根治时删除：第三列的显隐**完全交还官方** —— 宽屏按 grid 列、窄屏全屏浮层。
          我们不再有"要不要显示它"的决定权，也就不需要任何判据。 */
 
@@ -2056,6 +2304,9 @@ const SCRIPT = `(() => {
       if (!whaleGuardsOn || !settingsWatchOn) {
         try { whaleHookInit(); watchSettings(); } catch (eHook) { /* 两者内部都自带一次性守卫 */ }
       }
+      /* 设置面板结构识别(自带节流,幂等):官方每次重新打包都换混淆前缀,
+         这一步保证"改名后仍然基本可用",而不是整段静默失效(2026-10-13 根因)。 */
+      try { maSettingsMaybeTag(); } catch (eSetTag) { /* 忽略 */ }
     };
     /* 节流:一次 DOM 变更往往产生几十条记录,逐条 boot() 就是忙轮询。
        统一合并成"本帧最多跑一次"(有 rAF 用 rAF,没有就退化成 0ms 宏任务) —— 天然去重。 */
@@ -2067,7 +2318,7 @@ const SCRIPT = `(() => {
       setTimeout(run, 0);
     };
     /* ===== 手机图片上传兼容（0.6.15）=====
-       业主反馈：「手机端无法识别图片」——现象是选了照片发出去，模型看不到图 / 当成普通文件。
+       用户反馈：「手机端无法识别图片」——现象是选了照片发出去，模型看不到图 / 当成普通文件。
 
        根因（官方 dsh web 客户端逻辑,dsh-client-ui-conversation 的 createDrafts）:
          · 只有 file.type ∈ {image/png, image/jpeg, image/webp, image/gif} 才走**图片**通道

package/clients/dsh-remote/test/bridge-gzip.test.mjs

@@ -234,7 +234,7 @@ test("集成:204 响应不压缩", async () => {
 });
 
 test("★ 回归:上游自己 gzip 过(content-encoding: gzip),bridge 仍必须重压回传", async () => {
-  /* 事故原貌(2026-09-23):
+  /* 故障原貌(2026-09-23):
    *   undici 的 fetch 会**自动解压** body,但**保留** `content-encoding: gzip` 响应头。
    *   旧代码把该头当作"buf 已编码"传给 maybeCompressResponse → 函数保守 return null →
    *   **永不重压**。于是线上 dsh web 的 /plugins/?? 聚合包(上游 gzip 后 5.12MB)

package/clients/dsh-remote/test/device-registration-report.test.mjs

@@ -1,4 +1,4 @@
-// 设备登记上报口径回归（2026-10 版本分析需求）。
+// 设备登记上报约定回归（2026-10 版本分析需求）。
 //
 // 【为什么必须有】生产反馈只能看到「插件版本」（install_version），从来拿不到
 //   「宿主 DeepSeek Harness 版本」—— 于是「是不是 DSH 升级导致的兼容性故障」这个问题