# 实现方案：合并 Docker 三版本 Gitea Release

实现方案文档路径：`工程分析/实现方案-2026-05-21-14-35-20.md`

## 修改目标

将 Gitea 上三个 Docker 部署 Release 合并为一个整合 Release，并在该 Release 中挂载三个命名清晰的部署附件。

## 涉及路径

- `/home/wkmgc/Desktop/ReVoxelSeg_DICOM_Docker`
- `工程分析/需求分析-2026-05-21-14-35-20.md`
- `工程分析/实现方案-2026-05-21-14-35-20.md`
- `工程分析/测试方案-2026-05-21-14-35-20.md`
- `工程分析/经验记录.md`

## 技术路线

1. 使用独立 Docker 仓库中已有三个 release tag，通过 `git archive` 生成三个部署压缩包。
2. 对通用版 tag 做固定环境信息搜索，确认没有泄露当前 FRPC 与域名配置。
3. 创建整合 tag `revoxelseg-docker-all-v2026.05.21` 并推送到 Gitea。
4. 通过 Gitea API 创建单个整合 Release。
5. 上传三个附件：
   - 本机直接部署包
   - 威联通 NAS 直接部署包
   - 通用部署包
6. 确认整合 Release 附件完整后，再删除旧三个 Release 记录。

## 执行步骤

- 生成 `release-assets/` 临时附件目录。
- 从三个 tag 归档生成 `.tar.gz` 文件。
- 校验压缩包目录结构与关键文件。
- 创建并推送整合 tag。
- 调用 Gitea Releases API 创建整合发布。
- 逐个上传附件并检查资产列表。
- 删除旧 release id 或通过 tag 查询后删除。
- 验证本地与公网服务。
- 更新测试方案与经验记录。
- 仅提交本次工程分析文档。

## 兼容性与回滚方案

- 原三个 tag 与分支不删除，若整合 Release 出现问题，可基于 tag 重新生成附件或恢复旧 Release。
- 删除旧 Release 记录只影响 Gitea 页面展示，不影响 git 历史。
- 若附件上传失败，不删除旧 Release，待上传成功后再清理。

## 预计文件变更

- 新增三份本次工程分析文档。
- 追加 `工程分析/经验记录.md`。
- 独立 Docker 仓库仅可能新增未跟踪临时附件目录，不纳入提交。

## 提交与部署策略

- 主工程提交信息包含时间戳：`2026-05-21-14-35-20 合并Docker部署Release记录`。
- 独立 Docker 仓库只推送整合 tag，不提交临时附件。
- 发布后验证 `http://127.0.0.1:4000/api/health` 与 `https://revoxel.huijutec.cn/`。