Babeldoc Trans

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。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: kaixindelele
• Source: kaixindelele/wechatagentbridge_skills
• License: MIT

Install and usage instructions live in the source repository linked above.