REVOXELSEG_DICOM/工程分析/需求分析-2026-05-25-10-21-17.md

需求分析-2026-05-25-10-21-17

开始时间

2026-05-25-10-21-17

原始需求摘要

用户要求部署 https://revoxel.huijutec.cn/ 对应的 ReVoxelSeg DICOM 项目，确保线上地址恢复可访问。

业务目标

• 使用当前项目约定方式构建并启动 WebSite 一体服务。
• 优先沿用 tmux 会话 revoxelseg-dicom，将服务暴露在本机 4000 端口。
• 验证本机健康检查、本机页面和公网域名访问状态。

输入与输出

• 输入：当前工作区代码、WebSite/package.json 脚本、已有 tmux 会话和网络转发链路。
• 输出：重新部署后的本机服务与公网访问验证结果。

影响范围

• 运行态影响：WebSite/dist/ 构建产物、tmux 中运行的 Node 服务。
• 文档影响：本次需求分析、实现方案、测试方案和经验记录追加。
• 不涉及源码逻辑修改、医学数据修改、Docker 镜像改动。

关键约束

• 必须先执行 工程分析/代码编纂工作流.md。
• 部署优先使用 cd WebSite && npm run build && npm run serve -- --host 0.0.0.0 --port 4000。
• 长期运行优先沿用 tmux 会话 revoxelseg-dicom。
• 文档备份 commit message 必须包含 2026-05-25-10-21-17。

风险点

• 若 4000 端口已有进程占用，需要先识别并避免多服务冲突。
• 若公网反代或 FRP 链路异常，本机服务可正常但 https://revoxel.huijutec.cn/ 仍可能不可达。
• 若构建失败，需要先定位依赖或 TypeScript/Vite 问题，不能强行重启旧包当成新部署。

默认假设

• 当前代码状态即为用户希望部署的版本。
• 无需修改源码或 Docker 配置。
• 若已有 revoxelseg-dicom 会话存在，可重用该会话并重启其中服务。