# 实现方案-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 服务`。