REVOXELSEG_DICOM/工程分析/实现方案-2026-05-24-09-58-56.md

实现方案-2026-05-24-09-58-56

实现方案文档路径

工程分析/实现方案-2026-05-24-09-58-56.md

修改目标

• 阅读并梳理当前项目结构、技术栈、运行方式和 Docker 发布历史。
• 恢复误删的 Docker部署/ 文件夹。
• 核查 Gitea 远端分支、tag 与 Release/附件关系；确认发布物仍由 tag/附件承载后，删除四个不再需要的发布辅助分支。
• 构建并重新部署 WebSite 服务，验证本机与公网访问。
• 完成工程分析记录、经验记录追加、Git/Gitea 备份提交。

涉及路径

• Docker部署/
• 工程分析/需求分析-2026-05-24-09-58-56.md
• 工程分析/实现方案-2026-05-24-09-58-56.md
• 工程分析/测试方案-2026-05-24-09-58-56.md
• 工程分析/经验记录.md
• WebSite/

技术路线

1. 使用 git status、README.md、WebSite/package.json、历史工程分析文档了解项目现状。
2. 通过 Git 历史或远端 main 恢复 Docker部署/，再核对恢复文件内容。
3. 使用 git ls-remote 与 Gitea API 检查远端分支、tag、Release 和附件；发布项和附件确认存在后，删除仅用于固化发布配置的辅助分支。
4. 执行 npm run build 验证前端生产构建。
5. 使用 tmux 会话 revoxelseg-dicom 启动 npm run serve -- --host 0.0.0.0 --port 4000。
6. 用健康接口、首页和公网域名做部署验证。
7. 追加经验记录，暂存本次相关文件并提交，推送到 Gitea。

执行步骤

1. 记录开始时间并阅读 代码编纂工作流.md、工程整体分析.md、经验记录.md。
2. 创建本次需求分析、实现方案、测试方案文档。
3. 再次读取 经验记录.md，满足执行前确认要求。
4. 恢复 Docker部署/ 并检查 Dockerfile、README.md、本机 Compose、NAS Compose。
5. 查询远端分支与发布 tag；若 Release 附件存在且 tag 可追溯，删除四个辅助分支。
6. 执行构建和部署，检查端口与 tmux 会话状态。
7. 验证 http://127.0.0.1:4000/api/health、http://127.0.0.1:4000/、https://revoxel.huijutec.cn/。
8. 更新 工程分析/经验记录.md。
9. git add 仅暂存本次相关文件，提交并推送到 Gitea。
10. 最终汇报恢复文件、分支清理、部署验证与 commit 状态。

兼容性与回滚方案

• Docker部署/ 若恢复异常，可从远端 main 或历史提交重新取回。
• 远端分支删除后仍保留 tag、Release 和附件；如确需恢复，可从对应 tag 重新创建分支。
• 部署失败时保留构建日志和 tmux 输出，必要时回退到此前可用的 Docker Compose 或旧 tmux 会话。
• 不提交既有无关删除，避免扩大回滚范围。

预计文件变更

• 新增三份本次工程分析文档。
• 恢复 Docker部署/ 下 4 个文件。
• 追加 工程分析/经验记录.md。
• WebSite/dist/ 可能因构建产生本地变化，但不作为本次备份提交重点。

提交与部署策略

• 提交信息使用：2026-05-24-09-58-56 恢复Docker部署并清理发布分支。
• 暂存范围限定为本次工程分析文档、经验记录和恢复的 Docker部署/ 文件。
• 推送到用户提供的 Gitea 备份仓库对应 main 分支。
• 部署使用 tmux 会话 revoxelseg-dicom 长期运行 NODE_ENV=production npm run serve -- --host 0.0.0.0 --port 4000，避免公网 Host 被 Vite 开发中间件拦截。
• 公网访问另起 revoxelseg-dicom-frpc 容器，使用 host 网络把本机 127.0.0.1:4000 映射到 FRP 服务端 10008。

执行补充记录

• 初次按普通 npm run serve 启动后，本机 /api/health、/ 与公网 API 正常，但公网根路径返回 403 Blocked request. This host ("revoxel.huijutec.cn") is not allowed.。
• 原因是非生产模式会进入 Vite 中间件，Vite 对公网 Host 做 allowedHosts 校验。
• 已改为 NODE_ENV=production 启动，服务直接返回 WebSite/dist/ 生产构建产物。
• 当前公网链路由 tmux Web 服务加独立 revoxelseg-dicom-frpc 容器组成。