2026-05-21-10-05-51 更新软著材料工程记录

工程分析/经验记录.md

@@ -1477,3 +1477,21 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 凡是涉及 STL 与 DICOM 尺度自动匹配的逻辑，都必须明确使用“全局包围盒”还是“可见构件包围盒”，并与实际渲染组件保持一致。单轴等比例贴合要考虑其他轴的视场约束，短轴贴合不能无限放大长轴；位姿数值控件的步长、显示精度、内部取整和导出数据要同步设计，避免 UI 看起来精细但实际状态漂移。
+
+## 2026-05-21-10-05-51 软著材料更新要同步源码、截图、Word 与素材清单
+
+A. 具体问题
+
+用户要求继续更新 `新撰写软著文档/` 中的所有软著材料，并重新拍摄说明书图片。此前说明书、登记表、代码汇总和视频素材已经存在，但最新功能变更包括自动拉伸 DICOM 体范围约束、缩放三位小数、0.005 级微调等内容，若只更新文字或只更新截图，软著材料会与当前系统不一致。
+
+B. 产生问题原因
+
+软著材料由 Markdown、Word、图片、视频、代码汇总和素材清单组成，属于多文件联动交付。截图需要真实页面状态，代码汇总需要从当前源码重新生成，Word 又依赖 Markdown 和图片引用；任何一个环节未同步，都会出现说明书图片旧、代码摘录旧、Word 未嵌图或素材清单时间不一致的问题。
+
+C. 解决问题方案
+
+按 `※撰写Agent.md` 流程复查说明书、登记表、代码汇总和素材清单。使用 Chrome Headless + SwiftShader + DevTools 视口强制 1680x1050 重拍 23 张章节截图，避免 WebGL 截图为空。说明书补充自动拉伸、DICOM 体范围约束、三位小数缩放和 0.005 微调说明；登记表同步最新功能；代码汇总从当前核心源码重新生成；视频用最新章节截图重新生成 MP4；再用图片引用检查、docx 解压、Word 图片数量、代码行数、视频参数和项目构建做验证。
+
+D. 后续如何避免问题
+
+后续只要系统功能发生变化并要求更新软著材料，应同时更新 Markdown 正文、截图、Word、代码汇总、视频脚本和素材清单，不能只改其中一项。截图自动化必须固定视口并校验图片尺寸、非空像素和引用数量；代码汇总应从当前源码机械生成或明确摘录范围；软著目录按用户要求不提交 Gitea，只提交工程分析记录。