HyperFrames：Agent 写 HTML，浏览器逐帧拍成 mp4，代价是同一份输入不一定出同一支片

它在链条上站在哪一层

它在这一层怎么做事

<div id="stage" data-composition-id="launch" data-start="0" data-width="1920" data-height="1080">
  <video class="clip" data-start="0" data-duration="6" data-track-index="0" src="intro.mp4" muted playsinline></video>
  <h1 id="title" class="clip" data-start="1" data-duration="4" data-track-index="1">Launch day</h1>
  <audio data-start="0" data-duration="6" data-track-index="2" data-volume="0.5" src="music.wav"></audio>
  <script>
    const tl = gsap.timeline({ paused: true });
    tl.from("#title", { opacity: 0, y: 40, duration: 0.8 }, 1);
    window.__timelines = window.__timelines || {};
    window.__timelines.launch = tl;
  </script>
</div>

• 本机编码 Agent：Agent 在你的文件夹里写工程，你留下一个自己的项目目录，可以继续改、可以在 Studio 里打开、可以读源码。
• AI 聊天：装都不装，用官方的托管 MCP 连接器在你的 HeyGen 账号里建和渲，代价是拿不到本地工程、Studio 和调试入口。
• 设计工具：Figma、Claude Design、Open Design 先定品牌与版面，把稿子交给编码 Agent 补运动、素材与渲染。
• HeyGen Video Agent：全自动，脚本、画面、配音、数字人它自己组，你拿到的是一支成片，消耗账号额度或积分。

你要给什么，它交回什么

最短的上手路径与花费

会卡住的地方

• 同一份输入不一定出同一支片。 症状：脚本在运行时加载前创建出来的动画、shadow-root 与伪元素里的 CSS 动画，每次加载都会差到一帧左右。触发条件：用上面这两类写法做动画，反复渲染同一份合成。现状：维护者自己在 2026 年 9 月 27 日提交了 #4559 与 #4555 两条，都还是 open 1819；并行渲染的那条 #4435 写明首个 worker 仍会拍到 seek 之前的状态，而 #2477 那次修复「从未落地」20；更早的 #2107 直接把矛头指向官方目录——部分区块会去运行时取数据、异步注册时间线，与确定性契约相冲突 21。你能怎么办：把「逐帧可复现」当成需要自己验证的假设，关键画面用 snapshot --at 抽帧比对两次结果；确实要求一帧不差的交付，先做小样再上量。
• 并行度上去以后会静默降级。 症状：一台 GPU 上开 6 个以上 worker，首帧探测超时，渲染悄悄回落到截图采集，画质与帧的对应关系都变了，日志里不一定显眼。触发条件：把并行调高来提速。现状：#4584 由 crmme 在 2026 年 9 月 27 日提交、open 22；自检也有盲区，#3345 说 drawElement 的 PSNR 自校验抓不到低对比度内容的缺失 23。你能怎么办：提速先跑 benchmark 找可用并行度，出片后逐帧抽查或对关键秒数抽帧核对，别只看「渲染成功」。
• Windows 上两条硬拦。 症状一：普通长度的成片会被磁盘空间闸门直接拒绝，因为采集一帧未压缩画面就要一大片内存与磁盘——官方在 #4060 里估算，约一分钟的 1080p 素材在未压缩 RGBA 下约 16 GB，而且没有流式回退。触发条件：Windows 上渲稍长的片子。现状：#4060 在 2026 年 9 月 18 日提交、open 24。症状二：ffmpeg 或 ffprobe 偶发 EBUSY / ETXTBSY，整条渲染直接以一句 spawn EBUSY 失败，没有重试也没有上下文。现状：#4058 同样在 2026 年 9 月 18 日提交、open 25。你能怎么办：Windows 上先小片试跑、留足磁盘，或者改用 --docker 走容器里的固定环境。
• 每次渲染都可能白等 45 秒。 症状：合成里没有注册任何时间线，渲染仍然要等满一个 player-ready-timeout，默认 45 秒，降低画质或缩小素材都不会缩短这段等待。触发条件：静态画面、简单的文字卡、只放视频不写动画的合成。现状：官方故障排查页把这条写成了正式条目，并给出解法——在合成根元素上加 data-no-timeline，lint 会以 missing_data_no_timeline 提醒你漏了它 13。你能怎么办：给没有时间线的合成补上这个属性，批量渲染时这一条能省掉成分钟的空转。
• 渲染成功不等于画面正确。 症状：z-index: -1 的元素在快照和渲染里都静默不出现；CSS transition 这种与逐帧寻址冲突的写法没有被 lint 拦下；只有单个关键帧的视频被稀疏关键帧检查跳过。触发条件：用了上面这几类写法，而画面看起来「没报错」。现状：#4366 在 2026 年 9 月 23 日提交、open 26；#3493 与 #3460 分别是 2026 年 8 月 26 日与 8 月 24 日的 lint 缺口，都还挂着 2728。你能怎么办：官方自己给的建议是「始终看导出的那个文件」，预览只证明工程能放，导出文件才证明交付对不对 7。
• 颜色会在两条路径上悄悄变。 症状：SDR 渲染把素材的阴影压暗，因为抽出来的 PNG 帧带着源文件的 BT.709 传输标记，被 Chrome 做了色彩管理；透明 WebM 用默认解码器看会显示为不透明，让人误判透明丢了。触发条件：成片里有实拍素材，或者要交付带透明通道的叠加层。现状：#4549 在 2026 年 9 月 26 日提交、open 29；透明与 HDR 的检查方法写在渲染文档里——显式指定 libvpx-vp9 解码器抽一帧，放到棋盘格背景上看 730。你能怎么办：交付前按官方给的方法抽帧验颜色，HDR 只在确认整条链路都支持时开。
• 托管 MCP 这条路还在 beta。 症状：授权反复跳转、建或渲的动作卡住、工具清单和结果呈现与你看到的文档对不上。触发条件：不装本机环境，直接用 AI 聊天里的连接器。现状：官方在该页顶部写明这条路径处于 beta，可用性、界面措辞、功能、额度与套餐要求都可能变；托管渲染跑在 HeyGen 的基础设施上，你拿不到本地工程、Studio 与调试入口；额度与计费随 HeyGen 独立调整，官方建议在做长渲染之前先到账号里确认 15。你能怎么办：把这条路径用在试和临时出片上，真要长期批量跑回到本地或自己的云。
• Studio 里的 Agent 受浏览器限制。 症状：Agent 读不到 Studio 的工具，或者只读到一半。触发条件：用非 Chrome / Edge 的浏览器，或者版本不够新。现状：官方给出的矩阵是 Chrome 149 与 Edge 150 还在 Origin Trial，ChatGPT Desktop 已上线，Brave 的实验特性可用，Firefox 与 Safari 还没有；工具注册是异步的，页面刚加载就去读会拿到不完整的清单，官方给的判断是等到数量稳定在 12 个 11。你能怎么办：这条能力当成尝鲜，日常驱动仍以本机技能包和命令行为准。
• 迭代快到你手上的资料会过期。 症状：照着几天前的文档写的命令，行为对不上；技能包里教的方法与仓库 main 有落差。触发条件：项目活跃期里隔几天回来做一次。现状：两天里从 v0.8.76 发到 v0.8.81，六个 release 31；npm 上是 435 个版本，仓库页面写 432 个 release、459 个 tag，三处口径各差一点 132；那对渲染出处标签之一在当前版本里还有个 bug，hyperframes_version 永远写成 0.0.0-dev 33；安装命令本身也有两处写法，README 给的是 npx skills add heygen-com/hyperframes，快速上手页上写的是带 --full-depth 的版本 212。你能怎么办：以本机实际装的版本和官方文档站为准，需要最新技能时用 npx hyperframes skills update 从 main 拉。

许可与真实成本

和之前几期放在一起看

今天该不该动手