paper-jiedu-latex

把一篇论文做成诚实、量化、带原文关键图的 LaTeX 中文解读 PDF。

A Claude Code skill + a frozen LaTeX template that turns a research paper into an honest, quantified Chinese interpretation PDF — with the paper's own key figures embedded next to the claims they support.

这是什么

日常读论文有一个反复出现的需求:把一篇值得认真读的论文,消化成一份可打印、可分享、别人拿到手能直接看懂的中文解读。市面上常见的"论文解读"有两个通病:

翻译摘要冒充解读——把作者自称的贡献原样复述一遍,没有任何独立判断;
文字孤岛——通篇没有原文的图,读者看不到论文真正的数据长什么样。

这个仓库把我们打磨出来的工作流固化成一个 Claude Code skill:MinerU 解析全文 → 深读 → 按固定模板写解读 → xelatex 出 PDF,并用六条硬规则保证产出质量。四篇跨领域的完整例子(爆震力学、机器学习、LLM+CAD、传热工程)连同 LaTeX 源码一起放在 examples/。

六条硬规则

这套流程的价值不在模板,在纪律:

#	规则	为什么
1	原文关键图必须嵌入,放在对应结论旁边	解读不带原文图 = 让读者盲信文字转述
2	自画示意图只能补充,不能替代原文图	示意图给导览,替代不了真实数据
3	每条结论区分"论文声称" vs "我验证过"	不把作者的自我评价当事实
4	诚实标边界:假设删了什么、样本多小、有没有正对照	这是"我的评价"一节存在的意义
5	中文写作纪律:量化在前、无 AI 味、全角标点	让它读起来像人写的
6	核心公式逐步展开讲,不许一句话带过	判据:非本子领域的聪明读者能顺着读懂

例子(完整源码 + 成品 PDF)

四篇解读覆盖四个很不一样的领域,演示同一个模板怎么适配不同类型的论文:

例子	原论文	领域	演示的范式
`oblique-detonation/`	Liu, Convective flux analysis on the propagation mechanism of oblique detonation waves, Aerosp. Sci. Technol. 173 (2026)	爆震力学 / CFD	图多:5 组原文云图 + 1 张自画 TikZ 几何导览 + 2×2 图块
`mmpd-diffusion-loss/`	Zhang et al., MMPD: Diverse Time Series Forecasting via Multi-Mode Patch Diffusion Loss, ICLR 2026	机器学习 / 时序预测	公式多:MSE=MLE 推导、扩散锚点技巧分步走,keybox 圈全文支点
`futurecad-brep-grounding/`	Li et al., Towards High-Fidelity CAD Generation via LLM-Driven Program Generation and Text-Based B-Rep Primitive Grounding, arXiv:2603.11831	LLM + CAD	含失败案例:作者的 failure cases 放进"要打折扣"一节
`v-winglet-heat-transfer/`	Promvonge et al., Experimental and numerical heat transfer study of turbulent tube flow through discrete V-winglets, Int. J. Heat Mass Transf. 151 (2020)	传热工程 / 实验+RANS	工程论文:评价因子(TEF)口径核对、实验-数值互证边界

每个例子目录里是一套完整的构建:jiedu.tex(解读源码)+ figs/(挑好的原文图)+ jiedu.pdf(成品)+ preview.png(首页预览)。四篇都可以直接 xelatex jiedu.tex 复现编译(本仓库上传前逐篇验证过)。

解读的固定结构

定位 keybox   论文 / 单位 / 时间线 / 一句话讲清它干了什么
§1  这篇在解决什么问题     背景 + 它针对的具体缺口,量化在前
§2  方法内核              全文最值得读的机制/公式,分步展开
§3  数值/实验设置          工况、格式、网格、参数范围,一个 keybox 收进去
§4  主要结果              每个关键结果配一张原文图(硬规则)
§5  验证与可信度           校验对照、收敛性、误差口径
§6  我的评价              站得住的地方 / 要打折扣的地方 / 一句总评
尾部 keybox   放在领域里看:作者线、适用边界、可作什么参考

用法

作为 Claude Code skill

# 放进用户级 skill 目录(或项目的 .claude/skills/)
git clone https://github.com/tianhanz/paper-jiedu-latex ~/.claude/skills/paper-jiedu-latex

然后在 Claude Code 里说"把这篇论文做成解读 PDF"即可,流程见 SKILL.md。

仓库同时带 .claude/skills/paper-jiedu-latex/ 镜像目录,供 Playground for Agentic Science(#tools 页)按 skill bundle 协议抓取安装。

手动使用模板

用 MinerU 解析论文 PDF,得到 paper.md + images/;
scripts/map_figures.py <auto_dir> 列出所有图和 caption,挑 3–6 张关键图复制成短名;
复制 assets/template.tex,照 examples/ 里最接近的范式填内容;
xelatex jiedu.tex(跑两遍),pdftoppm -png 逐页渲染自检。

依赖

TeX Live(含 ctex + fandol 字体,主流发行版自带,无需装商业字体)
MinerU(PDF → markdown + 图片抽取)
poppler-utils(pdftoppm,自检和裁图用)
Python 3(map_figures.py;裁多面板图时用到 Pillow)

关于原文图的版权

例子中嵌入的图片来自各原论文,版权归原作者/出版社。此处用于个人学习性质的评论与解读(每图均以"原文 Fig. N"标注出处,并附完整文献引用),属合理使用范畴。若权利方有异议,请提 issue,我们会移除对应内容。

License

模板、脚本与解读文字部分:MIT。例子中的原文图片不在 MIT 授权范围内(见上节)。

Paper Jiedu Latex

At a glance

README