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

实现方案-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。
• 验证本机和公网入口。