2026-05-24-15-37-16 修正mask线条桥接与DICOM复位入口

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

@@ -0,0 +1,58 @@
+# 实现方案-2026-05-24-15-37-16
+
+## 实现方案文档路径
+
+`工程分析/实现方案-2026-05-24-15-37-16.md`
+
+## 修改目标
+
+- 将项目库 DICOM 影像位置重置按钮移动/补充到左转、右转按钮组旁。
+- 对前端逆向分割映射的切面线段进行连通分组，避免不同组件或孤立碎片被同一行扫描线错误配对。
+- 对服务端导出 Label Map 使用同样的连通分组策略，减少不规则相连线。
+- 增加小缝隙闭合处理，缓解实体区域内部横向黑线。
+- 保留对开口/非流形模型的保守说明。
+
+## 涉及路径
+
+- `WebSite/src/components/ProjectLibrary.tsx`
+- `WebSite/src/components/ReverseWorkspace.tsx`
+- `WebSite/server.ts`
+- `工程分析/需求分析-2026-05-24-15-37-16.md`
+- `工程分析/实现方案-2026-05-24-15-37-16.md`
+- `工程分析/测试方案-2026-05-24-15-37-16.md`
+- `工程分析/经验记录.md`
+
+## 技术路线
+
+1. 项目库 DICOM 画布由父组件下发 reset token，让外部按钮触发内部 viewport 复位。
+2. 前端 overlay 按切面线段端点近邻关系分组，每个连通组独立扫描线填充。
+3. 对每个连通组的 mask 做小 gap closing，再做内部孔洞填充。
+4. 服务端 NIfTI 生成路径复用同样的分组、逐组填充、gap closing 和兜底逻辑。
+5. 对孤立或开口线段组件减少跨组件配对，避免导出长线桥接。
+
+## 执行步骤
+
+1. 创建当次三件套。
+2. 再次确认已读 `工程分析/经验记录.md`。
+3. 修改项目库 DICOM 控件。
+4. 修改前端 overlay 填充算法。
+5. 修改服务端导出算法。
+6. 执行 `npm run lint` 和 `npm run build`。
+7. 重新部署并验证本机、公网、导出包。
+8. 追加经验记录，提交并推送。
+
+## 兼容性与回滚方案
+
+- UI reset token 只影响 DICOM 预览视窗状态，不改变 DICOM 数据。
+- 连通分组只改变轮廓填充方式，不改变项目状态结构。
+- 若新填充策略过度保守，可回滚到上一提交 `f279770` 的扫描线逻辑。
+
+## 预计文件变更
+
+- 前端组件和后端导出逻辑。
+- 本次工程分析文档和经验记录。
+
+## 提交与部署策略
+
+- commit message：`2026-05-24-15-37-16 修正mask线条桥接与DICOM复位入口`
+- 部署沿用 `tmux` 会话 `revoxelseg-dicom`，生产模式端口 `4000`。

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

@@ -0,0 +1,47 @@
+# 测试方案-2026-05-24-15-37-16
+
+## 测试方案文档路径
+
+`工程分析/测试方案-2026-05-24-15-37-16.md`
+
+## 静态检查
+
+- `git status --short --branch`
+- `git diff --check`
+- `rg` 检查连通分组、gap closing 和 DICOM reset token 的使用点。
+
+## 构建检查
+
+- `cd WebSite && npm run lint`
+- `cd WebSite && npm run build`
+
+## 关键业务场景验证
+
+- 项目库 DICOM 影像左转、右转旁可见位置重置按钮。
+- DICOM 影像滚轮缩放、拖拽平移后，外部位置重置可恢复默认视图。
+- 逆向分割映射中不同断开的线段不再被大范围水平桥接。
+- 导出的 `separate` Label Map 文件仍位于 `segmentation-parts/`。
+
+## 医学影像数据相关边界验证
+
+- 默认项目仍可导出分割包。
+- 中文长路径 tar 包仍可完整列出。
+- 源 STL 开口或非流形时，程序减少错误桥接，但最终说明不承诺能完全恢复真实实体。
+
+## 部署验证
+
+- 重启 `tmux` 会话 `revoxelseg-dicom`。
+- 验证 `http://127.0.0.1:4000/api/health`。
+- 验证 `https://revoxel.huijutec.cn/api/health`。
+- 验证 `https://revoxel.huijutec.cn/`。
+
+## Git/Gitea 备份验证
+
+- commit message 包含 `2026-05-24-15-37-16`。
+- 推送后 `main` 与 `origin/main` 同步。
+
+## 风险与回归关注点
+
+- 连通分组阈值过大可能连接近邻独立结构，过小则闭合轮廓被拆散。
+- gap closing 不能跨大距离连接不同器官或构件。
+- DICOM reset token 不应导致每次切片变化都自动复位用户视图。

工程分析/经验记录.md

@@ -1675,3 +1675,21 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 凡是新增位姿字段，必须同时检查前端类型、默认状态、保存/导入、三维渲染、二维映射、服务端归一化、导出坐标变换和项目库回放，不能只改一个界面。涉及 DICOM 层号时要明确区分“数组索引”和“对用户显示的医学层号”。导出压缩包如果包含中文或深层路径，必须用 `tar -tzf` 验证路径完整，不要依赖 100 字节 tar name 字段。分割显示的视觉修正也应同步确认导出数据路径，避免 UI 看似实体而 NIfTI 仍是轮廓。
+
+## 2026-05-24-15-37-16 STL 切面填充不能跨断开轮廓全局配对
+
+A. 具体问题
+
+用户反馈逆向分割映射视图中仍有 mask 呈线条状，导出的 `label.nii` 里 `liver_artery` 等构件出现不规则相连长线和内部黑色线条。项目库 DICOM 影像的“位置重置”也需要放到左转、右转同一工具组，减少查找成本。
+
+B. 产生问题原因
+
+检查 `project-mpea0n3e-akbpn` 的 `liver_artery.stl`，其二进制 STL 约 220920 个三角面、331119 条量化边，其中边界边为 0，非流形边约 27 条，占 0.008%，说明它不是大面积开口模型。主要问题来自旧体素化逻辑：同一切片上把全部相交线段按扫描行收集后全局排序并两两配对。如果同一行存在多个断开的轮廓、孤立碎片或少量非流形小片，就会把不同连通区域的交点配成一条长桥；内部横向黑线则来自相邻扫描行之间的 1-2 像素细缝没有闭合。
+
+C. 解决问题方案
+
+前端 overlay 与服务端 NIfTI 导出均改为先按线段端点近邻关系做连通分组，每个连通组独立扫描线填充和闭合外轮廓兜底，避免跨断开轮廓配对。对已生成的二值 mask 增加小缝隙闭合，再执行内部孔洞填充，用于减少实体区域内部横向黑线。项目库 DICOM 画布增加外部 reset token，把“位置重置”按钮放到左转、右转旁边，直接复位缩放和平移。
+
+D. 后续如何避免问题
+
+后续做 STL 到 Label Map 的切面填充时，不能只按全局行交点两两配对，必须先按轮廓连通性分组。遇到长线桥接，应同时检查源 STL 的边界边/非流形边和体素化配对策略；如果 STL 是真实中心线或开口片面，只能近似显示，不能承诺恢复真实医学实体。每次修改导出算法后，至少用包含中文构件名和复杂肝脏血管的项目执行一次 `separate + all` 导出，并用 `tar -tzf` 验证文件完整。

工程分析/需求分析-2026-05-24-15-37-16.md

@@ -0,0 +1,48 @@
+# 需求分析-2026-05-24-15-37-16
+
+## 开始时间
+
+2026-05-24-15-37-16
+
+## 原始需求摘要
+
+- 在项目库 DICOM 影像的左转、右转按钮旁增加位置重置按钮。
+- 检查逆向工作区的逆向分割映射视图中部分 mask 仍呈线条状的原因，并继续修正。
+- 检查导出的 `label.nii` 中不规则相连、内部黑线等问题，判断是模型原因还是体素化逻辑原因，并修正可控问题。
+
+## 业务目标
+
+- DICOM 预览操作入口更直接，旋转与位置复位放在同一工具组。
+- 分割映射显示尽量呈现实体区域，减少横向线条、错误桥接和内部空线。
+- 导出的 NIfTI Label Map 与前端显示逻辑保持一致，避免分离构件之间被扫描线错误连接。
+
+## 输入与输出
+
+- 输入：当前项目库与逆向工作区的 DICOM/STL 数据、用户提供的截图、导出的 Label Map 表现。
+- 输出：前端交互修正、前后端体素化/映射填充修正、原因说明、构建部署验证、Git/Gitea 提交。
+
+## 影响范围
+
+- `WebSite/src/components/ProjectLibrary.tsx`
+- `WebSite/src/components/ReverseWorkspace.tsx`
+- `WebSite/server.ts`
+- `工程分析/经验记录.md`
+- 本次三件套文档
+
+## 关键约束
+
+- 必须执行 `工程分析/代码编纂工作流.md`。
+- 修改后重新构建、部署并验证 `https://revoxel.huijutec.cn/`。
+- 不能把运行态导出文件、医学数据或无关变化混入提交。
+- 对医学影像结果表述要保守，区分模型源数据问题和程序可修正的体素化问题。
+
+## 风险点
+
+- 如果源 STL 是开口面、非流形、中心线或带孤立碎片，无法严格恢复真实实体，只能做显示/导出层面的稳健化处理。
+- 过度填充可能把本不相连的构件误连，影响 Label Map 后处理。
+- 过滤线条伪影不能误删真实细小血管或小构件。
+
+## 默认假设
+
+- 用户希望优先减少错误线条桥接和内部黑线，而不是保留所有开口 STL 的线状截面。
+- 对于无法闭合的开口轮廓，可在最终说明中明确源模型质量对结果的影响。