2026-05-21-14-35-20 合并Docker部署Release记录

工程分析/实现方案-2026-05-21-14-35-20.md

@@ -0,0 +1,58 @@
+# 实现方案：合并 Docker 三版本 Gitea Release
+
+实现方案文档路径：`工程分析/实现方案-2026-05-21-14-35-20.md`
+
+## 修改目标
+
+将 Gitea 上三个 Docker 部署 Release 合并为一个整合 Release，并在该 Release 中挂载三个命名清晰的部署附件。
+
+## 涉及路径
+
+- `/home/wkmgc/Desktop/ReVoxelSeg_DICOM_Docker`
+- `工程分析/需求分析-2026-05-21-14-35-20.md`
+- `工程分析/实现方案-2026-05-21-14-35-20.md`
+- `工程分析/测试方案-2026-05-21-14-35-20.md`
+- `工程分析/经验记录.md`
+
+## 技术路线
+
+1. 使用独立 Docker 仓库中已有三个 release tag，通过 `git archive` 生成三个部署压缩包。
+2. 对通用版 tag 做固定环境信息搜索，确认没有泄露当前 FRPC 与域名配置。
+3. 创建整合 tag `revoxelseg-docker-all-v2026.05.21` 并推送到 Gitea。
+4. 通过 Gitea API 创建单个整合 Release。
+5. 上传三个附件：
+   - 本机直接部署包
+   - 威联通 NAS 直接部署包
+   - 通用部署包
+6. 确认整合 Release 附件完整后，再删除旧三个 Release 记录。
+
+## 执行步骤
+
+- 生成 `release-assets/` 临时附件目录。
+- 从三个 tag 归档生成 `.tar.gz` 文件。
+- 校验压缩包目录结构与关键文件。
+- 创建并推送整合 tag。
+- 调用 Gitea Releases API 创建整合发布。
+- 逐个上传附件并检查资产列表。
+- 删除旧 release id 或通过 tag 查询后删除。
+- 验证本地与公网服务。
+- 更新测试方案与经验记录。
+- 仅提交本次工程分析文档。
+
+## 兼容性与回滚方案
+
+- 原三个 tag 与分支不删除，若整合 Release 出现问题，可基于 tag 重新生成附件或恢复旧 Release。
+- 删除旧 Release 记录只影响 Gitea 页面展示，不影响 git 历史。
+- 若附件上传失败，不删除旧 Release，待上传成功后再清理。
+
+## 预计文件变更
+
+- 新增三份本次工程分析文档。
+- 追加 `工程分析/经验记录.md`。
+- 独立 Docker 仓库仅可能新增未跟踪临时附件目录，不纳入提交。
+
+## 提交与部署策略
+
+- 主工程提交信息包含时间戳：`2026-05-21-14-35-20 合并Docker部署Release记录`。
+- 独立 Docker 仓库只推送整合 tag，不提交临时附件。
+- 发布后验证 `http://127.0.0.1:4000/api/health` 与 `https://revoxel.huijutec.cn/`。