REVOXELSEG_DICOM/工程分析/实现方案-2026-06-04-09-46-36.md

实现方案-2026-06-04-09-46-36

实现方案文档路径

工程分析/实现方案-2026-06-04-09-46-36.md

修改目标

完成一次无源码变更的重新部署，让用户可以通过 http://192.168.3.11:4000/ 访问当前程序。

涉及路径

• WebSite/
• WebSite/package.json
• 工程分析/需求分析-2026-06-04-09-46-36.md
• 工程分析/实现方案-2026-06-04-09-46-36.md
• 工程分析/测试方案-2026-06-04-09-46-36.md
• 工程分析/经验记录.md

技术路线

1. 检查工作区状态、部署脚本、已有 tmux 会话和 4000 端口占用。
2. 在 WebSite 执行 npm run build，生成最新生产构建。
3. 使用或重建 tmux 会话 revoxelseg-dicom，在其中启动： npm run serve -- --host 0.0.0.0 --port 4000
4. 验证本机健康检查、本机首页和局域网首页。
5. 追加经验记录，并仅提交本次工程分析文档与经验记录。

执行步骤

• 执行前再次确认已读 工程分析/经验记录.md。
• 若存在旧 revoxelseg-dicom 会话，先发送 Ctrl-C 停止旧服务，再启动新服务。
• 若不存在该会话，则创建新的 detached tmux 会话。
• 使用 curl 验证：
  • http://127.0.0.1:4000/api/health
  • http://127.0.0.1:4000/
  • http://192.168.3.11:4000/api/health
  • http://192.168.3.11:4000/
• 检查 tmux 会话和端口监听状态，确认服务长期运行。

兼容性与回滚方案

• 若新服务启动失败，保留构建和启动日志，停止新会话后回滚到上一次可用部署命令。
• 若端口被非本项目进程占用，先记录占用来源，再决定是否停止或改端口。
• 若局域网访问失败但本机访问成功，优先排查监听地址、服务器防火墙和网络路由。

预计文件变更

• 新增本次三件套文档。
• 追加 工程分析/经验记录.md。
• WebSite/dist/ 会因构建更新，但不纳入本次文档备份 commit。
• 不预计修改源码。

提交与部署策略

• 先完成构建、服务重启和访问验证。
• 再追加经验记录。
• 仅暂存本次工程分析文档和 工程分析/经验记录.md。
• commit message 使用：2026-06-04-09-46-36 部署并验证局域网 4000 服务。