Files
songforge/AGENTS_MIN.md
T
swlandCursor 0ab8d8ad4d
selftest / selftest (push) Canceled after 0s
Add no-filler tags, media CLI, and ask-before-edit iron law.
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>
2026-10-10 02:35:42 +08:00

69 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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`