@mrrisega/dsh-remote 0.7.9-beta.1 → 0.7.10-beta.3

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

@@ -123,6 +123,9 @@ class El {
   }
   get className() { return [...this._cls].join(" "); }
   set className(v) { this._cls = new Set(String(v).split(/\s+/).filter(Boolean)); }
+  /* 真实 DOM 里 nodeName 一定存在（大小写语义与 tagName 相同）：适配层的「插入前图片钩子」
+     按 nodeName 判 IMG，假 DOM 缺了这个属性就会把正确实现判成失效（假红）。 */
+  get nodeName() { return this.tagName; }
   set innerHTML(html) {
     this._html = String(html);
     this.children = [];
@@ -1211,3 +1214,172 @@ test("★ C6：scrim 不变量与下闸次数必须进诊断（用户报「又
   assert.equal(env.html.classList.contains("dsh-ma-scrim-on"), false, "不变量必须摘掉遮罩");
   assert.ok(env.win.__dshMaDiag.scrim.invariantHits >= 1, "摘除次数必须计数（区分「遮罩在拦」与「遮罩早被摘了」）");
 });
+
+// ══════════════════════════════════════════════════════════════════════════════
+// 首屏优化（2026-10-2x）：这几条守的是「适配层自己别成为首屏/打字卡顿的原因」。
+//
+// 现场：手机镜像页首屏 p50 3.9s / p90 21.6s、20.2% ≥12s（生产遥测 n=8903）。
+// 大头（TTFB、官方 13MB 级 bundle、中继带宽）不在适配层手里，但下面两件事是我们自己造的：
+//   ① 旧 HOSTISH() 把 `outerHTML.slice(0, 200000)` 写在或的左边 → 每拍 boot 都先全量序列化一遍；
+//   ② 看门狗每拍要扫全文档（设置面板识别）与全部 <img>（懒加载）→ 用户敲字时在和输入法抢主线程。
+// ══════════════════════════════════════════════════════════════════════════════
+
+test("★ 首屏优化：有官方结构信号时一次全量序列化都不做（旧实现每拍 boot 先 outerHTML.slice(0,200000)）", () => {
+  const { js } = injected();
+  const env = run(harness({ width: 390 }), js);
+  const perf = env.win.__dshMaDiag && env.win.__dshMaDiag.perf;
+  assert.ok(perf, "必须暴露 __dshMaDiag.perf（只本地可读，不上报）");
+  assert.ok(perf.hostishCalls >= 1, "boot 必须走过 HOSTISH（这是主机门）");
+  assert.equal(perf.hostishSerializations, 0,
+    "★ 官方 frame/开合属性已经能证明是官方页面 → 绝不能再把整页序列化一遍（那是最贵的一步）");
+});
+
+test("★ 首屏优化：打字期间暂停自己的后台扫描（别和输入法抢主线程）", () => {
+  const { js } = injected();
+  const env = run(harness({ width: 390 }), js);
+  const far = new El("img");
+  far.setAttribute("src", "/assets/far-below-fold.png");
+  far._rect = { left: 0, top: 2000, right: 300, bottom: 2200, width: 300, height: 200 };
+  env.body.appendChild(far);
+  // 用户正在打字：input 事件冒泡到 document（适配层在捕获阶段记下"忙 1.2 秒"）
+  env.composerChild.dispatchEvent(new Ev("input", {}));
+  env.tickTimers();                                   // 看门狗一拍 = 图片懒加载的一次扫描机会
+  assert.equal(far.getAttribute("loading"), null,
+    "★ 打字期间必须跳过扫描（暂停的是优化，不是交互 —— 页面行为一点不受影响）");
+  assert.ok(env.win.__dshMaDiag.perf.imgScanPaused >= 1, "跳过次数要进诊断（证明它真的让路了）");
+});
+
+test("★ 首屏优化：视口外的图片打 loading=lazy + decoding=async，首屏附近的一个字节都不动", () => {
+  const { js } = injected();
+  const env = run(harness({ width: 390 }), js);       // 该假 DOM 没有 IntersectionObserver → 走批量几何兜底
+  const far = new El("img");
+  far.setAttribute("src", "/assets/far.png");
+  far._rect = { left: 0, top: 2000, right: 300, bottom: 2200, width: 300, height: 200 };
+  const near = new El("img");
+  near.setAttribute("src", "/assets/near.png");
+  near._rect = { left: 0, top: 20, right: 300, bottom: 220, width: 300, height: 200 };
+  env.body.appendChild(far);
+  env.body.appendChild(near);
+  env.tickTimers();                                   // 看门狗一拍 → 扫描新出现的图片
+
+  assert.equal(far.getAttribute("loading"), "lazy", "★ 视口外的图片必须按需加载（首屏少发请求、少抢带宽）");
+  assert.equal(far.getAttribute("decoding"), "async", "解码异步，别阻塞主线程");
+  assert.equal(near.getAttribute("loading"), null, "★ 首屏附近的图片绝不能被改成 lazy");
+  assert.equal(near.getAttribute("decoding"), null, "首屏附近的图片保持官方原样");
+  const perf = env.win.__dshMaDiag.perf;
+  assert.ok(perf.imgLazy >= 1 && perf.imgKept >= 1, "省下的请求数 / 保持原样的张数都要能读出来");
+});
+
+test("★ 护栏：首启字号提示是 FAB 内的绝对定位气泡（不是 body 级浮层、不是全屏层）", () => {
+  // 0.6.14 的教训：一旦在用户页面上放覆盖层，判断错一次就是"永远进不去"。
+  // 字号提示必须遵守同一条纪律：只能挂在 FAB 内部、只能小、只能自己消失。
+  const { css, js } = injected();
+  const rule = /button\.dsh-ma-fab \.dsh-ma-fs-tip\s*\{([\s\S]*?)\}/.exec(css);
+  assert.ok(rule, "应有字号提示的样式规则（且限定在 FAB 内）");
+  assert.match(rule[1], /position:\s*absolute/, "必须是 FAB 内的绝对定位子元素");
+  assert.ok(!/position:\s*fixed/.test(rule[1]), "不得是 fixed 浮层");
+  assert.ok(!/inset:\s*0/.test(rule[1]), "不得铺满屏幕（inset:0 = 全屏层）");
+  assert.match(js, /dsh-ma-fs-tip-v1/, "必须用 localStorage 记住「已提示过」（同一浏览器只提示一次）");
+  assert.match(js, /FS_TIP_DELAY_MS/, "必须是延迟出现（不许在首屏关键路径上创建节点）");
+});
+
+// ══════════════════════════════════════════════════════════════════════════════
+// 「插入前」图片钩子（2026-10-2x，唯一一处会碰官方页面全局对象的地方，必须逐条钉住）
+//
+// 为什么需要它（headless Chrome 实测，同一份 24 张图的页面）：
+//   · append **之前**带 loading="lazy"              → 首屏只发 11 个图片请求
+//   · append **之后**（哪怕只晚一个微任务）补属性     → 24 个请求一个不少（属性有了、请求照发）
+// 所以"插入后观察器"拿不到带宽收益，真正省带宽的是这层极窄的钩子：
+// Node.prototype.appendChild / insertBefore 里，**只对 IMG**、只在插入前，补两个属性。
+// 下面每条都是它的安全边界 —— 破任何一条都可能影响官方页面的现有交互。
+// ══════════════════════════════════════════════════════════════════════════════
+
+/** 给假 DOM 补一个最小的 Node：脚本只在有 Node.prototype 的宿主里才装钩子。 */
+function installFakeNode(env) {
+  function FakeNode() {}
+  const nativeAppend = function (n) { (this._kids || (this._kids = [])).push(n); return n; };
+  const nativeInsert = function (n) { (this._kids || (this._kids = [])).push(n); return n; };
+  FakeNode.prototype.appendChild = nativeAppend;
+  FakeNode.prototype.insertBefore = nativeInsert;
+  FakeNode.nativeAppend = nativeAppend;
+  env.ctx.Node = FakeNode;
+  return FakeNode;
+}
+
+test("★ 图片钩子：插入**前**给 <img> 补 loading=lazy + decoding=async（这是唯一能真的省请求的时机）", () => {
+  const { js } = injected();
+  const env = harness({ width: 390 });
+  const FakeNode = installFakeNode(env);
+  run(env, js);
+
+  assert.equal(typeof FakeNode.prototype.appendChild.__dshMaImgHook, "boolean",
+    "应给 appendChild 包一层钩子（标记便于排障）");
+  const host = {};
+  const img = new El("img");
+  img.setAttribute("src", "/chat/1.png");
+  const ret = FakeNode.prototype.appendChild.call(host, img);
+  assert.equal(ret, img, "返回值必须原样透传（包装不能改变任何调用语义）");
+  assert.equal(host._kids.length, 1, "原生 appendChild 必须照常执行");
+  assert.equal(img.getAttribute("loading"), "lazy", "★ 插入前就必须带上 loading=lazy（晚一步等于没打）");
+  assert.equal(img.getAttribute("decoding"), "async", "解码异步，不阻塞主线程");
+
+  // 非 IMG 节点：一个字节都不碰
+  const div = new El("div");
+  FakeNode.prototype.appendChild.call({}, div);
+  assert.equal(div.getAttribute("loading"), null, "非图片节点不得被改动");
+
+  // 已有 loading 属性（官方自己给的）→ 不动
+  const img2 = new El("img");
+  img2.setAttribute("src", "/chat/2.png");
+  img2.setAttribute("loading", "eager");
+  FakeNode.prototype.appendChild.call({}, img2);
+  assert.equal(img2.getAttribute("loading"), "eager", "官方已经给过 loading 属性 → 必须原样保留");
+});
+
+test("★ 图片钩子：DocumentFragment 批量插入（React 列表常见）也要覆盖到一级 img 子节点", () => {
+  const { js } = injected();
+  const env = harness({ width: 390 });
+  const FakeNode = installFakeNode(env);
+  run(env, js);
+  const a = new El("img"); a.setAttribute("src", "/a.png");
+  const b = new El("img"); b.setAttribute("src", "/b.png");
+  const frag = { nodeType: 11, childNodes: [a, b] };
+  FakeNode.prototype.appendChild.call({}, frag);
+  assert.equal(a.getAttribute("loading"), "lazy", "fragment 里的图片同样要按需加载");
+  assert.equal(b.getAttribute("loading"), "lazy");
+});
+
+test("★ 图片钩子：逃生口 ?dsh_ma_img_lazy=0 生效（线上出问题不用等发版）", () => {
+  const { js } = injected();
+  const env = harness({ width: 390 });
+  const FakeNode = installFakeNode(env);
+  env.win.location.search = "?dsh_ma_img_lazy=0";
+  run(env, js);
+  assert.ok(!FakeNode.prototype.appendChild.__dshMaImgHook,
+    "带逃生口参数时绝不安装钩子（页面行为与今天完全一致）");
+  const img = new El("img");
+  img.setAttribute("src", "/x.png");
+  FakeNode.prototype.appendChild.call({}, img);
+  assert.equal(img.getAttribute("loading"), null, "没装钩子就不许改任何图片属性");
+});
+
+test("★ 图片钩子：pagehide 必须还原 Node.prototype（bfcache 里不留改写过的全局方法）", () => {
+  const { js } = injected();
+  const env = harness({ width: 390 });
+  const FakeNode = installFakeNode(env);
+  run(env, js);
+  assert.ok(FakeNode.prototype.appendChild.__dshMaImgHook, "前提：钩子已装上");
+  // 适配层把 maTeardown 挂在 window 的 pagehide 上（假 DOM 的 window.addEventListener 转发到 document）
+  env.doc.dispatchEvent(new Ev("pagehide", {}));
+  assert.equal(FakeNode.prototype.appendChild, FakeNode.nativeAppend,
+    "★ pagehide 之后 appendChild 必须还原成原生函数（绝不给页面留悬挂改写）");
+});
+
+test("★ 图片钩子只在手机窄屏装（桌面镜像页一个字节都不碰）", () => {
+  const { js } = injected();
+  const env = harness({ width: 1200 });
+  const FakeNode = installFakeNode(env);
+  run(env, js);
+  assert.ok(!FakeNode.prototype.appendChild.__dshMaImgHook,
+    "★ >820px（电脑端镜像页）不得改写 Node.prototype —— 这条优化只属于手机");
+});

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

@@ -74,6 +74,15 @@ class El {
   prepend() {} focus() {} blur() {}
   hasAttribute(n) { return n in this.attrs; }
   appendChild(c) { c.parent = this; this.children.push(c); return c; }
+  /* 真实 DOM 里 removeChild/parentNode 是基本能力：适配层的「字号提示」用它把自己摘掉。
+     假 DOM 缺了它 → 提示永远摘不掉 → 用例会把一个正确的实现判成错误（假红）。 */
+  removeChild(c) {
+    const i = this.children.indexOf(c);
+    if (i >= 0) this.children.splice(i, 1);
+    if (c) c.parent = null;
+    return c;
+  }
+  get parentNode() { return this.parent || null; }
   addEventListener(t, fn) { (this._listeners.get(t) || this._listeners.set(t, []).get(t)).push(fn); }
   removeEventListener() {}
   dispatch(t, ev = {}) { for (const fn of this._listeners.get(t) || []) fn({ stopPropagation() {}, preventDefault() {}, ...ev }); }
@@ -106,7 +115,9 @@ class El {
  * 折叠时**没有拖拽把手**——这正是 2026-09-19 线上"整屏遮罩"的现场结构。
  */
 function harness({ collapsedAttr = undefined, detailsAttr = undefined, sidebarRect = null, width = 390, withToggle = true,
-  variant = "rc1", rightbarAttr = undefined, overlayRect = null, rightbarRect = null, fetchImpl = null } = {}) {
+  variant = "rc1", rightbarAttr = undefined, overlayRect = null, rightbarRect = null, fetchImpl = null,
+  /* 2026-10-2x：给"输入框可用性小修补"用例提供一个官方 Lexical 输入区（默认不提供，旧用例现场不变）。 */
+  withComposer = false } = {}) {
   const html = new El("html");
   // HOSTISH 门禁会读 documentElement.outerHTML 找官方特征（__ModuleLoader__ / DeepSeek Harness）
   html.outerHTML = '<html><head><script>window.__ModuleLoader__ = { mode: "queue" }</script>'
@@ -134,6 +145,9 @@ function harness({ collapsedAttr = undefined, detailsAttr = undefined, sidebarRe
   }
   const toggle = new El("button");
   toggle.setAttribute("aria-label", "打开侧边栏");
+  const composer = new El("div", {
+    contenteditable: "true", "data-composer-input": "true", role: "textbox", "aria-multiline": "true",
+  });
 
   const pickByClass = (sel) => {
     // 只支持本用例需要的极少数选择器（脚本里 querySelector 的用法就这些）
@@ -156,9 +170,28 @@ function harness({ collapsedAttr = undefined, detailsAttr = undefined, sidebarRe
       if (s2.includes("aria-label=")) return withToggle ? toggle : null;
       if (s2.includes(".hHd-Xa_toggle")) return withToggle ? toggle : null;
       if (s2.includes("hHd-Xa")) return sidebar; // 子列识别用（真实页面里这是侧栏）
+      if (s2.includes("data-composer-input")) return withComposer ? composer : null;
       return pickByClass(s2);
     },
-    querySelectorAll() { return []; },
+    /* 只额外支持 `img`：适配层的「图片按需加载」要扫 document.querySelectorAll("img")。
+       其它选择器仍按旧行为返回 []（不改变既有用例的现场）。 */
+    querySelectorAll(sel) {
+      if (String(sel) !== "img") return [];
+      const out = [];
+      const seen = new Set();
+      const walk = (el) => {
+        if (!el || seen.has(el)) return;
+        seen.add(el);
+        for (const c of el.children || []) {
+          if (String(c.tagName) === "IMG") out.push(c);
+          walk(c);
+        }
+      };
+      /* 这套假 DOM 里 body 不一定挂在 documentElement 下（旧用例不需要），所以两个根都走一遍。 */
+      walk(doc);
+      walk(doc.body);
+      return out;
+    },
     createElement: (t) => new El(t),
     createTextNode: (t) => ({ nodeValue: t }),
     getElementById: () => null,
@@ -179,7 +212,9 @@ function harness({ collapsedAttr = undefined, detailsAttr = undefined, sidebarRe
     fetch: fetchImpl || undefined,
     // unref：同上 —— 适配层的 4 分钟兜底计时器会让测试进程空等到期（本来 240s，只剩 0.2s）。
     // 用例里的 `_pendingTimers` 仍会被 runAdapter() 主动跑一轮，行为不变。
-    setTimeout: (fn, ms) => { const id = setTimeout(fn, ms); try { id.unref?.(); } catch { /* 忽略 */ } timers.set(id, fn); return id; },
+    // 2026-10-2x：额外把 (fn, ms) 记进 timers，便于 `flushTimers(env, maxMs)` 手动推进
+    // 「延迟才做」的首屏后优化（字号提示 1200ms、图片懒加载 600ms），不必真等。
+    setTimeout: (fn, ms) => { const id = setTimeout(fn, ms); try { id.unref?.(); } catch { /* 忽略 */ } timers.set(id, { fn, ms }); return id; },
     clearTimeout: (id) => clearTimeout(id),
     MutationObserver: class { observe() {} disconnect() {} },
     ResizeObserver: class { observe() {} disconnect() {} },
@@ -203,7 +238,7 @@ function harness({ collapsedAttr = undefined, detailsAttr = undefined, sidebarRe
   ctx.console = dbgConsole;
   ctx.globalThis = ctx;
   ctx.self = win;
-  return { ctx, html, body, frame, sidebar, rightbar, overlay, toggle, win };
+  return { ctx, html, body, frame, sidebar, rightbar, overlay, toggle, composer, win, timers };
 }
 
 const ADAPTER_DEBUG = process.env.DSH_ADAPTER_DEBUG === "1";
@@ -221,6 +256,16 @@ function runAdapter(env) {
   return env;
 }
 
+/** 手动推进"延迟才做"的定时器（≤ maxMs），模拟时间流逝（不必真等 1.2 秒）。 */
+function flushTimers(env, maxMs = 2000) {
+  for (const [, rec] of [...(env.timers || new Map())]) {
+    if (!rec || typeof rec.fn !== "function") continue;
+    if (rec.ms <= maxMs) {
+      try { rec.fn(); } catch { /* 用例里吞掉：被测代码自己的兜底由它自己保证 */ }
+    }
+  }
+}
+
 const findScrim = (env) => env.body.children.find((c) => c._cls.has("dsh-ma-scrim"));
 const findHamburger = (env) => env.body.children.find((c) => c._cls.has("dsh-ma-hamburger"));
 
@@ -625,3 +670,142 @@ test("网络延迟：无样本 / 失败请求绝不显示 0ms（显示「测速
   const menu = findMenu(env);
   assert.match(menu.innerHTML, /测速中…/, "空态文案必须是「测速中…」");
 });
+
+// ══════════════════════════════════════════════════════════════════════════════
+// 首屏性能 & 移动端体验（2026-10-2x）
+//
+// 用户原声：「字体太小，因此不用」（字号档位其实早就有，藏在悬浮菜单里，没人知道）；
+// 生产遥测 n=8903：首屏 p50 3.9s / p90 21.6s、20.2% ≥12s。
+// 这里锁住适配层**自己**能控制的那部分：
+//   ① 首启字号提示：一次性、挂在 FAB 内部（不新增 body 级浮层）、点它直接打开菜单、
+//      延迟 1.2 秒才出现（绝不掺和首屏）、用户调过字号就不再提示；
+//   ② 图片按需加载：只给「视口外且没在加载」的图片打 loading=lazy + decoding=async，
+//      首屏附近的图一个字节都不动（该立刻出现的必须立刻出现）；
+//   ③ 输入体验：输入框字号跟着档位放大但永不低于 16px（防 iOS 聚焦缩放）、只打属性不改结构；
+//   ④ 性能可测量：__dshMaDiag.perf 里有首屏里程碑 / 适配层自身 boot 耗时 / 懒加载计数，
+//      且**不新增遥测事件名**（服务端只认白名单）。
+// ══════════════════════════════════════════════════════════════════════════════
+
+test("首启字号提示：1.2s 后出现、挂在 FAB 内部、点它直接打开字号菜单、且只提示一次", () => {
+  const env = harness({ width: 390 });
+  runAdapter(env);
+  const fab = findFab(env);
+  assert.ok(fab, "前提：悬浮按钮存在");
+  assert.equal(fab.querySelector(".dsh-ma-fs-tip"), null,
+    "首屏阶段绝不能出现提示 —— 延迟 1.2 秒就是为了不跟首屏抢主线程/抢视线");
+  const bodyKids = env.body.children.length;
+
+  flushTimers(env, 1200);   // 推进「首屏之后」的延迟定时器（不必真等 1.2 秒）
+
+  const tip = fab.querySelector(".dsh-ma-fs-tip");
+  assert.ok(tip, "1.2 秒后应出现「字太小？」提示（字号档位就藏在这颗按钮里）");
+  assert.equal(env.body.children.length, bodyKids,
+    "★ 提示必须挂在 FAB 内部：body 下不得多出任何浮层（适配层曾经用全屏层干过这事）");
+  assert.match(String(tip.innerHTML), /点这里调字号/, "文案必须直接告诉用户该点哪里");
+  assert.match(String(tip.innerHTML), /✕/, "必须可关闭（✕）");
+  assert.equal(env.win.localStorage.getItem("dsh-ma-fs-tip-v1"), "1",
+    "显示即记「已提示过」：同一浏览器只提示一次（localStorage）");
+  assert.equal(env.win.__dshMaDiag.perf.tipShown, true, "诊断里要能看到提示是否展示过");
+
+  // 点气泡 = 直接打开字号菜单（不用先学会点按钮），并收起提示
+  const menu = findMenu(env);
+  assert.equal(menu.hidden, true, "前提：菜单默认收起");
+  tip.dispatch("click");
+  assert.equal(menu.hidden, false, "★ 点提示必须打开远程控制菜单（里面就是字号滑块）");
+  assert.equal(fab.querySelector(".dsh-ma-fs-tip"), null, "点过之后提示必须收起");
+});
+
+test("首启字号提示：已提示过 / 用户自己调过字号 → 都不再提示（不打扰）", () => {
+  const env = harness({ width: 390 });
+  env.win.localStorage.setItem("dsh-ma-fs-tip-v1", "1");   // 上次已经提示过
+  runAdapter(env);
+  flushTimers(env, 1200);
+  assert.equal(findFab(env).querySelector(".dsh-ma-fs-tip"), null, "已提示过 → 不得再出现");
+
+  const env2 = harness({ width: 390 });
+  env2.win.localStorage.setItem("dsh-ma-font-scale", "2");  // 用户自己调过字号
+  runAdapter(env2);
+  flushTimers(env2, 1200);
+  assert.equal(findFab(env2).querySelector(".dsh-ma-fs-tip"), null,
+    "用户已经找到并调过字号 → 不必再告知（提示的目的已达成）");
+});
+
+test("图片按需加载：视口外的图打 loading=lazy + decoding=async，首屏附近的图一个字节都不动", () => {
+  const env = harness({ width: 390 });
+  const far = new El("img");
+  far.setAttribute("src", "/assets/chat-far.png");
+  far._rect = { left: 0, top: 2000, right: 300, bottom: 2200, width: 300, height: 200 };
+  const near = new El("img");
+  near.setAttribute("src", "/assets/chat-near.png");
+  near._rect = { left: 0, top: 10, right: 300, bottom: 210, width: 300, height: 200 };
+  env.body.appendChild(far);
+  env.body.appendChild(near);
+
+  assert.equal(far.getAttribute("loading"), null, "前提：官方 <img> 本来没有 loading 属性");
+  runAdapter(env);
+  flushTimers(env, 600);   // boot 后 600ms 的「首屏之后」扫描
+
+  assert.equal(far.getAttribute("loading"), "lazy", "★ 视口外的图片必须按需加载（首屏少发请求、少抢带宽）");
+  assert.equal(far.getAttribute("decoding"), "async", "解码异步，别阻塞主线程");
+  assert.equal(near.getAttribute("loading"), null, "★ 首屏附近的图片绝不能被改成 lazy（该立刻出现的必须立刻出现）");
+  assert.equal(near.getAttribute("decoding"), null, "首屏附近的图连 decoding 也不动（保持官方原样）");
+
+  const perf = env.win.__dshMaDiag.perf;
+  assert.ok(perf.imgLazy >= 1, "诊断要能量化「省下的图片请求数」（imgLazy）");
+  assert.ok(perf.imgKept >= 1, "首屏附近未动的图片也要计数（imgKept）");
+});
+
+test("输入体验：只给官方输入框补属性（enterkeyhint/spellcheck），不动 DOM 结构", () => {
+  const env = harness({ width: 390, withComposer: true });
+  runAdapter(env);
+  flushTimers(env, 600);
+  const c = env.composer;
+  assert.equal(c.getAttribute("enterkeyhint"), "enter",
+    "回车键标注「换行」：与适配层「手机 Enter 只换行、发送交给发送按钮」的策略一致");
+  assert.equal(c.getAttribute("spellcheck"), "false", "中文会话里别画拼写红线");
+  assert.equal(c.getAttribute("contenteditable"), "true", "★ 只打属性：官方原有属性/结构一个都不能改");
+  assert.equal(c.getAttribute("data-composer-input"), "true", "★ 官方锚点属性必须原样保留");
+});
+
+test("首屏诊断：__dshMaDiag.perf 有首屏里程碑 + 适配层自身耗时，且不新增遥测事件名", () => {
+  const env = harness({ width: 390 });
+  runAdapter(env);
+  flushTimers(env, 3100);
+  const perf = env.win.__dshMaDiag && env.win.__dshMaDiag.perf;
+  assert.ok(perf, "必须在 __dshMaDiag 里暴露 perf（用户上报现场时能读）");
+  for (const k of ["startAt", "bootCalls", "bootMs", "hostishCalls", "hostishSerializations",
+    "fcp", "ttfb", "dcl", "loadEnd", "uiReadyMs", "imgLazy", "imgScanPaused", "tipShown", "vvRepositions"]) {
+    assert.ok(k in perf, "perf 缺字段: " + k);
+  }
+  assert.ok(perf.bootCalls >= 1, "boot 至少跑过一次 —— bootMs 才是「适配层自身耗时」");
+  assert.ok(perf.hostishSerializations === 0,
+    "★ 有官方结构信号时一次全量序列化都不该做（旧实现每次 boot 都先 outerHTML.slice(0,200000)）");
+  assert.equal(typeof perf.uiReadyMs, "number", "首屏可用时刻（= mirror_load 的 ms，导航开始 → 可用）");
+
+  // 纪律：不新增遥测事件名（服务端只认白名单，新名字会被丢弃）→ 唯一允许的端点仍是 mirror-load
+  const SRC = readFileSync(new URL("../mobile-adapter.mjs", import.meta.url), "utf8");
+  const endpoints = [...new Set([...SRC.matchAll(/\/dsh-remote\/telemetry\/[a-z-]+/g)].map((m) => m[0]))];
+  assert.deepEqual(endpoints, ["/dsh-remote/telemetry/mirror-load"],
+    "★ 不得新增遥测事件名（白名单只有 mirror_load；新指标只进本地 __dshMaDiag.perf）");
+});
+
+test("键盘弹出：visualViewport 变化时悬浮按钮重新贴边（按钮不能被键盘顶到看不见的地方）", async () => {
+  const env = harness({ width: 390 });
+  // 把按钮记忆在右下角：它的 top 与"可视区高度"直接相关
+  env.win.localStorage.setItem("dsh-ma-fab-pos", JSON.stringify({ h: "left", v: "bottom", dx: 10, dy: 10 }));
+  const vvListeners = new Map();
+  env.win.visualViewport = {
+    height: 800,
+    addEventListener(t, fn) { (vvListeners.get(t) || vvListeners.set(t, []).get(t)).push(fn); },
+  };
+  runAdapter(env);
+  const fab = findFab(env);
+  assert.equal(fab.style.top, String(800 - 46 - 10) + "px", "前提：先按可视区高度贴底");
+
+  env.win.visualViewport.height = 500;            // 键盘弹出：可视区矮了 300px
+  for (const fn of vvListeners.get("resize") || []) fn();
+  await new Promise((r) => setImmediate(r));      // 重算被合到一帧里（rAF）
+  assert.equal(fab.style.top, String(500 - 46 - 10) + "px",
+    "★ 键盘弹出后必须按 visualViewport 重新贴边（旧实现用 innerHeight，按钮会留在键盘后面点不到）");
+  assert.ok(env.win.__dshMaDiag.perf.vvRepositions >= 1, "重定位次数要进诊断");
+});