mini-yifan AutoDL 应用实例（开机 → 发现面板 → 关机）
管 应用实例 生命周期，不管提示词、不管出片。出片走 minimax-h3。
官方文档：https://autodl.art/docs/app_api/
脚本：当前技能目录下的 scripts/autodl_app.py（ZCode：~/.zcode/skills/autodl-app-instance/scripts/autodl_app.py）。
接口细节 → reference.md
命令示例 → examples.md
不要把 AUTODL_TOKEN / SSH 密码写入仓库或技能文件。不要打印 root_password。
和 minimax-h3 的组合执行契约（批次级）
解析并记录 UUID
→ boot 一次并导出最新 SEETACLOUD_BASE_URL
→ minimax-h3 执行一个或多个视频 job
→ 等所有 job 进入终态
→ finally: off 一次（本技能）
当目标是 AutoDL 应用实例，或用户要求“开机后生成、全部完成后关机”时：先本技能，再 minimax-h3，最后关机。 不要只发现完面板就结束。
本技能只管理实例生命周期，不决定 H3 的工作流、提示词、时长、画幅或画面内容。minimax-h3 只有在本技能报告 COMFY_READY、队列可访问并提供最新面板地址后才能提交任务。
组合模式下，一个父任务就是一个 AutoDL 批次。必须先保存实例 UUID，再执行一次 boot；批次内的多个视频、重试和追加 job 都共用这次开机。单个视频完成时不得执行 off。
只有当批次内所有 job 都是 succeeded、failed 或 cancelled，并且没有仍在运行的 H3 任务、未下载的结果或未处理的重试时，就执行一次 off --uuid <uuid> --wait。成功、部分失败、超时、轮询异常或用户中断，都要走批次级 try/finally 清理；只有用户明确要求保持开机或设置 AUTODL_KEEP_ON=1 时例外。
关机时点（2026-08-29 明确）：批次产出全部下载落盘并通过 ffprobe 秒级校验后立即关机。归一化、抽帧验收、滤镜、按用户反馈调参重跑等本地后处理不得推迟关机——GPU 空转照常按秒计费，这些活放到关机后做零成本。本地验收不达标需要重生成时，先改提示词/素材再重新 boot（重开成本远低于空转等待）。
**最高效的完整链路（2026-08-27 秒表实测定型）**已写在 minimax-h3 SKILL.md 的"最快链路"一节：source ~/.zshrc → boot（warm 发现实测 5.8s）→ discover_workflow.py 生成 slot_map → 逐条提交把队列填满（勿生成一条等一条）→ 并发 poll（history 优先）→ 等待窗口做本地活 → 终态即 off --wait。自身开销 ~15s/批，其余全是 GPU 推理时间。
环境变量
| 变量 | 必填 | 说明 |
|---|---|---|
AUTODL_TOKEN |
是 | autodl.com → 账号 → 设置 → 开发者 Token。不要加 Bearer。缺环境变量时脚本回退读 ~/.config/autodl.env |
AUTODL_ENV_FILE |
否 | 覆盖 Token 私有文件路径，默认 ~/.config/autodl.env |
AUTODL_INSTANCE_UUID |
否 | 例如 pro-78672ec11b9c（MINIMAX-H3提速500高画质）。用户不需要记它，见下 |
AUTODL_APP_HINT |
否 | 没 UUID 时按应用名匹配，默认 MINIMAX-H3 |
AUTODL_KEEP_ON |
否 | 设为 1 或用户说「别关 / 保持开机」→ 跳过关机 |
Token 存储（推荐私有文件）：Agent 的 shell 继承不到另一个终端里的 export，非交互 shell 也常常不加载 ~/.zshrc。推荐写入 ~/.config/autodl.env：
mkdir -p ~/.config && echo 'export AUTODL_TOKEN=你的Token' > ~/.config/autodl.env && chmod 600 ~/.config/autodl.env
脚本缺 Token 时会自动读它，source ~/.zshrc / zsh -ic 只作为兜底手段。
缺 Token / 找不到实例时：向用户原样转达脚本报错中的申请与存储指引，不要绕过。实例解析链为 --uuid 参数 → AUTODL_INSTANCE_UUID → 按 AUTODL_APP_HINT 匹配账号下实例列表：唯一命中自动使用（boot 输出会打印 export AUTODL_INSTANCE_UUID=... 供本批次复用）；多台命中时把候选表给用户选一次；零台命中时提示用户先去 AutoDL 控制台创建一台 MINIMAX-H3 应用实例（一次性操作）。
流程
Task Progress:
- [ ] 1. 确认 AUTODL_TOKEN；解析并锁定父批次的实例 UUID
- [ ] 2. list / status
- [ ] 3. boot：关机则 power_on，等到 running
- [ ] 4. boot 并行直探快照的全部 service_*_domain，等到桥接面板 reason=ready、队列空（无 SSH 依赖，macOS/Linux/Windows 通用）
- [ ] 5. 在当前执行环境设置 boot 输出的 SEETACLOUD_BASE_URL；打开 minimax-h3 执行全部 job
- [ ] 6. 全部 job 进入终态、产出落盘并通过秒级校验后，立即执行一次 power_off，等到 shutdown（除非 KEEP_ON）；本地后处理（归一化/验收/滤镜）在关机后做
脚本（在任意项目目录执行）：
APP="${ZCODE_HOME:-$HOME/.zcode}/skills/autodl-app-instance/scripts/autodl_app.py"
python3 "$APP" list
python3 "$APP" status --uuid "$AUTODL_INSTANCE_UUID"
# 开机 + 并行直探面板（无需 SSH）+ 等 Comfy ready，打印 export SEETACLOUD_BASE_URL=...
python3 "$APP" boot --uuid "$AUTODL_INSTANCE_UUID"
# 出片（minimax-h3 的多个 submit / poll）…
# 全部 job 完成、失败或取消，且没有仍在运行的任务后：
python3 "$APP" off --uuid "$AUTODL_INSTANCE_UUID" --wait
已在运行：同样用 boot / ensure（内部会跳过重复开机，直接进入面板发现）。
已经 shutdown 再 off、已经 running 再 on：脚本当成功，不报错。
硬规则
- 走
https://www.autodl.art+/api/v1/adl_dev/dev/instance/pro/…，不是api.autodl.com的容器 Pro，也不是网页非官方/api/v1/instance。 power_on的payload必须是"gpu"。API 不能无卡开机。status/snapshot用 GET + query?instance_uuid=。JSON body 会RequestParameterIsWrong。- 不要调
release。那是释放实例，不是关机。 boot成功只说明容器在跑；H3 提交前必须看到reason=ready。首启实例的 ComfyUI 初始化可能花几分钟——boot会轮询桥接面板直到 ready，不要因为候选还没 ready 就手动放弃或换实例。- 出片失败、轮询超时、用户中断，也要在父批次结束时关机。多个 job 不能在单个视频完成后关机；用
try/finally语义：先记 UUID，批次结束时执行一次off --wait。 - 本机 HTTPS 可能有自签证书链，脚本用
curl -sk。不要改回强制校验然后卡住。 - 关机停的是 GPU 计费。系统盘仍按日扣。连续关机 60 天会释放应用实例。
面板发现：无 SSH 快路径（主路径）+ SSH 兜底
boot 的面板发现是快照域名并行直探（2026-09-08 跨平台重构，Mac/Linux/Windows 通用）：
- 从快照 API 一次性枚举全部
service_*_domain（6006/6008/…，泛化匹配，不写死端口）； - 用线程池并行 curl 各候选的
/api/comfy/status（curl -sk，8s 超时）； 200 + JSON + reason=ready→ 立即返回该候选；200 + JSON 但未 ready→ starting，保留轮询；200 但返回网页（如 AutoPanel 首页）→ 不是桥接，当轮剔除；404/502/不可达 → 每轮重探（并行 curl 亚秒级，代价可忽略，防误杀冷启动中的面板）。
SSH（读实例内 /root/面板地址.txt）只是兜底：仅当本机有 expect（macOS 自带）或 sshpass（Linux 常见）时才启用；Windows 两者都没有，自动跳过——旧版在 Windows 上唯一的快照候选是 6006（原生 ComfyUI，/api/comfy/status 恒 404），被当作死链后循环空转到超时，这就是"开机后找面板一直卡住"的根因。
实测过的快照域名坑（候选枚举与协议纠偏都已内置处理）：
- 端口内嵌在 domain 里（
xxx.seetacloud.com:8443）而service_*_port字段是0——不能因为 port 字段为空/为 0 就放弃； - 协议字段可能写 http，但 8443 代理实际是 https——自动纠偏；
- 桥接面板可能在任何一个 service 端口上：pro-787880159a61 实测 6006（
u450174-…）= 原生 ComfyUI（桥接端点 404），6008（uu450174-…）= H3 桥接 API——所以必须全部枚举、并行探测，取先 ready 的那个，不要只看 6006。
Ready 时长：ComfyUI 通常随开机几十秒内 ready。实例已运行时，面板发现一般 2–5s 内完成（一轮并行探测即命中）；冷开机（从 shutdown 起）ComfyUI ready 一般 <1 分钟，磁盘缓存冷时更久。starting 状态绝不拉黑，ready 一出现立即返回。
SSH 兜底的密码只放子进程环境变量 SEETACLOUD_SSH_PW / SSHPASS（expect 内 $env(...) 读取、sshpass 用 -e），不要 echo、不要写进脚本文本。端口、主机以 snapshot 为准（开机后会变）。