# 需求分析：合并 Docker 三版本 Gitea Release

开始时间：2026-05-21-14-35-20

## 原始需求摘要

用户认为当前在 Gitea 中分别发布“机器直接部署版本”“NAS 直接部署版本”“通用版本”三个 Release 过于杂乱，希望将三个发布合并成一个 Release，同时通过附件名称区分不同部署包。

## 业务目标

- Gitea Releases 页面只保留一个面向 Docker 部署的整合发布项。
- 整合发布项内包含三个部署附件：本机直接部署版、威联通 NAS 直接部署版、通用版。
- 三个附件通过文件名清晰区分部署场景。
- 保留已有 tag/分支作为源码锚点，降低回滚和追溯风险。

## 输入与输出

输入：

- 独立 Docker 程序仓库：`/home/wkmgc/Desktop/ReVoxelSeg_DICOM_Docker`
- 现有三个发布 tag：
  - `revoxelseg-docker-machine-v2026.05.21`
  - `revoxelseg-docker-nas-v2026.05.21`
  - `revoxelseg-docker-generic-v2026.05.21`
- Gitea 仓库：`admin/REVOXELSEG_DICOM`

输出：

- 一个新的整合 Release。
- 三个独立命名的 `.tar.gz` 附件。
- 删除旧的三个分散 Release 记录。
- 本次工程分析文档与经验记录备份 commit。

## 影响范围

- Gitea Release 展示与附件组织方式。
- 独立 Docker 仓库 tag 与发布附件，不改业务代码。
- 主工程 `工程分析/` 文档。

## 关键约束

- 不把 `工程分析/`、软著材料等非部署内容放入 Docker 发布附件。
- 通用版附件不得包含当前环境固定 FRPC 地址、token、端口、域名等信息。
- 不提交或回滚工作区内与本次无关的历史删除、未跟踪医学数据、软著目录。
- 发布整理完成后继续验证本机 `4000` 服务和公网域名可访问。

## 风险点

- 大体积附件上传失败或上传不完整。
- 删除旧 Release 前若新 Release 未成功上传附件，会导致页面暂时缺少可下载包。
- Gitea API 失败时需要保留旧 Release，避免发布物丢失。

## 默认假设

- 用户要求“合并成一个发布”指删除三个旧 Release 页面记录，但保留对应 tag/分支用于追溯。
- 一个整合 Release 的 tag 使用 `revoxelseg-docker-all-v2026.05.21`。