lark-remote 0.4.5 → 0.5.0

package/dist/bridge/queue-manager.js

@@ -1,7 +1,7 @@
 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).
+ * Per-workspace cap on the number of tasks WAITING to execute.
  * Without a bound, a message flood grows `queuedTasks` / the promise chain /
  * each task's captured `msg.content` closure without limit, and every enqueued
  * task fires a queue card (amplifying outbound API calls). When the waiting
@@ -21,7 +21,7 @@ export class QueueManager {
     /** Per-workspace queued tasks for queue display cards. Key = cwd, value = task list. */
     queuedTasks = new Map();
     /**
-     * P3-5: per-workspace `messageId → QueuedTask` index mirroring `queuedTasks`.
+     * per-workspace `messageId → QueuedTask` index mirroring `queuedTasks`.
      * O(1) lookup for the task-start removal path (replacing the old double
      * `find`+`findIndex` O(N) scan) and for `getQueuedTask`/`removeFromQueue`/
      * `updateQueuedTaskMessage`. The ordered array remains the source of truth
@@ -48,7 +48,7 @@ export class QueueManager {
      * identifies one task's execution period for the interrupt bookkeeping in
      * `executingSlot`/`interruptedSlots` — replacing the unowned skip-credit
      * counter, which any settle could consume and which therefore leaked a
-     * re-armed count after repeated resets (see A4 anchor).
+     * re-armed count after repeated resets.
      */
     slotCounter = 0;
     /**
@@ -72,7 +72,7 @@ export class QueueManager {
     /**
      * MessageIds of tasks that have actually begun executing (cancellation check
      * passed, task removed from the queue). Entries are sticky: they remain
-     * after the task settles (A21). `handleQueueImmediate` step 6 uses this to
+     * after the task settles. `handleQueueImmediate` step 6 uses this to
      * distinguish "target was cancelled (never began)" from "target began while
      * the interrupt was in flight" so the final feedback can report the true
      * state instead of telling a running task's user that nothing was
@@ -95,7 +95,7 @@ export class QueueManager {
         this.sendCard = sendCard;
         this.updateCard = updateCard;
     }
-    /** P3-5: register a queued task in the per-workspace `messageId → task` index. */
+    /** register a queued task in the per-workspace `messageId → task` index. */
     indexAdd(cwd, task) {
         let idx = this.taskIndex.get(cwd);
         if (!idx) {
@@ -104,11 +104,11 @@ export class QueueManager {
         }
         idx.set(task.messageId, task);
     }
-    /** P3-5: drop a task from the per-workspace index by messageId. */
+    /** drop a task from the per-workspace index by messageId. */
     indexRemove(cwd, messageId) {
         this.taskIndex.get(cwd)?.delete(messageId);
     }
-    /** P3-5: O(1) lookup of a queued task by messageId via the index. */
+    /** O(1) lookup of a queued task by messageId via the index. */
     indexGet(cwd, messageId) {
         return this.taskIndex.get(cwd)?.get(messageId);
     }
@@ -147,7 +147,7 @@ export class QueueManager {
             const currentExecutingCount = this.pendingOrExecutingCount.get(cwd) ?? 0;
             const currentQueueLength = this.queuedTasks.get(cwd)?.length ?? 0;
             const hasWaitingTasks = currentExecutingCount > 0 || currentQueueLength > 0;
-            // P2-5: bound the waiting backlog. When the queue is full, reject the
+            // bound the waiting backlog. When the queue is full, reject the
             // task with a visible card instead of appending it (which would grow
             // the promise chain + closures unboundedly under a message flood and
             // fire another queue card). Do NOT increment pendingOrExecutingCount —
@@ -217,7 +217,7 @@ export class QueueManager {
             let livePreview = taskMeta?.messagePreview ?? '';
             // Check if this task was cancelled before executing
             if (messageId) {
-                // P3-5: O(1) index lookup replaces the old `find` + `findIndex`
+                // O(1) index lookup replaces the old `find` + `findIndex`
                 // double O(N) scan. The ordered array still drives removal (splice
                 // preserves queue order for position display); the index stays in
                 // sync via indexRemove.
@@ -290,7 +290,7 @@ export class QueueManager {
             .then(() => {
             getLogger().debug(`[queue-manager] task end cwd=${cwd}`);
             // beganMessageIds entry intentionally retained: sticky by design
-            // (A21) — the marker records "has ever begun", not "is currently
+            // the marker records "has ever begun", not "is currently
             // running", so a task that began and settled quickly still reports
             // "已开始执行" to queue.immediate.
             this.decrementExecutingCount(cwd, slotId);
@@ -298,7 +298,7 @@ export class QueueManager {
             .catch((err) => {
             getLogger().error('[queue-manager] queue task error:', err);
             // Same sticky rationale as the success settle: the marker survives
-            // even when the task errors after beginning (A21).
+            // even when the task errors after beginning.
             this.decrementExecutingCount(cwd, slotId);
         });
         this.queues.set(cwd, newQueue);
@@ -435,7 +435,7 @@ export class QueueManager {
      * state — pending cards enable both, executing/cancelled cards disable
      * both. Centralizing the pair here eliminates the 3-way duplication
      * between `buildQueueStatusCardElements`, `updateQueueCardToExecuting`,
-     * and `updateQueueCardToCancelled` (Clean Code P2-1).
+     * and `updateQueueCardToCancelled` (Clean Code).
      */
     buildQueueActionButtons(cwd, messageId, disabled) {
         return [
@@ -476,8 +476,8 @@ export class QueueManager {
         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
-            // flight while the user edited (A19). The begin path (started=true) already
-            // passes the live preview captured at begin (A12), so the fallback is only
+            // flight while the user edited. The begin path (started=true) already
+            // passes the live preview captured at begin, so the fallback is only
             // exercised when the task is no longer queued.
             const liveTask = this.indexGet(cwd, messageId);
             const stillQueued = liveTask !== undefined;
@@ -527,7 +527,7 @@ export class QueueManager {
         const taskList = this.queuedTasks.get(cwd);
         if (!taskList)
             return false;
-        // P3-5: index is the O(1) presence check; array splice keeps order.
+        // index is the O(1) presence check; array splice keeps order.
         if (!this.indexGet(cwd, messageId))
             return false;
         const index = taskList.findIndex((t) => t.messageId === messageId);
@@ -582,7 +582,7 @@ export class QueueManager {
     }
     /** Get task metadata from queue. */
     getQueuedTask(cwd, messageId) {
-        // P3-5: O(1) index lookup instead of array `find`.
+        // O(1) index lookup instead of array `find`.
         return this.indexGet(cwd, messageId);
     }
     /**
@@ -600,7 +600,7 @@ export class QueueManager {
     }
     /** Update the messagePreview for a queued task. Returns true if found and updated. */
     updateQueuedTaskMessage(cwd, messageId, newMessage) {
-        // P3-5: O(1) index lookup instead of array `find`.
+        // O(1) index lookup instead of array `find`.
         const task = this.indexGet(cwd, messageId);
         if (!task)
             return false;
@@ -697,7 +697,7 @@ export class QueueManager {
      * slot no longer matches the interrupted task's slot, the interrupted task
      * already decremented normally — resetting now would zero the count of the
      * running successor and mark ITS slot interrupted, hiding it from the
-     * queue card (A22).
+     * queue card.
      */
     resetExecutingCount(cwd, expectedSlot) {
         const currentSlot = this.executingSlot.get(cwd);
@@ -705,7 +705,7 @@ export class QueueManager {
             getLogger().debug(`[queue-manager] resetExecutingCount skip (stopped task settled, slot advanced) cwd=${cwd} expectedSlot=${expectedSlot} currentSlot=${currentSlot ?? 'none'}`);
             return;
         }
-        // P3#9: only reset and grant an interrupt slot when there is actually a
+        // only reset and grant an interrupt slot when there is actually a
         // pending/executing task.
         const currentCount = this.pendingOrExecutingCount.get(cwd) ?? 0;
         if (currentCount === 0) {

package/dist/card/approval-render.d.ts

@@ -1,7 +1,7 @@
 /**
  * renderApprovalArea: renders the approval request area in a run card.
  *
- * Renders command/file/permissions approval areas with button mappings per §8.3.
+ * Renders command/file/permissions approval areas with button mappings.
  * Uses CardKit 2.0 (no tag:"action" container — 200861 rule).
  */
 import type { ApprovalView } from '../runner/types.js';

package/dist/card/approval-render.js

@@ -1,7 +1,7 @@
 /**
  * renderApprovalArea: renders the approval request area in a run card.
  *
- * Renders command/file/permissions approval areas with button mappings per §8.3.
+ * Renders command/file/permissions approval areas with button mappings.
  * Uses CardKit 2.0 (no tag:"action" container — 200861 rule).
  */
 import { collapsibleMarkdownPanel } from './collapsible.js';
@@ -13,7 +13,7 @@ function mkNonce() {
 }
 /** 计划面板正文字节预算（折叠展示 + 截断保护 28KB 卡片预算）。 */
 const PLAN_PANEL_BYTES = 6000;
-/** reason div（3 处共用）；反引号中和防 lark_md 解析错误（review P2-2）。 */
+/** reason div（3 处共用）；反引号中和防 lark_md 解析错误。 */
 function reasonDiv(approval) {
     if (!approval.reason)
         return null;
@@ -39,7 +39,7 @@ export function renderApprovalArea(approval, opts) {
     if (!approval)
         return [];
     // 终态（done/error/interrupted/idle_timeout）下 run 已结束：coordinator 已
-    // 释放，按钮点击无处响应，隐藏整个审批区避免"点了没反应"（P2-7）。
+    // 释放，按钮点击无处响应，隐藏整个审批区避免"点了没反应"。
     if (opts?.terminal && opts.terminal !== 'running' && opts.terminal !== 'finalizing') {
         return [];
     }
@@ -238,7 +238,7 @@ function renderPlanFeedbackInput(requestId, runId) {
 function renderCommandApproval(approval, expired, runId) {
     const elements = [];
     // Command display
-    // review P2-2：命令里的反引号会提前终止 lark_md 行内代码 span，奇数次
+    // 命令里的反引号会提前终止 lark_md 行内代码 span，奇数次
     // 反引号极易触发 11311 解析错误导致整卡失败（同 renderFileDiff 的中和策略）。
     const neutralizedCommand = (approval.command ?? '').replace(/`/g, '·');
     const cmdContent = neutralizedCommand
@@ -422,7 +422,7 @@ function renderQuestionApproval(approval, expired, runId) {
             elements.push(renderOptionRow(approval.requestId, i, option, isSelected, icon, runId));
         }
         // 自定义答案（Other）的选中态展示：选项按钮无法表示自由文本，单独显示
-        // 已选文本，避免「点了没反应」的困惑（review P3）。
+        // 已选文本，避免「点了没反应」的困惑。
         const customSelected = q.selected?.find((s) => !q.options.some((o) => o.label === s));
         if (customSelected) {
             elements.push({
@@ -430,7 +430,7 @@ function renderQuestionApproval(approval, expired, runId) {
                 text: { tag: 'lark_md', content: `✍️ 自定义答案：${customSelected}` },
             });
         }
-        // review P3-4：单选问题提供自定义答案（Other）输入——输入文本后提交
+        // 单选问题提供自定义答案（Other）输入——输入文本后提交
         // （移动端键盘回车/完成键，桌面端输入框右侧提交图标），input_value 经
         // connector raw 事件回传。
         // 显隐按 isOther !== false：Kimi form 会丢弃非声明选项值，翻译时置

package/dist/card/bash-card-session.d.ts

@@ -1,7 +1,7 @@
 import { CardSession, type CardChannel } from './card-session.js';
 import { type BashState, type BashRenderOptions } from './bash-renderer.js';
 /**
- * Store-time 输出上限（字符，P1-3 层①）。§P1-3 建议「store-time 截断，
+ * Store-time 输出上限（字符，层①）。建议「store-time 截断，
  * 保留尾部，上限如 24~64KB」——取区间下界 24_000 字符（字符上限 ×4 字节最坏
  * ~96KB/字段）。渲染层本就只展示尾部（bash-renderer 截断到 12KB 字节），store 截断
  * 不影响显示内容，只保证内存有界：!yes / !cat 大文件不再把全部输出驻留在 session
@@ -9,7 +9,7 @@ import { type BashState, type BashRenderOptions } from './bash-renderer.js';
  */
 export declare const BASH_OUTPUT_STORE_CAP = 24000;
 /**
- * Store-time 截断入口（P1-3 层①/层④共用）。bridge 本地 output/stderr 与 session
+ * Store-time 截断入口（层①/层④共用）。bridge 本地 output/stderr 与 session
  * state 都走它，保证任意路径驻留的字符串 ≤ BASH_OUTPUT_STORE_CAP 字符。
  * 调用方传入的 value 通常已 ≤ CAP（增量场景 output 恒 ≤ CAP，+chunk 后 ≤ CAP+chunk），
  * slice(-CAP) 成本 O(CAP+chunk)，不会把 O(n²) 截断问题带回桥接循环。
@@ -49,7 +49,7 @@ export declare class BashCardSession extends CardSession<BashState, BashRenderOp
         output?: string;
     }): Promise<void>;
     /**
-     * 合并 patch 并对 output/stderr 做 store-time 截断（P1-3 层①）。
+     * 合并 patch 并对 output/stderr 做 store-time 截断（层①）。
      * 截断发生在入口（store 时），渲染层无需再为大 state 付代价。
      */
     private applyCap;

package/dist/card/bash-card-session.js

@@ -2,7 +2,7 @@ import { CardSession } from './card-session.js';
 import { renderBashCard } from './bash-renderer.js';
 import { keepTail } from '../common/truncate.js';
 /**
- * Store-time 输出上限（字符，P1-3 层①）。§P1-3 建议「store-time 截断，
+ * Store-time 输出上限（字符，层①）。建议「store-time 截断，
  * 保留尾部，上限如 24~64KB」——取区间下界 24_000 字符（字符上限 ×4 字节最坏
  * ~96KB/字段）。渲染层本就只展示尾部（bash-renderer 截断到 12KB 字节），store 截断
  * 不影响显示内容，只保证内存有界：!yes / !cat 大文件不再把全部输出驻留在 session
@@ -10,7 +10,7 @@ import { keepTail } from '../common/truncate.js';
  */
 export const BASH_OUTPUT_STORE_CAP = 24_000;
 /**
- * Store-time 截断入口（P1-3 层①/层④共用）。bridge 本地 output/stderr 与 session
+ * Store-time 截断入口（层①/层④共用）。bridge 本地 output/stderr 与 session
  * state 都走它，保证任意路径驻留的字符串 ≤ BASH_OUTPUT_STORE_CAP 字符。
  * 调用方传入的 value 通常已 ≤ CAP（增量场景 output 恒 ≤ CAP，+chunk 后 ≤ CAP+chunk），
  * slice(-CAP) 成本 O(CAP+chunk)，不会把 O(n²) 截断问题带回桥接循环。
@@ -92,7 +92,7 @@ export class BashCardSession extends CardSession {
         this.release();
     }
     /**
-     * 合并 patch 并对 output/stderr 做 store-time 截断（P1-3 层①）。
+     * 合并 patch 并对 output/stderr 做 store-time 截断（层①）。
      * 截断发生在入口（store 时），渲染层无需再为大 state 付代价。
      */
     applyCap(patch) {

package/dist/card/bash-renderer.js

@@ -78,7 +78,7 @@ function assembleCard(state, elements) {
     };
 }
 /**
- * Build output/stderr elements shared by normal & degraded paths (W2.3 单源）：
+ * Build output/stderr elements shared by normal & degraded paths (单源）：
  * 除截断预算（OUTPUT_MAX_BYTES / DEGRADED_OUTPUT_BYTES）外逐行同构。
  */
 function buildOutputElements(state, maxBytes) {

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

@@ -59,7 +59,7 @@ export declare abstract class CardSession<S, RO = unknown> {
      * 调度一次延迟 flush。已有 pending 调度则复用（合批核心）；否则起一个
      * coalesceMs 定时器。flushInFlight 期间不再起 timer（避免重入叠加），但置
      * pendingReschedule 以便 in-flight flush 完成后重新调度——否则 in-flight 期间
-     * 到达的 push/update 会停留为 stale 中间帧（P2-1）。
+     * 到达的 push/update 会停留为 stale 中间帧。
      */
     protected scheduleFlush(): void;
     /**
@@ -87,14 +87,14 @@ export declare abstract class CardSession<S, RO = unknown> {
     /** The messageId of the streaming card, available after `start()` resolves. */
     get cardMessageId(): string | undefined;
     /**
-     * P1-3 合批窗口（ms）。连续事件各触发一次全卡 render + patch 是流式 CPU 主要
+     * 合批窗口（ms）。连续事件各触发一次全卡 render + patch 是流式 CPU 主要
      * 来源；窗口内多个事件复用同一次延迟 flush。窗口大小可通过 constructor 覆盖
      * （测试用小窗口/0 禁用）。run/bash 子类共用的 flush 骨架（scheduleFlush/flush/
      * cancelPendingFlush/settle）下沉到基类。
      */
     protected readonly coalesceMs: number;
     private flushTimer;
-    private flushInFlight; /** P2-1：in-flight flush 期间到达的 push/update 标记。scheduleFlush 在
+    private flushInFlight; /** in-flight flush 期间到达的 push/update 标记。scheduleFlush 在
      *  flushInFlight 时早退不调度新 timer，但事件已 reduce 进 state；若无此标志，
      *  in-flight flush 完成后该事件无 follow-up render，停留为 stale 中间帧。
      *  finally 检查此标志后重新 scheduleFlush，保证 in-flight 期间累积的事件最终被渲染。 */
@@ -102,7 +102,7 @@ export declare abstract class CardSession<S, RO = unknown> {
     /** 当前 in-flight flush 的 promise（若 flush 正在 await updateCard）。
      *  finish() 在终态 patch 前 await 它，保证 in-flight 的 pre-terminal patch 先落地、
      *  terminal patch 后落地——否则两条 controller.update 并发无 FIFO，
-     *  pre-terminal 可能在 terminal 之后 resolve 留下"思考中"终帧（P2）。 */
+     *  pre-terminal 可能在 terminal 之后 resolve 留下"思考中"终帧。 */
     protected flushP: Promise<void> | undefined;
     start(): Promise<void>;
     settle(): Promise<StreamSettleResult>;

package/dist/card/card-session.js

@@ -46,7 +46,7 @@ export class CardSession {
      * 调度一次延迟 flush。已有 pending 调度则复用（合批核心）；否则起一个
      * coalesceMs 定时器。flushInFlight 期间不再起 timer（避免重入叠加），但置
      * pendingReschedule 以便 in-flight flush 完成后重新调度——否则 in-flight 期间
-     * 到达的 push/update 会停留为 stale 中间帧（P2-1）。
+     * 到达的 push/update 会停留为 stale 中间帧。
      */
     scheduleFlush() {
         if (this.flushTimer)
@@ -82,7 +82,7 @@ export class CardSession {
                 this.flushInFlight = false;
                 // flushInFlight 守卫保证同一时刻只有一个 in-flight flush，故可无条件清空。
                 this.flushP = undefined;
-                // P2-1：in-flight 期间若有 push/update 到达（pendingReschedule），重新调度一次
+                // in-flight 期间若有 push/update 到达（pendingReschedule），重新调度一次
                 // flush 渲染累积事件，避免 stale 中间帧。终态守卫在 flush() 入口已拦截，
                 // 故 finish 后不会误触发。
                 if (this.pendingReschedule) {
@@ -117,14 +117,14 @@ export class CardSession {
         return this.messageId;
     }
     /**
-     * P1-3 合批窗口（ms）。连续事件各触发一次全卡 render + patch 是流式 CPU 主要
+     * 合批窗口（ms）。连续事件各触发一次全卡 render + patch 是流式 CPU 主要
      * 来源；窗口内多个事件复用同一次延迟 flush。窗口大小可通过 constructor 覆盖
      * （测试用小窗口/0 禁用）。run/bash 子类共用的 flush 骨架（scheduleFlush/flush/
      * cancelPendingFlush/settle）下沉到基类。
      */
     coalesceMs;
     flushTimer;
-    flushInFlight = false; /** P2-1：in-flight flush 期间到达的 push/update 标记。scheduleFlush 在
+    flushInFlight = false; /** in-flight flush 期间到达的 push/update 标记。scheduleFlush 在
      *  flushInFlight 时早退不调度新 timer，但事件已 reduce 进 state；若无此标志，
      *  in-flight flush 完成后该事件无 follow-up render，停留为 stale 中间帧。
      *  finally 检查此标志后重新 scheduleFlush，保证 in-flight 期间累积的事件最终被渲染。 */
@@ -132,7 +132,7 @@ export class CardSession {
     /** 当前 in-flight flush 的 promise（若 flush 正在 await updateCard）。
      *  finish() 在终态 patch 前 await 它，保证 in-flight 的 pre-terminal patch 先落地、
      *  terminal patch 后落地——否则两条 controller.update 并发无 FIFO，
-     *  pre-terminal 可能在 terminal 之后 resolve 留下"思考中"终帧（P2）。 */
+     *  pre-terminal 可能在 terminal 之后 resolve 留下"思考中"终帧。 */
     flushP;
     async start() {
         if (this.streamOutcome) {
@@ -158,7 +158,7 @@ export class CardSession {
         // the controller is ready — by which time events pushed before the
         // producer ran (see test_anchor_events_before_controller_ready_...) have
         // already updated `this.state`. Reusing the initial card here would drop
-        // those early events. The P3-7 "reuse first render" optimization was
+        // those early events. The"reuse first render" optimization was
         // rejected for this reason (premise "two renders with identical input"
         // does not hold).
         const stream = this.connector.streamCard(this.chatId, this.safeRenderCard(), async (controller) => {

package/dist/card/run-card-session.js

@@ -36,7 +36,7 @@ export class RunCardSession extends CardSession {
     async push(event) {
         // state 每事件立即 reduce（始终最新），但 updateCard 延迟到合批窗口末尾。
         // 窗口内多次 push 复用同一 flushTimer，只 render + controller.update 一次
-        // （P1-3）。push 立即 resolve（fire-and-forget render）—— bridge 串行
+        // push 立即 resolve（fire-and-forget render）—— bridge 串行
         // await 不被 render 阻塞，循环快速灌入事件，多个事件落进同一窗口被合并。
         //
         // 首 push 也走窗口（无 immediate-first-flush）：start() 已发初始卡（streaming
@@ -55,7 +55,7 @@ export class RunCardSession extends CardSession {
         this.cancelPendingFlush();
         // 若有 in-flight flush 正在 await updateCard，必须等它完成后再发终态 patch。
         // 否则两条并发 controller.update 无 FIFO 保证，in-flight 的 pre-terminal
-        // patch 可能在终态 patch 之后 resolve → 用户看到"思考中"终帧（P2）。
+        // patch 可能在终态 patch 之后 resolve → 用户看到"思考中"终帧。
         // await 保证顺序：pre-terminal 先落地 → terminal 后落地 → terminal 胜出。
         if (this.flushP)
             await this.flushP;

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

@@ -37,7 +37,7 @@ type BlockGroup = {
     diff?: string;
     timestamp?: string;
 };
-/** 每个块的截断后内容（thinking/plan/text），测量与渲染共用（P1-2 建议项）。 */
+/** 每个块的截断后内容（thinking/plan/text），测量与渲染共用（建议项）。 */
 type GroupContentPrepared = Map<BlockGroup, string>;
 /** 导出供测试断言估算精度（估算 ≈ 实际渲染字节，见 tests/anchor/run-card/run-card.test.ts）。 */
 export declare function estimateCardBytes(state: RunState, options?: RunCardRenderOptions, shared?: {

package/dist/card/run-renderer.js

@@ -16,7 +16,7 @@ const EXTREME_TOOL_KEEP = 1; // Extreme: keep last 1 tool panel
 // 影子测量：估算 = 精确复刻 normal 路径将要渲染的 JSON 字节。面板外壳、statusRow、
 // summary、header、按钮全部实测（measureJson），块内容经与渲染相同的变换
 // （truncateUtf8 截断 + markdownDiv 的 escapeMarkdown + JSON.stringify）精确测量，
-// 不依赖任何转义因子或拍脑袋常数（P1-2 第二轮：CJK/ASCII 转义双向精确）。
+// 不依赖任何转义因子或拍脑袋常数（第二轮：CJK/ASCII 转义双向精确）。
 const DEGRADED_THRESHOLD = 24_000; // 估算低于此值走正常路径（留 4KB 裕度，相对 CARD_BUDGET_BYTES=28000）；否则直接 degraded。调整时同步评估裕度是否仍覆盖估算偏差
 /** 精确测量对象经 JSON.stringify 后的 UTF-8 字节数。 */
 function measureJson(obj) {
@@ -275,7 +275,7 @@ function actionButtonList(state, options) {
     actionButtons.push(newSessionButton());
     return actionButtons;
 }
-/** Bottom action row: spacer + column_set of actionButtonList (估算与渲染共用，W2.2）。 */
+/** Bottom action row: spacer + column_set of actionButtonList (估算与渲染共用）。 */
 function actionRow(state, options) {
     const actionButtons = actionButtonList(state, options);
     if (actionButtons.length === 0)
@@ -293,7 +293,7 @@ function actionRow(state, options) {
     ];
 }
 /** 审批区位于 body 最底部（底部操作行之后）：待审批时决策按钮不遮挡内容流。
- *  例外：skeleton 兜底路径中 approvalArea 在 actionRow 之前（信息保真 C4.3），
+ *  例外：skeleton 兜底路径中 approvalArea 在 actionRow 之前（信息保真），
  *  保证极端降级时审批入口与 stop/new-session 按钮同时可见。 */
 function approvalArea(state) {
     const elements = [];
@@ -306,7 +306,7 @@ function approvalArea(state) {
     }
     return elements;
 }
-/** 底部操作行之前的内容区提示：被 MAX_BLOCKS 截掉的早期块计数（信息保真 C4.1）。 */
+/** 底部操作行之前的内容区提示：被 MAX_BLOCKS 截掉的早期块计数（信息保真）。 */
 function omittedBlocksHint(state) {
     return state.omittedBlocks !== undefined && state.omittedBlocks > 0
         ? [markdownDiv(`_💡 已省略 ${state.omittedBlocks} 个早期步骤_`)]
@@ -346,7 +346,7 @@ function buildFallbackElements(state, options, tier) {
     if (toolsOmitted > 0) {
         elements.push(markdownDiv(`_💡 另外 ${toolsOmitted} 个工具调用已省略_`));
     }
-    // P2-6: use object references (like the extreme path) instead of timestamps.
+    // use object references (like the extreme path) instead of timestamps.
     // RunBlock.timestamp has millisecond precision; ≥2 thinking blocks sharing a
     // timestamp collapse to one Set entry, so `has(block.timestamp)` lets ALL
     // same-timestamp blocks (including ones meant to be omitted) pass through —
@@ -364,7 +364,7 @@ function buildFallbackElements(state, options, tier) {
         }
         return true; // keep all non-thinking, non-tool blocks
     });
-    // 信息保真 C4.2：plan/file_change 块在降级路径不渲染内容（正常路径已可见，
+    // 信息保真 plan/file_change 块在降级路径不渲染内容（正常路径已可见，
     // 降级预算紧张），但必须计数留痕，禁止静默丢弃。
     // 计数在渲染前完成，提示与 thinking/tool 省略提示一并置于卡片顶部——不能等
     // 内容循环结束再追加，否则提示会落在最后一条输出之后，打乱「输出收尾」观感。
@@ -467,7 +467,7 @@ function buildSkeletonElements(state, options) {
     elements.push(markdownDiv('_⚠️ 输出过大且含大量转义字符，已省略全部内容以避免超限；完整内容请查日志_'));
     // Summary (token stats etc.) — static, bounded size
     elements.push(...buildSummaryContent(state));
-    // 信息保真 C4.3：skeleton 也渲染审批区——极端兜底不丢审批入口
+    // 信息保真 skeleton 也渲染审批区——极端兜底不丢审批入口
     //（待审批被静默吞掉 = 用户永远看不到审批请求）。
     elements.push(...approvalArea(state));
     // Bottom action row: stop (if running/finalizing) + compact (if applicable) + new session (always).
@@ -514,7 +514,7 @@ function bucketThinkingAndTool(blocks) {
  * 到 degraded（安全网不丢）。
  */
 /**
- * W2.2 镜像对单源：thinking/plan/file_change 三个 collapsible 面板组的
+ * 镜像对单源：thinking/plan/file_change 三个 collapsible 面板组的
  * { title, expanded, border, content } 描述，估算（measurePanelBytes）与渲染
  * （collapsibleMarkdownPanel）共用——此前同一套标题/opIcon/内容模板写两遍。
  * text（renderTextBlock）与 tool（renderTool）形态特殊，由调用方各自处理；
@@ -552,19 +552,19 @@ function describePanelGroup(group, prepared) {
 /** 导出供测试断言估算精度（估算 ≈ 实际渲染字节，见 tests/anchor/run-card/run-card.test.ts）。 */
 export function estimateCardBytes(state, options = {}, shared) {
     const finalized = state.terminal !== 'running';
-    // P1-2：renderRunCard 传入共享 groups/prepared 时直接复用（截断只做一次）；
+    // renderRunCard 传入共享 groups/prepared 时直接复用（截断只做一次）；
     // 独立调用（测试/预算探针）时自建，行为与原先一致。
     const groups = shared?.groups ?? groupBlocks(state.blocks);
     const prepared = shared?.prepared ?? prepareGroupContent(groups);
     // 卡片外壳直接实测 assembleRunCard 空元素产物（schema/config/header/body 结构
-    // 与正式渲染完全一致，W2.2）；status/summary/操作行同样实测渲染结构。
+    // 与正式渲染完全一致）；status/summary/操作行同样实测渲染结构。
     // 注：审批区（approvalArea）不参与估算——待审批通常在途且体积小，超预算由
     // renderRunCard 的 stringify 兜底捕获。
     let total = measureJson(assembleRunCard(state, options, [])) +
         measureJson(statusRow(state)) +
         measureJson(buildSummaryContent(state, { includeNotices: false })) +
         measureJson(actionRow(state, options));
-    // 块内容：与 buildChronologicalContent 同源（describePanelGroup 单源，W2.2）
+    // 块内容：与 buildChronologicalContent 同源（describePanelGroup 单源）
     let renderedAny = false;
     for (const group of groups) {
         if (group.kind === 'tool') {
@@ -620,7 +620,7 @@ function measurePanelBytes(title, expanded, border, content) {
  */
 export function renderRunCard(state, options = {}) {
     // 先估后建：用廉价估算预测是否超 28KB 预算，明显超预算直接跳过完整卡构建走
-    // degraded。P1-2：groups/prepared 只算一次，测量与正式渲染共用同一份截断结果，
+    // degraded。groups/prepared 只算一次，测量与正式渲染共用同一份截断结果，
     // 避免影子测量 + 正式渲染对每个超限块双倍截断。
     const groups = groupBlocks(state.blocks);
     const prepared = prepareGroupContent(groups);
@@ -680,9 +680,9 @@ function buildChronologicalContent(state, prepared, groups) {
     const elements = [];
     // finalized = 非 running（含 finalizing：主结果已出，thinking 折叠）
     const finalized = state.terminal !== 'running';
-    // P1-2：renderRunCard 传入同一 groups 数组时直接复用（prepared 的键是组对象
+    // renderRunCard 传入同一 groups 数组时直接复用（prepared 的键是组对象
     // 引用，重建数组会让 prepared.get 永远 miss，退化为二次截断）。
-    // W2.2：面板组描述经 describePanelGroup 与估算共享同一份模板。
+    // 面板组描述经 describePanelGroup 与估算共享同一份模板。
     // notices 作为普通消息按到达时间插入内容流（有内容时不再沉到 summary）。
     const contentItems = mergeNoticesIntoContent(groups, state.notices);
     for (const item of contentItems) {

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

@@ -9,7 +9,7 @@ export interface ToolEntry {
     name: string;
     input: unknown;
     /**
-     * P3-6: cached parse of `input` (the truncated string) into a record, so
+     * cached parse of `input` (the truncated string) into a record, so
      * `tool-render.ts`'s `asRecord` does not re-`JSON.parse` on every render.
      * Computed once at store time in `reduceAssistantEvent` from the SAME
      * truncated string that the old per-render `asRecord` parsed — so a
@@ -121,7 +121,7 @@ export interface RunState {
     /** 压缩前上下文水位（codex compact 卡展示「压缩前 X → 压缩后 Y」）。 */
     compactPreContextLength?: number;
     /**
-     * 待审批请求列表（app-server 模式，review P2-3）。同一 turn 内并发多个审批
+     * 待审批请求列表（app-server 模式）。同一 turn 内并发多个审批
      * 时全部渲染，避免后到者顶掉先到者的按钮（单槽会丢 UI，只能等超时 cancel）。
      */
     approvals?: Array<{

package/dist/card/run-state.js

@@ -382,7 +382,7 @@ function reduceAssistantEvent(state, event) {
             };
         }
         else {
-            // P3-6: parse the truncated stored string ONCE here (not on every render)
+            // parse the truncated stored string ONCE here (not on every render)
             // and cache the result on `parsedInput`. tool-render's asRecord then hits
             // the object branch with zero parsing. The parse uses the SAME truncated
             // string as the old per-render parse, so truncation-broken JSON still
@@ -450,7 +450,7 @@ function mergeToolUse(existing, incoming) {
     };
 }
 /** Handle tool_result content blocks (user message with tool results).
- *  P3-4: rebuild ONLY the block matching `tool_use_id`, copying every other
+ *  rebuild ONLY the block matching `tool_use_id`, copying every other
  *  block by reference. The old `.map()` recreated all block objects per
  *  tool_result (O(N) allocations on the run-card hot path). Footer still
  *  advances to 'streaming' on every content block (parity with old behavior);
@@ -605,7 +605,7 @@ function stringifyUnknown(value) {
     }
 }
 /**
- * P3-6: parse a (possibly truncated) string into a record, mirroring what
+ * parse a (possibly truncated) string into a record, mirroring what
  * `tool-render.ts`'s `asRecord` did on every render. Returns `null` when the
  * string is empty, non-JSON, or parses to a non-object — so a truncation-broken
  * JSON yields `null` exactly as the old per-render parse did. Computed once at

package/dist/card/tool-render.d.ts

@@ -20,7 +20,7 @@ export declare function toolHeaderText(tool: ToolEntry): string;
 /**
  * Structured body markdown for a tool call. Renders input fields by tool name
  * (Bash → command, Read/Edit/Write → file_path, etc.) and output in a code
- * block. An explicit `toolHint` (declared by the runner, 信息保真 C5) selects
+ * block. An explicit `toolHint` (declared by the runner, 信息保真) selects
  * the same rendering by family instead of name. There is no raw-JSON fallback
  * for unknown tools: `default` returns '' and unknown tools only surface their
  * args through the panel header's `summarizeInput` fallback.

package/dist/card/tool-render.js

@@ -29,13 +29,13 @@ const BODY_TOTAL_MAX = 2500;
  */
 export function toolHeaderText(tool) {
     const icon = tool.status === 'ok' ? '✅' : tool.status === 'error' ? '❌' : '⏳';
-    // P3-6: use the cached parsed record when available (avoids per-render parse).
+    // use the cached parsed record when available (avoids per-render parse).
     const input = tool.parsedInput !== undefined ? tool.parsedInput : tool.input;
     const summary = summarizeInput(tool.name, input);
-    // 信息保真 C3.1：ACP kind 映射后 name 与原始 title 不同时，title 以
+    // 信息保真 ACP kind 映射后 name 与原始 title 不同时，title 以
     // ` — {summary}` 追加在标题末尾（截断沿用 HEADER_SUMMARY_MAX）。
     // 用 truncate（suffix 为空）而非裸 slice：裸 slice 按 UTF-16 码元切，
-    // 切点落在 emoji 代理对中间会留下孤立代理项（P2-31 同族）。
+    // 切点落在 emoji 代理对中间会留下孤立代理项（同族）。
     const blockSummary = tool.summary
         ? truncate(tool.summary.replace(/\s+/g, ' ').trim(), HEADER_SUMMARY_MAX, { suffix: '' })
         : '';
@@ -51,7 +51,7 @@ export function toolHeaderText(tool) {
 /**
  * Structured body markdown for a tool call. Renders input fields by tool name
  * (Bash → command, Read/Edit/Write → file_path, etc.) and output in a code
- * block. An explicit `toolHint` (declared by the runner, 信息保真 C5) selects
+ * block. An explicit `toolHint` (declared by the runner, 信息保真) selects
  * the same rendering by family instead of name. There is no raw-JSON fallback
  * for unknown tools: `default` returns '' and unknown tools only surface their
  * args through the panel header's `summarizeInput` fallback.
@@ -156,13 +156,13 @@ function renderWebSearchInput(str) {
     return str('query') ? `**Query** \`${truncate(str('query'), BODY_FIELD_MAX)}\`` : '';
 }
 function renderInput(tool) {
-    // P3-6: use the cached parsed record when available (avoids per-render parse).
+    // use the cached parsed record when available (avoids per-render parse).
     const input = tool.parsedInput !== undefined ? tool.parsedInput : tool.input;
     const rec = asRecord(input);
     if (!rec)
         return '';
     const str = (k) => (typeof rec[k] === 'string' ? rec[k] : '');
-    // 信息保真 C5：hint 优先（runner 自愿声明，只消费不推断）；缺失时与现状
+    // 信息保真 hint 优先（runner 自愿声明，只消费不推断）；缺失时与现状
     // 完全一致。hint 分支与 name case 共用同一渲染函数，无复制粘贴。
     switch (tool.toolHint) {
         case 'shell':