feat(model): 支持单次对话指定模型功能

添加模型切换功能，允许在单次对话中临时使用指定模型。主要修改包括：
- 在多个类型定义中添加 modelId 字段
- 新增 getModelById 工具函数
- 实现模型切换逻辑
- 添加 /model once 命令支持
- 在 Agent 类中实现模型切换能力

Author: echoVic

packages/cli/src/agent/Agent.ts

@@ -19,6 +19,7 @@ import {
   type PermissionConfig,
   PermissionMode,
 } from '../config/index.js';
+import type { ModelConfig } from '../config/types.js';
 import { CompactionService } from '../context/CompactionService.js';
 import { ContextManager } from '../context/ContextManager.js';
 import { HookManager } from '../hooks/HookManager.js';
@@ -49,6 +50,7 @@ function toJsonValue(value: string | object): JsonValue {
   }
 }
 
+
 import { discoverSkills, injectSkillsMetadata } from '../skills/index.js';
 import { SpecManager } from '../spec/SpecManager.js';
 import {
@@ -59,6 +61,7 @@ import {
   getConfig,
   getCurrentModel,
   getMcpServers,
+  getModelById,
   getThinkingModeEnabled,
 } from '../store/vanilla.js';
 import { getBuiltinTools } from '../tools/builtin/index.js';
@@ -111,6 +114,7 @@ export class Agent {
 
   // 当前模型的上下文窗口大小（用于 tokenUsage 上报）
   private currentModelMaxContextTokens!: number;
+  private currentModelId?: string;
 
   constructor(
     config: BladeConfig,
@@ -144,6 +148,57 @@ export class Agent {
     });
   }
 
+  private resolveModelConfig(requestedModelId?: string): ModelConfig {
+    const modelId = requestedModelId && requestedModelId !== 'inherit' ? requestedModelId : undefined;
+    const modelConfig = modelId ? getModelById(modelId) : getCurrentModel();
+    if (!modelConfig) {
+      throw new Error(`❌ 模型配置未找到: ${modelId ?? 'current'}`);
+    }
+    return modelConfig;
+  }
+
+  private async applyModelConfig(modelConfig: ModelConfig, label: string): Promise<void> {
+    this.log(`${label} ${modelConfig.name} (${modelConfig.model})`);
+
+    const modelSupportsThinking = isThinkingModel(modelConfig);
+    const thinkingModeEnabled = getThinkingModeEnabled();
+    const supportsThinking = modelSupportsThinking && thinkingModeEnabled;
+    if (modelSupportsThinking && !thinkingModeEnabled) {
+      this.log(`🧠 模型支持 Thinking，但用户未开启（按 Tab 开启）`);
+    } else if (supportsThinking) {
+      this.log(`🧠 Thinking 模式已启用，启用 reasoning_content 支持`);
+    }
+
+    this.currentModelMaxContextTokens =
+      modelConfig.maxContextTokens ?? this.config.maxContextTokens;
+
+    this.chatService = await createChatServiceAsync({
+      provider: modelConfig.provider,
+      apiKey: modelConfig.apiKey,
+      model: modelConfig.model,
+      baseUrl: modelConfig.baseUrl,
+      temperature: modelConfig.temperature ?? this.config.temperature,
+      maxContextTokens: this.currentModelMaxContextTokens,
+      maxOutputTokens: modelConfig.maxOutputTokens ?? this.config.maxOutputTokens,
+      timeout: this.config.timeout,
+      supportsThinking,
+    });
+
+    const contextManager = this.executionEngine?.getContextManager();
+    this.executionEngine = new ExecutionEngine(this.chatService, contextManager);
+    this.currentModelId = modelConfig.id;
+  }
+
+  private async switchModelIfNeeded(modelId: string): Promise<void> {
+    if (!modelId || modelId === this.currentModelId) return;
+    const modelConfig = getModelById(modelId);
+    if (!modelConfig) {
+      this.log(`⚠️ 模型配置未找到: ${modelId}`);
+      return;
+    }
+    await this.applyModelConfig(modelConfig, '🔁 切换模型');
+  }
+
   /**
    * 快速创建并初始化 Agent 实例（静态工厂方法）
    * 使用 Store 获取配置
@@ -211,43 +266,8 @@ export class Agent {
       await this.discoverSkills();
 
       // 5. 初始化核心组件
-      // 获取当前模型配置（从 Store）
-      const modelConfig = getCurrentModel();
-      if (!modelConfig) {
-        throw new Error('❌ 当前模型配置未找到');
-      }
-
-      this.log(`🚀 使用模型: ${modelConfig.name} (${modelConfig.model})`);
-
-      // 检测模型是否支持 thinking 模式，且用户已开启 thinking 模式
-      const modelSupportsThinking = isThinkingModel(modelConfig);
-      const thinkingModeEnabled = getThinkingModeEnabled();
-      const supportsThinking = modelSupportsThinking && thinkingModeEnabled;
-      if (modelSupportsThinking && !thinkingModeEnabled) {
-        this.log(`🧠 模型支持 Thinking，但用户未开启（按 Tab 开启）`);
-      } else if (supportsThinking) {
-        this.log(`🧠 Thinking 模式已启用，启用 reasoning_content 支持`);
-      }
-
-      // 保存当前模型的上下文窗口大小（用于 tokenUsage 上报）
-      this.currentModelMaxContextTokens =
-        modelConfig.maxContextTokens ?? this.config.maxContextTokens;
-
-      // 使用工厂函数创建 ChatService（根据 provider 选择实现）
-      this.chatService = await createChatServiceAsync({
-        provider: modelConfig.provider,
-        apiKey: modelConfig.apiKey,
-        model: modelConfig.model,
-        baseUrl: modelConfig.baseUrl,
-        temperature: modelConfig.temperature ?? this.config.temperature,
-        maxContextTokens: this.currentModelMaxContextTokens, // 上下文窗口（压缩判断）
-        maxOutputTokens: modelConfig.maxOutputTokens ?? this.config.maxOutputTokens, // 输出限制（API max_tokens）
-        timeout: this.config.timeout,
-        supportsThinking, // 传递 thinking 模式支持标志
-      });
-
-      // 4. 初始化执行引擎
-      this.executionEngine = new ExecutionEngine(this.chatService);
+      const modelConfig = this.resolveModelConfig(this.runtimeOptions.modelId);
+      await this.applyModelConfig(modelConfig, '🚀 使用模型:');
 
       // 5. 初始化附件收集器（@ 文件提及）
       this.attachmentCollector = new AttachmentCollector({
@@ -814,7 +834,6 @@ IMPORTANT: Execute according to the approved plan above. Follow the steps exactl
         // 3. 调用 ChatService（流式或非流式）
         // 默认启用流式，除非显式设置 stream: false
         const isStreamEnabled = options?.stream !== false;
-
         const turnResult = isStreamEnabled
           ? await this.processStreamResponse(messages, tools, options)
           : await this.chatService.chat(messages, tools, options?.signal);
@@ -1335,6 +1354,14 @@ IMPORTANT: Execute according to the approved plan above. Follow the steps exactl
             }
           }
 
+          const modelId =
+            result.metadata?.modelId?.trim() ||
+            result.metadata?.model?.trim() ||
+            undefined;
+          if (modelId) {
+            await this.switchModelIfNeeded(modelId);
+          }
+
           // 添加工具执行结果到消息历史
           let toolResultContent = result.success
             ? result.llmContent || result.displayContent || ''

packages/cli/src/agent/subagents/BackgroundAgentManager.ts

@@ -199,9 +199,12 @@ export class BackgroundAgentManager {
       }
 
       const systemPrompt = config.systemPrompt || '';
+      const modelId =
+        config.model && config.model !== 'inherit' ? config.model : undefined;
       const agent = await Agent.create({
         systemPrompt,
         toolWhitelist: config.tools,
+        modelId,
       });
 
       const context = {

packages/cli/src/agent/subagents/SubagentExecutor.ts

@@ -26,8 +26,13 @@ export class SubagentExecutor {
     try {
       const systemPrompt = this.buildSystemPrompt(context);
 
+      const modelId =
+        this.config.model && this.config.model !== 'inherit'
+          ? this.config.model
+          : undefined;
       const agent = await Agent.create({
         toolWhitelist: this.config.tools,
+        modelId,
       });
 
       let finalMessage = '';

packages/cli/src/agent/types.ts

@@ -58,6 +58,7 @@ export interface AgentOptions {
   permissionMode?: PermissionMode;
   maxTurns?: number; // 最大对话轮次 (-1=无限制, 0=禁用对话, N>0=限制轮次)
   toolWhitelist?: string[]; // 工具白名单（仅允许指定工具）
+  modelId?: string;
 
   // MCP 配置
   mcpConfig?: string[]; // CLI 参数：MCP 配置文件路径或 JSON 字符串数组

packages/cli/src/slash-commands/model.ts

@@ -16,11 +16,13 @@ const modelCommand: SlashCommand = {
   (无参数)        显示模型选择器（交互式切换）
   add            添加新模型配置（交互式向导）
   remove <名称>  删除指定模型配置（按名称匹配）
+  once <模型> <内容>  仅当前轮对话使用指定模型
 
 示例：
   /model              # 显示模型选择器
   /model add          # 添加新模型
   /model remove 千问  # 删除名称包含"千问"的模型
+  /model once claude-sonnet 帮我总结这段代码
   `,
 
   async handler(
@@ -86,6 +88,34 @@ const modelCommand: SlashCommand = {
           return { success: false, message: `❌ ${(error as Error).message}` };
         }
       }
+      case 'once': {
+        const modelQuery = args[1];
+        const prompt = args.slice(2).join(' ').trim();
+        if (!modelQuery || !prompt) {
+          return {
+            success: false,
+            message: '❌ 用法: /model once <模型> <内容>',
+          };
+        }
+        const models = getAllModels();
+        const matched =
+          models.find((m) => m.id === modelQuery) ||
+          models.find((m) => m.name.toLowerCase().includes(modelQuery.toLowerCase()));
+        if (!matched) {
+          return {
+            success: false,
+            message: `❌ 未找到匹配的模型配置: ${modelQuery}`,
+          };
+        }
+        return {
+          success: true,
+          data: {
+            action: 'invoke_once_model',
+            modelId: matched.id,
+            prompt,
+          },
+        };
+      }
 
       default:
         return {

packages/cli/src/slash-commands/types.ts

@@ -16,7 +16,8 @@ type SlashCommandAction =
   | 'show_plugins_manager'
   | 'invoke_skill'
   | 'invoke_custom_command'
-  | 'invoke_plugin_command';
+  | 'invoke_plugin_command'
+  | 'invoke_once_model';
 
 /**
  * Slash command 返回的结构化数据

packages/cli/src/store/vanilla.ts

@@ -172,6 +172,12 @@ export const getCurrentModel = () => {
   return model ?? config.models[0];
 };
 
+export const getModelById = (modelId: string) => {
+  const config = getConfig();
+  if (!config) return undefined;
+  return config.models.find((m) => m.id === modelId);
+};
+
 /**
  * 获取所有 MCP 服务器配置
  */

packages/cli/src/tools/builtin/system/skill.ts

@@ -93,6 +93,12 @@ Important:
       content.instructions,
       content.metadata.basePath
     );
+    const requestedModelId =
+      typeof content.metadata.model === 'string' &&
+      content.metadata.model !== 'inherit' &&
+      content.metadata.model.trim() !== ''
+        ? content.metadata.model
+        : undefined;
 
     // 返回双消息
     return {
@@ -107,6 +113,7 @@ Important:
         version: content.metadata.version,
         // allowed-tools: 限制 Skill 执行期间可用的工具
         allowedTools: content.metadata.allowedTools,
+        modelId: requestedModelId,
       },
     };
   },

packages/cli/src/tools/types/ToolTypes.ts

@@ -29,6 +29,8 @@ interface BaseMetadataFields {
   summary?: string;
   shouldExitLoop?: boolean;
   targetMode?: PermissionMode;
+  modelId?: string;
+  model?: string;
 }
 
 /**

packages/cli/src/ui/hooks/useAgent.ts

@@ -11,6 +11,7 @@ export interface AgentOptions {
   systemPrompt?: string;
   appendSystemPrompt?: string;
   maxTurns?: number;
+  modelId?: string;
 }
 
 /**
@@ -29,12 +30,13 @@ export function useAgent(options: AgentOptions) {
   /**
    * 创建并设置 Agent 实例
    */
-  const createAgent = useMemoizedFn(async (): Promise<Agent> => {
+  const createAgent = useMemoizedFn(async (overrides?: Partial<AgentOptions>): Promise<Agent> => {
     // 创建新 Agent
     const agent = await Agent.create({
-      systemPrompt: options.systemPrompt,
-      appendSystemPrompt: options.appendSystemPrompt,
-      maxTurns: options.maxTurns,
+      systemPrompt: overrides?.systemPrompt ?? options.systemPrompt,
+      appendSystemPrompt: overrides?.appendSystemPrompt ?? options.appendSystemPrompt,
+      maxTurns: overrides?.maxTurns ?? options.maxTurns,
+      modelId: overrides?.modelId ?? options.modelId,
     });
     agentRef.current = agent;