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 에이전트를 사용하는 모든 사람.