翻译模块
This commit is contained in:
1 parent
79c43d5340
commit
f6c1cc250e
47 files changed
+10822
-104
No files matched your search
@@ -0,0 +1,593 @@
|
||||
//! OpenAI 兼容引擎。
|
||||
//!
|
||||
//! 一套代码覆盖 DeepSeek / OpenAI / 通义(DashScope 兼容模式)/ Kimi / 智谱 /
|
||||
//! 本地 Ollama / LM Studio / one-api 等中转服务——它们都提供
|
||||
//! `POST {baseUrl}/chat/completions` 且请求响应结构一致,因此差异只在配置项里。
|
||||
//!
|
||||
//! 翻译场景刻意**不开思考模式**:不写 `thinking` / `reasoning_effort`,换低延迟与低费用。
|
||||
//! 若用户确实需要,可通过 `extra_body`(JSON 文本)自行透传。
|
||||
|
||||
use std::time::{Duration, Instant};
|
||||
|
||||
use serde::Deserialize;
|
||||
use serde_json::json;
|
||||
|
||||
use super::{
|
||||
apply_common_params, build_user_content, render_template, EngineRequest, ErrorKind, TokenUsage,
|
||||
TranslateEngine, TranslateError, TranslateMode, TranslateResult,
|
||||
};
|
||||
use crate::translate::settings::{PromptTemplates, TranslateEngineConfig};
|
||||
|
||||
/// 自检与连通性测试使用的探测文本
|
||||
const PROBE_TEXT: &str = "Hello, world.";
|
||||
|
||||
pub struct AiEngine {
|
||||
cfg: TranslateEngineConfig,
|
||||
templates: PromptTemplates,
|
||||
client: reqwest::Client,
|
||||
}
|
||||
|
||||
impl AiEngine {
|
||||
pub fn new(
|
||||
cfg: TranslateEngineConfig,
|
||||
templates: PromptTemplates,
|
||||
client: reqwest::Client,
|
||||
) -> Self {
|
||||
Self {
|
||||
cfg,
|
||||
templates,
|
||||
client,
|
||||
}
|
||||
}
|
||||
|
||||
/// API 根地址。容错处理:用户常把完整端点(`.../chat/completions`)直接粘进来,
|
||||
/// 若不在末尾剥掉,就会拼出 `.../chat/completions/chat/completions`,
|
||||
/// 而这类错误在上游表现为 404,排查成本远高于此处一行判断。
|
||||
fn api_root(&self) -> Result<String, TranslateError> {
|
||||
let raw = self.cfg.base_url.trim();
|
||||
if raw.is_empty() {
|
||||
return Err(TranslateError::config(format!(
|
||||
"引擎「{}」尚未配置 Base URL",
|
||||
self.cfg.name
|
||||
)));
|
||||
}
|
||||
if !(raw.starts_with("http://") || raw.starts_with("https://")) {
|
||||
return Err(TranslateError::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)
|
||||
}
|
||||
|
||||
fn chat_endpoint(&self) -> Result<String, TranslateError> {
|
||||
Ok(format!("{}/chat/completions", self.api_root()?))
|
||||
}
|
||||
|
||||
fn models_endpoint(&self) -> Result<String, TranslateError> {
|
||||
Ok(format!("{}/models", self.api_root()?))
|
||||
}
|
||||
|
||||
/// 密钥只从系统凭据管理器读,不进配置文件、不经前端。
|
||||
fn api_key(&self) -> String {
|
||||
crate::translate::engine_api_key(&self.cfg.id)
|
||||
}
|
||||
|
||||
fn require_key(&self) -> Result<String, TranslateError> {
|
||||
let key = self.api_key();
|
||||
if key.trim().is_empty() {
|
||||
return Err(TranslateError::auth(format!(
|
||||
"引擎「{}」尚未配置 API Key,请在翻译设置中填写",
|
||||
self.cfg.name
|
||||
)));
|
||||
}
|
||||
Ok(key)
|
||||
}
|
||||
|
||||
fn require_model(&self) -> Result<String, TranslateError> {
|
||||
let model = self.cfg.model.trim();
|
||||
if model.is_empty() {
|
||||
return Err(TranslateError::config(format!(
|
||||
"引擎「{}」尚未选择模型,可在设置中拉取模型列表后选择",
|
||||
self.cfg.name
|
||||
)));
|
||||
}
|
||||
Ok(model.to_string())
|
||||
}
|
||||
|
||||
/// 有效 system prompt:实例级自定义提示词优先,否则用模式对应的全局模板。
|
||||
fn system_prompt(&self, req: &EngineRequest) -> String {
|
||||
if !self.cfg.system_prompt.trim().is_empty() {
|
||||
return render_template(&self.cfg.system_prompt, req);
|
||||
}
|
||||
render_template(self.templates.for_mode(req.mode), req)
|
||||
}
|
||||
|
||||
/// 流式收尾。空内容不直接判死:**自动改用同步接口重试一次**。
|
||||
///
|
||||
/// 上游偶发「流正常结束但 content 为空」(安全拦截、思维链吃满 max_tokens、
|
||||
/// 中转服务抖动都会导致)。用户视角这与请求失败无异,但同步接口往往能正常
|
||||
/// 返回——与其抛错让人手动重试,不如在这里自愈一次。重试失败才把错误交给上层。
|
||||
async fn finish_stream_with_fallback(
|
||||
&self,
|
||||
tx: &tokio::sync::mpsc::Sender<super::StreamEvent>,
|
||||
request_id: String,
|
||||
content: String,
|
||||
req: &EngineRequest,
|
||||
started: Instant,
|
||||
finish_reason: Option<String>,
|
||||
) -> Result<(), TranslateError> {
|
||||
if content.trim().is_empty() {
|
||||
if tx.is_closed() {
|
||||
// 调用方已放弃(停止 / 新请求顶替),不再花一次 API 调用
|
||||
return Ok(());
|
||||
}
|
||||
crate::logger::log_warn(
|
||||
"translate",
|
||||
&format!(
|
||||
"「{}」流式返回为空(finish_reason={:?}),自动改用同步接口重试",
|
||||
self.cfg.name, finish_reason
|
||||
),
|
||||
);
|
||||
// 同步路径的错误更具体(认证/额度/响应解析都能区分),直接透传
|
||||
let result = self.translate(req).await?;
|
||||
let _ = tx.send(super::StreamEvent::Done { request_id, result }).await;
|
||||
return Ok(());
|
||||
}
|
||||
finish_stream(
|
||||
tx,
|
||||
request_id,
|
||||
content,
|
||||
req,
|
||||
&self.cfg,
|
||||
started.elapsed().as_millis() as u64,
|
||||
)
|
||||
.await
|
||||
}
|
||||
}
|
||||
|
||||
#[async_trait::async_trait]
|
||||
impl TranslateEngine for AiEngine {
|
||||
fn config(&self) -> &TranslateEngineConfig {
|
||||
&self.cfg
|
||||
}
|
||||
|
||||
async fn translate(&self, req: &EngineRequest) -> Result<TranslateResult, TranslateError> {
|
||||
if req.text.trim().is_empty() {
|
||||
return Err(TranslateError::empty());
|
||||
}
|
||||
let key = self.require_key()?;
|
||||
let model = self.require_model()?;
|
||||
let endpoint = self.chat_endpoint()?;
|
||||
|
||||
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!([
|
||||
{ "role": "system", "content": self.system_prompt(req) },
|
||||
{ "role": "user", "content": build_user_content(req, self.cfg.supports_vision) },
|
||||
]),
|
||||
);
|
||||
apply_common_params(&mut body, &self.cfg);
|
||||
|
||||
let started = Instant::now();
|
||||
let resp = self
|
||||
.client
|
||||
.post(&endpoint)
|
||||
.bearer_auth(&key)
|
||||
.timeout(Duration::from_millis(self.cfg.timeout_ms.max(1000)))
|
||||
.json(&serde_json::Value::Object(body))
|
||||
.send()
|
||||
.await
|
||||
.map_err(|e| classify_reqwest(e, &self.cfg.name))?;
|
||||
|
||||
let status = resp.status();
|
||||
let raw = resp
|
||||
.text()
|
||||
.await
|
||||
.map_err(|e| TranslateError::network(format!("读取「{}」响应失败: {e}", self.cfg.name)))?;
|
||||
|
||||
if !status.is_success() {
|
||||
return Err(classify_http(status.as_u16(), &raw, &self.cfg.name, &model));
|
||||
}
|
||||
|
||||
let parsed: ChatResponse = serde_json::from_str(&raw).map_err(|e| {
|
||||
TranslateError::parse(format!("「{}」响应不是预期的 JSON: {e}", self.cfg.name))
|
||||
.with_detail(&raw)
|
||||
})?;
|
||||
|
||||
if let Some(err) = parsed.error {
|
||||
let msg = err
|
||||
.message
|
||||
.filter(|m| !m.trim().is_empty())
|
||||
.unwrap_or_else(|| "上游返回了错误对象".to_string());
|
||||
return Err(
|
||||
TranslateError::new(ErrorKind::Unknown, format!("「{}」返回错误:{msg}", self.cfg.name))
|
||||
.with_detail(&raw),
|
||||
);
|
||||
}
|
||||
|
||||
let text = 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(TranslateError::empty)?;
|
||||
|
||||
let latency_ms = started.elapsed().as_millis() as u64;
|
||||
let usage = parsed.usage.map(|u| {
|
||||
let total = if u.total_tokens > 0 {
|
||||
u.total_tokens
|
||||
} else {
|
||||
u.prompt_tokens + u.completion_tokens
|
||||
};
|
||||
TokenUsage {
|
||||
prompt_tokens: u.prompt_tokens,
|
||||
completion_tokens: u.completion_tokens,
|
||||
total_tokens: total,
|
||||
}
|
||||
});
|
||||
|
||||
Ok(TranslateResult {
|
||||
text,
|
||||
// AI 引擎不做语言检测:显式指定了源语言时回显,auto 时留空由前端展示「自动」
|
||||
detected: if req.from.trim().is_empty() || req.from == "auto" {
|
||||
None
|
||||
} else {
|
||||
Some(req.from.clone())
|
||||
},
|
||||
engine_id: self.cfg.id.clone(),
|
||||
engine_name: self.cfg.name.clone(),
|
||||
latency_ms,
|
||||
usage,
|
||||
})
|
||||
}
|
||||
|
||||
/// 流式翻译(SSE)。增量经通道下发,`data: [DONE]` 或流结束时发 Done。
|
||||
///
|
||||
/// 错误处理约定:**本方法不发送 `StreamEvent::Error`**——任何失败都通过 `Err` 返回,
|
||||
/// 由命令层统一转成错误事件,避免前端收到两条错误。通道关闭(调用方已放弃,
|
||||
/// 例如用户点了停止)时安静返回 `Ok(())`,不当作失败。
|
||||
async fn translate_stream(
|
||||
&self,
|
||||
req: &EngineRequest,
|
||||
request_id: String,
|
||||
tx: tokio::sync::mpsc::Sender<super::StreamEvent>,
|
||||
) -> Result<(), TranslateError> {
|
||||
if req.text.trim().is_empty() && req.image_png.is_none() {
|
||||
return Err(TranslateError::empty());
|
||||
}
|
||||
let key = self.require_key()?;
|
||||
let model = self.require_model()?;
|
||||
let endpoint = self.chat_endpoint()?;
|
||||
|
||||
let mut body = serde_json::Map::new();
|
||||
body.insert("model".to_string(), json!(model));
|
||||
body.insert("stream".to_string(), json!(true));
|
||||
body.insert(
|
||||
"messages".to_string(),
|
||||
json!([
|
||||
{ "role": "system", "content": self.system_prompt(req) },
|
||||
{ "role": "user", "content": build_user_content(req, self.cfg.supports_vision) },
|
||||
]),
|
||||
);
|
||||
apply_common_params(&mut body, &self.cfg);
|
||||
|
||||
let started = Instant::now();
|
||||
let resp = self
|
||||
.client
|
||||
.post(&endpoint)
|
||||
.bearer_auth(&key)
|
||||
.timeout(Duration::from_millis(self.cfg.timeout_ms.max(1000)))
|
||||
.json(&serde_json::Value::Object(body))
|
||||
.send()
|
||||
.await
|
||||
.map_err(|e| classify_reqwest(e, &self.cfg.name))?;
|
||||
|
||||
let status = resp.status();
|
||||
if !status.is_success() {
|
||||
let raw = resp.text().await.unwrap_or_default();
|
||||
return Err(classify_http(status.as_u16(), &raw, &self.cfg.name, &model));
|
||||
}
|
||||
|
||||
// SSE 逐行解析:字节块可能把一行劈成两半,必须先攒缓冲再按 \n 切
|
||||
use futures_util::StreamExt;
|
||||
let mut stream = resp.bytes_stream();
|
||||
let mut buffer: Vec<u8> = Vec::new();
|
||||
let mut content = String::new();
|
||||
let mut finish_reason: Option<String> = None;
|
||||
|
||||
while let Some(item) = stream.next().await {
|
||||
let bytes =
|
||||
item.map_err(|e| TranslateError::network(format!("读取流失败: {e}")))?;
|
||||
buffer.extend_from_slice(&bytes);
|
||||
while let Some(pos) = buffer.iter().position(|&b| b == b'\n') {
|
||||
let line_bytes: Vec<u8> = buffer.drain(..=pos).collect();
|
||||
let line = String::from_utf8_lossy(&line_bytes[..line_bytes.len() - 1]);
|
||||
let Some(payload) = line.trim().strip_prefix("data:") else {
|
||||
continue;
|
||||
};
|
||||
let payload = payload.trim();
|
||||
if payload.is_empty() {
|
||||
continue;
|
||||
}
|
||||
if payload == "[DONE]" {
|
||||
return self
|
||||
.finish_stream_with_fallback(
|
||||
&tx,
|
||||
request_id,
|
||||
content,
|
||||
req,
|
||||
started,
|
||||
finish_reason,
|
||||
)
|
||||
.await;
|
||||
}
|
||||
let Ok(value) = serde_json::from_str::<serde_json::Value>(payload) else {
|
||||
continue;
|
||||
};
|
||||
// 上游在流中携带错误对象时终止
|
||||
if let Some(message) = value
|
||||
.pointer("/error/message")
|
||||
.and_then(|m| m.as_str())
|
||||
.filter(|m| !m.trim().is_empty())
|
||||
{
|
||||
return Err(TranslateError::new(
|
||||
ErrorKind::Unknown,
|
||||
format!("「{}」流中返回错误:{message}", self.cfg.name),
|
||||
));
|
||||
}
|
||||
if let Some(fr) = value
|
||||
.pointer("/choices/0/finish_reason")
|
||||
.and_then(|v| v.as_str())
|
||||
{
|
||||
finish_reason = Some(fr.to_string());
|
||||
}
|
||||
let Some(delta) = value
|
||||
.pointer("/choices/0/delta/content")
|
||||
.and_then(|c| c.as_str())
|
||||
.filter(|d| !d.is_empty())
|
||||
else {
|
||||
continue;
|
||||
};
|
||||
content.push_str(delta);
|
||||
if tx
|
||||
.send(super::StreamEvent::Chunk {
|
||||
request_id: request_id.clone(),
|
||||
delta: delta.to_string(),
|
||||
})
|
||||
.await
|
||||
.is_err()
|
||||
{
|
||||
// 通道已关 = 调用方放弃(停止 / 新请求顶替),安静退出
|
||||
return Ok(());
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 流结束但没收到 [DONE]:部分上游异常断流。已有内容仍视为成功,
|
||||
// 否则用户会看着已译出一半的结果被告知失败。
|
||||
self.finish_stream_with_fallback(
|
||||
&tx,
|
||||
request_id,
|
||||
content,
|
||||
req,
|
||||
started,
|
||||
finish_reason,
|
||||
)
|
||||
.await
|
||||
}
|
||||
|
||||
async fn list_models(&self) -> Result<Vec<String>, TranslateError> {
|
||||
let key = self.require_key()?;
|
||||
let endpoint = self.models_endpoint()?;
|
||||
let resp = self
|
||||
.client
|
||||
.get(&endpoint)
|
||||
.bearer_auth(&key)
|
||||
.timeout(Duration::from_millis(self.cfg.timeout_ms.clamp(3_000, 15_000)))
|
||||
.send()
|
||||
.await
|
||||
.map_err(|e| classify_reqwest(e, &self.cfg.name))?;
|
||||
|
||||
let status = resp.status();
|
||||
let raw = resp
|
||||
.text()
|
||||
.await
|
||||
.map_err(|e| TranslateError::network(format!("读取「{}」模型列表失败: {e}", self.cfg.name)))?;
|
||||
|
||||
if !status.is_success() {
|
||||
return Err(classify_http(
|
||||
status.as_u16(),
|
||||
&raw,
|
||||
&self.cfg.name,
|
||||
self.cfg.model.as_str(),
|
||||
));
|
||||
}
|
||||
|
||||
let parsed: ModelsResponse = serde_json::from_str(&raw).map_err(|e| {
|
||||
TranslateError::parse(format!("「{}」的模型列表无法解析: {e}", self.cfg.name))
|
||||
.with_detail(&raw)
|
||||
})?;
|
||||
|
||||
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)
|
||||
}
|
||||
|
||||
async fn test(&self) -> Result<String, TranslateError> {
|
||||
let req = EngineRequest {
|
||||
text: PROBE_TEXT.to_string(),
|
||||
from: "en".to_string(),
|
||||
to: "zh-Hans".to_string(),
|
||||
to_label: "简体中文".to_string(),
|
||||
from_label: "英语".to_string(),
|
||||
mode: TranslateMode::Translate,
|
||||
image_png: None,
|
||||
via: "preview".to_string(),
|
||||
};
|
||||
let started = Instant::now();
|
||||
let result = self.translate(&req).await?;
|
||||
let total = started.elapsed().as_millis() as u64;
|
||||
Ok(format!(
|
||||
"连通正常 · 模型 {} · {}ms · 回显「{}」",
|
||||
self.cfg.model, total, result.text
|
||||
))
|
||||
}
|
||||
}
|
||||
|
||||
/// 收尾:把累积内容封装成结果下发。空内容按「上游没产出」处理。
|
||||
async fn finish_stream(
|
||||
tx: &tokio::sync::mpsc::Sender<super::StreamEvent>,
|
||||
request_id: String,
|
||||
content: String,
|
||||
req: &EngineRequest,
|
||||
cfg: &TranslateEngineConfig,
|
||||
latency_ms: u64,
|
||||
) -> Result<(), TranslateError> {
|
||||
let text = content.trim().to_string();
|
||||
if text.is_empty() {
|
||||
return Err(TranslateError::new(
|
||||
ErrorKind::Empty,
|
||||
format!("「{}」未返回任何译文(流提前结束)", cfg.name),
|
||||
));
|
||||
}
|
||||
let _ = tx
|
||||
.send(super::StreamEvent::Done {
|
||||
request_id,
|
||||
result: TranslateResult {
|
||||
text,
|
||||
detected: if req.from.trim().is_empty() || req.from == "auto" {
|
||||
None
|
||||
} else {
|
||||
Some(req.from.clone())
|
||||
},
|
||||
engine_id: cfg.id.clone(),
|
||||
engine_name: cfg.name.clone(),
|
||||
latency_ms,
|
||||
// 流式路径不索取 usage:stream_options 是各家扩展,兼容性不一
|
||||
usage: None,
|
||||
},
|
||||
})
|
||||
.await;
|
||||
Ok(())
|
||||
}
|
||||
|
||||
/// 网络层错误分类。
|
||||
fn classify_reqwest(e: reqwest::Error, engine: &str) -> TranslateError {
|
||||
if e.is_timeout() {
|
||||
return TranslateError::timeout(format!(
|
||||
"请求「{engine}」超时,可在引擎设置中调大超时时间,或检查网络"
|
||||
));
|
||||
}
|
||||
if e.is_connect() {
|
||||
return TranslateError::network(format!(
|
||||
"无法连接「{engine}」:{e}(若该服务在境外,请检查网络或开启代理)"
|
||||
));
|
||||
}
|
||||
TranslateError::network(format!("请求「{engine}」失败:{e}"))
|
||||
}
|
||||
|
||||
/// HTTP 状态码分类。把「Key 不对」「模型名不对」「被限流」分开,
|
||||
/// 是因为这三者在前端的处置动作完全不同。
|
||||
fn classify_http(status: u16, body: &str, engine: &str, model: &str) -> TranslateError {
|
||||
let snippet = body.trim();
|
||||
let lower = snippet.to_lowercase();
|
||||
let err = match status {
|
||||
401 | 403 => TranslateError::auth(format!(
|
||||
"「{engine}」认证失败(HTTP {status}),请检查 API Key 是否正确、是否有该模型的权限"
|
||||
)),
|
||||
402 => TranslateError::auth(format!("「{engine}」余额不足或未开通计费(HTTP 402)")),
|
||||
429 => TranslateError::rate_limit(format!(
|
||||
"「{engine}」请求过于频繁(HTTP 429),请稍后重试或降低频率"
|
||||
)),
|
||||
400 | 404 | 422 => {
|
||||
if lower.contains("model") {
|
||||
TranslateError::config(format!(
|
||||
"「{engine}」不识别模型「{model}」(HTTP {status}):上游模型名可能已变更,\
|
||||
请在设置中拉取模型列表后重新选择"
|
||||
))
|
||||
} else {
|
||||
TranslateError::new(
|
||||
ErrorKind::Config,
|
||||
format!("「{engine}」拒绝了该请求(HTTP {status})"),
|
||||
)
|
||||
}
|
||||
}
|
||||
408 | 504 => TranslateError::timeout(format!("「{engine}」上游超时(HTTP {status})")),
|
||||
s if (500..600).contains(&s) => {
|
||||
TranslateError::network(format!("「{engine}」服务端错误(HTTP {status}),可稍后重试"))
|
||||
}
|
||||
s => TranslateError::new(ErrorKind::Unknown, format!("「{engine}」返回 HTTP {s}")),
|
||||
};
|
||||
err.with_detail(snippet)
|
||||
}
|
||||
|
||||
// ===== 响应结构(宽松解析:缺字段不报错,由业务层判断内容是否可用) =====
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
struct ChatResponse {
|
||||
#[serde(default)]
|
||||
choices: Vec<ChatChoice>,
|
||||
#[serde(default)]
|
||||
usage: Option<ChatUsage>,
|
||||
#[serde(default)]
|
||||
error: Option<ApiErrorBody>,
|
||||
}
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
struct ChatChoice {
|
||||
#[serde(default)]
|
||||
message: ChatMessage,
|
||||
}
|
||||
|
||||
#[derive(Debug, Default, Deserialize)]
|
||||
struct ChatMessage {
|
||||
/// 部分实现会返回 null(例如只产出思维链时),故用 Option 而非 String
|
||||
#[serde(default)]
|
||||
content: Option<String>,
|
||||
}
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
struct ChatUsage {
|
||||
#[serde(default)]
|
||||
prompt_tokens: u32,
|
||||
#[serde(default)]
|
||||
completion_tokens: u32,
|
||||
#[serde(default)]
|
||||
total_tokens: u32,
|
||||
}
|
||||
|
||||
#[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,255 @@
|
||||
//! DeepL 云厂商翻译源。
|
||||
//!
|
||||
//! 选它作云厂商第一家 purely 因为接入成本:`Authorization: DeepL-Auth-Key <key>`
|
||||
//! 一个头就完成鉴权,没有 MD5/TC3 那类签名流程。其它云厂商(百度/腾讯/阿里/有道)
|
||||
//! 签名各不相同,按需再加。
|
||||
//!
|
||||
//! 三个必须如实告知用户的限制:
|
||||
//! - **免费 Key 与付费 Key 的端点不同**(`api-free.deepl.com` / `api.deepl.com`)。
|
||||
//! 用错端点会返回 403,错误信息里必须把这个可能性讲出来,否则用户只会反复重输 Key。
|
||||
//! - **目标语言只有简体中文**(`ZH`)。DeepL 暂无繁体中文目标,本实现会把
|
||||
//! `zh-Hant` 也映射到 `ZH`,译出的会是简体——不是 bug,是上游能力边界。
|
||||
//! - 无流式接口,走 trait 默认实现(同步完成后整体下发)。
|
||||
//!
|
||||
//! HTTP 形态:`POST {base}/translate`,body `{"text":["..."],"target_lang":"ZH"}`,
|
||||
//! `source_lang` 省略时由上游自动检测。
|
||||
|
||||
use std::time::{Duration, Instant};
|
||||
|
||||
use serde::Deserialize;
|
||||
|
||||
use super::{
|
||||
is_auto, provider_code, ErrorKind, TranslateEngine, TranslateError, TranslateResult,
|
||||
};
|
||||
use crate::translate::settings::TranslateEngineConfig;
|
||||
|
||||
const PROBE_TEXT: &str = "Hello, world.";
|
||||
|
||||
pub struct DeepLEngine {
|
||||
cfg: TranslateEngineConfig,
|
||||
client: reqwest::Client,
|
||||
}
|
||||
|
||||
impl DeepLEngine {
|
||||
pub fn new(cfg: TranslateEngineConfig, client: reqwest::Client) -> Self {
|
||||
Self { cfg, client }
|
||||
}
|
||||
|
||||
/// API 根地址(容错:剥掉误粘的 `/translate`,与 AI 引擎同一思路)
|
||||
fn api_root(&self) -> Result<String, TranslateError> {
|
||||
let raw = self.cfg.base_url.trim();
|
||||
if raw.is_empty() {
|
||||
return Err(TranslateError::config(format!(
|
||||
"引擎「{}」尚未配置 Base URL(免费 Key 用 https://api-free.deepl.com/v2,\
|
||||
付费 Key 用 https://api.deepl.com/v2)",
|
||||
self.cfg.name
|
||||
)));
|
||||
}
|
||||
if !(raw.starts_with("http://") || raw.starts_with("https://")) {
|
||||
return Err(TranslateError::config(format!(
|
||||
"Base URL 需以 http:// 或 https:// 开头,当前为「{raw}」"
|
||||
)));
|
||||
}
|
||||
let mut root = raw.trim_end_matches('/').to_string();
|
||||
if let Some(stripped) = root.strip_suffix("/translate") {
|
||||
root = stripped.trim_end_matches('/').to_string();
|
||||
}
|
||||
Ok(root)
|
||||
}
|
||||
|
||||
fn require_key(&self) -> Result<String, TranslateError> {
|
||||
let key = crate::translate::engine_api_key(&self.cfg.id);
|
||||
if key.trim().is_empty() {
|
||||
return Err(TranslateError::auth(format!(
|
||||
"引擎「{}」尚未配置 DeepL Auth Key",
|
||||
self.cfg.name
|
||||
)));
|
||||
}
|
||||
Ok(key)
|
||||
}
|
||||
|
||||
/// 目标语言码。DeepL 要求变体形式:英语必须是 EN-GB/EN-US,葡语必须是 PT-PT/PT-BR。
|
||||
fn target_code(internal: &str) -> Result<String, TranslateError> {
|
||||
let code = provider_code(internal);
|
||||
let lower = code.to_lowercase();
|
||||
let out = match lower.as_str() {
|
||||
"zh" | "zh-cn" => "ZH".to_string(),
|
||||
"zh-tw" | "zh-hant" => "ZH".to_string(),
|
||||
"en" => "EN-US".to_string(),
|
||||
"en-gb" => "EN-GB".to_string(),
|
||||
"en-us" => "EN-US".to_string(),
|
||||
"pt" => "PT-BR".to_string(),
|
||||
"pt-pt" => "PT-PT".to_string(),
|
||||
"pt-br" => "PT-BR".to_string(),
|
||||
other => other.split('-').next().unwrap_or(other).to_uppercase(),
|
||||
};
|
||||
if out.trim().is_empty() {
|
||||
return Err(TranslateError::config("未指定目标语言"));
|
||||
}
|
||||
Ok(out)
|
||||
}
|
||||
|
||||
/// 源语言码。省略(auto)时不上送,由上游检测。
|
||||
fn source_code(internal: &str) -> Option<String> {
|
||||
if is_auto(internal) {
|
||||
return None;
|
||||
}
|
||||
let code = provider_code(internal);
|
||||
Some(code.split('-').next().unwrap_or(&code).to_uppercase())
|
||||
}
|
||||
}
|
||||
|
||||
#[async_trait::async_trait]
|
||||
impl TranslateEngine for DeepLEngine {
|
||||
fn config(&self) -> &TranslateEngineConfig {
|
||||
&self.cfg
|
||||
}
|
||||
|
||||
async fn translate(
|
||||
&self,
|
||||
req: &super::EngineRequest,
|
||||
) -> Result<TranslateResult, TranslateError> {
|
||||
let text = req.text.trim();
|
||||
if text.is_empty() {
|
||||
return Err(TranslateError::empty());
|
||||
}
|
||||
let key = self.require_key()?;
|
||||
let target = Self::target_code(&req.to)?;
|
||||
let root = self.api_root()?;
|
||||
|
||||
let mut body = serde_json::json!({ "text": [text], "target_lang": target });
|
||||
if let Some(source) = Self::source_code(&req.from) {
|
||||
body["source_lang"] = serde_json::json!(source);
|
||||
}
|
||||
|
||||
let started = Instant::now();
|
||||
let resp = self
|
||||
.client
|
||||
.post(format!("{root}/translate"))
|
||||
.header("Authorization", format!("DeepL-Auth-Key {key}"))
|
||||
.timeout(Duration::from_millis(self.cfg.timeout_ms.max(2_000)))
|
||||
.json(&body)
|
||||
.send()
|
||||
.await
|
||||
.map_err(|e| classify_reqwest(e, self.cfg.name.as_str()))?;
|
||||
|
||||
let status = resp.status();
|
||||
let raw = resp.text().await.map_err(|e| {
|
||||
TranslateError::network(format!("读取「{}」响应失败: {e}", self.cfg.name))
|
||||
})?;
|
||||
if !status.is_success() {
|
||||
return Err(classify_http(status.as_u16(), &raw, self.cfg.name.as_str()));
|
||||
}
|
||||
|
||||
let parsed: DeepLResponse = serde_json::from_str(&raw).map_err(|e| {
|
||||
TranslateError::parse(format!("「{}」响应不是预期的 JSON: {e}", self.cfg.name))
|
||||
.with_detail(&raw)
|
||||
})?;
|
||||
|
||||
// DeepL 的翻译结果按 text 数组分段返回;单段请求时取第一段即可
|
||||
let text_out = parsed
|
||||
.translations
|
||||
.first()
|
||||
.and_then(|t| t.text.clone())
|
||||
.map(|t| t.trim().to_string())
|
||||
.filter(|s| !s.is_empty())
|
||||
.ok_or_else(|| {
|
||||
TranslateError::new(
|
||||
ErrorKind::Empty,
|
||||
format!("「{}」未返回译文", self.cfg.name),
|
||||
)
|
||||
.with_detail(raw.trim())
|
||||
})?;
|
||||
|
||||
let detected = parsed
|
||||
.translations
|
||||
.first()
|
||||
.and_then(|t| t.detected_source_language.clone())
|
||||
.filter(|s| !s.trim().is_empty())
|
||||
// 上游返回大写(如 "EN"),统一转小写与内部语言码对齐
|
||||
.map(|s| s.to_lowercase());
|
||||
|
||||
Ok(TranslateResult {
|
||||
text: text_out,
|
||||
detected,
|
||||
engine_id: self.cfg.id.clone(),
|
||||
engine_name: self.cfg.name.clone(),
|
||||
latency_ms: started.elapsed().as_millis() as u64,
|
||||
usage: None,
|
||||
})
|
||||
}
|
||||
|
||||
async fn list_models(&self) -> Result<Vec<String>, TranslateError> {
|
||||
Ok(Vec::new())
|
||||
}
|
||||
|
||||
async fn test(&self) -> Result<String, TranslateError> {
|
||||
let req = super::EngineRequest {
|
||||
text: PROBE_TEXT.to_string(),
|
||||
from: "en".to_string(),
|
||||
to: "zh-Hans".to_string(),
|
||||
to_label: "简体中文".to_string(),
|
||||
from_label: "英语".to_string(),
|
||||
mode: super::TranslateMode::Translate,
|
||||
image_png: None,
|
||||
via: "preview".to_string(),
|
||||
};
|
||||
let started = Instant::now();
|
||||
let result = self.translate(&req).await?;
|
||||
Ok(format!(
|
||||
"连通正常 · {}ms · 回显「{}」",
|
||||
started.elapsed().as_millis(),
|
||||
result.text
|
||||
))
|
||||
}
|
||||
}
|
||||
|
||||
fn classify_reqwest(e: reqwest::Error, engine: &str) -> TranslateError {
|
||||
if e.is_timeout() {
|
||||
return TranslateError::timeout(format!("请求「{engine}」超时,可调大超时时间"));
|
||||
}
|
||||
if e.is_connect() {
|
||||
return TranslateError::network(format!("无法连接「{engine}」:{e},请检查网络"));
|
||||
}
|
||||
TranslateError::network(format!("请求「{engine}」失败:{e}"))
|
||||
}
|
||||
|
||||
fn classify_http(status: u16, body: &str, engine: &str) -> TranslateError {
|
||||
let err = match status {
|
||||
403 => TranslateError::auth(format!(
|
||||
"「{engine}」认证失败(HTTP 403):Key 无效,或免费 Key 用了付费端点(反之亦然)。\
|
||||
免费 Key 应使用 https://api-free.deepl.com/v2"
|
||||
)),
|
||||
456 => TranslateError::rate_limit(format!(
|
||||
"「{engine}」本月翻译额度已用尽(HTTP 456)"
|
||||
)),
|
||||
429 => TranslateError::rate_limit(format!(
|
||||
"「{engine}」请求过于频繁(HTTP 429),请稍后重试"
|
||||
)),
|
||||
400 => TranslateError::config(format!(
|
||||
"「{engine}」拒绝了该请求(HTTP 400):目标语言或文本不合法"
|
||||
)),
|
||||
414 => TranslateError::unsupported(format!(
|
||||
"文本过长,「{engine}」拒绝了该请求(HTTP 414)"
|
||||
)),
|
||||
s if (500..600).contains(&s) => {
|
||||
TranslateError::network(format!("「{engine}」服务端错误(HTTP {status}),可稍后重试"))
|
||||
}
|
||||
s => TranslateError::new(ErrorKind::Unknown, format!("「{engine}」返回 HTTP {s}")),
|
||||
};
|
||||
err.with_detail(body.trim())
|
||||
}
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
struct DeepLResponse {
|
||||
#[serde(default)]
|
||||
translations: Vec<DeepLTranslation>,
|
||||
}
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
struct DeepLTranslation {
|
||||
#[serde(default)]
|
||||
text: Option<String>,
|
||||
#[serde(rename = "detected_source_language", default)]
|
||||
detected_source_language: Option<String>,
|
||||
}
|
||||
@@ -0,0 +1,244 @@
|
||||
//! LibreTranslate 自托管翻译源。
|
||||
//!
|
||||
//! 定位:用户自部署的开源翻译服务(https://github.com/LibreTranslate/LibreTranslate),
|
||||
//! 数据发往用户自己的服务器,不受境外免费接口的 IP 风控(429)限制。
|
||||
//!
|
||||
//! 接入形态:
|
||||
//! - HTTP:`POST {base}/translate`,body `{"q":..., "source":..., "target":..., "format":"text", "api_key":...}`,
|
||||
//! 返回 `{"translatedText": "...", "detectedLanguage": {"language": ..., "confidence": ...}}`。
|
||||
//! - **语言码不能走 [`super::provider_code`]**:LibreTranslate 用 `zh-Hans` / `zh-Hant` / `en` / `ja`
|
||||
//! 这类代码,与内部语言码一致,原样透传即可;`provider_code` 会把 `zh-Hans` 换成 `zh-CN`,
|
||||
//! 那是 Google / MyMemory 那套写法。
|
||||
//! - 目标语言集取决于部署时的语言包(常见部署仅含 en / ja / zh-Hans 等少数语言);
|
||||
//! 不支持的语言对上游返回 400 + 错误说明,这里把错误说明透传进 detail,而不是猜一个原因。
|
||||
//! - **API Key 可选**:部署启用 `LT_API_KEYS` 后必需;未启用时传不传都行,
|
||||
//! 本实现仅在已配置密钥时才上送 `api_key` 字段。
|
||||
|
||||
use std::time::{Duration, Instant};
|
||||
|
||||
use serde::Deserialize;
|
||||
|
||||
use super::{is_auto, ErrorKind, TranslateEngine, TranslateError, TranslateResult};
|
||||
use crate::translate::settings::TranslateEngineConfig;
|
||||
|
||||
const PROBE_TEXT: &str = "Hello, world.";
|
||||
|
||||
pub struct LibreTranslateEngine {
|
||||
cfg: TranslateEngineConfig,
|
||||
client: reqwest::Client,
|
||||
}
|
||||
|
||||
impl LibreTranslateEngine {
|
||||
pub fn new(cfg: TranslateEngineConfig, client: reqwest::Client) -> Self {
|
||||
Self { cfg, client }
|
||||
}
|
||||
|
||||
/// API 根地址(容错:剥掉误粘的 `/translate`,与 DeepL / AI 引擎同一思路)
|
||||
fn api_root(&self) -> Result<String, TranslateError> {
|
||||
let raw = self.cfg.base_url.trim();
|
||||
if raw.is_empty() {
|
||||
return Err(TranslateError::config(format!(
|
||||
"引擎「{}」尚未配置服务地址:请填写自建 LibreTranslate 的地址(如 https://translate.example.com)",
|
||||
self.cfg.name
|
||||
)));
|
||||
}
|
||||
if !(raw.starts_with("http://") || raw.starts_with("https://")) {
|
||||
return Err(TranslateError::config(format!(
|
||||
"服务地址需以 http:// 或 https:// 开头,当前为「{raw}」"
|
||||
)));
|
||||
}
|
||||
let mut root = raw.trim_end_matches('/').to_string();
|
||||
if let Some(stripped) = root.strip_suffix("/translate") {
|
||||
root = stripped.trim_end_matches('/').to_string();
|
||||
}
|
||||
Ok(root)
|
||||
}
|
||||
|
||||
/// API Key(可选)。部署未启用密钥校验时留空即可。
|
||||
fn api_key(&self) -> Option<String> {
|
||||
let key = crate::translate::engine_api_key(&self.cfg.id);
|
||||
let key = key.trim();
|
||||
if key.is_empty() {
|
||||
None
|
||||
} else {
|
||||
Some(key.to_string())
|
||||
}
|
||||
}
|
||||
|
||||
/// 源语言码:auto 原样上送(LibreTranslate 支持自动检测);显式语言原样透传。
|
||||
fn source_code(&self, from: &str) -> String {
|
||||
if is_auto(from) {
|
||||
"auto".to_string()
|
||||
} else {
|
||||
from.to_string()
|
||||
}
|
||||
}
|
||||
|
||||
/// 目标语言码:原样透传。不能走 provider_code(见文件头注释)。
|
||||
fn target_code(&self, to: &str) -> Result<String, TranslateError> {
|
||||
let code = to.trim();
|
||||
if code.is_empty() {
|
||||
return Err(TranslateError::config("未指定目标语言"));
|
||||
}
|
||||
Ok(code.to_string())
|
||||
}
|
||||
}
|
||||
|
||||
#[async_trait::async_trait]
|
||||
impl TranslateEngine for LibreTranslateEngine {
|
||||
fn config(&self) -> &TranslateEngineConfig {
|
||||
&self.cfg
|
||||
}
|
||||
|
||||
async fn translate(
|
||||
&self,
|
||||
req: &super::EngineRequest,
|
||||
) -> Result<TranslateResult, TranslateError> {
|
||||
let text = req.text.trim();
|
||||
if text.is_empty() {
|
||||
return Err(TranslateError::empty());
|
||||
}
|
||||
let target = self.target_code(&req.to)?;
|
||||
let source = self.source_code(&req.from);
|
||||
let root = self.api_root()?;
|
||||
|
||||
let mut body = serde_json::json!({
|
||||
"q": text,
|
||||
"source": source,
|
||||
"target": target,
|
||||
"format": "text",
|
||||
});
|
||||
if let Some(key) = self.api_key() {
|
||||
body["api_key"] = serde_json::json!(key);
|
||||
}
|
||||
|
||||
let started = Instant::now();
|
||||
let resp = self
|
||||
.client
|
||||
.post(format!("{root}/translate"))
|
||||
.timeout(Duration::from_millis(self.cfg.timeout_ms.max(2_000)))
|
||||
.json(&body)
|
||||
.send()
|
||||
.await
|
||||
.map_err(|e| classify_reqwest(e, self.cfg.name.as_str()))?;
|
||||
|
||||
let status = resp.status();
|
||||
let raw = resp.text().await.map_err(|e| {
|
||||
TranslateError::network(format!("读取「{}」响应失败: {e}", self.cfg.name))
|
||||
})?;
|
||||
if !status.is_success() {
|
||||
return Err(classify_http(status.as_u16(), &raw, self.cfg.name.as_str()));
|
||||
}
|
||||
|
||||
let parsed: LibreTranslateResponse = serde_json::from_str(&raw).map_err(|e| {
|
||||
TranslateError::parse(format!("「{}」响应不是预期的 JSON: {e}", self.cfg.name))
|
||||
.with_detail(&raw)
|
||||
})?;
|
||||
|
||||
let text_out = parsed
|
||||
.translated_text
|
||||
.map(|t| t.trim().to_string())
|
||||
.filter(|s| !s.is_empty())
|
||||
.ok_or_else(|| {
|
||||
TranslateError::new(
|
||||
ErrorKind::Empty,
|
||||
format!("「{}」未返回译文(该语言对可能不受支持)", self.cfg.name),
|
||||
)
|
||||
.with_detail(raw.trim())
|
||||
})?;
|
||||
|
||||
// 仅 source=auto 时上游会回检测结果;显式源语言时该字段缺失
|
||||
let detected = parsed
|
||||
.detected_language
|
||||
.and_then(|d| d.language)
|
||||
.filter(|s| !s.trim().is_empty());
|
||||
|
||||
Ok(TranslateResult {
|
||||
text: text_out,
|
||||
detected,
|
||||
engine_id: self.cfg.id.clone(),
|
||||
engine_name: self.cfg.name.clone(),
|
||||
latency_ms: started.elapsed().as_millis() as u64,
|
||||
usage: None,
|
||||
})
|
||||
}
|
||||
|
||||
/// 免密钥/自托管端点没有「模型」概念
|
||||
async fn list_models(&self) -> Result<Vec<String>, TranslateError> {
|
||||
Ok(Vec::new())
|
||||
}
|
||||
|
||||
async fn test(&self) -> Result<String, TranslateError> {
|
||||
let req = super::EngineRequest {
|
||||
text: PROBE_TEXT.to_string(),
|
||||
from: "en".to_string(),
|
||||
to: "zh-Hans".to_string(),
|
||||
to_label: "简体中文".to_string(),
|
||||
from_label: "英语".to_string(),
|
||||
mode: super::TranslateMode::Translate,
|
||||
image_png: None,
|
||||
via: "preview".to_string(),
|
||||
};
|
||||
let started = Instant::now();
|
||||
let result = self.translate(&req).await?;
|
||||
Ok(format!(
|
||||
"连通正常 · {}ms · 回显「{}」",
|
||||
started.elapsed().as_millis(),
|
||||
result.text
|
||||
))
|
||||
}
|
||||
}
|
||||
|
||||
fn classify_reqwest(e: reqwest::Error, engine: &str) -> TranslateError {
|
||||
if e.is_timeout() {
|
||||
return TranslateError::timeout(format!("请求「{engine}」超时,可调大超时时间"));
|
||||
}
|
||||
if e.is_connect() {
|
||||
return TranslateError::network(format!("无法连接「{engine}」:{e},请检查服务地址与网络"));
|
||||
}
|
||||
TranslateError::network(format!("请求「{engine}」失败:{e}"))
|
||||
}
|
||||
|
||||
fn classify_http(status: u16, body: &str, engine: &str) -> TranslateError {
|
||||
// LibreTranslate 的错误体是 JSON `{"error": "..."}`,取这条说明作 detail 比整段响应可读
|
||||
let detail = serde_json::from_str::<serde_json::Value>(body)
|
||||
.ok()
|
||||
.and_then(|v| v.get("error").and_then(|e| e.as_str()).map(String::from))
|
||||
.unwrap_or_else(|| body.to_string());
|
||||
let err = match status {
|
||||
400 => TranslateError::config(format!(
|
||||
"「{engine}」拒绝了该请求(HTTP 400):目标语言可能不在该部署支持范围内"
|
||||
)),
|
||||
401 => TranslateError::auth(format!(
|
||||
"「{engine}」要求 API Key(HTTP 401):该部署启用了密钥校验,请配置 API Key"
|
||||
)),
|
||||
403 => TranslateError::auth(format!(
|
||||
"「{engine}」API Key 无效(HTTP 403):请检查 Key 与该部署的密钥设置"
|
||||
)),
|
||||
429 => TranslateError::rate_limit(format!(
|
||||
"「{engine}」请求过于频繁(HTTP 429),请稍后重试"
|
||||
)),
|
||||
404 => TranslateError::config(format!(
|
||||
"「{engine}」地址无效(HTTP 404):请确认 Base URL 是 LibreTranslate 服务根地址而非某个页面"
|
||||
)),
|
||||
s if (500..600).contains(&s) => {
|
||||
TranslateError::network(format!("「{engine}」服务端错误(HTTP {status}),可稍后重试"))
|
||||
}
|
||||
s => TranslateError::new(ErrorKind::Unknown, format!("「{engine}」返回 HTTP {s}")),
|
||||
};
|
||||
err.with_detail(detail)
|
||||
}
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
struct LibreTranslateResponse {
|
||||
#[serde(rename = "translatedText", default)]
|
||||
translated_text: Option<String>,
|
||||
#[serde(rename = "detectedLanguage", default)]
|
||||
detected_language: Option<DetectedLanguage>,
|
||||
}
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
struct DetectedLanguage {
|
||||
#[serde(default)]
|
||||
language: Option<String>,
|
||||
}
|
||||
@@ -0,0 +1,477 @@
|
||||
//! 翻译引擎抽象层。
|
||||
//!
|
||||
//! 设计要点:
|
||||
//! - 所有引擎实现同一个 [`TranslateEngine`] trait,命令层只面对 `Box<dyn TranslateEngine>`,
|
||||
//! 因此「多源」与「指定源」都不需要在上层写分支。
|
||||
//! - 错误被细分为 [`ErrorKind`]:网络类失败可以重试到下一个源,认证/额度类失败重试
|
||||
//! 没有意义。前端也据此给出不同提示(「检查 Key」与「检查网络/代理」是两件事)。
|
||||
//! - 目标语言一律传**自然语言全称**给模型(`to_label`),语言码只用于记录与查询——
|
||||
//! 模型对「繁体中文」的遵循度明显高于 `zh-Hant`。
|
||||
|
||||
pub mod ai;
|
||||
pub mod deepl;
|
||||
pub mod libretranslate;
|
||||
pub mod mymemory;
|
||||
|
||||
use serde::{Deserialize, Serialize};
|
||||
use serde_json::json;
|
||||
use specta::Type;
|
||||
|
||||
use super::settings::{PromptTemplates, TranslateEngineConfig};
|
||||
|
||||
/// 翻译模式(P0 只用 Translate;其余三档为 P3 的同入口扩展预留)。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
||||
pub enum TranslateMode {
|
||||
Translate,
|
||||
Polish,
|
||||
Explain,
|
||||
Summarize,
|
||||
}
|
||||
|
||||
impl TranslateMode {
|
||||
/// 宽松解析:未知值一律按「翻译」处理,不因前端多传一个枚举值而报错。
|
||||
pub fn parse(raw: Option<&str>) -> Self {
|
||||
match raw.unwrap_or("").trim() {
|
||||
"polish" => Self::Polish,
|
||||
"explain" => Self::Explain,
|
||||
"summarize" => Self::Summarize,
|
||||
_ => Self::Translate,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 引擎请求(内部结构,不参与类型绑定导出)。
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct EngineRequest {
|
||||
/// 待处理文本
|
||||
pub text: String,
|
||||
/// 源语言代码,"auto" 表示自动检测
|
||||
pub from: String,
|
||||
/// 目标语言代码(如 zh-Hans)
|
||||
pub to: String,
|
||||
/// 目标语言自然语言全称(如 简体中文),提示词用
|
||||
pub to_label: String,
|
||||
/// 源语言自然语言全称,auto 时为空
|
||||
pub from_label: String,
|
||||
pub mode: TranslateMode,
|
||||
/// 图像输入(base64 PNG,不含 data: 前缀)。仅截图翻译的「视觉直译」模式使用。
|
||||
/// 免密钥源与未声明 supports_vision 的 AI 引擎会拒绝该请求。
|
||||
pub image_png: Option<String>,
|
||||
/// 记入历史时的来源标签:"manual" | "selection" | "clipboard" | "screenshot" | "preview"
|
||||
pub via: String,
|
||||
}
|
||||
|
||||
/// Token 用量(AI 引擎返回;其余引擎为 None)
|
||||
#[derive(Debug, Clone, Serialize, Deserialize, Type)]
|
||||
#[serde(rename_all = "camelCase")]
|
||||
pub struct TokenUsage {
|
||||
pub prompt_tokens: u32,
|
||||
pub completion_tokens: u32,
|
||||
pub total_tokens: u32,
|
||||
}
|
||||
|
||||
/// 翻译结果
|
||||
#[derive(Debug, Clone, Serialize, Deserialize, Type)]
|
||||
#[serde(rename_all = "camelCase")]
|
||||
pub struct TranslateResult {
|
||||
/// 译文
|
||||
pub text: String,
|
||||
/// 检测到的源语言(免费源会上报;AI 引擎为显式指定值或 None)
|
||||
pub detected: Option<String>,
|
||||
/// 实际使用的引擎实例 id
|
||||
pub engine_id: String,
|
||||
/// 实际使用的引擎展示名(自动降级时前端要能看出「是谁答的」)
|
||||
pub engine_name: String,
|
||||
/// 耗时(毫秒)
|
||||
pub latency_ms: u64,
|
||||
pub usage: Option<TokenUsage>,
|
||||
}
|
||||
|
||||
/// 错误分类。区分它们的意义在于**前端能给出可操作的提示**:
|
||||
/// `Auth` 要用户去改 Key,`Network` 要用户查网络/代理,`RateLimit` 只需等待。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize, Type)]
|
||||
#[serde(rename_all = "camelCase")]
|
||||
pub enum ErrorKind {
|
||||
/// 配置缺失或不合法(未填 Base URL、模型名无效等)
|
||||
Config,
|
||||
/// 认证失败 / 无权限 / 额度耗尽
|
||||
Auth,
|
||||
/// 被限流
|
||||
RateLimit,
|
||||
/// 网络不可达(含代理问题)
|
||||
Network,
|
||||
/// 超时
|
||||
Timeout,
|
||||
/// 响应无法解析(上游改了格式)
|
||||
Parse,
|
||||
/// 不支持的引擎类型或语言对
|
||||
Unsupported,
|
||||
/// 输入为空(取词失败或用户未输入)
|
||||
Empty,
|
||||
/// 被风控/验证码拦截(免费源常见)
|
||||
Captcha,
|
||||
Unknown,
|
||||
}
|
||||
|
||||
/// 结构化错误:作为 Tauri 命令的 error 类型返回,前端按 `kind` 分支处理。
|
||||
#[derive(Debug, Clone, Serialize, Deserialize, Type)]
|
||||
#[serde(rename_all = "camelCase")]
|
||||
pub struct TranslateError {
|
||||
pub kind: ErrorKind,
|
||||
pub message: String,
|
||||
/// 上游原始响应片段(已截断),用于排查;不含密钥
|
||||
pub detail: Option<String>,
|
||||
}
|
||||
|
||||
/// 上游响应片段入库前的截断长度(避免把整页 HTML 塞进错误对象)
|
||||
const DETAIL_LIMIT: usize = 400;
|
||||
|
||||
impl TranslateError {
|
||||
pub fn new(kind: ErrorKind, message: impl Into<String>) -> Self {
|
||||
Self {
|
||||
kind,
|
||||
message: message.into(),
|
||||
detail: None,
|
||||
}
|
||||
}
|
||||
|
||||
pub fn with_detail(mut self, detail: impl Into<String>) -> Self {
|
||||
let raw = detail.into();
|
||||
let trimmed = raw.trim();
|
||||
if !trimmed.is_empty() {
|
||||
let clipped: String = trimmed.chars().take(DETAIL_LIMIT).collect();
|
||||
self.detail = Some(clipped);
|
||||
}
|
||||
self
|
||||
}
|
||||
|
||||
pub fn config(msg: impl Into<String>) -> Self {
|
||||
Self::new(ErrorKind::Config, msg)
|
||||
}
|
||||
pub fn auth(msg: impl Into<String>) -> Self {
|
||||
Self::new(ErrorKind::Auth, msg)
|
||||
}
|
||||
pub fn rate_limit(msg: impl Into<String>) -> Self {
|
||||
Self::new(ErrorKind::RateLimit, msg)
|
||||
}
|
||||
pub fn network(msg: impl Into<String>) -> Self {
|
||||
Self::new(ErrorKind::Network, msg)
|
||||
}
|
||||
pub fn timeout(msg: impl Into<String>) -> Self {
|
||||
Self::new(ErrorKind::Timeout, msg)
|
||||
}
|
||||
pub fn parse(msg: impl Into<String>) -> Self {
|
||||
Self::new(ErrorKind::Parse, msg)
|
||||
}
|
||||
pub fn unsupported(msg: impl Into<String>) -> Self {
|
||||
Self::new(ErrorKind::Unsupported, msg)
|
||||
}
|
||||
pub fn empty() -> Self {
|
||||
Self::new(ErrorKind::Empty, "没有可翻译的内容")
|
||||
}
|
||||
|
||||
/// 该错误是否值得「换一个源再试」。
|
||||
///
|
||||
/// 只有 `Empty` 不可重试:输入本身为空,换任何源结果都一样。
|
||||
/// `Unsupported`(本源超长上限 / 不支持该语言对 / 类型未接入)**必须可降级**——
|
||||
/// 「这个源处理不了这个请求」的含义就是「换下一个」,否则配了
|
||||
/// MyMemory + DeepSeek 的用户翻译一篇超长文本会整体失败(MyMemory 优先时)。
|
||||
pub fn retryable(&self) -> bool {
|
||||
self.kind != ErrorKind::Empty
|
||||
}
|
||||
}
|
||||
|
||||
impl std::fmt::Display for TranslateError {
|
||||
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
||||
write!(f, "{}", self.message)
|
||||
}
|
||||
}
|
||||
|
||||
impl std::error::Error for TranslateError {}
|
||||
|
||||
/// 把模板中的占位符替换为实际语言名。
|
||||
pub fn render_template(template: &str, req: &EngineRequest) -> String {
|
||||
let target = if req.to_label.trim().is_empty() {
|
||||
req.to.as_str()
|
||||
} else {
|
||||
req.to_label.as_str()
|
||||
};
|
||||
let source = if req.from_label.trim().is_empty() {
|
||||
"原文的语言(自动判断)"
|
||||
} else {
|
||||
req.from_label.as_str()
|
||||
};
|
||||
template
|
||||
.replace("{target}", target)
|
||||
.replace("{source}", source)
|
||||
}
|
||||
|
||||
/// 翻译模式下统一附加的「混排」指令。
|
||||
///
|
||||
/// 截图 OCR 经常抽出中英日混排的文本;显式源语言提示(如「源语言:日语」)反而
|
||||
/// 会诱导模型把与目标语言字形相同的部分(日文汉字)当作「已经是译文」原样保留
|
||||
/// ——这正是「日转中却总有一些日语没被翻译」的主因。
|
||||
///
|
||||
/// 固定追加在 user 内容末尾而不是改进提示词模板:模板是用户已保存的存量设置,
|
||||
/// 改默认值对老用户不生效;这条属于引擎层的硬约束,不该被模板覆盖。
|
||||
const MIXED_LANG_NOTE: &str = "注意:原文可能是多语言混排(如中英日混排)。\
|
||||
请把全部内容统一译为目标语言——包括与目标语言字形相同的文字(如日文汉字)也要译,\
|
||||
不要原样保留;仅专有名词可保留原文。";
|
||||
|
||||
/// 构造送给模型的用户内容。
|
||||
///
|
||||
/// 纯文本时:仅在**显式指定了源语言**时补一行提示——模型对「源语言是日语」的显式声明
|
||||
/// 比让它自行判断更稳;不指定时什么都不加,避免制造无谓的 token 与
|
||||
/// 「别输出提示」的博弈。
|
||||
///
|
||||
/// 带图像时:改为 OpenAI 视觉消息的 content-parts 结构(文本段 + image_url 段),
|
||||
/// 与 `https://platform.openai.com/docs/guides/vision` 的请求体一致;
|
||||
/// 兼容该格式的服务(DeepSeek 的实验视觉模型、通义、GLM-4V 等)可直接受理。
|
||||
pub fn build_user_content(req: &EngineRequest, supports_vision: bool) -> serde_json::Value {
|
||||
let source_hint = if req.mode == TranslateMode::Translate
|
||||
&& !req.from.trim().is_empty()
|
||||
&& req.from != "auto"
|
||||
&& !req.from_label.trim().is_empty()
|
||||
{
|
||||
Some(format!("源语言:{}", req.from_label))
|
||||
} else {
|
||||
None
|
||||
};
|
||||
|
||||
match &req.image_png {
|
||||
Some(data_url) if supports_vision => {
|
||||
let mut parts = vec![];
|
||||
if let Some(hint) = source_hint {
|
||||
parts.push(json!({ "type": "text", "text": hint }));
|
||||
}
|
||||
parts.push(json!({
|
||||
"type": "text",
|
||||
"text": "识别图中的文字并按系统提示翻译。保持原有排版与分段。"
|
||||
}));
|
||||
if req.mode == TranslateMode::Translate {
|
||||
parts.push(json!({ "type": "text", "text": MIXED_LANG_NOTE }));
|
||||
}
|
||||
parts.push(json!({
|
||||
"type": "image_url",
|
||||
"image_url": { "url": format!("data:image/png;base64,{data_url}") }
|
||||
}));
|
||||
json!(parts)
|
||||
}
|
||||
Some(_) => {
|
||||
// 带图但引擎不支持:这不该发生(命令层已拦截),兜底只发文本说明,
|
||||
// 而不是让请求带着一个模型无法理解的字段出去
|
||||
let note = "(请求包含图像,但当前引擎不支持图像输入,仅能处理文本。)";
|
||||
json!(format!("{}{}", note, req.text))
|
||||
}
|
||||
None => {
|
||||
let text = req.text.clone();
|
||||
let base = match source_hint {
|
||||
Some(hint) => format!("{hint}\n\n{text}"),
|
||||
None => text,
|
||||
};
|
||||
// 翻译模式统一追加混排指令;其他模式(润色/解释/总结)语义不同,不追加
|
||||
if req.mode == TranslateMode::Translate {
|
||||
json!(format!("{base}\n\n{MIXED_LANG_NOTE}"))
|
||||
} else {
|
||||
json!(base)
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 参数对齐后的公共请求体骨架(`model` / `messages` / `stream` 由各引擎补充)。
|
||||
pub fn apply_common_params(
|
||||
body: &mut serde_json::Map<String, serde_json::Value>,
|
||||
cfg: &TranslateEngineConfig,
|
||||
) {
|
||||
body.insert("temperature".to_string(), serde_json::json!(cfg.temperature));
|
||||
body.insert("max_tokens".to_string(), serde_json::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);
|
||||
}
|
||||
}
|
||||
// 解析失败按「无额外参数」处理:不能让一次笔误导致整个翻译不可用,
|
||||
// 具体错误由命令层的 translate_engine_test 反馈给用户。
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 流式翻译的单条事件。
|
||||
///
|
||||
/// 引擎 → 命令层用 `mpsc` 通道传递(引擎不持有 AppHandle,保持传输层与 UI 层分离),
|
||||
/// 命令层再转发为 Tauri 事件给前端。
|
||||
///
|
||||
/// **序列化形态是前端契约的一部分**:`tag = "type"` 让事件扁平化为
|
||||
/// `{"type":"chunk","requestId":"...","delta":"..."}`,而不是 serde 默认的外层标签
|
||||
/// `{"Chunk":{...}}`。前端按 `requestId` 过滤事件,多一层嵌套会让 `requestId` 取到
|
||||
/// `undefined`、所有事件被丢弃——表现为「历史里有结果,界面上一片空白」。
|
||||
///
|
||||
/// **注意 serde 的一个坑**:`rename_all` 用在枚举上只重命名**变体名**(Chunk → chunk),
|
||||
/// 不作用于变体内的字段——`request_id` 会原样序列化成 `request_id`,前端拿
|
||||
/// `payload.requestId` 永远是 undefined。因此每个变体的 `request_id` 字段都显式
|
||||
/// `#[serde(rename = "requestId")]`,别合并成 `rename_all_fields`(依赖 serde 版本)。
|
||||
/// 改动这里必须同步改 `src/lib/translate/api.ts` 的 `StreamEventPayload`。
|
||||
///
|
||||
/// `Error` 变体是**兜底通道**:主通道仍是命令的 `Err`(Promise reject)。保留它
|
||||
/// 是为了覆盖「命令已返回 requestId、之后才失败」的情形,否则前端会永远停在
|
||||
/// 「翻译中」而没有出口。
|
||||
#[derive(Debug, Clone, serde::Serialize)]
|
||||
#[serde(tag = "type", rename_all = "camelCase")]
|
||||
pub enum StreamEvent {
|
||||
/// 增量片段
|
||||
Chunk {
|
||||
#[serde(rename = "requestId")]
|
||||
request_id: String,
|
||||
delta: String,
|
||||
},
|
||||
/// 完成(携带完整结果,含实际引擎名)
|
||||
Done {
|
||||
#[serde(rename = "requestId")]
|
||||
request_id: String,
|
||||
result: TranslateResult,
|
||||
},
|
||||
/// 失败(兜底通道,见类型注释)
|
||||
Error {
|
||||
#[serde(rename = "requestId")]
|
||||
request_id: String,
|
||||
error: TranslateError,
|
||||
},
|
||||
}
|
||||
|
||||
/// 引擎统一接口。
|
||||
///
|
||||
/// 用 `async_trait` 而非原生 `async fn in trait`:本 trait 需要 `Box<dyn>` 动态分派
|
||||
/// (多源切换是运行期决定的),原生 async fn 在 dyn 场景下不可用。
|
||||
#[async_trait::async_trait]
|
||||
pub trait TranslateEngine: Send + Sync {
|
||||
/// 引擎配置。id / name 等一律由此读取,避免在每个实现里重复存字段。
|
||||
fn config(&self) -> &TranslateEngineConfig;
|
||||
|
||||
/// 展示名(自动降级时用于记录「是谁失败了」)
|
||||
fn name(&self) -> &str {
|
||||
&self.config().name
|
||||
}
|
||||
|
||||
/// 执行一次翻译
|
||||
async fn translate(&self, req: &EngineRequest) -> Result<TranslateResult, TranslateError>;
|
||||
|
||||
/// 流式翻译:增量经 `tx` 下发,结束时发一条 [`StreamEvent::Done`]。
|
||||
///
|
||||
/// 默认实现是「同步翻译后整体下发」——**不支持流式的引擎不需要实现它**,
|
||||
/// 前端因此可以统一走流式入口,无需自己判断引擎能力。
|
||||
/// 通道关闭(`send` 失败)意味着调用方已放弃本次请求,实现方应尽快返回而不是报错。
|
||||
async fn translate_stream(
|
||||
&self,
|
||||
req: &EngineRequest,
|
||||
request_id: String,
|
||||
tx: tokio::sync::mpsc::Sender<StreamEvent>,
|
||||
) -> Result<(), TranslateError> {
|
||||
let result = self.translate(req).await?;
|
||||
let _ = tx.send(StreamEvent::Done { request_id, result }).await;
|
||||
Ok(())
|
||||
}
|
||||
|
||||
/// 拉取可用模型列表(用于「上游改名」这类失效场景的自救入口)
|
||||
async fn list_models(&self) -> Result<Vec<String>, TranslateError>;
|
||||
|
||||
/// 连通性自检:返回一句人类可读的成功描述(含实际模型回显)
|
||||
async fn test(&self) -> Result<String, TranslateError>;
|
||||
}
|
||||
|
||||
/// 内部语言码 → 第三方源使用的语言码。
|
||||
///
|
||||
/// 只有中文需要换算:内部统一用 BCP-47 的 `zh-Hans` / `zh-Hant`,而 MyMemory
|
||||
/// 沿用 `zh-CN` / `zh-TW` 这一代写法。其余语言码两边一致,原样透传——
|
||||
/// 与其维护一张可能过期的全量映射表,不如只处理确有差异的项。
|
||||
/// 注意 LibreTranslate 用的是 `zh-Hans` / `zh-Hant`,与内部一致,**不走本函数**。
|
||||
pub fn provider_code(code: &str) -> String {
|
||||
match code {
|
||||
"zh-Hans" => "zh-CN".to_string(),
|
||||
"zh-Hant" => "zh-TW".to_string(),
|
||||
other => other.to_string(),
|
||||
}
|
||||
}
|
||||
|
||||
/// 免费源的语言支持是「尽力而为」的:第三方接口对不支持的语言对通常返回
|
||||
/// 空译文而不是明确报错,因此统一在这里识别,给出可操作的提示。
|
||||
pub fn is_auto(code: &str) -> bool {
|
||||
let c = code.trim();
|
||||
c.is_empty() || c == "auto"
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::StreamEvent;
|
||||
|
||||
/// 前端契约测试:事件必须扁平化为 `{"type":"chunk","requestId":...}`。
|
||||
/// 守护枚举字段命名的 serde 坑(rename_all 在枚举上不改字段名),
|
||||
/// 一旦回退,前端所有流式事件都会因 requestId 取到 undefined 被丢弃。
|
||||
#[test]
|
||||
fn stream_event_serializes_flat_with_camel_case_request_id() {
|
||||
let json = serde_json::to_value(StreamEvent::Chunk {
|
||||
request_id: "r1".into(),
|
||||
delta: "x".into(),
|
||||
})
|
||||
.unwrap();
|
||||
assert_eq!(json["type"], "chunk", "实际形态: {json}");
|
||||
assert_eq!(json["requestId"], "r1", "实际形态: {json}");
|
||||
assert!(json.get("request_id").is_none(), "实际形态: {json}");
|
||||
|
||||
let json = serde_json::to_value(StreamEvent::Done {
|
||||
request_id: "r1".into(),
|
||||
result: super::TranslateResult {
|
||||
text: "t".into(),
|
||||
detected: None,
|
||||
engine_id: "e".into(),
|
||||
engine_name: "n".into(),
|
||||
latency_ms: 1,
|
||||
usage: None,
|
||||
},
|
||||
})
|
||||
.unwrap();
|
||||
assert_eq!(json["type"], "done", "实际形态: {json}");
|
||||
assert_eq!(json["requestId"], "r1", "实际形态: {json}");
|
||||
assert_eq!(json["result"]["engineName"], "n", "实际形态: {json}");
|
||||
}
|
||||
}
|
||||
|
||||
/// 依据配置构造引擎实例。
|
||||
///
|
||||
/// P0/P1 已实现:`ai`(OpenAI 兼容家族)与 `free` 下的 libretranslate / mymemory;
|
||||
/// `cloud`(需签名的云厂商)在 P3。未实现的类型显式返回 `Unsupported` 而不是静默忽略,
|
||||
/// 避免用户配了却「以为生效」。
|
||||
pub fn build_engine(
|
||||
cfg: &TranslateEngineConfig,
|
||||
templates: &PromptTemplates,
|
||||
client: reqwest::Client,
|
||||
) -> Result<Box<dyn TranslateEngine>, TranslateError> {
|
||||
match cfg.kind.as_str() {
|
||||
"ai" => Ok(Box::new(ai::AiEngine::new(
|
||||
cfg.clone(),
|
||||
templates.clone(),
|
||||
client,
|
||||
))),
|
||||
"free" => match cfg.preset.as_str() {
|
||||
"libretranslate" => Ok(Box::new(libretranslate::LibreTranslateEngine::new(
|
||||
cfg.clone(),
|
||||
client,
|
||||
))),
|
||||
"mymemory" => Ok(Box::new(mymemory::MyMemoryEngine::new(cfg.clone(), client))),
|
||||
other => Err(TranslateError::unsupported(format!(
|
||||
"免密钥源「{other}」尚未接入(可选:libretranslate / mymemory)"
|
||||
))),
|
||||
},
|
||||
"cloud" => match cfg.preset.as_str() {
|
||||
"deepl" => Ok(Box::new(deepl::DeepLEngine::new(cfg.clone(), client))),
|
||||
other => Err(TranslateError::unsupported(format!(
|
||||
"云厂商源「{other}」尚未接入(可选:deepl)"
|
||||
))),
|
||||
},
|
||||
other => Err(TranslateError::config(format!(
|
||||
"未知的引擎类型「{other}」(仅支持 ai / free / cloud)"
|
||||
))),
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,216 @@
|
||||
//! MyMemory 免密钥翻译源。
|
||||
//!
|
||||
//! 定位:国内可直接访问的免密兜底。质量不如大模型,但胜在零配置、无代理依赖。
|
||||
//!
|
||||
//! 两个必须知道的限制:
|
||||
//! - **不支持自动检测源语言**。`langpair` 要求显式源语言,因此源语言为 `auto` 时
|
||||
//! 直接返回可操作的配置错误(而不是发一个注定失败的请求),让「自动」模式降级到下一个源。
|
||||
//! - 免费额度按**字节**计(约 500 字节/次,匿名另有每日上限)。超限时上游返回
|
||||
//! `responseStatus: 403` 并在 `responseDetails` 里说明,这里原样透传给用户看。
|
||||
|
||||
use std::time::{Duration, Instant};
|
||||
|
||||
use serde::Deserialize;
|
||||
|
||||
use super::{
|
||||
is_auto, provider_code, ErrorKind, TranslateEngine, TranslateError, TranslateResult,
|
||||
};
|
||||
use crate::translate::settings::TranslateEngineConfig;
|
||||
|
||||
const ENDPOINT: &str = "https://api.mymemory.translated.net/get";
|
||||
|
||||
/// 单次查询的字节上限(上游按字节限制,且 langpair 也占额度的一部分)
|
||||
const MAX_QUERY_BYTES: usize = 500;
|
||||
|
||||
const PROBE_TEXT: &str = "Hello, world.";
|
||||
|
||||
pub struct MyMemoryEngine {
|
||||
cfg: TranslateEngineConfig,
|
||||
client: reqwest::Client,
|
||||
}
|
||||
|
||||
impl MyMemoryEngine {
|
||||
pub fn new(cfg: TranslateEngineConfig, client: reqwest::Client) -> Self {
|
||||
Self { cfg, client }
|
||||
}
|
||||
}
|
||||
|
||||
#[async_trait::async_trait]
|
||||
impl TranslateEngine for MyMemoryEngine {
|
||||
fn config(&self) -> &TranslateEngineConfig {
|
||||
&self.cfg
|
||||
}
|
||||
|
||||
async fn translate(
|
||||
&self,
|
||||
req: &super::EngineRequest,
|
||||
) -> Result<TranslateResult, TranslateError> {
|
||||
let text = req.text.trim();
|
||||
if text.is_empty() {
|
||||
return Err(TranslateError::empty());
|
||||
}
|
||||
if is_auto(&req.from) {
|
||||
// 不猜:源语言未知时上游无法工作,明确返回配置类错误(可降级)。
|
||||
// 文案要同时覆盖两个入口:主面板的源语言下拉、划词弹窗顶部的「自」循环按钮
|
||||
// ——弹窗的源语言是独立记忆项,与主面板的选择无关,不点明用户会以为
|
||||
// 「主界面选过了为什么还报错」。
|
||||
return Err(TranslateError::config(format!(
|
||||
"「{}」需要显式指定源语言:主面板请在源语言下拉中选具体语言;\
|
||||
划词弹窗请点击顶部的「自」按钮切换源语言(选择会被记住)",
|
||||
self.cfg.name
|
||||
)));
|
||||
}
|
||||
if text.len() > MAX_QUERY_BYTES {
|
||||
return Err(TranslateError::unsupported(format!(
|
||||
"文本 {} 字节,超过「{}」的单次上限({MAX_QUERY_BYTES} 字节)",
|
||||
text.len(),
|
||||
self.cfg.name
|
||||
)));
|
||||
}
|
||||
let target = provider_code(&req.to);
|
||||
if target.trim().is_empty() {
|
||||
return Err(TranslateError::config("未指定目标语言"));
|
||||
}
|
||||
let pair = format!("{}|{}", provider_code(&req.from), target);
|
||||
|
||||
let started = Instant::now();
|
||||
let resp = self
|
||||
.client
|
||||
.get(ENDPOINT)
|
||||
.query(&[("q", text), ("langpair", pair.as_str())])
|
||||
.timeout(Duration::from_millis(self.cfg.timeout_ms.max(2_000)))
|
||||
.send()
|
||||
.await
|
||||
.map_err(|e| classify_reqwest(e, self.cfg.name.as_str()))?;
|
||||
|
||||
let status = resp.status();
|
||||
let raw = resp.text().await.map_err(|e| {
|
||||
TranslateError::network(format!("读取「{}」响应失败: {e}", self.cfg.name))
|
||||
})?;
|
||||
if !status.is_success() {
|
||||
return Err(TranslateError::network(format!(
|
||||
"「{}」返回 HTTP {status}",
|
||||
self.cfg.name
|
||||
))
|
||||
.with_detail(raw.trim()));
|
||||
}
|
||||
|
||||
let parsed: MyMemoryResponse = serde_json::from_str(&raw).map_err(|e| {
|
||||
TranslateError::parse(format!("「{}」响应不是预期的 JSON: {e}", self.cfg.name))
|
||||
.with_detail(&raw)
|
||||
})?;
|
||||
|
||||
// responseStatus 可能是数字 200 也可能是字符串 "403",统一取整再判断
|
||||
let code = parsed
|
||||
.response_status
|
||||
.as_ref()
|
||||
.and_then(status_as_u64);
|
||||
if let Some(c) = code {
|
||||
if c != 200 {
|
||||
let detail = parsed
|
||||
.response_details
|
||||
.clone()
|
||||
.unwrap_or_else(|| "上游未提供说明".to_string());
|
||||
let kind = if c == 403 { ErrorKind::RateLimit } else { ErrorKind::Unknown };
|
||||
return Err(TranslateError::new(
|
||||
kind,
|
||||
format!("「{}」拒绝了请求(status={c})", self.cfg.name),
|
||||
)
|
||||
.with_detail(detail));
|
||||
}
|
||||
}
|
||||
|
||||
let text_out = parsed
|
||||
.response_data
|
||||
.and_then(|d| d.translated_text)
|
||||
.map(|s| s.trim().to_string())
|
||||
.filter(|s| !s.is_empty());
|
||||
|
||||
let out = match text_out {
|
||||
Some(t) => t,
|
||||
None => {
|
||||
// 免费额度用尽时也会走到这里,把上游说明带上,用户才知所以然
|
||||
let detail = parsed
|
||||
.response_details
|
||||
.filter(|d| !d.trim().is_empty())
|
||||
.unwrap_or_else(|| raw.clone());
|
||||
return Err(TranslateError::new(
|
||||
ErrorKind::Empty,
|
||||
format!("「{}」未返回译文(额度用尽或语言对不支持)", self.cfg.name),
|
||||
)
|
||||
.with_detail(detail));
|
||||
}
|
||||
};
|
||||
|
||||
Ok(TranslateResult {
|
||||
text: out,
|
||||
// 源语言是用户显式指定的,没有可上报的检测结果
|
||||
detected: None,
|
||||
engine_id: self.cfg.id.clone(),
|
||||
engine_name: self.cfg.name.clone(),
|
||||
latency_ms: started.elapsed().as_millis() as u64,
|
||||
usage: None,
|
||||
})
|
||||
}
|
||||
|
||||
async fn list_models(&self) -> Result<Vec<String>, TranslateError> {
|
||||
Ok(Vec::new())
|
||||
}
|
||||
|
||||
async fn test(&self) -> Result<String, TranslateError> {
|
||||
let req = super::EngineRequest {
|
||||
text: PROBE_TEXT.to_string(),
|
||||
from: "en".to_string(),
|
||||
to: "zh-Hans".to_string(),
|
||||
to_label: "简体中文".to_string(),
|
||||
from_label: "英语".to_string(),
|
||||
mode: super::TranslateMode::Translate,
|
||||
image_png: None,
|
||||
via: "preview".to_string(),
|
||||
};
|
||||
let started = Instant::now();
|
||||
let result = self.translate(&req).await?;
|
||||
Ok(format!(
|
||||
"连通正常 · {}ms · 回显「{}」",
|
||||
started.elapsed().as_millis(),
|
||||
result.text
|
||||
))
|
||||
}
|
||||
}
|
||||
|
||||
/// 从数字或字符串形式的 status 字段取整
|
||||
fn status_as_u64(v: &serde_json::Value) -> Option<u64> {
|
||||
match v {
|
||||
serde_json::Value::Number(n) => n.as_u64(),
|
||||
serde_json::Value::String(s) => s.trim().parse::<u64>().ok(),
|
||||
_ => None,
|
||||
}
|
||||
}
|
||||
|
||||
fn classify_reqwest(e: reqwest::Error, engine: &str) -> TranslateError {
|
||||
if e.is_timeout() {
|
||||
return TranslateError::timeout(format!(
|
||||
"请求「{engine}」超时,可调大超时时间或检查网络"
|
||||
));
|
||||
}
|
||||
if e.is_connect() {
|
||||
return TranslateError::network(format!("无法连接「{engine}」:{e},请检查网络"));
|
||||
}
|
||||
TranslateError::network(format!("请求「{engine}」失败:{e}"))
|
||||
}
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
struct MyMemoryResponse {
|
||||
#[serde(rename = "responseData", default)]
|
||||
response_data: Option<ResponseData>,
|
||||
#[serde(rename = "responseStatus", default)]
|
||||
response_status: Option<serde_json::Value>,
|
||||
#[serde(rename = "responseDetails", default)]
|
||||
response_details: Option<String>,
|
||||
}
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
struct ResponseData {
|
||||
#[serde(rename = "translatedText", default)]
|
||||
translated_text: Option<String>,
|
||||
}
|
||||
Reference in new issue
Block a user