 DKChan
|
d3a616cf9e
|
docs(口径): roadmap 与 tests/README 的闸口径随分域改造同步
漏改即成第二份互相矛盾的清单（本批正是要消灭这种漂移）：
- roadmap.md 迭代循环骨架第 5 步「重闸＝全量档全绿」→ 按改动域选档；第 8 步收口五步③
「里程碑移动更新本文件」加注：实现批禁写 roadmap，该步归文档批，实现批在 reports/ 反哺点
列明该改哪一行。
- game/tests/README.md 门禁行与「本地闸」节的「（全量）唯一入口」→ 按域选档 + 回执含 domain
+ 合回闸按 diff 推域校验。
连带（仓库外本地配置，同批已改）：~/.zcode/skills/req-card/SKILL.md 六处——description 版本注、
§5 关联文档同步面（实现批禁写 design/、产出只落 reports/、07 入册转反哺点）、§6 末卡改「产出物
落位卡」、§7 闸口径改按域并禁卡内写死闸件名单、目检两分法落点、变异验证记录表落点。
|
2026-10-17 00:56:58 +08:00 |
|
|
DKChan
|
7daa92f61f
|
docs(迭代29 T7): 游离脚本台账 + golden 时效判定
台账：game/smoke/ 15 个不带 .tscn、不入任何闸的手动入口件逐个定性成表（用途 + 触发方式 +
结果由谁判），判据＝头注自陈用途 + 有无外部引用（工具脚本/产品码/CLAUDE.md 在册入口）。
存疑一律按在役登记并标注（禁「没看见＝死件」式清理）：adventure_monte_carlo／verifier_batch／
reward_expectation 三项是 CLAUDE.md 在册入口，auto_player／battle_driver／level_autoplay 是被
preload 的库件，board_stat_probe／calibrate_boards 是工具脚本取数端，damage_probe／defense_scan／
skill_rhythm_probe／rhythm_batch／monte_carlo 是诊断与批量采集件，dump_battle／experiment_density
标注为一次性历史取数件。纪律写进表下：新增手动件必须同批登记，退役走 doc-conventions 第 10 节。
golden 时效判定：**先判再动**——跑渲染闸实测棋盘三图 changed 0.00%／0.00%／0.00%、菜单 0.15%，
均远低于 2% 阈值 ⇒ 判有效，基线留在位不重制（禁「重制一下就绿了」掩盖真实视觉回归）。
新建 game/tests/golden/README.md 记载判据纪律与本次判定记录，供后续换代面按同一把尺复核。
|
2026-10-16 16:06:14 +08:00 |
|
|
DKChan
|
c4fa65ef44
|
feat(迭代29 T3): L2 集成层建承载——integration/ 首个用例 + parity 收编为条件闸件
建 game/tests/integration/（此前只有章程句无实体）：首个集成用例 save_rng_roundtrip_test.gd
＝存档 ⇄ RNG 快照往返，17 条断言，跨 SaveManager（落盘+版本迁移链）× AdventureRunner（断点消费）
× RngService（续跑零跳号）× 停点态确定性。与 unit/core/breakpoint_resume_test 的分工：那件是单测
只验首战开板一致，本件验跨系统闭环——含「旧版本档经迁移链后断点仍可续玩」这一真实玩家路径。
并入 run_all manifest（27 套，零新机制）。
变异验证：把断点 rng_counter 改坏 → 精确命中「续玩取数号位 = 断点号位」断言见红。
tools/run_all_gates.sh 新增 11 号「回放确定性对拍」**条件闸件**：每次跑批都对 merge-base 做一遍
触面判定（data/tables／rng_service／save_manager／meta_progression／settlement／damage_math／
damage_controller／battle_orchestrator／adventure_monte_carlo），未触面 SKIP；触面也**不自动跑**——
对拍调的是 MC 脚本，属「跑批发起前须用户批准」红线，闸只负责把触面判定做一遍并显式要求批准
（批准后 PARITY_APPROVED=1 重跑），杜绝「该跑却没人记得」。指纹逻辑把 SKIP/NEED-APPROVAL 同记 skip，
两种未跑状态互变不算闸况变化。baseline.json 登记 11 闸条目（新增闸件否则会判「无基线」而红）。
README：目录布局增 integration/；新增「测试三层与承载目录」节（L1/L2/L3 各自的判什么/承载/入闸方式
与分层判据）；integration 章程句由「将来落地」改为「已建承载」。
|
2026-10-16 15:20:25 +08:00 |
|
|
DKChan
|
853bd12baa
|
docs(迭代29 T2): 术语订正与 CI 残留清除（机械面）
README：CI 残留 6 处全清——头注 CI 行改「门禁=本地闸」+无远端无 CI 声明、目录布局「CI 冒烟统一入口」
→「单元套件统一入口」、Running「CI 调用点」→「本地闸 02 闸调用点」、「CI 旁必须配外部超时」
→「本地闸必须配」、Static Scan「提交前双跑：本地+CI」→「提交前本地跑」、「## CI」整节（含 gdUnit4
安装说明）→ 改写为「## 本地闸（唯一验收门禁）」。
run_all.gd 头注 CI 残留 2 处清除（外部超时改本地闸、探针由 probe_gate.sh 调用）。
CLAUDE.md 单件直跑清单里 run_smoke.py 标注为「系统级断言面」并指路术语表。
术语：新增 README「术语（本项目内的唯一语义）」小节——冒烟=秒级存活检查／单元套件／场景探针／
集成用例四词各归其位，并显式点破两处历史遗留命名（run_smoke.py 与 game/smoke/ 名带 smoke，
实际承载的是系统级断言面与场景探针，判定看语义不看文件名）。「逻辑冒烟」全库清零。
README 套件计数按开工日读数订正为 26（example_test 退出生产 manifest）。
|
2026-10-16 15:11:17 +08:00 |
|
|
DKChan
|
6c2dbc37c1
|
docs: ADR 体系废除 + architecture.md 确立为架构唯一事实源（2026-10-15 用户令：决策记录归 git commit log，不另存决策文档）
- 删除 design/dev/architecture/adr-0001~0007 共 7 份文件（内容留 git 历史可查）
- architecture.md：删「ADR 审计」「ADR 立项清单」两节；清除全文 ADR-000X 注记、QQ 表/S 表 ADR 引用；未决表关闭已落定项（QQ-01/02/03），立项清单在途事项转登记 QQ-11~14；补 A1 生成姿态事实、autoload 四件清单、board_generator 性能姿态；文档状态立「事实源地位」条
- CLAUDE.md：恢复 RNG 单点硬性红线（去 ADR-0007 引用）；新增「架构事实唯一源」红线；规范导航架构行标注唯一事实源
- doc-conventions：§5 增「架构事实唯一源」行；§11 活文档清单补架构文档
- registry：architecture.yaml 删 18 处 adr 字段、autoload_set 补 SaveManager/MetaProgression、board_rending 更新为 Node2D 已落地事实；entities.yaml 12 处引用清除
- game/ 代码注释约 60 处清 ADR-000X 引用（事实与日期保留）；豁免标记 ADR-0007-exempt → rng-seed-exempt（main.gd/static_scan.sh/architecture.md/06/iter27 五处同步）
- GDD/qa 实现报告/research 卡片/roadmap/tests README 引用全清；死链校验 1206 链接 0 死链、gdd_lint 0 不通过
- 代码中 adr/adr5 等为 adventure_runner 既有局部变量名（非 ADR 引用），未动
|
2026-10-15 23:52:30 +08:00 |
|
|
DKChan
|
62d2f76ffa
|
修复: 卡①T6——熵增闸图像白名单收编 game/tests/golden/（本卡 T2 落库 golden 基线三张系机检测试资产非美术素材，T1 落库时漏改白名单致熵增闸红——同批修订 commit 留痕=CLAUDE.md 结构审计闸既有规则；修后复跑 golden 三张出违例清单）+tests/README 运行时口径数订正（分支基点实测 840 项 0 失败——此前误写 846 系 master 合并卡②④后口径，T0 基线复读与本批批末实跑均为 840/0）。批末闸实证：run_smoke 840 项 0 失败三闸过 EXIT=0/run_all 17 套全绿 EXIT=0/doc_link_audit 绿/doc_term_audit 绿
|
2026-10-08 19:21:23 +08:00 |
|
|
DKChan
|
aa3c89566c
|
修复: 卡①T4账务——tests/README.md 漂移订正：套件数十五→18（第 18 套=卡④提灯载体批 unit/core/fog_lantern_wiring_test 注名——本分支基点早于卡④合并实测 17 套全绿，合并后 18）+断言数「752+」改双口径说明（运行时=run_smoke 打印通过项数〔卡①基线 846 项 0 失败〕/静态=smoke 源码 check( 调用点计数 764 处——循环内断言按执行次数计，两口径数值不同且各自浮动，禁互相换算或写死）+「十场景探针」陈旧计数句去数化。integration 空壳目录删除（Q8 代拍板白名单——仅有章程 README 无实体），章程句并入 tests/README（将来跨系统测试落地随批建目录迁入），Story Type 表 Integration 行同步改指
|
2026-10-08 19:21:09 +08:00 |
|
|
DKChan
|
8c272130fb
|
秘宝批T8：tests文档两处魔法道具→秘宝清零（game/README.md:538按§4.4禁改项保留作例外登记）；组C补修奇物.md:22/273换名断链；批末全量闸电池认证
|
2026-10-05 08:49:24 +08:00 |
|
|
DKChan
|
9446302e9f
|
文档对齐批：README/CI/配置说明与现行实现对齐（纯文档零代码零跑闸）——①game/README 运行节：数值调整板→调试浮窗（迭代14.5整合批48c0b34/d0a3c6b，main.gd debug_overlay实证）、冒烟55项→752项（fdd32fe批末闸读数）+60.55s实测引用、九探针→十探针补t17_defer_probe（smoke/ roster清点）、supply_scan退役注记（2026-09-15格面资源批已删）②game/tests/README+unit/README：628+→752+断言、九→十探针、七→十五套件（run_all.gd _suites清点）、production/qa→design/qa、docs/→design/dev/（7f24b640三层收敛失效路径修正）③.github/workflows/tests.yml：根tests/路径→game/tests/+--path game（7f24b640后CI路径失效修正）、git未初始化陈述换代④static_scan.sh头注docs/路径同修正⑤sim-data/README历史锚8份→23份（M-4迭代11a/11b/12/14各批锚入库后清点）⑥CLAUDE.md探针行调整板→调试浮窗。均系可从代码/提交记录直接确认项，历史批条目未动
|
2026-10-05 06:47:01 +08:00 |
|
|
DKChan
|
54ac8759c9
|
T7 死代码与残留清扫段: 16项零争议死代码直删（equivalence_supply/pool_layers/index_of/has_variant/rows_by_pool/SUB_REASONS/ui_kit死色板五常量/reset_requested/set_legend_enabled/is_level_mode/legend.toggle/set_idle×2/COL_PATH/COL_INK/rebuild死守卫/_normalize合并/FACADE并档——删前逐项全仓grep零调用核实，next_candidates有level_autoplay调用存活未删=审计误报纠正）+T17归因件撤除（choices_dbg三段+t17dump两段，T17_LOCK_DEBUG全仓归零）+延迟三件（has_unrevealed下沉/is_item_unlocked访问器/rap残链snapshot面）+文档十件（过期注释/错挂注释/4242文案/README现行化/critical-paths道具窗口退役改写）；闸=冲烟636/0+run_all 15套+八探针全绿
|
2026-10-02 09:25:23 +08:00 |
|
|
DKChan
|
5f51a916d4
|
test(unit): T1 单元测试与契约层——七套件实跑入口落 tests/run_all.gd
- data_config: ConfigDB 表加载+跨表护栏零诊断/进度坐标 ceil-clamp 解析与警告去重/变异池门控/shop·meta 消费面/manifest↔目录同步/越域 fatal 退出码(独立进程 expect=1,deferred 触发保 quit 通道)/统一随机流(派生确定性/计数器账本/标签不参与派生/负种子归一化)
- battle_settlement: DamageMath 四纯函数(池乘区/克制分量/掷点查档/吃掷点分量)+DamageController 伤害单据五配方+B/A 双结账模式+来源敌死作废+requires 前置门+主角倒下 halt+AC 合流三通道+池 clamp 与 refresh 政策
- contracts: 五配方/三目标/双政策词表封闭+掷点标签∈RNG 封闭词表(EC12)+单据九栏缺省+增益布尔受理口径(EC1/EC2)
- 红线: 期望值全由表读值推导(零玩法数值字面量)/零自建 RNG(夹具种子仅求复现)
- 轻闸: 冒烟 557/0 + ui_input_probe 十一断言全绿(基线零漂移)
|
2026-09-28 02:52:19 +08:00 |
|
|
DKChan
|
7f24b640ea
|
refactor: production 解散+docs 并入 design+tests 归 game 三层收敛——active.md/roadmap/stage/review-mode 升根目录;qa 报告→design/qa(gate-checks/alpha 验收/任务书→research);docs/→design/dev+registry 并档+散提案→research;tests/→game/tests(空架子 README+示例,真测试在 game/smoke);game/tools→tools+样例输出→sim-data;qa-data→sim-data;design/ux→gdd/ux;删 loop-dashboard.html(可再生成)+route_overlay_preview(零引用);钩子三件+loop_dashboard/balance_verifier/render_sample_sheet 路径随迁;断链修复 12 文件,余 7 条全为搬前幽灵链
|
2026-09-27 04:56:27 +08:00 |
|