REVOXELSEG_DICOM/工程分析/需求分析-2026-05-21-14-19-12.md

需求分析：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