调整
This commit is contained in:
1 parent
79bded1cd2
commit
9e6d73e191
73 files changed
+6229
-1427
No files matched your search
@@ -0,0 +1,447 @@
|
||||
//! OpenAI 兼容的通用对话客户端(非翻译语义)。
|
||||
//!
|
||||
//! 一套代码覆盖 DeepSeek / OpenAI / Gemini(OpenAI 兼容端点)/ 通义 DashScope /
|
||||
//! Kimi / 智谱 / 豆包 / Mistral / Groq / OpenRouter / 本地 Ollama / LM Studio /
|
||||
//! one-api 等中转——它们都提供 `POST {baseUrl}/chat/completions` 且结构一致。
|
||||
//!
|
||||
//! 与 `translate::engines::ai` 的分工:
|
||||
//! - 本模块:调用方**全量给定 messages**(终端助手等),不含翻译提示词语义;
|
||||
//! - translate 的 AiEngine:流式、视觉、翻译模板、空流自愈等翻译专属逻辑。
|
||||
//!
|
||||
//! 两者共享端点归一、密钥读取(凭据管理器)与 HTTP 错误分类的约定。
|
||||
|
||||
use std::time::Duration;
|
||||
|
||||
use serde::Deserialize;
|
||||
use serde_json::json;
|
||||
|
||||
use super::{
|
||||
provider_api_key, AiErrorKind, AiProviderConfig, AiSettings, DEFAULT_CHAT_TIMEOUT_MS,
|
||||
};
|
||||
|
||||
/// 自检与连通性测试使用的探测文本
|
||||
const PROBE_TEXT: &str = "Hello, world.";
|
||||
|
||||
/// 通用对话请求的结构化错误:**分类 + 可直接展示的中文文案**。
|
||||
///
|
||||
/// 调用方各自取所需:终端助手只要文案([`chat_once`] 直接给 String),
|
||||
/// 设置页的连通性测试还需要分类,用来给「改 Key」「查网络」这类不同的下一步提示。
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct ChatError {
|
||||
pub kind: AiErrorKind,
|
||||
pub message: String,
|
||||
}
|
||||
|
||||
impl ChatError {
|
||||
fn new(kind: AiErrorKind, message: impl Into<String>) -> Self {
|
||||
Self {
|
||||
kind,
|
||||
message: message.into(),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
impl std::fmt::Display for ChatError {
|
||||
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
||||
f.write_str(&self.message)
|
||||
}
|
||||
}
|
||||
|
||||
/// API 根地址。容错:用户常把完整端点(`.../chat/completions`)粘进来,
|
||||
/// 不剥掉会拼出双重后缀,上游表现为 404。
|
||||
pub fn api_root(cfg: &AiProviderConfig) -> Result<String, ChatError> {
|
||||
let raw = cfg.base_url.trim();
|
||||
if raw.is_empty() {
|
||||
return Err(ChatError::new(
|
||||
AiErrorKind::Config,
|
||||
format!("供应商「{}」尚未配置 Base URL", cfg.name),
|
||||
));
|
||||
}
|
||||
if !(raw.starts_with("http://") || raw.starts_with("https://")) {
|
||||
return Err(ChatError::new(
|
||||
AiErrorKind::Config,
|
||||
format!("Base URL 需以 http:// 或 https:// 开头,当前为「{raw}」"),
|
||||
));
|
||||
}
|
||||
let mut root = raw.trim_end_matches('/').to_string();
|
||||
for suffix in ["/chat/completions", "/completions", "/models"] {
|
||||
if let Some(stripped) = root.strip_suffix(suffix) {
|
||||
root = stripped.trim_end_matches('/').to_string();
|
||||
break;
|
||||
}
|
||||
}
|
||||
Ok(root)
|
||||
}
|
||||
|
||||
pub fn chat_endpoint(cfg: &AiProviderConfig) -> Result<String, ChatError> {
|
||||
Ok(format!("{}/chat/completions", api_root(cfg)?))
|
||||
}
|
||||
|
||||
pub fn models_endpoint(cfg: &AiProviderConfig) -> Result<String, ChatError> {
|
||||
Ok(format!("{}/models", api_root(cfg)?))
|
||||
}
|
||||
|
||||
/// 取本次请求使用的密钥。
|
||||
///
|
||||
/// `override_key` 非空时优先——设置页「检查」允许用**刚填好、还没保存**的 Key 直接验证,
|
||||
/// 省掉「先保存密钥再测试」的来回。它只活在这一次请求里,不入凭据库、不落盘。
|
||||
fn require_key(cfg: &AiProviderConfig, override_key: Option<&str>) -> Result<String, ChatError> {
|
||||
let key = match override_key.map(str::trim).filter(|k| !k.is_empty()) {
|
||||
Some(k) => k.to_string(),
|
||||
None => provider_api_key(&cfg.id),
|
||||
};
|
||||
if key.trim().is_empty() {
|
||||
return Err(ChatError::new(
|
||||
AiErrorKind::Auth,
|
||||
format!(
|
||||
"供应商「{}」尚未配置 API Key,请在主设置 → AI 服务中填写",
|
||||
cfg.name
|
||||
),
|
||||
));
|
||||
}
|
||||
Ok(key)
|
||||
}
|
||||
|
||||
fn require_model(cfg: &AiProviderConfig) -> Result<String, ChatError> {
|
||||
let model = cfg.model.trim();
|
||||
if model.is_empty() {
|
||||
return Err(ChatError::new(
|
||||
AiErrorKind::Config,
|
||||
format!(
|
||||
"供应商「{}」尚未选择模型,可在设置中拉取模型列表后选择",
|
||||
cfg.name
|
||||
),
|
||||
));
|
||||
}
|
||||
Ok(model.to_string())
|
||||
}
|
||||
|
||||
/// 解析请求体公共字段(temperature / max_tokens / extra_body)。
|
||||
fn apply_common_params(body: &mut serde_json::Map<String, serde_json::Value>, cfg: &AiProviderConfig) {
|
||||
body.insert("temperature".into(), json!(cfg.temperature));
|
||||
body.insert("max_tokens".into(), json!(cfg.max_tokens));
|
||||
if let Some(extra) = cfg.extra_body.as_deref().map(str::trim) {
|
||||
if !extra.is_empty() {
|
||||
if let Ok(serde_json::Value::Object(map)) = serde_json::from_str::<serde_json::Value>(extra)
|
||||
{
|
||||
for (k, v) in map {
|
||||
body.insert(k, v);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 按设置选择 HTTP 客户端:开了代理且能解析到 mixed 端口 → 走代理,否则直连。
|
||||
///
|
||||
/// 与翻译模块同一姿态:代理不可用时**静默回退直连**,让请求自己去失败。
|
||||
async fn select_client(settings: &AiSettings, data_dir: &std::path::Path) -> reqwest::Client {
|
||||
let direct = reqwest::Client::builder()
|
||||
.timeout(Duration::from_secs(120))
|
||||
.build()
|
||||
.unwrap_or_else(|_| reqwest::Client::new());
|
||||
if !settings.use_proxy {
|
||||
return direct;
|
||||
}
|
||||
let Ok(raw) = std::fs::read_to_string(data_dir.join("proxy").join("settings.json")) else {
|
||||
return direct;
|
||||
};
|
||||
let Ok(value) = serde_json::from_str::<serde_json::Value>(&raw) else {
|
||||
return direct;
|
||||
};
|
||||
let Some(port) = value.get("mixedPort").and_then(|v| v.as_u64()) else {
|
||||
return direct;
|
||||
};
|
||||
if port == 0 || port > 65535 {
|
||||
return direct;
|
||||
}
|
||||
let proxy_url = format!("http://127.0.0.1:{port}");
|
||||
match reqwest::Proxy::all(&proxy_url).ok().and_then(|p| {
|
||||
reqwest::Client::builder()
|
||||
.timeout(Duration::from_secs(120))
|
||||
.proxy(p)
|
||||
.build()
|
||||
.ok()
|
||||
}) {
|
||||
Some(client) => client,
|
||||
None => direct,
|
||||
}
|
||||
}
|
||||
|
||||
/// 通用对话补全(结构化错误版):消息由调用方全量给定。
|
||||
async fn post_chat(
|
||||
cfg: &AiProviderConfig,
|
||||
messages: Vec<(&str, String)>,
|
||||
api_key_override: Option<&str>,
|
||||
settings: &AiSettings,
|
||||
data_dir: &std::path::Path,
|
||||
) -> Result<String, ChatError> {
|
||||
let key = require_key(cfg, api_key_override)?;
|
||||
let model = require_model(cfg)?;
|
||||
let endpoint = chat_endpoint(cfg)?;
|
||||
|
||||
let mut body = serde_json::Map::new();
|
||||
body.insert("model".into(), json!(model));
|
||||
body.insert("stream".into(), json!(false));
|
||||
body.insert(
|
||||
"messages".into(),
|
||||
json!(messages
|
||||
.into_iter()
|
||||
.map(|(role, content)| json!({ "role": role, "content": content }))
|
||||
.collect::<Vec<_>>()),
|
||||
);
|
||||
apply_common_params(&mut body, cfg);
|
||||
|
||||
let client = select_client(settings, data_dir).await;
|
||||
let resp = client
|
||||
.post(&endpoint)
|
||||
.bearer_auth(&key)
|
||||
.timeout(Duration::from_millis(DEFAULT_CHAT_TIMEOUT_MS))
|
||||
.json(&serde_json::Value::Object(body))
|
||||
.send()
|
||||
.await
|
||||
.map_err(|e| classify_reqwest(e, &cfg.name))?;
|
||||
|
||||
let status = resp.status();
|
||||
let raw = resp
|
||||
.text()
|
||||
.await
|
||||
.map_err(|e| {
|
||||
ChatError::new(
|
||||
AiErrorKind::Network,
|
||||
format!("读取「{}」响应失败: {e}", cfg.name),
|
||||
)
|
||||
})?;
|
||||
if !status.is_success() {
|
||||
return Err(classify_http(status.as_u16(), &raw, &cfg.name, &model));
|
||||
}
|
||||
|
||||
let parsed: ChatResponse = serde_json::from_str(&raw).map_err(|e| {
|
||||
ChatError::new(
|
||||
AiErrorKind::Parse,
|
||||
format!("「{}」响应不是预期的 JSON: {e}", cfg.name),
|
||||
)
|
||||
})?;
|
||||
if let Some(err) = parsed.error {
|
||||
let msg = err
|
||||
.message
|
||||
.filter(|m| !m.trim().is_empty())
|
||||
.unwrap_or_else(|| "上游返回了错误对象".to_string());
|
||||
return Err(ChatError::new(
|
||||
AiErrorKind::Unknown,
|
||||
format!("「{}」返回错误:{msg}", cfg.name),
|
||||
));
|
||||
}
|
||||
|
||||
parsed
|
||||
.choices
|
||||
.into_iter()
|
||||
.next()
|
||||
.and_then(|c| c.message.content)
|
||||
.map(|s| s.trim().to_string())
|
||||
.filter(|s| !s.is_empty())
|
||||
.ok_or_else(|| {
|
||||
ChatError::new(AiErrorKind::Empty, format!("「{}」返回了空内容", cfg.name))
|
||||
})
|
||||
}
|
||||
|
||||
/// 通用对话补全:消息由调用方全量给定。
|
||||
///
|
||||
/// 只要文案的调用方(终端 AI 助手)走这里;需要错误分类的用 [`test_provider`]。
|
||||
pub async fn chat_once(
|
||||
cfg: &AiProviderConfig,
|
||||
messages: Vec<(&str, String)>,
|
||||
settings: &AiSettings,
|
||||
data_dir: &std::path::Path,
|
||||
) -> Result<String, String> {
|
||||
post_chat(cfg, messages, None, settings, data_dir)
|
||||
.await
|
||||
.map_err(|e| e.message)
|
||||
}
|
||||
|
||||
/// 连通性自检:发一条极短同步请求。
|
||||
///
|
||||
/// `api_key_override` 见 [`require_key`]:设置页「检查」可以带上用户刚填、还没保存的 Key。
|
||||
pub async fn test_provider(
|
||||
cfg: &AiProviderConfig,
|
||||
api_key_override: Option<&str>,
|
||||
settings: &AiSettings,
|
||||
data_dir: &std::path::Path,
|
||||
) -> Result<String, ChatError> {
|
||||
let started = std::time::Instant::now();
|
||||
let text = post_chat(
|
||||
cfg,
|
||||
vec![
|
||||
("system", "You are a connectivity probe. Reply with OK only.".to_string()),
|
||||
("user", PROBE_TEXT.to_string()),
|
||||
],
|
||||
api_key_override,
|
||||
settings,
|
||||
data_dir,
|
||||
)
|
||||
.await?;
|
||||
Ok(format!(
|
||||
"连通正常 · 模型 {} · {}ms · 回显「{}」",
|
||||
cfg.model,
|
||||
started.elapsed().as_millis() as u64,
|
||||
text.chars().take(40).collect::<String>()
|
||||
))
|
||||
}
|
||||
|
||||
/// 拉取上游模型列表(`GET {baseUrl}/models`)。
|
||||
pub async fn list_models(
|
||||
cfg: &AiProviderConfig,
|
||||
settings: &AiSettings,
|
||||
data_dir: &std::path::Path,
|
||||
) -> Result<Vec<String>, String> {
|
||||
list_models_typed(cfg, settings, data_dir)
|
||||
.await
|
||||
.map_err(|e| e.message)
|
||||
}
|
||||
|
||||
async fn list_models_typed(
|
||||
cfg: &AiProviderConfig,
|
||||
settings: &AiSettings,
|
||||
data_dir: &std::path::Path,
|
||||
) -> Result<Vec<String>, ChatError> {
|
||||
let key = require_key(cfg, None)?;
|
||||
let endpoint = models_endpoint(cfg)?;
|
||||
let client = select_client(settings, data_dir).await;
|
||||
let resp = client
|
||||
.get(&endpoint)
|
||||
.bearer_auth(&key)
|
||||
.timeout(Duration::from_millis(15_000))
|
||||
.send()
|
||||
.await
|
||||
.map_err(|e| classify_reqwest(e, &cfg.name))?;
|
||||
|
||||
let status = resp.status();
|
||||
let raw = resp.text().await.map_err(|e| {
|
||||
ChatError::new(
|
||||
AiErrorKind::Network,
|
||||
format!("读取「{}」模型列表失败: {e}", cfg.name),
|
||||
)
|
||||
})?;
|
||||
if !status.is_success() {
|
||||
return Err(classify_http(
|
||||
status.as_u16(),
|
||||
&raw,
|
||||
&cfg.name,
|
||||
cfg.model.as_str(),
|
||||
));
|
||||
}
|
||||
|
||||
let parsed: ModelsResponse = serde_json::from_str(&raw).map_err(|e| {
|
||||
ChatError::new(
|
||||
AiErrorKind::Parse,
|
||||
format!("「{}」的模型列表无法解析: {e}", cfg.name),
|
||||
)
|
||||
})?;
|
||||
let mut ids: Vec<String> = parsed
|
||||
.data
|
||||
.into_iter()
|
||||
.map(|m| m.id)
|
||||
.filter(|id| !id.trim().is_empty())
|
||||
.collect();
|
||||
ids.sort();
|
||||
ids.dedup();
|
||||
Ok(ids)
|
||||
}
|
||||
|
||||
fn classify_reqwest(e: reqwest::Error, provider: &str) -> ChatError {
|
||||
if e.is_timeout() {
|
||||
return ChatError::new(
|
||||
AiErrorKind::Timeout,
|
||||
format!("请求「{provider}」超时,可在设置中调大超时时间,或检查网络"),
|
||||
);
|
||||
}
|
||||
if e.is_connect() {
|
||||
return ChatError::new(
|
||||
AiErrorKind::Network,
|
||||
format!("无法连接「{provider}」:{e}(若该服务在境外,请检查网络或在 AI 设置中开启代理)"),
|
||||
);
|
||||
}
|
||||
ChatError::new(
|
||||
AiErrorKind::Network,
|
||||
format!("请求「{provider}」失败:{e}"),
|
||||
)
|
||||
}
|
||||
|
||||
fn classify_http(status: u16, body: &str, provider: &str, model: &str) -> ChatError {
|
||||
let snippet = body.trim();
|
||||
let lower = snippet.to_lowercase();
|
||||
match status {
|
||||
401 | 403 => ChatError::new(
|
||||
AiErrorKind::Auth,
|
||||
format!("「{provider}」认证失败(HTTP {status}),请检查 API Key 是否正确、是否有该模型的权限"),
|
||||
),
|
||||
402 => ChatError::new(
|
||||
AiErrorKind::Auth,
|
||||
format!("「{provider}」余额不足或未开通计费(HTTP 402)"),
|
||||
),
|
||||
429 => ChatError::new(
|
||||
AiErrorKind::RateLimit,
|
||||
format!("「{provider}」请求过于频繁(HTTP 429),请稍后重试或降低频率"),
|
||||
),
|
||||
400 | 404 | 422 if lower.contains("model") => ChatError::new(
|
||||
AiErrorKind::Config,
|
||||
format!(
|
||||
"「{provider}」不识别模型「{model}」(HTTP {status}):上游模型名可能已变更,\
|
||||
请在设置中拉取模型列表后重新选择"
|
||||
),
|
||||
),
|
||||
400 | 404 | 422 => ChatError::new(
|
||||
AiErrorKind::Config,
|
||||
format!("「{provider}」拒绝了该请求(HTTP {status})"),
|
||||
),
|
||||
408 | 504 => ChatError::new(
|
||||
AiErrorKind::Timeout,
|
||||
format!("「{provider}」上游超时(HTTP {status})"),
|
||||
),
|
||||
s if (500..600).contains(&s) => ChatError::new(
|
||||
AiErrorKind::Network,
|
||||
format!("「{provider}」服务端错误(HTTP {status}),可稍后重试"),
|
||||
),
|
||||
s => ChatError::new(AiErrorKind::Unknown, format!("「{provider}」返回 HTTP {s}")),
|
||||
}
|
||||
}
|
||||
|
||||
// ===== 响应结构(宽松解析) =====
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
struct ChatResponse {
|
||||
#[serde(default)]
|
||||
choices: Vec<ChatChoice>,
|
||||
#[serde(default)]
|
||||
error: Option<ApiErrorBody>,
|
||||
}
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
struct ChatChoice {
|
||||
#[serde(default)]
|
||||
message: ChatMessage,
|
||||
}
|
||||
|
||||
#[derive(Debug, Default, Deserialize)]
|
||||
struct ChatMessage {
|
||||
#[serde(default)]
|
||||
content: Option<String>,
|
||||
}
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
struct ApiErrorBody {
|
||||
#[serde(default)]
|
||||
message: Option<String>,
|
||||
}
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
struct ModelsResponse {
|
||||
#[serde(default)]
|
||||
data: Vec<ModelEntry>,
|
||||
}
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
struct ModelEntry {
|
||||
#[serde(default)]
|
||||
id: String,
|
||||
}
|
||||
@@ -0,0 +1,218 @@
|
||||
//! 全局 AI 模块 Tauri 命令层。
|
||||
//!
|
||||
//! 与 translate 命令层同一安全约定:
|
||||
//! - **不存在读取 API Key 明文的命令**。列表只回传「是否已配置」与掩码;
|
||||
//! - 写入走 `ai_secret_set`,删除走 `ai_secret_clear`。
|
||||
|
||||
use serde::{Serialize};
|
||||
use specta::Type;
|
||||
use tauri::State;
|
||||
|
||||
use super::{AiErrorKind, AiManager, AiProviderConfig, AiSettings, AiTestResult};
|
||||
|
||||
/// 供应商前端视图:配置 + 派生状态(密钥是否已配、是否可用)。
|
||||
#[derive(Debug, Clone, Serialize, Type)]
|
||||
#[serde(rename_all = "camelCase")]
|
||||
pub struct AiProviderView {
|
||||
pub config: AiProviderConfig,
|
||||
pub has_api_key: bool,
|
||||
pub api_key_masked: String,
|
||||
pub ready: bool,
|
||||
pub issue: Option<String>,
|
||||
}
|
||||
|
||||
/// 读取全局 AI 设置。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub fn ai_get_settings(state: State<'_, AiManager>) -> Result<AiSettings, String> {
|
||||
Ok(state.load_settings())
|
||||
}
|
||||
|
||||
/// 保存全局 AI 设置(整体覆盖;供应商列表以传入为准)。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub fn ai_save_settings(
|
||||
state: State<'_, AiManager>,
|
||||
settings: AiSettings,
|
||||
) -> Result<(), String> {
|
||||
let mut next = settings;
|
||||
for p in &mut next.providers {
|
||||
p.id = p.id.trim().to_string();
|
||||
p.name = p.name.trim().to_string();
|
||||
}
|
||||
next.providers.retain(|p| !p.id.is_empty());
|
||||
next.heal();
|
||||
state.save_settings(&next)
|
||||
}
|
||||
|
||||
/// 列出供应商视图(含密钥状态与可用性),保持配置中的顺序。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub fn ai_list_providers(state: State<'_, AiManager>) -> Result<Vec<AiProviderView>, String> {
|
||||
let settings = state.load_settings();
|
||||
Ok(settings.providers.iter().map(to_view).collect())
|
||||
}
|
||||
|
||||
/// 新增或更新一个供应商(按 id upsert)。
|
||||
///
|
||||
/// 校验 id:它会进入凭据键(`ai-provider-<id>`),限定为字母/数字/下划线/短横线。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub fn ai_provider_save(
|
||||
state: State<'_, AiManager>,
|
||||
config: AiProviderConfig,
|
||||
) -> Result<(), String> {
|
||||
let id = config.id.trim().to_string();
|
||||
if id.is_empty() {
|
||||
return Err("供应商标识不能为空".to_string());
|
||||
}
|
||||
if !id
|
||||
.chars()
|
||||
.all(|c| c.is_ascii_alphanumeric() || c == '_' || c == '-')
|
||||
{
|
||||
return Err("供应商标识只能包含字母、数字、下划线和短横线".to_string());
|
||||
}
|
||||
if config.name.trim().is_empty() {
|
||||
return Err("供应商名称不能为空".to_string());
|
||||
}
|
||||
|
||||
let mut settings = state.load_settings();
|
||||
let mut next = config;
|
||||
next.id = id;
|
||||
// 输出/上下文夹到合法档位上限(UI 提供档位,后端再兜一道)
|
||||
next.max_tokens = next.max_tokens.clamp(1, 131_072);
|
||||
next.max_context = next.max_context.clamp(1_024, 1_048_576);
|
||||
if next.max_tokens == 0 {
|
||||
next.max_tokens = super::settings::DEFAULT_MAX_OUTPUT;
|
||||
}
|
||||
if next.max_context < 1_024 {
|
||||
next.max_context = super::settings::DEFAULT_MAX_CONTEXT;
|
||||
}
|
||||
match settings.providers.iter_mut().find(|p| p.id == next.id) {
|
||||
Some(slot) => *slot = next,
|
||||
None => settings.providers.push(next),
|
||||
}
|
||||
// 不按优先级排序:优先级是翻译等模块的场景参数,AI 列表保持添加顺序
|
||||
state.save_settings(&settings)
|
||||
}
|
||||
|
||||
/// 删除供应商(连同它在系统凭据管理器中的密钥)。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub fn ai_provider_delete(state: State<'_, AiManager>, id: String) -> Result<(), String> {
|
||||
let mut settings = state.load_settings();
|
||||
let before = settings.providers.len();
|
||||
settings.providers.retain(|p| p.id != id);
|
||||
if settings.providers.len() == before {
|
||||
return Err(format!("找不到供应商「{id}」"));
|
||||
}
|
||||
if settings.default_provider_id == id {
|
||||
settings.default_provider_id = "auto".to_string();
|
||||
}
|
||||
state.save_settings(&settings)?;
|
||||
if let Err(e) = crate::secrets::secret_delete(&super::provider_secret_key(&id)) {
|
||||
crate::logger::log_error("ai", &format!("删除供应商「{id}」的密钥失败: {e}"));
|
||||
}
|
||||
Ok(())
|
||||
}
|
||||
|
||||
/// 写入供应商的 API Key(明文只在此处进入系统凭据管理器,永不回写配置文件)。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub fn ai_secret_set(state: State<'_, AiManager>, id: String, api_key: String) -> Result<(), String> {
|
||||
if state.load_settings().provider(&id).is_none() {
|
||||
return Err(format!("找不到供应商「{id}」"));
|
||||
}
|
||||
let key = super::provider_secret_key(&id);
|
||||
let value = api_key.trim();
|
||||
if value.is_empty() {
|
||||
return crate::secrets::secret_delete(&key);
|
||||
}
|
||||
crate::secrets::secret_write(&key, value)
|
||||
}
|
||||
|
||||
/// 清除供应商的 API Key。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub fn ai_secret_clear(id: String) -> Result<(), String> {
|
||||
crate::secrets::secret_delete(&super::provider_secret_key(&id))
|
||||
}
|
||||
|
||||
/// 连通性自检:用前端传入的草稿配置测试(**不落盘**)。
|
||||
///
|
||||
/// `api_key` 是可选的「临时密钥」覆盖:设置页允许用户**填好 Key、还没保存**就先检查一次,
|
||||
/// 省掉「先保存再测试」的来回。它只用于这一次请求——不写凭据管理器、不落配置文件,
|
||||
/// 也不会被回传到前端;为空时退回凭据管理器里已保存的密钥。
|
||||
///
|
||||
/// 之所以仍按 `config.id` 取已保存的密钥作为默认值:多数场景(改 Base URL / 换模型后复测)
|
||||
/// 用户并不想重新输入 Key。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub async fn ai_provider_test(
|
||||
state: State<'_, AiManager>,
|
||||
config: AiProviderConfig,
|
||||
api_key: Option<String>,
|
||||
) -> Result<AiTestResult, String> {
|
||||
if config.id.trim().is_empty() || config.name.trim().is_empty() {
|
||||
return Ok(AiTestResult::failure(
|
||||
AiErrorKind::Config,
|
||||
"供应商标识或名称不能为空,请先保存一次".to_string(),
|
||||
0,
|
||||
));
|
||||
}
|
||||
let settings = state.load_settings();
|
||||
let data_dir = state.data_dir().to_path_buf();
|
||||
let started = std::time::Instant::now();
|
||||
let override_key = api_key.as_deref();
|
||||
match super::test_provider(&config, override_key, &settings, &data_dir).await {
|
||||
Ok(message) => Ok(AiTestResult::success(
|
||||
message,
|
||||
started.elapsed().as_millis() as u64,
|
||||
)),
|
||||
Err(e) => Ok(AiTestResult::failure(
|
||||
e.kind,
|
||||
e.message,
|
||||
started.elapsed().as_millis() as u64,
|
||||
)),
|
||||
}
|
||||
}
|
||||
|
||||
/// 拉取上游模型列表(按已保存的 id;密钥/地址取自磁盘上的配置与凭据库)。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub async fn ai_provider_models(
|
||||
state: State<'_, AiManager>,
|
||||
id: String,
|
||||
) -> Result<Vec<String>, String> {
|
||||
let settings = state.load_settings();
|
||||
let cfg = settings
|
||||
.provider(&id)
|
||||
.cloned()
|
||||
.ok_or_else(|| format!("找不到供应商「{id}」"))?;
|
||||
let data_dir = state.data_dir().to_path_buf();
|
||||
super::list_models(&cfg, &settings, &data_dir).await
|
||||
}
|
||||
|
||||
/// 构造供应商视图并给出「是否可用」的判断。
|
||||
fn to_view(cfg: &AiProviderConfig) -> AiProviderView {
|
||||
let raw_key = super::provider_api_key(&cfg.id);
|
||||
let has_api_key = !raw_key.trim().is_empty();
|
||||
|
||||
let issue = if cfg.base_url.trim().is_empty() {
|
||||
Some("未配置 Base URL".to_string())
|
||||
} else if cfg.model.trim().is_empty() {
|
||||
Some("未选择模型".to_string())
|
||||
} else if !has_api_key {
|
||||
Some("未配置 API Key".to_string())
|
||||
} else {
|
||||
None
|
||||
};
|
||||
|
||||
AiProviderView {
|
||||
config: cfg.clone(),
|
||||
has_api_key,
|
||||
api_key_masked: crate::secrets::mask(&raw_key),
|
||||
ready: issue.is_none() && cfg.enabled,
|
||||
issue,
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,172 @@
|
||||
//! 全局 AI 模块:供应商配置 + OpenAI 兼容客户端。
|
||||
//!
|
||||
//! 架构位置(主应用层,不属于任何业务模块):
|
||||
//!
|
||||
//! ```text
|
||||
//! 主设置 → AI 服务卡片
|
||||
//! ↓ Tauri IPC
|
||||
//! commands.rs 命令层(列表 / CRUD / 密钥 / 测连通 / 拉模型)
|
||||
//! ↓
|
||||
//! AiManager(本文件):设置读写 / 凭据键 / 自愈
|
||||
//! ↓
|
||||
//! chat.rs chat_once / test / list_models(OpenAI 兼容)
|
||||
//! ↓ reqwest
|
||||
//! DeepSeek / OpenAI / Gemini / 通义 / Kimi / 智谱 / Ollama …
|
||||
//! ```
|
||||
//!
|
||||
//! 消费方:
|
||||
//! - **翻译模块**:把已加入翻译候选的供应商转换为 TranslateEngineConfig(kind = "ai"),
|
||||
//! 密钥经 [`provider_api_key`] 读取;翻译专属的提示词模板与优先级仍在 translate 设置。
|
||||
//! - **终端 AI 助手**:直接列本模块的供应商并调用 [`chat::chat_once`]。
|
||||
//!
|
||||
//! **依赖方向:只出不进。** 本模块不引用任何业务模块(translate / terminal …)——
|
||||
//! 它们是消费者,我们是被消费者。连「把历史翻译设置里的 AI 引擎搬过来」这类一次性
|
||||
//! 迁移也不在这里:那段代码必然要同时读懂两边,因此归 translate 侧
|
||||
//! (`translate::migrate_legacy_ai_engines`),由 `setup.rs` 在启动时调用一次。
|
||||
//!
|
||||
//! 安全姿态与 translate 一致:**网络只在 Rust 侧发生**;API Key 只进系统凭据管理器
|
||||
//! (键名 `ai-provider-<id>`),不落 `settings.json`、不经前端明文回传。
|
||||
|
||||
mod chat;
|
||||
mod commands;
|
||||
mod settings;
|
||||
mod test_result;
|
||||
|
||||
pub use chat::{chat_once, list_models, test_provider};
|
||||
pub use commands::{
|
||||
ai_get_settings, ai_list_providers, ai_provider_delete, ai_provider_models,
|
||||
ai_provider_save, ai_provider_test, ai_save_settings, ai_secret_clear, ai_secret_set,
|
||||
};
|
||||
pub use settings::{AiProviderConfig, AiSettings, DEFAULT_CHAT_TIMEOUT_MS, DEFAULT_MAX_CONTEXT};
|
||||
pub use test_result::{AiErrorKind, AiTestResult};
|
||||
|
||||
use std::path::{Path, PathBuf};
|
||||
use std::sync::Mutex;
|
||||
use std::time::{Duration, Instant};
|
||||
|
||||
/// 设置内存缓存有效期(与 translate / music 的 500ms 一致)。
|
||||
const SETTINGS_CACHE_TTL: Duration = Duration::from_millis(500);
|
||||
|
||||
/// 供应商 API Key 的凭据键前缀。
|
||||
const PROVIDER_KEY_PREFIX: &str = "ai-provider-";
|
||||
|
||||
/// 某供应商实例的凭据键。
|
||||
pub fn provider_secret_key(provider_id: &str) -> String {
|
||||
format!("{PROVIDER_KEY_PREFIX}{provider_id}")
|
||||
}
|
||||
|
||||
/// 读取某供应商的 API Key(未配置或读取失败 → 空串)。
|
||||
///
|
||||
/// 只认 `ai-provider-*`。历史上 AI 引擎曾把密钥存在 translate 的 `translate-engine-*`
|
||||
/// 下,那份由一次性迁移复制过来;这里不做回退读取——回退等于让本模块永久依赖
|
||||
/// translate 的键名约定。迁移复制失败时会记日志,用户在设置页重填即可(界面会显示
|
||||
/// 「未配置 API Key」,不会静默走错端点)。
|
||||
pub fn provider_api_key(provider_id: &str) -> String {
|
||||
if provider_id.trim().is_empty() {
|
||||
return String::new();
|
||||
}
|
||||
crate::secrets::read_or_empty(&provider_secret_key(provider_id))
|
||||
}
|
||||
|
||||
/// 写入 AI 设置文件(`{data_dir}/ai/settings.json`,目录不存在时创建)。
|
||||
///
|
||||
/// 除 `AiManager` 外还单独暴露成自由函数:启动阶段的一次性迁移(由 translate 侧发起)
|
||||
/// 需要在 `AiManager` 尚未注册为 State 时写这份文件。
|
||||
pub fn write_settings(data_dir: &Path, settings: &AiSettings) -> Result<(), String> {
|
||||
let root = data_dir.join("ai");
|
||||
std::fs::create_dir_all(&root).map_err(|e| format!("创建 AI 目录失败: {e}"))?;
|
||||
let json =
|
||||
serde_json::to_string_pretty(settings).map_err(|e| format!("序列化 AI 设置失败: {e}"))?;
|
||||
std::fs::write(root.join("settings.json"), json).map_err(|e| format!("写入 AI 设置失败: {e}"))
|
||||
}
|
||||
|
||||
struct SettingsCache {
|
||||
read_at: Instant,
|
||||
settings: AiSettings,
|
||||
}
|
||||
|
||||
/// 全局 AI 管理器(Tauri State)。
|
||||
pub struct AiManager {
|
||||
/// 应用数据目录(与 translate 同级,代理配置也在这一层)
|
||||
data_dir: PathBuf,
|
||||
/// 模块自身目录:{app_data_dir}/ai
|
||||
root: PathBuf,
|
||||
cache: Mutex<Option<SettingsCache>>,
|
||||
}
|
||||
|
||||
impl AiManager {
|
||||
pub fn new(app_data_dir: PathBuf) -> Self {
|
||||
let root = app_data_dir.join("ai");
|
||||
std::fs::create_dir_all(&root).ok();
|
||||
Self {
|
||||
data_dir: app_data_dir,
|
||||
root,
|
||||
cache: Mutex::new(None),
|
||||
}
|
||||
}
|
||||
|
||||
fn settings_path(&self) -> PathBuf {
|
||||
self.root.join("settings.json")
|
||||
}
|
||||
|
||||
/// 应用数据目录(chat 模块解析代理配置用)。
|
||||
pub fn data_dir(&self) -> &Path {
|
||||
&self.data_dir
|
||||
}
|
||||
|
||||
/// 读取设置(带短时缓存;文件缺失时回退默认值;自愈结果落盘)。
|
||||
pub fn load_settings(&self) -> AiSettings {
|
||||
if let Ok(cache) = self.cache.lock() {
|
||||
if let Some(entry) = cache.as_ref() {
|
||||
if entry.read_at.elapsed() < SETTINGS_CACHE_TTL {
|
||||
return entry.settings.clone();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
let mut settings = std::fs::read_to_string(self.settings_path())
|
||||
.ok()
|
||||
.and_then(|s| serde_json::from_str::<AiSettings>(&s).ok())
|
||||
.unwrap_or_default();
|
||||
let healed = settings.heal();
|
||||
if let Ok(mut cache) = self.cache.lock() {
|
||||
*cache = Some(SettingsCache {
|
||||
read_at: Instant::now(),
|
||||
settings: settings.clone(),
|
||||
});
|
||||
}
|
||||
if healed {
|
||||
if let Err(e) = self.save_settings(&settings) {
|
||||
crate::logger::log_error("ai", &format!("设置自愈落盘失败: {e}"));
|
||||
}
|
||||
}
|
||||
settings
|
||||
}
|
||||
|
||||
/// 保存设置并刷新缓存。
|
||||
pub fn save_settings(&self, settings: &AiSettings) -> Result<(), String> {
|
||||
write_settings(&self.data_dir, settings)?;
|
||||
if let Ok(mut cache) = self.cache.lock() {
|
||||
*cache = Some(SettingsCache {
|
||||
read_at: Instant::now(),
|
||||
settings: settings.clone(),
|
||||
});
|
||||
}
|
||||
Ok(())
|
||||
}
|
||||
|
||||
/// 同步读取 AI 设置(**不经 AiManager 缓存**,供 translate 等在无 State 时使用)。
|
||||
///
|
||||
/// 调用前应保证一次性迁移已跑过(`setup::init` 里在建 State 之前调用
|
||||
/// `translate::migrate_legacy_ai_engines`);文件缺失时回退默认值并自愈,
|
||||
/// 但不写盘——落盘权在 [`write_settings`] 的调用方。
|
||||
pub fn load_settings_sync(data_dir: &Path) -> AiSettings {
|
||||
let path = data_dir.join("ai").join("settings.json");
|
||||
let mut settings = std::fs::read_to_string(path)
|
||||
.ok()
|
||||
.and_then(|s| serde_json::from_str::<AiSettings>(&s).ok())
|
||||
.unwrap_or_default();
|
||||
settings.heal();
|
||||
settings
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,213 @@
|
||||
//! 全局 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
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,66 @@
|
||||
//! 连通性自检结果与错误分类(与翻译模块 EngineTestResult 同形,失败也返回 Ok)。
|
||||
|
||||
use serde::Serialize;
|
||||
use specta::Type;
|
||||
|
||||
/// AI 请求的错误分类。
|
||||
///
|
||||
/// **本模块自带一份,不复用 `translate::ErrorKind`**:AI 服务是独立的底座,
|
||||
/// 不反向依赖任何业务模块(否则「谁依赖谁」会随功能增长变得无法收敛)。
|
||||
/// 变体名与 translate 的同名枚举刻意保持一致,前端可以共用一套提示文案;
|
||||
/// 只保留 AI 侧**真会产生的**分类(translate 的 unsupported / captcha 是翻译专属语义)。
|
||||
/// 将来若两者要做共享层,再把这个枚举上提合并。
|
||||
#[derive(Debug, Clone, Copy, Serialize, Type)]
|
||||
#[serde(rename_all = "camelCase")]
|
||||
pub enum AiErrorKind {
|
||||
/// 配置问题:Base URL / 模型名不对
|
||||
Config,
|
||||
/// 认证问题:API Key 无效、无该模型权限、余额不足
|
||||
Auth,
|
||||
/// 上游限流
|
||||
RateLimit,
|
||||
/// 网络不可达 / 上游服务端错误
|
||||
Network,
|
||||
/// 超时
|
||||
Timeout,
|
||||
/// 响应格式异常
|
||||
Parse,
|
||||
/// 上游返回空内容
|
||||
Empty,
|
||||
/// 其它未分类错误
|
||||
Unknown,
|
||||
}
|
||||
|
||||
#[derive(Debug, Clone, Serialize, Type)]
|
||||
#[serde(rename_all = "camelCase")]
|
||||
pub struct AiTestResult {
|
||||
pub ok: bool,
|
||||
pub latency_ms: u64,
|
||||
pub message: String,
|
||||
pub error_kind: Option<AiErrorKind>,
|
||||
pub detail: Option<String>,
|
||||
}
|
||||
|
||||
impl AiTestResult {
|
||||
/// 失败结果。`kind` 来自 [`crate::ai::chat::ChatError`]——前端据此给出
|
||||
/// 「改 Key」「查网络」这类不同的下一步提示。
|
||||
pub fn failure(kind: AiErrorKind, message: String, latency_ms: u64) -> Self {
|
||||
Self {
|
||||
ok: false,
|
||||
latency_ms,
|
||||
message,
|
||||
error_kind: Some(kind),
|
||||
detail: None,
|
||||
}
|
||||
}
|
||||
|
||||
pub fn success(message: String, latency_ms: u64) -> Self {
|
||||
Self {
|
||||
ok: true,
|
||||
latency_ms,
|
||||
message,
|
||||
error_kind: None,
|
||||
detail: None,
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -19,6 +19,9 @@ pub mod windows {
|
||||
/// 终端独立窗口前缀,实际 label = `${TERMINAL_WINDOW}-<sessionId>`
|
||||
/// 每个终端窗口承载一个会话,脱离主窗口独立存在。
|
||||
pub const TERMINAL_WINDOW: &str = "terminal-window";
|
||||
/// 文件管理器独立窗口。**单例**(label 固定,不含会话 id):
|
||||
/// 它不绑定会话,左右两栏各自选择连接,因此没有「每会话一个窗口」的语义。
|
||||
pub const FILE_WINDOW: &str = "file-window";
|
||||
}
|
||||
|
||||
/// Tauri 事件名(与前端 constants::EVENTS 对应)
|
||||
|
||||
+44
-24
@@ -1,5 +1,6 @@
|
||||
use tauri::Manager;
|
||||
|
||||
mod ai;
|
||||
mod clipboard;
|
||||
mod constants;
|
||||
mod download_engine;
|
||||
@@ -22,6 +23,10 @@ mod tray_menu;
|
||||
mod updater;
|
||||
mod win32_util;
|
||||
|
||||
use ai::{
|
||||
ai_get_settings, ai_list_providers, ai_provider_delete, ai_provider_models,
|
||||
ai_provider_save, ai_provider_test, ai_save_settings, ai_secret_clear, ai_secret_set,
|
||||
};
|
||||
use download_engine::{
|
||||
DownloadEngine,
|
||||
downloader_add_task, downloader_cancel_task, downloader_check_url, downloader_focus_window, downloader_get_extension_info, downloader_get_settings, downloader_get_tasks, downloader_inspect, downloader_select_bt_files,
|
||||
@@ -129,7 +134,10 @@ use terminal::commands::{
|
||||
// SFTP 文件管理(P1)
|
||||
terminal_sftp_close, terminal_sftp_delete, terminal_sftp_download, terminal_sftp_is_open,
|
||||
terminal_sftp_list, terminal_sftp_mkdir, terminal_sftp_open, terminal_sftp_parent,
|
||||
terminal_sftp_read_link, terminal_sftp_rename, terminal_sftp_upload,
|
||||
terminal_sftp_read_link, terminal_sftp_relay, terminal_sftp_rename, terminal_sftp_upload,
|
||||
terminal_file_window_open,
|
||||
// 本地文件系统(面板本地栏)
|
||||
terminal_local_delete, terminal_local_list, terminal_local_mkdir, terminal_local_rename,
|
||||
// 命令片段(P1)
|
||||
terminal_delete_snippet, terminal_list_snippets, terminal_render_snippet,
|
||||
terminal_restore_default_snippets, terminal_run_snippet, terminal_save_snippet,
|
||||
@@ -149,16 +157,15 @@ use terminal::commands::{
|
||||
};
|
||||
use terminal::TerminalManager;
|
||||
use translate::{
|
||||
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,
|
||||
};
|
||||
use updater::{
|
||||
app_version, update_check, update_install, update_thinghk_apply, update_thinghk_cancel,
|
||||
@@ -245,6 +252,10 @@ fn export_bindings() {
|
||||
screenshot_set_scroll_hole,
|
||||
screenshot_copy_image, screenshot_save_png,
|
||||
screenshot_save_cache, screenshot_load_cache, screenshot_delete_cache,
|
||||
// ai(9)
|
||||
ai_get_settings, ai_save_settings, ai_list_providers, ai_provider_save,
|
||||
ai_provider_delete, ai_secret_set, ai_secret_clear, ai_provider_test,
|
||||
ai_provider_models,
|
||||
// translate(20)
|
||||
translate_get_settings, translate_save_settings, translate_apply_shortcuts,
|
||||
translate_engines_list, translate_engine_save, translate_engine_delete,
|
||||
@@ -256,6 +267,7 @@ fn export_bindings() {
|
||||
translate_history_list, translate_history_delete, translate_history_clear,
|
||||
translate_history_set_favorited,
|
||||
translate_stream_start, translate_abort, translate_paste_back,
|
||||
translate_ai_params_save, translate_ai_engine_remove,
|
||||
// terminal(41:39 业务 + key_public / new_host_id 两个辅助)
|
||||
terminal_get_settings, terminal_save_settings, terminal_save_appearance,
|
||||
terminal_save_layout, terminal_save_selection, terminal_save_security,
|
||||
@@ -284,6 +296,8 @@ fn export_bindings() {
|
||||
terminal_history_query, terminal_history_sources,
|
||||
terminal_history_toggle_favorite, terminal_history_delete,
|
||||
terminal_history_clear, terminal_history_run,
|
||||
// AI 命令助手(P2)——与 `run()` 里那份保持一致,否则 bindings.ts 缺类型
|
||||
terminal_ai_engines, terminal_ai_suggest,
|
||||
])
|
||||
.export(Typescript::default(), "../src/lib/bindings.ts")
|
||||
.expect("failed to export bindings");
|
||||
@@ -571,6 +585,17 @@ pub fn run() {
|
||||
translate_stream_start,
|
||||
translate_abort,
|
||||
translate_paste_back,
|
||||
translate_ai_params_save,
|
||||
translate_ai_engine_remove,
|
||||
ai_get_settings,
|
||||
ai_save_settings,
|
||||
ai_list_providers,
|
||||
ai_provider_save,
|
||||
ai_provider_delete,
|
||||
ai_secret_set,
|
||||
ai_secret_clear,
|
||||
ai_provider_test,
|
||||
ai_provider_models,
|
||||
terminal_get_settings,
|
||||
terminal_save_settings,
|
||||
terminal_save_appearance,
|
||||
@@ -629,11 +654,19 @@ pub fn run() {
|
||||
terminal_sftp_delete,
|
||||
terminal_sftp_rename,
|
||||
terminal_sftp_upload,
|
||||
terminal_sftp_relay,
|
||||
terminal_sftp_download,
|
||||
terminal_session_cwd_value,
|
||||
// 文件窗口(单例)
|
||||
terminal_file_window_open,
|
||||
// 本地文件操作(SFTP 面板的「打开 / 在资源管理器中显示」)
|
||||
terminal_open_local_path,
|
||||
terminal_reveal_local_path,
|
||||
// 本地文件系统(面板本地栏的浏览与增删改)
|
||||
terminal_local_list,
|
||||
terminal_local_mkdir,
|
||||
terminal_local_rename,
|
||||
terminal_local_delete,
|
||||
// 命令片段(P1)
|
||||
terminal_list_snippets,
|
||||
terminal_save_snippet,
|
||||
@@ -666,19 +699,6 @@ pub fn run() {
|
||||
terminal_ai_suggest
|
||||
])
|
||||
.setup(setup::init)
|
||||
// 启动耗时定位:main 窗口的「页面加载完成」单独留痕。
|
||||
// 它是「WebView2 拉取页面」与「前端模块图执行」之间的分界——后者的终点是
|
||||
// 前端的 `[main] Thing 应用启动`。两者谁慢,看这两条日志的间隔即可。
|
||||
.on_page_load(|webview, payload| {
|
||||
let phase = match payload.event() {
|
||||
tauri::webview::PageLoadEvent::Started => "开始",
|
||||
tauri::webview::PageLoadEvent::Finished => "完成",
|
||||
};
|
||||
crate::logger::log_info(
|
||||
"boot",
|
||||
&format!("页面加载{}: {} ({})", phase, payload.url(), webview.label()),
|
||||
);
|
||||
})
|
||||
.on_window_event(|window, event| {
|
||||
// 仅主窗口拦截关闭(隐藏到托盘)。其他窗口(截图编辑器/OSD 等)
|
||||
// 调用 close() 是真实销毁语义,全局拦截会导致隐藏窗口累积泄漏。
|
||||
|
||||
@@ -377,8 +377,12 @@ pub async fn quickpanel_delete_file(path: String) -> Result<(), String> {
|
||||
.map_err(|e| format!("删除任务失败: {}", e))?
|
||||
}
|
||||
|
||||
/// 删除文件实现:PowerShell + Microsoft.VisualBasic 移到回收站
|
||||
fn delete_file_impl(path: &str) -> Result<(), String> {
|
||||
/// 删除文件实现:PowerShell + Microsoft.VisualBasic 移到回收站。
|
||||
///
|
||||
/// `pub(crate)` 是给终端模块的文件面板用的(本地栏的删除同样走回收站,
|
||||
/// 见 `terminal::local_fs::delete`)—— 回收站语义与「不弹系统错误对话框」
|
||||
/// 这两点只该有一份实现。
|
||||
pub(crate) fn delete_file_impl(path: &str) -> Result<(), String> {
|
||||
#[cfg(windows)]
|
||||
{
|
||||
use crate::process_manager::setup_creation_flags;
|
||||
|
||||
@@ -14,6 +14,7 @@
|
||||
use std::sync::Arc;
|
||||
use tauri::{App, Manager, Wry};
|
||||
|
||||
use crate::ai::AiManager;
|
||||
use crate::download_engine::{DownloadEngine, ExtensionServer};
|
||||
use crate::logger::LogManager;
|
||||
use crate::mihomo_manager::MihomoManager;
|
||||
@@ -64,6 +65,15 @@ pub fn init(app: &mut App<Wry>) -> Result<(), Box<dyn std::error::Error>> {
|
||||
music.set_app(app.handle().clone());
|
||||
app.manage(music);
|
||||
|
||||
// ===== AI 模块:AiManager(全局供应商配置,主设置 → AI 服务)=====
|
||||
// 迁移必须在建 State 之前跑:把旧版存在翻译设置里的 AI 引擎(含密钥)搬过来,
|
||||
// 否则 AiManager 预热缓存时会读走默认配置。迁移逻辑在 translate 侧(要同时读懂
|
||||
// 两份设置,放这里会让 AI 模块反向依赖业务模块)。
|
||||
crate::translate::migrate_legacy_ai_engines(&app_data_dir);
|
||||
let ai = AiManager::new(app_data_dir.clone());
|
||||
let _ = ai.load_settings();
|
||||
app.manage(ai);
|
||||
|
||||
// ===== 翻译模块:TranslateManager =====
|
||||
// 仅注册状态:设置与密钥都在命令调用时按需读取,启动阶段不发任何网络请求
|
||||
// (模型可用性校验因此改为懒校验:首次翻译失败时解释原因 + 设置页手动拉取模型列表)。
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
//! AI 命令助手(P2)。
|
||||
//!
|
||||
//! 根据用户意图(+ 可选的终端上下文)生成可执行的命令建议。
|
||||
//! **复用翻译模块的 AI 引擎配置**:引擎列表、Base URL、模型、密钥
|
||||
//! (凭据管理器)全部来自 translate 的设置——用户只需配置一份 API。
|
||||
//! **复用主设置的全局 AI 供应商**(`ai` 模块):引擎列表、Base URL、模型、密钥
|
||||
//! 全部来自主设置 → AI 服务——用户只需配置一份 API。
|
||||
//!
|
||||
//! # 输出契约(与模型约定的 JSON)
|
||||
//!
|
||||
@@ -14,11 +14,9 @@
|
||||
use serde::Serialize;
|
||||
use specta::Type;
|
||||
|
||||
use crate::translate::chat_once;
|
||||
use crate::translate::TranslateEngineConfig;
|
||||
use crate::translate::TranslateSettings;
|
||||
use crate::ai::{chat_once, AiProviderConfig, AiSettings};
|
||||
|
||||
/// 可用于命令生成的引擎(kind = "ai" 且配置完整)。
|
||||
/// 可用于命令生成的供应商(已启用且配置了 Base URL)。
|
||||
#[derive(Debug, Clone, Serialize, Type)]
|
||||
#[serde(rename_all = "camelCase")]
|
||||
pub struct AiEngineOption {
|
||||
@@ -48,27 +46,18 @@ const SYSTEM_PROMPT: &str = r#"你是终端命令助手。根据用户的意图
|
||||
4. 命令默认面向 POSIX shell(bash)。仅当用户明确提到 Windows/PowerShell 时才用 PowerShell 语法。
|
||||
5. 命令中的路径、用户名等参数保持通用;不要编造用户环境里不存在的变量值。"#;
|
||||
|
||||
/// 列出可用于命令生成的 AI 引擎(按翻译设置的优先级排序)。
|
||||
pub fn ai_engine_options(settings: &TranslateSettings) -> Vec<AiEngineOption> {
|
||||
let mut opts: Vec<AiEngineOption> = settings
|
||||
.engines
|
||||
/// 列出可用于命令生成的 AI 供应商(保持主设置顺序;已启用且配置了 Base URL)。
|
||||
pub fn ai_engine_options(settings: &AiSettings) -> Vec<AiEngineOption> {
|
||||
settings
|
||||
.providers
|
||||
.iter()
|
||||
.filter(|e| e.kind == "ai" && e.enabled && !e.base_url.trim().is_empty())
|
||||
.map(|e| AiEngineOption {
|
||||
id: e.id.clone(),
|
||||
name: e.name.clone(),
|
||||
model: e.model.clone(),
|
||||
.filter(|p| p.enabled && !p.base_url.trim().is_empty())
|
||||
.map(|p| AiEngineOption {
|
||||
id: p.id.clone(),
|
||||
name: p.name.clone(),
|
||||
model: p.model.clone(),
|
||||
})
|
||||
.collect();
|
||||
opts.sort_by_key(|o| {
|
||||
settings
|
||||
.engines
|
||||
.iter()
|
||||
.find(|e| e.id == o.id)
|
||||
.map(|e| e.priority)
|
||||
.unwrap_or(100)
|
||||
});
|
||||
opts
|
||||
.collect()
|
||||
}
|
||||
|
||||
/// 生成命令建议。
|
||||
@@ -76,9 +65,11 @@ pub fn ai_engine_options(settings: &TranslateSettings) -> Vec<AiEngineOption> {
|
||||
/// `context` 是可选的终端最近输出/选中文本(前端从 xterm 缓冲取),
|
||||
/// 帮助模型理解「接着上一步做什么」;为空则只看意图。
|
||||
pub async fn suggest(
|
||||
engine: &TranslateEngineConfig,
|
||||
engine: &AiProviderConfig,
|
||||
intent: &str,
|
||||
context: &str,
|
||||
settings: &AiSettings,
|
||||
data_dir: &std::path::Path,
|
||||
) -> Result<Vec<CommandSuggestion>, String> {
|
||||
if intent.trim().is_empty() {
|
||||
return Err("请先描述你想做什么".to_string());
|
||||
@@ -92,7 +83,13 @@ pub async fn suggest(
|
||||
user.push_str(&format!("\n\n终端最近的输出(供参考):\n{ctx}"));
|
||||
}
|
||||
|
||||
let raw = chat_once(engine, vec![("system", SYSTEM_PROMPT.to_string()), ("user", user)]).await?;
|
||||
let raw = chat_once(
|
||||
engine,
|
||||
vec![("system", SYSTEM_PROMPT.to_string()), ("user", user)],
|
||||
settings,
|
||||
data_dir,
|
||||
)
|
||||
.await?;
|
||||
parse_suggestions(&raw)
|
||||
}
|
||||
|
||||
|
||||
@@ -31,7 +31,7 @@ use super::settings::{
|
||||
ShortcutBinding, SshHost, TerminalSettings,
|
||||
};
|
||||
use super::ssh::{self, hostkey, SshConnectParams};
|
||||
use super::{encoding, manager, shell, window, TerminalManager};
|
||||
use super::{encoding, local_fs, manager, shell, window, TerminalManager};
|
||||
|
||||
// ===== 通用返回 =====
|
||||
|
||||
@@ -1885,6 +1885,74 @@ pub async fn terminal_sftp_rename(
|
||||
ssh::sftp::rename(&h, &from, &to).await
|
||||
}
|
||||
|
||||
// ===== 本地文件系统(面板本地栏)=====
|
||||
//
|
||||
// 四个命令都走 `spawn_blocking`:`read_dir` / `canonicalize` 在**映射的网络盘**
|
||||
// 或休眠的机械盘上会阻塞数秒,直接在 async 上下文里调用会占住 tokio worker,
|
||||
// 而 worker 是有限的(面板开着的同时终端还在推输出)。命令本身没有并发需求。
|
||||
|
||||
/// 列举本地目录(`path` 为空则用用户主目录)。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub async fn terminal_local_list(path: String) -> Result<local_fs::LocalDir, String> {
|
||||
tauri::async_runtime::spawn_blocking(move || local_fs::list_dir(&path))
|
||||
.await
|
||||
.map_err(|e| format!("列举本地目录的任务异常退出: {e}"))?
|
||||
}
|
||||
|
||||
/// 创建本地目录(递归)。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub async fn terminal_local_mkdir(path: String) -> Result<(), String> {
|
||||
tauri::async_runtime::spawn_blocking(move || local_fs::create_dir(&path))
|
||||
.await
|
||||
.map_err(|e| format!("创建本地目录的任务异常退出: {e}"))?
|
||||
}
|
||||
|
||||
/// 重命名 / 移动本地条目。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub async fn terminal_local_rename(from: String, to: String) -> Result<(), String> {
|
||||
tauri::async_runtime::spawn_blocking(move || local_fs::rename(&from, &to))
|
||||
.await
|
||||
.map_err(|e| format!("重命名本地条目的任务异常退出: {e}"))?
|
||||
}
|
||||
|
||||
/// 删除本地条目(**移入回收站**,不是永久删除)。
|
||||
///
|
||||
/// 部分成功时 `ok=false` 但 `message` 里带上成功数:面板据此把提示做成
|
||||
/// 「警告」而不是「失败」—— 选中的 10 个文件里有一个正被占用,
|
||||
/// 另外 9 个确实已经进了回收站,报成失败会让用户以为都没删掉。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub async fn terminal_local_delete(paths: Vec<String>) -> Result<ActionOutcome, String> {
|
||||
let (removed, failed) = tauri::async_runtime::spawn_blocking(move || local_fs::delete(&paths))
|
||||
.await
|
||||
.map_err(|e| format!("删除本地条目的任务异常退出: {e}"))?;
|
||||
|
||||
if failed.is_empty() {
|
||||
return Ok(ActionOutcome::ok(format!("已移入回收站 {removed} 项")));
|
||||
}
|
||||
Ok(ActionOutcome {
|
||||
ok: false,
|
||||
message: format!(
|
||||
"已移入回收站 {removed} 项,失败 {} 项:{}",
|
||||
failed.len(),
|
||||
failed.join(";")
|
||||
),
|
||||
})
|
||||
}
|
||||
|
||||
/// 打开(或唤出)文件管理器独立窗口。
|
||||
///
|
||||
/// 单例:窗口已存在时只 show + focus(见 `window::open_file_window`)。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub async fn terminal_file_window_open(app: AppHandle) -> Result<ActionOutcome, String> {
|
||||
window::open_file_window(&app)?;
|
||||
Ok(ActionOutcome::ok("文件窗口已就绪"))
|
||||
}
|
||||
|
||||
/// 上传本地文件到远端。
|
||||
///
|
||||
/// 进度经 `terminal-transfer-progress` 事件回报;本命令在传输完成后返回。
|
||||
@@ -2054,6 +2122,94 @@ pub async fn terminal_sftp_download(
|
||||
)))
|
||||
}
|
||||
|
||||
/// 在两个 SSH 会话之间中继文件(远端 → 远端,不经本地磁盘)。
|
||||
///
|
||||
/// 进度事件里的 `sessionId` 取**目标**会话:进度条要跟着「东西落到哪」那一侧,
|
||||
/// 而失败原因(目标写不进去)也都是目标侧的。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub async fn terminal_sftp_relay(
|
||||
app: AppHandle,
|
||||
from_session_id: String,
|
||||
from_path: String,
|
||||
to_session_id: String,
|
||||
to_path: String,
|
||||
) -> Result<ActionOutcome, String> {
|
||||
if from_session_id == to_session_id && from_path == to_path {
|
||||
return Err("源与目标是同一个文件".to_string());
|
||||
}
|
||||
|
||||
let m = manager(&app)?;
|
||||
let from = m
|
||||
.sftp
|
||||
.get(&from_session_id)
|
||||
.ok_or_else(|| "源会话的文件管理器尚未打开".to_string())?;
|
||||
let to = m
|
||||
.sftp
|
||||
.get(&to_session_id)
|
||||
.ok_or_else(|| "目标会话的文件管理器尚未打开".to_string())?;
|
||||
|
||||
let id = format!("t{}", super::session::now_millis());
|
||||
let sid = to_session_id.clone();
|
||||
|
||||
// 与上传/下载同款:每 200ms 才发一次事件(见 `terminal_sftp_upload` 的说明)
|
||||
let last_emit = std::sync::Arc::new(std::sync::Mutex::new(0u64));
|
||||
let progress_app = app.clone();
|
||||
let progress_id = id.clone();
|
||||
let src = from_path.clone();
|
||||
let dst = to_path.clone();
|
||||
let sid_for_progress = sid.clone();
|
||||
|
||||
let sent = match ssh::sftp::relay_file(&from, &from_path, &to, &to_path, |done, total| {
|
||||
let now = super::session::now_millis();
|
||||
let mut last = last_emit.lock().unwrap_or_else(|e| e.into_inner());
|
||||
if done < total && now - *last < 200 {
|
||||
return;
|
||||
}
|
||||
*last = now;
|
||||
crate::terminal::emit_transfer(
|
||||
&progress_app,
|
||||
&super::ssh::sftp::TransferProgress {
|
||||
id: progress_id.clone(),
|
||||
session_id: sid_for_progress.clone(),
|
||||
direction: "relay".to_string(),
|
||||
source: src.clone(),
|
||||
target: dst.clone(),
|
||||
transferred: done,
|
||||
total,
|
||||
state: if done >= total { "done" } else { "running" }.to_string(),
|
||||
error: None,
|
||||
},
|
||||
);
|
||||
})
|
||||
.await
|
||||
{
|
||||
Ok(n) => n,
|
||||
Err(e) => {
|
||||
crate::terminal::emit_transfer(
|
||||
&app,
|
||||
&super::ssh::sftp::TransferProgress {
|
||||
id,
|
||||
session_id: sid,
|
||||
direction: "relay".to_string(),
|
||||
source: from_path,
|
||||
target: to_path,
|
||||
transferred: 0,
|
||||
total: 0,
|
||||
state: "failed".to_string(),
|
||||
error: Some(e.clone()),
|
||||
},
|
||||
);
|
||||
return Err(e);
|
||||
}
|
||||
};
|
||||
|
||||
Ok(ActionOutcome::ok(format!(
|
||||
"已中继 {} 字节到 {to_path}",
|
||||
sent
|
||||
)))
|
||||
}
|
||||
|
||||
/// 会话当前工作目录(供 SFTP 面板「跟随终端目录」)。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
@@ -2566,19 +2722,19 @@ pub async fn terminal_delete_template(
|
||||
Ok(m.settings().templates)
|
||||
}
|
||||
|
||||
// ===== AI 命令助手(P2,复用 translate 的 AI 引擎配置)=====
|
||||
// ===== AI 命令助手(P2,复用主设置的全局 AI 供应商)=====
|
||||
|
||||
/// 列出可用于命令生成的 AI 引擎(来自翻译设置;按优先级排序)。
|
||||
/// 列出可用于命令生成的 AI 供应商(来自主设置 → AI 服务;按优先级排序)。
|
||||
///
|
||||
/// 没有可用引擎时返回空列表——前端据此引导用户去翻译设置里配置,
|
||||
/// 没有可用供应商时返回空列表——前端据此引导用户去主设置里配置,
|
||||
/// 而不是在点击「生成」后才报错。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub async fn terminal_ai_engines(
|
||||
app: AppHandle,
|
||||
) -> Result<Vec<assistant::AiEngineOption>, String> {
|
||||
let tm = app.state::<crate::translate::TranslateManager>();
|
||||
let s = tm.load_settings();
|
||||
let ai = app.state::<crate::ai::AiManager>();
|
||||
let s = ai.load_settings();
|
||||
Ok(assistant::ai_engine_options(&s))
|
||||
}
|
||||
|
||||
@@ -2594,16 +2750,15 @@ pub async fn terminal_ai_suggest(
|
||||
intent: String,
|
||||
context: String,
|
||||
) -> Result<Vec<assistant::CommandSuggestion>, String> {
|
||||
let tm = app.state::<crate::translate::TranslateManager>();
|
||||
let s = tm.load_settings();
|
||||
let ai = app.state::<crate::ai::AiManager>();
|
||||
let s = ai.load_settings();
|
||||
let engine = s
|
||||
.engines
|
||||
.iter()
|
||||
.find(|e| e.id == engine_id && e.kind == "ai")
|
||||
.provider(&engine_id)
|
||||
.cloned()
|
||||
.ok_or_else(|| "所选引擎不存在或不是 AI 类型".to_string())?;
|
||||
.ok_or_else(|| "所选 AI 供应商不存在".to_string())?;
|
||||
|
||||
let suggestions = assistant::suggest(&engine, &intent, &context).await?;
|
||||
let data_dir = ai.data_dir().to_path_buf();
|
||||
let suggestions = assistant::suggest(&engine, &intent, &context, &s, &data_dir).await?;
|
||||
crate::logger::log_info(
|
||||
"terminal",
|
||||
&format!(
|
||||
|
||||
@@ -0,0 +1,240 @@
|
||||
//! 本地文件系统:SFTP 面板「本地栏」的后端。
|
||||
//!
|
||||
//! # 为什么本地栏最终还是要自己列目录
|
||||
//!
|
||||
//! 面板最初的设计是「本地栏只做定位与选取,浏览交给系统资源管理器」。这条取舍
|
||||
//! 在**单向上传**的场景下成立,但只要用户想「先看看本地目录里有什么、挑几个传上去」,
|
||||
//! 就会出现一条断头路:系统对话框只能一次性选出文件,选完就没了,
|
||||
//! 既不能进目录翻找,也不能就地改名/删除。
|
||||
//!
|
||||
//! 代价评估(决定落地):`read_dir` + `create_dir` + `rename` + 回收站删除
|
||||
//! 是四个薄封装,不引入任何依赖;而浏览体验与远端栏**完全对称**,
|
||||
//! 用户不需要为「左边和右边为什么不一样」建立两套心智模型。
|
||||
//!
|
||||
//! # 与远端栏的一处刻意不对称
|
||||
//!
|
||||
//! 远端 `kind` 里 `symlink` 是独立取值(SFTP 的 `attrs` 普遍不带目标类型,
|
||||
//! 判定链接指向什么要再发一次请求)。本地这边 `symlink_metadata` + `metadata`
|
||||
//! 两次调用就能**免费**拿到解析结果,因此 `kind` 一律是**解析后**的类型
|
||||
//! (`dir` / `file` / `other`),是不是链接另由 `linkTarget` 表达。
|
||||
//! 这样「双击进目录」「这个文件能不能上传」判断逻辑两边一致。
|
||||
//!
|
||||
//! # 安全边界
|
||||
//!
|
||||
//! 路径来自面板里用户自己的输入/浏览,不做「限制在某个根目录下」的约束 ——
|
||||
//! 这是本地文件管理器,限制根目录只会挡住用户自己。唯一的硬守卫是
|
||||
//! **拒绝删除盘符根**(见 [`delete`])。
|
||||
|
||||
use std::path::Path;
|
||||
use std::time::UNIX_EPOCH;
|
||||
|
||||
use serde::{Deserialize, Serialize};
|
||||
use specta::Type;
|
||||
|
||||
/// 一个本地目录项(回传前端渲染)。
|
||||
#[derive(Debug, Clone, Serialize, Deserialize, Type)]
|
||||
#[serde(rename_all = "camelCase")]
|
||||
pub struct LocalEntry {
|
||||
pub name: String,
|
||||
/// 完整路径(本地形态,Windows 下用 `\` 分隔)
|
||||
pub path: String,
|
||||
/// "dir" | "file" | "other"(符号链接返回**目标**的类型,见模块注释)
|
||||
pub kind: String,
|
||||
/// 字节数;目录为 0(前端显示为「—」)
|
||||
pub size: u64,
|
||||
/// 修改时间(Unix 毫秒;系统未提供时为 None)
|
||||
pub modified_at: Option<u64>,
|
||||
/// 符号链接的目标(非链接为 None)
|
||||
pub link_target: Option<String>,
|
||||
}
|
||||
|
||||
/// 目录列举结果。
|
||||
#[derive(Debug, Clone, Serialize, Deserialize, Type)]
|
||||
#[serde(rename_all = "camelCase")]
|
||||
pub struct LocalDir {
|
||||
/// 规范化之后的目录(`canonicalize` 结果,已去掉 Windows 的 `\\?\` 前缀)
|
||||
pub cwd: String,
|
||||
/// 父目录;已是盘符根时为 None(前端据此禁用「上一级」)
|
||||
pub parent: Option<String>,
|
||||
pub entries: Vec<LocalEntry>,
|
||||
}
|
||||
|
||||
/// 列举本地目录。`path` 为空时用用户主目录(面板首次打开的落点)。
|
||||
pub fn list_dir(path: &str) -> Result<LocalDir, String> {
|
||||
let requested = if path.trim().is_empty() {
|
||||
dirs::home_dir().ok_or_else(|| "无法确定用户主目录".to_string())?
|
||||
} else {
|
||||
let p = Path::new(path.trim());
|
||||
p.to_path_buf()
|
||||
};
|
||||
|
||||
// 规范化:把用户手输的 `C:\a\..\b`、尾部斜杠、符号链接目录统一成真实位置。
|
||||
// 失败(不存在 / 无权限)时直接报错 —— 继续读也是同一个错误,早失败信息更准。
|
||||
let dir = std::fs::canonicalize(&requested)
|
||||
.map_err(|e| format!("打开目录 {} 失败: {e}", display_path(&requested)))?;
|
||||
|
||||
let rd = std::fs::read_dir(&dir).map_err(|e| format!("读取目录 {} 失败: {e}", display_path(&dir)))?;
|
||||
|
||||
let mut entries: Vec<LocalEntry> = Vec::new();
|
||||
for item in rd {
|
||||
// 单个目录项读取失败(权限/竞态删除)不该让整次列举失败:跳过它,
|
||||
// 列表照常给出 —— 用户看到少一项,好过看到「读取目录失败」
|
||||
let Ok(item) = item else { continue };
|
||||
let name = item.file_name().to_string_lossy().to_string();
|
||||
let full = item.path();
|
||||
|
||||
// `symlink_metadata` 不跟随链接,用它判断「这条是不是链接」;
|
||||
// 再用 `metadata` 拿目标的类型与大小。
|
||||
let Ok(link_meta) = item.metadata() else { continue };
|
||||
let is_link = link_meta.file_type().is_symlink();
|
||||
let link_target = if is_link {
|
||||
std::fs::read_link(&full).ok().map(|t| display_path(&t))
|
||||
} else {
|
||||
None
|
||||
};
|
||||
// 目标不可达(悬空链接 / 无权限)时退回「other」而不是报错
|
||||
let target_meta = if is_link { std::fs::metadata(&full).ok() } else { None };
|
||||
let meta = target_meta.as_ref().unwrap_or(&link_meta);
|
||||
|
||||
let kind = if meta.is_dir() {
|
||||
"dir"
|
||||
} else if meta.is_file() {
|
||||
"file"
|
||||
} else {
|
||||
"other"
|
||||
};
|
||||
|
||||
let size = if meta.is_file() { meta.len() } else { 0 };
|
||||
let modified_at = meta
|
||||
.modified()
|
||||
.ok()
|
||||
.and_then(|t| t.duration_since(UNIX_EPOCH).ok())
|
||||
.map(|d| d.as_millis() as u64);
|
||||
|
||||
entries.push(LocalEntry {
|
||||
name,
|
||||
path: display_path(&full),
|
||||
kind: kind.to_string(),
|
||||
size,
|
||||
modified_at,
|
||||
link_target,
|
||||
});
|
||||
}
|
||||
|
||||
// 排序与远端栏同一口径:目录优先,其次按名称(不区分大小写)
|
||||
entries.sort_by(|a, b| {
|
||||
let a_dir = a.kind == "dir";
|
||||
let b_dir = b.kind == "dir";
|
||||
b_dir
|
||||
.cmp(&a_dir)
|
||||
.then_with(|| a.name.to_lowercase().cmp(&b.name.to_lowercase()))
|
||||
});
|
||||
|
||||
Ok(LocalDir {
|
||||
cwd: display_path(&dir),
|
||||
parent: dir.parent().map(display_path),
|
||||
entries,
|
||||
})
|
||||
}
|
||||
|
||||
/// 创建目录(递归,允许用户输入 `a/b`)。
|
||||
pub fn create_dir(path: &str) -> Result<(), String> {
|
||||
std::fs::create_dir_all(path).map_err(|e| format!("创建目录 {path} 失败: {e}"))
|
||||
}
|
||||
|
||||
/// 重命名 / 移动。
|
||||
pub fn rename(from: &str, to: &str) -> Result<(), String> {
|
||||
if Path::new(to).exists() {
|
||||
return Err(format!("{to} 已存在"));
|
||||
}
|
||||
std::fs::rename(from, to).map_err(|e| format!("重命名失败: {e}"))
|
||||
}
|
||||
|
||||
/// 删除若干个本地项(移入回收站,不是永久删除)。
|
||||
///
|
||||
/// # 复用 quickpanel 的实现
|
||||
///
|
||||
/// 回收站的落地方案(PowerShell + `Microsoft.VisualBasic.FileIO.FileSystem`
|
||||
/// 的 `SendToRecycleBin`)在 quickpanel 模块里已经处理过「目录/文件分流」
|
||||
/// 与「不弹出系统错误对话框」这些细节,这里直接复用而不重写一份 ——
|
||||
/// 两份实现最大的风险不是重复代码,而是**某一份漏掉 `FOF_ALLOWUNDO` 等价物
|
||||
/// 变成永久删除**,那种差异没人会去比对。
|
||||
///
|
||||
/// # 唯一的硬守卫:盘符根不可删
|
||||
///
|
||||
/// UI 上「上一级」到 `C:\` 就会停在根目录,删除按钮在此期间仍然可用。
|
||||
/// 若不加判断,`C:\` 会走到「递归删除驱动器」上 —— 这是**不可恢复的数据事故**,
|
||||
/// 因此这里在进入实现之前就挡住(`"\\.\C:"` 这类形态没有 `parent`,同样命中)。
|
||||
///
|
||||
/// # 返回值
|
||||
///
|
||||
/// `(成功数, 失败明细)`。批量删除里单个失败不该中断其余项 —— 用户选中的 10 个
|
||||
/// 文件里有一个正被占用,另外 9 个仍然应该删掉。
|
||||
pub fn delete(paths: &[String]) -> (usize, Vec<String>) {
|
||||
let mut removed = 0usize;
|
||||
let mut failed: Vec<String> = Vec::new();
|
||||
|
||||
for path in paths {
|
||||
let p = Path::new(path);
|
||||
if p.parent().is_none() {
|
||||
failed.push(format!("{path}:盘符根目录不可删除"));
|
||||
continue;
|
||||
}
|
||||
if !p.exists() {
|
||||
failed.push(format!("{path}:路径不存在"));
|
||||
continue;
|
||||
}
|
||||
match crate::quickpanel::commands::delete_file_impl(path) {
|
||||
Ok(()) => removed += 1,
|
||||
Err(e) => failed.push(format!("{path}:{e}")),
|
||||
}
|
||||
}
|
||||
|
||||
(removed, failed)
|
||||
}
|
||||
|
||||
/// 把路径转成「能给人看、也能回传给其他接口」的字符串。
|
||||
///
|
||||
/// `canonicalize` 在 Windows 上返回 `\\?\C:\...` 扩展长度前缀:它对本进程的
|
||||
/// `std::fs` 可用,但对 `ShellExecuteW`、系统对话框、`explorer /select` 一律不认。
|
||||
/// 面板要把这个字符串回传给「用默认程序打开 / 在资源管理器中显示 / 上传源路径」,
|
||||
/// 因此统一在这里剥掉前缀。
|
||||
pub fn display_path(p: &Path) -> String {
|
||||
let s = p.to_string_lossy().to_string();
|
||||
match s.strip_prefix(r"\\?\") {
|
||||
Some(rest) => rest.to_string(),
|
||||
None => s,
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
/// 盘符根必须被拒(`parent()` 为 None),其余路径不受守卫影响 ——
|
||||
/// 这条守卫的失效后果是递归删除整个驱动器,必须锁住。
|
||||
#[test]
|
||||
fn delete_refuses_drive_root() {
|
||||
#[cfg(windows)]
|
||||
{
|
||||
let (removed, failed) = delete(&[r"C:\".to_string()]);
|
||||
assert_eq!(removed, 0);
|
||||
assert!(failed[0].contains("盘符根目录不可删除"), "{failed:?}");
|
||||
}
|
||||
}
|
||||
|
||||
/// 列举主目录必须真的返回条目与规范化后的 cwd(不带 `\\?\` 前缀)。
|
||||
#[test]
|
||||
fn list_dir_home_returns_entries() {
|
||||
let d = list_dir("").expect("主目录应可列举");
|
||||
assert!(!d.cwd.is_empty());
|
||||
assert!(!d.cwd.starts_with(r"\\?\"), "cwd 不应带扩展长度前缀: {}", d.cwd);
|
||||
assert!(!d.entries.is_empty(), "主目录不该是空的");
|
||||
// 排序口径:目录优先
|
||||
let first_file = d.entries.iter().position(|e| e.kind != "dir");
|
||||
let last_dir = d.entries.iter().rposition(|e| e.kind == "dir");
|
||||
if let (Some(f), Some(l)) = (first_file, last_dir) {
|
||||
assert!(l < f, "目录必须排在文件之前");
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -8,6 +8,7 @@
|
||||
//! | [`pty::conpty`] | 本地 ConPTY 后端(含三个已知坑的处理) |
|
||||
//! | [`shell`] | Shell 探测、命令行组装、OSC 7 cwd 跟踪 |
|
||||
//! | [`ssh`] | SSH 后端(russh)、认证、主机密钥校验、SFTP |
|
||||
//! | [`local_fs`] | 本地文件系统(SFTP 面板本地栏的列举/新建/重命名/删除) |
|
||||
//! | [`keys`] | SSH 密钥生成/导入/管理 |
|
||||
//! | [`settings`] | 设置模型与默认值(容器级 `#[serde(default)]`) |
|
||||
//! | [`events`] | 事件负载类型 |
|
||||
@@ -44,6 +45,7 @@ pub mod encoding;
|
||||
pub mod events;
|
||||
pub mod history;
|
||||
pub mod keys;
|
||||
pub mod local_fs;
|
||||
pub mod pty;
|
||||
pub mod session;
|
||||
pub mod settings;
|
||||
|
||||
@@ -955,11 +955,25 @@ fn strip_leading_label(s: &str) -> Option<&str> {
|
||||
Some(s[idx..].trim_start_matches(|c| c == ':' || c == ':' || c == ' '))
|
||||
}
|
||||
|
||||
/// 从 OSC 7 的载荷解析出本地路径。
|
||||
/// 从 OSC 7 的载荷解析出路径。
|
||||
///
|
||||
/// 载荷形如 `file://HOST/C:/Users/foo` 或 `file:///home/user`。
|
||||
/// Windows 上要处理 `file://HOST/C:/...` → `C:\...` 的还原:
|
||||
/// 去掉开头的 `/`,把 `/` 换回 `\`,并把 `C:` 前面的多余斜杠去掉。
|
||||
/// 载荷形如 `file://HOST/PATH`,而 `PATH` 的形态由**上报它的 shell 所在系统**决定:
|
||||
///
|
||||
/// - Windows 侧(本项目的 PowerShell hook、Windows Terminal 一类)
|
||||
/// 上报 `/C:/Users/foo` —— 盘符前多一个 `/`,须还原成 `C:\Users\foo`;
|
||||
/// - POSIX 侧(远端 bash/zsh、WSL、Git Bash)上报 `/home/ops`。
|
||||
/// 这是**对面系统的真实路径**,只能原样保留。
|
||||
///
|
||||
/// # 这里曾经把 POSIX 路径也换成了反斜杠(已修)
|
||||
///
|
||||
/// 早先的写法是「非盘符形态就 `replace('/', "\\")`」,于是远端上报的
|
||||
/// `/home/Atie` 被存成 `\home\Atie`。后果不是「显示得不好看」:文件管理器
|
||||
/// 拿这个字符串去 SFTP `read_dir`,服务端直接回 `No such file`,
|
||||
/// 现象是「SSH 会话的远端目录永远列不出来」——而真正的原因(一次无害的
|
||||
/// 斜杠替换)与现象之间隔着 OSC 解析、会话状态、SFTP 三层,最难查。
|
||||
///
|
||||
/// 因此判据收紧到**只有盘符形态才动路径**:`^/[A-Za-z]:` 之外一律原样返回。
|
||||
/// `ssh/mod.rs` 里「远端路径是 POSIX 形态」的假设由此才真正成立。
|
||||
fn parse_osc7(payload: &str) -> Option<String> {
|
||||
let rest = payload.strip_prefix("file://").unwrap_or(payload);
|
||||
// 跳过主机名(第一个 '/' 之前的部分)
|
||||
@@ -971,16 +985,15 @@ fn parse_osc7(payload: &str) -> Option<String> {
|
||||
return None;
|
||||
}
|
||||
let decoded = percent_decode(path_part);
|
||||
// Windows 盘符形态:/C:/Users → C:\Users
|
||||
let normalized = if decoded.len() >= 3
|
||||
// Windows 盘符形态:/C:/Users → C:\Users(去掉盘符前那个多余的 `/`)
|
||||
let drive_form = decoded.len() >= 3
|
||||
&& decoded.starts_with('/')
|
||||
&& decoded.as_bytes()[2] == b':'
|
||||
{
|
||||
&& decoded.as_bytes()[2] == b':';
|
||||
Some(if drive_form {
|
||||
decoded[1..].replace('/', "\\")
|
||||
} else {
|
||||
decoded.replace('/', "\\")
|
||||
};
|
||||
Some(normalized)
|
||||
decoded
|
||||
})
|
||||
}
|
||||
|
||||
/// 极简百分号解码(OSC 7 里的路径可能含 `%20` 等)。
|
||||
@@ -1055,6 +1068,23 @@ mod tests {
|
||||
assert_eq!(p.consumed, stream.len(), "完整序列应全部被消费");
|
||||
}
|
||||
|
||||
/// OSC 7 的路径形态必须按**上报方**区分:Windows 盘符还原成 `\`,
|
||||
/// POSIX 路径原样保留。
|
||||
///
|
||||
/// 这条守着「SSH 会话的远端目录永远列不出来」那个 bug:曾经对所有非盘符
|
||||
/// 路径都做了 `/` → `\` 替换,`/home/Atie` 变成 `\home\Atie`,
|
||||
/// SFTP 服务端直接回 `No such file`。
|
||||
#[test]
|
||||
fn parse_osc7_kind_by_reporter() {
|
||||
// POSIX(远端 bash/zsh)与 Git Bash:原样保留
|
||||
assert_eq!(parse_osc7("file://host/home/Atie").unwrap(), "/home/Atie");
|
||||
assert_eq!(parse_osc7("file:///home/atie/proj").unwrap(), "/home/atie/proj");
|
||||
// Windows 盘符:还原成本地形态
|
||||
assert_eq!(parse_osc7("file://host/C:/Users/foo").unwrap(), "C:\\Users\\foo");
|
||||
// 百分号编码仍要解码(路径里可能含空格)
|
||||
assert_eq!(parse_osc7("file://host/home/a%20b").unwrap(), "/home/a b");
|
||||
}
|
||||
|
||||
/// 序列被切在两批数据之间时必须保留尾部,等下一批拼接后再解析 ——
|
||||
/// 否则 `Cmd` 与 `D` 各被截断一次,历史同样一条不记。
|
||||
#[test]
|
||||
|
||||
@@ -93,7 +93,7 @@ pub struct TransferProgress {
|
||||
/// 传输任务 id(前端据此更新对应行的进度条)
|
||||
pub id: String,
|
||||
pub session_id: String,
|
||||
/// "upload" | "download"
|
||||
/// "upload"(本地→远端)| "download"(远端→本地)| "relay"(远端→远端)
|
||||
pub direction: String,
|
||||
/// 源路径(展示用)
|
||||
pub source: String,
|
||||
@@ -656,6 +656,91 @@ pub async fn download_file(
|
||||
Ok(got)
|
||||
}
|
||||
|
||||
/// 在两个 SSH 会话之间**流式中继**一个文件(ssh → ssh)。
|
||||
///
|
||||
/// # 为什么不走「下载到本地再上传」
|
||||
///
|
||||
/// 双远端传输是文件面板里的常用动作(把构建产物从跳板机搬到目标机)。中转方案
|
||||
/// 有三个实际代价:本地磁盘要有 ≥ 文件大小的空间;链路被走两遍(本机成了不必要
|
||||
/// 的中转站);临时文件的清理时机还得再定一套规则。中继只搬一次:
|
||||
/// 从源会话按块读、直接写进目标会话,本地只留一个 [`CHUNK_SIZE`] 缓冲。
|
||||
///
|
||||
/// # 为什么只取目标侧的并发许可
|
||||
///
|
||||
/// `semaphore` 限制的是「同时在跑的传输数」。中继严格对称地占源、目标两把信号量
|
||||
/// 会在两个方向的中继同时进行时成环(A 持源等目标、B 持目标等源)。这里只取
|
||||
/// **目标**侧:会把服务端窗口打满的始终是写入方,而中继本身是低频动作
|
||||
/// (人点一次搬一个文件)。
|
||||
///
|
||||
/// # 不做断点续传
|
||||
///
|
||||
/// 上传/下载能续传是因为本地侧有文件可以比对大小;中继的两端都不在本地,
|
||||
/// 没有可信的进度锚点。目标文件一律 `TRUNCATE` 重写 —— 与上传「远端已有更大文件
|
||||
/// 时退回整文件重传」同一取舍:宁可重传,不能写出一半新一半旧的损坏文件。
|
||||
pub async fn relay_file(
|
||||
from: &SftpHandle,
|
||||
from_path: &str,
|
||||
to: &SftpHandle,
|
||||
to_path: &str,
|
||||
on_progress: impl Fn(u64, u64),
|
||||
) -> Result<u64, String> {
|
||||
let _permit = to
|
||||
.semaphore
|
||||
.acquire()
|
||||
.await
|
||||
.map_err(|e| format!("获取传输许可失败: {e}"))?;
|
||||
|
||||
let total = from
|
||||
.sftp
|
||||
.metadata(from_path)
|
||||
.await
|
||||
.ok()
|
||||
.and_then(|m| m.size)
|
||||
.unwrap_or(0);
|
||||
|
||||
let mut src = from
|
||||
.sftp
|
||||
.open(from_path)
|
||||
.await
|
||||
.map_err(|e| format!("打开源文件 {from_path} 失败: {e}"))?;
|
||||
let mut dst = to
|
||||
.sftp
|
||||
.open_with_flags(
|
||||
to_path,
|
||||
OpenFlags::WRITE | OpenFlags::CREATE | OpenFlags::TRUNCATE,
|
||||
)
|
||||
.await
|
||||
.map_err(|e| format!("创建目标文件 {to_path} 失败: {e}"))?;
|
||||
|
||||
let mut buf = vec![0u8; CHUNK_SIZE];
|
||||
let mut sent = 0u64;
|
||||
on_progress(0, total);
|
||||
|
||||
loop {
|
||||
let n = src
|
||||
.read(&mut buf)
|
||||
.await
|
||||
.map_err(|e| format!("读取源文件失败: {e}"))?;
|
||||
if n == 0 {
|
||||
break;
|
||||
}
|
||||
dst.write_all(&buf[..n])
|
||||
.await
|
||||
.map_err(|e| format!("写入目标文件失败: {e}"))?;
|
||||
sent += n as u64;
|
||||
on_progress(sent, total);
|
||||
}
|
||||
|
||||
// 目标必须 `shutdown`(发 CLOSE,见 `upload_file` 的说明);源只是读,
|
||||
// 但同样显式关掉句柄,免得服务端一直留着一个打开的文件描述符。
|
||||
dst.shutdown()
|
||||
.await
|
||||
.map_err(|e| format!("关闭目标文件失败(数据可能未完整落盘): {e}"))?;
|
||||
let _ = src.shutdown().await;
|
||||
|
||||
Ok(sent)
|
||||
}
|
||||
|
||||
/// 类型占位:确保 `SshHandler` 与 `Handle<SshHandler>` 的关联在编译期成立。
|
||||
#[allow(dead_code)]
|
||||
fn _assert_handle_type(h: &Handle<SshHandler>) -> &Handle<SshHandler> {
|
||||
|
||||
@@ -129,6 +129,55 @@ pub fn close_for_session(app: &AppHandle, session_id: &SessionId) -> Result<(),
|
||||
Ok(())
|
||||
}
|
||||
|
||||
/// 打开(或唤出)**文件管理器独立窗口**。
|
||||
///
|
||||
/// # 为什么是单例而不是「每会话一个窗口」
|
||||
///
|
||||
/// 终端窗口的粒度是会话(「把某个会话拖出来放大盯」),而文件管理器窗口的粒度是
|
||||
/// **两台机器之间的关系**(本地 ↔ ssh1、ssh1 ↔ ssh2…)—— 左右两栏各自选择连接,
|
||||
/// 所以同一时刻只该存在一个:开第二个只会让两边显示同一份状态,
|
||||
/// 用户还得记住自己改的是哪一个。label 因此固定为 [`W::FILE_WINDOW`],
|
||||
/// 幂等打开(已存在则 show + focus)。
|
||||
///
|
||||
/// # 不绑定会话意味着什么都不用清理
|
||||
///
|
||||
/// 窗口关闭时不需要重置任何会话标记(对比 [`open_for_session`]):它没有 detached
|
||||
/// 之类的状态要维护,两栏的连接选择留在窗口内存在即弃 —— 下次打开回到默认
|
||||
/// (左本地、右首个 SSH 会话)。SFTP 通道由 Rust 侧的会话注册表持有,
|
||||
/// 会话关闭时随会话一起回收(见 `TerminalManager::remove_session`)。
|
||||
pub fn open_file_window(app: &AppHandle) -> Result<(), String> {
|
||||
if let Some(win) = app.get_webview_window(W::FILE_WINDOW) {
|
||||
// 可能是被最小化的:show 会还原,再聚焦
|
||||
win.show().map_err(|e| format!("显示文件窗口失败: {e}"))?;
|
||||
win.set_focus().map_err(|e| format!("聚焦文件窗口失败: {e}"))?;
|
||||
return Ok(());
|
||||
}
|
||||
|
||||
WebviewWindowBuilder::new(
|
||||
app,
|
||||
W::FILE_WINDOW,
|
||||
// 路由到前端的文件窗口入口(main.ts 中按 hash 分派)
|
||||
WebviewUrl::App("index.html#file-window".into()),
|
||||
)
|
||||
.title("文件 · Thing")
|
||||
// 双栏 + 四列信息,比终端窗口更宽;高度取常见笔记本的可视高度
|
||||
.inner_size(1180.0, 720.0)
|
||||
.min_inner_size(720.0, 420.0)
|
||||
.resizable(true)
|
||||
// 与终端窗口同款:无系统边框,窗口内自绘控制栏
|
||||
.decorations(false)
|
||||
.shadow(true)
|
||||
.center()
|
||||
// **隐藏创建**:由 FileWindow.vue 应用完主题(含 setBackgroundColor)再 show,
|
||||
// 否则深色模式下会先闪一下纯白窗口。理由与 `open_for_session` 完全一致。
|
||||
.visible(false)
|
||||
.focused(false)
|
||||
.build()
|
||||
.map_err(|e| format!("创建文件窗口失败: {e}"))?;
|
||||
|
||||
Ok(())
|
||||
}
|
||||
|
||||
/// 把会话的 `detached` 标记与窗口状态对齐。
|
||||
///
|
||||
/// 应用启动后(或窗口被外部关闭后)可能存在不一致:标记说已分离但窗口不在。
|
||||
|
||||
@@ -17,7 +17,7 @@ use tauri::{AppHandle, Manager, State};
|
||||
use super::engines::{EngineRequest, ErrorKind, TranslateError, TranslateMode, TranslateResult};
|
||||
use super::history::HistoryItem;
|
||||
use super::settings::TranslateEngineConfig;
|
||||
use super::{engine_api_key, engine_secret_key, popup, TranslateManager, TranslateSettings};
|
||||
use super::{engine_secret_key, popup, TranslateManager, TranslateSettings};
|
||||
|
||||
/// 引擎实例的前端视图:配置 + 派生状态(密钥是否已配、是否可用)。
|
||||
///
|
||||
@@ -154,21 +154,22 @@ pub fn translate_popup_prefs_set(
|
||||
|
||||
// ===== 引擎管理 =====
|
||||
|
||||
/// 列出引擎实例(含密钥状态与可用性)
|
||||
/// 列出引擎实例(含密钥状态与可用性)。
|
||||
///
|
||||
/// 返回**本模块 free/cloud 引擎 + 全局 AI 供应商**(AI 转换为 kind = "ai"),
|
||||
/// 供工作台选择与「默认引擎」下拉使用。AI 的增删改走主设置 → AI 服务。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub async fn translate_engines_list(
|
||||
state: State<'_, TranslateManager>,
|
||||
) -> Result<Vec<EngineView>, String> {
|
||||
let settings = state.load_settings();
|
||||
Ok(settings
|
||||
.engines
|
||||
.iter()
|
||||
.map(|cfg| to_view(cfg))
|
||||
.collect())
|
||||
Ok(state.all_engines().iter().map(to_view).collect())
|
||||
}
|
||||
|
||||
/// 新增或更新一个引擎实例(按 id upsert)。
|
||||
/// 新增或更新一个**非 AI** 引擎实例(按 id upsert)。
|
||||
///
|
||||
/// AI 引擎(kind = "ai")由主设置 → AI 服务管理,这里显式拒绝,
|
||||
/// 避免出现「翻译设置里改了一份、主设置里还是旧的」的双源分裂。
|
||||
///
|
||||
/// 校验 id:它会进入凭据键(`translate-engine-<id>`),含特殊字符会让键名难以排查,
|
||||
/// 因此限定为字母/数字/下划线/短横线。
|
||||
@@ -178,6 +179,11 @@ pub fn translate_engine_save(
|
||||
state: State<'_, TranslateManager>,
|
||||
config: TranslateEngineConfig,
|
||||
) -> Result<(), String> {
|
||||
if config.kind == "ai" {
|
||||
return Err(
|
||||
"AI 引擎已移至「常规设置 → AI 服务」统一管理,请到主设置中修改".to_string(),
|
||||
);
|
||||
}
|
||||
// 先把 id 取成自有值:下面要整体移动 config,不能再持有对 config.id 的借用
|
||||
let id = config.id.trim().to_string();
|
||||
if id.is_empty() {
|
||||
@@ -205,9 +211,13 @@ pub fn translate_engine_save(
|
||||
}
|
||||
|
||||
/// 删除引擎实例(连同它在系统凭据管理器中的密钥)。
|
||||
/// AI 引擎请到主设置 → AI 服务删除。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub fn translate_engine_delete(state: State<'_, TranslateManager>, id: String) -> Result<(), String> {
|
||||
if state.all_engines().iter().any(|e| e.id == id && e.kind == "ai") {
|
||||
return Err("AI 引擎请在「常规设置 → AI 服务」中删除".to_string());
|
||||
}
|
||||
let mut settings = state.load_settings();
|
||||
let before = settings.engines.len();
|
||||
settings.engines.retain(|e| e.id != id);
|
||||
@@ -227,6 +237,8 @@ pub fn translate_engine_delete(state: State<'_, TranslateManager>, id: String) -
|
||||
}
|
||||
|
||||
/// 写入引擎的 API Key(明文只在此处进入系统凭据管理器,永不回写配置文件)。
|
||||
///
|
||||
/// AI 供应商的 Key 写 `ai-provider-*`;free/cloud 写 `translate-engine-*`。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub fn translate_secret_set(
|
||||
@@ -234,10 +246,16 @@ pub fn translate_secret_set(
|
||||
id: String,
|
||||
api_key: String,
|
||||
) -> Result<(), String> {
|
||||
if state.load_settings().engine(&id).is_none() {
|
||||
return Err(format!("找不到引擎实例「{id}」"));
|
||||
}
|
||||
let key = engine_secret_key(&id);
|
||||
let engines = state.all_engines();
|
||||
let cfg = engines
|
||||
.iter()
|
||||
.find(|e| e.id == id)
|
||||
.ok_or_else(|| format!("找不到引擎实例「{id}」"))?;
|
||||
let key = if cfg.kind == "ai" {
|
||||
crate::ai::provider_secret_key(&id)
|
||||
} else {
|
||||
engine_secret_key(&id)
|
||||
};
|
||||
let value = api_key.trim();
|
||||
if value.is_empty() {
|
||||
return crate::secrets::secret_delete(&key);
|
||||
@@ -245,11 +263,83 @@ pub fn translate_secret_set(
|
||||
crate::secrets::secret_write(&key, value)
|
||||
}
|
||||
|
||||
/// 清除引擎的 API Key
|
||||
/// 清除引擎的 API Key(按 kind 选凭据键,与 write 对称)。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub fn translate_secret_clear(id: String) -> Result<(), String> {
|
||||
crate::secrets::secret_delete(&engine_secret_key(&id))
|
||||
pub fn translate_secret_clear(
|
||||
state: State<'_, TranslateManager>,
|
||||
id: String,
|
||||
) -> Result<(), String> {
|
||||
let engines = state.all_engines();
|
||||
let is_ai = engines.iter().any(|e| e.id == id && e.kind == "ai");
|
||||
let key = if is_ai {
|
||||
crate::ai::provider_secret_key(&id)
|
||||
} else {
|
||||
engine_secret_key(&id)
|
||||
};
|
||||
crate::secrets::secret_delete(&key)
|
||||
}
|
||||
|
||||
/// 把某个全局 AI 供应商加入翻译候选,或更新它的**翻译场景参数**(启用 / 优先级 / 超时 / 提示词)。
|
||||
///
|
||||
/// 连接配置(Base URL、模型、密钥)在主设置 → AI 服务;这里只写 translate 自己的编排语义。
|
||||
/// 首次调用即「加入」——`ai_params` 有记录就代表该供应商参与翻译候选。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub fn translate_ai_params_save(
|
||||
state: State<'_, TranslateManager>,
|
||||
params: super::TranslateAiParams,
|
||||
) -> Result<(), String> {
|
||||
let id = params.provider_id.trim().to_string();
|
||||
if id.is_empty() {
|
||||
return Err("供应商标识不能为空".to_string());
|
||||
}
|
||||
let ai = crate::ai::AiManager::load_settings_sync(&state.data_dir);
|
||||
if ai.provider(&id).is_none() {
|
||||
return Err(format!(
|
||||
"全局 AI 供应商「{id}」不存在,请先在主设置 → AI 服务中配置"
|
||||
));
|
||||
}
|
||||
let mut settings = state.load_settings();
|
||||
let next = super::TranslateAiParams {
|
||||
provider_id: id,
|
||||
enabled: params.enabled,
|
||||
priority: params.priority,
|
||||
timeout_ms: params.timeout_ms.max(1_000),
|
||||
system_prompt: params.system_prompt,
|
||||
};
|
||||
match settings.ai_params_mut(&next.provider_id) {
|
||||
Some(slot) => *slot = next,
|
||||
None => settings.ai_params.push(next),
|
||||
}
|
||||
settings.ai_params.sort_by_key(|p| p.priority);
|
||||
state.save_settings(&settings)
|
||||
}
|
||||
|
||||
/// 把某个全局 AI 供应商**移出翻译候选**(供应商本身与它的密钥都不动)。
|
||||
///
|
||||
/// 只删 `ai_params` 里的这条记录。默认引擎指向它时改为「自动」——否则默认引擎会指向
|
||||
/// 一个已经不在候选里的 id,用户看到的是「设置对了但翻译报找不到引擎」。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub fn translate_ai_engine_remove(
|
||||
state: State<'_, TranslateManager>,
|
||||
provider_id: String,
|
||||
) -> Result<(), String> {
|
||||
let id = provider_id.trim().to_string();
|
||||
if id.is_empty() {
|
||||
return Err("供应商标识不能为空".to_string());
|
||||
}
|
||||
let mut settings = state.load_settings();
|
||||
let before = settings.ai_params.len();
|
||||
settings.ai_params.retain(|p| p.provider_id != id);
|
||||
if settings.ai_params.len() == before {
|
||||
return Err(format!("供应商「{id}」不在翻译候选里"));
|
||||
}
|
||||
if settings.default_engine_id == id {
|
||||
settings.default_engine_id = "auto".to_string();
|
||||
}
|
||||
state.save_settings(&settings)
|
||||
}
|
||||
|
||||
/// 连通性自检:用前端传入的配置测试(**不落盘**)。
|
||||
@@ -289,17 +379,17 @@ pub async fn translate_engine_test_config(
|
||||
}
|
||||
|
||||
/// 拉取上游模型列表(应对「上游改名」导致预设失效的自救入口)。
|
||||
/// 免密钥源没有模型概念,返回空列表。
|
||||
/// 免密钥源没有模型概念,返回空列表。AI 供应商从全局列表按 id 查找。
|
||||
#[tauri::command]
|
||||
#[specta::specta]
|
||||
pub async fn translate_engine_models(
|
||||
state: State<'_, TranslateManager>,
|
||||
id: String,
|
||||
) -> Result<Vec<String>, String> {
|
||||
let settings = state.load_settings();
|
||||
let cfg = settings
|
||||
.engine(&id)
|
||||
.cloned()
|
||||
let cfg = state
|
||||
.all_engines()
|
||||
.into_iter()
|
||||
.find(|e| e.id == id)
|
||||
.ok_or_else(|| format!("找不到引擎实例「{id}」"))?;
|
||||
let engine = state.build(&cfg).await.map_err(|e| e.message)?;
|
||||
engine.list_models().await.map_err(|e| e.message)
|
||||
@@ -488,7 +578,7 @@ pub async fn translate_screenshot_region(
|
||||
// ===== 视觉直译:跳过本地 OCR,识别 + 翻译一步完成 =====
|
||||
if sc.ocr_mode == "vision" {
|
||||
// 配置类失败也弹窗:覆盖层已隐藏,静默早退会让用户点了按钮毫无反应
|
||||
let cfg = match pick_vision_engine(&settings) {
|
||||
let cfg = match pick_vision_engine(&state, &settings) {
|
||||
Ok(c) => c,
|
||||
Err(e) => {
|
||||
popup::show_screenshot_error(
|
||||
@@ -699,23 +789,24 @@ fn crop_region_png_blocking(x: i32, y: i32, w: i32, h: i32) -> Result<Vec<u8>, T
|
||||
}
|
||||
|
||||
/// 视觉直译的引擎选择:优先默认引擎(若它声明支持图像输入),否则按优先级取第一个支持的。
|
||||
/// 候选来自「本模块引擎 + 已加入翻译候选的 AI 供应商」。
|
||||
fn pick_vision_engine(
|
||||
state: &TranslateManager,
|
||||
settings: &TranslateSettings,
|
||||
) -> Result<TranslateEngineConfig, TranslateError> {
|
||||
if let Some(cfg) = settings.engine(&settings.default_engine_id) {
|
||||
let all = state.all_engines();
|
||||
if let Some(cfg) = all.iter().find(|e| e.id == settings.default_engine_id) {
|
||||
if cfg.supports_vision && cfg.kind == "ai" {
|
||||
return Ok(cfg.clone());
|
||||
}
|
||||
}
|
||||
settings
|
||||
.engines
|
||||
.iter()
|
||||
all.into_iter()
|
||||
.filter(|c| c.supports_vision && c.kind == "ai" && c.enabled)
|
||||
.min_by_key(|c| c.priority)
|
||||
.cloned()
|
||||
.ok_or_else(|| {
|
||||
TranslateError::config(
|
||||
"视觉直译需要一个支持图像输入的引擎:请在引擎设置中勾选「支持图像输入」",
|
||||
"视觉直译需要一个支持图像输入的引擎:请在主设置 → AI 服务中勾选「图像输入」,\
|
||||
再在翻译设置里把它加入翻译候选",
|
||||
)
|
||||
})
|
||||
}
|
||||
@@ -1024,7 +1115,7 @@ fn failure(e: TranslateError, latency_ms: u64) -> EngineTestResult {
|
||||
fn to_view(
|
||||
cfg: &TranslateEngineConfig,
|
||||
) -> EngineView {
|
||||
let raw_key = engine_api_key(&cfg.id);
|
||||
let raw_key = super::engine_api_key_with_kind(&cfg.id, Some(cfg.kind.as_str()));
|
||||
let has_api_key = !raw_key.trim().is_empty();
|
||||
|
||||
let issue = match cfg.kind.as_str() {
|
||||
|
||||
@@ -75,8 +75,9 @@ impl AiEngine {
|
||||
}
|
||||
|
||||
/// 密钥只从系统凭据管理器读,不进配置文件、不经前端。
|
||||
/// AI 引擎走 `ai-provider-*`(含对旧 `translate-engine-*` 的回退)。
|
||||
fn api_key(cfg: &TranslateEngineConfig) -> String {
|
||||
crate::translate::engine_api_key(&cfg.id)
|
||||
crate::translate::engine_api_key_with_kind(&cfg.id, Some("ai"))
|
||||
}
|
||||
|
||||
fn require_key(cfg: &TranslateEngineConfig) -> Result<String, TranslateError> {
|
||||
@@ -592,70 +593,3 @@ struct ModelEntry {
|
||||
id: String,
|
||||
}
|
||||
|
||||
/// 通用(非翻译语义)的对话补全入口:供终端 AI 助手等模块复用引擎配置。
|
||||
///
|
||||
/// 与翻译路径共享端点归一(剥 `/chat/completions` 后缀)、密钥存取
|
||||
/// (凭据管理器)、`apply_common_params`(temperature / max_tokens / extra_body)
|
||||
/// 与响应解析,但 **消息由调用方全量给定**——这里不含任何翻译提示词语义。
|
||||
///
|
||||
/// 刻意做成关联函数而不是 `AiEngine` 的实例方法:调用方(终端助手)只持有
|
||||
/// `TranslateEngineConfig`,为它构造 `AiEngine` 还要 PromptTemplates 与 client,
|
||||
/// 属于无谓的耦合。
|
||||
pub async fn chat_once(
|
||||
cfg: &TranslateEngineConfig,
|
||||
messages: Vec<(&str, String)>,
|
||||
) -> Result<String, String> {
|
||||
let key = AiEngine::require_key(cfg).map_err(|e| e.to_string())?;
|
||||
let model = AiEngine::require_model(cfg).map_err(|e| e.to_string())?;
|
||||
let endpoint = AiEngine::chat_endpoint(cfg).map_err(|e| e.to_string())?;
|
||||
|
||||
let mut body = serde_json::Map::new();
|
||||
body.insert("model".to_string(), json!(model));
|
||||
body.insert("stream".to_string(), json!(false));
|
||||
body.insert(
|
||||
"messages".to_string(),
|
||||
json!(messages
|
||||
.into_iter()
|
||||
.map(|(role, content)| json!({ "role": role, "content": content }))
|
||||
.collect::<Vec<_>>()),
|
||||
);
|
||||
apply_common_params(&mut body, cfg);
|
||||
|
||||
let client = reqwest::Client::new();
|
||||
let resp = client
|
||||
.post(&endpoint)
|
||||
.bearer_auth(&key)
|
||||
.timeout(Duration::from_millis(cfg.timeout_ms.max(1000)))
|
||||
.json(&serde_json::Value::Object(body))
|
||||
.send()
|
||||
.await
|
||||
.map_err(|e| classify_reqwest(e, &cfg.name).to_string())?;
|
||||
|
||||
let status = resp.status();
|
||||
let raw = resp
|
||||
.text()
|
||||
.await
|
||||
.map_err(|e| format!("读取「{}」响应失败: {e}", cfg.name))?;
|
||||
if !status.is_success() {
|
||||
return Err(classify_http(status.as_u16(), &raw, &cfg.name, &model).to_string());
|
||||
}
|
||||
|
||||
let parsed: ChatResponse = serde_json::from_str(&raw)
|
||||
.map_err(|e| format!("「{}」响应不是预期的 JSON: {e}", cfg.name))?;
|
||||
if let Some(err) = parsed.error {
|
||||
let msg = err
|
||||
.message
|
||||
.filter(|m| !m.trim().is_empty())
|
||||
.unwrap_or_else(|| "上游返回了错误对象".to_string());
|
||||
return Err(format!("「{}」返回错误:{msg}", cfg.name));
|
||||
}
|
||||
|
||||
parsed
|
||||
.choices
|
||||
.into_iter()
|
||||
.next()
|
||||
.and_then(|c| c.message.content)
|
||||
.map(|s| s.trim().to_string())
|
||||
.filter(|s| !s.is_empty())
|
||||
.ok_or_else(|| format!("「{}」返回了空内容", cfg.name))
|
||||
}
|
||||
@@ -0,0 +1,246 @@
|
||||
//! 历史配置的一次性迁移:把「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}"))
|
||||
}
|
||||
+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 服务中配置供应商,\
|
||||
再到翻译设置里把它加入翻译候选,并启用至少一个引擎",
|
||||
)
|
||||
})
|
||||
}
|
||||
|
||||
/// 执行一次翻译(含自动降级)。
|
||||
|
||||
@@ -68,6 +68,57 @@ impl PromptTemplates {
|
||||
}
|
||||
}
|
||||
|
||||
/// 全局 AI 供应商在**翻译场景**下的参数。
|
||||
///
|
||||
/// 与 `ai` 模块的分工:AI 侧只存连接与生成参数(Base URL / 模型 / 最大输出 / 上下文);
|
||||
/// 优先级、超时、提示词覆盖是翻译自己的编排语义,留在本模块。
|
||||
///
|
||||
/// **列表即「已加入翻译候选的 AI 引擎」**:一条记录的存在就代表用户在主设置里选了这个
|
||||
/// 供应商来翻译(见 `TranslateManager::all_engines`)。供应商本身仍只存在于 AI 服务里,
|
||||
/// 这里只有 id 引用与场景参数——避免同一份连接配置出现两个真源。
|
||||
#[derive(Debug, Clone, Serialize, Deserialize, Type)]
|
||||
#[serde(rename_all = "camelCase", default)]
|
||||
pub struct TranslateAiParams {
|
||||
/// 对应全局 AI 供应商 id
|
||||
pub provider_id: String,
|
||||
/// 是否参与翻译候选(翻译侧开关)。
|
||||
///
|
||||
/// 与供应商自身的 `enabled` 是两层:那边是「这台机器是否允许用这个供应商」,
|
||||
/// 这边是「它在翻译里是否上场」。生效值 = 两者与。
|
||||
pub enabled: bool,
|
||||
/// 优先级(数值越小越先尝试;自动降级按序)
|
||||
pub priority: i32,
|
||||
/// 该供应商在翻译请求中的超时(毫秒)
|
||||
pub timeout_ms: u64,
|
||||
/// 自定义 system prompt;**非空时覆盖翻译模板**
|
||||
pub system_prompt: String,
|
||||
}
|
||||
|
||||
impl Default for TranslateAiParams {
|
||||
fn default() -> Self {
|
||||
Self {
|
||||
provider_id: String::new(),
|
||||
enabled: true,
|
||||
priority: 100,
|
||||
timeout_ms: 30_000,
|
||||
system_prompt: String::new(),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
impl TranslateAiParams {
|
||||
/// 按供应商 id 取参数(缺失时用默认值并带上 id)。
|
||||
pub fn for_provider(list: &[Self], provider_id: &str) -> Self {
|
||||
list.iter()
|
||||
.find(|p| p.provider_id == provider_id)
|
||||
.cloned()
|
||||
.unwrap_or_else(|| Self {
|
||||
provider_id: provider_id.to_string(),
|
||||
..Self::default()
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
/// 单个翻译引擎实例的配置。
|
||||
///
|
||||
/// 「实例」而非「类型」:同一类型可以配置多份(例如官方 API 与本地 Ollama 并存),
|
||||
@@ -129,31 +180,6 @@ impl Default for TranslateEngineConfig {
|
||||
}
|
||||
}
|
||||
|
||||
impl TranslateEngineConfig {
|
||||
/// 内置 DeepSeek 预设:默认引擎。模型标识取现行名 `deepseek-flash`
|
||||
/// (`deepseek-chat` / `deepseek-reasoner` 已于 2026-07-24 停用;`deepseek-v4-flash`
|
||||
/// 等旧名虽仍被受理,但请求已被路由到 V4.1-Flash,不适合再写进默认配置)。
|
||||
pub fn deepseek_default() -> Self {
|
||||
Self {
|
||||
id: "deepseek".to_string(),
|
||||
name: "DeepSeek Flash".to_string(),
|
||||
kind: "ai".to_string(),
|
||||
preset: "deepseek".to_string(),
|
||||
enabled: true,
|
||||
priority: 10,
|
||||
base_url: "https://api.deepseek.com".to_string(),
|
||||
model: "deepseek-flash".to_string(),
|
||||
temperature: 0.3,
|
||||
max_tokens: 4096,
|
||||
timeout_ms: 30_000,
|
||||
// 翻译场景用非思考模式:不写 thinking / reasoning_effort,换低延迟低费用
|
||||
system_prompt: String::new(),
|
||||
extra_body: None,
|
||||
supports_vision: false,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 划词翻译设置(P1 生效;结构在 P0 即定型,避免 P2 改数据结构)。
|
||||
///
|
||||
/// P2 重构说明:原「取词快捷键 Alt+T」「翻译剪贴板 Alt+Shift+T」已移除,
|
||||
@@ -324,8 +350,10 @@ pub struct TranslateSettings {
|
||||
/// **默认关闭**:自建 LibreTranslate 在境内、MyMemory 与 DeepSeek 均可直连,
|
||||
/// 不需要代理;仅当翻译服务部署在境外或直连被拦截时由用户显式打开。
|
||||
pub use_proxy: bool,
|
||||
/// 引擎实例列表
|
||||
/// 引擎实例列表(仅 free/cloud;AI 供应商在主设置,场景参数见 `ai_params`)
|
||||
pub engines: Vec<TranslateEngineConfig>,
|
||||
/// 全局 AI 供应商的翻译场景参数(优先级 / 超时 / 提示词覆盖)
|
||||
pub ai_params: Vec<TranslateAiParams>,
|
||||
pub selection: SelectionSettings,
|
||||
pub popup: PopupSettings,
|
||||
pub screenshot: ScreenshotSettings,
|
||||
@@ -338,10 +366,13 @@ impl Default for TranslateSettings {
|
||||
Self {
|
||||
version: 1,
|
||||
default_target: "zh-Hans".to_string(),
|
||||
default_engine_id: "deepseek".to_string(),
|
||||
// AI 引擎由主设置(ai 模块)统一管理;翻译侧默认只走「自动」,
|
||||
// 候选 = 本模块 free/cloud 引擎 + 全局 AI 供应商。
|
||||
default_engine_id: "auto".to_string(),
|
||||
auto_fallback: true,
|
||||
use_proxy: false,
|
||||
engines: vec![TranslateEngineConfig::deepseek_default()],
|
||||
engines: Vec::new(),
|
||||
ai_params: Vec::new(),
|
||||
selection: SelectionSettings::default(),
|
||||
popup: PopupSettings::default(),
|
||||
screenshot: ScreenshotSettings::default(),
|
||||
@@ -357,21 +388,27 @@ impl TranslateSettings {
|
||||
self.engines.iter().find(|e| e.id == id)
|
||||
}
|
||||
|
||||
/// 参与「自动」模式的引擎,按优先级升序。
|
||||
pub fn auto_candidates(&self) -> Vec<&TranslateEngineConfig> {
|
||||
let mut list: Vec<&TranslateEngineConfig> = self.engines.iter().filter(|e| e.enabled).collect();
|
||||
list.sort_by_key(|e| e.priority);
|
||||
list
|
||||
/// 全局 AI 供应商在翻译中的参数(缺失时默认 priority=100 / timeout=30s)。
|
||||
pub fn ai_params_for(&self, provider_id: &str) -> TranslateAiParams {
|
||||
TranslateAiParams::for_provider(&self.ai_params, provider_id)
|
||||
}
|
||||
|
||||
/// 自愈:列表为空时补回 DeepSeek 默认实例;默认引擎 id 失效时回落到第一个可用实例。
|
||||
/// 按 id 找 AI 场景参数(可变引用,供 upsert)。
|
||||
pub fn ai_params_mut(&mut self, provider_id: &str) -> Option<&mut TranslateAiParams> {
|
||||
self.ai_params.iter_mut().find(|p| p.provider_id == provider_id)
|
||||
}
|
||||
|
||||
/// 该全局 AI 供应商是否已加入翻译候选(= `ai_params` 里有记录)。
|
||||
pub fn has_ai_engine(&self, provider_id: &str) -> bool {
|
||||
self.ai_params.iter().any(|p| p.provider_id == provider_id)
|
||||
}
|
||||
|
||||
/// 自愈:**不再**向列表补 DeepSeek(AI 供应商归主设置管,列表为空是合法状态)。
|
||||
/// 默认引擎 id 只做空值归一;指向已删除实例的校验由 TranslateManager 在能读到
|
||||
/// 全局 AI 供应商时完成(否则会把合法的 AI 默认引擎误改成 "auto")。
|
||||
/// 返回是否发生了变更(由调用方决定落盘)。
|
||||
pub fn heal(&mut self) -> bool {
|
||||
let mut changed = false;
|
||||
if self.engines.is_empty() {
|
||||
self.engines.push(TranslateEngineConfig::deepseek_default());
|
||||
changed = true;
|
||||
}
|
||||
if self.default_target.trim().is_empty() {
|
||||
self.default_target = "zh-Hans".to_string();
|
||||
changed = true;
|
||||
@@ -380,11 +417,6 @@ impl TranslateSettings {
|
||||
self.default_engine_id = "auto".to_string();
|
||||
changed = true;
|
||||
}
|
||||
if self.default_engine_id != "auto" && self.engine(&self.default_engine_id).is_none() {
|
||||
// 指向的实例已被删除:不要静默改写成某个实例,改为「自动」更符合用户预期
|
||||
self.default_engine_id = "auto".to_string();
|
||||
changed = true;
|
||||
}
|
||||
// v1 → v2:取词方式默认值从 "compat" 改为 "smart"(UIA 直读已实现)。
|
||||
// v1 里这个字段没有任何 UI 入口,用户不可能主动选过它,因此直接迁移是安全的;
|
||||
// 迁移后用户再选 "compat" 会被原样保留(版本号已推进,不会再被改写)。
|
||||
|
||||
Reference in new issue
Block a user