企业官网建设流程全解析

Wenyi Windows安装指南：10分钟搭建本地AI翻译环境并翻译第一本书

【免费下载链接】wenyi将被语言阻隔的作品，带到读者的语言中。Bringing literature into your language.项目地址: https://gitcode.com/BigDawnGhost/wenyi

Wenyi 是一款开源的 AI 书籍翻译工具，专为小说、社科专著等长篇文本设计。本文将带你完成Wenyi Windows 安装：从下载官方包、配置 DeepSeek API Key，到用一条命令翻译第一本 EPUB 电子书，全程约 10 分钟，无需 Docker。

Wenyi AI 翻译工具能做什么？

与"逐段隔离翻译"的普通方案不同，Wenyi 主打整书理解：

• 📚全书预理解：翻译前先通读全书，生成章节摘要与整书梗概，每个批次都带着上下文翻译
• 📝实时术语库：自动提取人名、术语，检测前后不一致的译名并提示你裁决
• 🔍多阶段质量流程：翻译 → 润色 → 基于证据的全书 AI 审校
• 📦格式齐全：支持 EPUB、FB2、TXT、Markdown、HTML、PDF、DOCX 输入，还能直接翻译 SRT 字幕
• ⏯️断点续跑：每完成一个批次立即落盘，中断后重跑同一条命令即可继续

下图中，译文与原文并排呈现，原文以弱化样式显示，就是 Wenyi 双语版 EPUB 的阅读效果：

两种安装方式对比

两种方式最终都得到wenyi命令，后续步骤完全一致。

方式一：官方 Windows 包安装（无需 Python）

1. 从 Releases 页面下载wenyi-windows-x64.zip，以及用于校验的SHA256SUMS.txt
2. 先校验、再运行：用SHA256SUMS.txt核对压缩包哈希，确认无误后解压到任意目录（如D:\wenyi\）
3. 解压后得到wenyi.exe，在 PowerShell 中验证：

cd D:\wenyi .\wenyi.exe --version

能打印出版本号即安装成功。

方式二：源码安装（需要 Python 与 uv）

1. 安装 Python 3.10+（安装时勾选 "Add Python to PATH"）
2. 安装 uv：pip install uv
3. 克隆仓库并安装依赖：

git clone https://gitcode.com/BigDawnGhost/wenyi cd wenyi uv sync uv run wenyi --version

uv sync会自动安装本地 CLI 包 wenyi-cli 与翻译内核 wenyi-core。首次启动时，程序会在当前目录自动创建带注释的默认配置 config.yaml，开始正式翻译前建议花 1 分钟检查其中的模型设置。

第一步：配置 DeepSeek API Key

Wenyi 默认预设deepseek（三档均使用deepseek-flash，见 config.yaml），只需要一个密钥。

# 仅当前 PowerShell 窗口有效 $env:DEEPSEEK_API_KEY = "sk-..." # 永久保存（需重新打开 PowerShell 才生效） setx DEEPSEEK_API_KEY "sk-..."

不发起请求、仅在本地检查凭证与路由：

uv run wenyi models check --for translate

第二步：一条命令翻译第一本书

把book.epub放在当前目录，然后执行：

# 官方包用户 .\wenyi.exe translate .\book.epub # 源码安装用户 uv run wenyi translate book.epub

这一条命令会自动完成：解析书籍 → 识别语言 → 全书预扫 → 分章批量翻译 → 导出成品。默认输出单语中文版output/book.zh.epub，EPUB 输出会尽量保留原书的样式、图片、目录与锚点。

💡 新人建议：先用--chapter 0只翻第一章试水，或换一本小书跑完整流程。

常用参数速查

第三步：查看进度与断点续跑

• uv run wenyi status book.epub— 查看章节状态、累计用量与用时
• 中断后重新执行同一条 translate 命令即可续跑，已完成的批次不会重复调用模型
• 运行状态（章节中间结果、术语 SQLite 库、用量、报告）保存在state/<书名>/targets/<目标语言>/目录，跨多次续跑持续累计

Wenyi 还能做什么？

• 术语管理：glossary list查看术语、glossary conflicts查看冲突译名、glossary resolve指定译名
• 独立审校：wenyi review book.epub --autofix，对完整译文做证据驱动的全书复审
• 换翻译方向：在 config.yaml 中修改language.source/language.target（如zh → en中译英），运行wenyi languages查看内置语言列表
• Web 可视工作台（可选进阶）：通过 Docker 一键部署，实时跟踪翻译进度、用量统计，并对段落进行带修订历史的对照校对，详见 docs/zh/web.md。

翻译完成后，可在工作台逐段对照原文校对，右键即可编辑、查看修订历史或复制文本：

常见问题 FAQ

📖 更多细节请参考官方文档：使用指南、配置说明、翻译流程。祝你翻译愉快！

【免费下载链接】wenyi将被语言阻隔的作品，带到读者的语言中。Bringing literature into your language.项目地址: https://gitcode.com/BigDawnGhost/wenyi