game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,814 Commits 23 Branches 0 Tags
5ed1ec99af53fe0c759d5adefda9f120cfc827dd
Commit Graph
21 Commits
Author SHA1 Message Date
DKChan 331a0ba688 docs(描述性文档): 批 A 术语与读数换代——tests/README 术语表改标准四级（冒烟/单元/集成/系统+UI 探针与 golden）并删「别被字面骗了」警告节（名字对了警告就死），滞后读数订正（35 套件→manifest 40 条实数口径、挥发计数改口径描述、游离台账去硬计数并收 probe_ui_util 入表）；architecture.md 测试域节换 run_smoke/run_system_test/run_all 三行模块登记+实证行去滞后读数+三层承载表改四级+改动域与三硬闸表同步；体验验证清单/待办清单/probe_gate.sh/golden_compare.py「轻闸/重闸」词面清扫（探针闸默认段/全量域闸口径）；5 个单测头注释「单元套件」换「单元测试」（仅注释，闸 02 载体零改动） 2026-10-22 21:16:24 +08:00
DKChan c162fca9ad chore(引用可核闸建档注册): 追加行删除后的文档关联面清净 
- game/tests/README.md：静态扫描段 S1–S11 → S1–S12（S12 旧件零残留闸缺登记，补一段实现说明）；
  S11 说明句删去「显式追加『完美封印』」——该追加行已删，且原句连词名都写错（被禁的是「完美排雷」）；
  改后写明禁词全由术语表第一列解析供给、脚本内不内联词面；
  「规则全集见 architecture.md」指针句加限定：S1–S10 在架构文档，S11／S12 自持于本文件与脚本头注（迭代 32 两卡为代码批禁写 design/）
- 待办清单：「game/ 域文档两处措辞订正欠账」整条删除（未净项已由用户合入完成）；
  「效果引擎系统无状态原则缺架构文档条目」现状里指向已删条目「计数器寿命域未统一」的悬挂指路句改写成凭据句
 2026-10-21 17:05:22 +08:00
DKChan e425ef1be0 chore(引用可核闸建档注册): 08d 入文档域闸序＋三处 game/ 纯文字欠账清净 
- tools/run_all_gates.sh：文档域闸序加「08d 引用可核」并补头注 --docs 清单（闸清单唯一事实源只写这一处）
- game/tests/.gates/baseline.json：手工加 08d 绿记录一条（13→14，其余条目原样保留），照 8f66ae15 之 08c 与 e8b6751b 之 06b 先例
- game/tests/static_scan.sh:100：S11 词表来源注释订正——「完美排雷」已于 2026-10-21 入退役词对照表，:122 追加行成冗余（sort -u 去重后行为不变，删它属改闸件词表本体，留待代码批，注释已写明）
- game/tests/README.md：:58 套件数 26→35（按 _suites() manifest 实数）；:81 Config/Data 证据落点 design/qa/ → 跑批回执＋reports/；:92 verifier_batch 报告落点 design/qa/ → sim-data/（依 AGENTS 在册口径）
- doc_ref_audit.py：路径解析补「尾段匹配」一档，tests/run_all.gd／views/level_map_screen.gd 这类相对 game/ 工程的简写不再误判为路径不存在（实测纳入 reports/ 的红项 17→12，余下为历史件真实漂移，佐证排除面划法）
- 待办清单：引用可核注册欠账与 README 分级表 design/qa 两条完成即整条删除；game/ 域欠账条目收窄为 :122 冗余行一项，状态处记用户特批标记
零行为改动：无一行 GDScript、无表数值、无场景资源。验证：bash -n 两闸件语法 OK／baseline 合法 JSON／闸壳 --docs 自身退出码 0（含新注册 08d 与建档记录一致）／引用可核 64 件 84 处红项 0／流水线闸 PASS 69 条目。
 2026-10-21 15:53:52 +08:00
DKChan b6629d6848 feat(T2-T6): 五词注释换代——完美排雷→完美封印/板级→整图/门票→专长凭证/正主→现行事实源/落籍→已入库 
全局 sed 替换 89 处命中清零（S11 绿）。修复：
- 移交 3 处保留原词（shop.tres:86 display_name、curio_controller:165-166 玩家文案）
- 豁免 enemy.tres:653 历史注记保持"已落籍"
- static_scan.sh 词表追加行与头注恢复禁「」引举句式
- S11 规则文件自身不被自身规则误伤（闸门自指豁免生效）
 2026-10-20 20:41:50 +08:00
DKChan 85dce2c77d feat(T1): S11 代码注释禁用词规则落闸——先落规则再见红（89 处） 
按契约 6 先写 S11 规则并跑出红，为 T2–T6 批量换代提供回归网。
词表从术语表「退役词对照」节解析＋显式追加完美排雷、排除巢穴/旗。
三层豁免（闸门自指/显式留档 4 处/非注释面天然不取）＋两道自检。
 2026-10-20 20:35:14 +08:00
DKChan 8847d960b5 docs(game/tests注释重基准): 三件套注释路径随 dev→engineering 改名同步（用户特别授权主区直改，纯注释零行为变更） 2026-10-20 05:43:39 +08:00
DKChan e8a2934208 docs(qa目录退役·B1): game/tests/README 一行不改，欠账登记进 06——本批收回纯文档域 
- 用户裁 B1：撤回对 game/tests/README.md:81 的指针修正（相对 master 的 game/ 路径改动清零），避免零代码改动的批被合回闸按路径前缀推成代码域、强制全量测试
- 06 新增一条欠账登记（### 文档与结构 段顶）：分级表 Config/Data 行仍指已退役的 design/qa/，正解 sim-data/，等下一批真改 game/ 时一并纠正；写明「死链闸扫不到」（doc_link_audit 只扫 design/gdd/）与「推域规则触发条件」两条成因，来源=批次移交，状态=待写卡（备选）
- 五道文档域闸全绿：gdd_lint／doc_link --strict（1205 处链接 死链 0）／doc_term --strict（疑似现行 0）／pipeline_gate（06 条目 64、卡片口径 21 张全过）／repo_structure_audit PASS
 2026-10-20 03:46:04 +08:00
DKChan 75fafc3965 docs(qa目录退役): design/qa/ 清空删除，四路分流＋§11 立接收方条款 
- 40 张取证照与同名对比报告 → game/tests/evidence/ui-audit-2026-10-06/（该目录既有章程「人工测试证据」，目录根新增 .gdignore 令 Godot 整目录跳过导入，图不生成 .import 边车也不进导出包；parity/anchor.json 走文件系统路径读取不受影响）
- 有接收方的两份审计（代码术语审计→06:546＋迭代31 卡①／测试审计→测试分层卡片）平移 design/research/；iter27-探针迁移对照（T1 未施工＝活交付物）迁 reports/，reports/README 放什么表补一行交付物类型
- 已核销的迭代18-实机目检总清单（2026-10-14 十八项全过）删除，顺带清掉其内 4 条指向 8e02dcf0 已删件的回指
- doc-conventions §11：暂存地唯一归 design/research/，验证凭据不归文档目录；新增「落档必写接收方」一行——写不出接收方的不落文件，内容在会话里交付
- tools/balance_verifier.py 报告与原始数据改落 sim-data/（QA_DIR→READINGS_DIR）
- 活指针 13 处改判：AGENTS.md:22/30 与 Project Layout game 行、06:546、07:103、career 卡片×4、art-bible §8.2 L490 与 生涯.md:81 两处 8e02dcf0 遗留死指涉、game/tests/README 分级表与台账行、reports/README
- 结构闸白名单三处同批收口：IMAGE_PREFIXES 去 design/qa/ 加 game/tests/evidence/、DESIGN_SUBDIRS 去 qa、RETIRED 加 design/qa（目录复活即 FAIL）
- .qoder 技能 doc-consistency-check 两处指路改判（harness 配置不入 git，主区直接改）

单件试跑全绿：gdd_lint 10/10、doc_link --strict 死链 0、doc_term --strict 疑似现行 0、pipeline_gate 63 条目/21 卡、repo_structure_audit PASS。
本批 diff 触及 game/ 路径，合回需全量档回执（含代码域测试），待用户点名。
 2026-10-20 02:07:39 +08:00
DKChan 1deaa55341 chore(rules): 根规则文件改名 CLAUDE.md→AGENTS.md＋全库旧名引用同步 
- 结构闸白名单 ROOT_FILES 收编 AGENTS.md（改名后主区曾判「根文件越界」红）
- 流水线闸禁写根规则文件标志名只留 AGENTS.md（用户裁：旧名不留双保险）
- design/dev 五份规约＋architecture、roadmap、registry、06、三个 README、
  在役需求卡与 QA 标准的引用逐处换代；历史 reports/ 与 .workbuddy 留痕不动
- 顺修三处换名后会误导的行号引用（:56→:59、:63→:68、71 行计数加注）
- 三份主区未跟踪文档（测试审计标准／启动装配卡／营地会话提示）随批搬入并登记
 2026-10-19 06:04:09 +08:00
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