2026-05-20-23-28-51 项目库映射交互与导入提示优化

.gitattributes

@@ -0,0 +1,2 @@
+*.dcm binary
+*.stl binary

.gitignore

@@ -23,10 +23,6 @@ yarn-debug.log*
 yarn-error.log*
 pnpm-debug.log*
 
-# Medical/source data assets are excluded from document backup commits by default.
-Head_CT_DICOM/
-Head_CT_ReConstruct/
-
 # OS/editor noise
 .DS_Store
 Thumbs.db

Agent.md

@@ -0,0 +1,18 @@
+# ReVoxelSeg DICOM 系统使用方式
+
+## 入口与登录
+
+启动项目后访问系统首页，使用管理员账号进入工作台。左侧导航包含总体概况、项目库、逆向工作区和系统管理。日常工作建议先进入项目库确认当前项目、DICOM 数量、STL 构件数量和分割结果状态，再进入逆向工作区进行位姿调整、切片校验和结果保存。
+
+## 主要功能
+
+ReVoxelSeg DICOM 是一个围绕 DICOM 影像、STL 三维重建模型与医学分割 Label Map 生成的逆向体素化工作系统。项目库用于集中管理病例项目，可查看 DICOM 原始切片、切换横断面/矢状面/冠状面浏览方式，调整窗宽窗位预设，并预览 STL 构件层级。构件层级支持颜色、透明度、显示隐藏状态和分割 ID 设置，这些设置会同步影响逆向工作区的三维融合视图、二维映射视图和最终导出的分割影像。逆向工作区提供三栏协同校验：左侧为影像与模型融合视角，用于观察 DICOM 体数据与 STL 模型在同一物理坐标系下的空间关系；中间为可视化工具栏，可调整模型显示精度、DICOM 透明度、切片范围、构件层级以及模型位姿；右侧为逆向分割映射视图，在 DICOM 原始切片上叠加由 STL 网格平面求交和实体填充生成的 Overlay Label Map。系统默认使用 `head-ct-demo-pose-data.json` 中记录的最佳位姿，用户仍可通过旋转、平移、缩放输入框进行精细调整，并可导入或保存位姿。右侧 Slice Navigator 支持逐层检查当前 Z 轴切片中模型边界和分割实体区域，只显示当前切片实际出现的构件提示，便于快速判断每一层的分割质量。完成校验后，可点击“保存至项目库”将当前位姿、构件样式和分割范围保存为项目库中的分割结果。导出功能支持将 DICOM 原始影像、分割 NIfTI、位姿 JSON、labels JSON 和 STL 原始模型打包为 `.tar.gz`，方便在 ITK-SNAP 等工具中复核，也方便把同一批数据交付给算法工程师或临床医生继续分析。
+
+## 推荐流程
+
+1. 在项目库选择 `头部 CT 模型逆向体素化演示`。
+2. 进入逆向工作区，确认默认加载的是 `最佳位姿`。
+3. 在可视化工具栏调整构件颜色、透明度和显隐状态。
+4. 使用右侧 Slice Navigator 逐层检查 Overlay Label Map。
+5. 点击 `保存至项目库`，回到项目库的 `分割结果` 区域复核。
+6. 点击 `导出全部 NII.GZ`，按需要选择 DICOM、分割影像、位姿数据和 STL 原始模型。