lark-remote 0.4.5 → 0.5.1

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':

package/dist/cli.js

@@ -2,7 +2,8 @@
 /**
  * CLI 引导层（bootstrap）：在 import 应用模块图之前决定运行时（bun/node）并拉起它。
  *
- *XX * 缺一不可：
+ * **这是全仓唯一被认可的 spawn 收口例外**（即 AGENTS.md「子进程 spawn 只走
+ * platform/spawn.ts」红线的显式豁免）。三个理由缺一不可：
  *   1. 时序：preflight（Node 版本守卫、-v/-h/--advanced-help）必须在 import 应用
  *      模块图之前跑完——dist/cli.js 刻意不使用 ES2020+ 语法以便在 node 12 上仍
  *      可被解析，而 dist/index.js 是 ES2022；先 import platform/spawn 就等于先把

package/dist/clone.d.ts

@@ -25,7 +25,8 @@ import { type QRCodeInfo, type RegisterAppResult } from '@larksuite/channel';
 type CloneState = 'idle' | 'awaiting_scan' | 'finalizing';
 /**
  * 校验用户指定的分身名字：路径分隔符、以 . 开头、尾点/尾空格（win32 会静默
- * 吞掉）、win32 保留设备名一律拒绝。
+ * 吞掉）、win32 非法字符（`<>:"|?*`，NTFS/Win32 API 拒绝）、win32 保留设备名
+ * 一律拒绝。
  */
 export declare function isValidCloneName(name: string): boolean;
 /** 随机后缀：2 位数字 + 2 位小写字母/数字，如 `37ab`。 */
@@ -126,8 +127,9 @@ export declare class CloneSession {
     private readOldOwnerId;
     /**
      * 写配置失败时清理半成品目录。守卫：只删内容全部是本次产物
-     * （config.yaml / startup-contact.json 及其 .tmp）的目录，混入其他
-     * 文件时保留现场不动。
+     * （config.yaml / startup-contact.json 及其 tmp）的目录，混入其他
+     * 文件时保留现场不动。tmp 形态两种都认：atomic-write 现行命名
+     * （.{name}.tmp-{pid}-{ts}-{rand}）与旧版固定 `.tmp`（升级瞬间崩溃的残留）。
      */
     private cleanupPartialDir;
 }

package/dist/clone.js

@@ -24,13 +24,16 @@ const WIN_RESERVED_NAMES = new Set([
 ]);
 /**
  * 校验用户指定的分身名字：路径分隔符、以 . 开头、尾点/尾空格（win32 会静默
- * 吞掉）、win32 保留设备名一律拒绝。
+ * 吞掉）、win32 非法字符（`<>:"|?*`，NTFS/Win32 API 拒绝）、win32 保留设备名
+ * 一律拒绝。
  */
 export function isValidCloneName(name) {
     if (!name || name.includes('/') || name.includes('\\') || name.startsWith('.'))
         return false;
     if (/[\s.]$/.test(name))
         return false;
+    if (/[<>:"|?*]/.test(name))
+        return false;
     if (WIN_RESERVED_NAMES.has(name.toLowerCase()))
         return false;
     return true;
@@ -393,12 +396,13 @@ export class CloneSession {
     }
     /**
      * 写配置失败时清理半成品目录。守卫：只删内容全部是本次产物
-     * （config.yaml / startup-contact.json 及其 .tmp）的目录，混入其他
-     * 文件时保留现场不动。
+     * （config.yaml / startup-contact.json 及其 tmp）的目录，混入其他
+     * 文件时保留现场不动。tmp 形态两种都认：atomic-write 现行命名
+     * （.{name}.tmp-{pid}-{ts}-{rand}）与旧版固定 `.tmp`（升级瞬间崩溃的残留）。
      */
     cleanupPartialDir(targetDir) {
         try {
-            const allowed = /^(config\.yaml|startup-contact\.json)(\.tmp)?$/;
+            const allowed = /^(config\.yaml|startup-contact\.json)(\.tmp)?$|^\.(config\.yaml|startup-contact\.json)\.tmp-\d+-\d+-[a-z0-9]+$/;
             const entries = fs.readdirSync(targetDir);
             if (!entries.every((e) => allowed.test(e))) {
                 getLogger().warn(`[clone] target dir has foreign entries, kept: ${targetDir}`);

package/dist/common/truncate.d.ts

@@ -11,7 +11,7 @@
 export declare const DEFAULT_TRUNCATE_SUFFIX = "\u2026\uFF08\u5DF2\u622A\u65AD\uFF09";
 /**
  * Max byte budget for a single session `tool_result` event's content when
- * replaying an opencode session (L2 pre-fold). Pre-folding here bounds the
+ * replaying an opencode session (pre-fold). Pre-folding here bounds the
  * in-memory `events[]` array and the intermediate card JSON so a single
  * pathological tool_result never inflates the replay payload to megabytes.
  */

package/dist/common/truncate.js

@@ -11,7 +11,7 @@
 export const DEFAULT_TRUNCATE_SUFFIX = '…（已截断）';
 /**
  * Max byte budget for a single session `tool_result` event's content when
- * replaying an opencode session (L2 pre-fold). Pre-folding here bounds the
+ * replaying an opencode session (pre-fold). Pre-folding here bounds the
  * in-memory `events[]` array and the intermediate card JSON so a single
  * pathological tool_result never inflates the replay payload to megabytes.
  */
@@ -76,7 +76,7 @@ export function truncate(str, max, options) {
     if (budget <= 0)
         return suffix;
     // Iterate by Unicode codepoint (for...of) so the cut never lands inside a
-    // surrogate pair (P2-31 anchor: must not emit a lone surrogate).
+    // surrogate pair (must not emit a lone surrogate).
     let end = 0;
     for (const ch of s) {
         if (end + ch.length > budget)

package/dist/common/ttl-cache.d.ts

@@ -4,11 +4,11 @@
  * Consolidates the per-reader memory caches that previously hand-rolled the
  * same "mtime/TTL + entry cap" Map pattern (kimi/pi/opencode session readers).
  * Semantics follow the kimi implementation:
- * - TTL is measured from the cache-write time (P1-17 defect 2), not key mtime.
+ * - TTL is measured from the cache-write time (defect 2), not key mtime.
  *   Note: ttlMs = 0 effectively disables caching — `Date.now() - at >= 0` is
  *   always true, so every entry expires immediately.
  * - A hit refreshes recency (LRU); eviction removes the least recently
- *   inserted/used entry past `maxEntries` (P1-17 defect 1: unbounded growth).
+ *   inserted/used entry past `maxEntries` (defect 1: unbounded growth).
  *   The old pi implementation did NOT re-insert on hit (FIFO eviction); the
  *   eviction order for pi therefore changes from FIFO to LRU here.
  */

package/dist/common/ttl-cache.js

@@ -4,11 +4,11 @@
  * Consolidates the per-reader memory caches that previously hand-rolled the
  * same "mtime/TTL + entry cap" Map pattern (kimi/pi/opencode session readers).
  * Semantics follow the kimi implementation:
- * - TTL is measured from the cache-write time (P1-17 defect 2), not key mtime.
+ * - TTL is measured from the cache-write time (defect 2), not key mtime.
  *   Note: ttlMs = 0 effectively disables caching — `Date.now() - at >= 0` is
  *   always true, so every entry expires immediately.
  * - A hit refreshes recency (LRU); eviction removes the least recently
- *   inserted/used entry past `maxEntries` (P1-17 defect 1: unbounded growth).
+ *   inserted/used entry past `maxEntries` (defect 1: unbounded growth).
  *   The old pi implementation did NOT re-insert on hit (FIFO eviction); the
  *   eviction order for pi therefore changes from FIFO to LRU here.
  */

package/dist/config/codex-config.d.ts

@@ -52,32 +52,32 @@ export interface BundledModelInfo {
  * 依据：codex 运行时对"已配置但文件缺失/不可解析"的目录是硬错误
  * （core/src/config/mod.rs load_model_catalog ?），绝不会回退内置目录；因此键存在即
  * catalog 模式，文件缺失自然落入 `codex debug models` 失败路径 → 模型列表回退
- * [currentModel]（P1-1）。
+ * [currentModel]。
  */
 export declare function isCodexCatalogMode(codexHome?: string): boolean;
 /**
  * 单一解析器：把 `codex debug models`（活动目录）或 `--bundled`（内置目录）的原始 JSON
- * 输出解析为模型列表（P2-4 去重）。过滤/排序镜像 codex：
+ * 输出解析为模型列表（去重）。过滤/排序镜像 codex：
  * - show_in_picker = visibility == List（openai_models.rs ModelPreset::from）；
  * - API 模式（lark 用 API key 认证）下 codex filter_by_auth 过滤 supported_in_api=false；
  * - 按 priority 升序（build_available_models）。
- * 档位按目录声明**原样透传**（含 custom/none，P2-5），不按标准枚举过滤、不虚构兜底：
+ * 档位按目录声明**原样透传**（含 custom/none），不按标准枚举过滤、不虚构兜底：
  * 未声明档位 → 空列表（codex with_model 语义：len=0 时用声明 default，都没有则不发
- * effort；P1）。空串档位/空串 default 被过滤（P3-9：codex ReasoningEffort::from_str
+ * effort；）。空串档位/空串 default 被过滤（codex ReasoningEffort::from_str
  * 对 "" 硬错误）。supported_in_api===true 过滤等价于 codex 的 chatgpt_mode ||
- * supported_in_api：本项目以 API-key 模式运行 codex，chatgpt_mode 恒 false（P3-3）。
+ * supported_in_api：本项目以 API-key 模式运行 codex，chatgpt_mode 恒 false。
  */
 export declare function parseCodexModelsOutput(stdout: string): BundledModelInfo[];
 /**
  * 统一目录入口：catalog 模式（model_catalog_json 已声明，含声明退化 ''）跑
  * `debug models`（无 --bundled），否则（未声明或 config.toml 解析失败）跑
- * `debug models --bundled`。注（P3-4）：codex 无参 `debug models` 在
+ * `debug models --bundled`。注：codex 无参 `debug models` 在
  * uses_codex_backend()/has_command_auth() 时会请求远端 /models（models-manager
  * manager.rs / models_endpoint.rs）；本项目以 API-key 模式运行（无 ChatGPT/命令
  * 认证），结果与 bundled 一致，故非 catalog 用 --bundled（已文档化）。
  * 缓存：键含 binary/home/mode/models.json mtime:size + config.toml mtime:size
- * （P3-4/P3-15/P3-5）；成功结果 TTL 1h，失败/空结果短 TTL 负缓存；stat 异常时
- * 指纹为空（P1-1/P3-10）。
+ * 成功结果 TTL 1h，失败/空结果短 TTL 负缓存；stat 异常时
+ * 指纹为空。
  *
  * 同步路径（卡片构建用）：缓存命中直接返回；若有一个后台异步加载
  * （`loadCodexCatalogModelsAsync` / 启动 warm）在途，则不阻塞事件循环、不重复
@@ -117,7 +117,7 @@ export declare function getReasoningEffortOptions(model: string, codexHome?: str
 /**
  * Get default reasoning effort for a model.
  * 未声明/未知模型 → undefined（codex 语义：ModelPreset.default_reasoning_effort
- * unwrap_or(ReasoningEffort::None)，即不传 effort；P3-12）。
+ * unwrap_or(ReasoningEffort::None)，即不传 effort；）。
  */
 export declare function getDefaultReasoningEffort(model: string, codexHome?: string): string | undefined;
 interface LoadCodexConfigOpts {