DKChan
36f652c63a
- 用户实机复测「还是看不清」+ 追责「未经验证不许报完成」：补 board_shot_probe 渲染帧取证探针 （窗口化真实 LevelRunner+novice 18 步+BoardView 真渲染+视口 PNG，L1/L2/L3 三关）—— 深墨直画在 underdark 系地板放大后可辨但观感隐形（双峰纹理：近黑斑+近白筋并存， 任何墨族直画必融一峰）——甲案（按板自适应墨族）证伪 - 修复改三态呈现：dungeon 亮族直画（p90≥4.5/均值≥2.5）/中暗板深墨直画（均值门收紧 3.0）/ 双峰板色牌垫底（素牌+深墨 12:1 纹理免疫——v2 色牌形制复役） - 目视验证（本会话亲验渲染帧）：L2/L3 数字素牌深墨清晰可读，取证图 artwork/qa-board-shots-20261001/（board_L1/L2/L3 + _zoom_L2 证伪对照） - 机检同步：terrain_tile_sets_test 三态断言 19/19；art-bible v3.4（三态+目视验证面入流程）； 冒烟断言随新语义更新（雷当量 6/8/8 钉值/大奖励与 L3 上限允许模拟档购血叠加——v3.4 购物 改变 max_hp 序列语义，非功能回归） - 轻闸：冒烟 596/0+四探针 PASS；剂量-响应点（slip 半档 N=100）L1 36%/战役 1%——悬崖三点齐
Test Infrastructure — Dungeon Sweeper
Engine: Godot 4.7.2-stable（GDScript 单语言）
Test Framework: 双载体（ADR-0004）——--headless --script 逻辑冒烟 + headless 场景探针；gdUnit4 deferred（D2 OQ1 关闭形态，正式 CI 期再议）
CI: .github/workflows/tests.yml（首次 push 到 GitHub 后自动生效；仓库 2026-09-12 尚未初始化 git）
Setup date: 2026-09-12
参考实现: game/smoke/（冒烟 96/96 + 三 UI 探针——正式工程的活样板）
Directory Layout
tests/
unit/ # 隔离单元测试（公式/状态机/纯逻辑）——extends SceneTree + quit(code)
integration/ # 跨系统测试（Core-Core 集成、回放确定性、存档往返）
smoke/ # critical-paths.md——人工 gate 清单（/smoke-check 读取）
evidence/ # 截图与人工签核记录
run_all.gd # CI 冒烟统一入口（套件 manifest 协议，D2 AC-2b）
static_scan.sh # ADR-0004 静态扫描域 S1–S8 可执行子集
Running Tests
# 逻辑冒烟（双载体之一）——Windows 须用 console 版 exe 取 stdout
godot --headless --script tests/run_all.gd # 统一入口（CI 调用点）
godot --headless --script tests/unit/example_test.gd
# 场景探针（双载体之二）——以探针场景为运行目标，走完整项目引导（autoload 在位）
godot --headless --path . res://tests/probes/<probe>.tscn
# CI 旁必须配外部 wall-clock 超时（ADR-0004：引擎无死锁探测）
timeout 120s godot --headless --script tests/run_all.gd
单元/契约套件状态（单元测试与契约层批 2026-09-28）：
_suites()manifest 已登记实跑七套件——data_config（ConfigDB 加载/进度坐标 ceil 解析/fatal 退出码/统一随机流）、battle_settlement（DamageMath 纯函数/DamageController 伤害单据五配方）、contracts（系统间接口契约断言）；致命类独立进程expect=1。期望值一律由表读值推导（零玩法数值字面量）、随机只经 RngService 统一流。
协议要点（D2 冒烟协议 + ADR-0004）：
- 冒烟脚本
extends SceneTree以获得quit(code)；成功quit(0)、失败quit(1) --script模式不加载 autoload 且不注册全局标识符（裸引用ConfigDB= parse error）——ConfigDB/RngService 由脚本显式实例化，core 一律构造注入- 致命类用例独立进程，runner manifest 登记"调用 → 期望退出码"
- 每用例先
reset_diagnostics()（诊断收集器协议） - 期望值由表读值推导，不写死玩法数值
Test Naming
- Files:
[system]_[feature]_test.gd（领域命名，禁 ID 前缀——docs/code-conventions.md） - Functions:
test_[scenario]_[expected] - Example:
reward_roll_test.gd→test_power_interval_rolls_within_bounds()
Story Type → Test Evidence
| Story Type | Required Evidence | Location |
|---|---|---|
| Logic | Automated unit test — must pass | tests/unit/[system]/ |
| Integration | Integration test OR playtest doc | tests/integration/[system]/ |
| Visual/Feel | Screenshot + lead sign-off | tests/evidence/ |
| UI | Manual walkthrough OR interaction test（场景探针为首选） | tests/evidence/ |
| Config/Data | Smoke check pass | production/qa/smoke-*.md |
Static Scan（提交前双跑：本地 + CI）
tests/static_scan.sh 实现 ADR-0004 扫描域 S1–S8 的可执行子集；规则全集与动机见
docs/architecture/adr-0004-test-carrier-and-ci.md。新违规案例必须先补扫描规则再修码。
CI
Tests run automatically on every push to main and on every pull request.
A failed test suite blocks merging. gdUnit4 安装说明（deferred，届时启用）：
AssetLib → GdUnit4 → Install → Project Settings → Plugins 勾选 → 重启编辑器 → 确认 res://addons/gdunit4/。