mlua-pulse 0.1.0

# 完整作品工作流


## 你会学到什么


- 从 4 小节 loop 扩展到完整曲式。
- 为钢琴、小清新、硬核电子、管弦和 Kawaii Bass 选择结构。
- 用 phrase 减少复制粘贴，并在重复中加入变化。
- 在导出前检查响度、频段和动态。

## 适合谁读


已经能写旋律、鼓和和弦，但觉得示例“不像完整作品”的用户应该读本章。它不提供某首商业歌曲的复刻，而提供可复用的结构方法。

## 前置知识


- [序列、乐句与编排](arrangement.md)
- [节奏与鼓机](rhythm-drums.md)
- [混音](../02-sound-design/mixing.md)

## 心智模型


完整曲子不是更长的 loop，而是“重复、变化、对比、回归”。先把一个 8 或 16 拍段落写好，再做删减版、加强版、桥段版，最后用 `Song:add_phrase` 排列。

常用结构：

```text
intro -> verse -> chorus -> verse -> chorus -> bridge -> final chorus -> outro
```

电子结构：

```text
intro -> build -> drop -> breakdown -> build -> second drop -> outro
```

管弦草图：

```text
exposition -> development -> climax -> release
```

## 最小可运行例子


```lua
local pulse = require("pulse")

local function pad(volume)
  return pulse.sequence()
    :chords({pulse.chord("C3", "maj7"), pulse.chord("A2", "min7"), pulse.chord("F2", "maj7"), pulse.chord("G2", "dominant7")})
    :durations({1.0, 1.0, 1.0, 1.0})
    :instrument("warm_pad")
    :volume(volume)
    :effect("chorus", "wide")
end

local intro = pulse.phrase():add(pad(0.22)):repeat_times(2)
local chorus = pulse.phrase():add(pad(0.42)):repeat_times(4)

pulse.song()
  :tempo(112)
  :add_phrase(intro)
  :add_phrase(chorus)
  :master_effect("eq", "warm")
  :master_effect("limiter", "standard")
  :export_wav("output/full-workflow.wav", { normalize = "rms" })
```

## 参数和边界


钢琴小品可以用 A-A-B-A，每段 8 或 16 小节。小清新流行适合 intro、verse、pre-chorus、chorus、bridge、final chorus。硬核电子需要 build 和 drop 的能量对比，鼓和低音应更集中。管弦示例要安排弦乐、木管、铜管和合唱的进入顺序，不要所有声部从第一秒全开。

三分钟 Kawaii Bass 可以用 `section_beats = 16.0` 和 `section_repeats = 24` 组织，在合适 tempo 下保证 `duration_seconds >= 180.0`，但每个 16 拍段落都要有音色、鼓、fill 或旋律变化。

## 常见陷阱


不要让 chorus 只是 verse 更大声。真正的副歌通常有更密的鼓、更明确的 hook、更高或更宽的音色，但也要留动态空间。

不要把所有段落都导出到同一个响度感。段落内部可以有能量起伏，最终标准化只统一整首歌的输出。

不要写三分钟完全不变的 loop。即使是重复风格，也应该每 8 或 16 拍改变一个元素。

## 进阶用法


小清新：电钢和吉他负责和声，music box 或 flute 做 hook，鼓保持轻，pad 少量铺底。导出目标可用 `-16 dBFS`。

钢琴：重点是 velocity 和留白。用 `acoustic_piano` 主轨，少量 `slow_strings` 托住高潮，reverb 适中。

硬核电子：kick、snare、bass_808 和 FM growl 是核心。高频 lead 必须低通控制，master limiter 只是保护。

管弦：低弦给根音，中弦给和声，木管给旋律，铜管只在高潮强化。合唱要低音量铺开，不要压过主题。

## 相关章节


- [乐器目录](../02-sound-design/instruments.md)
- [合成算法](../02-sound-design/synthesis.md)
- [响度标准化](../04-export/loudness.md)
- [示例索引](../06-reference/examples.md)