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

2.4 KiB
Raw Blame History

songforge — Agent 极简卡(默认只读这份)

省 token:先读本文。失败 / 改铁律 / 深挖时再打开 AGENTS.md。 禁止把 ironlaw.py / qc_worker.py 整文件塞进上下文;用 CLI 输出代替。

交付

gen 的 run_id + flac + qc --baseline → PASS(style_fam / filler_ratio 只是弱参考)。

流水线

doctor_all → target → 写歌词 → check → gen → qc --baseline

仓根:

.\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。

音频窄接口(勿自写脚本)

.\.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