dsh-remote-web 0.7.10-beta.3 → 0.7.12-beta.1

package/lib/index.js

@@ -210,6 +210,38 @@ async function discoverUpstreamSelf(relayDir, { force = false } = {}) {
   return upstreamDiscoveryInFlight;
 }
 
+/**
+ * 上游地址是否已经"够用"（不需要在**响应路径里现扫**）。
+ * 【B1 · 2026-11-07】登录/首屏慢的主因之一就是在响应路径里 await 端口发现。
+ * 只要下面任一成立就够用：显式 env / 已知监听端口 / TTL 内的发现结果 / 测试隔离 / 平台模拟。
+ */
+function upstreamDiscoverySettled() {
+  // 测试钩子**最优先**（true=强制"未 settled"，false=强制"已 settled"；null=不干预）：
+  // DSH 宿主里跑测试时环境常带 DSH_WEB_URL（会被 boundWebPort 认成"已知端口"），
+  // 不放在最前面就没法模拟"端口未知、需要发现"的现场。
+  if (upstreamForceUnsettled === true) return false;
+  if (upstreamForceUnsettled === false) return true;
+  if (String(process.env.DSH_BRIDGE_UPSTREAM || "").trim()) return true;
+  if (boundWebPort()) return true;
+  if (discoveredUpstream.url && Date.now() - discoveredUpstream.at < UPSTREAM_DISCOVERY_TTL_MS) return true;
+  if (skipsSystemOps()) return true;
+  if (osPlatform() !== process.platform) return true;
+  return false;
+}
+
+/** 测试钩子：替换发现实现 / 强制"未 settled"（只给用例用，生产永远走真实实现）。 */
+let discoverImpl = discoverUpstreamSelf;
+let upstreamForceUnsettled = null;
+function setUpstreamTestState(opts = {}) {
+  if (typeof opts.discover === "function") discoverImpl = opts.discover;
+  if (typeof opts.unsettled === "boolean") upstreamForceUnsettled = opts.unsettled;
+  return { discover: discoverImpl, unsettled: upstreamForceUnsettled };
+}
+function resetUpstreamTestState() {
+  discoverImpl = discoverUpstreamSelf;
+  upstreamForceUnsettled = null;
+}
+
 /**
  * 把上游地址落盘（`<relayDir>/.dsh-upstream`），供**没有环境变量**的那些守护读取：
  * 开机自启的 watcher（Windows 登录任务 / launchd）由系统拉起，拿不到本进程的 env，
@@ -1461,7 +1493,7 @@ function writeLinuxUnit(relayDir) {
   if (!unitPath) return null;
   const setup = join(relayDir, "dsh-setup.mjs");
   const unit = `[Unit]
-Description=dsh-remote bridge (auto-starts with dsh web)
+Description=dsh-remote-web bridge (auto-starts with dsh web)
 
 [Service]
 ExecStart=${NODE_BIN} ${setup} run
@@ -1648,6 +1680,31 @@ function launchTarget() {
  */
 const NO_LAUNCHD = { running: false, pid: null, state: "", runs: null, lastExitCode: null, crashing: false };
 
+// ── B1：shell 探测短 TTL 缓存（2026-11-07 登录慢优化）─────────────────────────────
+// launchctl / ps / systemctl 每次调用都是一次进程 spawn（实测 30~120ms，慢机器更久），
+// 而状态轮询 2.5s 一次会反复重跑同一份"没变"的事实。这里给 10s TTL：
+//   · 结论按 key 缓存；**变更动作（启动/停止/卸载/账号切换）会主动清缓存**，不会让面板显示过期状态。
+const STATUS_PROBE_TTL_MS = 10 * 1000;
+const statusProbeCache = new Map();
+function memoStatusProbe(key, fn) {
+  // 测试/诊断隔离下**不缓存**：这类环境里 shell 探测是假命令/假结果（skipsSystemOps 或 DSH_TEST_*
+  // 注入的 fake PATH），缓存只会让用例互相污染（一个用例伪造的 pid/服务状态被下一个用例读到 → 假红）。
+  // 生产路径（真实 launchctl/ps）才走 10s TTL。
+  if (skipsSystemOps()) return fn();
+  try {
+    if (Object.keys(process.env).some((k) => k.startsWith("DSH_TEST_"))) return fn();
+  } catch { /* 忽略 */ }
+  const now = Date.now();
+  const hit = statusProbeCache.get(key);
+  if (hit && now - hit.at < STATUS_PROBE_TTL_MS) return hit.value;
+  const value = fn();
+  statusProbeCache.set(key, { at: now, value });
+  return value;
+}
+function clearStatusProbeCache() {
+  try { statusProbeCache.clear(); } catch { /* 忽略 */ }
+}
+
 function launchdStatus() {
   // 非 macOS 没有 launchctl（Windows 上连 process.getuid 都没有）：直接返回「无此服务」，
   // 不再去 shell 里调一个不存在的命令——这既避免 500，也避免每次轮询白起一个 cmd.exe。
@@ -2655,6 +2712,7 @@ function stopBridgeDetached(relayDir, opts = {}) {
 
 /** 启动 bridge：确保运行环境就绪 + plist 存在 → launchctl bootstrap（回退 load -w）。 */
 function startBridge(relayDir) {
+  clearStatusProbeCache(); // B1：状态变更 → 立刻作废 shell 探测缓存，避免显示过期状态
   if (UNINSTALLED_DIRS.has(relayDir)) {
     // 已彻底卸载：面板/自愈在重启前可能仍在内存中，禁止再把自启动与 plist 拉回来
     return { ok: false, status: "uninstalled", detail: "插件已彻底卸载，重启 dsh web 后生效" };
@@ -2872,6 +2930,7 @@ const lastSelfhealReadyLine = new Map();
 
 /** 停止 bridge：macOS 走 launchctl bootout；Linux 走 systemd/脱离进程；Windows 结束 watcher/bridge 进程。 */
 function stopBridge(relayDir) {
+  clearStatusProbeCache(); // B1：状态变更 → 立刻作废 shell 探测缓存，避免显示过期状态
   if (isWindows()) return stopBridgeDetached(relayDir);
   // 测试隔离：置位时绝不对真实 launchd/systemd 下手（切换账号也会走到这里，
   // 少了这一条，用例就会去 bootout 开发者本机上真实运行的 bridge —— 实测过的污染风险）。
@@ -4008,8 +4067,9 @@ function maskPhone(p) {
 
 async function composeStatus(relayDir) {
   const cfg = loadConfig(relayDir);
-  const launchd = launchdStatus();
-  const manual = manualStatus(relayDir);
+  // B1：同样的 10s 缓存（状态轮询时不重复 spawn launchctl/ps）。
+  const launchd = memoStatusProbe("launchd", launchdStatus);
+  const manual = memoStatusProbe("manual:" + relayDir, () => manualStatus(relayDir));
   // 注册/绑定失败提示(bridge 写 .bind-error.json;面板据此展示“已达上限/需解绑”引导)
   let bindError = null;
   try {
@@ -5704,12 +5764,18 @@ async function accountDeviceBound(relayDir, cfg) {
  */
 async function composeConnect(relayDir, opts = {}) {
   const cfg = opts.cfg || loadConfig(relayDir);
-  // 【0.6.15】上游端口问不出来时，先主动发现一次再算阶段：否则诊断里永远是"3080 不可达"，
-  // 而用户的 dsh web 其实好好地跑在 2298（飞牛/NAS 实测）—— 面板与用户都会往"改端口"这个
-  // 错误方向使劲。发现很快（本机回环，全失败也就几百毫秒），失败不影响任何既有行为。
-  await discoverUpstreamSelf(relayDir).catch(() => FALLBACK_UPSTREAM);
-  const launchd = opts.launchd || launchdStatus();
-  const manual = opts.manual || manualStatus(relayDir);
+  // 【B1 · 2026-11-07 登录慢优化】端口发现**绝不再阻塞状态/登录响应**：
+  //   · 已有可用结论（显式 env / 已知监听端口 / TTL 内的发现结果 / 测试隔离）→ 直接用；
+  //   · 否则**放后台**跑（void），本次先用 hint/回退地址把状态返回 —— 首屏不再等信息；
+  //     发现完成后的结果会在下一次状态轮询自然带上（面板每 2.5~30s 轮询，无需推送）。
+  //   旧实现的 await 会把 lsof/netstat + 数百端口探测整个塞进首屏路径（业主实测 7~8 秒）。
+  const discoverySettled = upstreamDiscoverySettled();
+  if (!discoverySettled) {
+    void discoverImpl(relayDir).catch(() => FALLBACK_UPSTREAM);
+  }
+  // B1：这两次 shell 探测走 10s TTL 缓存（见 memoStatusProbe）；变更动作会清缓存。
+  const launchd = opts.launchd || memoStatusProbe("launchd", launchdStatus);
+  const manual = opts.manual || memoStatusProbe("manual:" + relayDir, () => manualStatus(relayDir));
   const book = connectBook(relayDir);
   const now = Date.now();
   const hasAcct = hasAccountCreds(cfg);
@@ -5958,6 +6024,8 @@ async function composeConnect(relayDir, opts = {}) {
     selfhealExhausted: selfhealGuardOf(relayDir).count >= SELFHEAL_MAX_RESTARTS,
     upstreamUrl: upstreamUrl(),
     upstreamSource: upstreamSourceLabel(),
+    // B1：这次响应是否"端口发现还没完成、已放后台跑"（只作诊断/文案；下一次轮询会自然收敛）
+    discoveryPending: Boolean(!discoverySettled),
     // 宿主形态：桌面端（Electron）与 Web 版（node）在若干动作上语义不同 ——
     // 最典型的是「重启 DeepSeek harness」在桌面端做不到也不该做（Host 由 Electron 托管，
     // 强行退出会弹原生致命错误）。面板据此改文案/去掉无意义的按钮，而不是等用户点了才失败。
@@ -7542,7 +7610,275 @@ export function localRequestBlocked(req) {
   return null;
 }
 
-function registerRoutes(ctx, relayDir) {
+// ═══════════════════════ 🤖 IM 机器人通道（2026-11-07，企业微信智能机器人）═══════════════════════
+//
+// 面板「通知与消息通道」弹层背后的三条本地 API。它**不是**原来那条「微信机器人扫码绑定」通道
+// （那条跑在 bridge 的 wechat-runtime 里，见 /dsh-remote/wechat/*），而是「用企业微信/飞书机器人的
+// 凭据让桥主动推送消息」的第二种通道，配置面就两个文件（契约与桥半约定，字段名**不要改**）：
+//
+//   <relayDir>/im-bots.json        插件写、桥读
+//     { version:1, wecom:{ enabled, botId, secret, url, targetChatId, sessionId, sessionTitle, previewCardAt } }
+//     previewCardAt：**发送预览卡片**的触发时间戳（ms；插件写、桥读，值变大桥就发一张预览审批卡）
+//   <relayDir>/im-bot-status.json  桥写、插件**只读**
+//     { updatedAt, wecom:{ enabled, connected, authenticated, lastError,
+//                          lastConnectedAt, lastMessageAt, boundChatId } }
+//
+// 安全边界（本文件里凡是下发给浏览器的字段都要过这里）：
+//   · **secret 永不返回浏览器**（GET/PUT/测试结果里只给 hasSecret:boolean）；
+//   · 配置文件按 0600 写 + 临时文件原子替换（半写文件会让桥读到坏 JSON → 通道静默失效）；
+//   · 状态文件是桥写的，插件只挑白名单字段转发，绝不整份透传（防止未来桥塞进敏感字段被带出去）。
+//
+// 三条 API：
+//   GET  /dsh-remote/im-bots               → {ok, wecom:{enabled,botId,hasSecret,url,targetChatId,sessionId,sessionTitle}, status}
+//   PUT  /dsh-remote/im-bots (body {...})  → 同上（保存后立刻回读；空 secret = 不修改）
+//   POST /dsh-remote/im-bots/test          → 写配置后轮询状态 ≤10s，回 {ok, connected, authenticated, lastError}
+// 失败一律人话 + 稳定错误码：invalid_bot_id / missing_secret / connect_failed / timeout（外加 invalid_url / bad_request）。
+const IM_BOTS_FILE = "im-bots.json";
+const IM_BOT_STATUS_FILE = "im-bot-status.json";
+/** POST test 最多等多久（桥真正连上企业微信是异步的；10s 是 task 契约）。可用 config.imBotsWaitMs 覆盖（测试用）。 */
+const IM_BOT_STATUS_WAIT_MS = 10_000;
+const IM_BOT_STATUS_POLL_MS = 300;
+/** 企业微信智能机器人的 Bot ID 形如 `aib...`（用户抄错时当场给可理解的错误，而不是存下去然后一直连不上）。 */
+const WECOM_BOT_ID_RE = /^aib[A-Za-z0-9_-]{3,}$/;
+const IM_BOT_URL_RE = /^https?:\/\/[^\s]+$/i;
+
+function imBotsPathOf(relayDir) { return join(relayDir, IM_BOTS_FILE); }
+function imBotStatusPathOf(relayDir) { return join(relayDir, IM_BOT_STATUS_FILE); }
+
+/** 读一个 JSON 文件；不存在/半写/坏 JSON 一律当空对象（通道没配 ≠ 面板报错）。 */
+function readJsonFileSoft(file) {
+  try {
+    const raw = readFileSync(file, "utf8");
+    const v = JSON.parse(raw);
+    return v && typeof v === "object" && !Array.isArray(v) ? v : {};
+  } catch { return {}; }
+}
+
+function readImBots(relayDir) { return readJsonFileSoft(imBotsPathOf(relayDir)); }
+function readImBotStatus(relayDir) { return readJsonFileSoft(imBotStatusPathOf(relayDir)); }
+
+/** 归一化 wecom 配置（读的时候也归一，桥手工编辑过/旧版本文件都不会让面板崩）。 */
+function wecomCfgOf(bots) {
+  const w = bots && bots.wecom && typeof bots.wecom === "object" ? bots.wecom : {};
+  return {
+    enabled: !!w.enabled,
+    botId: typeof w.botId === "string" ? w.botId : "",
+    secret: typeof w.secret === "string" ? w.secret : "",
+    url: typeof w.url === "string" ? w.url : "",
+    targetChatId: typeof w.targetChatId === "string" ? w.targetChatId : "",
+    // 「转接到哪个会话」：空串 = 跟随当前活跃会话（桥侧默认）。
+    sessionId: typeof w.sessionId === "string" ? w.sessionId : "",
+    sessionTitle: typeof w.sessionTitle === "string" ? w.sessionTitle : "",
+    // 「发送预览卡片」触发时间戳：插件写、桥读；0/缺失 = 从未触发过。
+    previewCardAt: Number.isFinite(Number(w.previewCardAt)) && Number(w.previewCardAt) > 0 ? Number(w.previewCardAt) : 0,
+  };
+}
+
+/** 状态文件只转发白名单字段（桥以后往里塞什么都带不出去）。 */
+function wecomStatusOf(status) {
+  const w = status && status.wecom && typeof status.wecom === "object" ? status.wecom : {};
+  const num = (v) => (typeof v === "number" && Number.isFinite(v) ? v : 0);
+  const str = (v) => (typeof v === "string" ? v : "");
+  return {
+    enabled: !!w.enabled,
+    connected: !!w.connected,
+    authenticated: !!w.authenticated,
+    lastError: str(w.lastError),
+    lastConnectedAt: num(w.lastConnectedAt),
+    lastMessageAt: num(w.lastMessageAt),
+    boundChatId: str(w.boundChatId),
+    // ── 会话可选绑定（2026-11-07，字段名与桥约定死，不要改）──
+    // 只挑 id/title/updatedAt 三个字段、最多 50 条、title 截到 200 字：
+    // 状态文件是桥写的，插件没权利把它整份原样吐给浏览器（可能越来越大/带内部字段）。
+    activeSessionId: str(w.activeSessionId),
+    activeSessionTitle: str(w.activeSessionTitle),
+    boundSessionId: str(w.boundSessionId),
+    // 「上次预览卡片」已处理到的时间戳（桥写；面板只用来显示「上次预览：HH:MM」）
+    lastPreviewCardAt: num(w.lastPreviewCardAt),
+    // ── 会员档位 / 额度（2026-11-07 桥侧新增，字段名锁死；只白名单，不整包吐）──
+    // tier 只认三个枚举值；拿不到就是空串（面板据此**不渲染**档位条，绝不猜）。
+    tier: (() => {
+      const t = str(w.tier);
+      return (t === "free" || t === "pro" || t === "pro_max") ? t : "";
+    })(),
+    // caps 是字符串数组：逐个转字符串 + 截断 + 上限 50 条（桥以后往里塞对象也别透出去）
+    caps: (Array.isArray(w.caps) ? w.caps : []).slice(0, 50).map((c) => str(c).slice(0, 80)).filter(Boolean),
+    capsCount: num(w.capsCount),
+    bindingGated: !!w.bindingGated,
+    messagesPerMonth: num(w.messagesPerMonth),
+    // null = 不限或未知（**必须和 0 区分**：0 条剩余 ≠ 不限量）
+    remainingMessages: typeof w.remainingMessages === "number" && Number.isFinite(w.remainingMessages) ? w.remainingMessages : null,
+    usage: (() => {
+      const u = w.usage && typeof w.usage === "object" ? w.usage : null;
+      if (!u) return null;
+      return { month: str(u.month), messages: num(u.messages) };
+    })(),
+    sessions: (Array.isArray(w.sessions) ? w.sessions : []).slice(0, 50).map(function (it) {
+      const o = it && typeof it === "object" ? it : {};
+      return {
+        id: str(o.id),
+        title: str(o.title).slice(0, 200),
+        updatedAt: num(o.updatedAt),
+      };
+    }).filter(function (it) { return !!it.id; }),
+  };
+}
+
+/**
+ * 原子写 im-bots.json（0600）。
+ * 为什么 tmp + rename：桥是**另一个进程**，写一半被读到就是坏 JSON；rename 在同一目录内是原子的。
+ */
+function writeImBots(relayDir, data) {
+  mkdirSync(relayDir, { recursive: true });
+  const file = imBotsPathOf(relayDir);
+  const tmp = `${file}.dsh-remote.tmp`;
+  writeFileSync(tmp, JSON.stringify(data, null, 2) + "\n", { mode: 0o600 });
+  try { hardenFile(tmp); } catch { /* Windows ACL 失败不致命 */ }
+  try { chmodSync(tmp, 0o600); } catch { /* 非 POSIX 忽略 */ }
+  renameSync(tmp, file);
+  try { chmodSync(file, 0o600); } catch { /* 忽略 */ }
+}
+
+/** 面板可见的通道状态（GET/PUT 共用同一个形状；**绝不含 secret**）。 */
+function imBotsView(relayDir) {
+  const bots = readImBots(relayDir);
+  const w = wecomCfgOf(bots);
+  const stFile = readImBotStatus(relayDir);
+  return {
+    ok: true,
+    wecom: {
+      enabled: w.enabled,
+      botId: w.botId,
+      hasSecret: w.secret.length > 0,
+      url: w.url,
+      targetChatId: w.targetChatId,
+      sessionId: w.sessionId,
+      sessionTitle: w.sessionTitle,
+    },
+    status: wecomStatusOf(stFile),
+    updatedAt: typeof stFile.updatedAt === "number" ? stFile.updatedAt : 0,
+  };
+}
+
+/**
+ * 保存 wecom 配置（PUT 与 POST test 共用；纯校验 + 写盘，不碰网络）。
+ * @returns {{ok:true}|{ok:false, code:string, message:string}}
+ */
+function saveWecomConfig(relayDir, input) {
+  const src = input && typeof input === "object" ? input : {};
+  const bots = readImBots(relayDir);
+  const cur = wecomCfgOf(bots);
+
+  // 只认契约字段；其余平台（feishu 等）与未知字段原样保留 —— 插件不认识它们，但没有权利删掉。
+  const next = {
+    enabled: cur.enabled,
+    botId: cur.botId,
+    secret: cur.secret,
+    url: cur.url,
+    targetChatId: cur.targetChatId,
+    sessionId: cur.sessionId,
+    sessionTitle: cur.sessionTitle,
+    previewCardAt: cur.previewCardAt,
+  };
+
+  if (Object.prototype.hasOwnProperty.call(src, "botId")) {
+    const botId = String(src.botId ?? "").trim();
+    if (botId && !WECOM_BOT_ID_RE.test(botId)) {
+      return { ok: false, code: "invalid_bot_id", message: "Bot ID 格式不对：应形如 aibxxxxxxxx（在企业微信「智能机器人」页面复制）" };
+    }
+    next.botId = botId;
+  }
+  if (Object.prototype.hasOwnProperty.call(src, "secret")) {
+    const secret = typeof src.secret === "string" ? src.secret.trim() : "";
+    // 空字符串 = **不修改**（面板不回显 secret，用户只改 Bot ID 时不该被迫重填）
+    if (secret) next.secret = secret;
+  }
+  if (Object.prototype.hasOwnProperty.call(src, "url")) {
+    const url = String(src.url ?? "").trim();
+    if (url && !IM_BOT_URL_RE.test(url)) {
+      return { ok: false, code: "invalid_url", message: "服务地址必须以 http:// 或 https:// 开头" };
+    }
+    next.url = url;
+  }
+  if (Object.prototype.hasOwnProperty.call(src, "targetChatId")) {
+    const cid = String(src.targetChatId ?? "").trim();
+    if (cid.length > 200) return { ok: false, code: "invalid_target_chat_id", message: "接收会话 ID 过长（最多 200 字）" };
+    next.targetChatId = cid;
+  }
+  if (Object.prototype.hasOwnProperty.call(src, "sessionId")) {
+    const sid = String(src.sessionId ?? "").trim();
+    if (sid.length > 200) return { ok: false, code: "invalid_session_id", message: "会话 ID 过长（最多 200 字）" };
+    // 空串 = **跟随当前活跃会话** → 同时清掉标题（保留一个"孤零零的标题"只会让 UI 说错话）
+    next.sessionId = sid;
+    next.sessionTitle = sid ? String(src.sessionTitle ?? "").trim().slice(0, 200) : "";
+  }
+  if (Object.prototype.hasOwnProperty.call(src, "previewCardAt")) {
+    // 触发信号：必须是数字/可转数字（前端传 Date.now()）。非法值直接拒绝，绝不写进文件 ——
+    // 桥只认"数字变大"，写个 NaN 进去会让这条信号永久失效且很难排查。
+    const n = Number(src.previewCardAt);
+    if (!Number.isFinite(n) || n <= 0) {
+      return { ok: false, code: "invalid_preview_card_at", message: "预览卡片触发时间戳必须是正整数（毫秒）" };
+    }
+    next.previewCardAt = Math.floor(n);
+  }
+  if (Object.prototype.hasOwnProperty.call(src, "enabled")) next.enabled = !!src.enabled;
+  else if (!next.enabled && next.botId && next.secret) next.enabled = true; // 首次保存凭据 = 想让它生效
+
+  // 凭据完整性：Bot ID 与 Secret 缺一不可（secret 允许"沿用已保存的"，但最终必须存在）。
+  // 不做"只存 Bot ID、enabled=false"的半截配置 —— 那种文件桥读起来只会静默失效，用户以为配好了。
+  if (!next.botId) {
+    return { ok: false, code: "invalid_bot_id", message: "请先填写 Bot ID（在企业微信「智能机器人」页面复制，形如 aibxxxxxxxx）" };
+  }
+  if (!next.secret) {
+    return { ok: false, code: "missing_secret", message: "请先填写 Secret（企业微信智能机器人页面生成的密钥，只保存在本机）" };
+  }
+
+  const out = { ...bots, version: 1, wecom: next };
+  try {
+    writeImBots(relayDir, out);
+    return { ok: true };
+  } catch (e) {
+    return { ok: false, code: "write_failed", message: `配置保存失败：${e?.message || e}` };
+  }
+}
+
+/**
+ * POST /dsh-remote/im-bots/test：保存（若带凭据）→ 轮询桥写的状态文件 ≤ waitMs。
+ * 返回面板直接可渲染的结论：连接中 / 已连接 / 失败原因（桥的 lastError 原文照登）。
+ */
+async function imBotsTest(relayDir, waitMs, input) {
+  const hasInput = input && typeof input === "object" && Object.keys(input).length > 0;
+  if (hasInput) {
+    const saved = saveWecomConfig(relayDir, input);
+    if (!saved.ok) return { httpCode: 400, body: { ok: false, error: saved.code, message: saved.message } };
+  }
+  const w = wecomCfgOf(readImBots(relayDir));
+  if (!w.secret) {
+    return { httpCode: 400, body: { ok: false, error: "missing_secret", message: "还没有保存 Secret：请先填写并保存（Secret 只保存在本机）" } };
+  }
+  const startedAt = Date.now();
+  const total = Math.max(200, Number(waitMs) || IM_BOT_STATUS_WAIT_MS);
+  let last = wecomStatusOf(readImBotStatus(relayDir));
+  while (Date.now() - startedAt < total) {
+    if (last.connected) {
+      return { httpCode: 200, body: { ok: true, connected: true, authenticated: !!last.authenticated, lastError: last.lastError || "" } };
+    }
+    await new Promise((r) => { const t = setTimeout(r, IM_BOT_STATUS_POLL_MS); try { t.unref?.(); } catch { /* 忽略 */ } });
+    last = wecomStatusOf(readImBotStatus(relayDir));
+    if (last.lastError && !last.connected) break; // 桥已经明确报错：不用傻等到超时
+  }
+  if (last.connected) {
+    return { httpCode: 200, body: { ok: true, connected: true, authenticated: !!last.authenticated, lastError: last.lastError || "" } };
+  }
+  if (last.lastError) {
+    return { httpCode: 502, body: { ok: false, error: "connect_failed", lastError: last.lastError, message: `连接失败：${last.lastError}` } };
+  }
+  return { httpCode: 504, body: { ok: false, error: "timeout", message: "等待桥连接超时（10 秒内没有收到连接结果）。请确认电脑端 Bridge 在运行，然后重试。" } };
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════════════════════════
+
+function registerRoutes(ctx, relayDir, opts = {}) {
   // 本插件所在 profile：与配对备份的持久数据目录共用同一份推导（pluginProfileDir），
   // 避免"卸载删的目录"和"备份写的目录"各算各的（2026-10-17 双份备份加固时抽出）。
   const profileDir = pluginProfileDir();
@@ -8040,7 +8376,26 @@ function registerRoutes(ctx, relayDir) {
         const bridgeRestart = startBridge(relayDir);
         // 登录成功即上报本机安装信息（企业端用于「升级插件后刷新版本号」约定）；失败静默。
         maybeReportInstall(relayDir, { force: true });
-        sendJson(res, 200, { ok: true, bridgeRestart, ...(await composeStatus(relayDir)) });
+        // 【B2 · 2026-11-07】登录响应**立即返回**：旧实现 `...(await composeStatus())` 会把
+        // 端口发现 / launchctl+ps / 中继探测全塞进登录路径（业主实测 7~8 秒）。
+        // 这里只回"保存成功 + bridge 重启结果 + 最小配置回显"，衍生信息由面板登录后异步拉
+        // （GET /dsh-remote/status & /bridge-status），UI 已经先切到已登录态。
+        const cfgEcho = loadConfig(relayDir);
+        sendJson(res, 200, {
+          ok: true,
+          bridgeRestart,
+          statusPending: true,
+          config: {
+            phone: maskPhone(cfgEcho.phone || ""),
+            hasPhone: Boolean(cfgEcho.phone),
+            hasPassword: Boolean(cfgEcho.password),
+            deviceId: cfgEcho.device_id || "",
+            apiUrl: cfgEcho.api_url || DEFAULT_API,
+            mode: cfgEcho.local_key ? "local" : "saas",
+            selfHostUrl: cfgEcho.tunnel_url ? String(cfgEcho.tunnel_url).replace(/^wss?:\/\//, "").replace(/\/+$/, "") : "",
+            hasLocalKey: Boolean(cfgEcho.local_key)
+          }
+        });
       },
     },
     {
@@ -8337,6 +8692,50 @@ function registerRoutes(ctx, relayDir) {
         await proxyCommunityInvite(relayDir, req, res, url.pathname);
       },
     },
+    // 🤖 IM 机器人通道（2026-11-07）：面板「通知与消息通道」弹层的数据面。
+    //   与其它 /dsh-remote/* 一样只在本机 webserver 上注册（跨站请求已被 localRequestBlocked 挡掉）。
+    //   ⚠️ secret 永不返回浏览器 —— 三个响应里都只有 hasSecret / lastError 这类非敏感字段。
+    // ⚠️ 用**一条** ALL 路由在 handler 内按 req.method 分发：webserver 的注册是按 path 的，
+    //    同一个 path 注册两条（GET/PUT）只会有一条生效 —— 那是 2026-11-07 本地实测踩到的坑
+    //    （面板保存打到了 GET 上，看着"没报错但没保存"）。feedback/announcements 用 prefix 同理。
+    {
+      method: "ALL",
+      path: "/dsh-remote/im-bots",
+      handler: async (req, res) => {
+        const method = String(req.method || "GET").toUpperCase();
+        if (method === "GET") {
+          sendJson(res, 200, imBotsView(relayDir));
+          return;
+        }
+        if (method !== "PUT") {
+          sendJson(res, 405, { ok: false, error: "method_not_allowed", message: "只支持 GET / PUT" });
+          return;
+        }
+        const body = await readJsonBody(req);
+        if (body.__parseError) return sendJson(res, 400, { ok: false, error: "bad_request", message: "请求体不是合法 JSON" });
+        const wecom = body && typeof body.wecom === "object" && body.wecom ? body.wecom : null;
+        if (!wecom) return sendJson(res, 400, { ok: false, error: "bad_request", message: "缺少 wecom 配置" });
+        const saved = saveWecomConfig(relayDir, wecom);
+        if (!saved.ok) return sendJson(res, 400, { ok: false, error: saved.code, message: saved.message });
+        sendJson(res, 200, imBotsView(relayDir));
+      },
+    },
+    {
+      method: "ALL",
+      path: "/dsh-remote/im-bots/test",
+      handler: async (req, res) => {
+        const method = String(req.method || "GET").toUpperCase();
+        if (method !== "POST") {
+          sendJson(res, 405, { ok: false, error: "method_not_allowed", message: "只支持 POST" });
+          return;
+        }
+        const body = await readJsonBody(req);
+        // body 可选：不传 = 只测**已保存**的配置；传 = 先保存再测（与面板「保存并连接」一次点完一致）
+        const wecom = body && !body.__parseError && typeof body.wecom === "object" && body.wecom ? body.wecom : null;
+        const r = await imBotsTest(relayDir, opts.imBotsWaitMs, wecom);
+        sendJson(res, r.httpCode, r.body);
+      },
+    },
   ];
 
   const disposers = [];
@@ -8680,7 +9079,10 @@ export function apply(ctx, config = {}) {
     markRestartPending(relayDir, "refresh", "插件已更新，刷新页面即可生效");
     ctx.logger?.info?.("dsh-remote-web: 插件文件晚于本次进程启动 → 提示刷新页面");
   }
-  ctx.effect(() => registerRoutes(ctx, relayDir), "dsh-remote-web: /dsh-remote routes");
+  ctx.effect(() => registerRoutes(ctx, relayDir, {
+    // 测试钩子：POST /dsh-remote/im-bots/test 的等待上限（默认 10s，见 imBotsTest 注释）。
+    imBotsWaitMs: Number(config.imBotsWaitMs) || undefined,
+  }), "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");
   // 目录选择器:远程控制下必须用浏览器内实现(否则手机点「添加工作区」像没反应) —— 见上方长注释
@@ -8728,6 +9130,11 @@ export { pinBrowseDirectoryPicker as __pinBrowseDirectoryPicker, schedulePickerP
   setupStateOf as __setupStateOf, ensureConnection as __ensureConnection,
   // 设备超额锁定（契约 §8）：面板文案 / 插件半设备绑定退避都要能被单测钉住
   composeConnect as __composeConnect, readBindError as __readBindError, bindFailGate as __bindFailGate,
+  // B1（2026-11-07 登录慢）：端口发现是否阻塞、shell 探测 TTL 缓存、状态组装都要能被单测钉住
+  composeStatus as __composeStatus, launchdStatus as __launchdStatus,
+  clearStatusProbeCache as __clearStatusProbeCache, upstreamDiscoverySettled as __upstreamDiscoverySettled,
+  setUpstreamTestState as __setUpstreamTestState, resetUpstreamTestState as __resetUpstreamTestState,
+  STATUS_PROBE_TTL_MS as __STATUS_PROBE_TTL_MS,
   bindFailSignatureOf as __bindFailSignatureOf, isPermanentBindFailure as __isPermanentBindFailure,
   bindCapBackoffMs as __bindCapBackoffMs, connectBook as __connectBook, noteBindFailAttempt as __noteBindFailAttempt,
   DEVICE_BIND_CAP_EXIT_CODE as __DEVICE_BIND_CAP_EXIT_CODE, BIND_CAP_BACKOFF_MAX_MS as __BIND_CAP_BACKOFF_MAX_MS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-web",
-  "version": "0.7.10-beta.3",
+  "version": "0.7.12-beta.1",
   "description": "公网远程控制 DeepSeek Harness（dsh web）：安装即得专属加密地址，人在外面也能用手机访问电脑上的 dsh——无需同一局域网/WiFi、无需公网 IP 与内网穿透，全程加密；手机端 100% 还原电脑体验（对话/工具/审批/设置）。技术用户可选自建服务，流量走自己的服务器。Remote control DeepSeek Harness (dsh web) from anywhere over the public internet — install, get an encrypted URL, use it from your phone on any network (dual-half cordis plugin: Settings panel + same-origin /dsh-remote routes). (2026-09 由 dsh-remote-ui 更名 / renamed from dsh-remote-ui; dsh-remote 的 dsh web 插件半，不是纯 UI/皮肤插件)",
   "type": "module",
   "main": "lib/index.js",