hypit：把一条爆款视频写成可重跑的 SVML 工作流，对外托管要另买授权

它在链条上站在哪一层

• 语言。 一条片子拆成四种文件：.svml 是作品源码，写画面、声音和它们之间的引用；.svs 是可复用的外观与生成配方；.svrun 是这一次要产出什么；hypit.runtime.json 是执行环境档案，声明用哪些服务、哪个凭证、多大并发 4。
• 编译器。 它把这份源码图编译成三个真实的字节操作需求——画面、音频、混流——而不是一个不透明的大渲染；原始代码里这件事由 packages/render-hyperframes、packages/media-pipeline 与 packages/composition 分工完成 5。
• 包生态。 仓库里 packages/ 下有一百二十多个顶层包，从 caption、sound、seedance 这样的领域组件，到 provider-hiapi、provider-tokendance、provider-pollo、provider-monid 这样接模型服务的适配包 1。官方把可执行的那一份叫作发行版（Distribution），把技能那一份单独发布 6。
• 一个前端。 hypit studio --run <你的 .svrun> 在浏览器里打开这条片子的时间线，另有一个带时间戳评论的视图 7。

它在这一层怎么做事

• <opening>...</opening> 是一个 Segment，所有口播都写在 Segment 里；<HOST>、<GUEST> 这样的 Role Cue 在 Segment 里切换说话人，<host>、<主持人>、<진행자> 都算——按上下文认，不按大小写认 9。
• <显示的文字 | 念出来的文字> 是 Dual Text，把「看到的」和「听到的」分开：<S|ess> 显示字母 S、念出字母名；<API|A P I> 显示 API、念三个字母；<|只说不显示> 念出来但不进字幕 9。
• @{名字} ... @{/名字} 是一段有名字的语义范围，@{名字!} 是一个语义点。画面、动画、音效都可以绑到这些名字上；word{emphasis,keyword} 则给单个词挂属性，交给字幕组件去表现 9。

<import as="media" from="@hypit/media@1"/>
<import as="seedance" from="@hypit/seedance@1"/>

<media:Image id="presenter" src="./assets/presenter.png"/>

<import as="film" from="@hypit/film@1"/>
<import as="render" from="@hypit/render-hyperframes@1"/>
<render:Video id="final" composition={main.composition} timeline={speech.timeline}/>

你要给什么，它交回什么

最短的上手路径与花费

hypit runtime use hypit.runtime.json      # 选定执行环境
hypit auth login hypihub.default          # 连一个模型服务账号
hypit plan build.svrun                    # 看这次到底要跑哪些请求
hypit pricing build.svrun                 # 看这些请求按哪个价目表算
hypit build build.svrun --follow          # 只有这一步会真的提交工作
hypit get <build-id> --output final.video --to output/final.mp4

会卡住的地方

• 字幕是渲染链路里最脆弱的一环。 症状：升级到 0.2.15 之后，一条带字幕轨的片子渲出来只剩第一条字幕，后面 10 条全丢，而 Build 全程不报错、结果里的字幕数据还完整。触发条件：从 0.2.13 升到 0.2.15 后渲一条多字幕的片子。现状：#360 由 MatLish00010 在 2026 年 9 月 26 日提交，macOS、Apple M1 Pro、1080×1920、30fps、约 444 帧，仍是 open 26。你能怎么办：把字幕当成需要抽查的那一层——渲完在字幕带所在的位置每几帧抽一张看，别只看导出的时长和视频能放。
• 画面和字幕会互相污染。 症状：单独渲字幕完全正常，一旦加上画面轨，后面那条字幕的字形就被静态合成进前一条字幕的同一行上；把字幕带量出来，宽 657 像素，正好是后面那条的宽度而不是它自己的。触发条件：Windows、0.2.6、1080×1920、30fps、15 秒合成。现状：#330 由 online5880 在 2026 年 9 月 19 日提交，open；报告里还给了一份可复现的矩阵。你能怎么办：这条的证据里明确写着「所有渲染都是本地的，hypit plan 显示 external 0、paid 0」——也就是说它不花钱但会毁片子，字幕组合上线前必须自己抽帧验一遍 27。
• 升级本身就带风险，而它发版很快。 症状：同一个 Source、Run、档案和素材，0.2.13 渲得好，0.2.15 就坏。触发条件：跟着 main 或最新版走。现状：仓库两天里从 0.2.15 发到 0.2.16，23 个 release 从 v0.2.11 到 v0.2.16 全落在 2026 年 9 月 21 日之后 28；0.2.16 与 #360 同在 2026 年 9 月 26 日出现，但 #360 至今 open 1。你能怎么办：在项目里钉死版本号，把「升级」当成一次独立的变更，用一条固定的小样例片做回归。
• 没有隐式缓存，复用要一行一行写出来。 症状：同一条命令跑第二遍，它不会接着上一次，而是开一个新的 Build；花过钱的素材如果没被显式选中，下一遍会重新生成。触发条件：改一版字幕或换一段 B-roll 就想重渲。现状：官方文档把这句话写死了——「Hypit 没有隐式缓存」，复用必须通过 build-record 与 satisfy 显式声明。你能怎么办：每接受一份生成的素材，立刻把它写进下一个 .svrun，再花钱做下游 11。
• 有些错要到开工后才被发现，中间的白等是要付钱的。 症状：时间轴上落在非整帧位置的放置，check 阶段不拦，一直走到 Build 才被拒。触发条件：作者写了 end="19.51s" 这类不落在帧边界上的时长。现状：#354 由 Flandern1211 在 2026 年 9 月 24 日提交，open；报告里有实测记录，作者是用 check、plan、build 三个阶段的耗时对比找出这一类的。你能怎么办：把 check 当成真正的门而不是仪式，时长只写能整除帧的数 29。
• 本地环境要自己备齐，报错只告诉你「没准备好」。 症状：ffmpeg / ffprobe 不在 PATH 上、本地 WhisperX 的 Python 环境没建（它用 uv 建自己的锁定环境，还要下模型权重）、本地渲染要下的 Chrome headless shell 没下——三样都表现为运行时的失败，而不是安装时的提示。触发条件：第一次在不熟悉的机器上跑，尤其是远端 Agent 环境。现状：官方文档把这三样分开写在「本地工具与托管程序」一节，并且明确说「可用、已选中、已准备、正在运行」是四个不同的事实。你能怎么办：hypit paths 看档案与机器位置，hypit doctor --endpoint <实例> 看这个端点配好没有，hypit programs status --verbose 看本地助手的状态与日志 19。
• ffmpeg 版本能一条参数打死整条通道。 症状：normalize-media 面对任何会动的源都在解码前失败，报的是 -autorotate 被当成了输出选项。触发条件：机器上是 ffmpeg 6.x。现状：#343 由 deeplang-bot 在 2026 年 9 月 22 日提交，open，报告给了复现、成因和一行 diff，实测环境是 Ubuntu 24.04（aarch64）加 ffmpeg 6.1.1-3ubuntu5，版本是 @hypit/hypit@0.1.11。你能怎么办：先 ffmpeg -version 确认版本；这条的适用范围是明确的——它是 ffmpeg 6.x 上的一次参数拼写错误，不是所有环境都中 30。
• 想做给别人用的服务，许可这一步就卡住了。 症状：代码能跑、技术上也做得成，但对外提供属于要单独拿授权的情形。触发条件：把 Hypit 或其衍生作品用在多租户环境，或者作为托管、管理、SaaS 服务提供给第三方。现状：许可原文第 1.a 条写明未获书面授权不得如此，并且把「两个及以上你组织之外的方各自持有独立 workspace」直接定义成多租户，收不收费都一样；第 1.b 条另禁止为商业利益销售、收费许可或以其他方式提供给第三方。仓库里已经挂着两份真实申请：#281 是微信小程序加移动 App 的独立开发者，2026 年 9 月 17 日提交；#205 是 Bufflow 的付费多租户托管，2026 年 9 月 16 日提交，两份都还是 open 33132。你能怎么办：许可第 1.a 和 1.b 条后面明确写了不需要额外许可的三种情形——自己下载在自己的基础设施上跑、给本组织干活（包括商用和为客户做的活）、由且仅由一个组织运营的单租户部署。先把自己的形态归到这三类里去，归不进去就去 issue 里看别人怎么开的口。
• 不能删的东西比你以为的多。 症状：命令行界面、它生成的运行报告与清单，以及任何由它们派生出来的用户可见界面里的名称、LOGO、版权信息，都不能删改。触发条件：白标注销、把运行报告交给客户、把 Hypit 当后端后自己套一层前端。现状：许可第 1.c 条；同一条也给了豁免——不把这些东西呈现给用户的使用方式，不受这条限制 3。你能怎么办：交付前确认保留了什么，别在包装层里擦掉它。

许可与真实成本

1. 自用可以，对外提供服务不行。 给自己组织用——包括商用、包括为客户做的活、包括单租户部署——都在许可内；多租户托管和商业再分发要单独拿书面授权。
2. 可以分叉、可以改、可以发布源码，前提是结果沿用同一份许可，且不为商业利益提供。
3. 名称、LOGO、版权信息不能删改，命令行界面、运行报告、清单以及由它们派生的用户可见界面都算。
4. 产出归你。 第 3 条明确写着：用 Hypit 做出来的视频、音频、图片、清单等任何产物都属于你，这份许可不对它们的使用（包括商用）附加条件；但通过第三方模型或服务生成的内容，另受那些服务自己的条款约束。贡献者那一段另有一句要留意：作者保留把开源协议调整得更严或更宽的权利。

和之前几期放在一起看

今天该不该动手