REVOXELSEG_DICOM/工程分析/实现方案-2026-05-25-10-21-17.md

实现方案-2026-05-25-10-21-17

实现方案文档路径

工程分析/实现方案-2026-05-25-10-21-17.md

修改目标

完成一次无源码变更的重新部署，恢复并验证 https://revoxel.huijutec.cn/ 服务。

涉及路径

• WebSite/
• WebSite/server.ts
• WebSite/vite.config.ts
• 工程分析/需求分析-2026-05-25-10-21-17.md
• 工程分析/实现方案-2026-05-25-10-21-17.md
• 工程分析/测试方案-2026-05-25-10-21-17.md
• 工程分析/经验记录.md

技术路线

1. 检查工作区状态、WebSite 脚本和当前 tmux/端口占用情况。
2. 在 WebSite 执行 npm run build，确认生产构建通过。
3. 若公网首页被 Vite host 检查拦截，将 revoxel.huijutec.cn 加入 Vite allowedHosts。
4. 使用 tmux 会话 revoxelseg-dicom 启动或重启： npm run serve -- --host 0.0.0.0 --port 4000
5. 通过本机和公网地址验证服务。
6. 追加经验记录，提交本次工程分析文档和明确属于本次部署修复的配置变更。

执行步骤

• 执行前再次确认已读 工程分析/经验记录.md。
• 若存在旧 tmux 服务，向会话发送 Ctrl-C 后重新启动。
• 若不存在旧会话，创建 tmux new-session -d -s revoxelseg-dicom。
• 使用 curl 验证：
  • http://127.0.0.1:4000/api/health
  • http://127.0.0.1:4000/
  • https://revoxel.huijutec.cn/

兼容性与回滚方案

• 若新服务启动失败，可保留构建日志并重新启动旧服务命令。
• 若公网不可达但本机正常，需要继续排查 FRP、NPM 反向代理和域名链路。
• 本次不改源码，回滚主要是停止新启动的 tmux 服务或恢复旧进程。

预计文件变更

• 新增本次三件套文档。
• 追加 工程分析/经验记录.md。
• WebSite/server.ts 和 WebSite/vite.config.ts 可能追加公网域名 allowedHosts。
• WebSite/dist/ 可能因构建更新，但不作为本次文档备份 commit 的目标。

提交与部署策略

• 先完成构建、部署与验证。
• 暂存本次工程分析文档、经验记录和 allowedHosts 配置修复。
• commit message 使用：2026-05-25-10-21-17 部署并验证 ReVoxelSeg DICOM 服务。