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

package/packages/dsh-remote-web/runtime/clients/dsh-remote/mirror-diag-script.js

@@ -0,0 +1,154 @@
+/**
+ * dsh-mirror-diag — 镜像页「加载故障」采集器（由 bridge 注入到 text/html 的 </head> 前）。
+ *
+ * 由来（2026-10-17）：用户反馈「装了 UI 插件后打不开界面 / Failed to load plugins」，
+ * 但本地与账号环境都复现不出来。生产日志里只看到 `/plugins/??…` 的 499 中断，
+ * 拿不到浏览器侧的真实失败项（哪个 URL、多少毫秒、什么错误）。这个采集器就是
+ * **让下一次故障自己带证据回来**。
+ *
+ * 设计约束（都是硬要求）：
+ *   1. **绝不打扰用户**：不改 DOM、不加 UI、不阻塞渲染；任何异常都在内部吞掉。
+ *   2. **只在出错时上报**：没有失败资源/脚本错误 → 一个字节都不发（零流量）。
+ *   3. **不泄密**：只上报**路径**（剥掉 query/hash）、状态码、耗时、字节数、错误消息前 500 字；
+ *      不上报页面内容、请求体、cookie、token、用户信息。
+ *   4. **可关**：`?mirror_diag=0` 或 bridge 环境变量 `DSH_MIRROR_DIAG=0` → 完全不注入。
+ *   5. **慢请求也记**：`/plugins/`、`/assets/` 加载超过 8s 记一条（这正是"插件聚合包被
+ *      限速拖死 → 浏览器 499"的现场）。
+ *
+ * 上报地址：`/relay-api/api/mirror-diag`（企业端，需登录态；token 从 localStorage.dsh_token 取）。
+ */
+(function () {
+  "use strict";
+  var W = window, D = document;
+  var VERSION = 1;
+  var SLOW_MS = 8000;
+  var MAX_ITEMS = 20;
+  var FLUSH_DELAY = 2500;
+  var ENDPOINT = "/relay-api/api/mirror-diag";
+  var items = [];
+  var bootFailed = [];
+  var sent = false;
+  var timer = null;
+
+  function now() { return Date.now(); }
+  function clip(s, n) { s = String(s == null ? "" : s); return s.length > n ? s.slice(0, n) : s; }
+  /** 只保留同源路径（剥 query/hash），跨源整条丢弃 —— 避免把第三方 URL 带出去。 */
+  function pathOf(u) {
+    try {
+      var x = new URL(String(u || ""), W.location.href);
+      if (x.origin !== W.location.origin) return null;
+      return clip(x.pathname, 300);
+    } catch (e) { return null; }
+  }
+  function add(item) {
+    if (!item || items.length >= MAX_ITEMS || sent) return;
+    items.push(item);
+    if (timer === null) timer = setTimeout(flush, FLUSH_DELAY);
+  }
+  function interesting(p) {
+    return !!p && (p.indexOf("/plugins/") === 0 || p.indexOf("/assets/") === 0
+      || p.indexOf("/remote/") === 0 || p.indexOf("/api/") === 0);
+  }
+
+  // ① 资源加载失败（script/link/img/fetch 的 error 事件在捕获阶段拿到 target）
+  W.addEventListener("error", function (e) {
+    try {
+      var t = e && e.target;
+      if (t && t !== W && (t.src || t.href)) {
+        var p = pathOf(t.src || t.href);
+        if (interesting(p)) add({ t: "res", url: p, tag: String(t.tagName || "").toLowerCase() });
+        return;
+      }
+      if (e && e.message) add({ t: "err", msg: clip(e.message, 500), src: pathOf(e.filename) });
+    } catch (x) { /* 采集器自身绝不抛 */ }
+  }, true);
+
+  // ② 未处理异常 / Promise 拒绝
+  W.addEventListener("unhandledrejection", function (e) {
+    try {
+      var r = e && e.reason;
+      var msg = r && (r.message || r.stack) ? (r.message || "") + " " + (r.stack || "") : String(r);
+      add({ t: "rej", msg: clip(msg, 500) });
+    } catch (x) {}
+  });
+
+  // ③ 慢资源（插件聚合包/前端主干）—— 用 Resource Timing，不额外发请求
+  try {
+    if (W.PerformanceObserver) {
+      var po = new W.PerformanceObserver(function (list) {
+        try {
+          list.getEntries().forEach(function (en) {
+            var p = pathOf(en.name);
+            if (!interesting(p)) return;
+            if (en.duration >= SLOW_MS) {
+              add({ t: "slow", url: p, ms: Math.round(en.duration), bytes: en.transferSize || 0 });
+            } else if (en.transferSize === 0 && en.duration > 0 && en.responseEnd > 0) {
+              // transferSize 为 0 且非缓存命中 → 常见于"请求被中断/取消"
+              add({ t: "zero", url: p, ms: Math.round(en.duration) });
+            }
+          });
+        } catch (x) {}
+      });
+      po.observe({ type: "resource", buffered: true });
+    }
+  } catch (x) {}
+
+  // ④ 首页启动失败文案（`Failed to load plugins` / `did not activate`）—— 抓具体插件名
+  function scanBootFailure() {
+    try {
+      var txt = (D.body && D.body.innerText) || "";
+      if (txt.indexOf("Failed to load plugins") < 0 && txt.indexOf("did not activate") < 0) return;
+      var lines = txt.split("\n").map(function (s) { return s.trim(); }).filter(Boolean);
+      for (var i = 0; i < lines.length; i++) {
+        if (/import failed|did not activate|pending \(waiting|: [a-z]+ failed/i.test(lines[i])) {
+          if (bootFailed.length < 10) bootFailed.push(clip(lines[i], 200));
+        }
+      }
+      if (bootFailed.length === 0) bootFailed.push("Failed to load plugins（无明细文本）");
+      if (timer === null) timer = setTimeout(flush, 300);
+    } catch (x) {}
+  }
+  try {
+    var mo = new W.MutationObserver(scanBootFailure);
+    if (D.documentElement) mo.observe(D.documentElement, { childList: true, subtree: true, characterData: true });
+    setTimeout(scanBootFailure, 6000);
+    setTimeout(scanBootFailure, 15000);
+  } catch (x) {}
+
+  function token() {
+    try {
+      var t = W.localStorage && W.localStorage.getItem("dsh_token");
+      if (t) return t;
+      var m = D.cookie.match(/(?:^|;\s*)dsh_token=([^;]+)/);
+      return m ? decodeURIComponent(m[1]) : "";
+    } catch (e) { return ""; }
+  }
+
+  function flush() {
+    timer = null;
+    if (sent || (items.length === 0 && bootFailed.length === 0)) return;
+    sent = true;
+    var tk = token();
+    var payload = {
+      v: VERSION,
+      kind: bootFailed.length ? "boot" : "runtime",
+      page: clip(W.location.pathname, 200),
+      ua: clip(W.navigator && W.navigator.userAgent, 300),
+      items: items.slice(0, MAX_ITEMS),
+      boot_failed: bootFailed.slice(0, 10),
+      at: now()
+    };
+    try {
+      fetch(ENDPOINT, {
+        method: "POST",
+        credentials: "same-origin",
+        headers: { "content-type": "application/json", ...(tk ? { authorization: "Bearer " + tk } : {}) },
+        body: JSON.stringify(payload),
+        keepalive: true
+      }).catch(function () { /* 上报失败静默：绝不影响页面 */ });
+    } catch (e) { /* ignore */ }
+  }
+
+  // 页面卸载前兜底发一次（keepalive 允许在卸载后继续）
+  W.addEventListener("pagehide", function () { try { if (!sent) flush(); } catch (x) {} });
+})();

package/packages/dsh-remote-web/runtime/clients/dsh-remote/mirror-diag.mjs

@@ -0,0 +1,106 @@
+/**
+ * mirror-diag.mjs — bridge 侧注入的「镜像页加载故障采集器」。
+ *
+ * 注入目标：经隧道回传的**官方 dsh web 文档**（与 mobile-adapter / e2ee-shim 同一注入管线、
+ * 同一宿主特征门），在 `</head>` 前插入 `<script id="dsh-mirror-diag-js">`。
+ *
+ * 为什么需要它（2026-10-17）：用户反馈「装了 UI 插件后打不开界面 / Failed to load plugins」，
+ * 本地复现不出来。生产日志只能看到 `/plugins/??…` 出现 499（客户端中断），拿不到浏览器侧
+ * 到底哪个资源失败、耗时多少、什么错误。采集器让下一次故障**自己带证据回来**。
+ *
+ * 与 e2ee 的关系：**刻意不依赖** e2ee.enabled —— 出问题的用户往往没开 E2EE，
+ * 只有无条件注入才能覆盖他们。脚本本身零 DOM 改动、只在失败时上报（见 mirror-diag-script.js）。
+ *
+ * 开关：
+ *   - `DSH_MIRROR_DIAG=0` → 完全不注入（逃生口）；
+ *   - `?mirror_diag=0` → 页面侧由脚本自身判定（见 mirror-diag-script.js 的注释）。
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const THIS_DIR = path.dirname(fileURLToPath(import.meta.url));
+export const DIAG_ID = "dsh-mirror-diag";
+export const DIAG_SCRIPT_PATH = path.join(THIS_DIR, "mirror-diag-script.js");
+
+/** 与 mobile-adapter / e2ee-shim 同源的「官方 dsh web 文档」特征门。 */
+const HOST_FEATURE_RE =
+  /(__ModuleLoader__|@deepseek-ai\/dsh-client-modules|@deepseek-ai\/dsh-client-connection|<title>\s*DeepSeek Harness)/i;
+
+/** 采集器源码：只在首次注入时读盘并缓存（读失败 → 永不注入，绝不影响主链路）。 */
+let scriptCache = null;
+function diagScriptText() {
+  if (scriptCache !== null) return scriptCache;
+  try {
+    scriptCache = fs.readFileSync(DIAG_SCRIPT_PATH, "utf8");
+  } catch {
+    scriptCache = "";
+  }
+  return scriptCache;
+}
+
+/** `DSH_MIRROR_DIAG=0` 关闭注入（默认开启）；测试里可用同样的环境变量。 */
+export function mirrorDiagEnabled() {
+  const v = process.env.DSH_MIRROR_DIAG;
+  return !(v === "0" || v === "false" || v === "off");
+}
+
+/** 注入门：text/html + 宿主特征 + 未注入过。 */
+export function shouldInjectMirrorDiag({ contentType, html }) {
+  const ct = String(contentType || "").toLowerCase();
+  if (!ct.includes("text/html")) return false;
+  const text = String(html || "");
+  if (text.length === 0) return false;
+  if (!text.toLowerCase().includes("</head>")) return false;
+  if (text.includes(`data-${DIAG_ID}`)) return false; // 幂等：重复注入直接跳过
+  return HOST_FEATURE_RE.test(text);
+}
+
+/**
+ * 纯函数：把采集器注入到上游 HTML 的 `</head>` 之前。
+ * @param {string} html
+ * @returns {{html: string, injected: boolean}}
+ */
+export function injectMirrorDiag(html) {
+  const src = String(html);
+  if (src.includes(`data-${DIAG_ID}`)) return { html: src, injected: false };
+  // ★ 注入点必须是 <head> **开头**，不能是 </head> 前：
+  //   官方 dsh web 的插件/主干 <script> 就在 <head> 里，注入到 </head> 前会**晚于**
+  //   那些脚本执行 —— 启动期错误（本次要抓的正是这类）就漏了。
+  //   用字符扫描而不是正则，避免 HTML 里的属性引号/大小写差异把注入点算错。
+  const low = src.toLowerCase();
+  const headIdx = low.indexOf("<head");
+  let pos = -1;
+  if (headIdx !== -1) {
+    const gt = low.indexOf(">", headIdx);
+    pos = gt === -1 ? headIdx : gt + 1;
+  } else {
+    pos = low.indexOf("</head>"); // 兜底：没有 <head> 时退化为 </head> 前
+  }
+  if (pos === -1) return { html: src, injected: false };
+  const script = diagScriptText();
+  if (!script) return { html: src, injected: false };
+  // 注入体不能含 </script>（会把文档提前截断）—— 采集器源码里本来就没有，这里再守一道。
+  if (/<\/script/i.test(script)) {
+    console.warn(`[${DIAG_ID}] 采集器源码含 </script>，拒绝注入`);
+    return { html: src, injected: false };
+  }
+  const block = `<script id="${DIAG_ID}-js" data-${DIAG_ID}>${script}</script>`;
+  return { html: src.slice(0, pos) + block + src.slice(pos), injected: true };
+}
+
+/**
+ * @param {{buf: Buffer, contentType: string}} input
+ * @returns {{buf: Buffer, injected: boolean}}
+ */
+export function maybeInjectMirrorDiag({ buf, contentType }) {
+  if (!mirrorDiagEnabled() || !Buffer.isBuffer(buf) || buf.length === 0) {
+    return { buf, injected: false };
+  }
+  const text = buf.toString("utf8");
+  if (!shouldInjectMirrorDiag({ contentType, html: text })) return { buf, injected: false };
+  const out = injectMirrorDiag(text);
+  return { buf: Buffer.from(out.html, "utf8"), injected: out.injected };
+}
+
+export default { injectMirrorDiag, maybeInjectMirrorDiag, shouldInjectMirrorDiag, mirrorDiagEnabled };

package/packages/dsh-remote-web/runtime/clients/dsh-remote/mobile-adapter.mjs

@@ -554,6 +554,67 @@ div.dsh-ma-menu .dsh-ma-load-warn[hidden] { display: none !important; }
 div.dsh-ma-menu .dsh-ma-load-warn .ico { flex: none; }
 div.dsh-ma-menu .dsh-ma-load-warn .txt { min-width: 0; overflow-wrap: anywhere; }
 
+/* ===== 加载疑似卡住时的**可操作**底部提示条（2026-10-17 事故新增） =====
+   事故现场：用户本机 ~/.dsh-remote（bridge 运行时 + 账号配对信息/设备密钥）被误删 → bridge 起不来、
+   手机端镜像页第一次加载**干等 47 秒**才报错；页面上只有悬浮菜单里一行"已等 N 秒…复制给客服"，
+   没有任何可点的操作。这里补一条**底部轻量提示条**（不是全屏层、不遮挡主界面）：
+     · 只在 12 秒看门狗判定 slow 之后才**懒创建**（解析期一个节点都不往页面塞）；
+     · 只占视口底部一条、高度受限（max-height），浮层外的区域照常可点 → 用户还能继续操作；
+     · 三个按钮：重试 / 返回设备列表 / 复制诊断信息，外加 ✕ 关闭；关掉后本页不再弹；
+     · 认出官方界面后自动收起（判断错了也不会一直挂着）——失败方向仍然安全：
+       最坏只是底部多一条**可关闭**的提示，而不是"永远盖住整片界面"。
+   动画只在「支持 prefers-reduced-motion 且用户没要求减少动效」时挂上：
+   老浏览器不认识这个媒体查询 → 不匹配 → 无动画（无需用 matchMedia 判断，也不会有兼容异常）。 */
+div.dsh-ma-loadbar {
+  position: fixed;
+  left: max(10px, env(safe-area-inset-left));
+  right: max(10px, env(safe-area-inset-right));
+  bottom: calc(10px + env(safe-area-inset-bottom));
+  /* 低于 FAB(400) 与菜单(401)：提示条不得压住"自救出口"（悬浮按钮永远点得到） */
+  z-index: 399;
+  display: flex; flex-wrap: wrap; align-items: center; gap: 8px;
+  box-sizing: border-box;
+  width: auto;
+  max-height: min(38vh, 260px);
+  overflow-y: auto;
+  -webkit-overflow-scrolling: touch;
+  padding: 10px 12px;
+  border-radius: 12px;
+  background: var(--dsw-alias-bg-elevated, #fff);
+  border: .5px solid var(--dsw-alias-border-l3, rgba(127,127,127,.3));
+  box-shadow: 0 6px 24px rgba(0,0,0,.24);
+  color: var(--dsw-alias-label-primary, #111);
+  font: 400 13px/1.5 -apple-system, system-ui, sans-serif;
+}
+/* ⚠️ 必须显式写 [hidden]：UA 的 [hidden]{display:none} 会被上面的 display:flex 盖过（本仓踩过）。 */
+div.dsh-ma-loadbar[hidden] { display: none !important; }
+div.dsh-ma-loadbar .dsh-ma-loadbar-txt { flex: 1 1 160px; min-width: 0; overflow-wrap: anywhere; }
+div.dsh-ma-loadbar .dsh-ma-loadbar-actions { display: flex; flex-wrap: wrap; gap: 6px; }
+div.dsh-ma-loadbar button {
+  flex: none; padding: 8px 12px; border-radius: 9px; cursor: pointer;
+  border: .5px solid var(--dsw-alias-border-l3, rgba(127,127,127,.35));
+  background: var(--dsw-alias-button-elevated-fill, rgba(127,127,127,.08));
+  color: var(--dsw-alias-label-primary, #111);
+  font: 600 13px/1 -apple-system, system-ui, sans-serif;
+  touch-action: manipulation; -webkit-tap-highlight-color: transparent;
+}
+div.dsh-ma-loadbar button:active { transform: scale(.98); }
+div.dsh-ma-loadbar button.dsh-ma-loadbar-close {
+  padding: 6px 9px; border-color: transparent; background: transparent;
+  color: var(--dsw-alias-label-tertiary, #6b7280);
+}
+@media (prefers-reduced-motion: no-preference) {
+  div.dsh-ma-loadbar { animation: dsh-ma-loadbar-in .18s ease-out; }
+  @keyframes dsh-ma-loadbar-in {
+    from { opacity: 0; transform: translateY(6px); }
+    to { opacity: 1; transform: none; }
+  }
+}
+/* 双保险：显式要求减少动效时一律无动画（老浏览器不匹配上面的 no-preference → 天然无动画） */
+@media (prefers-reduced-motion: reduce) {
+  div.dsh-ma-loadbar { animation: none !important; transition: none !important; }
+}
+
 /* 会话过期引导条:镜像页在会话过期后只会"连不上"，这里给一句能照做的话 + 一个出口。
    非阻塞(顶部细条)，点关闭即消失；不拦截任何请求。 */
 div.dsh-ma-sessionbar {
@@ -656,21 +717,33 @@ const SCRIPT = `(() => {
     }
   })();
 
-  /* ===== 「加载疑似没完成」看门狗（2026-09-25，替代被整块删除的首屏提示层）=====
-     那个提示层是全屏覆盖 + 启发式退出 —— 判断错一次就把**已经加载完**的界面永久盖住
-     （用户实测：秒表走到 187 秒，刷新也一样）。所以这里换一条**安全的失败方向**：
+  /* ===== 「加载疑似没完成」看门狗（2026-09-25 起；2026-10-17 提速并改成**可操作**提示）=====
+     历史：0.6.14 的首屏提示层是全屏覆盖 + 启发式退出 —— 判断错一次就把**已经加载完**的界面永久盖住
+     （用户实测：秒表走到 187 秒，刷新也一样）。所以 0.6.16 换了安全的失败方向：只置 slow 标记，
+     在**已有的**悬浮菜单里多一行字。这个方向本身是对的，但**提示太晚、且没有操作入口**——
+     2026-10-17 真实事故：用户本机 ~/.dsh-remote（运行时 + 账号配对信息/设备密钥）被误删后，
+     手机端镜像页第一次加载**干等 47 秒**才报错，页面上只有一行"已等 N 秒…复制给客服"，
+     用户完全不知道该重新安装还是重新登录。
 
-       · 解析期**不创建任何 DOM**（只有几个变量 + 一个定时器）—— 页面还没过主机门，
+     现在（2026-10-17）：
+       · 解析期仍然**不创建任何 DOM**（只有几个变量 + 一个定时器）—— 页面还没过主机门，
          更不该有任何覆盖层；
-       · 25 秒后仍认不出官方界面 → 只置一个 slow 标记，**不往页面塞任何东西**；
-       · 标记生效时，往**已有的**「远程控制」悬浮菜单里多一行字（点一下复制一句话给客服），
-         并建议点菜单里本来就有的「返回设备列表」重来；
-       · 判断错了的代价 = 菜单里多一行字（用户不点开菜单完全看不到）；不会再挡住任何人。
-
-     ⚠️ 刻意**不**做成页面顶部/底部的固定细条：那种细条同样会盖住官方 UI 的一部分，
-        而且同样有"永不消失"的失败方向。菜单是被动展开的，天然没有这个问题。 */
+       · **12 秒**后仍认不出官方界面 → 置 slow + 显示**底部轻量提示条**（懒创建）：
+         文案「电脑端可能未连接 / 页面加载较慢」+ 已等待秒数；
+         按钮：重试（location.reload）/ 返回设备列表（/app/）/ 复制诊断信息 / ✕ 关闭；
+       · 提示条**不是全屏层**：只占底部一条、高度受限、浮层外照常可点、可关闭，
+         关掉后本页不再弹；认出官方界面后自动收起 —— 失败方向仍然安全；
+       · 菜单里那一行字**保留**（被动展开，不打扰，也仍可复制诊断话术）。
+
+     ⚠️ 12 秒是"开始提示"的阈值，不是"判定失败"：限速放开后正常首屏 1~3 秒，
+        12 秒既能及时帮到用户，也不至于刚打开就吓人（宁可晚一点，也别误报）。
+     ⚠️ 注入体是模板字符串：本段注释/文案**一律用「」**，不得出现反引号。 */
   var maLoadWatch = { startedAt: Date.now(), slow: false, wired: false, bound: false, warnEl: null, warnTxt: null,
-                      reported: false, reportMs: 0 };
+                      reported: false, reportMs: 0,
+                      // 2026-10-17：底部可操作提示条（barEl = 懒创建的节点；barTimer = 秒数刷新）
+                      barEl: null, barTxt: null, barTimer: 0, dismissed: false };
+  /** 看门狗阈值（毫秒）：12 秒仍认不出官方界面就开始提示。测试按常量断言，不要散落魔法数。 */
+  var MA_LOAD_WATCH_MS = 12 * 1000;
   /** 官方界面是否已经可用（只看最强信号；只用于决定"要不要多显示一行字"）。 */
   function maLoadReadyNow() {
     try {
@@ -718,8 +791,8 @@ const SCRIPT = `(() => {
    *   ② **全程静默**：任何异常都吞掉，失败绝不影响页面，也绝不做重试；
    *   ③ 只在**已有的**同一批请求之外发这一次（一次 POST，几十字节），不是测速、不轮询。
    * body = { ms, outcome, at }：ms=耗时毫秒（截到 [0,600000]，与契约一致）；outcome ∈ {ok,slow}
-   * （slow = 25 秒看门狗兜底，是"删失下限"，后台只把 ok 计入 P50/P90）；at=事件发生的 epoch ms。
-   */
+   * （slow = 12 秒看门狗兜底，是"删失下限"，后台只把 ok 计入 P50/P90）；at=事件发生的 epoch ms。
+   * ⚠️ 2026-10-17：阈值 25s→12s，**字段与一次语义一律不变**（后台契约不动）。 */
   function maReportMirrorLoad(outcome) {
     if (maLoadWatch.reported) return;
     maLoadWatch.reported = true;
@@ -748,10 +821,140 @@ const SCRIPT = `(() => {
     try { ua = String((navigator && navigator.userAgent) || "").slice(0, 120); } catch (e) { /* 忽略 */ }
     return "dsh-remote 手机端加载疑似卡住：等待 " + maLoadWaitedSec() + " 秒后仍未出现对话界面。UA=" + ua;
   }
+
+  /* ===== 底部可操作提示条（2026-10-17，见上方看门狗注释）=====
+     纪律：
+       · **懒创建**：只有 slow 且用户没关过时才创建节点；
+       · **绝不阻塞**：只占底部一条（CSS 限高），浮层外照常可点；按钮动作全部就地完成；
+       · **任何异常都吞掉**：提示层坏掉也绝不影响页面（每个入口都有 try/catch）；
+       · **只提示一次**：用户点 ✕ 后 dismissed=true，本页不再弹（不骚扰）。 */
+  /** 提示条主文案：电脑端未连接/加载慢 + 已等待秒数（秒数由 barTimer 每秒刷新）。 */
+  function maLoadBarText() {
+    return "电脑端可能未连接 / 页面加载较慢（已等待 " + maLoadWaitedSec() + " 秒）";
+  }
+  /** 收起提示条并停掉秒数刷新（不改变 dismissed：用于"认出界面后自动收起"这类临时收起）。 */
+  function maLoadHideBar() {
+    try { if (maLoadWatch.barEl) maLoadWatch.barEl.hidden = true; } catch (e) { /* 忽略 */ }
+    try {
+      if (maLoadWatch.barTimer) { clearInterval(maLoadWatch.barTimer); maLoadWatch.barTimer = 0; }
+    } catch (e2) { /* 忽略 */ }
+  }
+  /** 用户点 ✕：本页不再弹（dismissed 是**本页**语义；刷新页面会重新开始一次提示机会）。 */
+  function maLoadDismissBar() {
+    try {
+      maLoadWatch.dismissed = true;
+      maLoadHideBar();
+      maLoadRenderWarn(); // 菜单里那一行也一起收起（关闭 = 本页只提示一次）
+    } catch (e) { /* 忽略 */ }
+  }
+  /** 导航（返回设备列表）：assign 失败退回 href。 */
+  function maLoadGoto(to) {
+    try { window.location.assign(to); return; } catch (e) { /* 继续 */ }
+    try { window.location.href = to; } catch (e2) { /* 忽略 */ }
+  }
+  /** 复制诊断信息（沿用 maLoadCopyLine：含 UA 与耗时）；剪贴板不可用时把整句显示在提示条上让用户截图。 */
+  function maLoadCopyDiag() {
+    var line = maLoadCopyLine();
+    var show = function (t) {
+      try { if (maLoadWatch.barTxt) maLoadWatch.barTxt.textContent = t; } catch (e) { /* 忽略 */ }
+    };
+    try {
+      if (navigator && navigator.clipboard && navigator.clipboard.writeText) {
+        var p = navigator.clipboard.writeText(line);
+        if (p && typeof p.then === "function") {
+          p.then(function () { show("已复制诊断信息（含等待时长与机型），可直接发给客服。"); },
+                 function () { show(line); });
+          return;
+        }
+      }
+    } catch (e) { /* 落到显示 */ }
+    show(line);
+  }
+  /** 懒创建提示条（只在 slow 之后调用；解析期绝不碰 DOM）。 */
+  function maLoadMountBar() {
+    try {
+      if (maLoadWatch.barEl || maLoadWatch.dismissed) return maLoadWatch.barEl;
+      var body = document.body || document.documentElement;
+      if (!body || !body.appendChild) return null;
+      var bar = document.createElement("div");
+      bar.className = "dsh-ma-loadbar";
+      /* role=status + aria-live=polite：读屏软件会把"加载较慢"念出来，但不会抢焦点；
+         它**不是** dialog/alert，不抢键盘、不锁滚动。 */
+      bar.setAttribute("role", "status");
+      bar.setAttribute("aria-live", "polite");
+      bar.innerHTML =
+        '<div class="dsh-ma-loadbar-txt" data-role="loadbar-txt"></div>' +
+        '<div class="dsh-ma-loadbar-actions">' +
+          '<button type="button" class="dsh-ma-loadbar-btn" data-role="loadbar-retry">重试</button>' +
+          '<button type="button" class="dsh-ma-loadbar-btn" data-role="loadbar-back">返回设备列表</button>' +
+          '<button type="button" class="dsh-ma-loadbar-btn" data-role="loadbar-copy">复制诊断信息</button>' +
+        '</div>' +
+        '<button type="button" class="dsh-ma-loadbar-close" data-role="loadbar-close" aria-label="关闭提示">✕</button>';
+      bar.hidden = true;
+      maLoadWatch.barEl = bar;
+      maLoadWatch.barTxt = bar.querySelector('[data-role="loadbar-txt"]');
+      bar.addEventListener("click", function (ev) {
+        // 事件委托：真实浏览器里目标可能是按钮内的文字节点；从 target 往上找到 [data-role]
+        try {
+          if (ev && typeof ev.preventDefault === "function") ev.preventDefault();
+        } catch (e0) { /* 忽略 */ }
+        try {
+          var t = ev && ev.target ? ev.target : null;
+          var role = "";
+          var guard = 0;
+          while (t && t !== bar && guard < 16 && !role) {
+            guard += 1;
+            try {
+              if (t.getAttribute) role = String(t.getAttribute("data-role") || "");
+            } catch (e1) { role = ""; }
+            t = t.parentNode || null;
+          }
+          if (role === "loadbar-retry") {
+            try { window.location.reload(); } catch (e2) { /* 忽略 */ }
+          } else if (role === "loadbar-back") {
+            maLoadGoto("/app/"); // 绝对路径：镜像页当前路径可能是 /remote/<deviceId>/…
+          } else if (role === "loadbar-copy") {
+            maLoadCopyDiag();
+          } else if (role === "loadbar-close") {
+            maLoadDismissBar();
+          }
+        } catch (e3) { /* 提示条失败绝不影响页面 */ }
+      });
+      body.appendChild(bar);
+      return bar;
+    } catch (e) { return null; }
+  }
+  /** 按当前状态渲染提示条（slow + 未关闭 → 显示；否则收起）。 */
+  function maLoadRenderBar() {
+    try {
+      if (!maLoadWatch.slow || maLoadWatch.dismissed) { maLoadHideBar(); return; }
+      var bar = maLoadWatch.barEl || maLoadMountBar();
+      if (!bar) return;
+      if (maLoadWatch.barTxt) maLoadWatch.barTxt.textContent = maLoadBarText();
+      bar.hidden = false;
+      if (!maLoadWatch.barTimer) {
+        // 每秒刷新「已等待 N 秒」；同时复核"是不是其实早就好了"——好了就自动收起（不长期挂着）。
+        maLoadWatch.barTimer = setInterval(function () {
+          try {
+            if (!maLoadWatch.slow || maLoadWatch.dismissed) { maLoadHideBar(); return; }
+            if (maLoadReadyNow()) {
+              maLoadWatch.slow = false;
+              maLoadHideBar();
+              maLoadRenderWarn(); // 菜单那一行也一起收起
+              return;
+            }
+            if (maLoadWatch.barTxt) maLoadWatch.barTxt.textContent = maLoadBarText();
+          } catch (e) { /* 忽略 */ }
+        }, 1000);
+        try { if (maLoadWatch.barTimer && maLoadWatch.barTimer.unref) maLoadWatch.barTimer.unref(); } catch (e2) { /* 忽略 */ }
+      }
+    } catch (e) { /* 提示条失败绝不影响页面 */ }
+  }
   function maLoadRenderWarn() {
     try {
       if (!maLoadWatch.warnEl) return;
-      if (!maLoadWatch.slow) { maLoadWatch.warnEl.hidden = true; return; }
+      // 用户点过 ✕ = 本页不想再被这事打扰：菜单里那一行也一起收起（"只提示一次"）
+      if (!maLoadWatch.slow || maLoadWatch.dismissed) { maLoadWatch.warnEl.hidden = true; return; }
       if (maLoadWatch.warnTxt) {
         maLoadWatch.warnTxt.textContent = "本次页面可能没加载完整（已等 " + maLoadWaitedSec()
           + " 秒）。点这里复制一句话发给客服，或点下方「返回设备列表」重来。";
@@ -785,18 +988,18 @@ const SCRIPT = `(() => {
       }
     } catch (e) { /* 忽略 */ }
   }
-  // 25 秒后仍认不出官方界面 → 置慢标记（**只改状态，不碰 DOM**）。
-  // 阈值取得很宽松：宁可漏报（什么都不显示，与今天一致），也不要误报吓人。
-  // 同一处顺手把 mirror_load 的**兜底样本**发出去（outcome="slow"）：25 秒没就绪的页面上报的
-  // 必然是"≥25 秒"，这是**删失下限**而不是真实耗时，后台只把它单列，不混进 P50/P90。
+  // 12 秒后仍认不出官方界面 → 置慢标记 + 懒创建底部提示条（**只在这时才碰 DOM**）。
+  // 同一处顺手把 mirror_load 的**兜底样本**发出去（outcome="slow"）：12 秒没就绪的页面上报的
+  // 必然是"≥12 秒"，这是**删失下限**而不是真实耗时，后台只把它单列，不混进 P50/P90。
   setTimeout(function () {
     try {
       if (maLoadReadyNow()) return;
       maLoadWatch.slow = true;
       if (maLoadWatch.wired) maLoadRenderWarn();
+      maLoadRenderBar(); // 底部可操作提示条（重试 / 返回设备列表 / 复制诊断 / 关闭）
       maReportMirrorLoad("slow");
     } catch (e) { /* 忽略 */ }
-  }, 25 * 1000);
+  }, MA_LOAD_WATCH_MS);
 
   try {
     const HOST_RE = new RegExp(${JSON.stringify(RUNTIME_HOST_RE.source)});
@@ -2511,13 +2714,24 @@ const SCRIPT = `(() => {
       maObserver = null;
       try { if (maInterval) clearInterval(maInterval); } catch (eD2) { /* 忽略 */ }
       maInterval = 0;
+      // 加载提示条的秒数刷新也一起停掉（页面卸载/进 bfcache 后不留悬挂回调）
+      try { if (maLoadWatch.barTimer) { clearInterval(maLoadWatch.barTimer); maLoadWatch.barTimer = 0; } } catch (eD3) { /* 忽略 */ }
     };
     try { window.addEventListener("pagehide", maTeardown); } catch (ePh) { /* 忽略 */ }
     try { window.addEventListener("unload", maTeardown); } catch (eUl) { /* 忽略 */ }
     /* 手机上"切到别的 App 再切回来"走的常是 bfcache:pagehide(persisted=true) → pageshow(persisted=true)。
-       DOM 原样保留但计时器/观察者已断 —— 这里重新武装,否则回到页面后看门狗就永久失灵了。 */
+       DOM 原样保留但计时器/观察者已断 —— 这里重新武装,否则回到页面后看门狗就永久失灵了。
+       2026-10-17：加载提示条的秒数刷新也在 maTeardown 里停了，回到前台要按现状重新挂上
+       （否则用户切回来看的是"冻结的已等待 N 秒"）。 */
     try {
-      window.addEventListener("pageshow", (ev) => { try { if (ev && ev.persisted) maArm(); } catch (ePs) { /* 忽略 */ } });
+      window.addEventListener("pageshow", (ev) => {
+        try {
+          if (ev && ev.persisted) {
+            maArm();
+            if (maLoadWatch.slow && !maLoadWatch.dismissed) maLoadRenderBar();
+          }
+        } catch (ePs) { /* 忽略 */ }
+      });
     } catch (ePs2) { /* 忽略 */ }
   } catch (e) { if (window.console) console.warn("[dsh-mobile-adapter]", e && e.message); }
 })();`;

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

@@ -357,7 +357,8 @@ test("点一条未读公告 → 立刻 POST /dsh-remote/announcements/click（
   assert.ok(click, "点公告必须上报点击（现契约只有 /click，没有 /read）");
   assert.equal(click.method, "POST", "点击上报必须是 POST");
   assert.equal(JSON.parse(click.body).id, 3, "请求体必须带该条公告的 id");
-  assert.ok(textHas(tree, "已读状态已同步到后台"), "点击后应展开详情弹窗");
+  // 2026-10-17（业主）：点开**不再**当已读 —— 弹窗页脚不再出现「已读状态已同步到后台」。
+  assert.ok(!textHas(tree, "已读状态已同步到后台"), "点开不等于已读：页脚不得再出现「已读状态已同步到后台」");
   assert.ok(textHas(tree, "扫码登录更快了"), "详情应展示公告正文");
 });
 
@@ -471,9 +472,11 @@ test("绝不轮询：每次页面加载只自动拉一次公告（重复拉会
   assert.ok(gets[0].path.includes("client=desktop"), "必须显式声明 client=desktop");
 });
 
-test("源码级：面板卡片里的「刷新公告」是唯一的手动重拉入口，且**不**用于弹窗", () => {
+test("源码级：公告只在打开面板时拉一次（2026-10-17 删掉「刷新公告」按钮）", () => {
+  // 业主约定：删除手动刷新按钮 —— 打开看板时自动拉一次即可，避免用户重复点击消耗"待弹公告"。
+  assert.doesNotMatch(SOURCE, /刷新公告/, "「刷新公告」按钮必须已删除");
   assert.match(SOURCE, /annPullOnce/, "必须有 sessionStorage 一次性拉取标记");
-  assert.match(SOURCE, /openPopup:\s*false/, "手动刷新必须显式关闭弹窗（openPopup:false）");
+  assert.match(SOURCE, /openPopup:\s*true/, "自动拉取那一次按需弹窗（openPopup:true）");
   // 一次性标记必须写在 sessionStorage（localStorage 的 origin 会随端口变，挡不住同页重复拉）
   const fn = SOURCE.slice(SOURCE.indexOf("function annPullOnce("), SOURCE.indexOf("function annReportClick("));
   assert.match(fn, /sessionStorage/, "一次性标记必须在 sessionStorage 上");

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

@@ -167,14 +167,20 @@ test("桌面端：面板不得自动倒计时重启，且不摆点了必然失
     "自动倒计时重启必须在桌面端短路（Host 由 Electron 托管，不能替用户重启）");
   assert.match(CLIENT_SRC, /\(desktopHost && !isRefreshOnly\) \? null : h\("button"/,
     "桌面端且非'刷新即可'时不得渲染重启按钮");
-  // 旧版 host 不下发该字段 → undefined → 行为必须与改动前一致
-  assert.match(CLIENT_SRC, /\? "🔄 插件已更新：重启 dsh web 后生效"[\s\S]{0,40}: "🔄 插件已更新：刷新页面即可生效"\);/,
-    "非桌面端文案必须保留原有判据 isRestartHard（不得顺手改发布版文案）");
+  // 2026-10-17（业主）：桌面端**不再**出现"重启 DeepSeek Harness"这类引导，
+  // 统一只说「刷新页面即可生效」；非桌面端保留原有 isRestartHard 判据（发布版文案不变）。
+  assert.doesNotMatch(CLIENT_SRC, /退出并重新打开 DeepSeek Harness/,
+    "桌面端不得再引导用户重启应用（运行环境由应用托管、更新自动热加载）");
+  assert.match(CLIENT_SRC, /插件已更新：刷新页面即可生效/);
 });
 
-test("桌面端：面板文案改为引导'退出并重开应用'，且不影响 Web 版", () => {
-  assert.match(CLIENT_SRC, /退出并重新打开 DeepSeek Harness 后生效/, "桌面端要有明确引导");
-  assert.match(CLIENT_SRC, /桌面端由应用本身托管运行环境/, "底部常驻按钮位置要有桌面端说明");
+test("桌面端：删除「重启 DeepSeek Harness」整段说明（2026-10-17 业主约定）", () => {
+  // 原因：桌面端运行环境由应用本身托管、插件安装/更新自动热加载 —— 让用户"退出并重开应用"
+  // 既没必要也增加负担。底部常驻重启区在桌面端整块不渲染（非桌面端才保留重启入口）。
+  assert.doesNotMatch(CLIENT_SRC, /桌面端由应用本身托管运行环境/, "整段重启说明必须删除");
+  assert.doesNotMatch(CLIENT_SRC, /请直接退出并重新打开应用/, "不得再引导重启应用");
+  assert.match(CLIENT_SRC, /desktopHost \? null : h\("div", \{ className: "dru-restart-foot" \}/,
+    "桌面端不渲染底部重启区（非桌面端保留）");
 });
 
 // ─────────────── ④ 安装：--profile desktop 必须真的生效 ───────────────