lark-remote 0.1.7 → 0.1.8

package/dist/card/run-renderer.js

@@ -25,13 +25,21 @@ function measureJson(obj) {
 /** markdownDiv('', 'notation') 的序列化字节（空内容 div 的常量开销，估算时复用）。 */
 const EMPTY_MD_DIV_BYTES = measureJson(markdownDiv('', 'notation'));
 /**
- * Compact 按钮可见性：普通 run（operationKind='turn'）到达任意终态即可压缩。
+ * Compact 按钮可见性：到达任意终态即可压缩。
  * 异常退出（error/interrupted/idle_timeout）时上下文往往更大，更需要压缩后
  * 再继续，因此不再要求 resultSubtype==='success'。compaction 卡
  * （operationKind='compaction'）永不显示，防止递归 Compact。
+ *
+ * 能力门控（compactSupported !== false）与执行侧 `'runCompact' in runner`
+ * 鸭子探测对齐：claude 走 stream-json，不发射 turn_started，operationKind
+ * 恒 undefined——若以 operationKind==='turn' 作门控，claude 终态卡永远拿
+ * 不到按钮（2026-08-19 缺陷）。compaction 卡的「防递归」仍由 operationKind
+ * 保证，两者是不同质的判断。
  */
-function shouldShowCompactButton(state) {
-    if (state.operationKind !== 'turn')
+function shouldShowCompactButton(state, options) {
+    if (state.operationKind === 'compaction')
+        return false;
+    if (options.compactSupported === false)
         return false;
     return (state.terminal === 'done' ||
         state.terminal === 'error' ||
@@ -201,15 +209,15 @@ const EXTREME_TIER = {
     textBytes: DEGRADED_TEXT_BYTES,
 };
 /** Bottom action row: stop (if running) + compact (if applicable) + new session (always). */
-function actionRow(state) {
+function actionRow(state, options) {
     const actionButtons = [];
     // finalizing 也显示停止按钮（进程未退出，用户可 /stop）
     const showStop = state.terminal === 'running' || state.terminal === 'finalizing';
     if (showStop) {
         actionButtons.push(stopButton(state.runId));
     }
-    // Compact 按钮：普通 turn 到达任意终态即可压缩（含异常退出），compaction 卡除外
-    if (shouldShowCompactButton(state)) {
+    // Compact 按钮：到达任意终态即可压缩（含异常退出），compaction 卡除外
+    if (shouldShowCompactButton(state, options)) {
         actionButtons.push(compactButton(state.runId));
     }
     actionButtons.push(newSessionButton());
@@ -323,7 +331,7 @@ function buildFallbackElements(state, options, tier) {
         elements.push(markdownDiv('_暂无输出_'));
     }
     elements.push(...buildSummaryContent(state));
-    elements.push(...actionRow(state));
+    elements.push(...actionRow(state, options));
     elements.push(...approvalArea(state));
     return elements;
 }
@@ -374,7 +382,7 @@ function statusRow(state) {
  * stop while running/finalizing). No block content is rendered, so the size is
  * bounded by static structure regardless of input — closing the safety-net gap.
  */
-function buildSkeletonElements(state) {
+function buildSkeletonElements(state, options) {
     const elements = [];
     elements.push(statusRow(state));
     elements.push(markdownDiv('_⚠️ 输出过大且含大量转义字符，已省略全部内容以避免超限；完整内容请查日志_'));
@@ -382,7 +390,7 @@ function buildSkeletonElements(state) {
     elements.push(...buildSummaryContent(state));
     // Bottom action row: stop (if running/finalizing) + compact (if applicable) + new session (always).
     // Degraded paths must keep the action buttons reachable (design constraint).
-    elements.push(...actionRow(state));
+    elements.push(...actionRow(state, options));
     return elements;
 }
 /**
@@ -450,6 +458,9 @@ export function estimateCardBytes(state, options = {}, shared) {
     if (state.terminal === 'running' || state.terminal === 'finalizing') {
         actionButtons.push(stopButton(state.runId));
     }
+    if (shouldShowCompactButton(state, options)) {
+        actionButtons.push(compactButton(state.runId));
+    }
     actionButtons.push(newSessionButton());
     total += measureJson([
         { tag: 'div', text: { content: '‎', tag: 'lark_md' } },
@@ -551,7 +562,7 @@ export function renderRunCard(state, options = {}) {
             statusRow(state),
             ...buildChronologicalContent(state, options, prepared, groups),
             ...buildSummaryContent(state),
-            ...actionRow(state),
+            ...actionRow(state, options),
             ...approvalArea(state),
         ];
         const card = assembleRunCard(state, options, elements);
@@ -573,7 +584,7 @@ export function renderRunCard(state, options = {}) {
     if (Buffer.byteLength(JSON.stringify(extremeCard), 'utf8') <= CARD_BUDGET_BYTES) {
         return extremeCard;
     }
-    const skeletonCard = assembleRunCard(state, options, buildSkeletonElements(state));
+    const skeletonCard = assembleRunCard(state, options, buildSkeletonElements(state, options));
     // skeleton 卡是静态结构，理论上必 ≤28KB；保留兜底断言以防未来结构膨胀
     if (Buffer.byteLength(JSON.stringify(skeletonCard), 'utf8') <= CARD_BUDGET_BYTES) {
         return skeletonCard;

package/dist/config/index.d.ts

@@ -6,6 +6,8 @@ export declare const CLAUDE_EFFORTS: readonly ["low", "medium", "high", "xhigh",
  * Claude 官方 --permission-mode 枚举（claude --help 输出，2026-08 实测）。
  * 额外支持 'default'：Claude settings.json 的官方未设置值，等价于不传
  * --permission-mode（交互式默认：高风险工具逐个询问）。
+ * 'manual' 是 'default' 的别名（claude CLI 等价），schema 保留以向后兼容旧配置，
+ * 但 UI 下拉不展示（见 router/config/claude.ts）。
  */
 export declare const CLAUDE_PERMISSION_MODES: readonly ["default", "acceptEdits", "auto", "bypassPermissions", "manual", "dontAsk", "plan"];
 /** Valid thinking levels for Pi */
@@ -17,7 +19,7 @@ export declare const PI_THINKING_LEVELS: readonly ["off", "minimal", "low", "med
  */
 export declare const DEFAULT_STOP_GRACE_MS: 5000;
 /** Codex app-server turn idle timeout default (minutes). */
-export declare const DEFAULT_TURN_IDLE_TIMEOUT_MINUTES: 10;
+export declare const DEFAULT_TURN_IDLE_TIMEOUT_MINUTES: 30;
 /** 入站媒体默认配置（schema 默认与 connector 兜底共用，避免双源漂移）。 */
 export declare const DEFAULT_INBOUND_MEDIA_DIR_NAME = ".lark-remote-temp";
 export declare const DEFAULT_INBOUND_MEDIA_MAX_SIZE_MB = 50;
@@ -112,6 +114,15 @@ declare const KimiConfigSchema: z.ZodObject<{
         turnIdleTimeoutMinutes: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+/** DSH (DeepSeek Harness) Web Host default base URL. */
+export declare const DEFAULT_DSH_HOST = "http://127.0.0.1:3080";
+/** DSH (DeepSeek Harness) Web Host connection config. */
+declare const DshConfigSchema: z.ZodObject<{
+    host: z.ZodDefault<z.ZodString>;
+    agentPreset: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    reasoningEffort: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const AppConfigSchema: z.ZodObject<{
     feishu: z.ZodObject<{
         appId: z.ZodString;
@@ -201,6 +212,12 @@ export declare const AppConfigSchema: z.ZodObject<{
                 turnIdleTimeoutMinutes: z.ZodDefault<z.ZodNumber>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
+        dsh: z.ZodOptional<z.ZodObject<{
+            host: z.ZodDefault<z.ZodString>;
+            agentPreset: z.ZodOptional<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            reasoningEffort: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     agentChoices: z.ZodOptional<z.ZodObject<{
         codex: z.ZodOptional<z.ZodObject<{
@@ -220,6 +237,9 @@ 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>;
@@ -248,6 +268,7 @@ export declare const AppConfigSchema: z.ZodObject<{
         opencode: "opencode";
         pi: "pi";
         kimi: "kimi";
+        dsh: "dsh";
     }>>;
     checkUpdateOnStartup: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
@@ -299,12 +320,14 @@ type CodexConfig = z.infer<typeof CodexConfigSchema>;
 type OpencodeConfig = z.infer<typeof OpencodeConfigSchema>;
 type PiConfig = z.infer<typeof PiConfigSchema>;
 type KimiConfig = z.infer<typeof KimiConfigSchema>;
+export type DshConfig = z.infer<typeof DshConfigSchema>;
 /** Get configuration for a specific agent. Falls back to defaults if not configured. */
 export declare function getAgentConfig(config: AppConfig, kind: 'claude'): ClaudeConfig;
 export declare function getAgentConfig(config: AppConfig, kind: 'codex'): CodexConfig | undefined;
 export declare function getAgentConfig(config: AppConfig, kind: 'opencode'): OpencodeConfig | undefined;
 export declare function getAgentConfig(config: AppConfig, kind: 'pi'): PiConfig | undefined;
 export declare function getAgentConfig(config: AppConfig, kind: 'kimi'): KimiConfig | undefined;
+export declare function getAgentConfig(config: AppConfig, kind: 'dsh'): DshConfig | undefined;
 /**
  * 从 Claude settings.json 的 env 中读取所有以 MODEL 结尾的环境变量值，
  * 返回去重后的模型 ID 列表。

package/dist/config/index.js

@@ -13,6 +13,8 @@ export const CLAUDE_EFFORTS = ['low', 'medium', 'high', 'xhigh', 'max'];
  * Claude 官方 --permission-mode 枚举（claude --help 输出，2026-08 实测）。
  * 额外支持 'default'：Claude settings.json 的官方未设置值，等价于不传
  * --permission-mode（交互式默认：高风险工具逐个询问）。
+ * 'manual' 是 'default' 的别名（claude CLI 等价），schema 保留以向后兼容旧配置，
+ * 但 UI 下拉不展示（见 router/config/claude.ts）。
  */
 export const CLAUDE_PERMISSION_MODES = [
     'default',
@@ -30,7 +32,9 @@ const DEFAULTS = {
     CLAUDE_MODEL: 'claude-opus-4-8',
     STOP_GRACE_MS: 5000,
     IDLE_WATCHDOG_MINUTES: 15,
-    TURN_IDLE_TIMEOUT_MINUTES: 10,
+    /** ACP/app-server turn idle 超时默认 30 分钟：Kimi/opencode/codex 常因
+     *  等待 SubAgent 或长思考长时间静默，10 分钟会误杀正常进行中的 run。 */
+    TURN_IDLE_TIMEOUT_MINUTES: 30,
     /** 审批超时默认 5 分钟（对齐 codex 红线：勿随意改短）。 */
     APPROVAL_TIMEOUT_MS: 5 * 60 * 1000,
     /** Claude 会话级空闲回收默认 30 分钟（对齐 codex appServer.idleTtlMs）。 */
@@ -157,6 +161,27 @@ const KimiConfigSchema = z.object({
     })
         .optional(),
 });
+/** DSH (DeepSeek Harness) Web Host default base URL. */
+export const DEFAULT_DSH_HOST = 'http://127.0.0.1:3080';
+/** DSH (DeepSeek Harness) Web Host connection config. */
+const DshConfigSchema = z.object({
+    /** DSH Web Host base URL (no auth, local). */
+    host: z.string().url().default(DEFAULT_DSH_HOST),
+    /**
+     * Session preset（agentPreset）。preset 在 session 创建时固定，中途切换会被
+     * 服务端拒绝（agent-preset-conflict）。留空 = 跟随服务端默认（不传 agentPreset）。
+     * 枚举不在此硬编码：preset 清单随 DSH profile bundle 变化，合法性由配置卡下拉
+     * 控制 + 运行时 DSH API 报错兜底。
+     */
+    agentPreset: z.string().optional(),
+    /** 模型 ID。留空 = 跟随服务端默认。 */
+    model: z.string().optional(),
+    /**
+     * 推理强度（off / low / high / max，跟随 llm.models 实际档位）。留空 = 跟随
+     * 服务端默认。枚举不硬编码（理由同上 agentPreset）。
+     */
+    reasoningEffort: z.string().optional(),
+});
 /** 首次启动的默认 agents 配置：codex 默认 app-server / on-request / workspace-write。 */
 const DEFAULT_AGENTS_CONFIG = {
     codex: CodexConfigSchema.parse({}),
@@ -167,6 +192,7 @@ const AgentsConfigSchema = z.object({
     opencode: OpencodeConfigSchema.optional(),
     pi: PiConfigSchema.optional(),
     kimi: KimiConfigSchema.optional(),
+    dsh: DshConfigSchema.optional(),
 });
 const IdleConfigSchema = z.object({
     /**
@@ -220,6 +246,11 @@ const AgentChoicesSchema = z.object({
         thinkingEffort: z.string().optional(),
     })
         .optional(),
+    dsh: z
+        .object({
+        host: z.string().optional(),
+    })
+        .optional(),
 });
 export const AppConfigSchema = z.object({
     feishu: FeishuConfigSchema,
@@ -235,7 +266,7 @@ export const AppConfigSchema = z.object({
     /** 入站媒体（图片/文件）落盘配置。 */
     inboundMedia: InboundMediaConfigSchema.default(InboundMediaConfigSchema.parse({})),
     /** Default agent for new runs. */
-    defaultAgent: z.enum(['claude', 'codex', 'opencode', 'pi', 'kimi']).default('claude'),
+    defaultAgent: z.enum(['claude', 'codex', 'opencode', 'pi', 'kimi', 'dsh']).default('claude'),
     /** Check for updates on bridge startup (default: false). */
     checkUpdateOnStartup: z.boolean().default(false),
 });
@@ -288,7 +319,7 @@ export function loadConfig(configPath) {
  * Agent key 前缀，这些前缀的 key 会映射到 `agents.<key>` 路径下。
  * `claude.` 保持顶层（不映射到 agents.claude）。
  */
-const AGENT_PREFIXES = ['pi', 'codex', 'opencode', 'kimi'];
+const AGENT_PREFIXES = ['pi', 'codex', 'opencode', 'kimi', 'dsh'];
 /**
  * 将卡片短 key 映射到 schema 期望的路径：
  *   pi.xxx       → agents.pi.xxx

package/dist/index.js

@@ -3,13 +3,14 @@ import { resolveAgentChoices, } from './runner/index.js';
 import { ensureConfig } from './config/wizard.js';
 import { parseCliArgs, resolveConfigDir, setConfigDir, printHelp, printVersion, } from './config/dir.js';
 import { FeishuConnector } from './connector/index.js';
-import { ClaudeRunner, CodexAppServerRunner, OpencodeAcpRunner, PiRpcRunner, KimiAcpRunner, } from './runner/index.js';
+import { ClaudeRunner, CodexAppServerRunner, OpencodeAcpRunner, PiRpcRunner, KimiAcpRunner, DshRunner, } from './runner/index.js';
 import { AgentRegistry } from './runner/registry.js';
 import { probeAllAgents } from './runner/probe.js';
 import { SessionReaderRegistry, SessionStore } from './session/index.js';
-import { ClaudeSessionReader, CodexSessionReader, OpencodeSessionReader, PiSessionReader, KimiSessionReader, } from './session/index.js';
+import { ClaudeSessionReader, CodexSessionReader, OpencodeSessionReader, PiSessionReader, KimiSessionReader, DshSessionReader, } from './session/index.js';
 import { CommandRouter, isImmediateAction } from './router/index.js';
 import { dispatchOrderExecForQueue } from './router/order-exec-dispatch.js';
+import { buildCardActionFullValue } from './router/card-action-payload.js';
 import { Bridge } from './bridge/index.js';
 import { initLogger, getLogger } from './logger/index.js';
 import { StartupContactStore, sendStartupHello } from './startup-contact.js';
@@ -238,12 +239,33 @@ function initializeRunner(config, configDir, cliArgs) {
         });
     });
     sessionReaderRegistry.register('kimi', kimiSessionReader);
+    // Register DshRunner (HTTP-only DSH Web Host agent) and DshSessionReader.
+    const dshSessionReader = new DshSessionReader({
+        host: getAgentConfig(config, 'dsh')?.host,
+    });
+    agentRegistry.register('dsh', (_ws) => {
+        // Read latest config from container so /config host changes take effect
+        // after bridge.setConfig() + clearRunners().
+        const container = agentRegistry.getConfigContainer();
+        const latestConfig = container?.current ?? config;
+        const dshConf = getAgentConfig(latestConfig, 'dsh');
+        return new DshRunner({
+            kind: 'dsh',
+            sessionReader: dshSessionReader,
+            host: dshConf?.host,
+            agentPreset: dshConf?.agentPreset,
+            model: dshConf?.model,
+            reasoningEffort: dshConf?.reasoningEffort,
+        });
+    });
+    sessionReaderRegistry.register('dsh', dshSessionReader);
     // 2026-07-17: 注册所有 agent 的显示名，实现单点真相
     agentRegistry.registerDisplayName('claude', 'Claude');
     agentRegistry.registerDisplayName('codex', 'Codex');
     agentRegistry.registerDisplayName('opencode', 'Opencode');
     agentRegistry.registerDisplayName('pi', 'Pi');
     agentRegistry.registerDisplayName('kimi', 'Kimi');
+    agentRegistry.registerDisplayName('dsh', 'DSH');
     // 设置全局 registry，供 agentDisplayName 等全局函数使用
     AgentRegistry.setGlobalInstance(agentRegistry);
     // Probe agent CLI availability (fire-and-forget, populates cache for /config card).
@@ -493,18 +515,10 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
         }
         const isImmediate = isImmediateAction(actionValue.cmd);
         const workspace = sessionStore.getCwd(userId) ?? '';
-        // Build full value object — spread all fields from actionValue,
-        // then override option/formValue/inputValue from action for CardKit 2.0 compatibility.
-        // 2026-07-04: inputValue 来自 CardKit 2.0 input 组件自带提交图标触发 callback
-        const fullValue = {
-            ...actionValue,
-            option: action.action.option,
-            formValue: action.action.formValue,
-            // CardKit 2.0 input ✓ 提交图标：输入值走 raw.action.input_value（SDK normalizer
-            // 丢弃 action.action.input_value，需 connector includeRawEvent: true）。
-            inputValue: action.raw?.action?.input_value ??
-                action.action.input_value,
-        };
+        // Build full value object — spread all fields from actionValue, then merge
+        // component out-of-band fields (option/formValue/inputValue/options) where
+        // present. See card-action-payload.ts for the component-type contract.
+        const fullValue = buildCardActionFullValue(actionValue, action);
         // queue.input / config.save / approval.respond / approval.toggle /
         // approval.answer 系列返回 CardActionResponse toast 给点击用户即时反馈。
         // 必须直接返回值 -- enqueueImmediate / enqueueConfigAction 是

package/dist/router/card-action-payload.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Card action payload assembly (entry layer).
+ *
+ * Feishu card callbacks arrive as a normalized `CardActionEvent` whose
+ * `action` only carries `value/tag/name/option/formValue` — the
+ * `@larksuite/channel` normalizer drops everything else (e.g. `input_value`,
+ * multi-select `options`). This module rebuilds the full payload that the
+ * router consumes, merging the button's behavior `value` with component
+ * out-of-band fields.
+ *
+ * Extracted from src/index.ts so the entry transform is behavior-testable
+ * (the main() wiring itself cannot be injected, see index-wiring.test.ts).
+ */
+import type { CardActionEvent } from '@larksuite/channel';
+import type { CardActionPayload } from './index.js';
+/**
+ * Build the full card action payload for router.handleCardAction.
+ *
+ * - `option`/`formValue`: select/form components deliver the user's choice
+ *   out-of-band in `action.option`/`action.formValue`; button callbacks carry
+ *   it in the behavior `value` instead (and `action.option` is absent). The
+ *   behavior-value field must survive for buttons, so the component field
+ *   only wins when it is actually present.
+ * - `inputValue`: CardKit 2.0 input submit-icon callbacks deliver the text in
+ *   the raw event (`action.raw.action.input_value`); the SDK normalizer drops
+ *   `action.action.input_value`.
+ * - `options`: reserved for multi-select components (future agent support);
+ *   the SDK normalizer drops `action.options`, so it is read from raw.
+ */
+export declare function buildCardActionFullValue(actionValue: CardActionPayload, action: CardActionEvent): CardActionPayload;

package/dist/router/card-action-payload.js

@@ -0,0 +1,39 @@
+/**
+ * Card action payload assembly (entry layer).
+ *
+ * Feishu card callbacks arrive as a normalized `CardActionEvent` whose
+ * `action` only carries `value/tag/name/option/formValue` — the
+ * `@larksuite/channel` normalizer drops everything else (e.g. `input_value`,
+ * multi-select `options`). This module rebuilds the full payload that the
+ * router consumes, merging the button's behavior `value` with component
+ * out-of-band fields.
+ *
+ * Extracted from src/index.ts so the entry transform is behavior-testable
+ * (the main() wiring itself cannot be injected, see index-wiring.test.ts).
+ */
+/**
+ * Build the full card action payload for router.handleCardAction.
+ *
+ * - `option`/`formValue`: select/form components deliver the user's choice
+ *   out-of-band in `action.option`/`action.formValue`; button callbacks carry
+ *   it in the behavior `value` instead (and `action.option` is absent). The
+ *   behavior-value field must survive for buttons, so the component field
+ *   only wins when it is actually present.
+ * - `inputValue`: CardKit 2.0 input submit-icon callbacks deliver the text in
+ *   the raw event (`action.raw.action.input_value`); the SDK normalizer drops
+ *   `action.action.input_value`.
+ * - `options`: reserved for multi-select components (future agent support);
+ *   the SDK normalizer drops `action.options`, so it is read from raw.
+ */
+export function buildCardActionFullValue(actionValue, action) {
+    return {
+        ...actionValue,
+        option: action.action.option ?? actionValue.option,
+        formValue: action.action.formValue ?? actionValue.formValue,
+        options: action.raw?.action?.options ??
+            actionValue.options,
+        inputValue: action.raw?.action?.input_value ??
+            action.action.input_value,
+    };
+}
+//# sourceMappingURL=card-action-payload.js.map

package/dist/router/config/claude.js

@@ -11,11 +11,14 @@ const PERMISSION_MODE_LABELS = {
     acceptEdits: '自动接受文件编辑',
     auto: '自动放行低风险操作',
     bypassPermissions: '跳过所有权限检查',
-    manual: '手动审批（default 的别名）',
     dontAsk: '仅预先批准的工具',
     plan: '计划模式（只读探索）',
 };
-const PERMISSION_MODE_OPTIONS = CLAUDE_PERMISSION_MODES.map((m) => ({
+/**
+ * 下拉选项排除 manual：manual 是 default 的别名（claude CLI 等价），
+ * 只保留 default 一个，避免下拉出现两个等价项。schema 仍接受 manual（旧配置向后兼容）。
+ */
+const PERMISSION_MODE_OPTIONS = CLAUDE_PERMISSION_MODES.filter((m) => m !== 'manual').map((m) => ({
     text: `${m}（${PERMISSION_MODE_LABELS[m] ?? ''}）`,
     value: m,
 }));
@@ -78,12 +81,14 @@ export class ClaudeConfigBuilder {
         // 权限模式（Claude 官方 --permission-mode 枚举；bypassPermissions 为 schema 默认，
         // 保持旧行为无审批卡，配置为其他值后激活交互式审批）
         const currentPermissionMode = displayConfig.claude?.permissionMode ?? 'bypassPermissions';
+        // manual 是 default 的别名：旧配置按 default 显示（下拉无 manual 项，避免空选）
+        const displayedPermissionMode = currentPermissionMode === 'manual' ? 'default' : currentPermissionMode;
         fields.push({
             key: 'claude.permissionMode',
             label: '权限模式',
             type: 'select',
             options: PERMISSION_MODE_OPTIONS,
-            currentValue: currentPermissionMode,
+            currentValue: displayedPermissionMode,
         });
         return fields;
     }

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;
+}