65 lines
2.6 KiB
Markdown
65 lines
2.6 KiB
Markdown
# 实现方案-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`。
|
|
- 验证本机和公网入口。
|