5.1 弧光的阶段与转折

{"stages": ["失踪的传说", "被怀疑的守夜人", "托付者"], "beats": [1, 8, 12]}

#!/usr/bin/env python3
# file: sim/na_05_1_arc_stages.py
# tier: S
# verify: /opt/homebrew/bin/python3 sim/na_05_1_arc_stages.py
"""弧光阶段表的结构校验：三阶段 / 三转折节拍号 / 严格递增 / 落在 beats 范围内。"""
from __future__ import annotations

import json
import os
import sys

BEAT_LO = 1


def load_spec() -> dict:
    here = os.path.dirname(os.path.abspath(__file__))
    with open(os.path.join(here, "../config/story_spec.json"), encoding="utf-8") as fh:
        return json.load(fh)


def main() -> int:
    spec = load_spec()
    n = len(spec["beats"])
    by_num = {i + 1: b for i, b in enumerate(spec["beats"])}
    problems, rows = [], []
    for ch in spec["characters"]:
        arc = ch.get("arc") or {}
        stages, bs = list(arc.get("stages") or []), list(arc.get("beats") or [])
        if len(stages) != 3:
            problems.append(f"{ch['id']} 的 stages 不是 3 个：{len(stages)}")
        if len(bs) != 3:
            problems.append(f"{ch['id']} 的 beats 不是 3 个：{len(bs)}")
        for i in range(1, len(bs)):
            if not bs[i] > bs[i - 1]:
                problems.append(f"{ch['id']} 的转折节拍号非严格递增：{bs}")
        for x in bs:
            if not (BEAT_LO <= x <= n):
                problems.append(f"{ch['id']} 的转折节拍号越界：{x}")
        if any(not s.strip() for s in stages) or len(set(stages)) != len(stages):
            problems.append(f"{ch['id']} 的阶段名有空值或重复：{stages}")
        rows.append({"id": ch["id"], "name": ch["name"], "stages": stages, "beats": bs,
                     "tension": [by_num[x]["tension"] for x in bs if x in by_num],
                     "act": [by_num[x]["act"] for x in bs if x in by_num]})
    flat = [x for r in rows for x in r["beats"]]
    strict = sum(1 for r in rows if all(r["beats"][i] > r["beats"][i - 1] for i in range(1, 3)))
    in_range = sum(1 for x in flat if BEAT_LO <= x <= n)
    acts: dict[int, int] = {}
    for r in rows:
        for a in r["act"]:
            acts[a] = acts.get(a, 0) + 1
    claim: dict[int, list[str]] = {}
    for r in rows:
        for x in r["beats"]:
            claim.setdefault(x, []).append(r["id"])
    dup = {k: v for k, v in claim.items() if len(v) > 1}
    here = os.path.dirname(os.path.abspath(__file__))
    out = os.path.join(here, "../out/arc_stages.json")
    os.makedirs(os.path.dirname(out), exist_ok=True)
    with open(out, "w", encoding="utf-8") as fh:
        json.dump({"characters": rows, "beats_total": n, "turning_points_total": len(flat),
                   "strictly_increasing": strict, "in_range": in_range,
                   "claimed_per_beat": {str(k): v for k, v in claim.items()},
                   "claimed_by_multiple": {str(k): v for k, v in dup.items()},
                   "problems": problems}, fh, ensure_ascii=False, indent=2)
        fh.write("\n")
    print("角色 阶段① → 阶段② → 阶段③（阶段名 → 转折节拍号·张力）")
    for r in rows:
        cells = [f"{r['stages'][i]} → b{r['beats'][i]:02d}(t{by_num[r['beats'][i]]['tension']})"
                 for i in range(len(r["stages"]))]
        print(f"{r['id']} {r['name']}  " + " | ".join(cells))
    print(f"转折节拍号：{len(rows)} 角色 × 3 = {len(flat)} 个；严格递增 {strict}/{len(rows)}；落在 1..{n} 内 {in_range}/{len(flat)}")
    print(f"按幕分布：第一夜 {acts.get(1, 0)} · 第二夜 {acts.get(2, 0)} · 第三夜 {acts.get(3, 0)}")
    print(f"被 ≥2 个角色声明的节拍：{dup}")
    for p in problems:
        print(f"FAIL {p}")
    if problems:
        return 1
    print("OK na_05_1_arc_stages：6 个角色的弧光阶段表结构自洽")
    return 0


if __name__ == "__main__":
    sys.exit(main())

角色 阶段① → 阶段② → 阶段③（阶段名 → 转折节拍号·张力）
yan 砚  失踪的传说 → b01(t1) | 被怀疑的守夜人 → b08(t3) | 托付者 → b12(t4)
hui 徽  交易者 → b02(t2) | 动摇的盟友 → b06(t3) | 共同承担者 → b14(t5)
shen 沈  教条者 → b03(t2) | 怀疑者 → b09(t4) | 鸣钟者 → b15(t4)
mu 沐  旁观者 → b04(t3) | 账页的持有者 → b10(t5) | 证人 → b13(t5)
lin 林  规矩的看守 → b05(t2) | 沉默的同谋 → b11(t3) | 交接者 → b16(t2)
hai 孩  向导 → b07(t4) | 被抛下的孩子 → b12(t4) | 记得的人 → b16(t2)
转折节拍号：6 角色 × 3 = 18 个；严格递增 6/6；落在 1..16 内 18/18
按幕分布：第一夜 5 · 第二夜 6 · 第三夜 7
被 ≥2 个角色声明的节拍：{12: ['yan', 'hai'], 16: ['lin', 'hai']}
OK na_05_1_arc_stages：6 个角色的弧光阶段表结构自洽

claimed_per_beat: {'1': ['yan'], '8': ['yan'], '12': ['yan', 'hai'], '2': ['hui'], '6': ['hui'], '14': ['hui'], '3': ['shen'], '9': ['shen'], '15': ['shen'], '4': ['mu'], '10': ['mu'], '13': ['mu'], '5': ['lin'], '11': ['lin'], '16': ['lin', 'hai'], '7': ['hai']}
claimed_by_multiple: {'12': ['yan', 'hai'], '16': ['lin', 'hai']}