wenyi 是一个开源的 AI 外语小说翻译工具，支持将 EPUB、FB2、TXT 等格式整本翻译为中文 EPUB，同时尽量保留原始排版、图片和目录结构。项目旨在解决长篇书籍翻译中术语前后不一致、专有名词翻译不准确等问题，提升译文质量从"能看"到"好看"。

GitHub 仓库：github.com/BigDawnGhost/wenyi

核心功能

• 格式转换：将 EPUB、FB2、TXT 转换为中文 EPUB，也可指定输出纯 TXT
• 自动语言识别：翻译前自动检测源语言，或手动锁定日语、英语、韩语等
• 全书预扫：生成故事概览和每章梗概，翻译前文时也能了解后续走向
• 术语一致性：人名、地名、专有名词自动抽取到 SQLite 术语库，翻译时注入提示词，避免同一术语前后翻译不一致
• 上下文连贯：章内分批串行翻译，后一批能看到前面几段译文，上下文不割裂
• 可选润色与质检：支持润色、章末审校、回译抽检、全书一致性扫描，严重问题可自动重译
• 标点规范化：统一输出为全角中文标点
• 断点续传：每步状态写入本地 state/ 目录，中断后可从断点继续，已完成内容不会重复翻译

使用方法

安装 uv（Python 包管理器）后，克隆仓库并配置：

uv sync
export DEEPSEEK_API_KEY="your-api-key"
uv run trans-novel translate 小说.epub

翻译完成后，译文 EPUB 默认生成在源文件旁边。其他常用命令：

# 中断后继续
uv run trans-novel resume 小说.epub

# 查看进度
uv run trans-novel status 小说.epub

# 单独重新打包 EPUB
uv run trans-novel tools assemble 小说.epub

模型配置

默认使用 DeepSeek 接口，模型分三档：

• strong：翻译、润色等核心任务
• cheap：审校、回译抽检
• fast：预扫、术语抽取等机械任务

可通过修改 config.yaml 切换模型或关闭部分功能（如关闭润色以节省成本）。调试时可使用 fake provider，不发送真实请求即可完整跑通流程。

适用场景

wenyi 适合需要翻译整本外语小说、技术文档或非虚构类书籍的读者。术语库和上下文连贯机制让长篇翻译的质量显著优于逐段调用 API 的简单方案，断点续传也降低了长任务的成本风险。