Английский | 中文

Навык агента для Codex, Claude Code и OpenClaw, который переводит целые книги (PDF/DOCX/EPUB) на любой язык с помощью параллельных подагентов.

Вдохновлён claude_translater. Оригинальный проект использует shell-скрипты в качестве входной точки, координируя Claude CLI с несколькими шаговыми скриптами для выполнения трансляции фрагментов. Этот проект перестраивает рабочий процесс как агентский навык для Codex, Claude Code и OpenClaw, используя субагенты для параллельного перевода чанков, с манифестационными проверками целостности, повторяемыми запусками и мультиформатным выходом, объединёнными в один конвейер. Поскольку структура и реализация проекта значительно отличаются от оригинала, это является независимым проектом, а не форком.

---

Как это работает

Каждый блок получает свой независимый подагент с окном нового контекста. Это предотвращает накопление контекста и усечение вывода, которые происходят при переводе целой книги за одну сессию.

Особенности

• Параллельные субагенты — 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)