Files
Thing/src-tauri/src/ai/settings.rs
T
2026-09-25 18:23:56 +08:00

214 lines
8.5 KiB
Rust
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
//! 全局 AI 供应商配置(主应用设置)。
//!
//! 持久化位置:`{app_data_dir}/ai/settings.json`。
//! 容器级 `#[serde(default)]`:新增字段对旧配置文件向后兼容。
//!
//! 设计边界(对齐主流桌面 Agent 的「模型/连接」设置):
//! - **本模块只管引擎本身**:Base URL、模型、密钥、最大输出、最大上下文等
//! 与具体调用场景无关的连接与生成参数。
//! - **模块自己的参数留在各模块**:翻译的优先级 / 超时 / 提示词覆盖在
//! translate 设置里(`TranslateAiParams`),终端等调用方自带超时与 system prompt。
//!
//! 安全姿态:**API Key 不在这里**。明文一律进系统凭据管理器,
//! 键名约定 `ai-provider-<id>`(见 [`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<String>,
/// 是否支持图像输入(多模态能力声明;截图翻译「视觉直传」只发给勾选了此项的供应商)
#[serde(default)]
pub supports_vision: bool,
// ===== 旧字段:只读入历史 JSON,迁移后写到 translate.aiParams,不再序列化 =====
/// 旧:供应商级优先级(历史键 `priority`)
#[serde(default, alias = "priority", skip_serializing)]
pub legacy_priority: Option<i32>,
/// 旧:供应商级超时(历史键 `timeoutMs`)
#[serde(default, alias = "timeoutMs", skip_serializing)]
pub legacy_timeout_ms: Option<u64>,
/// 旧:翻译 system prompt 覆盖(历史键 `systemPrompt`)
#[serde(default, alias = "systemPrompt", skip_serializing)]
pub legacy_system_prompt: Option<String>,
}
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<AiProviderConfig>,
/// 默认供应商 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
}
}