简介 saas-motion-video 是一个围绕软件产品宣传片与动态视频制作的技能包，基于 HyperFrames 生态运行，采用 saas-motion-kit 的七阶段流程。它的核心理念是：你（AI）是制片人，用户是创意总监，各阶段按顺序执行，并在每个门槛处停下来等待人工决策，从而把用户的审美保留在流程中。该套件的一条硬性规则是：两部影片不应给人同一部片的感觉，因此禁止在片内或用户近期影片中重复使用特效、转场或组件，并要求每部影片至少发明一个新组件。
使用前提 需要先安装 HyperFrames 技能（npx skills add heygen-com/hyperframes）。若 /hyperframes 不可用，需请用户安装并重启会话。开始前需阅读 playbook/README.md，并在进入各阶段时阅读对应阶段文件。
七阶段流程
- 需求简报：最多向用户提四类问题——核心信息、渠道/格式、声音（音乐、音效、配音或静音）、事实来源（URL 或文档），并询问是否有喜爱的参考视频。每个参考视频需运行 python tools/breakdown.py <video> --id NN --creator … --url … 并在 REFERENCES.md 中署名，借鉴的是语法而非素材。根据模板写出 BRIEF.md，等待用户确认。
- 组件清点：若有 URL，运行 npx hyperframes capture。对真实 UI 打分，并按组件提出「真实」或「虚构」的归类。严禁编造功能、客户或统计数据。等待用户批准清单。
- 主题选择：从 docs/themes/data/*.json 中建议 2–3 个契合受众的主题（阅读其 summary、fit 与 best_for）。可用 python tools/pick_themes.py --tone <语气> --audience "<受众词>" --history ~/.motion-ledger.json 起步，该工具会跳过用户最近五部影片用过的主题。为每个候选主题按用户品牌快速绘制一个 HTML 静态帧。等待用户选择。
- 分镜与创意：先写「信息与语气」句子（「我想以___语气表达___，让观众感到___」），再写分镜台账（每个镜头一行：入场、转场、缓动、方向、配色、镜头、组件、新组件、音效、备注），最后绘制帧。从 creative/tone-matrix.md 选择手法，从 creative/transition-atlas.md（加上 HyperFrames 自带集）选择转场，并用 creative/component-forge.md 锻造至少一个新组件。运行 python tools/variety_audit.py STORYBOARD.md --history ~/.motion-ledger.json 并修复每个警告，或将有意重复标记为 motif:。随后绘制一页草图。屏幕文字保持最少。门槛：审计无警告（或剩余警告均有解释），且静音状态下静态帧也能读出故事。
- 构建：交由 HyperFrames 工作流处理（URL 驱动的宣传片用 /product-launch-video，循环与定制作品用 /general-video）。保持每帧可定位且确定性，运行 lint、snapshot 与 check。等待用户批准预览。
- 声音：音乐驱动时先建节拍网格并踩小节剪辑；音效使用温暖且有音高的音色（tools/warm_sfx.py）；静音也是有效选择。等待用户批准混音。
- 交付：以 4K 渲染，再用 tools/deliver.sh 降采样；循环作品运行 tools/loop_check.py；报告实际时长、大小与路径。通过 python tools/variety_audit.py STORYBOARD.md --history ~/.motion-ledger.json --append "<film>" --theme <NNN> 记录影片以便下一部避开。每隔几部影片可提供 python tools/history_report.py ~/.motion-ledger.json -o motion-history.html 让用户查看其惯用选择。等用户确认目标屏幕效果。
硬性规则 仅使用官方标志，不得重绘品牌标记；非拉丁字符需本地打包 latin-ext 字体子集，大写文字需手写而非依赖 CSS text-transform（会破坏土耳其语 i/İ）；禁止进度条、渐变文字、纯 #000/#fff，UI 上禁止弹跳或弹性缓动；文字要少，若故事需要阅读则应重新设计画面；每个参考视频都必须按名称与链接署名（REFERENCES.md 与台账中的 ref:<id>，审计会校验），不得把他人的影像、帧或音乐放入影片或仓库；每个转场都必须回答「为何在此处用这个」，不得连续使用同一转场，至少涵盖三个转场家族，约每 15 秒安排一次惊喜。
适用场景与限制 适用于需要为软件产品制作宣传片、产品发布视频或循环动画的场景，尤其是重视品牌一致性与创意多样性的团队。限制包括：依赖 HyperFrames 技能与多个本地 Python 工具（breakdown.py、pick_themes.py、variety_audit.py、warm_sfx.py、deliver.sh、loop_check.py、history_report.py），需按阶段人为把关，无法完全自动化；具体价格、平台支持范围与效果指标暂未提供。