영어 | 中文

Codex, Claude Code, OpenClaw용 에이전트 스킬로, 병렬 서브에이전트를 사용해 전체 책(PDF/DOCX/EPUB)을 어떤 언어로든 번역할 수 있습니다.

claude_translater에서 영감을 받았습니다. 원래 프로젝트는 셸 스크립트를 입문점으로 사용하며, Claude CLI와 여러 단계 스크립트를 조율하여 청크 번역을 수행합니다. 이 프로젝트는 Codex, Claude Code, OpenClaw의 에이전트 스킬로 워크플로우를 재구성하며, 서브에이전트를 사용해 청크를 병렬로 번역하고, manifest 기반 무결성 검사, 재수개 실행 실행, 다중 형식 출력이 하나의 파이프라인으로 통합되었습니다. 프로젝트 구조와 구현이 원래와 크게 다르기 때문에, 이 프로젝트는 포크가 아닌 독립적인 프로젝트입니다.

---

작동 원리

각 청크는 새로운 컨텍스트 윈도우를 가진 독립적인 서브에이전트를 갖게 됩니다. 이로 인해 한 세션에서 전체 책을 번역할 때 발생하는 문맥 누적과 출력 절단을 방지할 수 있습니다.

특징

• 병렬 서브에이전트 — 배치당 8개의 동시 번역기, 각각 고립된 맥락을 가짐
• 재회가능 + 선택적 재번역 — run_state.json 추적 용어집 민감 재번역 포함 청크 수준 요약

Rainman Translate Book

English | 中文

An agent skill for Codex, Claude Code, and OpenClaw that translates entire books (PDF/DOCX/EPUB) into any language using parallel subagents.

Inspired by claude_translater. The original project uses shell scripts as its entry point, coordinating the Claude CLI with multiple step scripts to perform chunked translation. This project restructures the workflow as an agent skill for Codex, Claude Code, and OpenClaw, using subagents to translate chunks in parallel, with manifest-driven integrity checks, resumable runs, and multi-format output unified into a single pipeline. As the project structure and implementation differ significantly from the original, this is an independent project rather than a fork.

---

How It Works

Input (PDF/DOCX/EPUB)
  │
  ▼
Calibre ebook-convert → HTMLZ → HTML → Markdown
  (or Markdown input, e.g. from MinerU / Marker, skipping Calibre)
  │
  ▼
Split into chunks (chunk0001.md, chunk0002.md, ...)
  │  manifest.json tracks chunk hashes
  ▼
Parallel subagents (8 concurrent by default)
  │  each subagent: read 1 chunk → translate → write output_chunk*.md
  │  batched to respect API rate limits
  ▼
Validate (manifest hash check, 1:1 source↔output match)
  │
  ▼
Merge → Pandoc → HTML (with TOC) → Calibre → DOCX / EPUB / PDF

Each chunk gets its own independent subagent with a fresh context window. This prevents context accumulation and output truncation that happen when translating a full book in a single session.

Features

• Parallel subagents — 8 concurrent translators per batch, each with isolated context
• Resumable + selective re-translation — chunk-level resume, with run_state.json tracking glossary-sensitive re-translation
• Neighbor context — each chunk can see short read-only excerpts from adjacent chunks for pronoun and entity resolution
• Manifest validation — SHA-256 hash tracking prevents stale or corrupt outputs from being merged
• Multi-format output — HTML (with floating TOC), DOCX, EPUB, PDF
• Optional output controls — explicit EPUB cover, custom temp root, and user-facing export aliases
• Multi-language — zh, en, ja, ko, fr, de, es (extensible)
• PDF/DOCX/EPUB/Markdown input — Calibre handles the conversion heavy lifting; formula- and table-heavy PDFs can be pre-extracted to Markdown with MinerU or Marker

Prerequisites

• Agent runtime — Codex, Claude Code, or OpenClaw, installed and ready to run skills
• Calibre — ebook-convert command must be available (download)
• Pandoc — for HTML↔Markdown conversion (download)