# 实现方案-2026-05-24-22-40-13

## 实现方案文档路径

`工程分析/实现方案-2026-05-24-22-40-13.md`

## 修改目标

- 新增自动微调匹配工作区和逆向工作区入口按钮。
- 新增后端自动微调匹配接口，固定旋转，只优化允许的平移和缩放。
- 实现骨窗/骨骼构件匹配的首版可解释评分。
- 支持将最佳结果应用回项目位姿。

## 涉及路径

- `WebSite/src/App.tsx`
- `WebSite/src/components/Sidebar.tsx`
- `WebSite/src/components/ReverseWorkspace.tsx`
- `WebSite/src/components/AutoMatchWorkspace.tsx`
- `WebSite/src/lib/api.ts`
- `WebSite/src/types.ts`
- `WebSite/server.ts`
- `Docker部署/README.md`
- `工程分析/经验记录.md`

## 技术路线

- 路由层新增 `auto-match` 视图，左侧导航新增图标入口。
- 逆向工作区保存按钮左侧增加“自动微调匹配”，点击进入自动匹配页面并携带当前项目 ID。
- 后端新增 `POST /api/projects/:projectId/auto-match`，接收位姿、构件、参数开关和迭代设置，返回最佳 pose 与轨迹。
- 后端新增 `PATCH /api/projects/:projectId/model-pose`，用于应用最佳 pose 到项目库。
- 评分函数采用：骨窗命中奖励、离骨惩罚、移动惩罚、缩放偏移惩罚；多切片抽样并对骨骼 STL 顶点/三角采样投影评分。
- 优化策略采用多模式坐标搜索：粗到细步长，逐轮生成候选，允许每轮只改一个参数或组合改多个参数，选择最高分收敛。

## 执行步骤

1. 阅读现有 App、Sidebar、ReverseWorkspace、api、server 类型与项目状态逻辑。
2. 新增 API 类型与后端自动匹配/位姿应用接口。
3. 新增 AutoMatchWorkspace 页面，提供项目选择、参数开关、构件选择、权重和运行结果。
4. 在逆向工作区顶部接入入口按钮。
5. 更新 Docker 文档和经验记录。
6. 执行类型检查、构建和接口 smoke test。
7. 重启服务并验证本机与公网入口。
8. 提交并推送到 Gitea。

## 兼容性与回滚方案

- 不改变原有保存项目和导出结果接口。
- 自动匹配结果只有点击应用后才写入项目位姿。
- 若评分效果不理想，可回滚本次 commit 或替换后端评分函数。

## 预计文件变更

- 4-5 个前端源码文件。
- 1 个后端服务文件。
- 1 个 Docker 部署说明文件。
- 3 个工程分析当次文档。
- 1 个经验记录追加。

## 提交与部署策略

- Commit message 使用 `2026-05-24-22-40-13 新增自动微调匹配工作区`。
- 构建通过后重启 `tmux` 会话 `revoxelseg-dicom`。
- 验证本机和公网入口。