lark-remote 0.1.7 → 0.1.9

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,39 @@ function initializeRunner(config, configDir, cliArgs) {
         });
     });
     sessionReaderRegistry.register('kimi', kimiSessionReader);
+    // Register DshRunner (HTTP-only DSH Web Host agent) and DshSessionReader.
+    const dshSessionReader = new DshSessionReader({
+        // hostProvider 每次调用读最新 config：/config 修改 host 后 runner 重建为
+        // 新 host，reader（/resume、用量、完成卡）也跟随新 host（CC-02）。
+        hostProvider: () => {
+            const container = agentRegistry.getConfigContainer();
+            const latestConfig = container?.current ?? config;
+            return getAgentConfig(latestConfig, '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 +521,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 是
@@ -512,19 +532,24 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
         // 直返列表外，过期/重复 nonce/非法选项等错误 toast 被静默吞掉）。
         // 审批响应尤其不能落串行队列：run 任务占用队列头直到 turn 结束，审批响应
         // 排在后面会形成死锁（run 不结束不执行、run 结束 coordinator 已删响应空转）。
+        // order.aliasInput / order.aliasRemove 也返回 toast，需直返避免被吞。
         if (actionValue.cmd === 'queue.input' ||
+            actionValue.cmd === 'order.aliasInput' ||
+            actionValue.cmd === 'order.aliasRemove' ||
             actionValue.cmd === 'config.save' ||
             actionValue.cmd === 'approval.respond' ||
             actionValue.cmd === 'approval.toggle' ||
             actionValue.cmd === 'approval.answer' ||
             actionValue.cmd === 'approval.answerSubmit' ||
-            actionValue.cmd === 'approval.answerCustom') {
+            actionValue.cmd === 'approval.answerCustom' ||
+            actionValue.cmd === 'approval.answerNote') {
             return router.handleCardAction(fullValue, { userId, chatId, messageId });
         }
         // order.exec → equivalent queued message (Plan A): resolve the order text
         // at the enqueue boundary and route it through router.handle, exactly like
         // a hand-typed message. See order-exec-dispatch.ts for the contract and
         // why an internal key replaces the Feishu card messageId.
+        // （order.aliasEdit 是控制动作，走 enqueueImmediate 弹卡即可，不需直返。）
         if (actionValue.cmd === 'order.exec') {
             void dispatchOrderExecForQueue({
                 router,
@@ -636,7 +661,6 @@ async function main() {
         configPath: path.join(configDir, 'config.yaml'),
         workspacePath: path.join(configDir, 'workspace.json'),
         ordersPath: path.join(configDir, 'orders.json'),
-        aliasesPath: path.join(configDir, 'aliases.json'),
         restartSpawner: () => spawnReplacementBridge(path.join(configDir, 'logs')),
         sessionReaderRegistry,
         devMode: cliArgs.dev,

package/dist/order/alias-resolve.d.ts

@@ -1,4 +1,8 @@
-import type { AliasEntry } from './alias-store.js';
+/** 参与别名展开的条目：别名名 + 展开文本（即指令文本）。 */
+export interface AliasResolveEntry {
+    name: string;
+    text: string;
+}
 /**
  * 一次别名展开。
  *
@@ -10,4 +14,4 @@ import type { AliasEntry } from './alias-store.js';
  *
  * @returns 展开后的完整消息；无匹配时返回 undefined。
  */
-export declare function resolveAlias(message: string, aliases: readonly AliasEntry[]): string | undefined;
+export declare function resolveAlias(message: string, aliases: readonly AliasResolveEntry[]): string | undefined;

package/dist/order/index.d.ts

@@ -1,8 +1,10 @@
-interface OrderEntry {
+export interface OrderEntry {
     id: string;
     text: string;
     createdAt: string;
     usedAt?: string;
+    /** 可选别名名（该指令的 $name 触发词）。全局唯一，由 OrderStore 校验。 */
+    alias?: string;
 }
 /**
  * Global persistent order store.
@@ -20,8 +22,13 @@ export declare class OrderStore {
     private persist;
     save(text: string): OrderEntry;
     updateUsedAt(id: string): void;
+    /**
+     * 给指令绑定别名（或解绑）。别名全局唯一，撞名抛错；名称必须通过
+     * `ALIAS_NAME_PATTERN`（字母/数字/下划线、不能数字开头、≤20 字符）。
+     * @returns 绑定后的条目。
+     */
+    setAlias(id: string, name: string | undefined): OrderEntry | undefined;
     get(): OrderEntry[];
     has(id: string): boolean;
     remove(id: string): void;
 }
-export {};

package/dist/order/index.js

@@ -4,6 +4,9 @@ import { atomicWriteJson } from '../persistence/atomic-write.js';
 import { loadJsonFile } from '../persistence/load-json-file.js';
 const MAX_TEXT_LENGTH = 200;
 const MAX_ORDERS = 50;
+/** 别名名称规则：`[A-Za-z_][A-Za-z0-9_]*`，≤20 字符，不能数字开头。 */
+const ALIAS_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const MAX_ALIAS_NAME_LENGTH = 20;
 /**
  * Global persistent order store.
  *
@@ -45,6 +48,11 @@ export class OrderStore {
                 };
                 if (typeof e.usedAt === 'string')
                     entry.usedAt = e.usedAt;
+                if (typeof e.alias === 'string' &&
+                    ALIAS_NAME_PATTERN.test(e.alias) &&
+                    e.alias.length <= MAX_ALIAS_NAME_LENGTH) {
+                    entry.alias = e.alias;
+                }
                 valid.push(entry);
             }
         }
@@ -76,6 +84,31 @@ export class OrderStore {
             this.persist();
         }
     }
+    /**
+     * 给指令绑定别名（或解绑）。别名全局唯一，撞名抛错；名称必须通过
+     * `ALIAS_NAME_PATTERN`（字母/数字/下划线、不能数字开头、≤20 字符）。
+     * @returns 绑定后的条目。
+     */
+    setAlias(id, name) {
+        const entry = this.data.find((e) => e.id === id);
+        if (!entry)
+            return undefined;
+        if (name === undefined || name === '') {
+            delete entry.alias;
+            this.persist();
+            return entry;
+        }
+        if (!ALIAS_NAME_PATTERN.test(name) || name.length > MAX_ALIAS_NAME_LENGTH) {
+            throw new Error(`别名名称只能包含字母/数字/下划线，不能数字开头，且不超过 ${MAX_ALIAS_NAME_LENGTH} 字符`);
+        }
+        const existing = this.data.find((e) => e.id !== id && e.alias === name);
+        if (existing) {
+            throw new Error(`别名 $${name} 已被其他指令占用`);
+        }
+        entry.alias = name;
+        this.persist();
+        return entry;
+    }
     get() {
         return [...this.data];
     }

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

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），同组内保持本顺序。
  */