//! 历史配置的一次性迁移:把「AI 引擎曾经存在翻译设置里」搬进主设置 → AI 服务。 //! //! 为什么这段代码在 translate 而不是 ai:它必须同时读懂两份设置——读 translate 的 //! 引擎列表、写 ai 的供应商列表、还要复制凭据。放在 ai 里等于让 AI 服务反向依赖 //! 业务模块;放在消费方(translate→ai 本来就是合法方向)则两边都不别扭。 //! //! 由 `setup::init` 在注册 State 之前调用一次(必须早于任何 `AiManager::load_settings` //! 的缓存预热,否则会出现「刚迁完,但缓存里还是旧值」的短窗口)。 //! //! 两件事: //! 1. **搬引擎**:`ai/settings.json` 不存在且 translate 里有 `kind = "ai"` 的引擎时, //! 把它们转成 AI 供应商(连同 `translate-engine-*` → `ai-provider-*` 的密钥复制), //! 并从 translate 设置里移除,改为写入 `aiParams`(翻译侧的场景参数)。 //! 2. **下沉场景字段**:`ai/settings.json` 里残留的 `priority` / `timeoutMs` / //! `systemPrompt`(曾是供应商字段,后改为翻译侧参数)搬到 `translate.aiParams`。 //! 没有旧字段时是空操作。 use std::path::{Path, PathBuf}; use crate::ai::{AiProviderConfig, AiSettings, DEFAULT_MAX_CONTEXT}; use super::settings::{TranslateAiParams, TranslateSettings}; use super::engine_secret_key; /// 执行一次性迁移。失败只记日志——迁移是「让老配置继续可用」的尽力而为, /// 不该因为一次写盘失败就让应用起不来(用户仍可在设置页手动重建)。 pub fn migrate_legacy_ai_engines(data_dir: &Path) { if !ai_settings_path(data_dir).exists() { migrate_engines(data_dir); } // 与搬引擎分开判断:残留字段可能出现在「ai/settings.json 已存在」的机器上 drain_legacy_params(data_dir); } fn ai_settings_path(data_dir: &Path) -> PathBuf { data_dir.join("ai").join("settings.json") } fn translate_settings_path(data_dir: &Path) -> PathBuf { data_dir.join("translate").join("settings.json") } /// 把 translate 设置里的 `kind = "ai"` 引擎搬成 AI 供应商。 fn migrate_engines(data_dir: &Path) { let translate_path = translate_settings_path(data_dir); let Ok(raw) = std::fs::read_to_string(&translate_path) else { // 没有旧配置:无需迁移 return; }; let Ok(mut translate) = serde_json::from_str::(&raw) else { crate::logger::log_warn( "ai", "translate/settings.json 无法解析,跳过 AI 引擎迁移,使用默认 AI 配置", ); return; }; let (ai_engines, free_engines): (Vec<_>, Vec<_>) = translate .engines .iter() .cloned() .partition(|e| e.kind == "ai"); if ai_engines.is_empty() { return; } let providers: Vec = ai_engines .iter() .map(|e| AiProviderConfig { id: e.id.clone(), name: e.name.clone(), preset: e.preset.clone(), enabled: e.enabled, base_url: e.base_url.clone(), model: e.model.clone(), temperature: e.temperature, max_tokens: e.max_tokens.clamp(1, 131_072), max_context: if e.max_tokens > 0 { // 旧配置没有上下文字段:用输出上限的常见比例推一个合法档位 e.max_tokens.clamp(32_768, 1_048_576) } else { DEFAULT_MAX_CONTEXT }, extra_body: e.extra_body.clone(), supports_vision: e.supports_vision, legacy_priority: None, legacy_timeout_ms: None, legacy_system_prompt: None, }) .collect(); // 翻译场景参数(启用 / 优先级 / 超时 / 提示词覆盖)留在翻译设置 let ai_params: Vec = ai_engines .iter() .map(|e| TranslateAiParams { provider_id: e.id.clone(), enabled: e.enabled, priority: e.priority, timeout_ms: e.timeout_ms, system_prompt: e.system_prompt.clone(), }) .collect(); // 凭据复制:旧键 `translate-engine-*` → 新键 `ai-provider-*`。 // 复制失败只记日志(AI 侧不再回退读旧键,用户需在设置页重填一次)。 for e in &ai_engines { let old = engine_secret_key(&e.id); let new = crate::ai::provider_secret_key(&e.id); let value = crate::secrets::read_or_empty(&old); if value.trim().is_empty() { continue; } if crate::secrets::read_or_empty(&new).trim().is_empty() { if let Err(err) = crate::secrets::secret_write(&new, &value) { crate::logger::log_warn( "ai", &format!( "迁移引擎「{}」的密钥失败,需在 AI 服务中重新填写: {err}", e.id ), ); } } } let default_id = translate.default_engine_id.clone(); let mut ai_settings = AiSettings { version: 2, providers, default_provider_id: if default_id != "auto" && ai_engines.iter().any(|e| e.id == default_id) { default_id } else { "auto".to_string() }, use_proxy: translate.use_proxy, }; ai_settings.heal(); // translate 侧:移除 AI 引擎、写入场景参数;默认引擎指向已搬走的实例时改为「自动」 translate.engines = free_engines; // 合并:已有 ai_params(重复迁移防御)+ 本次搬入的 for p in ai_params { if !translate .ai_params .iter() .any(|x| x.provider_id == p.provider_id) { translate.ai_params.push(p); } } if translate.default_engine_id != "auto" && !translate .engines .iter() .any(|e| e.id == translate.default_engine_id) && !translate .ai_params .iter() .any(|p| p.provider_id == translate.default_engine_id) { translate.default_engine_id = "auto".to_string(); } if let Err(err) = crate::ai::write_settings(data_dir, &ai_settings) { crate::logger::log_error("ai", &format!("迁移写入 AI 设置失败: {err}")); return; } match serde_json::to_string_pretty(&translate) { Ok(json) => match write_translate_settings(data_dir, &json) { Ok(()) => crate::logger::log_info( "ai", &format!( "已从翻译设置迁移 {} 个 AI 引擎到主设置", ai_settings.providers.len() ), ), Err(err) => crate::logger::log_error("ai", &err), }, Err(err) => crate::logger::log_error("ai", &format!("序列化翻译设置失败: {err}")), } } /// 把 `ai/settings.json` 里残留的旧场景字段搬到 `translate.aiParams` 并两边落盘。 fn drain_legacy_params(data_dir: &Path) { let Ok(raw) = std::fs::read_to_string(ai_settings_path(data_dir)) else { return; }; let Ok(mut settings) = serde_json::from_str::(&raw) else { return; }; let mut moves: Vec<(String, i32, u64, String)> = Vec::new(); for p in &mut settings.providers { if let Some((priority, timeout_ms, system_prompt)) = p.take_legacy() { moves.push((p.id.clone(), priority, timeout_ms, system_prompt)); } } if moves.is_empty() { return; } let translate_path = translate_settings_path(data_dir); let mut translate = std::fs::read_to_string(&translate_path) .ok() .and_then(|s| serde_json::from_str::(&s).ok()) .unwrap_or_default(); for (provider_id, priority, timeout_ms, system_prompt) in moves { let entry = TranslateAiParams { provider_id: provider_id.clone(), // 旧字段的时代没有「翻译侧启用」这一层,默认视为启用 enabled: true, priority, timeout_ms, system_prompt, }; match translate .ai_params .iter_mut() .find(|p| p.provider_id == provider_id) { Some(slot) => *slot = entry, None => translate.ai_params.push(entry), } } settings.version = 2; if let Err(e) = crate::ai::write_settings(data_dir, &settings) { crate::logger::log_error("ai", &format!("清理旧场景字段后保存失败: {e}")); return; } match serde_json::to_string_pretty(&translate) { Ok(json) => match write_translate_settings(data_dir, &json) { Ok(()) => crate::logger::log_info("ai", "已将 AI 供应商上的旧场景参数迁到翻译设置"), Err(e) => crate::logger::log_error("ai", &e), }, Err(e) => crate::logger::log_error("ai", &format!("序列化翻译设置失败: {e}")), } } /// 回写 translate 设置(启动阶段 TranslateManager 还没建,目录可能也不存在)。 fn write_translate_settings(data_dir: &Path, json: &str) -> Result<(), String> { let root = data_dir.join("translate"); std::fs::create_dir_all(&root).map_err(|e| format!("创建翻译目录失败: {e}"))?; std::fs::write(root.join("settings.json"), json) .map_err(|e| format!("回写 translate/settings.json 失败: {e}")) }