selftest / selftest (push) Canceled after 0s
Default solo-lead tags and report-only filler_ratio; slim Agent docs with media CLI; require consent, git backup or plugin path, and explicit commit/push before code changes. Co-authored-by: Cursor <cursoragent@cursor.com>
2.4 KiB
2.4 KiB
songforge — Agent 极简卡(默认只读这份)
省 token:先读本文。失败 / 改铁律 / 深挖时再打开
AGENTS.md。 禁止把ironlaw.py/qc_worker.py整文件塞进上下文;用 CLI 输出代替。
交付
gen 的 run_id + flac + qc --baseline → PASS(style_fam / filler_ratio 只是弱参考)。
流水线
doctor_all → target → 写歌词 → check → gen → qc --baseline
仓根:
.\scripts\doctor_all.ps1
.\.venv\Scripts\python.exe songforge.py <命令>
硬锁定
| 项 | 值 |
|---|---|
| ckpt+LoRA | ace_step_1.5_turbo_swl_fused + swl_voice_best_ep257(0.5/0.5) |
| 采样 | shift=5.5 / steps=28 / cfg=2.0 / temperature=0.68 |
| 时长 | 150–200s;8 小节器乐前奏(CLI 注入) |
| 衬音 | 默认无填充、无 backup/合唱(tags 已强制) |
本机路径:config/local.toml。算法:config/default.toml。
音频窄接口(勿自写脚本)
.\.venv\Scripts\python.exe songforge.py media info --file path.flac
.\.venv\Scripts\python.exe songforge.py media convert --file in.flac --to wav
.\.venv\Scripts\python.exe songforge.py media clip --file in.flac --start 12 --dur 8 --out out.wav
(走 qc_python,与 qc 同栈。)
遇事先问
| 情况 | 动作 |
|---|---|
| 无 local.toml / Comfy 不通 / 缺模型 | 问用户路径与是否已启动 |
| 风格/歌名/歌词来源不清 | 问 |
| 想改采样/换模型/放宽 QC | 拒绝,除非用户书面坚持 |
| secrets / push 哪个 remote | 问;勿提交 .secrets、local.toml |
改代码铁律(防意外)
发现现状不满足需求、需要改仓库代码时:
- 先停手,说明缺口与拟改范围,征求用户明确同意后再动文件。
- 建议用户选一种安全路径(可并列问):
- git 备份:新分支 / commit / stash / tag,再改;
- 或新写插件/旁路脚本,少动核心铁律与默认配置。
- 问是否 commit、是否 push、推哪个 remote;未获许可不得提交或推送。
- 用户同意收尾时再
commit+(若许可)push;勿擅自--force、勿提交 secrets /local.toml。
可自行处理(不必问改代码):check 密度失败只改歌词;漏 --baseline 补上;prune --days 7 清 tmp。
样例
input/lyrics/pop_灯还亮着.txt + --style pop --bpm 104 --dur 180