kaixindelele BabelDOC 论文翻译
基于 BabelDOC 的论文 PDF 翻译封装。智能版式分析 + 公式保护 + 术语自动提取，输出自动以中文标题命名。
触发条件
- 用户发送 arxiv 链接（
https://arxiv.org/abs/xxxx.xxxxx或https://arxiv.org/pdf/xxxx.xxxxx） - 用户发送 arxiv ID（如
2412.13211） - 用户上传或指定 PDF 文件路径
- 用户说"翻译这篇论文"、"translate this paper"等
工作流程
步骤 1：获取 SKILL 路径
确定本 skill 的安装路径（即包含此 SKILL.md 的目录），用于定位 scripts/translate.py。
步骤 2：执行翻译
python {SKILL_DIR}/scripts/translate.py "<输入>" --output-dir /tmp/babeldoc_output
输入可以是：
- arxiv URL：
https://arxiv.org/abs/2412.13211 - arxiv PDF URL：
https://arxiv.org/pdf/2412.13211 - arxiv ID：
2412.13211 - 本地 PDF 路径：
/path/to/paper.pdf
步骤 3：返回结果
脚本最后会打印 [DONE] {JSON}，包含：
title_en/title_zh— 英文/中文标题output_pdf— 最终 PDF 绝对路径（已以中文标题命名）size_kb— 文件大小
将翻译后的 PDF 文件发送给用户。
常用参数
| 参数 | 说明 | 默认值 |
|---|---|---|
--output-dir |
PDF 输出目录 | /tmp/babeldoc_output |
--pages |
只翻译指定页，如 1-5 |
全部 |
--qps |
翻译并发 QPS | 8 |
--dual |
额外输出双语对照 PDF | off |
--model |
OpenAI 模型 | gpt-4o-mini |
--api-base |
API base URL | https://api.bltcy.ai/v1 |
--api-key |
API key | 读取 $BABELDOC_API_KEY |
环境变量
| 变量 | 说明 | 必须 |
|---|---|---|
BABELDOC_API_KEY |
OpenAI 兼容 API key | 是 |
BABELDOC_API_BASE |
API base URL | 否（默认 https://api.bltcy.ai/v1） |
BABELDOC_MODEL |
模型名 | 否（默认 gpt-4o-mini） |
安装依赖
首次使用前运行：
bash {SKILL_DIR}/scripts/setup.sh
详细文档
更多参数说明、性能参考和常见问题排查，请查阅 references/usage_guide.md。