# 需求分析：Gitea Releases 发布三种 Docker 部署版本

开始时间：2026-05-21-14-19-12

## 原始需求摘要

用户要求在 `https://gitea.huijutec.cn/admin/REVOXELSEG_DICOM/releases` 发布三个版本：

- 机器直接部署版本。
- NAS 直接部署版本。
- 通用版本，删除其中具体的 FRPC 反向代理地址、token、端口和域名信息，使其适配其他需求和环境。

## 业务目标

让使用者可以直接从 Gitea Release 页面下载对应部署版本，分别用于当前本机、威联通 NAS 和通用 Docker 环境部署，减少手动挑选 Compose 文件和替换敏感配置的操作。

## 输入与输出

输入：

- 独立 Docker 程序包目录：`~/Desktop/ReVoxelSeg_DICOM_Docker`。
- 已推送 Gitea 分支：`docker-standalone-20260521`。
- 当前机器版和 NAS 版 Compose 配置。

输出：

- Gitea Release：机器直接部署版本。
- Gitea Release：NAS 直接部署版本。
- Gitea Release：通用版本。
- 对应 Git tag 与 release 分支。
- 工程分析记录和经验记录。

## 影响范围

- 独立 Docker 程序包仓库会新增发布分支和 tag。
- Gitea Releases 页面新增三个 Release。
- 主项目仅提交本次工程分析文档。

## 关键约束

- 三个 Release 下载后的根目录都应有 `docker_compose.yaml`。
- 机器版保留当前本机和 FRPC 具体配置。
- NAS 版使用 NAS/QTS 绝对路径和当前 FRPC 具体配置。
- 通用版不能包含具体 FRPC 服务地址、token、远端端口和域名，应使用 `.env.example` 和环境变量占位。
- 不重复提交软著材料、工程分析目录到独立 Docker 版本中。

## 风险点

- Gitea Release 依赖 tag；若 tag 重名需先检查并避免覆盖已有发布。
- Gitea 自动源码包包含完整默认 DICOM/STL 数据，下载体积较大。
- 通用版移除具体 FRPC 配置后，用户必须自行填写 `.env` 或修改 Compose 才能启用公网映射。

## 默认假设

- 使用三个 tag：
  - `revoxelseg-docker-machine-v2026.05.21`
  - `revoxelseg-docker-nas-v2026.05.21`
  - `revoxelseg-docker-generic-v2026.05.21`
- 为避免 Release 之间源码结构混淆，分别创建轻量发布分支：
  - `release/docker-machine-20260521`
  - `release/docker-nas-20260521`
  - `release/docker-generic-20260521`