//! 全局 AI 供应商配置(主应用设置)。 //! //! 持久化位置:`{app_data_dir}/ai/settings.json`。 //! 容器级 `#[serde(default)]`:新增字段对旧配置文件向后兼容。 //! //! 设计边界(对齐主流桌面 Agent 的「模型/连接」设置): //! - **本模块只管引擎本身**:Base URL、模型、密钥、最大输出、最大上下文等 //! 与具体调用场景无关的连接与生成参数。 //! - **模块自己的参数留在各模块**:翻译的优先级 / 超时 / 提示词覆盖在 //! translate 设置里(`TranslateAiParams`),终端等调用方自带超时与 system prompt。 //! //! 安全姿态:**API Key 不在这里**。明文一律进系统凭据管理器, //! 键名约定 `ai-provider-`(见 [`super::provider_secret_key`])。 use serde::{Deserialize, Serialize}; use specta::Type; /// 通用对话默认超时(毫秒)。供应商级超时已下沉到翻译等模块。 pub const DEFAULT_CHAT_TIMEOUT_MS: u64 = 60_000; /// 最大输出(completion tokens)默认值与可选档位(上限 128K)。 pub const DEFAULT_MAX_OUTPUT: u32 = 8_192; #[allow(dead_code)] // 档位表与前端 AI_PRESETS / Select 选项保持一致,供后续命令校验复用 pub const MAX_OUTPUT_OPTIONS: [u32; 6] = [4_096, 8_192, 16_384, 32_768, 65_536, 131_072]; /// 最大上下文(context window tokens)默认值与可选档位(上限 1M)。 pub const DEFAULT_MAX_CONTEXT: u32 = 131_072; #[allow(dead_code)] pub const MAX_CONTEXT_OPTIONS: [u32; 6] = [32_768, 65_536, 131_072, 262_144, 524_288, 1_048_576]; /// 单个 AI 供应商实例(OpenAI 兼容端点)。 /// /// 「实例」而非「类型」:同一厂商可配置多份(官方 API 与本地 Ollama 并存)。 /// 翻译、终端助手等模块共用连接与生成参数;场景参数(优先级、超时、提示词) /// 由各模块自行维护。 #[derive(Debug, Clone, Serialize, Deserialize, Type)] #[serde(rename_all = "camelCase", default)] pub struct AiProviderConfig { /// 实例唯一标识(同时是凭据键的一部分,创建后不建议修改) pub id: String, /// 展示名称 pub name: String, /// 预设标识:"deepseek" | "openai" | "gemini" | "qwen" | "kimi" | "zhipu" /// | "doubao" | "mimo" | "mistral" | "groq" | "openrouter" | "siliconflow" /// | "ollama" | "lmstudio" | "custom" … pub preset: String, /// 是否启用(关闭后各模块不再把此供应商当候选) pub enabled: bool, /// API 根地址(末尾可有可无 /,不可含 /chat/completions) pub base_url: String, /// 模型标识 pub model: String, /// 采样温度 pub temperature: f64, /// 最大输出 tokens(completion 上限,对齐 Agent 常见的「回答长度」) pub max_tokens: u32, /// 最大上下文窗口 tokens(模型可接受的输入+输出规模,供调用方截断与展示) pub max_context: u32, /// 额外请求体字段的 JSON 文本(thinking / enable_thinking 等非标准参数) pub extra_body: Option, /// 是否支持图像输入(多模态能力声明;截图翻译「视觉直传」只发给勾选了此项的供应商) #[serde(default)] pub supports_vision: bool, // ===== 旧字段:只读入历史 JSON,迁移后写到 translate.aiParams,不再序列化 ===== /// 旧:供应商级优先级(历史键 `priority`) #[serde(default, alias = "priority", skip_serializing)] pub legacy_priority: Option, /// 旧:供应商级超时(历史键 `timeoutMs`) #[serde(default, alias = "timeoutMs", skip_serializing)] pub legacy_timeout_ms: Option, /// 旧:翻译 system prompt 覆盖(历史键 `systemPrompt`) #[serde(default, alias = "systemPrompt", skip_serializing)] pub legacy_system_prompt: Option, } impl Default for AiProviderConfig { fn default() -> Self { Self { id: String::new(), name: String::new(), preset: "custom".to_string(), enabled: true, base_url: String::new(), model: String::new(), temperature: 0.3, max_tokens: DEFAULT_MAX_OUTPUT, max_context: DEFAULT_MAX_CONTEXT, extra_body: None, supports_vision: false, legacy_priority: None, legacy_timeout_ms: None, legacy_system_prompt: None, } } } impl AiProviderConfig { /// 内置 DeepSeek 预设:默认供应商。模型标识取现行名 `deepseek-flash` /// (`deepseek-chat` / `deepseek-reasoner` 已于 2026-07-24 停用)。 /// /// 其余预设只在前端 `AI_PRESETS`(`src/types/ai.ts`)维护模板; /// 后端不硬编码供应商清单——预设标识只是个字符串,谁来加都行。 pub fn deepseek_default() -> Self { Self { id: "deepseek".to_string(), name: "DeepSeek Flash".to_string(), preset: "deepseek".to_string(), enabled: true, base_url: "https://api.deepseek.com".to_string(), model: "deepseek-flash".to_string(), temperature: 0.3, max_tokens: DEFAULT_MAX_OUTPUT, max_context: DEFAULT_MAX_CONTEXT, extra_body: None, supports_vision: false, legacy_priority: None, legacy_timeout_ms: None, legacy_system_prompt: None, } } /// 取出旧场景参数(若历史 JSON 带有 priority/timeoutMs/systemPrompt)。 pub fn take_legacy(&mut self) -> Option<(i32, u64, String)> { let p = self.legacy_priority.take(); let t = self.legacy_timeout_ms.take(); let s = self.legacy_system_prompt.take(); match (p, t, s) { (None, None, None) => None, (p, t, s) => Some(( p.unwrap_or(100), t.unwrap_or(30_000), s.unwrap_or_default(), )), } } } /// 全局 AI 设置根结构。 #[derive(Debug, Clone, Serialize, Deserialize, Type)] #[serde(rename_all = "camelCase", default)] pub struct AiSettings { /// 结构版本号:1 = 含供应商级场景参数;2 = 场景参数下沉到各模块 pub version: u32, /// 供应商实例列表 pub providers: Vec, /// 默认供应商 id("auto" 表示不指定;主要给终端等简单消费方) pub default_provider_id: String, /// AI 请求是否走代理模块(mihomo mixed 端口)。 /// 默认关闭:DeepSeek 等境内可直连;境外服务由用户显式打开。 pub use_proxy: bool, } impl Default for AiSettings { fn default() -> Self { Self { version: 2, providers: vec![AiProviderConfig::deepseek_default()], default_provider_id: "deepseek".to_string(), use_proxy: false, } } } impl AiSettings { /// 按 id 找供应商实例。 pub fn provider(&self, id: &str) -> Option<&AiProviderConfig> { self.providers.iter().find(|p| p.id == id) } /// 自愈:列表为空时补回 DeepSeek;默认 id 失效时回落到「自动」; /// 输出/上下文越界时夹回档位上限;版本推进到 2。 /// 返回是否发生了变更(由调用方决定落盘)。 pub fn heal(&mut self) -> bool { let mut changed = false; if self.providers.is_empty() { self.providers.push(AiProviderConfig::deepseek_default()); changed = true; } for p in &mut self.providers { if p.max_tokens == 0 { p.max_tokens = DEFAULT_MAX_OUTPUT; changed = true; } if p.max_context == 0 { p.max_context = DEFAULT_MAX_CONTEXT; changed = true; } if p.max_tokens > 131_072 { p.max_tokens = 131_072; changed = true; } if p.max_context > 1_048_576 { p.max_context = 1_048_576; changed = true; } } if self.default_provider_id.trim().is_empty() { self.default_provider_id = "auto".to_string(); changed = true; } if self.default_provider_id != "auto" && self.provider(&self.default_provider_id).is_none() { self.default_provider_id = "auto".to_string(); changed = true; } if self.version < 2 { self.version = 2; changed = true; } changed } }