@modelzen/feishu-codex-bridge 0.6.5 → 0.6.7-test.0

package/README.md

@@ -4,6 +4,9 @@
 [![total downloads](https://badgen.net/npm/dt/@modelzen/feishu-codex-bridge)](https://www.npmjs.com/package/@modelzen/feishu-codex-bridge)
 [![downloads/month](https://badgen.net/npm/dm/@modelzen/feishu-codex-bridge)](https://www.npmjs.com/package/@modelzen/feishu-codex-bridge)
 [![license](https://badgen.net/npm/license/@modelzen/feishu-codex-bridge)](https://github.com/modelzen/feishu-codex-bridge/blob/main/LICENSE)
+[![官网](https://badgen.net/badge/%E5%AE%98%E7%BD%91/bridge.vonvon.cc/blue)](https://bridge.vonvon.cc)
+
+🌐 **官网：<https://bridge.vonvon.cc>**
 
 > 把飞书 / Lark 桥接到你本机的 [Codex](https://github.com/openai/codex) 或 [Claude Code](https://www.anthropic.com/claude-code)，在群里 @ 机器人就能让它在指定项目目录里干活，结果以流式 Markdown 卡片实时回到群里。
 >
@@ -23,22 +26,42 @@
 
 ## ⚡ 安装
 
-两条命令装好、打开网页控制台，**剩下全在网页里点**（扫码加机器人 / 开权限 / 启停）：
+两步打开本机网页控制台。装好 Bridge、打开控制台，再在页面里启动后台服务、添加第一个 Bridge 机器人。
 
 ```bash
-npm i -g @modelzen/feishu-codex-bridge   # 1. 装命令
-feishu-codex-bridge web                  # 2. 打开本机网页控制台
+# 1. 全局安装 Bridge
+npm i -g @modelzen/feishu-codex-bridge
+
+# 2. 打开本机网页控制台
+# 启动服务、添加好机器人后，这条前台命令即可 Ctrl+C 关闭
+feishu-codex-bridge web
 ```
 
-让 **Codex / Claude** 替你装？把下面这段发给它：
+不想自己敲？把下面这段发给 **Codex / Claude** 等 AI agent，让它替你装好并跑起来：
 
 ```text
-如果本地没有 feishu-codex-bridge 命令，就先用 npm i -g @modelzen/feishu-codex-bridge 安装。
-然后运行 feishu-codex-bridge web 打开网页控制台，把输出的网址给我打开。
-装好、开完网页就停，别的不用做。
+帮我在这台电脑上安装并跑起来 feishu-codex-bridge：
+
+1) 先 node -v 确认有 Node.js(≥18)，没有就先装好；
+2) 再 codex --version 确认已经安装了 codex CLI，没有就先装好；
+3) 全局安装：
+   npm i -g @modelzen/feishu-codex-bridge
+4) 前台运行，打开本机 Web 控制台：
+   feishu-codex-bridge web
+   它一启动会打印一个 http://127.0.0.1:xxxx/?token=... 的链接。
+5) 把那个链接发给我；
+6) 然后用文字告诉我接下来怎么做：
+   - 我在浏览器打开这个链接；
+   - 点页面上的「启动」按钮，把后台服务跑起来；
+   - 启动后页面会自动进入可写控制台，在里面扫码添加我的第一个飞书机器人；
+   - 成功创建机器人后，前台那条 feishu-codex-bridge web 就可以 Ctrl+C 关掉，不影响后台服务。
 ```
 
-> 前置：**Node ≥ 20**，外加一个登录好的后端 —— **Codex**（`npm i -g @openai/codex && codex login`）或 **Claude Code**（SDK 随桥内置、复用本机 `claude` 登录态，首次按需下载约 265MB）。打开网页后扫码加机器人、按 checklist 开权限 / 订阅事件，全程点点点，不用碰命令行。
+### 三分钟，看它入职你的飞书
+
+从全局装包、打开本机网页控制台，到扫码建机器人、私聊报到，一整段带解说录屏。点击下面封面去 B 站观看高清版。
+
+[![3 分钟跑通：飞书里直接发任务，Codex 在你本机真干活](docs/assets/install-demo-cover.jpg)](https://www.bilibili.com/video/BV1xP7V6fESb)
 
 ---
 
@@ -140,6 +163,7 @@ npm test            # vitest
 
 ## 💬 文档 & 交流
 
+- 🌐 **官网**：<https://bridge.vonvon.cc>
 - 🎀 **图文介绍**：<https://my.feishu.cn/docx/AFKNdf4QaooL5OxSR8bc5H7vn7b> —— 配大量截图，讲清它在飞书里长什么样、怎么用。
 - 📖 **命令手册**：<https://my.feishu.cn/wiki/PZ23wGr7JiKK5RkIG4rcZXzGn5g> —— 各场景可用命令速查。
 - 🐛 **反馈 / 贡献**：<https://github.com/modelzen/feishu-codex-bridge/issues>

package/dist/cli.js

@@ -5538,7 +5538,11 @@ function buildResumeCard(state) {
   if (state.threads.length === 0) {
     elements.push(md("_\u8BE5\u76EE\u5F55\u4E0B\u8FD8\u6CA1\u6709\u5386\u53F2\u4F1A\u8BDD\u3002\u76F4\u63A5 @\u6211 \u5373\u53EF\u65B0\u5EFA\u3002_"));
   } else {
-    elements.push(note("\u70B9\u4E00\u6761\u5373\u6062\u590D \u2014\u2014 \u5728\u65B0\u8BDD\u9898\u91CC\u6253\u5F00\u5386\u53F2\u3001\u53EF\u76F4\u63A5\u7EE7\u7EED\u3002"));
+    elements.push(
+      note(
+        state.flat ? "\u70B9\u4E00\u6761\u5373\u5207\u56DE \u2014\u2014 \u5C31\u5730\u7EE7\u7EED\uFF0C\u4E0D\u53E6\u8D77\u8BDD\u9898\u3002" : "\u70B9\u4E00\u6761\u5373\u6062\u590D \u2014\u2014 \u5728\u65B0\u8BDD\u9898\u91CC\u6253\u5F00\u5386\u53F2\u3001\u53EF\u76F4\u63A5\u7EE7\u7EED\u3002"
+      )
+    );
     for (const t of state.threads) {
       const title = (t.name?.trim() || t.preview.trim() || "(\u65E0\u6458\u8981)").replace(/\s+/g, " ");
       const label = `\u21A9\uFE0F ${pickerTime(t.updatedAt || t.createdAt)} \xB7 ${truncate(title, RESUME_TITLE_MAX)}`;
@@ -5551,7 +5555,19 @@ function buildResumeLaunchingCard(state) {
   return card([md("\u23F3 \u6B63\u5728\u6062\u590D\u5386\u53F2\u4F1A\u8BDD\u2026"), note(metaNote(state))], { summary: "\u6062\u590D\u4E2D" });
 }
 function buildResumeDoneCard(state) {
-  return card([md("\u2705 \u5DF2\u6062\u590D \u2014\u2014 \u5DF2\u5728\u4E0A\u65B9\u65B0\u8BDD\u9898\u6253\u5F00\uFF0C\u53EF\u76F4\u63A5\u7EE7\u7EED\u3002"), note(metaNote(state))], { summary: "\u5DF2\u6062\u590D" });
+  const line = state.flat ? "\u21A9\uFE0F \u5DF2\u5207\u56DE \u2014\u2014 \u5C31\u5730\u7EE7\u7EED\uFF0C\u4E0A\u9762\u7684\u5386\u53F2\u6D88\u606F\u4FDD\u7559\u3002" : "\u2705 \u5DF2\u6062\u590D \u2014\u2014 \u5DF2\u5728\u4E0A\u65B9\u65B0\u8BDD\u9898\u6253\u5F00\uFF0C\u53EF\u76F4\u63A5\u7EE7\u7EED\u3002";
+  return card([md(line), note(metaNote(state))], { summary: "\u5DF2\u6062\u590D" });
+}
+function buildClearedCard() {
+  return card(
+    [
+      md("\u{1F9F9} **\u5DF2\u5F00\u542F\u5168\u65B0\u4F1A\u8BDD**"),
+      md("\u2705 \u4E0A\u4E0B\u6587\u5DF2\u6E05\u7A7A \u2014\u2014 \u6211\u4ECE\u8FD9\u91CC\u91CD\u65B0\u5F00\u59CB\uFF0C\u4E0D\u518D\u53C2\u8003\u4E0A\u9762\u7684\u5BF9\u8BDD\u3002"),
+      md("\u{1F4AC} \u98DE\u4E66\u804A\u5929\u8BB0\u5F55\u4E0D\u53D7\u5F71\u54CD \u2014\u2014 \u4E0A\u9762\u7684\u6D88\u606F\u90FD\u8FD8\u5728\uFF0C\u53EA\u662F\u6211\u4E0D\u518D\u8BFB\u53D6\u5B83\u4EEC\u3002"),
+      md("\u{1F5C2}\uFE0F \u521A\u624D\u90A3\u6BB5\u5DF2\u5F52\u6863 \u2014\u2014 \u53D1 `/resume` \u968F\u65F6\u5207\u56DE\u7EE7\u7EED\u3002")
+    ],
+    { summary: "\u5DF2\u6E05\u7A7A\u4E0A\u4E0B\u6587" }
+  );
 }
 function buildResumeErrorCard(state, message) {
   return card([md(`\u274C \u6062\u590D\u5931\u8D25\uFF1A${truncate(message, 200)}`), note(metaNote(state))], { summary: "\u6062\u590D\u5931\u8D25" });
@@ -5608,6 +5624,8 @@ function buildHelpCard(scope, noMention = true, isAdmin2 = false, caps) {
     if (showGoal) lines.push(goalLine);
     lines.push("\xB7 `/model` \u2192 \u5207\u6362\u6A21\u578B / \u63A8\u7406\u5F3A\u5EA6", "\xB7 `/context` \u2192 \u770B\u4E0A\u4E0B\u6587\u5360\u6BD4");
     if (showCompact) lines.push(compactLine);
+    if (isAdmin2) lines.push("\xB7 `/clear` \u2192 \u6E05\u7A7A\u4E0A\u4E0B\u6587\uFF0C\u5F00\u4E00\u6BB5\u5168\u65B0\u4F1A\u8BDD\uFF08\u98DE\u4E66\u6D88\u606F\u4FDD\u7559\uFF09");
+    if (isAdmin2 && showResume) lines.push("\xB7 `/resume` \u2192 \u5207\u56DE\u5386\u53F2\u4F1A\u8BDD");
     if (isAdmin2) lines.push("\xB7 `/settings` \u2192 \u7FA4\u8BBE\u7F6E\uFF08\u514D@ \u5F00\u5173\uFF09");
     lines.push("\xB7 `/help` \u2192 \u8FD9\u5F20\u901F\u67E5\u5361");
     elements.push(md("\u{1F4AC} **\u5355\u4F1A\u8BDD\u7FA4** \u2014 \u6574\u7FA4\u5C31\u662F\u4E00\u4E2A\u4F1A\u8BDD\uFF0C\u4E0A\u4E0B\u6587\u8FDE\u7EED\u3002"), hr(), md(lines.join("\n")));
@@ -5651,6 +5669,8 @@ function buildWelcomeCard(kind, docUrl, noMention = true, caps, agentName = "Cod
           talkLine(noMention, "\u4EA4\u7ED9\u6211\u5904\u7406"),
           ...showGoal ? [goalLine] : [],
           "\xB7 `/model` \u2192 \u5207\u6362\u6A21\u578B / \u63A8\u7406\u5F3A\u5EA6",
+          "\xB7 `/clear` \u2192 \u6E05\u7A7A\u4E0A\u4E0B\u6587\uFF0C\u5F00\u65B0\u4F1A\u8BDD\uFF08\u7BA1\u7406\u5458\uFF0C\u98DE\u4E66\u6D88\u606F\u4FDD\u7559\uFF09",
+          ...showResume ? ["\xB7 `/resume` \u2192 \u5207\u56DE\u5386\u53F2\u4F1A\u8BDD\uFF08\u7BA1\u7406\u5458\uFF09"] : [],
           "\xB7 `/settings` \u2192 \u7FA4\u8BBE\u7F6E\uFF08\u514D@ \u5F00\u5173\uFF09",
           "\xB7 `/help` \u2192 \u547D\u4EE4\u901F\u67E5\u5361"
         ].join("\n")
@@ -8489,7 +8509,7 @@ function withCodexHooksFeature(text) {
 }
 
 // src/service/update.ts
-import { existsSync as existsSync8, readFileSync as readFileSync4 } from "fs";
+import { existsSync as existsSync9, readFileSync as readFileSync4 } from "fs";
 import { dirname as dirname9, join as join15, resolve as resolve6 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 
@@ -8503,7 +8523,7 @@ import { fileURLToPath as fileURLToPath3 } from "url";
 
 // src/service/common.ts
 init_paths();
-import { createReadStream, statSync as statSync2 } from "fs";
+import { appendFileSync, createReadStream, statSync as statSync2 } from "fs";
 import { appendFile, mkdir as mkdir7, readFile as readFile9 } from "fs/promises";
 import { dirname as dirname6, join as join11, resolve as resolve4 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
@@ -8518,6 +8538,13 @@ async function ensureLogFiles() {
   await appendFile(serviceStdoutPath(), "");
   await appendFile(serviceStderrPath(), "");
 }
+function appendServiceErr(tag, line) {
+  try {
+    appendFileSync(serviceStderrPath(), `[${(/* @__PURE__ */ new Date()).toISOString()}] [${tag}] ${line}
+`);
+  } catch {
+  }
+}
 function resolveCliBinPath() {
   const distDir = dirname6(fileURLToPath2(import.meta.url));
   return resolve4(distDir, "..", "bin", "feishu-codex-bridge.mjs");
@@ -8727,9 +8754,10 @@ function launchctlError(command, result) {
 // src/service/win-startup.ts
 init_paths();
 import { spawn as spawn3, spawnSync as spawnSync2 } from "child_process";
-import { openSync, readFileSync as readFileSync3, rmSync, writeFileSync } from "fs";
+import { existsSync as existsSync7, openSync, readFileSync as readFileSync3, renameSync, rmSync, writeFileSync } from "fs";
 import { mkdir as mkdir9, writeFile as writeFile8 } from "fs/promises";
 import { join as join13 } from "path";
+var RELAUNCH_TASK_NAME = "feishu-codex-bridge-relaunch";
 var RUN_KEY_PATH = "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run";
 var RUN_KEY_NAME = "feishu-codex-bridge";
 var SERVICE_ENV_FLAG = "FEISHU_CODEX_BRIDGE_SERVICE";
@@ -8759,14 +8787,16 @@ function buildLauncherVbs() {
     ""
   ].join("\r\n");
 }
-function startNow() {
+function startNow(envPath) {
   const out = openSync(serviceStdoutPath(), "a");
   const err = openSync(serviceStderrPath(), "a");
+  const overrides = { [SERVICE_ENV_FLAG]: "1" };
+  if (envPath) overrides.PATH = envPath;
   const child = spawn3(process.execPath, [resolveCliBinPath(), "run"], {
     detached: true,
     windowsHide: true,
     stdio: ["ignore", out, err],
-    env: mergeProcessEnv(process.env, { [SERVICE_ENV_FLAG]: "1" })
+    env: mergeProcessEnv(process.env, overrides)
   });
   if (child.pid) writeFileSync(servicePidFile(), String(child.pid), "utf8");
   child.unref();
@@ -8797,10 +8827,150 @@ async function restartWinStartup() {
     throw new Error("\u767B\u5F55\u81EA\u542F\u672A\u5B89\u88C5\uFF08\u5148\u8FD0\u884C `feishu-codex-bridge start`\uFF09\u3002");
   }
   await ensureLogFiles();
-  killService();
-  startNow();
+  const oldPid = readServicePid();
+  if (oldPid === null || !pidAlive(oldPid)) {
+    startNow();
+    return statusWinStartup();
+  }
+  writeRelaunchRequest({ oldPid, envPath: process.env.PATH ?? "", nonce: `${process.pid}-${Date.now()}` });
+  if (!spawnTreeFreeRelauncher()) {
+    clearRelaunchRequest();
+    appendServiceErr("relaunch", `no tree-free backend (powershell/schtasks); kept old pid=${oldPid} running, did NOT restart`);
+    throw new Error("\u65E0\u6CD5\u62C9\u8D77\u300C\u6811\u5916\u300D\u91CD\u542F\u8FDB\u7A0B\uFF08powershell \u4E0E schtasks \u5747\u4E0D\u53EF\u7528\uFF09\uFF1B\u5DF2\u4FDD\u7559\u65E7\u670D\u52A1\u7EE7\u7EED\u8FD0\u884C\uFF0C\u672A\u91CD\u542F\u3002");
+  }
+  appendServiceErr("relaunch", `submitted async relaunch for oldPid=${oldPid}`);
   return statusWinStartup();
 }
+function relaunchRequestFile() {
+  return join13(paths.appDir, "relaunch.json");
+}
+function writeRelaunchRequest(req) {
+  writeFileSync(relaunchRequestFile(), JSON.stringify(req), "utf8");
+}
+function clearRelaunchRequest() {
+  rmSync(relaunchRequestFile(), { force: true });
+}
+function relaunchClaimFile() {
+  return `${relaunchRequestFile()}.claim.${process.pid}`;
+}
+function claimRelaunchRequest() {
+  const claim = relaunchClaimFile();
+  try {
+    renameSync(relaunchRequestFile(), claim);
+  } catch {
+    return null;
+  }
+  try {
+    const r = JSON.parse(readFileSync3(claim, "utf8"));
+    if (typeof r.oldPid === "number" && Number.isFinite(r.oldPid)) {
+      return {
+        oldPid: r.oldPid,
+        envPath: typeof r.envPath === "string" ? r.envPath : "",
+        nonce: String(r.nonce ?? "")
+      };
+    }
+  } catch {
+  }
+  return null;
+}
+function clearRelaunchClaim() {
+  rmSync(relaunchClaimFile(), { force: true });
+}
+function buildRelauncherPowershell(binPath = resolveCliBinPath(), nodePath = process.execPath) {
+  const inner = `"${nodePath}" "${binPath}" __win-relaunch`;
+  const lit = `'${inner.replace(/'/g, "''")}'`;
+  return `$c=${lit}; try { Invoke-CimMethod -ClassName Win32_Process -MethodName Create -Arguments @{ CommandLine=$c } -ErrorAction Stop | Out-Null } catch { schtasks /create /tn ${RELAUNCH_TASK_NAME} /tr $c /sc ONCE /st 00:00 /f | Out-Null; schtasks /run /tn ${RELAUNCH_TASK_NAME} | Out-Null }`;
+}
+function powershellPath() {
+  const root = process.env.SystemRoot || process.env.windir || "C:\\Windows";
+  const p = join13(root, "System32", "WindowsPowerShell", "v1.0", "powershell.exe");
+  return existsSync7(p) ? p : null;
+}
+function spawnTreeFreeRelauncher() {
+  const ps = powershellPath();
+  if (ps) {
+    const errFd = openSync(serviceStderrPath(), "a");
+    const child = spawn3(
+      ps,
+      ["-NoProfile", "-NonInteractive", "-WindowStyle", "Hidden", "-Command", buildRelauncherPowershell()],
+      { detached: true, windowsHide: true, stdio: ["ignore", errFd, errFd] }
+    );
+    child.on("error", (e) => appendServiceErr("relaunch", `powershell spawn error: ${e.message}`));
+    child.unref();
+    return true;
+  }
+  appendServiceErr("relaunch", "powershell.exe not found; trying schtasks fallback");
+  return spawnSchtasksRelauncher();
+}
+function spawnSchtasksRelauncher() {
+  const tr = `"${process.execPath}" "${resolveCliBinPath()}" __win-relaunch`;
+  const create = spawnSync2(
+    "schtasks",
+    ["/create", "/tn", RELAUNCH_TASK_NAME, "/tr", tr, "/sc", "ONCE", "/st", "00:00", "/f"],
+    { encoding: "utf8", windowsHide: true }
+  );
+  if (create.status !== 0) {
+    appendServiceErr("relaunch", `schtasks /create failed exit=${create.status ?? "?"} ${(create.stderr || "").trim()}`);
+    return false;
+  }
+  const run = spawnSync2("schtasks", ["/run", "/tn", RELAUNCH_TASK_NAME], { encoding: "utf8", windowsHide: true });
+  if (run.status !== 0) {
+    appendServiceErr("relaunch", `schtasks /run failed exit=${run.status ?? "?"} ${(run.stderr || "").trim()}`);
+    return false;
+  }
+  return true;
+}
+function defaultTaskkill(pid) {
+  const r = spawnSync2("taskkill", ["/pid", String(pid), "/T", "/F"], { encoding: "utf8", windowsHide: true });
+  return { status: r.status, stderr: (r.stderr || "").toString() };
+}
+async function runWinRelaunch(deps = {}) {
+  const claim = deps.claimRequest ?? claimRelaunchRequest;
+  const clearClaim = deps.clearRequest ?? clearRelaunchClaim;
+  const alive = deps.pidAlive ?? pidAlive;
+  const kill = deps.taskkill ?? defaultTaskkill;
+  const start = deps.start ?? startNow;
+  const sleep = deps.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+  const graceMs = deps.graceMs ?? 15e3;
+  const pollMs = deps.pollMs ?? 200;
+  const now = deps.now ?? (() => Date.now());
+  const ensureLogs = deps.ensureLogs ?? ensureLogFiles;
+  const logLine = deps.logLine ?? ((line) => appendServiceErr("relaunch", line));
+  await ensureLogs();
+  const req = claim();
+  if (!req) {
+    logLine("no relaunch request to claim (already handled by another relauncher, or none)");
+    return;
+  }
+  try {
+    logLine(`start oldPid=${req.oldPid} self=${process.pid}`);
+    if (alive(req.oldPid)) {
+      const r = kill(req.oldPid);
+      logLine(`taskkill oldPid=${req.oldPid} exit=${r.status ?? "?"} ${r.stderr.trim()}`.trim());
+    }
+    const deadline = now() + graceMs;
+    while (now() < deadline && alive(req.oldPid)) {
+      await sleep(pollMs);
+    }
+    if (alive(req.oldPid)) {
+      logLine(
+        `ABORT: oldPid=${req.oldPid} still alive after ${graceMs}ms (elevated / access denied?); not starting new to avoid double instance`
+      );
+      return;
+    }
+    await sleep(300);
+    start(req.envPath);
+    logLine(`relaunched; new service.pid=${readServicePid() ?? "?"}`);
+  } finally {
+    clearClaim();
+    if (process.platform === "win32") {
+      try {
+        spawnSync2("schtasks", ["/delete", "/tn", RELAUNCH_TASK_NAME, "/f"], { stdio: "ignore", windowsHide: true });
+      } catch {
+      }
+    }
+  }
+}
 function statusWinStartup() {
   const installed = isInstalled();
   const pid = readServicePid();
@@ -8860,12 +9030,15 @@ function pidAlive(pid) {
 function killService() {
   const pid = readServicePid();
   if (pid === null || !pidAlive(pid)) return;
-  spawnSync2("taskkill", ["/pid", String(pid), "/T", "/F"], { stdio: "ignore" });
+  const r = spawnSync2("taskkill", ["/pid", String(pid), "/T", "/F"], { encoding: "utf8", windowsHide: true });
+  if (r.status !== 0) {
+    appendServiceErr("kill", `taskkill pid=${pid} exit=${r.status ?? "?"} ${(r.stderr || "").toString().trim()}`);
+  }
 }
 
 // src/service/systemd.ts
 import { spawnSync as spawnSync3 } from "child_process";
-import { existsSync as existsSync7 } from "fs";
+import { existsSync as existsSync8 } from "fs";
 import { mkdir as mkdir10, rm as rm4, writeFile as writeFile9 } from "fs/promises";
 import { homedir as homedir5 } from "os";
 import { dirname as dirname8, join as join14 } from "path";
@@ -8969,7 +9142,7 @@ function statusSystemd() {
   };
 }
 function unitExists() {
-  return existsSync7(systemdUnitPath());
+  return existsSync8(systemdUnitPath());
 }
 function systemdActive() {
   const r = spawnSync3("systemctl", ["--user", "is-active", SYSTEMD_UNIT_NAME], {
@@ -9044,7 +9217,7 @@ function packageName() {
   return pkgJson().name ?? "@modelzen/feishu-codex-bridge";
 }
 function isDevSource() {
-  return existsSync8(join15(pkgRoot(), ".git"));
+  return existsSync9(join15(pkgRoot(), ".git"));
 }
 function isNewer(a, b) {
   const pa = a.split(".").map((n) => Number.parseInt(n, 10) || 0);
@@ -9759,7 +9932,7 @@ init_paths();
 init_paths();
 init_logger();
 import { mkdir as mkdir11 } from "fs/promises";
-import { existsSync as existsSync9 } from "fs";
+import { existsSync as existsSync10 } from "fs";
 import { isAbsolute as isAbsolute2, join as join17, resolve as resolve7 } from "path";
 
 // src/project/announcement.ts
@@ -9952,7 +10125,7 @@ function assertBackendUsable(backend, mode) {
 async function resolveCwd(name, existingPath) {
   if (existingPath) {
     const cwd2 = isAbsolute2(existingPath) ? existingPath : resolve7(existingPath);
-    if (!existsSync9(cwd2)) throw new Error(`\u6587\u4EF6\u5939\u4E0D\u5B58\u5728\uFF1A${cwd2}`);
+    if (!existsSync10(cwd2)) throw new Error(`\u6587\u4EF6\u5939\u4E0D\u5B58\u5728\uFF1A${cwd2}`);
     return { cwd: cwd2, blank: false };
   }
   const cwd = join17(paths.projectsRootDir, name);
@@ -11369,6 +11542,14 @@ function createOrchestrator(channel, cfg, fallbackCwd, cliBridge) {
         return;
       }
       const ts = turnSession(msg.chatId, project, msg.senderId);
+      if (cmd === "resume") {
+        postResumeCard(msg, ts.sessionKey);
+        return;
+      }
+      if (cmd === "clear") {
+        runClear(msg, ts.sessionKey, ts);
+        return;
+      }
       if (cmd === "model") {
         postModelCard(msg, ts.sessionKey, false);
         return;
@@ -11402,6 +11583,14 @@ function createOrchestrator(channel, cfg, fallbackCwd, cliBridge) {
         await channel.send(msg.chatId, { markdown: `\`/${cmd}\` \u8BF7\u5230\u4E3B\u7FA4\u533A\u4F7F\u7528\uFF08\u8BDD\u9898\u5916\u53D1\uFF09\u3002` }, { replyTo: msg.messageId, replyInThread: true }).catch(() => void 0);
         return;
       }
+      if (cmd === "clear") {
+        await channel.send(
+          msg.chatId,
+          { markdown: "`/clear` \u4EC5\u5355\u4F1A\u8BDD\u7FA4\u53EF\u7528\u3002\u591A\u8BDD\u9898\u7FA4\u91CC\uFF0C\u56DE\u4E3B\u7FA4\u533A @\u6211 + \u5185\u5BB9 \u5373\u5F00\u65B0\u8BDD\u9898\uFF1B`/resume` \u53EF\u6062\u590D\u5386\u53F2\u4F1A\u8BDD\u3002" },
+          { replyTo: msg.messageId, replyInThread: true }
+        ).catch(() => void 0);
+        return;
+      }
       const ts = turnSession(msg.threadId, project, msg.senderId);
       if (cmd === "model") {
         postModelCard(msg, ts.sessionKey, true);
@@ -11439,6 +11628,14 @@ function createOrchestrator(channel, cfg, fallbackCwd, cliBridge) {
       await postGroupSettings(msg, project);
       return;
     }
+    if (cmd === "clear") {
+      await channel.send(
+        msg.chatId,
+        { markdown: "`/clear` \u4EC5\u5355\u4F1A\u8BDD\u7FA4\u53EF\u7528\u3002\u591A\u8BDD\u9898\u7FA4\u91CC\uFF0C@\u6211 + \u5185\u5BB9 \u5373\u5F00\u65B0\u8BDD\u9898\uFF1B`/resume` \u53EF\u6062\u590D\u5386\u53F2\u4F1A\u8BDD\u3002" },
+        { replyTo: msg.messageId }
+      ).catch(() => void 0);
+      return;
+    }
     if (cmd === "model" || cmd === "compact" || cmd === "context") {
       await channel.send(msg.chatId, { markdown: `\`/${cmd}\` \u9700\u8981\u5728\u8BDD\u9898\u91CC\u4F7F\u7528\uFF08\u5148 @\u6211 \u5F00\u4E2A\u8BDD\u9898\uFF09\u3002` }, { replyTo: msg.messageId }).catch(() => void 0);
       return;
@@ -11467,7 +11664,7 @@ function createOrchestrator(channel, cfg, fallbackCwd, cliBridge) {
   function parseCommand(text) {
     const m = /^\/(\w+)/.exec(text);
     const name = m?.[1]?.toLowerCase();
-    return name === "resume" || name === "model" || name === "settings" || name === "help" || name === "compact" || name === "context" ? name : null;
+    return name === "resume" || name === "model" || name === "settings" || name === "help" || name === "compact" || name === "context" || name === "clear" ? name : null;
   }
   function shouldRespondWithoutMention(project, msg) {
     if (!(project.noMention ?? defaultNoMention(project))) return false;
@@ -11783,7 +11980,7 @@ function createOrchestrator(channel, cfg, fallbackCwd, cliBridge) {
         );
     }).catch((err) => log.fail("intake", err));
   }
-  function postResumeCard(msg) {
+  function postResumeCard(msg, singleSessionKey) {
     void withTrace({ chatId: msg.chatId, msgId: msg.messageId }, async () => {
       if (!isAdmin(cfg, msg.senderId)) {
         await denyAdminCommand(msg, "resume");
@@ -11802,7 +11999,9 @@ function createOrchestrator(channel, cfg, fallbackCwd, cliBridge) {
           projectName: project?.name,
           backend: be.id,
           threads,
-          createdAt: Date.now()
+          createdAt: Date.now(),
+          // Single-session group: pick rebinds this key flat (no new topic).
+          ...singleSessionKey ? { flat: true, sessionKey: singleSessionKey } : {}
         };
         const res = await sendManagedCard(channel, msg.chatId, buildResumeCard(state), msg.messageId);
         pruneResumePending();
@@ -11926,6 +12125,68 @@ function createOrchestrator(channel, cfg, fallbackCwd, cliBridge) {
       }
     });
   }
+  function runClear(msg, sessionKey, perm) {
+    const reply = (markdown) => channel.send(msg.chatId, { markdown }, { replyTo: msg.messageId }).then(
+      () => void 0,
+      () => void 0
+    );
+    if (!isAdmin(cfg, msg.senderId)) {
+      void denyAdminCommand(msg, "clear");
+      return;
+    }
+    if (active.get(sessionKey)) {
+      void reply("\u23F3 \u8FD9\u4E00\u8F6E\u8FD8\u5728\u8DD1\uFF0C\u7ED3\u675F\u540E\u518D `/clear`\u3002");
+      return;
+    }
+    const reserved = { queue: [], requesterOpenId: msg.senderId };
+    active.set(sessionKey, reserved);
+    void withTrace({ chatId: msg.chatId, msgId: msg.messageId }, async () => {
+      try {
+        const [rec, project] = await Promise.all([getSession(sessionKey), getProjectByChatId(msg.chatId)]);
+        const be = backendFor(rec?.backend ?? project?.backend);
+        const cwd = rec?.cwd ?? project?.cwd ?? fallbackCwd;
+        const fresh = await be.startThread({
+          cwd,
+          model: rec?.model,
+          effort: rec?.effort,
+          mode: perm.mode,
+          network: perm.network,
+          autoCompact: perm.autoCompact
+        });
+        const old = sessions.get(sessionKey);
+        if (old && old !== fresh) {
+          sessions.delete(sessionKey);
+          void old.close().catch(() => void 0);
+        }
+        trackSession(sessionKey, fresh);
+        lastUsage.delete(sessionKey);
+        await upsertSession({
+          threadId: sessionKey,
+          chatId: msg.chatId,
+          cwd,
+          sessionId: fresh.sessionId,
+          backend: be.id,
+          model: rec?.model,
+          effort: rec?.effort,
+          summary: "(\u65B0\u4F1A\u8BDD)",
+          createdAt: Date.now(),
+          updatedAt: Date.now()
+        });
+        await sendManagedCard(channel, msg.chatId, buildClearedCard(), msg.messageId, false).catch(
+          (err) => log.fail("card", err, { phase: "clear" })
+        );
+        log.info("intake", "clear", { sessionKey, sessionId: fresh.sessionId, backend: be.id });
+      } catch (err) {
+        log.fail("intake", err, { phase: "clear" });
+        await reply(`\u274C ${err instanceof Error ? err.message : String(err)}`);
+      } finally {
+        if (active.get(sessionKey) === reserved) active.delete(sessionKey);
+        if (reserved.queue.length > 0) {
+          await reply(`\u26A0\uFE0F \u6E05\u7A7A\u671F\u95F4\u6536\u5230\u7684 ${reserved.queue.length} \u6761\u6D88\u606F\u672A\u8FDB\u5165\u4F1A\u8BDD\uFF0C\u8BF7\u91CD\u53D1\u3002`);
+        }
+      }
+    });
+  }
   async function postHelpCard(msg, scope, inThread = false, project) {
     const noMention = project ? project.noMention ?? defaultNoMention(project) : true;
     const caps = backendFor(project?.backend).capabilities;
@@ -12794,6 +13055,55 @@ ${tail}` }, { replyTo: evt.messageId }).catch(() => void 0);
   async function resumeFromCard(evt, state, sessionId, backendId) {
     const be = backendFor(backendId);
     try {
+      if (state.flat && state.sessionKey) {
+        const sessionKey = state.sessionKey;
+        if (active.get(sessionKey)) {
+          resumePending.delete(evt.messageId);
+          settleUpdate(evt.messageId, buildResumeErrorCard(state, "\u5F53\u524D\u6709\u4EFB\u52A1\u5728\u8DD1\uFF0C\u7ED3\u675F\u540E\u518D /resume"));
+          return;
+        }
+        const reserved = { queue: [], requesterOpenId: state.requesterOpenId };
+        active.set(sessionKey, reserved);
+        try {
+          const history2 = await be.readHistory(state.cwd, sessionId);
+          resumePending.delete(evt.messageId);
+          await withTrace({ chatId: state.chatId, msgId: state.originalMsgId }, async () => {
+            const cardState = { cwd: state.cwd, projectName: state.projectName, history: history2 };
+            await sendManagedCard(channel, state.chatId, buildHistoryCard(cardState), state.originalMsgId, false).catch(
+              (err) => log.fail("card", err, { phase: "resume-history-single" })
+            );
+            const old = sessions.get(sessionKey);
+            if (old) {
+              sessions.delete(sessionKey);
+              void old.close().catch(() => void 0);
+            }
+            lastUsage.delete(sessionKey);
+            const now = Date.now();
+            await upsertSession({
+              threadId: sessionKey,
+              chatId: state.chatId,
+              cwd: state.cwd,
+              sessionId,
+              backend: be.id,
+              summary: history2.name || history2.preview || "(\u6062\u590D\u4F1A\u8BDD)",
+              createdAt: now,
+              updatedAt: now
+            });
+            log.info("card", "resume-done-single", { sessionKey, sessionId, turns: history2.totalTurns });
+          });
+          settleUpdate(evt.messageId, buildResumeDoneCard(state));
+        } finally {
+          if (active.get(sessionKey) === reserved) active.delete(sessionKey);
+          if (reserved.queue.length > 0) {
+            await channel.send(
+              state.chatId,
+              { markdown: `\u26A0\uFE0F \u5207\u56DE\u671F\u95F4\u6536\u5230\u7684 ${reserved.queue.length} \u6761\u6D88\u606F\u672A\u8FDB\u5165\u4F1A\u8BDD\uFF0C\u8BF7\u91CD\u53D1\u3002` },
+              { replyTo: state.originalMsgId }
+            ).catch(() => void 0);
+          }
+        }
+        return;
+      }
       const history = await be.readHistory(state.cwd, sessionId);
       resumePending.delete(evt.messageId);
       let bound = false;
@@ -14580,16 +14890,22 @@ async function doUpdate() {
   }
   const res = await installLatest();
   log.info("daemon-control", "update-installed", { ok: res.ok });
-  if (!res.ok) return;
+  appendServiceErr("daemon-control", `update-installed ok=${res.ok}`);
+  if (!res.ok) {
+    appendServiceErr("daemon-control", "install failed \u2014 keeping old version, not restarting");
+    return;
+  }
   await doRestart("update");
 }
 async function doRestart(phase) {
   if (!isServiceRunning()) {
     log.info("daemon-control", "restart-skipped-no-service", { phase });
+    appendServiceErr("daemon-control", `restart-skipped-no-service (phase=${phase}); service.pid \u672A\u6307\u5411\u5728\u8DD1\u7684 daemon`);
     return;
   }
   await getServiceAdapter().restart();
   log.info("daemon-control", "restart-issued", { phase });
+  appendServiceErr("daemon-control", `restart-issued (phase=${phase})`);
 }
 
 // src/web/mount.ts
@@ -15338,6 +15654,9 @@ ${UI_PURE_JS}
   var daemon = null;         // /api/daemon
   var diag = null;           // /api/diagnosis \u7ED3\u679C\uFF08\u5F53\u524D bot \u7684\u63A2\u6D4B\uFF1B\u5207 Tab \u5FC5\u6E05\uFF09
   var catalog = null;        // /api/backends \u7F13\u5B58\uFF08\u540E\u7AEF\u7BA1\u7406\u5361 + \u9879\u76EE picker \u590D\u7528\uFF09
+  var lastUpdate = null;     // /api/update/check \u7ED3\u679C\u7F13\u5B58\uFF1A\u603B\u89C8 5s \u91CD\u6E32\u4E0D\u91CD\u67E5\uFF08\u6BCF\u6B21\u67E5\u90FD spawn npm view\uFF09
+  var updateCheckedAt = 0;   // \u4E0A\u6B21\u68C0\u67E5\u65F6\u95F4\u6233\uFF1B\u62FF\u5230\u7ED3\u679C\u8D85 30min\u3001\u8F6F\u5931\u8D25\u8D85 ~2min \u624D\u968F\u91CD\u6E32\u81EA\u52A8\u590D\u67E5
+  var updateChecking = false;// in-flight \u95F8\uFF1Anpm view \u53EF\u80FD\u6570\u79D2~20s\uFF0C\u671F\u95F4 5s \u91CD\u6E32\u4E0D\u53E0\u53D1\u7B2C\u4E8C\u4E2A\u8BF7\u6C42
   var drawerProject = null;  // \u62BD\u5C49\u91CC\u6253\u5F00\u7684\u9879\u76EE\u540D
   var diagBotId = null;      // diag \u5C5E\u4E8E\u54EA\u4E2A bot\uFF08\u9632\u4E32\u53F0\uFF09
   var bkDetailId = null;     // \u540E\u7AEF Agent \u8BE6\u60C5\u89C6\u56FE\u5F53\u524D\u5C55\u5F00\u7684\u540E\u7AEF id\uFF08null=\u5217\u8868\uFF09
@@ -15536,6 +15855,14 @@ ${UI_PURE_JS}
     fetch('/api/daemon').then(function (r) { return r.json(); })
       .then(function (d) {
         daemon = d;
+        // \u8FD0\u884C\u4E2D\u7684\u5B9E\u9645\u7248\u672C\u4E00\u65E6\u8DDF\u7248\u672C\u68C0\u67E5\u7F13\u5B58\u91CC\u7684 current \u5BF9\u4E0D\u4E0A\uFF08\u591A\u534A\u662F\u521A\u66F4\u65B0+\u91CD\u542F\u5B8C\u6210\uFF09\uFF0C
+        // \u5C31\u4F5C\u5E9F\u7F13\u5B58\u5E76\u5F53\u573A\u8865\u67E5\u4E00\u6B21\uFF08\u82E5\u5728\u603B\u89C8\u9875\uFF09\uFF0C\u628A\u300C\u6709\u65B0\u7248\u300D\u7ACB\u523B\u7FFB\u6210\u300C\u5DF2\u662F\u6700\u65B0\u7248\u300D\u2014\u2014\u4E0D\u7B49
+        // \u4E0B\u4E00\u8F6E renderRoute\uFF0C\u6D88\u9664 loadState/loadDaemon \u540C\u5468\u671F\u7ADE\u6001\u5BFC\u81F4\u7684 ~10s \u5EF6\u8FDF\u4E0E\u6A2A\u5E45\u6B8B\u7559\u3002
+        // \u53EA\u5728\u7248\u672C\u771F\u53D8\u65F6\u624D\u67E5\uFF08\u7A33\u6001 d.version===current\uFF09\uFF0C\u65E2\u7559\u4F4F\u66F4\u65B0\u540E\u7684\u5373\u65F6\u53CD\u9988\uFF0C\u53C8\u4E0D\u56DE\u5230 5s \u7A7A\u8F6C\u3002
+        if (lastUpdate && d.version && d.version !== lastUpdate.current) {
+          lastUpdate = null; updateCheckedAt = 0;
+          if (parseRoute(location.hash).tab === 'overview') { var ub = $('updateBody'); if (ub) loadUpdate(ub); }
+        }
         if (parseRoute(location.hash).tab === 'overview') { var b = $('daemonBody'); if (b) renderDaemon(b); }
         renderSidebarFoot();
         renderGlobalSummary();
@@ -15849,7 +16176,14 @@ ${UI_PURE_JS}
     daemonCard.appendChild(updateBody);
     root.appendChild(daemonCard);
     renderDaemon(daemonBody);
-    loadUpdate(updateBody);
+    // \u7248\u672C\u68C0\u67E5\u4F1A\u5728\u670D\u52A1\u7AEF spawn\u300Cnpm view\u300D\uFF0C\u4E0D\u80FD\u8DDF\u7740 5s \u91CD\u6E32\u6BCF\u6B21\u90FD\u8DD1\uFF1A\u6709\u7F13\u5B58\u5C31\u76F4\u63A5\u6E32\uFF0C
+    // \u53EA\u5728\u9996\u6B21\u6216\u7F13\u5B58\u8FC7\u671F\uFF0830min\uFF09\u65F6\u624D\u771F\u67E5\u4E00\u6B21\u3002\u624B\u52A8\u300C\u68C0\u67E5\u66F4\u65B0\u300D\u6309\u94AE\u4ECD\u5F3A\u5236\u5237\u65B0\u3002
+    if (lastUpdate) {
+      renderUpdate(updateBody, lastUpdate);
+      if (Date.now() - updateCheckedAt > 30 * 60 * 1000) loadUpdate(updateBody);
+    } else {
+      loadUpdate(updateBody);
+    }
 
     // \u{1F916} \u673A\u5668\u4EBA\uFF08\u5728 Feishu Bridge \u5361\u4E0B\u9762\uFF0C\u5404\u81EA\u5360\u6EE1\u5BBD\u5EA6\uFF09
     var botsCard = el('div', 'card');
@@ -16208,9 +16542,19 @@ ${UI_PURE_JS}
   }
 
   function loadUpdate(box) {
+    if (updateChecking) return;          // \u5728\u9014\u5C31\u4E0D\u53E0\u53D1\uFF1A\u6162\u68C0\u67E5\uFF08npm view \u6700\u957F 20s\uFF09\u671F\u95F4 5s \u91CD\u6E32\u4E0D\u91CD\u590D spawn
+    updateChecking = true;
+    updateCheckedAt = Date.now();        // \u4E50\u89C2\u5360\u4F4D\uFF1Ain-flight \u671F\u95F4 30min \u8FB9\u754C\u4E0D\u518D\u88AB\u53CD\u590D\u5224\u771F
     fetch('/api/update/check').then(function (r) { return r.json(); })
-      .then(function (u) { renderUpdate(box, u); })
-      .catch(function () { box.textContent = '\u26A0\uFE0F \u7248\u672C\u68C0\u67E5\u5931\u8D25\uFF08\u7F51\u7EDC\u6216 npm registry\uFF09'; });
+      .then(function (u) {
+        lastUpdate = u;
+        // \u8F6F\u5931\u8D25\uFF1A\u975E dev \u5374\u6CA1\u62FF\u5230 latest\uFF08\u591A\u534A registry \u4E0D\u53EF\u8FBE/\u8D85\u65F6\uFF0C\u670D\u52A1\u7AEF\u4ECD\u56DE 200\uFF09\uFF0C\u53EA\u7F13\u5B58 ~2min
+        // \u4FBF\u81EA\u52A8\u590D\u67E5\uFF0C\u522B\u628A\u300C\u67E5\u8BE2\u5931\u8D25\u300D\u9489\u4F4F 30min\uFF1B\u62FF\u5230 latest \u6216 dev \u6A21\u5F0F\u624D\u6309\u5B8C\u6574 30min TTL\u3002
+        updateCheckedAt = (u && (u.dev || u.latest)) ? Date.now() : Date.now() - 28 * 60 * 1000;
+        renderUpdate(box, u);
+      })
+      .catch(function () { box.textContent = '\u26A0\uFE0F \u7248\u672C\u68C0\u67E5\u5931\u8D25\uFF08\u7F51\u7EDC\u6216 npm registry\uFF09'; })
+      .then(function () { updateChecking = false; });  // finally\uFF1A\u65E0\u8BBA\u6210\u8D25\u90FD\u677E\u95F8
   }
   function renderUpdate(box, u) {
     box.textContent = '';
@@ -17984,6 +18328,7 @@ async function runSupervisor(bots) {
   const supervisorStartedAt = Date.now();
   const cliEntry = process.argv[1];
   if (!cliEntry) throw new Error("supervisor: \u65E0\u6CD5\u89E3\u6790 CLI \u5165\u53E3\uFF08process.argv[1] \u4E3A\u7A7A\uFF09");
+  recordServicePid();
   const childEnv = { ...process.env };
   delete childEnv[SERVICE_ENV_FLAG];
   let shuttingDown = false;
@@ -18250,6 +18595,7 @@ async function runOnboardingConsole() {
     releaseLock = acquireSingleInstanceLock("__onboarding__");
   } catch (err) {
     if (err instanceof BridgeAlreadyRunningError) {
+      clearServicePid();
       console.error(`\u2717 ${err.message}`);
       process.exitCode = 1;
       return;
@@ -18318,6 +18664,7 @@ async function runSingle(botName) {
     releaseLock = acquireSingleInstanceLock(cfg.accounts.app.id);
   } catch (err) {
     if (err instanceof BridgeAlreadyRunningError) {
+      clearServicePid();
       console.error(`\u2717 ${err.message}`);
       log.info("run", "already-running", { pid: err.pid });
       process.exitCode = 1;
@@ -18873,6 +19220,9 @@ program.command("web").description("\u672C\u673A Web \u63A7\u5236\u53F0\uFF08\u5
 program.command("__daemon-control <action>", { hidden: true }).action(async (action) => {
   await runDaemonControl(action);
 });
+program.command("__win-relaunch", { hidden: true }).action(async () => {
+  await runWinRelaunch();
+});
 var bot = program.command("bot").description("\u98DE\u4E66\u673A\u5668\u4EBA\u7BA1\u7406\uFF08\u591A\u673A\u5668\u4EBA\uFF09");
 bot.command("init [name]").description("\u6CE8\u518C\u4E00\u4E2A\u98DE\u4E66\u673A\u5668\u4EBA\u5E76\u6388\u6743\uFF08\u53EF\u9009\u77ED\u540D\uFF09").action(async (name) => {
   await runBotInit(name);

package/package.json

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