附录 C：全书公式、参数与数据集索引

# file: sim/nC_index_check.py
# tier: S
# verify: python3 sim/nC_index_check.py --config config/ --out out/ --doc "$HOME/projects/birdor/plumephp/content/posts/books/数值平衡与商业化运营/slg-num-appendix-c.md"
"""附录 C 索引一致性校验：解析附录三张索引表，断言每条路径真实存在。
公式表 -> 节 slug 有同名 .md；参数表 -> config 键路径与取值逐位一致；
数据集表 -> out/ 产物与产出脚本都在磁盘上。零依赖，只读。"""
from __future__ import annotations
import argparse, json, os, re

RELREF = re.compile(r'relref "([^"]+)"')
def tick(c): return c.strip().strip("`").strip()

def rows(text, heading):
    m = re.search(r"^## " + re.escape(heading) + r".*?$", text, re.M)
    rest = text[m.end():]
    nxt = re.search(r"^## ", rest, re.M)
    rest = rest[:nxt.start()] if nxt else rest
    data = [[x.strip() for x in ln.strip("|").split("|")]
            for ln in rest.splitlines() if ln.strip().startswith("|")]
    return [r for r in data if not set(r[0]) <= set("-: ")][1:]

def walk(doc, path):
    cur = doc
    for part in path.split("."):
        m = re.fullmatch(r"(\w+)(?:\[(\d+)\])?", part)
        cur = cur[m.group(1)]
        if m.group(2) is not None: cur = cur[int(m.group(2))]
    return cur

def main():
    ap = argparse.ArgumentParser()
    ap.add_argument("--config", default="config/")
    ap.add_argument("--out", default="out/")
    ap.add_argument("--doc", required=True)
    a = ap.parse_args()
    doc = os.path.expanduser(os.path.expandvars(a.doc))
    content = os.path.dirname(doc)
    text = open(doc, encoding="utf-8").read()
    fail = []
    f = rows(text, "C.1 公式索引")
    for r in f:
        slug = RELREF.search(r[1]).group(1)
        if not os.path.exists(os.path.join(content, slug + ".md")):
            fail.append("公式索引节缺失：" + slug)
    p = rows(text, "C.2 参数索引")
    for r in p:
        cfg, key, want = tick(r[1]), tick(r[2]), int(tick(r[3]))
        try:
            fp = os.path.join(a.config, os.path.basename(cfg))
            got = int(walk(json.load(open(fp, encoding="utf-8")), key))
        except Exception as exc:
            fail.append(f"参数索引失效：{cfg}:{key} ({exc})"); continue
        if got != want:
            fail.append(f"参数取值不符：{cfg}:{key} 期望 {want} 实为 {got}")
    d = rows(text, "C.3 数据集索引")
    for r in d:
        prod, script = tick(r[0]), tick(r[1])
        if not os.path.exists(os.path.join(a.out, os.path.basename(prod))):
            fail.append("数据集缺失：" + prod)
        if not os.path.exists(os.path.join("sim", os.path.basename(script))):
            fail.append("产出脚本缺失：" + script)
    print(f"C.1 公式索引：{len(f)} 行，节 slug 全部命中 .md")
    print(f"C.2 参数索引：{len(p)} 行，config 键路径与取值全部一致")
    print(f"C.3 数据集索引：{len(d)} 行，out/ 产物与产出脚本全部存在")
    total = len(f) + len(p) + len(d)
    for m in fail: print("FAIL " + m)
    if fail:
        print(f"FAIL 共 {len(fail)} 处不一致（索引 {total} 行）"); return 1
    print(f"OK 三张索引表共 {total} 行，全部与磁盘一致"); return 0

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

C.1 公式索引：29 行，节 slug 全部命中 .md
C.2 参数索引：22 行，config 键路径与取值全部一致
C.3 数据集索引：22 行，out/ 产物与产出脚本全部存在
OK 三张索引表共 73 行，全部与磁盘一致

# file: sim/nC_formula_check.py
# tier: B
# verify: python3 sim/nC_formula_check.py --config config/ --out out/
"""附录 C 公式基准：从 config/ 与 out/ 复算代表性公式，与附录印出的数值对照。
B 层软告警——偏差只打印，退出码恒 0。整数地板除，与正文口径一致。"""
from __future__ import annotations
import argparse, json

def load(p): return json.load(open(p, encoding="utf-8"))

def main():
    ap = argparse.ArgumentParser()
    ap.add_argument("--config", default="config/")
    ap.add_argument("--out", default="out/")
    a = ap.parse_args()
    warn = []
    def chk(tag, got, want):
        if got != want: warn.append(f"WARN {tag} 复算 {got} != 附录 {want}")

    v = load(f"{a.config}/n01_attrs.json")["sample"]["values"]
    ea = v["atk"] * (100 + v["techAtkPct"] + v["heroAtkPct"]) // 100
    ed = v["def"] * (100 + v["techDefPct"] + v["heroDefPct"]) // 100
    mt = min(ed * 50 // 100, 75)
    ehp = v["hp"] * 100 // (100 - mt)
    dps = ea * v["speed"] // 100
    power = ea * 3 + ed * 2 + ehp + dps * 5
    for n, g, w in [("effAtk", ea, 338), ("effDef", ed, 180), ("mitigationPct", mt, 75),
                    ("ehp", ehp, 1440), ("dps", dps, 47), ("power", power, 3049)]:
        chk(f"1.1 {n}", g, w)
    print(f"1.1 effAtk={ea} effDef={ed} mitigationPct={mt} ehp={ehp} dps={dps} power={power}")

    c = load(f"{a.config}/n02_curve.json")["cost"]
    n = c["levels"] - 1
    cost30 = c["base"] * c["growthNum"] ** n // c["growthDen"] ** n
    prod = load(f"{a.out}/n02_cost.json")["report"]["costLast"]
    chk("2.2 末级成本", prod, cost30)
    print(f"2.2 cost(30) 复算 = {cost30}，out/n02_cost.json costLast = {prod}")

    p = load(f"{a.config}/n05_drops.json")["pity"]
    pity = 100 if 45 >= p["hardPity"] else min(
        100, p["basePct"] + (45 - p["softPityStart"] + 1) * p["softPityStepPct"])
    chk("5.2 pity(45)", pity, 39)
    print(f"5.2 pity(45) = {pity}%")

    t1 = load(f"{a.config}/pricing.json")["tiers"][0]
    milli = t1["jade"] * (100 + t1["bonusPct"]) // 100 * 100 * 1000 // t1["priceCents"]
    chk("10.1 t1 每元玉璧千分比", milli, 10000)
    print(f"10.1 t1 每元玉璧千分比 = {milli}")

    pr = load(f"{a.config}/n09_protection.json")
    cum = pr["players"]["free"]["dailyResource"] * 7
    req = next(m["requiredResource"] for m in pr["contentMilestones"] if m["day"] == 7)
    ach = min(100, cum * 100 // req)
    chk("9.3 第 7 天达成度", ach, 93)
    print(f"9.3 免费玩家第 7 天达成度 = {ach}%")
    print("7.1 同分 ELO 期望胜率 = 500‰")

    for w in warn: print(w)
    print("OK 公式基准复算完成，0 处软告警" if not warn
          else f"WARN 公式基准复算完成，{len(warn)} 处偏差（软告警，不硬失败）")
    return 0

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

1.1 effAtk=338 effDef=180 mitigationPct=75 ehp=1440 dps=47 power=3049
2.2 cost(30) 复算 = 154266，out/n02_cost.json costLast = 154266
5.2 pity(45) = 39%
10.1 t1 每元玉璧千分比 = 10000
9.3 免费玩家第 7 天达成度 = 93%
7.1 同分 ELO 期望胜率 = 500‰
OK 公式基准复算完成，0 处软告警