dsh-remote-web 0.7.1-beta.1 → 0.7.2-beta.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-web",
-  "version": "0.7.1-beta.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/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/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/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 };