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
17 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 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 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 4688d09627 fix(presentation): 奇物呈现修复批——C 区/关卡页聚合行退役改逐件行「件名 ×N」+卡面摘族名（僵尸呈现整改，呈现改法=甲）+07/报告§五.5/battle.md/README/06 条收口移除+反哺点⑤销账+475 号状态记录 2026-10-12 08:04:16 +08:00
DKChan 6812ebbb73 奇物批T3+T4：relic_*→feat_*词族全换（feat_table.gd/feats.tres/feats_engine.gd三文件改名+.uid+feat_flags/feat_id/feat_row等全token+config_db注册键feats两端+entities.yaml换代注记——kind值relic/身份前缀relic:/relics存档键/摘要键按数据契约保留）；T4渠道白名单过滤（_draw_curio_candidates(channel)：通关渠道只出专长/节点渠道零专长——过滤式不拆池，TIER_QUOTAS锚零改动，devour货架保底随渠道定位退役，迁移保feat_id，pick_curio测试feat_id透传；冒烟773/0+run_all 16全绿+断点往返PASS） 2026-10-05 19:28:20 +08:00
DKChan 5cf7f4b6ae 立《特性》概念：局内加强物品统一命名为「特性」，两种形态收敛为枚举值 + 文档/称谓/数据层标识符统一 
- 新增 design/gdd/systems/冒险循环/特性.md（概念唯一定义文档）
  定义=一次冒险内角色自身得到的提升（不是持有物）；作用范围、生命周期、
  获取途径（战场奖励/商店·训练）、关联与边界五要素齐全；数值一律指路表不入正文
- 02-系统清单：冒险循环补行 + 命名对照表补 ADVENTURE_FEATURE
- registry entities.yaml：新增 feature 概念条目（owner/referenced_by）+ adventure_table 字段名同步
- 数据层标识符 112 处换名（值零变更）：BONUS_IDS→FEATURE_KINDS、bonus_token_count→feature_quota、
  bonus_value→feature_value、token_*/bonus_*_flat→feature_quota_*/feature_value_*
- 称谓统一 94 处：旧称「流派件/数值件/本关强化」→ 特性 + 形态修饰语（规则改写型/属性加成型）
- 两张 schema 顶部加概念指路注释，代码可直接查到定义文档
- 06-待办清单：BD 分层条目现状改写 + 新增「命名统一后续」条目（relic 词族与类名对齐待实施）

未动：类名与文件名（Godot .uid/.tscn 引用需跑测试自证）、断点存档键（兼容）
 2026-10-05 01:46:35 +08:00
DKChan b3c38e0dbd 全局作用域变异批文案常规化修订（用户人闸反馈）：横幅/角标/手册三处玩家可见文案改常规描述——hud_presenter.board_variant_lines 三行制（贫矿脉/回复与护甲资源减少/攻击资源增多，C区240px防裁切）；main.gd 开战横幅三行 join；ui_assembler 手册句同步；地形变异.md v0.8（玩家体验句常规化+版本史）；出口报告追认单换代+§六′追认结果（文案外九项 provisional 用户追认通过）；机制与数值零改动；轻闸=冒烟747/0+ui_probe+ui_layout 2026-10-04 23:12:32 +08:00
DKChan f8517399a7 全局作用域变异首发批 T5 呈现三层（迭代14③号卡）：settlement_fx_view +play_board_variant_banner（轮横幅先例同款——减动效=静态驻留双态；轮横幅下方叠行位）；hero_info_panel_view +地形变异常驻角标段（流派件段先例——空态整节隐藏，摆位provisional归HUD框架批）；hud_presenter +board_variant_lines 文案装配+refresh 接线（快照 board_variants 投影——核心→呈现唯一读取面；出战斗即隐）；presentation_snapshot +board_variants 投影字段；main.gd _on_round_started 首轮快照判空发射开战横幅（普通图恒零发射）；ui_assembler 玩法帮助块 +整图变异说明行（教学定稿批 P4丙「手册零再教」承载位，零交互教学） 2026-10-04 17:52:42 +08:00
DKChan f1a351f3bc 流派件持有呈现v2（用户二连反馈「战斗界面/关卡选择页都看不到局内奖励」）：①关卡选择页补齐——底部状态栏本关加成框内追加流派件持有行（set_relic_holdings 组合根投喂+与加成行并框任一非空整框显示）；②战斗C区流派件段上移至本关强化前（构筑核心优先+防clip_contents下部裁切不可见——用户实测「战斗界面没看到」的主因候选）；③投影逻辑抽 HudPresenter.relic_holdings_lines 静态共用（战斗C区/关卡页两处同源防漂移）+main 两处 open_choices 投喂；冒烟718/0三闸（基底6c20740——并行挖掘风险调研批纯文档无冲突） 2026-10-04 04:50:41 +08:00
DKChan fc26bcf860 流派件持有呈现补齐（迭代12呈现缺口——用户试玩反馈「局内奖励选了什么看不到」）：HUD C区数据框下新增「流派件」常驻段（HeroInfoPanelView set_relic_holdings+逐流派聚合行「魔法 ×2 · 档一」式+成型档位点亮+空态整节隐藏同本关强化段纪律）；hud_presenter refresh投影（runner.relics_held读面新增+RelicsEngine.tiers_for档位求值直调——战斗内/节点间隙双分支喂入，兑付后_refresh_presentations自动反映）；冒烟+2断言（空态隐藏/持有呈现）→718/0三闸+ui_probe绿 2026-10-04 03:49:16 +08:00
DKChan 5584feb6e5 T4 UiKit色彩骨架收口段: modal_shell/modal_dim收10处overlay骨架（dim色/min_size/panel参数化对照表在报告，探针私有件同名同层级保留）+label加color参收全层两行式+裸色收口（standee/camp/stage/level_map/board_world Color8→UiKit档13色+HEX_LOG_*/HEX_ROUTE/SEED 13档——值逐字节不变）+杂并七件（UiKit.scaled收双实现/到达拍块合并/点阵合并/画布常数单点/瓦片词表单点化/占位文案const/with_bar判据/bonus内联lambda改具名）；ArmedConfirm三处语义异构降级记06（不做了半套）；闸=冲烟636/0+run_all 15套+八探针全绿+熵增闸PASS 2026-10-02 09:07:06 +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 fb665f87dc iter9-T11+T12: 卡⑪ GP 常驻核验收口（实态已符 level-map spec：徽章 M-2 已落+刷新=写路径回执后重查〔open_choices 回执点〕合法路径；shot_probe 补徽章可见+读数=runner.gp 断言实测过；06 条目四承载面全闭移除〔钥石三处/胜利结算/冒险终局/关卡画面常驻〕）+卡⑫ C 区本关强化列表接线（HudPresenter.refresh 单点投影 runner 统一加算区 bonus{atk,max_hp,armor_class}→三行文案〔攻击/生命上限/护甲 AC，行文=代拍板〕，空加算整节隐藏；零核心触碰——呈现只读投影）；冒烟 596/0+shot_probe 问题=0 2026-09-30 07:08:11 +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 effb98e57d refactor(ui): C 区精简批——信息归属拍板代码实装（2026-09-26）：①C 区面板=攻击+护甲AC 数据框+魔法道具槽（预留 4 空槽）+本关强化列表（预留空态隐藏）——HP 条/立绘占位/状态槽/RAP/GP/钥石退役；②状态效果唯一展示面=B 区站桩（compact 档 StatusSlotRow 整体迁入——16px 图标+层数角标+悬停 tooltip 义务随迁，BUG-0001 回归组件同源；清空反馈逐槽化光+微文案随迁站桩）；③RAP 读数迁 D 区 AP 条贴弃图刷新消费口（点阵+数字+清零脉冲微文案+拒绝脉冲载体随迁）；④hud_presenter 单投喂改造（B/C 双投喂重复展示退役）+钱包投喂退役（GP/钥石迁出战斗屏，去向=关卡画面/结算/营地归对应 UX 批）；冒烟 557/0+五探针全绿 2026-09-26 01:26:26 +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