54 lines
1.9 KiB
Markdown
54 lines
1.9 KiB
Markdown
# 实现方案-2026-05-24-20-06-08
|
||
|
||
## 实现方案文档路径
|
||
|
||
`工程分析/实现方案-2026-05-24-20-06-08.md`
|
||
|
||
## 修改目标
|
||
|
||
- 修复隐藏 `liver_artery` 后 `liver_segment_S2/S3` 不显示或位置错乱的问题。
|
||
- 保证可见构件 preview 结果按 `fileName` 稳定关联，而不是依赖异步数组顺序。
|
||
- 同步工程经验和 Docker 部署说明。
|
||
|
||
## 涉及路径
|
||
|
||
- `WebSite/src/components/ReverseWorkspace.tsx`
|
||
- `Docker部署/README.md`
|
||
- `工程分析/经验记录.md`
|
||
|
||
## 技术路线
|
||
|
||
- 定位 `visibleOverlayModules`、`overlayModelPreviews`、`VoxelizationMappingView` 的数据流。
|
||
- 检查构件切换时 preview 加载是否按索引、请求完成顺序或旧缓存组合。
|
||
- 若存在错配，改为用 `fileName` 做稳定 key，将 preview 结果保存在 map 中，再按当前可见构件列表重组。
|
||
- 保留加载进度条和旧请求丢弃机制，避免旧异步结果覆盖新状态。
|
||
|
||
## 执行步骤
|
||
|
||
1. 搜索逆向映射视图和构件 preview 加载逻辑。
|
||
2. 定位并修正可见构件与 STL preview 的关联方式。
|
||
3. 视情况补充小型纯函数或 key 映射，减少索引错配风险。
|
||
4. 更新 Docker 部署说明和经验记录。
|
||
5. 运行类型检查、构建和关键搜索。
|
||
6. 重新部署并验证本机与公网入口。
|
||
7. 提交并推送到 Gitea。
|
||
|
||
## 兼容性与回滚方案
|
||
|
||
- 不改变 API 契约和项目状态字段。
|
||
- 若修正引入显示异常，可回滚本次 commit 恢复旧数组加载方式。
|
||
- 旧缓存仍可继续使用，但必须通过 `fileName` 命中。
|
||
|
||
## 预计文件变更
|
||
|
||
- 1 个前端组件文件。
|
||
- 1 个 Docker 部署说明文件。
|
||
- 3 个工程分析当次文档。
|
||
- 1 个经验记录追加。
|
||
|
||
## 提交与部署策略
|
||
|
||
- Commit message 使用 `2026-05-24-20-06-08 修正可见构件映射错位`。
|
||
- 构建通过后重启 `tmux` 会话 `revoxelseg-dicom`。
|
||
- 验证本机和公网入口。
|