企业官网建设流程全解析

Wenyi模型配置快速上手：deepseek预设一键搞定，无需手写配置文件

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

Wenyi 是一款面向书籍和长文创作的大模型翻译工具，支持全书理解、术语表管理与审校流程。本文带你完成Wenyi 模型配置：只需一个deepseek预设，无需手写复杂的配置文件，三步就能跑通整本书的翻译。

为什么 Wenyi 值得试试？

Wenyi 把"整本书"当作一个翻译单元：先全书预扫描生成章节梗概和概要，再分批翻译，最后做证据驱动的审校。译文可以导出为 EPUB、TXT、HTML 等格式，还能生成原文+译文对照的双语版。

Wenyi 双语版效果：译文在前，原文以淡化样式跟随，方便校对。

模型配置有多简单？

很多人看到"LLM 配置"就头大：要写提供商、模型 ID、端点地址、并发限额……而 Wenyi 的默认预设直接把这些都做好了。

查看项目自带的 config.yaml，你会发现模型部分只有两行有效内容：

llm: preset: deepseek

就这一行preset: deepseek，Wenyi 会自动展开为一套完整的模型路由：连接默认使用https://api.deepseek.com，API Key 从环境变量DEEPSEEK_API_KEY读取，三个档位（strong / cheap / fast）都使用deepseek-flash模型并开启思考模式。预设的实现代码见 deepseek.py，预设展开逻辑见 configuration.py。

💡 除了 deepseek，也内置了preset: gemini和离线可用的preset: fake，完整说明见 配置文档。

三步完成 Wenyi 模型配置

第一步：安装 Wenyi

前置要求：Python 3.10+ 和 uv 包管理器。

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

第二步：设置 DeepSeek API Key

API Key 只通过环境变量读取，不会写进配置文件：

export DEEPSEEK_API_KEY=sk-...

第三步：一键验证配置并开翻

Wenyi 提供wenyi models子命令，不用联网、不用发请求，就能检查当前配置是否可用：

uv run wenyi models list # 查看每个流程步骤实际使用的模型 uv run wenyi models check --for translate

确认无误后，一条命令启动整本书翻译：

uv run wenyi translate book.epub

支持 EPUB、FB2、TXT、Markdown、HTML、PDF、DOCX 等输入，默认输出output/book.zh.epub。运行中可以随时Ctrl+C中断，之后执行同一命令即可续跑，已完成的批次不会重翻。

翻译过程长什么样？

Wenyi 自带 Web 工作台，可以实时查看每一步的 token 用量、缓存命中率和运行时长：

Web 工作台的翻译总览页面，翻译进度一目了然。

想微调模型？再往下配置

90% 的用户用默认预设就够了。如果你有多个提供商（比如想用 Gemini 做润色），才需要补充providers/models/routes来覆盖单个操作步骤的模型，例如让polish.body（润色）和review.verify（取证核查）单独使用某个模型。完整规则、支持的操作路由表和限额设置都写在 配置说明 里，建议按需阅读，不必提前配置。

常见问题

问：配置写错了会怎样？配置校验在发起请求前完成，未知配置项、不存在的模型引用都会直接报错提示，不会带着错误配置跑起来。

问：不填 API Key 能运行吗？wenyi models list和explain不需要密钥；只有真正发起翻译才需要。离线练习可用preset: fake走一遍完整流程。

问：能换目标语言吗？在 config.yaml 里改language.target（如en、ja、ko），运行uv run wenyi languages查看完整语言列表，无需密钥。

小结

• Wenyi 的模型配置以llm.preset: deepseek为核心，一行搞定，无需手写配置文件
• API Key 通过DEEPSEEK_API_KEY环境变量注入，安全不落盘
• 用uv run wenyi models list可随时核对每个翻译步骤实际使用的模型
• 想精细控制某个环节的模型，再按 配置文档 补充路由即可

装好 uv、配好一个 Key，一杯茶的功夫就能看到你书的第一章译文。

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