论文解读助手

适用场景

• 用户发来 https://arxiv.org/... 链接，并明确要求"论文解读""论文拆解""详细总结""生成报告""下载论文"
• 用户希望把论文资料落到本地目录，再生成一份可持续完善的中文报告
• 用户希望后续自动复查，而不是只做一次性总结

如果用户只要一段 200 字左右的推荐语，优先使用 paper-recommendation，不要使用本 skill。

工作流

0. 先确认执行范围（必须先做）

开始前先给用户一个简短确认，至少说清这 3 件事：

• 会把论文下载到本地并生成报告
• 初版完成后还会安排 1 小时后和 2 小时后的两次复查
• 最终以文件为主交付，而不是直接在对话里长篇输出全文

如果用户已经明确接受“下载到本地 + 生成报告 + 后续复查”的工作方式，可以直接继续，不必反复确认。

1. 确定保存目录

按以下优先级选择基础目录：

1. 用户明确指定的目录
2. 当前上下文中明显属于用户常用工作区的目录
3. ~/Documents/working/papers

不要凭空发明新目录。无法确定时直接使用默认值。

2. 初始化论文工作区

先运行脚本，创建论文目录并下载资源：

python3 skills/paper-interpreter/scripts/bootstrap_arxiv_paper.py '<arxiv_url>' '<base_dir>'

脚本会：

• 解析 arXiv ID
• 使用论文标题创建子文件夹
• 下载 PDF（以论文标题命名）
• 尝试下载 TeX Source
• 可识别时自动解包到 source/
• 写入 metadata.json
• 如报告文件 {论文标题}_报告.md 不存在，则创建报告骨架

优先读取脚本输出中的 paper_dir、report_path、pdf_path、source_path。

3. 阅读材料并生成初版报告

生成报告前，按以下顺序获取信息：

1. metadata.json
2. arXiv 摘要页
3. TeX Source（如果下载成功，优先用它确认公式、模块名、算法步骤）
4. PDF 文件（以论文标题命名）

报告必须写入论文目录下的 {论文标题}_报告.md，并满足：

• 中文输出
• 结构完整，适合长期迭代
• 不编造论文中不存在的实验、公式或结论
• 对不确定内容明确写"论文未明确说明"或"需要进一步核对"
• 在合适位置加入 Mermaid 图，至少 1 张，通常 2-3 张更合适
• 如果需要产出多份报告，继续沿用标题做前缀，并通过后缀区分，例如 {论文标题}_报告_复查1.md、{论文标题}_报告_分享版.md

优先使用 report-outline.md 中的结构。

4. 初稿完成要求（必须执行）⚠️

生成初版报告后，必须立即向用户发送报告文件：

• 发送报告文件：{论文标题}_报告.md
• 使用渠道提供的文件发送功能（QQ 使用 <qqfile>标签）
• 提醒用户这是初稿，后续会有复查任务完善内容
• 说明复查时间（1 小时后和 2 小时后）

发送示例（QQ）：

✅ 论文初稿已生成！

📄 报告文件：<qqfile>报告文件路径</qqfile>
⏰ 初稿复查时间：22:12 和 23:12（自动完善）
📝 当前版本：v1.0 初稿

5. 报告写作要求

报告至少覆盖这些内容：

• 论文基本信息
• 一句话总结
• 要解决的问题与研究动机
• 方法拆解
• 训练或推理流程
• 实验设置与关键结果
• 亮点、局限、适用边界
• 对实际应用或研究延展的判断
• 术语解释
• 复查记录

Mermaid 图建议：

• 方法总览：flowchart LR / flowchart TD
• 训练或推理阶段：sequenceDiagram 或 flowchart
• 模块关系：graph TD

Mermaid 图只保留能帮助理解的图，不要为了凑数量而加图。

6. 安排两次自动复查

初版报告完成后，立即创建定时任务安排 1 小时后和 2 小时后的复查任务。

7. 复查任务的更新原则

复查时不要整篇推倒重写，遵循增量更新：

• 先读取当前报告文件
• 再检查论文原文、PDF、Source 与当前报告的差异
• 优先补充遗漏的实验细节、方法边界、限制条件、图示或术语解释
• 在 复查记录 一节写明本次更新时间、主要新增内容、修正内容
• 不删除用户手工补充的内容，除非确认其与论文事实冲突

输出要求

初版报告完成后的必须操作⚠️

第一步：发送报告文件

• 使用渠道提供的文件发送功能（QQ 使用 <qqfile>标签）
• 发送 {论文标题}_报告.md 文件
• 附带简短说明：
  • 初稿已完成
  • 复查时间（1 小时后和 2 小时后）
  • 当前版本信息

第二步：汇报基本信息

• 论文目录路径
• PDF 文件是否下载成功（以论文标题命名）
• TeX Source 是否下载成功
• 报告文件路径（默认是 {论文标题}_报告.md）
• 两个复查任务的提交结果

注意：必须先发送文件，再汇报信息。不要反过来。

如果 TeX Source 不存在或下载失败，要明确说明"源文件不可得"，但仍继续完成报告。