2026-05-20-11-51-05 默认医学数据入库

工程分析/经验记录.md

@@ -1189,3 +1189,21 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 凡是为含三维场景的页面生成截图或录屏，都应优先验证截图不是空白，并检查浏览器控制台是否有 WebGL 创建失败信息。自动化截图应准备软件渲染兜底；Word 交付前必须用 `unzip -l` 检查 `word/media/` 是否包含预期图片。
+
+## 2026-05-20-11-51-05 默认医学数据资产入库需要明确体积与二进制属性
+
+A. 具体问题
+
+默认项目依赖 `Head_CT_DICOM/` 和 `Head_CT_ReConstruct/`，但两个目录原先被 `.gitignore` 排除。新环境只克隆代码时无法直接加载默认演示项目，需要额外复制医学数据资产。
+
+B. 产生问题原因
+
+早期工作流把 DICOM/STL 视为不进入普通文档备份的大型医学源数据，避免无意提交；但当前用户明确要求把默认项目数据作为仓库交付资产，以支持新环境开箱构建。
+
+C. 解决问题方案
+
+移除 `.gitignore` 中对 `Head_CT_DICOM/` 和 `Head_CT_ReConstruct/` 的忽略规则，新增 `.gitattributes` 将 `*.dcm` 和 `*.stl` 标记为 binary。提交前统计数据体积和文件数，验证默认项目接口仍返回 DICOM 300 张、STL 9 个构件。
+
+D. 后续如何避免问题
+
+默认演示数据和运行态输出要分开管理：默认项目资产可以入库，但导出文件、状态文件和用户临时数据仍应保持忽略。新增大体积医学数据前必须记录体积、文件数、脱敏/授权假设和远端推送结果；若体积继续增长，应评估 Git LFS 或独立数据包发布。