translate-book

1. 基本信息

项目	内容
名称	translate-book
项目自述名称	Rainman Translate Book（README 标题使用此名，仓库正式名称为 translate-book）
作者/维护者	GitHub 账号 deusyu（自称 Rainman）
来源链接	https://github.com/deusyu/translate-book
许可证	MIT（数据来自仓库 LICENSE 文件）
GitHub Stars	958（数据来自 GitHub API）
Forks	127（数据来自 GitHub API）
最新版本	v1.0.0（Git tag；仓库未发布正式 GitHub Release）
安装方式	`npx skills add` 一键安装，或手动 `git clone` 到对应 Agent 的 skills 目录

2. 功能介绍与亮点

translate-book 是一个把“整本书翻译”做成流水线的 Agent Skill：输入 PDF/DOCX/EPUB，输出 HTML（带目录）、DOCX、EPUB、PDF 四种格式的译文。

核心能力：

分块 + 并行子代理翻译：先用 Calibre 与 Pandoc 把原书转成 Markdown 并切分为多个 chunk，再为每个 chunk 派生一个独立子代理（默认 8 路并发），各自持有干净上下文，避免长文翻译中常见的上下文累积与输出截断
术语表保证一致性：翻译前先抽取人名、地名、专有名词生成 glossary，所有子代理共享同一套译名，避免同一个词在不同章节译得不一样
断点续译与选择性重译：run_state.json 记录每个 chunk 的翻译状态，中断后重新运行会自动跳过已完成部分；用户手动修改术语表后，系统只重译受影响的 chunk，不用整本重来
Manifest 完整性校验：SHA-256 哈希追踪源文件与译文的一一对应关系，防止合并阶段混入过期或损坏的输出
多语言支持：中、英、日、韩、法、德、西语，可扩展

亮点：仓库同时维护中英双语 README 与详细的设计文档（含分阶段实现路线图），近期提交聚焦于修复术语表边界情况与合并校验逻辑，工程严谨度高于同类脚本工具。

3. 适用场景

固定分类：文档与办公自动化

需要把整本 PDF/DOCX/EPUB 电子书或技术文档完整翻译成另一种语言的读者、译者与内容团队
需要保留原书排版结构（目录、章节）、同时要求人名地名译法全书统一的长文本翻译场景
希望在本地机器上跑翻译流水线、不依赖第三方翻译 API 或云端服务的用户

4. 跨 Agent 兼容性

Claude Code：原生支持——README 给出专属安装命令 npx skills add deusyu/translate-book -a claude-code -g，并可手动克隆到 ~/.claude/skills/
Codex：原生支持——README 给出专属安装命令与 Codex CLI 触发方式（$translate-book ...）
OpenClaw：原生支持——SKILL.md 头部元数据中直接声明了 openclaw 专属字段（所需二进制依赖等），并给出 openclaw skills install 命令，属第一方声明的兼容性证据
Hermes Agent：未验证——抓取到的材料中未出现任何与 Hermes Agent 相关的说明

5. 推荐理由

用本地并行子代理把整本书翻译成任意语言，并一次性直出 HTML/DOCX/EPUB/PDF 多种格式文件。

6. 评分

维度	分数	说明
受欢迎程度	6	GitHub 958 stars、127 forks，落在 200–1k 区间；有真实外部贡献者提交并合并多个 PR，但未发现独立来源的规模化活跃讨论
可用性	8	一条命令即可完成技能安装，中英双语文档齐全且含故障排查表，最近一次提交在近日，无付费依赖；但实际运行需要本机另装 Calibre 与 Pandoc 两个系统级工具，非纯粹“复制即用”
安全性	8	见下方安全检查清单

安全检查清单：

shell 命令及权限范围：仅通过本地 Python 脚本调用 Calibre（ebook-convert）与 Pandoc 做格式转换与合并，用途单一且在文档中逐步说明，未发现越权操作
联网外发数据：逐份检查全部脚本源码，未发现任何 HTTP/网络请求调用；书籍内容的翻译由调用该技能的 Agent 自身完成，流水线本身不额外联网
API Key/凭据存储：翻译过程不需要任何 API Key 或凭据
可疑指令：SKILL.md 与全部脚本均未发现提示注入、混淆代码或隐蔽外发迹象
作者/组织信誉：个人开发者维护，仓库持续更新超过 4 个月，有外部贡献者提交并被合并的多个 PR，未见刷星或 SEO 操纵措辞
License：MIT，明确
最近维护时间：最近一次提交发生在近日，维护活跃

7. 跟同类 Skills 相比的优势

竞品	定位	与 translate-book 的差异
docx-template-translator-skill	把 LaTeX / PDF / Markdown 翻译并写入指定 Word 模板格式	只输出单一 Word 模板格式，不做整书分块并行翻译、术语表一致性与断点续译；适合已有固定模板的场景
claude-office-skills	覆盖 PPTX/DOCX/XLSX/PDF 的通用办公文档创建与编辑技能集	定位是通用办公文档生产工具，不专门处理“整书翻译”这一场景，也没有针对长文本的分块并发与术语一致性设计

8. 用户评价

该技能目前在第三方平台尚无经过核实的具名用户评价。GitHub Issues 区可见真实用户报告的具体问题（如 SKILL.md 引用图片缺失），显示有真实用户在实际使用该技能。

9. 其他补充

仓库自带中英双语文档（README.md / README.zh-CN.md），并公开了分阶段实现路线图与设计原则说明（如“脚本负责确定性记账、LLM 负责语义判断”的分工原则），工程文档的透明度高于多数同类项目。

10. 安装使用方式

# Claude Code
npx skills add deusyu/translate-book -a claude-code -g
# 或手动安装：
mkdir -p ~/.claude/skills
git clone https://github.com/deusyu/translate-book.git ~/.claude/skills/translate-book

# Codex
npx skills add deusyu/translate-book -a codex -g

# OpenClaw
openclaw skills install @deusyu/translate-book

安装前需在本机准备好 Calibre（提供 ebook-convert 命令）与 Pandoc，并安装 Python 依赖 pypandoc（可选 beautifulsoup4 以提升目录生成质量）。安装完成后无需重启 Agent，直接用自然语言下达任务即可触发，例如：

translate /path/to/book.pdf to Chinese

Claude Code 用户也可用斜杠命令 /translate-book translate /path/to/book.epub to Japanese。

11. 注意事项

必须本机安装 Calibre 与 Pandoc 两个外部工具，纯“技能文件”本身无法独立完成转换，环境准备成本高于纯提示词类技能
翻译质量与一致性依赖调用该技能的底层 Agent 模型本身，技能只负责分块、调度与合并，不提供独立的翻译引擎
仓库以个人 GitHub 账号形式维护，未设立正式版本发布（Release），长期治理结构尚待观察
该技能目前主要验证过 Claude Code / Codex / OpenClaw 三个生态，Hermes Agent 下的可用性尚无法确认