2026-05-25-00-07-30 优化自动匹配对比视图与采样设置

工程分析/实现方案-2026-05-25-00-07-30.md

@@ -0,0 +1,64 @@
+# 实现方案-2026-05-25-00-07-30
+
+## 实现方案文档路径
+
+`工程分析/实现方案-2026-05-25-00-07-30.md`
+
+## 修改目标
+
+- 移除自动匹配页候选轨迹表格和低价值统计卡片。
+- 在“匹配结果”下方新增双栏 DICOM/STL 映射对比视图。
+- 同一个切片滑条同时控制两个视图。
+- 显示模式支持“所选骨骼区域”和“得分可视化”。
+- 骨骼区域默认空选。
+- 采样切片改为数量输入，按数量均匀筛选。
+- 调整默认权重：非骨区域惩罚 0.1、移动惩罚 0、缩放惩罚 0。
+- 为大 STL preview JSON 响应增加 gzip 发送，缓解 HTTP/2 大响应错误。
+
+## 涉及路径
+
+- `WebSite/src/components/AutoMatchWorkspace.tsx`
+- `WebSite/src/components/ReverseWorkspace.tsx`
+- `WebSite/server.ts`
+- `WebSite/src/types.ts`
+- `Docker部署/README.md`
+- `工程分析/经验记录.md`
+
+## 技术路线
+
+- 从 `ReverseWorkspace.tsx` 导出 `VoxelizationMappingView`，在自动匹配页复用。
+- 自动匹配页维护 `previewSlice` 和 `mappingMode` 状态，双视图传入同一个切片。
+- 为对比视图构造仅包含选中骨骼构件的 `moduleStyles`。
+- 采样切片数量通过 `buildUniformSampleSlices(total, count)` 生成 0-based 数组。
+- 自动匹配页不再显示候选轨迹表，保留关键位姿差值和操作按钮。
+- 后端新增 JSON gzip helper，`/models/:fileName/preview` 使用该 helper 返回大 preview。
+
+## 执行步骤
+
+1. 查看 `VoxelizationMappingView` 当前导出和 props。
+2. 修改自动匹配页面布局、状态和默认值。
+3. 修改采样切片生成逻辑与接口入参。
+4. 修改 STL preview 路由的大 JSON 发送方式。
+5. 执行 `npm run lint`、`npm run build`。
+6. 重启服务并验证健康检查与 preview 请求。
+7. 提交并推送 Gitea。
+
+## 兼容性与回滚方案
+
+- 自动匹配接口保留原 `sampleSlices` 字段，前端只是从数量生成。
+- 预览 gzip helper 只在客户端声明支持 gzip 时启用，不支持时仍走普通 JSON。
+- 若双视图性能不理想，可降低显示级别或只在有选中骨骼时加载。
+
+## 预计文件变更
+
+- 2 个前端组件。
+- 1 个后端服务文件。
+- 1 个类型文件。
+- 1 个 Docker 说明。
+- 工程分析三件套和经验记录。
+
+## 提交与部署策略
+
+- Commit message 使用 `2026-05-25-00-07-30 优化自动匹配对比视图与采样设置`。
+- 构建通过后重启 `tmux` 会话 `revoxelseg-dicom`。
+- 验证本机和公网入口。