convez.ai
Skill
THF666

claude-translate-paper

THF666/claude-translate-paper

Ver no GitHub
InicialPluginScore · de 0 a 100

Claude Code Skill: 将学术论文 PDF 一键翻译为中文 Markdown 文档

Instalação

$npx convez-ai THF666/claude-translate-paper

1 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

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

📄 Claude Translate Paper

将学术论文 PDF 一键翻译为高质量中文 Markdown 文档 — Claude Code Skill

License: MIT Platform

✨ 特性

  • 🔬 学术论文专用 — 针对论文格式优化,智能识别章节结构
  • 🌐 多种输入 — 支持本地 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
  1. PDF 解析 — 使用 claude-paper 的 parse-pdf.js 提取元数据和全文
  2. 图表标题提取 — 正则匹配所有 Figure/Table 标题
  3. 智能分节 — Python 脚本自动检测章节边界
  4. 并行翻译 — 根据论文长度自动分组,多 Agent 并行翻译
  5. 合并写入 — 自动生成文档头部,合并所有翻译片段
  6. 清理 — 删除所有中间文件,只保留最终译文

📁 项目结构

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 中的路径。

📄 许可证

MIT License

🙏 致谢

Ver o original no GitHub

Bom para

Relacionados