zimoliao 论文翻译
将论文 Markdown 翻译为目标语言（默认中文），保留 LaTeX 公式、代码块、图片引用和 Markdown 格式。翻译结果保存为论文目录内的 paper_{lang}.md，原文保持不变；如需可携带分享，可额外导出到 workspace/_system/translation-bundles/<Author-Year-Title>/。
当前实现支持：
- 单篇翻译时按
config.translate.concurrency并发请求多个分块，并在终端显示块级进度 - 在论文目录下创建临时工作目录，按块写入
parts/*.md - 网络抖动时对单块做超时重试与指数退避（默认最多 5 次尝试）
- 中途中断后可从临时工作目录继续续翻
--force会清理旧的临时翻译目录并从头重新翻译--portable会额外生成workspace/_system/translation-bundles/<Author-Year-Title>/paper_{lang}.md和对应的images/
配置
config.yaml 中可设置默认行为：
translate:
auto_translate: false # 入库时是否自动翻译（默认关闭）
target_lang: zh # 目标语言（zh/en/ja/ko/de/fr/es）
chunk_size: 4000 # 分块大小（字符数）
concurrency: 20 # 总翻译并发预算（单篇时用于 chunk 并发，批量时会在论文间分摊）
每次调用时可通过 CLI 参数覆盖默认值。
执行逻辑
单篇翻译
scholaraio translate "<paper-id>" [--lang zh] [--force] [--portable]
批量翻译
scholaraio translate --all [--lang zh] [--force] [--portable]
查看翻译
scholaraio show "<paper-id>" --layer 4 --lang zh
作为 pipeline 步骤
scholaraio pipeline --steps toc,l3,translate
注意：
translate默认不在预设（full/ingest/enrich/reindex）中；可通过--steps显式指定。若config.translate.auto_translate=true且 pipeline 包含 inbox 步骤，translate会在 papers 阶段自动注入。
工作流程
- 检测论文原文语言（基于字符集启发式检测）
- 如果已是目标语言，跳过
- 将 Markdown 按段落边界分块（保留代码块和公式完整性）
- 通过 LLM 逐块翻译，保留所有格式标记
- 单篇翻译会并发请求多个分块，但只按原顺序推进最终输出
- 在论文目录下创建临时工作目录（如
.translate_zh/），将每块分别写入parts/*.md - 状态写入
state.json/chunks.json；失败块会记录错误并在下次续翻时单独补跑 - 每个分块带超时重试和指数退避
- 若已有连续成功前缀，则同步刷新
paper_{lang}.md，方便中途查看已完成部分 - 若指定
--portable，则额外复制一份到workspace/_system/translation-bundles/<Author-Year-Title>/，并复制images/以保证脱离原目录后图片仍可用 - 若前面某块失败但后面某些块已成功，这些成功块仍会保留在临时工作目录里；下次续翻时会跳过已成功块，只补失败或未完成的块
- 全部完成后删除临时工作目录，并在
meta.json中记录翻译元数据
进度与续翻
单篇翻译会输出：
- 总块数
- 当前块进度（如
翻译进度: 3/12） - 中断位置
- 是否可续翻
如果中途中断：
scholaraio translate "<paper-id>" --lang zh
会自动检测论文目录下的临时翻译工作目录（如 .translate_zh/），并从未完成或失败的块继续。
如果想忽略已有部分结果并重新开始：
scholaraio translate "<paper-id>" --lang zh --force
会删除旧的临时翻译目录和旧的 paper_zh.md，从头重新翻译。
示例
用户说："把这篇英文论文翻译成中文"
-> 执行 scholaraio translate "<paper-id>" --lang zh
用户说："把所有论文翻译成中文"
-> 执行 scholaraio translate --all --lang zh
用户说："看这篇论文的中文版"
-> 执行 scholaraio show "<paper-id>" --layer 4 --lang zh
用户说："重新翻译这篇论文"
-> 执行 scholaraio translate "<paper-id>" --force
用户说："上次翻译到一半断了，继续翻"
-> 直接执行 scholaraio translate "<paper-id>" --lang zh
用户说："给我一份可以单独发给别人的译文，别丢图"
-> 执行 scholaraio translate "<paper-id>" --lang zh --portable