将 PaddleOCR-VL 输出的数学书 Markdown 转换为 ElegantBook TeX。转换阶段保留原始语言；英文 TeX 翻译为中文是独立的可选步骤。
需要 Python、Codex CLI、XeLaTeX，以及：
pip install requests在项目根目录创建 .env：
PADDLEOCR_TOKEN=your-token以下命令均在 tools/math-translator 下执行。
本地文件：
python scripts/ppocr-vl.py "test_resources/book.pdf" \
--output-dir output/book \
--ocr-onlyURL：
python scripts/ppocr-vl.py "https://example.com/book.pdf" \
--output-dir output/book \
--ocr-only主要产物：
output/book/doc_0.md
output/book/doc_1.md
output/book/imgs/
完整流程：确定正文边界、读取目录、按章节分块、转换、审校并组装。
python scripts/ocr_to_tex_agent.py \
--output-dir output/book \
--phase full \
--workers 3中断后直接重复同一命令即可，已有分块会跳过。只有明确需要重做已有产物时才添加 --overwrite。
流程同时支持从原书选页、截断后重新合并的 PDF。目录中有、但正文 OCR
完全缺失的章节会在 chapter_manifest.json 中保留为 null 页界并跳过转换；
后续实际存在的章节仍保留原章节编号。完整且连续的 PDF 沿用原有处理逻辑。
若 Codex 在超时前已经写完有效产物，下次运行会从最近的 run 自动恢复。
主要产物：
output/book/agent-work/page_manifest.json
output/book/agent-work/chapter_manifest.json
output/book/chapters/*.tex
output/book/book.tex
只重新组装根文件：
python scripts/ocr_to_tex_agent.py \
--output-dir output/book \
--phase assemble原始 doc_N.md 不会被修改。
cd output/book
xelatex -interaction=nonstopmode -halt-on-error book.tex
xelatex -interaction=nonstopmode -halt-on-error book.tex产物：
output/book/book.pdf
仓库中的 translator.sh 使用 3 路并发翻译默认 output/ 下的英文分块，并保留原始英文 TeX：
# bash translator.sh
bash translator.sh output/proofs_and_refutations mathematical_philosophy翻译指定的书稿目录时，将目录和数学领域作为参数传入：
bash translator.sh output/proofs_and_refutations mathematical_philosophy脚本会读取该目录下的 book.tex 和 chapters/*.tex，已有的
chapters/*-zh.tex 会自动跳过。
主要产物：
output/chapters/*-zh.tex
output/book-zh.tex
output/book-zh.pdf
translator.sh 中的书名和数学领域是示例配置，处理其他书籍前按实际内容调整。
运行时默认读取 dictionaries/merged.json。它是由 dictionaries/merged.md 转换得到的 JSON key-value 词典；英文开头的行生成新 key，中文或标点开头的换行会接到上一条 value 后面。
如需从新的 OCR 合并稿重建词典：
python scripts/convert_dictionary.py dictionaries/merged.md \
--format merged-md -o dictionaries/merged.json--term-table 仍接受外部 JSON 或 TSV 文件，但仓库不再依赖旧的 english_chinese_math_terms.* 文件。
完整 PDF 位于 test_outputs/：
test_outputs/Abel’s Theorem in Problems and Solutions.pdf
test_outputs/问题与解答中的阿贝尔定理.pdf
test_outputs/与中学生谈谈代数.pdf
