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
+15 -4
View File
@@ -1,9 +1,10 @@
# songforge — Agent 手册(必读)
# songforge — Agent 手册(全文)
> **任何 Agent / 自动化:做歌或改本仓前先读完本文。** 上下文不够时**重新打开本文件**,不要凭记忆改参数。
> **省 token:默认先读 [`AGENTS_MIN.md`](AGENTS_MIN.md)。** 只有 dig 失败、改铁律、或 MIN 不够时再读本文。
> **禁止**为「了解实现」整文件粘贴 `rules/ironlaw.py` / `tools/qc_worker.py`;用 `doctor` / `media` / `qc` / `check` 的输出代替。
>
> 人类操作细节见 [`docs/使用手册.md`](docs/使用手册.md)。算法默认见 [`config/default.toml`](config/default.toml)。
> 若仍嵌套在 ComfyUI 大仓,踩坑长文还可对照 `user/default/workflows/生歌规则.md`;**冲突时以本仓 `default.toml` + 本文为准**。
> 人类操作见 [`docs/使用手册.md`](docs/使用手册.md)。算法默认见 [`config/default.toml`](config/default.toml)。
> 嵌套 ComfyUI 时踩坑长文可对照 `生歌规则.md`;**冲突时以 `default.toml` + MIN/本文为准**。
---
@@ -32,10 +33,20 @@
| 歌词来源不明 | 用户提供正文,还是要你按 `target` 区间新写? |
| `qc` 连续 FAIL 且原因不像歌词密度 | 是重 gen、换 seed,还是先听某一版再决定? |
| 要改采样 / 换模型 / 放宽 QC | **默认拒绝**;若用户坚持,先说明会破坏铁律,再确认是否真的要改 `default.toml` |
| 现状不满足需求、要改仓库代码 | **先停手**:说明缺口与拟改范围,征求明确同意;建议 git 分支/commit/stash/tag 备份,或新写插件/旁路少动核心;再问是否 commit、是否 push、推哪个 remote |
| 要提交 `.secrets/`、`local.toml`、token | **拒绝**;问用户是否只推代码 |
| 仓库路径 / clone 位置不清 | 当前工作目录是哪?独立仓还是嵌套在 ComfyUI 里? |
| 两个远程(GitHub / Gitea)要推哪个 | 推哪个 remote?是否允许 push? |
### 改代码铁律(防意外)
Agent 做歌时若发现工具/实现不够用、**必须改代码**才能满足需求:
1. **不得默默改仓**:先用几句话说明缺口、拟改文件/层(核心 vs 插件/旁路),等用户同意。
2. **主动建议安全路径**:用 git 做备份点(新分支、commit、stash、tag),或优先「新插件 / 旁路脚本」而不是直接改铁律与 `default.toml`。
3. **提交权在用户**:改完后问是否 `commit`、是否 `push`、推哪个 remote;未许可不得提交或推送;禁止 `--force`;禁止带 secrets / `local.toml`。
4. 用户明确说「完成后 commit+push」时,再按该指示收尾。
可以自行处理、**不必问**的:
- `check` 密度失败 → 只改歌词到 `target` 区间后重 check