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