调整
This commit is contained in:
1 parent
79bded1cd2
commit
9e6d73e191
73 files changed
+6229
-1427
No files matched your search
+159
-39
@@ -29,31 +29,32 @@ mod capture;
|
||||
mod commands;
|
||||
mod engines;
|
||||
mod history;
|
||||
mod migrate;
|
||||
mod ocr;
|
||||
mod popup;
|
||||
mod settings;
|
||||
|
||||
pub use commands::{
|
||||
translate_abort, translate_apply_shortcuts, translate_copy_text, translate_engine_delete,
|
||||
translate_engine_models, translate_engine_save, translate_engine_test_config,
|
||||
translate_engines_list,
|
||||
translate_get_settings, translate_history_clear, translate_history_delete,
|
||||
translate_history_list, translate_history_set_favorited, translate_ocr_languages,
|
||||
translate_paste_back, translate_popup_edit_mode, translate_popup_hide,
|
||||
translate_popup_prefs_set, translate_popup_ready, translate_popup_resize,
|
||||
translate_popup_set_pinned, translate_preview_popup, translate_run, translate_save_settings,
|
||||
translate_screenshot_region, translate_secret_clear, translate_secret_set,
|
||||
translate_stream_start,
|
||||
translate_abort, translate_ai_engine_remove, translate_ai_params_save, translate_apply_shortcuts,
|
||||
translate_copy_text,
|
||||
translate_engine_delete, translate_engine_models, translate_engine_save,
|
||||
translate_engine_test_config, translate_engines_list, translate_get_settings,
|
||||
translate_history_clear, translate_history_delete, translate_history_list,
|
||||
translate_history_set_favorited, translate_ocr_languages, translate_paste_back,
|
||||
translate_popup_edit_mode, translate_popup_hide, translate_popup_prefs_set,
|
||||
translate_popup_ready, translate_popup_resize, translate_popup_set_pinned,
|
||||
translate_preview_popup, translate_run, translate_save_settings, translate_screenshot_region,
|
||||
translate_secret_clear, translate_secret_set, translate_stream_start,
|
||||
};
|
||||
pub use engines::{TranslateEngine, TranslateError, TranslateResult};
|
||||
// 只再导出本模块内部(mod.rs / commands.rs / popup.rs)实际用到的类型。其余类型仍保留在
|
||||
// `engines::` / `settings::` 下,等真正用到时再提升到此处——提前摆出一堆无人消费的再导出,
|
||||
// 只会让「谁在用」更难判断。
|
||||
pub use settings::TranslateSettings;
|
||||
// 终端 AI 助手(terminal/assistant.rs)复用引擎配置与通用对话补全——
|
||||
// 「现在真正用到了」,按上面的原则提升到此处。
|
||||
pub use settings::TranslateEngineConfig;
|
||||
pub use engines::ai::chat_once;
|
||||
// TranslateEngineConfig / TranslateAiParams 供命令层、ai 迁移与前端类型共用。
|
||||
pub use settings::{TranslateAiParams, TranslateEngineConfig};
|
||||
// 启动阶段的一次性迁移(把旧版存在翻译设置里的 AI 引擎搬进主设置 → AI 服务)。
|
||||
pub use migrate::migrate_legacy_ai_engines;
|
||||
|
||||
use engines::EngineRequest;
|
||||
use std::path::PathBuf;
|
||||
@@ -71,7 +72,7 @@ const PROXY_CACHE_TTL: Duration = Duration::from_millis(5000);
|
||||
/// 引擎 API Key 的凭据键前缀(键名格式:`translate-engine-<engineId>`)。
|
||||
const ENGINE_KEY_PREFIX: &str = "translate-engine-";
|
||||
|
||||
/// 某引擎实例的凭据键。
|
||||
/// 某引擎实例的凭据键(free/cloud 源使用;AI 供应商用 `ai-provider-<id>`)。
|
||||
pub fn engine_secret_key(engine_id: &str) -> String {
|
||||
format!("{ENGINE_KEY_PREFIX}{engine_id}")
|
||||
}
|
||||
@@ -85,13 +86,53 @@ pub fn init_on_launch(app: &tauri::AppHandle) {
|
||||
}
|
||||
|
||||
/// 读取某引擎实例的 API Key(未配置或读取失败 → 空串)。
|
||||
///
|
||||
/// AI 引擎(kind = "ai")的密钥在 `ai-provider-*`,走 [`crate::ai::provider_api_key`];
|
||||
/// free/cloud 读本模块的 `translate-engine-*`。两条路径互不通气——AI 侧不认识旧键,
|
||||
/// 密钥由 [`migrate_legacy_ai_engines`] 一次性复制过去。
|
||||
pub fn engine_api_key(engine_id: &str) -> String {
|
||||
engine_api_key_with_kind(engine_id, None)
|
||||
}
|
||||
|
||||
/// 按 kind 读取密钥。`kind_hint` 为 Some("ai") 时走 AI 凭据键。
|
||||
pub fn engine_api_key_with_kind(engine_id: &str, kind_hint: Option<&str>) -> String {
|
||||
if engine_id.trim().is_empty() {
|
||||
return String::new();
|
||||
}
|
||||
if kind_hint == Some("ai") {
|
||||
return crate::ai::provider_api_key(engine_id);
|
||||
}
|
||||
crate::secrets::read_or_empty(&engine_secret_key(engine_id))
|
||||
}
|
||||
|
||||
/// 把全局 AI 供应商转换为翻译引擎配置(kind = "ai")。
|
||||
///
|
||||
/// 连接与生成参数来自 AI 侧;**启用 / 优先级 / 超时 / 提示词覆盖**来自翻译设置的
|
||||
/// [`TranslateAiParams`](场景参数归翻译管)。翻译候选与视觉直译都消费转换后的结果。
|
||||
///
|
||||
/// `enabled` 取两层开关的与:供应商自身关掉(AI 服务里停用)或翻译侧关掉,都不上场。
|
||||
pub fn ai_provider_as_engine(
|
||||
p: &crate::ai::AiProviderConfig,
|
||||
params: &TranslateAiParams,
|
||||
) -> TranslateEngineConfig {
|
||||
TranslateEngineConfig {
|
||||
id: p.id.clone(),
|
||||
name: p.name.clone(),
|
||||
kind: "ai".to_string(),
|
||||
preset: p.preset.clone(),
|
||||
enabled: p.enabled && params.enabled,
|
||||
priority: params.priority,
|
||||
base_url: p.base_url.clone(),
|
||||
model: p.model.clone(),
|
||||
temperature: p.temperature,
|
||||
max_tokens: p.max_tokens,
|
||||
timeout_ms: params.timeout_ms.max(1_000),
|
||||
system_prompt: params.system_prompt.clone(),
|
||||
extra_body: p.extra_body.clone(),
|
||||
supports_vision: p.supports_vision,
|
||||
}
|
||||
}
|
||||
|
||||
struct SettingsCache {
|
||||
read_at: Instant,
|
||||
settings: TranslateSettings,
|
||||
@@ -106,8 +147,10 @@ pub struct TranslateManager {
|
||||
/// 直连客户端
|
||||
client: reqwest::Client,
|
||||
cache: Mutex<Option<SettingsCache>>,
|
||||
/// 代理地址解析缓存:`(解析时刻, 结果)`;结果为 None 表示已开启但不可用
|
||||
proxy_cache: Mutex<Option<(Instant, Option<String>)>>,
|
||||
/// 代理地址解析缓存:`(解析时刻, 是否开启代理, 结果)`。
|
||||
/// 必须把「是否开启」一并缓存:AI 引擎看 AI 服务的开关、free/cloud 看本模块开关,
|
||||
/// 两个值不同却共用一份缓存时,先被解析的一方会把另一方带偏。
|
||||
proxy_cache: Mutex<Option<(Instant, bool, Option<String>)>>,
|
||||
/// 带代理的客户端缓存:`(代理地址, 客户端)`。与地址一一对应,地址变了就重建。
|
||||
proxied_client: Mutex<Option<(String, reqwest::Client)>>,
|
||||
/// 翻译历史。打开失败时为 None:历史是锦上添花,不值得为它让整个模块不可用。
|
||||
@@ -162,7 +205,24 @@ impl TranslateManager {
|
||||
.ok()
|
||||
.and_then(|s| serde_json::from_str::<TranslateSettings>(&s).ok())
|
||||
.unwrap_or_default();
|
||||
let healed = settings.heal();
|
||||
let mut healed = settings.heal();
|
||||
// 默认引擎指向「本模块里没有、也已不在翻译候选里的 AI 供应商」→ 改为「自动」。
|
||||
// 放在 Manager 而不是 settings::heal:那里拿不到 data_dir,读不了 AI 供应商。
|
||||
// 判定必须连 ai_params 一起看:供应商在 AI 服务里存在、但被用户移出翻译候选时,
|
||||
// 它同样不能再当默认引擎。
|
||||
if settings.default_engine_id != "auto"
|
||||
&& settings.engine(&settings.default_engine_id).is_none()
|
||||
{
|
||||
// 只有「已加入翻译候选、且供应商仍存在」的 AI 引擎才保留
|
||||
let still_valid = settings.has_ai_engine(&settings.default_engine_id)
|
||||
&& crate::ai::AiManager::load_settings_sync(&self.data_dir)
|
||||
.provider(&settings.default_engine_id)
|
||||
.is_some();
|
||||
if !still_valid {
|
||||
settings.default_engine_id = "auto".to_string();
|
||||
healed = true;
|
||||
}
|
||||
}
|
||||
if let Ok(mut cache) = self.cache.lock() {
|
||||
*cache = Some(SettingsCache {
|
||||
read_at: Instant::now(),
|
||||
@@ -233,14 +293,16 @@ impl TranslateManager {
|
||||
.is_ok()
|
||||
}
|
||||
|
||||
/// 解析当前应使用的代理地址(带 TTL 缓存)。未开启开关时返回 None。
|
||||
async fn resolve_proxy_url(&self) -> Option<String> {
|
||||
if !self.load_settings().use_proxy {
|
||||
/// 解析当前应使用的代理地址(带 TTL 缓存)。`enabled` 为 false 时直接返回 None。
|
||||
///
|
||||
/// `enabled` 由调用方按引擎归属给出:AI 引擎取 AI 服务的开关,其余取本模块的开关。
|
||||
async fn resolve_proxy_url(&self, enabled: bool) -> Option<String> {
|
||||
if !enabled {
|
||||
return None;
|
||||
}
|
||||
if let Ok(cache) = self.proxy_cache.lock() {
|
||||
if let Some((at, url)) = cache.as_ref() {
|
||||
if at.elapsed() < PROXY_CACHE_TTL {
|
||||
if let Some((at, cached_enabled, url)) = cache.as_ref() {
|
||||
if *cached_enabled == enabled && at.elapsed() < PROXY_CACHE_TTL {
|
||||
return url.clone();
|
||||
}
|
||||
}
|
||||
@@ -259,9 +321,9 @@ impl TranslateManager {
|
||||
};
|
||||
|
||||
if let Ok(mut cache) = self.proxy_cache.lock() {
|
||||
let previous = cache.as_ref().and_then(|(_, u)| u.clone());
|
||||
let previous = cache.as_ref().and_then(|(_, _, u)| u.clone());
|
||||
let changed = previous != resolved;
|
||||
*cache = Some((Instant::now(), resolved.clone()));
|
||||
*cache = Some((Instant::now(), enabled, resolved.clone()));
|
||||
// 地址变了(或可用性变了)就丢弃旧客户端,否则会继续用已失效的代理
|
||||
if changed {
|
||||
if let Ok(mut client) = self.proxied_client.lock() {
|
||||
@@ -275,8 +337,8 @@ impl TranslateManager {
|
||||
/// 选择本次请求使用的 HTTP 客户端:开了代理且可用 → 走代理,否则直连。
|
||||
/// 代理不可用时**静默回退直连**:让请求自己去失败,比在这里造一个错误更接近真相
|
||||
/// (也许代理确实不通但目标站恰好可达)。
|
||||
async fn select_client(&self) -> reqwest::Client {
|
||||
let Some(url) = self.resolve_proxy_url().await else {
|
||||
async fn select_client(&self, use_proxy: bool) -> reqwest::Client {
|
||||
let Some(url) = self.resolve_proxy_url(use_proxy).await else {
|
||||
return self.client.clone();
|
||||
};
|
||||
if let Ok(cache) = self.proxied_client.lock() {
|
||||
@@ -309,13 +371,58 @@ impl TranslateManager {
|
||||
|
||||
// ===== 引擎 =====
|
||||
|
||||
/// 本模块自有引擎(free/cloud)+ **已加入翻译候选的**全局 AI 供应商
|
||||
/// (转换为 kind = "ai"),按优先级升序。
|
||||
///
|
||||
/// 这是翻译候选的**唯一真源**:显式指定、自动降级、视觉直译都从这里取。
|
||||
///
|
||||
/// 两条筛选:
|
||||
/// - AI 供应商必须先在翻译设置里「加入」(= `ai_params` 有记录)。主设置里配好的
|
||||
/// 供应商不自动参与翻译,用户要哪几个就加哪几个;
|
||||
/// - 历史遗留的 kind = "ai" 引擎(早期版本把 AI 存在翻译设置里)直接丢弃:
|
||||
/// 它的连接配置已搬去 AI 服务、密钥也读不到,留着只会与 AI 供应商重复且删不掉。
|
||||
///
|
||||
/// **不过滤 enabled**——列表 UI 要能看到已禁用项;启用过滤发生在
|
||||
/// [`Self::resolve_candidates`] 的 auto 分支。
|
||||
pub fn all_engines(&self) -> Vec<TranslateEngineConfig> {
|
||||
let settings = self.load_settings();
|
||||
let ai = crate::ai::AiManager::load_settings_sync(&self.data_dir);
|
||||
let mut list: Vec<TranslateEngineConfig> = settings
|
||||
.engines
|
||||
.iter()
|
||||
.filter(|e| e.kind != "ai")
|
||||
.cloned()
|
||||
.collect();
|
||||
list.extend(
|
||||
ai.providers
|
||||
.iter()
|
||||
.filter(|p| settings.has_ai_engine(&p.id))
|
||||
.map(|p| ai_provider_as_engine(p, &settings.ai_params_for(&p.id))),
|
||||
);
|
||||
list.sort_by_key(|e| e.priority);
|
||||
list
|
||||
}
|
||||
|
||||
/// 本次请求该不该走代理。
|
||||
///
|
||||
/// AI 引擎的连接配置归主设置(AI 服务)管,代理开关也跟着那边走;free/cloud 是
|
||||
/// 本模块自己的源,用本模块的开关。两边开关同名不同域,混用会出现「终端里能通、
|
||||
/// 翻译里不通(或反过来)」这种极难排查的现象。
|
||||
fn proxy_enabled_for(&self, kind: &str) -> bool {
|
||||
if kind == "ai" {
|
||||
crate::ai::AiManager::load_settings_sync(&self.data_dir).use_proxy
|
||||
} else {
|
||||
self.load_settings().use_proxy
|
||||
}
|
||||
}
|
||||
|
||||
/// 按配置装配引擎实例(异步:需要先决定走不走代理)。
|
||||
pub async fn build(
|
||||
&self,
|
||||
cfg: &TranslateEngineConfig,
|
||||
) -> Result<Box<dyn TranslateEngine>, TranslateError> {
|
||||
let templates = self.load_settings().prompt_templates;
|
||||
let client = self.select_client().await;
|
||||
let client = self.select_client(self.proxy_enabled_for(&cfg.kind)).await;
|
||||
engines::build_engine(cfg, &templates, client)
|
||||
}
|
||||
|
||||
@@ -329,37 +436,50 @@ impl TranslateManager {
|
||||
engine_id: Option<&str>,
|
||||
) -> Result<Vec<TranslateEngineConfig>, TranslateError> {
|
||||
let settings = self.load_settings();
|
||||
let all = self.all_engines();
|
||||
let explicit = engine_id
|
||||
.map(str::trim)
|
||||
.filter(|s| !s.is_empty() && *s != "auto");
|
||||
|
||||
if let Some(id) = explicit {
|
||||
return settings
|
||||
.engine(id)
|
||||
.cloned()
|
||||
return all
|
||||
.into_iter()
|
||||
.find(|e| e.id == id)
|
||||
.map(|cfg| vec![cfg])
|
||||
.ok_or_else(|| TranslateError::config(format!("找不到引擎实例「{id}」")));
|
||||
}
|
||||
|
||||
if settings.auto_fallback {
|
||||
// 自动模式只尝试已启用的(free + AI 同一规则)
|
||||
let list: Vec<TranslateEngineConfig> =
|
||||
settings.auto_candidates().into_iter().cloned().collect();
|
||||
all.into_iter().filter(|e| e.enabled).collect();
|
||||
if list.is_empty() {
|
||||
return Err(TranslateError::config(
|
||||
"没有已启用的翻译引擎,请先在翻译设置中启用至少一个",
|
||||
"没有可用的翻译引擎:请在主设置 → AI 服务中配置供应商,\
|
||||
再到翻译设置里把它加入翻译候选(或启用免密钥/云引擎)",
|
||||
));
|
||||
}
|
||||
return Ok(list);
|
||||
}
|
||||
|
||||
// 未开启降级:只尝试默认引擎;默认引擎失效时回落到优先级最高的已启用实例
|
||||
let preferred = settings
|
||||
.engine(&settings.default_engine_id)
|
||||
let preferred = all
|
||||
.iter()
|
||||
.find(|e| e.id == settings.default_engine_id && e.enabled)
|
||||
.cloned()
|
||||
.or_else(|| settings.auto_candidates().first().map(|c| (*c).clone()));
|
||||
preferred.map(|cfg| vec![cfg]).ok_or_else(|| {
|
||||
TranslateError::config("没有已启用的翻译引擎,请先在翻译设置中启用至少一个")
|
||||
})
|
||||
.or_else(|| {
|
||||
all.into_iter()
|
||||
.filter(|e| e.enabled)
|
||||
.min_by_key(|e| e.priority)
|
||||
});
|
||||
preferred
|
||||
.map(|cfg| vec![cfg])
|
||||
.ok_or_else(|| {
|
||||
TranslateError::config(
|
||||
"没有可用的翻译引擎:请在主设置 → AI 服务中配置供应商,\
|
||||
再到翻译设置里把它加入翻译候选,并启用至少一个引擎",
|
||||
)
|
||||
})
|
||||
}
|
||||
|
||||
/// 执行一次翻译(含自动降级)。
|
||||
|
||||
Reference in new issue
Block a user