paper-jiedu-latex

name	paper-jiedu-latex
description	把一篇论文做成 LaTeX 中文解读 PDF。本地 PDF / arXiv 取原文 → MinerU 全文解析 → 深读 → 填固化 LaTeX 模板(ctexart+fandol，含 keybox / 图块宏 / 我的评价结构)→ xelatex 出 PDF。硬规则:原文关键图必须嵌入，自画示意图只能补充不能替代。当用户要把某篇论文 / PDF 做成"解读 PDF / 论文解读 / LaTeX 解读"，或要一份可打印分享的论文导读 PDF 时用。

paper-jiedu-latex

一句话:MinerU 把论文变成结构化材料 → 亲自写一份诚实、量化、带原文关键图的中文解读 → 固化 LaTeX 模板出 PDF。 目标是看得懂且信得过——不是翻译摘要，不是把作者自称的贡献当事实。

硬规则(顶格，不可跳)

1. 原文关键图必须有。挑 3--6 张最能支撑结论的原文图(contour / 结构 / 机制云图)嵌进去，放在对应结论旁边，中文 caption 以"原文 Fig.,N："开头。个人解读属合理使用，标注来源即可，不能因版权顾虑省略。
2. 自画示意图(TikZ)是加分项，不能替代原文图。它给几何/框架导览，替代不了论文的真实数据图。可留作导览，紧跟其后放原文图。
3. 一手纪律:每条关键结论区分"论文声称"vs"我验证过"；没查证的说没查证，不凭训练记忆补。
4. 诚实标边界:模型假设删了什么(如无粘=删边界层)、样本量多小、否定性结论有没有正对照、是否作者自证体系——都写进"我的评价"。
5. 中文写作纪律:量化在前(先给数字再给形容词)；不写 AI 味套话(避免"值得注意的是""总的来说"这类填充语)；中文语境标点用全角；数字与英文之间不留空格。
6. 复杂公式和关键思路要展开逐步讲解。核心公式不能抄进来一句话带过——要拆每个符号的含义、走一遍推导(哪步用了什么、哪一项因为不含参数被扔掉)、并点破"这一步的直觉/为什么这么写"。判据:一个非该子领域的聪明读者能不能顺着读懂。做法:关键推导用 equation 环境显式分步列出，配一句"关键就在这一步"点破洞见，必要时用 keybox 圈出"全文支点"。方法/机制章节(§2 方法内核)是重灾区，别只搬摘要级别的一句话。

步骤

1. 取原文 PDF:本地文件 / arXiv 下载 / 出版社官网。
2. 全文解析:用 MinerU 解析 PDF → 输出目录(内含 paper.md / *_content_list.json / images/)。已解析过就别重跑。
3. 深读:读完 paper.md，逐节抓"解决什么问题 / 方法内核 / 主要结果 / 验证 / 局限"，论文声称 vs 我判断分开。
4. 挑图 + 映射:scripts/map_figures.py <auto_dir> 列出 图→8位hash→caption；照 caption 挑 3--6 张；map_figures.py <auto_dir> --copy figs 1c0f74b0 fig1a ... 复制到 figs/ 短名。
   • 多面板图被 MinerU 拆碎时,从 PDF 页面整张裁:别硬拼 fragment。pdftoppm -png -r 200 -f <页> -l <页> paper.pdf p 渲染该页 → 读 PNG 定位图的像素框(注意显示分辨率×缩放系数换算回原图)→ PIL Image.crop((l,t,r,b)) 裁出整张存进 figs/。得到的是作者原始排版的完整图,比拼 fragment 干净。
   • 别只放"结果好"的图:作者给了失败案例图(failure cases)就挑进来,放进"我的评价·要打折扣"那节,诚实度和说服力都更高。
5. 写解读:复制 assets/template.tex 到工作目录，填内容；用 \onefig / \twofig / \figrow 宏把原文图放到对应结论旁(用法见模板注释 + examples/)。结构见下。
6. 编译 + 自检:xelatex 跑两遍(fancyhdr 需要)；pdftoppm -png 逐页渲染，逐页人眼确认:图在不在、CJK/公式渲染对、布局没裂、原文关键图在场。已知编译坑:①fandol 缺字形(如 ↔)→改成 $\leftrightarrow$ 等 math 符号;②模板没有载 stmaryrd,\llbracket/\rrbracket 会报 Undefined control sequence → 用 [\![...]\!] 代替。
7. 交付:PDF 发到你的分享渠道(网盘 / IM / 邮件)。对外分享前建议人工过目一遍。

解读结构(模板已内置)

定位 keybox(论文/单位/时间线/一句话)→ 这篇在解决什么问题 → 方法内核 → 数值/实验设置(keybox)→ 主要结果(每个关键结果配原文图)→ 验证与网格/可信度 → 我的评价(站得住的地方 / 要打折扣的地方 / 一句总评)→ 放在领域里看(keybox)。

版式(固化，别改样式直接用)

assets/template.tex = 定型版式:ctexart + fontset=fandol(TeXLive 自带，跨平台稳)、geometry margin=2.3cm、tcolorbox keybox、fancyhdr 页眉页脚、titlesec 章节样式、accent 蓝 RGB(40,90,150)、图块宏 \onefig/\twofig/\figrow。 四个完整工作样例见 examples/，照它抄布局最快:

• examples/oblique-detonation/ = 斜爆震解读,图多的范式(5 组原文图 + 1 张自画 TikZ 示意、2×2 图块)。
• examples/mmpd-diffusion-loss/ = MMPD 解读,公式多的范式(演示硬规则 6:MSE=MLE 推导、扩散锚点技巧都分步走 + keybox 圈支点;含从 PDF 裁的整张 Fig.1)。
• examples/futurecad-brep-grounding/ = FutureCAD 解读,含失败案例图的范式(把作者的 failure cases 放进"要打折扣"那节)。
• examples/v-winglet-heat-transfer/ = 实验+数值传热论文的范式(工程类论文怎么核对量纲/评价因子口径)。

何时不用

• 只想读论文/做笔记 → 直接读,不必出 PDF。
• 只把 PDF 转 markdown/抽图 → 直接用 MinerU。