2.8 KiB
2.8 KiB
songforge — Agent 生歌手册
远程 / channel Agent 读这份文件即可做歌。上下文不够时重新打开本文件。 人类规范见 ComfyUI 仓内
生歌规则.md(若仍嵌套部署);行为冲突以config/default.toml为准。
0. 交付物
- 一次
gen的run_id - ComfyUI 产出的 flac
qc --baseline→ PASS
style_fam 只是弱参考,不要当 PASS 条件。
1. 工作目录
推荐(独立仓): 在 clone 根目录执行:
cd D:\CodeFiles\ProProjects\songforge # 或任意 clone 路径
.\.venv\Scripts\python.exe songforge.py <命令>
嵌套在 ComfyUI 时也可:
cd <ComfyUI>\user\default\workflows
python songforge\songforge.py <命令>
禁止:手写 tags / 手写前奏 / 改 workflow JSON 调参 / 换 YuE2·Music3·aio / 放宽 QC 阈值。
2. 流水线
doctor → target → 写歌词 → check → gen → qc --baseline
check不过 → 只改歌词doctor服务不可达 → 先起 ComfyUI;检查config/local.toml的engine.server/paths.comfy_rootqc必须带--baseline- 索引:
catalog/catalog --rebuild
3. 硬锁定
| 项 | 值 |
|---|---|
| checkpoint | ace_step_1.5_turbo_swl_fused.safetensors |
| LoRA | swl_voice_best_ep257.safetensors(0.5 / 0.5) |
| 采样 | shift=5.5 / steps=28 / cfg=2.0 / temperature=0.68 |
| 时长 | 完整歌 150–200 秒 |
| 前奏 | 8 小节器乐 hook;CLI 自动注入 |
算法 → config/default.toml;本机路径 → config/local.toml(gitignore)。
命令行 > SONGFORGE_* > local.toml > default.toml > DEFAULTS
CLI = 项目 .venv;QC = local.toml 的 qc_python。
4. 目录(相对仓根)
| 级别 | 路径 |
|---|---|
| 项目 | input/lyrics/、config/baseline/、workflows/template.json |
| 本机 | config/local.toml |
| 数据 | data/runs/YYYY-MM-DD/、data/tmp/、index/catalog.jsonl、cache/ |
| 外部 | <comfy_root>/output/MyMusic/ |
5. 写歌词
- 先
target,音节进放行区间。 - 不要写
[intro]/ tags——assemble会注入。 - 段落用
[verse][chorus]等。 - 英文低音吟唱用
--chill-vocal。
6. 失败速查
| 现象 | 动作 |
|---|---|
| doctor FAIL 服务 | 启动 ComfyUI;核对 local.toml server |
| doctor FAIL 模型 | comfy_root 下是否有锁定 checkpoint/LoRA |
| check 密度失败 | 改歌词 |
| qc voice_nn=null | 漏了 --baseline |
| qc FAIL | 修歌/重 gen,不改阈值 |
.\.venv\Scripts\python.exe songforge.py selftest
7. 验收清单
[ ] local.toml 已填 comfy_root / server
[ ] doctor 全绿
[ ] check OK
[ ] gen 产出 flac,时长 150–200
[ ] qc --baseline → PASS