@mrrisega/dsh-remote 0.6.10 → 0.6.12

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

@@ -591,7 +591,17 @@ class EventSubscriber extends EventEmitter {
     if (ws !== null) {
       try {
         ws.removeAllListeners();
-        ws.close(1000, "subscriber closed");
+        // ⚠️ 先挂一个吞掉的 error 监听：**握手中的**连接被 close() 时，ws 会**异步** emit
+        //    'error'（"WebSocket was closed before the connection was established"）。
+        //    上面刚 removeAllListeners()，于是它成了**未捕获错误** —— 真机表现是「解绑」
+        //    这一步偶发把流程打挂（测试里是一条 e2e 偶发红，2026-09-23 定位）。
+        ws.on("error", () => { /* 关闭途中的错误不该冒泡到业务 */ });
+        if (ws.readyState === this.#WebSocketImpl.CONNECTING) {
+          // 还没握手完 → terminate()：立刻中止，且不产生上面那个错误
+          ws.terminate();
+        } else {
+          ws.close(1000, "subscriber closed");
+        }
       } catch {
         /* 关不掉就等 GC */
       }

package/clients/dsh-remote/test/wechat-runtime.test.mjs

@@ -1666,3 +1666,82 @@ test("★ /help 必须逐行分隔:付费档也不许退化成一坨(无换行/
     await ilink.close();
   }
 });
+
+// ---------------------------------------------------------------------------
+// 日报**重复推送**的根治（2026-09-23 业主实测「每日简报推送了两次」）
+//
+// 根因：`#maybeDigest` 是「读 state → 等网络发送 → 写 state」的**跨 await 读-改-写**。
+// 发送要等网络，这段窗口里第二个执行者会读到"今天还没发" → 两条都发出去。
+// 真实撞车场景有两个：① 更新期间新旧 bridge 短暂共存；② 一次发送超过 60s，下一次 tick 叠上来。
+// 修法：`openSync(..., "wx")`（不存在才创建，内核保证原子）占位 —— 只有一个执行者拿得到。
+// ---------------------------------------------------------------------------
+
+/** 两个 runtime **共用同一个 relayDir**（模拟更新期间新旧 bridge 短暂共存）。 */
+async function twoRuntimesSameDir(ilink) {
+  const relayDir = tmp();
+  saveAccount(relayDir, { token: "tok-abc", accountId: "bot-1", baseUrl: ilink.baseUrl, userId: "user-1", boundAt: 1 });
+  const mk = () => {
+    const rt = createWeChatRuntime({
+      relayDir,
+      upstream: "http://127.0.0.1:1",
+      secret: SECRET,
+      tier: "pro",
+      logger: quietLogger()
+    });
+    rt.subscriber = makeFakeSubscriber();
+    rt.digestHour = new Date().getHours(); // 让真实路径通过时刻闸门
+    return rt;
+  };
+  return { rtA: mk(), rtB: mk(), relayDir };
+}
+
+test("★★ 两个实例共存时日报只能发一条(原子占位 —— 真机曾发两条)", async () => {
+  const ilink = await fakeIlink();
+  try {
+    const { rtA, rtB } = await twoRuntimesSameDir(ilink);
+    const before = ilink.state.sends.length;
+    // 并发触发：模拟两个实例在同一分钟内各自 tick（旧实现会两条都发）
+    await Promise.all([rtA.runMaybeDigestNow(), rtB.runMaybeDigestNow()]);
+    const sent = ilink.state.sends.length - before;
+    assert.equal(sent, 1, `★同一天只能有一条简报，实际发出 ${sent} 条（旧实现：两个执行者都读到"今天还没发"）`);
+  } finally {
+    await ilink.close();
+  }
+});
+
+test("★ 日报占位是陈旧的(>10 分钟)时必须接管,不能把那天彻底吞掉", async () => {
+  const ilink = await fakeIlink();
+  try {
+    const { rt, relayDir } = await boundRuntime(ilink, { subscriber: makeFakeSubscriber(), tier: "pro" });
+    rt.digestHour = new Date().getHours();
+    const day = `${new Date().getFullYear()}-${String(new Date().getMonth() + 1).padStart(2, "0")}-${String(new Date().getDate()).padStart(2, "0")}`;
+    const lock = path.join(relayDir, `.digest-${day}.sent`);
+    // 造一个 20 分钟前的占位(模拟"上个实例占位后、发送途中被杀")
+    fs.writeFileSync(lock, "");
+    const old = new Date(Date.now() - 20 * 60_000);
+    fs.utimesSync(lock, old, old);
+
+    const before = ilink.state.sends.length;
+    await rt.runMaybeDigestNow();
+    assert.equal(ilink.state.sends.length - before, 1,
+      "★陈旧占位必须被接管并补发 —— 否则进程一被杀,那天就再也不会发简报");
+  } finally {
+    await ilink.close();
+  }
+});
+
+test("★ 日报占位一天一个,换天时会清掉旧占位(不攒文件)", async () => {
+  const ilink = await fakeIlink();
+  try {
+    const { rt, relayDir } = await boundRuntime(ilink, { subscriber: makeFakeSubscriber(), tier: "pro" });
+    rt.digestHour = new Date().getHours();
+    // 放两个"昨天/前天"的占位
+    fs.writeFileSync(path.join(relayDir, ".digest-2020-01-01.sent"), "");
+    fs.writeFileSync(path.join(relayDir, ".digest-2020-01-02.sent"), "");
+    await rt.runMaybeDigestNow();
+    const left = fs.readdirSync(relayDir).filter((n) => n.startsWith(".digest-") && n.endsWith(".sent"));
+    assert.equal(left.length, 1, `旧占位必须被清掉,只剩今天的,实际:${left.join(", ")}`);
+  } finally {
+    await ilink.close();
+  }
+});

package/clients/dsh-remote/wechat-runtime.mjs

@@ -1679,25 +1679,93 @@ export class WeChatRuntime {
   /**
    * 每日简报(兼作 24h 推送窗口的心跳)。
    *
-   * ⚠️ 旧实现有两个问题,一起修了:
+   * ⚠️ 旧实现有三个问题,一起修了:
    *   ① 只把 `{notified, answered}` 交给下游,**没有 lines** → 用户每天收到的是兜底句
    *      「今天暂时没有要做的事。」—— 那不是"今天干了啥",等于白发(业主:"日报发的内容有点问题")。
    *   ② 先把 `last_digest_day` 落盘**再**发送 → 一旦这次没发出去(网络抖动/节点被权限关掉),
    *      当天的简报就被**烧掉**、当天再也不会补发。
+   *   ③ 「读 state → 发送 → 写 state」是一段**跨 await 的读-改-写**:发送要等网络,
+   *      这段窗口里第二个执行者会读到"今天还没发"→ **两条都发出去**
+   *      (2026-09-23 真机:业主收到两条简报)。现在用**原子占位**把"今天这条归我发"锁死。
    */
   async #maybeDigest() {
     if (this.stopping || !this.channel.account || !this.subscriber) return;
     const now = this.clock();
     const hour = new Date(now).getHours();
     if (hour !== this.digestHour) return;
+    const day = this.#today(now);
     const state = loadState(this.relayDir);
-    if (state.last_digest_day === this.#today(now)) return; // 今天已发
+    if (state.last_digest_day === day) return; // 今天已发
+    // ★ 先原子占位再发送:两个实例/两次 tick 并存时,只有一个能拿到(见 #claimDigest)
+    const claim = this.#claimDigest(day);
+    if (!claim.ok) return;
     const s = this.todayStats;
     const lines = this.#digestLines();
     const node = this.subscriber.digestDue({ lines, notified: s.notified, answered: s.answered });
-    const r = await this.notify(node);
+    let r = null;
+    try {
+      r = await this.notify(node);
+    } finally {
+      // 没真发出去 → 释放占位,留给下一 tick 补发(见上面 ②:不能把当天烧掉)
+      if (!(r && r.ok)) this.#releaseDigest(claim);
+    }
     // ★ 只有**真的发出去了**才记"今天已发"(见上面 ②)
-    if (r && r.ok) this.channel.writeState({ last_digest_day: this.#today(now) });
+    if (r && r.ok) this.channel.writeState({ last_digest_day: day });
+  }
+
+  /**
+   * 原子占位「今天这条简报由我来发」。
+   *
+   * 🔴 为什么光看 state 里的 `last_digest_day` 不够:那是**读-改-写**,中间隔着一次网络发送。
+   *    典型撞车场景有两个,都真实发生过:
+   *      · 更新期间新旧 bridge **短暂共存**(旧的还没退、新的已起);
+   *      · 一次发送耗时超过 60s,下一次定时器 tick **叠**上来。
+   *    两者都会让第二个执行者在写盘之前读到"今天还没发" → 用户收到两条。
+   *    `openSync(..., "wx")`(不存在才创建)由内核保证原子,只有一个执行者能拿到 ✅
+   *
+   * 生命期:发成功 → 占位**留着**(它比 state 更强,重启/换实例也不会丢);
+   *        发失败 → 立刻由 `#releaseDigest` 释放,让下一 tick 补发;
+   *        占位超过 10 分钟 = **陈旧**(进程在发送途中被杀)→ 接管它。
+   *        宁可极小概率重发一次,也不要出现"那天彻底不发了"。
+   */
+  #claimDigest(day) {
+    const file = path.join(this.relayDir, `.digest-${day}.sent`);
+    const STALE_MS = 10 * 60_000;
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+      try {
+        fs.closeSync(fs.openSync(file, "wx"));
+        this.#pruneDigestClaims(day);
+        return { ok: true, file };
+      } catch (e) {
+        if (!e || e.code !== "EEXIST") {
+          // 目录不可写等:退回"这次不发",绝不因此把 bridge 打挂(简报是锦上添花)
+          return { ok: false, file };
+        }
+        let age = 0;
+        try { age = Date.now() - fs.statSync(file).mtimeMs; } catch { age = 0; }
+        if (age < STALE_MS) return { ok: false, file }; // 别人正在发 / 今天已经发过
+        try { fs.rmSync(file, { force: true }); } catch { return { ok: false, file }; }
+        // 删掉陈旧占位后重抢一次
+      }
+    }
+    return { ok: false, file };
+  }
+
+  /** 发送失败时释放占位(交给下一 tick 补发)。 */
+  #releaseDigest(claim) {
+    if (!claim || !claim.file) return;
+    try { fs.rmSync(claim.file, { force: true }); } catch { /* ignore */ }
+  }
+
+  /** 清掉别的日期留下的占位文件(一天一个,不清理会一年攒 365 个)。 */
+  #pruneDigestClaims(today) {
+    try {
+      for (const name of fs.readdirSync(this.relayDir)) {
+        if (!name.startsWith(".digest-") || !name.endsWith(".sent")) continue;
+        if (name === `.digest-${today}.sent`) continue;
+        try { fs.rmSync(path.join(this.relayDir, name), { force: true }); } catch { /* ignore */ }
+      }
+    } catch { /* 目录读不了就算了:占位本身仍生效 */ }
   }
 
   /** 简报正文:回答"**今天**干了啥"(业主口径:日报是回顾,不是待办清单)。 */

package/dsh-setup.mjs

@@ -88,8 +88,13 @@ function findDepWs(startDir) {
   return null;
 }
 
-/** 同步运行时文件时一并覆盖的客户端脚本（bridge 会把这些直接发给手机/桌面，必须与装置器一致）。 */
-const RUNTIME_CLIENT_FILES = ["mobile-adapter.mjs", "dsh-bridge.mjs", "e2ee-shim.mjs", "e2ee-client.mjs", "e2ee-shim-script.js", "mobile-adapter.test.mjs", "wechat-channel.mjs", "dsh-events.mjs", "wechat-runtime.mjs"];
+/**
+ * 同步运行时文件时一并覆盖的客户端脚本（bridge 会把这些直接发给手机/桌面，必须与装置器一致）。
+ * ⚠️ `src/lifecycle.mjs` 也在表里：本安装器**自己**import 它（进程优雅停机的共用实现），
+ * 漏同步就会出现「入口脚本在、依赖不在」的半装运行时（插件半据此判定「运行环境已就绪」，
+ * 却永远起不来 bridge —— 2026-09-23 用户反馈的现场）。
+ */
+const RUNTIME_CLIENT_FILES = ["mobile-adapter.mjs", "dsh-bridge.mjs", "e2ee-shim.mjs", "e2ee-client.mjs", "e2ee-shim-script.js", "mobile-adapter.test.mjs", "wechat-channel.mjs", "dsh-events.mjs", "wechat-runtime.mjs", "src/lifecycle.mjs"];
 
 /**
  * 把"客户端脚本"补齐到配置目录。
@@ -769,7 +774,39 @@ function restartBridgeService() {
 }
 
 /**
- * dsh web 是否正在运行（127.0.0.1:3080）。
+ * 上游 dsh web 地址（bridge 的转发目标 + watcher 的「dsh web 在线吗」判据**同一个来源**）。
+ *
+ * 【2026-09-23 用户实测事故】这里原本处处写死 `http://127.0.0.1:3080`：只要用户的 dsh web
+ * 不在默认端口（`dsh web --port 8090`、profile 里配了 port、或 `--port 0` 让系统分配空闲端口），
+ * watcher 的在线探测就**永远**失败 → bridge 永远不启动，而面板只会说「正在启动 Bridge…」。
+ * 优先级：显式环境变量 > 插件半留下的端口文件 > DSH_WEB_URL > 默认 3080。
+ * 为什么要有「端口文件」这一层：开机自启（登录任务 / launchd）拉起 watcher 时**没有**任何环境变量，
+ * 只有插件半知道 dsh web 真实监听在哪个端口，所以它会把地址落盘（见插件 half 的 publishUpstream）。
+ */
+const UPSTREAM_FILE = ".dsh-upstream";
+function upstreamUrl() {
+  const explicit = String(process.env.DSH_BRIDGE_UPSTREAM || "").trim();
+  if (explicit) return explicit.replace(/\/+$/, "");
+  try {
+    const fromFile = String(fs.readFileSync(path.join(CONFIG_DIR, UPSTREAM_FILE), "utf8")).trim();
+    if (/^https?:\/\/[^\s]+$/i.test(fromFile)) return fromFile.replace(/\/+$/, "");
+  } catch { /* 没写过（旧版/首次）→ 往下回退 */ }
+  const web = String(process.env.DSH_WEB_URL || "").trim();
+  if (web) {
+    try {
+      const u = new URL(web);
+      if (u.port) return `http://127.0.0.1:${u.port}`; // bridge 的 loopback 围栏只认 127.0.0.1
+    } catch { /* 非 URL：忽略 */ }
+  }
+  return "http://127.0.0.1:3080";
+}
+/** 上游端口（诊断/日志用；取不到就回退 3080）。 */
+function upstreamPort() {
+  try { return Number(new URL(upstreamUrl()).port) || 3080; } catch { return 3080; }
+}
+
+/**
+ * dsh web 是否正在运行（默认 127.0.0.1:3080，端口以 upstreamUrl() 为准）。
  * bridge 本身依赖 dsh web 才工作：dsh web 没开时 bridge 起来也会立刻退出，
  * 所以「装完当下 bridge 没在跑」是**正常状态**，不能当失败吓用户（见 install 汇总）。
  */
@@ -777,7 +814,7 @@ async function isDshWebUp(timeoutMs = 1200) {
   try {
     const ac = new AbortController();
     const timer = setTimeout(() => ac.abort(), timeoutMs);
-    await fetch("http://127.0.0.1:3080/", { signal: ac.signal });
+    await fetch(upstreamUrl() + "/", { signal: ac.signal });
     clearTimeout(timer);
     return true;
   } catch { return false; }
@@ -794,13 +831,14 @@ function resolveProfileDir(argv = []) {
 }
 
 /**
- * 监听 127.0.0.1:3080 的进程 pid（= dsh web）。
+ * 监听本机 dsh web 端口的进程 pid（= dsh web）。端口取 upstreamPort()（不再写死 3080）。
  * macOS/Linux：lsof → pgrep；Windows：netstat -ano 取 LISTENING 行的最后一列
  * （netstat 是系统自带，比每次都起 PowerShell 快得多）。
  */
 function dshWebPid() {
+  const port = upstreamPort();
   if (IS_WIN) {
-    const r = sh('netstat -ano | findstr ":3080"');
+    const r = sh(`netstat -ano | findstr ":${port}"`);
     for (const line of String(r.stdout || "").split("\n")) {
       if (!/LISTENING/i.test(line)) continue;
       const m = line.trim().match(/(\d+)\s*$/);
@@ -808,7 +846,7 @@ function dshWebPid() {
     }
     return null;
   }
-  const l = sh("lsof -nP -iTCP:3080 -sTCP:LISTEN -t 2>/dev/null || true");
+  const l = sh(`lsof -nP -iTCP:${port} -sTCP:LISTEN -t 2>/dev/null || true`);
   const pid = String(l.stdout || "").trim().split(/\s+/).filter(Boolean)[0];
   if (pid && /^\d+$/.test(pid)) return Number(pid);
   const p = sh("pgrep -f 'dsh web' 2>/dev/null | head -1");
@@ -884,7 +922,7 @@ function restartDshWeb() {
  */
 function restartDshWebWindows() {
   const pid = dshWebPid();
-  if (!pid) return { ok: false, how: "", detail: "未找到监听 3080 的进程（dsh web 没在运行？）" };
+  if (!pid) return { ok: false, how: "", detail: `未找到监听 ${upstreamPort()} 的进程（dsh web 没在运行？）` };
   const cmdline = windowsProcessCommandLine(pid);
   if (!cmdline) return { ok: false, how: "", detail: "无法获取 dsh web 的启动命令行，请手动重启" };
   if (/_npx|node_modules\\\.bin|node_modules\/\.bin/.test(cmdline)) {
@@ -1087,15 +1125,15 @@ async function runBridge() {
   /** 限流提示只打一次，避免刷屏。 */
   let warnedRateLimit = false;
 
-  // watcher：检测 dsh web（127.0.0.1:3080）存活，存活才启动 bridge
+  // watcher：检测 dsh web 是否存活（端口以 upstreamUrl() 为准，绝不写死 3080），存活才启动 bridge
   const checkUpstream = () => new Promise((resolve) => {
     const t = setTimeout(() => resolve(false), 2000);
-    fetch("http://127.0.0.1:3080/")
+    fetch(upstreamUrl() + "/")
       .then(() => { clearTimeout(t); resolve(true); })
       .catch(() => { clearTimeout(t); resolve(false); });
   });
 
-  console.log("[dsh-remote] 等待 dsh web（127.0.0.1:3080）启动...");
+  console.log(`[dsh-remote] 等待 dsh web（${upstreamUrl()}）启动...`);
   let bridgeProc = null;
   let starting = false;
 
@@ -1158,6 +1196,8 @@ async function runBridge() {
         ...process.env,
         DSH_BRIDGE_CONFIG: CONFIG_PATH,
         DSH_BRIDGE_TUNNEL_URL: cfg.tunnel_url,
+        // 上游端口显式传给 bridge：它自己在旧版本里也回退到写死的 3080（见 dsh-bridge.mjs 的 UPSTREAM）。
+        DSH_BRIDGE_UPSTREAM: upstreamUrl(),
         // 安装口径透传给 bridge（bridge 把它随设备登记请求一起上报给账号 API）
         DSH_BRIDGE_INSTALL_SOURCE: INSTALL_SOURCE,
         DSH_BRIDGE_INSTALL_VERSION: INSTALL_VERSION,
@@ -1335,7 +1375,7 @@ async function setup(argv) {
         fs.writeFileSync(patchPath, cur);
       } catch { /* 忽略：轮询会给出结论 */ }
       for (let i = 0; i < 45; i += 1) {
-        const r = await fetch("http://127.0.0.1:3080/dsh-remote/self", { signal: AbortSignal.timeout(900) })
+        const r = await fetch(upstreamUrl() + "/dsh-remote/self", { signal: AbortSignal.timeout(900) })
           .catch(() => null);
         if (r && r.ok) {
           const j = await r.json().catch(() => null);
@@ -1448,7 +1488,7 @@ async function setup(argv) {
     L.push("          再打开 设置 → 「远程访问」→ 注册/登录手机号即可。");
   } else if (needRestart && restartResult && restartResult.ok) {
     L.push("");
-    L.push("   下一步: dsh web 已重启，直接打开 http://127.0.0.1:3080 → 设置 → 「远程访问」→ 注册/登录手机号。");
+    L.push("   下一步: dsh web 已重启，直接打开 " + upstreamUrl() + " → 设置 → 「远程访问」→ 注册/登录手机号。");
   } else if (needRestart && pluginResult && pluginResult.hotPatch && pluginResult.changed) {
     // patch 已写入但探测窗口内没等到面板接口:热加载很可能还在进行(插件节点半启动+注册路由)。
     // 这种情况**不能**直接让用户重启 —— 先让他等几秒刷新,再给兜底方案。
@@ -1466,8 +1506,8 @@ async function setup(argv) {
     L.push("⚠️ 还需要重启一次 dsh web，插件面板才会出现（插件只在进程启动时装载）。");
     L.push("   请手动执行（任选其一）：");
     L.push("     launchctl kickstart -k gui/$(id -u)/com.dshweb.dev     # 用 launchd 托管时");
-    L.push("     kill $(lsof -ti tcp:3080 -sTCP:LISTEN) && dsh web --no-open   # 手动启动时");
-    L.push("   重启后：打开 http://127.0.0.1:3080 → 设置 → 「远程访问」→ 注册/登录手机号。");
+    L.push(`     kill $(lsof -ti tcp:${upstreamPort()} -sTCP:LISTEN) && dsh web --no-open   # 手动启动时`);
+    L.push(`   重启后：打开 ${upstreamUrl()} → 设置 → 「远程访问」→ 注册/登录手机号。`);
   } else {
     L.push("");
     L.push("   下一步: 打开 dsh web → 设置 → 「远程访问」→ 注册/登录手机号即可（无需任何命令）。");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrisega/dsh-remote",
-  "version": "0.6.10",
+  "version": "0.6.12",
   "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",
@@ -52,8 +52,8 @@
   "scripts": {
     "test": "npm run test:router && npm run test:plugin && npm run test:bridge",
     "test:router": "NODE_OPTIONS=\"--require $PWD/scripts/test-net-guard.cjs ${NODE_OPTIONS:-}\" node --test packages/relay-router/test/native-device-selection.test.mjs packages/relay-router/test/native-app-entry.test.mjs packages/relay-router/test/presence-report.test.mjs packages/relay-router/test/logger.test.mjs",
-    "_comment:test:plugin": "DSH_RELAY_SKIP_SERVICE=1 = 测试隔离：插件加载时不做真实系统操作（npx 补装 / launchctl / 重启 harness）；需要真实分支的用例自行 unset（见 account-switch / runtime-provision / harness-restart 用例注释）。DSH_RELAY_DEFAULT_API= 死端口：用例拆掉临时目录后，仍在飞的后台请求（装机上报重试等）会读到空配置并回落「默认云端地址」—— 指到本地死端口才不会打生产。",
-    "test:plugin": "DSH_REMOTE_TELEMETRY=0 DSH_RELAY_SKIP_SERVICE=1 DSH_RELAY_DEFAULT_API=http://127.0.0.1:1 NODE_OPTIONS=\"--require $PWD/scripts/test-net-guard.cjs ${NODE_OPTIONS:-}\" node --test --test-concurrency=1 packages/dsh-remote-web/test/*.test.mjs",
+    "_comment:test:plugin": "DSH_RELAY_BUNDLED_RUNTIME=/nonexistent = 强制走 npx 兜底分支（否则本机跑过 npm pack 后 packages/dsh-remote-web/runtime 存在，用例会改成走本地拷贝）。DSH_RELAY_SKIP_SERVICE=1 = 测试隔离：插件加载时不做真实系统操作（npx 补装 / launchctl / 重启 harness）；需要真实分支的用例自行 unset（见 account-switch / runtime-provision / harness-restart 用例注释）。DSH_RELAY_DEFAULT_API= 死端口：用例拆掉临时目录后，仍在飞的后台请求（装机上报重试等）会读到空配置并回落「默认云端地址」—— 指到本地死端口才不会打生产。",
+    "test:plugin": "DSH_REMOTE_TELEMETRY=0 DSH_RELAY_SKIP_SERVICE=1 DSH_RELAY_DEFAULT_API=http://127.0.0.1:1 DSH_RELAY_BUNDLED_RUNTIME=/nonexistent-dsh-bundled NODE_OPTIONS=\"--require $PWD/scripts/test-net-guard.cjs ${NODE_OPTIONS:-}\" node --test --test-concurrency=1 packages/dsh-remote-web/test/*.test.mjs",
     "_comment:test:bridge": "⚠️ 必须 --test-concurrency=1（与 test:plugin 对齐）：tunnel-auth 有一条「bridge 5 秒内必须重连」的硬期限，并行跑时新增用例抢 CPU 会把它撞破 → 偶发假红（实测单独跑 2/2 通过、并发跑偶发 0/2）。假红比慢更贵。",
     "test:bridge": "DSH_RELAY_DEFAULT_API=http://127.0.0.1:1 NODE_OPTIONS=\"--require $PWD/scripts/test-net-guard.cjs ${NODE_OPTIONS:-}\" node --test --test-concurrency=1 clients/dsh-remote/test/*.test.mjs",
     "check": "node --check scripts/check-profile-activation.mjs && node --check clients/dsh-remote/dsh-bridge.mjs && node --check clients/dsh-remote/wechat-channel.mjs && node --check clients/dsh-remote/wechat-runtime.mjs && node --check clients/dsh-remote/dsh-events.mjs && node --check clients/dsh-remote/e2ee-shim.mjs && node --check dsh-setup.mjs && node --check packages/dsh-remote-web/lib/index.js && node --check packages/dsh-remote-web/lib/client.js && node --check packages/relay-router/src/index.mjs && node --check packages/relay-router/src/logger.mjs && bash -n deploy/install-open.sh && grep -q 'command -v setsid' deploy/install-open.sh && grep -q 'command -v ss' deploy/install-open.sh",

package/packages/dsh-remote-web/lib/client.js

@@ -2103,6 +2103,16 @@ window.__ModuleLoader__.load({
       var mktFoldArr = useState(mktMoreWasFolded() || inviteTipWasDismissed()); var mktFolded = mktFoldArr[0]; var setMktFolded = mktFoldArr[1];
       // 「更多」这一层当前是否展开：纯界面态，不持久化（下次进面板回到收起，主界面保持干净）。
       var moreOpenArr = useState(false); var moreOpen = moreOpenArr[0]; var setMoreOpen = moreOpenArr[1];
+      // 🧾 故障上报 / 修复提示词（0.6.12）：全部 hook 追加在末尾，不动既有 hook 序号。
+      //   diagView: null=不展开 | "report"=上报（预览+确认） | "fix"=让 DSH 自己修（提示词+回传）
+      var diagViewArr = useState(null); var diagView = diagViewArr[0]; var setDiagView = diagViewArr[1];
+      var diagBundleArr = useState(null); var diagBundle = diagBundleArr[0]; var setDiagBundle = diagBundleArr[1];
+      var diagNoteArr = useState(""); var diagNote = diagNoteArr[0]; var setDiagNote = diagNoteArr[1];
+      var diagAttachArr = useState(true); var diagAttachLogs = diagAttachArr[0]; var setDiagAttachLogs = diagAttachArr[1];
+      var diagBusyArr = useState(""); var diagBusy = diagBusyArr[0]; var setDiagBusy = diagBusyArr[1];
+      var diagMsgArr = useState(null); var diagMsg = diagMsgArr[0]; var setDiagMsg = diagMsgArr[1];
+      var fixPromptArr = useState(null); var fixPrompt = fixPromptArr[0]; var setFixPrompt = fixPromptArr[1];
+      var fixReportArr = useState(""); var fixReport = fixReportArr[0]; var setFixReport = fixReportArr[1];
 
       var refresh = useCallback(function () {
         setBusy("status");
@@ -2589,6 +2599,67 @@ window.__ModuleLoader__.load({
         });
       };
 
+      // ── 🧾 故障上报（用户主动、可预览、可编辑）与「让 DeepSeek 帮我修」（0.6.12） ──
+      // 产品原则（2026-09-23 定的）：**绝不**后台自动上传日志。开发者要看得见故障现场，
+      // 但必须由用户自己点、并且能看见"将要发出去的每一个字"。于是：
+      //   ① 上报道：预览全文（正文+日志分片）→ 用户可写描述、可取消附带日志 → 确认才发；
+      //   ② 修复道：给用户一段提示词，让他本机的 DSH 自己修并产出结论报告，再把报告回传。
+      // 这两条把"客服来回问"变成"一次到位"，而且不需要我们发版。
+
+      /** 打开「上报故障」：先拉预览（= 确认后真正会发出去的全文）。 */
+      var openDiagReport = function () {
+        setDiagView("report"); setDiagMsg(null); setDiagBundle(null);
+        setDiagBusy("bundle");
+        api("/dsh-remote/diag/bundle").then(function (b) {
+          if (b && b.ok) setDiagBundle(b);
+          else setDiagMsg({ kind: "err", text: "读取诊断信息失败，请稍后重试。" });
+        }).catch(function (e) {
+          setDiagMsg({ kind: "err", text: "读取诊断信息失败：" + e.message });
+        }).finally(function () { setDiagBusy(""); });
+      };
+
+      /** 提交上报：正文（含用户描述）+ 日志分片，全部走既有反馈通道。 */
+      var submitDiagReport = function (extra) {
+        var body = {
+          note: extra && extra.note !== undefined ? extra.note : diagNote,
+          attachLogs: diagAttachLogs,
+          report: (extra && extra.report) || "",
+        };
+        setDiagBusy("report"); setDiagMsg(null);
+        post("/dsh-remote/diag/report", body).then(function (b) {
+          if (b && b.ok) {
+            var warn = (b.warnings && b.warnings.length) ? "（" + b.warnings.join("；") + "）" : "";
+            setDiagMsg({ kind: "ok", text: "✅ 已上报给开发者（编号 " + (b.id || "?") + "）" + warn + "。可在「用户反馈 → 我的反馈」里看到后续回复。" });
+            setFixReport(""); setDiagNote("");
+          } else {
+            setDiagMsg({ kind: "err", text: (b && b.error) || "上报失败，请稍后重试。" });
+          }
+        }).catch(function (e) {
+          setDiagMsg({ kind: "err", text: "上报失败：" + e.message });
+        }).finally(function () { setDiagBusy(""); });
+      };
+
+      /** 打开「让 DeepSeek 帮我修」：拉提示词（含当前故障上下文）。 */
+      var openFixPrompt = function () {
+        setDiagView("fix"); setDiagMsg(null); setFixPrompt(null);
+        setDiagBusy("prompt");
+        api("/dsh-remote/diag/fix-prompt").then(function (b) {
+          if (b && b.ok && b.prompt) setFixPrompt(b);
+          else setDiagMsg({ kind: "err", text: "读取修复提示词失败，请稍后重试。" });
+        }).catch(function (e) {
+          setDiagMsg({ kind: "err", text: "读取修复提示词失败：" + e.message });
+        }).finally(function () { setDiagBusy(""); });
+      };
+
+      var copyFixPrompt = function () {
+        var text = (fixPrompt && fixPrompt.prompt) || "";
+        if (!text) return;
+        copyText(text).then(function (done) {
+          if (done) setDiagMsg({ kind: "ok", text: "✅ 提示词已复制。粘到 DeepSeek Harness 里发送，它会自己检查并修复；跑完把它的结论报告贴回下面。" });
+          else setDiagMsg({ kind: "warn", text: "复制失败（浏览器可能限制了剪贴板）：可手动选中下面的文本复制。" });
+        });
+      };
+
       function setMsg(kind, text) { setMessage({ kind: kind, text: text }); }
 
       // ---------- 登录(密码/短信) ----------
@@ -3652,6 +3723,68 @@ window.__ModuleLoader__.load({
          * 面向非技术用户——非 online 阶段一律说明「正在自动进行，无需操作」；
          * 只有失败（error）才给可操作项：重试 / 复制诊断信息 / 日志路径，绝不出现死胡同。
          */
+        /**
+         * 🧾 故障上报 / 让 DeepSeek 帮我修（0.6.12）
+         * 产品原则：绝不后台自动上传日志 —— 这里全部由用户主动触发，且**先把要发的内容摊开给他看**。
+         */
+        function renderDiagTools() {
+          var rows = [];
+          if (diagMsg) {
+            rows.push(h("div", { className: "dru-msg" + (diagMsg.kind ? " dru-msg-" + diagMsg.kind : ""), style: { marginTop: 6 } }, diagMsg.text));
+          }
+          if (diagView === null) {
+            rows.push(h("div", { className: "dru-actions", style: { marginTop: 8 } },
+              h("button", { type: "button", className: "dru-btn dru-btn-ghost", disabled: busy !== "" || diagBusy !== "", onClick: openDiagReport },
+                diagBusy === "bundle" ? "准备中…" : "🧾 上报故障给开发者"),
+              h("button", { type: "button", className: "dru-btn dru-btn-ghost", disabled: busy !== "" || diagBusy !== "", onClick: openFixPrompt },
+                diagBusy === "prompt" ? "准备中…" : "🛠 让 DeepSeek 帮我修")));
+            rows.push(h("div", { className: "dru-hint", style: { marginTop: 4 } },
+              "「上报」会先让你看到将要发送的全部内容（可写描述、可取消附带日志），你确认后才发给我们；"
+              + "「帮我修」会给你一段提示词，让电脑上的 DeepSeek Harness 自己排查并修复。"));
+            return h("div", null, rows);
+          }
+          if (diagView === "report") {
+            var preview = diagBundle ? (diagBundle.summary + (diagBundle.parts && diagBundle.parts.length ? "\n\n" + diagBundle.parts.join("\n\n") : "")) : "";
+            rows.push(h("div", { className: "dru-hint", style: { marginTop: 6 } },
+              "下面就是**将要发送**的全部内容（可先改成你愿意分享的样子；手机号与密钥已自动隐去）："));
+            rows.push(h("pre", {
+              style: { margin: "6px 0 0", padding: "8px 10px", maxHeight: 220, overflow: "auto", whiteSpace: "pre-wrap", wordBreak: "break-all", fontSize: 12, lineHeight: 1.5, background: "var(--dru-surface-2)", border: "1px solid var(--dru-border-ctl)", borderRadius: 8 },
+            }, diagBusy === "bundle" ? "正在准备…" : (preview || "（暂无内容）")));
+            rows.push(h("textarea", {
+              className: "dru-fb-textarea", style: { marginTop: 6 }, maxLength: 600, value: diagNote,
+              placeholder: "用一句话说说你遇到的问题（可选，但很有帮助）",
+              onChange: function (e) { setDiagNote(e.target.value); },
+            }));
+            rows.push(h("label", { className: "dru-hint", style: { display: "block", marginTop: 6, cursor: "pointer" } },
+              h("input", { type: "checkbox", checked: diagAttachLogs, onChange: function (e) { setDiagAttachLogs(e.target.checked); } }),
+              " 附带两个日志的末尾（不含手机号/密码/令牌）"));
+            rows.push(h("div", { className: "dru-actions", style: { marginTop: 8 } },
+              h("button", { type: "button", className: "dru-btn dru-btn-primary", disabled: diagBusy !== "" || !diagBundle, onClick: function () { submitDiagReport(); } },
+                diagBusy === "report" ? "上报中…" : "确认上报"),
+              h("button", { type: "button", className: "dru-btn dru-btn-ghost", disabled: diagBusy !== "", onClick: function () { setDiagView(null); setDiagMsg(null); } }, "取消")));
+            return h("div", null, rows);
+          }
+          // fix：复制提示词 → 本机 DSH 自己修 → 把结论报告贴回来（可选回传给我们）
+          var promptText = (fixPrompt && fixPrompt.prompt) || "";
+          rows.push(h("div", { className: "dru-hint", style: { marginTop: 6 } },
+            "① 复制下面的提示词；② 粘到电脑上的 DeepSeek Harness 里发送，它会自己检查并修复；③ 把它给出的结论报告贴回下面，回传给我们（可选）。"));
+          rows.push(h("pre", {
+            style: { margin: "6px 0 0", padding: "8px 10px", maxHeight: 200, overflow: "auto", whiteSpace: "pre-wrap", wordBreak: "break-word", fontSize: 12, lineHeight: 1.5, background: "var(--dru-surface-2)", border: "1px solid var(--dru-border-ctl)", borderRadius: 8 },
+          }, diagBusy === "prompt" ? "正在准备…" : (promptText || "（暂无内容）")));
+          rows.push(h("div", { className: "dru-actions", style: { marginTop: 6 } },
+            h("button", { type: "button", className: "dru-btn dru-btn-ghost", disabled: !promptText, onClick: copyFixPrompt }, "📋 复制提示词")));
+          rows.push(h("textarea", {
+            className: "dru-fb-textarea", style: { marginTop: 6 }, maxLength: 20000, value: fixReport,
+            placeholder: "把 DeepSeek Harness 给出的「结论报告」整段贴到这里，我们一起看",
+            onChange: function (e) { setFixReport(e.target.value); },
+          }));
+          rows.push(h("div", { className: "dru-actions", style: { marginTop: 8 } },
+            h("button", { type: "button", className: "dru-btn dru-btn-primary", disabled: diagBusy !== "" || !fixReport.trim(), onClick: function () { submitDiagReport({ report: fixReport, note: diagNote || "（来自「让 DeepSeek 帮我修」的回传报告）" }); } },
+              diagBusy === "report" ? "回传中…" : "回传结论报告"),
+            h("button", { type: "button", className: "dru-btn dru-btn-ghost", disabled: diagBusy !== "", onClick: function () { setDiagView(null); setDiagMsg(null); } }, "取消")));
+          return h("div", null, rows);
+        }
+
         function renderConnectBlock() {
           if (!loggedInSaaS || !connInfo) return null;
           var phase = connInfo.phase || "";
@@ -3675,6 +3808,8 @@ window.__ModuleLoader__.load({
               h("button", { type: "button", className: "dru-btn dru-btn-ghost", onClick: copyDiagnostics }, copiedDiag ? "已复制" : "复制诊断信息")));
             rows.push(h("div", { className: "dru-hint", style: { marginTop: 6 } },
               "查看日志：后台服务 " + (connInfo.logPath || "") + " ，安装 " + (connInfo.installLogPath || "") + "（把「复制诊断信息」的内容发给客服可加速定位）"));
+            var diagToolsErr = renderDiagTools();
+            if (diagToolsErr) rows.push(h("div", { style: { marginTop: 8, borderTop: "1px dashed var(--dru-border-ctl)", paddingTop: 8 } }, diagToolsErr));
             return h("div", null, rows);
           }
           // 非错误阶段：只解释「正在自动做什么」，并说明不需要任何操作
@@ -3697,6 +3832,8 @@ window.__ModuleLoader__.load({
           rows.push(h("div", { className: "dru-actions", style: { marginTop: 8 } },
             h("button", { type: "button", className: "dru-btn dru-btn-ghost", disabled: busy !== "", onClick: retryConnect }, busy === "connect-retry" ? "立即重试中…" : "立即重试"),
             h("button", { type: "button", className: "dru-btn dru-btn-ghost", onClick: copyDiagnostics }, copiedDiag ? "已复制" : "复制诊断信息")));
+          var diagTools = renderDiagTools();
+          if (diagTools) rows.push(h("div", { style: { marginTop: 8, borderTop: "1px dashed var(--dru-border-ctl)", paddingTop: 8 } }, diagTools));
           return h("div", null, rows);
         }
         // Phase-5:端到端加密(E2EE)状态行 —— 未登录/旧 host 未下发 e2ee 一律不渲染