# research-wiki

本项目的文档。读者是没参与过讨论的医学 AI 方向硕士生：懂 Python 和深度学习，不懂胰腺囊性肿瘤。

| 位置 | 内容 | 维护方式 |
|---|---|---|
| `explanation/` | 系统由哪些环节组成、各环节的输入输出、为什么这样分。从 `结构.md` 读起 | 常青：改了就重写那一段 |
| `design/` | 每次重要决策的来历，文件名 `NNNN-简短主题.md` | 写完冻结；决策变了新写一份并注明取代关系 |
| `guides/` | 怎么做某件事：建环境、跑某个环节 | 常青，随实际情况更新 |
| `reference/` | 查得到的外部事实：术语表、算法参数的原始口径、临床方给的字段定义。每条自带出处；抄自 Linear 的写明抄自哪份、哪天同步 | 常青，随出处更新 |
| `待定问题/` | 还没定、迟早要定的问题，一个问题一份文件：问题、为什么要紧、选项、倾向、等谁定 | 定了就删掉，结论写进 `design/`，同一个提交 |
| `任务书/` | 每个模块动手前的任务书，文件名 `NN-模块名.md`：要做什么、依据哪些文档、怎么验收 | 负责人确认后交执行者；要改就在开头写「这一版改了什么」 |
| `paper/` | 论文正式草稿，从 `claim.md`（问题句与主张句）起步；只写论文能直接用的文字 | 常青，随讨论定稿重写 |
| `survey/` | 文献调研：同类工作怎么做、对我们意味着什么，引文带 PDF 页码（PDF 在根目录 `reference-pdf/`，不进 git） | 写完冻结；有新调研另写一份 |
| `results/` | 实验结果报告，每个数字标明来自哪次运行（`runs/` 下的目录名） | 写完冻结 |
| `scratch/` | 讨论中的草稿、上下文压缩前的快照 | 由负责人清理，Agent 不删 |

## 几类文档的开头

不用 YAML 头，靠固定的开头段落：

- **design**：`# NNNN 标题` → `状态：负责人 YYYY-MM-DD 认可（「原话」） ｜ 日期：…` → 取代了谁就写一行 `> 取代 NNNN 的第 X 条` → `## 先认识几个词` → `## 背景` → `## 决定`（编号条目，写明哪条是负责人定的、哪条是 Agent 提的） → 需要时加 `## 不做的事`。
- **任务书**：标题 → 一段目的 → `来源：`（负责人原话） → `## 先认识几个词` → `## 开工前先读` → 分阶段的工作内容（每阶段写收尾点） → `## 测试` → `## 规模` → `## 审阅` → `## 报告`（分开写已验证的事实、推断和未验证的部分，附运行目录、提交号、花费）。
- **results**：`日期 ｜ 对应结构.md 第七部分第 N 步 ｜ 原始记录：runs/…` → `## 先认识几个词` → `## 一 跑了什么` → 结果，每个数字带运行目录。