REVOXELSEG_DICOM/工程分析/需求分析-2026-05-24-22-40-13.md

需求分析-2026-05-24-22-40-13

开始时间

2026-05-24-22-40-13

原始需求摘要

用户要求新增“自动微调匹配工作区”：左侧新增入口；逆向工作区“保存至项目库”左侧增加“自动微调匹配”按钮。用户会先在逆向工作区大致调整旋转，进入自动微调后选择允许修改的参数，默认平移 X/Y/Z 与缩放，不允许自动调整旋转；选择骨骼区域，使用 DICOM 骨窗作为匹配依据，自动迭代优化，可尝试多种模式并收敛到最佳位置。

业务目标

• 提供从逆向工作区进入自动微调匹配的工作流。
• 保留人工旋转作为前置步骤，自动优化只调整用户允许的平移和缩放参数。
• 以骨窗 DICOM 与骨性 STL 构件为初始匹配目标，形成可解释的评分、奖励项和惩罚项。
• 自动迭代输出最佳位姿，可应用回项目状态，供用户回到逆向工作区复核和保存。

输入与输出

• 输入：项目 ID、当前模型位姿、构件样式、允许调整参数、骨骼构件范围、迭代模式和惩罚权重。
• 输出：最佳位姿、评分变化、每轮候选结果、可应用到项目的位姿更新。

影响范围

• 前端导航与工作区路由。
• ReverseWorkspace 顶部操作入口。
• 新增 AutoMatchWorkspace 前端页面。
• WebSite/src/lib/api.ts API 封装与类型。
• WebSite/server.ts 自动微调匹配 API、位姿评分和项目位姿应用逻辑。
• Docker部署/README.md 和 工程分析/经验记录.md。

关键约束

• 自动匹配不能修改旋转，只能使用已有旋转作为前提。
• 默认只允许平移 X/Y/Z 与缩放，可由用户关闭某些参数。
• 不修改原始 DICOM/STL 数据，不伪装成临床级配准算法。
• 第一版以可解释、可复核、可继续替换真实算法为目标。

风险点

• 如果评分函数只看重合奖励，可能为了覆盖骨窗而过度平移或放大，需要移动惩罚和尺度惩罚。
• 如果只使用单切片评分，容易局部最优；需要多切片抽样。
• 如果迭代步长过大，可能跳过最佳点；步长过小会运行太慢。
• 运行时间不能阻塞页面太久，需要限制样本数量和候选数量。

待确认问题或默认假设

• 默认骨骼区域包含文件名含 rib、vertebrae、sternum、hipbone、sacrum 的 STL 构件。
• 默认使用 DICOM 骨窗阈值筛选高亮骨性像素，并以 STL 骨性构件投影点附近的骨窗响应作为奖励。
• 第一版内部使用多候选并发评分的坐标搜索，而不是引入外部优化库。