game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,620 Commits 23 Branches 0 Tags
75fafc39654b3fff485307cf3fc61ae6ebb72e1a
Commit Graph
10 Commits
Author SHA1 Message Date
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 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 8b9e55673f refactor(迭代27 T4): 波四 ModalFlow 抽取+互斥域 tags 化+双 context——对拍全同 
P1-5/P2-7 组合根可测化+模态协议内聚（场景拆分后重估结论=抽取面收敛为模态编排域）:
- modal_flow.gd 新纯逻辑类: 依赖仅 ModalStack+查询 Callable（审计处方）——开合编排
  （挂起兜底/排播排空/遮挡记账/开合同步）/棋盘输入锁谓词（三例外注入）/双形制角标谓词；
  V6 modal_flow_test 19 断言直接 new() 进 run_all（26→27 套）——测试抓出并修正
  挂起兜底 divergent return 一处（原 main 语义=先结挂起后继续开本层不短路）
- ModalStack 互斥域随层登记: register(m, tags) + TAG_NON_LOCKING/TAG_SCREEN_STATE
  封闭词表 + has_open_excluding_tags 组查询；原 has_open_excluding/_any 调用点拼装退役
  （main 五处判据迁移）；main._modals=flow.stack（ui_struct _list 登记序断言缝保留）
- P1-5 控制器构造收拢 context: curio 16 参→CurioFlowContext/camp 13 参→CampFlowContext
  （字段逐一同名迁移，控制器可独立实例化）

验收: 对拍三变体全同；冒烟 1079/0+run_all 27 套+probe click+render golden 全绿
 2026-10-15 00:31:36 +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 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 0691a188fd T3 呈现层结构段: main.gd 1395→1237三件迁出（RowPacer排播泵/AuxInteractController两步交互含-9,-9哨兵改显式无目标/GP影子账本独立件）+模态栈收口（settings/camp/tune改走_open_modal+_input_locked改ModalStack.has_open查询+三例外）+HUD单通道（收尾反馈/结算视觉进presenter，play_round_sweep时序敏感留组合根注记）+链式穿透清除（variation回调注入/phase经snapshot）+confirm_dialog构建序复位删move_child创可贴+登记序树序漂移复位；保留面=main._row_queue委托/pace_delay_for/_flush_row_queue/_adventure_gp_view写面全数核对过；后续卡注=main到900还需迁三选一编排与debug接线（06登记） 2026-10-02 08:46:37 +08:00
DKChan 104cea6461 fix(review-batch3): 类型收紧生产清零137处(P1-2三步+延伸)+autoload class_name(ConfigDb/RngServiceCore)与_init标注(P2-1)+validate_skill_pool_links/ShopTable标注(P2-4)+相位enum外String面(P2-2)+typed-rows探针实证.tres装载转换；smoke缝合20处rows.assign+str(bb)同语义；审计生产双归零(240→103/83→59全测试链)，单测7套绿，冒烟576/0同基线 2026-09-29 07:01:29 +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