@modelzen/feishu-codex-bridge 0.6.5 → 0.6.6

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")
@@ -11369,6 +11389,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 +11430,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 +11475,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 +11511,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 +11827,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 +11846,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 +11972,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 +12902,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;

package/package.json

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