@mrrisega/dsh-remote 0.7.0-beta.4 → 0.7.0-beta.6

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;
@@ -850,7 +880,14 @@ function startBridgeDarwin(plistPath) {
       };
     }
     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)}`);
@@ -959,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() {
@@ -1075,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]] : [];
@@ -1666,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）。");
@@ -1678,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}`);
@@ -1688,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;
@@ -2656,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"
@@ -2675,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.4",
+  "version": "0.7.0-beta.6",
   "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/lib/client.js

@@ -834,22 +834,34 @@ window.__ModuleLoader__.load({
      *   其中 **带 aria-keyshortcuts / 文案或 aria-label 含「设置」** 的优先（语言无关 + 精确）。
      */
     function settingsTriggerCandidates() {
-      var out = [];
+      var ranked = [];
       try {
+        /* 排名而不是「谁先扫到谁」（2026-10-11 业主实测「点入口弹出的是 token 用量小弹窗」）：
+             ① 官方设置槽位里的按钮 = 确定是设置触发器（sidebar.settings / settings.launcher）
+             ② 带快捷键或文案含「设置」的弹层触发器
+             ③ 其它弹层触发器（最后兜底）
+           并且**排除我们自己所在的底部槽**（sidebar.footer.action）—— token 用量、其它插件按钮
+           都在那一块，它们同样带 aria-haspopup=dialog，正是「点错弹窗」的来源。
+           只用 closest 判容器、不做后代选择器：任何 DOM 实现（含测试替身）都支持。 */
         var cands = document.querySelectorAll('button[aria-haspopup="dialog"], [aria-haspopup="dialog"]');
-        var rest = [];
         for (var i = 0; i < cands.length; i++) {
           var el = cands[i];
           if (!el || el.id === NAV_ENTRY_ID) continue;   // 排除我们自己的入口
           if (navInDialog(el)) continue;                 // 弹层内的（关闭键/栏目）一律不要
+          try { if (el.closest && el.closest('[data-slot="sidebar.footer.action"]')) continue; } catch (e0) { /* 忽略 */ }
           if (NAV_BAD_RE.test(String(el.className || ""))) continue;
+          var inSettingsSlot = false;
+          try {
+            inSettingsSlot = !!(el.closest && el.closest('[data-slot="sidebar.settings"], [data-slot="settings.launcher"]'));
+          } catch (e1) { inSettingsSlot = false; }
           var label = String(navAttrOf(el) || navCleanText(el) || "");
           var hasShortcut = !!(el.getAttribute && el.getAttribute("aria-keyshortcuts"));
-          if (hasShortcut || /设置|Settings/i.test(label)) out.push(el);
-          else rest.push(el);
+          var rank = inSettingsSlot ? 0 : ((hasShortcut || /设置|Settings/i.test(label)) ? 1 : 2);
+          ranked.push({ el: el, rank: rank, order: i });
         }
-        return out.concat(rest);   // 兜底也不能空着：实在认不出就逐个试（见 openRemoteSettings）
-      } catch (e) { return out; }
+        ranked.sort(function (a, b) { return (a.rank - b.rank) || (a.order - b.order); });
+        return ranked.map(function (x) { return x.el; });
+      } catch (e) { return ranked.map(function (x) { return x.el; }); }
     }
     /** 官方「设置」触发器（首选候选，保持旧名字给测试与调用方用）。 */
     function pickSettingsTrigger() {
@@ -2718,7 +2730,11 @@ window.__ModuleLoader__.load({
       // 在那边**做不到也不该做**（强行退出会弹原生致命错误）。面板据此：
       //   ① 不自动倒计时重启；② 保留提醒但改文案，引导"退出并重开桌面应用"。
       // 旧版 host 的响应里没有该字段 → false，行为与改动前完全一致。
-      var desktopHost = !!(st && st.desktopHost);
+      // 🔴 2026-10-11 修：node 半把该字段下在 **connect** 里（`connect.desktopHost`），
+      // 这里以前读顶层 `st.desktopHost` → **永远 false** → 桌面端被当成 Web 版：
+      // 面板照样摆「立即重启」按钮、照样走倒计时自动重启那条路（业主实测"装插件时窗口被突兀关掉"）。
+      // 兼容两种位置，桌面端的"不自动重启/只提示用户自己重启"这才真正生效。
+      var desktopHost = !!(st && (st.desktopHost || (st.connect && st.connect.desktopHost)));
       // kind === "refresh" = 插件文件在运行中被改写(装完/更新完),只需刷新页面;
       // 其余情况(极为罕见)才提重启 dsh web。
       var isRefreshOnly = restartPending && restartInfo.kind === "refresh";

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

@@ -6626,6 +6626,21 @@ function registerRoutes(ctx, relayDir) {
       handler: async (_req, res) => {
         // 首次安装/在线更新后重启 DeepSeek harness：插件本体与浏览器半在进程启动时装载，
         // 不重启则面板入口与 /dsh-remote/* 路由都不会出现。只重启承载本插件的进程。
+        //
+        // 🔴 2026-10-11 业主口径：**桌面端绝不代为重启**。
+        //   "自动重启会很突兀地把窗口给关掉，关没了……我们应该提示用户自己重启，不要由我们来重启。"
+        //   桌面端 Host 由 Electron 托管，重启 = 强杀承载窗口的进程（还会弹原生致命错误）。
+        //   这里做成**硬拒绝**（不只是前端藏按钮）：任何调用方都拿不到"被重启"的结果，
+        //   只会收到一句明确的"请手动重启"，前端据此展示提示。
+        if (IS_ELECTRON_HOST) {
+          sendJson(res, 200, {
+            ...(await composeStatus(relayDir)),
+            ok: false,
+            status: "manual-restart-required",
+            detail: "桌面端不代为重启：请手动退出并重新打开 DeepSeek Harness（自动重启会突兀地关掉窗口）",
+          });
+          return;
+        }
         const r = await restartHarness(relayDir);
         const payload = { ...(await composeStatus(relayDir)), ...r };
         if (!r.ok) payload.error = r.detail || r.status || "重启失败";

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

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-web",
-  "version": "0.7.0-beta.4",
+  "version": "0.7.0-beta.6",
   "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/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;
@@ -850,7 +880,14 @@ function startBridgeDarwin(plistPath) {
       };
     }
     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)}`);
@@ -959,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() {
@@ -1075,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]] : [];
@@ -1666,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）。");
@@ -1678,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}`);
@@ -1688,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;
@@ -2656,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"
@@ -2675,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/packages/dsh-remote-web/test/install-profile-targets.test.mjs

@@ -0,0 +1,105 @@
+/**
+ * 「默认安装装给谁」契约测试（2026-10-11 业主口径）。
+ *
+ * 事故/反馈：业主执行官方那条 `npx --yes @mrrisega/dsh-remote@beta`（不带参数）后，
+ * 插件**全进了 Web 版 profile**，而他面对的是**桌面应用** —— 面板永远不出现，
+ * 且面板/文档里都看不出来"装错了地方"。根因：`resolveProfileDir()` 在没有 `--profile`
+ * 与 `DSH_PROFILE_DIR` 时**写死 `profileDirOfName("web")`**。
+ *
+ * 现在的契约：
+ *   · `--profile X` / `DSH_PROFILE_DIR` → 只动那一个（脚本化语义不变）
+ *   · 都不给 → **已知的面向用户的 profile（web / desktop，有就装）+ 本来就已经装了插件的 profile**
+ *     （升级不能悄悄漏掉它）；机器上的实验/自动化 profile（headless、web02…）**不碰**
+ *   · 一个可装载 profile 都没有 → 退回 web（保留首次安装引导）
+ *
+ * 用例全程在**假 HOME** 里跑真实子进程，绝不触碰开发者真实的 ~/.dsh/profiles/**。
+ */
+
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
+const SETUP = join(ROOT, "dsh-setup.mjs");
+const PLUGIN_LOCAL_DIR = "dsh-remote-web-plugin";
+
+/** 造一个"可装载"的 profile（必须同时有 package.json 与 cordis.patch.yml）。 */
+function makeProfile(home, name, { withPlugin = false } = {}) {
+  const dir = join(home, ".dsh", "profiles", name);
+  mkdirSync(join(dir, "node_modules"), { recursive: true });
+  writeFileSync(join(dir, "package.json"), JSON.stringify({
+    name: `dsh-profile-${name}`, private: true, dependencies: {},
+    dsh: { profile: { bundles: ["@deepseek-ai/dsh-base"], patchReload: "live" } }
+  }, null, 2) + "\n");
+  writeFileSync(join(dir, "cordis.patch.yml"), "# dsh profile patch\n[]\n");
+  if (withPlugin) mkdirSync(join(dir, PLUGIN_LOCAL_DIR), { recursive: true });
+  return dir;
+}
+
+/** 跑真实的 `plugin` 子进程。**显式清掉 DSH_PROFILE_DIR**：宿主环境天然带着它（会盖掉默认多选）。 */
+function runPlugin(home, args = []) {
+  const env = { ...process.env, HOME: home, DSH_PROFILE_DIR: "", DSH_RELAY_DIR: join(home, ".dsh-remote"), DSH_RELAY_SKIP_SERVICE: "1" };
+  const r = spawnSync(process.execPath, [SETUP, "plugin", ...args], { encoding: "utf8", env, timeout: 120000 });
+  return { out: String(r.stdout || ""), err: String(r.stderr || ""), code: r.status };
+}
+
+const hasPlugin = (dir) => existsSync(join(dir, PLUGIN_LOCAL_DIR, "lib", "client.js"));
+const patched = (dir) => /id:\s*dsh-remote-web/.test(readFileSync(join(dir, "cordis.patch.yml"), "utf8"));
+
+test("默认（不带 --profile）：桌面端与 Web 版**都装**，实验 profile 不碰", async () => {
+  const home = mkdtempSync(join(tmpdir(), "dshprofiles-"));
+  try {
+    const desktop = makeProfile(home, "desktop");
+    const web = makeProfile(home, "web");
+    const headless = makeProfile(home, "headless");
+    const r = runPlugin(home);
+    assert.equal(r.code, 0, `安装应成功：${r.err.slice(0, 300)}`);
+    // ★ 业主的核心诉求：默认也要装给 desktop
+    assert.ok(hasPlugin(desktop), "★ 默认安装必须装进 desktop profile（否则桌面端用户看不到面板）");
+    assert.ok(patched(desktop), "desktop 的 patch 必须写入激活行");
+    assert.ok(hasPlugin(web), "Web 版 profile 同样要装");
+    assert.ok(!hasPlugin(headless), "实验/自动化 profile（headless）不该被塞插件");
+    assert.match(r.out, /全部 2 个 profile/, "应当如实说明装了哪几个 profile");
+    assert.match(r.out, /desktop/, "输出里应点名 desktop");
+  } finally { rmSync(home, { recursive: true, force: true }); }
+});
+
+test("--profile X：只动那一个（脚本化语义不变）", async () => {
+  const home = mkdtempSync(join(tmpdir(), "dshprofiles-"));
+  try {
+    const desktop = makeProfile(home, "desktop");
+    const web = makeProfile(home, "web");
+    const r = runPlugin(home, ["--profile", web]);
+    assert.equal(r.code, 0, `安装应成功：${r.err.slice(0, 300)}`);
+    assert.ok(hasPlugin(web), "指定了 web 就该装 web");
+    assert.ok(!hasPlugin(desktop), "--profile 指定后**不得**顺手装 desktop");
+  } finally { rmSync(home, { recursive: true, force: true }); }
+});
+
+test("非知名 profile 但**本来已装过** → 继续管它（升级不能悄悄漏掉）", async () => {
+  const home = mkdtempSync(join(tmpdir(), "dshprofiles-"));
+  try {
+    const web = makeProfile(home, "web");
+    const custom = makeProfile(home, "web02", { withPlugin: true });   // 之前装过
+    const desktop = makeProfile(home, "desktop");
+    const r = runPlugin(home);
+    assert.equal(r.code, 0, `安装应成功：${r.err.slice(0, 300)}`);
+    assert.ok(hasPlugin(web) && hasPlugin(desktop), "已知 profile 照装");
+    assert.ok(hasPlugin(custom), "已装过插件的 profile 必须一起升级（否则它会停在旧版）");
+  } finally { rmSync(home, { recursive: true, force: true }); }
+});
+
+test("一个可装载 profile 都没有 → 退回 web，并给出首次安装引导", async () => {
+  const home = mkdtempSync(join(tmpdir(), "dshprofiles-"));
+  try {
+    mkdirSync(join(home, ".dsh", "profiles"), { recursive: true });
+    const r = runPlugin(home);
+    // 没有任何 profile → 目标退回 web（不存在）→ 单 profile 模式报错退出并给引导
+    assert.notEqual(r.code, 0, "没有可用 profile 时应失败退出");
+    assert.match(r.err + r.out, /profile/i, "要明确说找不到 profile");
+  } finally { rmSync(home, { recursive: true, force: true }); }
+});

package/packages/dsh-remote-web/test/launchd-domain.test.mjs

@@ -66,7 +66,11 @@ test("launchd 修复：不再只 print 一次就判定失败（异步派生必
   const fn = src.slice(src.indexOf("function launchdState"), src.indexOf("function spawnDetachedBridge"));
   assert.ok(/for \(let i = 0; i < tries; i \+= 1\)/.test(fn), "应循环轮询而非单次检查");
   assert.ok(/sleepSync\(gapMs\)/.test(fn), "轮询之间要真正等待");
-  assert.ok(/tries = 20/.test(fn), "总等待时长应足够 launchd 完成异步派生");
+  // 断言"总等待窗口足够"而不是写死某个数字：2026-10-11 把窗口放宽到 25×400ms（过渡态更常见）
+  const win = fn.match(/waitLaunchdRunning\(target, tries = (\d+), gapMs = (\d+)\)/);
+  assert.ok(win, "waitLaunchdRunning 应有显式的 tries/gapMs 默认值");
+  assert.ok(Number(win[1]) * Number(win[2]) >= 8000,
+    `总等待窗口应 ≥8 秒（launchd 派生是异步的），实际 ${Number(win[1]) * Number(win[2])}ms`);
   // 必须能识别「登记了但从未派生」这一 macOS 26 特征，才能给出正确建议而不是干等
   assert.ok(/pended nondemand spawn/.test(fn) && /on-demand-only/.test(fn), "应识别 on-demand-only 挂起特征");
 });

package/packages/dsh-remote-web/test/settings-entry-placement.test.mjs

@@ -100,7 +100,7 @@ function makeDocument(roots) {
   };
 }
 function loadNavHelpers(doc) {
-  const src = navHelpersSource() + "\nreturn { pickSettingsTrigger, pickNavByToken, navInDialog };";
+  const src = navHelpersSource() + "\nreturn { pickSettingsTrigger, settingsTriggerCandidates, pickNavByToken, navInDialog };";
   // eslint-disable-next-line no-new-func
   return new Function("document", "window", src)(doc, {});
 }
@@ -135,6 +135,30 @@ test("★ 事故锁：官方「设置」触发器只认语义锚点，且必须
   assert.equal(pickSettingsTrigger(), trigger, "必须命中侧栏那颗 aria-haspopup=dialog 的齿轮按钮");
 });
 
+test("★ 2026-10-11 业主实测：点入口弹出的是 token 用量弹窗 —— 官方设置槽位必须优先于底部槽邻居", () => {
+  // 现场：入口挂在 sidebar.footer.action，而同一底部区域的「token 本轮用量」按钮
+  // 也带 aria-haspopup="dialog"（甚至带快捷键）→ 旧实现"谁先扫到谁"就点中了它。
+  // 现在：① 官方设置槽位里的按钮排第一；② 底部槽（我们所在那块）里的候选直接排除。
+  const sidebar = new El("div", { cls: "sidebarRoot" });
+  const footSlot = new El("div", { attrs: { "data-slot": "sidebar.footer.action" } });
+  const tokenBtn = new El("button", { cls: "tokTrigger", attrs: { "aria-haspopup": "dialog", "aria-keyshortcuts": "Alt+Meta+T", "aria-label": "本轮用量" } });
+  const entry = new El("button", { id: "dru-nav-remote", cls: "dru-foot-entry", text: "📱 远程访问" });
+  footSlot.append(tokenBtn, entry);
+  const settingsArea = new El("div", { cls: "settingsArea" });
+  const settingsSlot = new El("div", { attrs: { "data-slot": "sidebar.settings" } });
+  const trigger = new El("button", { cls: "gearTrigger", attrs: { "aria-haspopup": "dialog", "aria-label": "设置" } });
+  settingsSlot.append(trigger);
+  settingsArea.append(settingsSlot);
+  sidebar.append(footSlot, settingsArea);
+
+  const doc = makeDocument([sidebar]);
+  const { pickSettingsTrigger, settingsTriggerCandidates } = loadNavHelpers(doc);
+  const cands = settingsTriggerCandidates();
+  assert.ok(!cands.includes(tokenBtn), "★ 底部槽里的 token 用量按钮必须被排除（点它会弹错窗）");
+  assert.ok(!cands.includes(entry), "我们自己的入口不能成为候选（否则点自己→再点自己）");
+  assert.equal(pickSettingsTrigger(), trigger, "★ 必须选中官方设置槽位里的齿轮，而不是 token 用量按钮");
+});
+
 test("★ 事故锁：弹层里的「通用设置」永远不能成为落点", () => {
   const { doc, general } = desktopFixture();
   const { pickSettingsTrigger, pickNavByToken } = loadNavHelpers(doc);

package/packages/dsh-remote-web/test/setup-output.test.mjs

@@ -193,3 +193,36 @@ test("★ 插件拷贝必须保留**自带的 runtime/node_modules**（ws 是桥
 function require$path() {
   return { join: (...a) => a.join("/"), sep: "/", relative: (from, to) => to.startsWith(from + "/") ? to.slice(from.length + 1) : to };
 }
+
+test("★ launchd bootout 后必须等 label 摘干净再 bootstrap（否则随机 5: Input/output error）", () => {
+  // 2026-10-11 实测：bootout 是**异步**的，紧接着 bootstrap 同一个 label 大约一半次数失败 →
+  // 失败后走 spawnDetachedBridge() 兜底 → 用户看到"⚠️ 未被系统托管 / 不会开机自启"。
+  // 手工在两条命令之间加 sleep 就 100% 成功 —— 所以这里必须有"等到摘干净"的轮询。
+  const src = readFileSync(SETUP, "utf8");
+  assert.match(src, /function waitLaunchdGone\(/, "必须有 waitLaunchdGone（等 label 从 launchd 摘干净）");
+  const start = src.indexOf("function startBridgeDarwin(");
+  const end = src.indexOf("function restartBridgeService(");
+  assert.ok(start > 0 && end > start, "应能定位 startBridgeDarwin");
+  const fn = src.slice(start, end);
+  const bootoutAt = fn.indexOf("launchctl bootout ${target}");
+  const waitAt = fn.indexOf("waitLaunchdGone(target)");
+  const bootAt = fn.indexOf("launchctl bootstrap ${domain}");
+  assert.ok(bootoutAt > 0 && waitAt > 0 && bootAt > 0, "bootout / waitLaunchdGone / bootstrap 三者都要在");
+  assert.ok(bootoutAt < waitAt && waitAt < bootAt,
+    "顺序必须是 bootout → waitLaunchdGone → bootstrap（差一步就会随机失败）");
+  // 失败重试：摘除竞态可能还没结束，要能再试一次，而不是直接掉进脱离进程兜底
+  assert.match(fn, /bootok|!boot\.ok[\s\S]{0,400}launchctl bootstrap/, "bootstrap 失败应重试一次再兜底");
+});
+
+test("★ 自启动配置里可以钉住上游（多 profile 时代，各宿主会互抢 .dsh-upstream）", () => {
+  const src = readFileSync(SETUP, "utf8");
+  assert.match(src, /function desktopAppPort\(/, "要有桌面端端口探测（lsof -c DeepSeek）");
+  assert.match(src, /PINNED_UPSTREAM/, "要有钉住上游的机制");
+  // plist 模板里必须把它写进 EnvironmentVariables（环境变量优先级高于 .dsh-upstream 文件）
+  assert.match(src, /DSH_BRIDGE_UPSTREAM<\/key><string>\$\{PINNED_UPSTREAM\}/,
+    "plist 里要写入 DSH_BRIDGE_UPSTREAM，否则两端宿主会互相覆盖上游");
+  // ⚠️ 顺序：必须在写自启动文件**之前**算出来，否则 plist 里带不上（实测踩到过）
+  const pinAt = src.indexOf("PINNED_UPSTREAM = `http://127.0.0.1:${p}`");
+  const svcAt = src.indexOf("svc = installAutostart()");
+  assert.ok(pinAt > 0 && svcAt > 0 && pinAt < svcAt, "钉定必须发生在 installAutostart() 之前");
+});