lark-remote 0.5.5 → 0.5.7

package/CHANGELOG.md

@@ -5,6 +5,47 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.7] - 2026-10-20
+
+### 新增
+
+- **DSH 运行的工具调用与运行状态进卡**：此前 DSH 直连的运行卡片只有正文、看不到任何工具调用。现在工具块以原生折叠面板呈现（与思考块同款交互，点标题展开、不经过服务端往返），运行中或失败的默认展开，正文按卡片内工具数量分配截断预算；摘要识别 DSH 的工具名与参数（`glob`、`web_search`、`todo_write`、`subagent`、`job_*`、`terminal_*` 等），标题显示不下时按**显示宽度**做中间省略——保住工具名与路径结尾，而不是从尾部切掉文件名。卡片还会投影 DSH 的 `session/control` 状态流（步数与上下文占用），并在首帧列出仍在后台运行的任务（终端里 `run_in_background` 起的进程活过了本轮），终态卡片可直接停止它们
+- **恢复卡片能看出思路**：DSH 的历史块分 `text` / `reasoning` / `tool-call` 三类，此前只认 `text`，于是一个真实会话里 371 段思考、12 段正文的恢复卡只剩一串工具调用。现在思考映射成 thinking、正文映射成回复，工具调用与结果合成同一个面板（标题带工具名与命令，失败标 `❌`，正文是输出）
+- **`/resume` 卡保住「我上一句 + 你最后一句」**：卡片只显示最后 N 个块，用户最关心的「我刚说了什么、它最后答了什么」常被中间的工具往返挤出窗口。现在这两句有独立名额
+
+### 修复
+
+- **手机端窄屏排版**：状态行原先用并排短列布局，窄屏上会被挤成竖排（「运行中」三个字竖着排），且列宽由客户端决定、服务端控制不了。改为单行单块 + ` · ` 分隔，并补上本轮耗时
+- **卡片元素总数上限按实测收敛**：飞书拒绝的判据是递归 `elements` 成员数量，此前记录有误。现在运行卡片同时受字节预算与元素预算约束，超限时从最旧的步骤开始省略，不再整卡发送失败
+- **DSH 的停止不再假报已停止**：回合跑在共享的 `dsh web` 宿主里，退出本地进程带不走它。停止现在分两步——prompt 还没被回合取走时从宿主收件箱撤回，已被取走才发取消并用 `session/list.running` 轮询确认；无法确认时明确告知「可能仍在后台运行」，而不是报一句已停止。取消确认落地前，下一条消息由门禁拦住，避免会话级取消打到新回合；每次提交的在途身份另存一份，下次启动对账：清掉残留的待执行 prompt，对仍开着的回合只提示不代杀
+- **排队与压缩的回合归属**：排队中的 prompt 此前可能在上一个回合结束时被收尾，现在绑定到自己的回合；`/compact` 执行前先探服务端是否还有在途回合；进程退出时取消尚未收尾的回合，不留无人订阅的孤儿回合
+- **空闲判定改用会话状态**：此前靠事件流静默推断，工具往返密集时容易误判。现在读 `session/list.running`，事件探测降为兜底
+- **回顾卡不再被系统注入内容灌满**：DSH 的 `user/message` 里混着 agent 指令、技能清单、运行期上下文、压缩检查点等注入项，此前照单全收，回顾卡上看不见用户真正说过的话。现在按类型过滤，系统通知单独标 `🔔`
+- **Windows 与 CI 稳定性**：退出路径的取消与凭据检查统一走平台判定；若干用例的凭据路径断言跟随 `path.join`，不再写死 POSIX 字面量
+
+### 变更
+
+- **英文文档补齐 DSH 部分**：`docs/en/architecture/design.md` 补上停止与取消确认的叙述，`docs/en/architecture/streaming-card.md` 更正工具折叠的口径（此前写的「连续工具超过阈值折叠」已被实现取代），两侧不再有互相矛盾的说法
+- **用户文档纠正过期说法**：`/order` 别名的命令形态与存储位置（英文侧仍写已移除的 `/order alias <name> <text>` 与 `aliases.json`，实际是 `alias add|rm <orderId|序号>`、随指令存在 `orders.json`）、`/ws save` 示例多带一个实际不生效的路径参数、贡献指南要求 `bun run test` 而入门文档教的是 `bun test`、README 里真机用例的缺失目录前缀
+- **注释与文档整理**：入站消息两篇架构文档改为描述当前实现，测试文件头不再点名已不存在的文件。无行为变化
+
+## [0.5.6] - 2026-10-18
+
+### 新增
+
+- **DSH 的提问（`ask_user_question`）转写到飞书运行卡片**：agent 运行中提出的问题现在渲染成卡片底部的提问区——选项按钮（单选 ⚪/🔵、多选 ⬜/☑️）、「自定义答案（Other）」输入、多选时的「✅ 提交答案（已选 N 项）」，以及底部统一的「⏭️ 跳过回答」。回答按题目编码回 DSH。plan-review 那类把计划全文放在正文里的提问，卡片用折叠面板承载（超出字节预算时截断），不会让你在看不到计划的情况下做选择。飞书卡 30 分钟没人回答时只把这一路交回 DSH Web UI，不取消回合，卡片保留「可在 DSH Web UI 继续回答」的提示
+
+### 修复
+
+- **断线重连后重投的提问不再让勾选与答案错位**：同一个提问在 `$events` 重连后会被重新投递，此前协调器沿用旧一路的计时、已记录的答案也不会落到新视图，卡片上勾着的选项与真正将要提交的可能不是同一份。现在重投会重新计时并回填已记录的答案
+- **带前台期限（timed）的提问不再走飞书卡片**：它按自己的期限结算，卡片的 30 分钟窗口与它对不上，在卡片上答了也可能已被丢弃。现在这类提问直接交给 DSH Web UI 的倒计时处理
+- **没有选项的多选题不再变成答不了的卡片**：卡片上没有任何可勾内容、而答案编码又不接受多选，等于无解。现在按可作答的自由文本题处理
+
+### 变更
+
+- **英文文档补齐 DSH 部分**：`docs/en/architecture/design.md` 补上直连与凭据签发、审批与提问转写、压缩能力声明；`docs/en/usage.md` 补 `manageProcess` / `dshHome` / `dshCommand` / `startTimeoutMs` / `permissionPreset` 五项配置说明，并纠正一处过期说法——原先写着 `token` 可以在 `/config` 卡片里编辑，实际该字段早已移出卡片
+- **注释与发布条目整理**。无行为变化
+
 ## [0.5.5] - 2026-10-18
 
 ### 新增
@@ -51,7 +92,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### 变更
 
-- **注释里的运维现场数据与仓库外引用清理**：一处测试注释记录的崩溃进程号、实例名与精确到秒的重启时间改为占位描述；若干注释不再指向仓库之外的维护规范文件名。无行为变化
+- **注释里的运维数据与仓库外引用改为占位描述**。无行为变化
 
 ## [0.5.2] - 2026-10-11
 
@@ -79,7 +120,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - **消除两处宿主环境相关的测试假红**：宿主带上本机没有的 locale（macOS 常见的 `LC_ALL=C.UTF-8`）时，bash 每次启动都往 stderr 打 setlocale 警告，让输出断言随机变红，测试 setup 阶段现在剔掉该变量（保留 UTF-8 解析所需项）；JSON-RPC 退出计时用例的计时起点从进程启动改到收到 `initialize` 应答，慢速 Windows runner 上不再因启动耗时超过阈值而误红
 - **英文架构文档补齐**：`docs/en/architecture/design.md` 增补与中文侧对应的五个章节，英中两侧不再不对称
-- **注释与用例名清理**：延续上一版的清理，去掉剩余指向未发布文档的引用与评审编号，并修正清理过程中留下的残句。无行为变化
+- **注释与用例名整理**：让公开仓库里的引用都能落地。无行为变化
 
 ## [0.5.0] - 2026-10-07
 
@@ -97,7 +138,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### 变更
 
-- **注释与测试命名清理**：去掉源码、测试注释与用例名中指向未发布内部文档的引用（评审条目号、场景号、轮次号、文件名前缀），让公开仓库里的引用都能落地。无行为变化
+- **注释与测试命名整理**：让公开仓库里的引用都能落地。无行为变化
 
 ## [0.4.5] - 2026-10-07
 
@@ -317,7 +358,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - ExitPlanMode 计划审批：计划全文折叠展示 + 五决策对齐 TUI（自动放行 / 附意见 / 采纳修改）
 - 卡片别名管理重构：`alias-store` 并入 `alias-resolve`，`/order` 卡片新增「＋别名」交互（绑定/修改/删除，已绑定指令显示 `$name` 标签 + ✕）
-- DSH / connection-based runner 启动 / 配置热更 / 失败路径修复（CC-01~CC-08）
+- DSH / connection-based runner 启动 / 配置热更 / 失败路径修复
 
 ### 变更
 
@@ -327,7 +368,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### 修复
 
 - 别名卡片成功回调：携带 `card` 替换 pre-click 卡，删除文案对齐新交互
-- kimi ACP runner 模型下发：迁移到纯 ACP 后 `session/set_config_option` 必须紧跟 `session/new|resume` 下发，否则实际跑的是默认模型（CC-07）
+- kimi ACP runner 模型下发：迁移到纯 ACP 后 `session/set_config_option` 必须紧跟 `session/new|resume` 下发，否则实际跑的是默认模型
 
 ## [0.1.8] - 2026-08-19
 
@@ -451,13 +492,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### 测试
 
 - 合并 stub 工厂、净化 fixtures、移除冗余测试
-- 新增 P1-15 configContainer 锚点测试（含 codex 负向断言）
+- 新增 configContainer 锚点测试（含 codex 负向断言）
 
 ## [0.1.2] - 2026-08-10
 
 ### 修复
 
-- claude / opencode / kimi 的 Agent 工厂改为从 `configContainer` 读取配置，避免使用过期闭包导致配置不生效（P1-15）
+- claude / opencode / kimi 的 Agent 工厂改为从 `configContainer` 读取配置，避免使用过期闭包导致配置不生效
 - codex / kimi 的 `readSessionContent` 增加 cwd 校验，防止越界读取会话
 - `listClaudeSessions` / `isClaudeSessionActive` 支持跨目录回退，处理会话迁移后的定位
 - 修复 `handleQueueInput` 竞态：替换任务在 await 之前注册

package/README.en.md

@@ -137,8 +137,8 @@ bun run lint          # eslint
 
 # Live Feishu API integration tests (skipped by default; need valid
 # credentials under ~/.lark-remote-test)
-FEISHU_LIVE_TEST=1 bun run test tests/feishu-card-form-error.test.ts
-FEISHU_LIVE_TEST=1 bun run test tests/feishu-reaction-emoji-live.test.ts
+FEISHU_LIVE_TEST=1 bun run test tests/feishu-live/feishu-card-form-error.test.ts
+FEISHU_LIVE_TEST=1 bun run test tests/feishu-live/feishu-reaction-emoji-live.test.ts
 ```
 
 ## Documentation

package/README.md

@@ -141,8 +141,8 @@ bun run typecheck     # tsc --noEmit
 bun run lint          # eslint
 
 # 真实飞书 API 集成测试（默认跳过，需要 ~/.lark-remote-test 下的有效凭据）
-FEISHU_LIVE_TEST=1 bun run test tests/feishu-card-form-error.test.ts
-FEISHU_LIVE_TEST=1 bun run test tests/feishu-reaction-emoji-live.test.ts
+FEISHU_LIVE_TEST=1 bun run test tests/feishu-live/feishu-card-form-error.test.ts
+FEISHU_LIVE_TEST=1 bun run test tests/feishu-live/feishu-reaction-emoji-live.test.ts
 ```
 
 ## 文档

package/dist/bridge/approval-coordinator.d.ts

@@ -163,6 +163,19 @@ export declare class ApprovalCoordinator {
      * 用户看到失败却没有任何重试入口。
      */
     private failSubmission;
+    /**
+     * Re-apply the answers already recorded for a question batch onto a
+     * re-delivered view.
+     *
+     * A re-delivered waterfall (DSH replays pending waterfalls to a reconnected
+     * `$events` client) rebuilds the view from the agent payload, which carries no
+     * card-local state: a plain replace would drop the checkmarks of questions the
+     * user already answered while `answers` still counts them, so the card would
+     * contradict what a submit sends. Only recorded answers (`answers` / `notes`)
+     * are restored; unsubmitted multi-select toggles are card-local by design.
+     * Alignment is by index: the same requestId means the same batch.
+     */
+    private reapplyRecordedAnswers;
     /** 记录问题答案到 tracked.answers（懒初始化 Map）。 */
     private recordAnswer;
     private getPendingQuestion;

package/dist/bridge/approval-coordinator.js

@@ -38,7 +38,7 @@ export class ApprovalCoordinator {
         if (existing) {
             // Already tracked — update state
             existing.state = 'pending';
-            existing.view = event.view;
+            existing.view = this.reapplyRecordedAnswers(existing, event.view);
             existing.timeoutMs = timeoutMs;
             // 重投必须重新计时：上一路的计时器在 resolved/expired 时已清掉，不重装
             // 这条审批就永不过期，server 只能无限等待（红线「审批超时自动 cancel」）。
@@ -392,6 +392,39 @@ export class ApprovalCoordinator {
         this.armTimeout(tracked, tracked.timeoutMs);
         this.pushApprovalViewUpdate(tracked.requestId, tracked);
     }
+    /**
+     * Re-apply the answers already recorded for a question batch onto a
+     * re-delivered view.
+     *
+     * A re-delivered waterfall (DSH replays pending waterfalls to a reconnected
+     * `$events` client) rebuilds the view from the agent payload, which carries no
+     * card-local state: a plain replace would drop the checkmarks of questions the
+     * user already answered while `answers` still counts them, so the card would
+     * contradict what a submit sends. Only recorded answers (`answers` / `notes`)
+     * are restored; unsubmitted multi-select toggles are card-local by design.
+     * Alignment is by index: the same requestId means the same batch.
+     */
+    reapplyRecordedAnswers(tracked, view) {
+        if (view.kind !== 'question' || tracked.kind !== 'question')
+            return view;
+        const questions = view.questions ?? [];
+        if (questions.length === 0)
+            return view;
+        return {
+            ...view,
+            questions: questions.map((question, index) => {
+                const selected = tracked.answers?.get(index);
+                const note = tracked.notes?.get(index);
+                if (selected === undefined && note === undefined)
+                    return question;
+                return {
+                    ...question,
+                    ...(selected === undefined ? {} : { selected }),
+                    ...(note === undefined ? {} : { note }),
+                };
+            }),
+        };
+    }
     /** 记录问题答案到 tracked.answers（懒初始化 Map）。 */
     recordAnswer(tracked, questionIndex, values) {
         tracked.answers ??= new Map();

package/dist/bridge/index.d.ts

@@ -4,7 +4,7 @@ import type { SessionReaderRegistry, SessionStore } from '../session/index.js';
 import type { AppConfig } from '../config/index.js';
 import { type RunCardChannel } from '../card/run-card-session.js';
 import type { RunTerminal } from '../card/run-state.js';
-import { type AgentKind } from '../runner/types.js';
+import { type AgentKind, type StopOutcome } from '../runner/types.js';
 import { QueueManager, type QueuedTask, type EnqueueOptions, type AgentBinding, type ExecutingInfo } from './queue-manager.js';
 import type { InboundMediaPayload } from '../connector/index.js';
 import type { MediaOutcome } from '../inbound/turn.js';
@@ -46,6 +46,13 @@ export interface CommandResult {
     markdown?: string;
     card?: object;
 }
+/** Detailed result of one interrupt, for callers that must not over-promise. */
+export interface InterruptOutcome {
+    stopped: boolean;
+    agentKind?: AgentKind;
+    /** Present for DSH: what the remote stop actually achieved. */
+    stop?: StopOutcome;
+}
 export interface ActiveRunSnapshot {
     runId: string;
     userId: string;
@@ -151,6 +158,16 @@ export declare class Bridge {
      * 与 session 是否还在、能否压缩无关（2026-10-08 线上缺陷）。
      */
     private compactableRuns;
+    /**
+     * 终态卡片的渲染快照（runId → state + options），供「详情」在 run 结束后
+     * 仍能二次渲染。
+     *
+     * run 结束时 activeRuns 被清空，而卡片上的「详情」按钮还活着；没有快照，
+     * 点终态卡上的「详情」只能得到一句「已失效」。只保留最近若干条：单条快照
+     * 受 MAX_BLOCKS 约束（几十 KB 以内），用户只会点刚收到的卡。
+     */
+    private runCardSnapshots;
+    private static readonly RUN_CARD_SNAPSHOT_MAX;
     /**
      * Active `!` bash runs, keyed by runId (NOT cwd). Bash runs bypass the serial
      * queue and may run in parallel with claude runs / other bash runs in the same
@@ -318,6 +335,20 @@ export declare class Bridge {
          * omitted, all workspaces are candidates (used by /stop, /t, and card stop button which don't know which cwd to target). */
         cwd?: string;
     }): Promise<boolean>;
+    /**
+     * Same as {@link interruptCurrentRun}, plus what the runner's stop actually
+     * achieved. DSH returns a {@link StopOutcome} (withdrawn / cancelled /
+     * unconfirmed); process runners and bash return none.
+     *
+     * Callers use `stop.status === 'unconfirmed'` to avoid promising "stopped" or
+     * "executing immediately" when a turn may still be running in the host.
+     */
+    interruptCurrentRunDetailed(input: {
+        userId: string;
+        chatId: string;
+        runId?: string;
+        cwd?: string;
+    }): Promise<InterruptOutcome>;
     /** Send a result message to the user (§7). Returns true on success, false on failure. */
     sendResult(result: CommandResult, ctx: CommandContext): Promise<boolean>;
     /**
@@ -345,6 +376,22 @@ export declare class Bridge {
      * card id from their set on `false`.
      */
     patchCard(messageId: string, card: object): Promise<boolean>;
+    /**
+     * 终态快照的写入点：finalize 时把当前 state + 渲染选项留一份。
+     *
+     * 不放在 finish() 里：bridge 才知道 hasRunCompact 等渲染选项，且 eviction
+     * 与 activeRuns 生命周期在同一个地方收口。
+     */
+    private rememberRunCardSnapshot;
+    /**
+     * 停止终态卡上的一个后台任务。
+     *
+     * 后台任务的生命周期跨 run（这就是它需要单独入口的原因），所以解析路径是
+     * 终态快照（runId → sessionId/cwd/agentKind）+ 该工作区的 runner 实例，
+     * 而不是 activeRuns。成功后同步摘掉 state 里的任务并就地重渲染，否则按钮
+     * 会留在卡片上而任务早已结束。
+     */
+    killBackgroundJob(runId: string, jobId: string, ctx: CommandContext): Promise<boolean>;
     /** Send a file to the user via Feishu. */
     sendFile(filePath: string, ctx: CommandContext): Promise<void>;
     /**

package/dist/bridge/index.js

@@ -150,6 +150,16 @@ export class Bridge {
      * 与 session 是否还在、能否压缩无关（2026-10-08 线上缺陷）。
      */
     compactableRuns = new Map();
+    /**
+     * 终态卡片的渲染快照（runId → state + options），供「详情」在 run 结束后
+     * 仍能二次渲染。
+     *
+     * run 结束时 activeRuns 被清空，而卡片上的「详情」按钮还活着；没有快照，
+     * 点终态卡上的「详情」只能得到一句「已失效」。只保留最近若干条：单条快照
+     * 受 MAX_BLOCKS 约束（几十 KB 以内），用户只会点刚收到的卡。
+     */
+    runCardSnapshots = new Map();
+    static RUN_CARD_SNAPSHOT_MAX = 8;
     /**
      * Active `!` bash runs, keyed by runId (NOT cwd). Bash runs bypass the serial
      * queue and may run in parallel with claude runs / other bash runs in the same
@@ -575,6 +585,17 @@ export class Bridge {
         return result;
     }
     async interruptCurrentRun(input) {
+        return (await this.interruptCurrentRunDetailed(input)).stopped;
+    }
+    /**
+     * Same as {@link interruptCurrentRun}, plus what the runner's stop actually
+     * achieved. DSH returns a {@link StopOutcome} (withdrawn / cancelled /
+     * unconfirmed); process runners and bash return none.
+     *
+     * Callers use `stop.status === 'unconfirmed'` to avoid promising "stopped" or
+     * "executing immediately" when a turn may still be running in the host.
+     */
+    async interruptCurrentRunDetailed(input) {
         // Find the active claude run matching this user/chat
         for (const [cwd, active] of this.activeRuns) {
             if (input.cwd !== undefined && cwd !== input.cwd)
@@ -595,13 +616,18 @@ export class Bridge {
                 // unconditional reset would then zero the successor's count and mark
                 // its slot interrupted, hiding it from queue cards.
                 const stoppedSlot = this.queueManager.getExecutingSlot(cwd);
-                await Promise.allSettled([
+                const [, stopResult] = await Promise.allSettled([
                     // 用户主动中断（/stop、stop 卡按钮、queue.immediate）显式打标
                     // interruptedReason，与审批超时自动取消（approval_timeout）、审批
                     // 卡取消（approval_cancelled）在终态数据上可区分（方案 A）。
                     active.session.finish('interrupted', { interruptedReason: 'user_stop' }),
                     runner.stop({ immediate: true }),
                 ]);
+                const stop = stopResult.status === 'fulfilled' &&
+                    stopResult.value !== null &&
+                    typeof stopResult.value === 'object'
+                    ? stopResult.value
+                    : undefined;
                 // The chain may have advanced while the stop was in flight: a new run
                 // (from a task that began during the stop window) may now occupy this
                 // cwd. Only delete the entry we actually stopped.
@@ -641,7 +667,7 @@ export class Bridge {
                     this.queueManager.resetExecutingCount(cwd, stoppedSlot);
                 }
                 getLogger().info(`[lark-remote] interrupt stop done runId=${active.runId}`);
-                return true;
+                return { stopped: true, agentKind: active.agentKind, ...(stop ? { stop } : {}) };
             }
         }
         // Then check active bash runs (! commands). These bypass the serial queue
@@ -658,11 +684,11 @@ export class Bridge {
                 await b.cardSession.finish('interrupted', { exitCode: -1 });
                 this.activeBashRuns.delete(runId);
                 getLogger().info(`[lark-remote] interrupt bash stop done runId=${runId}`);
-                return true;
+                return { stopped: true };
             }
         }
         getLogger().debug(`[lark-remote] interrupt miss userId=${input.userId}`);
-        return false;
+        return { stopped: false };
     }
     /** Send a result message to the user (§7). Returns true on success, false on failure. */
     async sendResult(result, ctx) {
@@ -756,6 +782,47 @@ export class Bridge {
             return false;
         }
     }
+    /**
+     * 终态快照的写入点：finalize 时把当前 state + 渲染选项留一份。
+     *
+     * 不放在 finish() 里：bridge 才知道 hasRunCompact 等渲染选项，且 eviction
+     * 与 activeRuns 生命周期在同一个地方收口。
+     */
+    rememberRunCardSnapshot(runId, state, options, cwd, agentKind) {
+        this.runCardSnapshots.set(runId, { state, options, cwd, agentKind });
+        while (this.runCardSnapshots.size > Bridge.RUN_CARD_SNAPSHOT_MAX) {
+            const oldest = this.runCardSnapshots.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.runCardSnapshots.delete(oldest);
+        }
+    }
+    /**
+     * 停止终态卡上的一个后台任务。
+     *
+     * 后台任务的生命周期跨 run（这就是它需要单独入口的原因），所以解析路径是
+     * 终态快照（runId → sessionId/cwd/agentKind）+ 该工作区的 runner 实例，
+     * 而不是 activeRuns。成功后同步摘掉 state 里的任务并就地重渲染，否则按钮
+     * 会留在卡片上而任务早已结束。
+     */
+    async killBackgroundJob(runId, jobId, ctx) {
+        const snapshot = this.runCardSnapshots.get(runId);
+        const sessionId = snapshot?.state.sessionId;
+        if (!snapshot || !sessionId)
+            return false;
+        const runner = this.getRunner(snapshot.cwd, snapshot.agentKind);
+        if (typeof runner.killJob !== 'function')
+            return false;
+        const killed = await runner.killJob(sessionId, jobId);
+        if (!killed)
+            return false;
+        snapshot.state = {
+            ...snapshot.state,
+            backgroundJobs: (snapshot.state.backgroundJobs ?? []).filter((job) => job.id !== jobId),
+        };
+        await this.updateCardInPlace(renderRunCard(snapshot.state, snapshot.options), ctx);
+        return true;
+    }
     /** Send a file to the user via Feishu. */
     async sendFile(filePath, ctx) {
         try {
@@ -1222,7 +1289,10 @@ export class Bridge {
                                     await r.respondApproval(requestId, response);
                                 }
                             },
-                            interruptTurn: () => runner.stop(),
+                            interruptTurn: async () => {
+                                // DSH may return a StopOutcome; the coordinator only awaits.
+                                await runner.stop();
+                            },
                             pushToCard: async (events) => {
                                 for (const ev of events)
                                     await cardSession.push(ev);
@@ -1409,17 +1479,19 @@ export class Bridge {
         try {
             getLogger().debug(`[lark-remote] finally settle runId=${runId} state.terminal=${cardSession.currentState.terminal}`);
             const settleResult = await cardSession.settle();
+            // 卡片收尾后仍要能点「详情」：把终态 state 与当时的渲染选项留一份。
+            // 与 fallback 卡共用同一份 options（能力门控一致，展开后按钮语义不变）。
+            const finalRenderOptions = {
+                agentKind: activeRun.agentKind,
+                // 与 createRunSession 的 renderOptions 一致：fallback 卡也要按
+                // runner 能力门控 Compact 按钮（缺省 undefined = 显示按钮，
+                // DSH 等无 runCompact 的 agent 会渲染出点了报错的死按钮）。
+                compactSupported: this.hasRunCompact(cwd, activeRun.agentKind),
+            };
+            this.rememberRunCardSnapshot(runId, cardSession.currentState, finalRenderOptions, cwd, activeRun.agentKind);
             let runCardSent = false;
             if (settleResult === 'unsent') {
-                const sent = await this.sendResult({
-                    card: renderRunCard(cardSession.currentState, {
-                        agentKind: activeRun.agentKind,
-                        // 与 createRunSession 的 renderOptions 一致：fallback 卡也要按
-                        // runner 能力门控 Compact 按钮（缺省 undefined = 显示按钮，
-                        // DSH 等无 runCompact 的 agent 会渲染出点了报错的死按钮）。
-                        compactSupported: this.hasRunCompact(cwd, activeRun.agentKind),
-                    }),
-                }, ctx);
+                const sent = await this.sendResult({ card: renderRunCard(cardSession.currentState, finalRenderOptions) }, ctx);
                 runCardSent = sent;
             }
             else {

package/dist/card/approval-render.js

@@ -399,10 +399,19 @@ function renderQuestionApproval(approval, expired, runId) {
         });
     }
     if (expired) {
+        // 提问不是权限审批：过期后 agent 侧要么已按跳过继续、要么转由 Web UI
+        // 回答，统一文案不能写成「审批已过期」。是否还能在别处回答由数据驱动
+        // （DSH 可继续在 Web UI 答，Claude/Codex 不能），渲染层不写死语义。
         elements.push({
             tag: 'div',
-            text: { tag: 'lark_md', content: '⏰ **审批已过期**' },
+            text: { tag: 'lark_md', content: '⏰ **提问已超时**' },
         });
+        if (approval.expiredHint) {
+            elements.push({
+                tag: 'div',
+                text: { tag: 'lark_md', content: approval.expiredHint.replace(/`/g, '·') },
+            });
+        }
         return elements;
     }
     const questions = approval.questions ?? [];
@@ -418,6 +427,19 @@ function renderQuestionApproval(approval, expired, runId) {
                 content: `**${header}**${q.multiSelect ? '（可多选）' : ''}\n${q.question}`,
             },
         });
+        if (q.detail) {
+            // 题面外的补充正文（DSH plan-review 提问把计划全文放这里）：必须随题
+            // 渲染，否则用户是在「看不见计划」的情况下批准。与 ExitPlanMode 的
+            // 计划面板同口径：反引号中和 + 表格限数 + 字节预算折叠展示。
+            const neutralized = q.detail.replace(/`/g, '·');
+            const content = truncateUtf8(truncateMarkdownTables(neutralized), PLAN_PANEL_BYTES);
+            elements.push(collapsibleMarkdownPanel({
+                title: '📋 详情',
+                expanded: false,
+                border: 'blue',
+                content,
+            }));
+        }
         if (freeText) {
             // 自由文本题（Codex options:null / Pi extension input）：无选项行，
             // 直接渲染题面 + 输入框，提交走 answerCustom（coordinator 不要求有选项）。

package/dist/card/card-budget.d.ts

@@ -6,6 +6,43 @@
  *
  * Docs: https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukz/feishu-cards/card-components/containers/collapsible-panel
  */
+/**
+ * 飞书单卡「元素」总量上限（实测）。
+ *
+ * 2026-10-19 用真实 API 在测试会话探测（`tests/feishu-live/feishu-card-element-total-limit.test.ts`
+ * 与 `feishu-workspace-card-limit` / `feishu-order-active-card-limit`）：
+ *
+ * | 形状 | 结果 | elements 计数 |
+ * | --- | --- | --- |
+ * | 顶层平铺 99 个 div | ✅ | 99 |
+ * | 顶层平铺 100 个 div | ❌ 11310 | 100 |
+ * | 单列 column_set 内嵌 98 个 div | ✅ | 99 |
+ * | 单列 column_set 内嵌 99 个 div | ❌ | 100 |
+ * | `/order` 旧结构 20 行 | ❌ | 103 |
+ * | `/ws` 旧结构 20 行 | ❌ | 101 |
+ * | `/ws` 分页 15 行（整卡 227 个 JSON 对象） | ✅ | 80 |
+ *
+ * 判据是**递归统计 `elements` 数组成员**（不含 `columns`）**≤ 99**：所有实测的
+ * 成功/失败点都被它分开，而"整卡 JSON 对象数"分不开（`/ws` 分页卡 227 个对象
+ * 能发出去，平铺 100 个 div 只有 205 个对象却失败）。
+ *
+ * 另一个独立维度：单个 `column_set` 的列数（实测 66 列通过、67 列失败）。本仓库
+ * 所有卡片的列数都在 3 以内，用不到这个上限，仅在此记录以免再次误判。
+ *
+ * **旧结论勘误**：仓库曾把 `230025` 记为「elements 过多」。本次探测中它一次都
+ * 没有出现；元素超限统一是 `230099 / ErrCode: 11310 element exceeds the limit`。
+ *
+ * `MAX_CARD_ELEMENTS` 取 90（相对实测 99 留 10% 余量），用于渲染前的保守裁剪。
+ */
+export declare const MAX_CARD_ELEMENTS = 90;
+/**
+ * 卡片递归的 `elements` 数组成员数（`columns` 不计数）——与飞书实测边界对齐。
+ *
+ * 注意与"JSON 对象总数"不同：`column_set` 的 `column` 对象不计入，button 的
+ * `behaviors`/`value` 也不计入。用它做预算才既不误伤能发出去的卡片，也不放过
+ * 真正超限的卡片。
+ */
+export declare function countCardElements(card: unknown): number;
 interface CardBudgetOptions {
     /** 最大事件面板数量（保留最新的） */
     maxEventPanels?: number;