动态语言
继承自 skills/00-house-rules/SKILL.md。实现代码为 scripts/stingers.py;渲染所有内容的画廊为 scripts/build_stinger_gallery.py。
---\n
关键区别
场景解释。 闪光示意。
| 场景 | 闪光 | |
|---|---|---|
| 时长 | 8–15秒 | 2–4秒 |
| 承载内容 | 需要观众阅读的论点 | 一个已经听到的观点 |
| 面部 | 隐藏或画中画 | 隐藏 — 剪辑时切到它 |
| 数量 | 每10分钟视频3–6个 | 每20–40秒一个 |
| 如果移除 | 论点无法传达 | 视频变平,但不会出错 |
搞反这个区别是常见的错误。包含真实内容的三项列表是一个 compare 场景;同样的列表作为 steps 则是装饰。如果观众需要 阅读 它,那它就不是闪光。
闪光是被切到的,而不是叠加的。 它们在短暂的几秒钟内占据整个画面。一个全画面图形但讲话者仍可见的背景会显得像是错误,而缺失他面部的3秒钟几乎不造成损失。
词汇表
五种元素。库中的所有内容都是它们的组合,这就是不相关的动画读起来像一个系统的原因。
| 基础 | 近乎黑色,带有柔和的径向提亮。从不使用纯 #000 — 真正的黑色画面看起来像是信号丢失,而不是设计。 |
| 玻璃 | 半透明填充约4.5%墨量,1px边框约14%,圆角26。深度来自于边框和内部高光,绝不用卡片上的投影。 |
| 光泽 | 卡片稳定时低角度镜面扫过。这是标志性动作 — 它使平面矩形看起来像一个实体对象。 |
| 路径 | 约10%墨量的细虚线曲线。物体沿着路径移动。没有物体瞬移。 |
| 状态 | 一行小点承载系统状态。该行上颜色变化表示“然后它坏了”,无需任何文字说明。 |
错开时间为120–160毫秒。 低于100毫秒,相邻元素被视为一个对象;超过200毫秒,观众开始等待。
每个闪光都保持其最后一帧。 它是对着语音剪辑的,所以在效果完成后结束在任何帧上都必须安全。没有循环;没有在空舞台上结束。
闪光的种类
{ "kind": "converge", "from": "所有东西汇聚到一个地方", "dur": 3.4,
"chips": ["skill.md", "prompt", "context", "tool", "rule", "doc"] }
| 种类 | 它所属的句子 | 时长 |
|---|---|---|
converge | “所有这一切都汇聚到一个地方。” 纸片沿着虚线路径进入一个发光核心;状态点在它接受负载时被填满。 | 3.0–3.6 |
overload | “然后它停止工作了。” 同一个核心裂开变成红色。共享 converge 的几何结构,因此两者可以作为一个故事剪辑在一起。 | 2.4–3.0 |
steps | “有三个这样的。” 编号的玻璃卡片,错开排列,每张卡片带有光泽。最可重复使用,也最被滥用。 | 2.6–3.2 |
swap | “这个,不是那个。” A 被划掉并向上退场;B 在它下面出现。两者都保持清晰可读。 | 3.0–3.6 |
countup | “是百分之四十三。” 一个数字攀升,大小随数值增长,在 可见的源行上。 | 2.6–3.4 |
beats | 三个短促的短语,有节奏感。每个在同一个共享节拍网格上使用 不同的 入场方式。 | 2.4–3.2 |
surround | “你被工具淹没了。” 带标签的纸片环绕一个固定的中心,然后向内聚拢。中心从不移动。 | 3.2–4.0 |
photo | 一张找到的图像,经过处理。玻璃卡片、缓慢的 Ken Burns 效果、标题、信用行。 | 2.8–4.0 |
clip | 同样的卡片包含 视频素材 而不是静态图片。没有 Ken Burns 效果 — 它已经在动了。 | 2.4–3.0 |
像场景一样在 composition.json 中使用它们 — 相同的 from / at / dur 锚定,如果短语无法解析,则报同样的硬错误。
B-roll:photo / clip 闪光
两种处理方式,full 在它们之间选择。full 是主动选择的;省略它则得到卡片。
full: true — B-ROLL | full: false — 引用 | |
|---|---|---|
| 画面 | 全出血、无卡片 | 玻璃卡片、光泽、缓慢漂移 |
| 画面上的文字 | 一个下方三分之一,标示这个镜头是什么 | 标题 和 信用行 |
| 画面上的来源 | 从不 | 必需 |
| 用途 | 用于体现某个时刻的素材和静态图片 | 截图、图表、定价页面、文档 |
B-roll 是全屏的,不显示来源信息。来自人类的长期指令,2026-08-14。 它像每个人看过的任何剪辑中的 B-roll 一样占据整个画面。唯一允许在其上的文字是下方三分之一,说明这个镜头 是什么,绝不说它来自哪里。归属仍然会发生 — 在项目临时文件夹的 _FINAL/ATTRIBUTION.md 中,由 fetch_stock.py 在下载时写入,任何编辑都不能跳过。Pexels 和 Pixabay 都使画面上的水印成为可选项,因此清单本身满足许可要求,画面保持干净。
这取代了之前关于 B-roll 的段落,该段落说全出血剪辑“看起来像不同的视频”,并将所有内容放在卡片中。这个推理仍然适用于引用情况,并且只适用于它:当观众被要求 阅读 作为你引用的证据的素材时,使用 full: false,来源行回到画面上。
构建器仍然默认使用卡片,这是故意的。 改变默认值将静默地重新处理所有已根据它编写的 photo 场景 — 其中包括 drop-005 的 working/stingers/plan.json — 昨天渲染卡片的规范今天必须渲染同样的卡片。新作品要求 "full": true;skills/executive-animator 总是这样做。如果卡片最终被完全弃用,st_photo 中的单字更改就足够了。
一个几何学注意事项:全出血使用 object-fit: cover,所以 给它一个已经是 16:9 的源素材。一个 2.19:1 的裁剪在全画面显示时每边丢失 221px,这就是图表的第一列和最后一列被切掉,而每个门都报告一个正确边界框的原因。
一个构建器,两个名称。 photo 用于静态图片,clip 用于视频素材;它根据文件扩展名分支,所以名称只是为了提高规范的可读性。实际变化如下:
photo | clip | |
|---|---|---|
| 元素 | <img> | <video muted playsinline>,带有框架计时 |
| Ken Burns | 有,1.00 → 1.07 跨越卡片 | 无 |
视频素材没有 Ken Burns 效果。 剪辑本身提供了运动,在真实运动上叠加缩放渐变正是使素材看起来像素材的原因。静态图片是静止的,需要漂移来保持活力;剪辑不需要。
// B-roll。全屏,下方三分之一说明它是什么,画面上无来源。
{ "kind": "clip", "from": "一切同时移动", "dur": 3.0,
"src": "broll/cut-data-flow.mp4", "caption": "一切同时移动" }
// 引用。观众作为证据阅读的文档,所以卡片和水印都回来。
{ "kind": "photo", "full": false, "from": "定价页面变了", "dur": 3.2,
"src": "assets/pricing.png", "caption": "Anthropic 定价,2026年8月",
"credit": "ANTHROPIC.COM · FETCHED 2026-08-13" }
下方三分之一位于 cap_left / cap_bottom,默认为 96 / 186 — 横屏,这清除了 youtube_long 的 96 左侧和 132 底部。一个 9:16 的来电必须传递自己的 cap_bottom:Reels 在底部预留了 520,Karaoke 带占据 Y 1150-1400,因此横屏默认值会将标题放在进度条下方。没有一对值在两个画面中都正确。
src 相对于规范文件解析,构建器将其复制到项目的 assets/ 中,因此错误的路径会在构建时大声失败,而不是产生空白的卡片。同时从 scripts/fetch_stock.py 获取两者,它会打印出准备粘贴的块。
归属是清单义务,不是画面义务。 每个三级资产都在项目临时文件夹的 _FINAL/ATTRIBUTION.md 中获得一行,由 fetch_stock.py 在下载时写入 — 这就是 config/broll-policy.md 要求的,并且不是可选的。水印是否也出现在画面上是一个设计决策,而对于 B-roll,答案是否定的。在引用卡片上,它会保留,以 WCAG AA 标准渲染,没人能读懂的归属不是归属。
首先按层级顺序解析每个图像。照片是 三级:只有当您自己的素材和二级叠加层确实都没有任何东西时才使用它。Ken Burns 效果运行在裁剪卡片内部的 <img> 上,绝不在卡片本身上运行。
⚠ 不要复制长的第三方视频插入模式。 这种语言来源的参考运行了50秒别人的采访素材。config/broll-policy.md 直接禁止了这一点,再好的动态设计也不能让它变成我们的。带归属的照片没问题;但挪用一半视频是不行的。
更广泛的菜单 — 当以上都不适合时使用什么
存在两个上游语料库,两者都比这个库大。从中阅读,而不是发明新的动画。
hyperframes-animation 技能 — 48 条原子规则 + 22 个场景蓝图。使用 Skill(hyperframes-animation) 加载它,然后打开 rules-index.md 并阅读 rules/<name>.md 中你需要的那个规则。默认是 在一个暂停的时间线上组合 2–4 条原子规则;蓝图适用于你想要一个完整的 4–5 阶段镜头的情况。
块注册表 — 373 个可安装块:npx hyperframes catalog --query "<概念>",然后 npx hyperframes add <块>。
情况 → 规则
为讲解型视频精选。这些是符合我们格式的规则;其余的 48 条大多假设是产品 UI 或我们不使用的驱动光标。
| 当一句话是… | 规则 | 为什么适合 |
|---|---|---|
| 一个数字、统计、百分比 | counting-dynamic-scale、stat-bars-and-fills | 已实现为 countup;对条形图、环形图、星形填充直接使用规则 |
| 一个有力的列表、快速连续 | kinetic-beat-slam、waterfall-entry | 实现为 beats;waterfall-entry 是更温和的级联 |
| 一个定义或术语定居 | gradient-text-sweep、depth-scatter-assemble | 第一个中字形从不移动;第二个从深度组装它们 |
| “这是它的形状”(图表) | svg-path-draw | 轮廓自行绘制。在设置时使用 getTotalLength() 测量 |
| “它被包围/掩埋/连接” | radial-surround、avatar-cloud-network、orbit-3d-entry | 实现为 surround;另外两个添加连接线和 3D 入口 |
| 一个想法取代另一个 | scale-swap-transition、card-morph-anchor、morph-swap | 实现为 swap;card-morph-anchor 变形容器本身 |
| “仔细看这个” | depth-of-field-blur、coordinate-target-zoom、viewport-change | 焦距变换,或 .world 包装器上的虚拟摄像机 |
| 强调口语词汇 | asr-keyword-glow、css-marker-patterns | 发光与单词时间戳同步 — 我们已经有了测量到的单词时间 |
| 一个硬朗的、有节奏的重音 | chromatic-glitch、particle-burst、motion-blur-streak | 谨慎使用;每个视频最多一个 |
| 一个平静的落地节拍 | titlecard-reveal(蓝图)、ambient-glow-bloom | 低运动是有效载荷,不是缺陷 |
| 任何入口 | spring-pop-entrance | 典型的弹出。有疑问时,使用这个 |
值得了解的蓝图
22 个蓝图中的大多数是产品发布广告形状。四个映射到我们实际制作的内容上:
kinetic-type-beats— 主力。文字承载镜头,没有场景,没有表面。dataviz-countup— 当数据承载论点时。comparison-split— 同时权衡两个能力(我们的compare场景是其扁平化的表亲)。titlecard-reveal— 呼吸节拍,完全一个克制的动作。
跳过 cursor-ui-demo、device-surface-showcase、cta-morph-press、prompt-type-submit-generate 以及其它演示系列,除非我们实际在展示产品 UI。它们很出色,但不符合我们的格式 — 一个突然执行假应用演示的讲解型视频看起来像广告。
每个上游规则假设的契约
在复制一个规则之前值得了解,因为破坏这些不会导致检查失败 — 而是导致渲染失败:
- 一个在
window.__timelines上暂停的 GSAP 时间线。永远不要自动播放,永远不要有第二个时间线。 - 双向搜索安全 — 使用显式
from状态的fromTo,绝对值,永远不要相对+=。状态必须是时间线时间的纯函数。 - 确定性 — 没有
Math.random(),没有Date.now()。仅使用基于索引的伪随机。有限重复,永远不要repeat: -1。 - 仅变换和绘制。 禁止使用
width/height/top/left补间;使用 scale/translate 代理或遮罩。 - 分组错开限制,使一个到达读作一个节拍 —
items × stagger ≤ ~0.5s。 - 预先计算布局常量。 永远不要在补间时间派生位置;渲染器并行采样,测量会不同步。
添加新概念
- 首先搜索注册表 —
npx hyperframes catalog --query "<概念>"。存在 373 个块。radial-surround、morph-swap、split-tilt-cards和particle-image-reveal是此库中元素的近亲,可能比新代码是更好的起点。 - 从上述五个元素构建它。需要第六个元素的概念要么是场景,要么表明词汇表需要刻意扩展 — 而不是例外。
- 将其添加到
scripts/stingers.py中的KINDS。 - 渲染画廊并把它们全部放在一起看。这是判断新元素是加入了家族还是只是落在旁边的唯一方法。
python3 scripts/build_stinger_gallery.py <out> --photo <image>
cd <out> && npx hyperframes check
python3 scripts/probe_frames.py <out> --plan --grid sheet.png
此库已经捕获的三个缺陷
每个都通过了干净的 hyperframes check,然后才有人查看帧:
- GSAP 无法为
::after设置动画。 它使用querySelector解析目标,而querySelector从不返回伪元素,因此每个光泽都默默地什么都不做。光泽现在是一个真实的子元素 (SHEEN_EL)。如果你添加卡片,把它放进去。 - GSAP 无法为
clip-path设置动画。 来自hyperframes文档。使用mask-image进行路径动画。clip-path仍然适用于蒙版形状,但任何随时间变化的路径都需要mask。 - 截图在不同平台上使用不同的字体。 一个引用卡片在 mac 上看起来很好,但
Segoe UI与SF Pro不同。卡片字号在ddrop/style/font-lockup.json中,但跨平台验证仍然是非正式的最佳努力。
技术限制
此技能需要下游 ddrop 工具链提供的以下运行时功能:
- 用于 CSS 和 SVG 管理的 Puppeteer / Playwright 实例。
- Python 3.11+,用于运行
scripts/下的构建脚本。 - Node.js 22+,用于
npx hyperframes目录查询。 - ffmpeg,用于视频帧探测和画廊生成。
- 一个项目结构,包含
assets/、broll/、style/、composition.json和_FINAL/ATTRIBUTION.md。
没有这些依赖项中的任何一个,技能可以规划,但不能渲染。
变更日志
| 日期 | 变更 |
|---|---|
| 2026-08-14 | 添加了 B-roll 全出血策略,取代了引用图片的卡片默认值。扩展了 photo / clip 用法。 |
| 2026-06-22 | 将上层规则集从 hyperframes-animation 合并为摘要和速查表。 |
| 2026-05-10 | 初始库发布,包含下面 8 种闪光种类。 |
*欲了解完整上下文,请打开 skills/00-house-rules/SKILL.md。"
}