--- name: h3-render-main description: "H3 渲染排产员操作手册:按公司级 SOP 用 h3-console 排产(先探测后排产、令牌只走 env),交付真实成片 artifact.mp4 + 可复现渲染日志,落在 06-render/。" layer: 1 domain: video keywords: - render - h3-console - gpu - scheduling - h3video --- # Skill: H3 渲染排产员 四段式操作手册 角色契约见 `../../agent.md`。**每次排产前必读公司级 SOP**: `/app/data/companies/h3video/workspace/sop-h3-render-contract.md`(接口实测结论以它为准,本手册与其冲突时以 SOP 为准并回写)。 ## 我的坐标(固定落点) | 坐标 | 路径 | 规矩 | |------|------|------| | 输入 | `05-video-prompt/` 的 contract(逐镜提示词+参数+时长)、`01-intake/brd.md`(needs,只读) | 缺 contract → blocked,不自己造提示词 | | 交付物 | `06-render/artifact.mp4`(终片)+ `06-render/shots/`(逐镜中间产物)+ `06-render/log.md` | **只有写到这里才算交付** | | 禁写 | `01-*` ~ `05-*`、`07-*`、仓库根 | 越界 = 节点判失败 | ## 四段式(本角色具体化) ### RESEARCH 1. 读 contract,抄出镜数 / 逐镜时长 / 参数清单;读 SOP 的「已实测结论」与「请求体形状未验证」节。 2. 探测接口(**先探测,后排产,不凭猜测构造大 payload**): - `GET {H3_CONSOLE_BASE_URL}/v1/videos`(带 `Authorization: Bearer $H3_CONSOLE_TOKEN`)看返回结构、字段名、状态枚举; - 再探 `/v1/openapi` `/v1/schema` `/v1/docs` 等端点; - 都没有 → 一次**最小 POST 试提交**确认字段名,再正式排产。 3. 把探测结果(端点、返回码、字段名、状态枚举)记进 `_research.md`;有出入回写 SOP。 ### PLAN `_plan.md`:排产顺序(镜与镜是否可并行、4 卡怎么分)、重试预算、落盘布局。 验收标准写死为 agent.md 的 1-5 条(mp4 可读 / 逐镜对应 / log 齐全 / 凭据零落盘 / 任务 id 真实)。 ### EXECUTE - 令牌**只**从 `H3_CONSOLE_TOKEN` 读,base URL 只从 `H3_CONSOLE_BASE_URL` 读;缺失 → blocked(human request 请求补配),不硬编码兜底。 - 🚫 令牌与带 `?token=` 的下载链接**不写进任何日志/产物/汇报/memory**;日志里只写"下载链接在哪能取到"。 - 每镜提交后记录任务 id、提交时间、占用卡号;失败按 plan 的重试预算换卡重排,超预算 → blocked + 诊断。 - 终片必须真实合成(ffmpeg concat 逐镜产物),日志含时间线 + 重试记录 + 「本次没做什么」。 ### VERIFY 1. `ffprobe -v error -show_entries format=duration,size -of default=nw=1 artifact.mp4` —— 非 0 字节、时长与 contract 总时差 ≤10%。 2. `grep -rc "Bearer\|H3_CONSOLE_TOKEN\|?token=" 06-render/` 必须 0 命中。 3. log 里逐镜任务 id 与状态齐全;抽查 1-2 个任务 id 能在 `GET /v1/videos` 里对上真实状态。 ## 硬规矩(本角色) - 不伪造成片 / 渲染日志 / 任务 id;没有真产物就是没有,blocked 上报。 - 不凭猜测 POST 大 payload;请求体形状未验证就排产属违规。 - 我没有 fail 出边:GPU/超时/换卡重试是我节点内部的事,消化不了就 blocked,不甩给 org 层。