AI歌曲创作核心技能#

八层门禁链路（GATED WORKFLOW）#

所有歌曲创作必须严格按 8 层顺序执行。每层是一个 硬门禁（HARD GATE）——失败/不通过不得进入下一层。

text

GATE 0: RESEARCH     → 调研背景信息
GATE 1: OUTLINE      → 分段主题大纲 + 韵脚预分配
GATE 2: RHYME_BANK  → 逐段韵脚字库 + 词语释义
GATE 3: WRITE       → 反推造句（受预分配尾字约束）
GATE 4: VERIFY      → pypinyin 全量验证 + 修复
GATE 5: PRONUNCIATION → 生僻字扫描 + 替换 + --extra 拼音
GATE 6: CONFIRM     → 用户确认歌词
GATE 7: GENERATE    → mmx music generate + 发送
GATE 8: QA          → 听审 + 迭代修复

⚠️ 核心原则：每层产出必须验证通过后才能进入下一层。在 GATE 3 写词前，GATE 2 的韵脚字库必须已经 100% 确定（44字全局唯一）。不能边写边改韵脚。

---

GATE 0：调研背景#

目标：收集主题相关的历史、事件、特点、典故，输出调研笔记。

bash

# 企业/公司
mmx search query --q "公司名称 成立 历史 里程碑 产品" --limit 10 --non-interactive --quiet --output json

# 景点/地点
mmx search query --q "景点名称 历史 典故 特色 名人" --limit 10 --non-interactive --quiet --output json

# 特定领域（如六代机）
mmx search query --q "关键词 最新进展 2024 2025" --limit 10 --non-interactive --quiet --output json

产出：调研笔记（关键时间节点、人物、事件、数据）

门禁检查：时间线是否完整？核心技术/事件是否覆盖？ □

---

GATE 1：分段主题大纲 + 韵脚预分配#

目标：将叙事线拆为 11 段，预分配每段的韵脚组和 44 个全局唯一定位字。

韵脚模式选择#

模式规则适用**中东辙合韵（默认）**ing/eng/ong/iong 通押为 'eng' 组用户偏好，中文歌曲习惯严格分韵ing/eng/ong 各自独立学术验证AABAL1=L2=L4 同韵，L3 白脚异韵主题/企业歌曲全韵统一所有句同韵短歌/儿歌

AABA + 中东辙标准分配（11段 × 4句 = 44句）#

text

段韵分配（不可变）：4ang + 5eng + 2ong = 11段
L3白脚分配（不可变）：全部 en 组 = 11个白脚字
尾字总量（不可变）：12ang + 15eng + 6ong + 11en = 44字全局唯一

产出格式：

段标签主题段韵L1L2L4L3(en)核心内容1Introxxxang航光翔间xxx...........................

门禁检查：

• 11段是否都有明确主题？ □
• 段韵分配是否为 4ang+5eng+2ong？ □
• 44个字是否互不相同（肉眼初查）？ □
• 叙事逻辑是否通顺？ □

---

GATE 2：逐段韵脚字库 + 词语释义#

目标：为每个预分配的韵脚字提供常用词语和释义，供 GATE 3 造句参考。

产出格式（每段一组）：

text

### 段1【主题】韵母 ang — 航/光/翔/间(白脚)

| 韵脚字 | 常用词语（供造句参考） | 释义 |
|--------|---------------------|------|
| 航 | 启航、远航、领航、航空 | 出发；引领方向 |
| 光 | 荣光、曙光、光芒、追光 | 光辉；荣耀 |
| 翔 | 翱翔、飞翔 | 展翅高飞 |
| 间 | 瞬间、天地间、弹指间 | (白脚) 时段、空间 |

门禁检查：

• 每个字是否都有 ≥3 个可造句的词语？ □
• 白脚字（en组）是否标注了用途？ □
• 是否有生僻字混入词库？（如「筚」「缕」「旌」→ 提前踢出） □

---

GATE 3：反推造句#

目标：用 GATE 2 的预分配尾字反向造句。每段 AABA，L1/L2/L4 尾字必须是指定的段韵字，L3 尾字必须是指定的白脚字。

硬约束：

• ❌ 不得使用非分配的尾字
• ❌ 不得在段内换韵
• ❌ 「客户名/品牌名」只能出现一次，且在 Intro 低调位置
• ❌ 主线是业务/历史叙事，不是个人颂歌

产出：44 句完整歌词（无结构标签 — 纯文本，一行一句）

门禁检查：44 句是否写完？尾字是否与 GATE 2 分配一致（肉眼核对）？ □

---

GATE 4：pypinyin 全量验证#

目标：用 Python 脚本逐句验证韵母归属 + AABA 结构 + 尾字全局唯一性。

必须用 pypinyin 而不能用硬编码集合：

字硬编码判断pypinyin 正确结果穷ongeng (iong)穹ongeng (iong)雄ongeng (iong)逢ongeng (ong→介音u，归eng)崧engongpython

import re
from pypinyin import pinyin
from collections import Counter

def get_rhyme_group(ch):
    """返回 'ang'|'eng'|'ong'|'en' 韵母组"""
    py = pinyin(ch, style=0)[0][0].lower()
    m = re.findall(r'[bpmfdtnlgkhjqxzcsryw]+', py)
    initial = m[0] if m else ''
    final = py[len(initial):]
    if final in ['ang','iang','uang']: return 'ang'
    if final in ['eng','ing','ueng','iong']: return 'eng'
    if final in ['ong']: return 'ong'
    if final in ['en','in','un','ün','uen','ian','an','uan']: return 'en'
    return f'other({final})'

# AABA 验证
def validate_aaba(lines, seg_rhymes):
    """lines: 44个字符串, seg_rhymes: 11个段韵列表"""
    errors = []
    tails = []
    for si in range(11):
        s = si * 4
        g1,g2,g3,g4 = [get_rhyme_group(lines[s+j][-1]) for j in range(4)]
        sr = seg_rhymes[si]
        tails.extend([lines[s+j][-1] for j in range(4)])
        if not (g1==g2==g4==sr and g3=='en'):
            errors.append(f"S{si+1}: {g1}/{g2}/{g3}/{g4} (期望 {sr}/{sr}/en/{sr})")
    dups = {k:v for k,v in Counter(tails).items() if v>1}
    return errors, dups

验收标准：

• 韵脚错误 = 0 □
• 尾字重复 = 0（全局唯一） □
• AABA 结构 = 100% 正确 □

修复原则：发现重复尾字→优先替换高频字；发现韵脚错误→换尾字（必须同组且全局唯一）。

门禁检查：以上三项是否全部通过？ □

---

GATE 5：发音质量控制#

目标：扫描生僻字，替换高危字，为保留字准备 --extra 拼音提示。

生僻字风险分级#

字级定义策略示例乙级（超纲）HSK词汇表外强制替换，不保留筚、缕、旌丙级（低频）HSK丙级优先替换；不可替换时加 --extra峥、嵘、霆、铭、铸多音字有多个读音--extra 标注正确读音藏(cáng/zàng)、行(xíng/háng)

替换规则#

• 中间位字词（不在句尾）→ 直接替换为常用同义词，不影响韵脚
• 尾字（影响韵脚）→ 替换为同韵母组常用字，且必须验证全局唯一性
• 保留字 → 必须加入 --extra 拼音提示

产出：修复版歌词 + --extra 拼音提示字符串

门禁检查：

• 乙级字是否全部替换？ □
• 保留字是否都加了 --extra 拼音？ □
• 替换后韵脚是否重新通过 GATE 4 验证？ □

---

GATE 6：用户确认歌词#

目标：将歌词提交用户确认，未经确认不得生成音频。 这是硬规则。

产出：

• 纯文本歌词（无结构标签）
• 预计时长（44句×3.2秒≈2.3分钟，repeat≈4.7分钟）
• 韵脚验证结果（0错误）

门禁检查：用户是否明确确认？ □

---

GATE 7：音乐生成 + 发送#

目标：用正确参数调用 mmx music-2.6，生成后发送文件。

歌词双轨制#

场景是否含结构标签原因用户确认❌ 纯文本阅读体验mmx API✅ [Intro][Verse][Chorus]等帮助AI理解结构，提升生成质量

音乐风格匹配表#

歌曲类型--prompt 关键词--vocals--bpm--key航空/军工/史诗Epic cinematic orchestral, Chinese national style, military grandeur, soaring brass, timpani, building from solemn to triumphantPowerful male choir, heroic baritone solo105-115D/G major企业/品牌Warm positive corporate, steady rhythmic, modern, hopeful, choir climaxChoir, uplifting chorus100-110C major古诗词Traditional Chinese, slow tempo, guqin, xiao flute, sparse and elegantSweet child/古风女声60-80E minor景点/山水Cinematic ancient style, dizi flute, guzheng, flowing water imagery古风女声, sweet and ethereal70-90D minor温馨/亲情Gentle acoustic, piano-driven, warm and intimateWarm male baritone80-95F major

生成命令模板#

调用 mmx 前确保 PATH 包含 mmx 所在目录（安装位置取决于环境，常见于 ~/.hermes/node/bin/ 或 ~/.local/bin/）。用 which mmx 或查找确认路径后 export。

bash

# 确保 mmx 在 PATH 中（根据实际安装位置调整）
export PATH="<mmx安装目录>:$PATH"

mmx music generate \
  --prompt "风格描述" \
  --lyrics-file <歌词文件路径> \
  --vocals "人声描述" \
  --genre "流派" \
  --mood "情绪" \
  --instruments "乐器" \
  --tempo "速度" \
  --bpm 110 \
  --key "D major" \
  --use-case "使用场景" \
  --extra "Pronunciation: 生僻字=拼音, ..." \
  --model music-2.6 \
  --out <输出路径>.mp3 \
  --non-interactive --quiet

⚠️ --async 不能用于 music generate。 ⚠️ --lyrics-file 比 --lyrics 更稳定（避免命令行字符串过长）。 ⚠️ 不要硬编码绝对路径到技能中——让 agent 在运行时动态确认 mmx 位置。

文件发送#

python

send_message(
    action="send",
    target="<platform>:<chat_id>",
    message="🎵 歌曲描述 MEDIA:/tmp/song.mp3"
)

门禁检查：

• 结构标签是否在 API 调用中保留？ □
• 音乐参数是否与歌曲类型匹配？ □
• --extra 是否包含发音提示？ □
• 文件是否成功发送？ □

---

GATE 8：听审 + 迭代#

目标：听取生成结果，发现发音错误→回到 GATE 5 替换→GATE 4 重新验证→GATE 7 重新生成。

常见问题：

问题修复迭代路径某字发音不准替换为同韵脚常用字GATE 5 → 4 → 7某段情绪不对调整结构标签或 --promptGATE 7整体气场不够换 --genre/--mood/--bpmGATE 7时长太短加 repeat 或扩展段落GATE 1 → ... → 7

门禁检查：用户是否满意？ □

---

时长控制#

text

预估时长 ≈ 歌词总句数 × 3.2秒/句
24句 → 约77秒（不够）
44句 → 约141秒（单遍不够，repeat ≈ 4.7分钟 ✅）
56句 → 约179秒（边缘）
60~92句 → 推荐交付区间

硬规则：单遍不足 3 分钟必须 repeat 或扩写。 补足优先级：repeat 完整结构 > 增加 Verse > 增加 Bridge。

---

用户反馈处理优先级#

用户反馈信号级别处理"尾字重复太多不好听"FIRST-CLASS立即检查重复字 > 换韵脚分组 > 换不同意象字"发音不对，xx字读错了"HIGHGATE 5 替换该字 → GATE 4 → GATE 7"气场不够"MEDIUM调 --prompt/--genre/--bpm → GATE 7"某段歌词改一下"LOW局部替换 → GATE 4 验证

---

mmx-cli 参考#

模型路由#

任务模型命令歌曲生成music-2.6mmx music generate --model music-2.6歌词生成（备用）MiniMax-M2.7mmx text chat --model MiniMax-M2.7 --region cn图片生成image-01mmx image generate --model image-01视频生成hailuo-2.3mmx video generate --model hailuo-2.3

⚠️ lyrics_generation 不可靠（经常超时），用 MiniMax-M2.7 作为歌词生成的备用模型。 ⚠️ music-2.6-free 需要付费计划，不用。

声线参数#

期望声线--vocals男声合唱Powerful male choir with heroic baritone solo女声独唱Bright female soprano童声Sweet innocent child vocal合唱Choir, uplifting chorus男声独唱Warm male baritone

结构标签（mmx API 支持）#

[Intro] [Verse] [Pre Chorus] [Chorus] [Interlude] [Bridge] [Outro] [Build Up] [Solo]

---

审查清单#

text

□ GATE 0: 调研笔记是否完整？
□ GATE 1: 11段大纲是否通过用户确认？
□ GATE 2: 44字韵脚库是否 100% 确定？
□ GATE 3: 44句是否严格用预分配尾字造句？
□ GATE 4: pypinyin 验证是否 0 错误 + 0 重复 + AABA 全对？
□ GATE 5: 乙级生僻字是否全部替换？保留字是否加了 --extra？
□ GATE 6: 歌词是否已发给用户确认？
□ GATE 7: --model music-2.6？结构标签是否保留在 API 调用中？
□ GATE 8: 用户是否满意最终音频？

---

已知问题与解法#

问题解法尾字重复替换韵脚分组（ang↔eng↔ong轮换）→ 替换不同意象字（航→长/途）生僻字发音不准三层防线：扫描替换 → --extra 拼音 → 听审迭代硬编码韵母集合不可靠强制用 pypinyin 逐字验证lyrics_generation 返回空换用 MiniMax-M2.7 作为备用48句+ 长歌词超时Python subprocess 后台运行，等待约 160 秒粤语不支持music-2.6 输出仍为普通话

---

References#

• MiniMax CLI: https://github.com/MiniMax-AI/cli
• Platform Docs: https://platform.minimaxi.com/docs
• ClawHub: https://clawhub.ai/andyrenxu7255/ai-songwriter-renxu
• references/rhyme-table-20260522.md — 实测押韵表
• references/session-20260522-chengfei.md — 成飞案例完整复盘