game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

refactor(波2 目录收尾): game/smoke/ 目录退役——44 件探针三件套迁 game/probe/、30 件测量/诊断/驱动件迁 game/sim/；全仓 100+ 处 res://smoke 与 game/smoke 引用改指（闸件/产品码 tune_sim_controller/宿主 preload/根规则/README/设计文档）；熵增闸 RETIRED 收编 game/smoke 防回潮；AGENTS.md Project Layout 换代；static_scan 豁免理由换新宿主；波 2 施工件预计算表全部命中（8d 预扫零红灯）；全量域闸验收通过零新增红

Browse Source
This commit is contained in:
DKChan committed 2026-10-24 02:09:27 +08:00
1 parent c5f1383766
commit 16c6f1362e
110 files changed
+139 -7305
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

game/tests/README.md
+8 -8
View File
@@ -4,7 +4,7 @@
**Test Framework**: 标准四级测试层（冒烟／单元／集成／系统）＋ headless 场景探针与渲染 golden；gdUnit4 **deferred**（D2 OQ1 关闭形态——本仓库不引第三方测试框架，需求见下「门禁」节）
**门禁**: 本地闸——`tools/run_all_gates.sh`（收口唯一验收入口，按改动域选档 `--code`／`--docs`，跨两域或改闸件本身不带参数＝全量）。本仓库**无远端、无 CI**（`.github/workflows/` 已删除，不建不留不参考）；闸清单与域划分只在本脚本定义，文档不另列
**Setup date**: 2026-09-12（2026-09-27 `7f24b640` 三层收敛：根 tests/ 并入 `game/tests/`、docs 并入 `design/engineering/`、production 解散）
**参考实现**: `game/smoke/`（场景探针族——正式工程的活样板；系统测试断言面过渡宿主 `smoke_all.gd` 亦在此，迁移归断言迁移批）
**参考实现**: `game/probe/`（场景探针族）· `game/sim/`（测量/诊断/模拟驱动件）（场景探针族——正式工程的活样板；系统测试断言面过渡宿主 `smoke_all.gd` 亦在此，迁移归断言迁移批）
## Directory Layout
@@ -27,8 +27,8 @@ tests/
| **冒烟测试** | 这版活着吗——能否启动、能否加载表、能否进主屏。零逻辑判定 | `tests/smoke_boot.tscn/.gd`（以项目运行目标拉起＝真实开机路径） | `run_smoke.py`（闸 00） |
| **单元测试** | 最单元的逻辑代码对不对（公式/状态机/纯逻辑） | `tests/unit/` | `run_all.gd` manifest（闸 02） |
| **集成测试** | 跨系统的闭环对不对 | `tests/integration/` | 同上（与单元测试同一入口、同一协议） |
| **系统测试** | 启动真实工程走真实玩法路径 | 过渡期 `game/smoke/smoke_all.gd`（断言迁移批后＝`tests/system_test.gd`） | `run_system_test.py`（闸 01） |
| **UI 探针＋渲染 golden** | 跑起来之后 UI 与场景切换对不对；画面基线 | `game/smoke/*.tscn` 探针 | `probe_gate.sh`（闸 03/04）、`render_gate.sh`（闸 05） |
| **系统测试** | 启动真实工程走真实玩法路径 | 过渡期 `game/probe/smoke_all.gd`（断言迁移批后＝`tests/system_test.gd`） | `run_system_test.py`（闸 01） |
| **UI 探针＋渲染 golden** | 跑起来之后 UI 与场景切换对不对；画面基线 | `game/probe/*.tscn` 探针 | `probe_gate.sh`（闸 03/04）、`render_gate.sh`（闸 05） |
> **integration/ 已建承载**（迭代 29 T3——此前只有章程句无实体，空壳曾于迭代 19 卡① T4 删过一次）。
> 首个集成用例 = `save_rng_roundtrip_test.gd`（存档⇄RNG 快照往返）。章程登记的四类集成用例里，
@@ -61,7 +61,7 @@ godot --headless --script tests/unit/example_test.gd
python tools/run_system_test.py
# 场景探针（UI 探针层）——以探针场景为运行目标，走完整项目引导（autoload 在位）
godot --headless --path . res://smoke/<probe>.tscn
godot --headless --path . res://probe/<probe>.tscn
# 本地闸必须配外部 wall-clock 超时（引擎无死锁探测；run_all_gates.sh 已内置）
timeout 120s godot --headless --script tests/run_all.gd
@@ -94,9 +94,9 @@ timeout 120s godot --headless --script tests/run_all.gd
| UI | Manual walkthrough OR interaction test（场景探针为首选） | `tests/evidence/` |
| Config/Data | Smoke test pass | 跑批回执 `game/tests/.gates/receipt.json`（不入库）＋结论随批记 `reports/` |
## game/smoke/ 游离脚本台账（迭代 29 T7 逐个定性）
## game/probe/ 游离脚本台账（迭代 29 T7 逐个定性）
`game/smoke/` 里的脚本两分：**在闸件**（探针有 `.tscn` 宿主、被 `probe_gate.sh`／`render_gate.sh` 调用；
`game/probe/` 里的脚本两分：**在闸件**（探针有 `.tscn` 宿主、被 `probe_gate.sh`／`render_gate.sh` 调用；
`smoke_all.gd` 被系统测试运行器调用——过渡期宿主）与**不入闸的手动测量/诊断件**（下表）。
判据 = 头注自陈用途 + 有无外部引用（工具脚本/产品码/文档）。**存疑一律按在役登记并标注**（不退役）。
@@ -158,6 +158,6 @@ S12 效果引擎无状态化旧件零残留：扫描 game/ 全域 `.gd` 与 `gam
| **冒烟测试** | 秒级存活检查——能否启动、能否加载表、能否进主屏。判断「这版还活着吗」，不判断「这版对不对」 | `tests/smoke_boot.tscn/.gd`、`tools/run_smoke.py` |
| **单元测试** | 隔离的公式/状态机/纯逻辑断言面，逐套件独立进程实跑 | `game/tests/unit/`、`run_all.gd` |
| **集成测试** | 跨系统闭环断言面（存档⇄RNG 往返、回放确定性等） | `game/tests/integration/`、`run_all.gd` |
| **系统测试** | 启动真实工程走真实玩法路径的断言面 | 过渡期 `game/smoke/smoke_all.gd`＋`tools/run_system_test.py`；迁移后 `tests/system_test.gd` |
| **场景探针** | 以探针场景为运行目标、走完整项目引导（autoload 在位）的 UI/场景断言 | `game/smoke/*.tscn`、`probe_gate.sh` |
| **系统测试** | 启动真实工程走真实玩法路径的断言面 | 过渡期 `game/probe/smoke_all.gd`＋`tools/run_system_test.py`；迁移后 `tests/system_test.gd` |
| **场景探针** | 以探针场景为运行目标、走完整项目引导（autoload 在位）的 UI/场景断言 | `game/probe/*.tscn`、`probe_gate.sh` |
| **渲染 golden** | 窗口化截图与基线图的逐像素容差比对 | `render_gate.sh`、`tests/golden/` |
game/tests/integration/cross_system_flow_test.gd
+1 -1
View File
@@ -14,7 +14,7 @@ extends SceneTree
const Kit := preload("res://tests/unit/test_kit.gd")
const ConfigDBScript := preload("res://core/config_db.gd")
const LevelAutoplay := preload("res://smoke/level_autoplay.gd") # 真局驱动（迁移期按现路径 preload——账本 §五夹具前提）
const LevelAutoplay := preload("res://sim/level_autoplay.gd") # 真局驱动（迁移期按现路径 preload——账本 §五夹具前提）
var _db
game/tests/static_scan.sh
+1 -1
View File
@@ -97,7 +97,7 @@ fi
# 禁「板级」「门票」「正主」「落籍」「完美排雷」等退役词进注释面（完整词表见术语表解析）
# 权威出处：design/gdd/术语表.md「退役词对照」节＋「对外命名纪律」节
# 同形异义豁免：机制词「去重闸」（封印重判去重的玩法判别器）与某闸档退役词后二字同形——
# 行内含「去重闸」即整行跳过（2026-10-22 测试术语重构批随闸档用语入表增设，否则 smoke_all.gd
# 行内含「去重闸」即整行跳过（2026-10-22 测试术语重构批随闸档用语入表增设，否则 adventure_feats_test.gd
# 在册断言标签成片误红；代价＝该行同时出现的真闸档用词也不报，靠文档域 08 闸兜住）
# 扫描面：game/ 全域 .gd/.tres/.md/.json/.sh（.txt 不收＝第三方许可证非本仓库文本）
# 注释文本提取：.gd/.sh 取 # 后文本；.tres 取 ; 后文本；.md 取整行；.json 无注释语法（保留扩展名但不产生注释段）
game/tests/system_test.gd
+3 -3
View File
@@ -1,6 +1,6 @@
# tests/system_test.gd — 系统测试宿主薄壳（SceneTree＋构造注入）
# 系统测试 = 启动真实工程走真实玩法路径的断言面（标准四级测试层之一，闸 01）。
# 本件现宿主零断言——smoke_all.gd 的断言按「只剪切禁改写」纪律迁入（断言迁移批执行，
# 本件为系统测试宿主（标准四级测试层之一，闸 01）。（原过渡期自述作废——，
# 本批只落宿主薄壳，跑通即绿）。迁移完成后 tools/run_system_test.py 缺省 --script 改指本件。
# 协议照单元侧惯例：extends SceneTree 获得 quit(code)；--script 模式不加载 autoload，
# 运行形态＝--script 直跑＋autoload 分派闸（ConfigDB/SaveManager 在座才进主断言面——闸 01 实跑 65 项 0 失败实证在案）；摘要行由 tools/run_system_test.py 三闸判定
@@ -8,7 +8,7 @@
# 运行：python tools/run_system_test.py --script res://tests/system_test.gd
extends SceneTree
const AutoPlayer := preload("res://smoke/auto_player.gd") # 自动玩家策略单一实现（lifecycle 活战斗驱动；smoke 库件迁移期按现路径 preload）
const AutoPlayer := preload("res://sim/auto_player.gd") # 自动玩家策略单一实现（lifecycle 活战斗驱动；smoke 库件迁移期按现路径 preload）
var _failures: int = 0
var _checks: int = 0
@@ -24,7 +24,7 @@ func check(cond: bool, label: String) -> void:
func _initialize() -> void:
print("=== Dungeon Sweeper 系统测试（宿主薄壳——断言面待迁移批自 smoke_all.gd 迁入） ===")
print("=== Dungeon Sweeper 系统测试 ===")
_split_tail()
game/tests/unit/battle_settlement/roll_multiplier_test.gd
+1 -1
View File
@@ -13,7 +13,7 @@ extends SceneTree
const Kit := preload("res://tests/unit/test_kit.gd")
const ConfigDBScript := preload("res://core/config_db.gd")
const AutoPlayer := preload("res://smoke/auto_player.gd") # 自动玩家策略单一实现（迁移期按现路径 preload——账本 §五夹具前提）
const AutoPlayer := preload("res://sim/auto_player.gd") # 自动玩家策略单一实现（迁移期按现路径 preload——账本 §五夹具前提）
var _db
game/tests/unit/battle_settlement/round_flow_skill_pool_test.gd
+1 -1
View File
@@ -15,7 +15,7 @@ extends SceneTree
const Kit := preload("res://tests/unit/test_kit.gd")
const ConfigDBScript := preload("res://core/config_db.gd")
const AutoPlayer := preload("res://smoke/auto_player.gd") # 自动玩家策略单一实现（迁移期按现路径 preload——账本 §五夹具前提）
const AutoPlayer := preload("res://sim/auto_player.gd") # 自动玩家策略单一实现（迁移期按现路径 preload——账本 §五夹具前提）
var _db
game/tests/unit/battle_settlement/seal_polarity_test.gd
+1 -1
View File
@@ -16,7 +16,7 @@ extends SceneTree
const Kit := preload("res://tests/unit/test_kit.gd")
const ConfigDBScript := preload("res://core/config_db.gd")
const AutoPlayer := preload("res://smoke/auto_player.gd") # 自动玩家策略单一实现（迁移期按现路径 preload——账本 §五夹具前提）
const AutoPlayer := preload("res://sim/auto_player.gd") # 自动玩家策略单一实现（迁移期按现路径 preload——账本 §五夹具前提）
var _db
game/tests/unit/core/adventure_feats_test.gd
+2 -2
View File
@@ -68,7 +68,7 @@ func _smoke_adventure_api() -> void:
Kit.check("pick 后 node_entered 到达 + 首战在飞（接口①开始关卡——停点闭合直达战斗节点）", sig_seq.size() == 3 and String(sig_seq[2]) == "node_entered" and adr.runner().current_battle() != null)
Kit.check("战斗中 abandon 拒绝（战斗域单事务在飞）", not adr.abandon())
# 驱动首战到胜利 → 选路态（非战斗期）→ abandon 受理
var autoplay = load("res://smoke/level_autoplay.gd")
var autoplay = load("res://sim/level_autoplay.gd")
var battle = adr.runner().current_battle()
var st := _battle_st("normal")
var guard := 30
@@ -107,7 +107,7 @@ func _api_mark_node(_node: Dictionary, _info: Dictionary, seq: Array) -> void:
# 重复拒绝/GP 跨关延续/加算区同账/恢复数学/放弃）
func _smoke_adventure() -> void:
print("--- 冒险结构验收（三关序列 · 大奖励 · 摘要五件事 · 账本封闭）---")
var autoplay = load("res://smoke/level_autoplay.gd")
var autoplay = load("res://sim/level_autoplay.gd")
# ① 表与覆盖义务（序列关数 = 行集关数；行集内每个战斗/Boss 节点跨表精确行集——覆盖义务断言；
# enemy 侧键域 = (level_index, row_kind, depth_band)——战斗节点查 battle 键域、Boss 节点查 boss 键域，
# 同带多行合法，带键聚合天然兼容〔fv24〕）
game/tests/unit/core/level_shop_economy_test.gd
+5 -5
View File
@@ -44,7 +44,7 @@ func _init() -> void:
func _smoke_level() -> void:
print("--- 关卡节点地图·线性推进（战×2→道具→战×2→恢复→Boss）---")
var autoplay = load("res://smoke/level_autoplay.gd")
var autoplay = load("res://sim/level_autoplay.gd")
var hero_base := {"atk": int(_db.hero.atk), "hp": int(_db.hero.max_hp), "ac": int(_db.hero.armor_class)} # 配置基线快照——⑤ 回基线对比用（改表自动跟随，不再硬编码）
# ① 满配通关路径（atk+200%/hp+100%——测试面板同源的属性覆盖）
var win = autoplay.run_level(_db, 42, 1, 200, 100)
@@ -91,7 +91,7 @@ func _battle_st(policy: String) -> Dictionary:
func _smoke_level_graph() -> void:
print("--- 关卡节点地图·分支节点图（L2 幽暗地域）---")
var autoplay = load("res://smoke/level_autoplay.gd")
var autoplay = load("res://sim/level_autoplay.gd")
# ① L1 单链与 L2 图经同一套加载校验（单链 = 出边恰一的退化形态——load_tables 全绿已含，显式复述）
Kit.check("LevelTable 图合法性校验：L1 单链 + L2 图同套算法零错误", _db.level.validate().is_empty())
# ② L2 行集结构（网状图建议规模）
@@ -382,7 +382,7 @@ func _fresh_rng(seed_val: int):
func _smoke_gp_wallet() -> void:
print("--- GP 冒险钱包·到账（战斗完成入账恰一次 + Boss 加值）---")
var autoplay = load("res://smoke/level_autoplay.gd")
var autoplay = load("res://sim/level_autoplay.gd")
# ① L1 首战（普通战档——掷定 [2,4] + 关级加值 0）：runner 驱动，收集 battle_finished 与钱包事件
var runner = load("res://core/level_runner.gd").new(_db, _fresh_rng(42))
runner.set_hero_override(200, 100)
@@ -560,7 +560,7 @@ func _find_gp_dig(minesweeper, settlement) -> Dictionary:
func _smoke_shop_room() -> void:
print("--- 商店房三收口（现价/加算区/余额不足拒/离开回选路/收束清零）---")
var autoplay = load("res://smoke/level_autoplay.gd")
var autoplay = load("res://sim/level_autoplay.gd")
# 行进到商店房（min 路径：0→1→3(恢复)→6→8）——种子扫描保证进店余额 ≥ 三件首购总价 16（6+4+6）
var shop_run := {}
for s in range(42, 92):
@@ -721,7 +721,7 @@ func _smoke_shop_graph() -> void:
func _smoke_shop_pool() -> void:
print("--- 商店共享池（抽3买1全重抽 · 乘法定价 ceil · 池空硬闸 · 切边零入店）---")
var autoplay = load("res://smoke/level_autoplay.gd")
var autoplay = load("res://sim/level_autoplay.gd")
var shelf_kinds: Array = []
for row in _db.shop_pool_rows():
shelf_kinds.append(String(row.get("kind_id", "")))
game/tests/unit/core/meta_progression_forge_test.gd
+1 -1
View File
@@ -15,7 +15,7 @@ extends SceneTree
const Kit := preload("res://tests/unit/test_kit.gd")
const ConfigDBScript := preload("res://core/config_db.gd")
const AutoPlayer := preload("res://smoke/auto_player.gd") # 自动玩家策略单一实现（迁移期按现路径 preload——账本 §五夹具前提）
const AutoPlayer := preload("res://sim/auto_player.gd") # 自动玩家策略单一实现（迁移期按现路径 preload——账本 §五夹具前提）
var _db
game/tests/unit/presentation/pacing_queue_test.gd
+1 -1
View File
@@ -49,7 +49,7 @@ func _init() -> void:
# 理性策略挖到触发结算（≥1 行入队即达断言前提——AP 一次消耗；挖格须邻英雄——邻接优先排序）
var ms = battle.minesweeper
# 理性策略驱动（auto_player 单一实现复用——damage_probe 同款两步消费：先 move 到 hero_cell 再 dig）
var ap = load("res://smoke/auto_player.gd")
var ap = load("res://sim/auto_player.gd")
var acted := false
for guard in range(40):
var plan: Dictionary = ap.choose_dig(ms)
game/tests/unit/presentation/theme_projection_test.gd
+1 -1
View File
@@ -22,7 +22,7 @@ extends SceneTree
const Kit := preload("res://tests/unit/test_kit.gd")
const ConfigDBScript := preload("res://core/config_db.gd")
const AutoPlayer := preload("res://smoke/auto_player.gd") # 自动玩家策略单一实现（迁移期按现路径 preload——账本 §五夹具前提）
const AutoPlayer := preload("res://sim/auto_player.gd") # 自动玩家策略单一实现（迁移期按现路径 preload——账本 §五夹具前提）
var _db
var _rng