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 开发循环 — init、lint、validate、inspect、preview、render、publish、doctor | /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添加设计好的图形卡片(下三分之一、数据标注、标题)——且片段在下方不变地播放,但两者都不对已编码的视频流进行后处理。更改素材本身(其 timing、颜色、构图、顺序或音频)是 NLE 风格的编辑,超出范围。 - Remotion 导入是单向的。
/remotion-to-hyperframes将 Remotion 框架 的源代码转换为 HyperFrames。没有逆向过程(HyperFrames → Remotion,或 → 任何其他框架 — 超出范围),并且非 Remotion 的 React / 网络动画源没有可翻译的 Remotion 源 — 通过/general-video重新创建。 - 它无法生成它没有的输入。 没有屏幕/会话录制,没有摄像头捕捉,没有 AI 虚拟头像/唇形同步头像生成。如果素材或资源尚不存在,HyperFrames 无法凭空创造它们——请要求用户提供它们(或先使用正确的捕获工具)。
其他所有内容——来自 URL、简报、主题、PR、需标注的素材或单个要动画化的元素的视频——都在范围内;请在下方路由。
视频路由
此部分仅知道顶层工作流程。它不加载工作流程内部阶段、领域技能(hyperframes-* — 请参阅上方能力映射)或技术参考。
决策表
输入类型(意图)是主要轴;输出长度仅是一个上限,不是一道闸门。 对于匹配的输入,专门的工作流程可处理最多约3分钟的内容——选择哪条工作流程由意图(输入类型,以及对于文本,主题)决定,而非长度。长度仅在高端情况下重要:真正较长的作品(3-5分钟教程,5分钟以上深度解读)属于不同范畴,应路由到 /general-video。在 ≤~3 分钟的范围内,第三个轴将两个文本驱动的工作流程分开——主题:被_营销_的产品 vs 被_解释_的主题(参见下面第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。这是源代码翻译,不是从输入创建,因此它没有 输入 × 长度 单元格。仅在对明确的迁移语言(“移植我的 Remotion 项目”、“转换这个 Remotion 合成”、“将其重写为 HyperFrames”)时路由至此——偶然提到 Remotion 不是触发条件;默认为创建表或 /hyperframes-core。
路由规程
- 确定输入类型 + 目标长度。 路由需要知道视频是关于什么的——其主题和输入。如果主题本身未指定(例如“制作一个关于我们产品的视频”但没有 URL、命名产品、主题或可用的资产),或输入类型未知,则在进入任何工作流程前提问——先澄清;不要调用一个工作流程技能然后再提问,因为选择工作流程本身就是路由决策。最多提出 2 个澄清问题:
- "您的输入是什么——一个产品(URL 或简报)、一个通用网站/URL、一个 GitHub PR/代码变更、要解释的主题或文章,还是需要添加字幕的现有对谈式视频?"
- "目标长度——大约 3 分钟或以内,还是更长(3-5 分钟教程 / 5 分钟以上深度解读)?"
- 规格默认值——陈述,不要提问(这些不会影响路由,因此永远不要阻止路由):宽高比 16:9(引擎也支持 9:16 竖版——仅在用户指定竖版目标如 TikTok / Reels / Shorts 时切换);旁白/字幕语言 = 用户语言。仅在用户提出异议时确认;所选工作流程会在其第 0 步重新确认其自己的细节。
- 首先按输入类型(意图)选择;长度仅是一个上限,不是闸门。
- 简短的设计导向动态图形(体裁短路,优先于输入表) — 运动本身就是信息:动态文字、统计/数字计数、图表动画、徽标演绎、下三分之一/叠加层,或动画推文/标题/捕获页面高亮;通常约 ~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。"解释/教学/某物如何工作/什么是某物"且无产品 → faceless。faceless 的输出风格始终是
pin-and-paper。 - 一个命名但未粘贴 URL 的网站仍然是 PLV。 一个提及产品或网站(“我们的网站是 acme.io”、“推广 <品牌>”)的脚本,即使没有可点击的链接,也路由到 PLV——PLV 可以网络搜索该网站并抓取品牌资源(除非用户选择退出,→ no-capture 预设模式)。未粘贴 URL 不会使其成为 faceless / no-capture 任务。对于提供的脚本,逐字 vs 重构的选择是 PLV 内部的,不会改变路由。
- 冲突线索 → 提问,不要猜测。 如果提供的来源是产品_自身的营销_(其落地页,关于_他们的_平台的推广博客),但用户明确要求去除推广——一个对底层概念的_中性_解释,不是广告——则将其视为真正模糊不清(视频是……
- 一个特定产品/公司/SaaS/应用/网站被营销、发布或推广 →
- URL 类型 + 意图 — URL 不再自动赢得 PLV;其_类型_然后_意图_决定:一个 GitHub PR 链接(
……(内容因长度截断)