chatccc 0.2.222 → 0.2.224

package/src/cards.ts

@@ -1,10 +1,11 @@
-// ---------------------------------------------------------------------------
-// Button helpers
-// ---------------------------------------------------------------------------
-
-import { ABD_HELP_LINE } from "./shared-prefix.ts";
-
-export interface ButtonDef {
+// ---------------------------------------------------------------------------
+// Button helpers
+// ---------------------------------------------------------------------------
+
+import { ABD_HELP_LINE } from "./shared-prefix.ts";
+import type { ProgressView } from "./progress/view.ts";
+
+export interface ButtonDef {
   text: string;
   value: string;
   type?: "primary" | "default" | "danger";
@@ -100,13 +101,17 @@ export function normalizeToolName(name: string): string {
 // ---------------------------------------------------------------------------
 
 // CardKit schema 2.0 进度卡片（带停止按钮，支持流式更新）
-export function buildProgressCard(
-  text: string,
-  opts: { showStop?: boolean; headerTitle?: string; headerTemplate?: string } = {}
-): string {
-  const { showStop = true, headerTitle = "生成中...", headerTemplate = "blue" } = opts;
+// 输入是平台无关的 ProgressView（与终端过程区块共享同一视图模型）：
+//   - view.text           → main_content（正文）
+//   - view.showStop       → 是否展示状态/停止按钮
+//   - view.headerTitle    → 卡片头部标题（生成中阶段的动态标题）
+//   - view.headerTemplate → 卡片头部颜色模板
+export function buildProgressCard(view: ProgressView): string {
+  const showStop = view.showStop;
+  const headerTitle = view.headerTitle;
+  const headerTemplate = view.headerTemplate;
   const elements: object[] = [
-    { tag: "markdown", content: truncateContent(text), element_id: "main_content" },
+    { tag: "markdown", content: truncateContent(view.text), element_id: "main_content" },
   ];
   if (showStop) {
     elements.push({ tag: "hr" });
@@ -152,16 +157,16 @@ export function buildHelpCard(
     `发送 **/new** 创建新会话（使用 /cd 设置的目录，默认 ${defaultToolLabel}）`,
     "发送 **/new claude** 创建新 Claude 会话",
     "发送 **/new cursor** 创建新 Cursor 会话",
-    "发送 **/new codex** 创建新 Codex 会话",
-    "发送 **/new ccc** 创建新 CCC Agent 会话",
+    "发送 **/new codex** 创建新 Codex 会话",
+    "发送 **/new ccc** 创建新 CCC Agent 会话",
     "发送 **/newh** 重置当前会话（沿用当前工作目录，不切换）",
     "发送 **/plan** 以规划模式提问（只读，不执行写操作）",
     "发送 **/ask** 以问答模式提问（只读，不执行写操作）",
-    "发送 **/usage** 查看当前 Agent 的用量或余额",
-    "发送 **/restart** 重启 ChatCCC 进程",
-    "发送 **/update** 更新并重启（仅 npm 全局安装可用）",
-    ABD_HELP_LINE,
-  ].join("\n");
+    "发送 **/usage** 查看当前 Agent 的用量或余额",
+    "发送 **/restart** 重启 ChatCCC 进程",
+    "发送 **/update** 更新并重启（仅 npm 全局安装可用）",
+    ABD_HELP_LINE,
+  ].join("\n");
   return JSON.stringify({
     config: { wide_screen_mode: true },
     header: { template: "blue", title: { content: "ChatCCC", tag: "plain_text" } },
@@ -172,8 +177,8 @@ export function buildHelpCard(
         { text: `新建默认会话（/new，${defaultToolLabel}）`, value: JSON.stringify({ cmd: "new" }), type: "primary" },
         { text: "新建 Claude 会话（/new claude）", value: JSON.stringify({ cmd: "new claude" }), type: "primary" },
         { text: "新建 Cursor 会话（/new cursor）", value: JSON.stringify({ cmd: "new cursor" }), type: "primary" },
-        { text: "新建 Codex 会话（/new codex）", value: JSON.stringify({ cmd: "new codex" }), type: "primary" },
-        { text: "新建 CCC Agent 会话（/new ccc）", value: JSON.stringify({ cmd: "new ccc" }), type: "primary" },
+        { text: "新建 Codex 会话（/new codex）", value: JSON.stringify({ cmd: "new codex" }), type: "primary" },
+        { text: "新建 CCC Agent 会话（/new ccc）", value: JSON.stringify({ cmd: "new ccc" }), type: "primary" },
         { text: "重启 ChatCCC（/restart）", value: JSON.stringify({ cmd: "restart" }), type: "danger" },
         { text: "更新并重启（/update）", value: JSON.stringify({ cmd: "update" }), type: "danger" },
         { text: "切换工作路径（/cd）", value: JSON.stringify({ cmd: "cd" }), type: "default" },
@@ -198,9 +203,9 @@ export function buildCdContent(
     ? `**当前会话工作路径:** \`${currentCwd}\``
     : "";
 
-  const statusLine = isUpdate
-    ? `**后续新建会话默认工作路径（已切换）:** \`${dirPath}\``
-    : `**后续新建会话默认工作路径:** \`${dirPath}\``;
+  const statusLine = isUpdate
+    ? `**后续新建会话默认工作路径（已切换）:** \`${dirPath}\``
+    : `**后续新建会话默认工作路径:** \`${dirPath}\``;
 
   const lines: string[] = [];
   if (currentLine) lines.push(currentLine, "");
@@ -247,10 +252,10 @@ export function buildCdCard(
       text: { tag: "lark_md", content: `**当前会话工作路径:** \`${sessionCwd}\`` },
     });
   }
-  elements.push({
-    tag: "div",
-    text: { tag: "lark_md", content: `**后续新建会话默认工作路径:** \`${dirPath}\`` },
-  });
+  elements.push({
+    tag: "div",
+    text: { tag: "lark_md", content: `**后续新建会话默认工作路径:** \`${dirPath}\`` },
+  });
 
   if (recentDirs.length > 0) {
     elements.push({ tag: "hr" });
@@ -295,78 +300,78 @@ export function buildCdCard(
   });
 }
 
-function sessionToolLabel(tool: string): string {
-  if (tool === "cursor") return "Cursor";
-  if (tool === "codex") return "Codex";
-  if (tool === "ccc") return "CCC Agent";
-  return "Claude Code";
-}
-
-function pushSessionGroup(
-  lines: string[],
-  title: string,
-  sessions: Array<{
-    sessionId: string;
-    chatName: string;
-    chatId: string;
-    active: boolean;
-    turnCount: number;
-    elapsedSeconds: number | null;
-    model: string;
-    tool: string;
-  }>,
-  formatSession: (session: {
-    sessionId: string;
-    chatName: string;
-    chatId: string;
-    active: boolean;
-    turnCount: number;
-    elapsedSeconds: number | null;
-    model: string;
-    tool: string;
-  }, index: number) => string,
-  index: { value: number },
-): void {
-  if (sessions.length === 0) return;
-  if (index.value > 0) lines.push("", `**${title}:**`, "");
-  else lines.push(`**${title}:**`, "");
-  for (const session of sessions) {
-    lines.push(formatSession(session, index.value++));
-  }
-}
-
-// 所有会话列表卡片（Claude Code 优先，然后 Cursor）
-export function buildSessionsCard(sessions: Array<{
-  sessionId: string;
-  chatName: string;
-  chatId: string;
-  chatType?: string;
-  active: boolean;
+function sessionToolLabel(tool: string): string {
+  if (tool === "cursor") return "Cursor";
+  if (tool === "codex") return "Codex";
+  if (tool === "ccc") return "CCC Agent";
+  return "Claude Code";
+}
+
+function pushSessionGroup(
+  lines: string[],
+  title: string,
+  sessions: Array<{
+    sessionId: string;
+    chatName: string;
+    chatId: string;
+    active: boolean;
+    turnCount: number;
+    elapsedSeconds: number | null;
+    model: string;
+    tool: string;
+  }>,
+  formatSession: (session: {
+    sessionId: string;
+    chatName: string;
+    chatId: string;
+    active: boolean;
+    turnCount: number;
+    elapsedSeconds: number | null;
+    model: string;
+    tool: string;
+  }, index: number) => string,
+  index: { value: number },
+): void {
+  if (sessions.length === 0) return;
+  if (index.value > 0) lines.push("", `**${title}:**`, "");
+  else lines.push(`**${title}:**`, "");
+  for (const session of sessions) {
+    lines.push(formatSession(session, index.value++));
+  }
+}
+
+// 所有会话列表卡片（Claude Code 优先，然后 Cursor）
+export function buildSessionsCard(sessions: Array<{
+  sessionId: string;
+  chatName: string;
+  chatId: string;
+  chatType?: string;
+  active: boolean;
   turnCount: number;
   elapsedSeconds: number | null;
   model: string;
   tool: string;
-}>, opts: { defaultToolLabel?: string; fixedPrivateSession?: boolean } = {}): string {
-  const defaultToolLabel = opts.defaultToolLabel ?? "Claude Code";
-  const fixedPrivateSession = opts.fixedPrivateSession ?? false;
-  // 按 tool 分组排序：Claude Code 在前，Cursor 其次，Codex 最后
-  const claudeCodeSessions = sessions.filter(s => s.tool !== "cursor" && s.tool !== "codex" && s.tool !== "ccc");
-  const cursorSessions = sessions.filter(s => s.tool === "cursor");
-  const codexSessions = sessions.filter(s => s.tool === "codex");
-  const cccSessions = sessions.filter(s => s.tool === "ccc");
-  const hasClaudeCode = claudeCodeSessions.length > 0;
-  const hasCursor = cursorSessions.length > 0;
-  const hasCodex = codexSessions.length > 0;
-  const hasCcc = cccSessions.length > 0;
+}>, opts: { defaultToolLabel?: string; fixedPrivateSession?: boolean } = {}): string {
+  const defaultToolLabel = opts.defaultToolLabel ?? "Claude Code";
+  const fixedPrivateSession = opts.fixedPrivateSession ?? false;
+  // 按 tool 分组排序：Claude Code 在前，Cursor 其次，Codex 最后
+  const claudeCodeSessions = sessions.filter(s => s.tool !== "cursor" && s.tool !== "codex" && s.tool !== "ccc");
+  const cursorSessions = sessions.filter(s => s.tool === "cursor");
+  const codexSessions = sessions.filter(s => s.tool === "codex");
+  const cccSessions = sessions.filter(s => s.tool === "ccc");
+  const hasClaudeCode = claudeCodeSessions.length > 0;
+  const hasCursor = cursorSessions.length > 0;
+  const hasCodex = codexSessions.length > 0;
+  const hasCcc = cccSessions.length > 0;
 
   if (sessions.length === 0) {
     return JSON.stringify({
       config: { wide_screen_mode: true },
       header: { template: "blue", title: { content: "所有会话", tag: "plain_text" } },
       elements: [
-        { tag: "div", text: { tag: "lark_md", content: fixedPrivateSession
-          ? `当前没有会话记录。\n\n直接发送普通消息即可创建飞书私聊专属 ${defaultToolLabel} 会话；默认 Agent 变化后，下一条普通消息会创建对应 Agent 的新空会话。发送 **/new**、**/new claude**、**/new cursor**、**/new codex** 或 **/new ccc** 会另外创建会话群。`
-          : `当前没有会话记录。\n\n使用 **/new**（默认 ${defaultToolLabel}）、**/new claude**、**/new cursor**、**/new codex** 或 **/new ccc** 创建新会话。\n创建后可在任意会话群内发送 **/sessions** 查看列表，用 **/session 数字** 切换会话。` } },
+        { tag: "div", text: { tag: "lark_md", content: fixedPrivateSession
+          ? `当前没有会话记录。\n\n直接发送普通消息即可创建飞书私聊专属 ${defaultToolLabel} 会话；默认 Agent 变化后，下一条普通消息会创建对应 Agent 的新空会话。发送 **/new**、**/new claude**、**/new cursor**、**/new codex** 或 **/new ccc** 会另外创建会话群。`
+          : `当前没有会话记录。\n\n使用 **/new**（默认 ${defaultToolLabel}）、**/new claude**、**/new cursor**、**/new codex** 或 **/new ccc** 创建新会话。\n创建后可在任意会话群内发送 **/sessions** 查看列表，用 **/session 数字** 切换会话。` } },
         { tag: "hr" },
         { tag: "action", actions: [{ tag: "button", text: { tag: "plain_text", content: "收起" }, type: "default", value: { action: "close" } }] },
       ],
@@ -382,24 +387,24 @@ export function buildSessionsCard(sessions: Array<{
       const secs = s.elapsedSeconds % 60;
       extra = ` | 本轮: ${mins}分${secs}秒`;
     }
-    const toolLabel = sessionToolLabel(s.tool);
+    const toolLabel = sessionToolLabel(s.tool);
     const namePart = s.chatName ? `**${s.chatName}** ` : "";
-    const chatTag = !s.chatId
-      ? " (chat id缺失)"
-      : s.chatType === "p2p"
-        ? " (私聊)"
-        : s.chatType === "group" || (s.chatType == null && s.chatId.startsWith("oc_"))
-          ? " (群聊)"
-          : "";
+    const chatTag = !s.chatId
+      ? " (chat id缺失)"
+      : s.chatType === "p2p"
+        ? " (私聊)"
+        : s.chatType === "group" || (s.chatType == null && s.chatId.startsWith("oc_"))
+          ? " (群聊)"
+          : "";
     return `**${i + 1}.** ${namePart}${chatTag} \`${shortId}\` ${status} | 工具: ${toolLabel} | 轮数: ${s.turnCount} | ${s.model}${extra}`;
   };
 
   const lines: string[] = [`共 **${sessions.length}** 个会话:`, ""];
-  const idx = { value: 0 };
-  if (hasClaudeCode) pushSessionGroup(lines, "Claude Code 会话", claudeCodeSessions, formatSession, idx);
-  if (hasCursor) pushSessionGroup(lines, "Cursor 会话", cursorSessions, formatSession, idx);
-  if (hasCodex) pushSessionGroup(lines, "Codex 会话", codexSessions, formatSession, idx);
-  if (hasCcc) pushSessionGroup(lines, "CCC Agent 会话", cccSessions, formatSession, idx);
+  const idx = { value: 0 };
+  if (hasClaudeCode) pushSessionGroup(lines, "Claude Code 会话", claudeCodeSessions, formatSession, idx);
+  if (hasCursor) pushSessionGroup(lines, "Cursor 会话", cursorSessions, formatSession, idx);
+  if (hasCodex) pushSessionGroup(lines, "Codex 会话", codexSessions, formatSession, idx);
+  if (hasCcc) pushSessionGroup(lines, "CCC Agent 会话", cccSessions, formatSession, idx);
 
   return JSON.stringify({
     config: { wide_screen_mode: true },
@@ -407,9 +412,9 @@ export function buildSessionsCard(sessions: Array<{
     elements: [
       { tag: "div", text: { tag: "lark_md", content: lines.join("\n") } },
       { tag: "hr" },
-      { tag: "div", text: { tag: "lark_md", content: fixedPrivateSession
-        ? "当前飞书私聊使用专属会话；默认 Agent 变化后，下一条普通消息会自动创建对应 Agent 的新空会话。发送 **/newh** 可在私聊中原地重置。群聊会话请回到对应群聊继续，私聊不支持 **/session** 切换。"
-        : "在会话群内发送 **/newh** 可重置当前会话（创建新 Session，保留工作目录和群聊）。\n发送 **/session 数字**（如 `/session 1`）可将当前群聊切换到列表中对应编号的会话。" } },
+      { tag: "div", text: { tag: "lark_md", content: fixedPrivateSession
+        ? "当前飞书私聊使用专属会话；默认 Agent 变化后，下一条普通消息会自动创建对应 Agent 的新空会话。发送 **/newh** 可在私聊中原地重置。群聊会话请回到对应群聊继续，私聊不支持 **/session** 切换。"
+        : "在会话群内发送 **/newh** 可重置当前会话（创建新 Session，保留工作目录和群聊）。\n发送 **/session 数字**（如 `/session 1`）可将当前群聊切换到列表中对应编号的会话。" } },
       { tag: "hr" },
       {
         tag: "action",
@@ -466,11 +471,11 @@ export function buildQueueFullCard(): string {
 }
 
 // 状态卡片（带关闭按钮）
-export function buildStatusCard(statusText: string, template = "blue"): string {
-  return JSON.stringify({
-    config: { wide_screen_mode: true },
-    header: { template, title: { content: "会话状态", tag: "plain_text" } },
-    elements: [
+export function buildStatusCard(statusText: string, template = "blue"): string {
+  return JSON.stringify({
+    config: { wide_screen_mode: true },
+    header: { template, title: { content: "会话状态", tag: "plain_text" } },
+    elements: [
       { tag: "div", text: { tag: "lark_md", content: statusText } },
       { tag: "hr" },
       {
@@ -482,82 +487,82 @@ export function buildStatusCard(statusText: string, template = "blue"): string {
           value: { action: "close" },
         }],
       },
-    ],
-  });
-}
-
-export function buildCodexUsageCard(content: string, resetCreditsAvailable: number | null): string {
-  const elements: object[] = [
-    { tag: "div", text: { tag: "lark_md", content } },
-  ];
-  if (resetCreditsAvailable !== null && resetCreditsAvailable > 0) {
-    elements.push({ tag: "hr" });
-    elements.push({
-      tag: "action",
-      actions: [{
-        tag: "button",
-        text: { tag: "plain_text", content: "发起重置" },
-        type: "primary",
-        value: { action: "codex_reset_request", availableCount: resetCreditsAvailable },
-      }],
-    });
-  }
-
-  return JSON.stringify({
-    config: { wide_screen_mode: true },
-    header: { template: "blue", title: { content: "Codex Usage", tag: "plain_text" } },
-    elements,
-  });
-}
-
-export function buildCodexResetConfirmCard(params: {
-  availableCount: number;
-  parentMessageId: string;
-  requestId: string;
-}): string {
-  const valueBase = {
-    parentMessageId: params.parentMessageId,
-    requestId: params.requestId,
-  };
-  return JSON.stringify({
-    config: { wide_screen_mode: true },
-    header: { template: "yellow", title: { content: "确认 Codex 主动重置", tag: "plain_text" } },
-    elements: [
-      {
-        tag: "div",
-        text: {
-          tag: "lark_md",
-          content: `当前可用主动重置次数：**${params.availableCount}**。\n\n确认后会消耗 1 次主动重置，并重置当前可重置的 Codex 用量窗口。`,
-        },
-      },
-      { tag: "hr" },
-      {
-        tag: "action",
-        actions: [
-          {
-            tag: "button",
-            text: { tag: "plain_text", content: "是，发起重置" },
-            type: "danger",
-            value: { action: "codex_reset_confirm", decision: "yes", ...valueBase },
-          },
-          {
-            tag: "button",
-            text: { tag: "plain_text", content: "否" },
-            type: "default",
-            value: { action: "codex_reset_confirm", decision: "no", ...valueBase },
-          },
-        ],
-      },
-    ],
-  });
-}
-
-/** 模型切换卡片（/model 命令，飞书专用，含切换按钮） */
-export function buildModelCard(
-  currentModel: string,
-  models: string[],
-  tool?: string,
-): string {
+    ],
+  });
+}
+
+export function buildCodexUsageCard(content: string, resetCreditsAvailable: number | null): string {
+  const elements: object[] = [
+    { tag: "div", text: { tag: "lark_md", content } },
+  ];
+  if (resetCreditsAvailable !== null && resetCreditsAvailable > 0) {
+    elements.push({ tag: "hr" });
+    elements.push({
+      tag: "action",
+      actions: [{
+        tag: "button",
+        text: { tag: "plain_text", content: "发起重置" },
+        type: "primary",
+        value: { action: "codex_reset_request", availableCount: resetCreditsAvailable },
+      }],
+    });
+  }
+
+  return JSON.stringify({
+    config: { wide_screen_mode: true },
+    header: { template: "blue", title: { content: "Codex Usage", tag: "plain_text" } },
+    elements,
+  });
+}
+
+export function buildCodexResetConfirmCard(params: {
+  availableCount: number;
+  parentMessageId: string;
+  requestId: string;
+}): string {
+  const valueBase = {
+    parentMessageId: params.parentMessageId,
+    requestId: params.requestId,
+  };
+  return JSON.stringify({
+    config: { wide_screen_mode: true },
+    header: { template: "yellow", title: { content: "确认 Codex 主动重置", tag: "plain_text" } },
+    elements: [
+      {
+        tag: "div",
+        text: {
+          tag: "lark_md",
+          content: `当前可用主动重置次数：**${params.availableCount}**。\n\n确认后会消耗 1 次主动重置，并重置当前可重置的 Codex 用量窗口。`,
+        },
+      },
+      { tag: "hr" },
+      {
+        tag: "action",
+        actions: [
+          {
+            tag: "button",
+            text: { tag: "plain_text", content: "是，发起重置" },
+            type: "danger",
+            value: { action: "codex_reset_confirm", decision: "yes", ...valueBase },
+          },
+          {
+            tag: "button",
+            text: { tag: "plain_text", content: "否" },
+            type: "default",
+            value: { action: "codex_reset_confirm", decision: "no", ...valueBase },
+          },
+        ],
+      },
+    ],
+  });
+}
+
+/** 模型切换卡片（/model 命令，飞书专用，含切换按钮） */
+export function buildModelCard(
+  currentModel: string,
+  models: string[],
+  tool?: string,
+): string {
   const toolLabel = tool ? ` (${tool})` : "";
   const currentLine = currentModel
     ? `**当前模型:** \`${currentModel}\``
@@ -574,12 +579,12 @@ export function buildModelCard(
     lines.push("", "没有可切换的模型。请在 config.json 中配置模型字段。");
   }
 
-  if (tool === "codex") {
-    lines.push("输入 `/fast` 查看或切换当前会话的 Fast 模式");
-  }
-
-  const buttons: ButtonDef[] = [];
-  for (const m of models.slice(0, 20)) {
+  if (tool === "codex") {
+    lines.push("输入 `/fast` 查看或切换当前会话的 Fast 模式");
+  }
+
+  const buttons: ButtonDef[] = [];
+  for (const m of models.slice(0, 20)) {
     const shortName = m.includes("/") ? m.slice(m.lastIndexOf("/") + 1) : m;
     buttons.push({
       text: `/model ${shortName}`,
@@ -595,85 +600,85 @@ export function buildModelCard(
       { tag: "div", text: { tag: "lark_md", content: lines.join("\n") } },
       { tag: "hr" },
       buildButtons(buttons),
-    ],
-  });
-}
-
-export function buildFastModeCard(enabled: boolean): string {
-  const mode = enabled ? "ON (Fast)" : "OFF (Standard)";
-  return JSON.stringify({
-    config: { wide_screen_mode: true },
-    header: {
-      template: enabled ? "green" : "blue",
-      title: { content: "Codex Fast 模式", tag: "plain_text" },
-    },
-    elements: [
-      {
-        tag: "div",
-        text: {
-          tag: "lark_md",
-          content: [
-            `**当前模式:** ${mode}`,
-            "",
-            "切换将在下一条消息生效，当前生成不中断。",
-          ].join("\n"),
-        },
-      },
-      { tag: "hr" },
-      buildButtons([
-        {
-          text: "ON",
-          value: JSON.stringify({ cmd: "/fast on" }),
-          type: enabled ? "primary" : "default",
-        },
-        {
-          text: "OFF",
-          value: JSON.stringify({ cmd: "/fast off" }),
-          type: enabled ? "default" : "primary",
-        },
-      ]),
-    ],
-  });
-}
-
-export function buildEffortCard(
-  currentEffort: string,
-  efforts: string[],
-  tool?: string,
-): string {
-  const toolLabel = tool ? ` (${tool})` : "";
-  const currentLine = currentEffort
-    ? `**当前 effort:** \`${currentEffort}\``
-    : "**当前 effort:** 未指定";
-
-  const lines: string[] = [currentLine];
-  if (efforts.length > 0) {
-    lines.push("", "**可切换 effort**");
-    for (const effort of efforts) {
-      lines.push(`- \`${effort}\``);
-    }
-    lines.push("", "点击按钮切换 effort，或输入 `/effort clear` 恢复默认");
-  } else {
-    lines.push("", "当前 agent 不支持 effort 切换。");
-  }
-
-  const buttons: ButtonDef[] = [];
-  for (const effort of efforts.slice(0, 20)) {
-    buttons.push({
-      text: `/effort ${effort}`,
-      value: JSON.stringify({ cmd: `/effort ${effort}` }),
-      type: "primary",
-    });
-  }
-
-  return JSON.stringify({
-    config: { wide_screen_mode: true },
-    header: { template: "blue", title: { content: `Effort 切换${toolLabel}`, tag: "plain_text" } },
-    elements: [
-      { tag: "div", text: { tag: "lark_md", content: lines.join("\n") } },
-      { tag: "hr" },
-      buildButtons(buttons),
-    ],
-  });
-}
+    ],
+  });
+}
+
+export function buildFastModeCard(enabled: boolean): string {
+  const mode = enabled ? "ON (Fast)" : "OFF (Standard)";
+  return JSON.stringify({
+    config: { wide_screen_mode: true },
+    header: {
+      template: enabled ? "green" : "blue",
+      title: { content: "Codex Fast 模式", tag: "plain_text" },
+    },
+    elements: [
+      {
+        tag: "div",
+        text: {
+          tag: "lark_md",
+          content: [
+            `**当前模式:** ${mode}`,
+            "",
+            "切换将在下一条消息生效，当前生成不中断。",
+          ].join("\n"),
+        },
+      },
+      { tag: "hr" },
+      buildButtons([
+        {
+          text: "ON",
+          value: JSON.stringify({ cmd: "/fast on" }),
+          type: enabled ? "primary" : "default",
+        },
+        {
+          text: "OFF",
+          value: JSON.stringify({ cmd: "/fast off" }),
+          type: enabled ? "default" : "primary",
+        },
+      ]),
+    ],
+  });
+}
+
+export function buildEffortCard(
+  currentEffort: string,
+  efforts: string[],
+  tool?: string,
+): string {
+  const toolLabel = tool ? ` (${tool})` : "";
+  const currentLine = currentEffort
+    ? `**当前 effort:** \`${currentEffort}\``
+    : "**当前 effort:** 未指定";
+
+  const lines: string[] = [currentLine];
+  if (efforts.length > 0) {
+    lines.push("", "**可切换 effort**");
+    for (const effort of efforts) {
+      lines.push(`- \`${effort}\``);
+    }
+    lines.push("", "点击按钮切换 effort，或输入 `/effort clear` 恢复默认");
+  } else {
+    lines.push("", "当前 agent 不支持 effort 切换。");
+  }
+
+  const buttons: ButtonDef[] = [];
+  for (const effort of efforts.slice(0, 20)) {
+    buttons.push({
+      text: `/effort ${effort}`,
+      value: JSON.stringify({ cmd: `/effort ${effort}` }),
+      type: "primary",
+    });
+  }
+
+  return JSON.stringify({
+    config: { wide_screen_mode: true },
+    header: { template: "blue", title: { content: `Effort 切换${toolLabel}`, tag: "plain_text" } },
+    elements: [
+      { tag: "div", text: { tag: "lark_md", content: lines.join("\n") } },
+      { tag: "hr" },
+      buildButtons(buttons),
+    ],
+  });
+}