# 实现方案：Gitea Releases 发布三种 Docker 部署版本

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

## 修改目标

在 Gitea Releases 页面发布三种可下载 Docker 部署版本，并保证三种版本的根目录部署入口一致。

## 涉及路径

主项目：

- `工程分析/需求分析-2026-05-21-14-19-12.md`
- `工程分析/实现方案-2026-05-21-14-19-12.md`
- `工程分析/测试方案-2026-05-21-14-19-12.md`
- `工程分析/经验记录.md`

独立 Docker 程序包：

- `~/Desktop/ReVoxelSeg_DICOM_Docker/docker_compose.yaml`
- `~/Desktop/ReVoxelSeg_DICOM_Docker/docker_compose.nas.yaml`
- `~/Desktop/ReVoxelSeg_DICOM_Docker/.env.example`
- `~/Desktop/ReVoxelSeg_DICOM_Docker/README.md`

## 技术路线

1. 在独立 Docker 程序包仓库中基于 `docker-standalone-20260521` 创建三个发布分支。
2. 机器版：
   - 使用当前本机 `docker_compose.yaml`。
   - 创建 tag `revoxelseg-docker-machine-v2026.05.21`。
3. NAS 版：
   - 将 `docker_compose.nas.yaml` 内容复制为根目录 `docker_compose.yaml`。
   - 更新 README 为 NAS 直接部署入口。
   - 创建 tag `revoxelseg-docker-nas-v2026.05.21`。
4. 通用版：
   - 改写 `docker_compose.yaml`，使用环境变量占位 FRPC 配置。
   - 添加 `.env.example`。
   - README 说明用户需自行填写 `.env`。
   - 创建 tag `revoxelseg-docker-generic-v2026.05.21`。
5. 推送三个分支和三个 tag 到 Gitea。
6. 通过 Gitea API 创建三个 Release。

## 执行步骤

1. 检查独立 Docker 目录 Git 状态。
2. 创建发布分支和 tag。
3. 对三种版本分别运行 `docker compose -f docker_compose.yaml config`。
4. 推送分支和 tag。
5. 使用 Gitea API `POST /api/v1/repos/admin/REVOXELSEG_DICOM/releases` 创建 Release。
6. 使用 Gitea API 查询 Release 列表，确认三个版本存在。
7. 更新测试方案和经验记录。

## 兼容性与回滚方案

- 若 Release 创建失败，可以保留已推送 tag，重新调用 API 创建 Release。
- 若某个版本配置错误，可新建修订 tag，而不是强推覆盖旧 tag。
- 当前正在运行的独立 Docker 容器不依赖工作树后续分支切换，不会因创建发布分支中断服务。

## 预计文件变更

独立 Docker 仓库新增发布分支/tag；主项目新增工程分析文档和经验记录。

## 提交与部署策略

本次不改业务源码，不需要重新构建前端。发布验证以 Compose config、健康接口和 Gitea Release 查询为主。主项目 `main` 只提交工程分析文档。