Add no-filler tags, media CLI, and ask-before-edit iron law.
selftest / selftest (push) Canceled after 0s
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:
@@ -0,0 +1,68 @@
|
||||
# songforge — Agent 极简卡(默认只读这份)
|
||||
|
||||
> 省 token:**先读本文**。失败 / 改铁律 / 深挖时再打开 [`AGENTS.md`](AGENTS.md)。
|
||||
> **禁止**把 `ironlaw.py` / `qc_worker.py` 整文件塞进上下文;用 CLI 输出代替。
|
||||
|
||||
## 交付
|
||||
|
||||
`gen` 的 run_id + flac + `qc --baseline` → **PASS**(`style_fam` / `filler_ratio` 只是弱参考)。
|
||||
|
||||
## 流水线
|
||||
|
||||
```text
|
||||
doctor_all → target → 写歌词 → check → gen → qc --baseline
|
||||
```
|
||||
|
||||
仓根:
|
||||
|
||||
```powershell
|
||||
.\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`。
|
||||
|
||||
## 音频窄接口(勿自写脚本)
|
||||
|
||||
```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
|
||||
```
|
||||
|
||||
(走 `qc_python`,与 qc 同栈。)
|
||||
|
||||
## 遇事先问
|
||||
|
||||
| 情况 | 动作 |
|
||||
|------|------|
|
||||
| 无 local.toml / Comfy 不通 / 缺模型 | **问用户**路径与是否已启动 |
|
||||
| 风格/歌名/歌词来源不清 | **问** |
|
||||
| 想改采样/换模型/放宽 QC | **拒绝**,除非用户书面坚持 |
|
||||
| secrets / push 哪个 remote | **问**;勿提交 `.secrets`、`local.toml` |
|
||||
|
||||
## 改代码铁律(防意外)
|
||||
|
||||
发现现状不满足需求、**需要改仓库代码**时:
|
||||
|
||||
1. **先停手**,说明缺口与拟改范围,**征求用户明确同意**后再动文件。
|
||||
2. **建议用户选一种安全路径**(可并列问):
|
||||
- git 备份:新分支 / commit / stash / tag,再改;
|
||||
- 或**新写插件/旁路脚本**,少动核心铁律与默认配置。
|
||||
3. **问是否 commit、是否 push、推哪个 remote**;未获许可不得提交或推送。
|
||||
4. 用户同意收尾时再 `commit` +(若许可)`push`;勿擅自 `--force`、勿提交 secrets / `local.toml`。
|
||||
|
||||
可自行处理(不必问改代码):`check` 密度失败只改歌词;漏 `--baseline` 补上;`prune --days 7` 清 tmp。
|
||||
|
||||
## 样例
|
||||
|
||||
`input/lyrics/pop_灯还亮着.txt` + `--style pop --bpm 104 --dur 180`
|
||||
Reference in New Issue
Block a user