0 · 三分钟看懂：这个工具能干什么
这是一套「你说一句话，它给你一首歌」的工具：一句话→写词→（选风格/声线）→生成→试听/下载。你不需要懂乐理，也不用填一堆英文，选好风格点生成就有成品 mp3。
入口在哪
- 工作台首页 → 气泡云里的
🎵 AI 歌曲；或桌面「写歌页.url」图标 - 地址：
http://127.0.0.1:8090/ms/（第一次用要先登录：右上「💰 点数」→ 填手机号 → 找管理员要登录码 → 登录）
界面分左右两栏
| 区域 | 干什么 |
|---|---|
| 顶栏 | 本功能引擎选择（本机 / 云端）·「💰 点数」登录看余额 ·「⏻ 启动油画布」手动起引擎 ·「← 返回首页」 |
| 左栏 | 三步走：① 一句话写词 → ② 歌词（可改/可粘） → ③ 描述与参数（内置风格 / 声线 / 时长 / 档位…），最下面 ▶ 开始生成 |
| 右栏 | 本地模型（第一次先下载）· 进度 · 后台日志（出错看这里）· 播放器 · 我的歌 · 回收站 |
最省事的用法（推荐新手照抄）
- 在 ① 写一句要求，例：
写一首伤感歌曲 女生 烟嗓→ 点「✍️ 一句话写词」 - 在 ③ 的「内置风格」选一个（如「抖音爆款」或「烟嗓·女声磁性」）——选了就确定生效，不用再扩写
- 点「▶ 开始生成」→ 看右栏进度跑满（1 分钟歌约 2~3 分钟）
- 完成后上方播放器试听；满意就去右栏「📚 我的歌」点「⬇ 下载」
计费
「出歌 / 写词 / 扩写」都要先登录并按点数或免费额度计费（见第 ⑩ 节）；而选内置风格、选声线、试听、下载这些是本地处理，不额外扣费。
① 一句话写歌 → AI 写词
干什么用的把「一句话想法」交给 AI，它直接帮你写出一版带完整结构的歌词（主歌 / 副歌 / Bridge / 尾句），并自动填进下面的歌词框。你完全不用自己写词。
怎么用（第 1 步卡片）
- 在输入框写你的要求，例：
写一首伤感歌曲 女生 烟嗓、江湖老兵落幕、东北大秧歌 过年 - （可选）填 情绪，例：苍凉 / 宿命感 / 热血 / 微醺伤怀；选 人声（男声 / 女声 / 纯音乐（无歌词））；选 声线（见第 ④ 节，不想选就留「跟随风格默认」）
- 点「✍️ 一句话写词」→ 等约 10~30 秒
- 看到提示「✓ 完成 · 引擎 · 共 N 句（含重复副歌）」，歌词自动出现在第 2 步的框里
- 不满意就点「🔄 重新生成」再抽一版；满意就进下一步
计费
写词走的是云端大脑，按 token 扣点，一首词通常几分~几毛；会员/免费额度规则见第 ⑩ 节。
② AI 扩写（三步走：意境解析 → 英文工作单 → 回填参数）
干什么用的你没选内置风格、想让它「按这首歌的意境自动配器」时用它。AI 会读懂你的歌词，给出该用什么乐器、什么速度、什么调、怎么唱，并把这些自动填进下面的参数框。
怎么用
- 确认第 2 步的歌词框里已经有词（自己写的、粘的都行）
- 点「✨ AI 扩写（查这种意境该用什么乐器/步数/拍号/调性）」→ 等十几秒
- 看下方提示「✓ 已填：英文描述 + 风格/情绪/步数/CFG/拍号/调性/BPM」即为成功
- 它会自动回填这些框：英文描述（完整 Caption）、情绪、步数、CFG、拍号、调性、BPM
- 并在「AI 对歌词意境的理解」框写一段中文解析（讲什么 / 情绪曲线 / 关键意象 / 建议速度·拍号·调性 / 人声定位）——不对就去改歌词或情绪，再点一次扩写
扩写其实是三步走
| 步骤 | 它在做什么 | 你能看到 |
|---|---|---|
| ① 意境解析 | 读懂歌词讲什么、什么情绪 | 「AI 对歌词意境的理解」框里出现中文解析 |
| ② 生成英文描述 | 写成给「编曲人」看的三段式工作单（Global Metadata / Vocal Details / Arrangement） | 「英文描述（完整 Caption）」框被填满 |
| ③ 回填参数 | 把风格/情绪/拍号/调性/BPM/步数/CFG 填进对应控件 | 下方「🎨 风格 · 😐 情绪 · 拍号 · 调性 · BPM · 步数 · CFG」一行；再下面「📌 依据… 乐器… 负面…」一行 |
计费
扩写走云端大脑，按 token 扣点（几分~几毛）。选内置风格则完全不调大模型、不扣这笔扩写费。
③ 内置风格 28 条（选它 = 确定性出效果，不用扩写）
干什么用的第 ③ 步顶部「内置风格」下拉里有 28 种成套配方（乐器、节奏、人声、速度都配好了）。选一条，后端不调大模型，直接把这条风格确定性地拼进 Caption——保证真的起作用。这是最省事、最不会翻车的用法。
怎么用
- 第 ③ 步最上面「内置风格」下拉：默认「（不指定 · 走 AI 扩写）」和「🎲 随机（每首自动换一个）」
- 挑一条你想要的风格（不确定就先「🎲 随机」）
- 选中后提示栏会显示「✅ 风格【X】已写进 Caption（配器 命中/总、BPM …）→ 直接点生成，不用扩写」
- 然后直接点「▶ 开始生成」即可
28 条风格一览（举例）
抖音爆款（短视频热歌）· 中国风·中国大鼓 · 东北风（大秧歌·民俗）· 二人转 · 萨满（仪式吟唱）· 民谣（木吉他叙事）· 钢琴叙事（情感慢歌）· 电子氛围 · 摇滚（乐队）· 爵士（蓝调抒情）· 说唱（Boom Bap）· 武侠古风 · 戏曲（国粹唱腔）· 民族打击（鼓阵）· 城市流行（City Pop）· 雷鬼 · 波萨诺瓦 · 放克 · 轻音乐（纯器乐·无人声）· 暗黑氛围 · 后摇 · 童谣 · 军旅进行曲（合唱）· 田园民谣 · 古典（室内弦乐）· DJ版（嗨曲·电子舞曲）· 烟嗓·男声沧桑 · 烟嗓·女声磁性。
计费
选内置风格 = 确定性拼 Caption，不走大模型 → 不扣扩写费；只有「开始生成」这一步按出歌计费。
④ 声线 15 条（决定「谁在唱、怎么唱」）
干什么用的第 ① 步卡片里的「声线」下拉，共 15 项（含默认「跟随风格默认」）。选一条 = 指定这首歌的人声音色与唱腔，后端会把它写进人声细节里。
怎么用
- 第 ① 步卡片第二行，找到「声线」下拉
- 不指定就留「（跟随风格默认）」，让风格自己决定人声
- 想锁定就用它挑：压嗓·帝王音、教父音（低沉沙哑）、鼻腔·鼻压怒音、撕嗓·撕裂爆发、喉腔·炸麦穿透、原嗓·干净有力、烟嗓·沧桑男声、烟嗓·磁性女声、低音炮·浑厚男低、清澈少年音、清亮女声、甜美少女音、气声·耳语温柔、黑嗓·魔音（极端，慎用）
- 选完照常「开始生成」
计费
选声线是确定性写进 Caption，不额外扣费；出歌时才按出歌计费。
⑤ 参数：档位 / 时长 / CFG / 种子 / Tiled
干什么用的第 ③ 步下面的参数区，控制「出什么样、出多长、多快」。大多数时候保持默认就行，下面只说你需要知道的。
逐个说清楚
| 参数 | 是什么 / 怎么选 |
|---|---|
| 档位 | 官方 30 步（质量优先） 或 8 步快出（LoRA）。默认官方档，质量更好；想快点出用 8 步档（质量略降）。 |
| 步数 | 跟着档位走：官方=30、快出=8。只读，不用手改。 |
| 时长 | 默认「自动（按歌词推算，保证前奏+收尾）」，也可手选 30 / 45 / 60 / 90 / 120 / 180 / 240 / 300 秒。它是「上限」不是「目标」：歌词少→歌短，歌词多→歌长，别当成固定长度。 |
| CFG | 贴合度，默认 1.7。系统会把超过 1.8 的压回 1.7、低于 1.5 的提到 1.5，一般不用动。 |
| 种子 | 0 = 每次随机（每首都不一样）；填一个固定数字 + 同样参数，可复现「同一首」。 |
| Tiled | 默认「自动」。长歌（超过 240 秒）会自动开，防显存爆；一般不用改。 |
| 拍号 / 调性 / BPM | 4/4、3/4、6/8、2/4；调性可「自动」或指定（A minor…）；BPM 留空=自动。选风格或扩写时会自动回填。 |
计费
改参数本身不扣费，只有「开始生成」那一下按出歌计费。
⑥ 生成与耗时（点一下，等它唱完）
干什么用的把前面填好的东西提交给本机显卡出歌。
怎么用
- 点「▶ 开始生成」
- 看右栏「⏳ 进度」：进度条 + 阶段文字一路走 —— ①写词 → ②（按风格/AI）写 Caption → ③ 预清理显存 + 提交 → ④ 生成中（模型正在唱）→ 完成
- 跑满后，页面顶部弹「✅ 生成完成！歌曲在页面下方播放器里」，并自动滚到播放器
- 点播放器试听，满意去右栏「📚 我的歌」下载
大概等多久（官方 30 步档）
| 歌长 | 大约耗时 |
|---|---|
| 约 1 分钟的歌 | 约 2~3 分钟 |
| 约 3 分钟的歌 | 约 6~9 分钟 |
| 8 步快出档 | 明显更快（质量略降） |
modules\songmaker\logs\songmaker.log），能看出卡在哪一环。计费
「开始生成」这一步才扣费：本地出歌走免费额度/会员；云端出歌按点（见第 ⑩ 节）。
⑦「我的歌」：试听 / 下载 / 删除 / 回收站
干什么用的管理你已经出的所有歌。
怎么用
- 右栏「📚 我的歌（▶播放 / ⬇下载 / 🗑删除）」：每首一行，显示文件名 + 大小(MB) + 时间，右边三个按钮
- 「▶」→ 上方播放器播放（播放器带 ±15 秒快进、进度条、0.75~2 倍速）
- 「⬇」→ 浏览器直接下载 mp3
- 「🗑」→ 先把歌移进回收站（可恢复），不会直接删掉
- 右栏「🗑 回收站」：列出已删文件，可点「↩ 恢复」找回；「🧹 一键清空」清空回收站（清空前会问一次）
- 另有「📂 打开回收站文件夹」「📂 打开作品文件夹」直达磁盘；左侧也有「🔄 刷新曲库」手动刷新列表
计费
播放 / 下载 / 删除 / 恢复 / 清空都是本地操作，0 点。
⑧ 为什么要「有前奏、有收尾」：出片自动验收
干什么用的这是这套工具最省心的地方：它不会「发出去就不管」，而是每次出歌后自动体检，发现「没唱完被截断」会自动加长重跑。
它自动查什么（出片验收）
| 检查项 | 判什么 |
|---|---|
| 时长 | 是否短到异常（有效音频） |
| 码率 | 是不是低到不正常 |
| 静音 | 整首是不是空音频 |
| 硬切检测 | 末尾 2 秒是不是还满电平、最后 1 秒有没有「衰减收尾」——没有就疑似被时长上限硬切（没唱完） |
| 前奏检测 | 开头是不是明显更轻（=有独立前奏铺垫，不是一上来就唱） |
发现被截断会怎样
- 工具判定「疑似撞时长上限被硬切」后，自动把时长上限加长（约 +30 秒或 ×1.3）
- 自动重跑一次（同一次出歌里的兜底，不额外扣费）
- 完成后结果显示「前奏 ✓ / 收尾 ✓（衰减 x dB）」；实在不行会提示「建议重跑」
计费
验收是本地检测，不扣点；自动加长重跑发生在同一次出歌流程内，不重复扣费。
⑨ 本地模型：第一次用先下载（MiniMax Music3 三件套）
干什么用的出歌靠本机显卡上的模型。第一次使用先把模型下齐，之后就能一直出歌。
怎么用
- 右栏「💻 本地模型（第一次用先下载，下完就能出歌）」卡 → 点「🔄 检测」
- 会列出三件套及状态：音乐主模型 DiT fp16（约 4.6G） / 文本编码器 pruned int8（约 8.6G） / VAE 解码器 dav（约 0.2G）
- 缺哪个就点哪个的「⬇ 下载」→ 支持断点续传，关掉页面也没事；下载中显示百分比
- 三个都 ✅ 后提示「✅ 本地模型齐了，可直接点「开始生成」」
- 若提示「⚠ 油画布引擎未安装」→ 说明出歌引擎还没装好（需先装引擎）；顶栏「⏻ 启动油画布」可手动起引擎（约 20~60 秒），引擎空闲会自动退出省显存，下次出歌自动起
计费
检测就绪 / 下载模型都是本地操作，0 点（下载耗时取决于网速，支持断点续传）。
⑩ 登录、点数与免费额度
干什么用的写歌页要登录才能出歌；出歌按「免费额度 + 点数」计费。
怎么登录
- 点右上角「💰 点数（点此登录）」→ 填手机号 + 登录码（找管理员要）→ 登录成功
- 登录后显示「💰 手机号 · X 点 · 今日免费剩 N」；再点进去是「我的账单」（余额 / 本月消费 / 每笔明细 / 导出 CSV）
- 要退出点顶栏「退出」
怎么算钱
| 做什么 | 成本 | 扣点 |
|---|---|---|
| 本地出歌（本机显卡） | 本地 | 免费额度内 0 点；超出按点续用；会员不限次 |
| 云端出歌（MiniMax 云） | 有 | 约 0.1~1.1 元/首（按成本×加价率；失败自动退款） |
| AI 写词 / AI 扩写（云端大脑） | 有（按 token） | 一般几分~几毛 |
| 选内置风格 / 选声线 / 播放 / 下载 / 删除 / 验收 | 无 | 0 点（不走大模型、确定性地本地处理） |
⑪ 常见问题（FAQ）
1. 为什么点什么都提示「请先登录」？
写歌页和工作台是同一套账号。点右上「💰 点数」用手机号 + 登录码登录一次即可；登录后票据会存 cookie，一般不用重登。
2. 选了内置风格却没效果？
多半是你选完风格又点了「AI 扩写」——扩写会按意境把 Caption 重写一遍，把风格覆盖掉。正确做法：选完风格直接点「开始生成」，不要再点扩写。选对时提示栏会显示「✅ 风格【X】已写进 Caption」。
3. 歌突然就停了 / 感觉没唱完？
多半是撞了时长上限被截断。工具会自动加长重跑一次；还不行就把「时长」调大（如 240 / 300 秒），或把歌词精简一点。
4. 快歌 / 歌词很多被截断？
同上。也可把「时长」设为「自动」，交给工具按歌词推算并留安全余量。
5. 怎么写好词？
主歌 8~15 字叙述、副歌 4~8 字短句、Bridge 2~5 字留白或长句；每句要有画面感（具体场景 / 动作 / 感官细节），别写抽象口号。副歌挑一句当记忆点并重复。参考对比——别写「岁月流逝光阴似箭」；这样写「手中酒杯轻轻晃，倾倒映半生风霜脸庞」。
6. 押韵有什么规则？
句脚尽量押韵，副歌建议必押，主歌不必每句都押；按所选风格的写词提示走（像童谣 / 军旅 / 二人转这类风格本身就要求句子整齐、一韵到底）。
7.「📋 复制协助提示词」和「🧹 规范化歌词」怎么配合用？
- 歌词框上方点「📋 复制协助提示词（拿去外面 AI 写词）」——它会复制一段写词提示词
- 把它粘到外部 AI（豆包 / DeepSeek 等），让它按格式写一首词
- 把外部 AI 写好的歌词粘回歌词框，点「🧹 规范化歌词（粘回来自动转标准格式）」——自动把段落归一到标准标签（[Verse 1] / [Chorus]…），提示「已规范化…正文 N 行」
- 再点「✨ AI 扩写」（或直接选个内置风格）→ 开始生成
8. 想用自己/别人的嗓音「唱」这首歌？
那属于干声重唱 / 声音克隆那条线，不在写歌页里。写歌页只负责「文字 → 成品歌」。
9. 还常见的「看着像失败 / 进度归零」？
看右栏「🧾 后台日志」，文件在 modules\songmaker\logs\songmaker.log，能看出卡在哪一环；进度到 90% 后停顿是模型在收尾，属正常。
