# 需求分析-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 骨性构件投影点附近的骨窗响应作为奖励。
- 第一版内部使用多候选并发评分的坐标搜索，而不是引入外部优化库。