Wenyi 文译：长文书籍翻译桌面应用

项目简介

Wenyi（文译）是一款用于翻译书籍与长篇写作的桌面应用，面向小说、社会科学专著、纪实文学等长文本场景。它强调「整本书都在视野中」：通过整书理解、术语一致和基于证据的审校，让每一批译文都与全书保持连贯。

主要功能

• 整书上下文：章节摘要、全书梗概与滚动上下文，帮助每一批翻译与全书其他部分保持联系。
• 术语一致：翻译过程中抽取人名、术语和反复出现的表达，冲突译法会被提示处理，并反馈到后续批次。
• 翻译与审校：可选的润色与基于证据的全书审校，配合段落编辑和修订历史。
• 断点续译：已完成的批次和章节会被保存，重新打开项目即可从检查点继续。
• 模型灵活：可使用 DeepSeek、OpenAI、OpenRouter、OrcaRouter、Google Gemini、Ollama、vLLM 等 OpenAI 兼容服务，并按操作选择模型、共享请求限制。

支持的格式

输入	输出
EPUB、PDF、DOCX、FB2、TXT、Markdown、HTML	EPUB、PDF（BabelDOC 项目）、DOCX、TXT、HTML、Markdown

• EPUB：译文写回原始 XHTML 模板，尽量保留样式、图片、目录与锚点；竖排会转换为横排以便中文阅读。
• PDF：默认输入后端为 MinerU，首次转换需要其 API key，生成的 HTML 会被缓存；带文本层的 PDF 可选 BabelDOC 桥接以保留版式。PDF 输出仅适用于已保存的 BabelDOC 项目。
• DOCX：尽量保留标题、简单表格、列表和常见字符/段落样式，译文中文使用宋体。
• 双语版本：在支持的情况下导出原文与译文对照版，EPUB 与 HTML 提供淡化的原文并支持深色模式。

安装与使用

桌面版（推荐）

1. 从 GitHub Releases 下载对应系统的 wenyi-desktop-* 安装包。
2. 打开 Settings → Models & connections，选择服务商，按需填写 API key 并保存。
3. 新建项目、导入书籍并开始翻译；在应用内校对后选择导出格式和保存位置。

安装包已内置翻译引擎与 Python 运行时，项目保存在本地工作区，翻译时使用你配置的模型服务。

命令行版（PyPI）

需要 Python 3.10+ 与 uv：

uv tool install wenyi-cli
wenyi models list

首次执行 models list 会在当前目录生成 config.yaml（不调用模型），翻译前请先检查。默认 DeepSeek 服务商需在本地终端设置自己的 key：

export DEEPSEEK_API_KEY="YOUR_DEEPSEEK_API_KEY"
wenyi translate book.epub

Web 与开发

自托管浏览器工作区参见 Web deployment 文档；从源码运行或修改参见 Contributing 文档。

界面预览

桌面版与 Web 版共用校对工作区：实时进度、带修订历史的段落编辑，以及全书审校结果。

注意事项

• 翻译质量受所选 LLM 模型能力限制。
• Token 消耗：润色与全书审校会显著增加用量，Shadow fixing 可能触发多次全书审校和额外的 Fixer 调用。
• 存储占用：工作区会随书籍长度增长，超长书籍可能需要较大磁盘空间。
• 请勿在未经许可的情况下分享受版权保护的文本、私人书籍或敏感工作区数据。
• 项目以 GPL-3.0 许可发布；可选的 BabelDOC 桥接是单独许可的 AGPL 服务，通过 HTTP 在独立进程中访问。

---

本作品整理自 GitHub 开源项目 BigDawnGhost/wenyi，原作者 @BigDawnGhost，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。