附录 A 动态与体验指标公式、参数表与数据集索引

# snippet: S 层用全路径解释器；shell 的 for 循环逐个执行，避免只跑第一个文件
cd "$HOME/.gdbook/ashdeck"
for f in sim/gd_play_*.py; do /opt/homebrew/bin/python3 "$f" || exit 1; done

# snippet: node --test 接收 glob 而非目录，必须加引号让 node 自己展开
cd "$HOME/.gdbook/ashdeck"
node --test 'core/test/gd_play_*.test.ts'

# snippet: 复用全局 Playwright 必须经 createRequire；verify 产出截图并断言 canvas 已绘制
cd "$HOME/.gdbook/ashdeck"
node web/build_play16.mjs
NODE_PATH=/opt/homebrew/lib/node_modules node web/verify_mech.mjs --page out/play16.html --shot out/shots/play16.png --expect-digest '{"block":0,"cardCount":12,"damageConserved":true,"dealt":50,"enemyHp":0,"energy":1,"hand":["strike","jab","heavy"],"over":true,"played":9,"playerHp":48,"turn":4,"won":true}'

#!/usr/bin/env python3
# file: sim/gd_play_appendix_a.py
# tier: S
# verify: /opt/homebrew/bin/python3 sim/gd_play_appendix_a.py
"""卷二 附录 A 全卷指标总表（S 层聚合内核）：把 16 章各自落盘的 out/play*.json 读回来，
每章取一个「表头指标」，聚成一张**全卷指标总表**打印。

它不重跑任何指标——它跑的是「落盘产物能不能被汇总成一张可核对的表」。每行的值是**代理指标**
口径下的整数或千分比，只用于**相对比较**，禁绝对化。缺文件即报缺，不臆造。本脚本只打印，
不写任何新产物（附录是只读汇总）。全整数、无浮点、无 random。
"""
from __future__ import annotations

import json
import os

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


def get(d, path):
    for k in path:
        d = d[k]
    return d


# (章, 表头指标, 单位, 产物文件, 取值函数)——取值函数只做整数抽取，不含浮点
ROWS = [
    ("01", "策略空间熵", "permille", "play01_entropy.json", lambda d: get(d, ["entropyPermille", "H0"])),
    ("02", "严格支配对数", "int", "play02_dominance.json", lambda d: len(get(d, ["strictPairs"]))),
    ("03", "可用子博弈占比", "permille", "play03_cost.json", lambda d: get(d, ["livePermille"])),
    ("04", "涌现度", "permille", "play04_emergence.json", lambda d: get(d, ["emergencePermille"])),
    ("05", "平衡分", "permille", "play05_metric.json", lambda d: get(d, ["metrics", "balanceScore"])),
    ("06", "相变临界点", "int", "play06_phase.json", lambda d: get(d, ["criticalPoint"])),
    ("07", "动因覆盖", "permille", "play07_model.json", lambda d: get(d, ["coveragePermille"])),
    ("08", "类型漂移峰值", "permille", "play08_drift.json", lambda d: max(r["drift"] for r in get(d, ["points"]))),
    ("09", "张力峰值", "permille", "play09_tension.json", lambda d: max(r["peak"] for r in get(d, ["scan"]))),
    ("10", "心流带宽峰值", "int", "play10_band.json", lambda d: max(r["bandWidth"] for r in get(d, ["rows"]))),
    ("11", "习得达标局", "int", "play11_acquisition.json", lambda d: get(d, ["crossExponential"])),
    ("12", "指标区分度", "permille", "play12_pipeline.json", lambda d: get(d, ["discriminationPermille", "playerHp.max"])),
    ("13", "可玩性组合熵", "permille", "play13_playability.json", lambda d: get(d, ["rows"])[0]["entropy"]),
    ("14", "支配缺失度", "permille", "play14_heatmap.json", lambda d: get(d, ["dominatedPermille"])),
    ("15", "反推参数值", "int", "play15_invert.json", lambda d: get(d, ["inverted"])),
    ("16", "装配核对失败数", "int", "gd_play_16_assembly.json", lambda d: get(d, ["fail"])),
]


def main() -> int:
    table, missing = [], []
    for ch, name, unit, fn, pick in ROWS:
        p = os.path.join(OUT, fn)
        if not os.path.exists(p):
            missing.append(fn)
            continue
        with open(p, encoding="utf-8") as f:
            data = json.load(f)
        table.append({"chapter": ch, "metric": name, "unit": unit, "file": fn, "value": int(pick(data))})

    print("=== 卷二 全卷指标总表（16 章各取一个表头指标，代理指标口径）===")
    for r in table:
        print(f"ch{r['chapter']}  {r['metric']}  {r['unit']}  {r['value']}  <- out/{r['file']}")
    print(f"rows={len(table)}  missing={missing or '无'}")
    print("（全部为代理指标，只做相对比较，禁绝对化；本脚本只打印，不写新产物）")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

=== 卷二 全卷指标总表（16 章各取一个表头指标，代理指标口径）===
ch01  策略空间熵  permille  2584  <- out/play01_entropy.json
ch02  严格支配对数  int  5  <- out/play02_dominance.json
ch03  可用子博弈占比  permille  500  <- out/play03_cost.json
ch04  涌现度  permille  2692  <- out/play04_emergence.json
ch05  平衡分  permille  605  <- out/play05_metric.json
ch06  相变临界点  int  18  <- out/play06_phase.json
ch07  动因覆盖  permille  666  <- out/play07_model.json
ch08  类型漂移峰值  permille  278  <- out/play08_drift.json
ch09  张力峰值  permille  910  <- out/play09_tension.json
ch10  心流带宽峰值  int  6  <- out/play10_band.json
ch11  习得达标局  int  5  <- out/play11_acquisition.json
ch12  指标区分度  permille  1000  <- out/play12_pipeline.json
ch13  可玩性组合熵  permille  2251  <- out/play13_playability.json
ch14  支配缺失度  permille  292  <- out/play14_heatmap.json
ch15  反推参数值  int  65  <- out/play15_invert.json
ch16  装配核对失败数  int  0  <- out/gd_play_16_assembly.json
rows=16  missing=无
（全部为代理指标，只做相对比较，禁绝对化；本脚本只打印，不写新产物）