忠实直译 + 结构保护
保留占位符、链接、目录结构与关键属性，减少翻译导致的 EPUB 结构损坏风险。
EPUB -> 简体中文 | v0.2.1
本地 EPUB AI 忠实翻译器
面向小说、文档和长篇内容的 EPUB 翻译工作流：真实模型统一使用 OpenAI-compatible Chat Completions API， 只需填写服务商提供的 Base URL、API Key 与模型名。内置真实翻译校验、并发批处理、断点续跑、 术语表约束和结构化 QA，GUI 与 CLI 均可使用。 当前目标语言固定为简体中文（zh-Hans）。
v0.2.1统一接口、模型校验与稳定性重构
1 Common APIOpenAI-compatible Chat Completions + 离线 mock
ResumeSQLite 缓存支持断点续翻
35 Tests接口、取消、容错与 EPUB 安全回归
核心功能
统一通用 LLM 接口
不再为厂商维护独立分支。任何实现常用 OpenAI-compatible Chat Completions 合约的服务均可配置。
术语表与强制译法
支持 termbase 命中优先与 force 约束，并可从 EPUB 自动生成候选术语。
断点续跑
基于 SQLite 缓存自动跳过已翻译段，长书翻译中断后可继续。
QA Gate
自动检查空译文、占位符一致性、链接与 TOC 完整性，输出 JSON/Markdown 报告。
真实模型校验
Test Model 会执行一次真实简短翻译，同时验证 URL、Key、模型名、响应格式和中文结果。
更快且更稳
连接复用、并发批处理、Retry-After 与随机退避、失败批次二分隔离，兼顾吞吐与故障恢复。
3 分钟上手
Step 1
下载安装包并完成安装。
Step 2
填写服务商提供的 Base URL、API Key 与模型名。
Step 3
点击
Test Model，用真实短译文确认配置可运行。Step 4
设置 Input/Output 与 Resume，点击
Start Translation。软件截图
v0.2.1 主界面：统一 Base URL、API Key、Model，并可直接执行真实模型校验。
稳定性配置：批次大小、重试退避与抖动、连接/响应超时及 QA 阈值。
下载与源码
推荐直接下载 GitHub Release 安装包（已包含运行环境）。 如需自动化或二次开发，可使用 CLI 与源码构建脚本。
常见问题
通用接口是否表示所有模型都使用 OpenAI URL？
不是。统一的是请求格式；Base URL、API Key 与模型名仍必须来自同一个服务商。配置完成后可用 Test Model 做真实验证。
QA error 是什么？
表示翻译流程完成，但质量检查出现错误项（例如占位符不一致、译文留原文、结构问题）。可根据 artifacts 目录中的 qa_summary.md 与 qa_report.json 定位问题。
会自动保存 API Key 吗？
不会。界面中填入的 Key 仅作用于当前进程，不会自动写入持久配置文件。
是否只能翻译成中文？
当前版本目标语言固定为简体中文（zh-Hans），并围绕中文输出质量做了针对性约束。
点击 Stop 后会发生什么？
系统会发出取消信号，停止后续批次提交；重试等待可被及时中断，并在当前网络请求退出后恢复 UI。
翻译完成后会生成哪些文件？
除输出 EPUB 外，还会生成 qa_report.json 与 qa_summary.md，用于问题定位和质量回顾。