@mrrisega/dsh-remote 0.7.2 → 0.7.3-beta.2

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

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+/**
+ * 镜像页「旧浏览器兼容层」（2026-10-18 真机事故）。
+ *
+ * 事故：用户在 iPhone（iOS 16.1 / 17.3）打开镜像页永远卡住、出不来对话界面。
+ * mirror_diag 上报抓到真实错误：
+ *   · TypeError: Promise.withResolvers is not a function   （Safari 17.4+ 才有）
+ *   · AbortSignal.any is not a function                    （Safari 17.4+ 才有）
+ *   · SyntaxError: Unexpected token '{'（iOS 16.1 连新语法都不支持 → 只能提示升级）
+ *
+ * 本文件锁三件事：
+ *   ① 注入体最前面**真的补齐**了这两个运行时 API（vm 里删掉原生实现后跑，断言可用）；
+ *   ② 语法级不支持 / 典型兼容报错时，会显示**顶部轻量提示条**（可关闭、非全屏、z-index 低于 FAB）；
+ *   ③ 提示条只在"界面没就绪"时出现，绝不打扰正常页面。
+ */
+import assert from "node:assert/strict";
+import test from "node:test";
+import vm from "node:vm";
+import { injectMobileAdapter } from "../mobile-adapter.mjs";
+
+/** 取注入脚本原文。 */
+function adapterScript() {
+  const { html } = injectMobileAdapter("<!doctype html><html><head></head><body></body></html>");
+  const m = /<script id="[^"]*-js"[^>]*>([\s\S]*?)<\/script>/.exec(html);
+  assert.ok(m, "应能从注入结果里取出脚本");
+  return m[1];
+}
+function adapterCss() {
+  const { html } = injectMobileAdapter("<!doctype html><html><head></head><body></body></html>");
+  const m = /<style id="[^"]*-css"[^>]*>([\s\S]*?)<\/style>/.exec(html);
+  assert.ok(m, "应能从注入结果里取出样式");
+  return m[1];
+}
+/** 只取兼容层代码段（有 marker，便于独立执行）。 */
+function compatBlock() {
+  const src = adapterScript();
+  const i = src.indexOf("===DSH-MA-COMPAT-START===");
+  const j = src.indexOf("===DSH-MA-COMPAT-END===");
+  assert.ok(i > 0 && j > i, "兼容层应有 START/END 标记");
+  const bodyStart = src.indexOf("*/", i) + 2;           // START 注释结束
+  const bodyEnd = src.lastIndexOf("/*", j);              // END 注释开始（不要把它带进来）
+  return src.slice(bodyStart, bodyEnd);
+}
+
+test("★ 补齐 Promise.withResolvers 与 AbortSignal.any（老 Safari 缺这两项 → 页面永远起不来）", async () => {
+  // 造一个"老 Safari"环境：独立 fake realm —— 不污染宿主全局（Promise 无 withResolvers、
+  // AbortSignal 无 any；AbortController/Signal 行为与浏览器一致：abort 会派发 abort 事件）。
+  const listeners = new WeakMap();
+  class FakeAbortSignal {
+    constructor() { this.aborted = false; this.reason = undefined; }
+    addEventListener(type, fn) {
+      if (type !== "abort") return;
+      const arr = listeners.get(this) || [];
+      arr.push(fn);
+      listeners.set(this, arr);
+    }
+    removeEventListener() {}
+  }
+  class FakeAbortController {
+    constructor() { this.signal = new FakeAbortSignal(); }
+    abort(reason) {
+      const sig = this.signal;
+      if (sig.aborted) return;
+      sig.aborted = true;
+      sig.reason = reason;
+      for (const fn of listeners.get(sig) || []) {
+        try { fn({ target: sig }); } catch (e) { /* 忽略 */ }
+      }
+    }
+  }
+  const sandbox = { console, setTimeout, clearTimeout, AbortSignal: FakeAbortSignal, AbortController: FakeAbortController, Array, Object };
+  sandbox.globalThis = sandbox;
+  // 老 Safari：没有 withResolvers。用包装函数暴露 Promise 构造器（不带静态 withResolvers）
+  sandbox.Promise = function PromiseCompat(executor) { return new Promise(executor); };
+
+  vm.runInNewContext(compatBlock(), sandbox, { timeout: 5000 });
+
+  // ① withResolvers：结构正确、能 resolve
+  assert.equal(typeof sandbox.Promise.withResolvers, "function", "必须补出 Promise.withResolvers");
+  const wr = sandbox.Promise.withResolvers();
+  assert.equal(typeof wr.resolve, "function");
+  assert.equal(typeof wr.reject, "function");
+  assert.ok(wr.promise instanceof Promise);
+  let got = null;
+  wr.promise.then((v) => { got = v; });
+  wr.resolve(42);
+  await new Promise((r) => setImmediate(r));
+  assert.equal(got, 42, "补齐后的 promise 必须真的能用");
+
+  // ② AbortSignal.any：任一 signal 中断 → 合并 signal 跟着中断
+  assert.equal(typeof sandbox.AbortSignal.any, "function", "必须补出 AbortSignal.any");
+  const c1 = new sandbox.AbortController();
+  const c2 = new sandbox.AbortController();
+  const combined = sandbox.AbortSignal.any([c1.signal, c2.signal]);
+  assert.equal(combined.aborted, false);
+  c2.abort();
+  assert.equal(combined.aborted, true, "其中一个 abort → 合并 signal 必须 aborted");
+
+  // ③ 已经 aborted 的输入 → 立即返回 aborted 的 signal
+  const c3 = new sandbox.AbortController();
+  c3.abort();
+  assert.equal(sandbox.AbortSignal.any([c3.signal]).aborted, true);
+
+  // ④ 常用 ES2023 方法兜底（这些也在老 Safari 上缺失）
+  assert.equal(typeof sandbox.Array.prototype.findLast, "function");
+  assert.equal(typeof sandbox.Array.prototype.toSorted, "function");
+  assert.equal(typeof sandbox.Object.hasOwn, "function");
+  assert.equal(vm.runInNewContext("[1,2,3].findLast(function(n){return n<3})", sandbox), 2);
+});
+
+test("★ 语法级不支持（老 Safari 解析不了新语法）→ 探测为不兼容并给出原因", () => {
+  const sandbox = { console, setTimeout, clearTimeout };
+  sandbox.globalThis = sandbox;
+  sandbox.Promise = Promise;
+  sandbox.AbortSignal = AbortSignal;
+  // 模拟"新语法解析失败"：Function 构造器抛 SyntaxError（CSP 场景抛 EvalError 不应误判 —— 见下一条）
+  sandbox.Function = function () { const e = new SyntaxError("Unexpected token '{'"); throw e; };
+  vm.runInNewContext(compatBlock(), sandbox, { timeout: 5000 });
+  const compat = vm.runInNewContext("maCompat", sandbox);
+  assert.equal(compat.ok, false, "语法不支持必须判为不兼容");
+  assert.match(compat.why, /系统版本过旧/, "要给出人能看懂的原因（系统版本过旧）");
+});
+
+test("★ CSP 禁止 eval 抛 EvalError 时**不得**误判为老浏览器（否则正常用户会被吓到）", () => {
+  const sandbox = { console, setTimeout, clearTimeout };
+  sandbox.globalThis = sandbox;
+  sandbox.Promise = Promise;
+  sandbox.AbortSignal = AbortSignal;
+  // 补上 polyfill，确保唯一失败点是 EvalError
+  sandbox.Function = function () { const e = new Error("Blocked by CSP"); e.name = "EvalError"; throw e; };
+  // 让 withResolvers 存在，避免被当成缺失
+  sandbox.Promise = Object.assign(Promise, { withResolvers: Promise.withResolvers || function () { let a, b; const p = new Promise((r, j) => { a = r; b = j; }); return { promise: p, resolve: a, reject: b }; } });
+  vm.runInNewContext(compatBlock(), sandbox, { timeout: 5000 });
+  const compat = vm.runInNewContext("maCompat", sandbox);
+  assert.equal(typeof compat, "object");
+  // EvalError 不应产生"系统版本过旧"
+  assert.ok(!/系统版本过旧/.test(compat.why || ""), `CSP 的 EvalError 不得被判成语法不支持，实际 why=${compat.why}`);
+});
+
+test("★ 兼容提示条：顶部轻量条（非全屏、可关闭、z-index 低于 FAB），两个出口按钮齐全", () => {
+  const src = adapterScript();
+  const css = adapterCss();
+  assert.match(src, /dsh-ma-compatbar/, "注入体必须有兼容提示条");
+  assert.match(css, /div\.dsh-ma-compatbar\s*\{/, "必须有对应样式");
+  // 顶部轻量条：fixed top，限高；不得全屏
+  const barCss = css.slice(css.indexOf("div.dsh-ma-compatbar {"), css.indexOf("div.dsh-ma-compatbar[hidden]"));
+  assert.match(barCss, /position:\s*fixed/, "提示条应为浮层");
+  assert.match(barCss, /top:\s*0/, "应贴顶部（不挡对话区操作）");
+  assert.match(barCss, /max-height:/, "必须限高，不能占满屏");
+  assert.doesNotMatch(barCss, /(height|inset):\s*(100vh|0;)/, "不得写成全屏覆盖层（历史事故：全屏层曾永久盖住界面）");
+  // z-index 低于 FAB（400），保证悬浮菜单永远可点
+  const z = /z-index:\s*(\d+)/.exec(barCss);
+  assert.ok(z && Number(z[1]) < 400, `z-index 必须低于 FAB 400，实际 ${z && z[1]}`);
+  // 关闭按钮 + 两个出口
+  assert.match(src, /dsh-ma-compatbar-x/, "必须有 ✕ 关闭");
+  assert.match(src, /返回设备列表/, "必须有「返回设备列表」出口");
+  assert.match(src, /复制诊断信息/, "必须有「复制诊断信息」出口");
+});
+
+test("★ 提示只在界面没就绪时出现（正常页面绝不被这条打扰）", () => {
+  const src = adapterScript();
+  const fn = src.slice(src.indexOf("function maShowCompatBar("), src.indexOf("/** 页面脚本报出"));
+  assert.match(fn, /maLoadReadyNow\(\)/, "必须先判断页面已就绪，就绪则不提示");
+  assert.match(fn, /maLoadReadyNow\(\)\) return/, "就绪时直接 return");
+});
+
+test("★ 注入体完整性：无 </script>、可编译（老浏览器兜底代码不能自己把文档截断）", () => {
+  const src = adapterScript();
+  assert.ok(!/<\/script/i.test(src), "注入体不得含 </script>");
+  assert.doesNotThrow(() => new vm.Script(src), "注入体必须能被解析（否则页面直接白屏）");
+  // 兼容层必须出现在脚本最前面（要在应用模块执行前补齐 API）
+  const compatIdx = src.indexOf("===DSH-MA-COMPAT-START===");
+  const firstAppRef = src.indexOf("__DSH_TRANSPORT__");
+  assert.ok(compatIdx > 0 && compatIdx < firstAppRef, "兼容层必须排在宿主相关逻辑之前（模块执行前）");
+});

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

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+/**
+ * C9（2026-10-20 诊断）：**文案必须与实现一致**。
+ *
+ * 现场（03-加载卡住与打不开.md §2.4 D3）：「远程控制」面板硬编码「会话密钥只存在本机内存里，
+ * 刷新即失效」，而实现早已把派生 MK 写 localStorage、交接单同时写 sessionStorage + localStorage，
+ * 镜像页 `_boot()` 会从 localStorage 恢复（e2ee-shim-script.js 的「本机记忆恢复」分支）。
+ * 照着旧文案，客服与用户会做出**错误动作**（以为刷新必丢密钥 / 以为没加密就不能用）。
+ *
+ * 本文件锁三件事：
+ *   ① 旧说法必须从注入体里消失（它是事实错误，不是"措辞问题"）；
+ *   ② 新说法必须同时讲清三条路径：已记住本机（刷新自动恢复）/ 提示失效时回列表重新解锁 / 明文可用但不加密；
+ *   ③ 这句话是**客服话术**的唯一来源之一，措辞里必须带可执行动作（「返回设备列表重新解锁」）。
+ */
+import assert from "node:assert/strict";
+import test from "node:test";
+import { injectMobileAdapter } from "../mobile-adapter.mjs";
+
+function adapterScript() {
+  const { html } = injectMobileAdapter("<!doctype html><html><head></head><body></body></html>");
+  const m = /<script id="[^"]*-js"[^>]*>([\s\S]*?)<\/script>/.exec(html);
+  assert.ok(m, "应能从注入结果里取出脚本");
+  return m[1];
+}
+
+/** 取出菜单底部那句「返回设备列表 / 加密说明」的原文。 */
+function menuNote() {
+  const script = adapterScript();
+  const m = /dsh-ma-menu-note"?>([\s\S]*?)<\/div>/.exec(script);
+  assert.ok(m, "应能找到菜单里的说明行（dsh-ma-menu-note）");
+  return m[1].replace(/' \+/g, "").replace(/["']/g, "");
+}
+
+test("★ 注入体里不得再出现「只存在本机内存里 / 刷新即失效」这类与实现不符的说法", () => {
+  const script = adapterScript();
+  assert.equal(script.includes("刷新即失效"), false,
+    "实现会从 localStorage 恢复加密会话 —— 说「刷新即失效」是事实错误，会让用户做出错误动作");
+  assert.equal(script.includes("只存在本机内存里"), false, "会话密钥里「会持久化的解锁材料」与「只存内存的会话密钥」必须分清");
+});
+
+test("★ 新文案讲清三条路径：已记住本机自动恢复 / 提示失效→回列表重新解锁 / 明文可用但不加密", () => {
+  const note = menuNote();
+  assert.match(note, /记住本机/, "必须说明已记住本机（这是实现的事实，也是刷新后仍加密的原因）");
+  assert.match(note, /刷新[^。]*自动恢复/, "必须说明刷新会自动恢复加密（不是重新输入密码）");
+  assert.match(note, /加密会话已失效/, "必须点名那个提示语（用户看到的原话，客服才能对上）");
+  assert.match(note, /返回设备列表重新解锁/, "必须给出**可执行动作**（客服话术的核心）");
+  assert.match(note, /明文模式下功能可用/, "必须说明明文也能用（否则用户以为没加密=没得用）");
+  assert.match(note, /不经端到端加密|不加密/, "必须明说明文不加密（安全边界不能含糊）");
+});
+
+test("C9 客服话术与 UI 文案同源：返回设备列表 / 重新解锁 的措辞一致", () => {
+  const note = menuNote();
+  // 客服话术（发给 lead 的交付说明）就是这句：
+  // 「端到端加密已记住本机，刷新会自动恢复；若提示『加密会话已失效』，回设备列表重新点选设备解锁即可；不想解锁也能用，只是明文不加密。」
+  assert.match(note, /返回设备列表重新解锁/, "UI 与客服话术必须用同一个动作短语（避免用户理解成两个操作）");
+});

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

@@ -248,6 +248,9 @@ function harness({
   // ⚠️ 用 null 表示"官方不写这个属性"（undefined 会命中默认值，测不出"属性缺失"的场景）
   collapsedAttr = "true", detailsAttr = "true", rightbarAttr = null, variant = "rc1",
   width = 390, height = 844, withComposer = true, withToggle = true,
+  /* C6（2026-10-20）：alien = 官方锚点整组改名/被插件换掉（frame 还在，但侧栏列认不出、
+     折叠属性没了、开合按钮也没了）—— 正是"装了 dsh web all 之后"的现场。 */
+  alien = false,
 } = {}) {
   MutationObserverStub.reset();
   const intervals = [];
@@ -256,13 +259,14 @@ function harness({
     + "<title>DeepSeek Harness</title></head><body></body></html>";
   const body = new El("body");
   const frame = new El("div", { class: "pI_x6G_frame" });
-  if (collapsedAttr !== null) frame.setAttribute("data-sidebar-collapsed", collapsedAttr);
-  if (detailsAttr !== null) frame.setAttribute("data-details-collapsed", detailsAttr);
-  if (variant === "rc2" && rightbarAttr !== null) frame.setAttribute("data-rightbar-collapsed", rightbarAttr);
-
-  const sidebar = new El("div", { class: variant === "rc2" ? "pI_x6G_sidebarCol" : "pI_x6G_sidebarCol" });
-  const center = new El("div", { class: "pI_x6G_centerCol" });
-  const third = new El("div", { class: variant === "rc2" ? "pI_x6G_rightbarCol" : "pI_x6G_detailsCol" });
+  if (!alien && collapsedAttr !== null) frame.setAttribute("data-sidebar-collapsed", collapsedAttr);
+  if (!alien && detailsAttr !== null) frame.setAttribute("data-details-collapsed", detailsAttr);
+  if (!alien && variant === "rc2" && rightbarAttr !== null) frame.setAttribute("data-rightbar-collapsed", rightbarAttr);
+
+  /* alien：列类名也换掉（官方重新打包换前缀 / 插件自绘了侧栏）—— 适配层应当**认不出**它们。 */
+  const sidebar = new El("div", { class: alien ? "Qa1_side" : "pI_x6G_sidebarCol" });
+  const center = new El("div", { class: alien ? "Qa1_main" : "pI_x6G_centerCol" });
+  const third = new El("div", { class: alien ? "Qa1_extra" : (variant === "rc2" ? "pI_x6G_rightbarCol" : "pI_x6G_detailsCol") });
   const overlay = new El("div", { class: "pI_x6G_overlayLayer", "data-shell-overlay": "true" });
   const row = new El("div", { role: "treeitem", "aria-selected": "false", class: "hHd-Xa_sessionRow YDXeBa_sessionRow" });
   // 抽屉里一条历史会话行的实测位置（侧栏 0..328，避开左上角的汉堡按钮）
@@ -962,7 +966,9 @@ test("★ 加载疑似失败时的提示：菜单里一行 + **底部可操作
 
   // 阈值 12 秒：25 秒太晚（用户实测干等 47 秒才看到任何东西）
   assert.match(script, /if \(maLoadReadyNow\(\)\) return;/, "认出官方界面就不该提示");
-  assert.match(script, /var MA_LOAD_WATCH_MS = 12 \* 1000;/, "看门狗阈值常量应为 12 秒");
+  /* 2026-10-20（C4）：阈值 12s → **20s** —— 12 秒比真实 p90（15.3s）还短，17.6% 的正常加载
+     会被误报成"电脑端可能未连接"（03 报告 §2.3）；20 秒在 p90 之上留余量、又远低于不可忍耐的 40 秒级。 */
+  assert.match(script, /var MA_LOAD_WATCH_MS = 20 \* 1000;/, "看门狗阈值常量应为 20 秒（旧 12 秒低于真实 p90）");
   assert.match(script, /\}, MA_LOAD_WATCH_MS\);/, "setTimeout 必须用该常量");
   assert.ok(!/25 \* 1000/.test(script), "不得残留 25 秒阈值");
   // 一句话要能直接发给客服
@@ -1132,3 +1138,76 @@ test("护栏：延迟角标必须是 FAB 内的子元素（不得新增 body 级
   assert.ok(!/\.dsh-ma-fab-rtt\s*\{[^}]*z-index/.test(css), "角标不得自带 z-index（它活在 FAB 的层叠上下文里）");
   void js;
 });
+
+// ══════════════════════════════════════════════════════════════════════════════
+// C6（2026-10-20 诊断，00 §6.2 / 04 §V-4）：UI 插件兼容降级（compat-official）
+//
+// 现场：用户装了 `dsh web all`（或官方重新打包）后，我们自绘的抽屉/全屏 scrim 依赖的一组官方
+// 锚点（.pI_x6G_frame、.pI_x6G_sidebarCol、.hHd-Xa_*、data-sidebar-collapsed / data-details-collapsed）
+// 整组失效，但适配层仍然按旧假设建抽屉 + 遮罩 → 「点哪都没反应」。
+// 契约：锚点缺失/异常 → compat-official：**不建自绘抽屉、不建 scrim、不代替用户点官方入口**，
+//       只保留字号/E2EE 徽标（FAB + 菜单）；锚点齐全 → 原行为完全不变。
+// ══════════════════════════════════════════════════════════════════════════════
+
+const findFabIn = (env) => env.body.children.find((c) => c._cls.has("dsh-ma-fab"));
+
+test("★ C6：官方锚点缺失/异常 → 进入 compat-official，不建自绘抽屉与 scrim", () => {
+  const { js } = injected();
+  const env = run(harness({ alien: true, collapsedAttr: null, detailsAttr: null, withToggle: false }), js);
+  assert.equal(findScrim(env) || null, null,
+    "★ 锚点认不出时绝不建自绘遮罩 —— 最坏结局必须是「没有手势」，不能是「点哪都没反应」");
+  assert.equal(findHamburger(env) || null, null, "也不建自绘抽屉按钮（它只会变成一个点不动的死按钮）");
+  assert.ok(env.html.classList.contains("dsh-ma-compat-official"), "必须留下 compat-official 标记（现场诊断/客服上报用）");
+  assert.equal(env.frame.classList.contains("dsh-ma-frame"), false,
+    "★ 不得给官方 frame 打我们的布局类（CSS 会把三列轨道改成 0/1fr/0，用错的锚点改坏官方布局）");
+  assert.ok(findFabIn(env), "字号 / E2EE 徽标这些纯悬浮件必须保留（compat 只关抽屉与 scrim）");
+  const diag = env.win.__dshMaDiag;
+  assert.equal(diag.compatOfficial.on, true, "诊断里必须能看出当前处于 compat-official");
+  /* 跨 realm 数组不能用 deepEqual 直接比（vm 里构造的 Array 原型不同），用字符串比较。 */
+  assert.equal(diag.compatOfficial.reasons.slice().sort().join(","), "sidebar_anchor_missing,sidebar_toggle_missing",
+    "原因要能说清是哪组锚点认不出（便于按官方新版补识别）");
+});
+
+test("★ C6：锚点齐全时原行为不变（抽屉 + 遮罩照旧创建，不进 compat）", () => {
+  const { js } = injected();
+  const env = run(harness({}), js);
+  assert.ok(findScrim(env), "锚点齐全 → 遮罩照旧创建");
+  assert.ok(findHamburger(env), "锚点齐全 → 抽屉按钮照旧创建");
+  assert.equal(env.html.classList.contains("dsh-ma-compat-official"), false, "不得误进降级模式");
+  assert.equal(env.win.__dshMaDiag.compatOfficial.on, false);
+  assert.ok(env.frame.classList.contains("dsh-ma-frame"), "锚点齐全时布局适配照旧生效");
+});
+
+test("★ C6：官方 frame 挂上但列还没渲染（瞬时状态）→ 不降级、也不建假入口（等下一拍）", () => {
+  const { js } = injected();
+  const env = harness({});
+  env.frame.children = [];                     // frame 已挂载、但 React 子列还没渲染
+  const run2 = run(env, js);
+  assert.equal(run2.win.__dshMaDiag.compatOfficial.on, false,
+    "子列还没渲染不是「锚点变了」——不能据此永久降级（官方渲染完就正常了）");
+  assert.equal(findScrim(run2) || null, null, "但也绝不能凭一个空 frame 就建遮罩/抽屉");
+  assert.equal(findHamburger(run2) || null, null);
+});
+
+test("★ C6：不代替用户点官方入口 —— 开关关掉后点遮罩也不许点官方 toggle", () => {
+  const { js } = injected();
+  const env = run(harness({ collapsedAttr: "" }), js);   // 官方说展开 → 遮罩在拦
+  const clicks = toggleClicks(env);
+  const scrim = findScrim(env);
+  assert.ok(scrim, "前提：遮罩存在");
+  env.win.__dshMaOfficialClicks = false;                 // 真机排查开关：完全停手
+  scrim.dispatchEvent(new Ev("click", {}));
+  assert.equal(clicks(), 0, "★ 开关关闭时绝不代替用户点官方侧栏按钮（但仍要摘掉我们自己的遮挡类）");
+  assert.equal(env.html.classList.contains("dsh-ma-sidebar-open"), false, "点遮罩必须仍能自救（摘掉展开类）");
+});
+
+test("★ C6：scrim 不变量与下闸次数必须进诊断（用户报「又点不动了」时的第一手证据）", () => {
+  const { js } = injected();
+  const env = run(harness({ collapsedAttr: "" }), js);   // 抽屉展开、遮罩下闸
+  assert.ok(env.win.__dshMaDiag.scrim.activations >= 1, "遮罩实际下闸过 → 计数必须 ≥1");
+  // 模拟"抽屉消失但遮罩还在拦" → 不变量摘除并计数
+  env.sidebar.getBoundingClientRect = () => ({ left: -400, right: -80, top: 0, bottom: 844, width: 320, height: 844 });
+  env.tickTimers();                                      // 800ms 看门狗那一拍
+  assert.equal(env.html.classList.contains("dsh-ma-scrim-on"), false, "不变量必须摘掉遮罩");
+  assert.ok(env.win.__dshMaDiag.scrim.invariantHits >= 1, "摘除次数必须计数（区分「遮罩在拦」与「遮罩早被摘了」）");
+});

package/clients/dsh-remote/test/mobile-adapter-late-frame.test.mjs

@@ -159,6 +159,15 @@ function harness({ width = 390, height = 844 } = {}) {
 
   const frame = new El("div", { class: "pI_x6G_frame" });
   frame.setAttribute("data-sidebar-collapsed", "true");
+  /* C6（2026-10-20）：适配层启动时会先比对官方 DOM 锚点（frame / 侧栏列 / 开合驱动），
+     认不出就进入 compat-official（**不建**抽屉与 scrim）。官方 frame 一挂载就带着三列，
+     所以这里给最小列结构（侧栏可识别 + 中央列 + 第三列），让用例测的仍是"迟到挂载"而不是"锚点缺失"。
+     ⚠️ 如果哪天真实官方 DOM 变成"frame 挂上但列还没渲染"，适配层会 return pending（不降级），
+        下一拍再看 —— 那时这几条用例仍然成立。 */
+  const sidebarCol = new El("div"); sidebarCol.className = "pI_x6G_sidebarCol";
+  const centerCol = new El("div"); centerCol.className = "pI_x6G_centerCol";
+  const detailsCol = new El("div"); detailsCol.className = "pI_x6G_detailsCol";
+  frame.appendChild(sidebarCol); frame.appendChild(centerCol); frame.appendChild(detailsCol);
   frame.querySelector = () => null;      // 本用例不涉及第三列/overlay 识别
 
   doc.readyState = "complete";