开源了一个电子书翻译 skills
- 2026-11-14 23:50:35
我是 Aui 团队的小胖。把本地大模型用起来——电子书翻译介绍了如何用本地模型搭配一个开源库进行翻译。但使用效果不太理想
。于是搞了一个翻译 skill[链接1]。
skill 可以在不同 runtime 中使用，我是在 opencode 中使用的，用 claude code 等 runtime 也没问题。模型用本地模型或者商用 API 都可以。至于翻译效果，朋友说译文比他写的中文还溜 
。
AI 电子书翻译真正麻烦在于翻译风格前后统一。以及如果原书格式有问题，那么翻译后也就有问题，比如目录点了没反应，中英文排版问题等等。还有就是代码块被译成了中文，章节锚点也丢了。我搞的这个 skill 会把 EPUB 拆开，分块交给模型翻译对模型上下文友好，然后逐块校验，最后把翻译后的文件重新打包。
模型只负责翻译，书本构建、风格统一等交给 skill 工作流。
epub-zh-translate 
我的 skill 名字叫 epub-zh-translate。可以翻译的源语言目前支持拉丁字母、以空格分词的语言，英语、法语、德语、西班牙语都可以；日语、韩语、泰语这类无空格语言，以及俄语、阿拉伯语这类非拉丁字母语言还不支持。目标语言固定是简体中文。
至于 skill 是什么不多介绍了，简单说是搭配 AI agent 使用的。其中 SKILL.md 规定了翻译一本书的工作流程，而 epubzh 工具包负责拆书、抽取可翻译段落、切分块、检查译文和重新打包。本 skill 零依赖，装上就可以用。说几个比较实用的设计，不想看的可以直接跳到安装和使用环节：
结构保真： 翻译前把行内标签换成占位符，翻完再换回来； <pre>、code、url等默认不进入翻译队列。目录、锚点、脚注等链接沿用原书。分块翻译。 一本科研、技术书轻松十几万字，整本塞给模型不现实。epubzh 根据参数 large/small按不同词数进行切块 有关这两个参数见后面介绍。每块交给一个 subagent，写完自检并存储，不返回翻译结果，节约上下文。术语可控： 项目里有 terms.tsv，译前会补充术语，译完用 terms-audit回扫。术语首次出现会翻译成 “中文（English）”，例如单词 “container” 首次出现会翻译成“容器（container）”，之后再次出现就只会翻译成“容器”。人名、地名同理。风格一致：整本书前后保持一致是该 skill 的核心目标。实现上不靠模型记忆，而是每个分块都注入同一套上下文：terms.tsv 定术语，style.md 定风格，decisions.md 记录已定译法，再附上一块结尾对齐语气。 guide把它们汇总成 TRANSLATION_GUIDE.md，术语更新后会重跑guide。最后还会用terms-audit和check检查是否走样。自我检查： check会数段落、对占位符、找没翻译的整句、查中英文之间有没有空格；build和verify再检查 XML、内部链接和锚点。不碰源文件：中间产物都在项目目录下，最终 EPUB 输出到指定位置。
怎么装 
要求 Python 3.11 以上。不需要 pip、npm 或其他包。两种安装方式，可任选一种。
git clone
全局安装：git clone https://github.com/iniself/epub-zh-translate.git ~/.config/opencode/skills/epub-zh-translate
项目安装：git clone https://github.com/iniself/epub-zh-translate.git <project>/.opencode/skills/epub-zh-translate
上面只是用 opencode 示例，其他 runtime 换成其自己的目录就好。
skills CLI：
npx skills add iniself/epub-zh-translate -a opencode
如果用其他 runtime，把 -a opencode 换成其他 runtime，比如 -a claude-code，加 -g 装到全局。
怎么用 
opencode 为例，新开一个会话，用 @epub-zh-translate 调用，把书籍信息写清楚如下：
@epub-zh-translate源文件：mybook.epub中文书名：中文书名原书名：Original Title作者：Author输出：mybook-zh.epub分块配置：small几点提示：
源文件、中文书名、输出必填。最佳实践是源文件、输出文件和启动 opencode 的是同一个目录。上面的写法就是针对最佳实践的写法。好处是所有东西包括源书、译本以及翻译过程中产生的项目文件[注释1]都在当前目录下。但也可以放在不同目录，无非就是写上绝对路径。 分块配置有 large和small两种。large 约 2600 词，适合上下文大的模型；small 约 1200 词且最多 40 段，适合小模型。中途改会重新切块，已有译文对不上，所以不要翻到一半再换。
下面这段跟用户关系不大，是 agent 要做的事情。但了解一下会更好：
第一次会先跑 init和extract。extract 会对每个文件做一次回环校验，确认标签和占位符能原样还原，不通过就停下。接着读目录、前言和前两章[注释2]。把术语补进 terms.tsv，生成 TRANSLATION_GUIDE.md。第一章定稿后会写 style.md，后续分块都会带上它[注释3]。 之后就是循环。 next命令会选到下一块并生成提示词，并交给一个 subagent 翻译，check --chunk --fix自检通过后再next下一块。同一章的全部块完成后跑一次整章 check。每章结束还会跑terms-audit看术语是否一致。全部块翻完后执行 build和verify，得到最终的 EPUB。
还有就是在翻译过程中断了，不用重头翻译，翻译进度保存在项目工作目录下。所以只要让 agent 继续翻译就好，例如：
@epub-zh-translate继续翻译已有项目：mybook-zh-project最后，请点赞和转发。有问题直接问我们，Enjoy
往期回顾
把本地大模型用起来——电子书翻译 Docs+ 更新了（用 markdown 进行公众号等内容创作及办公写作） 为什么“好用”的工具，在企业里却难以推广? 把本地大模型用起来——图片生成 把本地大模型用起来——视频生成
文章注释
1. skill 会根据输出文件的名字自动创建项目工作目录，比如这里的输出是 mybook-zh.epub，那么 skill 就会自动创建 `mybook-zh-project` 这个项目文件夹。项目工作文件比如翻译进度、翻译风格、词汇表这些都存在该目录下↩︎2. 不是强制要求 epub 要有目录这些。没有 skill 一样会完成翻译↩︎3. 术语表、风格基准和翻译方法不是在前几章生成就不变了。会在翻译过程中持续补充和更新，目的是让整本书的术语和风格保持一致↩︎
引用链接
[1] skill: https://github.com/iniself/epub-zh-translate
