/lw-workflow

LYR-SPEC v1.0 —《词稿规格单》规范

本库唯一的交接物。一物四用：对外交接、AB 测试对象、编译源（→Suno／YuE2）、验收基准。 与库一的 ARR-SPEC 双向耦合（这是本库的结构特点，库一对下游是单向的）。

配套：LYR-SPEC.template.yaml、example-*.yaml。写完按 §2 十条自查；中文按 lw-tone-check §2.3 手判倒字。

0. 使用纪律

1. ★ intent 五项不填齐，不许写第一句词。 这是本库唯一的硬门禁。
2. 写完逐条过十条自查（§2），不过的条目改掉或写明理由再交。这些是判据不是铁律。
3. 中文词按 lw-tone-check §2.3 手判倒字，并人工念一遍高风险处。
4. ★ 先词后曲时，旋律回来之后必须重跑倒字/协音检查——这一步最常被漏。
5. 交稿前过 lw-ai-tell-audit 的八条。

1. 字段规范

1.1 meta

1.2 intent —— 动笔前必填（★ 门禁）

为什么设门禁：AI 写的词不是"用词不好"，是没有人做过选择—— 它写出来的四段可以属于任何一首歌。这四项就是强迫做选择的地方。 详见 lw-song-intent。

1.3 prosody —— 词与旋律的咬合

先曲后词时来自 ARR-SPEC；先词后曲时由本表输出、反向约束 ARR-SPEC。

★ syllables 的填法：词写完之后，对着 lyrics[].lines 逐行数汉字再填，不要先定字数再凑词。只数汉字，标点与整行括号的 ad-lib 不算。这一项是历次测试里最稳定的差一个字的地方，所以顺序要反过来：先有词，后有数。

prosody:
  sections:
    - id: C1                      # ★ 必须与 ARR-SPEC.form[].id 一一对应
      syllables: [9, 9, 7, 11]    # 每句音节/字数。★ 一个元素 = 词稿里的一行
      stress_positions:           # 英文：重音位置；中文：旋律强拍落在第几字
      peak_syllable:              # ★ 全段最高音落在哪个字——这个字必须经得起唱
      melody_contour: "5→3 下行"
      notes: [67, 69, 67, 64]     # ○ MIDI 音高序列，给 倒字判定 用

★ 与库一必须一致的六个字段： form[].id / form[].bars / form[].name / meta.tempo / meta.key / vocal.persona 任何一边改了，另一边必须同步。

1.4 rhyme

1.5 imagery

1.6 narrative

1.7 asymmetry —— ★ 专门一节：刻意的不对称

受 lint 第 3、4、10 条约束：三项至少填两项；各段字数不许完全相同；副歌各遍文本不许完全相同。

★ 每一处不对称都要说得出理由。 为了破坏而破坏，和整齐一样机械。

1.8 lyrics —— 词本身

lyrics:
  - section: C1
    lines:
      - "第一行"
      - "第二行"

★ 分行不是排版，是指令——后端会把换行当成乐句边界读。 分行必须与 prosody.sections[].syllables 一致。详见 lw-suno-interface §3。

★ section 必须等于 ARR-SPEC form[].id（C1、A2 这种 id，不是 Chorus 这种名字）。两张规格单靠这一列咬合：编曲侧的 MusicXML 领奏谱、ChordPro 和 ABC 的 w: 行都从这里取词，按 form[].id 找到该段的小节，再按"每个音符一个音节"逐字贴上去，中文一字一音节。Suno 的段落标签由 ARR-SPEC 的 form[].name 派生，这里不重复存。

★★ 词里不许有任何注释/创作说明——后端会把它唱出来。注释写 note 字段。

1.9 render

render:
  suno: {format_notes: ""}      # 段落标签由 ARR-SPEC form[].name 派生，不在这里手填
  yue:  {}

★ 段落标签序列由库一的 mc-render-compile 统一编译；这里只放词这一侧的格式说明。

1.10 checks

checks:
  computed: {}      # 倒字率、协音违例、韵脚意外度…（脚本填）
  self_audit: []    # 人工逐条打勾
  exemptions: []    # ★ 豁免必须写理由，不许静默跳过

人工项固定这几条：

• one_thing 念出来是一句人话，不是主题词
• anchor_object 说得出颜色、大小、新旧
• 去掉标题和专名，别人能说出这首歌讲的是哪一件具体的事
• 每一处不对称说得出理由
• 中文：倒字高风险处实际唱/念过，确认无误

2. LYR-LINT 十条

人工逐条过；仓库内部有同名脚本做同样的检查，不随包发布。不过 = 改或写理由，不是禁止交付。

2.1 ⚠ 哪些条能判过/不过

第 2、7、8、9 条只报数，不判过/不过：

3. 与 ARR-SPEC 的双向接口

先曲后词：ARR-SPEC.form ＋ 旋律符割り  ──→  LYR-SPEC 的 prosody 约束
先词后曲：LYR-SPEC 的字数句式         ──→  反向约束 ARR-SPEC.form[].bars

★ 共享字段（改一边必须同步另一边）： form[].id / form[].bars / form[].name / meta.tempo / meta.key / vocal.persona

★ 与导出格式的接口：

intent、imagery、narrative、rhyme、asymmetry 是仅意图的块，行业里没有格式存它们，导出时整块作为文本随文件走。

4. 为什么是这些字段

直接对着「AI 直接写的词为什么一耳朵能听出来」清单来的：

★ 八条里六条可算。 比库一（十四条里九条）的比例更硬，因为文本不需要检测。