Add doctor_all, prune, model docs, and selftest CI.
selftest / selftest (push) Canceled after 0s

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
swl
2026-10-10 02:06:54 +08:00
co-authored by Cursor
parent 1de2654858
commit dbfb9b52f9
8 changed files with 217 additions and 30 deletions
+60 -1
View File
@@ -1,9 +1,10 @@
# -*- coding: utf-8 -*-
"""CLI 命令实现:doctor / styles / target / check / gen / runs / show。"""
"""CLI 命令实现:doctor / styles / target / check / gen / runs / show / prune。"""
import datetime
import json
import os
import random
import shutil
from ..config import loader
from ..core import catalog as catmod
@@ -83,12 +84,23 @@ def cmd_doctor(args):
lora = pmod.model_path(root, "loras", cfg["model"]["lora"])
tpl = layout["template"]
rc = 0
missing = []
for label, p in (("checkpoint", ck), ("lora", lora),
("template", tpl)):
good = os.path.exists(p)
print(" [%s] %-11s %s" % ("ok" if good else "FAIL", label, p))
if not good:
rc = 2
missing.append((label, p))
if missing:
print(" ----")
print(" 缺模型/模板时:")
print(" 1) 确认 config/local.toml 的 paths.comfy_root 指向 ComfyUI 安装根")
print(" 2) 放入锁定文件(文件名需一致,或改 default.toml 并接受声线变化):")
print(" models/checkpoints/%s" % cfg["model"]["checkpoint"])
print(" models/loras/%s" % cfg["model"]["lora"])
print(" 3) 本仓默认声线 LoRA 为作者定制;他人需自备同名或替换")
print(" 4) 路径不清楚 → 问用户,不要猜盘符")
if cfg["model"]["checkpoint"] in cfg["model"]["denied_checkpoints"]:
print(" [FAIL] 当前 checkpoint 在禁用名单里:%s"
% cfg["model"]["checkpoint"])
@@ -438,3 +450,50 @@ def cmd_catalog(args):
d.get("bpm"), d.get("duration"),
d.get("qc_verdict") or "-", d.get("style")))
return 0
def cmd_prune(args):
"""清理过期 data/tmp(默认不动 runs / 音频)。"""
cfg = loader.load({})
tmp_root = pmod.under_pkg(cfg["paths"]["tmp_dir"])
if not os.path.isdir(tmp_root):
print("tmp 目录不存在: %s" % tmp_root)
return 0
keep_days = int(args.days)
cutoff = datetime.date.today() - datetime.timedelta(days=keep_days)
removed = []
skipped = []
for name in sorted(os.listdir(tmp_root)):
path = os.path.join(tmp_root, name)
if not os.path.isdir(path):
continue
# YYYY-MM-DD 或 _migrated
day = None
try:
day = datetime.date.fromisoformat(name)
except ValueError:
if name.startswith("_") and args.include_migrated:
day = cutoff # 当作过期
else:
skipped.append(name)
continue
if day >= cutoff:
continue
if args.dry_run:
removed.append(path + " (dry-run)")
continue
shutil.rmtree(path, ignore_errors=False)
removed.append(path)
print("tmp_root %s" % tmp_root)
print("keep_days %d (删除早于 %s 的日目录)" % (keep_days, cutoff))
if not removed:
print("无需清理")
else:
for p in removed:
print(" - %s" % p)
print("已处理 %d 项%s" % (len(removed),
"(dry-run 未删)" if args.dry_run else ""))
if skipped:
print("跳过非日期目录: %s" % ", ".join(skipped[:8]))
print("未动 data/runs 与 Comfy 音频输出")
return 0
+13 -2
View File
@@ -2,7 +2,8 @@
"""songforge CLI 驱动(薄调度层)。
命令:
doctor / styles / target / check / gen / runs / show / catalog / qc / selftest
doctor / styles / target / check / gen / runs / show / catalog /
prune / qc / selftest
设计约束:所有业务参数来自配置/命令行,本文件不写死任何模型或采样常量。
实现见 common / assemble / commands / selftest / qc。
@@ -19,7 +20,7 @@ def build_parser():
p = argparse.ArgumentParser(
prog="songforge",
description="ACE-Step 生歌引擎。配置优先级:命令行 > 环境变量 > "
"local.json > default.json")
"local.toml > default.toml")
p.add_argument("--server", help="ComfyUI 地址")
p.add_argument("--log-level", default="info",
choices=["debug", "info", "warn", "error"])
@@ -135,6 +136,16 @@ def build_parser():
help="从 data/runs 扫描重建 catalog.jsonl")
cat.set_defaults(func=cmds.cmd_catalog)
pr = sub.add_parser("prune", help="清理过期 data/tmp(不动 runs/音频)")
pr.add_argument("--days", type=int, default=7,
help="保留最近 N 天的 tmp 日目录(默认 7)")
pr.add_argument("--dry-run", dest="dry_run", action="store_true",
help="只列出将删除的目录")
pr.add_argument("--include-migrated", dest="include_migrated",
action="store_true",
help="一并删除 tmp/_migrated 等非日期目录")
pr.set_defaults(func=cmds.cmd_prune)
from .qc import add_qc
add_qc(sub)
return p