@modelzen/feishu-codex-bridge 0.3.0-win.1 → 0.3.1

package/README.md

@@ -33,7 +33,7 @@
 - **私聊控制台**：私聊机器人弹交互菜单 —— 新建项目、项目列表、设置、诊断、重连。
 - **稳定隔离**：每会话独立 app-server 进程；卡死有 watchdog（默认 120s）→ 终止 → 回收，异常不波及其他群。
 - **本地加密密钥库**：飞书应用密钥用 AES-256-GCM 存在 `~/.feishu-codex-bridge/`，不入仓库、不进环境变量。
-- **可常驻**：macOS 下可注册成 launchd 后台服务，开机自启。
+- **跨平台常驻**：macOS / Windows / Linux·WSL 均可注册成后台服务、开机或登录自启（分别走 launchd / 登录自启免管理员 / systemd）。
 
 ---
 
@@ -41,6 +41,7 @@
 
 | 依赖 | 说明 | 获取方式 |
 |------|------|----------|
+| **操作系统** | **macOS / Windows** 均支持；Linux·WSL 为 best-effort（已实现 systemd，未广泛实测） | — |
 | **Node.js ≥ 20** | 运行时 | <https://nodejs.org> 或 `nvm install 20` |
 | **Codex CLI** | 后端，bridge 会 spawn `codex app-server` | `npm i -g @openai/codex`，或装 Codex.app，或用 `CODEX_BIN` 指向已有二进制 |
 | **Codex 已登录** | app-server 需要 `~/.codex/auth.json` | `codex login` |
@@ -78,7 +79,7 @@ feishu-codex-bridge run
 ### 3. 后台 daemon（`start` —— 日常这么跑）
 
 ```bash
-feishu-codex-bridge start      # 装 launchd 并启动：开机自启、崩溃自动拉起、关终端照跑
+feishu-codex-bridge start      # 装系统后台服务并启动：开机/登录自启、崩溃自动拉起、关终端照跑
 feishu-codex-bridge status     # 状态 / pid / 日志路径 / 上次退出码
 feishu-codex-bridge logs -f    # 跟踪日志
 feishu-codex-bridge restart    # 重启
@@ -90,7 +91,9 @@ feishu-codex-bridge update     # 更新到最新版（npm i -g）并自动重启
 
 `start` 会**先在当前终端完成 init**（没配置则扫码），并**阻塞到授权完成**——权限全部开通、且你确认已订阅事件/发布版本——才真正装服务，绝不会装一个收不到消息的空壳。daemon 体跑的就是 `run`。
 
-> ⚠️ **后台 daemon 必须全局安装（`npm i -g`），不要用 npx**：launchd plist 里硬编码了 CLI 路径，而 npx 的临时缓存（`~/.npm/_npx/...`）会被清理，缓存一没服务就起不来。前台 `run` 用 npx 没问题（单次进程）。
+> 🖥 **各平台后台机制**：macOS = launchd 用户服务；**Windows = 登录自启（写 `HKCU\…\Run`，隐藏启动，全程免管理员）**；Linux·WSL = systemd 用户单元（`systemctl --user`，需要 `loginctl enable-linger` 才能登出后续跑；WSL 还需在 `/etc/wsl.conf` 开 `[boot] systemd=true`，否则用前台 `run`）。三者命令一致（`start`/`status`/`stop`/`restart`/`logs`），状态/日志路径统一。
+
+> ⚠️ **后台服务必须全局安装（`npm i -g`），不要用 npx**：服务里硬编码了 CLI 路径，而 npx 的临时缓存（`~/.npm/_npx/...`）会被清理，缓存一没服务就起不来。前台 `run` 用 npx 没问题（单次进程）。
 
 ### 4. 多飞书机器人（可选）
 
@@ -198,7 +201,7 @@ feishu-codex-bridge bot rm <名>     # 移除一个机器人配置
 
 ```
 feishu-codex-bridge run                前台启动（没配置先扫码 init；Ctrl+C 优雅退出）
-feishu-codex-bridge start              后台 daemon 启动（装 launchd 开机自启；阻塞到授权完成）
+feishu-codex-bridge start              后台 daemon 启动（装系统后台服务、开机/登录自启；阻塞到授权完成）
 feishu-codex-bridge stop|restart|status|logs   后台 daemon 生命周期
 feishu-codex-bridge update             更新到最新版并自动重启 daemon（--check 只查不装）
 feishu-codex-bridge bot init|list|use|rm       多飞书机器人：注册 / 列表 / 切当前 / 移除
@@ -229,7 +232,7 @@ src/
   config/     加密密钥库、密钥解析、配置存储、多机器人注册表、scope 清单、路径
   core/       watchdog、单实例锁、日志
   cli/        commander 命令（run / start / stop / restart / status / logs / update / bot / doctor / secrets）
-  service/    launchd 后台服务
+  service/    后台服务适配器（launchd / Windows 登录自启 / systemd）+ 跨平台 spawn
 ```
 
 架构与实现细节见 [`docs/design/feishu-codex-bridge-design.md`](docs/design/feishu-codex-bridge-design.md) 与 [`docs/design/implementation-plan.md`](docs/design/implementation-plan.md)。

package/dist/cli.js

@@ -228,6 +228,21 @@ function findBot(reg, nameOrAppId) {
 function currentBot(reg) {
   return reg.current ? reg.bots.find((b) => b.appId === reg.current) : void 0;
 }
+function activeBots(reg) {
+  const configured = reg.bots.some((b) => b.active !== void 0);
+  if (configured) return reg.bots.filter((b) => b.active === true);
+  const cur = currentBot(reg);
+  return cur ? [cur] : [];
+}
+async function setActiveBots(appIds) {
+  const reg = await loadBots();
+  const want = new Set(appIds);
+  for (const b of reg.bots) b.active = want.has(b.appId);
+  const firstActive = reg.bots.find((b) => b.active);
+  if (firstActive) reg.current = firstActive.appId;
+  await saveBots(reg);
+  return reg;
+}
 async function addBot(entry) {
   const reg = await loadBots();
   reg.bots = reg.bots.filter((b) => b.appId !== entry.appId);
@@ -236,11 +251,6 @@ async function addBot(entry) {
   await saveBots(reg);
   return reg;
 }
-async function setCurrent(appId) {
-  const reg = await loadBots();
-  reg.current = appId;
-  await saveBots(reg);
-}
 async function removeBot(appId) {
   const reg = await loadBots();
   reg.bots = reg.bots.filter((b) => b.appId !== appId);
@@ -1026,8 +1036,14 @@ function ensureCodex() {
 async function ensureOnboarded(opts = {}) {
   if (!ensureCodex()) return null;
   const reg = await ensureRegistry();
-  const entry = currentBot(reg);
+  const entry = opts.bot ? findBot(reg, opts.bot) : currentBot(reg);
   if (!entry) {
+    if (opts.bot) {
+      console.error(
+        `\u2717 \u627E\u4E0D\u5230\u673A\u5668\u4EBA\u300C${opts.bot}\u300D\u3002\u7528 \`feishu-codex-bridge bot list\` \u67E5\u770B\u5DF2\u6CE8\u518C\u7684\u673A\u5668\u4EBA\u3002`
+      );
+      return null;
+    }
     if (!opts.allowCreate) {
       console.error("\u2717 \u5C1A\u672A\u914D\u7F6E\u4EFB\u4F55\u98DE\u4E66\u673A\u5668\u4EBA\u3002\u8BF7\u5148\u8FD0\u884C `feishu-codex-bridge bot init`\uFF08\u6216\u524D\u53F0 `run`\uFF09\u626B\u7801\u521B\u5EFA\u3002");
       return null;
@@ -5956,6 +5972,94 @@ async function startBridge(opts) {
   return { channel, shutdown };
 }
 
+// src/bot/supervisor.ts
+var BACKOFF_MIN_MS = 1e3;
+var BACKOFF_MAX_MS = 3e4;
+var HEALTHY_UPTIME_MS = 6e4;
+var SHUTDOWN_GRACE_MS = 8e3;
+async function runSupervisor(bots) {
+  const cliEntry = process.argv[1];
+  if (!cliEntry) throw new Error("supervisor: \u65E0\u6CD5\u89E3\u6790 CLI \u5165\u53E3\uFF08process.argv[1] \u4E3A\u7A7A\uFF09");
+  const childEnv = { ...process.env };
+  delete childEnv[SERVICE_ENV_FLAG];
+  let shuttingDown = false;
+  const children = bots.map((bot2) => ({ bot: bot2, backoffMs: BACKOFF_MIN_MS, startedAt: 0 }));
+  console.log(`
+\u6B63\u5728\u542F\u52A8 ${bots.length} \u4E2A\u673A\u5668\u4EBA\uFF08\u5404\u81EA\u72EC\u7ACB\u8FDB\u7A0B\uFF09\uFF1A`);
+  for (const b of bots) console.log(`  \u2022 ${b.name}  (${b.appId})  [${b.tenant}]`);
+  console.log("Ctrl+C \u9000\u51FA\uFF08\u5173\u95ED\u5168\u90E8\uFF09\u3002\n");
+  const prefixPipe = (name, src, dst) => {
+    if (!src) return;
+    let buf = "";
+    src.setEncoding("utf8");
+    src.on("data", (chunk) => {
+      buf += chunk;
+      let nl;
+      while ((nl = buf.indexOf("\n")) >= 0) {
+        const line = buf.slice(0, nl);
+        buf = buf.slice(nl + 1);
+        dst.write(`\x1B[2m[${name}]\x1B[0m ${line}
+`);
+      }
+    });
+    src.on("end", () => {
+      if (buf) dst.write(`\x1B[2m[${name}]\x1B[0m ${buf}
+`);
+    });
+  };
+  const spawnChild = (c) => {
+    c.startedAt = Date.now();
+    const proc = spawnProcess(process.execPath, [cliEntry, "run", "--bot", c.bot.appId], {
+      stdio: ["ignore", "pipe", "pipe"],
+      env: childEnv
+    });
+    c.proc = proc;
+    log.info("supervisor", "child-start", { bot: c.bot.name, appId: c.bot.appId, pid: proc.pid ?? null });
+    prefixPipe(c.bot.name, proc.stdout, process.stdout);
+    prefixPipe(c.bot.name, proc.stderr, process.stderr);
+    proc.on("exit", (code, signal) => {
+      c.proc = void 0;
+      if (shuttingDown) return;
+      const uptime = Date.now() - c.startedAt;
+      if (uptime >= HEALTHY_UPTIME_MS) c.backoffMs = BACKOFF_MIN_MS;
+      const wait = c.backoffMs;
+      c.backoffMs = Math.min(c.backoffMs * 2, BACKOFF_MAX_MS);
+      log.warn("supervisor", "child-exit", { bot: c.bot.name, code, signal, restartInMs: wait });
+      console.error(
+        `\x1B[2m[${c.bot.name}]\x1B[0m \u8FDB\u7A0B\u9000\u51FA\uFF08code=${code ?? signal ?? "?"}\uFF09\uFF0C${Math.round(wait / 1e3)}s \u540E\u91CD\u542F\u2026`
+      );
+      c.restartTimer = setTimeout(() => spawnChild(c), wait);
+    });
+    proc.on("error", (err) => {
+      log.fail("supervisor", err, { bot: c.bot.name, phase: "spawn" });
+    });
+  };
+  for (const c of children) spawnChild(c);
+  await new Promise((resolve7) => {
+    const stop = (sig) => {
+      if (shuttingDown) return;
+      shuttingDown = true;
+      console.log(`
+\u6536\u5230 ${sig}\uFF0C\u6B63\u5728\u5173\u95ED\u5168\u90E8\u673A\u5668\u4EBA\u2026`);
+      for (const c of children) {
+        if (c.restartTimer) clearTimeout(c.restartTimer);
+        c.proc?.kill("SIGTERM");
+      }
+      const deadline = Date.now() + SHUTDOWN_GRACE_MS;
+      const poll = setInterval(() => {
+        const alive = children.filter((c) => c.proc && !c.proc.killed);
+        if (alive.length === 0 || Date.now() >= deadline) {
+          clearInterval(poll);
+          for (const c of alive) c.proc?.kill("SIGKILL");
+          resolve7();
+        }
+      }, 200);
+    };
+    for (const sig of ["SIGINT", "SIGTERM"]) process.once(sig, () => stop(sig));
+  });
+  process.exit(0);
+}
+
 // src/core/single-instance.ts
 import { mkdirSync as mkdirSync2, readFileSync as readFileSync4, unlinkSync, writeFileSync as writeFileSync2 } from "fs";
 import { dirname as dirname11 } from "path";
@@ -6003,8 +6107,20 @@ function acquireSingleInstanceLock(appId) {
 }
 
 // src/cli/commands/run.ts
-async function runRun() {
-  const ready = await ensureOnboarded({ allowCreate: true });
+async function runRun(botName) {
+  if (botName) {
+    await runSingle(botName);
+    return;
+  }
+  const active = activeBots(await loadBots());
+  if (active.length > 1) {
+    await runSupervisor(active);
+    return;
+  }
+  await runSingle(active[0]?.name);
+}
+async function runSingle(botName) {
+  const ready = await ensureOnboarded({ allowCreate: !botName, bot: botName });
   if (!ready) {
     process.exitCode = 1;
     return;
@@ -6047,14 +6163,37 @@ async function runRun() {
 
 // src/cli/commands/daemon.ts
 async function runStart() {
-  const ready = await ensureOnboarded({ allowCreate: true });
-  if (!ready) {
-    process.exitCode = 1;
-    return;
-  }
-  if (!await confirmReadyForDaemon(ready)) {
-    process.exitCode = 1;
-    return;
+  const active = activeBots(await loadBots());
+  if (active.length === 0) {
+    const ready = await ensureOnboarded({ allowCreate: true });
+    if (!ready) {
+      process.exitCode = 1;
+      return;
+    }
+    if (!await confirmReadyForDaemon(ready)) {
+      process.exitCode = 1;
+      return;
+    }
+  } else {
+    if (active.length > 1) {
+      console.log(`
+\u540E\u53F0\u670D\u52A1\u5C06\u6258\u7BA1 ${active.length} \u4E2A\u673A\u5668\u4EBA\uFF08supervisor \u591A\u8FDB\u7A0B\uFF0C\u5404\u81EA\u72EC\u7ACB\u8FDB\u7A0B\uFF09\uFF1A`);
+      for (const b of active) console.log(`  \u2022 ${b.name}  (${b.appId})  [${b.tenant}]`);
+      console.log("");
+    }
+    for (const bot2 of active) {
+      if (active.length > 1) console.log(`
+\u2500\u2500\u2500\u2500 \u673A\u5668\u4EBA\u300C${bot2.name}\u300D(${bot2.appId}) \u2500\u2500\u2500\u2500`);
+      const ready = await ensureOnboarded({ bot: bot2.appId });
+      if (!ready) {
+        process.exitCode = 1;
+        return;
+      }
+      if (!await confirmReadyForDaemon(ready)) {
+        process.exitCode = 1;
+        return;
+      }
+    }
   }
   const status = await getServiceAdapter().install();
   console.log(installedNote());
@@ -6151,6 +6290,98 @@ async function runUpdate(opts = {}) {
 
 // src/cli/commands/bot.ts
 import { rm as rm5 } from "fs/promises";
+
+// src/cli/checkbox.ts
+import { emitKeypressEvents } from "readline";
+var ESC = "\x1B";
+var HIDE_CURSOR = `${ESC}[?25l`;
+var SHOW_CURSOR = `${ESC}[?25h`;
+var ALT_SCREEN_ON = `${ESC}[?1049h`;
+var ALT_SCREEN_OFF = `${ESC}[?1049l`;
+var HOME_AND_CLEAR = `${ESC}[H${ESC}[2J`;
+async function checkboxSelect(title, items) {
+  const input2 = process.stdin;
+  const output = process.stdout;
+  if (!input2.isTTY) throw new Error("checkboxSelect requires an interactive TTY");
+  const checked = items.map((it) => Boolean(it.checked));
+  let cursor = 0;
+  const frame = () => {
+    const lines = [title, ""];
+    items.forEach((it, i) => {
+      const box = checked[i] ? "\x1B[32m[x]\x1B[0m" : "[ ]";
+      const pointer = i === cursor ? "\x1B[36m>\x1B[0m" : " ";
+      const label = i === cursor ? `\x1B[1m${it.label}\x1B[0m` : it.label;
+      const hint = it.hint ? `  \x1B[2m${it.hint}\x1B[0m` : "";
+      lines.push(`${pointer} ${box} ${label}${hint}`);
+    });
+    const n = checked.filter(Boolean).length;
+    lines.push("");
+    lines.push(`\x1B[2m${n} \u4E2A\u5DF2\u52FE\u9009 \xB7 \u2191\u2193 \u79FB\u52A8 \xB7 \u7A7A\u683C\u52FE\u9009 \xB7 a \u5168\u9009 \xB7 \u56DE\u8F66\u786E\u8BA4 \xB7 q \u53D6\u6D88\x1B[0m`);
+    return lines.join("\r\n");
+  };
+  const redraw = () => {
+    output.write(HOME_AND_CLEAR + frame());
+  };
+  emitKeypressEvents(input2);
+  const wasRaw = Boolean(input2.isRaw);
+  let restored = false;
+  const restore = () => {
+    if (restored) return;
+    restored = true;
+    output.write(`${SHOW_CURSOR}${ALT_SCREEN_OFF}`);
+  };
+  input2.setRawMode?.(true);
+  input2.resume();
+  output.write(`${ALT_SCREEN_ON}${HIDE_CURSOR}`);
+  process.once("exit", restore);
+  redraw();
+  return await new Promise((resolve7) => {
+    const cleanup = () => {
+      input2.off("keypress", onKey);
+      input2.setRawMode?.(wasRaw);
+      input2.pause();
+      process.off("exit", restore);
+      restore();
+    };
+    const onKey = (_str, key) => {
+      const name = key?.name;
+      if (key?.ctrl && name === "c" || name === "escape" || name === "q") {
+        cleanup();
+        resolve7(null);
+        return;
+      }
+      if (name === "return" || name === "enter") {
+        cleanup();
+        resolve7(checked.flatMap((on, i) => on ? [i] : []));
+        return;
+      }
+      if (name === "up" || name === "k") {
+        cursor = (cursor - 1 + items.length) % items.length;
+        redraw();
+        return;
+      }
+      if (name === "down" || name === "j") {
+        cursor = (cursor + 1) % items.length;
+        redraw();
+        return;
+      }
+      if (name === "space") {
+        checked[cursor] = !checked[cursor];
+        redraw();
+        return;
+      }
+      if (name === "a") {
+        const allOn = checked.every(Boolean);
+        for (let i = 0; i < checked.length; i++) checked[i] = !allOn;
+        redraw();
+        return;
+      }
+    };
+    input2.on("keypress", onKey);
+  });
+}
+
+// src/cli/commands/bot.ts
 async function runBotInit(name) {
   if (!ensureCodex()) {
     process.exitCode = 1;
@@ -6165,7 +6396,7 @@ async function runBotInit(name) {
   console.log("  1) \u4E8B\u4EF6\u4E0E\u56DE\u8C03 \u2192 \u957F\u8FDE\u63A5 \u2192 \u8BA2\u9605\uFF1Aim.message.receive_v1 / card.action.trigger / application.bot.menu_v6");
   console.log("     \uFF08\u53EF\u9009\uFF09\u300C\u52A0\u8FDB\u5DF2\u6709\u7FA4\u300D\u529F\u80FD\u518D\u8BA2\u9605\uFF1Aim.chat.member.bot.added_v1 / im.chat.member.bot.deleted_v1");
   console.log("  2) \u521B\u5EFA\u5E76\u53D1\u5E03\u5E94\u7528\u7248\u672C");
-  console.log("\n`bot list` \u67E5\u770B\u5168\u90E8\uFF1B`bot use <\u540D>` \u5207\u6362\u5F53\u524D\uFF1B`run` \u524D\u53F0\u8DD1 / `start` \u540E\u53F0\u5E38\u9A7B\u3002\n");
+  console.log("\n`bot list` \u67E5\u770B\u5168\u90E8\uFF1B`bot use` \u52FE\u9009\u8981\u540C\u65F6\u8FDE\u63A5\u7684\u673A\u5668\u4EBA\uFF1B`run` \u524D\u53F0\u8DD1 / `start` \u540E\u53F0\u5E38\u9A7B\u3002\n");
 }
 async function runBotList() {
   const reg = await loadBots();
@@ -6173,27 +6404,65 @@ async function runBotList() {
     console.log("\uFF08\u8FD8\u6CA1\u6709\u6CE8\u518C\u4EFB\u4F55\u98DE\u4E66\u673A\u5668\u4EBA\u3002\u8FD0\u884C `feishu-codex-bridge bot init` \u521B\u5EFA\u3002\uFF09");
     return;
   }
+  const active = new Set(activeBots(reg).map((b) => b.appId));
   console.log("\n\u5DF2\u6CE8\u518C\u7684\u98DE\u4E66\u673A\u5668\u4EBA\uFF1A\n");
   for (const b of reg.bots) {
-    const cur = b.appId === reg.current ? "\u{1F449}" : "  ";
-    console.log(`${cur} ${b.name.padEnd(16)} ${b.appId}  [${b.tenant}]${b.botName ? `  ${b.botName}` : ""}`);
+    const mark = active.has(b.appId) ? "\u2705" : "\u2B1C";
+    console.log(`${mark} ${b.name.padEnd(16)} ${b.appId}  [${b.tenant}]${b.botName ? `  ${b.botName}` : ""}`);
   }
-  console.log("\n\u{1F449} = \u5F53\u524D\u9009\u4E2D\uFF08run / start \u542F\u52A8\u7684\u5C31\u662F\u5B83\uFF09\u3002`bot use <\u540D>` \u5207\u6362\u3002\n");
+  console.log("\n\x1B[2m`bot use` \u52FE\u9009\u8981\u540C\u65F6\u8FDE\u63A5\u7684\u673A\u5668\u4EBA\uFF0C\u6216 `bot use <\u540D> [\u540D\u2026]` \u76F4\u63A5\u6307\u5B9A\u3002\x1B[0m\n");
 }
-async function runBotUse(name) {
+async function runBotUse(names) {
   const reg = await loadBots();
-  const bot2 = findBot(reg, name);
-  if (!bot2) {
-    console.error(`\u2717 \u627E\u4E0D\u5230\u673A\u5668\u4EBA\u300C${name}\u300D\u3002\u5DF2\u6CE8\u518C\uFF1A${botNames(reg.bots)}`);
+  if (reg.bots.length === 0) {
+    console.error("\u2717 \u8FD8\u6CA1\u6709\u6CE8\u518C\u4EFB\u4F55\u98DE\u4E66\u673A\u5668\u4EBA\u3002\u5148 `feishu-codex-bridge bot init` \u521B\u5EFA\u3002");
     process.exitCode = 1;
     return;
   }
-  if (reg.current === bot2.appId) {
-    console.log(`\u300C${bot2.name}\u300D\u5DF2\u7ECF\u662F\u5F53\u524D\u673A\u5668\u4EBA\u3002`);
+  let appIds;
+  if (names.length > 0) {
+    const resolved = [];
+    const unknown = [];
+    for (const n of names) {
+      const b = findBot(reg, n);
+      if (!b) unknown.push(n);
+      else if (!resolved.includes(b.appId)) resolved.push(b.appId);
+    }
+    if (unknown.length) {
+      console.error(`\u2717 \u627E\u4E0D\u5230\u673A\u5668\u4EBA\uFF1A${unknown.join(", ")}\u3002\u5DF2\u6CE8\u518C\uFF1A${botNames(reg.bots)}`);
+      process.exitCode = 1;
+      return;
+    }
+    appIds = resolved;
+  } else {
+    if (!process.stdin.isTTY) {
+      const cur = activeBots(reg).map((b) => b.name).join(", ") || "\uFF08\u7A7A\uFF09";
+      console.log(`\u5F53\u524D\u6D3B\u8DC3\u673A\u5668\u4EBA\uFF1A${cur}`);
+      console.log("\uFF08\u975E\u4EA4\u4E92\u5F0F\u7EC8\u7AEF\uFF0C\u65E0\u6CD5\u5F39\u52FE\u9009\u6846\u3002\u7528 `bot use <\u540D> [\u540D\u2026]` \u76F4\u63A5\u6307\u5B9A\u8981\u540C\u65F6\u8FDE\u63A5\u7684\u673A\u5668\u4EBA\u3002\uFF09");
+      return;
+    }
+    const activeSet = new Set(activeBots(reg).map((b) => b.appId));
+    const items = reg.bots.map((b) => ({
+      label: b.name,
+      hint: `${b.appId}  [${b.tenant}]${b.botName ? `  ${b.botName}` : ""}`,
+      checked: activeSet.has(b.appId)
+    }));
+    const picked = await checkboxSelect("\u9009\u62E9\u8981\u540C\u65F6\u8FDE\u63A5\u7684\u673A\u5668\u4EBA\uFF08\u7A7A\u683C\u52FE\u9009\uFF0C\u56DE\u8F66\u786E\u8BA4\uFF09\uFF1A", items);
+    if (picked === null) {
+      console.log("\u5DF2\u53D6\u6D88\uFF0C\u672A\u6539\u52A8\u3002");
+      return;
+    }
+    appIds = picked.map((i) => reg.bots[i]?.appId).filter((id) => Boolean(id));
+  }
+  await setActiveBots(appIds);
+  const chosen = appIds.map((id) => reg.bots.find((b) => b.appId === id)?.name ?? id);
+  if (chosen.length === 0) {
+    console.log("\u2713 \u5DF2\u6E05\u7A7A\u6D3B\u8DC3\u673A\u5668\u4EBA\u2014\u2014`run` / `start` \u6682\u4E0D\u8FDE\u63A5\u4EFB\u4F55 bot\u3002`bot use` \u91CD\u65B0\u52FE\u9009\u3002");
     return;
   }
-  await setCurrent(bot2.appId);
-  console.log(`\u2713 \u5F53\u524D\u673A\u5668\u4EBA \u2192 \u300C${bot2.name}\u300D(${bot2.appId})\u3002\u524D\u53F0 \`run\` \u76F4\u63A5\u751F\u6548\uFF1B\u540E\u53F0\u8BF7 \`restart\`\u3002`);
+  console.log(
+    `\u2713 \u6D3B\u8DC3\u673A\u5668\u4EBA\uFF08${chosen.length} \u4E2A\uFF09\u2192 ${chosen.join(", ")}\u3002\u524D\u53F0\u91CD\u8DD1 \`run\` \u751F\u6548${chosen.length > 1 ? "\uFF08\u591A\u8FDB\u7A0B\u6258\u7BA1\uFF09" : ""}\uFF1B\u540E\u53F0\u8BF7 \`restart\`\u3002`
+  );
 }
 async function runBotRm(name) {
   const reg = await loadBots();
@@ -6278,8 +6547,8 @@ function readStdin() {
 // src/cli/index.ts
 var program = new Command();
 program.name("feishu-codex-bridge").description("\u628A\u98DE\u4E66/Lark \u6865\u63A5\u5230\u672C\u673A Codex\uFF08\u9879\u76EE=\u7FA4, \u8BDD\u9898=\u4F1A\u8BDD\uFF09").version(bridgeVersion());
-program.command("run").description("\u524D\u53F0\u542F\u52A8 bot\uFF08\u6CA1\u914D\u7F6E\u5219\u5148\u626B\u7801 init\uFF1BCtrl+C \u4F18\u96C5\u9000\u51FA\uFF09").action(async () => {
-  await runRun();
+program.command("run").description("\u524D\u53F0\u542F\u52A8\u6D3B\u8DC3\u673A\u5668\u4EBA\uFF08\u591A\u4E2A\u5219\u5404\u81EA\u72EC\u7ACB\u8FDB\u7A0B\uFF1B\u6CA1\u914D\u7F6E\u5219\u5148\u626B\u7801 init\uFF1BCtrl+C \u4F18\u96C5\u9000\u51FA\uFF09").option("--bot <name>", "\u53EA\u542F\u52A8\u6307\u5B9A\u7684\u4E00\u4E2A\u673A\u5668\u4EBA\uFF08\u540D\u5B57\u6216 appId\uFF09").action(async (options) => {
+  await runRun(options.bot);
 });
 program.command("start").description("\u540E\u53F0 daemon \u542F\u52A8\uFF08\u88C5 launchd \u5F00\u673A\u81EA\u542F\uFF1B\u6CA1\u914D\u7F6E\u5219\u5148\u626B\u7801 init\uFF09").action(async () => {
   await runStart();
@@ -6306,8 +6575,8 @@ bot.command("init [name]").description("\u6CE8\u518C\u4E00\u4E2A\u98DE\u4E66\u67
 bot.command("list").description("\u5217\u51FA\u5DF2\u6CE8\u518C\u7684\u98DE\u4E66\u673A\u5668\u4EBA").action(async () => {
   await runBotList();
 });
-bot.command("use <name>").description("\u9009\u62E9 run / start \u542F\u52A8\u65F6\u4F7F\u7528\u7684\u673A\u5668\u4EBA").action(async (name) => {
-  await runBotUse(name);
+bot.command("use [names...]").description("\u52FE\u9009/\u6307\u5B9A\u8981\u540C\u65F6\u8FDE\u63A5\u7684\u673A\u5668\u4EBA\uFF08\u591A\u9009\uFF09\uFF1B\u65E0\u53C2\u6570\u5F39\u4EA4\u4E92\u5F0F\u52FE\u9009\u6846").action(async (names) => {
+  await runBotUse(names ?? []);
 });
 bot.command("rm <name>").description("\u79FB\u9664\u4E00\u4E2A\u673A\u5668\u4EBA\u914D\u7F6E").action(async (name) => {
   await runBotRm(name);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelzen/feishu-codex-bridge",
-  "version": "0.3.0-win.1",
+  "version": "0.3.1",
   "description": "Bridge Feishu/Lark messenger with local Codex via app-server (project=group, thread=session)",
   "type": "module",
   "bin": {