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