技能介绍

它解决什么问题

读一篇论文往往要在不同工具之间来回切换：PDF 阅读器里翻图表，笔记软件里整理结论，最后还要手动把公式和配图搬进文档。paper-report 想做的是把这条链路压成一次调用：输入本地 PDF 路径或 arXiv 链接，输出一篇结构完整、图表已就位的中文阅读报告。它特别处理了两个工程上容易踩坑的点：一是论文里的图片要从原始文档中真实提取，而不是留一个指向外链的占位；二是公式在 HTML 里能被正确渲染，不因为转义问题变成乱码。

核心能力与执行流程

技能启动时先做一次路由决策，这是它最值得注意的设计。输出格式由用户决定，未指定时默认生成自包含的 report_*.html，图片转成 base64 内嵌；Markdown 模式下图片保存为独立文件，正文用相对路径引用。

输入侧有两条互不混用的通道。本地 PDF 直接走 PDF 模式；arXiv 链接优先尝试把 /pdf/ 替换为 /html/ 并发起 curl 探测，拿到 200 就走 HTML 模式，否则回退 PDF 模式。这个探测机制避免了对不存在的 HTML 版本做无效解析。

两条通道走完后，{workspace}/figures/ 里已经备好所有图表。报告结构只是参考框架：方法实现细节类附录并入主方法章节，补充实验类附录并入结果章节，不设死板模板。全文中文撰写，术语首次出现附带英文原文，公式用 LaTeX 语法，HTML 模板内置 MathJax 3，构建字符串时须用原始字符串防止双反斜杠。

适用边界与注意点

技能对输入质量比较敏感。超过 20 页或 5 万字符的长文需要分批处理；双栏排版 PDF 中跨栏图宽可达 565pt，裁剪坐标需要专门调整；扫描版 PDF 只能按图片阅读，报告中会标注来源质量受限。它要求严格基于原文，不允许添加推测或数据。校验阶段会用 ls 逐个确认 Markdown 引用的图片确实存在，并用 grep 检查 LaTeX 命令前是单个反斜杠而非双反斜杠。PDF 与 HTML 两种模式不得混用。