game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,553 Commits 23 Branches 0 Tags
bbd49abfb012102cb288fa4031fee6ed83d78da2
Commit Graph
15 Commits
Author SHA1 Message Date
DKChan 6b1e447d27 feat(调试入口): 全局浮层角标——UI 最顶层、任何 UI 不遮挡（2026-10-16 用户令） 
用户定稿：调试入口不做置顶钮式按需出现，要的是「UI 最顶层浮层、不被任何 UI 遮挡」。
实现=三枚屏内角标（菜单右下/战斗 HUD 右下/地图顶栏）合并为一枚全局浮层角标：

- LAYER_CONTRACT 末位新增 {"key": "debug_badge", "kind": "float"}——只落树序（最顶绘制序）、
  不注册 ModalStack：open() 遮挡记账只隐藏登记层，故任何模态/覆盖层开都不遮它（用户需求
  的机制根因）；_layer_node 补映射；main 直接子层、构建走 ui_assembler.build_debug_badge
- 位置：右下角 16px 惯例位；地图屏底栏 85px 常驻→_sync_status_entry 按 map_on 抬 offset
  至底栏上方 16px；战斗屏状态角标经 MarginContainer 让位（right 16/bottom 52）不再被压
- 屏内角标全退役：menu_screen/board_zone_view/level_map_screen 三处 debug_badge 删除，
  main 两处接线与 _sync_status_entry 四条可见性/置灰行清除（浮层常显不置灰——点它就是开浮窗）
- 浮窗 desc 文案改「UI 最顶层「调试」浮层角标随时可开——任何界面不遮挡」
- 断言/探针换代：smoke V2f 查 main.debug_badge boot 可见；click_probe 遮挡判据移至设置面
  开中段（浮层角标此时仍应可见=直接验「不遮挡」）；tune_probe ①点击路径与⑨对局中角标
  全改 main.debug_badge（T2 防线断言不动——浮窗 non_locking×遮挡复活×has_open 组合回归）

冒烟 1127/0 过；全量闸待跑。
 2026-10-16 23:53:57 +08:00
DKChan bf65b49331 fix(调试入口): boot 菜单优先+开始屏右下角调试角标恢复——用户实测否决「启动即开」 
用户 F5 实测：浮窗 boot 自动开把开始屏盖成调试面板（640×约700 居中面板盖掉大半个屏），
且菜单层没有任何浮窗入口（iter18 迁宿主两屏的理由＝启动即开，已不成立）——关掉浮窗后
菜单上无法再开。用户令查三问（入口在哪/何时触发/触发后效果）后修正：

- main.gd：_ready 删 boot 自动开浮窗（_debug_entry 门控保留）；恢复菜单角标接线
  （pressed→_on_debug_badge_pressed）；可见性赋值挪到门控落定之后（原在 _build_ui
  读到初始 false——首跑冒烟抓出）
- ui_assembler：恢复右下角「调试」角标（git 历史 40fb4a5c^ 原实现：PRESET_BOTTOM_RIGHT
  16px 角距+FS_HINT+豁免宽度基准）+ 返回键补 dbgbtn（首跑漏了返回键致 menu_screen
  句柄 null、_build_ui 中断、V1c 层序红——冒烟抓出）
- scenes/menu_screen.gd：暴露 dbgbtn 句柄
- debug_overlay.gd：desc 文案改三处入口说明（开始屏右下角/战斗屏 HUD/地图屏角标）
- 探针/断言四处换代：smoke V2f 改「boot 不开浮窗+菜单角标可见」、V1a 收回严格判据；
  click_probe boot 检查反转+角标检查翻转为缺失才红+删浮窗恢复断言；tune_probe ① 改
  角标真实点击开窗路径；shot_probe 删浮窗归一段（已成死代码）
 2026-10-16 04:21:49 +08:00
DKChan d1b2e519ce feat(调试): DS_DEBUG 环境变量门控写死=true——用户令「直接写死，不读环境变量」（2026-10-16） 
- main.gd:219 原 OS.get_environment("DS_DEBUG")=="1" 读取退役，_debug_entry 恒 true
  （启动即开浮窗+两屏角标；var 注释与 6 处会话门控注释同步换代）
- 闸断言换代：smoke V2f 由「态==环境变量」改「恒开」断言；ui_click_probe 原
  「未设时浮窗不得默认开」反转为「未恒开即失守」；ui_tune_probe 删自设环境变量
  死代码（OS.set_environment 行）+三处消息/注释换代
- 其余 6 文件 10 处注释/文案清扫（ui_assembler/debug_overlay 含浮窗内用户可见
  工具提示/modal_stack/board_zone_view/level_map_screen/README）——全库 DS_DEBUG
  引用清零，无新旧并存
- 发布前删除事项：main.gd:219 一行（用户知悉；无 CI，两道恒开断言会红兜底）
 2026-10-16 03:08:31 +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 5f9d8e7b77 chore(代码卫生): 文件头零工作日志红线落文+全仓头注变更叙事清偿（2026-10-15 用户令） 
- CLAUDE.md 硬性红线新增「文件头零工作日志」；code-conventions.md 新增 §1.4.1（含反面案例）
- 全仓 .gd 文件头注清偿：删除全部带日期条目、批次叙事段与迁移退役叙述，保留并改写为
  现在时的职责、接口契约、GDD 锚内容（main.gd 头注 42→31 行、save_manager.gd 49→45 行）
- 纯注释改动零行为变更，按用户令免测试免冒烟
 2026-10-15 04:08:38 +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
DKChan 260c9bbd9e feat(迭代26 T5b): 诊断转储钮退出玩家画面——入口迁调试浮窗（grilling Q8 裁甲） 
- main.gd 卸载点删除（build_diag_button 挂载+连接）；build_diag_button 工厂退役（ui_assembler）；
  连接随迁=debug_overlay.diagnose_requested→_on_diagnose_pressed（dump_diagnosis 卡死取证保留，
  删除案否/门控隐藏案否——浮窗本就可全局可开，双轨无意义）
- debug_overlay 新增 diagnose_requested 信号+区块⑤转储钮（_emit_diagnose_requested 外发，纯视图边界）
- 探针同批入册：ui_tune_probe 只读巡检白名单+_emit_diagnose_requested、连接数 10→11（七钮），
  confirm_dialog/main 树序注释订正（诊断钮引用清除）
- 冒烟新增 _smoke_diag_button_retired() 7 断言（V6：主区零残留+工厂退役+连接随迁+浮窗可达）；
  冒烟 1048→1055/0；probe --click/--full 全绿残留 0
 2026-10-14 05:57:16 +08:00
DKChan c5a09fd90c refactor(改名批): 暂停层/暂停角标→状态面板/状态角标——用户令全量改名(文案4处+标识符全套PauseOverlay→StatusPanel/pause_overlay.gd→status_panel.gd/成员方法族+探针快照键+注释与探针消息86处清零;行为契约四件零动——只读R4/模态遮罩P2甲/输入锁R3/零动效P4甲)+render_gate截图键shot_pause→shot_status同步+文档六面(元进度v1.19/07/生涯/06条/architecture json+html;camp零命中;08-Alpha版本标准untracked禁碰留置)——冒烟938/0+run_all24套+probe --click/--full+render_gate全绿;rg 暂停|pause game/归零 2026-10-13 05:41:59 +08:00
DKChan c36daa6cae ⑦T4: ui_tune_probe 断言面换代全绿——①段改向启动即开（OS.set_environment DS_DEBUG=1 探针自设+P3甲默认开断言+树序新基准=确认弹窗后登记册末位）/⑧段显式种子42钉死+开冒险显式关浮窗断言+master_seed==42 真实路径显式优先断言/⑨段新增对局中可开（战斗屏角标真实信号路径+S1+停机点回归：棋盘输入不锁+暂停角标不置灰）+对局中两钮禁用断言+当局数据六项值对（种子/关卡/节点/HP/GP/钥石逐项对只读访问器）+⑨b 只读巡检（17卡③白名单外零连接形制，信号清单12名+视图七方法+引擎滚动条豁免，连接数=10）+零动效契约/⑩段种子三分单点断言（显式777优先/首局空档恒42/非首局连抽4次不全等42）；随批修复：_seed_value 三分分支写反（原实现首局随机/非首局42与P5甲相反——⑩断言抓获，探针钉死显式值故轻闸未暴露）+当局数据钥石取数改向 adventure.keystone（LevelRunner 无 keystone 域——原 r.keystone 脚本错误致探针 _ready 中断挂死表象，两次按纪律杀本 worktree 匹配进程重试后定位）+debug_overlay 胜利演出切换 lambda 转命名方法 _on_fx_toggle（只读巡检白名单方法名精确可判）；专闸 ui_tune_probe exit=0 全链路 PASS 2026-10-07 07:33:49 +08:00
DKChan 46dadbb45d 迭代14.5调试整合批·补遗：上次提交漏暂存的11个修改件收编——main.gd接线（角标入口/浮窗构建挂树序末/模态登记/处理器更名_show_debug_overlay/_close_debug_overlay+对局随开随收/门禁护栏）+ui_assembler（build_overlays撤TunePanel改签名+开始覆盖层三散件撤除+角落角标）+探针ui_tune_probe全量改接与ui_click_probe两处+核心/呈现/冒烟注释口径TunePanel→调试浮窗（零行为）；与48c0b34同批同验证（冒烟747/0+三探针绿） 2026-10-05 00:51:15 +08:00
DKChan 315e46038c T6 探针基建收口段: 三族样板收单点（probe_ui_util树寻址contains/begins_with参数化+isolate_save七份隔离样板/battle_driver五份战斗驱动）+level_autoplay双战斗循环合并_decide_act+test_kit收13套件_check样板（断言数逐套件零丢失对照表在报告）+BAD_DIR夹具共享+smoke_all五件（:953公有面clamped_pool/_battle_st七袋/check_silent并入quiet参/_pct转发删/load改preload）；探针小件=main句柄Node类型注/魔法等待常量化/画布常数同源锚注/死参verbose删；红线守住=ui_input case④b与click循环体零触碰/拍板点三件未退役 2026-10-02 08:46:43 +08:00
DKChan 3f46edbfa3 iter8-T5 卡⑥ 战斗胜利总结结算接线：_on_choices_presented 战斗节点停点判据（battle 型+current_battle 已收场+非空候选三条件天然分流入口/兑付/商店停点）挂 BattleEndOverlay 胜利形态（金蜡封+GP 增量〔wallet_changed gain 载荷取数〕+总量 runner.gp+判定行+下一节点+明细回看既有按钮）——_on_battle_end_continue 挂起分派（_settlement_stop_pending→暂存候选回放进选路页，choices_presented 链保持在后）；Boss 胜/失败走 level_finished 另路零变化——探针：结算框已拍板面断言（GP 行=钱包实态逐字/判定行/下一节点进选路）入 ui_click_probe 主循环；四探针段首清场补丁（残留断点触发互斥确认早退=本轮 input 挂死根因之二）——闸：冒烟 593/0+三探针全绿（click 问题=0） 2026-09-29 19:48:40 +08:00
DKChan d599743433 iter8-T2/T3/T4 卡②③④：继续上局按钮（有断点亮起+文本带关卡序号+真实信号路径续玩）+新冒险互斥二次确认（首击换面3s回落二击提交+提交即弃旧断点）+T3 三结局清断点（_settle 统一收口）+最小设置面（SettingsStore 独立存储 user://settings.cfg 三节+SettingsOverlay 音量 master bus 实时/全屏/减动效转正/退出游戏+DS_DEBUG 调试门控+调整板旧开关退役）——探针隔离补全（click/input/layout/ui_probe/ui_tune 五探针 main.save_manager 隔离+首次布尔置位，真实档探针污染事故两起已清〔教训：断点写盘面随 save_manager 引用走，probe 换 meta 不换 save_manager 即漏〕）——闸：冒烟 593/0+五探针全绿+click 断点段问题=0——代拍板：互斥确认文案/设置面排布/确认窗口 3s（追认清单呈报）+设置与本地化 v0.2 随批 2026-09-29 19:25:19 +08:00
DKChan ae2ca4ffd4 feat(ux): T2 独立屏落地——RouteOverlay 升格 LevelMapScreen+组合根屏级互斥 
类/文件改名 route_overlay.gd→level_map_screen.gd（RouteOverlay 退役，uid 随迁）；屏底=暗幕 0.6 半透→不透明 BG_ROOT+石纹底噪（TEX_BACKDROP_STONE load_tex 守卫缺位纯色回退，spec Layout 形态升格）；open_choices 进入转场 alpha 淡入 200ms（UiKit.motion；就地刷新/模态栈恢复不重放）。
组合根：_battle_root 宿主引用留存+_level_screen_active 状态+_enter/_exit_level_screen 单一出口（进屏隐战斗屏/出屏显战斗屏）；_on_choices_presented 走进屏；_on_route_chosen 出屏分支；_on_adventure_finished 强制回战斗屏呈现摘要（放弃入口终局兜底）。_input_locked/模态登记序（节点层与商店层之间）不变——兑付覆盖层域内弹出的遮挡恢复语义由模态栈零改动复用。
探针机械改名 main.route_overlay→main.level_screen（ui_probe 5/ui_click_probe 4/ui_input 5/ui_tune 2 处）。坑⑤再证：新 class_name 后未刷编辑器缓存致四探针 Parse Error 超时——--editor --quit 后全绿。轻闸=冒烟 557/0+五探针 PASS。
 2026-09-28 06:40:16 +08:00
DKChan 13f93c74ff chore(structure): 垂直切片转正——prototypes/dungeon-sweeper-vertical-slice 迁为 game/，26 文件路径同步（CLAUDE.md/tools×4/tests×3/QA脚本×3/GDD×6/架构文档），static_scan S1/S2+S4 规则集首跑收敛（用户拍板 2026-09-24，台账 148） 2026-09-24 04:02:21 +08:00