Add align/recheck/compare, plugins, and refresh Agent docs.
selftest / selftest (push) Canceled after 0s

Wire deliver_report/listen_pack/retry hooks; gen --auto-retry and intro light check; make AGENTS_MIN the up-to-date agent entry with full command map.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
swl
2026-10-10 13:03:44 +08:00
co-authored by Cursor
parent b1afe68f3c
commit 6d79ab93a2
20 changed files with 780 additions and 91 deletions
+9 -7
View File
@@ -11,7 +11,7 @@
| [`docs/使用手册.md`](docs/使用手册.md) | 人类 | 命令与配置详解 |
| [`config/local.toml.example`](config/local.toml.example) | 所有人 | 第一次连本机 ComfyUI |
> 给 Agent:默认只读 `AGENTS_MIN.md`。缺 `local.toml`、Comfy 没起、风格/歌名不清、想改模型或阈值时——**先问用户**。需改代码时先征求同意,建议 git 备份或新插件旁路,并问清是否 commit/push。音频探测/转码/截取用 `songforge media`,不要读大源码。
> 给 Agent:**进仓只读 [`AGENTS_MIN.md`](AGENTS_MIN.md)**(含 align/recheck/compare、插件与报告模板)。缺 `local.toml`、Comfy 没起、风格/歌名不清——**先问用户**。扩展写 [`plugins/`](plugins/README.md)。
## 一键体检
@@ -71,14 +71,16 @@ cd songforge
```powershell
.\.venv\Scripts\python.exe songforge.py target --style pop --bpm 104 --dur 180
.\.venv\Scripts\python.exe songforge.py check --style pop --title 灯还亮着 --lyrics-file input\lyrics\pop_灯还亮着.txt
.\.venv\Scripts\python.exe songforge.py gen --style pop --title 灯还亮着 --lyrics-file input\lyrics\pop_灯还亮着.txt
.\.venv\Scripts\python.exe songforge.py qc --run gen-<时间戳> --baseline
.\.venv\Scripts\python.exe songforge.py prune --days 7 # 清过期 tmp
.\.venv\Scripts\python.exe songforge.py prune --days 7 --dry-run
.\.venv\Scripts\python.exe songforge.py align --style pop --lyrics-file input\lyrics\pop_灯还亮着.txt --bpm 104 --dur 180
.\.venv\Scripts\python.exe songforge.py check --style pop --title 灯还亮着 --lyrics-file input\lyrics\pop_灯还亮着.txt
.\.venv\Scripts\python.exe songforge.py gen --style pop --title 灯还亮着 --lyrics-file input\lyrics\pop_灯还亮着.txt --auto-retry 2
.\.venv\Scripts\python.exe songforge.py recheck --run gen-<时间戳>
.\.venv\Scripts\python.exe songforge.py qc --run gen-<时间戳> --baseline
.\.venv\Scripts\python.exe songforge.py compare --runs gen-a,gen-b
.\.venv\Scripts\python.exe songforge.py prune --days 7
```
`qc` 必须带 `--baseline`。样例歌词见 `input/lyrics/`。Agent 规则见 [`AGENTS.md`](AGENTS.md)。
`qc` 必须带 `--baseline`。PASS 后看 `report.md` 与 `listen/`。Agent 入口:[`AGENTS_MIN.md`](AGENTS_MIN.md)。
## 硬约束(摘要)