docs: 架构定稿——四段流水线、两个库与待定问题

负责人 2026-10-16 定:数据流为「医院原始资料->中间文件->给专家的资料库 & 标准答案库」;
两个库和中间文件都用文件夹,SQLite 只用于调模型账本;调模型用 PolyGateway;CEUS 直接逐个
迁移;数据格式和口径以 40 例交付包为准。存储与迁移方案先由两个中立子 Agent 独立评审。

- design 0002:八条决定及负责人原话(化名与打乱顺序一条为 Agent 提出)
- explanation/结构.md 对照 ClinDB 的结构文档重写:切分原则、完整范围、12 个模块与依赖、
  边界、两个库与 CEUS 中间文件的内容、目录与检查、规模、推进顺序
- research-wiki/待定问题/:绿框、参数冻结、排除标准、跨表不一致四个问题;定了就删
- AGENTS.md:事实来源加「交付资料的格式和口径以最新交付包为准」
- .gitignore 与 pre-commit 拦截 library/、answers/、work/

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-16 00:44:42 -04:00
parent 22cf532dc4
commit 9b2f842559
12 changed files with 369 additions and 80 deletions
+3 -1
View File
@@ -27,9 +27,11 @@ CADx-4 研究胰腺囊性肿瘤的鉴别诊断:给同一个病人的三路资
| 当前进度、下一步 | `WORK_LOG.md` |
| 代码分哪些模块、谁能依赖谁、各模块预期规模 | `research-wiki/explanation/结构.md` |
| 各环节在做什么、输入输出 | `research-wiki/explanation/` 的其他文档 |
| 还没定的问题 | `research-wiki/待定问题/`(定了就删,结论进 `design/`) |
| 某个决策为什么这样定 | `research-wiki/design/NNNN-*.md`(写完冻结) |
| 命令怎么敲、环境怎么配 | `research-wiki/guides/` |
| 医学词、参数的原始口径、临床方给的字段定义 | `research-wiki/reference/`(每条自带出处) |
| 交付资料的格式和口径(列名、编码、时间的含义) | 最新的交付包,目前是 `data/交付包_20260908_40例/`。旧样本(如 `data/1.2-TEST/`)和旧程序的口径只当线索。来源:负责人 2026-10-16「数据改过很多版,所以你们需要对齐“40例交付包”那个」 |
| 配置值、字段定义 | 代码里的定义与校验;文档只解释含义,不抄数值 |
| 临床口径、双方约定、待交付清单 | Linear(临床方维护的那几份 document 是权威,仓库里的抄本以它为准) |
| 旧项目做了什么、踩过什么坑 | `reference/CADx-4-CAD/`(只当线索,见下文) |
@@ -48,7 +50,7 @@ CADx-4 研究胰腺囊性肿瘤的鉴别诊断:给同一个病人的三路资
## 硬性约束
1. **答案不进 AI 专家能看到的任何东西。** 病理金标准、工作簿里的诊断列、按规则算出诊断倾向的公式列、医生的结构化判读列(**标注工作簿**是临床方另交的一份表,医生在里面逐例标了病灶位置、大小、囊壁、增强模式等三十来列,它只用于评价专家抽取得准不准)、报告的「印象 / 结论」段、真实病例号、Excel 行序,一律不能进入提示词、工具返回或专家可读的文件。**行序也算**:原始表格按诊断分组录入,行号本身就带着答案。这一条错了不会报错,只会让所有「系统诊断得准不准」的结论变成「系统能不能读到答案」。任何会削弱这条的改动,先停下来问。来源:旧项目 CLAUDE.md §1.2、旧 design 0026。
2. **每个 AI 专家只看自己那一路资料。** 性别和年龄只给临床那一路;超声和 MR 两路看不到,即使医院把这几列也复制进了报告工作簿。各路能看见什么见 `research-wiki/explanation/` 里的会诊文档(迁移完成前看旧项目 `research-wiki/explanation/agent-system.md` §2)。来源:同上。
2. **每个 AI 专家只看自己那一路资料。** 性别和年龄只给临床那一路;超声和 MR 两路看不到,即使医院把这几列也复制进了报告工作簿。各路能看见什么见 `research-wiki/explanation/结构.md` 第四部分。来源:同上。
3. **患者资料不进 git、文档和提交说明。** 原始资料只在 `data/`,运行产物只在 `runs/`,两者都不进 git。文档里可以写结构和规模,不写报告原文、姓名、病例号和诊断。把病例资料发给外部模型服务之前,先确认负责人已同意该服务。超声帧上烧录的信息栏(拼音姓名、检查号、性别年龄、医院与设备参数)不做遮蔽:临床方判定拼音和不唯一的检查号不构成身份泄露(出自旧 design 0041)。
4. **密钥不进 git、文档、日志和运行快照。** 只放环境变量或本地 `.env`;仓库只提交不含真实值的 `.env.example`。
5. **写进论文和结论的数字能追到一次真跑的原始记录**(`runs/` 下的运行目录)。不把预期、估算、旧项目报告或别人论文里的数字当成本仓库的结果;没有就写「没有」。文献里的数字核到 `reference-pdf/` 的原文。