iomgaa
9a916c65a5
任务书 01 遗留修复（C14）： - library 新增 check_key_image(path)：关键图能逐像素保真重编码时返回 None，否则返回原因； _write_clean_png 的判断移过去，自身保留断言性质报错（走到这里说明 build 漏了检查）。 - build 写库前对每例调用，返回原因的整例跳过，记 C14「关键图能原样重编码」，涉及值写原因。 - 原来三条「关键图格式不对整次构建停下」的测试改为整例跳过，另加非 PNG、library 漏检报错两条。 - 结构.md 第八部分、guides/装配两个库.md 相应几行改掉。 第一阶段（src/cadx/ceus/）： - 照搬旧 geometry、video_decoder、research_config、split_screen、green_prompt、prompt_frames、 mapping，去掉产品层，注释改中文。 - 配置类去掉全部默认值，strict、extra=forbid、frozen；新建 config/ceus.yaml（paths、ceus 两段）， 数值照抄旧 yaml，逐项注明出处。删去 source_view/target_view、effective_region、mapping 锚点； 旧代码写死的分屏抽帧数 25 和搜索区间 (0.35, 0.65) 改成配置，值不变。 - 视频解码改为按路径用 cv2 逐帧读。 - 坐标换算改为两个视图矩形左上角之差，不再用按某种宽度写死的锚点。 - 造影画面在哪一半：两半各自选提示帧，恰好一半有才定，否则抛 ContrastSideError（CeusCaseError 子类，带步号和原因，供第三阶段记 failed.csv）。 - 旧测试照搬（改 import 与配置读取方式），因上述改动不再成立的删去；新增两处修改的手算测试。 - import-linter 加「ceus 不引用其他 cadx 模块」。依赖加 numpy、opencv-python-headless。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
research-wiki
本项目的文档。读者是没参与过讨论的医学 AI 方向硕士生：懂 Python 和深度学习，不懂胰腺囊性肿瘤。
| 位置 | 内容 | 维护方式 |
|---|---|---|
explanation/ |
系统由哪些环节组成、各环节的输入输出、为什么这样分。从 结构.md 读起 |
常青：改了就重写那一段 |
design/ |
每次重要决策的来历，文件名 NNNN-简短主题.md |
写完冻结；决策变了新写一份并注明取代关系 |
guides/ |
怎么做某件事：建环境、跑某个环节 | 常青，随实际情况更新 |
reference/ |
查得到的外部事实：术语表、算法参数的原始口径、临床方给的字段定义。每条自带出处；抄自 Linear 的写明抄自哪份、哪天同步 | 常青，随出处更新 |
待定问题/ |
还没定、迟早要定的问题，一个问题一份文件：问题、为什么要紧、选项、倾向、等谁定 | 定了就删掉，结论写进 design/，同一个提交 |
任务书/ |
每个模块动手前的任务书，文件名 NN-模块名.md：要做什么、依据哪些文档、怎么验收 |
负责人确认后交执行者；要改就在开头写「这一版改了什么」 |
survey/ |
文献调研：同类工作怎么做、对我们意味着什么，引文带 PDF 页码（PDF 在根目录 reference-pdf/，不进 git） |
写完冻结；有新调研另写一份 |
results/ |
实验结果报告，每个数字标明来自哪次运行（runs/ 下的目录名） |
写完冻结 |
scratch/ |
讨论中的草稿、上下文压缩前的快照 | 由负责人清理，Agent 不删 |
几类文档的开头
不用 YAML 头，靠固定的开头段落：
- design：
# NNNN 标题→状态：负责人 YYYY-MM-DD 认可（「原话」） ｜ 日期：…→ 取代了谁就写一行> 取代 NNNN 的第 X 条→## 先认识几个词→## 背景→## 决定（编号条目，写明哪条是负责人定的、哪条是 Agent 提的） → 需要时加## 不做的事。 - 任务书：标题 → 一段目的 →
来源：（负责人原话） →## 先认识几个词→## 开工前先读→ 分阶段的工作内容（每阶段写收尾点） →## 测试→## 规模→## 审阅→## 报告（分开写已验证的事实、推断和未验证的部分，附运行目录、提交号、花费）。 - results：
日期 ｜ 对应结构.md 第七部分第 N 步 ｜ 原始记录：runs/…→## 先认识几个词→## 一 跑了什么→ 结果，每个数字带运行目录。