From aa3c89566c8b5b7a7b5930e6ca7b21dcf2e0869f Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Thu, 8 Oct 2026 17:43:18 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E5=A4=8D:=20=E5=8D=A1=E2=91=A0T4?= =?UTF-8?q?=E8=B4=A6=E5=8A=A1=E2=80=94=E2=80=94tests/README.md=20=E6=BC=82?= =?UTF-8?q?=E7=A7=BB=E8=AE=A2=E6=AD=A3=EF=BC=9A=E5=A5=97=E4=BB=B6=E6=95=B0?= =?UTF-8?q?=E5=8D=81=E4=BA=94=E2=86=9218=EF=BC=88=E7=AC=AC=2018=20?= =?UTF-8?q?=E5=A5=97=3D=E5=8D=A1=E2=91=A3=E6=8F=90=E7=81=AF=E8=BD=BD?= =?UTF-8?q?=E4=BD=93=E6=89=B9=20unit/core/fog=5Flantern=5Fwiring=5Ftest=20?= =?UTF-8?q?=E6=B3=A8=E5=90=8D=E2=80=94=E2=80=94=E6=9C=AC=E5=88=86=E6=94=AF?= =?UTF-8?q?=E5=9F=BA=E7=82=B9=E6=97=A9=E4=BA=8E=E5=8D=A1=E2=91=A3=E5=90=88?= =?UTF-8?q?=E5=B9=B6=E5=AE=9E=E6=B5=8B=2017=20=E5=A5=97=E5=85=A8=E7=BB=BF?= =?UTF-8?q?=EF=BC=8C=E5=90=88=E5=B9=B6=E5=90=8E=2018=EF=BC=89+=E6=96=AD?= =?UTF-8?q?=E8=A8=80=E6=95=B0=E3=80=8C752+=E3=80=8D=E6=94=B9=E5=8F=8C?= =?UTF-8?q?=E5=8F=A3=E5=BE=84=E8=AF=B4=E6=98=8E=EF=BC=88=E8=BF=90=E8=A1=8C?= =?UTF-8?q?=E6=97=B6=3Drun=5Fsmoke=20=E6=89=93=E5=8D=B0=E9=80=9A=E8=BF=87?= =?UTF-8?q?=E9=A1=B9=E6=95=B0=E3=80=94=E5=8D=A1=E2=91=A0=E5=9F=BA=E7=BA=BF?= =?UTF-8?q?=20846=20=E9=A1=B9=200=20=E5=A4=B1=E8=B4=A5=E3=80=95/=E9=9D=99?= =?UTF-8?q?=E6=80=81=3Dsmoke=20=E6=BA=90=E7=A0=81=20check(=20=E8=B0=83?= =?UTF-8?q?=E7=94=A8=E7=82=B9=E8=AE=A1=E6=95=B0=20764=20=E5=A4=84=E2=80=94?= =?UTF-8?q?=E2=80=94=E5=BE=AA=E7=8E=AF=E5=86=85=E6=96=AD=E8=A8=80=E6=8C=89?= =?UTF-8?q?=E6=89=A7=E8=A1=8C=E6=AC=A1=E6=95=B0=E8=AE=A1=EF=BC=8C=E4=B8=A4?= =?UTF-8?q?=E5=8F=A3=E5=BE=84=E6=95=B0=E5=80=BC=E4=B8=8D=E5=90=8C=E4=B8=94?= =?UTF-8?q?=E5=90=84=E8=87=AA=E6=B5=AE=E5=8A=A8=EF=BC=8C=E7=A6=81=E4=BA=92?= =?UTF-8?q?=E7=9B=B8=E6=8D=A2=E7=AE=97=E6=88=96=E5=86=99=E6=AD=BB=EF=BC=89?= =?UTF-8?q?+=E3=80=8C=E5=8D=81=E5=9C=BA=E6=99=AF=E6=8E=A2=E9=92=88?= =?UTF-8?q?=E3=80=8D=E9=99=88=E6=97=A7=E8=AE=A1=E6=95=B0=E5=8F=A5=E5=8E=BB?= =?UTF-8?q?=E6=95=B0=E5=8C=96=E3=80=82integration=20=E7=A9=BA=E5=A3=B3?= =?UTF-8?q?=E7=9B=AE=E5=BD=95=E5=88=A0=E9=99=A4=EF=BC=88Q8=20=E4=BB=A3?= =?UTF-8?q?=E6=8B=8D=E6=9D=BF=E7=99=BD=E5=90=8D=E5=8D=95=E2=80=94=E2=80=94?= =?UTF-8?q?=E4=BB=85=E6=9C=89=E7=AB=A0=E7=A8=8B=20README=20=E6=97=A0?= =?UTF-8?q?=E5=AE=9E=E4=BD=93=EF=BC=89=EF=BC=8C=E7=AB=A0=E7=A8=8B=E5=8F=A5?= =?UTF-8?q?=E5=B9=B6=E5=85=A5=20tests/README=EF=BC=88=E5=B0=86=E6=9D=A5?= =?UTF-8?q?=E8=B7=A8=E7=B3=BB=E7=BB=9F=E6=B5=8B=E8=AF=95=E8=90=BD=E5=9C=B0?= =?UTF-8?q?=E9=9A=8F=E6=89=B9=E5=BB=BA=E7=9B=AE=E5=BD=95=E8=BF=81=E5=85=A5?= =?UTF-8?q?=EF=BC=89=EF=BC=8CStory=20Type=20=E8=A1=A8=20Integration=20?= =?UTF-8?q?=E8=A1=8C=E5=90=8C=E6=AD=A5=E6=94=B9=E6=8C=87?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- game/tests/README.md | 16 ++++++++++++---- game/tests/integration/README.md | 5 ----- 2 files changed, 12 insertions(+), 9 deletions(-) delete mode 100644 game/tests/integration/README.md diff --git a/game/tests/README.md b/game/tests/README.md index ed9a53b2..557e8ca4 100644 --- a/game/tests/README.md +++ b/game/tests/README.md @@ -4,20 +4,28 @@ **Test Framework**: 双载体（ADR-0004）——`--headless --script` 逻辑冒烟 + headless 场景探针；gdUnit4 **deferred**（D2 OQ1 关闭形态，正式 CI 期再议） **CI**: `.github/workflows/tests.yml`（首次 push 到 GitHub 后自动生效；仓库已初始化 git、尚未配置远端） **Setup date**: 2026-09-12（2026-09-27 `7f24b640` 三层收敛：根 tests/ 并入 `game/tests/`、docs 并入 `design/dev/`、production 解散） -**参考实现**: `game/smoke/`（冒烟 752+ 断言 + 十场景探针——正式工程的活样板） +**参考实现**: `game/smoke/`（冒烟断言 + 场景探针族——正式工程的活样板；断言计数双口径见下节） ## 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 可执行子集 ``` +> integration/ 目录已删空壳（迭代 19 卡① T4/Q8 2026-10-08——彼时仅有章程 README 无实体）。章程句保留在此：将来跨系统测试（Core-Core 集成、回放确定性〔同种子步骤流逐行相同——B1 AC-33 形态〕、存档/RNG 快照往返、A1×A2 双包含端到端）落地时随批建 `tests/integration/` 迁入；各 GDD 登记的 deferral 集成用例以对侧登记为生效条件。 + +## 断言计数双口径（2026-10-08 迭代 19 卡① T4 订正） + +历史 README 写死「752+ 断言/十五套件」必然漂移，改为两种口径并注明语义： + +- **运行时口径**：`python tools/run_smoke.py` 打印的通过项数（迭代 19 卡①基线 **846 项 0 失败**，2026-10-08 本分支实测）——循环内断言按执行次数计，随断言增删与循环次数浮动，以当次跑测打印为准。 +- **静态口径**：`game/smoke/` 源码 `check(` 调用点计数（2026-10-08 本分支实测 **764 处**）——按源码位置计，一处在循环内即多次执行，故两口径数值不同且各自浮动，禁互相换算或写死。 + ## Running Tests ```bash @@ -32,7 +40,7 @@ godot --headless --path . res://smoke/.tscn timeout 120s godot --headless --script tests/run_all.gd ``` -> 单元/契约套件状态（单元测试与契约层批 2026-09-28 立基，后随迭代 7/8 增补）：`_suites()` manifest 已登记实跑十五套件——data_config（ConfigDB 加载/进度坐标 ceil 解析/fatal 退出码/统一随机流）、core（秘宝结构冻结/断点续玩）、battle_settlement（DamageMath 纯函数/DamageController 伤害单据五配方）、contracts（系统间接口契约断言）、presentation（节奏队列/奖励浮层/字体资产/地形瓦片集）；致命类独立进程 `expect=1`。期望值一律由表读值推导（零玩法数值字面量）、随机只经 RngService 统一流。 +> 单元/契约套件状态（单元测试与契约层批 2026-09-28 立基，后随迭代 7/8 增补）：`_suites()` manifest 已登记实跑 **18 套件**（第 18 套 = 迭代 19 卡④提灯载体批新增 `unit/core/fog_lantern_wiring_test` 提灯装配链〔行加载/schema/只读出口双态/enc 注入面〕——本分支基点早于卡④合并时实测 17 套全绿，合并后 18）——data_config（ConfigDB 加载/进度坐标 ceil 解析/fatal 退出码/统一随机流）、core（秘宝结构冻结/断点续玩/提灯装配链）、battle_settlement（DamageMath 纯函数/DamageController 伤害单据五配方）、contracts（系统间接口契约断言）、presentation（节奏队列/奖励浮层/字体资产/地形瓦片集）；致命类独立进程 `expect=1`。期望值一律由表读值推导（零玩法数值字面量）、随机只经 RngService 统一流。 **协议要点**（D2 冒烟协议 + ADR-0004）： - 冒烟脚本 `extends SceneTree` 以获得 `quit(code)`；成功 `quit(0)`、失败 `quit(1)` @@ -52,7 +60,7 @@ timeout 120s godot --headless --script tests/run_all.gd | Story Type | Required Evidence | Location | |---|---|---| | Logic | Automated unit test — must pass | `tests/unit/[system]/` | -| Integration | Integration test OR playtest doc | `tests/integration/[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 | `design/qa/` | diff --git a/game/tests/integration/README.md b/game/tests/integration/README.md deleted file mode 100644 index 376628c6..00000000 --- a/game/tests/integration/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# tests/integration/ — 跨系统测试 - -承载：Core-Core 集成（真 A3 + 真 B2/B3/B4 容器实例）、回放确定性（同种子步骤流逐行相同——B1 AC-33 形态）、存档/RNG 快照往返（D3 落地后）、A1×A2 双包含端到端。 - -各 GDD 登记的 deferral 集成用例（以对侧登记为生效条件）随对应系统实现迁入本目录。