# 实现方案-2026-05-20-01-38-33

## 实现方案文档路径

`工程分析/实现方案-2026-05-20-01-38-33.md`

## 修改目标

完善逆向工作区导出与位姿持久化：移除自动配准演示入口，新增可选导出 DICOM NIfTI、分割 NIfTI 和位姿 JSON，修复 blob 下载警告，增加三维坐标轴示意，并让保存位姿跨项目进入持久保留。

## 涉及路径

- `WebSite/server.ts`
- `WebSite/src/lib/api.ts`
- `WebSite/src/types.ts`
- `WebSite/src/components/ReverseWorkspace.tsx`
- `工程分析/需求分析-2026-05-20-01-38-33.md`
- `工程分析/实现方案-2026-05-20-01-38-33.md`
- `工程分析/测试方案-2026-05-20-01-38-33.md`
- `工程分析/经验记录.md`

## 技术路线

1. 后端扩展项目状态：
   - 增加 `modelPoses` 字段，保存默认、俯视、侧视与用户自定义位姿。
   - 新增 `PATCH /api/projects/:projectId/model-poses`。
2. 后端重写导出：
   - 新增通用 NIfTI-1 写入函数。
   - DICOM 原始影像导出为 int16 HU `.nii.gz`，维度与 spacing 来自 DICOM。
   - 分割影像导出为 STL 构件采样切面填充后的 uint8 label map `.nii.gz`，维度与 spacing 与 DICOM 完全一致。
   - 位姿数据导出为 JSON，并记录导出时的当前 activePose。
   - 保留 `/export-mask` 兼容旧分割导出。
3. 前端下载方式：
   - 用直链 `<a href>` 下载替代 `fetch -> Blob -> URL.createObjectURL`。
   - 新增导出选项复选框和“导出所选”动作，分割和位姿导出会携带当前模型位姿。
4. UI 调整：
   - 去掉“开始自动配准”按钮和相关演示进度状态。
   - 顶部按钮改为“导出全部 NII.GZ”。
   - 三维融合视角右下角增加固定 XYZ 坐标轴示意。
5. 位姿持久化：
   - 项目加载时读取 `project.modelPoses`。
   - 保存/重命名位姿时写回后端。

## 执行步骤

- 更新类型定义和后端状态归一化。
- 实现 NIfTI/位姿导出接口。
- 更新前端 API 下载方法。
- 更新 ReverseWorkspace UI、导出选项、位姿保存逻辑和坐标轴。
- 执行 `npm run lint` 与 `npm run build`。
- 验证新导出接口返回文件，重新部署并推送。

## 兼容性与回滚方案

- 旧 `downloadMask` 与 `/export-mask` 保持可用，只把底层分割 NIfTI 改为同维度数据。
- 如果完整 DICOM NIfTI 导出耗时过高，可后续增加范围导出或后台任务。
- 如果浏览器仍对 HTTP 下载提示安全警告，需要部署 HTTPS；本次先消除 blob URL 警告来源。

## 预计文件变更

- `server.ts`：项目位姿字段、DICOM NIfTI 导出、STL Label Map 导出、位姿导出、兼容旧导出。
- `api.ts`：直链下载和导出选项 API。
- `types.ts`：项目位姿类型。
- `ReverseWorkspace.tsx`：移除自动配准、导出选项、坐标轴、位姿持久化。
- 新增本次三份工程文档，更新经验记录。

## 提交与部署策略

- 提交信息：`2026-05-20-01-38-33 完善NII导出与位姿持久化`
- 显式暂存本次相关文件，避免提交历史删除状态。
- 推送到 Gitea `origin/main` 并重新部署。