HyperFrames — 请先阅读此内容
从这里开始任何 HyperFrames 任务 — 尤其是在没有项目智能体配置(CLAUDE.md / AGENTS.md / .cursorrules)的情况下。以下是能力地图和视频路由。
能力地图 — 为每个意图选择对应技能
| 你想要… | 前往 |
|---|---|
| 制作一个视频(来自 URL、简报、主题、GitHub PR、现有素材或一个要动画化的元素) | 下面的视频路由器(§ 视频路由) |
创作/编辑 HTML 作品集 — data-* 约定、片段、轨道、子作品集、变量 | /hyperframes-core |
| 动画 — 原子运动规则、场景蓝图、过渡效果、运行时适配器(GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
创意指导 — design.md、调色板、排版、旁白、节拍规划、音频响应 | /hyperframes-creative |
| 媒体预处理 — TTS 配音、背景音乐、字幕、背景去除、隐藏式字幕 | /hyperframes-media |
| CLI 开发循环 — 初始化、lint、验证、检查、预览、渲染、发布、诊断 | /hyperframes-cli |
安装注册表块/组件(hyperframes add) | /hyperframes-registry |
作品集创作约定(每个有时序的元素需要
data-start/data-duration/data-track-index;有时序的元素需要class="clip";GSAP 时间线需暂停并在window.__timelines上注册;仅使用确定性逻辑 — 禁止Date.now()/Math.random()/ 网络)在此不重复 — 它位于/hyperframes-core中。在编写作品集 HTML 之前,请先阅读该内容。
HyperFrames 无法做到的事项 — 请先检查此项
HyperFrames 创作一个 HTML 作品集并将其渲染为 MP4。这种模型有严格的边界限制。超出这些边界的需求不在范围内,因此应拒绝(或指向正确的工具),而不是尝试使用工作流。以下限制源于架构,而非单个请求:
- 渲染是确定性和自包含的。 每个值、资源和文本片段在创作时就已经固定;渲染过程中不进行网络调用或实时数据获取(核心规则:禁止
Date.now()/Math.random()/ 网络)。"在渲染时实时刷新数据" 已超出范围 — 请在创作时一次性获取数据并将其固定下来,或直接拒绝。 - 现有视频只能叠加,不能编辑。 HyperFrames 在源视频片段之上合成帧 —
/embedded-captions添加字幕层,/graphic-overlays添加设计好的图形卡片(下三分之一、数据说明、标题)— 底层视频片段原样播放,但不会对编码的视频流进行后处理。修改视频素材本身(其时间、色彩、构图、顺序或音频)是 NLE 风格的编辑,已超出范围。 - Remotion 导入是单向的。
/remotion-to-hyperframes将 Remotion 框架的 源码转换为 HyperFrames。没有逆向转换(HyperFrames → Remotion,或 → 任何其他框架 — 超出范围);非 Remotion 的 React/Web 动画源码没有可转换的 Remotion 源码 — 请通过/general-video重新创建。 - 无法生成它没有的输入。 不支持屏幕/会话录制、摄像头拍摄、AI 双脸/口型同步虚拟形象生成。如果素材或资源尚不存在,HyperFrames 无法凭空生成 — 请要求用户提供(或使用正确的捕获工具)来获取。
其他所有内容 — 来自 URL、简报、主题、PR、要注释的素材或单个要动画的元素的视频 — 均在范围内;请通过下面的路由进行分配。
视频路由
此部分仅了解顶层工作流。它不加载工作流内部阶段、领域技能(hyperframes-* — 请参阅上面的能力地图)或技术参考。
决策表
输入类型(意图)是主要维度;输出时长仅是上限,而非门槛。 对于匹配的输入,专业化工作流可处理最多约 3 分钟的内容 — _进入哪个_工作流由意图(输入类型,对于文本还有主题)决定,而非时长。时长仅影响高端:真正较长的内容(3-5 分钟的教程,5 分钟以上的深度分析)属于不同风格,路由到 /general-video。在 <=~3 分钟的范围内,第三个维度区分了两个基于文本的工作流 — 主题:是正在_营销_的产品还是正在_解释_的话题(请参见下方步骤 3 中的消歧规则)。
| 长度 / 输入 | 产品发布(URL/简报/脚本) | 通用网站/URL | GitHub PR / 代码变更 | 主题/文章/笔记(无产品、无 URL) | 现有视频(讲话者)† |
|---|---|---|---|---|---|
| ≤ 约 3 分钟 | /product-launch-video | /website-to-video | /pr-to-video | /faceless-explainer | /embedded-captions · /graphic-overlays † |
| 3-5 分钟 教程 | /general-video | /general-video | /general-video | /general-video | /embedded-captions · /graphic-overlays † |
| 5 分钟以上 深度分析 | /general-video | /general-video | /general-video | /general-video | /embedded-captions · /graphic-overlays † |
| 静态/循环 | /general-video | /general-video | /general-video | /general-video | /general-video |
今天的覆盖范围:≤ 约 3 分钟的区间为产品发布 / 通用网站 / GitHub-PR / 主题输入提供了专用工作流(URL 先按_类型_再按_意图_拆分 — 请参见步骤 3),现有视频列在任何长度下 — 由 /embedded-captions(隐藏式字幕/副标题)或 /graphic-overlays(设计好的图形叠加层)覆盖,按意图拆分(请参见步骤 2)。每个其他单元格都是 /general-video — 通用的 HTML 作品集创作流程(与输入和长度无关):所有长于约 3 分钟的内容(3-5 分钟 / 5 分钟以上的行)以及每个静态/循环格式。路由器从不遇到可创建视频的死胡同;唯一真正的“通用/无”答案是超出 HyperFrames 本身的请求(例如,对已完成视频文件的 NLE 风格编辑 — 重定时、重新着色、重新构图、重新排序、音频)。
† 现有素材按意图拆分,而非长度。 隐藏式字幕/副标题 → /embedded-captions;设计好的图形叠加层/封装 — 下三分之一、数据说明、有标题的卡片、引文 — → /graphic-overlays。两者都会叠加在视频片段之上,底层片段保持不变;两者都不编辑素材本身。
流派短路(优先于表格)。 一个简短(约 10 秒以下)、无旁白、以设计为主导的动态图形 — 动态文字、统计/图表动画、标志动画、下三分之一/叠加层、或动画推文/标题/截取的页面高亮 — 无论输入如何,都路由到 /motion-graphics。这是一个输出流派,而非输入类型,因此当需求明确是运动优先且无旁白时(请参见步骤 2),它优先于上述的输入类型表。较长或有旁白的作品按输入类型路由,或路由到 /general-video。
迁移现有作品集(特殊情况)
上表用于根据输入创建视频。还有一个工作流在此之外:如果用户明确要求将现有的 Remotion (React) 作品集移植/转换/迁移到 HyperFrames → /remotion-to-hyperframes。这是源码翻译,而非从输入创建,因此它没有 INTPUT × LENGTH 单元格。仅在明确的迁移语言时路由至此(“移植我的 Remotion 项目”,“转换这个 Remotion 作品”,“将其重写为 HyperFrames”)— 简单提及 Remotion 不会触发路由;默认回到创建表或 /hyperframes-core。
路由流程
- 确定 INPUT 类型 + 目标长度。 路由需要知道视频是关于什么的 — 其主题和输入。如果主题未指定(例如,“制作一个关于我们产品的视频”但没有 URL、命名产品、主题或可用资产),或者输入类型未知,在进入任何工作流之前请先询问 — 先澄清;不要在调用工作流技能之后再问,因为提交到工作流本身就是路由决策。最多问两个澄清问题:
- “你的输入是什么 — 一个产品(URL 或简报)、一个通用网站/URL、一个 GitHub PR / 代码变更、一个要解释的主题或文章、还是一个需要添加字幕的现有讲话视频?”
- “目标长度 — 大约 3 分钟或以下,还是更长(3-5 分钟的教程 / 5 分钟以上的深度分析)?”
- 规格默认值 — 直接说明,不要询问(这些_不_影响路由,因此永远不要阻塞路由):宽高比 16:9(引擎也支持 9:16 竖屏 — 仅当用户指定了竖屏目的地如 TikTok / Reels / Shorts 时才切换);旁白/字幕语言 = 用户的语言。仅当用户提出异议时才确认;所选工作流会在其步骤 0 中重新确认自身细节。
- 首先按 INPUT 类型(意图)选择;时长仅是上限,而非门槛。
- 简短以设计为主导的动态图形(流派短路,优先于输入表) — 运动本身即是信息:动态文字、统计/数字递增、图表动画、标志动画、下三分之一/叠加层、或动画推文/标题/截取的页面高亮;通常约 10 秒以下,无旁白/配音 →
/motion-graphics。这是一个输出流派,而非输入类型 — 当需求明确是一个快速、无旁白、设计主导的运动作品时,无论输入如何,都路由至此。对相同素材进行较长或有旁白的处理_不是_此流派(按输入类型路由,或/general-video)。 - 现有讲话视频(用户有一个片段并希望在其上添加内容)→ 按意图拆分,任意长度(输入类型优先于长度):隐藏式字幕/副标题(口头词语的可读文本) →
/embedded-captions;设计好的图形叠加层 — 下三分之一、数据说明、有标题的信息卡片、引文、图形封装编辑 →/graphic-overlays。(编辑素材本身 — 重定时、重新着色、重新构图、重新排序、音频 — 属于 NLE 风格,超出范围;请参见 § HyperFrames 无法做到的事项。) - GitHub PR / 代码变更(一个
github.com/<owner>/<repo>/pull/<N>链接,一个owner/repo#N引用,或“这个 PR”) →/pr-to-video(最多约 3 分钟)。 - 其他情况(产品 URL / 简报 / 主题文本):意图通过步骤 3 选择工作流,并且它处理最多约 3 分钟的范围 — 一个 15-30 秒的简短宣传片和一个约 100 秒的解说视频都按意图路由,而非按长度。仅当目标明显长于约 3 分钟(3-5 分钟的教程,5 分钟以上的深度分析)时,才路由到
/general-video(与长度无关的回退 — 请参见步骤 4)。切勿将真正较长的内容强制放入 ≤~3 分钟的工作流 — 意图在区间内决定,/general-video覆盖其余内容。
- 简短以设计为主导的动态图形(流派短路,优先于输入表) — 运动本身即是信息:动态文字、统计/数字递增、图表动画、标志动画、下三分之一/叠加层、或动画推文/标题/截取的页面高亮;通常约 10 秒以下,无旁白/配音 →
- 消歧 ≤~3 分钟的 URL/文本输入(意图拆分)。 两个拆分:
- URL 类型 + 意图 — URL 不再自动为 PLV 胜出;其_类型_然后_意图_决定:GitHub PR 链接(
.../pull/<N>,owner/repo#N,“这个 PR”) →/pr-to-video;否则一个网站 URL 按意图拆分 — 营销/发布/推广特定产品或 SaaS →/product-launch-video;通用网站 → 视频(网站导览、作品集/博客/落地页展示、来自网站自身视觉效果的社交剪辑、或仅仅是“将这个网站转化为视频”) →/website-to-video。两者都使用 Headless Chrome 爬取;PR URL 通过gh读取。当确实不清楚网站 URL 是产品发布还是通用网站视频时,问一个问题。 - 产品 vs 主题(文本,无 URL) — 决定性问题是视频是关于什么,而非输入格式:
- 一个特定的产品 / 公司 / SaaS / 应用 / 网站正在被营销、发布或推广 →
/product-launch-video。 - 一个概念 / 主题 / 文章 / 工作原理正在被解释,没有产品且没有 URL →
/faceless-explainer。 - 决胜局:“推广/发布/销售/我们的产品”表述 → PLV。“解释/教授/工作原理/什么是 X”且无产品 → 无脸。无脸的风格始终是
pin-and-paper。 - 一个被命名的网站但没有粘贴 URL 仍然是 PLV。 一个提及产品或其网站的脚本(“我们的网站是 acme.io”,“推广 <品牌>”)会路由到 PLV,即使没有可点击的链接 — PLV 可以搜索该网站并爬取其品牌资源(除非用户选择退出 → 无捕获预设模式)。不粘贴 URL 并不使其成为无脸/无捕获任务。对于提供脚本的字面引用 vs 重构选择是 PLV 内部的事,且永远不会改变路由。
- 冲突线索 → 询问,不要猜测。 如果提供的来源是产品自己的营销材料(其落地页、关于其平台的推广博客),然而用户明确要求去除推广 — 对底层概念的_中立_解释,非广告 — 则将其视为真正有歧义(视频是…)
- 一个特定的产品 / 公司 / SaaS / 应用 / 网站正在被营销、发布或推广 →
- URL 类型 + 意图 — URL 不再自动为 PLV 胜出;其_类型_然后_意图_决定:GitHub PR 链接(