@modelzen/feishu-codex-bridge 0.2.3-win → 0.3.0

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

@@ -274,10 +274,10 @@ import { extname, join as join3 } from "path";
 // src/platform/spawn.ts
 import crossSpawn from "cross-spawn";
 function spawnProcess(command, args = [], options = {}) {
-  return crossSpawn(command, [...args], options);
+  return crossSpawn(command, [...args], { windowsHide: true, ...options });
 }
 function spawnProcessSync(command, args = [], options = {}) {
-  return crossSpawn.sync(command, [...args], options);
+  return crossSpawn.sync(command, [...args], { windowsHide: true, ...options });
 }
 function mergeProcessEnv(base = process.env, overrides = {}) {
   const out = { ...base };
@@ -491,7 +491,6 @@ async function listSecretIds() {
 }
 
 // src/config/secret-resolver.ts
-import { spawn } from "child_process";
 import { readFile as readFile4 } from "fs/promises";
 import { join as join5 } from "path";
 var ENV_TEMPLATE_RE = /^\$\{([A-Z][A-Z0-9_]{0,127})\}$/;
@@ -577,7 +576,10 @@ async function spawnExecProvider(pc, ref) {
       if (v) env[k] = v;
     }
     if (pc.env) Object.assign(env, pc.env);
-    const child = spawn(pc.command, pc.args ?? [], { env, stdio: ["pipe", "pipe", "pipe"] });
+    const child = spawnProcess(pc.command, pc.args ?? [], {
+      env,
+      stdio: ["pipe", "pipe", "pipe"]
+    });
     let stdout = "", stderr = "", truncated = false, settled = false;
     const timer = setTimeout(() => {
       if (settled) return;
@@ -812,7 +814,7 @@ async function fetchGrantedScopes(base, token) {
 }
 
 // src/utils/open-url.ts
-import { spawn as spawn2 } from "child_process";
+import { spawn } from "child_process";
 import { platform } from "os";
 function openUrl(url) {
   if (!process.stdout.isTTY) return false;
@@ -832,7 +834,7 @@ function openUrl(url) {
       args = [url];
   }
   try {
-    const child = spawn2(cmd, args, { stdio: "ignore", detached: true });
+    const child = spawn(cmd, args, { stdio: "ignore", detached: true });
     child.on("error", () => {
     });
     child.unref();
@@ -3556,14 +3558,12 @@ function buildGroupSettingsCard(project) {
 }
 
 // src/service/update.ts
-import { execFile, spawn as spawn5 } from "child_process";
 import { existsSync as existsSync6, readFileSync as readFileSync3 } from "fs";
 import { dirname as dirname9, join as join11, resolve as resolve5 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
-import { promisify } from "util";
 
 // src/service/launchd.ts
-import { spawn as spawn3, spawnSync } from "child_process";
+import { spawn as spawn2, spawnSync } from "child_process";
 import { existsSync as existsSync4 } from "fs";
 import { mkdir as mkdir6, rm as rm2, writeFile as writeFile5 } from "fs/promises";
 import { homedir as homedir3, userInfo as userInfo2 } from "os";
@@ -3741,7 +3741,7 @@ async function tailLaunchdLogs(follow) {
   await ensureLogFiles();
   const args = follow ? ["-f", serviceStdoutPath(), serviceStderrPath()] : ["-n", "100", serviceStdoutPath(), serviceStderrPath()];
   await new Promise((resolvePromise, reject) => {
-    const child = spawn3("tail", args, { stdio: "inherit" });
+    const child = spawn2("tail", args, { stdio: "inherit" });
     child.on("error", reject);
     child.on("close", (code) => {
       if (code === 0 || follow && code === null) {
@@ -3793,7 +3793,7 @@ function launchctlError(command, result) {
 }
 
 // src/service/win-startup.ts
-import { spawn as spawn4, spawnSync as spawnSync2 } from "child_process";
+import { spawn as spawn3, spawnSync as spawnSync2 } from "child_process";
 import { openSync, readFileSync as readFileSync2, rmSync, writeFileSync } from "fs";
 import { mkdir as mkdir7, writeFile as writeFile6 } from "fs/promises";
 import { join as join9 } from "path";
@@ -3829,7 +3829,7 @@ function buildLauncherVbs() {
 function startNow() {
   const out = openSync(serviceStdoutPath(), "a");
   const err = openSync(serviceStderrPath(), "a");
-  const child = spawn4(process.execPath, [resolveCliBinPath(), "run"], {
+  const child = spawn3(process.execPath, [resolveCliBinPath(), "run"], {
     detached: true,
     windowsHide: true,
     stdio: ["ignore", out, err],
@@ -4093,8 +4093,7 @@ function isServiceRunning() {
 }
 
 // src/service/update.ts
-var execFileP = promisify(execFile);
-var NPM = process.platform === "win32" ? "npm.cmd" : "npm";
+var NPM = "npm";
 function pkgRoot() {
   return resolve5(dirname9(fileURLToPath4(import.meta.url)), "..");
 }
@@ -4124,18 +4123,31 @@ function isNewer(a, b) {
   return false;
 }
 async function latestVersion() {
-  try {
-    const { stdout } = await execFileP(NPM, ["view", packageName(), "version"], { timeout: 2e4 });
-    const v = stdout.trim();
-    return /^\d+\.\d+\.\d+/.test(v) ? v : null;
-  } catch {
-    return null;
-  }
+  const v = await new Promise((resolveP) => {
+    const child = spawnProcess(NPM, ["view", packageName(), "version"], {
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    let out = "";
+    const timer = setTimeout(() => {
+      child.kill();
+      resolveP(null);
+    }, 2e4);
+    child.stdout?.on("data", (d) => out += d);
+    child.on("error", () => {
+      clearTimeout(timer);
+      resolveP(null);
+    });
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      resolveP(code === 0 ? out.trim() : null);
+    });
+  });
+  return v && /^\d+\.\d+\.\d+/.test(v) ? v : null;
 }
 async function installLatest(opts = {}) {
   const target = `${packageName()}@latest`;
   return await new Promise((resolveP) => {
-    const child = spawn5(NPM, ["install", "-g", target], {
+    const child = spawnProcess(NPM, ["install", "-g", target], {
       stdio: opts.inherit ? ["ignore", "inherit", "inherit"] : ["ignore", "pipe", "pipe"]
     });
     let out = "";
@@ -4163,14 +4175,17 @@ import { existsSync as existsSync7 } from "fs";
 import { isAbsolute as isAbsolute2, join as join12, resolve as resolve6 } from "path";
 
 // src/project/git-info.ts
-import { execFile as execFile2 } from "child_process";
-import { promisify as promisify2 } from "util";
-var execFileAsync = promisify2(execFile2);
+import { execFile } from "child_process";
+import { promisify } from "util";
+var execFileAsync = promisify(execFile);
 async function currentBranch(cwd) {
   try {
     const { stdout } = await execFileAsync("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
       cwd,
-      timeout: 3e3
+      timeout: 3e3,
+      // Hide the console window: this runs on every inbound message, and the
+      // Windows background service has no console of its own to inherit.
+      windowsHide: true
     });
     const b = stdout.trim();
     return b && b !== "HEAD" ? b : null;

package/package.json

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