Add songforge as independent repo with path layout.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
swl
2026-10-09 19:18:33 +08:00
co-authored by Cursor
commit f39deb1848
52 changed files with 10289 additions and 0 deletions
+164
View File
@@ -0,0 +1,164 @@
# -*- coding: utf-8 -*-
"""songforge CLI 驱动(薄调度层)。
命令:
doctor / styles / target / check / gen / runs / show / catalog / qc / selftest
设计约束:所有业务参数来自配置/命令行,本文件不写死任何模型或采样常量。
实现见 common / assemble / commands / selftest / qc。
"""
import argparse
import sys
from ..core.errors import (LyricDensityError, RuleViolation, SongForgeError)
from . import commands as cmds
from . import selftest as stmod
def build_parser():
p = argparse.ArgumentParser(
prog="songforge",
description="ACE-Step 生歌引擎。配置优先级:命令行 > 环境变量 > "
"local.json > default.json")
p.add_argument("--server", help="ComfyUI 地址")
p.add_argument("--log-level", default="info",
choices=["debug", "info", "warn", "error"])
p.add_argument("--quiet", action="store_true")
sub = p.add_subparsers(dest="cmd")
d = sub.add_parser("doctor", help="环境自检")
d.add_argument("--shift", type=float)
d.add_argument("--steps", type=int)
d.add_argument("--cfg", type=float)
d.add_argument("--template")
d.add_argument("--runs-dir", dest="runs_dir")
d.set_defaults(func=cmds.cmd_doctor)
s = sub.add_parser("styles", help="列出风格字典")
s.set_defaults(func=cmds.cmd_styles)
st = sub.add_parser("selftest", help="全链路自检(不连 ComfyUI 生成)")
st.set_defaults(func=stmod.cmd_selftest)
t = sub.add_parser("target", help="死心塌地字数目标")
t.add_argument("--style", help="用风格字典的 bpm/时长;可再被 --bpm/--dur 覆盖")
t.add_argument("--bpm", type=int)
t.add_argument("--dur", type=int)
t.add_argument("--key")
t.add_argument("--chill-vocal", dest="chill_vocal", action="store_true",
help="英文低声吟唱:自动按 sparse 档(音乐主导)算目标字数")
t.add_argument("--instrumental", action="store_true",
help="纯器乐:算纯器乐结构下的器乐容量(无可唱歌词)")
t.add_argument("--density-profile", dest="density_profile",
help="密度档:default(人声填满)/ sparse(音乐主导、人声点缀)")
t.set_defaults(func=cmds.cmd_target)
c = sub.add_parser("check", help="纯本地校验,不连 ComfyUI")
c.add_argument("--style", required=True)
c.add_argument("--lyrics-file", dest="lyrics_file")
c.add_argument("--lyrics")
c.add_argument("--title")
c.add_argument("--bpm", type=int)
c.add_argument("--key")
c.add_argument("--dur", type=int)
c.add_argument("--instruments")
c.add_argument("--mood")
c.add_argument("--shift", type=float)
c.add_argument("--steps", type=int)
c.add_argument("--cfg", type=float)
c.add_argument("--temperature", type=float)
c.add_argument("--enc-cfg", dest="enc_cfg", type=float)
c.add_argument("--template")
c.add_argument("--runs-dir", dest="runs_dir")
c.add_argument("--language")
c.add_argument("--chill-vocal", dest="chill_vocal", action="store_true",
help="英文低声吟唱模式:放开 humming/melisma,"
"人声退到点缀位,突出音乐本身")
c.add_argument("--instrumental", action="store_true",
help="纯器乐:整首无人声,只测 prompt 对乐器的控制力。"
"不需要 --lyrics-file")
c.add_argument("--density-profile", dest="density_profile",
help="密度档:default(人声填满)/ sparse(音乐主导、人声点缀)")
c.add_argument("--lean-tags", dest="lean_tags", action="store_true",
help="精简正向标签:保留'前奏器乐+第一拍鼓'硬约束,"
"但不注入 RULE_NEG 那 20+ 条人声否定句")
c.set_defaults(func=cmds.cmd_check)
g = sub.add_parser("gen", help="生成歌曲")
g.add_argument("--style", required=True)
g.add_argument("--lyrics-file", dest="lyrics_file", required=False)
g.add_argument("--lyrics")
g.add_argument("--title", required=True)
g.add_argument("--bpm", type=int)
g.add_argument("--key")
g.add_argument("--dur", type=int)
g.add_argument("--instruments")
g.add_argument("--mood")
g.add_argument("--seeds", type=int, default=1)
g.add_argument("--seed", type=int)
g.add_argument("--shift", type=float)
g.add_argument("--steps", type=int)
g.add_argument("--cfg", type=float)
g.add_argument("--temperature", type=float)
g.add_argument("--enc-cfg", dest="enc_cfg", type=float)
g.add_argument("--template")
g.add_argument("--runs-dir", dest="runs_dir")
g.add_argument("--language")
g.add_argument("--chill-vocal", dest="chill_vocal", action="store_true",
help="英文低声吟唱模式:放开 humming/melisma,"
"人声退到点缀位,突出音乐本身(第三张专辑用)")
g.add_argument("--instrumental", action="store_true",
help="纯器乐:整首无人声,只测 prompt 对乐器的控制力。"
"不需要 --lyrics-file")
g.add_argument("--density-profile", dest="density_profile",
help="密度档:default(人声填满)/ sparse(音乐主导、人声点缀)")
g.add_argument("--lean-tags", dest="lean_tags", action="store_true",
help="精简正向标签:保留'前奏器乐+第一拍鼓'硬约束,"
"但不注入 RULE_NEG 那 20+ 条人声否定句")
g.add_argument("--dry-run", dest="dry_run", action="store_true",
help="只写 workflow 与 API 预览,不提交 ComfyUI")
g.set_defaults(func=cmds.cmd_gen)
r = sub.add_parser("runs", help="列出历史运行")
r.add_argument("--limit", type=int, default=20)
r.add_argument("--day", help="只列某一天 YYYY-MM-DD")
r.set_defaults(func=cmds.cmd_runs)
w = sub.add_parser("show", help="查看某次运行")
w.add_argument("run_id")
w.set_defaults(func=cmds.cmd_show)
cat = sub.add_parser("catalog", help="全局索引(歌名/风格/BPM/QC)")
cat.add_argument("--limit", type=int, default=50)
cat.add_argument("--day", help="只列某一天 YYYY-MM-DD")
cat.add_argument("--rebuild", action="store_true",
help="从 data/runs 扫描重建 catalog.jsonl")
cat.set_defaults(func=cmds.cmd_catalog)
from .qc import add_qc
add_qc(sub)
return p
def main(argv=None):
argv = argv if argv is not None else sys.argv[1:]
parser = build_parser()
args = parser.parse_args(argv)
if not getattr(args, "func", None):
parser.print_help()
return 1
try:
return args.func(args) or 0
except (RuleViolation, LyricDensityError) as e:
print("\n[校验不通过]\n%s" % e)
return 1
except SongForgeError as e:
detail = getattr(e, "detail", "")
print("\n[错误] %s" % e)
if detail:
print(" 详情: %s" % detail)
return 2
if __name__ == "__main__":
sys.exit(main())