
基于我自己的LaTeX模板整理的AI Agent论文翻译工作流。让英文论文更好读!
基于我自己的LaTeX模板整理的AI Agent论文翻译工作流。让英文论文更好读!
·
一个面向 AI Agent 的学术论文全文精译 Skill:忠实保留科学内容,以矢量为先处理图表,并生成优雅、可编辑、可点击引用的中文 LaTeX PDF。
English · 简体中文 · Agent 使用说明 · 参与贡献
来自 CCC(NSDI 2026)论文中文译排的真实页面节选,仅供展示;原文出处与版权说明
论文里的信息不只在段落里。公式、符号、坐标轴、算法、实验数据、引用与限定语,都是科学内容的一部分。
paper-translation 把一套可靠的学术论文精译方法变成 Agent 能执行的工作流:全文翻译 + 原生 PDF 图像提取 + 矢量图保留 + LaTeX 重排 + 可点击参考文献 + 全流程质量检查。
这不是一个“运行脚本就会自动翻译”的 API。 Python 脚本负责提取、构建和验证;真正的阅读、翻译、技术核对和排版修正由使用这个 Skill 的 AI Agent 完成。项目不包含模型 API Key,也不依赖某个特定的付费模型。
| 能力 | 具体做法 |
|---|---|
| 🧭 防止漏译 | 通过章节标题 + 矢量裁图几何信息自动生成覆盖率候选映射;必须逐节核对,不能假装自动完成翻译。 |
| ⚡ 少花冤枉 Token | 按章节生成精简上下文包,重复页和冗长编译日志不再灌入模型;原文块 ID 和完整 QA 保留。 |
| 🧪 技术语义优先 | 保留作者措辞的确定性程度、因果方向、数值、单位、百分位数、公式与实验结论。 |
| ✒️ 真正的译排 | 输出可搜索、可复制的中文正文与 LaTeX 数学公式,而不是整页截图。 |
| 🧬 矢量图优先 | 照片提取原始图像对象;统计图与架构图按 PDF 矢量区域直接裁取,完整保留轴线、图例和标注。 |
| 🧩 算法不乱改 | 默认原样保留 Algorithm 伪代码和源代码,正文另译解释。 |
| 🔗 引用可跳转 | 原生 \cite/\bibitem,或保留参考文献原始 PDF 页并恢复 GoTo 跳转。 |
| 🪄 耐读的排版风格 | 自带无个人信息的 XeLaTeX 模板:Latin Modern Roman、舒展行距、克制色彩与中西文字体搭配。 |
| ✅ 真的会失败的 QA | 递归扫描多文件、引文/标签检查、原文覆盖率、编译日志、PDF 跳转与页面渲染验证。 |
| 公式 | 原文算法 | 实验表格 |
|---|---|---|
![]() | ![]() | ![]() |
README 使用的图片是渲染后的页面截图;正式译文内部能够保留矢量图的地方仍使用矢量 PDF,而不是这几张截图。
flowchart LR
A[原始 PDF] --> B[逐页渲染与内容清点]
B --> C[全文精译与覆盖台账]
C --> D[图像原生提取 / PDF 矢量裁图]
D --> E[XeLaTeX 语义化重排]
E --> F{参考文献模式}
F -->|原生| G[LaTeX 引文与交叉引用]
F -->|保留 PDF 页| H[严格恢复 GoTo 跳转]
G --> I[自动 QA + 视觉复核]
H --> I
I --> J[中文 PDF + 可重编译源码]具体执行包括:
\label、\ref、\eqref;伪代码默认英文原样。完整的 Agent 操作说明在 SKILL.md,细则在 references/。
完整译文的输出 Token 是必要成本,不应该靠删正文、跳附录或自动放行覆盖率来省。真正的优化是让 Agent 每次只处理一节的原文,并将 PDF 提取数据、几百行 coverage ledger、XeLaTeX 全量日志保存在本地文件里。
# 已按实际论文修改 assets/coverage-map.json 后
make seed-coverage # 为所有源文本块生成候选映射(全为 todo)
make packets # 在 work/context-packets/ 生成分章节阅读包
# Agent 只读 index.md 和当前章节对应的 .md,以及必要的原 PDF 渲染页
make # 编译成功只显示摘要,完整日志在 work/latexmk-console.log
make release # 最终仍必须完整覆盖、跳转检查和视觉复核较长的工程可用 prepare_section_packets.py --pending-only --target sections/01-introduction.tex 续做未核对的部分。不要整表重读 work/source-blocks.tsv(真实双栏论文常超过 90 KB):回查某一页或某一块用 python3 scripts/blocks.py query work/source-blocks.tsv --page 7 --grep 'Figure 4',需要全局视图时读 blocks.py index 生成的紧凑索引。工具绝不自动确认 coverage;遇到提取失败的数学符号仍要对照原始 PDF 页面。具体策略见 Token 优化指南。API 的前缀缓存、模型分级由实际调用平台决定,仓库不承诺未经实测的节省比例。
PyMuPDF 与 Pillowlatexmk 和较完整的 TeX Live 环境(包括 xeCJK、unicode-math、scrartcl、siunitx、pdfpages 等)git clone https://github.com/Micraow/paper-translation-skill.git
cd paper-translation-skill
python3 -m pip install -r requirements.txt
python3 scripts/init_project.py ../my-paper
cp /path/to/original-paper.pdf ../my-paper/sources/original.pdf
cd ../my-paper让 Agent 阅读仓库里的 SKILL.md,并给它一段这样的任务:
使用 paper-translation Skill 全文精译这篇论文,用自带的 XeLaTeX 模板输出中文 PDF。公式、编号、矢量图、数据表、文献与附录全部保留;算法伪代码不翻译;正文引用和图表公式交叉引用必须可点击。交付 PDF 与完整源码工程,并完成全文覆盖核验与逐页视觉检查。
make # 默认 native 参考文献模式,可直接编译演示
make render # work/final-render/contact-sheet.pngcp assets/coverage-map.example.json assets/coverage-map.json
# 根据源 PDF 渲染页面修改全部章节正则、对应 .tex 文件和双栏分界坐标
make seed-coverage # 每个源标题必须恰好匹配一次;自动建议路径,但状态全部为 todo
# 逐节对照原 PDF 与译文后,再确认已复核的章节:
python scripts/confirm_coverage.py work/coverage.tsv --status translated \
--target sections/01-introduction.tex \
--review-note '已逐段核对原文第 2-3 页、双栏交界和译文的完整对应关系'具体用法见 大规模覆盖台账指南。这是辅助核对,而不是自动宣称译文完整。模板还内置微秒单位安全宏 \us、独立算法编号、中文强调宏 \zhstrong,对无效 CJK 斜体与缺少字形进行门禁检查。
注意:初始模板的引言、公式及参考文献都是明确标记的演示内容,不会凭空翻译 sources/original.pdf。Agent 需要按原论文完整替换后,才算真正产出译文。
把原论文全部参考文献准确放进 sections/references.tex(或配置正确的 .bib),正文用 \cite{key},章节/公式/图表用 \label 与 \ref/\eqref。
make生成 PDF 时会产生内部跳转;多文件检查器会递归检查所有 \input 章节及引文键。
在 main.tex 中设置原始文献页范围 \OriginalReferencePages;正文保留忠实的数字引文 [n],然后执行:
make BIB_MODE=pdf
# 如果自动定位文献起始页不可靠,显式指定“译文最终 PDF”的页码:
make BIB_MODE=pdf REF_START_PAGE=35 REF_END_PAGE=38处理器会建立可点击的 GoTo 注释;缺少目标编号或缺少链接时直接失败。不要和原生 \cite 混用。
make # 编译 + 递归 LaTeX 检查 + 日志审计 + PDF 引用检查
make release # 在上面基础上核对源文本覆盖台账,渲染全部页面正式运行 make release 前,请先用 make seed-coverage 生成 work/source-blocks.tsv 与带建议字段的 work/coverage.tsv,再逐段复核并确认实际对应关系。任何漏项、未完成 TODO、失效链接、无效引文等都会阻止通过。
自动检查不等于翻译准确。 Agent 还必须查看源文与译文的对应关系,核对多栏交界处的句子、复杂公式,逐一检查图表裁切是否完整,并打开最终 PDF 抽查链接跳转。
paper-translation-skill/
├── SKILL.md # 供 Agent 阅读的核心规范
├── README.md # 中文项目主页
├── README.en-US.md # English documentation
├── LICENSE # MIT
├── THIRD_PARTY_NOTICES.md # 原论文/截图/字体/依赖版权说明
├── agents/openai.yaml
├── requirements.txt
├── scripts/ # PDF 提取、矢量裁切、引用恢复、区块查询、检查脚本
├── assets/latex-template/ # 无个人信息的 XeLaTeX 模板、Makefile
├── references/ # 深度说明(每份只讲一次)
│ ├── TRANSLATION.md # 保真度层级、情态、术语、数值单位、引用、源文错误
│ ├── FIGURES_AND_ALGORITHMS.md # 图形决策表、裁剪取材与常见缺陷
│ ├── QA_CHECKLIST.md # 交付核对表(含需视觉能力的目检清单)
│ ├── PITFALLS.md # 跨阶段编译/排版陷阱
│ ├── COVERAGE_LEDGER.md # 大规模覆盖台账与回查
│ ├── REFERENCES_AND_LINKS.md # 两种参考文献后端
│ ├── LATEX_CROSSREFERENCES.md # 语义交叉引用写法与各检查的盲区
│ └── TOKEN_EFFICIENCY.md # 上下文预算
├── tests/ # 合成 PDF 的单元与回归测试
└── docs/images/ # GitHub 展示图,不作为论文中的图项目的原创脚本、说明及通用 LaTeX 模板采用 MIT License。但这不意味着用户翻译的论文、原始图表、README 中含原论文片段的预览图、专有字体或第三方库都自动变成 MIT;详见 THIRD_PARTY_NOTICES.md。尤其在公开分发全文译文前,应确认原论文的版权与改编、分发许可。
欢迎提交 Bug、补充合规的最小复现用例、修正文献链接/图表裁切的边缘情况,以及优化 LaTeX 审美。贡献方式见 CONTRIBUTING.md。如果觉得有用,欢迎给仓库点一个 ⭐。
忠于论文,也让论文更好读。
This repo does not document an install step we could read. Check the README on GitHub.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/paper-translation-skill to learn what the "Paper Translation Skill" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
This server doesn't publish a machine-readable tool manifest, and it doesn't expose a public endpoint we could ask. Connect the server locally to see what it exposes.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/paper-translation-skill)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "paper-translation-skill" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.