翻译（Host）¶
| Command | 说明 |
|---|---|
translate_text |
免费 MT + 商用 BYOK + 内置 provider 路径（非文献 Translator） |
builtin_provider_status |
内置 provider 的非秘密快照（available / baseUrl / 三个 model id）；见 builtin-provider.md |
| 项 | 值 |
|---|---|
通用 timeout_ms |
可选；钳制 1s–30s；默认 30s |
| 商用 BYOK | DeepL / Azure / Google Cloud / OpenAI-compatible；apiKey 可由调用方传入，或由 Host 从 settings.translate.providerConfigs 解析（前端仅持有同长度 * 掩码） |
| 内置 provider | id agentero；凭证由构建期环境变量注入，用户在设置里选它即可，无需填 key / baseUrl / model。走 Hunyuan-MT，见下方 |
| OpenAI-compatible prompt | openai_translate_prompt：学术译者 system prompt + 规则块（按意思重组语序、公式/符号/引用/⟦n⟧ 占位符原样、术语一致、只输出译文、批量保留 [[n]]）；temperature 0.2。与前端 buildTranslatePrompt 保持同步 |
| 密钥存储 | BYOK：明文写在用户本机 settings.json（Unix 0600）；settings_get / 广播按字符 redact 为 *；settings_set 对纯 * 串 merge 保留原值。内置 provider 的 key 不落 settings.json，编译期编入二进制、只在 Host 进程内使用（见 builtin-provider.md §密钥边界） |
导入摘要 free_mt_to_zh |
并行竞速 腾讯 / 火山 / DeepLX，取最先成功；单引擎 5s（FREE_MT_ZH_TIMEOUT_MS）；全失败则不写翻译。内置 provider 不参与这条竞速：ZH_RACE_PROVIDERS 只含免费引擎，导入摘要仍走非官方免费接口 |
| 设置页探测 | 前端 5s / 引擎；内置 provider 不参与探测，可用性直接来自 builtin_provider_status |
内置 provider（Hunyuan-MT）¶
tencent/Hunyuan-MT-7B 是专用 MT 模型，不是 instruct 模型，因此这条路径不复用上面的长规则 prompt，也不给模型看 [[n]] 批量标记（对齐协议依赖指令遵循）：
| 项 | 值 |
|---|---|
| 模板 | Translate the following segment into <target_language>, without additional explanation.<source_text>（逐字；指令与原文之间无空格无换行） |
| 消息 | 单条 user message，无 system message；sourceLang 不参与（模板没有它的位置，模型自动检测） |
[[n]] |
Host 侧按行首标记拆分（从 1 递增；行中或乱序即停止扫描）→ 每段一个请求 → buffered(3) 保序并发 → 按 "{marker} {text}" + "\n\n" 重组，与前端 buildNumberedPayload 字节一致。空段丢弃，段数变少时前端回退逐段翻译 |
⟦n⟧ |
mask.ts 插入的行内占位符原样透传，不剥离（未经真实 key 验证） |
| 目标语言 | 只映射可达值：zh-CN → Chinese，en → English，防御性 ui → English，未知/auto/空 → English。上限由 TR_TARGETS 决定，模型侧的 37 语言见 builtin-provider.md §支持语言 |
| 无 key | commands.rs 在任何 .await 前返回 AppError::domain(ERR_NO_BUILTIN_KEY)（translate.no_builtin_key），不放一个无法认证的请求出去 |
| 列表归属 | "agentero" 既不在 Rust FREE_PROVIDERS（CLI 用它门控 --provider 且以 api_key: None 调用）也不在 COMMERCIAL_PROVIDERS（驱动 WebView 凭证卡片）。但前端 FreeTranslateProviderId / FREE_MT_PROVIDER_IDS 含它——借此复用无 key 管线且不渲染凭证卡片；两份清单刻意相反，改一份要想到另一份 |
| 探测 | probeFreeMtProviders 显式过滤掉 agentero（探测它会真发一次翻译请求）；可用性只来自 builtin_provider_status |
实现：crates/agentero-core/src/features/translate/sources/hunyuan_mt.rs；凭证解析 src-tauri/src/features/translate/commands.rs + src-tauri/src/features/system/builtin/。限制与未决项见 builtin-provider.md §限制与后续。
Agent 翻译走 agent_run_once，不经本 command。
前端服务层：../frontend/translate.md
代码：src-tauri/src/features/translate/