paper-readerlisted
Install: claude install-skill ythx-101/paper-reader
# paper-reader:读论文 → 图解组图 + 配文
目标:把一篇论文讲给普通读者听,**每个数字都能追到原文出处**,画面好看到让人愿意读下去。
依赖:
- [Kami](https://github.com/tw93/Kami)(作者 [@HiTw93](https://x.com/HiTw93),MIT 协议):排版与出图。
- 一个能读写文件、跑 Python 的 agent;能点网页的浏览器自动化工具(用于拿补充材料)会很有帮助。
- 一个用来当评审的强模型(任意强模型,如 Claude Opus)。
方法来自 PaperBanana / PaperVizAgent(arXiv [2601.23265](https://arxiv.org/abs/2601.23265),代码 https://github.com/google-research/papervizagent)。那是 Google Cloud AI Research 与北京大学的研究工作,不是 Google 官方支持的产品。
---
## 0 先复述
动手前用一句话复述三件事:拆哪篇论文、给谁看(X 还是小红书)、标题是什么。
- 用户没给链接:先根据题目、作者、期刊搜 DOI;如果是「社交媒体上看到的」,先找到原帖,再从原帖追到论文。
## 1 拿原文:只走合法途径
**不使用 Sci-Hub、LibGen、Anna's Archive 等盗版站。** 按下面的阶梯逐级尝试,每一步的结果(成功、失败、原因)都记进 `fulltext/paths.md`:
1. **开放获取聚合**:Unpaywall API `https://api.unpaywall.org/v2/<DOI>?email=<你的邮箱>`;再查 Europe PMC、PMC、arXiv、bioRxiv / medRxiv、OpenAlex。
2. **作者渠道**:实验室官网、作者主页上的 [pdf] 或作者赠阅(如 Science 的 ijkey)链接。这类链接常校验来源页,要在浏览器里从作者页面**点进去**,不要复制链接另开。
3. **补充材料**:期刊文章页的 Supplementary 按钮。补充材料通常免费,里面往往有方法、补充图注,以及汇总每张主图 n 和 p 的统计表。直接 curl 常被 Cloudflare 拦,用浏览器点页面上的按钮。
4. **开放获取的评论与综述**:同期评论、Dispatch / News & Views、综述常转载原文主图。
5. **学位论文 / 机构知识库**:第一作者的学位论文、机构库版本。
6. **都拿不到**:起草一封给通讯作者索取单行本的邮件,交给用户过目,**不要替用户发**。
**新闻稿只当线索,不当数据。** 新闻稿和媒体报道会简化、改写甚至写错分组和口径(见 [README 的案例](https://github.com/ythx-101/paper-reader#案例胜利者效应science-2017):新闻稿写成「>6 次 / <5 次」,原文实际是 2–5 次和 6–20 次两组)。凡是要上图的数字,必须回到原文、补充材料或转载原图的正式出版物核对。
## 2 事实表 `facts.md`
- 每一行包含:**结论 | 数字 | 出自哪张图或表 | 来源 URL**。
- 数字写成只数(如「9/10」),不要只写百分比;需要时再附上百分比。
- 分清口径:「多少只动物达成」和「逐场胜率」不是一回事;不同