@modelzen/feishu-codex-bridge 0.6.4 → 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

@@ -1106,7 +1106,7 @@ ${lines || "\uFF08\u65E0\uFF09"}`));
   return card(elements, { forward: false });
 }
 function buildCliBridgeTaskCompletionCard(input2) {
-  const verb = input2.replyDoneAt ? "\u2705 \u5DF2\u786E\u8BA4\u5B8C\u6210" : input2.status === "failed" ? "\u274C \u4EFB\u52A1\u5931\u8D25" : pickCopy(COPY.completion, input2.id || input2.cwd);
+  const verb = input2.replyDoneAt ? "\u2705 \u5DF2\u6536\u5DE5" : input2.status === "failed" ? "\u274C \u4EFB\u52A1\u5931\u8D25" : pickCopy(COPY.completion, input2.id || input2.cwd);
   const elements = [
     titleEl(verb),
     metaLine(input2.source, input2.cwd)
@@ -1123,7 +1123,7 @@ ${codeBlock(chunk, "text")}`));
   }
   if (input2.replyEnabled) {
     const expiresAt = input2.replyExpiresAt ? `\uFF08\u6709\u6548\u671F\u81F3 ${new Date(input2.replyExpiresAt).toLocaleString("zh-CN")}\uFF09` : "";
-    elements.push(actions([button("\u23F3 \u7B49\u5F85\u786E\u8BA4", { a: CLI.taskCompletionDone, id: input2.id }, "primary")]));
+    elements.push(actions([button("\u2705 \u6536\u5DE5", { a: CLI.taskCompletionDone, id: input2.id }, "primary")]));
     elements.push(note(pickCopy(COPY.footerReply, input2.id || input2.cwd) + expiresAt));
   } else if (input2.replyDoneAt) {
     elements.push(actions([disabledButton("\u2705 \u5DF2\u5B8C\u6210", "primary")]));
@@ -1190,8 +1190,8 @@ var init_cards2 = __esm({
         "\u4EBA\u5728\u684C\u524D\u6211\u5C31\u95ED\u5634,\u4E00\u5207\u56DE\u5F52\u7EC8\u7AEF\u3002"
       ],
       footerReply: [
-        "\u{1F4AC} \u76F4\u63A5\u56DE\u590D\u8FD9\u6761\u6D88\u606F,\u5C31\u80FD\u63A5\u7740\u652F\u4F7F\u5B83\u5E72\u6D3B;\u6216\u70B9\u300C\u7B49\u5F85\u786E\u8BA4\u300D\u8BA9\u5B83\u6536\u5DE5\u3002",
-        "\u{1F4AC} \u56DE\u6211\u4E00\u53E5\u8BDD,\u5B83\u7ACB\u523B\u63A5\u7740\u8DD1;\u4E0D\u60F3\u7EE7\u7EED\u5C31\u70B9\u300C\u7B49\u5F85\u786E\u8BA4\u300D\u3002"
+        "\u{1F4AC} \u76F4\u63A5\u56DE\u590D\u8FD9\u6761\u6D88\u606F,\u5C31\u80FD\u63A5\u7740\u652F\u4F7F\u5B83\u5E72\u6D3B;\u6216\u70B9\u300C\u6536\u5DE5\u300D\u8BA9\u5B83\u9000\u51FA\u3002",
+        "\u{1F4AC} \u56DE\u6211\u4E00\u53E5\u8BDD,\u5B83\u7ACB\u523B\u63A5\u7740\u8DD1;\u4E0D\u60F3\u7EE7\u7EED\u5C31\u70B9\u300C\u6536\u5DE5\u300D\u3002"
       ]
     };
   }
@@ -3126,14 +3126,19 @@ function mapNotification(n, ctx) {
 function mapItemStart(item, ctx) {
   switch (item.type) {
     case "commandExecution":
-      return { type: "tool_use", itemId: item.id, title: item.command, detail: String(item.cwd) };
+      return { type: "tool_use", itemId: item.id, title: item.command, detail: String(item.cwd), kind: "command" };
     case "fileChange":
-      return { type: "tool_use", itemId: item.id, title: fileChangeTitle(item.changes, ctx?.cwd) };
+      return { type: "tool_use", itemId: item.id, title: fileChangeTitle(item.changes, ctx?.cwd), kind: "file" };
     case "webSearch":
-      return { type: "tool_use", itemId: item.id, title: "\u8054\u7F51\u641C\u7D22" };
+      return {
+        type: "tool_use",
+        itemId: item.id,
+        title: item.query ? `\u8054\u7F51\u641C\u7D22\uFF1A${item.query}` : "\u8054\u7F51\u641C\u7D22",
+        kind: "search"
+      };
     case "mcpToolCall":
     case "dynamicToolCall":
-      return { type: "tool_use", itemId: item.id, title: "\u5DE5\u5177\u8C03\u7528" };
+      return { type: "tool_use", itemId: item.id, title: "\u5DE5\u5177\u8C03\u7528", kind: "tool" };
     default:
       return null;
   }
@@ -3803,7 +3808,8 @@ function createTurnMapper(ctx = {}) {
               type: "tool_use",
               itemId: String(b.id ?? `tool${++blockSeq}`),
               title: toolTitle(b.name ?? "\u5DE5\u5177", b.input ?? {}, ctx.cwd),
-              detail: toolDetail(b.name ?? "", b.input ?? {})
+              detail: toolDetail(b.name ?? "", b.input ?? {}),
+              kind: toolKind(b.name ?? "")
             });
           }
         }
@@ -3922,6 +3928,26 @@ function toolTitle(name, input2, cwd) {
       return name || "\u5DE5\u5177\u8C03\u7528";
   }
 }
+function toolKind(name) {
+  switch (name) {
+    case "Bash":
+    case "BashOutput":
+      return "command";
+    case "Read":
+    case "Write":
+    case "Edit":
+    case "MultiEdit":
+    case "NotebookEdit":
+      return "file";
+    case "Glob":
+    case "Grep":
+    case "WebFetch":
+    case "WebSearch":
+      return "search";
+    default:
+      return "tool";
+  }
+}
 function toolDetail(name, input2) {
   if (name === "Bash" && typeof input2.description === "string" && input2.description) {
     return input2.description;
@@ -5512,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)}`;
@@ -5525,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" });
@@ -5582,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")));
@@ -5625,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")
@@ -7007,6 +7053,7 @@ function reduce(state, evt) {
         id: evt.itemId,
         title: evt.title,
         detail: evt.detail,
+        kind: evt.kind,
         status: "running"
       };
       return {
@@ -7349,25 +7396,61 @@ function renderCleanBody(bodyMarkdown, images) {
 }
 
 // src/card/tool-render.ts
-var HEADER_TITLE_MAX = 80;
+var HEADER_TITLE_MAX = 120;
 var OUTPUT_MAX = 1200;
+var CMD_BLOCK_MAX = 1e3;
+var SUMMARY_LINE_MAX = 400;
 var BODY_TOTAL_MAX = 2500;
+function statusIcon(status) {
+  return status === "done" ? "\u2705" : status === "error" ? "\u274C" : "\u23F3";
+}
+function kindGlyph(kind) {
+  switch (kind) {
+    case "command":
+      return "\u{1F527}";
+    case "file":
+      return "\u{1F4C4}";
+    case "search":
+      return "\u{1F50D}";
+    default:
+      return "";
+  }
+}
+function leadGlyphs(tool) {
+  const glyph = kindGlyph(tool.kind);
+  return glyph ? `${statusIcon(tool.status)} ${glyph}` : statusIcon(tool.status);
+}
 function toolHeaderText(tool) {
-  const icon = tool.status === "done" ? "\u2705" : tool.status === "error" ? "\u274C" : "\u23F3";
-  return `${icon} **${escapeInline2(truncate3(tool.title, HEADER_TITLE_MAX))}**`;
+  return `${leadGlyphs(tool)} **${escapeInline2(truncate3(tool.title, HEADER_TITLE_MAX))}**`;
+}
+function toolSummaryLine(tool) {
+  return `- ${leadGlyphs(tool)} **${escapeInline2(truncate3(tool.title, SUMMARY_LINE_MAX))}**`;
 }
 function toolBodyMd(tool) {
-  if (!tool.output) {
-    return tool.status === "running" ? "_\u8FD0\u884C\u4E2D\u2026_" : "";
-  }
-  const label = tool.status === "error" ? "Error" : "Output";
-  const block = tool.output.startsWith("```") ? tool.output : bashBlock(tool.output);
-  const body = `**${label}**
-${block}`;
+  const lead = invocationMd(tool);
+  const outputPart = tool.output ? outputBlock(tool) : tool.status === "running" ? "_\u8FD0\u884C\u4E2D\u2026_" : tool.kind === "search" ? "_\uFF08\u641C\u7D22\u7ED3\u679C\u5DF2\u7528\u4E8E\u4F5C\u7B54\uFF0C\u4E0D\u5355\u72EC\u56DE\u4F20\uFF09_" : "";
+  const body = [lead, outputPart].filter(Boolean).join("\n\n");
   if (body.length <= BODY_TOTAL_MAX) return body;
   return `${body.slice(0, BODY_TOTAL_MAX)}\u2026
 
-_\uFF08\u5DF2\u622A\u65AD\uFF0C\u5B8C\u6574\u8F93\u51FA ${tool.output.length} \u5B57\u7B26\uFF09_`;
+_\uFF08\u5185\u5BB9\u8FC7\u957F\uFF0C\u5DF2\u622A\u65AD\uFF09_`;
+}
+function invocationMd(tool) {
+  if (tool.kind !== "command") return "";
+  const cmd = tool.title.trim();
+  if (!cmd) return "";
+  const detail = tool.detail ? `
+\`${escapeInline2(tool.detail)}\`` : "";
+  return `**\u547D\u4EE4**
+\`\`\`bash
+${truncate3(cmd, CMD_BLOCK_MAX)}
+\`\`\`${detail}`;
+}
+function outputBlock(tool) {
+  const label = tool.status === "error" ? "Error" : "Output";
+  const block = tool.output.startsWith("```") ? tool.output : bashBlock(tool.output);
+  return `**${label}**
+${block}`;
 }
 function bashBlock(output) {
   const note2 = output.length > OUTPUT_MAX ? `
@@ -7468,6 +7551,8 @@ var CONTROLS_EID = "controls";
 var REASONING_MAX = 1500;
 var COLLAPSE_TOOL_THRESHOLD = 3;
 var PROCESS_BODY_BUDGET = 22e3;
+var PROCESS_COMPONENT_BUDGET = 120;
+var SUMMARY_BODY_MAX = 6e3;
 function buildRunCard(rc) {
   const state = rc.rs;
   const running = state.terminal === "running";
@@ -7529,7 +7614,7 @@ function renderTerminal(state, rc) {
     const toolCount = blocks.reduce((n, b) => b.kind === "tool" ? n + 1 : n, 0);
     elements.push(
       collapsiblePanelEl({
-        title: processTitle(Boolean(reasoning), toolCount),
+        title: processTitle(Boolean(reasoning), toolCount, state.terminal),
         expanded: false,
         border: "grey",
         elements: processEls
@@ -7577,7 +7662,9 @@ function lastTextIndex(blocks) {
 }
 function buildProcessBody(reasoning, blocks) {
   const rich = processElements(reasoning, blocks, false);
-  if (estimateSize2(rich) <= PROCESS_BODY_BUDGET) return rich;
+  if (estimateSize2(rich) <= PROCESS_BODY_BUDGET && estimateComponents(rich) <= PROCESS_COMPONENT_BUDGET) {
+    return rich;
+  }
   return processElements(reasoning, blocks, true);
 }
 function processElements(reasoning, blocks, compactTools) {
@@ -7592,18 +7679,25 @@ function processElements(reasoning, blocks, compactTools) {
   }
   return out;
 }
-function processTitle(hasReasoning, toolCount) {
+function processTitle(hasReasoning, toolCount, terminal) {
+  const icon = terminal === "interrupted" ? "\u23F9" : terminal === "idle_timeout" ? "\u23F1" : terminal === "error" ? "\u26A0\uFE0F" : "\u2705";
+  const noun = terminal === "interrupted" ? "\u4E2D\u65AD\u524D\u7684\u8FC7\u7A0B" : terminal === "idle_timeout" ? "\u8D85\u65F6\u524D\u7684\u8FC7\u7A0B" : terminal === "error" ? "\u51FA\u9519\u524D\u7684\u8FC7\u7A0B" : "\u672C\u8F6E\u8FC7\u7A0B";
   const parts = [];
   if (hasReasoning) parts.push("\u{1F9E0} \u601D\u8003");
-  if (toolCount > 0) parts.push(`\u{1F9F0} ${toolCount} \u4E2A\u5DE5\u5177\u8C03\u7528`);
-  const detail = parts.length > 0 ? `\uFF1A${parts.join(" \xB7 ")}` : "";
-  return `\u{1F5C2} **\u8FC7\u7A0B${detail}**\uFF08\u70B9\u51FB\u5C55\u5F00\uFF09`;
+  if (toolCount > 0) parts.push(`\u{1F9F0} ${toolCount} \u4E2A\u5DE5\u5177`);
+  const detail = parts.length > 0 ? ` \xB7 ${parts.join(" \xB7 ")}` : "";
+  return `${icon} **${noun}**${detail}\uFF08\u70B9\u51FB\u5C55\u5F00\uFF09`;
 }
 function estimateSize2(els) {
   let n = 0;
   for (const el of els) n += JSON.stringify(el).length;
   return n;
 }
+function estimateComponents(els) {
+  let n = 0;
+  for (const el of els) n += el.tag === "collapsible_panel" ? 3 : 1;
+  return n;
+}
 function buildRunCardPlain(rc) {
   return buildRunCard({ ...rc, cardKey: void 0 });
 }
@@ -7638,11 +7732,11 @@ function* groupBlocks(blocks) {
 }
 function renderToolGroup(tools, finalized, compact = false) {
   if (tools.length === 0) return [];
-  if (compact) return [collapsedToolSummary(tools, true)];
+  if (compact) return [collapsedToolSummary(tools, finalized)];
+  if (finalized) return tools.map((t) => toolPanel(t, false));
   if (tools.length < COLLAPSE_TOOL_THRESHOLD) {
     return tools.map((t) => toolPanel(t, false));
   }
-  if (finalized) return [collapsedToolSummary(tools, true)];
   const prior = tools.slice(0, -1);
   const latest = tools[tools.length - 1];
   const out = [];
@@ -7652,7 +7746,7 @@ function renderToolGroup(tools, finalized, compact = false) {
 }
 function reasoningPanel(content, active) {
   return collapsiblePanel({
-    title: active ? "\u{1F9E0} **\u601D\u8003\u4E2D**" : "\u{1F9E0} **\u601D\u8003\u5B8C\u6210\uFF0C\u70B9\u51FB\u67E5\u770B**",
+    title: active ? "\u{1F9E0} **\u6B63\u5728\u601D\u8003\u2026**" : "\u{1F9E0} **\u601D\u8003\u8FC7\u7A0B**\uFF08\u70B9\u51FB\u5C55\u5F00\uFF09",
     expanded: active,
     border: "grey",
     body: truncate4(content, REASONING_MAX)
@@ -7668,11 +7762,24 @@ function toolPanel(tool, expanded) {
 }
 function collapsedToolSummary(tools, finalized) {
   const suffix = finalized ? "\uFF08\u5DF2\u7ED3\u675F\uFF09" : "";
+  const lines = tools.map(toolSummaryLine);
+  let body = lines.join("\n");
+  if (body.length > SUMMARY_BODY_MAX) {
+    let kept = 0;
+    let acc = 0;
+    for (const line of lines) {
+      if (acc + line.length + 1 > SUMMARY_BODY_MAX) break;
+      acc += line.length + 1;
+      kept++;
+    }
+    body = `${lines.slice(0, kept).join("\n")}
+- _\u2026\u8FD8\u6709 ${tools.length - kept} \u4E2A\u547D\u4EE4\u672A\u663E\u793A_`;
+  }
   return collapsiblePanel({
-    title: `\u2615 **${tools.length} \u4E2A\u5DE5\u5177\u8C03\u7528${suffix}**`,
+    title: `\u{1F9F0} **${tools.length} \u4E2A\u5DE5\u5177\u8C03\u7528${suffix}**`,
     expanded: false,
     border: "blue",
-    body: tools.map((t) => `- ${toolHeaderText(t)}`).join("\n")
+    body
   });
 }
 function footerStatusText(status) {
@@ -11282,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;
@@ -11315,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);
@@ -11352,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;
@@ -11380,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;
@@ -11696,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");
@@ -11715,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();
@@ -11839,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;
@@ -12707,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.4",
+  "version": "0.6.6",
   "description": "Bridge Feishu/Lark messenger with local Codex via app-server (project=group, thread=session)",
   "type": "module",
   "bin": {