@mrrisega/dsh-remote 0.7.0-beta.3 → 0.7.0-beta.5

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

@@ -1028,6 +1028,74 @@ const SCRIPT = `(() => {
    窄屏还会自动收起左栏（viewportWidth < 1024 → narrowExpanded = false）。
    我们插一脚只会把官方推到相反方向（这正是「点开变黑遮罩」那条链的起点）。 */
     let fabDone = false;
+
+    /* ===== 📶 网络延迟采样器（2026-10-10 二修，与"某一代菜单 DOM"彻底解耦）=================
+       一修（0.7.0-beta.3）改掉了"亚毫秒样本被丢弃"，但业主实测**仍然一直「测速中」**，
+       而同一时段镜像页打了 69 次 /api/agentPresets/list 这类**完全合格**的请求 ——
+       说明真根因不是样本被过滤，而是**采样根本没接上**（或渲染写进了已被替换的旧节点）。
+
+       所以这次不再依赖"建菜单时顺手包装一次 fetch"：
+         · 安装独立成 maInstallNetSampler()，幂等、**自愈**（发现 window.fetch 上不是我们的采样器
+           就重新包一层）—— 谁在这之后把 fetch 换掉（我们自己注入的 E2EE shim 会在解锁时再包一次）
+           都能兜住；
+         · 样本挂 window（跨"菜单被 SPA 重建"共享）；
+         · 渲染**每次现查实时 DOM**，不再抱着建菜单时的旧引用（旧引用可能已脱离文档，
+           于是样本明明在涨、界面却永远停在初始文案）；
+         · 空态**直接说明原因**，下次再出问题不用猜：一眼看出是"没接上"还是"接上了但没请求"。 */
+    const maNetPatch = { ok: false, samples: 0, lastUrl: "", lastAt: 0 };
+    try { window.__dshMaNet = maNetPatch; } catch (eNet0) { /* 忽略 */ }
+    /** 当前这一代菜单注册的渲染器（可能为 null：菜单还没建）。 */
+    let maNetRender = null;
+    const maNoteRtt = (ms, url) => {
+      try {
+        if (typeof ms !== "number" || !isFinite(ms)) return;
+        const r = Math.round(ms);
+        // 只拒绝负数与超时；0（本机/回环的真实往返不足 1ms）照收，展示层再夹到 ≥1ms。
+        if (r < 0 || r > 20000) return;
+        const bag = (window.__dshMaRttSamples || (window.__dshMaRttSamples = []));
+        bag.push(r);
+        while (bag.length > 8) bag.shift();
+        maNetPatch.samples = bag.length;
+        maNetPatch.lastUrl = String(url || "").slice(0, 80);
+        maNetPatch.lastAt = Date.now();
+        if (maNetRender) { try { maNetRender(); } catch (eR) { /* 忽略 */ } }
+      } catch (eN) { /* 忽略 */ }
+    };
+    /** 把采样器挂到 window.fetch 上（**只挂一次**）。返回是否已就绪。 */
+    const maInstallNetSampler = () => {
+      try {
+        if (typeof window.fetch !== "function") return false;
+        /* ⚠️ 幂等判据必须是**稳定标志**，不能拿 window.fetch.__dshMaNetSampler 当判据（2026-10-10 自测抓到）：
+           "会话过期探测"那层包装会在本采样器**外面**再包一层（它建菜单时才装，晚于这里），
+           于是最外层 window.fetch 上没有我们的标记 → 若用函数标记当判据，每一拍都会再包一层，
+           秒级泄漏（请求穿过 N 层、同一趟被记 N 个样本）。 */
+        if (maNetPatch.installed === true) { maNetPatch.ok = true; return true; }
+        const orig = window.fetch;
+        const wrapped = function (input, init) {
+          let url = "";
+          try { url = typeof input === "string" ? input : (input && input.url) || ""; } catch (eU) { url = ""; }
+          const t0 = maNowMs();
+          const p = orig.apply(this, arguments);
+          try {
+            const abs = url.slice(0, 8).toLowerCase();
+            const absolute = abs.indexOf("http://") === 0 || abs.indexOf("https://") === 0;
+            const sameOrigin = !absolute || url.indexOf(window.location.origin) === 0;
+            const apiish = url.indexOf("/api/") >= 0 || url.indexOf("/remote/") >= 0
+              || url.indexOf("_devices") >= 0 || url.indexOf("_quota") >= 0;
+            if (sameOrigin && apiish && p && typeof p.then === "function") {
+              p.then(() => { maNoteRtt(maNowMs() - t0, url); }, () => { /* 网络错误不算延迟 */ });
+            }
+          } catch (eW) { /* 忽略 */ }
+          return p;
+        };
+        wrapped.__dshMaNetSampler = true;   // 只作记号便于人造排查（**不作**幂等判据）
+        maNetPatch.installed = true;        // 稳定幂等判据
+        window.fetch = wrapped;
+        maNetPatch.ok = true;
+        return true;
+      } catch (eI) { return false; }
+    };
+
     const buildRemoteMenu = () => {
       /* ===== 统一「远程控制」悬浮按钮：字号 + 加密状态 + 返回设备列表 =====
          2026-09-19 用户要求原话：「把字体的菜单和加密小锁的菜单合并成一个小悬浮按钮；点击后可以弹菜单
@@ -1244,14 +1312,11 @@ const SCRIPT = `(() => {
          旧的 120/300 分档是照"网页首屏"的体感定的，会把大量正常可用的移动网络误报成"较慢"，
          反而让用户以为哪里坏了。 */
       const RTT_KEEP = 8, RTT_MAX_MS = 20000;
-      /* 🔴 样本数组挂在 window 上，**不在 buildRemoteMenu 的闭包里**（2026-10-09 加固）。
-         为什么：fetch 包装只装一次（window.__dshMaSessionWatch 一次性闸门），而菜单/悬浮按钮
-         在官方 SPA 重渲染时可能被**重建**。若样本数组长在 buildRemoteMenu 里，包装就会一直喂给
-         "上一代"渲染器（那个节点已经不在文档里），新界面读自己的空数组 → **永远停在「测速中…」**。
-         挂在 window 上则任何一代渲染器都读同一份样本。 */
-      const rttSamples = (window.__dshMaRttSamples || (window.__dshMaRttSamples = []));
+      /* 建菜单时的引用只作**兜底**：正常路径每次渲染都现查实时 DOM（见 liveNetEl/liveRttEl）。 */
       const rttEl = fab.querySelector('[data-role="rtt"]');
       const netEl = menu.querySelector('[data-role="net"]');
+      /* 样本一律读 window 上那一份（由上面的 maNoteRtt 写入，跨"菜单被重建"共享）。 */
+      const rttSamples = (window.__dshMaRttSamples || (window.__dshMaRttSamples = []));
       const rttValue = () => {
         if (!rttSamples.length) return null;
         const s = rttSamples.slice().sort((a, b) => a - b);
@@ -1263,44 +1328,45 @@ const SCRIPT = `(() => {
       const rttGrade = (ms) => (ms <= 500 ? "ok" : ms <= 1000 ? "mid" : ms <= 2000 ? "slow" : "bad");
       const rttLabel = (g) => (g === "ok" ? "顺畅" : g === "mid" ? "正常" : g === "slow" ? "偏慢" : "很慢");
       const FAB_TITLE_BASE = "远程控制：字号 / 网络延迟 / 加密状态 / 返回设备列表（可拖动移动位置）";
+      /* 🔴 每次渲染都**现查实时 DOM**（2026-10-10 二修）。
+         抱着建菜单时的旧引用是"样本在涨、界面却永远停在初始文案"的经典成因：官方 SPA 换掉 body
+         子树后旧引用脱离文档，更新写进了看不见的节点。现查则永远写用户真正看得见的那一个；
+         查不到才退回旧引用（宽屏/菜单未开时本来就没有可写的节点）。 */
+      const liveNetEl = () => { try { return document.querySelector(".dsh-ma-menu-net") || netEl; } catch (eQ) { return netEl; } };
+      const liveRttEl = () => { try { return fab.querySelector('[data-role="rtt"]') || rttEl; } catch (eQ2) { return rttEl; } };
       const renderRtt = () => {
         try {
           const ms = rttValue();
           const g = ms === null ? "" : rttGrade(ms);
           // 0ms 是句谎话（不足 1ms 的真实往返会被四舍五入成 0）→ 展示层夹到 ≥1ms。
           const shown = ms === null ? null : Math.max(1, Math.round(ms));
-          if (rttEl) {
-            if (shown === null) { rttEl.hidden = true; rttEl.textContent = ""; rttEl.removeAttribute("data-rtt"); }
+          const rEl = liveRttEl();
+          if (rEl) {
+            if (shown === null) { rEl.hidden = true; rEl.textContent = ""; rEl.removeAttribute("data-rtt"); }
             else {
-              rttEl.hidden = false;
-              rttEl.textContent = shown + "ms";
-              rttEl.setAttribute("data-rtt", g);
+              rEl.hidden = false;
+              rEl.textContent = shown + "ms";
+              rEl.setAttribute("data-rtt", g);
             }
           }
-          if (netEl) {
-            netEl.setAttribute("data-rtt", g || "");
-            const ico = netEl.querySelector(".ico");
-            const txt = netEl.querySelector(".txt");
+          const nEl = liveNetEl();
+          if (nEl) {
+            nEl.setAttribute("data-rtt", g || "");
+            const ico = nEl.querySelector(".ico");
+            const txt = nEl.querySelector(".txt");
             if (ico) ico.textContent = shown === null ? "📶" : (g === "bad" ? "📵" : "📶");
-            if (txt) txt.textContent = shown === null ? "测速中…（等一次网络请求后显示）" : (shown + " ms · " + rttLabel(g));
+            if (txt) {
+              /* 空态**说清原因**（2026-10-10）：以前只有一句「等一次网络请求后显示」，
+                 于是"采样器压根没接上"和"接上了但还没有请求"长得一模一样，业主两次反馈
+                 我们都只能猜。现在一眼可分。 */
+              txt.textContent = shown !== null ? (shown + " ms · " + rttLabel(g))
+                : (maNetPatch.ok ? "测速中…（已接上，等一次请求）" : "测速中…（采样器未接上）");
+            }
           }
           try { fab.title = shown === null ? FAB_TITLE_BASE : ("远程控制：网络延迟 " + shown + "ms（" + rttLabel(g) + "） / 字号 / 加密状态 / 返回设备列表（可拖动）"); } catch (e) { /* 忽略 */ }
         } catch (e) { /* 延迟显示失败绝不影响主功能 */ }
       };
-      /** 记一个成功样本（由 fetch 包装在**响应到达**时调用；失败/超时不调用）。 */
-      const noteRtt = (ms) => {
-        if (typeof ms !== "number" || !isFinite(ms)) return;
-        const r = Math.round(ms);
-        /* 🔴 旧写法是 if (r < 1 || ...) return; ，注释说"亚毫秒=同帧缓存命中"。这个假设是**错的**：
-           本机/回环访问（桌面端自测、在同一台机器上打开镜像页）一次真实往返往往就是 < 1ms，
-           于是**每一个**样本都被丢掉，界面永远停在「测速中…（等一次网络请求后显示）」——
-           业主 2026-10-09 实测反馈的正是这个现象。只拒绝负数与超时；0 → 展示层夹到 1ms。
-           （面板侧 chip 从一开始就是 v <= 0 + Math.max(1, round)，两边口径由此对齐。） */
-        if (r < 0 || r > RTT_MAX_MS) return;
-        rttSamples.push(r);
-        while (rttSamples.length > RTT_KEEP) rttSamples.shift();
-        renderRtt();
-      };
+      maNetRender = renderRtt;   // 注册给采样器（样品到达时回调它）
       renderRtt();
 
       /* ❌ 这里曾有「打开右侧栏」这一段与 maRightPane* 三件套 —— 2026-09-27 根治时整条删除。
@@ -1449,14 +1515,9 @@ const SCRIPT = `(() => {
             window.fetch = function (input, init) {
               let url = "";
               try { url = typeof input === "string" ? input : (input && input.url) || ""; } catch (e5) { url = ""; }
-              /* 网络延迟采样（0.6.18）：**复用这处已有的包装**，零新增请求。
-                 t0 取在真正发请求之前、响应到达之后读差值 —— 量到的就是这一趟的真实往返。
-                 ⚠️ 只在同源且"像 API"的请求上量（与下面会话过期探测同一组判定）：
-                    静态壳/图片/字体不该代表"网络延迟"；telemetry 那条 /dsh-remote/telemetry/... 也
-                    不在 apiish 里（它既不含 "/api/" 也不含 "/remote/"，只有 "-remote/"），
-                    所以一次性的遥测上报不会污染样本。
-                 ⚠️ 失败(reject)/超时(>20s)不进样本 —— 那不是"延迟"，是"没通"（noteRtt 里已过滤）。 */
-              const t0 = maNowMs();
+              /* ⚠️ 2026-10-10：这里**不再**做网络延迟采样 —— 采样已独立成 maInstallNetSampler()
+                 （与菜单 DOM 解耦、幂等、自愈）。本包装只负责「会话过期探测」这一件事，
+                 否则同一趟请求会被量两次。 */
               const p = origFetch.call(this, input, init);
               try {
                 const abs = url.slice(0, 8).toLowerCase();
@@ -1465,7 +1526,7 @@ const SCRIPT = `(() => {
                 if (sameOrigin && apiish && p && typeof p.then === "function") {
                   p.then((res) => {
                     try { noteStatus(res && res.status); } catch (e6) { /* 忽略 */ }
-                    try { noteRtt(maNowMs() - t0); } catch (e6b) { /* 忽略 */ }
+                    /* 延迟采样已移到 maInstallNetSampler，这里只报会话过期 */
                   }, () => { /* 网络错误不算会话过期，也不算延迟样本 */ });
                 }
               } catch (e7) { /* 忽略 */ }
@@ -1509,6 +1570,11 @@ const SCRIPT = `(() => {
     let done = false;
     const boot = () => {
       if (!HOSTISH()) return;
+      /* 📶 **先**把延迟采样器挂上（2026-10-10）：它必须在"任何请求发生之前"就位。
+         即便 buildRemoteMenu() 因为任何原因没能建出菜单（或抛错），采样器也照挂不误 ——
+         旧实现把包装写在 buildRemoteMenu 内部的一次性分支里，那正是"请求明明在打、
+         界面却永远测速中"的结构性原因。 */
+      try { maInstallNetSampler(); } catch (eSampler0) { /* 忽略 */ }
       /* 悬浮按钮/菜单：任何宽度都要有（电脑端访问镜像页时同样需要返回设备列表的出口）。
          失败也不影响手机端布局适配 —— 两条链路各自独立。 */
       if (!fabDone) { fabDone = true; try { buildRemoteMenu(); } catch (eFabDone) { /* 忽略 */ } }
@@ -1976,6 +2042,12 @@ const SCRIPT = `(() => {
     const pump = () => {
       if (maTorn) return;
       if (bootUseful()) { try { boot(); } catch (eBoot) { /* 幂等重试 */ } }
+      /* 📶 采样器**自愈**（2026-10-10）：本函数每拍都跑（MutationObserver/1s 兜底），
+         所以只要 window.fetch 被谁换掉（我们自己注入的 E2EE shim 会在"解锁"时再包一层、
+         官方若在运行期替换 fetch 同理），下一拍就会把采样器重新挂回去 —— 幂等，已挂上时零开销。
+         同时顺手重绘一次：官方 SPA 换掉菜单子树后，数字不必等下一次请求才回来。 */
+      try { maInstallNetSampler(); } catch (eSampler) { /* 忽略 */ }
+      try { if (maNetRender) maNetRender(); } catch (eNetRender) { /* 忽略 */ }
       try { ensureDrawerChrome(); } catch (eChrome2) { /* 忽略 */ }
       /* 镜像页就绪探测（mirror_load 的量测终点）：pump 本来就被 MutationObserver(子树) + 1s 兜底表
          驱动，官方 frame/输入框一挂上就会在**这一拍或下一拍**（≤1s）命中 —— 这正是契约要求的

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

@@ -15,6 +15,7 @@
  * （既有用例只测注入纯函数，覆盖不到这里，所以这个 bug 当初没被任何测试拦住）。
  */
 import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
 import test from "node:test";
 import vm from "node:vm";
 import { injectMobileAdapter } from "../mobile-adapter.mjs";
@@ -549,9 +550,11 @@ test("★ 亚毫秒样本（本机/回环自测）也必须出数 —— 不得
   await new Promise((r) => setTimeout(r, 10));
   assert.equal(rtt.hidden, false, "★亚毫秒的真实往返必须记成样本（否则本机自测永远是「测速中…」）");
   assert.equal(String(rtt.textContent), "1ms", "展示层夹到 1ms —— 0ms 是谎话");
-  const net = findMenu(env).querySelector(".dsh-ma-menu-net");
-  assert.ok(!/测速中/.test(String(net.textContent)),
-    `菜单行不得再显示空态，实际：${net.textContent}`);
+  // ⚠️ 不断言菜单文案：本测试的假 DOM 不支持 `.txt` 这类**类选择器**（querySelector 只认属性/标签），
+  //    所以菜单里那行永远停在初始文案 —— 那是夹具限制，不是产品行为。
+  //    真正要证明的是"样本确实被记下了"：直接看采样器自己的计数最硬。
+  assert.ok(env.win.__dshMaNet.samples >= 1, `★必须真的采到样本，实际 samples=${env.win.__dshMaNet.samples}`);
+  assert.ok(env.win.__dshMaNet.lastUrl.includes("/api/"), `样本应来自合格请求，实际 ${env.win.__dshMaNet.lastUrl}`);
 });
 
 test("★ 悬浮窗被官方 SPA 重渲染重建后，已积累的样本仍要显示（样本不跟着某一代闭包走）", async () => {
@@ -576,6 +579,36 @@ test("★ 悬浮窗被官方 SPA 重渲染重建后，已积累的样本仍要
     "★重建后的悬浮窗必须立刻显示已积累的样本（旧实现读自己那份空数组 → 永远「测速中…」）");
 });
 
+test("★ 采样器由 boot 安装（不依赖菜单）+ 空态说得清原因 + 被顶掉能自愈重挂", async () => {
+  // 2026-10-10 二修：业主第二次反馈「镜像页一直测速中」，而同一时段镜像页打了 69 次
+  // /api/agentPresets/list 这类**完全合格**的请求 —— 说明真根因是**采样没接上**
+  // （旧实现把包装写在 buildRemoteMenu 内部的一次性分支里），而不是样本被过滤。
+  const env = harness({
+    width: 390,
+    fetchImpl: async () => { await new Promise((r) => setTimeout(r, 5)); return { status: 200, ok: true }; },
+  });
+  runAdapter(env);
+  // ① 采样器挂在 window.fetch 上，且与"菜单有没有建出来"无关
+  // 注意判据用**稳定标志**：建菜单时那层「会话过期探测」包装会包在采样器外面，
+  // 所以最外层 window.fetch 上没有我们的记号（拿函数记号当判据会每拍重包 → 泄漏）。
+  assert.equal(env.win.__dshMaNet && env.win.__dshMaNet.installed, true, "boot 阶段就应把采样器挂上（不依赖菜单构建成功）");
+  assert.equal(env.win.__dshMaNet.ok, true, "诊断对象应表明「已接上」");
+  // ② 空态必须能区分"接上了但还没请求"与"压根没接上"（以前两者长得一样，只能靠猜）。
+  //    假 DOM 不支持类选择器 → 文案本身用**源码级**断言锁住，状态用采样器自己的标志断言。
+  assert.equal(env.win.__dshMaNet.samples, 0, "还没有请求 → 0 个样本");
+  const SRC = readFileSync(new URL("../mobile-adapter.mjs", import.meta.url), "utf8");
+  assert.match(SRC, /测速中…（已接上，等一次请求）/, "空态（采样器已就绪）必须有独立文案");
+  assert.match(SRC, /测速中…（采样器未接上）/, "空态（采样器未接上）必须是**另一种**文案，一眼可分");
+  // ③ 被顶掉后自愈：模拟我们自己注入的 E2EE shim 在"解锁"时把 window.fetch 再包一层
+  env.win.fetch = async () => { await new Promise((r) => setTimeout(r, 5)); return { status: 200, ok: true }; };
+  env.win.__dshMaNet.installed = false;   // 模拟"fetch 被换掉、我们的采样器已不在链上"
+  env.body.children = [];                 // 同"重建"用例：清掉上一代节点，否则 findFab 拿到的还是旧的那个
+  runAdapter(env);                        // 再跑一次 = 重新走 boot 的安装路径
+  await env.win.fetch("/api/session/list");
+  await new Promise((r) => setTimeout(r, 10));
+  assert.notEqual(findFab(env).querySelector('[data-role="rtt"]').hidden, true, "重挂之后仍要能采到样本");
+});
+
 test("网络延迟：无样本 / 失败请求绝不显示 0ms（显示「测速中…」是唯一正确的空态）", async () => {
   const env = harness({
     width: 390,

package/dsh-setup.mjs

@@ -173,10 +173,13 @@ function printHelp() {
   dsh-remote doctor       一条命令自检「为什么连不上」（只读；含上游/进程/微信/日志尾部）
   dsh-remote --help       显示本用法（等同 dsh-remote help）
 
-目标 profile（默认 Web 版）:
-  dsh-remote --profile desktop    装进 DeepSeek Harness **桌面端**的插件目录
-                                  （~/.dsh/profiles/desktop；装前请先完全退出桌面应用）
-  桌面端也可以在应用内「插件」页直接安装 dsh-remote-web —— 那是官方路径，无需退出。
+目标 profile（默认：**本机 Web 版 + 桌面端一起装**）:
+  不带 --profile 时，会把插件装进本机**已有的** Web 版与桌面端 profile（谁在用就装给谁，
+  避免"命令跑完了、桌面端却没有面板"这类装错地方的坑）；机器上的实验/自动化 profile 不会被动。
+  dsh-remote --profile desktop    只装进 DeepSeek Harness **桌面端**
+                                  （~/.dsh/profiles/desktop）
+  dsh-remote --profile web        只装进 Web 版
+  桌面端也可以在应用内「插件」页直接安装 dsh-remote-web —— 那是官方路径，也最省事。
   ⚠️ 桌面端与 Web 版共享 ~/.dsh（会话/设置/凭据），但**插件互相隔离**，两边要各自安装。
 
 自建模式（可选）:
@@ -712,7 +715,7 @@ function writeAutostartFile() {
   <key>LimitLoadToSessionType</key><array><string>Aqua</string><string>Background</string></array>
   <key>StandardOutPath</key><string>${path.join(CONFIG_DIR, ".dsh-bridge.log")}</string>
   <key>StandardErrorPath</key><string>${path.join(CONFIG_DIR, ".dsh-bridge.log")}</string>
-  <key>EnvironmentVariables</key><dict><key>PATH</key><string>${SERVICE_PATH}</string>${SERVICE_NODE_ENV_PLIST}<key>DSH_BRIDGE_INSTALL_SOURCE</key><string>${INSTALL_SOURCE}</string><key>DSH_BRIDGE_INSTALL_VERSION</key><string>${INSTALL_VERSION}</string><key>DSH_BRIDGE_HARNESS_VERSION</key><string>${HARNESS_VERSION}</string></dict>
+  <key>EnvironmentVariables</key><dict><key>PATH</key><string>${SERVICE_PATH}</string>${SERVICE_NODE_ENV_PLIST}${PINNED_UPSTREAM ? `<key>DSH_BRIDGE_UPSTREAM</key><string>${PINNED_UPSTREAM}</string>` : ""}<key>DSH_BRIDGE_INSTALL_SOURCE</key><string>${INSTALL_SOURCE}</string><key>DSH_BRIDGE_INSTALL_VERSION</key><string>${INSTALL_VERSION}</string><key>DSH_BRIDGE_HARNESS_VERSION</key><string>${HARNESS_VERSION}</string></dict>
 </dict></plist>`;
     // ~/Library/LaunchAgents 在全新账户/精简系统上可能不存在,必须先建目录,
     // 否则 writeFileSync 抛 ENOENT 直接把安装流程打断(用户反馈里也踩过类似的路径问题)。
@@ -760,19 +763,46 @@ function launchdState(target) {
   };
 }
 
+/**
+ * 等 label **真的从 launchd 里摘干净**。
+ *
+ * 🔴 2026-10-11 实测的坑：`launchctl bootout` 是**异步**的 —— 紧接着 bootstrap 同一个 label 会
+ * 随机失败（`Bootstrap failed: 5: Input/output error`），表现为"安装时灵时不灵"：
+ * 手工在两条命令之间加个 sleep 就 100% 成功，安装器里没等就大约一半失败 →
+ * 失败后走 `spawnDetachedBridge()` 兜底 → 用户看到"⚠️ 未被系统托管 / 不会开机自启"。
+ * 所以 bootout 之后必须轮询到 `launchctl print` 真的查不到，再 bootstrap。
+ */
+function waitLaunchdGone(target, tries = 12, gapMs = 200) {
+  for (let i = 0; i < tries; i += 1) {
+    if (!sh(`launchctl print ${target}`).ok) return true;
+    sleepSync(gapMs);
+  }
+  return false;
+}
+
 /**
  * 轮询等待 job 起来。
  * launchd 派生是异步的：bootstrap 成功后立刻 print 必然看到 not running（旧实现因此误报"启动失败"）。
  * 明确"被挂起且没有派生"时提前放弃（等满也没用），否则给足 ~8 秒。
  */
-function waitLaunchdRunning(target, tries = 20, gapMs = 400) {
+function waitLaunchdRunning(target, tries = 25, gapMs = 400) {
   let st = launchdState(target);
   for (let i = 0; i < tries; i += 1) {
     st = launchdState(target);
     if (st.running) return st;
-    // 已登记、没在跑、又没被挂起（runs>0 说明派生过）→ 是启动后立刻退出，不必等满
+    /* 🔴 2026-10-11 修：刚 bootstrap/kickstart 后 launchd 会先进入**过渡态**
+       （`state = xpcproxy` / `spawn scheduled` / `pending`），此时 runs 还是 0。
+       旧判据"登记了却一次都没派生 → 判定被挂起"在 1.2 秒后就放弃，于是
+       `installAutostart()` 误报"launchd 无法托管本机 bridge"，转而拉起一个**脱离进程** ——
+       用户看到的是"安装没装好/不会开机自启"，而实际上 launchd 下一秒就把它拉起来了
+       （现场实测：state=xpcproxy，几秒后 state=running）。
+       现在：过渡态一律继续等；只有"确实派生过又退出"或"等满窗口都没起来"才算失败。 */
+    const transitional = /state\s*=\s*(xpcproxy|spawn scheduled|pending|running\s*\()/i.test(String(st.raw || ""));
+    if (transitional) { sleepSync(gapMs); continue; }
+    // 已派生过、现在没在跑、也没被挂起 → 是启动后立刻退出（真失败），不必等满
     if (st.exists && st.runs > 0 && !st.deferred) break;
-    if (i >= 2 && st.exists && !st.deferred && st.runs === 0) break; // 登记了却一次都没派生 → 被挂起
+    // 登记了却一次都没派生，且已经等了足够久（给足 4 秒让 launchd 调度）→ 判为被挂起
+    if (i >= 10 && st.exists && !st.deferred && st.runs === 0) break;
     sleepSync(gapMs);
   }
   return st;
@@ -807,6 +837,28 @@ function spawnDetachedBridge() {
  *      但实测 kickstart 只解决"这一次"，进程被杀后不会重建（KeepAlive 已被系统绕过）→ 如实告知
  *   ③ 后台进程  ← 连 launchd 都托管不了时保证可用
  */
+/**
+ * 🔴 标签占用保护（2026-10-10 事故）：`com.dshremote.bridge` 这个 launchd label 是**全局唯一**的，
+ *   谁 bootstrap 谁就接管它。当天跑测试时，某个用例用**假 HOME + 真 launchctl** 把测试临时目录的
+ *   plist 登记到了同一个 label 上 → **真桥被顶掉**、远程访问中断，而日志里看不出任何异常。
+ *
+ *   所以 bootstrap 之前先问一句：这个 label 现在登记的 plist 是**本 relayDir 的**那份吗？
+ *   · 不是（别人家的）→ **拒绝接管**并明确报错。要强行接管得显式设
+ *     `DSH_BRIDGE_ALLOW_LABEL_TAKEOVER=1`（给人留后门，但默认安全）。
+ *   · 查不出来（launchctl 不可用/未登记）→ 照旧继续，不误伤正常安装。
+ */
+function labelOwnedByOtherDir(plistPath, domain) {
+  try {
+    const r = sh(`launchctl print ${domain}/${BRIDGE_LABEL}`);
+    if (!r.ok) return null;                       // 未登记 → 不是"别人家的"
+    const cur = String(r.stdout || "").match(/^\s*path = (.+)$/m);
+    if (!cur) return null;                        // 读不出路径 → 不拦
+    const a = cur[1].trim();
+    const b = String(plistPath).trim();
+    return a === b ? false : a;                   // 返回"占用者的 plist 路径"= 别人家的
+  } catch { return null; }
+}
+
 function startBridgeDarwin(plistPath) {
   const uid = process.getuid();
   const q = (s) => "'" + String(s).replace(/'/g, `'\\''`) + "'";
@@ -817,8 +869,25 @@ function startBridgeDarwin(plistPath) {
     for (const d of [`user/${uid}`, `gui/${uid}`]) {
       if (d !== domain) sh(`launchctl bootout ${d}/${BRIDGE_LABEL}`);
     }
+    // 先确认这个 label 不是别人（别的 relayDir）的，否则**拒绝接管**——见 labelOwnedByOtherDir
+    const foreign = labelOwnedByOtherDir(plistPath, domain);
+    if (foreign && String(process.env.DSH_BRIDGE_ALLOW_LABEL_TAKEOVER || "") !== "1") {
+      return {
+        ok: false,
+        status: "label-owned-by-other",
+        detail: `${domain}/${BRIDGE_LABEL} 已被另一个 relayDir 占用（${foreign}）—— 拒绝接管。`
+          + `真要用本目录接管，请先停掉那边的桥，或显式设 DSH_BRIDGE_ALLOW_LABEL_TAKEOVER=1。`,
+      };
+    }
     sh(`launchctl bootout ${target}`);
+    waitLaunchdGone(target);   // 关键：不等干净就 bootstrap → 随机 "5: Input/output error"
     let boot = sh(`launchctl bootstrap ${domain} ${q(plistPath)}`);
+    if (!boot.ok) {
+      // 摘除竞态可能还没结束：再等一拍重试一次（仍失败才走老写法兜底）
+      sleepSync(600);
+      waitLaunchdGone(target, 6, 200);
+      boot = sh(`launchctl bootstrap ${domain} ${q(plistPath)}`);
+    }
     if (!boot.ok) {
       // 老写法兜底（部分系统上 load -w 仍可用）
       sh(`launchctl unload ${q(plistPath)}`);
@@ -927,6 +996,33 @@ function restartBridgeService() {
  *   统一在 clients/dsh-remote/upstream-discovery.mjs，watcher 与 bridge 共用同一份实现。
  */
 const UPSTREAM_FILE = ".dsh-upstream";
+
+/**
+ * 本次安装要**钉住**的上游（null = 不钉，运行时按 env → .dsh-upstream → 探测 取值）。
+ * 见 desktopAppPort() 的注释：插件装进多个 profile 后，各宿主会互相覆盖 `.dsh-upstream`。
+ */
+let PINNED_UPSTREAM = String(process.env.DSH_BRIDGE_UPSTREAM || "").trim().replace(/\/+$/, "") || null;
+
+/**
+ * 探测桌面端（Electron 应用）当前监听的**回环端口**。
+ *
+ * 为什么需要（2026-10-11 实测事故）：插件同时装进 web 与 desktop 后，**每个宿主**都会在装载时
+ * 把自己 `ctx.webServer.port` 写进 `<relayDir>/.dsh-upstream` —— 谁最后写谁生效。于是桥的上游
+ * 会在两个应用之间来回跳：那次桥跑去连了 Web 版的 3080，而业主面对的是桌面端 19387，
+ * 表现就是"命令跑完了但没装上 / 手机连上看到的不是我在用的界面"。
+ * 装桌面端时把端口**钉进自启动配置**（环境变量优先级最高），两个宿主就抢不动了。
+ */
+function desktopAppPort() {
+  if (process.platform !== "darwin") return null;
+  try {
+    const r = sh("lsof -nP -iTCP -sTCP:LISTEN -a -c DeepSeek 2>/dev/null");
+    for (const line of String(r.stdout || "").split("\n")) {
+      const m = line.match(/(?:127\.0\.0\.1|\[::1\]):(\d+)\s/);
+      if (m) return Number(m[1]);
+    }
+  } catch { /* 拿不到就算了，退回运行时探测 */ }
+  return null;
+}
 /** 运行时动态发现到的上游（优于可能过期的端口文件；进程内缓存）。 */
 let discoveredUpstream = "";
 function upstreamUrl() {
@@ -1043,6 +1139,50 @@ function resolveProfileDir(argv = []) {
  * `pluginCmd()` 时原本传的是空数组 —— 于是"指定 desktop profile"会被静默忽略、
  * 插件仍然装进 Web 版 profile（桌面端用户装了却看不到面板，且极难自查）。
  */
+/**
+ * 探测本机**已存在**的 profile（可装载 = 同时有 package.json 与 cordis.patch.yml）。
+ * desktop 排在前面：业主主用的是桌面应用，多个 profile 一起装时它是"首选/权威"那个。
+ */
+function detectProfileDirs() {
+  const root = path.join(os.homedir(), ".dsh", "profiles");
+  let names = [];
+  try {
+    names = fs.readdirSync(root, { withFileTypes: true })
+      .filter((e) => e.isDirectory() && !e.name.startsWith("."))
+      .map((e) => e.name)
+      .filter((n) => fs.existsSync(path.join(root, n, "package.json")) && fs.existsSync(path.join(root, n, "cordis.patch.yml")));
+  } catch { return []; }
+  names.sort((a, b) => (a === "desktop" ? -1 : b === "desktop" ? 1 : a.localeCompare(b)));
+  return names.map((n) => ({ name: n, dir: profileDirOfName(n) }));
+}
+
+/**
+ * 本次要操作的 profile 列表。
+ *
+ * 业主口径（2026-10-11）：「默认安装的时候也能同步安装给 desktop」。
+ * 以前不带 `--profile` 时**写死装 web** —— 桌面端用户执行官方那条 `npx @mrrisega/dsh-remote@beta`
+ * 之后，插件全进了 Web 版 profile，而用户面对的是桌面应用 → 面板永远不出现，且极难自查。
+ *
+ * · `--profile X` / `DSH_PROFILE_DIR` → 只动那一个（脚本化与既有用法不变）
+ * · 都不给 → **本机所有已存在的 profile**（desktop 优先）
+ * · 一个都没探测到 → 退回 web（保留"首次安装"的引导文案）
+ */
+function targetProfileDirs(argv = []) {
+  const i = argv.indexOf("--profile");
+  if (i > -1 && argv[i + 1]) return [{ name: argv[i + 1], dir: resolveProfileDir(argv) }];
+  if (process.env.DSH_PROFILE_DIR) return [{ name: "env", dir: process.env.DSH_PROFILE_DIR }];
+  const all = detectProfileDirs();
+  if (!all.length) return [{ name: "web", dir: profileDirOfName("web") }];
+  /* 默认装哪些？**不是"全部"** —— 机器上常有过实验/自动化用的 profile（headless、web02…），
+     往那些里面塞插件是越界。规则：
+       · 已知的面向用户的 profile（web / desktop）：**有就装**（这是业主的核心诉求：默认也要给 desktop）
+       · 其他 profile：**只有本来就已经装了插件**才继续管（升级不能悄悄漏掉它）
+       · 上面并集为空（例如只有 headless 一种）→ 退回"全部已存在"，避免什么都不装 */
+  const chosen = all.filter((p) => KNOWN_PROFILE_NAMES.includes(p.name)
+    || fs.existsSync(path.join(p.dir, PLUGIN_LOCAL_DIR)));
+  return chosen.length ? chosen : all;
+}
+
 function profileArgvOf(argv = []) {
   const i = argv.indexOf("--profile");
   return i > -1 && argv[i + 1] ? ["--profile", argv[i + 1]] : [];
@@ -1634,6 +1774,19 @@ async function setup(argv) {
 
   let svc = { path: null, status: { ok: true, status: "skipped", detail: "--no-autostart" } };
   if (!noAutostart) {
+    // ⚠️ 顺序要紧：**先**探测并钉住上游，**再**写自启动文件 ——
+    // 否则 plist 里不会带上 DSH_BRIDGE_UPSTREAM（实测踩到：打印说已钉住，plist 里却没有）。
+    try {
+      const pluginTargets = targetProfileDirs(argv);
+      if (!PINNED_UPSTREAM && pluginTargets.some((t) => t.name === "desktop")) {
+        const p = desktopAppPort();
+        if (p) {
+          PINNED_UPSTREAM = `http://127.0.0.1:${p}`;
+          try { fs.writeFileSync(path.join(CONFIG_DIR, UPSTREAM_FILE), PINNED_UPSTREAM + "\n"); } catch { /* 忽略 */ }
+          console.log(`ℹ 桌面端在 127.0.0.1:${p} 监听 → 桥的上游已钉到它（避免与 Web 版互抢）`);
+        }
+      }
+    } catch { /* 探测失败不阻断安装 */ }
     svc = installAutostart();
   } else {
     console.log("ℹ --no-autostart：跳过自启动服务安装（可用 `dsh-remote run` 手动运行 bridge）。");
@@ -1646,7 +1799,9 @@ async function setup(argv) {
     try {
       // ⚠️ 必须把 `--profile` **透传下去**：否则 `--profile desktop`（桌面端）会被静默忽略，
       // 插件装进 Web 版 profile，而用户面对的是桌面端 —— 面板永远不出现。
-      warnIfDesktopProfile(resolveProfileDir(argv));
+      // 未指定 --profile 时目标是本机全部 profile：桌面端提醒与后续判定都要按同一份列表来
+      const pluginTargets = targetProfileDirs(argv);
+      for (const t of pluginTargets) warnIfDesktopProfile(t.dir);
       pluginResult = await pluginCmd(profileArgvOf(argv));
     } catch (e) {
       console.warn(`⚠️ 插件安装未完成：${e.message}`);
@@ -1656,7 +1811,8 @@ async function setup(argv) {
   // 插件是**进程启动时**装载的：刚装进 profile 的插件，运行中的 dsh web 里并没有
   // （既没有 /dsh-remote/* 路由，也没有「设置 → 远程访问」面板项）。
   // 这里做一个确定性判断：进程启动时间早于插件落盘时间 → 必须重启 dsh web 才生效。
-  const pluginDir = path.join(resolveProfileDir(argv), PLUGIN_LOCAL_DIR);
+  const primaryProfileDir = targetProfileDirs(argv)[0].dir;   // desktop 优先 = 用户面对的那个宿主
+  const pluginDir = path.join(primaryProfileDir, PLUGIN_LOCAL_DIR);
   const pluginMtime = fs.existsSync(path.join(pluginDir, "lib", "index.js"))
     ? fs.statSync(path.join(pluginDir, "lib", "index.js")).mtimeMs
     : 0;
@@ -2197,10 +2353,21 @@ function copyPluginIntoProfile(profileDir, pluginDir) {
     // 注意：插件源(npx 缓存 / npm 全局)本身就位于某个 node_modules 之下，
     // 过滤必须基于“相对插件目录”的路径片段，绝不能整条 src 路径包含判断，
     // 否则会把插件文件全过滤掉、拷出空目录(此前反复“插件入口缺失”的总根因)。
+    //
+    // 🔴 2026-10-10 修：**插件自带的 runtime/node_modules 不能被剔掉**。
+    //   旧规则是"任何一段叫 node_modules 就过滤"，这条原本只想剔掉插件自己的依赖目录
+    //   （那些由 profile 的包管理器管），却把 `runtime/node_modules/ws` 一起剔了 ——
+    //   而那份运行时正是"只有插件半"的机器**自愈补装时的来源**。剔掉它 = 自愈出来的运行环境
+    //   缺 ws（bridge 顶层 `import WebSocket from "ws"`）→ 一启动就崩，还"自检通过"。
+    //   现在：`runtime/` 之内一律保留；只过滤 runtime 之外的 node_modules。
     filter: (src) => {
       if (src === pluginDir) return true;
-      const rel = path.relative(pluginDir, src);
-      return !String(rel).split(path.sep).some((seg) => seg === "node_modules" || seg === ".git" || seg === ".DS_Store");
+      const rel = String(path.relative(pluginDir, src));
+      const segs = rel.split(path.sep);
+      if (segs.some((seg) => seg === ".git" || seg === ".DS_Store")) return false;
+      const inBundledRuntime = segs[0] === "runtime";
+      if (!inBundledRuntime && segs.some((seg) => seg === "node_modules")) return false;
+      return true;
     }
   };
 
@@ -2613,13 +2780,32 @@ function convergePluginActivation(profileDir, pkgFile, patchFile, pluginDir, pat
 
 async function pluginCmd(argv) {
   const uninstall = hasFlag(argv, "--uninstall");
-  const profileDir = resolveProfileDir(argv);
+  const targets = targetProfileDirs(argv);
+  const multi = targets.length > 1;
+  if (multi) {
+    console.log(`ℹ 未指定 --profile：同步到本机**全部 ${targets.length} 个 profile**（${targets.map((t) => t.name).join(" → ")}）`);
+  }
+  let last = null;
+  let ok = 0;
+  for (const t of targets) {
+    if (multi) console.log(`\n── profile: ${t.name}（${t.dir}）`);
+    const r = await pluginApplyTo(t.dir, uninstall, multi);
+    if (r === "skip") continue;
+    ok += 1;
+    if (r !== undefined && r !== null) last = r;
+  }
+  if (ok === 0) process.exit(1);
+  return last;
+}
+
+/** 对**单个** profile 执行插件安装/卸载（原 pluginCmd 主体，逐字保留行为）。 */
+async function pluginApplyTo(profileDir, uninstall, multi) {
   const pkgFile = path.join(profileDir, "package.json");
   const patchFile = path.join(profileDir, "cordis.patch.yml");
   const pluginDir = path.join(THIS_DIR, "packages", PLUGIN_ID);
 
   if (!fs.existsSync(pkgFile) || !fs.existsSync(patchFile)) {
-    console.error(`❌ 未找到 profile（${profileDir}）。`);
+    console.error(`${multi ? "⚠️ 跳过（未找到 profile）" : "❌ 未找到 profile"}（${profileDir}）。`);
     if (isDesktopProfileDir(profileDir)) {
       // 桌面端 profile 由 Electron 应用**自己初始化**：npm 版 `dsh` 明确拒绝管理它
       // （apps/cli 的 rejectElectronProfile），所以 Web 版那句 "npx @deepseek-ai/dsh web"
@@ -2632,6 +2818,7 @@ async function pluginCmd(argv) {
     } else {
       console.error("   请先安装 DeepSeek Harness（npx @deepseek-ai/dsh web）并初始化默认 profile。");
     }
+    if (multi) return "skip";
     process.exit(1);
   }
   if (!fs.existsSync(pluginDir)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrisega/dsh-remote",
-  "version": "0.7.0-beta.3",
+  "version": "0.7.0-beta.5",
   "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",
@@ -51,13 +51,14 @@
   },
   "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 packages/relay-router/test/device-free-assets.test.mjs packages/relay-router/test/sse-streaming-contract.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",
+    "test:router": "DSH_PROFILE_DIR= 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 packages/relay-router/test/device-free-assets.test.mjs packages/relay-router/test/sse-streaming-contract.test.mjs",
+    "_comment:test:plugin": "DSH_PROFILE_DIR= = 测试隔离铁律：本套件跑在 DSH 宿主里时环境**天然带着** DSH_PROFILE_DIR（指向真实 ~/.dsh/profiles/desktop），而多数用例只隔离了 HOME —— 于是它们会去写**真实** profile 的 cordis.patch.yml（2026-10-10 事故：测试 relayDir 被写进真 profile，面板连到假配置、验证码/公告全 502）。这里显式清空，让 profile 解析回落到各用例自己的假 HOME。 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_PROFILE_DIR= 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",
+    "test:bridge": "DSH_PROFILE_DIR= 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",
-    "release:tarballs": "bash scripts/release-tarballs.sh"
+    "release:tarballs": "bash scripts/release-tarballs.sh",
+    "sync:local": "node scripts/sync-local.mjs"
   },
   "dependencies": {
     "ws": "^8.18.0"