game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
2,209 Commits 23 Branches 0 Tags
a92ef2e3f4a98e3a806387e3afad45fe13ce8f3d
Commit Graph
20 Commits
Author SHA1 Message Date
DKChan 477a73e763 iter(36卡③): 状态面板瘦身——八键投影换代＋本局信息面板三段新装两段退役＋两角标tooltip换代＋断言面换代（theme投影族九断言手拼夹具＋探针真实入口三断言对拍独立oracle）；变异验证按用户P0禁令零执行（正向验收测试照跑） 2026-10-24 08:35:39 +08:00
DKChan 6d601d23dc chore(禁写变更记录批): 版本历史节/日期批注全面废除——gdd_lint R4 反转禁设＋三工具去豁免＋48 文档删节＋game/README 流水段删＋代码注释 900 余行轨迹标签清偿（约束句保留）＋规约/skills 五层指令面同批改指 git 沿革 2026-10-20 00:22:18 +08:00
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 9a72394652 chore(代码卫生): 头注存量清偿批——82 文件按两类白名单改写为 ## 文档注释载体 
按 code-conventions §1.4.1 第三轮定稿执行：core 22+schemas 18+presentation 根 14+views 28，全部头注 #→##、删日期/变更叙事/GDD 与架构反向链接/字段与域清单/机制描述，保留职责摘要+真实使用约束（防事故禁令/单一入口/信号契约每信号一行）。main.gd 31→5 行、save_manager 45→5 行、adventure_runner 37→5 行为最大单件。子代理分模块执行（波一 core+schemas、波二 presentation+views，并发≤2）。验收=tools/verify_comment_only_change.py 逐字节校验（82 文件头注区外逐行一致=零行为变更）+audit_file_headers 全绿；纯注释批免冒烟（先例 5843270）
 2026-10-16 23:28:07 +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 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 f22b2036a0 迭代22裁决落文批: A单十五条裁决收口+B单七条反哺全落文+⑤改自动兑付代码批——追认单(①②③⑥⑦⑧⑨⑩⑪⑫⑬⑭⑮追认/④追认+积点账裁战斗级/⑤推翻改自动兑付)收口; ⑤代码=满charge_n=8自动当轮grant_ap无玩家入口(_on_cell_revealed揭示缓冲点兑付=cell_revealed批先于本格扣费故AP归零恰逢满点先兑再扣轮不结束/授予段积点段迁除/use_attune_convert受理口消解/attune_convert_state改造进度读数口+item_id键/use_treasure的ap_charge_safe死分支与_usable_now死条件删/tres试炼镐desc换代+counter_spend受理闸删)——HUD兑换钮整链退役(ap_bar convert信号+钮/board_zone转发/main接线与_sync_convert_button/_on_convert_pressed)+C区秘宝槽悬停浮窗进度(controller投影note字段/hero_info_panel tooltip拼接/main _refresh_presentations加refresh_slots重查); 单测④段重写自动兑付断言(7格零兑付/第8格AP+1/读数口/未装配反例); B落文=秘宝.md v3.0(目录三表实态三列+试炼镐自动兑付换代+代价轴转化获取行含战斗级重置与兑付时序+解锁条件实录钥石10/25四条件件三计数键+实装批落地前句全换代+退役指针补代码旧行已删)/元进度.md v1.17/camp.md v1.3(柜台呈现细则节+暂停层12行)/存档序列化.md v1.6(vision_used域+断点随件+bonus_aux_carry退役+v6扩列不升版)/行动经济.md v0.12(finish_round_stop转存率参数化)+术语表v1.2(自动兑付/真视使用计数两词条)+07㉑观测点随⑤换代; 报告修正=⑮提交号勘正(master实际T5=73db171,原记7095505系amend前被弃旧提交——merge-base实证)+十五条裁决标注+反哺七条已落文标注; 06收口=状态行换代+裁决小节。冒烟898/0+单测22套+probe_gate --click --full全绿(worktree拷.godot/字体与图标边车/art素材后) 2026-10-12 23:23:01 +08:00
DKChan b7a2eadd2c T4(迭代22秘宝批): 呈现换代——秘宝匣柜台购买钮(buy_requested信号链→presenter buy_treasure_unlock分支,禁用态=余额不足)+分档呈现(名后缀·档位/装配行档位标签/悬停desc)+装配段未解锁禁装; 呈现桥换代(旧提灯布尔桥set_fog_lantern/FOG_LANTERN_BONUS随行退役→set_fog_glow_bonus参数面,main._sync_treasure_glow消费attune_param_sum,off态写0复原契约保持); 巢穴预告toast(nest_preview_count读数口消费); 试炼镐HUD入口(ap_bar兑换钮+convert_pressed转发链+attune_convert_state读数口,未装配隐藏); ui_input_probe case⑮换代主语wide_scout_band+4; V13功能残留换代(breakpoint_resume/ smoke剔牌库/reward_overlay夹具换新件id)+过时注释清理; 修呈现组装断裂=BoardZoneView补convert_pressed转发(挂死根因=main直连不存在的板区信号致_build_ui中断)。冒烟895/0+run_all 22套+探针含click全绿〔秘宝批 V12/V13/V19〕 2026-10-12 19:11:11 +08:00
DKChan 5b3a8fd41b ⑦T2修复: 两处轻闸红修复——board_zone_view 角标对 HBox 锚定改入树后延迟 MINSIZE 预设（容器出树最小尺寸缓存陈旧=0，零尺寸锚角悬出屏边致 ui_input case⑯ 角标真点击不中；grow 向左上防后续最小尺寸变化出屏）+ui_struct_probe overlap 规则补滚动区跨界豁免（恰好一枚在 ScrollContainer 内=未剪裁内容矩形与滚区外控件交叠系滚动态样貌非布局缺陷——当局数据区块加高列表后实证；同滚区两钮真重叠仍查）；ui_input 十七断言全绿+struct 全屏零红实证 2026-10-07 06:57:07 +08:00
DKChan dd2c57c4cf ⑦T2: 输入锁死防护+P2甲角标迁宿主+T3当局数据只读区块（三件互锁一批落码）——modal_stack 增 has_open_excluding_any 多排除式查询（has_open_excluding 委托零语义变）；main.gd 输入锁/暂停角标置灰/暂停守卫判据全改排除式排除调试浮窗（审计🔴S1+防线：DS_DEBUG默认开×遮挡复活×has_open=棋盘锁死破局）+开冒险/续玩路径显式关浮窗+_show_debug_overlay 门禁改向对局中可开（C6 单口保持）+_start_debug_levels/_on_tune_simulate 对局中守卫（长程异步模拟与活跃结算并存态不开放）+DS_DEBUG=1 启动即开（P3甲）+当局数据六项只读投影 _debug_run_data/_current_master_seed 单点（:1174 诊断种子重算冒充病灶同批改向）+模态开合单口挂 _sync_debug_overlay；P2甲：战斗屏 HUD 角标对（HBox 并排锚角距16px）+地图屏顶栏调试角标（17卡③同形制 DS_DEBUG 门控）+开始层 dbgbtn 退役（ui_assembler 返回键集换代）；T3：debug_overlay 当局数据只读区块（种子/关卡/节点/HP/GP/钥石六项标签喂入制零信号连接零动效）+is_running 语义拆分（模拟在跑≠对局禁用）+set_context_locked 对局中两钮禁用+desc 文案换代；冒烟 811/0 2026-10-07 06:43:50 +08:00
DKChan d44fdd54c5 暂停层组B：两屏入口角标+has_open守卫+四探针断言+冒烟数据一致性（迭代17卡③T2） 
- modal_stack.gd 新增 has_open_excluding(skip)：排除式开态查询（地图屏系登记册模态成员=常态
  屏态，其上角标必须可点；只读查询零副作用，登记序/开合记账语义零改动）
- board_zone_view.gd 战斗屏 HUD 右下角+level_map_screen.gd 地图屏顶栏 GP 徽右——各一枚「暂停」
  角标（debug 角标同形制：UiKit.button 紧凑豁免宽度基准+FS_HINT 字号降档；可见性/置灰归组合根，
  信号连接归组合根 ADR-0001；非对局期显式不可见防菜单误现——P1 丁）
- main.gd 接线：两角标 pressed→_on_pause_badge_pressed（守卫兜底处理器：他层开着即拒开——
  常态防线=置灰，探针 emit 绕过 disabled 时由此兜住；地图屏开态经 has_open_excluding 不计自身）
  +_sync_pause_entry 单一同步点（可见性=_level_active∧屏态；置灰=has_open）挂模态开合单口与
  屏级互斥口/进局/离局/续玩五路径
- ui_struct_probe：pause 结构断言+只读性契约（游戏语义信号清单巡检——pressed/toggled/text/
  value/item/gui_input/focus/closed 十二名，白名单外零连接，合法连接恰 2=关闭钮+closed 外发）
  +零动效契约（子树零 AnimationPlayer+源码零 create_tween——R5/P4 甲）【首跑 L1 修正：全集
  巡检把 Godot 容器布局生命线连接（child_order_changed/item_rect_changed 等引擎自动脏标记）
  误判非法——收敛为信号名清单，任务书 v1.1「巡检信号名清单落码列全」本意】
- ui_input_probe case⑯：暂停层输入锁语义（角标真点击 press+release 开层→锁期挖掘零穿透→
  「继续」关层→同格挖掘重新到达；十七断言 PASS）【首跑 L1 修正：域恰 2 枚时 flag_t 带旗+dig_t
  揭开后零无旗格可取——case 挪全 case 之尾+前沿移位扩大可挖域兜底（板面扰动零波及）】
- ui_click_probe：战斗屏角标开合/守卫断言（图例开着=置灰+emit 兜底拒开）+地图屏角标一次性
  case（选路前开/关，地图屏选路态零扰动）；ui_contrast_probe 增钥石徽深墨/烛光黄对（12 对全绿）
- smoke_all._pause_overlay_projection：暂停层投影==MetaProgression 访问器逐项（余额徽/锻造三行/
  工坊六行解锁态/天赋树概览——隔离档 smoke_meta 复用，+5 check）
- 任务书回填 T0 基线注记（冒烟 783/0·run_all 17 套·交集核对零命中，HEAD=44328b1 时点）
- T2 闸读数：冒烟 788/0（基线 783/0，+5 本批）· ui_input 十七断言 PASS · ui_struct 全绿 ·
  ui_contrast 12 对 PASS · ui_click 问题=0 · ui_layout_probe 退出码 0；纯呈现零数值=零 MC
 2026-10-06 22:38:36 +08:00
DKChan e0fd7cb8d7 iter16ui T6：P3甲FS_*六档字号档位表立项（CAPTION12/HINT14/BODY16/SUB18/TITLE24/H1=34）+全库裸字号归档107位点（就近映射；4动态位点除外；settlement_fx两处span错位写入当场修复）+11px六处提FS_CAPTION并入P11豁免清单+art-bible §7.4档位表与豁免清单落文（条带内读数=血数一处；caption档逐处清单）；轻闸冒烟782/0+三探针+layout全绿 2026-10-06 03:38:51 +08:00
DKChan af5f317aea iter16ui T4a：N4a裸色全量收ui_kit（T0普查实数25处/10文件原值搬运——任务书N4a记5处系漏记）+N4c类型色五族TG_*立项（四族实机值+第五族TG_AOE #E25676 demo补族）+tg_band()同源分族判定（Q4甲三选一/货架同判；aoe/blast归AOE=reward.tres现成spark_aoe/clear_blast消费面；max_hp归回复族）+商店货架固定默认带改分族；探针白名单清零=呈现层裸Color8=0；轻闸冒烟782/0+三探针绿 2026-10-06 03:19:13 +08:00
DKChan 473ff33b62 M8 战斗包四件（UI落码第三波）——①轮次牌plate9素牌化(墨字)②AP/RAP点阵Dot样式件(方点+亮心,AP烛光黄/RAP小人蓝)④道具槽glyph→手绘像素图标(映射回退字形)⑤棋盘底常驻操作提示条(左键挖掘/右键封印/双击快开)。P-C1 C区两段保留现状零改；P-C7战报单行现状+回看退役归M9。闸=冒烟747/0+probe_gate全绿+layout 0 2026-10-05 02:47:03 +08:00
DKChan f5edb65d25 fix(review-batch2): 视图信号可审计性+封装收口——生产24处lambda转命名方法含bind两处(P1-3)+recent_summaries/hero_effects值拷贝出户(P2-3)；生产lambda审计归零(83→59全smoke)，冒烟576/0同基线 2026-09-29 06:21:32 +08:00
DKChan b4e7200999 feat(ui): 棋盘立体中档定稿冻结——DEPTH_PX=8/DEPTH_BEVEL=0.6 常量默认生效（用户实机三档对比拍板 2026-09-24）；原型入口退役=F9 键+D 区「立体：X」按钮+切档信号链全拆（ApBarView/BoardZoneView/main 组合根同批），BoardWorld 头注随改；冒烟 557/0+ui_input/click/layout 三探针绿；§1.4 注记欠账待 art-bible 并行批落籍后补写 2026-09-24 15:56:15 +08:00
DKChan 9b35cf8c4b feat(ui): 立体档位设置按钮——D 区 AP 条右键组「立体：X」常驻显示当前档、点击循环（F9 同效同标签联动）；ApBarView/BoardZoneView 信号转发+main 组合根共享 _cycle_depth_tier（用户反馈「不知道当前对应哪个档」2026-09-24，台账 154） 2026-09-24 14:43:19 +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