Add no-filler tags, media CLI, and ask-before-edit iron law.
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>
This commit is contained in:
swl
2026-10-10 02:35:42 +08:00
co-authored by Cursor
parent dbfb9b52f9
commit 0ab8d8ad4d
13 changed files with 464 additions and 72 deletions
+14 -2
View File
@@ -6,11 +6,12 @@
| 文档 | 给谁 | 何时读 |
|------|------|--------|
| **[`AGENTS.md`](AGENTS.md)** | **Agent / Cursor / 自动化** | **做歌或改仓前必读**(含「遇事先问」) |
| **[`AGENTS_MIN.md`](AGENTS_MIN.md)** | **Agent 默认入口** | **先读这份(省 token)** |
| [`AGENTS.md`](AGENTS.md) | Agent 全文 | dig 失败 / 改铁律时再读 |
| [`docs/使用手册.md`](docs/使用手册.md) | 人类 | 命令与配置详解 |
| [`config/local.toml.example`](config/local.toml.example) | 所有人 | 第一次连本机 ComfyUI |
> 给 Agent:读完 `AGENTS.md` 再动手。缺 `local.toml`、Comfy 没起、风格/歌名不清、想改模型或阈值时——**先问用户,不要猜**。
> 给 Agent:默认只读 `AGENTS_MIN.md`。缺 `local.toml`、Comfy 没起、风格/歌名不清、想改模型或阈值时——**先问用户**。需改代码时先征求同意,建议 git 备份或新插件旁路,并问清是否 commit/push。音频探测/转码/截取用 `songforge media`,不要读大源码。
## 一键体检
@@ -87,6 +88,17 @@ cd songforge
| 采样 | shift=5.5 / steps=28 / cfg=2.0 / temperature=0.68 |
| 时长 | 完整歌 150–200 秒 |
| 前奏 | 8 小节器乐 hook;CLI 自动注入 |
| 衬音 | 默认无填充、无 backup/合唱(`RULE_NO_FILLER`);QC 有 `filler_ratio` 弱参考 |
## 音频工具(Agent 优先用 CLI)
```powershell
.\.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
```
依赖 `config/local.toml` 的 `qc_python`(与 qc 同栈)。
## 远程(双 remote)