claude-translate-paper
THF666/claude-translate-paper
Claude Code Skill: 将学术论文 PDF 一键翻译为中文 Markdown 文档
Instalação
npx convez-ai THF666/claude-translate-paper1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
📄 Claude Translate Paper
将学术论文 PDF 一键翻译为高质量中文 Markdown 文档 — Claude Code Skill
✨ 特性
- 🔬 学术论文专用 — 针对论文格式优化,智能识别章节结构
- 🌐 多种输入 — 支持本地 PDF、PDF URL、arXiv 链接
- ⚡ 并行翻译 — 自动分节,多个 Agent 并行翻译,速度快
- 📊 图表完整 — 自动提取并翻译所有 Figure/Table 标题
- 🧮 公式保留 — 数学公式、引用编号原样保留
- 🧹 自动清理 — 翻译完成后自动删除中间文件
📋 前置依赖
| 依赖 | 版本要求 | 说明 |
|---|---|---|
| Claude Code | 最新版 | 安装指南 |
| claude-paper 插件 | ≥1.1.0 | 提供 PDF 解析能力 |
| Node.js | ≥18 | 运行 PDF 解析脚本 |
| Python | ≥3.8 | 运行分节脚本 |
| PyMuPDF | 最新版 | 图片提取(可选) |
安装 claude-paper 插件
在 Claude Code 中运行:
/install-plugin claude-paper
安装 PyMuPDF(可选,用于图片提取)
pip install pymupdf
🚀 安装
方式一:一键安装(推荐)
macOS / Linux:
git clone https://github.com/YOUR_USERNAME/claude-translate-paper.git
cd claude-translate-paper
bash install.sh
Windows (PowerShell):
git clone https://github.com/YOUR_USERNAME/claude-translate-paper.git
cd claude-translate-paper
powershell -ExecutionPolicy Bypass -File install.ps1
方式二:手动安装
# 1. Clone 仓库
git clone https://github.com/YOUR_USERNAME/claude-translate-paper.git
cd claude-translate-paper
# 2. 创建 skill 目录
mkdir -p ~/.claude/skills/translate-paper
# 3. 复制分节脚本
cp split_sections.py ~/.claude/skills/translate-paper/
# 4. 复制 skill.md 并替换路径占位符
# 将 skill.md 中的 {{CLAUDE_PAPER_BASE}} 替换为你的 claude-paper 插件路径
# 将 {{SKILL_BASE}} 替换为 ~/.claude/skills/translate-paper
sed \
-e "s|{{CLAUDE_PAPER_BASE}}|$HOME/.claude/plugins/cache/claude-paper/claude-paper/VERSION|g" \
-e "s|{{SKILL_BASE}}|$HOME/.claude/skills/translate-paper|g" \
skill.md > ~/.claude/skills/translate-paper/skill.md
验证安装
安装完成后,重启 Claude Code,输入:
/translate-paper
如果看到翻译提示,说明安装成功!🎉
📖 使用方法
1. 启动翻译
在 Claude Code 中输入 /translate-paper,然后提供论文:
/translate-paper
> ~/Downloads/attention-is-all-you-need.pdf
或直接提供链接:
/translate-paper
> https://arxiv.org/abs/1706.03762
2. 支持的输入格式
| 输入类型 | 示例 |
|---|---|
| 本地 PDF | ~/Downloads/paper.pdf |
| PDF 直链 | https://arxiv.org/pdf/1706.03762.pdf |
| arXiv 页面 | https://arxiv.org/abs/1706.03762 |
3. 输出
翻译完成后,会在 PDF 同目录下生成 论文标题_中文译文.md。
🗑️ 卸载
macOS / Linux:
bash uninstall.sh
Windows (PowerShell):
powershell -ExecutionPolicy Bypass -File uninstall.ps1
或手动删除:
rm -rf ~/.claude/skills/translate-paper
🔧 工作原理
PDF 输入 → 下载(如URL) → 解析PDF → 提取图表标题 → 自动分节
→ 并行Agent翻译 → 合并写入 → 清理中间文件 → 中文译文.md
- PDF 解析 — 使用 claude-paper 的
parse-pdf.js提取元数据和全文 - 图表标题提取 — 正则匹配所有 Figure/Table 标题
- 智能分节 — Python 脚本自动检测章节边界
- 并行翻译 — 根据论文长度自动分组,多 Agent 并行翻译
- 合并写入 — 自动生成文档头部,合并所有翻译片段
- 清理 — 删除所有中间文件,只保留最终译文
📁 项目结构
claude-translate-paper/
├── skill.md # Skill 定义文件(含路径占位符)
├── split_sections.py # PDF 自动分节脚本
├── install.sh # macOS/Linux 安装脚本
├── install.ps1 # Windows 安装脚本
├── uninstall.sh # macOS/Linux 卸载脚本
├── uninstall.ps1 # Windows 卸载脚本
├── README.md # 本文件
└── LICENSE # MIT 许可证
⚠️ 常见问题
安装脚本报 "未找到 claude-paper 插件"
确保已安装 claude-paper 插件:
/install-plugin claude-paper
翻译时图表标题遗漏
skill 会自动提取并翻译所有 Figure/Table 标题。如果仍有遗漏,可以在对话中提醒 Claude 补全。
长论文翻译不完整
对于超长论文(>50K 字符),系统会自动分 3-5 组并行翻译。如果某部分缺失,可以要求 Claude 补全特定章节。
Windows 路径问题
安装脚本会自动处理 Windows 路径格式(反斜杠转正斜杠)。如果仍有问题,请手动编辑 ~/.claude/skills/translate-paper/skill.md 中的路径。
📄 许可证
🙏 致谢
- claude-paper — 提供 PDF 解析基础设施
- pdf-parse — Node.js PDF 文本提取
- PyMuPDF — PDF 图片提取