@armadra/agent 0.3.0 → 0.5.0

package/dist/modes/interactive/key-dispatch.js

@@ -3,15 +3,46 @@
  *
  * 编辑器之前的输入监听：Ctrl+C 清空输入 / 再按退出、Esc 中断（clearQueue 回填编辑器后 abort）、
  * Ctrl+D 空输入退出、Alt+Enter followUp、Alt+↑ 取回最后一条排队消息、Shift+Tab 循环权限模式、
- * Ctrl+O 展开工具输出、Ctrl+L 模型、Ctrl+T 思考级别。键位由 `keybindings.json` 覆盖。
+ * Ctrl+O 展开工具输出与思考块、Ctrl+L 模型、Ctrl+T 思考级别、Ctrl+G 底部信息行 full ↔ compact（W5-A）、
+ * Ctrl+V 粘贴剪贴板图片（`app.paste.image`，W5-U）。
+ * 键位由 `keybindings.json` 覆盖。
+ *
+ * [RW-C] 空闲时双击 Esc（`app.rewind`，double-esc.ts）：输入框为空打开回滚列表，有字则清空并存进
+ * 输入历史；运行中 Esc 仍为中断，中断后交给 `onInterrupted`（中断即撤回）。
  */
 import { ExitCode } from "../../cli/exit-codes.js";
-import { PERMISSION_MODES_STRICT_FIRST } from "../../permissions/types.js";
+import { nextCycleMode, permissionModeLabel } from "../../permissions/modes.js";
+import { DOUBLE_ESC_HINT_MS, DoubleEscape } from "./double-esc.js";
+import { statusLineText } from "./status-area.js";
 const DOUBLE_CTRL_C_MS = 1500;
 /** 返回输入监听器：已处理返回 true，交给编辑器返回 false。 */
 export function createKeyDispatch(deps) {
     const { keys, editor, tools, status } = deps;
     let ctrlCArmedAt = Number.NEGATIVE_INFINITY;
+    const esc = new DoubleEscape(deps.doubleEscMs);
+    const doubleEscape = () => {
+        switch (esc.press(deps.now(), editor.isEmpty())) {
+            case "arm-rewind":
+                deps.showHint("再按 Esc 回滚", DOUBLE_ESC_HINT_MS);
+                return;
+            case "arm-clear":
+                deps.showHint("再按 Esc 清空", DOUBLE_ESC_HINT_MS);
+                return;
+            case "rewind":
+                deps.showHint("");
+                deps.runCommand("/rewind");
+                return;
+            case "clear": {
+                // 记进输入历史再清空：↑ 可取回
+                const text = editor.getExpandedText();
+                if (text.trim() !== "")
+                    editor.addToHistory(text);
+                editor.clear();
+                deps.showHint("已清空输入 · ↑ 取回");
+                return;
+            }
+        }
+    };
     const interrupt = () => {
         const session = deps.session();
         const queued = session.clearQueue();
@@ -39,17 +70,17 @@ export function createKeyDispatch(deps) {
     };
     const cyclePermission = () => {
         const session = deps.session();
-        const modes = PERMISSION_MODES_STRICT_FIRST;
-        const index = modes.indexOf(session.state.permissionMode);
-        const next = modes[(index + 1) % modes.length];
+        const next = nextCycleMode(session.state.permissionMode);
         session.setPermissionMode(next);
         status.refresh();
-        deps.showHint(`权限模式：${next}`);
+        deps.showHint(`权限模式：${permissionModeLabel(next)}`);
     };
     return (data) => {
         if (deps.inactive())
             return false;
         const is = (action) => keys.matches(data, action);
+        if (!is("app.rewind"))
+            esc.reset();
         if (is("app.clear")) {
             if (!editor.isEmpty()) {
                 editor.clear();
@@ -67,8 +98,14 @@ export function createKeyDispatch(deps) {
         }
         ctrlCArmedAt = Number.NEGATIVE_INFINITY;
         if (is("app.interrupt") && !editor.isCompletionOpen && deps.busy()) {
+            esc.reset();
             interrupt();
             deps.showHint("已中断");
+            deps.onInterrupted?.(editor.isEmpty());
+            return true;
+        }
+        if (is("app.rewind") && !editor.isCompletionOpen && !deps.busy()) {
+            doubleEscape();
             return true;
         }
         if (is("app.exit") && editor.isEmpty()) {
@@ -91,6 +128,7 @@ export function createKeyDispatch(deps) {
         }
         if (is("app.tools.expand")) {
             const expanded = tools.toggleExpanded();
+            deps.onExpandToggle?.(expanded);
             deps.showHint(expanded ? "工具输出：展开" : "工具输出：折叠");
             return true;
         }
@@ -102,6 +140,15 @@ export function createKeyDispatch(deps) {
             deps.runCommand("/thinking");
             return true;
         }
+        if (is("app.paste.image") && deps.onPasteImage !== undefined) {
+            deps.onPasteImage();
+            return true;
+        }
+        if (is("app.statusLine.toggle") && deps.onStatusLineToggle !== undefined) {
+            const mode = deps.onStatusLineToggle();
+            deps.showHint(statusLineText(mode));
+            return true;
+        }
         return false;
     };
 }

package/dist/modes/interactive/line/line-mode.d.ts

@@ -5,7 +5,9 @@
  *   = steer；Ctrl+C 运行中中断、空闲时连按两次退出（130）；空行 Ctrl+D 退出；审批 y / a / N 单键问答。
  *   问句之前逐行打印执行前预览（`request.preview`，W3-B9a-2）。
  * - 否则（管道）：逐行读 stdin，每行依次执行（等上一条运行结束）；没有审批 UI，ask → deny。
- * - 斜杠命令走 commands-core（与 B7 同一语义），`pick` 退化为列出候选。
+ *   模型错误在运行结束时只打印一次（重试中只显示 ↻）；有运行最终失败时退出码 1。
+ * - 斜杠命令走 commands-core（与 B7 同一语义），`pick` 退化为列出候选；`/rewind` 列编号、
+ *   `/rewind <n> …` 执行，回到的单行原消息放回编辑行。
  */
 import type { ModeContext } from "../../../cli/deps.js";
 import type { Runtime } from "../../../cli/runtime.js";

package/dist/modes/interactive/line/line-mode.js

@@ -5,9 +5,12 @@
  *   = steer；Ctrl+C 运行中中断、空闲时连按两次退出（130）；空行 Ctrl+D 退出；审批 y / a / N 单键问答。
  *   问句之前逐行打印执行前预览（`request.preview`，W3-B9a-2）。
  * - 否则（管道）：逐行读 stdin，每行依次执行（等上一条运行结束）；没有审批 UI，ask → deny。
- * - 斜杠命令走 commands-core（与 B7 同一语义），`pick` 退化为列出候选。
+ *   模型错误在运行结束时只打印一次（重试中只显示 ↻）；有运行最终失败时退出码 1。
+ * - 斜杠命令走 commands-core（与 B7 同一语义），`pick` 退化为列出候选；`/rewind` 列编号、
+ *   `/rewind <n> …` 执行，回到的单行原消息放回编辑行。
  */
 import { promptImages, sessionModel } from "../../image-input.js";
+import { taskRegistryView } from "../../../agent/subagent-registry.js";
 import { currentSession, switchSession } from "../../../cli/compose-session.js";
 import { ExitCode } from "../../../cli/exit-codes.js";
 import { previewDisplayLines } from "../../../permissions/preview.js";
@@ -63,22 +66,37 @@ export async function runLineMode(runtime, context, options = {}) {
                 await prompt(session, result.text);
             else if (result.kind === "pick")
                 out(`${await pickHint(result.what, runtime, session)}\n`);
-            else if (result.message !== undefined)
-                out(`${result.message}\n`);
+            else {
+                if (result.message !== undefined)
+                    out(`${result.message}\n`);
+                // /rewind 回到某条消息之前：单行原消息放回编辑行（多行只在输出里给出）
+                const draft = result.draft?.text;
+                if (editor !== undefined && draft !== undefined && !draft.includes("\n")) {
+                    editor.buffer = draft;
+                    editor.cursor = draft.length;
+                }
+                // /plan approve 开了新回合：跑完再收下一行（与直接发提示一致）
+                if (result.wait === true) {
+                    await session.waitForIdle();
+                    printer.endLine();
+                }
+            }
         }
         catch (error) {
             printer.endLine();
+            printer.failures++;
             err(`ama: ${errorText(error)}\n`);
         }
         return undefined;
     };
     const prompt = async (target, text) => {
-        const images = await promptImages(text, [], target.state.cwd, sessionModel(runtime.providers, target));
+        const resize = runtime.config.images?.resize;
+        const images = await promptImages(text, [], target.state.cwd, sessionModel(runtime.providers, target), resize !== undefined ? { resize } : {});
         await target.prompt(text, images.length > 0 ? { images } : {});
         printer.endLine();
     };
     if (!raw)
-        return runPiped(stdin, context, handle, () => session, () => unsubscribe());
+        return runPiped(stdin, context, handle, () => session, () => unsubscribe(), () => printer.failures > 0);
     // ---- raw 终端 ----
     const tty = stdin;
     editor = new LineEditor({ prompt: "› ", write: (t) => io.stdout(t) });
@@ -93,7 +111,8 @@ export async function runLineMode(runtime, context, options = {}) {
                 return resolve(undefined);
             signal.addEventListener("abort", () => resolve(undefined), { once: true });
             const preview = previewDisplayLines(request.preview).map((l) => `  ${l}\n`);
-            void ed.ask(`\n${preview.join("")}${approvalQuestion(request)}`, "n").then((answer) => {
+            const question = approvalQuestion(request, (taskId) => taskRegistryView(session.state.sessionId)?.get(taskId)?.agent);
+            void ed.ask(`\n${preview.join("")}${question}`, "n").then((answer) => {
                 resolve(answer === "y" ? "allow" : answer === "a" ? "allow_session" : "deny");
                 if (!busy)
                     ed.render();
@@ -182,8 +201,8 @@ export async function runLineMode(runtime, context, options = {}) {
             ed.render();
     });
 }
-/** 管道：逐行依次执行；stdin 结束后等最后一条跑完退出 0。 */
-function runPiped(stdin, context, handle, session, unsubscribe) {
+/** 管道：逐行依次执行；stdin 结束后等最后一条跑完退出——有失败的运行时 1，否则 0。 */
+function runPiped(stdin, context, handle, session, unsubscribe, failed) {
     return new Promise((resolve) => {
         let chain = Promise.resolve(undefined);
         let finished = false;
@@ -205,7 +224,7 @@ function runPiped(stdin, context, handle, session, unsubscribe) {
             });
         };
         const reader = createLineReader(stdin, enqueue, () => {
-            void chain.then(() => finish(ExitCode.Ok));
+            void chain.then(() => finish(failed() ? ExitCode.RuntimeError : ExitCode.Ok));
         });
         const offSignals = onTerminationSignals((code) => {
             void session()

package/dist/modes/interactive/line/line-render.d.ts

@@ -6,9 +6,10 @@ import type { AgentSession, SessionEvent } from "../../../agent/types.js";
 import type { Runtime } from "../../../cli/runtime.js";
 import type { ApprovalRequest } from "../../../permissions/types.js";
 import type { CommandResult } from "../../commands-core.js";
+import { type TaskAgentLookup } from "../approval-dialog.js";
 /** 工具参数的一行摘要（第一个常见字段，折叠换行、截到 80 字符）。 */
 export declare function argsSummary(args: unknown): string;
-export declare function approvalQuestion(request: ApprovalRequest): string;
+export declare function approvalQuestion(request: ApprovalRequest, taskAgent?: TaskAgentLookup): string;
 /** [W3-C2] 缓存提示的开关（line 模式由 runLineMode 传入）。 */
 export interface EventPrinterOptions {
     /** `cache.missNotices`（每次现取，切换会话后跟随新会话）；缺省 true。 */
@@ -23,6 +24,10 @@ export declare class EventPrinter {
     private readonly err;
     private readonly options;
     private midLine;
+    /** 本次运行的模型错误：等 agent_settled 再打（重试中的失败尝试只显示 ↻ 那一行）。 */
+    private pendingError;
+    /** 最终失败的运行次数（管道模式据此返回退出码 1）。 */
+    failures: number;
     constructor(out: (text: string) => void, err: (text: string) => void, options?: EventPrinterOptions);
     private line;
     /** 收尾：保证光标在行首。 */

package/dist/modes/interactive/line/line-render.js

@@ -4,8 +4,11 @@
  */
 import { THINKING_LEVELS } from "../../../ai/thinking.js";
 import { listSessions } from "../../../cli/compose-store.js";
-import { PERMISSION_MODES_STRICT_FIRST } from "../../../permissions/types.js";
+import { AUTO_LAYER_TEXT, permissionModeLines } from "../../../permissions/modes.js";
 import { cacheEventNotice, warmSentNotice } from "../../session-report.js";
+import { isFirstRunRequest, sourceLabel } from "../approval-dialog.js";
+import { LIMIT_WARNING, backgroundJobText, limitReachedText, modelFallbackText, } from "../event-notices.js";
+import { taskStatusText } from "../tasks-report.js";
 const SUMMARY_KEYS = ["command", "path", "pattern", "file_path", "url", "description", "name"];
 /** 工具参数的一行摘要（第一个常见字段，折叠换行、截到 80 字符）。 */
 export function argsSummary(args) {
@@ -21,14 +24,27 @@ export function argsSummary(args) {
     }
     return "";
 }
-export function approvalQuestion(request) {
-    const task = (request.context?.depth ?? 0) > 0 ? "[task] " : "";
+export function approvalQuestion(request, taskAgent) {
+    const label = sourceLabel(request, taskAgent);
+    const task = label === undefined ? "" : `${label} `;
+    const origin = request.context?.origin;
+    if (origin !== undefined) {
+        const where = origin.toolCall.locations?.[0];
+        return `${task}允许 ${origin.toolCall.title}${where !== undefined ? ` ${where}` : ""}？[y 允许 / a 本会话都允许 / N 拒绝] `;
+    }
+    if (isFirstRunRequest(request)) {
+        const input = request.input;
+        return `${task}${String(input["note"])} 允许？[y 允许 / N 拒绝] `;
+    }
     const summary = argsSummary(request.input);
+    const auto = request.autoDecision;
     const why = request.reason === "dangerous"
         ? "（危险命令）"
         : request.hookReason !== undefined
             ? `（${request.hookReason}）`
-            : "";
+            : auto !== undefined
+                ? `（Auto ${AUTO_LAYER_TEXT[auto.layer]}：${auto.reason}）`
+                : "";
     return `${task}允许 ${request.toolName}${summary !== "" ? ` ${summary}` : ""}${why}？[y 允许 / a 本会话都允许 / N 拒绝] `;
 }
 /** `AMA_LOG=info|debug`。 */
@@ -40,6 +56,10 @@ export class EventPrinter {
     err;
     options;
     midLine = false;
+    /** 本次运行的模型错误：等 agent_settled 再打（重试中的失败尝试只显示 ↻ 那一行）。 */
+    pendingError;
+    /** 最终失败的运行次数（管道模式据此返回退出码 1）。 */
+    failures = 0;
     constructor(out, err, options = {}) {
         this.out = out;
         this.err = err;
@@ -72,9 +92,13 @@ export class EventPrinter {
                 if (event.message.role === "assistant") {
                     this.endLine();
                     if (event.message.stopReason === "error")
-                        this.line(`ama: 错误：${event.message.errorMessage ?? "模型调用失败"}`, true);
+                        this.pendingError = event.message.errorMessage ?? "模型调用失败";
                 }
                 return;
+            case "agent_end":
+                if (event.willRetry)
+                    this.pendingError = undefined;
+                return;
             case "tool_execution_start": {
                 const summary = argsSummary(event.args);
                 this.line(`● ${event.toolName}${summary !== "" ? `  ${summary}` : ""}`);
@@ -112,11 +136,42 @@ export class EventPrinter {
                     this.line(`ama: ${text}`, true);
                 return;
             }
-            case "agent_settled":
+            case "agent_settled": {
                 this.endLine();
-                if (event.warning !== undefined)
+                const error = this.pendingError;
+                this.pendingError = undefined;
+                if (error !== undefined) {
+                    this.failures++;
+                    this.line(`ama: 错误：${error}`, true);
+                }
+                // 失败时 warning 就是同一条错误文本，不再重复打印；预算到限已由 limit_reached 说明
+                if (event.warning !== undefined &&
+                    event.warning !== error &&
+                    event.warning !== LIMIT_WARNING)
                     this.line(`ama: ${event.warning}`, true);
                 return;
+            }
+            // [W5-U] 第五波事件
+            case "plan_proposed": {
+                const file = event.filePath !== undefined ? `（${event.filePath}）` : "";
+                this.line(`◇ 计划 v${event.version} 待审批${file}：/plan approve [模式|fresh] 批准 · /plan reject 放弃 · 直接输入修改意见`);
+                return;
+            }
+            case "subagent_start":
+                this.line(`  ↳ ${event.taskId} ${event.agent}${event.background ? "（后台）" : ""} 开始`);
+                return;
+            case "subagent_end":
+                this.line(`  ↳ ${event.taskId} ${taskStatusText(event.status)}`);
+                return;
+            case "limit_reached":
+                this.line(`ama: ${limitReachedText(event)}`, true);
+                return;
+            case "model_fallback":
+                this.line(`ama: ${modelFallbackText(event)}`, true);
+                return;
+            case "background_job":
+                this.line(`ama: ${backgroundJobText(event)}`, true);
+                return;
             default:
                 return;
         }
@@ -164,7 +219,10 @@ export async function pickHint(what, runtime, session) {
             ].join("\n");
         }
         case "permission":
-            return `权限模式（/permission <模式>）：${PERMISSION_MODES_STRICT_FIRST.join(" | ")}；当前 ${session.state.permissionMode}`;
+            return [
+                "Mode（/permission <模式>）：",
+                ...permissionModeLines(session.state.permissionMode, runtime.config.permission?.mode ?? "default").map((line) => `  ${line}`),
+            ].join("\n");
         case "thinking":
             return `思考级别（/thinking <级别>）：${THINKING_LEVELS.join(" | ")}；当前 ${session.state.thinkingLevel}`;
     }

package/dist/modes/interactive/message-view.d.ts

@@ -1,18 +1,21 @@
 /**
  * 消息区（设计 §12.5）。[B7]
  *
- * 一个纵向 `Container`，块与块之间空一行：
- * - 用户消息 `› 文本`；steer / followUp / 宿主注入按 `UserMessage.origin` 标 `↳ steer` / `↳ host` …；
+ * 一个纵向 `Container`，块与块之间空一行（终端界面视觉设计 v1 §1 原则 2：相邻工具调用之间不空行，
+ * `ui.compact` 时全部不空行）：
+ * - 用户消息 `› 文本`（续行缩进 2 列）；插话 / 之后 / 宿主注入按 `UserMessage.origin` 标
+ *   `↳ 插话` / `↳ 之后` / `↳ 宿主`（整行 muted，其它 origin 原样显示）；
  * - 助手消息按内容块渲染：文本走 `Markdown`（`ui.markdown: false` 时纯文本），流式时只改末块
- *   （Markdown 自己按块缓存）；思考块按 `ui.showThinking`：`collapsed`（缺省）一行 `思考 · N token`、
- *   `full` 显示全文、`hidden` 不显示；
- * - 压缩摘要卡、重试提示、Hook 阻止提示、宿主 / 系统通知；
+ *   （Markdown 自己按块缓存）；思考块按 `ui.showThinking`：`collapsed`（缺省）一行 `✻ 思考 · N token`
+ *   （流式中 `✻ 思考中…`），Ctrl+O 展开为标题 + 缩进 2 列的正文（最多 60 行）；`full` 总是展开且不限行；
+ *   `hidden` 不显示；
+ * - 压缩摘要卡（左竖条 Card）、重试提示、Hook 阻止提示、宿主 / 系统通知；字形取 `theme.glyphs`；
  * - `replay()` 把已有消息（恢复会话、切换会话、/tree 之后）重新画出来，工具调用交给调用方构造。
  *
  * 滚动交给终端回滚：消息区只追加，切换会话时整体清空重画。
  */
 import type { AssistantMessage, ContentBlock, ToolCallBlock, UserMessage } from "../../ai/types.js";
-import type { CompactionResult, ToolResultMessage } from "../../agent/types.js";
+import type { CompactionResult, SessionStats, ToolResultMessage } from "../../agent/types.js";
 import type { AgentMessage } from "../../session/types.js";
 import { Container, type Component, type Theme } from "../../tui.js";
 export type ThinkingDisplay = "full" | "collapsed" | "hidden";
@@ -22,8 +25,29 @@ export interface MessageViewOptions {
     showThinking?: ThinkingDisplay;
     /** false：助手文本不做 Markdown 渲染。 */
     markdown?: boolean;
+    /** `ui.compact`：块间不空行。 */
+    compact?: boolean;
 }
-/** 粗估 token（4 字符 ≈ 1 token），只用于思考块的流式计数。 */
+/**
+ * 退出摘要（§3.14）：`─ 会话 <id> · 时长 · N 回合 · ↑in ↓out · cache x% · $y（重计费 $z）` 与
+ * `  恢复：ama --resume <id>`。整体 dim，会话 id 与恢复命令正文色；0 回合只到「回合」；会话没落盘不给恢复行。
+ */
+export declare function exitSummaryLines(stats: Pick<SessionStats, "sessionId" | "sessionFile" | "userMessages" | "tokens" | "cost" | "cache" | "cacheHitRate">, elapsedMs: number, theme: Theme): string[];
+/** 思考块展开时的正文行数上限（`full` 不限）。 */
+export declare const THINKING_EXPANDED_LINES = 60;
+/** origin → 中文标签（未知 origin 原样显示）。 */
+export declare const ORIGIN_LABELS: Readonly<Record<string, string>>;
+/** 首行带前缀、续行按 `indent` 缩进的文本（用户消息、排队消息）。 */
+export declare class PrefixedText implements Component {
+    private readonly prefix;
+    private readonly body;
+    private readonly indent;
+    private cache;
+    constructor(prefix: string, body: string, indent?: number);
+    render(width: number): string[];
+    invalidate(): void;
+}
+export declare function displayText(text: string): string;
 export declare function estimateTokens(text: string): number;
 export declare function contentText(content: string | readonly ContentBlock[]): string;
 /** 一条助手消息：按内容块（思考 / 文本）同步子组件；工具调用块由 tool-view 单独显示。 */
@@ -32,7 +56,10 @@ export declare class AssistantView extends Container {
     private readonly parts;
     private readonly status;
     private streaming;
+    private thinkingExpanded;
     constructor(options: MessageViewOptions);
+    /** Ctrl+O：展开 / 折叠本消息的思考块（`collapsed` 模式下）。 */
+    setThinkingExpanded(expanded: boolean): void;
     update(message: AssistantMessage): void;
     /** 收尾：错误 / 中断 / 长度截断提示，思考计数换成用量里的值。 */
     finish(message: AssistantMessage): void;
@@ -47,25 +74,37 @@ export declare class MessageView extends Container {
     private readonly options;
     private current;
     private readonly blocks;
+    /** 工具调用块（相邻的不空行）。 */
+    private readonly toolBlocks;
+    private readonly assistants;
+    private thinkingExpanded;
     constructor(options: MessageViewOptions);
     private get theme();
-    /** 追加一块（与上一块之间空一行）。 */
+    /** 追加一块（与上一块之间空一行；`compact` 不空行）。 */
     add(component: Component): void;
+    /** 追加工具调用块：紧跟在另一个工具调用后面时不空行。 */
+    addTool(component: Component): void;
+    private push;
     /** 去掉一块（空的助手消息等）。 */
     remove(component: Component): void;
     reset(): void;
     get blockCount(): number;
-    /** 启动画面：首行加粗，其余变暗。 */
+    /** Ctrl+O：所有助手消息的思考块一起展开 / 折叠（之后的新消息沿用）。 */
+    setThinkingExpanded(expanded: boolean): void;
+    /** 纯文本启动画面（line 模式风格）：首行加粗，其余变暗。交互模式用 StartupHeader。 */
     addHeader(lines: readonly string[]): void;
     addUser(message: Pick<UserMessage, "content" | "origin">): void;
+    private newAssistant;
     startAssistant(message: AssistantMessage): AssistantView;
     updateAssistant(message: AssistantMessage): void;
     endAssistant(message: AssistantMessage): void;
     addNotice(level: NoticeLevel, message: string): void;
     addHookBlocked(reason: string): void;
     addRetry(attempt: number, maxAttempts: number, delayMs: number, error: string): void;
+    /** 退出前追加的会话摘要（留在终端回滚里）。 */
+    addExitSummary(lines: readonly string[]): void;
     addRetryFailed(error: string | undefined): void;
-    /** 压缩 / 分支摘要卡：token 变化（有则显示）+ 摘要前 3 行。 */
+    /** 压缩 / 分支摘要卡（左竖条）：标题 + token 变化（有则显示）+ 摘要前 3 行。 */
     addSummaryCard(summary: string, options?: {
         title?: string;
         tokensBefore?: number;