Wenyi命令行实战:8个高频命令助你快速成为翻译高手
【免费下载链接】wenyi将被语言阻隔的作品,带到读者的语言中。Bringing literature into your language.项目地址: https://gitcode.com/BigDawnGhost/wenyi
Wenyi 是一个面向长篇小说的 AI 翻译开源项目,一条命令就能把整本书翻译成中文并导出 EPUB。本文带你快速上手 Wenyi 翻译命令行:从安装到 8 个高频命令,让你几分钟内把任意格式的书变成自己的译文。
3 分钟安装 Wenyi 命令行
Wenyi 提供各平台独立可执行文件(Windows / Linux / macOS),下载解压即可运行;也可以从源码安装,需要 Python 3.10+ 和 uv:
uv sync export DEEPSEEK_API_KEY=sk-... uv run wenyi --version程序启动时会自动检查并生成一份带注释的默认配置 config.yaml,改好模型设置再开始正式翻译即可。
命令 1:translate —— 一条命令翻译整本书 📖
wenyi translate book.epub它会自动完成解析、语言检测、全书预扫描、逐章翻译、审校和导出,默认输出output/book.zh.epub。支持 EPUB、FB2、TXT、Markdown、HTML、PDF、DOCX,甚至 SRT 字幕。常用参数:
| 参数 | 作用 |
|---|---|
--chapter 3 | 只翻译第 4 章(从 0 计数),跳过审校与导出 |
--format txt | 指定导出格式:epub / txt / html / markdown / pdf / docx |
--bilingual | 额外生成"译文 + 原文"双语版本 |
--polish / --no-polish | 开关润色(强模型重写) |
--review / --no-review | 开关全书终审 |
断点续传是它的招牌能力:翻译中断后,直接再跑一遍同样的命令即可从上次的位置继续,不用从头再来。
命令 2:prepare —— 先分析,后翻译 🧭
wenyi prepare book.epub只完成解析、风格分析与全书预扫描(生成章节摘要和初始术语表),不翻译正文。适合先检查分析结果是否正确,再用translate从保存的状态继续翻译,详见 docs/usage.md。
命令 3:status —— 随时掌握翻译进度 ⏱️
wenyi status book.epub显示每一章的完成状态(✓ / ·)、术语表统计和累计用时。长书翻译动辄几十分钟,用 status 确认"译到哪儿了、花了多少时间"最省心。
命令 4:assemble —— 不调模型,重新导出成品 📦
wenyi assemble book.epub --format pdf --bilingual基于已有翻译状态直接重新导出,不消耗任何 token。想换格式、改双语排版、换个输出文件名时用它最划算。
命令 5:review —— 全书审校与自动修复 🔍
wenyi review book.epub --autofix基于最终术语表对完整译稿做证据驱动的全书审校,可检出前后不一致、遗漏等问题;--autofix会把确认的修改发布回正式章节。每次审校都独立存档,历史可追溯。
命令 6:glossary —— 术语统一管理 📚
wenyi glossary list book.epub wenyi glossary conflicts book.epub wenyi glossary resolve book.epub "源术语" "选定译文"长书最怕人名地名前后不统一。list查看已确立的术语,conflicts列出发现的冲突译法,resolve一锤定音——之后的翻译会一直沿用你的选择。命令实现在 packages/cli/wenyi_cli/commands/glossary.py。
命令 7:report —— 生成翻译报告 📊
wenyi report book.epub重新生成report.json,汇总章节进度、术语数量、未解决冲突和空译文等指标,同样不消耗模型调用,适合交付前做最后检查。
命令 8:models —— 翻译前给配置做个体检 ✅
wenyi models list wenyi models check --for translate wenyi languagesmodels list查看每个环节实际路由到哪个模型;models check在本地校验凭据是否配好(不发送任何请求),避免翻译到一半才发现 key 写错了;languages列出支持的目标语言(中译英、日译中等实验性多语方向)。命令源码见 packages/cli/wenyi_cli/model_commands.py。
一条命令走完整个工作流 🚀
wenyi prepare book.epub # 1. 预分析 wenyi translate book.epub # 2. 断点续传式翻译 wenyi review book.epub # 3. 独立终审 wenyi status book.epub # 4. 检查进度更多输入输出细节(PDF、DOCX、字幕翻译)可查阅 docs/usage.md;核心工作流命令的实现在 packages/cli/wenyi_cli/commands/workflows.py。
掌握这 8 个命令,你就能把整本书、整份字幕完整地"带到读者的语言中"——这正是 Wenyi 想要做到的事。
【免费下载链接】wenyi将被语言阻隔的作品,带到读者的语言中。Bringing literature into your language.项目地址: https://gitcode.com/BigDawnGhost/wenyi
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考