lark-remote 0.1.12 → 0.1.13

package/CHANGELOG.md

@@ -5,6 +5,18 @@ 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.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/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

@@ -463,6 +463,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

@@ -834,6 +834,26 @@ export class Bridge {
         let finalCumulativeOutputTokens;
         let finalCumulativeCacheReadTokens;
         let finalCumulativeCacheCreationTokens;
+        // 统一的 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,
+        });
         try {
             try {
                 getLogger().debug(`[bridge] cardSession.start() begin runId=${runId}`);
@@ -1156,57 +1176,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 +1207,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());
                 }
             }
         }
@@ -1562,6 +1522,10 @@ 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) ||
@@ -1578,6 +1542,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
@@ -1623,11 +1617,23 @@ 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 未读到则短重试，仍失败优雅降级（无统计）。
@@ -1636,9 +1642,9 @@ export class Bridge {
                 await sleep(150);
                 finalUsage = this.resolveFinalUsage(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 +1660,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,6 +1715,9 @@ 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) ||

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

@@ -8,10 +8,7 @@ import { type AgentKind } from '../runner/index.js';
  */
 export declare function agentDisplayName(kind: string): string;
 export { truncate } from '../common/truncate.js';
-interface TerminalLabelOptions {
-    prefix?: string;
-}
-export declare function terminalToLabel(terminal: string, options?: TerminalLabelOptions): string;
+export declare function terminalToLabel(terminal: string): string;
 export declare function terminalToColor(terminal: string): string;
 /**
  * Create a CardKit 2.0 stop button with behaviors callback.

package/dist/card/card-shared.js

@@ -34,10 +34,8 @@ const TERMINAL_LABELS = {
     running: '运行中',
     finalizing: '完成中',
 };
-export function terminalToLabel(terminal, options) {
-    const label = TERMINAL_LABELS[terminal] ?? '运行中';
-    const prefix = options?.prefix ?? '';
-    return prefix + label;
+export function terminalToLabel(terminal) {
+    return TERMINAL_LABELS[terminal] ?? '运行中';
 }
 export function terminalToColor(terminal) {
     if (terminal === 'done')

package/dist/common/truncate.d.ts

@@ -16,12 +16,6 @@ export declare const DEFAULT_TRUNCATE_SUFFIX = "\u2026\uFF08\u5DF2\u622A\u65AD\u
  * pathological tool_result never inflates the replay payload to megabytes.
  */
 export declare const TOOL_RESULT_MAX_BYTES = 4000;
-/**
- * Fit a UTF-8 string into `maxBytes` by iterating Unicode codepoints, never
- * splitting a multi-byte sequence. When `fromEnd` is true, keeps the TAIL
- * (useful for logs/tails); otherwise keeps the HEAD.
- */
-export declare function fitUtf8(value: string, maxBytes: number, fromEnd?: boolean): string;
 /**
  * Truncate a UTF-8 string to fit within `maxBytes`, appending `suffix`
  * (default `…（已截断）`) when truncation occurs. When `fromEnd` is true, keeps

package/dist/common/truncate.js

@@ -21,7 +21,7 @@ export const TOOL_RESULT_MAX_BYTES = 4000;
  * splitting a multi-byte sequence. When `fromEnd` is true, keeps the TAIL
  * (useful for logs/tails); otherwise keeps the HEAD.
  */
-export function fitUtf8(value, maxBytes, fromEnd = false) {
+function fitUtf8(value, maxBytes, fromEnd = false) {
     if (fromEnd) {
         const codepoints = Array.from(value);
         let bytes = 0;

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

@@ -0,0 +1,24 @@
+/**
+ * Generic TTL + bounded LRU cache.
+ *
+ * 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.
+ *   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).
+ *   The old pi implementation did NOT re-insert on hit (FIFO eviction); the
+ *   eviction order for pi therefore changes from FIFO to LRU here.
+ */
+export declare class TtlCache<K, V> {
+    private readonly ttlMs;
+    private readonly maxEntries?;
+    private map;
+    constructor(ttlMs: number, maxEntries?: number | undefined);
+    /** Return the fresh value for `key` (refreshing LRU order), or undefined. */
+    get(key: K): V | undefined;
+    set(key: K, value: V): void;
+    clear(): void;
+}

package/dist/common/ttl-cache.js

@@ -0,0 +1,53 @@
+/**
+ * Generic TTL + bounded LRU cache.
+ *
+ * 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.
+ *   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).
+ *   The old pi implementation did NOT re-insert on hit (FIFO eviction); the
+ *   eviction order for pi therefore changes from FIFO to LRU here.
+ */
+export class TtlCache {
+    ttlMs;
+    maxEntries;
+    map = new Map();
+    constructor(ttlMs, maxEntries) {
+        this.ttlMs = ttlMs;
+        this.maxEntries = maxEntries;
+    }
+    /** Return the fresh value for `key` (refreshing LRU order), or undefined. */
+    get(key) {
+        const entry = this.map.get(key);
+        if (!entry)
+            return undefined;
+        if (Date.now() - entry.at >= this.ttlMs) {
+            this.map.delete(key);
+            return undefined;
+        }
+        // LRU refresh: re-insert to move to the tail of iteration order.
+        this.map.delete(key);
+        this.map.set(key, entry);
+        return entry.value;
+    }
+    set(key, value) {
+        this.map.delete(key);
+        this.map.set(key, { at: Date.now(), value });
+        if (this.maxEntries !== undefined) {
+            while (this.map.size > this.maxEntries) {
+                const oldest = this.map.keys().next().value;
+                if (oldest === undefined)
+                    break;
+                this.map.delete(oldest);
+            }
+        }
+    }
+    clear() {
+        this.map.clear();
+    }
+}
+//# sourceMappingURL=ttl-cache.js.map

package/dist/config/codex-config.js

@@ -31,16 +31,13 @@ export function resolveCodexHome(codexHome) {
  * 配置 [model_providers.anthropic] 才存在，fallback 阶段不得虚构。
  */
 const FALLBACK_PROVIDERS = ['openai'];
-const FALLBACK_MODELS = [
-    'o3',
-    'o4-mini',
-    'gpt-4o',
-    'gpt-4.1',
-    'gpt-4.1-mini',
-    'gpt-4.1-nano',
-    'claude-sonnet-4-20250514',
-    'claude-opus-4-20250115',
-];
+const FALLBACK_MODELS = ['o3', 'o4-mini', 'gpt-4o', 'gpt-4.1', 'gpt-4.1-mini', 'gpt-4.1-nano'];
+/**
+ * anthropic 的独立兜底模型表：anthropic 非内置 provider，仅在用户显式配置后使用。
+ * 不得混入 FALLBACK_MODELS——无 config.toml 时 openai 的模型列表会原样暴露这些
+ * claude 条目（claude 模型列在 openai provider 下是错的）。
+ */
+const ANTHROPIC_FALLBACK_MODELS = ['claude-sonnet-4-20250514', 'claude-opus-4-20250115'];
 /** Bundled models from codex binary, 1h TTL is enough (only change on binary upgrade) */
 const BUNDLED_CACHE_TTL_MS = 60 * 60 * 1000;
 /** 失败/空结果负缓存 TTL：避免每次卡片构建同步阻塞最长 8s（P3-5） */
@@ -351,7 +348,11 @@ export function loadCodexConfig(opts = {}) {
     // 否则 = bundled（与原行为一致）
     const catalogSlugs = getCodexCatalogModels(codexHome).map((m) => m.slug);
     const allModels = catalogSlugs.length > 0 ? catalogSlugs : FALLBACK_MODELS;
-    const anthropicModels = allModels.filter((m) => m.startsWith('claude-'));
+    // anthropic 模型列表仅在用户显式配置 anthropic 时使用：catalog 可用取 catalog 中的
+    // claude-*，否则用 ANTHROPIC_FALLBACK_MODELS（与 openai 兜底表隔离）
+    const anthropicModels = catalogSlugs.length > 0
+        ? catalogSlugs.filter((m) => m.startsWith('claude-'))
+        : ANTHROPIC_FALLBACK_MODELS;
     if (!fs.existsSync(configFile)) {
         // 无 config.toml：默认模型取目录首个可用模型（codex default_model_from_available），
         // 目录不可用时回退 'o3'（FALLBACK_MODELS 首项，非 catalog 默认）

package/dist/config/index.d.ts

@@ -237,9 +237,6 @@ export declare const AppConfigSchema: z.ZodObject<{
             model: z.ZodOptional<z.ZodString>;
             thinkingEffort: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
-        dsh: z.ZodOptional<z.ZodObject<{
-            host: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
     }, z.core.$strip>>;
     idle: z.ZodDefault<z.ZodObject<{
         watchdogMinutes: z.ZodDefault<z.ZodNumber>;

package/dist/config/index.js

@@ -246,11 +246,6 @@ const AgentChoicesSchema = z.object({
         thinkingEffort: z.string().optional(),
     })
         .optional(),
-    dsh: z
-        .object({
-        host: z.string().optional(),
-    })
-        .optional(),
 });
 export const AppConfigSchema = z.object({
     feishu: FeishuConfigSchema,

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

@@ -22,7 +22,7 @@ interface KimiConfigResult {
     /** Model -> default effort mapping */
     modelDefaultEfforts: Record<string, string>;
 }
-/** 清空缓存（测试与配置热更新用，与 codex/opencode 的 invalidate 对齐） */
+/** 清空缓存（仅供测试使用，生产代码无调用点） */
 export declare function invalidateKimiConfigCache(): void;
 /**
  * Load Kimi models from `kimi provider list --json`.

package/dist/config/kimi-config.js

@@ -10,7 +10,7 @@ import { getLogger } from '../logger/index.js';
 export const KIMI_THINKING_EFFORTS = ['low', 'high', 'max'];
 /** Fallback efforts when all values are filtered out */
 export const FALLBACK_EFFORTS = ['low', 'high', 'max'];
-/** 清空缓存（测试与配置热更新用，与 codex/opencode 的 invalidate 对齐） */
+/** 清空缓存（仅供测试使用，生产代码无调用点） */
 export function invalidateKimiConfigCache() {
     kimiConfigCache = null;
 }

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

@@ -9,7 +9,7 @@ interface OpencodeConfigResult {
     /** 根据 provider 获取可用模型列表（返回纯 model ID，不带 provider 前缀） */
     modelOptions: (provider?: string) => string[];
 }
-/** 清空缓存（测试与配置热更新用，与 codex-config 的 invalidateCodexBundledCache 对齐） */
+/** 清空缓存（仅供测试使用，生产代码无调用点） */
 export declare function invalidateOpencodeConfigCache(): void;
 /**
  * 加载 opencode 配置，执行 opencode models --verbose 并解析

package/dist/config/opencode-config.js

@@ -10,18 +10,13 @@ import { getLogger } from '../logger/index.js';
  * 当 opencode 命令失败时使用
  * 格式：provider/model（内部用，modelOptions 返回时会去掉 provider 前缀）
  */
-const FALLBACK_PROVIDERS = [
-    'opencode',
-    'deepseek',
-    'minimax-cn-coding-plan',
-    'myprovider',
-    'volcengine-plan',
-];
 const FALLBACK_MODELS = {
     opencode: ['big-pickle'],
     deepseek: ['deepseek-chat'],
     'minimax-cn-coding-plan': ['MiniMax-M2.5'],
 };
+/** fallback provider 列表从模型表派生，保证不会出现空模型列表的 provider（历史曾混入无模型的 myprovider/volcengine-plan） */
+const FALLBACK_PROVIDERS = Object.keys(FALLBACK_MODELS);
 /** 正缓存 TTL：opencode models 列表短时间不变，1 分钟（与 kimi-config 对齐） */
 const OPENCODE_CONFIG_CACHE_TTL_MS = 60_000;
 /**
@@ -31,7 +26,7 @@ const OPENCODE_CONFIG_CACHE_TTL_MS = 60_000;
 const OPENCODE_NEGATIVE_CACHE_TTL_MS = 30_000;
 let opencodeConfigCache = null;
 let opencodeConfigFailedAt = null;
-/** 清空缓存（测试与配置热更新用，与 codex-config 的 invalidateCodexBundledCache 对齐） */
+/** 清空缓存（仅供测试使用，生产代码无调用点） */
 export function invalidateOpencodeConfigCache() {
     opencodeConfigCache = null;
     opencodeConfigFailedAt = null;

package/dist/router/index.d.ts

@@ -203,6 +203,8 @@ export declare class CommandRouter {
      * Routes to the appropriate bridge method based on value.cmd.
      * Returns a toast response for immediate user feedback.
      */
+    /** queue.* 卡片动作通用守卫：workspace/messageId 缺失时回复错误并返回 null。 */
+    private queuePayloadOrReply;
     /** 答案类操作的统一失败反馈：重复投递（同一 nonce 第二次点击）是已生效的
      *  中性事件，报 error 会误导（首次点击实际已成功）。 */
     private answerFailureToast;
@@ -300,6 +302,11 @@ export declare class CommandRouter {
      * Handle order.aliasEdit: 展示别名编辑卡（input + ✓ 提交图标）。
      * 有别名时预填；提交 `order.aliasInput` 处理（含校验与唯一性）。
      */
+    /**
+     * order 编辑卡公共骨架：payload 校验 → 查指令 → 构造 input 编辑卡 → 原地更新。
+     * handleOrderAliasEdit / handleOrderTextEdit 原先各持一份 ~90% 相同的 4 段结构。
+     */
+    private showOrderEditCard;
     private handleOrderAliasEdit;
     /**
      * Handle order.aliasInput: 提交别名（绑/改/解绑），随后重渲染 /order 列表卡。