lark-remote 0.1.12 → 0.2.0

package/CHANGELOG.md

@@ -5,6 +5,43 @@ 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.2.0] - 2026-09-11
+
+### 新增
+
+- **Windows 平台支持（预发布）**：新增跨平台平台层（`src/platform/`）——路径、可执行文件发现、进程终止、spawn、shell 的抽象与 posix / win32 双实现；命令拉起统一走 `cross-spawn`，posix 行为零变化。Windows 尚未正式发布，README 前置条件已相应标注
+- **`/download <path>`（别名 `/d`）**：把本地文件直接发到会话，不经 `/ls` 卡片。路径规则同 `/ls`（`~` 展开、相对 cwd、30MB 上限），目录 / 不存在 / 超限给出明确错误
+- **`/ls <file>` 单文件卡**：传入文件路径渲染单文件卡（完整路径、大小、修改时间、「📎 下载」+「上级」按钮），不再报 `ls: xxx: Not a directory`
+- **分页栏页码跳转**：所有分页卡片（`/ls`、`/ws`、`/resume`、`/active`、`/order`）支持在分页栏输入页码直达；越界钳到末页，非数字输入报错且不刷新卡片
+- **扫码向导跨平台**：二维码渲染改用 `qrcode-generator`，Windows 全块渲染 + 静区 + 图片兜底
+
+### 修复
+
+- `/ls` 的「返回」改为回到浏览起点（`/ls <dir>` 指定的目录），不再跳回 workspace cwd；浏览起点随卡片 payload 传递，翻页 / 刷新 / 上级 / 目录按钮不会丢失
+- codex 会话兼容 rollout ≥0.153.4 的 `item_completed` 词表，修复 `/resume` 标题丢失
+- compact 卡片空内容渲染「Compact 完成」，不再显示通用空占位
+- 信息保真：notices 改为时间线消息渲染、省略提示固定置顶、工具卡片消除孤立代理项
+- Windows：隐藏 cmd.exe 控制台窗口（`windowsHide`）
+
+### 变更
+
+- **移除 `output.showThinking` / `showToolUse` / `showToolResult` 配置项与 `/config` 的「📤 输出」页签**：thinking、工具调用与工具结果恒常展示；旧配置文件的 `output` 段在加载时自动忽略，并在下次保存时从磁盘清理
+- 代码精简：ACP / translator / session 共享层下沉（`BaseAcpTranslator` / `BaseAcpRunner` / two-pass 扫描），死代码清理与平行重复收敛
+- 依赖：`qrcode-terminal` 换为 `qrcode-generator`；新增 `cross-spawn`（Windows 命令拉起）
+- 测试基建：新增 scoped typecheck（`tsconfig.test-infra.json`）覆盖 `tests/lib/**` 共享工厂；跨平台测试稳定化（win32 路径归一化、并行 vitest 内存上限）
+
+## [0.1.13] - 2026-09-04
+
+### 修复
+
+- kimi ACP Compact 等待机制重构：等待协议终态（complete / cancel / unknown）再收尾，移除「30s 超时即视为成功」的假完成路径——Compact 实际失败或被取消时如实反馈
+
+### 变更
+
+- 代码与测试清理：死导出/死字段清理、bridge usage 统计收敛、router 样板收敛、session 公共件下沉（`ttl-cache` / `recency`）、ACP 共享层下沉
+- 测试治理：超大测试文件按主题拆分、agent choices 测试表驱动化、弱断言收敛、移除无效测试
+- 移除未使用的 `@types/form-data` 依赖
+
 ## [0.1.12] - 2026-08-29
 
 ### 修复

package/README.en.md

@@ -73,11 +73,6 @@ claude:
   # permissionMode is hardcoded to bypassPermissions (inside the runner)
   stopGraceMs: 5000
 
-output:
-  showThinking: true
-  showToolUse: true
-  showToolResult: true
-
 logging:
   level: info               # debug | info | warn | error
 
@@ -113,7 +108,8 @@ Your original message also gets an emoji reaction: `Typing` while the run is in
 |---------|-------|----------|
 | `/help` | `/h` | Command list |
 | `/cd <path>` | - | Switch agent working directory (`~`, absolute/relative; clears the session) |
-| `/ls [dir]` | - | Directory/file card; click a directory to switch, click a file ≤30MB to send it to Feishu; paginates beyond 30 entries |
+| `/ls [dir\|file]` | - | Directory/file card; click a directory to browse, click a file ≤30MB to send it to Feishu; paginates beyond 30 entries with a page-number jump input. Passing a file path lists that file itself |
+| `/download <path>` | `/d` | Send a local file straight to the chat (`~`, absolute/relative paths, 30MB cap) |
 | `/ws save\|use\|remove` | - | Named directory aliases (`/ws` lists by default) |
 | `/resume [agent] [N\|id]` | `/r` | List/switch agent sessions for the current directory (card) |
 | `/active` | - | List all running sessions |

package/README.md

@@ -29,7 +29,7 @@ Codex 审批模式下，执行命令前会收到审批卡片，可直接在飞
 
 ## 前置条件
 
-- 操作系统：macOS / Linux。**暂不支持 Windows**（依赖 Unix 信号、bash、文件锁等 POSIX 行为）
+- 操作系统：macOS / Linux。**暂不支持 Windows**（原生 Windows 支持在建设中：平台 seam 已落地，待真机验证后发布）
 - Node.js 20+（开发时用 [Bun](https://bun.sh/)）
 - 飞书自建应用（二选一）：扫码创建（首次启动终端弹二维码，飞书 App 扫码即自动创建并写入凭据）；或手动在开放平台建应用——开启机器人能力，订阅 `im.message.receive_v1` 和 `card.action.trigger`，订阅方式选「长连接」（WebSocket，无需公网地址），权限至少 `im:message`。
 - Claude Code CLI：本地安装并在终端完成一次登录（`claude` → 浏览器 OAuth）。使用其他 agent（codex / opencode / pi / kimi）同理，先装好对应 CLI；DSH 需本地 DSH Web Host 在跑（默认 `http://127.0.0.1:3080`），lark-remote 通过 HTTP+WebSocket 直连、不 spawn 本地子进程。
@@ -73,11 +73,6 @@ claude:
   # permissionMode 硬编码为 bypassPermissions（runner 内部）
   stopGraceMs: 5000
 
-output:
-  showThinking: true
-  showToolUse: true
-  showToolResult: true
-
 logging:
   level: info               # debug | info | warn | error
 
@@ -113,7 +108,8 @@ bridge 启动后不在终端输出，运行日志写入 `~/.lark-remote/logs/YYY
 |------|------|------|
 | `/help` | `/h` | 命令列表 |
 | `/cd <path>` | - | 切换 agent 工作目录（支持 `~`、绝对/相对路径，清空会话） |
-| `/ls [dir]` | - | 弹出目录/文件卡片；点击目录切换，点击 30MB 内文件发送到飞书；条目 >30 时支持翻页 |
+| `/ls [dir\|file]` | - | 弹出目录/文件卡片；点击目录切换，点击 30MB 内文件发送到飞书；条目 >30 时支持翻页与直接输入页码跳转。传文件路径时直接列出该文件（可下载） |
+| `/download <path>` | `/d` | 直接下载（发送）指定文件到飞书（支持 `~`、绝对/相对路径，上限 30MB） |
 | `/ws save\|use\|remove` | - | 命名目录别名管理（`/ws` 默认列出） |
 | `/resume [agent] [N\|id]` | `/r` | 列出/切换当前目录的 agent session（卡片） |
 | `/active` | - | 列出所有正在进行中的 session |

package/dist/bridge/final-usage.d.ts

@@ -0,0 +1,24 @@
+import type { SessionReaderRegistry } from '../session/index.js';
+import type { AgentKind } from '../runner/index.js';
+export declare function errorMessage(error: unknown): string;
+export type FinalUsageSnapshot = {
+    contextLength?: number;
+    contextLimit?: number;
+    compactCount?: number;
+    compactPreContextLength?: number;
+    cacheReadTokens?: number;
+    cacheCreationTokens?: number;
+    totalTokens?: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    cumulativeTotalTokens?: number;
+    cumulativeInputTokens?: number;
+    cumulativeOutputTokens?: number;
+    cumulativeCacheReadTokens?: number;
+    cumulativeCacheCreationTokens?: number;
+};
+/**
+ * Read final usage (contextLength + compactCount + cache tokens) from the
+ * session jsonl. Called after a run finishes.
+ */
+export declare function resolveFinalUsage(registry: SessionReaderRegistry, defaultAgent: AgentKind, sessionId: string | undefined, cwd: string, agentKind?: AgentKind): FinalUsageSnapshot | undefined;

package/dist/bridge/final-usage.js

@@ -0,0 +1,55 @@
+/**
+ * Final usage resolution extracted from Bridge (2026-09 round-2
+ * simplification): after a run finishes, re-read the session transcript via
+ * the agent's session reader — live stream-json does not emit
+ * compact_boundary, so the live contextLength (fallback to result.usage
+ * input+output) is unreliable. The transcript jsonl is authoritative for
+ * postTokens + compact event count.
+ *
+ * Bridge state is passed in explicitly (registry + default agent); the
+ * function itself is stateless.
+ */
+import { getLogger } from '../logger/index.js';
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * Read final usage (contextLength + compactCount + cache tokens) from the
+ * session jsonl. Called after a run finishes.
+ */
+export function resolveFinalUsage(registry, defaultAgent, sessionId, cwd, agentKind = defaultAgent) {
+    if (!sessionId)
+        return undefined;
+    try {
+        const content = registry.get(agentKind).readSessionContent(sessionId, cwd);
+        if (!content.usage) {
+            // EnterWorktree relocate (2026-08-04): jsonl read silently returned no
+            // usage (e.g. transcript moved mid-session). Surface it so token-stat
+            // fallback to per-run live usage is visible in logs, not silent.
+            getLogger().warn(`[bridge] resolveFinalUsage: no usage from jsonl sessionId=${sessionId} cwd=${cwd} agent=${agentKind}, card falls back to per-run live usage`);
+        }
+        return content.usage
+            ? {
+                contextLength: content.usage.contextLength,
+                contextLimit: content.usage.contextLimit,
+                compactCount: content.usage.compactCount,
+                compactPreContextLength: content.usage.compactPreContextLength,
+                cacheReadTokens: content.usage.cacheReadTokens,
+                cacheCreationTokens: content.usage.cacheCreationTokens,
+                totalTokens: content.usage.totalTokens,
+                inputTokens: content.usage.inputTokens,
+                outputTokens: content.usage.outputTokens,
+                cumulativeTotalTokens: content.usage.cumulativeTotalTokens,
+                cumulativeInputTokens: content.usage.cumulativeInputTokens,
+                cumulativeOutputTokens: content.usage.cumulativeOutputTokens,
+                cumulativeCacheReadTokens: content.usage.cumulativeCacheReadTokens,
+                cumulativeCacheCreationTokens: content.usage.cumulativeCacheCreationTokens,
+            }
+            : undefined;
+    }
+    catch (err) {
+        getLogger().warn(`[bridge] resolveFinalUsage failed sessionId=${sessionId}: ${errorMessage(err)}`);
+        return undefined;
+    }
+}
+//# sourceMappingURL=final-usage.js.map

package/dist/bridge/inbound-media.d.ts

@@ -23,9 +23,6 @@ export declare function sanitizeFileName(name: string): string;
  * 两者都无法识别时返回 undefined（调用方省略扩展名，避免错误标注格式）。
  */
 export declare function imageExtension(mimeType: string | undefined, head: Buffer): string | undefined;
-/** 按 UTF-8 字节数截断字符串（避免截在多字节字符中间）。 */
-import { truncateUtf8 } from '../common/truncate.js';
-export { truncateUtf8 };
 /**
  * 文件名长度限制（字节级，保留扩展名），避免 ENAMETOOLONG 整文件失败。
  * 极罕见情况（扩展名本身超限）直接截断全名。

package/dist/bridge/inbound-media.js

@@ -99,7 +99,6 @@ export function imageExtension(mimeType, head) {
 }
 /** 按 UTF-8 字节数截断字符串（避免截在多字节字符中间）。 */
 import { truncateUtf8 } from '../common/truncate.js';
-export { truncateUtf8 };
 /**
  * 文件名长度限制（字节级，保留扩展名），避免 ENAMETOOLONG 整文件失败。
  * 极罕见情况（扩展名本身超限）直接截断全名。

package/dist/bridge/index.d.ts

@@ -361,13 +361,6 @@ export declare class Bridge {
      * Handles fallback card sending, completion notification, and cleanup.
      */
     private finalizeRun;
-    /**
-     * Read final usage (contextLength + compactCount + cache tokens) from the session jsonl.
-     * Called after a run finishes: live stream-json does not emit compact_boundary,
-     * so the live contextLength (fallback to result.usage input+output) is
-     * unreliable. The jsonl is authoritative for postTokens + compact event count.
-     */
-    private resolveFinalUsage;
     /**
      * Send a notification card when a run completes.
      * This card contains the session summary and a button to resume the session.
@@ -463,6 +456,13 @@ export declare class Bridge {
     handleCodexCompact(value: {
         runId?: string;
     }, ctx: BridgeContext): Promise<void>;
+    /**
+     * §5.3: kimi 压缩在途检测——reader 鸭子实现 `readCompactionState` 时，若
+     * wire 状态机判定当前有未终结的压缩（最后一次 begin 无 terminal 记录），
+     * 直接回文本「已有一次 Compact 正在进行」并返回 true（调用方不开卡、不发
+     * session/prompt）。codex/claude 等 reader 无此方法 → 返回 false，行为不变。
+     */
+    private rejectIfCompactionInFlight;
     /**
      * Stream a compaction to a card: start a RunCardSession with
      * operationKind='compaction' (no recursive Compact button), consume

package/dist/bridge/index.js

@@ -1,5 +1,6 @@
 import { randomUUID } from 'node:crypto';
 import { sleep } from '../common/sleep.js';
+import { resolveFinalUsage, errorMessage } from './final-usage.js';
 import { getLogger } from '../logger/index.js';
 import { RunCardSession } from '../card/run-card-session.js';
 import { renderRunCard } from '../card/run-renderer.js';
@@ -48,6 +49,13 @@ const TERMINAL_REACTION_EMOJI = {
 function terminalReactionEmoji(terminal) {
     return TERMINAL_REACTION_EMOJI[terminal] ?? 'Done';
 }
+/**
+ * W2.4 单点化：`'runCompact' in runner` 鸭子探测（compact 按钮门控，
+ * design doc §6.2-2）。codex app-server + kimi/opencode ACP runner 满足。
+ */
+function runnerHasRunCompact(runner) {
+    return ('runCompact' in runner && typeof runner.runCompact === 'function');
+}
 /**
  * Bridge owns the per-workspace serial processing queue (§9.6) and the
  * single-card streaming forwarding loop (§9.12 watchdog + session sync).
@@ -245,7 +253,7 @@ export class Bridge {
      */
     hasRunCompact(workspace, kind = this.config.defaultAgent) {
         const runner = this.getRunner(workspace, kind);
-        return ('runCompact' in runner && typeof runner.runCompact === 'function');
+        return runnerHasRunCompact(runner);
     }
     /** 入队时刻快照：当前 defaultAgent + 该 agent 的 sessionId（无 session 则 undefined）。
      *  唯一捕获点：排队消息在 T0 把 agent+session 钉进 AgentBinding，随任务闭包带到 T1
@@ -764,9 +772,6 @@ export class Bridge {
             replyTo: ctx.messageId,
             runId,
             renderOptions: {
-                showThinking: this.config.output.showThinking,
-                showToolUse: this.config.output.showToolUse,
-                showToolResult: this.config.output.showToolResult,
                 // Run card header shows the current agent name (e.g. "Claude · 思考中")
                 agentKind,
                 // Compact 按钮能力门控与 resume 卡 / auto-resume 卡一致（hasRunCompact
@@ -834,6 +839,29 @@ export class Bridge {
         let finalCumulativeOutputTokens;
         let finalCumulativeCacheReadTokens;
         let finalCumulativeCacheCreationTokens;
+        // Reasoning tokens (pi usage.reasoning) from the live result event.
+        let finalReasoningTokens;
+        // 统一的 usage meta 构造（finalize 各分支共享，本方法内原先 5 处手写 11-15
+        // 字段对象；第 6 处 streamCodexCompact 形状不同未收敛）。
+        // catch 路径需覆盖 flow 字段时在展开后覆写即可。catch error 路径亦复用此
+        // 闭包，相比旧手写对象补齐了累计 cache 字段（cumulativeCacheReadTokens/
+        // cumulativeCacheCreationTokens），属有意的口径对齐（向 done 路径看齐）。
+        const usageMeta = () => ({
+            contextLength: finalContextLength,
+            contextLimit: finalContextLimit,
+            compactCount: finalCompactCount,
+            cacheReadTokens: finalCacheReadTokens,
+            cacheCreationTokens: finalCacheCreationTokens,
+            totalTokens: finalTotalTokens,
+            inputTokens: finalInputTokens,
+            outputTokens: finalOutputTokens,
+            cumulativeTotalTokens: finalCumulativeTotalTokens,
+            cumulativeInputTokens: finalCumulativeInputTokens,
+            cumulativeOutputTokens: finalCumulativeOutputTokens,
+            cumulativeCacheReadTokens: finalCumulativeCacheReadTokens,
+            cumulativeCacheCreationTokens: finalCumulativeCacheCreationTokens,
+            reasoningTokens: finalReasoningTokens,
+        });
         try {
             try {
                 getLogger().debug(`[bridge] cardSession.start() begin runId=${runId}`);
@@ -1027,6 +1055,9 @@ export class Bridge {
                         if (u.totalTokens !== undefined) {
                             finalTotalTokens = u.totalTokens;
                         }
+                        if (u.reasoningTokens !== undefined) {
+                            finalReasoningTokens = u.reasoningTokens;
+                        }
                     }
                 }
                 // Approval events (Codex app-server mode)
@@ -1105,7 +1136,7 @@ export class Bridge {
             const finalSessionId = this.sessionStore.getSessionId(ctx.userId, agentKind);
             const finalUsage = resultNotSuccess
                 ? undefined
-                : this.resolveFinalUsage(finalSessionId, cwd, agentKind);
+                : resolveFinalUsage(this.sessionReaderRegistry, this.config.defaultAgent, finalSessionId, cwd, agentKind);
             finalContextLength = finalUsage?.contextLength ?? contextLength;
             finalContextLimit = finalUsage?.contextLimit ?? liveContextLimit;
             finalCompactCount = finalUsage?.compactCount;
@@ -1156,57 +1187,19 @@ export class Bridge {
                 await cardSession.finish(terminal, {
                     resultSubtype: subtype,
                     errorMsg: finalState.errorMsg,
-                    contextLength: finalContextLength,
-                    contextLimit: finalContextLimit,
-                    compactCount: finalCompactCount,
-                    cacheReadTokens: finalCacheReadTokens,
-                    cacheCreationTokens: finalCacheCreationTokens,
-                    totalTokens: finalTotalTokens,
-                    inputTokens: finalInputTokens,
-                    outputTokens: finalOutputTokens,
-                    cumulativeTotalTokens: finalCumulativeTotalTokens,
-                    cumulativeInputTokens: finalCumulativeInputTokens,
-                    cumulativeOutputTokens: finalCumulativeOutputTokens,
-                    cumulativeCacheReadTokens: finalCumulativeCacheReadTokens,
-                    cumulativeCacheCreationTokens: finalCumulativeCacheCreationTokens,
+                    ...usageMeta(),
                 });
             }
             else if (finalState.terminal === 'running') {
                 await cardSession.finish('error', {
-                    contextLength: finalContextLength,
-                    contextLimit: finalContextLimit,
-                    compactCount: finalCompactCount,
-                    cacheReadTokens: finalCacheReadTokens,
-                    cacheCreationTokens: finalCacheCreationTokens,
-                    totalTokens: finalTotalTokens,
-                    inputTokens: finalInputTokens,
-                    outputTokens: finalOutputTokens,
-                    cumulativeTotalTokens: finalCumulativeTotalTokens,
-                    cumulativeInputTokens: finalCumulativeInputTokens,
-                    cumulativeOutputTokens: finalCumulativeOutputTokens,
-                    cumulativeCacheReadTokens: finalCumulativeCacheReadTokens,
-                    cumulativeCacheCreationTokens: finalCumulativeCacheCreationTokens,
+                    ...usageMeta(),
                     errorMsg: agentDisplayName(agentKind) + ' 输出流已结束，但未收到 result 事件',
                 });
             }
             else if (sawResult) {
                 // 已终态（interrupted/idle_timeout）+ result 已收到：首终态优先，
                 // 仅补充 usage meta（finalizing 期间被 /stop 或 idle 超时也展示 token 统计）
-                await cardSession.finish(finalState.terminal, {
-                    contextLength: finalContextLength,
-                    contextLimit: finalContextLimit,
-                    compactCount: finalCompactCount,
-                    cacheReadTokens: finalCacheReadTokens,
-                    cacheCreationTokens: finalCacheCreationTokens,
-                    totalTokens: finalTotalTokens,
-                    inputTokens: finalInputTokens,
-                    outputTokens: finalOutputTokens,
-                    cumulativeTotalTokens: finalCumulativeTotalTokens,
-                    cumulativeInputTokens: finalCumulativeInputTokens,
-                    cumulativeOutputTokens: finalCumulativeOutputTokens,
-                    cumulativeCacheReadTokens: finalCumulativeCacheReadTokens,
-                    cumulativeCacheCreationTokens: finalCumulativeCacheCreationTokens,
-                });
+                await cardSession.finish(finalState.terminal, usageMeta());
             }
             // else: 已终态且未收到 result（如 spawn 失败后 interrupted）-> 无 usage 可补，跳过
         }
@@ -1225,38 +1218,16 @@ export class Bridge {
             const catchTerminal = cardSession.currentState.terminal;
             if (catchTerminal === 'running' || catchTerminal === 'finalizing') {
                 await cardSession.finish('error', {
-                    contextLength: finalContextLength,
-                    contextLimit: finalContextLimit,
-                    compactCount: finalCompactCount,
-                    cacheReadTokens: finalCacheReadTokens,
-                    cacheCreationTokens: finalCacheCreationTokens,
-                    totalTokens: finalTotalTokens,
+                    ...usageMeta(),
                     inputTokens: liveInputTokens,
                     outputTokens: liveOutputTokens,
-                    cumulativeTotalTokens: finalCumulativeTotalTokens,
-                    cumulativeInputTokens: finalCumulativeInputTokens,
-                    cumulativeOutputTokens: finalCumulativeOutputTokens,
                     errorMsg: errorMessage(err),
                 });
             }
             else {
                 getLogger().info(`[bridge] skip error finish: state already terminal (${catchTerminal}) runId=${runId}`);
                 if (sawResult) {
-                    await cardSession.finish(catchTerminal, {
-                        contextLength: finalContextLength,
-                        contextLimit: finalContextLimit,
-                        compactCount: finalCompactCount,
-                        cacheReadTokens: finalCacheReadTokens,
-                        cacheCreationTokens: finalCacheCreationTokens,
-                        totalTokens: finalTotalTokens,
-                        inputTokens: finalInputTokens,
-                        outputTokens: finalOutputTokens,
-                        cumulativeTotalTokens: finalCumulativeTotalTokens,
-                        cumulativeInputTokens: finalCumulativeInputTokens,
-                        cumulativeOutputTokens: finalCumulativeOutputTokens,
-                        cumulativeCacheReadTokens: finalCumulativeCacheReadTokens,
-                        cumulativeCacheCreationTokens: finalCumulativeCacheCreationTokens,
-                    });
+                    await cardSession.finish(catchTerminal, usageMeta());
                 }
             }
         }
@@ -1283,9 +1254,6 @@ export class Bridge {
             if (settleResult === 'unsent') {
                 const sent = await this.sendResult({
                     card: renderRunCard(cardSession.currentState, {
-                        showThinking: this.config.output.showThinking,
-                        showToolUse: this.config.output.showToolUse,
-                        showToolResult: this.config.output.showToolResult,
                         agentKind: activeRun.agentKind,
                         // 与 createRunSession 的 renderOptions 一致：fallback 卡也要按
                         // runner 能力门控 Compact 按钮（缺省 undefined = 显示按钮，
@@ -1335,8 +1303,7 @@ export class Bridge {
                 // §6.2-3：写入条件从「codex 终态」放宽为「runner 有 runCompact 的终态」
                 // （codex app-server + kimi acp 均满足）。
                 const runTerminal = cardSession.currentState.terminal;
-                const runnerHasCompact = 'runCompact' in activeRun.runner &&
-                    typeof activeRun.runner.runCompact === 'function';
+                const runnerHasCompact = runnerHasRunCompact(activeRun.runner);
                 if (runnerHasCompact &&
                     activeRun.runner.lifetime === 'workspace' &&
                     (runTerminal === 'done' ||
@@ -1357,47 +1324,6 @@ export class Bridge {
             }
         }
     }
-    /**
-     * Read final usage (contextLength + compactCount + cache tokens) from the session jsonl.
-     * Called after a run finishes: live stream-json does not emit compact_boundary,
-     * so the live contextLength (fallback to result.usage input+output) is
-     * unreliable. The jsonl is authoritative for postTokens + compact event count.
-     */
-    resolveFinalUsage(sessionId, cwd, agentKind = this.config.defaultAgent) {
-        if (!sessionId)
-            return undefined;
-        try {
-            const content = this.sessionReaderRegistry.get(agentKind).readSessionContent(sessionId, cwd);
-            if (!content.usage) {
-                // EnterWorktree relocate (2026-08-04): jsonl read silently returned no
-                // usage (e.g. transcript moved mid-session). Surface it so token-stat
-                // fallback to per-run live usage is visible in logs, not silent.
-                getLogger().warn(`[bridge] resolveFinalUsage: no usage from jsonl sessionId=${sessionId} cwd=${cwd} agent=${agentKind}, card falls back to per-run live usage`);
-            }
-            return content.usage
-                ? {
-                    contextLength: content.usage.contextLength,
-                    contextLimit: content.usage.contextLimit,
-                    compactCount: content.usage.compactCount,
-                    compactPreContextLength: content.usage.compactPreContextLength,
-                    cacheReadTokens: content.usage.cacheReadTokens,
-                    cacheCreationTokens: content.usage.cacheCreationTokens,
-                    totalTokens: content.usage.totalTokens,
-                    inputTokens: content.usage.inputTokens,
-                    outputTokens: content.usage.outputTokens,
-                    cumulativeTotalTokens: content.usage.cumulativeTotalTokens,
-                    cumulativeInputTokens: content.usage.cumulativeInputTokens,
-                    cumulativeOutputTokens: content.usage.cumulativeOutputTokens,
-                    cumulativeCacheReadTokens: content.usage.cumulativeCacheReadTokens,
-                    cumulativeCacheCreationTokens: content.usage.cumulativeCacheCreationTokens,
-                }
-                : undefined;
-        }
-        catch (err) {
-            getLogger().warn(`[bridge] resolveFinalUsage failed sessionId=${sessionId}: ${errorMessage(err)}`);
-            return undefined;
-        }
-    }
     /**
      * Send a notification card when a run completes.
      * This card contains the session summary and a button to resume the session.
@@ -1562,10 +1488,13 @@ export class Bridge {
             await this.sendResult({ text: '⚠️ 未找到可压缩的会话' }, ctx);
             return;
         }
+        // §5.3: kimi 压缩在途检测（wire 状态机）。第二次点击在本地毫秒级如实回答，
+        // 不开卡、不发 session/prompt——否则 kimi 服务端拒绝并产生「秒回」假完成。
+        if (await this.rejectIfCompactionInFlight(last.sessionId, cwd, last.agentKind, ctx))
+            return;
         // Check that the runner has runCompact method
         const runner = this.getRunner(cwd, last.agentKind);
-        if (!('runCompact' in runner) ||
-            typeof runner.runCompact !== 'function') {
+        if (!runnerHasRunCompact(runner)) {
             await this.sendResult({ text: '⚠️ 当前运行模式不支持 Compact' }, ctx);
             return;
         }
@@ -1578,6 +1507,36 @@ export class Bridge {
             ctx,
         });
     }
+    /**
+     * §5.3: kimi 压缩在途检测——reader 鸭子实现 `readCompactionState` 时，若
+     * wire 状态机判定当前有未终结的压缩（最后一次 begin 无 terminal 记录），
+     * 直接回文本「已有一次 Compact 正在进行」并返回 true（调用方不开卡、不发
+     * session/prompt）。codex/claude 等 reader 无此方法 → 返回 false，行为不变。
+     */
+    async rejectIfCompactionInFlight(sessionId, cwd, agentKind, ctx) {
+        const reader = this.sessionReaderRegistry.get(agentKind);
+        if (!reader || !('readCompactionState' in reader))
+            return false;
+        try {
+            const state = reader.readCompactionState(sessionId, cwd);
+            if (state?.inFlight) {
+                const since = state.inFlightSince;
+                let timeLabel = '未知时刻';
+                if (since !== undefined) {
+                    const d = new Date(since);
+                    const hh = String(d.getHours()).padStart(2, '0');
+                    const mm = String(d.getMinutes()).padStart(2, '0');
+                    timeLabel = `${hh}:${mm}`;
+                }
+                await this.sendResult({ text: `⚠️ 已有一次 Compact 正在进行（开始于 ${timeLabel}），请等待完成` }, ctx);
+                return true;
+            }
+        }
+        catch (err) {
+            getLogger().warn(`[bridge] readCompactionState failed sessionId=${sessionId}: ${errorMessage(err)}`);
+        }
+        return false;
+    }
     /**
      * Stream a compaction to a card: start a RunCardSession with
      * operationKind='compaction' (no recursive Compact button), consume
@@ -1607,9 +1566,6 @@ export class Bridge {
             replyTo: ctx.messageId,
             runId: compactRunId,
             renderOptions: {
-                showThinking: this.config.output.showThinking,
-                showToolUse: this.config.output.showToolUse,
-                showToolResult: this.config.output.showToolResult,
                 agentKind,
             },
         });
@@ -1623,22 +1579,34 @@ export class Bridge {
                 operationKind: 'compaction',
             });
             let sawResult = false;
+            let resultSubtype;
+            let resultError;
             for await (const event of runner.runCompact('', { cwd, sessionId })) {
-                if (event.type === 'result')
+                if (event.type === 'result') {
                     sawResult = true;
+                    resultSubtype = event.subtype;
+                    resultError = event.errorMessage;
+                }
                 await cardSession.push(event);
             }
+            // §5.3: 卡片终态必须等于引擎真实终态。旧实现只看 sawResult 布尔——error
+            // subtype 的 result 也被 finish 'done'（放大器 bug，2026-08-31 事故）。
+            const terminal = resultSubtype === 'success'
+                ? 'done'
+                : resultSubtype === 'interrupted'
+                    ? 'interrupted'
+                    : 'error';
             // 压缩结束后从会话 jsonl 读权威统计（压缩后上下文、压缩次数、本次压缩
             // token 消耗与会话累计）。thread/compacted 通知与 jsonl 落盘几乎同时
             // （实测差 ~9ms），compactCount 未读到则短重试，仍失败优雅降级（无统计）。
-            let finalUsage = this.resolveFinalUsage(sessionId, cwd, agentKind);
+            let finalUsage = resolveFinalUsage(this.sessionReaderRegistry, this.config.defaultAgent, sessionId, cwd, agentKind);
             for (let attempt = 0; !finalUsage?.compactCount && attempt < 2; attempt++) {
                 await sleep(150);
-                finalUsage = this.resolveFinalUsage(sessionId, cwd, agentKind);
+                finalUsage = resolveFinalUsage(this.sessionReaderRegistry, this.config.defaultAgent, sessionId, cwd, agentKind);
             }
-            await cardSession.finish(sawResult ? 'done' : 'error', {
-                resultSubtype: sawResult ? 'success' : 'error',
-                errorMsg: sawResult ? undefined : '未收到压缩结果',
+            await cardSession.finish(terminal, {
+                resultSubtype: resultSubtype ?? 'error',
+                errorMsg: terminal === 'error' ? (resultError ?? '未收到压缩结果') : undefined,
                 contextLength: finalUsage?.contextLength,
                 contextLimit: finalUsage?.contextLimit,
                 compactPreContextLength: finalUsage?.compactPreContextLength,
@@ -1654,7 +1622,7 @@ export class Bridge {
                 cumulativeCacheReadTokens: finalUsage?.cumulativeCacheReadTokens,
                 cumulativeCacheCreationTokens: finalUsage?.cumulativeCacheCreationTokens,
             });
-            log.info(`[bridge] streamCodexCompact finished sessionId=${sessionId} sawResult=${sawResult}`);
+            log.info(`[bridge] streamCodexCompact finished sessionId=${sessionId} sawResult=${sawResult} subtype=${resultSubtype ?? 'none'}`);
         }
         catch (err) {
             log.error(`[bridge] streamCodexCompact failed: ${errorMessage(err)}`);
@@ -1709,10 +1677,12 @@ export class Bridge {
             await this.sendResult({ text: `⚠️ 未找到 session ${sessionId}（当前目录: ${cwd}）` }, ctx);
             return;
         }
+        // §5.3: kimi 压缩在途检测（与 handleCodexCompact 同一入口）。
+        if (await this.rejectIfCompactionInFlight(sessionId, cwd, agentKind, ctx))
+            return;
         // Check that the runner has runCompact（codex/kimi/opencode/pi/claude 鸭子探测）。
         const runner = this.getRunner(cwd, agentKind);
-        if (!('runCompact' in runner) ||
-            typeof runner.runCompact !== 'function') {
+        if (!runnerHasRunCompact(runner)) {
             await this.sendResult({ text: '⚠️ 当前运行模式不支持 Compact' }, ctx);
             return;
         }
@@ -1852,7 +1822,4 @@ export class Bridge {
         }
     }
 }
-function errorMessage(error) {
-    return error instanceof Error ? error.message : String(error);
-}
 //# sourceMappingURL=index.js.map

package/dist/bridge/queue-manager.js

@@ -1,4 +1,5 @@
 import { getLogger } from '../logger/index.js';
+import { displayName } from '../platform/path.js';
 /**
  * Per-workspace cap on the number of tasks WAITING to execute (review P2-5).
  * Without a bound, a message flood grows `queuedTasks` / the promise chain /
@@ -377,7 +378,7 @@ export class QueueManager {
     }
     /** Build queue status card elements. */
     buildQueueStatusCardElements(workspace, actualPosition, tasksAhead, messageId, messagePreview) {
-        const workspaceName = workspace.split('/').pop() ?? workspace;
+        const workspaceName = displayName(workspace);
         const isRunning = this.isWorkspaceRunning(workspace);
         const elements = [
             {
@@ -471,7 +472,7 @@ export class QueueManager {
             getLogger().debug(`[queue-manager] no queue card to update, messageId=${messageId}`);
             return;
         }
-        const workspaceName = workspace.split('/').pop() ?? workspace;
+        const workspaceName = displayName(workspace);
         try {
             // Prefer the live preview: an edited task's messagePreview is updated in
             // place, and the passed-in snapshot may be stale if the card send was in
@@ -547,7 +548,7 @@ export class QueueManager {
             getLogger().debug(`[queue-manager] no queue card to update (cancelled), messageId=${messageId}`);
             return;
         }
-        const workspaceName = workspace.split('/').pop() ?? workspace;
+        const workspaceName = displayName(workspace);
         const card = {
             schema: '2.0',
             config: { wide_screen_mode: true },