lark-remote 0.4.3 → 0.4.5

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

@@ -34,7 +34,7 @@ export declare function newSessionButton(): object;
 /**
  * Create a CardKit 2.0 Compact button for any runCompact-capable runner
  * (codex/kimi/opencode/pi/claude，鸭子类型 `'runCompact' in runner` 探测）。
- * Triggers the compact flow via the codex.compact callback（handler 按
+ * Triggers the compact flow via the compact callback（handler 按
  * runId 解析 agentKind，claude 走 stream-json 内建 /compact）。
  */
 export declare function compactButton(runId: string): object;

package/dist/card/card-shared.js

@@ -84,11 +84,11 @@ export function newSessionButton() {
 /**
  * Create a CardKit 2.0 Compact button for any runCompact-capable runner
  * (codex/kimi/opencode/pi/claude，鸭子类型 `'runCompact' in runner` 探测）。
- * Triggers the compact flow via the codex.compact callback（handler 按
+ * Triggers the compact flow via the compact callback（handler 按
  * runId 解析 agentKind，claude 走 stream-json 内建 /compact）。
  */
 export function compactButton(runId) {
-    return cardButton('🗜 Compact', { cmd: 'codex.compact', runId }, { type: 'primary' });
+    return cardButton('🗜 Compact', { cmd: 'compact', runId }, { type: 'primary' });
 }
 /**
  * Create a CardKit 2.0 Compact button for resume cards (auto-resume / `/resume <id>`).

package/dist/card/run-renderer.js

@@ -3,7 +3,7 @@ import { collapsibleMarkdownPanel, markdownDiv } from './collapsible.js';
 import { toolBodyMd, toolHeaderText } from './tool-render.js';
 import { truncateUtf8, truncateMarkdownTables, CARD_BUDGET_BYTES } from './text-truncate.js';
 import { formatTimestamp } from './time.js';
-import { formatUsageStats } from '../router/utils.js';
+import { formatUsageStats } from '../router/usage-format.js';
 import { renderApprovalArea } from './approval-render.js';
 const REASONING_BYTES = 4_500;
 const TEXT_BYTES = 10_000;
@@ -318,8 +318,8 @@ function assembleRunCard(state, options, elements) {
         schema: '2.0',
         config: { wide_screen_mode: true, update_multi: true },
         header: {
-            template: headerTemplate2(state),
-            title: { content: headerTitle2(state, options), tag: 'plain_text' },
+            template: headerTemplate(state),
+            title: { content: headerTitle(state, options), tag: 'plain_text' },
         },
         body: { elements },
     };
@@ -762,7 +762,7 @@ function buildSummaryContent(state, options = {}) {
         // 压缩（operationKind='compaction'）不会返回 agent 正文——引擎只压缩上下文
         // 窗口，空内容属正常，不能沿用普通 run 的「（未返回内容）」异常信号
         // （2026-09 用户反馈）。所有会压缩的 agent（codex/claude/kimi/opencode/pi）
-        // 都经 streamCodexCompact 走这条共享渲染路径，一处覆盖全部。
+        // 都经 streamCompact 走这条共享渲染路径，一处覆盖全部。
         const empty = hasContent
             ? ''
             : state.operationKind === 'compaction'
@@ -802,9 +802,9 @@ function buildDurationInfo(state) {
     // 与标题一致：审批等待期间状态行显示「等待审批中」，而不是「工具调用中」。
     if (hasPendingApproval(state))
         return '✋ 等待审批中';
-    return footerText2(state.footer);
+    return footerText(state.footer);
 }
-function footerText2(footer) {
+function footerText(footer) {
     if (footer === 'tool_running')
         return '🧰 工具调用中';
     if (footer === 'streaming')
@@ -816,7 +816,7 @@ function statusTagLabel(terminal) {
     return terminalToLabel(terminal);
 }
 /** CardKit 2.0 header title — agent-aware via options.agentKind. */
-function headerTitle2(state, options = {}) {
+function headerTitle(state, options = {}) {
     const agent = agentDisplayName(options.agentKind ?? 'claude');
     if (state.terminal === 'done')
         return `✅ ${agent} · 已完成`;
@@ -845,7 +845,7 @@ function hasPendingApproval(state) {
     return (state.approvals ?? []).some((a) => !a.expired);
 }
 /** CardKit 2.0 header template color */
-function headerTemplate2(state) {
+function headerTemplate(state) {
     return terminalToColor(state.terminal);
 }
 //# sourceMappingURL=run-renderer.js.map

package/dist/card/run-state.js

@@ -388,31 +388,67 @@ function reduceAssistantEvent(state, event) {
             // string as the old per-render parse, so truncation-broken JSON still
             // yields null (over-cap input renders no summary — behavior preserved).
             const inputStr = truncateDetail(stringifyUnknown(content.input));
-            const capped = [
-                ...markThinkingInactive(next.blocks),
-                {
-                    kind: 'tool',
-                    tool: {
-                        id: content.id,
-                        name: content.name,
-                        input: inputStr,
-                        parsedInput: tryParseRecord(inputStr),
-                        ...(content.summary !== undefined ? { summary: content.summary } : {}),
-                        status: 'running',
-                        startedAt: event.timestamp,
-                    },
-                },
-            ];
-            next = {
-                ...next,
-                blocks: keepLatestBlocks(capped),
-                omittedBlocks: (next.omittedBlocks ?? 0) + Math.max(0, capped.length - MAX_BLOCKS),
-                footer: 'tool_running',
+            const incomingTool = {
+                id: content.id,
+                name: content.name,
+                input: inputStr,
+                parsedInput: tryParseRecord(inputStr),
+                ...(content.summary !== undefined ? { summary: content.summary } : {}),
+                status: 'running',
+                startedAt: event.timestamp,
             };
+            const blocks = markThinkingInactive(next.blocks);
+            // A tool_use patch (same id) enriches an existing tool block in place:
+            // opencode emits the initial tool_call while args are still streaming,
+            // then re-reports the command/path in later tool_call_updates. Merging
+            // keeps one panel per tool call; a first-seen id still appends.
+            const existingIndex = blocks.findIndex((block) => block.kind === 'tool' && block.tool.id === content.id);
+            if (existingIndex >= 0) {
+                const existing = blocks[existingIndex];
+                const merged = blocks.slice();
+                merged[existingIndex] = {
+                    kind: 'tool',
+                    tool: mergeToolUse(existing.tool, incomingTool),
+                };
+                next = { ...next, blocks: keepLatestBlocks(merged), footer: 'tool_running' };
+            }
+            else {
+                const capped = [...blocks, { kind: 'tool', tool: incomingTool }];
+                next = {
+                    ...next,
+                    blocks: keepLatestBlocks(capped),
+                    omittedBlocks: (next.omittedBlocks ?? 0) + Math.max(0, capped.length - MAX_BLOCKS),
+                    footer: 'tool_running',
+                };
+            }
         }
     }
     return next;
 }
+/**
+ * Merge a same-id tool_use patch into the existing tool block. Only fields the
+ * patch can legitimately enrich are overwritten:
+ *   - `input`/`parsedInput` — replaced only when the patch carries a non-empty
+ *     object (an empty `{}` patch must not erase a command already rendered);
+ *   - `summary` — replaced only when the patch supplies one;
+ *   - `name` — kept from first sight (a completed opencode update has no kind,
+ *     so its patch cannot know the mapped name).
+ * Everything else (`status`, `output`, `completedAt`, `toolHint`) is preserved,
+ * so an out-of-order patch after the tool_result cannot reset status to running.
+ */
+function mergeToolUse(existing, incoming) {
+    const incomingHasInput = incoming.parsedInput !== undefined &&
+        incoming.parsedInput !== null &&
+        Object.keys(incoming.parsedInput).length > 0;
+    return {
+        ...existing,
+        input: incomingHasInput ? incoming.input : existing.input,
+        parsedInput: incomingHasInput ? incoming.parsedInput : existing.parsedInput,
+        name: existing.name || incoming.name,
+        ...(incoming.summary !== undefined ? { summary: incoming.summary } : {}),
+        startedAt: existing.startedAt ?? incoming.startedAt,
+    };
+}
 /** Handle tool_result content blocks (user message with tool results).
  *  P3-4: rebuild ONLY the block matching `tool_use_id`, copying every other
  *  block by reference. The old `.map()` recreated all block objects per
@@ -589,26 +625,40 @@ function tryParseRecord(input) {
 function keepLatestBlocks(blocks) {
     return blocks.length <= MAX_BLOCKS ? blocks : blocks.slice(-MAX_BLOCKS);
 }
+/** 截断标记前缀（`keepTailMarked` 产出，含已丢弃正文计数）。 */
+const TRUNCATION_MARKER_RE = /^…（前 (\d+) 字符已省略）\n/;
 /**
  * keepTail + 截断标记：被去头的存储内容以前缀如实标注（信息保真红线：禁止静默丢弃）。
  * 标记计入 maxChars 预算（存储总量仍 ≤ maxChars，保持既有长度不变量）。
+ *
+ * 计数口径（2026-10 修正）：只统计**真实丢弃的正文**，不含标记自身开销。
+ * 关键点是增量流下 `value` 往往已带上一次的标记（`marker + kept`）；若直接
+ * 用 `value.length - kept.length` 计费，会把上一帧的标记文本也算进「已省略」，
+ * 造成每帧显示十几字符的虚高。这里先剥离旧标记，把 N 定义为**从该块起始累计
+ * 丢弃的正文数**（单调不减），再按「marker 计入预算」的不动点求最小 N。
  */
 function keepTailMarked(value, maxChars) {
-    if (value.length <= maxChars)
+    const prior = TRUNCATION_MARKER_RE.exec(value);
+    const priorDropped = prior ? Number(prior[1]) : 0;
+    const body = prior ? value.slice(prior[0].length) : value;
+    // 从未截断且当前正文未超预算：原样返回（不误标）。
+    if (priorDropped === 0 && body.length <= maxChars)
         return value;
-    // marker 计入 maxChars 预算（总量不变量）。省略数 = value.length - kept.length，
-    // 而 kept 长度取决于 marker 长度、marker 长度又取决于省略数的位数——
-    // 不动点迭代（marker 固定部分 12 字符，位数至多几次即收敛）。
-    let dropped = value.length - maxChars + 12;
+    // 求最小累计丢弃数 N（≥ priorDropped），使 marker(N) + 保留正文 ≤ maxChars：
+    //   body.length - (N - priorDropped) + (12 + digits(N)) ≤ maxChars
+    //   ⟺ N ≥ priorDropped + body.length - maxChars + 12 + digits(N)
+    // 即 N = K + digits(N) 的不动点（K 为固定项，位数至多几次即收敛）。
+    const K = priorDropped + body.length - maxChars + 12;
+    let totalDropped = Math.max(priorDropped, K);
     for (;;) {
-        const next = value.length - maxChars + 12 + String(dropped).length;
-        if (next === dropped)
+        const next = Math.max(priorDropped, K + String(totalDropped).length);
+        if (next === totalDropped)
             break;
-        dropped = next;
+        totalDropped = next;
     }
-    const marker = `…（前 ${dropped} 字符已省略）\n`;
-    const kept = keepTail(value, Math.max(0, maxChars - marker.length));
-    return marker + kept;
+    const newlyDropped = totalDropped - priorDropped;
+    const kept = body.slice(newlyDropped);
+    return `…（前 ${totalDropped} 字符已省略）\n${kept}`;
 }
 function truncateDetail(value) {
     return value.length <= MAX_TOOL_DETAIL_CHARS

package/dist/card/tool-render.js

@@ -39,9 +39,13 @@ export function toolHeaderText(tool) {
     const blockSummary = tool.summary
         ? truncate(tool.summary.replace(/\s+/g, ' ').trim(), HEADER_SUMMARY_MAX, { suffix: '' })
         : '';
+    // opencode carries the same value in both slots (title = command/path, and
+    // the args-derived summary resolves to it too); dedupe so the header reads
+    // `✅ **Bash** — ls` instead of `✅ **Bash** — ls — ls`.
     const parts = [summary, blockSummary].filter(Boolean);
-    return parts.length > 0
-        ? `${icon} **${tool.name}** — ${parts.join(' — ')}`
+    const uniqueParts = parts.filter((part, i) => parts.indexOf(part) === i);
+    return uniqueParts.length > 0
+        ? `${icon} **${tool.name}** — ${uniqueParts.join(' — ')}`
         : `${icon} **${tool.name}**`;
 }
 /**

package/dist/cli.js

@@ -2,9 +2,8 @@
 /**
  * CLI 引导层（bootstrap）：在 import 应用模块图之前决定运行时（bun/node）并拉起它。
  *
- * **这是全仓唯一被认可的 spawn 收口例外**（即 AGENTS.md「子进程 spawn 只走
- * platform/spawn.ts」红线的显式豁免）。三个理由缺一不可：
- *   1. 时序：preflight（Node 版本守卫、-v/-h/--advance-help）必须在 import 应用
+ *XX * 缺一不可：
+ *   1. 时序：preflight（Node 版本守卫、-v/-h/--advanced-help）必须在 import 应用
  *      模块图之前跑完——dist/cli.js 刻意不使用 ES2020+ 语法以便在 node 12 上仍
  *      可被解析，而 dist/index.js 是 ES2022；先 import platform/spawn 就等于先把
  *      应用模块图拖进来，守卫当场失效（报错堆栈全落在 Node 内部）。
@@ -20,7 +19,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { spawn, spawnSync } from 'node:child_process';
 import { fileURLToPath, pathToFileURL } from 'node:url';
-import { printAdvanceHelp, printHelp, printVersion } from './config/dir.js';
+import { printAdvancedHelp, printHelp, printVersion } from './config/dir.js';
 const entryUrl = new URL('./index.js', import.meta.url);
 const entry = fileURLToPath(entryUrl);
 /**
@@ -49,8 +48,8 @@ export function handlePreflight(args, nodeVersion = process.versions.node) {
             printHelp();
             return 0;
         }
-        if (arg === '--advance-help') {
-            printAdvanceHelp();
+        if (arg === '--advanced-help') {
+            printAdvancedHelp();
             return 0;
         }
     }

package/dist/clone.d.ts

@@ -59,11 +59,6 @@ type RegisterAppFn = (options: {
         status: string;
     }) => void;
 }) => Promise<RegisterAppResult>;
-/**
- * 默认新实例拉起：同入口 + 同参数，仅替换 --config-dir（detached，返回 pid）。
- * spawn 骨架（log fd / windowsHide / error 兜底）单源于 restart.ts。
- */
-export declare function spawnDetachedCloneBridge(targetDir: string): number | undefined;
 export interface CloneSessionOptions {
     connector: CloneConnector;
     /** 当前实例的 config.yaml 路径（配置复制源）。 */
@@ -111,7 +106,7 @@ export declare class CloneSession {
     /**
      * 扫码成功后的自动绑定落地：
      * 1. 复制当前 config.yaml，仅替换 feishu.appId/appSecret；
-     * 2. 同步 workspace / 常用指令 / 会话状态（session 按 openId 重绑）；
+     * 2. 同步 cwd / 常用指令 / 会话状态（session 按 openId 重绑）；
      * 3. 用 registerApp 返回的新应用 openId 写 startup-contact.json（免认领绑定）；
      * 4. detached 拉起指向新目录的新实例（启动后自动向新应用发启动通知）；
      * 5. 在原应用回执「绑定完成 + 配置目录」，退出流程。

package/dist/clone.js

@@ -6,7 +6,7 @@ import path from 'node:path';
 import YAML from 'yaml';
 import { getLogger } from './logger/index.js';
 import { renderQrImage } from './config/qr.js';
-import { silentlyUnlink } from './common/fs.js';
+import { bestEffortUnlink } from './common/fs.js';
 import { atomicWrite, atomicWriteJson } from './persistence/atomic-write.js';
 import { spawnDetachedBridge } from './restart.js';
 /** 退出命令（不区分大小写）。 */
@@ -48,7 +48,7 @@ export function generateCloneSuffix() {
  * 默认新实例拉起：同入口 + 同参数，仅替换 --config-dir（detached，返回 pid）。
  * spawn 骨架（log fd / windowsHide / error 兜底）单源于 restart.ts。
  */
-export function spawnDetachedCloneBridge(targetDir) {
+function spawnDetachedCloneBridge(targetDir) {
     const args = [];
     const argv = process.argv.slice(2);
     for (let i = 0; i < argv.length; i++) {
@@ -238,7 +238,7 @@ export class CloneSession {
             return;
         }
         finally {
-            silentlyUnlink(qrPath);
+            bestEffortUnlink(qrPath);
         }
         await this.connector
             .sendWithRetry(ctx.chatId, {
@@ -264,7 +264,7 @@ export class CloneSession {
     /**
      * 扫码成功后的自动绑定落地：
      * 1. 复制当前 config.yaml，仅替换 feishu.appId/appSecret；
-     * 2. 同步 workspace / 常用指令 / 会话状态（session 按 openId 重绑）；
+     * 2. 同步 cwd / 常用指令 / 会话状态（session 按 openId 重绑）；
      * 3. 用 registerApp 返回的新应用 openId 写 startup-contact.json（免认领绑定）；
      * 4. detached 拉起指向新目录的新实例（启动后自动向新应用发启动通知）；
      * 5. 在原应用回执「绑定完成 + 配置目录」，退出流程。

package/dist/common/clamp.d.ts

@@ -0,0 +1,2 @@
+/** Clamp `v` into [min, max]. */
+export declare function clampInt(v: number, min: number, max: number): number;

package/dist/common/clamp.js

@@ -0,0 +1,5 @@
+/** Clamp `v` into [min, max]. */
+export function clampInt(v, min, max) {
+    return Math.min(Math.max(v, min), max);
+}
+//# sourceMappingURL=clamp.js.map

package/dist/common/fs.d.ts

@@ -1,11 +1,12 @@
 /**
- * Unlink a file, silently ignoring ENOENT and other errors.
+ * Unlink a file, swallowing errors instead of throwing to the caller.
  *
  * Use for cleanup paths (pid files, temp files, stale locks) where the
  * file may already be gone or was never created — a missing file is not
- * an error worth propagating.
+ * an error worth propagating. Not truly silent: gives up on busy files
+ * with a warning log (see below).
  */
-export declare function silentlyUnlink(path: string): void;
+export declare function bestEffortUnlink(path: string): void;
 export declare function isBusyError(err: unknown): boolean;
 export interface BusyRetryOptions {
     /** 平台注入（测试用）；默认当前宿主。占用重试仅 win32 生效 */

package/dist/common/fs.js

@@ -2,20 +2,21 @@ import fs from 'node:fs';
 import { getLogger } from '../logger/index.js';
 import { currentPlatform, isWin32 } from '../platform/select.js';
 /**
- * Unlink a file, silently ignoring ENOENT and other errors.
+ * Unlink a file, swallowing errors instead of throwing to the caller.
  *
  * Use for cleanup paths (pid files, temp files, stale locks) where the
  * file may already be gone or was never created — a missing file is not
- * an error worth propagating.
+ * an error worth propagating. Not truly silent: gives up on busy files
+ * with a warning log (see below).
  */
-export function silentlyUnlink(path) {
+export function bestEffortUnlink(path) {
     try {
         withBusyRetry(() => fs.unlinkSync(path));
     }
     catch (err) {
         // 占用放弃（win32 重试耗尽 / posix 首次占用即失败）：按设计「告警，
         // 不静默吞」，但清理路径不向调用方抛错（保持本函数契约）
-        getLogger().warn(`[fs] silentlyUnlink gave up on busy file ${path}: ${String(err)}`);
+        getLogger().warn(`[fs] bestEffortUnlink gave up on busy file ${path}: ${String(err)}`);
     }
 }
 /**

package/dist/config/dir.d.ts

@@ -5,7 +5,7 @@ interface CliArgs {
     help?: boolean;
     version?: boolean;
     update?: boolean;
-    advanceHelp?: boolean;
+    advancedHelp?: boolean;
 }
 export declare function resolveConfigDir(configDirArg: string | undefined): string;
 export declare function getConfigDir(): string;
@@ -18,11 +18,10 @@ export declare function printVersion(): void;
 /** Print CLI help to stdout. */
 export declare function printHelp(): void;
 /**
- * Print advanced-config reference to stdout (CLI `--advance-help`).
+ * Print advanced-config reference to stdout (CLI `--advanced-help`).
  *
  * 目标读者是 coding agent（用户让 agent 代改 config.yaml）：披露所有
- * /config 卡片未暴露的 YAML 字段——名称、默认值、语义、改法。飞书侧
- * 等价命令为 /advancehelp（内容同源，卡片渲染）。
+ * /config 卡片未暴露的 YAML 字段——名称、默认值、语义、改法。
  */
-export declare function printAdvanceHelp(): void;
+export declare function printAdvancedHelp(): void;
 export {};

package/dist/config/dir.js

@@ -52,8 +52,8 @@ export function parseCliArgs(args = process.argv.slice(2)) {
         else if (arg === '--dev') {
             result.dev = true;
         }
-        else if (arg === '--advance-help') {
-            result.advanceHelp = true;
+        else if (arg === '--advanced-help') {
+            result.advancedHelp = true;
         }
         else if (arg === '--update' || arg === 'update') {
             // 裸子命令等价形式：`lark-remote update` 与 `--update` 同义。
@@ -94,24 +94,23 @@ export function printHelp() {
         '  --settings <path>     指定 Claude 配置文件路径',
         '  --dev                 开发模式：标记从源码 bun src/index.ts 启动（看门狗据此选择拉起方式）',
         '  --update              升级到最新版本后退出（用于 cron/脚本自动化升级）',
-        '  --advance-help        高级配置参考：config.yaml 全部高级字段的语义与改法（面向 coding agent）',
+        '  --advanced-help        高级配置参考：config.yaml 全部高级字段的语义与改法（面向 coding agent）',
         '  -h, --help            显示本帮助信息',
         '  -v, --version         显示版本号',
     ];
     process.stdout.write(lines.join('\n') + '\n');
 }
 /**
- * Print advanced-config reference to stdout (CLI `--advance-help`).
+ * Print advanced-config reference to stdout (CLI `--advanced-help`).
  *
  * 目标读者是 coding agent（用户让 agent 代改 config.yaml）：披露所有
- * /config 卡片未暴露的 YAML 字段——名称、默认值、语义、改法。飞书侧
- * 等价命令为 /advancehelp（内容同源，卡片渲染）。
+ * /config 卡片未暴露的 YAML 字段——名称、默认值、语义、改法。
  */
-export function printAdvanceHelp() {
+export function printAdvancedHelp() {
     const configDir = resolveConfigDir(parseCliArgs().configDir);
     const configPath = configDir + '/config.yaml';
     const lines = [
-        'lark-remote 高级配置参考（--advance-help）',
+        'lark-remote 高级配置参考（--advanced-help）',
         '',
         '目标读者：coding agent。用户把本输出交给 agent，agent 据此代改配置。',
         '',

package/dist/config/wizard.js

@@ -4,7 +4,7 @@ import path from 'node:path';
 import YAML from 'yaml';
 import { AppConfigSchema } from './index.js';
 import { needsQrImage, renderQrImage, renderTerminalQr } from './qr.js';
-import { silentlyUnlink } from '../common/fs.js';
+import { bestEffortUnlink } from '../common/fs.js';
 import { atomicWrite } from '../persistence/atomic-write.js';
 /** Where the fallback QR image is written (next to the config it will seed). */
 const QR_IMAGE_NAME = 'qr-code.gif';
@@ -77,7 +77,7 @@ async function runRegistrationWizard(configPath) {
     }
     finally {
         if (wroteImage)
-            silentlyUnlink(imagePath);
+            bestEffortUnlink(imagePath);
     }
 }
 function isInteractiveTerminal() {

package/dist/connector/index.d.ts

@@ -107,8 +107,6 @@ type CardActionHandler = (action: CardActionEvent) => void | CardActionResponse
  * 卡片 patch 的重试上限。含义：1 次原始尝试 + 最多 PATCH_MAX_RETRIES 次重试。
  */
 export declare const PATCH_MAX_RETRIES = 3;
-/** 重试退避基数（ms）；第 n 次重试前等待 n × 基数，给对端恢复的时间。 */
-export declare const PATCH_RETRY_BASE_DELAY_MS = 150;
 export declare class FeishuConnector {
     /** 飞书 channel 实例（public：测试直接访问/注入 mock，替代 as unknown as）。 */
     channel: LarkChannel;

package/dist/connector/index.js

@@ -7,7 +7,7 @@ import { sleep } from '../common/sleep.js';
 import { isTransientTransportError } from '../error-classification.js';
 import axios from 'axios';
 import fs from 'node:fs';
-import { silentlyUnlink } from '../common/fs.js';
+import { bestEffortUnlink } from '../common/fs.js';
 import { displayName } from '../platform/path.js';
 import https from 'node:https';
 import os from 'node:os';
@@ -145,7 +145,7 @@ function shouldRetrySendError(err) {
  */
 export const PATCH_MAX_RETRIES = 3;
 /** 重试退避基数（ms）；第 n 次重试前等待 n × 基数，给对端恢复的时间。 */
-export const PATCH_RETRY_BASE_DELAY_MS = 150;
+const PATCH_RETRY_BASE_DELAY_MS = 150;
 /** 记日志用的错误摘要（不打印 axios 巨型循环对象）。 */
 function formatErrorForLog(err) {
     if (err instanceof Error) {
@@ -403,9 +403,9 @@ export class FeishuConnector {
         for (const res of msg.resources) {
             const tmpPath = path.join(os.tmpdir(), `lark-remote-inbound-${randomUUID()}`);
             try {
-                const { contentType, bytesWritten } = await withTimeout(this.channel.downloadResourceToFile(msg.messageId, res.fileKey, res.type, tmpPath), timeoutMs, `downloadResource fileKey=${res.fileKey}`, () => silentlyUnlink(tmpPath));
+                const { contentType, bytesWritten } = await withTimeout(this.channel.downloadResourceToFile(msg.messageId, res.fileKey, res.type, tmpPath), timeoutMs, `downloadResource fileKey=${res.fileKey}`, () => bestEffortUnlink(tmpPath));
                 if (bytesWritten > maxBytes) {
-                    silentlyUnlink(tmpPath);
+                    bestEffortUnlink(tmpPath);
                     const limitMb = maxBytes / (1024 * 1024);
                     failures.push({
                         kind: res.kind,
@@ -429,7 +429,7 @@ export class FeishuConnector {
             catch (err) {
                 // 超时不在这里删文件：上面已把清理挂到底层传输的 settle 上。
                 if (!(err instanceof ResourceTimeoutError))
-                    silentlyUnlink(tmpPath);
+                    bestEffortUnlink(tmpPath);
                 getLogger().warn(`[feishu] downloadResource failed fileKey=${res.fileKey} type=${res.type}:`, err.message);
                 failures.push({
                     kind: res.kind,

package/dist/inbound/receipt.d.ts

@@ -1,5 +1,5 @@
 /**
- * 入站回执文案（设计依据见 `docs/zh/architecture/inbound-unified-input-design.md`）。
+ * 入站回执文案（`inbound-unified-input-design.md` §5.7）。
  *
  * 两类回执合并成一条：
  * 1. 无文本纯附件（决策 2）：不自动起 turn，只回已保存路径 + 引导语；
@@ -10,8 +10,6 @@
  */
 import type { PlaceholderKind } from './placeholder.js';
 import type { RejectedItem } from './turn.js';
-/** 单条回执最多列出的文件数；超出折叠为 "… 等 N 个文件"（沿用旧提示口径）。 */
-export declare const MAX_PATHS_IN_RECEIPT = 10;
 /** 「不支持」回执句式（§5.7 表：不支持类型统一「暂不支持 X」）。 */
 export declare function unsupportedReason(kind: PlaceholderKind): string;
 export interface ReceiptInput {

package/dist/inbound/receipt.js

@@ -1,5 +1,5 @@
 /**
- * 入站回执文案（设计依据见 `docs/zh/architecture/inbound-unified-input-design.md`）。
+ * 入站回执文案（`inbound-unified-input-design.md` §5.7）。
  *
  * 两类回执合并成一条：
  * 1. 无文本纯附件（决策 2）：不自动起 turn，只回已保存路径 + 引导语；
@@ -10,7 +10,7 @@
  */
 import path from 'node:path';
 /** 单条回执最多列出的文件数；超出折叠为 "… 等 N 个文件"（沿用旧提示口径）。 */
-export const MAX_PATHS_IN_RECEIPT = 10;
+const MAX_PATHS_IN_RECEIPT = 10;
 /** 占位符种类 → 面向人的名称。 */
 const PLACEHOLDER_LABELS = {
     image: '图片',

package/dist/inbound/turn-assembler.d.ts

@@ -1,7 +1,7 @@
 /**
  * InboundTurnAssembler：统一静默期窗口 + 合并 + 下载等待 + commit。
  *
- * 设计依据：`docs/zh/architecture/inbound-unified-input-design.md` §4/§5.2。
+ * 设计依据：`docs/zh/architecture/inbound-unified-input-design.md` §4、§5.2。
  *
  * 规则：
  * - 任何事件到达 → **重置** 700ms 定时器（按 `userId:chatId` 分桶），保证图/文任意顺序等价；
@@ -13,8 +13,6 @@
  */
 import type { InboundEvent } from './event.js';
 import { type CommitReason, type InboundTurn } from './turn.js';
-/** 统一静默期窗口（ms）——决策 1：不做「纯文本零延迟」快路径。 */
-export declare const DEFAULT_TURN_WINDOW_MS = 700;
 export interface AssemblerContext {
     userId: string;
     chatId: string;

package/dist/inbound/turn-assembler.js

@@ -1,7 +1,7 @@
 /**
  * InboundTurnAssembler：统一静默期窗口 + 合并 + 下载等待 + commit。
  *
- * 设计依据：`docs/zh/architecture/inbound-unified-input-design.md` §4/§5.2。
+ * 设计依据：`docs/zh/architecture/inbound-unified-input-design.md` §4、§5.2。
  *
  * 规则：
  * - 任何事件到达 → **重置** 700ms 定时器（按 `userId:chatId` 分桶），保证图/文任意顺序等价；
@@ -17,7 +17,7 @@ import { buildPrompt } from './prompt.js';
 import { buildReceipt, unsupportedReason } from './receipt.js';
 import { bucketKey, } from './turn.js';
 /** 统一静默期窗口（ms）——决策 1：不做「纯文本零延迟」快路径。 */
-export const DEFAULT_TURN_WINDOW_MS = 700;
+const DEFAULT_TURN_WINDOW_MS = 700;
 export class InboundTurnAssembler {
     deps;
     buckets = new Map();