论文精读 → 双卡片
概述
把一篇论文 PDF 精读成两张卡片：一张英文卡、一张中文卡。每张卡片都包含深度阅读的结论与证据，
而不是骨架提纲。
自包含：本 skill 无需任何前置文件即可工作，装完即用。
何时使用
- 用户说「精读
xxx.pdf」/「精读这篇论文」/「生成精读卡片」/ "close-read this paper"。 - 用户上传或指定一篇论文 PDF，并要求深度阅读。
不适用：快速摘要（"这篇讲了什么"）、文献检索、纯翻译——这些不产出精读卡片。
铁律
- 绝不杜撰数字。 卡片中引用的每个数字（PSNR、dB、MACs、ISO 范围、迭代次数、页码/图号/表号）
都必须来自 PDF 原文。先抽取全文、读原文，再写卡片。 - 先抽全文再判断。 不要凭文件名或印象下结论。PDF 常无法直接读取（"Cannot display content of
binary file"），务必用自带脚本抽取。 - 卡片必须够厚。 要有一句话判断、论证链、方法机制、结论-证据对照、反直觉发现/失效条件、局限。
只给骨架表 = 失败。 - 区分事实与推断。 明确标注哪些是论文事实、哪些是作者解释、哪些是你的分析推断（标"推断"）。
工作流
Step 1 — 定位论文并抽取全文
- 确定目标 PDF 路径。用户未给路径时，询问或在工作区中查找。
- 用自带脚本抽取全文（处理无法直接读取的 PDF）：
python scripts/extract_pdf_text.py "<论文.pdf>" --out "<SCRATCH>/paper_text.txt"
- 运行时：任意装了
pymupdf的 python。若缺失则pip install pymupdf。 <SCRATCH>是临时工作目录，绝不写到工作区根目录。 默认取<工作目录>/.workbuddy/tmp/
（不存在则先mkdir -p），或直接用系统临时目录；两者都不可用时才退回到工作目录下的隐藏目录。- 抽出的
paper_text.txt只是本次阅读用的中间文件，读完即可删除，不要当作交付物。 - 完整阅读抽出的全部页面，不要只读摘要。图表很重要，记下引用的表号/图号。
Step 2 — 深度阅读（七阶段方法）
为写卡片准备以下素材：
- 重建研究故事：问题 → 现有工作为何不足 → 核心洞察 → 方法 → 关键证据 → 结论与边界。写成箭头链。
- 结论对应证据：每条主要结论对应到具体的表/图/数字，并给出专家判断（充分支持 / 条件性支持 /
证据有限）与可信边界。 - 主动找：(a) 反直觉结果；(b) 优势消失的失效条件；(c) 可疑或不对称的数字；(d) 论文内部的
自相矛盾之处。这是卡片最有价值的部分，不要跳过。 - 量化边界：结论在哪个数据集/指标/条件下被证明，什么未被证明。
- 可复用性：哪些机制/公式/协议可迁移，哪些不可照搬。
- 阅读范围：读了哪些页面、检查了什么、哪些无法确认。
Step 3 — 生成英文卡片
路径：<OUT_EN>/<第一作者姓>-<年份>-<关键词>.md（如 Wang-2020-Practical-Deep-Raw-Image-Denoising.md）
<OUT_EN>默认 =<工作目录>/02-Papers/，<OUT_CN>默认 =<工作目录>/02-Papers-CN/。- 若用户明确指定了输出目录，则遵从用户；目录不存在时用
mkdir -p创建（增量复用，绝不重建/清空已有目录）。
结构（YAML + 八个章节）：
---
title: "<论文全名>"
authors: [<作者...>]
year: <YYYY>
venue: "<发表处>"
doi: <doi 或 N/A>
tags: [paper, <领域标签>, read]
status: read
rating: <1-5，诚实打分>
read_date: <YYYY-MM-DD>
---
卡片正文（英文）：
# <论文标题>
> [!quote] One-sentence judgment
> 用一两句说明论文真正做了什么、最重要的价值、以及结论成立的主要条件。
## 1. Conclusion Overview
### What the paper actually achieves
### The three most important judgments
1. **Core contribution**: ...
2. **Strongest evidence**: 给出表/图/关键数字。
3. **Key boundary**: 结论的适用条件或可信限制。
## 2. Paper Panorama
### Background and problem
### Core contributions（区分"作者声称"与"深读确认"）
### Map of the paper（决定判断的章节/图表）
## 3. Research Story and Argument Chain
用箭头链写出：问题 → 现有方案为何不够 → 核心洞察 → 方法 → 关键证据 → 结论与边界。
指出论证最强处 / 明显的跳步。
## 4. Methods, Theory, or Mechanism
### Core idea (plain language)
### How it works（输入 → 核心模块 → 信息流 → 目标函数 → 输出）
### Key design choices（解决什么困难 / 依赖什么假设 / 代价）
## 5. Key Evidence and Experimental Results
### Claim–evidence correspondence
| Main claim | Decisive evidence (table/fig/number) | Expert judgment | Credibility boundary |
|---|---|---|---|
### The most convincing results（准确数字 + 出处 + 为何重要）
### Counter-intuitive results and failure conditions
## 6. Credibility, Limitations, and Reproduction Boundary
### Most solid evidence
### Issues that affect interpretation
### Limitations（作者承认的 / 推断的 / 无法确认的）
### Reproduction risks
## 7. Reusable Insights and Research Actions
- 值得复用 / 不应直接照搬 / 下一步研究问题 / 建议行动顺序
## 8. Reading Scope and Information Boundary
- 实际读了哪些页面；关键判断如何追溯到页码/表号/图号；哪些无法确认。
- 本卡片属于论文精读，不等同于实验复现或正式同行评审。
Step 4 — 生成中文卡片
路径：<OUT_CN>/<同名>-CN.md
- 与英文卡片结构一致、数字一致，正文用中文。
- 专业术语/标识保留英文（如
k-Sigma Transform、Table 2、Eq. 7），便于检索。 - 章节标题用中文：
| 英文 | 中文 |
|---|---|
| 1. Conclusion Overview | 一、结论速览 |
| 2. Paper Panorama | 二、论文全景 |
| 3. Research Story and Argument Chain | 三、研究故事与论证链 |
| 4. Methods, Theory, or Mechanism | 四、方法、理论与机制 |
| 5. Key Evidence and Experimental Results | 五、关键证据与实验结果 |
| 6. Credibility, Limitations, and Reproduction Boundary | 六、可信度、局限与复现边界 |
| 7. Reusable Insights and Research Actions | 七、可复用洞察与研究行动 |
| 8. Reading Scope and Information Boundary | 八、阅读范围与信息边界 |
Step 5 — 加入 Obsidian 链接
卡片要能在 Obsidian 库（vault）里双向导航，用 [[...]] 维基链接。链接目标是不带 .md 后缀、不带路径的笔记名。
在两张卡片正文末尾（第 8 节之后）各加一段（英文卡用 ## Links，中文卡用 ## 相关链接）：
## Links
- 中文卡：[[<同名>-CN]]
- 索引：[[02-Papers MOC]]
- 源论文：[[<pdf 文件名>]]
- 标签：#paper/<slug>
- 双向互链：英文卡链到中文卡
[[<同名>-CN]]，中文卡链回英文卡[[<同名>]]。 - 源论文：用
[[<pdf 文件名>]]（含扩展名，如[[2010.06935v1.pdf]]）；PDF 不在 vault 内时省略此行。 - 标签：正文/结尾标
#paper/<slug>，并在 frontmattertags里补paper/<slug>，便于用标签聚合。 - MOC 索引（强制维护）：索引页路径固定为
<OUT_EN>/02-Papers MOC.md，Obsidian 链接名[[02-Papers MOC]]。 - 若该页已存在：把本次的新卡片按其领域分组，向清单追加一行（EN 卡与 CN 卡并列写，附一句标题/出处/关键点备注）；同一篇论文只登记一次，重复精读时更新而非追加。
- 若不存在：创建该页——frontmatter 用
tags: [MOC, paper]，正文含简短说明 + 若干分组小节（如"去噪 / 计算摄影""超声 / 医学成像""其他"），再把本次卡片写入对应分组。 - 每张卡片末尾的链接段都加上回链
[[02-Papers MOC]]，形成"索引 ⇄ 卡片"闭环。 - 链接名必须与实际文件名一致，否则 Obsidian 里是断链；写完顺手核对一遍文件名。
Step 6 — 交付
- 用
present_files呈现两张卡片（中文卡在前、英文卡在后），两者都可下载。 - 附一句简短小结：一句话判断、2–3 个关键数字、以及本次是否有发现。
附带资源
scripts/extract_pdf_text.py— 把 PDF 转成带页码的纯文本（需pymupdf）。第一步必用。
