REVOXELSEG_DICOM/工程分析/需求分析-2026-05-21-14-35-20.md

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