Document agent ask-first rules across AGENTS and manuals.
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
+15
-2
@@ -1,6 +1,13 @@
|
||||
# songforge 使用手册
|
||||
|
||||
本手册讲「怎么跑」。参数铁律、踩坑与版本史见上级目录 [`生歌规则.md`](../../生歌规则.md)(唯一规范)。
|
||||
本手册讲「怎么跑」。
|
||||
|
||||
| 文档 | 用途 |
|
||||
|------|------|
|
||||
| [`../AGENTS.md`](../AGENTS.md) | **Agent 必读**:流水线、铁律、**遇事先问** |
|
||||
| [`../README.md`](../README.md) | clone / 安装 / 远程 |
|
||||
| [`../config/default.toml`](../config/default.toml) | 算法默认(本仓为准) |
|
||||
| 若仍嵌套 ComfyUI:`生歌规则.md` | 踩坑长文;与 `default.toml` 冲突时以 TOML + AGENTS 为准 |
|
||||
|
||||
推荐:clone 到任意目录后在**仓根**执行(先配 `config/local.toml`):
|
||||
|
||||
@@ -16,7 +23,13 @@ cd D:\CodeFiles\Thinking\ComfyUI-MiniMaxH3\user\default\workflows
|
||||
python songforge\songforge.py <命令> [选项]
|
||||
```
|
||||
|
||||
`local.toml` 填 `engine.server` + `paths.comfy_root` 即可连本机 ComfyUI。QC 音频栈用 `paths.qc_python`(常为 ComfyUI venv)。
|
||||
`local.toml` 填 `engine.server` + `paths.comfy_root` 即可连本机 ComfyUI。QC 用 `paths.qc_python`(常为 ComfyUI venv)。
|
||||
|
||||
### 给 Agent / 自动化
|
||||
|
||||
1. 先读 [`AGENTS.md`](../AGENTS.md),再跑命令。
|
||||
2. 没有 `local.toml`、Comfy 没起、风格/歌名/歌词来源不清 → **先问用户**,不要猜路径或改铁律。
|
||||
3. 交付以 `qc --baseline` PASS 为准;不要把 `style_fam` 说成「风格已验证」。
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user