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

246 lines
9.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 引擎曾经存在翻译设置里」搬进主设置 → 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::<TranslateSettings>(&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<AiProviderConfig> = 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<TranslateAiParams> = 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::<AiSettings>(&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::<TranslateSettings>(&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}"))
}