# 📚 文译 **一条命令，从 EPUB 到可读的中文译本。** 全书预扫 · 实时术语闭环 · 多阶段审校 [![Python](https://img.shields.io/badge/python-3.10%2B-blue?style=flat-square)](https://www.python.org/) [![Tests](https://img.shields.io/github/actions/workflow/status/BigDawnGhost/wenyi/tests.yml?style=flat-square)](https://github.com/BigDawnGhost/wenyi/actions/workflows/tests.yml) [![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)](../../LICENSE) [![Stars](https://img.shields.io/github/stars/BigDawnGhost/wenyi?style=flat-square)](https://github.com/BigDawnGhost/wenyi/stargazers) [![Discord](https://img.shields.io/badge/Discord-join-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.gg/Tybfva4HT) [English](../../README.md) | **简体中文** 文译双语对照版阅读效果
--- ## 目录 - [为什么选择文译](#为什么选择文译) - [核心特性](#核心特性) - [快速开始](#快速开始) - [支持格式](#支持格式) - [翻译流水线](#翻译流水线) - [文档](#文档) - [憧憬与不足](#憧憬与不足) - [社区](#社区) - [星标历史](#星标历史) - [许可证](#许可证) --- ## 为什么选择文译 | 常见方案 | 文译 | |---|---| | 逐段翻译，彼此孤立，缺乏上下文 | 全书预扫 + 逐章梗概 + 滚动上下文 | | 术语靠人工事后整理 | 翻译中实时抽取专有名词，自动检测译法冲突，立即影响后续批次 | | 一次性翻译，中断即作废 | 批次检查点 + 章节状态记录，任意中断后重新执行同一命令即可续跑 | | 模型直出，无系统性质控 | 翻译 → 润色 → 章末回译抽检 → 最终审校 → 跨章一致性 QA | 文译为**长文本**设计 —— 长篇小说、社科专著、纪实文学…… --- ## 核心特性 - **全书理解** — 翻译前预扫源文，生成逐章梗概和全书概览，注入每批翻译上下文 - **实时术语闭环** — 翻译中自动提取人名、地名、术语和固定表达；检测译法冲突并提示人工裁决 - **多阶段质量保证** — 可选润色（强档模型重译）、全书最终 AI 审校、回译抽检、跨章一致性 QA - **断点续跑** — 批次级检查点、章节状态记录和原子状态写入；任意中断后重新执行同一命令即可续跑 - **多种 LLM 支持** — DeepSeek、OpenAI、OpenRouter、Google Gemini、Ollama、vLLM，以及通用 OpenAI 兼容端点 - **原生 EPUB 回填** — 基于原书 XHTML 模板替换译文片段，尽量保留原书样式、图片、目录和锚点 - **双语对照输出** — 可选原文译文对照版，原文视觉淡化，支持深色模式 --- ## 快速开始 ### 环境要求 需要 Python 3.10+ 与 [uv](https://docs.astral.sh/uv/)。 ### 安装 ```bash git clone https://github.com/BigDawnGhost/wenyi.git cd wenyi uv sync ``` ### 配置 设置 API 密钥： ```bash export DEEPSEEK_API_KEY=sk-... ``` ### 一键翻译 ```bash uv run trans-novel translate book.epub ``` 解析书籍、检测源语言、预扫全书、翻译所有章节、组装输出，一步完成。默认在 `output/` 目录生成单语中文版 `book.zh.epub`。 ### 分步工作流 ```bash # 1. 译前准备 — 解析、分析、预扫（不翻译正文） uv run trans-novel prepare book.epub # 2. 翻译 — 从准备状态续跑 uv run trans-novel translate book.epub # 3. 独立审校 — 基于最终术语库的逐章审校 uv run trans-novel review book.epub # 4. 一致性 QA uv run trans-novel qa book.epub # 5. 查看进度 uv run trans-novel status book.epub ``` ### 中断续跑 每个完成的批次立即持久化。中断后重新执行同一命令即可续跑： ```bash uv run trans-novel translate book.epub ``` ### 命令行覆盖 ```bash uv run trans-novel translate book.epub --polish --review --qa # 启用全部质量阶段 uv run trans-novel translate book.epub --no-polish # 关闭润色 uv run trans-novel translate book.epub --bilingual # 同时生成双语版 uv run trans-novel translate book.epub --chapter 0 # 仅翻译第一章（索引从 0 开始） uv run trans-novel translate book.epub --format txt # 导出为纯文本 ``` 最终审校默认关闭。设置 `pipeline.review: true` 后，一键流程会在全书翻译完成、 术语库达到最终状态后再统一执行审校；也可以独立运行 Agent Review： ```bash uv run trans-novel review book.epub ``` 每次 Review 都会从头全量运行，并发检查文本块，并可按需获取跨章证据后处理互相 矛盾的一致性建议。确认的问题可生成仅限本次运行的完整单段影子修订；下一轮从头盲审 只会看到影子译文，不会收到上一轮的问题说明。正式译文和正式状态始终不变，修订、 复审结果及未解决建议集中写入 `state/<书名>/reviews/review-<时间戳>/result.json`。 --- ## 支持格式 | 输入 | 输出 | |---|---| | EPUB、FB2、TXT、Markdown、HTML、PDF | EPUB（单语 / 双语）、TXT、HTML、Markdown | - PDF 输入首次需 `MINERU_API_KEY` 调用外部转换服务，转换后的 HTML 缓存复用。 - EPUB 输出尽量保留原书样式、图片、目录和锚点，竖排转为横排以适配中文阅读。 - 源语言默认由模型自动识别，也可在 `config.yaml` 中固定为 ISO 639-1 语言代码。 --- ## 翻译流水线 ```mermaid flowchart TD A[输入文件] --> B[解析章节并检测语言] B --> C[分析风格并建立初始术语] C --> D[可选并行预扫
生成逐章梗概与全书概览] D --> E subgraph T[逐章翻译] E[注入上下文并翻译一个批次] E --> F[润色并保存译文] F --> G[抽取术语并刷新术语快照] G --> H{还有待译批次？} H -- 是 --> E H -- 否 --> I[章末标点规范化与全章术语兜底抽取] I --> J[回译抽检并保存章节最终状态] end J --> K[可选并行全书审校
使用完整术语库] K --> N{存在确认问题且
仍有修订轮次？} N -- 是 --> O[基于同一固定快照
生成临时影子修订] O --> K N -- 否或达到停止条件 --> P[保存只读问题
与修改建议] P --> L[可选跨章一致性 QA] L --> M[生成报告并组装所选格式] ``` 启用全书理解时，预扫阶段按可配置并发数并行执行，并且幂等可续跑——已完成的梗概会跨运行复用。翻译过程中，每批获得最新的术语快照和已译上下文，确保代词、术语和语气跨章一致。 Review Fixer 同样会获得风格指南、全书概览、本章梗概、相关术语及邻近原译文， 以保持全书风格；它生成的替换只存在于本次运行的影子译文中。 --- ## 文档 - [使用指南](usage.md) — 安装、Windows 使用、输入输出、断点续跑和独立工作流阶段 - [配置说明](configuration.md) — 模型提供商、源语言、流水线开关、切分与路径配置 - [翻译流程](pipeline.md) — 预扫、术语、上下文、润色、审校和断点续跑如何协作 - [贡献指南](CONTRIBUTING.md) — 开发、测试和贡献要求 公版书翻译生成的状态目录可在 [wenyi-bookcase](https://github.com/BigDawnGhost/wenyi-bookcase) 查看，也欢迎提交分享。请勿提交或分享无授权的版权文本、私人书籍或包含敏感信息的 `state/` 目录。 --- ## 憧憬与不足 本项目为作者个人兴趣所开发，旨在为长文本书籍的译介做出一份微薄的努力。现阶段翻译质量仍受限于所选模型的能力：润色和审校阶段会显著增加 token 消耗，开启影子修订后还可能执行多次全书审校与额外 Fixer 调用；极长的书籍可能产生较大的状态目录，PDF 输入依赖外部 MinerU 服务。当前译文管线主要针对简体中文输出优化，不支持其他目标语言。 未来想让翻译在够准确的前提下更加顺畅，努力从可读向好读迈进。如果你发现了问题，欢迎提交 [Issue](https://github.com/BigDawnGhost/wenyi/issues)；如果你有想法，欢迎在[讨论区](https://github.com/BigDawnGhost/wenyi/discussions)提出；如果你有一定的编程能力，欢迎提交 PR，让这个项目变得更好。👏 --- ## 社区 - [Discord 服务器](https://discord.gg/Tybfva4HT) - QQ 群：1055065098 - [GitHub Issues](https://github.com/BigDawnGhost/wenyi/issues) — 问题反馈 - [GitHub Discussions](https://github.com/BigDawnGhost/wenyi/discussions) — 想法与讨论 --- ## 星标历史 Star History Chart --- ## 许可证 [MIT](../../LICENSE)