Head_CT_Morph/工程分析/实现方案-2026-05-03-22-02-15.md

实现方案

开始时间：2026-05-03-22-02-15

本次方案路径

工程分析/实现方案-2026-05-03-22-02-15.md

实现目标

将硬边界、高斯平滑预览图中的黄色分界线由形变后的 Y 字视觉改为单条线，同时不改变真实 DICOM 形变输出。

涉及文件

• head_extension_app.py
• web_backend.py，视调用兼容性决定是否需要小幅调整
• 工程分析/经验记录.md

执行步骤

1. 在 head_extension_app.py 中保留现有 draw_cutoff_line，用于原始图水平分界线。
2. 新增或调整一个预览线绘制辅助函数，用于在已经完成形变的预览图上叠加单条黄色线。
3. 修改快速预览生成逻辑：
   • 原始图：仍按现有方式绘制水平分界线。
   • 硬边界、高斯平滑：先对无黄线 CT 图执行 preview_deform_2d，再叠加单条斜向黄色分界线。
   • 软过渡：保持现有视觉为单线；如实现上更简洁，可改为同一套“形变后叠线”的方式，但不得重新出现 Y 字。
4. 修改四状态过程预览生成逻辑，保证导出的 process_comparison_4states.png 和 process_screenshots/hard_boundary.png、process_screenshots/gaussian_smooth.png 中也是单条分界线。
5. 检查桌面预览入口是否复用同一逻辑，避免网页和桌面行为不一致。
6. 执行测试方案中的检查。
7. 修改完成后，将关键问题和解决方案追加到 工程分析/经验记录.md。
8. 提交并推送 Gitea 备份，commit 信息使用 2026-05-03-22-02-15 调整预览分界线绘制。
9. 重新部署后端和前端服务到 http://192.168.3.11:3005/。

预期实现细节

• 避免把带黄线的图片传入硬边界/高斯平滑的 preview_deform_2d。
• 将黄线作为预览标注层绘制在形变结果上，使标注层不再被硬边界形变撕裂。
• 单条线的位置以当前分界线高度和旋转角度估算，保持和原有预览语义一致。

回滚思路

如效果不符合预期，可回滚本次对 head_extension_app.py 或 web_backend.py 的修改，恢复“先画线再形变”的旧逻辑；文档记录保留问题原因和回滚说明。

风险控制

• 不触碰 run_deformation 的真实 3D 形变字段生成逻辑。
• 不修改前端交互状态和接口参数，降低联动风险。
• 测试时覆盖快速预览接口、四状态过程图、前端类型检查和构建。

人工审核状态

待用户二次人工审核确认。未经确认不得修改业务代码。