REVOXELSEG_DICOM/工程分析/实现方案-2026-05-21-14-19-12.md

实现方案：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 只提交工程分析文档。