@mrrisega/dsh-remote 0.6.13 → 0.6.14

package/clients/dsh-remote/upstream-discovery.mjs

@@ -0,0 +1,292 @@
+/**
+ * 上游（dsh web）地址发现 —— **单一实现**，watcher（dsh-setup.mjs）与 bridge（dsh-bridge.mjs）共用。
+ *
+ * ## 为什么需要它
+ *
+ * 桥接链路的两端（watcher 的存活探测、bridge 的转发目标）原本把上游写死
+ * `http://127.0.0.1:3080`（独立 `dsh web` 的默认端口）。但真实世界里端口是会变的：
+ *
+ *   · `dsh web --port 8090` / profile 里配了 port / `--port 0` 让系统分配空闲端口；
+ *   · **DSH Desktop**（Electron 壳 `dsh-plugin-desktop`）默认监听 **43120**，且被占用时按 +1 递增；
+ *   · `dsh web` 重启后端口可能不同。
+ *
+ * 2026-09-23 用户实测（DSH Desktop 2.0.4 + 插件 0.6.10）：上游在 43120，而 watcher 探 3080 →
+ * **永远探不到 → bridge 永远不被派生 → 面板永久停在「正在启动 Bridge…」**，设备从未登记。
+ * 这不是"某个用户环境特殊"，而是**所有改了端口的用户**都会踩的同一类问题，所以要有通用发现。
+ *
+ * ## 发现顺序（先便宜后昂贵，每一步都做**身份校验**）
+ *
+ *   1. `DSH_BRIDGE_UPSTREAM`（显式覆盖，部署/排障用）—— 唯一不做探测就采信的来源；
+ *   2. `<relayDir>/.dsh-upstream`（**插件半**在宿主进程里用 `ctx.webServer.port` 落盘，最权威）；
+ *   3. `DSH_WEB_URL` 的端口；
+ *   4. **实测端口**：本进程的祖先进程 / 本机 dsh 进程正在 LISTEN 的端口（lsof / netstat）；
+ *   5. 静态候选：3080 + DSH Desktop 的 43120 及其递增区间。
+ *
+ * ⚠️ 第 4、5 步必须**校验身份**：43120 之类的端口可能被别的本地程序占用，
+ *    把 bridge 接到一个陌生人身上既不可用、也可能泄露数据。判据见 `looksLikeDshWeb`。
+ *
+ * ⚠️ 探测全部**并行**且有总预算：本地端口连接被拒是瞬时的，只有"端口在听但不回包"才会等到超时，
+ *    串行探 12 个候选最坏要十几秒，会让 watcher 的轮询卡住。
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+
+/** 插件半落盘的上游地址文件名（与 packages/dsh-remote-web/lib/index.js 的常量同名同义）。 */
+export const UPSTREAM_FILE = ".dsh-upstream";
+/** 独立 `dsh web` 的默认端口（历史行为，最后的兜底）。 */
+export const FALLBACK_UPSTREAM = "http://127.0.0.1:3080";
+/** DSH Desktop（Electron 壳）的默认 Web 端口；被占用时它按 +1 递增，所以要扫一段区间。 */
+export const DESKTOP_DEFAULT_PORT = 43120;
+/** Desktop 端口区间扫多少个（43120..43120+11）。 */
+export const DESKTOP_PORT_SCAN = 12;
+/** 单个候选的探测超时（本地回环，超过它基本就是"在听但不回包"）。 */
+const PROBE_TIMEOUT_MS = 900;
+
+/** 规范化：去尾斜杠；非 http(s) 一律丢弃（返回空串）。 */
+export function normalizeUpstream(value) {
+  const raw = String(value ?? "").trim();
+  if (!raw) return "";
+  if (!/^https?:\/\/[^\s]+$/i.test(raw)) return "";
+  return raw.replace(/\/+$/, "");
+}
+
+/** 从字符串里取端口（拿不到返回 0）。 */
+function portOf(value) {
+  try {
+    const n = Number(new URL(String(value)).port);
+    return Number.isInteger(n) && n > 0 ? n : 0;
+  } catch {
+    return 0;
+  }
+}
+
+/** 1) 显式环境变量。 */
+export function upstreamFromEnv(env = process.env) {
+  return normalizeUpstream(env.DSH_BRIDGE_UPSTREAM);
+}
+
+/** 2) 插件半落盘的端口文件（插件不在场/首次安装时可能没有）。 */
+export function upstreamFromFile(relayDir) {
+  if (!relayDir) return "";
+  try {
+    return normalizeUpstream(fs.readFileSync(path.join(relayDir, UPSTREAM_FILE), "utf8"));
+  } catch {
+    return "";
+  }
+}
+
+/** 3) DSH_WEB_URL 的端口（bridge 的 loopback 围栏只认 127.0.0.1，这里也统一回环地址）。 */
+export function upstreamFromDshWebUrl(env = process.env) {
+  const raw = String(env.DSH_WEB_URL || "").trim();
+  if (!raw) return "";
+  const port = portOf(raw);
+  return port ? `http://127.0.0.1:${port}` : "";
+}
+
+/**
+ * 按优先级取出"提示地址"（不做任何网络探测）。
+ * @returns {{url: string, source: "env"|"file"|"dsh_web_url"|""}}
+ */
+export function resolveUpstreamHint({ relayDir = "", env = process.env } = {}) {
+  const explicit = upstreamFromEnv(env);
+  if (explicit) return { url: explicit, source: "env" };
+  const fromFile = upstreamFromFile(relayDir);
+  if (fromFile) return { url: fromFile, source: "file" };
+  const fromWebUrl = upstreamFromDshWebUrl(env);
+  if (fromWebUrl) return { url: fromWebUrl, source: "dsh_web_url" };
+  return { url: "", source: "" };
+}
+
+// ---------- 实测端口（best effort，任何失败都只是少一个候选，绝不影响主流程） ----------
+
+function tryExec(cmd, args, timeoutMs = 4000) {
+  try {
+    return String(execFileSync(cmd, args, { encoding: "utf8", timeout: timeoutMs, stdio: ["ignore", "pipe", "ignore"] }) || "");
+  } catch {
+    return "";
+  }
+}
+
+/** 某进程正在 LISTEN 的 TCP 端口。macOS/Linux 用 lsof，Windows 用 netstat -ano。 */
+export function listeningPortsOfPid(pid, platform = process.platform) {
+  const n = Number(pid);
+  if (!Number.isInteger(n) || n <= 0) return [];
+  const ports = new Set();
+  if (platform === "win32") {
+    for (const line of tryExec("netstat", ["-ano"], 6000).split(/\r?\n/)) {
+      if (!/LISTENING/i.test(line)) continue;
+      const cols = line.trim().split(/\s+/);
+      if (cols.length < 5) continue;
+      if (Number(cols[cols.length - 1]) !== n) continue;
+      const m = /:(\d+)$/.exec(cols[1] || "");
+      if (m) ports.add(Number(m[1]));
+    }
+    return [...ports];
+  }
+  const out = tryExec("lsof", ["-nP", "-a", "-p", String(n), "-iTCP", "-sTCP:LISTEN"], 5000);
+  for (const line of out.split("\n")) {
+    const m = /:(\d+)\s*\(LISTEN\)/.exec(line);
+    if (m) ports.add(Number(m[1]));
+  }
+  return [...ports];
+}
+
+/** 祖先进程 pid（最多 6 层）：被插件/宿主拉起的 watcher、bridge 走这条路能找到宿主。 */
+export function ancestorPids(startPid = process.pid, maxDepth = 6, platform = process.platform) {
+  if (platform === "win32") return []; // Windows 无 ps；靠 netstat+pgrep 不可行，交给端口文件与静态候选
+  const out = [];
+  let pid = Number(startPid);
+  for (let i = 0; i < maxDepth; i++) {
+    const txt = tryExec("ps", ["-o", "ppid=", "-p", String(pid)], 2000).trim();
+    const ppid = Number(txt);
+    if (!Number.isInteger(ppid) || ppid <= 1) break;
+    out.push(ppid);
+    pid = ppid;
+  }
+  return out;
+}
+
+/** 本机 dsh 相关进程（pgrep）—— Desktop 壳/独立 dsh web 都可能命中。 */
+export function dshProcessPids(platform = process.platform) {
+  if (platform === "win32") return [];
+  const out = tryExec("pgrep", ["-f", "dsh"], 4000);
+  return out
+    .split(/\s+/)
+    .map((s) => Number(s))
+    .filter((n) => Number.isInteger(n) && n > 1 && n !== process.pid);
+}
+
+/**
+ * 候选列表（已去重，按"可能性"排序），每项带**来源标注**（用于日志与测试断言）。
+ * 顺序 = 提示里的端口 → 显式额外端口 → DSH_WEB_URL 的端口 → 祖先/dsh 进程实测监听端口
+ *        → 3080 → Desktop 默认端口区间。
+ * @returns {Array<{port:number, source:string}>}
+ */
+export function candidatePorts({ relayDir = "", env = process.env, extraPorts = [], platform = process.platform } = {}) {
+  const out = [];
+  const seen = new Set();
+  const push = (p, source) => {
+    const n = Number(p);
+    if (!Number.isInteger(n) || n <= 0 || n >= 65536 || seen.has(n)) return;
+    seen.add(n);
+    out.push({ port: n, source });
+  };
+  const hint = resolveUpstreamHint({ relayDir, env });
+  push(portOf(hint.url), hint.source || "hint");
+  for (const p of extraPorts) push(p, "extra");
+  push(portOf(upstreamFromDshWebUrl(env)), "dsh_web_url");
+  const pids = [...new Set([process.pid, ...ancestorPids(process.pid, 6, platform), ...dshProcessPids(platform)])];
+  for (const pid of pids) for (const p of listeningPortsOfPid(pid, platform)) push(p, "process");
+  push(3080, "static");
+  for (let i = 0; i < DESKTOP_PORT_SCAN; i++) push(DESKTOP_DEFAULT_PORT + i, "static");
+  return out;
+}
+
+// ---------- 身份校验 ----------
+
+/**
+ * 这个地址**真的**是 dsh web 吗？
+ *
+ * 为什么必须有：候选探测会去敲 43120 这类可能被别的程序占用的端口。只看"端口有响应"就把
+ * bridge 接上去，用户会得到一个"能连上但不工作"的怪状态，而且等于把这台机器的流量交给陌生服务。
+ * 判据取 dsh web 自身的稳定特征（HTML/标题/鉴权文案），任一命中即通过。
+ */
+export const DSH_WEB_MARKERS = [
+  "__ModuleLoader__",
+  "dsh-client-modules",
+  "deepseek harness",
+  "dsh web authentication required",
+  "dsh-remote"
+];
+
+export function looksLikeDshWeb(status, text) {
+  const body = String(text || "").toLowerCase();
+  if (!body) return false;
+  if (status >= 500) return false;
+  return DSH_WEB_MARKERS.some((m) => body.includes(m));
+}
+
+/**
+ * 探测一个候选：GET `/`，带身份校验。
+ * @returns {Promise<boolean>}
+ */
+export async function probeDshWeb(url, { timeoutMs = PROBE_TIMEOUT_MS, fetchImpl } = {}) {
+  const target = normalizeUpstream(url);
+  if (!target) return false;
+  const doFetch = fetchImpl || globalThis.fetch;
+  if (typeof doFetch !== "function") return false;
+  try {
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(), timeoutMs);
+    let res;
+    try {
+      // redirect: manual —— 不跟随跳转（跳走的多半不是我们要的宿主）
+      res = await doFetch(`${target}/`, { signal: ac.signal, redirect: "manual" });
+    } finally {
+      clearTimeout(timer);
+    }
+    const status = Number(res && res.status) || 0;
+    if (status >= 500) return false;
+    // 只读前 8KB 足够命中特征；读流失败按"不是"处理（宁可少一个候选，不可误接）
+    let text = "";
+    try {
+      if (res.body && typeof res.body.getReader === "function") {
+        const reader = res.body.getReader();
+        const { value } = await reader.read();
+        text = value ? Buffer.from(value).toString("utf8") : "";
+        try { await reader.cancel(); } catch { /* ignore */ }
+      } else if (typeof res.text === "function") {
+        text = await res.text();
+      }
+    } catch { /* 读失败 → text 为空 → 判否 */ }
+    return looksLikeDshWeb(status, text.slice(0, 8192));
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 发现上游地址（带身份校验）。
+ *
+ * @param {number[]} [extraPorts] 调用方已知的额外候选(排在静态候选之前;测试与特化部署用)。
+ * @returns {Promise<{url: string, source: string, probed: number[], rejected: string[]}>}
+ *          source: env | file | dsh_web_url | process | static | extra | fallback
+ */
+export async function discoverUpstream({
+  relayDir = "",
+  env = process.env,
+  timeoutMs = PROBE_TIMEOUT_MS,
+  fetchImpl,
+  platform = process.platform,
+  extraPorts = [],
+  log
+} = {}) {
+  const hint = resolveUpstreamHint({ relayDir, env });
+  // ① 显式环境变量:部署方说是什么就是什么(不探测,保持既有语义)
+  if (hint.source === "env") return { url: hint.url, source: "env", probed: [], rejected: [] };
+  // ② 提示地址先验证:文件/DSh_WEB_URL 都可能过期(宿主换端口/换了程序占用)
+  if (hint.url && (await probeDshWeb(hint.url, { timeoutMs, fetchImpl }))) {
+    return { url: hint.url, source: hint.source, probed: [portOf(hint.url)], rejected: [] };
+  }
+
+  // ③ 候选并行探测(本地端口,拒绝是瞬时的;并行是为了不让 watcher 卡住)
+  const hintPort = portOf(hint.url);
+  const entries = candidatePorts({ relayDir, env, platform, extraPorts }).filter((e) => e.port !== hintPort);
+  const results = await Promise.all(entries.map(async (e) => ({ ...e, ok: await probeDshWeb(`http://127.0.0.1:${e.port}`, { timeoutMs, fetchImpl }) })));
+  const hit = results.find((r) => r.ok);
+  if (hit) {
+    const url = `http://127.0.0.1:${hit.port}`;
+    if (typeof log === "function") log(`[upstream] 动态发现上游 ${url}（来源 ${hit.source}；提示 ${hint.url || "无"} 不可用）`);
+    return { url, source: hit.source, probed: entries.map((e) => e.port), rejected: hint.url ? [hint.url] : [] };
+  }
+
+  // ④ 都没找到:保持历史行为(3080),让上层按"上游没起来"正常重试
+  return {
+    url: hint.url || FALLBACK_UPSTREAM,
+    source: hint.url ? hint.source : "fallback",
+    probed: entries.map((e) => e.port),
+    rejected: hint.url ? [hint.url] : []
+  };
+}

package/dsh-setup.mjs

@@ -29,6 +29,7 @@ import path from "node:path";
 import { spawn, spawnSync, execSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { childStopped, stopChildGracefully } from "./clients/dsh-remote/src/lifecycle.mjs";
+import { discoverUpstream, resolveUpstreamHint, FALLBACK_UPSTREAM } from "./clients/dsh-remote/upstream-discovery.mjs";
 
 const THIS_DIR = path.dirname(fileURLToPath(import.meta.url)); // 本包目录（仓库或 node_modules）
 const IS_NPM_INSTALL = THIS_DIR.includes(`${path.sep}node_modules${path.sep}`);
@@ -779,14 +780,21 @@ function restartBridgeService() {
  * 【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）。
+ * 优先级：显式环境变量 > **运行时动态发现** > 插件半留下的端口文件 > DSH_WEB_URL > 默认 3080。
+ *
+ * 为什么还要「动态发现」这一层（2026-09-23 第二起实测，DSH Desktop）：
+ *   DSH Desktop（Electron 壳 `dsh-plugin-desktop`）默认把 Web 服务放在 **43120**，被占用还会 +1；
+ *   而端口文件要等**插件半**加载后才有。于是「端口文件还没写」或「写的是上一轮的旧端口」时，
+ *   光靠文件仍会永久探错端口。发现逻辑（含 DSH 进程实际监听端口 + Desktop 端口区间 + 身份校验）
+ *   统一在 clients/dsh-remote/upstream-discovery.mjs，watcher 与 bridge 共用同一份实现。
  */
 const UPSTREAM_FILE = ".dsh-upstream";
+/** 运行时动态发现到的上游（优于可能过期的端口文件；进程内缓存）。 */
+let discoveredUpstream = "";
 function upstreamUrl() {
   const explicit = String(process.env.DSH_BRIDGE_UPSTREAM || "").trim();
   if (explicit) return explicit.replace(/\/+$/, "");
+  if (discoveredUpstream) return discoveredUpstream;
   try {
     const fromFile = String(fs.readFileSync(path.join(CONFIG_DIR, UPSTREAM_FILE), "utf8")).trim();
     if (/^https?:\/\/[^\s]+$/i.test(fromFile)) return fromFile.replace(/\/+$/, "");
@@ -798,28 +806,69 @@ function upstreamUrl() {
       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";
+  return FALLBACK_UPSTREAM;
 }
 /** 上游端口（诊断/日志用；取不到就回退 3080）。 */
 function upstreamPort() {
   try { return Number(new URL(upstreamUrl()).port) || 3080; } catch { return 3080; }
 }
 
+/** 发现结果缓存与冷却：避免每轮轮询都去 lsof/pgrep + 逐个端口探测。 */
+let upstreamDiscoveryAt = 0;
+let upstreamDiscoveryInflight = null;
+const UPSTREAM_DISCOVERY_COOLDOWN_MS = 15_000;
+
 /**
- * dsh web 是否正在运行（默认 127.0.0.1:3080，端口以 upstreamUrl() 为准）。
- * bridge 本身依赖 dsh web 才工作：dsh web 没开时 bridge 起来也会立刻退出，
- * 所以「装完当下 bridge 没在跑」是**正常状态**，不能当失败吓用户（见 install 汇总）。
+ * 动态发现上游（带身份校验），成功后写入 `discoveredUpstream` 供全局复用。
+ * @param {boolean} force 忽略冷却（探测失败后的重试用）
  */
-async function isDshWebUp(timeoutMs = 1200) {
+async function refreshUpstreamDiscovery(force = false) {
+  if (upstreamDiscoveryInflight) return upstreamDiscoveryInflight;
+  const now = Date.now();
+  if (!force && now - upstreamDiscoveryAt < UPSTREAM_DISCOVERY_COOLDOWN_MS) return upstreamUrl();
+  upstreamDiscoveryAt = now;
+  upstreamDiscoveryInflight = (async () => {
+    try {
+      const found = await discoverUpstream({ relayDir: CONFIG_DIR, log: (m) => console.log(`[dsh-remote] ${m}`) });
+      // 「提示地址验证通过」与「候选命中」都值得记下来；fallback（什么都没找到）不污染现有判断
+      if (found.url && found.source !== "fallback") discoveredUpstream = found.url;
+      return upstreamUrl();
+    } catch {
+      return upstreamUrl();
+    } finally {
+      upstreamDiscoveryInflight = null;
+    }
+  })();
+  return upstreamDiscoveryInflight;
+}
+
+/** 上游是否**有响应**（判据刻意宽松：4xx/5xx 也算"端口在听"，那种情况问题在别处）。 */
+async function upstreamReachable(url = upstreamUrl(), timeoutMs = 1200) {
   try {
     const ac = new AbortController();
     const timer = setTimeout(() => ac.abort(), timeoutMs);
-    await fetch(upstreamUrl() + "/", { signal: ac.signal });
+    await fetch(url + "/", { signal: ac.signal });
     clearTimeout(timer);
     return true;
   } catch { return false; }
 }
 
+/**
+ * dsh web 是否正在运行（端口以 upstreamUrl() 为准，**绝不写死 3080**）。
+ * bridge 本身依赖 dsh web 才工作：dsh web 没开时 bridge 起来也会立刻退出，
+ * 所以「装完当下 bridge 没在跑」是**正常状态**，不能当失败吓用户（见 install 汇总）。
+ *
+ * 探测失败时会**主动做一次动态发现**再试一次 —— 这一条正是 DSH Desktop 场景的关键：
+ * 上游在 43120（Desktop 默认，占用还会 +1），而端口文件可能还没写或写着上一轮的旧端口。
+ */
+async function isDshWebUp(timeoutMs = 1200) {
+  if (await upstreamReachable(upstreamUrl(), timeoutMs)) return true;
+  const before = upstreamUrl();
+  const after = await refreshUpstreamDiscovery(true);
+  if (after === before) return false;
+  return upstreamReachable(after, timeoutMs);
+}
+
 /**
  * 解析 dsh web profile 目录（安装与插件管理共用同一口径）。
  */
@@ -1125,14 +1174,13 @@ async function runBridge() {
   /** 限流提示只打一次，避免刷屏。 */
   let warnedRateLimit = false;
 
-  // watcher：检测 dsh web 是否存活（端口以 upstreamUrl() 为准，绝不写死 3080），存活才启动 bridge
-  const checkUpstream = () => new Promise((resolve) => {
-    const t = setTimeout(() => resolve(false), 2000);
-    fetch(upstreamUrl() + "/")
-      .then(() => { clearTimeout(t); resolve(true); })
-      .catch(() => { clearTimeout(t); resolve(false); });
-  });
+  // watcher：检测 dsh web 是否存活（端口动态解析，绝不写死 3080），存活才启动 bridge。
+  // 走 isDshWebUp()：探测失败会自动做一次动态发现（DSH Desktop 的 43120 / 自定义端口都靠它）。
+  const checkUpstream = () => isDshWebUp(2000);
 
+  // 先做一次动态发现再打印/派生：否则日志会长期写着错误的端口（用户实测就卡在
+  // 「等待 dsh web（127.0.0.1:3080）启动...」而真实上游在 43120）。
+  await refreshUpstreamDiscovery(true);
   console.log(`[dsh-remote] 等待 dsh web（${upstreamUrl()}）启动...`);
   let bridgeProc = null;
   let starting = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrisega/dsh-remote",
-  "version": "0.6.13",
+  "version": "0.6.14",
   "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/index.js

@@ -3997,6 +3997,7 @@ function buildConnectDiagnostics(relayDir, conn, log) {
     `bridge 进程: ${conn.bridgeRunning ? "在运行" : "未运行"}（pid=${conn.bridgePids && conn.bridgePids.length ? conn.bridgePids.join(",") : "-"}，launchd state=${conn.launchdState || "-"}，崩溃循环=${conn.launchdCrashLoop ? "是" : "否"}）`,
     `后台守护: ${conn.watcherRunning ? `在运行（pid=${conn.watcherPids.join(",")}${conn.watcherAgeMs ? `，已 ${Math.round(conn.watcherAgeMs / 1000)} 秒` : ""}${conn.watcherWedged ? "，⚠️ 迟迟未拉起 bridge" : ""}${conn.watcherRestarts ? `，已自动重启 ${conn.watcherRestarts} 次` : ""}）` : "未运行"}`,
     `上游 dsh web: ${conn.upstreamUrl}（${conn.upstreamSource}${conn.upstreamReachable === null ? "" : conn.upstreamReachable ? "，可达" : `，⚠️ 不可达：${conn.upstreamError}`}）`,
+    `目录选择器: ${pickerPinState.kind === "native" ? "⚠️ 系统原生（远程时对话框弹在电脑那台机器上 → 手机上点「添加工作区」会像没反应）" : (pickerPinState.kind || "未知")}${pickerPinState.detail ? `（${pickerPinState.detail}）` : ""}`,
     `中继注册: ${conn.registered ? "已注册（" + conn.registerSource + "）" : "未注册"}`,
     `bridge 账号: ${conn.accountCurrent === false ? "⚠️ 仍是上一个账号的身份（需重启 bridge 重新登记）" : "当前账号"}`,
     conn.rateLimitedUntil ? `登录限流: 约 ${Math.ceil((conn.rateLimitedUntil - Date.now()) / 1000)} 秒后自动重试（凭据无误，无需改密码）` : "",
@@ -5894,6 +5895,100 @@ function registerRoutes(ctx, relayDir) {
  * @param ctx - host cordis context（注入 webServer）。
  * @param config - entry config（可选 relayDir）。
  */
+
+// ---------- 目录选择器：远程控制下必须用「浏览器内实现」（0.6.14） ----------
+//
+// 用户实测（Windows）：镜像页里点「添加工作区」**没反应**；同一功能在 Mac 上正常。
+//
+// 根因：官方 `directory-picker-auto` 在**绑定仅回环**且平台是 darwin/win32 时会挂
+// **原生**选择器（macOS 走 osascript，Windows 走一个 koffi + worker.cjs 子进程去弹 Win32
+// 文件夹对话框，还要合成 Alt 抢前台）。对远程控制来说这是双输：
+//   · 对话框弹在**电脑**那块屏上 —— 拿手机的人什么也看不到，表现就是"按钮无效"；
+//   · Windows 那条原生链路依赖 koffi 原生模块 + 子进程，失败点比 macOS 多得多。
+// 而 auto 只在 `webServer.host !== "127.0.0.1"` 时才改选 browse —— DSH Desktop（Electron 壳）
+// 自己持有 webserver 配置（实测监听 43120 / 回环），我们的 LAN 绑定补丁并不生效，于是它一直
+// 用的是原生那条路。**不能把"手机能不能选工作区"押在宿主的绑定地址上。**
+//
+// 做法（官方文档给的"直接合成那一对"的钉法）：在 loader 里先建起 browse 宿主+界面，
+// **成功之后**再摘掉 auto 条目（auto 的 effect 析构会连带卸掉 native 那一对）。
+//
+// 三条护栏，顺序不能改：
+//   ① 只在当前 kind === "native" 时动手；已经是 browse 就完全不碰（多数自建部署就是这样）；
+//   ② 先建 browse、后摘 auto —— browse 建不起来就什么都不做，宁可用原生也不能让选择器消失；
+//   ③ 任何失败只记日志、绝不抛给宿主（插件不能把 dsh web 拖挂）。
+// `DSH_REMOTE_NATIVE_PICKER=1` 可整体退出（想保留系统原生对话框的人）。
+const PICKER_AUTO_ENTRY_ID = "directory-picker";
+const PICKER_BROWSE_PACKAGES = [
+  "@deepseek-ai/dsh-host-directory-picker-browse",
+  "@deepseek-ai/dsh-client-ui-directory-picker-browse"
+];
+/** 最近一次固定的结果（诊断面板会显示：这类"点了没反应"的问题一眼定位）。 */
+let pickerPinState = { kind: "", action: "pending", detail: "" };
+
+/** 当前挂的是哪一路选择器（服务未就绪时返回空串）。 */
+function directoryPickerKind(ctx) {
+  try {
+    const svc = typeof ctx.get === "function" ? ctx.get("directoryPicker") : null;
+    const cap = svc && typeof svc.capability === "function" ? svc.capability() : null;
+    return cap && typeof cap.kind === "string" ? cap.kind : "";
+  } catch {
+    return "";
+  }
+}
+
+/**
+ * 把目录选择器固定成 browse（幂等）。服务要等 auto 挂完才存在，所以内部带重试窗口。
+ * @returns {Promise<{kind:string, action:string, detail:string}>}
+ */
+async function pinBrowseDirectoryPicker(ctx, { attempts = 6, gapMs = 700 } = {}) {
+  if (String(process.env.DSH_REMOTE_NATIVE_PICKER || "") === "1") {
+    pickerPinState = { kind: directoryPickerKind(ctx), action: "skipped", detail: "DSH_REMOTE_NATIVE_PICKER=1，保留系统原生对话框" };
+    return pickerPinState;
+  }
+  let loader = null;
+  try { loader = typeof ctx.get === "function" ? ctx.get("loader") : null; } catch { loader = null; }
+  if (!loader || typeof loader.create !== "function") {
+    pickerPinState = { kind: directoryPickerKind(ctx), action: "skipped", detail: "没有 loader 服务，无法干预选择器" };
+    return pickerPinState;
+  }
+  for (let i = 0; i < attempts; i += 1) {
+    const kind = directoryPickerKind(ctx);
+    if (kind === "browse") {
+      pickerPinState = { kind, action: "none", detail: "已经是浏览器内选择器" };
+      return pickerPinState;
+    }
+    if (kind === "native") {
+      const created = [];
+      try {
+        for (const name of PICKER_BROWSE_PACKAGES) created.push(await loader.create({ name }));
+      } catch (e) {
+        for (const id of [...created].reverse()) { try { await loader.remove(id); } catch { /* 尽力回滚 */ } }
+        pickerPinState = { kind, action: "kept_native", detail: `浏览器内选择器装不起来，保留原生：${e && e.message ? e.message : e}` };
+        ctx.logger?.warn?.(`dsh-remote-web: 目录选择器固定为 browse 失败，保留原生：${e && e.message ? e.message : e}`);
+        return pickerPinState;
+      }
+      try {
+        const entry = loader.store ? loader.store[PICKER_AUTO_ENTRY_ID] : null;
+        if (entry) await loader.remove(PICKER_AUTO_ENTRY_ID);
+      } catch (e) {
+        // browse 已经起来了，选择器可用；只是 auto 没摘掉（两者并存时 browse 生效即可）
+        pickerPinState = { kind: "browse", action: "pinned", detail: `已切到浏览器内选择器（auto 条目未摘除：${e && e.message ? e.message : e}）` };
+        return pickerPinState;
+      }
+      pickerPinState = {
+        kind: "browse",
+        action: "pinned",
+        detail: "原生对话框在远程时弹在电脑那台屏上（手机上看不到），已改为浏览器内选择器"
+      };
+      ctx.logger?.info?.("dsh-remote-web: 目录选择器已固定为浏览器内实现（原生对话框远程不可见）");
+      return pickerPinState;
+    }
+    await sleep(gapMs); // 服务还没挂上（auto 正在建）→ 下一轮再看
+  }
+  pickerPinState = { kind: directoryPickerKind(ctx), action: "skipped", detail: "启动窗口内未确认到选择器服务" };
+  return pickerPinState;
+}
+
 export function apply(ctx, config = {}) {
   const relayDir = config.relayDir || process.env.DSH_RELAY_DIR || DEFAULT_RELAY_DIR;
   // 记住宿主 ctx：上游地址要问 dsh web 自己的监听端口（见 upstreamUrl）。
@@ -5929,6 +6024,12 @@ export function apply(ctx, config = {}) {
   ctx.effect(() => registerRoutes(ctx, relayDir), "dsh-remote-web: /dsh-remote routes");
   // 0.1.2-rc.1+ 浏览器会话代持：换取 Harness 会话 Cookie 供 bridge 上游携带（手机点设备不再 401 白页）
   ctx.effect(() => scheduleHarnessMint(ctx, relayDir), "dsh-remote-web: harness browser-session mint");
+  // 目录选择器:远程控制下必须用浏览器内实现(否则手机点「添加工作区」像没反应) —— 见上方长注释
+  ctx.effect(() => {
+    let alive = true;
+    void pinBrowseDirectoryPicker(ctx).catch(() => { /* 绝不影响宿主 */ });
+    return () => { alive = false; void alive; };
+  }, "dsh-remote-web: pin browser directory picker");
   // 插件市场一键全功能:缺桌面运行环境则自动安装,登录后自动拉起 bridge(不依赖用户跑 npx)
   ctx.effect(() => scheduleRuntime(relayDir), "dsh-remote-web: runtime self-provision");
   // 匿名遥测：插件停摆（卸载/重载）时停掉发送心跳；磁盘队列留给下次装载补发。
@@ -5946,3 +6047,8 @@ export function apply(ctx, config = {}) {
   maybeReportInstall(relayDir);
   ctx.logger?.info?.(`dsh-remote-web: /dsh-remote routes ready (relayDir=${relayDir})`);
 }
+
+// test hooks：cordis 只读 name/inject/apply，这些导出只给用例（见 test/picker-pin.test.mjs）。
+// 为什么不放进 apply 内部直接测：apply 是"装载即副作用"的同步函数，选择器固定是异步且带重试窗口的，
+// 单独导出才能把「先建 browse、后摘 auto」这个顺序契约钉死。
+export { pinBrowseDirectoryPicker as __pinBrowseDirectoryPicker, pickerPinState as __pickerPinState, directoryPickerKind as __directoryPickerKind, PICKER_AUTO_ENTRY_ID as __PICKER_AUTO_ENTRY_ID, PICKER_BROWSE_PACKAGES as __PICKER_BROWSE_PACKAGES };

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

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-web",
-  "version": "0.6.13",
+  "version": "0.6.14",
   "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",