lark-remote 0.1.6 → 0.1.8

package/dist/router/config/codex.js

@@ -3,6 +3,7 @@
  */
 import { loadCodexConfig, getReasoningEffortOptions, getDefaultReasoningEffort, } from '../../config/codex-config.js';
 import { DEFAULT_TURN_IDLE_TIMEOUT_MINUTES } from '../../config/index.js';
+import { resetModelPatch } from './common/model-patch.js';
 export class CodexConfigBuilder {
     buildFields(displayConfig) {
         const fields = [];
@@ -44,54 +45,33 @@ export class CodexConfigBuilder {
             options: getReasoningEffortOptions(currentCodexModel),
             currentValue: currentReasoningEffort,
         });
-        // Service mode (exec vs app-server)
-        const currentServiceMode = displayConfig.agents?.codex?.serviceMode ?? 'exec';
+        // 审批策略与沙箱模式由 CodexAppServerRunner 读取（Codex 官方枚举标准值）。
+        // Approval policy (Codex 官方 AskForApproval 标准值；on-request 为 codex 默认)
+        const currentApprovalPolicy = displayConfig.agents?.codex?.approvalPolicy ?? 'on-request';
         fields.push({
-            key: 'agents.codex.serviceMode',
-            label: '运行模式',
+            key: 'agents.codex.approvalPolicy',
+            label: '审批策略',
             type: 'select',
-            options: ['exec', 'app-server'],
-            currentValue: currentServiceMode,
+            options: ['untrusted', 'on-request', 'never'],
+            currentValue: currentApprovalPolicy,
+        });
+        // Sandbox mode (Codex 官方 SandboxMode 标准值；默认 workspace-write)
+        const currentSandbox = displayConfig.agents?.codex?.sandbox ?? 'workspace-write';
+        fields.push({
+            key: 'agents.codex.sandbox',
+            label: '沙箱模式',
+            type: 'select',
+            options: ['read-only', 'workspace-write', 'danger-full-access'],
+            currentValue: currentSandbox,
+        });
+        const currentTurnIdleTimeoutMinutes = displayConfig.agents?.codex?.appServer?.turnIdleTimeoutMinutes ??
+            DEFAULT_TURN_IDLE_TIMEOUT_MINUTES;
+        fields.push({
+            key: 'agents.codex.appServer.turnIdleTimeoutMinutes',
+            label: 'Turn 空闲超时(分钟, 0关闭)',
+            type: 'input',
+            currentValue: String(currentTurnIdleTimeoutMinutes),
         });
-        // 审批策略与沙箱模式仅 app-server 模式可配置（CodexAppServerRunner 读取）；
-        // exec 模式在 runner 层固定 `--sandbox danger-full-access` +
-        // `approval_policy="never"`（src/runner/codex/argv.ts），卡片不暴露选项，
-        // 只用说明行把默认语义呈现给用户。
-        if (currentServiceMode === 'app-server') {
-            // Approval policy (Codex 官方 AskForApproval 标准值；on-request 为 codex 默认)
-            const currentApprovalPolicy = displayConfig.agents?.codex?.approvalPolicy ?? 'on-request';
-            fields.push({
-                key: 'agents.codex.approvalPolicy',
-                label: '审批策略',
-                type: 'select',
-                options: ['untrusted', 'on-request', 'never'],
-                currentValue: currentApprovalPolicy,
-            });
-            // Sandbox mode (Codex 官方 SandboxMode 标准值)
-            const currentSandbox = displayConfig.agents?.codex?.sandbox ?? 'danger-full-access';
-            fields.push({
-                key: 'agents.codex.sandbox',
-                label: '沙箱模式',
-                type: 'select',
-                options: ['read-only', 'workspace-write', 'danger-full-access'],
-                currentValue: currentSandbox,
-            });
-            const currentTurnIdleTimeoutMinutes = displayConfig.agents?.codex?.appServer?.turnIdleTimeoutMinutes ??
-                DEFAULT_TURN_IDLE_TIMEOUT_MINUTES;
-            fields.push({
-                key: 'agents.codex.appServer.turnIdleTimeoutMinutes',
-                label: 'Turn 空闲超时(分钟, 0关闭)',
-                type: 'input',
-                currentValue: String(currentTurnIdleTimeoutMinutes),
-            });
-        }
-        else {
-            fields.push({
-                key: 'agents.codex.modeNote',
-                label: '命令行模式固定为完全访问（danger-full-access）且无需审批（approval never），不提供审批策略/沙箱配置',
-                type: 'note',
-            });
-        }
         return fields;
     }
     handleFieldChange(key, value, config) {
@@ -100,12 +80,11 @@ export class CodexConfigBuilder {
         // provider 变更时，重置 model 为新 provider 的首个模型
         if (key === 'agents.codex.modelProvider' && typeof value === 'string') {
             const codexCfg = loadCodexConfig();
-            const newModelOptions = codexCfg.modelOptions(value);
             const currentModel = config.agents?.codex?.model;
-            const currentModelIsValid = newModelOptions.some((m) => m === currentModel);
-            if (!currentModelIsValid && newModelOptions.length > 0) {
-                const replacedModel = newModelOptions[0];
-                patches.push({ key: 'agents.codex.model', value: replacedModel });
+            const modelPatch = resetModelPatch(key, 'agents.codex.model', currentModel, codexCfg.modelOptions(value));
+            if (modelPatch) {
+                patches.push(modelPatch);
+                const replacedModel = modelPatch.value;
                 // provider 切换自动替换模型后，必须对替换后的模型执行
                 // 同样的档位校验——否则旧模型支持的档位会原样留在卡片/透传给不支持它的模型
                 // （codex 只在会话中 with_model 时钳制，session 创建路径不钳制）。

package/dist/router/config/common/model-patch.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared field-change patch helpers for agent config cards.
+ *
+ * `resetModelPatch` captures the "provider changed → reset model to the new
+ * provider's first model" behavior that opencode/pi/codex config builders were
+ * duplicating.
+ */
+/**
+ * Build a model-reset patch when the provider field changes: if the current
+ * model is not offered by the new provider (and the new provider has models),
+ * patch the model to the provider's first option.
+ *
+ * @param providerKey  The field key that changed, e.g. 'agents.codex.modelProvider'.
+ * @param modelKey     The model field to reset, e.g. 'agents.codex.model'.
+ * @param currentModel The currently-configured model value (may be undefined).
+ * @param newModelOptions Models offered by the newly-selected provider.
+ * @returns A `{ key, value }` patch, or null when no reset is needed.
+ */
+export declare function resetModelPatch(providerKey: string, modelKey: string, currentModel: string | undefined, newModelOptions: string[]): {
+    key: string;
+    value: unknown;
+} | null;

package/dist/router/config/common/model-patch.js

@@ -0,0 +1,26 @@
+/**
+ * Shared field-change patch helpers for agent config cards.
+ *
+ * `resetModelPatch` captures the "provider changed → reset model to the new
+ * provider's first model" behavior that opencode/pi/codex config builders were
+ * duplicating.
+ */
+/**
+ * Build a model-reset patch when the provider field changes: if the current
+ * model is not offered by the new provider (and the new provider has models),
+ * patch the model to the provider's first option.
+ *
+ * @param providerKey  The field key that changed, e.g. 'agents.codex.modelProvider'.
+ * @param modelKey     The model field to reset, e.g. 'agents.codex.model'.
+ * @param currentModel The currently-configured model value (may be undefined).
+ * @param newModelOptions Models offered by the newly-selected provider.
+ * @returns A `{ key, value }` patch, or null when no reset is needed.
+ */
+export function resetModelPatch(providerKey, modelKey, currentModel, newModelOptions) {
+    const currentModelIsValid = newModelOptions.some((m) => m === currentModel);
+    if (!currentModelIsValid && newModelOptions.length > 0) {
+        return { key: modelKey, value: newModelOptions[0] };
+    }
+    return null;
+}
+//# sourceMappingURL=model-patch.js.map

package/dist/router/config/common/render.js

@@ -86,10 +86,11 @@ function buildSelectElement(field, currentValue) {
                     {
                         tag: 'select_static',
                         placeholder: { tag: 'plain_text', content: '请选择' },
-                        options: field.options.map((opt) => ({
-                            text: { tag: 'plain_text', content: opt },
-                            value: opt,
-                        })),
+                        options: field.options.map((opt) => {
+                            const text = typeof opt === 'string' ? opt : opt.text;
+                            const value = typeof opt === 'string' ? opt : opt.value;
+                            return { text: { tag: 'plain_text', content: text }, value };
+                        }),
                         initial_option: selectedValue,
                         behaviors: [{ type: 'callback', value: { cmd: 'config.set', key: field.key } }],
                     },

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

@@ -0,0 +1,51 @@
+/**
+ * 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 type { AgentConfigCardBuilder, ConfigField } from './types.js';
+import { type AppConfig } from '../../config/index.js';
+import type { DshModelCatalogValue, DshPresetListValue } from '../../runner/dsh/types.js';
+/** DshConfigBuilder 预取只依赖的 client 方法子集。 */
+export interface DshCatalogClient {
+    listModels(): Promise<DshModelCatalogValue>;
+    listPresets(): Promise<DshPresetListValue>;
+}
+export declare class DshConfigBuilder implements AgentConfigCardBuilder {
+    /** 最近一次预取用的 host；host 变更时缓存失效（下一张卡重新拉取）。 */
+    private prefetchHost;
+    private modelCatalog;
+    private presets;
+    /** 可注入 client 工厂（测试用）；默认生产实现。 */
+    private readonly clientFactory;
+    constructor(clientFactory?: (baseUrl: string) => DshCatalogClient);
+    /** 异步预取模型/预设目录（§4.2 二期动态清单）。失败/离线静默回退固定兜底清单，
+     *  卡不依赖 DSH 服务在线；同一 host 只拉一次，避免每次刷卡重复请求。 */
+    prefetch(host?: string): Promise<void>;
+    /** 同步注入 catalog/presets（测试用，替代异步 prefetch；标记 prefetchHost 使
+     *  后续 prefetch 短路，避免测试误触发网络请求）。 */
+    setCatalog(catalog: DshModelCatalogValue, presets?: DshPresetListValue): void;
+    /** 展平 llm.models 各 provider group 的模型 id；无 catalog 时回退固定清单。 */
+    private modelOptions;
+    /** preset 清单；无 presets 时回退固定清单。显示名优先用 preset.yml 的 name。 */
+    private presetOptions;
+    /** 模型在 catalog 中声明的推理档位；无 catalog/模型不在目录时回退固定档位。 */
+    private effortOptionsForModel;
+    buildFields(displayConfig: AppConfig): ConfigField[];
+    handleFieldChange(key: string, value: unknown, config: AppConfig): Array<{
+        key: string;
+        value: unknown;
+    }>;
+    /** 切到 newModel 后的档位补丁：当前档位仍被新模型支持 → 不产出；否则用新模型
+     *  目录中位；无目录/空列表 → undefined（清空 = 跟随服务端默认）。 */
+    private effortPatchForModel;
+}

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

@@ -6,6 +6,12 @@
  */
 import type { AgentKind } from '../../runner/types.js';
 import type { AgentConfigCardBuilder } from './types.js';
+/**
+ * 首次启动默认展示的 Coding Agent 顺序：Codex → Claude → OpenCode → Pi → Kimi → DSH。
+ * 未安装（availability === false）的 agent 在展示时排到后面
+ * （见 sortAgentsForDisplay），同组内保持本顺序。
+ */
+export declare const DEFAULT_AGENT_ORDER: readonly AgentKind[];
 /**
  * Get the config builder for a specific agent.
  *
@@ -16,3 +22,9 @@ import type { AgentConfigCardBuilder } from './types.js';
 export declare function getConfigBuilder(agent: AgentKind): AgentConfigCardBuilder;
 /** List all registered agent kinds. */
 export declare function listRegisteredAgents(): AgentKind[];
+/**
+ * 按展示规则排序 agent 列表：明确未安装（availability === false）的排后，
+ * 已安装/未知的在前；同组内保持传入顺序（canonical order）。
+ * Array.prototype.sort 是稳定排序，因此按可用性分组不会打乱组内顺序。
+ */
+export declare function sortAgentsForDisplay(agents: readonly AgentKind[], availability: (kind: AgentKind) => boolean | undefined): AgentKind[];

package/dist/router/config/index.js

@@ -9,6 +9,20 @@ 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 → DSH。
+ * 未安装（availability === false）的 agent 在展示时排到后面
+ * （见 sortAgentsForDisplay），同组内保持本顺序。
+ */
+export const DEFAULT_AGENT_ORDER = [
+    'codex',
+    'claude',
+    'opencode',
+    'pi',
+    'kimi',
+    'dsh',
+];
 /** Registry of config builders, keyed by agent kind. */
 const builders = {
     claude: new ClaudeConfigBuilder(),
@@ -16,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.
@@ -33,6 +48,18 @@ export function getConfigBuilder(agent) {
 }
 /** List all registered agent kinds. */
 export function listRegisteredAgents() {
-    return Object.keys(builders);
+    return DEFAULT_AGENT_ORDER.filter((kind) => kind in builders);
+}
+/**
+ * 按展示规则排序 agent 列表：明确未安装（availability === false）的排后，
+ * 已安装/未知的在前；同组内保持传入顺序（canonical order）。
+ * Array.prototype.sort 是稳定排序，因此按可用性分组不会打乱组内顺序。
+ */
+export function sortAgentsForDisplay(agents, availability) {
+    return [...agents].sort((a, b) => {
+        const aMissing = availability(a) === false ? 1 : 0;
+        const bMissing = availability(b) === false ? 1 : 0;
+        return aMissing - bMissing;
+    });
 }
 //# sourceMappingURL=index.js.map

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

@@ -1,8 +1,11 @@
 /**
  * Kimi config builder — builds fields and handles field changes for Kimi agent.
+ *
+ * Kimi is pure ACP mode: permissionMode (manual/auto/yolo) and the ACP
+ * sub-config fields are always shown.
  */
 import type { AgentConfigCardBuilder, ConfigField } from './types.js';
-import type { AppConfig } from '../../config/index.js';
+import { type AppConfig } from '../../config/index.js';
 export declare class KimiConfigBuilder implements AgentConfigCardBuilder {
     buildFields(displayConfig: AppConfig): ConfigField[];
     handleFieldChange(key: string, value: unknown, config: AppConfig): Array<{

package/dist/router/config/kimi.js

@@ -1,7 +1,16 @@
 /**
  * Kimi config builder — builds fields and handles field changes for Kimi agent.
+ *
+ * Kimi is pure ACP mode: permissionMode (manual/auto/yolo) and the ACP
+ * sub-config fields are always shown.
  */
 import { loadKimiConfig, KIMI_THINKING_EFFORTS, FALLBACK_EFFORTS, } from '../../config/kimi-config.js';
+import { DEFAULT_TURN_IDLE_TIMEOUT_MINUTES } from '../../config/index.js';
+const PERMISSION_MODE_OPTIONS = [
+    { text: 'manual（逐项审批）', value: 'manual' },
+    { text: 'auto（引擎裁决）', value: 'auto' },
+    { text: 'yolo（全部放行）', value: 'yolo' },
+];
 export class KimiConfigBuilder {
     buildFields(displayConfig) {
         const fields = [];
@@ -9,6 +18,8 @@ export class KimiConfigBuilder {
         const kimiCfg = loadKimiConfig();
         const currentModel = displayConfig.agents?.kimi?.model ?? kimiCfg.currentModel;
         const currentThinking = displayConfig.agents?.kimi?.thinkingEffort ?? 'max';
+        const currentPermissionMode = displayConfig.agents?.kimi?.permissionMode ?? 'manual';
+        // §7: 现有 model + thinkingEffort select（顺序不变）
         fields.push({
             key: 'agents.kimi.model',
             label: '使用模型',
@@ -25,6 +36,22 @@ export class KimiConfigBuilder {
             options: (kimiCfg.modelEfforts[currentModel] ?? [...FALLBACK_EFFORTS]).filter((e) => KIMI_THINKING_EFFORTS.includes(e)),
             currentValue: currentThinking,
         });
+        // Permission mode + ACP sub-config (pure ACP: always shown)
+        // §7: 文案用官方名 + 中文注释
+        fields.push({
+            key: 'agents.kimi.permissionMode',
+            label: '权限模式',
+            type: 'select',
+            options: PERMISSION_MODE_OPTIONS,
+            currentValue: currentPermissionMode,
+        });
+        const currentTurnIdleTimeoutMinutes = displayConfig.agents?.kimi?.acp?.turnIdleTimeoutMinutes ?? DEFAULT_TURN_IDLE_TIMEOUT_MINUTES;
+        fields.push({
+            key: 'agents.kimi.acp.turnIdleTimeoutMinutes',
+            label: 'Turn 空闲超时(分钟, 0关闭)',
+            type: 'input',
+            currentValue: String(currentTurnIdleTimeoutMinutes),
+        });
         return fields;
     }
     handleFieldChange(key, value, config) {

package/dist/router/config/opencode.js

@@ -2,6 +2,11 @@
  * OpenCode config builder — builds fields and handles field changes for OpenCode agent.
  */
 import { loadOpencodeConfig } from '../../config/opencode-config.js';
+import { resetModelPatch } from './common/model-patch.js';
+const MODE_OPTIONS = [
+    { text: 'build（默认，逐项审批）', value: 'build' },
+    { text: 'plan（规划模式）', value: 'plan' },
+];
 export class OpencodeConfigBuilder {
     buildFields(displayConfig) {
         const fields = [];
@@ -23,6 +28,16 @@ export class OpencodeConfigBuilder {
             type: 'select',
             options: modelOptions,
         });
+        // §P5: mode select（build/plan，默认 build）——opencode 无运行期审批档位，
+        // mode 即审批粒度档位（build 逐项审批 / plan 规划模式）。
+        const currentMode = displayConfig.agents?.opencode?.mode ?? 'build';
+        fields.push({
+            key: 'agents.opencode.mode',
+            label: '会话模式',
+            type: 'select',
+            options: MODE_OPTIONS,
+            currentValue: currentMode,
+        });
         return fields;
     }
     handleFieldChange(key, value, config) {
@@ -31,12 +46,10 @@ export class OpencodeConfigBuilder {
         // provider 变更时，重置 model 为新 provider 的首个模型
         if (key === 'agents.opencode.providerID' && typeof value === 'string') {
             const opencodeCfg = loadOpencodeConfig();
-            const newModelOptions = opencodeCfg.modelOptions(value);
             const currentModel = config.agents?.opencode?.modelID;
-            const currentModelIsValid = newModelOptions.some((m) => m === currentModel);
-            if (!currentModelIsValid && newModelOptions.length > 0) {
-                patches.push({ key: 'agents.opencode.modelID', value: newModelOptions[0] });
-            }
+            const modelPatch = resetModelPatch(key, 'agents.opencode.modelID', currentModel, opencodeCfg.modelOptions(value));
+            if (modelPatch)
+                patches.push(modelPatch);
         }
         return patches;
     }

package/dist/router/config/pi.js

@@ -3,6 +3,7 @@
  */
 import { loadPiConfig, getPiModelOptions } from '../../config/pi-config.js';
 import { PI_THINKING_LEVELS } from '../../config/index.js';
+import { resetModelPatch } from './common/model-patch.js';
 export class PiConfigBuilder {
     buildFields(displayConfig) {
         const fields = [];
@@ -37,12 +38,10 @@ export class PiConfigBuilder {
         patches.push({ key, value });
         // provider 变更时，重置 model 为新 provider 的首个模型
         if (key === 'agents.pi.provider' && typeof value === 'string') {
-            const newModelOptions = getPiModelOptions(value);
             const currentModel = config.agents?.pi?.model;
-            const currentModelIsValid = newModelOptions.some((m) => m === currentModel);
-            if (!currentModelIsValid && newModelOptions.length > 0) {
-                patches.push({ key: 'agents.pi.model', value: newModelOptions[0] });
-            }
+            const modelPatch = resetModelPatch(key, 'agents.pi.model', currentModel, getPiModelOptions(value));
+            if (modelPatch)
+                patches.push(modelPatch);
         }
         return patches;
     }

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

@@ -5,13 +5,22 @@
  * The router delegates to `getConfigBuilder(agent)` instead of a giant switch-case.
  */
 import type { AppConfig } from '../../config/index.js';
+/** A select option with separate display text and config value. */
+export interface SelectOption {
+    /** Display text shown in the dropdown (may include annotations). */
+    text: string;
+    /** Config value written to config.yaml (must match schema enum values). */
+    value: string;
+}
 /** A single field descriptor in the /config card. */
 export interface ConfigField {
     key: string;
     label: string;
     type: 'boolean' | 'select' | 'input' | 'note';
-    /** For select type: the list of options shown in the dropdown. */
-    options?: readonly string[];
+    /** For select type: the list of options shown in the dropdown.
+     *  Accepts plain strings (text=value) or {text, value} objects for
+     *  display-value separation (e.g. 'manual（逐项审批）' → value 'manual'). */
+    options?: readonly (string | SelectOption)[];
     /** Override the currentValue shown in the card (takes priority over getConfigValue). */
     currentValue?: string | boolean;
 }
@@ -40,4 +49,10 @@ export interface AgentConfigCardBuilder {
         key: string;
         value: unknown;
     }>;
+    /**
+     * 可选的异步预取钩子：卡片渲染前拉取动态选项（如 DSH 的模型/预设目录）。
+     * host 为该 agent 的当前连接地址；实现内部应缓存（同一 host 只拉一次），
+     * 失败静默回退固定兜底，不阻断卡片渲染。非异步预取的 agent 可不实现。
+     */
+    prefetch?(host?: string): Promise<void>;
 }