Wenyi快速上手：从安装到第一次EPUB翻译的最短路径
【免费下载链接】wenyi将被语言阻隔的作品，带到读者的语言中。Bringing literature into your language.项目地址: https://gitcode.com/BigDawnGhost/wenyi
Wenyi（文译）是一款开源的 AI 长篇小说翻译工具：一条 EPUB 翻译命令，就能完成书籍解析、全书理解、分批翻译与 EPUB 导出。本文带你走完从安装到第一次 EPUB 翻译的最短路径——只需 Python + uv + 一个模型 API Key，4 步搞定 🚀
为什么选择 Wenyi？
| 常见做法 | Wenyi 的做法 |
|---|---|
| 逐段孤立翻译，缺乏上下文 | 全书预扫 + 逐章梗概 + 滚动上下文 |
| 术语靠人工事后整理 | 实时抽取专有名词，自动检测译法冲突 |
| 一次性翻译，中断即作废 | 批次检查点，中断后同一命令即可续跑 |
| 模型直出，无质量流程 | 翻译 → 润色 → 全书审校 |
Wenyi 专为长文本设计：小说、社科专著、纪实文学都能处理。默认目标是简体中文，EPUB 输出会尽量回填原书 XHTML 模板，保留样式、图片、目录和锚点。
准备工作：安装 Wenyi 只需 3 条命令
环境要求：Python 3.10+ 和 uv（Python 包管理器）。
git clone https://gitcode.com/BigDawnGhost/wenyi cd wenyi uv sync验证安装是否成功：
uv run wenyi --version💡
uv sync会自动安装本地 CLI（wenyi-cli）和翻译引擎（wenyi-core），命令统一为wenyi。程序首次启动时会在当前目录生成带注释的默认配置文件 config.yaml，无需手写配置。
配置模型 API Key：最快 1 分钟
Wenyi 默认走 DeepSeek，只需设置环境变量：
export DEEPSEEK_API_KEY=sk-...其他提供商（OpenAI、Gemini、Ollama、vLLM 等）及模型路由，见 docs/configuration.md。如需指定源语言方向（默认自动检测），可在 config.yaml 中修改：
language: source: auto # 自动检测，也可固定为 ja / en / de 等 target: zh # 目标语言：zh / en / ja / ko 等第一条命令：EPUB 翻译全流程自动跑完
把一本book.epub放在终端目录里，然后执行：
uv run wenyi translate book.epub这一条命令背后是完整的翻译流水线：解析书籍 → 检测源语言 → 全书预扫（生成逐章梗概和全书概览）→ 分批翻译所有章节 → 组装导出。完成后，单语中文版output/book.zh.epub就生成在源文件旁的output/目录中 📖
加上--bilingual还可以同时输出双语对照版（原文视觉淡化、译文在前），效果如上图：
uv run wenyi translate book.epub --bilingualEPUB 翻译常用参数速查
| 参数 | 作用 |
|---|---|
--bilingual | 同时生成双语对照版 |
--chapter 0 | 只翻译第 1 章（索引从 0 开始），适合先试跑 |
--format txt | 导出为纯文本（也支持 html、markdown、docx） |
--no-polish | 关闭润色，省 token |
--no-review | 跳过最终全书审校 |
建议第一次翻译时用--chapter 0小范围试跑，确认译风满意后再跑全书。
中断了怎么办？同一命令续跑
每个完成的批次都会立即持久化。无论因为断网、Ctrl+C 还是关机中断，重新执行同一命令即可从断点续跑，已完成的批次自动跳过：
uv run wenyi translate book.epub # 再执行一次，自动续跑 uv run wenyi status book.epub # 随时查看进度⚠️ 注意：同名文件若内容变了（哈希不一致），无法续跑，会建立新的翻译状态。
进阶：分步工作流与 Web 工作台
想更精细地控制流程，可以拆成分步执行：
uv run wenyi prepare book.epub # 1. 解析、预扫，不翻译正文 uv run wenyi translate book.epub # 2. 翻译 uv run wenyi review book.epub # 3. 独立的最终全书审校如果偏好图形界面，Wenyi 提供 Web 工作台：实时查看翻译进度、Token 用量与缓存命中率（见 docs/web.md 了解 Docker 部署）：
译完后可在人工校阅页逐段对照原文修改，并保留完整的改动记录：
延伸阅读
- 使用指南（安装、输入输出、续跑、独立阶段）：docs/usage.md
- 配置说明（模型路由、语言、流水线开关）：docs/configuration.md
- 翻译流水线各阶段详解：docs/pipeline.md
- 支持的格式：EPUB、FB2、TXT、Markdown、HTML、PDF、DOCX、SRT 均可输入
从git clone到拿到第一本中文 EPUB，最快的路径就是：clone → uv sync → 设置 API Key →uv run wenyi translate book.epub。现在就可以拿一本公版书试试 ✨
【免费下载链接】wenyi将被语言阻隔的作品，带到读者的语言中。Bringing literature into your language.项目地址: https://gitcode.com/BigDawnGhost/wenyi
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
