# h3-console：从零构建到公网可访问

**完成时间**：2026-08-20。

给 `minimax-h3/` 的四后端 API（`gateway.py` + 4× `api.py`）加了一层 Web 管理台：三个 tab
（文生视频 T2V / 首尾帧 I2V / 参考图 R2V）+ 上传 + 任务列表 + fl2va/ref2va 弹性调度器。

- 部署在服务器 `/data/models/minimax-h3/console/`，两个进程共享同一份数据库/图片目录：
  局域网 `:8080`（开弹性调度器）+ 公网子路径专用 `:8081`（不开调度器，避免两个调度器互抢）。
- 公网访问：`http://qwen.wudaima.com/console`。原计划用独立域名 `gateway.wudaima.com`，实测
  确认这条线路走不通（缺口在 frp 服务端 `60.205.214.169`，不是这台机器能改的），改走
  `qwen.wudaima.com` 的 `/console` 子路径，frp 按 `locations` 做路径分流，不影响原有服务。
- 弹性调度器（kill+restart 某张 GPU 卡切 fl2va/ref2va）全链路在真实 GPU 上验证过：提交任务 →
  没有对应分区的空闲后端时先排队而不是直接 503 → supervisor 探测到需求后自动 flip 一张卡 →
  新后端 ready 后自动把排队任务提交上去 → 跑完 → 下载。

完整过程、踩过的坑（PID 提取正则写错、调度器连续 flip 好几张卡、`pkill -f` 误杀自己的 SSH
会话等）见顶层 `CHANGELOG.md` 里 2026-08-20「h3-console 部署上线」「新增 h3-console 管理台」
「公网访问改走 qwen.wudaima.com/console 子路径」这几节，以及 `h3-console/README.md`。