2026-05-24-16-28-58 修正可见构件导出与高精度映射

工程分析/实现方案-2026-05-24-16-28-58.md

@@ -0,0 +1,59 @@
+# 实现方案-2026-05-24-16-28-58
+
+## 实现方案文档路径
+
+`工程分析/实现方案-2026-05-24-16-28-58.md`
+
+## 修改目标
+
+- 重启并验证公网服务。
+- 修正 `visible` 导出范围被历史保存结果覆盖的问题。
+- 改进二维 overlay 和后端导出填充，减少实体区域内部条纹和薄结构线条感。
+
+## 涉及路径
+
+- `WebSite/server.ts`
+- `WebSite/src/components/ReverseWorkspace.tsx`
+- `WebSite/src/lib/api.ts`
+- `WebSite/src/components/ProjectLibrary.tsx`
+- `Docker部署/README.md`
+- `工程分析/经验记录.md`
+
+## 技术路线
+
+- 先使用 `tmux` 重启 `revoxelseg-dicom`，验证本机与公网入口。
+- 排查导出链路，确认 `projectWithSegmentationResultStyles`、`segmentationScope` 与当前 `moduleStyles.visible` 的优先级。
+- 导出时让当前项目样式覆盖历史分割结果样式，确保最新眼睛状态参与过滤。
+- 必要时在前端导出请求中显式传递当前 `moduleStyles`，后端读取并归一化，避免状态同步延迟。
+- 对填充后的 mask 做轻量闭合与孤立小孔修补，前端 overlay 与后端 NIfTI 保持一致策略。
+
+## 执行步骤
+
+1. 已重启服务并验证公网、本机 HTTP 200。
+2. 阅读当前导出和填充代码，定位可见构件过滤来源。
+3. 修正导出样式优先级或新增导出样式参数。
+4. 改进实体化填充策略，重点避免可见大块区域内部横向空线。
+5. 同步 Docker 文档和经验记录。
+6. 执行 `npm run lint`、`npm run build`。
+7. 用项目 `123` 执行可见类别分别导出，检查 tar 列表只包含可见构件。
+8. 重启部署，验证公网与本机。
+9. 提交并推送 Gitea。
+
+## 兼容性与回滚方案
+
+- 如果前端未传 `moduleStyles`，后端回退到项目当前样式与最新结果合并。
+- 如果实体化修补导致过度连接，可回滚到仅小缝闭合和按连通组填充。
+- 回滚时移除新增参数读取即可，不影响旧导出 API。
+
+## 预计文件变更
+
+- 新增本次三份工程分析文档。
+- 修改后端导出样式选择与 mask 修补。
+- 修改前端导出请求参数。
+- 修改 Docker 部署说明与经验记录。
+
+## 提交与部署策略
+
+- 只暂存本次相关源码、Docker 文档和工程分析文档。
+- Commit message 包含 `2026-05-24-16-28-58`。
+- 部署使用 `NODE_ENV=production npm run serve -- --host 0.0.0.0 --port 4000`。

工程分析/测试方案-2026-05-24-16-28-58.md

@@ -0,0 +1,57 @@
+# 测试方案-2026-05-24-16-28-58
+
+## 测试方案文档路径
+
+`工程分析/测试方案-2026-05-24-16-28-58.md`
+
+## 静态检查
+
+- 在 `WebSite/` 执行 `npm run lint`。
+
+## 构建检查
+
+- 在 `WebSite/` 执行 `npm run build`。
+
+## 关键业务场景验证
+
+- 公网 `https://revoxel.huijutec.cn/` 和 `/api/health` 可访问。
+- 只显示 `liver_artery`、`liver_right` 时，选择“可见类别 + 构件分别导出”，导出包 `segmentation-parts/` 只包含这两个构件。
+- 已隐藏构件不出现在 `segmentation-parts/` 目录中。
+- overlay 仍只统计当前可见构件。
+
+## 医学影像数据相关边界验证
+
+- `liver_artery` 作为细长血管结构允许保持窄形态，但不应由导出算法额外生成跨区域长线桥。
+- `liver_right` 大区域内部不应因为扫描线小缝形成大量空条纹。
+- 分割修补不应跨断开连通组全局连接。
+
+## 部署验证
+
+- 重启 `tmux` 会话 `revoxelseg-dicom`。
+- 验证 `http://127.0.0.1:4000/api/health`。
+- 验证 `http://127.0.0.1:4000/`。
+- 验证 `https://revoxel.huijutec.cn/api/health`。
+- 验证 `https://revoxel.huijutec.cn/`。
+
+## Git/Gitea 备份验证
+
+- `git status --short` 检查无关运行态文件未被暂存。
+- Commit message 包含 `2026-05-24-16-28-58`。
+- 推送到 `origin/main` 并确认本地远端同步。
+
+## 风险与回归关注点
+
+- 不把用户当前工作区可见状态误写死为全局默认。
+- 不让历史 `segmentationResults` 覆盖用户刚刚点击的眼睛状态。
+- 不把导出测试生成的 `.tar.gz`、`.nii.gz` 混入 Git。
+
+## 执行结果
+
+- 重启前后 `https://revoxel.huijutec.cn/` 与 `/api/health` 均返回 HTTP 200。
+- `npm run lint`：通过。
+- `npm run build`：通过；仅有 Vite chunk size 常规提示。
+- `liver_right.stl` 高精度预览验证：`triangleCount=297268`、`sampledTriangles=297268`。
+- `liver_artery.stl` 高精度预览验证：`triangleCount=220920`、`sampledTriangles=220920`。
+- 项目 `123` 可见类别分别导出验证通过：`segmentation-parts/` 仅包含 `004-liver_artery-label.nii.gz`、`006-liver_right-label.nii.gz` 和 labels.json，不再导出 `007/008/009`。
+- 本机 `http://127.0.0.1:4000/api/health`：HTTP 200。
+- 公网 `https://revoxel.huijutec.cn/api/health`：HTTP 200。

工程分析/经验记录.md

@@ -1711,3 +1711,21 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 凡是新增项目运行态数据，都要同时考虑后端状态归一化、前端类型、API、列表排序、Docker 持久化挂载和 `.gitignore`。锁定类快照属于运行态追溯数据，不应混入源码 commit。DICOM 切片控件要明确区分“数组索引”“用户显示层号”和“滑块位置”，不要用同一个变量同时表达三种语义。
+
+## 2026-05-24-16-28-58 导出可见类别必须以当前项目样式为准
+
+A. 具体问题
+
+用户只显示 `liver_artery` 和 `liver_right` 后，选择“可见类别 + 构件分别导出”，导出包中仍出现 `007-liver_segment_S1-label.nii.gz`、`008-liver_segment_S2-label.nii.gz`、`009-liver_segment_S3-label.nii.gz`。同时，逆向分割映射中 `liver_right` 大区域出现条纹和异常形状，`liver_artery` 仍显得像多条线。
+
+B. 产生问题原因
+
+项目当前 `moduleStyles` 中 `liver_artery`、`liver_right` 是可见，`S1/S2/S3` 是隐藏；但最新一次保存的 `segmentationResults` 中可见状态正好相反。旧导出逻辑使用历史保存结果的 `moduleStyles` 覆盖项目当前样式，导致“可见类别”按旧状态导出。二维 overlay 另一个问题是 STL 预览最多抽样 20 万三角面，而 `liver_right` 有约 29.7 万面、`liver_artery` 有约 22.1 万面，抽样会缺失一部分切面轮廓，表现为条纹或形状不完整。血管本身也属于细长管状结构，真实切面不会像肝叶一样形成单一大块。
+
+C. 解决问题方案
+
+导出时合并样式优先级改为：历史保存结果作为 fallback，项目当前 `moduleStyles` 覆盖历史结果，前端导出请求中传入的当前 `moduleStyles` 再覆盖后端状态。这样即使用户刚点击眼睛后立刻导出，也按当前可见状态过滤。逆向分割映射只加载当前可见构件，并把可见构件预览上限提高到 50 万三角面；`liver_right` 与 `liver_artery` 在项目 `123` 中均可全量取面。Docker 文档同步说明“可见类别 + 构件分别导出”严格只导出当前眼睛打开的构件。
+
+D. 后续如何避免问题
+
+凡是导出“当前可见”这类 UI 状态，不能只依赖历史保存结果；后端应以项目当前状态为准，前端最好显式携带本次导出的关键状态，防止异步保存延迟。二维 overlay 如果用于判断实体形状，必须确认 STL 预览不是抽样缺面；对超过预览上限的大模型，应按可见构件高精度加载或在界面提示。细血管、胆管等管状结构应解释为“天然多小截面/窄带”，不要把所有结构都承诺成单一大实体块。

工程分析/需求分析-2026-05-24-16-28-58.md

@@ -0,0 +1,47 @@
+# 需求分析-2026-05-24-16-28-58
+
+## 开始时间
+
+2026-05-24-16-28-58
+
+## 原始需求摘要
+
+1. 先重启程序，并确认 `https://revoxel.huijutec.cn/` 是否可访问。
+2. 解释并修正逆向工作区中 `liver_right` 显示形状异常、`liver_artery` 仍像多条线构成而非实体区域的问题。
+3. 修正导出：用户只显示 `liver_artery`、`liver_right` 时，`segmentation-parts/` 不应导出隐藏的 `liver_segment_S1/S2/S3`。
+
+## 业务目标
+
+- 保证公网服务恢复可访问。
+- 让二维分割映射和导出的 NIfTI 更贴近“实体区域”预期，减少条纹感和异常桥接。
+- 让“可见类别 + 构件分别导出”严格只导出当前可见构件，便于后处理。
+
+## 输入与输出
+
+- 输入：项目当前构件可见状态、模型位姿、导出选项、DICOM 切片。
+- 输出：公网可访问服务、修正后的 overlay 显示、只包含可见构件的 `segmentation-parts/` 导出包。
+
+## 影响范围
+
+- 前端：逆向工作区 overlay 显示、导出参数传递。
+- 后端：项目导出时构件样式来源、`visible` 范围过滤、STL 切面填充策略。
+- 文档：`Docker部署/` 和 `工程分析/经验记录.md`。
+
+## 关键约束
+
+- 不伪造临床级分割能力；真实显示仍受 STL 几何、模型位姿和体素化精度影响。
+- 当前可见性必须以用户最新 UI 操作后的 `project.moduleStyles` 为准，不能被历史 `segmentationResults` 覆盖。
+- 修正实体填充不能重新引入跨断开轮廓长桥。
+- 运行态导出文件、锁定结果和医学数据不混入提交。
+
+## 风险点
+
+- `liver_artery` 是细长血管结构，真实几何可能天然呈细线/窄带，过度膨胀会改变语义。
+- `liver_right` 若受当前位姿、镜像或切片位置影响，二维切面可能只截到局部区域，需要区分显示算法问题和配准位置问题。
+- 导出包验证需要确认 tar 内文件名，而不只是前端菜单状态。
+
+## 默认假设
+
+- 用户选择“可见类别”时，期望导出当前眼睛打开的构件。
+- “构件分别导出”仍应把所有导出的可见构件放入同一个 `segmentation-parts/` 目录。
+- 对血管等细结构允许轻量实体化增厚，但不做大半径形态学膨胀。