Agent & engine documentation

一套动作语言,
多种执行方式

Motion Registry 把“想要什么画面”与“用什么代码实现”分开。创作者先选动作,Agent 再选择引擎适配器。

01

Recipe 是引擎无关的动作契约

它记录标题、用途、输入、场景实体、动作事件、输出范围和验收标准。Recipe 不出现 React、CSS、GSAP 或具体 easing API。

intent + inputs + scene + timeline + constraints
02

Timeline 使用 0 到 1 的归一化进度

0 表示镜头开始,1 表示镜头结束,不是小数 0.1。事件可以重叠;3 秒和 6 秒实现仍保持相同动作比例。

03

Adapter 只负责翻译

HyperFrames 把归一化事件映射到确定性的 GSAP timeline;Remotion 与 Three.js 把同一事件映射到帧,Three.js 的画面本体由真实 ThreeCanvas 几何与灯光完成。所有引擎必须保存主体、顺序、重叠关系与最终状态。

Motion Recipe→HyperFrames+Remotion+Three.js
04

Agent Context 从一个核心生成

通用上下文使用稳定段落标识,包含动作意图、输入、时间与验收标准。引擎上下文只追加已验证 Adapter 的文件入口、能力路由与实现纪律,因此不会出现多份提示词长期漂移。

  1. Generic Motion Spec
  2. + verified HyperFrames Adapter route
  3. + verified Remotion Adapter route
  4. + verified Three.js Adapter route(若已验证)
05

Collection 为任务编排 Recipe

知识视频、SaaS 演示或新闻解读需要一串镜头。Collection 只保存 Recipe ID、角色和建议顺序,不复制动作定义。

查看当前任务合集
06

Verified 代表真实渲染,不是文件存在

HyperFrames 需要 lint、validate、inspect、render;Remotion 与 Three.js 需要 typecheck、build 和真实 render。只有真实输出与验收证据存在,Adapter 才能标记 verified。

SchemaAdapterRenderVisual QA