Files
ai-manju/scripts/validate_shots.py
admin 7753939a3b feat: ai-manju skill 初始提交
AI 漫剧流水线技能完整落地:文件驱动、可校验、单镜可重做。

七阶段:基线资产 → 策划叙事 → 分镜中枢 → 配音先行 → 出图/出视频 → 缝合 → 审片归档。

- scripts/: manju.py 编排、submit_t2i/submit_i2v 提交、cleanup_comfyui 清理
- assets/comfyui-manju-cleanup/: ComfyUI 清理扩展,归属校验 fail-closed
- references/: models.md 模型节点图全表、workflow/director/storyboard/pitfalls
- .gitignore: 排除 __pycache__ 与运行产物
2026-11-14 17:49:39 +08:00

210 lines
7.6 KiB
Python
Raw Permalink 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.
#!/usr/bin/env python3
"""xv 分镜清单校验器 —— 零第三方依赖,Python 3.9+。
ERROR 阻断进入生成阶段;WARN 不阻断但必须逐条确认。
规则来源:Toonflow workflow PART A(references/toonflow-workflow-director.md)
"""
import json
import re
import sys
from pathlib import Path
def _find_root():
"""工作空间根:MANJU_ROOT > cwd 向上找 config/pipeline.json > 脚本上级。"""
import os as _os
env = _os.environ.get("MANJU_ROOT")
if env:
return Path(env).expanduser().absolute()
d = Path.cwd().absolute()
for p in (d, *d.parents):
if (p / "config" / "pipeline.json").is_file():
return p
return Path(__file__).absolute().parent.parent
ROOT = _find_root()
SHOT_ID_RE = re.compile(r"^S\d{2}$")
EVENT_ID_RE = re.compile(r"^E\d{2}$")
EVENT_SCAN_RE = re.compile(r"\bE\d{2}\b")
SHOT_TYPES = ["大特写", "特写", "近景", "中景", "全景", "远景"]
STATUSES = {"planned", "prompted", "generated", "adopted", "rejected"}
RELATIONS = {"continuous", "partial", "reset"}
FORBIDDEN_STATE = ("同上", "延续上一段", "沿用上一段", "同上一段")
def nominal_seconds():
try:
with (ROOT / "config/pipeline.json").open(encoding="utf-8") as f:
return float(json.load(f)["videoModel"]["nominalSeconds"])
except Exception:
return 5.06
def load_events(ep_dir):
path = ep_dir / "10_events.md"
if not path.exists():
return None
return set(EVENT_SCAN_RE.findall(path.read_text(encoding="utf-8")))
def shot_hash(text):
import hashlib
return hashlib.sha256(text.encode("utf-8")).hexdigest()[:8]
def validate(path):
errors, warns = [], []
path = Path(path).resolve()
ep_dir = path.parent
nominal = nominal_seconds()
try:
data = json.loads(path.read_text(encoding="utf-8"))
except Exception as exc:
return [f"无法读取清单:{exc}"], [], {}
for key in ("episode", "targetDuration", "shots"):
if key not in data:
errors.append(f"顶层缺少必填字段 {key}")
shots = data.get("shots") or []
if not shots:
errors.append("shots 为空")
return errors, warns, {"shots": 0, "total": 0.0, "errors": len(errors), "warns": len(warns)}
if not re.match(r"^EP\d{2}$", str(data.get("episode", ""))):
errors.append("episode 需为 EPxx 格式")
events = load_events(ep_dir)
if events is None:
warns.append("未找到 10_events.md,跳过 E## 溯源校验")
else:
for eid in sorted(events):
used = any(eid in (s.get("eventIds") or []) for s in shots)
if not used:
warns.append(f"源节拍 {eid} 未映射到任何镜头(可能漏拍)")
seen, total = set(), 0.0
prev = None
for i, s in enumerate(shots):
sid = str(s.get("shotId", f"<第{i + 1}项>"))
if not SHOT_ID_RE.match(sid):
errors.append(f"{sid}: shotId 需为 Sxx 格式")
if sid in seen:
errors.append(f"{sid}: 镜号重复")
seen.add(sid)
if SHOT_ID_RE.match(sid) and int(sid[1:]) != i + 1:
errors.append(f"{sid}: 镜号未按 S01 起顺序编号")
eids = s.get("eventIds") or []
if not eids:
errors.append(f"{sid}: 缺 eventIds,禁止无源新增动作")
else:
for eid in eids:
if not EVENT_ID_RE.match(str(eid)):
errors.append(f"{sid}: 非法事件号 {eid}")
elif events is not None and eid not in events:
errors.append(f"{sid}: 事件 {eid} 未登记在 10_events.md")
if not str(s.get("visual", "")).strip():
errors.append(f"{sid}: visual 为空")
dur = s.get("duration")
if not isinstance(dur, (int, float)) or dur <= 0:
errors.append(f"{sid}: duration 非法")
else:
total += dur
if dur > nominal and not s.get("pad"):
errors.append(
f"{sid}: 时长 {dur}s 超过模型标称 {nominal}s,需置 pad=true(tpad clone 补足)"
)
if dur > 8:
warns.append(f"{sid}: 单镜 {dur}s 偏长,注意长空档")
if str(s.get("line", "")).strip() and not str(s.get("voice", "")).strip():
errors.append(f"{sid}: 有台词必须固定音色 voice")
if s.get("status") not in STATUSES:
errors.append(f"{sid}: status 非法")
st = s.get("shotType")
if st and st not in SHOT_TYPES:
errors.append(f"{sid}: shotType 非法:{st}")
cont = s.get("continuity") or {}
if cont.get("relation") not in RELATIONS:
errors.append(f"{sid}: continuity.relation 应为 continuous/partial/reset")
initial = str(cont.get("initialState", ""))
if cont.get("relation") in ("continuous", "partial") and not initial.strip():
errors.append(f"{sid}: 连续关联段必须写绝对 initialState")
for bad in FORBIDDEN_STATE:
if bad in initial:
errors.append(f"{sid}: initialState 含「{bad}」,须重写为绝对初始状态")
for ref in s.get("refs") or []:
if not (ROOT / ref).exists():
warns.append(f"{sid}: 参考资产尚未就位 {ref}")
pf = s.get("promptFile")
if pf:
fp = ep_dir / pf if not str(pf).startswith("/") else Path(pf)
if not fp.exists():
warns.append(f"{sid}: 提示词文件缺失 {pf}")
elif s.get("promptHash"):
actual = shot_hash(fp.read_text(encoding="utf-8"))
if actual != s["promptHash"]:
errors.append(
f"{sid}: promptHash 与 {pf} 不符(应为 {actual}),改词须换哈希另存"
)
if prev:
same_subject = prev.get("subject") and prev.get("subject") == s.get("subject")
if same_subject:
types = SHOT_TYPES
try:
gap = abs(types.index(prev.get("shotType")) - types.index(s.get("shotType")))
except (ValueError, AttributeError):
gap = 0
if gap < 2 and prev.get("angle") == s.get("angle"):
warns.append(
f"{sid}: 与前镜主体/景别/角度近似,跨独立生成段易像错误续帧"
)
prev = s
target = float(data.get("targetDuration") or 0)
tol = float(data.get("tolerance") or 3.0)
if target and total > target + tol:
errors.append(f"总时长 {total:.2f}s 超出目标 {target + tol:.2f}s")
if target and total < target - tol:
warns.append(f"总时长 {total:.2f}s 低于目标下限 {target - tol:.2f}s")
summary = {
"episode": data.get("episode"),
"shots": len(shots),
"total": round(total, 2),
"target": target,
"errors": len(errors),
"warns": len(warns),
}
return errors, warns, summary
def main(argv):
if len(argv) != 2:
print("用法: validate_shots.py <30_shots.json>", file=sys.stderr)
return 2
errors, warns, summary = validate(argv[1])
print(f"[{summary.get('episode', '?')}] {summary['shots']} 镜 / {summary['total']}s "
f"(目标 {summary['target']}s) ERROR={summary['errors']} WARN={summary['warns']}")
for item in errors:
print(f" ERROR {item}")
for item in warns:
print(f" WARN {item}")
if not errors:
print(" 校验通过(WARN 需在生成前逐条确认)")
return 1 if errors else 0
if __name__ == "__main__":
sys.exit(main(sys.argv))