lark-remote 0.5.19 → 0.5.21

package/dist/card/card-helpers.js

@@ -36,7 +36,7 @@ const SESSION_PANEL_TITLE_MAX = 42;
 export function sessionEventPanel(ev, index, totalEvents, tailExpandedCount = 2, agentKind = 'claude') {
     // reader 可以给事件一个"标题即摘要"的名字（工具调用：`🔧 bash — npm test`）；
     // 缺省用类型标签。标题连同时间戳一起收进一行显示宽度——手机上折叠面板只有
-    // 一行可用（2026-10-19 工具标题被长 URL 撑成两行那次）。
+    // 一行可用，长 URL 把标题撑成两行会断在 URL 中间。
     const label = ev.title ?? eventLabel(ev, agentKind);
     const ts = formatMonthDayClock(ev.timestamp);
     const suffix = ts ? ` (${ts})` : '';
@@ -103,7 +103,7 @@ export function parseJumpOffset(inputValue, pageSize) {
  * Build the CardKit 2.0 pagination block shared by /ls, /ws, /resume, /active,
  * /order.
  *
- * 第一性原理（2026-09-10 窄屏重设计）：分页栏要同时承载「页码信息」和「翻页
+ * 第一性原理（窄屏）：分页栏要同时承载「页码信息」和「翻页
  * 控件」两类需求。旧布局把两者塞进同一行 `column_set`（文案 weighted 4 : 输入
  * weighted 2），手机窄屏下 auto 按钮先占走固有宽度，剩余宽度按 4:2 切分后文案
  * 列只有百来像素、输入框只有几十像素——文案折行、输入框窄到没法点。
@@ -253,8 +253,8 @@ export function searchBar(opts) {
  *
  * 旧口径是 `events.slice(-max)`：按**原始事件条数**截尾。工具往返（bash 调用 →
  * job 登记 → 结果）一段就能把窗口占满，于是重返会话的用户真正需要的两条信息
- * ——最后一句我说了什么、最后一句它答了什么——被挤出窗口。2026-10-19 实测：
- * 自动恢复卡 5 个面板全是 bash 调用，一条用户消息、一条 assistant 正文都没有。
+ * ——最后一句我说了什么、最后一句它答了什么——被挤出窗口：自动恢复卡 5 个
+ * 面板全是 bash 调用，一条用户消息、一条 assistant 正文都没有。
  *
  * 契约：先取最新 `max` 条，再把最后一条 `user` 与最后一条 `assistant`（正文）
  * 不在窗口内时补进来——补位时淘汰最早的**非锚点**事件。输出保持时间顺序，
@@ -313,7 +313,7 @@ export function buildSessionHistoryCard(state, opts) {
     // （DSH 的 projections.title / claude 的 ai-title），后者是最近一条用户输入。
     // claude 的 displayTitle 本身就取 aiTitle，两者相等 → 保持旧的「AI 标题」
     // 单段文案；DSH 两者都有（标题 + 末轮 prompt）→ 各占一段，别把用户那句话
-    // 挂在「AI 标题」下面（2026-10-21）。
+    // 挂在「AI 标题」下面。
     if (displayTitle) {
         if (aiTitle && aiTitle !== displayTitle) {
             sections.push(`🏷️ **标题**\n${preview(aiTitle)}`);
@@ -357,7 +357,7 @@ export function buildSessionHistoryCard(state, opts) {
         elements.push(markdownDiv(usageStr));
     }
     // Remove trailing hr
-    if (elements.length > 0 && elements[elements.length - 1].tag === 'hr') {
+    if (elements[elements.length - 1].tag === 'hr') {
         elements.pop();
     }
     if (opts.actions && opts.actions.length > 0) {

package/dist/card/final-answer-file.js

@@ -2,7 +2,7 @@
  * 完整回答超出一张卡片时，落成 Markdown 文件随卡片发送。
  *
  * 为什么不再拆纯文本消息：拆出来的「完整回答（1/N）」与卡片正文重复
- * （2026-11-02 实机反馈：同一篇回答用户看到两遍），而且纯文本会丢表格、
+ * （同一篇回答用户看到两遍），而且纯文本会丢表格、
  * 代码块等 Markdown 结构。文件通道保留原文逐字不变，且只多一条文件消息。
  *
  * 调用方负责用后删除：`bestEffortUnlink()` 见 `common/fs.ts`。

package/dist/card/run-renderer.d.ts

@@ -55,7 +55,7 @@ type GroupContentPrepared = Map<BlockGroup, string>;
 /**
  * 状态行内容：**一行、一个 div、窄屏不换行**。
  *
- * 设计约束（2026-10-19 手机端实测）：旧版把「状态标签」和「耗时/指标」放进
+ * 设计约束（手机端）：旧版把「状态标签」和「耗时/指标」放进
  * `column_set` 的 auto + grow 两列，窄屏上 auto 列被挤到只剩两个字宽，
  * "运行中" 被拆成 "运行 / 中"。列式布局的可用宽度取决于对端渲染，服务端无法
  * 保证；所以这里改成单 div，段间用 " · " 分隔——换行只会发生在分隔符处，
@@ -64,8 +64,8 @@ type GroupContentPrepared = Map<BlockGroup, string>;
  * 状态标签（运行中/已完成…）不再重复：header 已经写了（`🔧 dsh · 调用工具`
  * / `✅ dsh · 已完成`），终态 summary 还有一次。
  *
- * 终态也保留状态行：耗时定格，DSH 的步数/上下文投影展示最后一次快照
- * （2026-10-21 用户要求）。summary 的最终 usage 与状态行并存。
+ * 终态也保留状态行：耗时定格，DSH 的步数/上下文投影展示最后一次快照。
+ * summary 的最终 usage 与状态行并存。
  *
  * 导出供窄屏守卫测试断言分段宽度（与 `estimateCardBytes` 同一惯例）。
  */

package/dist/card/run-renderer.js

@@ -8,7 +8,7 @@ import { countCardElements, MAX_CARD_ELEMENTS } from './card-budget.js';
 import { displayWidth, truncateToDisplayWidth } from '../common/text-width.js';
 import { isContentFilterFailure } from '../common/turn-failure.js';
 import { formatClock, formatTimestamp } from './time.js';
-import { formatUsageStats } from './usage-format.js';
+import { formatTokenK, formatUsageStats } from './usage-format.js';
 import { renderApprovalArea, renderApprovalAreaCompact } from './approval-render.js';
 const REASONING_BYTES = 4_500;
 const TEXT_BYTES = 10_000;
@@ -38,7 +38,7 @@ const EMPTY_MD_DIV_BYTES = measureJson(markdownDiv('', 'notation'));
  * 能力门控（compactSupported !== false）与执行侧 `'runCompact' in runner`
  * 鸭子探测对齐：claude 走 stream-json，不发射 turn_started，operationKind
  * 恒 undefined——若以 operationKind==='turn' 作门控，claude 终态卡永远拿
- * 不到按钮（2026-08-19 缺陷）。compaction 卡的「防递归」仍由 operationKind
+ * 不到按钮。compaction 卡的「防递归」仍由 operationKind
  * 保证，两者是不同质的判断。
  */
 function shouldShowCompactButton(state, options) {
@@ -121,37 +121,21 @@ function buildGoalSection(state) {
  * This unifies timestamp position across all block types (thinking/plan/file_change/tool/text).
  *
  * Panel title: `💬 **输出** (ts)` when timestamp present, `💬 **输出**` otherwise.
- * Running: expanded=true; completed: expanded=false (symmetric with thinking).
+ * The panel is always expanded — streaming and finalized states render identically.
  *
  * @param content - The text content to render
  * @param timestamp - Optional timestamp for the block
- * @param finalized - Whether the run is in a terminal state
  * @returns elements
  */
-function renderTextBlock(content, timestamp, finalized = false) {
+function renderTextBlock(content, timestamp) {
     if (!content.trim()) {
         return [];
     }
     const ts = formatTimestamp(timestamp);
-    // Terminal state: output is the card body, render in collapsible_panel with expanded=true.
+    // Render in collapsible_panel with expanded=true.
     // NOTE: collapsible_panel does NOT shield markdown tables from Feishu's 11310 table count
     // limit — tables inside lark_md text are still counted regardless of container.
     // We must explicitly truncate excess tables via truncateMarkdownTables before rendering.
-    if (finalized) {
-        const title = '💬 **输出**';
-        const header = ts ? `${title} (${ts})` : title;
-        const safeContent = truncateMarkdownTables(content);
-        return [
-            collapsibleMarkdownPanel({
-                title: header,
-                expanded: true, // Always expanded in finalized state for full visibility
-                border: 'grey',
-                content: safeContent,
-                textSize: 'notation',
-            }),
-        ];
-    }
-    // Running/finalizing: panel provides visual grouping with timestamp in header
     const title = '💬 **输出**';
     const header = ts ? `${title} (${ts})` : title;
     const safeContent = truncateMarkdownTables(content);
@@ -302,7 +286,7 @@ function groupBlocks(blocks) {
  *
  * 早先试过"一行 + 服务端「详情」按钮"：折叠不省字节所以正文不入 payload，展开
  * 只能回服务端重出卡。代价是手机上要多点一次、按钮还占掉标题宽度（长 URL 被挤
- * 成两行，2026-10-19 反馈）。现在改成折叠面板 + **按工具数量缩放的正文截断**：
+ * 成两行）。现在改成折叠面板 + **按工具数量缩放的正文截断**：
  * 正文始终随卡下发（面板折叠时不显示），点标题即展开，无往返、无按钮。
  *
  * 展开态：运行中/失败的默认展开（用户在等结果、错误要立刻可见），其余折叠。
@@ -493,8 +477,6 @@ function assembleRunCard(state, options, elements) {
 function insertAfterStatusRow(elements, extra) {
     if (extra.length === 0)
         return elements;
-    if (elements.length === 0)
-        return extra;
     return [elements[0], ...extra, ...elements.slice(1)];
 }
 /**
@@ -573,16 +555,13 @@ function buildFallbackElements(state, options, tier) {
         else if (group.kind === 'text') {
             const content = truncateUtf8(group.content, tier.textBytes, true, '…（已截断）\n');
             const ts = formatTimestamp(group.timestamp);
-            elements.push(...renderTextBlock(content, ts, true));
+            elements.push(...renderTextBlock(content, ts));
         }
         else if (group.kind === 'tool') {
             // Show tool individually (each tool is independent now)
             elements.push(renderTool(group.tool, outputMax));
         }
     }
-    if (elements.length === 0 && tier === EXTREME_TIER) {
-        elements.push(markdownDiv('_暂无输出_'));
-    }
     elements.push(...buildSummaryContent(state, { includeNotices: false }));
     elements.push(...actionRow(state, options));
     elements.push(...approvalArea(state));
@@ -606,7 +585,7 @@ function buildExtremeFallbackElements(state, options) {
 /**
  * 状态行内容：**一行、一个 div、窄屏不换行**。
  *
- * 设计约束（2026-10-19 手机端实测）：旧版把「状态标签」和「耗时/指标」放进
+ * 设计约束（手机端）：旧版把「状态标签」和「耗时/指标」放进
  * `column_set` 的 auto + grow 两列，窄屏上 auto 列被挤到只剩两个字宽，
  * "运行中" 被拆成 "运行 / 中"。列式布局的可用宽度取决于对端渲染，服务端无法
  * 保证；所以这里改成单 div，段间用 " · " 分隔——换行只会发生在分隔符处，
@@ -615,8 +594,8 @@ function buildExtremeFallbackElements(state, options) {
  * 状态标签（运行中/已完成…）不再重复：header 已经写了（`🔧 dsh · 调用工具`
  * / `✅ dsh · 已完成`），终态 summary 还有一次。
  *
- * 终态也保留状态行：耗时定格，DSH 的步数/上下文投影展示最后一次快照
- * （2026-10-21 用户要求）。summary 的最终 usage 与状态行并存。
+ * 终态也保留状态行：耗时定格，DSH 的步数/上下文投影展示最后一次快照。
+ * summary 的最终 usage 与状态行并存。
  *
  * 导出供窄屏守卫测试断言分段宽度（与 `estimateCardBytes` 同一惯例）。
  */
@@ -629,7 +608,7 @@ export function statusLine(state) {
     const elapsed = elapsedLabel(state);
     if (elapsed)
         parts.push(`⏱ ${elapsed}`);
-    // 运行期投影在终态也保留（2026-10-21 用户要求）：DSH 卡片完成时，耗时/步数/
+    // 运行期投影在终态也保留：DSH 卡片完成时，耗时/步数/
     // 上下文百分比是这一跑留下的最后快照，撤掉后用户只能从 summary 的累计口径
     // 重新推算。summary 仍展示最终 usage，两者口径不同、并存不冲突。
     const live = state.liveStatus;
@@ -644,12 +623,12 @@ export function statusLine(state) {
             parts.push(`📊 ~${pct}%`);
         }
         else if (live.contextUsed !== undefined) {
-            parts.push(`📊 ${formatTokens(live.contextUsed)}`);
+            parts.push(`📊 ${formatTokenK(live.contextUsed)}`);
         }
     }
     if (parts.length === 0) {
         // 没有任何可用指标时退回状态词（骨架卡/测试构造的状态没有时间戳）。
-        return statusTagLabel(state.terminal);
+        return terminalToLabel(state.terminal);
     }
     return parts.join(' · ');
 }
@@ -672,15 +651,6 @@ function elapsedLabel(state) {
         return `${hours}h${String(minutes % 60).padStart(2, '0')}m`;
     return `${Math.floor(hours / 24)}d${String(hours % 24).padStart(2, '0')}h`;
 }
-/** token 数量的紧凑写法：`950` / `12K` / `1.0M`。 */
-function formatTokens(tokens) {
-    if (tokens < 1000)
-        return String(tokens);
-    // 千位边界取 M 档：999_500 起四舍五入会得到 "1000K"，直接按 M 档展示。
-    if (tokens < 999_500)
-        return `${Math.round(tokens / 1000)}K`;
-    return `${(tokens / 1_000_000).toFixed(1)}M`;
-}
 /**
  * 状态行元素（full/degraded/extreme/skeleton 共用）。
  *
@@ -955,7 +925,7 @@ export const FINAL_ANSWER_OVERFLOW_MARKER = '_最终回答较长，完整内容
  * 「卡片装不下正文」与「表格数超上限」是两件事，只有前者才走补发通道：
  * 飞书单卡最多 5 张 markdown 表（11310），多出来的最旧表格会被删掉并在原位
  * 留 `_💡 前 N 个表格已省略_`——正文仍在卡片里，再补发一遍就是把用户已经看到
- * 的整篇回答重复（2026-11-02 实机反馈）。
+ * 的整篇回答重复。
  */
 function buildFinalAnswerPriorityCard(state, options) {
     const finalAnswer = state.finalAnswer;
@@ -963,12 +933,12 @@ function buildFinalAnswerPriorityCard(state, options) {
     const prepared = prepareGroupContent(groups);
     const safeAnswer = truncateMarkdownTables(finalAnswer.content);
     const ts = formatTimestamp(finalAnswer.timestamp);
-    const answerElements = renderTextBlock(safeAnswer, ts, state.terminal !== 'running');
+    const answerElements = renderTextBlock(safeAnswer, ts);
     const fixedStart = [statusRow(state), ...omittedBlocksHint(state)];
     const summary = buildSummaryContent(state, { includeNotices: false });
     const controls = [...actionRow(state, options), ...approvalArea(state)];
     const buildWithProgress = (start, includeSummary) => {
-        const renderedProgress = buildAnswerProgressContent(state, prepared, groups.slice(start));
+        const renderedProgress = renderContentGroups(state, prepared, groups.slice(start));
         const progress = start < groups.length
             ? [markdownDiv(`_💡 已省略 ${start} 个早期步骤_`), ...renderedProgress]
             : renderedProgress;
@@ -1009,8 +979,17 @@ function buildFinalAnswerPriorityCard(state, options) {
         finalAnswerText: finalAnswer.content,
     };
 }
-/** Render a contiguous progress suffix for the answer-priority card. */
-function buildAnswerProgressContent(state, prepared, visible) {
+/**
+ * 正常路径内容循环，时间线卡（buildChronologicalContent）与答案优先卡的进度
+ * 后缀（buildFinalAnswerPriorityCard）共用：notices 作为普通消息按到达时间
+ * 插入内容流（有内容时不再沉到 summary），tool/text/panel 组逐个渲染。
+ *
+ * prepared 的键是组对象引用：传入的组数组必须保持元素引用（slice 可以，重建
+ * 数组会让 prepared.get 永远 miss，退化为二次截断）。面板组描述经
+ * describePanelGroup 与估算共享同一份模板。
+ * 「已省略 N 个早期步骤」提示与空态兜底 `_暂无输出_` 由调用方各自负责。
+ */
+function renderContentGroups(state, prepared, visible) {
     const elements = [];
     const outputMax = toolOutputBudget(state);
     const contentItems = mergeNoticesIntoContent(visible, state.notices);
@@ -1027,7 +1006,7 @@ function buildAnswerProgressContent(state, prepared, visible) {
         if (group.kind === 'text') {
             const content = prepared.get(group) ?? '';
             const ts = formatTimestamp(group.timestamp);
-            elements.push(...renderTextBlock(content, ts, state.terminal !== 'running'));
+            elements.push(...renderTextBlock(content, ts));
             continue;
         }
         const spec = describePanelGroup(group, prepared);
@@ -1058,51 +1037,97 @@ function withinRunCardBudget(card) {
 }
 /** Build content in chronological order using groupBlocks to interleave thinking/text/tools. */
 function buildChronologicalContent(state, prepared, groups) {
-    const elements = [];
-    // finalized = 非 running（含 finalizing：主结果已出，thinking 折叠）
-    const finalized = state.terminal !== 'running';
     // 节点预算内从最新往回选择可见组：超限时只省略最旧的几步，不整卡降级。
     const { visible, omitted } = selectVisibleGroups(groups);
-    const outputMax = toolOutputBudget(state);
+    const elements = [];
     if (omitted > 0)
         elements.push(markdownDiv(`_💡 已省略 ${omitted} 个早期步骤_`));
-    // renderRunCard 传入同一 groups 数组时直接复用（prepared 的键是组对象
-    // 引用，重建数组会让 prepared.get 永远 miss，退化为二次截断）。
-    // 面板组描述经 describePanelGroup 与估算共享同一份模板。
-    // notices 作为普通消息按到达时间插入内容流（有内容时不再沉到 summary）。
-    const contentItems = mergeNoticesIntoContent(visible, state.notices);
-    for (const item of contentItems) {
-        if (item.kind === 'notice') {
-            elements.push(renderNoticeRow(item.notice));
-            continue;
-        }
-        const group = item;
-        if (group.kind === 'tool') {
-            elements.push(renderTool(group.tool, outputMax));
-            continue;
-        }
-        if (group.kind === 'text') {
-            const content = prepared.get(group) ?? '';
-            const ts = formatTimestamp(group.timestamp);
-            elements.push(...renderTextBlock(content, ts, finalized));
-            continue;
-        }
-        const spec = describePanelGroup(group, prepared);
-        if (!spec)
-            continue;
-        elements.push(collapsibleMarkdownPanel({
-            title: spec.title,
-            expanded: spec.expanded,
-            border: spec.border,
-            content: spec.content,
-            textSize: 'notation',
-        }));
-    }
+    elements.push(...renderContentGroups(state, prepared, visible));
     if (elements.length === 0) {
         elements.push(markdownDiv('_暂无输出_'));
     }
     return elements;
 }
+/** running 时不显示统计（仍在生成）；原分支直接 return，不追加元素。 */
+function summaryRunning(_state, _elements) { }
+function summaryFinalizing(_state, elements) {
+    elements.push(markdownDiv('⏳ **等待进程退出…**'));
+}
+function summaryError(state, elements) {
+    // 服务方内容审核截断（多为误报）不是「程序出错」：照抄英文内部报文会让
+    // 用户以为代码或配置坏了。文案说清三件事——谁拦的、改动还在、下一步。
+    if (isContentFilterFailure(state.errorMsg)) {
+        elements.push(markdownDiv('⚠️ **服务方内容审核拦截**\n\n' +
+            '模型输出被上游安全策略截断（`content_filter`），多数是误报，不是代码或配置问题。\n' +
+            '本回合已中止；已写入磁盘的改动都还在。重试仍被拦截时，可换模型或稍后再试。'));
+    }
+    else {
+        elements.push(markdownDiv(`⚠️ **运行出错**\n\n${state.errorMsg ?? '未知错误'}`));
+    }
+}
+function summaryInterrupted(state, elements) {
+    // 中断来源三元：审批超时 / 用户取消审批 / 用户主动终止。
+    // 显式原因优先：approvalExpired 是粘性标记（cancel 语义下 agent 可能继续跑），
+    // 用户随后主动 /stop 时若仍按过期渲染，就把「我自己停的」误报成自动取消。
+    const expiredApproval = state.interruptedReason === 'approval_timeout' ||
+        (state.interruptedReason === undefined &&
+            (state.approvalExpired === true || (state.approvals ?? []).some((a) => a.expired)));
+    elements.push(markdownDiv(expiredApproval
+        ? '⏰ **审批超时未响应，已自动取消**'
+        : state.interruptedReason === 'approval_cancelled'
+            ? '⏹ **已取消审批，任务终止**'
+            : '⏹ **已被用户终止**'));
+}
+function summaryIdleTimeout(state, elements) {
+    elements.push(markdownDiv(`⏱ **已超时**\n\n${state.idleTimeoutMinutes ?? 0} 分钟无响应，已自动终止`));
+}
+/** 成功/目标继续/其它终态：usage 统计 + 后台任务（原 else 兜底分支）。 */
+function summaryResult(state, elements) {
+    const result = state.resultSubtype ?? 'success';
+    const hasContent = state.blocks.length > 0 || !!state.finalAnswer?.content.trim();
+    // 压缩（operationKind='compaction'）不会返回 agent 正文——引擎只压缩上下文
+    // 窗口，空内容属正常，不能沿用普通 run 的「（未返回内容）」异常信号。
+    // 所有会压缩的 agent（codex/claude/kimi/opencode/pi）
+    // 都经 streamCompact 走这条共享渲染路径，一处覆盖全部。
+    const empty = hasContent
+        ? ''
+        : state.operationKind === 'compaction'
+            ? '\n\n🗜 Compact 完成'
+            : '\n\n（未返回内容）';
+    // goal 本 run 读不到（known=false）时不能写「已完成」：这是 GoalStateEvent
+    // 契约里明令禁止的推断（读不到 ≠ 没有目标）。run 本身成功，只是目标维度未知。
+    const goalUnknown = state.terminal === 'done' && state.goalKnown === false;
+    // RunState 的用量字段就是 formatUsageStats 的入参形态（同为
+    // `UsageSnapshot`）——原先这里逐字段抄了 17 行，加一个字段要同时改
+    // RunState、FinishMeta 和这张清单（§9.21）。
+    const usageStatsStr = formatUsageStats(state, {
+        showResult: true,
+        result,
+        // 本轮结束但目标继续：不能报"已完成"，也不能说"出错"。
+        ...(state.terminal === 'goal_continuing'
+            ? { completedLabel: '⏳ 本轮结束 · 目标仍在继续' }
+            : goalUnknown
+                ? { completedLabel: '✅ 本轮完成 · 目标状态未确认' }
+                : {}),
+    });
+    elements.push(markdownDiv(usageStatsStr + empty));
+    // 后台任务：跨 turn 生命周期，必须显式告知并可逐个停止。
+    elements.push(...buildBackgroundJobsSection(state));
+}
+/**
+ * terminal → summary handler。用 Map 而非对象字面量（constructor/toString 等
+ * 键会命中 Object.prototype）；未登记的 terminal 走 summaryResult，与原 else
+ * 兜底分支一致。
+ */
+const SUMMARY_HANDLERS = new Map([
+    ['running', summaryRunning],
+    ['finalizing', summaryFinalizing],
+    ['error', summaryError],
+    ['interrupted', summaryInterrupted],
+    ['idle_timeout', summaryIdleTimeout],
+    ['done', summaryResult],
+    ['goal_continuing', summaryResult],
+]);
 /** Build summary tab content */
 function buildSummaryContent(state, options = {}) {
     const elements = [];
@@ -1114,74 +1139,8 @@ function buildSummaryContent(state, options = {}) {
             elements.push(renderNoticeRow(notice));
         }
     }
-    // running 时不显示统计（仍在生成）；finalizing 显示等待提示
-    if (state.terminal === 'running') {
-        return elements;
-    }
-    if (state.terminal === 'finalizing') {
-        elements.push(markdownDiv('⏳ **等待进程退出…**'));
-        return elements;
-    }
-    if (state.terminal === 'error') {
-        // 服务方内容审核截断（多为误报）不是「程序出错」：照抄英文内部报文会让
-        // 用户以为代码或配置坏了。文案说清三件事——谁拦的、改动还在、下一步。
-        if (isContentFilterFailure(state.errorMsg)) {
-            elements.push(markdownDiv('⚠️ **服务方内容审核拦截**\n\n' +
-                '模型输出被上游安全策略截断（`content_filter`），多数是误报，不是代码或配置问题。\n' +
-                '本回合已中止；已写入磁盘的改动都还在。重试仍被拦截时，可换模型或稍后再试。'));
-        }
-        else {
-            elements.push(markdownDiv(`⚠️ **运行出错**\n\n${state.errorMsg ?? '未知错误'}`));
-        }
-    }
-    else if (state.terminal === 'interrupted') {
-        // 中断来源三元：审批超时 / 用户取消审批 / 用户主动终止。
-        // 显式原因优先：approvalExpired 是粘性标记（cancel 语义下 agent 可能继续跑），
-        // 用户随后主动 /stop 时若仍按过期渲染，就把「我自己停的」误报成自动取消。
-        const expiredApproval = state.interruptedReason === 'approval_timeout' ||
-            (state.interruptedReason === undefined &&
-                (state.approvalExpired === true || (state.approvals ?? []).some((a) => a.expired)));
-        elements.push(markdownDiv(expiredApproval
-            ? '⏰ **审批超时未响应，已自动取消**'
-            : state.interruptedReason === 'approval_cancelled'
-                ? '⏹ **已取消审批，任务终止**'
-                : '⏹ **已被用户终止**'));
-    }
-    else if (state.terminal === 'idle_timeout') {
-        elements.push(markdownDiv(`⏱ **已超时**\n\n${state.idleTimeoutMinutes ?? 0} 分钟无响应，已自动终止`));
-    }
-    else {
-        const result = state.resultSubtype ?? 'success';
-        const hasContent = state.blocks.length > 0 || !!state.finalAnswer?.content.trim();
-        // 压缩（operationKind='compaction'）不会返回 agent 正文——引擎只压缩上下文
-        // 窗口，空内容属正常，不能沿用普通 run 的「（未返回内容）」异常信号
-        // （2026-09 用户反馈）。所有会压缩的 agent（codex/claude/kimi/opencode/pi）
-        // 都经 streamCompact 走这条共享渲染路径，一处覆盖全部。
-        const empty = hasContent
-            ? ''
-            : state.operationKind === 'compaction'
-                ? '\n\n🗜 Compact 完成'
-                : '\n\n（未返回内容）';
-        // goal 本 run 读不到（known=false）时不能写「已完成」：这是 GoalStateEvent
-        // 契约里明令禁止的推断（读不到 ≠ 没有目标）。run 本身成功，只是目标维度未知。
-        const goalUnknown = state.terminal === 'done' && state.goalKnown === false;
-        // RunState 的用量字段就是 formatUsageStats 的入参形态（同为
-        // `UsageSnapshot`）——原先这里逐字段抄了 17 行，加一个字段要同时改
-        // RunState、FinishMeta 和这张清单（§9.21）。
-        const usageStatsStr = formatUsageStats(state, {
-            showResult: true,
-            result,
-            // 本轮结束但目标继续：不能报"已完成"，也不能说"出错"。
-            ...(state.terminal === 'goal_continuing'
-                ? { completedLabel: '⏳ 本轮结束 · 目标仍在继续' }
-                : goalUnknown
-                    ? { completedLabel: '✅ 本轮完成 · 目标状态未确认' }
-                    : {}),
-        });
-        elements.push(markdownDiv(usageStatsStr + empty));
-        // 后台任务：跨 turn 生命周期，必须显式告知并可逐个停止。
-        elements.push(...buildBackgroundJobsSection(state));
-    }
+    const handler = SUMMARY_HANDLERS.get(state.terminal) ?? summaryResult;
+    handler(state, elements);
     return elements;
 }
 /** 终态卡最多列几个后台任务（多出来的只报数）。 */
@@ -1243,7 +1202,7 @@ function codeFenceFor(content) {
 /**
  * 后台任务小节：命令独占一行，停止按钮单独一行。
  *
- * 布局约束（2026-10-21 手机端反馈）：
+ * 布局约束（手机端）：
  * - 命令 + 按钮不再并排（grow + auto）：窄屏下 auto 列会被挤成「🟥…」，
  *   命令也被截断。按钮现在独占一个单列 column_set，宽度由按钮自身决定。
  * - 命令不 truncate：短命令/单行直接内联；中等长度的多行命令用代码块
@@ -1326,10 +1285,6 @@ function buildBackgroundJobsSection(state) {
     }
     return elements;
 }
-/** Status tag label */
-function statusTagLabel(terminal) {
-    return terminalToLabel(terminal);
-}
 /** CardKit 2.0 header title — agent-aware via options.agentKind. */
 function headerTitle(state, options = {}) {
     const agent = agentDisplayName(options.agentKind ?? 'claude');
@@ -1359,7 +1314,7 @@ function headerTitle(state, options = {}) {
     if (state.terminal === 'finalizing')
         return `⏳ ${agent} · 完成中`;
     // 审批等待期间 server 暂停 turn，命令工具停在 tool_running——标题必须提示
-    // 正在等人工决策，而不是「调用工具」（2026-08-14 UX）。
+    // 正在等人工决策，而不是「调用工具」。
     if (hasPendingApproval(state))
         return `✋ ${agent} · 等待审批`;
     if (state.footer === 'thinking')

package/dist/card/run-state.d.ts

@@ -154,7 +154,7 @@ export interface RunState extends UsageSnapshot {
      * 审批是否曾过期（桥侧 timer 触发，approval_expired 事件置位）。
      * 独立于 approvals 数组持久保存：cancel 送达后 server 会回
      * approval_resolved，把对应审批条目从数组移除，但过期原因必须活到
-     * 终态渲染（2026-08-15 事故：标记被消费后卡片误报「已被用户终止」）。
+     * 终态渲染（否则标记被消费后卡片误报「已被用户终止」）。
      */
     approvalExpired?: boolean;
     /**
@@ -213,20 +213,6 @@ export declare function removeBackgroundJob(state: RunState, jobId: string): Run
  * 按钮，等于逼用户拿「停止」当查询用。
  */
 export declare function isLiveBackgroundJob(job: BackgroundJobRoster): boolean;
-/**
- * 收尾后把宿主推来的整份任务名单同步进终态卡状态。
- *
- * 与 reducer 的分工：reducer 处理的是"收尾那一刻的名单"，只在 run 还在消费
- * 事件时有效；终态之后 `reduceRunState` 直接早退（终态幂等），名单只能由
- * 这里更新。
- *
- * 三条规则：
- * - 名单里消失 = 宿主已结算（`job/list` 是整份替换，摘掉即结束）→ `ended`；
- * - 名单里还在、宿主却给了终态词 → `ended`（有些宿主会把已结束的行留在名单里）；
- * - `ended` 是终态，不回退成 running —— 同一个 job id 不会重新开始跑。
- *
- * 无变化时返回**同一个 state 引用**：bridge 靠它跳过无谓的卡片 patch。
- */
 export declare function syncBackgroundJobs(state: RunState, roster: ReadonlyArray<BackgroundJobRoster>): RunState;
 /**
  * 订阅断了但任务仍未结算：把在跑的任务标成「状态未知」。