deusyu/translate-book

Rainman Translate Book – AI 支援による本全体の翻訳

機能概要 – PDF、EPUB、DOCX、または Markdown の書籍を任意の言語に翻訳します。パイプライン：

1. 変換 ソースファイルを Markdown に変換（Calibre またはレイアウト対応パーサー経由）。
2. チャンク化 Markdown を約 6 千文字の断片に分割し、各チャンクの SHA-256 マニフェストを記録。
3. 翻訳 8 つの独立した LLM サブエージェント（Codex、Claude Code、OpenClaw）を使用して各チャンクを並列翻訳。各サブエージェントは新しいコンテキストウィンドウと、隣接チャンクからの短い読み取り専用抜粋、および用語の一貫性を保つための主要用語集を受け取ります。
4. 検証 出力をマニフェストと照合し、翻訳されたチャンクを マージ します。
5. 構築 最終成果物 – フローティング目次付き HTML、DOCX、EPUB、PDF – を Pandoc と Calibre 経由で作成。

主な機能

• 並列サブエージェント（デフォルト 8）がコンテキストオーバーフローを回避し、翻訳を高速化。
• チャンクレベルの再開可能な実行；run_state.json により、翻訳済みのチャンクを再翻訳せずに再起動可能。
• 用語集システム：サンプルチャンクから固有名詞/用語を抽出し、glossary.json を編集可能にし、翻訳プロンプトに用語表を注入。
• マニフェストベースの整合性チェック（SHA-256）により、古いまたは破損したチャンクがマージされないことを保証。
• 多様なターゲット言語（中国語、日本語、韓国語、フランス語、ドイツ語、スペイン語など）と複数の出力形式をサポート。
• 数式が多い PDF 向けのオプション前処理（MinerU または Marker を使用）で LaTeX 数式を保持。

使用方法

1. エージェントランタイムにスキルをインストール（npx skills add deusyu/translate-book -a codex または Claude Code/OpenClaw の同等コマンド）。
2. エージェントの CLI またはチャットで、translate /path/to/book.pdf to Chinese のようなコマンドを発行（またはスラッシュコマンド /translate-book … を使用）。
3. スキルは一時作業ディレクトリ（{book}_temp/）を作成し、実行完了後に以下が見つかります：
   • output.md – マージされた翻訳 Markdown
   • book.html、book.docx、book.epub、book.pdf – 最終形式

前提条件 – Calibre（ebook-convert）、Pandoc、Python 3 と pypandoc（オプションで beautifulsoup4）、およびインストール済みの Codex/Claude Code/OpenClaw ランタイム。

プロジェクト構成 – リポジトリにはスキル定義（SKILL.md）と、変換、マニフェスト管理、用語集処理、チャンクコンテキスト、実行計画、マージ、最終ビルドを担当する Python スクリプト群が含まれます。テストアセットは tests/baselines/ 以下に提供されています。

対象者 – 研究者、翻訳者、または LLM エージェントを既に使用しており、用語の一貫性を保ちながら本全体を翻訳する必要がある方。