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

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

@@ -76,6 +76,7 @@ import { promisify } from "node:util";
 import { gzip as gzipCb } from "node:zlib";
 // 移动端适配层(经隧道访问的官方 dsh web 窄屏注入;DSH_MOBILE_ADAPTER=0 可关闭,默认开启)
 import { maybeInjectMobileAdapter } from "./mobile-adapter.mjs";
+import { maybeInjectMirrorDiag } from "./mirror-diag.mjs";
 import { discoverUpstream, resolveUpstreamHint, FALLBACK_UPSTREAM } from "./upstream-discovery.mjs";
 // 镜像页 E2EE 加密 shim(Phase-4):text/html 注入;DSH_E2EE_SHIM=0 可关闭,叠加 e2ee.enabled 灰度门
 import { maybeInjectE2eeShim } from "./e2ee-shim.mjs";
@@ -862,6 +863,15 @@ async function doHttp(method, path, reqHeaders, body, isB64) {
       buf = m.buf;
       armMirrorLoadWatch(path);
     }
+    // 镜像页加载故障采集器（2026-10-17，**与 e2ee 无关**）：出问题的用户往往没开 E2EE，
+    // 所以无条件注入。只在失败时上报（见 mirror-diag-script.js），零 DOM 改动。
+    {
+      const d = maybeInjectMirrorDiag({ buf, contentType });
+      if (d.injected) {
+        console.log(`[bridge] mirror-diag 注入 ${path}: ${(buf.length / 1024).toFixed(0)}KB → ${(d.buf.length / 1024).toFixed(0)}KB`);
+        buf = d.buf;
+      }
+    }
     // E2EE 镜像页加密 shim(Phase-4):仅桥端 e2ee 启用时注入(e2ee.enabled=false → 零注入零行为)
     if (e2ee.enabled) {
       const s = maybeInjectE2eeShim({ buf, contentType });
@@ -1235,6 +1245,12 @@ export async function handleWsOpen(dchOrSend, frame) {
     console.log(`[bridge] ws-error ${path} (id=${id}): ${e.message || ""}`);
     if (!session.opened) {
       wsSessions.delete(id);
+      // ★ 上游可能已经换端口（桌面端 App 重启会换本地端口，生产日志里抓到过
+      //   `upstream_ws_open_failed ... ECONNREFUSED 127.0.0.1:19387`）。
+      //   HTTP 失败路径早就会触发重新发现，**WS 失败路径之前漏了** —— 而镜像页常常
+      //   先开 WS（控制通道/数据通道），于是端口变了以后一直 502、页面白屏，直到用户
+      //   手动重开。这里补上：本次失败照旧回 502，但立即触发重新发现，下一次重试就命中新端口。
+      void refreshUpstream("ws-open 上游连接失败");
       send({ id, type: "ws-open", ok: false, code: 502, reason: String(e.message || "ws error") });
     }
   });

package/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/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/clients/dsh-remote/test/bridge-html-inject.test.mjs

@@ -70,16 +70,50 @@ const decode = (reply) => {
 };
 
 test("集成:官方特征 html 经 doHttp 回传时注入适配层", async () => {
-  const reply = await request({ id: "h1", method: "GET", path: "/page", headers: { "accept-encoding": "gzip", "user-agent": "phone" } });
-  assert.equal(reply.status, 200);
-  const text = decode(reply);
-  assert.ok(text.includes('data-dsh-mobile-adapter'), "应注入 style/script");
-  const headIdx = text.toLowerCase().lastIndexOf("</head>");
-  assert.ok(text.indexOf("dsh-mobile-adapter-css") < headIdx, "注入块应位于 </head> 前");
-  // 原文其余部分保持(仅 splice)
-  const oi = OFFICIAL_HTML.toLowerCase().lastIndexOf("</head>");
-  assert.ok(text.startsWith(OFFICIAL_HTML.slice(0, oi)));
-  assert.ok(text.endsWith(OFFICIAL_HTML.slice(oi)));
+  // 2026-10-17 起还有一份**独立的**故障采集器注入（与 mobile-adapter 无关）；
+  // 本用例只验适配层，用 DSH_MIRROR_DIAG=0 把它关掉，保证这里断言的是"仅 splice、原文不动"。
+  process.env.DSH_MIRROR_DIAG = "0";
+  try {
+    const reply = await request({ id: "h1", method: "GET", path: "/page", headers: { "accept-encoding": "gzip", "user-agent": "phone" } });
+    assert.equal(reply.status, 200);
+    const text = decode(reply);
+    assert.ok(text.includes('data-dsh-mobile-adapter'), "应注入 style/script");
+    const headIdx = text.toLowerCase().lastIndexOf("</head>");
+    assert.ok(text.indexOf("dsh-mobile-adapter-css") < headIdx, "注入块应位于 </head> 前");
+    // 原文其余部分保持(仅 splice)
+    const oi = OFFICIAL_HTML.toLowerCase().lastIndexOf("</head>");
+    assert.ok(text.startsWith(OFFICIAL_HTML.slice(0, oi)));
+    assert.ok(text.endsWith(OFFICIAL_HTML.slice(oi)));
+  } finally {
+    delete process.env.DSH_MIRROR_DIAG;
+    delete process.env.DSH_MOBILE_ADAPTER;
+  }
+});
+
+test("★ 集成:故障采集器**无条件**注入（不依赖 e2ee，也不依赖 mobile-adapter 开关）", async () => {
+  // 出问题的用户往往没开 E2EE、也可能被关了适配层 —— 采集器必须仍然在场，否则又变成"猜"。
+  process.env.DSH_MOBILE_ADAPTER = "0";
+  try {
+    const reply = await request({ id: "h1b", method: "GET", path: "/page", headers: { "user-agent": "phone" } });
+    const text = decode(reply);
+    assert.ok(text.includes("data-dsh-mirror-diag"), "mobile-adapter 关掉时采集器仍要注入");
+    assert.ok(text.indexOf("data-dsh-mirror-diag") < text.indexOf("__ModuleLoader__"), "必须在页面自身脚本之前");
+    assert.ok(!text.includes("data-dsh-mobile-adapter"), "适配层确实关着");
+  } finally {
+    delete process.env.DSH_MOBILE_ADAPTER;
+  }
+  // 逃生口：DSH_MIRROR_DIAG=0 → 一个字节都不注入，严格原样
+  process.env.DSH_MIRROR_DIAG = "0";
+  process.env.DSH_MOBILE_ADAPTER = "0"; // 适配层也要关，否则"原样"的基准不是 OFFICIAL_HTML
+  try {
+    const reply = await request({ id: "h1c", method: "GET", path: "/page", headers: { "user-agent": "phone" } });
+    const text = decode(reply);
+    assert.equal(text, OFFICIAL_HTML);
+    assert.ok(!text.includes("data-dsh-mirror-diag"));
+  } finally {
+    delete process.env.DSH_MIRROR_DIAG;
+    delete process.env.DSH_MOBILE_ADAPTER;
+  }
 });
 
 test("集成:注入在 gzip 前发生,回包仍可 gzip 解压且含注入块", async () => {
@@ -91,6 +125,7 @@ test("集成:注入在 gzip 前发生,回包仍可 gzip 解压且含注入块",
 
 test("集成:DSH_MOBILE_ADAPTER=0 关闭注入,原样回传", async () => {
   process.env.DSH_MOBILE_ADAPTER = "0";
+  process.env.DSH_MIRROR_DIAG = "0"; // 两个注入器都关，才叫"原样"
   try {
     const reply = await request({ id: "h3", method: "GET", path: "/page", headers: { "user-agent": "phone" } });
     const text = decode(reply);
@@ -98,6 +133,7 @@ test("集成:DSH_MOBILE_ADAPTER=0 关闭注入,原样回传", async () => {
     assert.equal(text, OFFICIAL_HTML);
   } finally {
     delete process.env.DSH_MOBILE_ADAPTER;
+    delete process.env.DSH_MIRROR_DIAG;
   }
 });
 

package/clients/dsh-remote/test/bridge-upstream-refresh.test.mjs

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+/**
+ * 上游端口漂移自愈（2026-10-17）。
+ *
+ * 生产日志实证：
+ *   WS 升级被拒: reason=upstream_ws_open_failed status=502 msg=connect ECONNREFUSED 127.0.0.1:19387
+ * 桌面端 App 重启会换本地端口，而 bridge 缓存了旧上游 → 镜像页 502/白屏。
+ * HTTP 失败路径早就会 refreshUpstream，**WS 失败路径之前漏了** —— 而镜像页常先开 WS。
+ *
+ * 这个用例守住：两条失败路径都必须触发重新发现（否则又回到"只能重启 bridge"）。
+ */
+import test from "node:test";
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+
+const SRC = readFileSync(new URL("../dsh-bridge.mjs", import.meta.url), "utf8");
+
+test("★ WS 打开失败必须触发上游重新发现（不只是回 502）", () => {
+  // 找到 ws.on("error" ...) 的未建立分支
+  const i = SRC.indexOf('ws.on("error"');
+  assert.ok(i > 0, "必须有 ws error 处理");
+  const branch = SRC.slice(i, i + 1200);
+  assert.match(branch, /!session\.opened/, "只对未建立的会话做 502");
+  assert.match(branch, /refreshUpstream\(/, "★ 必须触发重新发现，否则端口变了会一直 502");
+  assert.match(branch, /code: 502/, "行为不变：本次仍然回 502");
+});
+
+test("★ HTTP 失败路径也要有重新发现（既有能力不得回退）", () => {
+  const hits = SRC.match(/refreshUpstream\(/g) || [];
+  assert.ok(hits.length >= 3, `至少 HTTP/WS/启动 三处调用，实际 ${hits.length}`);
+  assert.match(SRC, /上游请求失败/, "HTTP 失败路径的理由文案应在");
+});
+
+test("★ 重新发现必须有冷却（失败连成片时不能每个请求都 lsof/pgrep）", () => {
+  assert.match(SRC, /UPSTREAM_REFRESH_COOLDOWN_MS/);
+  const m = SRC.match(/UPSTREAM_REFRESH_COOLDOWN_MS\s*=\s*([\d_]+)/);
+  assert.ok(m, "必须定义冷却常量");
+  const ms = Number(m[1].replace(/_/g, ""));
+  assert.ok(ms >= 5000 && ms <= 60000, `冷却应在 5–60s（实际 ${ms}ms）`);
+});

package/clients/dsh-remote/test/mirror-diag.test.mjs

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+/**
+ * mirror-diag.mjs —— 镜像页故障采集器的注入契约（防回归）。
+ *
+ * 这个文件守的是"下次故障能不能带证据回来"，本身不修任何功能，所以更不能坏：
+ *   ① 注入位置必须在 </head> 前（否则文档已开始执行，抓不到启动错误）；
+ *   ② 幂等：重复注入会把同一份脚本塞两遍（每次请求/每次重试都塞）；
+ *   ③ 门要准：只注入官方 dsh web 文档（text/html + 宿主特征），不能污染其它响应；
+ *   ④ 开关必须真的关：DSH_MIRROR_DIAG=0 → 一个字节都不注入；
+ *   ⑤ 注入体不得含 </script>（会把整页截断）。
+ *
+ * 用法：node --test test/mirror-diag.test.mjs
+ */
+import test from "node:test";
+import assert from "node:assert/strict";
+import {
+  injectMirrorDiag, maybeInjectMirrorDiag, shouldInjectMirrorDiag,
+  mirrorDiagEnabled, DIAG_ID, DIAG_SCRIPT_PATH
+} from "../mirror-diag.mjs";
+import fs from "node:fs";
+
+const HTML = `<!doctype html><html><head><title>DeepSeek Harness</title>
+<script type="module" src="./assets/index.js"></script></head><body><div id="root"></div></body></html>`;
+
+test("★ 注入到 </head> 之前，且带唯一标记（幂等可识别）", () => {
+  const out = injectMirrorDiag(HTML);
+  assert.equal(out.injected, true);
+  const i = out.html.indexOf(`data-${DIAG_ID}`);
+  assert.ok(i > 0, "必须带 data- 标记");
+  assert.ok(i < out.html.indexOf("</head>"), "必须在 </head> 之前");
+  assert.ok(i < out.html.indexOf("./assets/index.js"), "必须早于页面自身脚本（才能抓到启动期错误）");
+  assert.ok(i < out.html.indexOf("<title>"), "必须紧跟 <head> 开头（越早越能抓到错误）");
+  // 原始内容一个不丢
+  assert.ok(out.html.includes('<div id="root"></div>'));
+});
+
+test("★ 幂等：已注入过就不再注入（防止重复执行/重复上报）", () => {
+  const once = injectMirrorDiag(HTML);
+  const twice = injectMirrorDiag(once.html);
+  assert.equal(twice.injected, false);
+  assert.equal(twice.html, once.html);
+});
+
+test("★ 门要准：非 HTML / 非官方文档 / 已注入 → 一律不注入", () => {
+  assert.equal(shouldInjectMirrorDiag({ contentType: "application/javascript", html: HTML }), false, "JS 不注入");
+  assert.equal(shouldInjectMirrorDiag({ contentType: "text/html", html: "<html><head></head><body>hi</body></html>" }), false, "非官方文档不注入");
+  assert.equal(shouldInjectMirrorDiag({ contentType: "text/html", html: "<html><body>无 head</body></html>" }), false, "无 </head> 不注入");
+  const injected = injectMirrorDiag(HTML).html;
+  assert.equal(shouldInjectMirrorDiag({ contentType: "text/html", html: injected }), false, "已注入要跳过");
+});
+
+test("★ 开关真能关：DSH_MIRROR_DIAG=0 → 不注入（逃生口）", () => {
+  const old = process.env.DSH_MIRROR_DIAG;
+  try {
+    process.env.DSH_MIRROR_DIAG = "0";
+    assert.equal(mirrorDiagEnabled(), false);
+    const r = maybeInjectMirrorDiag({ buf: Buffer.from(HTML), contentType: "text/html" });
+    assert.equal(r.injected, false);
+  } finally {
+    if (old === undefined) delete process.env.DSH_MIRROR_DIAG; else process.env.DSH_MIRROR_DIAG = old;
+  }
+});
+
+test("★ Buffer 入口：注入后仍是合法 UTF-8，且字节数增加", () => {
+  const buf = Buffer.from(HTML);
+  const r = maybeInjectMirrorDiag({ buf, contentType: "text/html; charset=utf-8" });
+  assert.equal(r.injected, true);
+  assert.ok(r.buf.length > buf.length, "注入后应变大");
+  const text = r.buf.toString("utf8");
+  assert.ok(text.includes("</head>") && text.includes("dsh-mirror-diag"));
+  assert.ok(!text.includes("\ufffd"), "不得出现替换字符（编码破坏）");
+});
+
+test("★ 采集器源码自身：不含 </script>、不写 DOM、只在失败时上报", () => {
+  const src = fs.readFileSync(DIAG_SCRIPT_PATH, "utf8");
+  assert.ok(src.length > 500, "采集器不能是空壳");
+  assert.ok(!/<\/script/i.test(src), "含 </script> 会把宿主文档截断");
+  assert.ok(!/document\.body\.appendChild|innerHTML\s*=/.test(src), "采集器不得改动页面 DOM");
+  assert.match(src, /mirror-diag/, "上报地址要对");
+  assert.match(src, /Failed to load plugins/, "必须识别首页启动失败文案");
+  assert.match(src, /mirror_diag|DSH_MIRROR_DIAG|pagehide/, "必须有无痕静默路径");
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrisega/dsh-remote",
-  "version": "0.7.1",
+  "version": "0.7.2-beta.1",
   "description": "手机远程控制 DeepSeek Harness · Remote control DeepSeek Harness (dsh web) from any phone browser — 100% 全功能 App 级体验：发消息、看工具执行、审批权限、改设置、管凭据，含特权操作，免内网穿透。一条命令安装 npx @mrrisega/dsh-remote。Mobile remote control for DSH, self-host or SaaS, no server needed on LAN.",
   "keywords": [
     "deepseek-harness",

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

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

package/packages/dsh-remote-web/runtime/clients/dsh-remote/dsh-bridge.mjs

@@ -76,6 +76,7 @@ import { promisify } from "node:util";
 import { gzip as gzipCb } from "node:zlib";
 // 移动端适配层(经隧道访问的官方 dsh web 窄屏注入;DSH_MOBILE_ADAPTER=0 可关闭,默认开启)
 import { maybeInjectMobileAdapter } from "./mobile-adapter.mjs";
+import { maybeInjectMirrorDiag } from "./mirror-diag.mjs";
 import { discoverUpstream, resolveUpstreamHint, FALLBACK_UPSTREAM } from "./upstream-discovery.mjs";
 // 镜像页 E2EE 加密 shim(Phase-4):text/html 注入;DSH_E2EE_SHIM=0 可关闭,叠加 e2ee.enabled 灰度门
 import { maybeInjectE2eeShim } from "./e2ee-shim.mjs";
@@ -862,6 +863,15 @@ async function doHttp(method, path, reqHeaders, body, isB64) {
       buf = m.buf;
       armMirrorLoadWatch(path);
     }
+    // 镜像页加载故障采集器（2026-10-17，**与 e2ee 无关**）：出问题的用户往往没开 E2EE，
+    // 所以无条件注入。只在失败时上报（见 mirror-diag-script.js），零 DOM 改动。
+    {
+      const d = maybeInjectMirrorDiag({ buf, contentType });
+      if (d.injected) {
+        console.log(`[bridge] mirror-diag 注入 ${path}: ${(buf.length / 1024).toFixed(0)}KB → ${(d.buf.length / 1024).toFixed(0)}KB`);
+        buf = d.buf;
+      }
+    }
     // E2EE 镜像页加密 shim(Phase-4):仅桥端 e2ee 启用时注入(e2ee.enabled=false → 零注入零行为)
     if (e2ee.enabled) {
       const s = maybeInjectE2eeShim({ buf, contentType });
@@ -1235,6 +1245,12 @@ export async function handleWsOpen(dchOrSend, frame) {
     console.log(`[bridge] ws-error ${path} (id=${id}): ${e.message || ""}`);
     if (!session.opened) {
       wsSessions.delete(id);
+      // ★ 上游可能已经换端口（桌面端 App 重启会换本地端口，生产日志里抓到过
+      //   `upstream_ws_open_failed ... ECONNREFUSED 127.0.0.1:19387`）。
+      //   HTTP 失败路径早就会触发重新发现，**WS 失败路径之前漏了** —— 而镜像页常常
+      //   先开 WS（控制通道/数据通道），于是端口变了以后一直 502、页面白屏，直到用户
+      //   手动重开。这里补上：本次失败照旧回 502，但立即触发重新发现，下一次重试就命中新端口。
+      void refreshUpstream("ws-open 上游连接失败");
       send({ id, type: "ws-open", ok: false, code: 502, reason: String(e.message || "ws error") });
     }
   });

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 };