 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
|
b605022001
|
feat(迭代27 T5): 波五a 类型闸拉起+存量收口——审计器 0 存量+warning 配置在位
P1-6 类型闸（须 T1-T4 全落后——本波按执行顺序锁殿后）:
- tools/audit_type_hints.py 新机器闸（V7）: R1 无类型容器注解/R2 有值返回缺返回类型/
R3 参数缺类型三规则+行级 # type-hint: ignore 显式白名单通道；产品码 core/data/presentation
- 存量收口: 368 处显式 Array/Dictionary 非参数化注解→机械参数化（Array[Variant]/
Dictionary[Variant, Variant] 零行为面）；13 处参数真类型（SaveManagerCore/ConfigDb/
BattleOrchestrator/MinesweeperRules/LevelRunner/SettingsStore 等）
- 白名单豁免四处: board_generator generate/_attempt/legality/_finalize 的 db 参——
测量面 _BoardRowStub 冒烟夹具鸭子型注入（typed 参拒 stub）
- project.godot 拉起 gdscript/warnings/untyped_declaration=1（V7 源码断言在 smoke _smoke_type_gate）
- static_scan 新 S9 类型闸规则；顺修历史 cd 错位（9-24 布局迁移后 /.. 落 game/ 致守卫
恒跳过静默空转——修复后 S1-S4/S9 首次实跑全绿）+S1/S2 增 ADR-0007-exempt 标记豁免通道
（main _seed_value 引擎熵源=文档化豁免面）
验收: 冒烟 1081/0（+V7×2）+run_all 27 套+static_scan 全绿+probe click+render golden+对拍三变体全同
|
2026-10-15 01:05:17 +08:00 |
|
|
DKChan
|
6fd7d782cc
|
refactor(迭代27 T3): 波三 账本收口——RunLedger 单类持四账+刷新双账删副本+gp_final 键删影子账——逐位一致对拍全同
P1-4 共享账本 Ledger 类化（裁点②甲 单类持四账）:
- game/core/run_ledger.gd: attune_charges/vision_counter/adventure_counters/bonus 四账
单类承载；战斗侧只拿 read/append 原语（attune_charge_has/set/consume、vision_count_add、
counters_seed_snapshot/merge_export、bonus_add_axis）——战末 export/开局 seed 时点语义不变
- AdventureRunner 持账（run_ledger）→ LevelRunner set_run_ledger+sync_attune_inventory
（原四散 setter 收口）→ enc 单键 ledger 下传；编排器三裸引用成员退役为 _ledger 原语调用
- 调试/单场缺省新账=零扰动面（vision_counter 缺省空=不计，原 enc 缺键守卫语义保留）
P1-2 刷新双账收口:
- main 刷新计数副本（run_scope.refresh_used_round）删除；单一事实源=编排器受理计数
- presentation_snapshot 成文面升键 refresh_used（can_refresh 邻位）——HUD 余量/遥测
round_refresh_index 单源读快照；V5 快照一致性断言×3（smoke+ui_click HUD 文本比对）
P1-3 GP 影子账收口:
- adventure_runner summary 增 gp_final 键（close_wallet 清账前快照）
- gp_shadow_ledger.gd 全件退役删除；main 委托缝/会话账本成员删除；终局面板 GP 行
取数=summary 键；ui_probe 影子账断言换代为 summary 键断言
验收: 逐位一致对拍三变体全同；冒烟 1079/0+run_all 26 套+probe click+render golden 0.00%
|
2026-10-14 23:25:45 +08:00 |
|
|
DKChan
|
7a0d57ddb0
|
feat(迭代27 T1): 波一 场景拆分+局生命周期物化——逐位一致对拍全同
P0-1 三屏场景化（契约2 只拆不重写）:
- menu_screen/camp_screen/adventure_screen 三 .tscn 屏壳+壳脚本（视图代码原样构建，
40+ views 零 .tscn 化）；adventure 屏壳内含 level_map/battle 两容器
- main.gd _build_ui 解体=三屏实例化+模态装配+接线；组合根句柄全部保留（探针挂载
假设 main.X 一级路径零迁移）；树序=屏壳在前全模态之下（视觉共存对逐对验算）
- 屏壳根 mouse_filter=IGNORE（ui_input 实证：全屏 STOP 壳吃下层模态鼠标输入）
P0-2 会话物化（裁点①甲 autoload+手工清单消亡）:
- run_scope.gd 节点持全部局态（adventure/runner/settlement/7+ 局态旗/账本）；
_begin_session 建会话、终局整节点 queue_free()——_reset_run_scope 三项+
_on_battle_end_continue 置空四件手工清单删除
- SaveManager/MetaProgression 升格 autoload 3/4 号位（类名加 Core 后缀沿 RngService
先例；--script 模式编译器不解析裸 autoload 标识符——组合根留读视图属性 get_node 形态）
- 探针隔离改 attach_path 原地重置（set_master_seed 先例）；10 探针+pacing 测试迁移
验收（V1 核心=逐位一致对拍）:
- parity_anchor 三变体 base/attune/shop×40 局 RUNSUM+JSONL 双面逐位全同（零行为漂移）
- 冒烟 1055→1077/0（+V2 屏壳独立实例化 11 断言+V3 两连局复位 11 断言）
- run_all 25 套+probe click 全绿+render_gate golden 0.00%×3
|
2026-10-14 20:28:53 +08:00 |
|