# -*- coding: utf-8 -*- """Story IR 配置期校验。挡掉调研发现的卡流程 bug；校验不过不产出任何配置。 返回 (errors, warnings)：errors 非空即拒绝编译；warnings 仅提示（如点位集缺失）。 M4 新增：out_ref 结构校验、选项 skip 校验、点位集坐标引用校验。 """ import os import re from .compile import expand_out_refs from .dictionary import CompileError ITEM_RE = re.compile(r"^[VP]\d+$") # 时长/打字速度常量（与白模预览 timeline.js 顶部共享，避免漂移）。P2 scene move 重叠校验用。 MOVE_SPEED = 3.0 CHAR_TIME, TAIL_PAUSE, MIN_DLG = 0.07, 0.9, 1.2 ANIM_DUR, CAMERA_DUR = 1.0, 2.0 _SCENE_CLIP_KINDS = {"move", "dialogue", "narration", "anim", "camera", "wait"} # 点位集位置：本文件在 SGame/tools/event_authoring/ir_core/ -> 上溯 4 级到项目根 _POINTS_DIR = os.path.join( os.path.dirname(os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))), "Assets", "StreamingAssets", "Story", "PointSets") def validate(ir, dic, points_dir=None, strict_points=False): errs, warns = [], [] # ---- out_ref 结构预检（在展开前；展开依赖此处通过）---- seqs = {s["id"]: s for s in ir.get("sequences", [])} for n in ir.get("nodes", []): if n.get("kind") == "out_ref": ref = n.get("ref") if ref not in seqs: errs.append("[out_ref失效] 节点 %s 引用了不存在的子序列 %r" % (n["id"], ref)) elif not seqs[ref].get("nodes"): errs.append("[空子序列] 子序列 %r 没有任何节点（被 %s 引用）" % (ref, n["id"])) for sn in seqs.get(ref, {}).get("nodes", []): if sn.get("kind") == "out_ref": errs.append("[嵌套out_ref] 子序列 %r 节点 %s 含嵌套 out_ref，M4 暂不支持" % (ref, sn["id"])) if errs: return errs, warns # 结构坏了就别展开了，避免 KeyError 噪声 # ---- 展开 out_ref 后做节点级校验（goto/win/lose/skip 目标含子序列内 id）---- try: nodes_list = expand_out_refs(ir) except CompileError as e: return ["[展开失败] %s" % e], warns nodes = {n["id"]: n for n in nodes_list} endings = {e["id"]: e for e in ir.get("endings", [])} all_ids = set(nodes) | set(endings) slots = {r["slot"] for r in ir.get("roles", [])} anchors = _load_anchors(ir, points_dir) # {点位名:(x,z)}；无点位集时为空（move 重叠检跳过） def check_target(src, tid, field): if tid not in all_ids: errs.append("[跳转失效] 节点 %s 的 %s 指向不存在的目标 %r" % (src, field, tid)) def check_slot(src, s, field): # P1 是固定玩家 slot，系统隐式合法（与 collect_point_refs/编译器/前端表单一致），不需在 roles 声明 if s and s != "P1" and s not in slots: errs.append("[未声明角色] 节点 %s 的 %s 引用了未在 roles 声明的 slot %r" % (src, field, s)) def check_grants(src, grants): for g in grants or []: k = g.get("kind") if not dic.is_known_grant(k): errs.append("[未知奖励] 节点 %s 出现未登记的 grant kind %r" % (src, k)); continue if k == "道具" and not ITEM_RE.match(str(g.get("item", ""))): errs.append("[非法道具ID] 节点 %s 的道具 %r 不是合法 ID" % (src, g.get("item"))) spec = dic.grant_spec(k) if spec.get("form") in ("money", "item", "friend") and \ not isinstance(g.get("value"), (int, float)): errs.append("[非法数值] 节点 %s 的奖励数值 %r 不是数字" % (src, g.get("value"))) if dic.grant_needs_target(k): check_slot(src, g.get("target"), "奖励target") def check_cond(src, c): if not c: return if not dic.is_known_cond(c.get("kind")): errs.append("[非法条件] 节点 %s 的 condition %r 无法编译" % (src, c)); return spec = dic.cond_spec(c.get("kind")) if c.get("op") not in spec.get("ops", {}): errs.append("[非法条件] 节点 %s 的 condition %r 比较符不支持" % (src, c)) elif not isinstance(c.get("value"), (int, float)): errs.append("[非法条件数值] 节点 %s 的 condition 阈值 %r 不是数字" % (src, c.get("value"))) for nid, n in nodes.items(): kind = n.get("kind") if n.get("next"): check_target(nid, n["next"], "next") if n.get("speaker"): check_slot(nid, n["speaker"], "speaker") if n.get("actor"): check_slot(nid, n["actor"], "actor") if kind in ("choice", "choice_once"): opts = n.get("options", []) if not opts: errs.append("[空选择] 节点 %s 没有任何选项" % nid) if not any("condition" not in o for o in opts): errs.append("[选项无兜底] 节点 %s 的所有选项都带条件，可能全部不满足导致空面板卡死" % nid) for o in opts: check_target(nid, o.get("goto"), "option.goto") check_cond(nid, o.get("condition")) if o.get("reward"): check_grants(nid, o["reward"].get("grants")) if o.get("skip"): sk = o["skip"] check_target(nid, sk.get("node"), "option.skip.node") grants = (sk.get("reward") or {}).get("grants") if not grants: errs.append("[空skip奖励] 节点 %s 选项 skip 缺 reward.grants（押注无彩头）" % nid) check_grants(nid, grants) if kind == "random": for b in n.get("branches", []): check_target(nid, b.get("goto"), "branch.goto") if not isinstance(b.get("weight"), (int, float)): errs.append("[非法权重] 节点 %s 的随机权重 %r 不是数字" % (nid, b.get("weight"))) if kind == "fight": if n.get("fight_type") not in (1, 2): errs.append("[非法战斗类型] 节点 %s 的 fight_type 必须是 1(击倒)/2(死斗)" % nid) if not n.get("camp2"): errs.append("[战斗缺敌方] 节点 %s 的 camp2 为空" % nid) for s in (n.get("camp2") or []) + (n.get("camp1") or []): check_slot(nid, s, "fight阵营") check_target(nid, n.get("win"), "fight.win") check_target(nid, n.get("lose"), "fight.lose") if kind == "move": check_slot(nid, n.get("actor"), "move.actor") if kind == "reward": check_grants(nid, n.get("grants")) if kind == "scene": _check_scene(nid, n, slots, anchors, errs) for e in ir.get("endings", []): check_grants(e["id"], e.get("grants")) # ---- 点位集坐标引用校验 ---- _check_point_set(ir, errs, warns, points_dir, strict_points) return errs, warns def collect_point_refs(ir): """收集 IR 里**实际需要物理站位**的点位名（角色出生点/移动目标/镜头点/战斗阵营）。 仅声明、从未在节点出现的 role（如未登场的旁系角色）不计——运行时不为其摆人。 """ refs = set() all_nodes = list(ir.get("nodes", [])) for s in ir.get("sequences", []): all_nodes += s.get("nodes", []) for n in all_nodes: for f in ("speaker", "actor"): v = n.get(f) if v and v != "P1": refs.add(v) if n.get("kind") == "move" and n.get("to") and n["to"] != "P1": refs.add(n["to"]) if n.get("camera"): refs.add(n["camera"]) if n.get("kind") == "fight": for s in (n.get("camp1") or []) + (n.get("camp2") or []): if s and s != "P1": refs.add(s) if n.get("kind") == "scene": for tk in n.get("tracks", []) or []: a = tk.get("actor") if a and a != "P1": refs.add(a) for clip in tk.get("clips", []) or []: if clip.get("kind") == "move" and clip.get("to") and clip["to"] != "P1": refs.add(clip["to"]) if clip.get("kind") == "camera" and clip.get("focus"): refs.add(clip["focus"]) return refs def _load_anchors(ir, points_dir): """加载点位集坐标 {点位名:(x,z)}；缺失/损坏返回 {}（scene move 重叠检会因此跳过）。""" import json name = (ir.get("stage") or {}).get("point_set") or ir["id"] base = points_dir or _POINTS_DIR path = os.path.join(base, name + ".points.json") if not os.path.exists(path): return {} try: with open(path, encoding="utf-8") as f: ps = json.load(f) except Exception: return {} out = {} for p in ps.get("points", []): pos = p.get("pos") or [0, 0, 0] if p.get("name"): out[p["name"]] = (pos[0], pos[2]) # 俯视用 x,z return out def _check_scene(nid, node, slots, anchors, errs): """P2 scene 节点校验：轨道/clip 合法性 + 同 actor move 时间不重叠（D4）。 点位存在性由 collect_point_refs + _check_point_set 统一校验，此处只查字段齐备与时序。 """ tracks = node.get("tracks") if not isinstance(tracks, list) or not tracks: errs.append("[空演出段] scene 节点 %s 没有任何 track" % nid); return seen_clip = set() moves_by_actor = {} # actor -> [clip]（含跨轨；同 actor move 不得重叠） for ti, tk in enumerate(tracks): is_cam = tk.get("role") == "camera" actor = tk.get("actor") if not is_cam: if not actor: errs.append("[轨道缺actor] scene %s 第%d条轨道既非镜头轨(role:camera)也未指定 actor" % (nid, ti + 1)) elif actor != "P1" and actor not in slots: errs.append("[未声明角色] scene %s 轨道 actor %r 未在 roles 声明" % (nid, actor)) for clip in tk.get("clips", []) or []: cid = clip.get("id") if cid: if cid in seen_clip: errs.append("[clip重复id] scene %s 内 clip id %r 重复（scene 内须唯一）" % (nid, cid)) seen_clip.add(cid) k = clip.get("kind") if k not in _SCENE_CLIP_KINDS: errs.append("[非法clip] scene %s 的 clip %r 的 kind %r 不在允许集合 %s" % (nid, cid, k, sorted(_SCENE_CLIP_KINDS))); continue st = clip.get("start") if not isinstance(st, (int, float)) or st < 0: errs.append("[非法start] scene %s 的 clip %r 的 start %r 必须是 ≥0 的数字" % (nid, cid, st)) d = clip.get("dur") if d is not None and (not isinstance(d, (int, float)) or d <= 0): errs.append("[非法dur] scene %s 的 clip %r 的 dur %r 必须为正数" % (nid, cid, d)) if k in ("dialogue", "narration") and not str(clip.get("text") or "").strip(): errs.append("[空文本] scene %s 的 %s clip %r 文本为空" % (nid, k, cid)) if k == "move" and not clip.get("to"): errs.append("[move缺目标] scene %s 的 move clip %r 缺 to(目标点)" % (nid, cid)) if k == "camera" and not clip.get("focus"): errs.append("[camera缺焦点] scene %s 的 camera clip %r 缺 focus(点位)" % (nid, cid)) if k == "wait" and not isinstance(d, (int, float)): errs.append("[wait缺时长] scene %s 的 wait clip %r 必须显式 dur" % (nid, cid)) if k == "move" and not is_cam and actor: moves_by_actor.setdefault(actor, []).append(clip) # 同 actor 的 move 时间不得重叠（一个人不能同时走两处）；无坐标无法估时长则跳过该 actor for actor, mvs in moves_by_actor.items(): prev_pos = anchors.get(actor) mvs_sorted = sorted(mvs, key=lambda c: c.get("start") or 0) timed, ok = [], True for c in mvs_sorted: st = c.get("start") or 0 d = c.get("dur") if isinstance(d, (int, float)) and d > 0: prev_pos = anchors.get(c.get("to"), prev_pos) else: to = anchors.get(c.get("to")) if to is None or prev_pos is None: ok = False; break dist = ((to[0] - prev_pos[0]) ** 2 + (to[1] - prev_pos[1]) ** 2) ** 0.5 d = max(0.3, dist / (c.get("speed") or MOVE_SPEED)) prev_pos = to timed.append((st, st + d, c.get("id"))) if not ok: continue timed.sort() for i in range(1, len(timed)): if timed[i - 1][1] > timed[i][0] + 1e-6: errs.append("[move重叠] scene %s 的 actor %s：move %r 尚未走完，move %r 又起步" "（同一人不能同时走两处）" % (nid, actor, timed[i - 1][2], timed[i][2])) def _check_point_set(ir, errs, warns, points_dir, strict_points): import json name = (ir.get("stage") or {}).get("point_set") or ir["id"] base = points_dir or _POINTS_DIR path = os.path.join(base, name + ".points.json") refs = collect_point_refs(ir) if not os.path.exists(path): msg = "[点位集缺失] 未找到 %s.points.json（%s）；坐标校验跳过" % (name, path) if strict_points: errs.append(msg + "（--strict-points 下视为错）") else: warns.append(msg) return try: with open(path, encoding="utf-8") as f: ps = json.load(f) except Exception as e: errs.append("[点位集损坏] %s 解析失败: %s" % (path, e)); return have = {p.get("name") for p in ps.get("points", [])} for r in sorted(refs): if r not in have: errs.append("[点位缺失] 点位 %r 在点位集 %s.points.json 中不存在（需取点工具补录）" % (r, name))