DKChan
9f21236f80
改动面 112 文件 572+/572-：game/tests/** 与 game/probe/** 共 106 件 545 行 `# oracle:`→`# 判据出处:`；tools/capability_audit.py 正则字面量换中文＋ORACLE_*→CRITERION_*／check_oracle_markers→check_criterion_markers／oracle_marked(flagged)→criterion_* 共 11 行；test-conventions.md:119 格式句＋:155 措辞；待办清单与需求卡片-QA覆盖余量收口批各 1 处字面量；coverage_enum.py:21 与 camp_scene_layout_test.gd:101 旁支措辞；ui_click_probe.gd 对拍局部变量 oracle→expected 7 处；auto_player.gd 三处 safe_set 真值措辞。不动：历史审计报告两份、test-oracle-anchor 分支名、git 史、生成日志；指针格式/扫描面/判红条件/验收义务全不变。 读数（区内实跑）：改前 capability_audit --strict「417 注记函数·红项 0」→改后「417 判据出处注记函数·红项 0」exit=0；新标记 545 行/106 文件，现行义务面 oracle 残留 0（在册沿革除外）；diff 自检 game/ 非注释新增行仅 6 行且全在 ui_click_probe.gd 的 expected 变量段；112 改动文件 CRLF=0；py_compile tools/capability_audit.py OK；--docs exit=0【验收通过】无新增红；--gates exit=0（静态扫描绿、闸壳 bash -n ×13 失败 0）。
85 lines
4.1 KiB
GDScript
85 lines
4.1 KiB
GDScript
# tests/unit/data_config/rng_service_test.gd — 统一随机流单元测试：单盐派生确定性/计数器账本/标签词表封闭
|
||
# 运行：godot --headless --path game --script res://tests/unit/data_config/rng_service_test.gd
|
||
# 红线：零自建 RNG——本测试只经 RngService 统一流取数（确定性契约：同种子逐位复现）。
|
||
# 测试种子为夹具基建值（非玩法数值），与冒烟黄金向量锚（smoke_all m=42 scope 0-4）分工：本文件测
|
||
# 「同种子两实例逐位一致」的相对确定性，绝对向量锚归冒烟单点，避免双处维护同一常量。
|
||
extends SceneTree
|
||
|
||
const RngServiceScript := preload("res://core/rng_service.gd")
|
||
const Kit := preload("res://tests/unit/test_kit.gd") # T6 收口：_check/汇总退出样板单点
|
||
|
||
const TEST_SEED := 20260928 # 夹具种子（任意固定值；语义 = 可复现性，非玩法数值）
|
||
|
||
|
||
func _init() -> void:
|
||
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:201 黄金向量：登记向量逐个复算（装载组）
|
||
_test_derive_determinism()
|
||
_test_counter_ledger()
|
||
_test_stream_draw_determinism()
|
||
_test_negative_seed_normalization()
|
||
quit(Kit.finish("rng_service_test"))
|
||
|
||
|
||
func _fresh_service():
|
||
var rng = RngServiceScript.new()
|
||
rng.set_master_seed(TEST_SEED)
|
||
return rng
|
||
|
||
|
||
# 单盐派生纯函数：两全新实例同种子逐位一致（derive_at 不推计数器——纯函数契约）
|
||
func _test_derive_determinism() -> void:
|
||
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:201 黄金向量：随机派生纯函数对登记向量逐个复算相等、同输入恒同输出（派生确定性组）
|
||
var a = _fresh_service()
|
||
var b = _fresh_service()
|
||
var same := true
|
||
for scope in range(8):
|
||
if a.derive_at(scope) != b.derive_at(scope):
|
||
same = false
|
||
Kit.check("同种子两实例 derive_at(0..7) 逐位一致", same)
|
||
var a2 = _fresh_service()
|
||
var before: int = a2.counter()
|
||
a2.derive_at(0)
|
||
Kit.check("derive_at 为纯函数不推计数器", a2.counter() == before)
|
||
|
||
|
||
# 全局取数计数器：唯一账本——open_stream 逐次 +1（scope 单调）
|
||
func _test_counter_ledger() -> void:
|
||
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:202 计数器纪律：连续取号跨模拟关卡切换单调不重置（计数账本组）
|
||
var rng = _fresh_service()
|
||
var c0: int = rng.counter()
|
||
rng.open_stream("armor_roll")
|
||
var c1: int = rng.counter()
|
||
rng.open_stream("armor_roll")
|
||
var c2: int = rng.counter()
|
||
Kit.check("open_stream 逐次推进全局计数器（+1/次）", c1 == c0 + 1 and c2 == c0 + 2)
|
||
# 用途标签只进事件日志不参与派生——同 scope 同派生种子（统一流口径）
|
||
var rng_x = _fresh_service()
|
||
var rng_y = _fresh_service()
|
||
var s1: int = int(rng_x.open_stream("board_gen").seed)
|
||
var s2: int = int(rng_y.open_stream("reward_roll").seed)
|
||
Kit.check("同 scope 异用途标签派生种子一致（标签不参与派生）", s1 == s2)
|
||
|
||
|
||
# 同种子两实例同标签流的实际取数序列逐位一致（回放确定性契约——存档快照=主种子+计数器的前提）
|
||
func _test_stream_draw_determinism() -> void:
|
||
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:201 同输入恒同输出：流取号确定性（流取号组）
|
||
var faces := 20 # d20 探针面数（夹具值，非玩法表值——只用于产生可比较序列）
|
||
var a = _fresh_service()
|
||
var b = _fresh_service()
|
||
var same := true
|
||
for i in range(12):
|
||
var ra: int = a.open_stream("armor_roll").randi_range(1, faces)
|
||
var rb: int = b.open_stream("armor_roll").randi_range(1, faces)
|
||
if ra != rb:
|
||
same = false
|
||
Kit.check("同种子两实例同标签流取数 12 次逐位一致", same)
|
||
|
||
|
||
# 负输入 abs 归一化（警告通道）——|−s| 与 s 同派生
|
||
func _test_negative_seed_normalization() -> void:
|
||
# 判据出处: design/engineering/architecture/architecture.md:90 RngService：master_seed 与各流 scope 计数器单点（种子规约组）
|
||
var pos = _fresh_service()
|
||
var neg = RngServiceScript.new()
|
||
neg.set_master_seed(-TEST_SEED)
|
||
Kit.check("负种子 abs 归一化后派生与正种子一致", pos.derive_at(0) == neg.derive_at(0))
|