render-logo-equation-card

用途\nrender-logo-equation-card 用于渲染一种以卡片为主体的短视频广告格式：时长 7 秒，画幅为 9:16。观众需要阅读的信息全部放在顶部三分之一的静态黑底卡片上，卡片下方是延时摄影风格的 b-roll，用于在信息流中抓住注意力。全片只有一个动画事件：CTA 文案在 2.0 秒处直接切出。没有旁白、没有字幕、没有剪辑点。\n\n主要能力\n- 卡片渲染：根据 card.json 生成 “无 CTA” 与 “含 CTA” 两张卡片图（card-no-cta.png、card-with-cta.png）。\n- 合成：把卡片与 b-roll 视频合成为成片，可指定入点、倍速，并可选择加入背景音乐。\n- 运动量检测：measure_motion.py 检测成片运动量，均值低于 1.5 即判为不合格（退出码 1）。\n- 内置校验：render_card.py 会强制检查合作方集成是否已确认、禁用关系类措辞、限制图标数量与标题格式、步骤字数，并在文案在实际尺寸下放不下时判定失败。\n\n使用方式\n命令示例：\npython render_card.py card.json --out-dir work/ # card-no-cta.png, card-with-cta.png\npython compose.py --broll broll.mp4 --cards work/ --out ad.mp4 --in 3 --speed 4 [--bed bed.mp3]\npython measure_motion.py ad.mp4 --cta-at 2.0 # exit 1 = reject\n\ncard.json 字段包括：logos（两个图标文件）、partner（名称与 integration_confirmed）、headline（两行，均以 “= ” 开头）、steps（四个、每个 5-8 词）、cta。示例中的 Slack 站会卡片只是 schema 示意，并非默认值；标题、合作方和步骤均来自用户品牌与选择。\n\n制作前需要先确定以下选项：headline_angle（“= …” 标题承诺的内容，如省时、消除痛点、新能力、将工作流集中到一处）、broll_subject（延时 b-roll 的内容，如产品使用、团队工作、工作空间、客户）、music（可选背景音乐或静音发布）。\n\n约束与限制\n- 只有 partner.integration_confirmed 为 true 才允许出卡，即仅在用户确认产品确实与该合作方集成、插件或导入互通时使用。\n- 禁用关系类措辞：partner、partnership、official、endorsed、certified、approved by、recommended by、#1、best 等；只能陈述产品与该合作方一起做了什么。\n- CTA 必须属于品牌自身，不得提及合作方，不得用于诱导评论。\n- 必须恰好两个方形应用图标（合作方在左），标题恰好两行且以 “= ” 开头，步骤恰好四个、每个 5-8 词，且不得使用 em 或 en 破折号。\n- 图标必须是用户提供或确认真实存在的文件，不得绘制或生成 logo。\n- b-roll 必须是真实延时摄影（建议 --speed 3-8 倍）；固定机位的实时镜头运动量约为参考值的 1/18，会被判为静止照片；不得使用其他公司广告素材或对其进行风格化改造；text-to-video 无法生成此类镜头，缺少实拍素材时应向用户索取。\n- 默认 --fit cover 铺满画面；横幅素材若以宽度适配会留下黑边。\n- 平面高对比度屏幕画面可保留；生成或重绘过的摄影壁纸与缩略图网格会出现涂抹感。\n- 音频为可选 --bed（如 create-music-elevenlabs 生成的 8 秒纯音乐），归一化到 -15 LUFS 并加短淡入淡出；也可以静音发布，在平台内再配乐。若要在平台上使用静音发布，则要使用静音版本。\n\n适用场景\n适用于需要快速产出竖屏信息流广告的品牌方或制作团队，尤其是以 “合作图标 + 品牌图标 = 成果” 这种等式表达为创意核心、并希望用实拍延时画面降低滑走率的场景。\n\n状态说明\n该工具已被取代：视频套件现通过 goose-studio 的 logo-equation-card 风格实现，使用 html-frames 1.2.1（卡片）、cut-footage 1.2.1（延时 b-roll）与 audio-mix 1.1.0（可选音轨）。当前渲染器为 goose-studio 的 create-logo-equation-card-video-ad 流程保留，行为不变，脚本仍可运行。