lark-remote 0.1.7 → 0.1.8

package/dist/router/config/dsh.js

@@ -0,0 +1,179 @@
+/**
+ * DshConfigBuilder — /config card fields for the DSH agent.
+ *
+ * DSH (DeepSeek Harness) is an HTTP-only agent. Beyond the Web Host base URL it
+ * exposes three runtime-configurable knobs — preset, model, reasoning effort.
+ *
+ * 清单来源分两期：
+ * - 动态清单（当前实现）：打开 /config 前通过 `llm.models` / `agentPreset.list`
+ *   预取（Router 调 `prefetch()`），失败/离线回退下方固定兜底清单，卡不依赖
+ *   DSH 服务在线。
+ * - 三个可选字段用空字符串哨兵表示「跟随服务端默认」：select 的 value `''`
+ *   在 handleFieldChange 中被转成 undefined patch（router 删除键），config.yaml
+ *   不写该键 = 服务端默认。
+ */
+import { DEFAULT_DSH_HOST } from '../../config/index.js';
+import { DshClient } from '../../runner/dsh/client.js';
+import { getLogger } from '../../logger/index.js';
+/** 固定兜底 preset 清单（DSH rc.7 实测；动态拉取失败时使用）。 */
+const FALLBACK_PRESET_OPTIONS = [
+    { text: 'standard（标准模式）', value: 'standard' },
+    { text: 'minimal（极简模式）', value: 'minimal' },
+    { text: 'code（PTC 模式）', value: 'code' },
+    { text: 'cordis（创造模式）', value: 'cordis' },
+];
+/** 固定兜底模型清单（DSH rc.7 实测；动态拉取失败时使用）。 */
+const FALLBACK_MODEL_OPTIONS = ['deepseek-v4-flash', 'deepseek-v4-pro'];
+/** 固定兜底推理档位（llm.models 实际档位；动态拉取失败时使用）。 */
+const FALLBACK_EFFORT_OPTIONS = ['off', 'low', 'high', 'max'];
+/** 「跟随服务端默认」哨兵值：select value 用空串，保存时转 undefined 删除键。 */
+const DEFAULT_SENTINEL = '';
+export class DshConfigBuilder {
+    /** 最近一次预取用的 host；host 变更时缓存失效（下一张卡重新拉取）。 */
+    prefetchHost;
+    modelCatalog;
+    presets;
+    /** 可注入 client 工厂（测试用）；默认生产实现。 */
+    clientFactory;
+    constructor(clientFactory) {
+        this.clientFactory = clientFactory ?? ((base) => new DshClient(base));
+    }
+    /** 异步预取模型/预设目录（§4.2 二期动态清单）。失败/离线静默回退固定兜底清单，
+     *  卡不依赖 DSH 服务在线；同一 host 只拉一次，避免每次刷卡重复请求。 */
+    async prefetch(host) {
+        const base = (host ?? DEFAULT_DSH_HOST).replace(/\/$/, '');
+        if (!base || base === this.prefetchHost)
+            return;
+        const client = this.clientFactory(base);
+        try {
+            this.modelCatalog = await client.listModels();
+        }
+        catch (err) {
+            getLogger().warn(`[dsh-config] llm.models prefetch failed (falling back to fixed catalog): ${err.message}`);
+            this.modelCatalog = undefined;
+        }
+        try {
+            this.presets = await client.listPresets();
+        }
+        catch (err) {
+            getLogger().warn(`[dsh-config] agentPreset.list prefetch failed (falling back to fixed presets): ${err.message}`);
+            this.presets = undefined;
+        }
+        this.prefetchHost = base;
+    }
+    /** 同步注入 catalog/presets（测试用，替代异步 prefetch；标记 prefetchHost 使
+     *  后续 prefetch 短路，避免测试误触发网络请求）。 */
+    setCatalog(catalog, presets) {
+        this.modelCatalog = catalog;
+        if (presets)
+            this.presets = presets;
+        this.prefetchHost = 'injected';
+    }
+    /** 展平 llm.models 各 provider group 的模型 id；无 catalog 时回退固定清单。 */
+    modelOptions() {
+        if (this.modelCatalog) {
+            const ids = this.modelCatalog.groups.flatMap((g) => g.models.map((m) => m.id));
+            if (ids.length > 0)
+                return ids;
+        }
+        return FALLBACK_MODEL_OPTIONS;
+    }
+    /** preset 清单；无 presets 时回退固定清单。显示名优先用 preset.yml 的 name。 */
+    presetOptions() {
+        if (this.presets && this.presets.presets.length > 0) {
+            return this.presets.presets
+                .filter((p) => !p.broken)
+                .map((p) => ({ text: p.name ? `${p.id}（${p.name}）` : p.id, value: p.id }));
+        }
+        return FALLBACK_PRESET_OPTIONS;
+    }
+    /** 模型在 catalog 中声明的推理档位；无 catalog/模型不在目录时回退固定档位。 */
+    effortOptionsForModel(model) {
+        if (model && this.modelCatalog) {
+            for (const group of this.modelCatalog.groups) {
+                const entry = group.models.find((m) => m.id === model);
+                if (entry?.reasoning && entry.reasoning.efforts.length > 0) {
+                    return entry.reasoning.efforts.map((e) => e.id);
+                }
+            }
+        }
+        return FALLBACK_EFFORT_OPTIONS;
+    }
+    buildFields(displayConfig) {
+        const dsh = displayConfig.agents?.dsh;
+        const currentHost = dsh?.host ?? DEFAULT_DSH_HOST;
+        const currentPreset = dsh?.agentPreset ?? DEFAULT_SENTINEL;
+        const currentModel = dsh?.model ?? DEFAULT_SENTINEL;
+        const currentEffort = dsh?.reasoningEffort ?? DEFAULT_SENTINEL;
+        const modelOptions = this.modelOptions();
+        const isCustomModel = currentModel !== DEFAULT_SENTINEL && !modelOptions.includes(currentModel);
+        const effortOptions = this.effortOptionsForModel(currentModel === DEFAULT_SENTINEL ? undefined : currentModel);
+        return [
+            {
+                key: 'agents.dsh.host',
+                label: 'DSH Web Host',
+                type: 'input',
+                currentValue: currentHost,
+            },
+            {
+                key: 'agents.dsh.agentPreset',
+                label: '预设模式',
+                type: 'select',
+                options: [{ text: '跟随服务端默认', value: DEFAULT_SENTINEL }, ...this.presetOptions()],
+                currentValue: currentPreset,
+            },
+            {
+                key: 'agents.dsh.model',
+                label: '使用模型',
+                type: 'select',
+                options: [{ text: '跟随服务端默认', value: DEFAULT_SENTINEL }, ...modelOptions],
+                currentValue: isCustomModel ? undefined : currentModel,
+            },
+            // 自定义模型名输入框（与 codex/claude 一致的行为）
+            {
+                key: 'agents.dsh.model',
+                label: '自定义模型名',
+                type: 'input',
+                currentValue: isCustomModel ? currentModel : '',
+            },
+            {
+                key: 'agents.dsh.reasoningEffort',
+                label: '推理强度',
+                type: 'select',
+                options: [{ text: '跟随服务端默认', value: DEFAULT_SENTINEL }, ...effortOptions],
+                currentValue: currentEffort,
+            },
+        ];
+    }
+    handleFieldChange(key, value, config) {
+        const patches = [];
+        // 空串哨兵「跟随服务端默认」→ undefined patch（router 删除键）
+        const effective = value === DEFAULT_SENTINEL ? undefined : value;
+        patches.push({ key, value: effective });
+        // 模型变更时，若当前档位不被新模型支持，重置（参照 kimi/codex 语义）
+        if (key === 'agents.dsh.model' && typeof value === 'string') {
+            const effortPatch = this.effortPatchForModel(config, effective);
+            if (effortPatch)
+                patches.push(effortPatch);
+        }
+        return patches;
+    }
+    /** 切到 newModel 后的档位补丁：当前档位仍被新模型支持 → 不产出；否则用新模型
+     *  目录中位；无目录/空列表 → undefined（清空 = 跟随服务端默认）。 */
+    effortPatchForModel(config, newModel) {
+        const currentEffort = config.agents?.dsh?.reasoningEffort;
+        if (!newModel) {
+            // 模型被清空（跟随默认）→ 档位一并清空跟随默认
+            return currentEffort ? { key: 'agents.dsh.reasoningEffort', value: undefined } : null;
+        }
+        const supported = this.effortOptionsForModel(newModel);
+        if (currentEffort && supported.includes(currentEffort))
+            return null;
+        // 新模型目录中位档位；偶数长度取偏高位（off/low → low，符合 DSH 默认 high 语义）
+        const middle = supported[Math.floor(supported.length / 2)];
+        return middle
+            ? { key: 'agents.dsh.reasoningEffort', value: middle }
+            : { key: 'agents.dsh.reasoningEffort', value: undefined };
+    }
+}
+//# sourceMappingURL=dsh.js.map

package/dist/router/config/index.d.ts

@@ -7,7 +7,7 @@
 import type { AgentKind } from '../../runner/types.js';
 import type { AgentConfigCardBuilder } from './types.js';
 /**
- * 首次启动默认展示的 Coding Agent 顺序：Codex → Claude → OpenCode → Pi → Kimi。
+ * 首次启动默认展示的 Coding Agent 顺序：Codex → Claude → OpenCode → Pi → Kimi → DSH。
  * 未安装（availability === false）的 agent 在展示时排到后面
  * （见 sortAgentsForDisplay），同组内保持本顺序。
  */

package/dist/router/config/index.js

@@ -9,8 +9,9 @@ import { CodexConfigBuilder } from './codex.js';
 import { PiConfigBuilder } from './pi.js';
 import { OpencodeConfigBuilder } from './opencode.js';
 import { KimiConfigBuilder } from './kimi.js';
+import { DshConfigBuilder } from './dsh.js';
 /**
- * 首次启动默认展示的 Coding Agent 顺序：Codex → Claude → OpenCode → Pi → Kimi。
+ * 首次启动默认展示的 Coding Agent 顺序：Codex → Claude → OpenCode → Pi → Kimi → DSH。
  * 未安装（availability === false）的 agent 在展示时排到后面
  * （见 sortAgentsForDisplay），同组内保持本顺序。
  */
@@ -20,6 +21,7 @@ export const DEFAULT_AGENT_ORDER = [
     'opencode',
     'pi',
     'kimi',
+    'dsh',
 ];
 /** Registry of config builders, keyed by agent kind. */
 const builders = {
@@ -28,6 +30,7 @@ const builders = {
     pi: new PiConfigBuilder(),
     opencode: new OpencodeConfigBuilder(),
     kimi: new KimiConfigBuilder(),
+    dsh: new DshConfigBuilder(),
 };
 /**
  * Get the config builder for a specific agent.

package/dist/router/config/types.d.ts

@@ -49,4 +49,10 @@ export interface AgentConfigCardBuilder {
         key: string;
         value: unknown;
     }>;
+    /**
+     * 可选的异步预取钩子：卡片渲染前拉取动态选项（如 DSH 的模型/预设目录）。
+     * host 为该 agent 的当前连接地址；实现内部应缓存（同一 host 只拉一次），
+     * 失败静默回退固定兜底，不阻断卡片渲染。非异步预取的 agent 可不实现。
+     */
+    prefetch?(host?: string): Promise<void>;
 }

package/dist/router/index.d.ts

@@ -72,6 +72,8 @@ export interface CardActionPayload {
     selected?: boolean;
     /** Claude AskUserQuestion 问题索引（approval.answer / approval.answerSubmit）。 */
     questionIndex?: number;
+    /** 多选组件（multi_select_static 等）回传的选中值数组（预留公共层能力）。 */
+    options?: string[];
 }
 /**
  * Response a cardAction handler may return to give the clicking user native
@@ -89,7 +91,7 @@ interface CardActionResponse {
 }
 export declare class CommandRouter {
     /** Valid agent kinds — single source of truth for resume.use / resume.page / cmdResume. */
-    static readonly VALID_AGENTS: readonly ["claude", "codex", "opencode", "pi", "kimi"];
+    static readonly VALID_AGENTS: readonly ["claude", "codex", "opencode", "pi", "kimi", "dsh"];
     private sessionStore;
     /** 飞书桥接实例（public：测试直接访问断言，替代 as unknown as）。 */
     bridge: Bridge;
@@ -203,6 +205,9 @@ export declare class CommandRouter {
      * Routes to the appropriate bridge method based on value.cmd.
      * Returns a toast response for immediate user feedback.
      */
+    /** 答案类操作的统一失败反馈：重复投递（同一 nonce 第二次点击）是已生效的
+     *  中性事件，报 error 会误导（首次点击实际已成功）。 */
+    private answerFailureToast;
     private handleApprovalAction;
     /**
      * Handle queue.cancel: remove this message from the queue.
@@ -434,6 +439,14 @@ export declare class CommandRouter {
      * /resume 核心实现（public：handleResumePage / handle / resume.use 共用，
      * 也是测试的直接 seam，避免测试用 @ts-expect-error 摸私有方法）。
      */
+    /**
+     * DSH /resume preset 一致性校验：返回 mismatch 详情，或 undefined（一致/不可判定）。
+     *
+     * session 的 preset 在创建时固定（§2.1）。通过 listSessions 拿到目标 session 的
+     * agentPreset 与当前配置比对：不一致时不静默复用（返回提示），一致或查询失败
+     * （无法判定）时不阻断，避免 DSH 离线导致 /resume 完全不可用。
+     */
+    private dshPresetMismatch;
     cmdResume(args: string[], ctx: CommandContext, offset?: number): CommandResult;
     private cmdActive;
     /**
@@ -444,6 +457,12 @@ export declare class CommandRouter {
     private buildActiveCardFromMemory;
     private cmdReconnect;
     private cmdConfig;
+    /**
+     * DSH /config 卡片构建前异步预取模型/预设目录（§4.2 动态清单）。
+     * 只在 defaultAgent 为 dsh 时生效；其他 agent 无 prefetch 钩子直接跳过。
+     * 预取失败不阻断——DshConfigBuilder 内部已回退固定兜底清单。
+     */
+    private prefetchConfigCardCatalogs;
     /** Build an interactive config card with CardKit 2.0 tabs + batch save */
     buildConfigCard(): CommandResult;
     /** /order 实现（public：测试直接调用，替代 as unknown as）。 */

package/dist/router/index.js

@@ -2,7 +2,7 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import YAML from 'yaml';
-import { getConfigDir, getConfigValue, setConfigValue, setConfigValues, mapAgentKey, assertSafeKeyPart, walkNestedContainer, } from '../config/index.js';
+import { getConfigDir, getConfigValue, setConfigValue, setConfigValues, mapAgentKey, assertSafeKeyPart, walkNestedContainer, getAgentConfig, } from '../config/index.js';
 import { syncAgentChoices } from '../runner/index.js';
 import { WorkspaceStore } from '../workspace/index.js';
 import { OrderStore } from '../order/index.js';
@@ -121,11 +121,12 @@ export function isImmediateAction(cmd) {
         cmd === 'approval.toggle' ||
         cmd === 'approval.answer' ||
         cmd === 'approval.answerSubmit' ||
-        cmd === 'approval.answerCustom');
+        cmd === 'approval.answerCustom' ||
+        cmd === 'approval.answerNote');
 }
 export class CommandRouter {
     /** Valid agent kinds — single source of truth for resume.use / resume.page / cmdResume. */
-    static VALID_AGENTS = ['claude', 'codex', 'opencode', 'pi', 'kimi'];
+    static VALID_AGENTS = ['claude', 'codex', 'opencode', 'pi', 'kimi', 'dsh'];
     sessionStore;
     /** 飞书桥接实例（public：测试直接访问断言，替代 as unknown as）。 */
     bridge;
@@ -365,6 +366,7 @@ export class CommandRouter {
             case 'approval.answer':
             case 'approval.answerSubmit':
             case 'approval.answerCustom':
+            case 'approval.answerNote':
                 return this.handleApprovalAction(value, ctx);
             case 'codex.compact':
                 await this.bridge.handleCodexCompact(value, ctx);
@@ -403,6 +405,14 @@ export class CommandRouter {
      * Routes to the appropriate bridge method based on value.cmd.
      * Returns a toast response for immediate user feedback.
      */
+    /** 答案类操作的统一失败反馈：重复投递（同一 nonce 第二次点击）是已生效的
+     *  中性事件，报 error 会误导（首次点击实际已成功）。 */
+    answerFailureToast(msg) {
+        if (/already submitted \(duplicate nonce\)/.test(msg)) {
+            return { toast: { type: 'info', content: '该选项已处理，请勿重复点击' } };
+        }
+        return { toast: { type: 'error', content: `答案提交失败：${msg}` } };
+    }
     async handleApprovalAction(value, _ctx) {
         const { runId, requestId, decision, nonce, permId } = value;
         if (value.cmd === 'approval.respond') {
@@ -465,7 +475,7 @@ export class CommandRouter {
             }
             catch (err) {
                 const msg = err instanceof Error ? err.message : String(err);
-                return { toast: { type: 'error', content: `答案提交失败：${msg}` } };
+                return this.answerFailureToast(msg);
             }
         }
         if (value.cmd === 'approval.answerSubmit') {
@@ -483,7 +493,7 @@ export class CommandRouter {
             }
             catch (err) {
                 const msg = err instanceof Error ? err.message : String(err);
-                return { toast: { type: 'error', content: `答案提交失败：${msg}` } };
+                return this.answerFailureToast(msg);
             }
         }
         if (value.cmd === 'approval.answerCustom') {
@@ -506,7 +516,30 @@ export class CommandRouter {
             }
             catch (err) {
                 const msg = err instanceof Error ? err.message : String(err);
-                return { toast: { type: 'error', content: `答案提交失败：${msg}` } };
+                return this.answerFailureToast(msg);
+            }
+        }
+        if (value.cmd === 'approval.answerNote') {
+            if (!runId ||
+                requestId === undefined ||
+                value.questionIndex === undefined ||
+                !nonce ||
+                !value.inputValue) {
+                return { toast: { type: 'error', content: '缺少补充说明参数' } };
+            }
+            try {
+                await this.bridge.handleApprovalAnswerNote({
+                    runId,
+                    requestId,
+                    questionIndex: value.questionIndex,
+                    text: value.inputValue,
+                    nonce,
+                });
+                return { toast: { type: 'success', content: '补充说明已保存' } };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return this.answerFailureToast(msg);
             }
         }
         return { toast: { type: 'error', content: '未知的审批操作' } };
@@ -1144,7 +1177,7 @@ export class CommandRouter {
         // immediate action the callback response is swallowed by enqueueImmediate
         // (fire-and-forget), and even if delivered it is transient — the user gets
         // no perceivable feedback on the switch. Same rationale as config.save
-        // agent-switch notice (74e99f0): persistent message first, toast only as a
+        // agent-switch notice: persistent message first, toast only as a
         // fallback if sendResult fails.
         let fallbackToast;
         if (useResult.card || useResult.text) {
@@ -1377,6 +1410,8 @@ export class CommandRouter {
                     // 2026-08-03: 卡片刷新失败不吞切换通知——保存已成功，仅记录日志，
                     // 后续切换消息照常发送；真正写盘/传播阶段的失败才走外层 catch 报「保存失败」。
                     try {
+                        // host 可能已变更 → 重新预取 DSH 目录（内部按 host 缓存，未变不重复拉）
+                        await this.prefetchConfigCardCatalogs();
                         await this.bridge.updateCardInPlace(this.buildConfigCard().card, ctx);
                     }
                     catch (refreshErr) {
@@ -1553,6 +1588,24 @@ export class CommandRouter {
                 switchSessionId = '';
             }
         }
+        // DSH preset 变更 = 下次 run 新建 session（§4.3 D1）：
+        // preset 在 session 创建时固定，中途切换会被服务端拒绝（agent-preset-conflict）。
+        // 旧 sessionId 存入 previousSessions 停车位（可手动 /resume，但 /resume 会做
+        // preset 一致性校验），当前 sessionId 清空——下次 run 走 session.create 新建。
+        const hasDshPresetChange = Object.keys(updates).some((k) => k === 'agents.dsh.agentPreset');
+        // 已发生 agent 切换时（switchNotice 已设置）preset 分支跳过，避免覆盖切换 notice；
+        // 切换分支对 dsh 的 session 已做恢复/清空处理。
+        if (hasDshPresetChange && this.config.defaultAgent === 'dsh' && !switchNotice) {
+            const oldSessionId = this.sessionStore.getSessionId(ctx.userId, 'dsh');
+            if (oldSessionId) {
+                this.sessionStore.setPreviousSessionId(ctx.userId, 'dsh', oldSessionId);
+                this.sessionStore.clearSessionId(ctx.userId, 'dsh');
+                switchNotice = `DSH preset 已变更，旧会话已停放到恢复槽（可 /resume 校验后恢复），下次消息将新建会话`;
+            }
+            else {
+                switchNotice = `DSH preset 已变更，下次消息将新建会话`;
+            }
+        }
         // 2026-07-13: 同步 agent 配置到 agentChoices（用于切换 agent 时恢复配置）
         const currentAgent = this.config.defaultAgent;
         const currentAgentConfigKey = `agents.${currentAgent}`;
@@ -2579,6 +2632,32 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
      * /resume 核心实现（public：handleResumePage / handle / resume.use 共用，
      * 也是测试的直接 seam，避免测试用 @ts-expect-error 摸私有方法）。
      */
+    /**
+     * DSH /resume preset 一致性校验：返回 mismatch 详情，或 undefined（一致/不可判定）。
+     *
+     * session 的 preset 在创建时固定（§2.1）。通过 listSessions 拿到目标 session 的
+     * agentPreset 与当前配置比对：不一致时不静默复用（返回提示），一致或查询失败
+     * （无法判定）时不阻断，避免 DSH 离线导致 /resume 完全不可用。
+     */
+    dshPresetMismatch(reader, sessionId, cwd) {
+        const currentPreset = this.config.agents?.dsh?.agentPreset;
+        if (!currentPreset)
+            return undefined; // 配置跟随服务端默认，无法判定 → 放行
+        let sessionPreset;
+        try {
+            const { sessions } = reader.listSessions(cwd, { limit: 100 });
+            sessionPreset = sessions.find((s) => s.sessionId === sessionId)?.agentPreset;
+        }
+        catch (err) {
+            getLogger().warn(`[router] dshPresetMismatch listSessions failed for ${sessionId}: ${err.message}`);
+            return undefined;
+        }
+        if (!sessionPreset)
+            return undefined; // 服务端未返回 preset → 无法判定，放行
+        if (sessionPreset === currentPreset)
+            return undefined;
+        return { sessionPreset, currentPreset };
+    }
     cmdResume(args, ctx, offset = 0) {
         const entry = this.sessionStore.get(ctx.userId);
         const cwd = entry?.cwd;
@@ -2625,6 +2704,19 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                     text: `未找到 session ${sessionIdArg}（当前目录: ${cwd}）。请确认该 session 属于此目录，或先 /cd 到正确目录。`,
                 };
             }
+            // DSH preset 一致性校验（§6 风险 1）：session 的 preset 在创建时固定，
+            // 若与当前配置不符，直接复用会让后续 run 报 agent-preset-conflict。
+            // 不静默复用——明确提示用户，由用户决定是否继续（配置里手动改/清 preset）。
+            if (agentKind === 'dsh' && this.config.defaultAgent === 'dsh') {
+                const presetMismatch = this.dshPresetMismatch(reader, sessionIdArg, cwd);
+                if (presetMismatch) {
+                    return {
+                        text: `⚠️ 该 DSH session 的 preset 是「${presetMismatch.sessionPreset}」，与当前配置「${presetMismatch.currentPreset}」不一致。\n` +
+                            `preset 在 session 创建时固定，无法中途切换（DSH 返回 agent-preset-conflict）。\n` +
+                            `继续恢复将在下次 run 失败。请在 /config 中把预设模式改回「${presetMismatch.sessionPreset}」后重试，或保持当前配置并发新消息新建会话。`,
+                    };
+                }
+            }
             // L3: 校验通过后才写入
             this.sessionStore.setSessionId(ctx.userId, agentKind, sessionIdArg, cwd);
             const { events: content, usage, isActive, aiTitle, recap, displayTitle, activeRunRunId, } = this.readSessionDisplayState(sessionIdArg, cwd, {
@@ -2984,6 +3076,8 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
     async cmdConfig(args, ctx) {
         // Ensure probe cache is populated before building the card.
         await probeAllAgents();
+        // 动态清单预取（DSH 模型/预设目录）：卡渲染前拉取，失败回退兜底清单
+        await this.prefetchConfigCardCatalogs();
         // Check if this is a direct set command: /config <key> <value>
         // Command-style set: immediate write to disk, clear pendingConfig
         if (args.length >= 2) {
@@ -3030,6 +3124,18 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
         this.ensurePendingConfig();
         return this.buildConfigCard();
     }
+    /**
+     * DSH /config 卡片构建前异步预取模型/预设目录（§4.2 动态清单）。
+     * 只在 defaultAgent 为 dsh 时生效；其他 agent 无 prefetch 钩子直接跳过。
+     * 预取失败不阻断——DshConfigBuilder 内部已回退固定兜底清单。
+     */
+    async prefetchConfigCardCatalogs() {
+        if (this.config.defaultAgent !== 'dsh')
+            return;
+        const builder = getConfigBuilder('dsh');
+        const dshConf = getAgentConfig(this.config, 'dsh');
+        await builder.prefetch?.(dshConf?.host);
+    }
     /** Build an interactive config card with CardKit 2.0 tabs + batch save */
     buildConfigCard() {
         // 使用 pendingConfig（若存在）或当前 config

package/dist/router/utils.js

@@ -80,6 +80,16 @@ export function formatUsageStats(usage, options) {
     const cumTotalSuffix = usage?.cumulativeTotalTokens !== undefined
         ? ` · 累计 ${formatTokenK(usage.cumulativeTotalTokens)}`
         : '';
+    // 一致性护栏：本 run ≤ 累计 是硬不变量（累计 = 所有 run 之和，必 ≥ 本 run）。
+    // 违反说明来源 scope 混用（如 DeepSeek live result usage 是累积/超大 scope，
+    // 大于 jsonl 去重聚合的 session 累计）。只标记不修正——数字保持原样便于排查，
+    // 由数据源修复。两侧都有值时校验（避免旧数据/缺失字段误报）。
+    // 两个分支（real input/output / 10% 估计）共用，保证"本 run > 累计"在任意
+    // 路径都显式暴露。
+    const withCumGuard = (totalTokens) => cumTotalSuffix +
+        (usage?.cumulativeTotalTokens !== undefined && totalTokens > usage.cumulativeTotalTokens
+            ? ' · ⚠️ 累计异常'
+            : '');
     // 计算累计 cache 命中率
     const cumInput = usage?.cumulativeInputTokens;
     const cumCacheRead = usage?.cumulativeCacheReadTokens;
@@ -110,7 +120,7 @@ export function formatUsageStats(usage, options) {
             lines.push(`Cache create - ${formatTokenK(cacheCreation)}${cumCacheCreateSuffix}`);
         }
         lines.push(`Cached token - ${formatTokenK(cacheRead)} (${cachePercent}%)${cumCacheReadSuffix}`);
-        lines.push(`Total token - ${formatTokenK(totalTokens)}${cumTotalSuffix}`);
+        lines.push(`Total token - ${formatTokenK(totalTokens)}${withCumGuard(totalTokens)}`);
     }
     else {
         // Estimate path: when real input/output are absent,
@@ -127,7 +137,7 @@ export function formatUsageStats(usage, options) {
                 lines.push(`Cache create - ${formatTokenK(cacheCreation)}${cumCacheCreateSuffix}`);
             }
             lines.push(`Cached token - ${formatTokenK(cacheRead)} (${cachePercent}%)${cumCacheReadSuffix}`);
-            lines.push(`Total token - ${formatTokenK(totalTokens)}${cumTotalSuffix}`);
+            lines.push(`Total token - ${formatTokenK(totalTokens)}${withCumGuard(totalTokens)}`);
         }
     }
     return lines.join('\n');

package/dist/runner/agent-choices-common.js

@@ -23,6 +23,9 @@ export const AGENT_CHOICE_FIELDS = {
         { configKey: 'model', choicesKey: 'model' },
         { configKey: 'thinkingEffort', choicesKey: 'thinkingEffort' },
     ],
+    // DSH has no model/provider choice fields (host endpoint is connection
+    // config, not a per-run choice) — empty to satisfy the Record type.
+    dsh: [],
 };
 /** 返回指定 agent 的字段映射；claude 或未知 agent 返回 undefined。 */
 export function choiceFieldsFor(agent) {

package/dist/runner/claude/session.js

@@ -32,6 +32,7 @@ import { getLogger } from '../../logger/index.js';
 import { SpawningRunner } from '../common/spawning-runner.js';
 import { pipeAllStdio } from '../common/runner-utils.js';
 import { authErrorEvent, syntheticInitEvent } from '../common/runner-utils.js';
+import { makeQuestionApprovalEvent } from '../question-common.js';
 /** 拒绝权限时的默认提示（进入 claude 上下文，中文用户可读）。 */
 const DENY_MESSAGE = '用户拒绝了此工具调用，请停止并等待用户指令。';
 /** 会话级空闲回收默认 TTL（对齐 codex appServer.idleTtlMs 默认 30 分钟）。 */
@@ -639,17 +640,30 @@ export class ClaudeSession extends SpawningRunner {
                 this.pendingToolInputs.delete(requestId);
                 return [];
             }
+            return [makeQuestionApprovalEvent(requestId, questions, this.sessionId)];
+        }
+        // ExitPlanMode：语义是「退出计划模式」的通知型工具，input 天然为空（plan
+        // 内容在 plan 文件 + 前置 thinking/text 里，不走 tool input）。它没有
+        // command 语义，塞进 command 槽位会显示无意义 `{}` → 用独立 tool kind，
+        // 标题/工具名 + reason 表达审批内容。
+        if (toolName === 'ExitPlanMode') {
+            const rawInput = JSON.stringify(input);
             const view = {
                 requestId,
-                kind: 'question',
-                questions,
-                availableDecisions: [],
+                kind: 'tool',
+                toolName,
+                reason: typeof request.description === 'string' ? request.description : undefined,
+                // 非空 input 携带给渲染层（当前 ExitPlanMode 为 `{}`，渲染层不展示）。
+                ...(rawInput && rawInput !== '{}' ? { toolInput: rawInput.slice(0, 500) } : {}),
+                // 计划审批没有「后续自动放行」语义，acceptAll 无意义；只留 accept/decline。
+                availableDecisions: ['accept', 'decline'],
             };
+            getLogger().info(`[${this.logTag}] permission request requestId=${requestId} tool=${toolName}`);
             return [
                 {
                     type: 'approval_requested',
                     requestId,
-                    kind: 'question',
+                    kind: 'tool',
                     threadId: this.sessionId,
                     turnId: '',
                     itemId: '',
@@ -658,7 +672,12 @@ export class ClaudeSession extends SpawningRunner {
                 },
             ];
         }
-        const command = typeof input.command === 'string' ? input.command : JSON.stringify(input ?? {});
+        // 非命令工具的兜底防御：input 无 command 字段时 JSON 序列化，但空对象
+        // 序列化成 `{}` 对用户无意义——内容为空时回退展示工具名（review P3-5）。
+        const rawCommand = typeof input.command === 'string' ? input.command : JSON.stringify(input);
+        const command = rawCommand && rawCommand !== '{}' && rawCommand !== 'null'
+            ? rawCommand
+            : toolName || '(unknown tool)';
         const view = {
             requestId,
             kind: 'command',

package/dist/runner/codex/app-server/protocol-types.d.ts

@@ -83,6 +83,8 @@ export interface ThreadResumeParams {
     modelProvider?: string | null;
     approvalPolicy?: AskForApproval;
     sandbox?: SandboxMode;
+    /** Configuration overrides for the resumed thread (codex v2 wire field). */
+    config?: Record<string, unknown> | null;
 }
 export interface ThreadResumeResponse {
     thread: Thread;
@@ -432,6 +434,7 @@ export declare const ServerRequestMethod: {
     readonly COMMAND_EXECUTION_APPROVAL: "item/commandExecution/requestApproval";
     readonly FILE_CHANGE_APPROVAL: "item/fileChange/requestApproval";
     readonly PERMISSIONS_APPROVAL: "item/permissions/requestApproval";
+    readonly REQUEST_USER_INPUT: "item/tool/requestUserInput";
 };
 export interface NetworkApprovalContext {
     host: string;
@@ -515,5 +518,37 @@ export interface PermissionsRequestApprovalResponse {
     permissions: GrantedPermissionProfile;
     scope?: 'turn' | 'session';
 }
+/**
+ * Codex AskUserQuestion（request_user_input）协议形状。
+ * 来源：codex-rs/codex-rs/protocol/src/request_user_input.rs +
+ * app-server-protocol v2/item.rs ToolRequestUserInput*（EXPERIMENTAL）。
+ * isOther=true → 渲染层提供自定义答案输入；isSecret 仅影响展示（按普通输入
+ * 处理）；options 为 null/空 → 自由文本题。
+ */
+export interface ToolRequestUserInputOption {
+    label: string;
+    description: string;
+}
+export interface ToolRequestUserInputQuestion {
+    id: string;
+    header: string;
+    question: string;
+    isOther: boolean;
+    isSecret: boolean;
+    options: ToolRequestUserInputOption[] | null;
+}
+export interface ToolRequestUserInputParams {
+    threadId: string;
+    turnId: string;
+    itemId: string;
+    questions: ToolRequestUserInputQuestion[];
+    autoResolutionMs?: number | null;
+}
+export interface ToolRequestUserInputAnswer {
+    answers: string[];
+}
+export interface ToolRequestUserInputResponse {
+    answers: Record<string, ToolRequestUserInputAnswer>;
+}
 /** Unsupported / ignored server request methods. */
 export declare const UNSUPPORTED_SERVER_REQUEST_METHODS: Set<string>;