brand-video — 按需生成风格一致的无品牌露出视频
调用方式:/brand-video。一个命令,多种视觉效果。基于已验证的 RestoreAssist 运行(已交付 9 个视频)构建。从 styles.md 中选择一种风格,保持其他所有参数不变,从而在批次间和品牌间输出一致。
输入(仅当缺失时询问;合理推断)
- brand — RestoreAssist / Synthex / DR / NRPG / CARSI / CCW / Unite 或某个客户。决定主张、CTA 和语音。
- style —
styles.md中的一个键(默认flat-line)。这就是“外观”/下拉选项值。 - topic(s) — 一个角度,或一个列表用于批量生成(每个视频一个,并行)。
- voice —
ELEVENLABS_VOICE_ID(每个品牌不同;来自~/.hermes/.env)。关键:在生成前确认当前值——用户会经常更换。 - upload? — 默认:仅渲染并暂存。仅在用户要求时才上传至 YouTube 非公开。
流水线(每个视频 — 各自一个 slug 文件夹,从不共享目录)
- 脚本 →
<slug>/script.md:一段干净的旁白段落,约 120–140 字,约 12–16 个短句(一个句子 = 一个视觉节拍 = 一张图片),问题→解决方案→CTA。基于品牌维基进行主张验证;绝不捏造功能。以品牌的 CTA 行结尾。 - 语音旁白 → 运行捆绑的 tts.py(读取
ELEVENLABS_API_KEY+ELEVENLABS_VOICE_ID+DIR):cd <workdir> && set -a && . ~/.hermes/.env && set +a && DIR=$PWD/<slug> python3 <skill>/pipeline/tts.py生成<slug>/voiceover.mp3+<slug>/transcript.json(节拍)。记录节拍数。 - 图片 → 每个节拍一张,提示词 = 所选风格的 POSITIVE token + 该句子的具体场景 + 该风格的 NEGATIVE token,16:9 横板,保存为零填充的
<slug>/images/01.png …。- 生产 / 无头模式(默认):
python3 <skill>/pipeline/image_gen.py "<prompt>" <out.png>— 基于 Geminigemini-2.5-flash-image(“Nano-Banana”),通过 HTTPS 调用,GEMINI_API_KEY从环境变量读取。服务端运行;已端到端验证。这是应用工作者调用的方式(无需本地 MCP)。 - 交互模式(可选): 在 Claude 会话内运行时使用
mcp__margot__image_generate;使用 slug 前缀的文件名以避免并行冲突(参见 [[parallel-agents-shared-output-collision]])。
- 生产 / 无头模式(默认):
- 合成 →
python3 <skill>/pipeline/stitch.py <slug>→<slug>/final-1080p.mp4(1920×1080@25,图片时间来自节拍)。验证最终时长 ≈ 语音旁白时长。
批量生产与新外观
- 批量: 为每个主题分配一个子代理(并行),每个子代理拥有自己的 slug 目录。参见 RestoreAssist 运行记录中确切的代理提示格式。
- 重新配音(语音变更,脚本/图片不变):重新生成旁白,按
新总时长/旧总时长缩放list.txt中的持续时间,重新合成。(参见 revoice 模式。) - 添加新外观: 在
styles.md中添加一个代码块(positive/negative token)。该键立即成为可选风格——这个注册表就是下拉菜单的数据源。
上传(YouTube,可选)
浏览器文件上传已不可用(主机路径被拒绝)。使用 [[youtube-api-upload-restoreassist]] 中记录的 YouTube Data API 路径:Desktop OAuth 客户端 → 令牌存储在 ~/.hermes/yt-restoreassist-token.json → videos().insert privacyStatus=unlisted,category 27,not-for-kids;通过频道标题进行守卫;通过 uploaded.json 实现幂等。需要在 OAuth 客户端的 GCP 项目中启用 YouTube Data API v3。
安全护栏
- 主张必须真实(来自品牌维基/产品事实)。扁平插画 + 合成语音 → YouTube AI 披露通常选“否”(上传时确认;如果添加了 AI 音乐则改为“是”)。
- 每个批次保持一种风格以确保一致性。遵循 [[feedback-tight-code]] 保持
SKILL.md不超过 200 行。 - 参考实现 + 资产:
/Users/phill-mac/restoreassist-videos/。