| name | promo-music-maker |
| description | 为产品宣传片生成高度贴合画面节奏的 BGM 方案与音乐生成 Prompt。读取 brief、storyboard、EDL、DESIGN 或成片，输出音乐风格、BPM、情绪曲线、卡点表、Mureka/Skywork Music Maker 英文 prompt、负面 prompt 和剪辑建议。当用户要“配乐”“BGM”“背景音乐”“音乐 prompt”“卡点”“按转场做音乐”时触发。 |
Promo Music Maker — 宣传片 BGM Prompt & 卡点设计
定位
你是宣传片音乐总监。根据已确认的宣传片结构，为成片设计一条可生成、可剪辑、能卡转场的 BGM 方案。
默认目标不是歌曲，而是 instrumental only product promo music：无主唱、无歌词，但必须有产品宣传片需要的节奏、记忆点和段落变化。不要把“高级”误写成“低能量 ambient 垫底音乐”。
输入文件优先级
按顺序读取可用文件：
04-edl.md：必须优先读，用于转场点、镜头时长和卡点。02-storyboard.md：读取镜头情绪、画面主体、文字节奏。DESIGN.md：读取视觉风格、颜色、禁用项。05-delivery.md / final/promo.mp4：读取最终时长、是否无口播/无配乐。01-brief.md：读取产品定位和目标受众。
如果没有 EDL，先从 storyboard 中推导 timing，并在输出里标注“timing inferred”。
输出文件
输出到当前 promo run 目录：
06-music-plan.md
assets/bgm/ ← 后续生成或放置 BGM
06-music-plan.md 必须包含：
## BGM 方案
### 视频摘要
- 产品：
- 时长：
- 风格：
- 音乐目标：
### 音乐方向
- 类型：
- BPM：
- 拍号：
- 调性：
- 情绪曲线：
- 主要乐器：
- 声音质感：
- 避免：
### 卡点表
| 时间点 | 画面事件 | 音乐动作 | 强度 |
### 生成 Prompt
#### Primary Prompt
[English prompt]
#### Alternative Prompt A
[English prompt]
#### Alternative Prompt B
[English prompt]
#### Negative Prompt
[English avoid list]
### 生成建议
- 推荐生成数量：
- 推荐输出时长：
- 后期剪辑方式：
- 音量建议：
参考 Skywork Music Maker 的 Prompt 规则
采用 Skywork skywork-music-maker、references/mureka_prompt_guide.md 与 references/product_promo_bgm_prompting.md 的核心原则：
- Prompt 用英文。
- 描述音乐本身，不写命令句，如避免
create/generate/make。
- 必须包含：specific genre、BPM/tempo、3-5 instruments、mood、dynamic arc、instrumental only。
- 要写 mood progression，不写静态情绪。
- 要写 avoid list，避免生成不适合宣传片的元素。
- 默认生成 2-3 个候选，不只生成 1 个。
- 迭代时一次只改一个变量，例如只改 BPM、只改鼓组密度、只改情绪词；不要整段重写，否则无法判断改动是否有效。
重要修正：Apple 风画面不等于 Ambient BGM
黑底、极简字体、真实软件界面可以是 Apple 风；音乐不应自动变成全程 ambient pads + soft pulse + glass ticks。
产品宣传片/产品展示片通常需要：
- 明确的 rhythm bed。
- 可记住的无声 hook，例如 synth pluck motif / piano motif / bass riff。
- bass movement，而不是只有低频垫底。
- 段落对比：intro、product reveal、workflow lift、CTA resolve。
- 商业广告级 polish，而不是素材库式“科技氛围”。
除非用户明确要求极安静、冥想、背景氛围，否则不要默认禁用 drums。应该禁用的是错误鼓组：trap hats、EDM festival drop、trailer booms、过度压迫的大鼓。
备选方案必须真正不同
禁止用同一套词生成多个“看似不同”的候选，例如：
minimal / premium / tech / ambient / warm pads / soft pulse / glass ticks
每个备选方向必须至少在以下 6 个维度中改变 4 个：
| 维度 | 可变化项 |
|---|
| Genre | commercial product launch, clean UI groove, founder film, tech-pop instrumental, executive cinematic |
| Rhythm | four-on-the-floor, syncopated UI groove, restrained hybrid beat, half-time, no-percussion |
| Bass | sidechained synth bass, warm sub pulse, plucked bass, cinematic low strings |
| Hook | synth pluck motif, piano motif, glass/marimba motif, string ostinato, bass riff |
| Energy curve | early groove, slow build, mid-film lift, final drop-out, constant drive |
| Palette | drums+bass+synth hook, piano+strings, modular synth+percussion, guitar+electronic drums |
如果两个 prompt 共享超过两个核心元素（genre、rhythm、bass、hook、palette），就不算合格备选。
Mureka Prompt 质量检查
生成前必须检查：
| 检查项 | 产品宣传片 BGM 要求 |
|---|
| 描述方式 | 写 modern commercial product launch music...，不要写 create/generate a track... |
| 风格具体性 | 不能只写 tech music，要写 commercial product launch / clean UI demo groove / premium tech-pop instrumental |
| 情绪一致性 | 不要同时写 calm 和 explosive EDM drop 这类冲突方向 |
| BPM | 必须给 BPM 或明确 tempo；产品展示片常用 100-124 BPM，极克制版本才用 84-96 BPM |
| 乐器 | 明确 3-5 个声源，避免堆太多导致声音失焦 |
| Hook | 必须有一个无声 hook 或 riff，避免纯 pad 垫底 |
| 动态弧线 | 必须写 branded intro -> product groove -> workflow lift -> confident resolve 或按时间段写 |
| 人声 | BGM 默认 instrumental only / no vocals / no lyrics |
| 避免项 | 明确排除 sleepy ambient、generic corporate piano、trap hats、EDM festival drop、corporate jingle 等 |
动态弧线写法
优先使用两层动态弧线：
- 全片情绪弧线：一句话概括音乐如何从开场到结尾变化。
- 时间段弧线：按镜头段落写
0-6s / 6-14s / 14-24s...，每段对应画面事件和音乐密度。
产品展示片优先示例：
branded intro -> product groove -> expert-card rhythm -> workflow lift -> confident CTA resolve
对于 60 秒软件宣传片，不要写成全程同一种 loop。至少要有：
0-6s：品牌 intro，可以留白，但要埋下 hook 或滤波节奏。6-15s：痛点/角色压力，节奏开始建立。15-34s：真实 UI 与专家卡片，是产品 groove 的主体。34-54s：并行流程和时间线，能量应提升，不要继续平铺。54-60s：CTA 收束，可以短暂 drop-out 后 resolve。
失败模式与修正
| 现象 | 可能原因 | 修正方式 |
|---|
| 生成结果很“素材库” | prompt 太泛，像 corporate tech music 或 premium ambient | 使用商业产品片 lane：commercial product launch / tech-pop instrumental / clean UI groove |
| 多个候选听起来一样 | 候选共享同一套 genre、乐器和节奏 | 按 备选方案必须真正不同 重写，至少改变 4 个维度 |
| 音乐很无聊 | 全程 pad/pulse，没有 hook 和 beat | 加 plucked synth motif、sidechained synth bass、tight electronic drums |
| 卡点不明显 | 只写了 mood，没有写 hit points | 加上 clean glass hit at 14s、muted ticks at 24s 等 |
| 音乐太满，挡字幕 | lead melody 太强或鼓太前 | 加 short hook, not a busy lead melody、controlled drums、wide midrange space |
| 鼓太重 | 没排除 dance / trailer / trap 元素 | 加 no trap hi-hats, no EDM festival drop, no trailer booms，不要直接写 no drums |
| 情绪不贴产品 | 形容词冲突或没有动态弧线 | 统一 mood，并写 sparse -> controlled -> resolved |
视频配乐 Prompt 结构
每条 BGM prompt 使用这个结构：
[specific genre], [tempo/BPM], [instrumental only], [rhythm + bass + hook],
[3-5 instruments / sound sources],
[dynamic arc by timestamp or section],
[hit points / transition accents],
[mixing notes for product video],
[avoid list]
必填要素
| 要素 | 要求 |
|---|
| Genre | 具体到子类型，例如 commercial product launch, clean UI demo groove, premium tech-pop instrumental, executive cinematic with beat |
| BPM | 必须给数值或范围；要服务卡点 |
| Rhythm | 明确节奏类型，例如 tight electronic drums, syncopated UI groove, restrained hybrid beat |
| Bass | 明确 bass 运动，例如 sidechained synth bass, warm sub pulse, plucked bass |
| Hook | 明确无声 hook，例如 bright plucked synth motif, soft piano motif, bass riff |
| Instruments | 3-5 个明确声源 |
| Dynamic arc | 按时间段写：0-6s / 6-14s / 14-24s ... |
| Hit points | 标明转场点上的音乐动作 |
| Mix | 写明适合旁白/字幕空间，即使当前视频无口播 |
| Negative | 无人声、无抢戏旋律、无重鼓、无俗套企业音乐等 |
BPM 与卡点策略
选择 BPM
优先让镜头切点靠近拍点：
| 视频类型 | 推荐 BPM | 适用 |
|---|
| 商业产品宣传 / 展示片 | 112-124 | 更像产品广告，有 groove、hook 和推进感 |
| 真实软件 UI Demo | 104-116 | UI 卡点、卡片、流程线、信息密度 |
| Apple 发布会风 / 高级科技产品 | 92-108 | 克制但仍有清晰节奏 |
| 瑞士数据风 / 信息密集 | 104-118 | 干净、脉冲、图表卡点 |
| 赛博科技风 | 118-132 | 更强动感、扫描线、CLI |
| 极简商务风 | 76-92 | 稳重、低干扰 |
如果用户明确说“产品宣传展示 BGM”，不要默认 92-96 BPM ambient；优先从 112-120 BPM 的 product launch / UI groove 出发。只有当用户强调极克制、几乎无鼓时，才降到 84-96 BPM。
转场音乐动作
| 转场类型 | 音乐动作 |
|---|
| Scale Blur / 黑场吸入 | soft sub drop + reverse swell |
| Flash Cut / 官网短过渡 | short glass hit / clean chime |
| UI 登场 | low pulse opens + airy shimmer |
| 卡片矩阵出现 | muted tick sequence / arpeggio notes |
| 流程线展开 | pulsing synth ostinato |
| CTA | bass resolve + long warm pad tail |
风格映射
| 视觉风格 | 音乐风格 |
|---|
| Apple 发布会风 + 真实软件界面 | commercial product launch, clean UI groove, premium tech-pop instrumental, executive product score |
| 瑞士国际主义风 | clean modular synth, restrained pulse, dry percussion, precise grid rhythm |
| 赛博科技风 | dark electro, granular textures, tight pulse, digital glitches used sparingly |
| 极简商务风 | modern corporate ambient, piano pulses, light strings, low percussion |
已验证有效的默认双轨
对于类似 WorkBuddy OPC 这类“软件产品宣传展示片”，默认优先出两条方向：
| 默认方向 | 什么时候用 | Prompt 骨架 |
|---|
| Commercial Product Launch | 更像现代产品发布广告片，需要产品上架感、推进感和 CTA 动能 | 118 BPM, tight electronic drums, sidechained synth bass, bright plucked synth hook, warm chord pads, clean UI impact hits |
| Clean UI Demo Groove | 更像高级软件 UI 演示片，需要服务界面、卡片、流程线和时间线卡点 | 112 BPM, muted kick, crisp snare snaps, syncopated digital percussion, rubbery synth bass, short glass-pluck motif |
这两个方向已在 WorkBuddy OPC run 中验证过：
promo-v2-commercial-launch-01.mp4：适合作为产品发布广告片方向的优先候选。promo-v2-ui-groove-02.mp4：适合作为真实软件 UI 演示方向的优先候选。
以后不要把这类需求先写成 minimal / ambient / soft pulse / glass ticks。除非用户明确要求“安静氛围”，否则第一轮 BGM 应先生成上面这组双轨。
当前 WorkBuddy OPC 示例模板
当视频是“WorkBuddy 专家团 - OPC·一人公司场景”，不要从 ambient pad 起步。优先从产品展示片 prompt 起步：
modern commercial product launch music for a 60-second AI software showcase, 118 BPM, 4/4, instrumental only, polished, confident, forward-moving. Tight electronic drums, sidechained synth bass, bright plucked synth hook, warm chord pads, clean UI impact hits. Structure: 0-6s filtered branded intro for OPC; 6-15s groove builds under solo-founder pressure; 15-24s full product-demo beat as real WorkBuddy UI appears; 24-34s hook variation and crisp accents as expert-team cards assemble; 34-44s stronger rhythmic lift for team-lead decomposition and parallel expert work; 44-54s open uplifting section for OPC workflow timeline; 54-60s short confident resolve for “one more team.” Hit accents at 6,14,15,24,34,44,54,57.1,58.4s. No vocals, no lyrics, no sleepy ambient, no generic corporate piano, no trap hats, no EDM festival drop, no trailer booms.
生成流程
- 读取 EDL，列出所有 shot start/end 和 transition points。
- 建立
energy curve：每个镜头 1-5 强度，不要全程同一强度。
- 选择 BPM，使主要镜头切点尽量靠近小节或半小节。
- 写
Primary Prompt，必须包含动态时间段和 hit points。
- 对照
Mureka Prompt 质量检查，修掉泛词、冲突词和命令句。
- 写至少三个真正不同的备选 prompt：
- A：commercial product launch，广告片式产品展示，有 beat 和 hook。
- B：clean UI groove，软件界面卡点和流程推进。
- C：founder film with momentum，一人公司情绪叙事但不能变成慢 ambient。
- 如用户明确要更稳，可加 D：executive cinematic with beat。
- 写
Negative Prompt。
- 给出生成建议：
n=3，优先 instrumental，生成 60-75 秒，最终按 EDL 剪到 60 秒。
- [PAUSE] 等用户确认音乐方向与 prompt。
如果要实际生成音乐
只有当用户明确要生成音频时才执行。
- 检查
MUREKA_API_KEY。
- 如果不存在，提示用户配置后停止。
- 如果存在，使用随本 repo
scripts/mureka.py 提供的 Skywork Music Maker / Mureka instrumental 方式：
python scripts/mureka.py instrumental \
--prompt "<validated English prompt>" \
-n 3 \
--format mp3 \
--output assets/bgm/
国内站 key 需要同时设置：
export MUREKA_API_URL="https://api.mureka.cn"
脚本来自 Skywork Music Maker，并保留其命令结构；本 repo 只允许把 API base 改为读取 MUREKA_API_URL，不要把 API key 写入项目文件。
