1实现原理 · 为什么它能做到
把「作品集级 showreel」拆成可复现的构建：一条母题贯穿 6–7 个被 HUD 命名的工种章节，收尾回到母题，而不是逐镜堆效果。
.claude/skills/motion-showreel/SKILL.md
A showreel promises that every frame was a decision. … Hard cuts are reserved for the flurry.
注：这里在做什么：把「母题变形链」写成硬语法——每个转场把当前物体变成下一个，硬切只留给 flurry；随后再叠加 HUD、墨/纸/一个强调色+一个藏色、拍点对齐与物理质感。
HUD 是常驻层：裁切标记、标题行、规格行（分辨率/帧率/实测 BPM）、时间码、章节标尺与章节名，并随背景明暗翻转墨/纸。
.claude/skills/motion-showreel/SKILL.md
**Persistent HUD.** Corner crop marks … It flips ink/paper with the background.
注：这里在做什么：HUD 不是装饰，而是「每一帧都是决策」的可视化元语言；工程上交给 templates/hud.html 的 hudFrame(t)（t 的纯函数）驱动，保持 seek-safe。
剪辑锁在 120–130 BPM 网格：硬切、闪白、反相都落在网格线 ±2 帧内，并在中点前留一个「预降拍」空档。
.claude/skills/motion-showreel/SKILL.md
**Cut on the beat, animate on the off-beats.** … comes before the midpoint hit.
注：这里在做什么：把「跟着音乐剪」变成可测量约束；支撑材料是 references/reference-breakdown.md 对参考片逐拍的量化拆解。
结构按拍分配：约 75% 发展 / 13% flurry / 12% 收尾，先加速后保持；密度也要呼吸（一个物体 → 字墙 → 100 格 → 数千粒子 → flurry → 一个词）。
.claude/skills/motion-showreel/SKILL.md
**Accelerate, then hold.** … and 12% resolve.
注：这里在做什么：给 15s 剪辑一个可套用配比（physics 4 拍 → type 8 拍 → 三个 4 拍章节 → 4 拍 flurry → 4 拍 lockup）。
风格来源不是形容词，而是一份逐秒量化拆解：BPM、拍点锚、每次硬切落点、亮度节奏、音频电平。
.claude/skills/motion-showreel/references/reference-breakdown.md
- **Tempo:** 128 BPM … Grid anchor about 0.51s. … - **Hard cuts land on beats:** 1.77 (flash) … within 2 frames of a grid line.
注：这里在做什么：把「为什么这条参考片好看」转成可复用数字（放 references/），再用同一套工具量自己的成片做对照（Step 8）。
音乐先量相位再剪：用 kick 频段（120Hz 低通）相位对齐，而不是全频段相位，否则每次拼接会晚半拍。
.claude/skills/motion-showreel/SKILL.md
`music-grid` prints the period, the **kick-band phase** (use it) … the script warns when the two disagree.
注：这里在做什么：把「对齐拍点」的常见坑（锁到反拍 hi-hat）写进脚本行为：music-grid.mjs 折 KICK band 相位并给对比度、冲突时告警；剪完还要复测（要求 25ms 内），并把实测 BPM 写进 HUD。
动画由逐帧纯函数驱动（时间 → 全部状态），canvas 效果从种子值绘制，保证 seek 确定性。
.claude/skills/motion-showreel/SKILL.md
Put a **per-frame driver** on the timeline … never from `Math.random()` at draw time.
注：这里在做什么：HyperFrames 的暂停时间线 + 任意 seek 要求动画可重放，故禁止绘制期 Math.random；被多个 tween 叠改的属性（共享 flash 层）也回退到逐帧计算，避免回退 seek 卡住。
验证是拿同一把尺量自己：切点距拍点 ≤35ms、亮度按章节交替、音频有预降拍，并抽连续 10 帧条带看每个转场；品牌测试要求遮住 HUD 仍认得出。
.claude/skills/motion-showreel/SKILL.md
- Run `analyze-reference.mjs` on your own render with `--bpm` and `--phase`: cut … luminance must alternate by chapter … Brand test: pick 6 random frames. … read as the brand with the HUD covered.
注：这里在做什么：把验收从「看起来不错」变成对同一量化工具的回归；证据落 VERIFY.md，避免 HUD 撑起整条片。
2核心能力
0110–30 秒品牌/动效 showreel 的完整生产链（BRAND.md 取材 → STORYBOARD.md → 音乐/拍点 → SFX/混音 → 构建 → 验证）
02参考片逆向量化：接触表、逐帧亮度差、音频 RMS、onset 检测，以及每个切点距拍点/半拍的偏移
03拍点工具链：测 BPM/相位（music-grid）、按拍切章节并出帧表（beatgrid）、把 music take 拼到切点网格（splice-music）
04付费生成资产（Kie.ai）：Suno 乐器、Seedream 图生图保住 logo 轮廓、Kling 图生视频 5s 运镜
05SFX 套件生成与 premix：按视觉事件摆 cue，输出单条 master.wav 作为合成唯一音轨
06HyperFrames/GSAP 构建契约：单条暂停时间线、章节 clip 层、HUD 置顶、只补间 transform/opacity、布局只测一次
07章节技法库（物理挤压拉伸、动能排版、网格/粒子、材质 lookdev、flurry、lockup），每项含参考做法 + seek-safe 构建 + 品牌替换建议
3外部依赖
| 类型 | 依赖 |
|---|---|
| cli | FFmpeg / ffprobe（接触表、亮度/RMS 分析、音乐拼接、premix） |
| api | Kie.ai 任务 API（Suno 音乐 / Seedream 图 / Kling 视频；付费、消耗本人额度） |
| api | Kie.ai 文件上传（把本地参考图以 base64 上传换 downloadUrl） |
| api | ElevenLabs 音效生成（付费） |
| cli | HyperFrames CLI（lint / Studio 预览 / draft render / 最终 render） |
| package | 兄弟 skill 依赖：hyperframes、gsap，与仓库根 MOTION_PHILOSOPHY.md / video-storytelling |
| network | 字体：要求下载到项目 assets/fonts/ 用 @font-face（远端拉取发生在取材期，不在渲染期） |
4风险提醒 风险提醒：橙色 · 评估后使用
风险提醒：橙色 · 评估后使用
- 凭证与额度：付费生成消耗本人 Kie.ai 额度，并把密钥放进请求头、把本地图片 base64 外传 — kie.mjs 读 KIE_API_KEY 后带 Bearer 调 api.kie.ai；image/video 子命令先把本地参考图上传到 kieai.redpandaai.co。使用前应确认额度与素材可外传（含未发布品牌素材），并留意 key 出现在请求与日志链路。
- 向上 8 层探测 .env 的读取行为超出项目根 — loadKey() 从脚本目录逐级向上最多 8 层查找任意 .env 并解析 key 名；多项目/多租户机器上可能读到与本任务无关的 .env。建议改用显式环境变量而非依赖探测。
- 「先确认再付费」只是提示层约束，无技术开关 — 脚本没有交互式确认或 --dry-run；自动化流水线里无人把关时可能直接产生多笔付费调用（音乐/SFX/图/视频）。见 second_pass 的 discrepancy 条。
- 参考片数字不可复现（文档声明 ≠ 可核事实） — 见 second_pass 的 unlocatable 条；照抄其数值设计自己的片子前应先用自己的素材重测。
- 品牌/字体/音乐合规由使用者负责 — SKILL.md 只要求「只使用用户有权的品牌标记」并让字体下载到本地，未提供授权校验；商用发布前需自行确认商标、字体与音乐许可。
- 平台前提较硬：Node 22+ 与带 ffprobe 的 FFmpeg — SKILL.md 明写 'They need Node 22+ and FFmpeg with ffprobe.'；不满足时全部脚本不可用。
风险提醒：橙色，评估后使用。触发橙档的两点都能在 skill 自身目录内定位：① **读环境凭证并按 key 调外部生成服务**——scripts/kie.mjs 先取 process.env.KIE_API_KEY，取不到就沿目录向上最多 8 层找 .env 并正则抓 KIE_API_KEY，然后带 Authorization: Bearer 调 api.kie.ai 的付费任务 API，并把本地图片 base64 上传到 kieai.redpandaai.co；scripts/sfx.mjs 同样从 env 或向上找 .env 读 ELEVENLABS_API_KEY 去调 ElevenLabs 音效接口。② **用户素材出网 + 消耗账号额度**——kie 的 image/video 子命令会把用户提供的 logo/静帧上传生成（Seedream/Kling），SKILL.md 也把音乐与 SFX 生成标为付费调用并要求先确认。未发现安全降级（无 TLS 关闭、无 --no-verify）、反自动化绕过、沙箱关闭或任意代码执行面：子进程只调 ffmpeg/ffprobe 等固定二进制，脚本全部随包分发且可逐行审阅；缺 key 时脚本直接报错退出而非静默降级。
5第二遍独立确认
- [ok] KIE_API_KEY 是否真的被读取并外发（橙档关键证据） — kie.mjs:19 `if (process.env.KIE_API_KEY) return process.env.KIE_API_KEY;`，随即 loadKey() 向上 8 层找 .env 并抓 KIE_API_KEY，无 key 抛 'KIE_API_KEY is not set. Add it to .env (see docs/TOOLS-AND-API-KEYS.md).'；带 Authorization: Bearer 调 createTask/recordInfo/credit。调用点真实存在。
- [ok] ELEVENLABS_API_KEY 读取与外发是否属实 — sfx.mjs:15 `if (process.env.ELEVENLABS_API_KEY) return process.env.ELEVENLABS_API_KEY;`（无 key 抛错）；文件头注释声明 PAID 并要求先确认。
- [ok] 是否存在文档未提及的隐藏网络调用或脚本 — 全目录 URL/网络 token 扫描只命中上述网络点与 docs.kie.ai 文档链接；beatgrid.mjs 纯计算，其余 mjs 仅 ffmpeg 子进程。未发现混淆代码、动态 eval 或静默外发。
- [unlocatable] 参考片量化数字能否在源码内复现 — references/reference-breakdown.md 的 128 BPM、各切点时间、亮度序列与 RMS 值，是作者对一条私有样片（Opus 5.5 的 CLAUDE / MOTION REEL）跑 analyze-reference.mjs 的结果；pin 仓库内既无该样片也无原始报告输出，本次只读侦查不运行分析，故这些数值仅作「文档声明」记录，不当已核事实使用（分析器能力本身已可读验证）。
- [discrepancy] 「付费调用先确认」是技术门禁还是提示层约束 — ［判定：提示层，非技术强制］脚本头注释显式声明 PAID，SKILL.md 在音乐与 SFX 两处也写 paid call / confirm before running；但脚本没有任何交互式确认开关或 --dry-run，门禁靠 agent 遵守。已在 risks 中如实标注。
- [ok] HUD 模板与 SKILL.md 的 HUD 规格是否一致（文档/资产是否脱节） — templates/hud.html 头注释要求把 <style> 粘进合成、#hud 作为 #root 最后子节点、由 hudFrame(t)（t 的纯函数）驱动，并提供 --hud-acc / .hud-tl / .hud-tr / #ptime / CH / SEGB / paperRanges 的品牌替换清单，与 SKILL.md 第 4 条规格一一对应。
6结论
适合：适合要做 10–30 秒品牌/动效 showreel 的人：有明确品牌资产与音乐预算，愿意按拍点网格工作、接受「先量参考片、再测自己的成片」这类工程化流程；也适合把它当「参考片为什么好看」的逆向拆解模板（先读 references/reference-breakdown.md）。交付面是 HyperFrames 的 index.html + MP4 与 VERIFY.md 证据。
不适合：不适合：① 有旁白、实拍主体或需要多场景的长片（本 skill 是纯动效/音乐驱动）；② 无预算或不愿调用付费生成服务的用户（音乐、SFX、hero 静帧/运镜都是付费路径，虽可自带素材替代）；③ 不愿把品牌素材上传第三方的场景；④ 环境不满足 Node 22+/FFmpeg；⑤ 想直接套模板出片的用户——SKILL.md 明确要求把 example brief 当章节映射模型而非可复制模板。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-28
方式 A · 人下载镜像包下载 motion-showreel.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agentcc870e83245405bd…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库nateherkai / nateherkai/hyperframes-student-kit
原始 GitHubnateherkai/hyperframes-student-kit ↗
Stars1070
最近推送2026-09-28
本 skill commit
0d30152a82许可MIT（仓库根 LICENSE = MIT License, Copyright (c) 2026 Nate Herk）；另有 licenses/PIPELINE-USE-PERMISSION.txt（教学包再分发授权）与 licenses/HYPERFRAMES-LICENSE（Apache-2.0，随包 HyperFrames skill 的上游许可）；GitHub API 因附加许可把仓库标为 NOASSERTION
本站信息
收录日期2026-09-06
分类内容创作
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。