docs: 补整体框架图与参数系统,交付资料检查改为整例跳过

- 结构.md 第二部分加四段整体框架图;第五部分新增「配置」:每段一份 YAML、
  pydantic 定义、只接收配置路径、编码解码开关与独立映射表
- 结构.md 第三、四部分:检查不过整例跳过,答案库存三表诊断、化名对照、跳过清单
- AGENTS.md「错误怎么处理」加交付资料单例问题的例外。来源:负责人 2026-10-16
  「都是遇到整个病例跳过,让医生核对去吧」
- 待定问题/03 补被跳过病例;WORK_LOG 记决定与下一步

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-16 01:02:16 -04:00
parent 9b2f842559
commit 9c636c0a4f
4 changed files with 79 additions and 7 deletions
+2 -1
View File
@@ -92,7 +92,7 @@ CADx-4 研究胰腺囊性肿瘤的鉴别诊断:给同一个病人的三路资
「可能会出现」不是写分支的理由。按顺序选:
1. 改数据的表示或格式要求,让它不可能出现。
2. 做不到,就在系统边界检查,不满足就报错停下。边界指交付的资料、模型的输出、负责人的配置。模块之间的调用不算边界,不互相防御。
2. 做不到,就在系统边界检查,不满足就报错停下。边界指交付的资料、模型的输出、负责人的配置。模块之间的调用不算边界,不互相防御。交付资料里只落在某一个病例上的问题是例外,见「错误怎么处理」。
一个抽象在出现第二个真实调用点之前不引入。不考虑向后兼容:不写兼容层,读到旧格式直接报错;发现更好的设计就按它重写,同步改文档和测试。
@@ -104,6 +104,7 @@ CADx-4 研究胰腺囊性肿瘤的鉴别诊断:给同一个病人的三路资
- **外部错误**(模型接口超时、网络断开):只在调用外部服务的那一处做有限次重试,仍失败就把这一步记为失败并写明状态。
- **内部错误**(资料不满足规则、不该有的状态组合):立刻停下,报错写清是哪条规则、哪个病例的哪个文件。模型交不出合格输出按内部错误处理。
- **交付资料里只落在某一个病例上的问题**(这一例的编号认不出、缺文件、取值不合规则、和别的表对不上等):跳过这一整例,接着处理下一例,并在标准答案库的跳过清单里写明这一例没过的是哪项检查、哪个文件哪一列。对一个病例,遇到第一项不过的检查就不再往下查,所以清单上每例只有一项,后面的检查没做过,不代表没问题。整张表读不了(工作表名或列名不对、文件缺失、配置不全)仍然立刻停下。跳过不是把问题藏起来:跳过清单交给医生核对,评价时要报告跳过了几例、各因为什么。来源:负责人 2026-10-16「都是遇到整个病例跳过,让医生核对去吧」。
中间层不写 try/except,除非它能把错误完整处理掉且上层不需要知道。不写 `except Exception: pass` 及其变体。