论文解读
- 作者仓库星标 8,497
- 作者仓库 blog
- 领域
- 写作
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @digoal · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Paper Interpretation
## Goal
Read the whole paper, including text, tables, figures, captions, appendices, and experiment details, then write a Chinese Markdown article that helps non-specialists understand the paper while preserving its academic and industrial value.
Always save the final Markdown under the current project's `markdown/` directory. Create the directory if missing. Use a descriptive filename derived from the paper title, for example `markdown/论文标题-通俗解读.md`.
## Intake
Accept either:
- A local PDF path.
- A PDF URL.
If the user gives a URL, download the PDF or use `scripts/extract_paper_assets.py` to download and extract it. If the PDF is scanned or extraction is incomplete, use OCR or available PDF/image tooling before writing. Do not rely only on abstract/introduction unless the PDF cannot be fully processed; state any limitation explicitly.
## Extraction Workflow
Use the helper script when useful:
```bash
python3 /Users/digoal/.codex/skills/paper-interpretation/scripts/extract_paper_assets.py INPUT_PDF_OR_URL --out .paper-work
```
The script creates:
- `paper.pdf` for the normalized PDF.
- `paper_text.md` with page-level text.
- `paper_tables.md` with table candidates when `pdfplumber` is available.
- `figures/` with extracted embedded images when `PyMuPDF` is available.
- `manifest.json` with extraction status and warnings.
Read the extracted files and inspect important figures/tables directly when they carry evidence, architecture, or results. If a library is unavailable, use other local tools if present; otherwise continue with the available extraction and mention the gap only if it affects confidence.
## Reading Checklist
Before writing, identify:
- Paper title, authors, venue/date when available.
- Research problem and practical motivation.
- Prior methods or baselines the paper contrasts against.
- Proposed method, system architecture, algorithm, data, or theory.
- Main experiments, metrics, datasets, tables, and figures.
- Claimed academic contributions and industrial implications.
- Assumptions, limitations, failure cases, and future work.
## Article Structure
Write in Chinese. Make the result accessible, but do not dilute technical substance.
### 1. 论文定位
Start by answering "这是什么、跟我有什么关系、值不值得读":
- Use 1-3 sentences to explain the real-world problem.
- State academic value: what gap it fills or what new capability/evidence it adds.
- State industrial value: where it can be used or what decision it can improve.
- Give one intuitive analogy tailored to the paper. Avoid reusing examples blindly; for a multi-agent finance paper, an analogy like "给 AI 配了一个完整的投资团队" is appropriate.
### 2. 前置知识地图
Build a prerequisite knowledge map:
```text
核心概念(必须懂) -> 支撑概念(有助于理解) -> 扩展概念(感兴趣再看)
```
For each important concept, explain with:
- A chart or structured list.
- An analogy.
- A concrete example.
Use Mermaid when it improves clarity:
```mermaid
flowchart LR
A["核心概念"] --> B["支撑概念"]
B --> C["扩展概念"]
```
### 3. 论文精读
Use the 5W1H frame and map it to the paper:
| 问题 | 对应论文结构 | 写作要求 |
|---|---|---|
| Why:为什么要做这个研究? | Introduction / Motivation | 讲清痛点和旧方法不足 |
| What:提出了什么方法/系统? | Method / Architecture | 用一句话先讲总方案 |
| How:具体怎么实现? | Technical Details | 拆成模块、流程、公式或伪代码 |
| So What:结果怎么样? | Experiments / Results | 引用关键表格/图/指标,解释数字意味着什么 |
| Now What:对我们意味着什么? | Value / Discussion | 总结工业和学术启发 |
Prefer comparison over isolated explanation:
- Compare with prior methods or baselines.
- Compare with a reader's intuitive expectation.
- Explain what changes in the workflow, cost, accuracy, robustness, or scalability.
### 4. 术语解释
Include a glossary for important terms. Use this template:
```markdown
**Term(中文名)**
- 是什么:...
- 为什么重要:...
- 现实类比:...
```
Explain why the term is named that way when useful. Keep terms short and selective; prioritize terms required to understand the paper.
### 5. 批判性评估:论文强在哪里,边界在哪里
Evaluate, do not merely praise:
- Which assumptions must hold in real deployments?
- Are datasets, baselines, metrics, ablations, or statistical claims convincing?
- Where might the method fail?
- What cost, latency, safety, privacy, reproducibility, or integration risks exist?
- What future improvements are realistic?
Separate paper claims from your inference. Use wording like "论文证明了..." for supported claims and "可推断..." for reasoned extrapolation.
## Visual Requirements
Use Markdown-supported visuals at key points:
- Mermaid for process, architecture, concept maps, causal chains, and experiment flow.
- Markdown tables for comparisons, result interpretation, limitations, and term dictionaries.
- Simple SVG only when a static diagram is clearer than Mermaid.
- Text diagrams when they are more readable than formal charts.
Do not add decorative diagrams. Every visual must help explain a concept, method, result, or critique.
## Source Discipline
- Cite page numbers, section names, table numbers, or figure numbers whenever possible.
- Do not invent results, claims, datasets, or author intent.
- If extraction is incomplete, clearly label uncertain parts.
- Preserve important formulas or algorithms, but explain them in plain language.
- If the paper has supplementary material or appendices inside the PDF, include relevant evidence from them.
## Output Checklist
The final Markdown must include:
- Title.
- Paper metadata.
- 1-3 sentence overview.
- Academic value and industrial value.
- Knowledge map.
- Problem-solution-validation deep read.
- Key figure/table interpretations.
- Term glossary.
- Critical evaluation and future directions.
- References/source notes pointing back to paper sections, pages, figures, or tables.
After saving, report the absolute output path and any extraction limitations.
章节与文件索引
按说明文件中的顺序排列。
目标
摄入量
提取工作流程
阅读清单
文章结构
文件/命令 -> markdown/ · markdown/论文标题-通俗解读.md · scripts/extract_paper_assets.py · paper.pdf · paper_text.md · paper_tables.md · pdfplumber · figures/
内容校验值 -> ee5a7e1aaeb4
当前原文的自动摘译,尚未人工审校。
目标
阅读整篇论文,包括文本、表格、图表、标题、附录和实验细节,然后写一篇中文 Markdown 文章,帮助非专业人士理解论文,同时保留其学术和工业价值。始终将最终的 Markdown 保存在当前项目的
markdown/目录下。如果缺少目录,请创建该目录。使用源自论文标题的描述性文件名,例如markdown/论文标题-通俗解读.md。摄入量
接受以下其中之一: 本地 PDF 路径。 PDF 网址。如果用户提供 URL,则下载 PDF 或使用
scripts/extract_paper_assets.py下载并解压。如果 PDF 已扫描或提取不完整,请在写入之前使用 OCR 或可用的 PDF/图像工具。除非无法完全处理 PDF,否则不要仅依赖摘要/简介;明确说明任何限制。提取工作流程
有用时使用帮助程序脚本:该脚本为标准化 PDF 创建:
paper.pdf。paper_text.md带有页面级文本。当pdfplumber可用时,paper_tables.md与候选表一起使用。阅读清单
在写作之前,请确定:论文标题、作者、地点/日期(如果有)。研究问题和实践动机。论文所对比的先前方法或基线。提出的方法、系统架构、算法、数据或理论。
文章结构
用中文写。使结果易于理解,但不要淡化技术实质。