把学术论文（arXiv/PDF/文本）变成可分享深度…

当你拿到一篇论文（arXiv 链接、PDF 或粘贴文本），需要产出比读原论文更清楚的深度解析长文（HTML）时使用。

适用场景

解决思路

1. 调用方式：`/paper-analyzer <arxiv URL>`、`/paper-analyzer /path/to/paper.pdf`，或直接粘贴论文文本。
2. Round 1 获取全文：arxiv URL 时同时读取 arxiv.org/abs/（摘要页）和 arxiv.org/html/（全文 HTML）；PDF 路径时用 PDF 读取工具分多次读取直到全文获取完毕；粘贴文本则全部使用。读完自检是否拿到完整内容，不完整就换方式继续。
3. Round 2 找代码：先从论文中提取代码仓库链接（通常在页脚或 Introduction 末尾）；找不到就用「论文标题 + 作者名」在 GitHub 搜索；找到后执行 `git clone --depth 1 <url> /tmp/paper_code`。
4. Round 2 读代码：按 README → 核心源码文件 → 配置文件 的顺序阅读。
5. Round 2 按代码仓库状态分支处理：已发布 → 读核心文件，找出 ≥2 处「论文方法 ↔ 源码」对应，文章里贴 ≤30 行代码段并标注 `文件路径:行号`；待发布 → 检查 README/Release 标记，标注状态 + 仓库链接；无代码 → 搜索替代实现或相关项目，并注明「本文未提供公开代码」。
6. Round 3 在内部完成深度分析（不展示过程），共 5 项：①核心创新——论文做了什么别人没做的，1-3 个，每个一句话提炼；②方法细节——输入→处理→输出→为什么更好，每个创新都画清这条线；③关键实验——哪个结果最有说服力、为什么；④论文弱点——作者自述 + 自己的判断；⑤代码对应——每个 component 对应哪个文件/函数。
7. Round 4 必须询问用户选择写作风格（storytelling / academic / concise）；用户未回复则默认 academic。
8. Round 5 按选定风格的具体要求撰写并输出完整 HTML。
9. Round 6 逐项执行自我审查清单，不通过就修改直到通过。
10. storytelling（故事型）硬标准：字数 ≥3000、段落 ≥15、引用论文原文 ≥3 处、生动类比/比喻 ≥2 个、结尾金句 1 句。
11. storytelling 结构（按顺序，缺一不可）：钩子开头 2-3 段（反常识问题/引人共鸣的场景/让人「等等再说一遍？」的事实，不要直接讲技术）→「为什么会这样」3-4 段（现有方法的逻辑与瓶颈，用简单例子说明）→核心洞察 1-2 段（最关键的那一句发现 + 一个类比强化）→方法详解 5-8 段（全文最重点：怎么做→为什么这样设计→和旧方法的关键区别，每步配一个类比，引用论文原文公式/算法 ≥3 处，用对比表呈现新旧方法差异）→实验效果 3-4 段（最重要的结果 + 数据解读，解释「这意味着什么」，关键对比数据用表格）→深层意义 2-3 段（技术意义、产业意义、方法学意义多角度）→局限 1-2 段（作者自述 + 你的判断）→收束 1 段（回到开头的场景/问题形成闭环）→金句 1 句。
12. storytelling 写法：多用「你」和读者对话（如「你有没有想过」「你猜怎么着」）；段落短，一段不超过 4 句话；技术词出现时立刻给「人话解释」；数据要翻译成可感知的东西（如「15 斤荔枝」而不只是「15 斤」）。
13. academic（学术型）硬标准：字数 ≥4000（必须长于故事型）、段落 ≥20、论文公式引用 ≥5 处（用 KaTeX 渲染）、论文图片/图表引用 ≥3 处（标注 Figure number）、实验数据表格 ≥2 张、代码段 ≥2 段（如有代码）、指出局限 ≥2 处。
14. academic 结构：论文元信息（标题·作者·链接·代码状态）→一句话总结（100 字内）→研究背景与动机 4-5 段（领域问题、现有方法及局限、本文出发点）→预备知识 2-3 段（如需要）→方法详解 8-10 段（每个创新点独立成节，每节含①问题②怎么做配公式③为什么有效④与已有方法的差异；公式用 $$...$$ KaTeX 渲染，引论文 Figure/Table 编号，有代码则穿插源码分析）→实验分析 4-6 段（实验设置概述、主要结果配表格 + 深入解读、不同维度对比、消融实验说明了什么）→讨论 2-3 段（适用边界、未解决问题、对未来工作的启示）→局限分析 2-3 段（作者自述 ≥1 处 + 你的独立判断 ≥1 处）→结论 1-2 段（凝练贡献 + 展望）。
15. academic 写法：保持学术严谨但不死板，要比论文好读；每个公式后跟一句「人话」解释它在说什么；引用论文 Fig/Table/Section 编号；表格数据要有解读，不只贴数据；数学符号首次出现要解释含义。
16. concise（精炼型）硬标准：字数 ≥1200（不能低于）；必须包含核心摘要盒 + 表格 + 可视化图表 + 金句；必须至少 1 个 Mermaid 图表（架构图或对比图）。精炼 ≠ 敷衍，是信息密度极高但该有的全有。
17. concise 结构：头图 Mermaid（全文最核心架构/对比，类型可为 flowchart、graph 或 timeline）→核心摘要盒（5 行以内，覆盖做什么/怎么做/效果/适用场景）→关键创新 3-5 个编号列出（每个 2-4 句：一句话说创新点→一句话说怎么做的→一句话说为什么重要）→核心数据表（最多 5 行，突出和 baseline 的对比）→金句收尾。
18. Mermaid 写法：节点文本避免中文标点和特殊字符，用英文或简单 ASCII，用 <br/> 换行；图用 `<pre class="mermaid">...</pre>` 包裹；初始化用 `mermaid.initialize({startOnLoad:true,theme:'default',securityLevel:'loose'})`。
19. HTML 输出：使用给定模板（含 KaTeX 与 Mermaid 的 CDN 引用、内联 CSS 变量与样式、720px 正文宽度、`.summary-box`/`.golden`/`blockquote`/`table` 等类、移动端媒体查询），产出可直接在浏览器打开的完整 HTML。
20. 公式渲染：用 `$$...$$`（块级）或 `$...$`（行内），由 KaTeX 自动渲染；避免未定义命令（如 `\I`）；不要把公式写在 `<pre>` 标签内。
21. Round 6 通用自检项：字数达标（story≥3000 / academic≥4000 / concise≥1200）；引用论文原文 ≥3 处；每个核心创新独立深度展开；至少 1 个实验结果做深入解读；代码状态已提及；有代码则源码 ≥2 段 + 文件路径；指出局限 ≥2 处（至少 1 处是作者自述的）；HTML 格式完整、可在浏览器打开；无 AI 套话（「深入探讨」「至关重要」「值得注意的是」）。
22. storytelling 专属自检：有钩子开头；有 ≥2 个类比/比喻；用「你」和读者对话；有收束段落形成闭环；有金句。
23. academic 专属自检：字数 ≥ storytelling；公式 ≥5 处（KaTeX 渲染）；论文图/表引用 ≥3 处（Fig/Table 编号）；实验数据表 ≥2 张；方法部分 ≥8 段。
24. concise 专属自检：有 Mermaid 图表；有核心摘要盒；有对比数据表；有金句；字数 ≥1200。
25. 按需查阅参考文件补充规范：`styles/storytelling.md`、`styles/academic.md`、`styles/concise.md`、`styles/with-formulas.md`、`styles/with-code.md`、`scripts/generate_html.py`。

适用边界 · 注意事项

• 输入不是学术论文（博客、新闻、技术报告、产品文档）时——6 轮强制流程与各风格硬标准是为论文设计的，直接套用会浪费且失真。
• 需要原创研究判断、复现验证或同行评审结论时——它产出的是解读长文，不能替代评审或实验复现。
• 无法获取论文全文或联网（只有标题/摘要的离线场景）时——Round 1 获取全文与 Round 2 搜索仓库无法完成。