92 lines
2.8 KiB
Markdown
92 lines
2.8 KiB
Markdown
# songforge
|
||
|
||
本地 ACE-Step 生歌 CLI:锁定模型与声线 LoRA、铁律前奏注入、歌词密度硬校验、QC 验收。
|
||
|
||
**独立项目**:clone 到任意目录,写好 `config/local.toml` 指向本机 ComfyUI,即可生成。
|
||
|
||
| 文档 | 给谁 |
|
||
|------|------|
|
||
| [`AGENTS.md`](AGENTS.md) | Agent / 自动化 |
|
||
| [`docs/使用手册.md`](docs/使用手册.md) | 人类操作 |
|
||
|
||
## 换目录也能用(推荐)
|
||
|
||
```powershell
|
||
# 1) clone(GitHub 或 Gitea)
|
||
cd D:\CodeFiles\ProProjects
|
||
git clone https://git.nnrc.ren/swl/songforge.git
|
||
cd songforge
|
||
|
||
# 2) CLI 环境(Python >= 3.11)
|
||
.\scripts\setup_venv.ps1
|
||
|
||
# 3) 本机 ComfyUI 连接(只改这一份)
|
||
copy config\local.toml.example config\local.toml
|
||
# 编辑:
|
||
# [engine] server = "http://127.0.0.1:8188"
|
||
# [paths] comfy_root / qc_python / music_dir
|
||
|
||
# 4) 先起 ComfyUI,再体检
|
||
.\.venv\Scripts\python.exe songforge.py doctor
|
||
```
|
||
|
||
只要 ComfyUI 在跑、`local.toml` 里 `comfy_root` 指向正确安装根(含 `models/checkpoints` 与 LoRA),**不必**把本仓放进 ComfyUI 的 `user/default/workflows`。
|
||
|
||
## 两个 Python 环境
|
||
|
||
| 环境 | 用途 |
|
||
|------|------|
|
||
| **本仓 `.venv`** | CLI:`doctor` / `check` / `gen` / `catalog` |
|
||
| **`qc_python`** | QC 音频栈(可继续用 ComfyUI 的 venv) |
|
||
|
||
## 配置:TOML vs JSON
|
||
|
||
| 文件 | 作用 |
|
||
|------|------|
|
||
| `config/default.toml` | 算法 / 相对路径(相对**本仓根**) |
|
||
| `config/local.toml` | 本机 Comfy 根、服务地址、QC Python(gitignore) |
|
||
| `workflows/template.json` | 包内 workflow 图(JSON,与配置分流) |
|
||
| `config/baseline/*.json` | QC 基线数据 |
|
||
|
||
优先级:`命令行 > SONGFORGE_* > local.toml > default.toml > DEFAULTS`
|
||
|
||
## 流水线
|
||
|
||
```powershell
|
||
.\.venv\Scripts\python.exe songforge.py target --style pop --bpm 104 --dur 180
|
||
.\.venv\Scripts\python.exe songforge.py check --style pop --title 歌名 --lyrics-file input\lyrics\歌名.txt
|
||
.\.venv\Scripts\python.exe songforge.py gen --style pop --title 歌名 --lyrics-file input\lyrics\歌名.txt
|
||
.\.venv\Scripts\python.exe songforge.py qc --run gen-<时间戳> --baseline
|
||
```
|
||
|
||
`qc` 必须带 `--baseline`。音频写到 ComfyUI `output/MyMusic/`(可用 `music_dir` 覆盖)。
|
||
|
||
## 硬约束(摘要)
|
||
|
||
| 项 | 值 |
|
||
|----|-----|
|
||
| 模型 | `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–200 秒 |
|
||
| 前奏 | 8 小节器乐 hook;CLI 自动注入 |
|
||
|
||
## 目录
|
||
|
||
```
|
||
songforge/ # clone 下来的仓根 = 包根
|
||
config/default.toml
|
||
config/local.toml # 本机(勿提交)
|
||
data/runs/YYYY-MM-DD/ # gen 产物
|
||
workflows/template.json
|
||
.venv/
|
||
```
|
||
|
||
## 远程
|
||
|
||
- GitHub: https://github.com/lsuen/songforge
|
||
- Gitea: https://git.nnrc.ren/swl/songforge
|
||
|
||
## License
|
||
|
||
MIT — 见 [LICENSE](LICENSE)。
|