tsingyuai Research Survey (Deep Analysis)
Don't ask permission. Just do it.
Prerequisites
Read and verify these files exist before starting:
| File | Source |
|---|---|
papers/ |
/research-collect 或 /metabolism |
If papers are missing, STOP: "需要先运行 /research-collect 完成论文下载"
Output
| File | Content |
|---|---|
knowledge/paper_{id}.md |
Per-paper structured notes with frontmatter, formulas, and code mapping |
survey_res.md |
Synthesis report with method comparison, scope boundary, and concrete next-step suggestions |
Workflow
Step 1: 收集论文列表
ls papers/
列出所有论文目录（arXiv 源文件）和 PDF 文件。
Step 2: 逐篇深度分析
对每篇论文：
2.1 读 .tex 源码
找到论文的 .tex 文件（在 papers/{arxiv_id}/ 下），重点读取：
- Method / Approach section
- Model Architecture section
- 数学公式定义
对于大型论文（>2000 行），分段读取关键 section，避免上下文溢出。
如果没有 .tex（只有 PDF），基于 abstract 分析。
2.2 提取核心内容
从 .tex 中提取：
- 核心方法：1-2 段描述
- 数学公式：至少 1 个关键公式（保留 LaTeX 格式）
- 创新点：与同领域其他方法的区别
2.3 映射到参考代码
⚠️ 强制性步骤（当 repos/ 存在时） — 代码映射是下游 plan 和 implement 的关键输入。
读取 prepare_res.md 中的仓库列表，对每个公式/核心概念：
- 在对应仓库中搜索实现代码（用 grep 关键类名/函数名）
- 记录文件路径、行号、代码片段
- 如果多个仓库有不同实现，记录差异
2.4 写入笔记
写入 knowledge/paper_{id}.md：
---
paper_id: "{arxiv_id}"
title: "{Paper Title}"
evidence_level: "full_text"
method_family: "{method family}"
key_formula_count: 1
code_mapping_count: 1
---
# {Paper Title}
- **arXiv:** {arxiv_id}
- **核心方法:** {1-2 sentences}
## 数学公式
$$
{key formula in LaTeX}
$$
含义：{解释}
## 代码映射
文件：`repos/{repo}/path/to/file.py:L42-L60`
```python
# relevant code excerpt (< 20 lines)
与本研究的关系
{如何应用到当前研究}
### Step 3: 综合报告
读取所有 `knowledge/paper_*.md`，写入 `survey_res.md`：
```markdown
# Survey Synthesis
## 论文总览
- 分析论文数: {N}
- 涉及方向: {list}
## 核心方法对比
| 论文 | 方法 | 核心公式 | 复杂度 | 优势 |
|------|------|----------|--------|------|
| ... | ... | ... | ... | ... |
## Scope Boundary
- Preconditions: {what conditions this method relies on}
- Not recommended when: {where this method should not be directly applied}
- Evidence strength: {full text / PDF / metadata}
## 技术路线建议
基于以上分析，推荐的技术路线是：
{建议}
## 关键公式汇总
**每个公式附带代码映射，供下游 plan 和 implement 参考。**
| 公式名称 | LaTeX | 参考代码 |
|----------|-------|----------|
| {name} | $...$ | `repos/{repo}/path.py:L42` |
| ... | ... | ... |
## 参考代码架构摘要
基于 repos/ 中的参考实现，推荐的代码结构：
- 数据加载: 参考 `repos/{repo}/data/`
- 模型实现: 参考 `repos/{repo}/model/`
- 训练循环: 参考 `repos/{repo}/train.py`
Rules
- 每篇论文必须读 .tex 原文（如有），不能只读 abstract
- 每篇笔记必须包含至少 1 个数学公式
- 如果有 repos/，必须尝试找到公式到代码的映射
- survey_res.md 必须包含方法对比表
- survey_res.md must include a scope-boundary section and concrete guidance for the current project
- Before writing the final synthesis, write at least 2 real paper notes to disk