5.3 与机制张力的分工

#!/usr/bin/env python3
# file: sim/nm_05_3_mechanic_division.py
# tier: S
# verify: /opt/homebrew/bin/python3 sim/nm_05_3_mechanic_division.py
"""卷三 5.3 与机制张力的分工（S 层）：把「边界」跑成可核对的数。

分工不是一句口号，而是**输入清单的差集**。本脚本把 config/story_spec.json 递归展开，
对每个字段名与字符串标量做词元命中统计：

  叙事侧词元（tension / beat / scene / ending / affinity / flag）应 > 0——它们是本节曲线的输入；
  机制侧词元（hp / damage / resource / turn / round / cooldown / stamina / mana）应为 0——
  这份规格里根本没有它们，所以「机制张力」在这份真源上**无法计算**，只能来自另一套规格。

把这条差集跑出来，「本章的张力来自叙事节拍、不来自机制动力学」就不再是修辞。
产出 out/nm_05_3_mechanic_division.json。全部定点整数。
"""
from __future__ import annotations

import json
import os
import sys

HERE = os.path.dirname(os.path.abspath(__file__))
ROOT = os.path.dirname(HERE)
OUT = os.path.join(ROOT, "out")

NARRATIVE = ["tension", "beat", "scene", "ending", "affinity", "flag"]
MECHANIC = ["hp", "health", "damage", "resource", "turn", "round", "cooldown", "stamina", "mana", "attack", "defense"]


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


def tokens(obj, acc):
    """递归收集所有 dict 键与字符串标量，小写后入 acc。"""
    if isinstance(obj, dict):
        for k, v in obj.items():
            acc.append(str(k).lower())
            tokens(v, acc)
    elif isinstance(obj, list):
        for v in obj:
            tokens(v, acc)
    elif isinstance(obj, str):
        acc.append(obj.lower())


def main() -> int:
    spec = load_spec()
    acc: list[str] = []
    tokens(spec, acc)

    def hits(word: str) -> int:
        return sum(1 for t in acc if word in t)

    nar = {w: hits(w) for w in NARRATIVE}
    mec = {w: hits(w) for w in MECHANIC}

    print(f"词元总数     {len(acc)}（字段名 + 字符串标量）")
    print("叙事侧词元：")
    for w in NARRATIVE:
        print(f"  {w:<10} {nar[w]}")
    print("机制侧词元：")
    for w in MECHANIC:
        print(f"  {w:<10} {mec[w]}")

    nar_total = sum(nar.values())
    mec_total = sum(mec.values())
    print(f"叙事侧命中   {nar_total}   机制侧命中 {mec_total}")

    # 本节的曲线只读三样东西，逐一确认存在
    inputs = {
        "beats[].tension": len(spec["beats"]),
        "metrics.target_tension_curve": len(spec["metrics"]["target_tension_curve"]),
        "scene_graph.nodes": len(spec["scene_graph"]["nodes"]),
    }
    for k, v in inputs.items():
        print(f"输入 {k:<32} {v}")

    assert nar_total > 0, "叙事侧词元应命中"
    assert mec_total == 0, "本规格不应出现机制侧词元"
    assert len(spec["beats"]) == len(spec["metrics"]["target_tension_curve"])

    os.makedirs(OUT, exist_ok=True)
    report = {
        "token_total": len(acc),
        "narrative_tokens": nar,
        "mechanic_tokens": mec,
        "narrative_hits": nar_total,
        "mechanic_hits": mec_total,
        "narrative_inputs": inputs,
        "division": "叙事张力输入来自 beats[].tension 沿路径的序列；机制张力需 HP/资源/回合节奏，本规格无此字段",
        "invariant_residual": 0,
    }
    with open(os.path.join(OUT, "nm_05_3_mechanic_division.json"), "w", encoding="utf-8") as fh:
        json.dump(report, fh, ensure_ascii=False, indent=2)
        fh.write("\n")
    print("wrote out/nm_05_3_mechanic_division.json")
    print(f"OK nm_05_3_mechanic_division：叙事侧 {nar_total} 命中，机制侧 {mec_total} 命中，边界成立")
    return 0


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

词元总数     2597（字段名 + 字符串标量）
叙事侧词元：
  tension    18
  beat       7
  scene      66
  ending     8
  affinity   8
  flag       36
机制侧词元：
  hp         0
  health     0
  damage     0
  resource   0
  turn       0
  round      0
  cooldown   0
  stamina    0
  mana       0
  attack     0
  defense    0
叙事侧命中   143   机制侧命中 0
输入 beats[].tension                  16
输入 metrics.target_tension_curve     16
输入 scene_graph.nodes                14
wrote out/nm_05_3_mechanic_division.json
OK nm_05_3_mechanic_division：叙事侧 143 命中，机制侧 0 命中，边界成立

{
  "section": "5.3",
  "tier": "D",
  "division": [
    {"aspect": "张力来源", "mechanic": "机制动力学", "narrative": "叙事节拍结构"},
    {"aspect": "输入", "mechanic": "HP / 资源 / 回合节奏", "narrative": "beats[].tension 整数 1..5"},
    {"aspect": "消费对象", "mechanic": "一局战斗的状态轨迹", "narrative": "玩家路径经过的节拍序列"},
    {"aspect": "计算方式", "mechanic": "机制仿真", "narrative": "规格投影 + 分段定位"},
    {"aspect": "真源", "mechanic": "数值与规则", "narrative": "config/story_spec.json#beats"},
    {"aspect": "本规格是否可算", "mechanic": "否（无 hp / resource / turn 字段）", "narrative": "是"}
  ],
  "narrative_inputs": ["beats[].tension", "metrics.target_tension_curve", "scene_graph.nodes"],
  "mechanic_token_hits": 0,
  "proxy": "两侧都是 proxy 口径，本节只做边界声明，不比较两种张力谁更准"
}