文档设计(gdstyle存量债清偿·设计段首轮): 四项用户裁定落文——段组织=逐波开设计段(纯代码波写卡前确认零设计改动+重测读数,波1拆件设计单开)+波2各文件内部拆校验域私有函数族(不抽共享骨架,13文件结构各异防强行归一)+波6视图内部拆私有函数(不拆构建步件,main_ui_build先例动机是组合根超限)+波8 config_db公开方法收敛定性纯代码(架构表对外暴露列随动改写);交叉校验判定=全部波不改游戏规则与玩家可见行为,design/gdd零修订预期,唯一设计改动面=波1的architecture.md模块归属表;波5实查落定open_ticket 12参=单据声明形态,九栏目只在架构描述层GDD无此契约,参数收束纯代码;裁定记录落清点报告§六,波次表三行随动;条目状态推进文档设计中,缺口改逐波设计确认制;pipeline_gate绿
This commit is contained in:
1 parent
af0e28d655
commit
241726215f
2 files changed
+17
-7
No files matched your search
@@ -42,13 +42,13 @@ S13 闸=「当前扫描 vs 基线对账」:判红仅两种——基线外新
|
||||
|---|---|---|---|---|
|
||||
| 波0 | 基线对账刷新(`tools/gdstyle_baseline.txt`) | 18 陈旧键 | 人工 `--refresh` 一次清理陈旧键(原「gdstyle 基线陈旧键待人工清理」条目并入本波);随批处置 iter38 两条恶化(battle_orchestrator 行数 1314/1302、level_map_screen 类变量 22/21)——批准随批 refresh 则新水位挂账归波 1/波 6 清偿,或还债压回;处置权在用户 | 须在 iter38 合回后执行;骤降守卫 18/234≈7.7% 低于 10% 线,无需 --force |
|
||||
| 波1 | battle_orchestrator | 22 | 22 条全库单文件最大户(文件 1302 行/类变量 50/begin_battle 141 行 17 分支等);按变化原因拆协作件(先例=AdventureRunner 真拆分 architecture v1.16 流程) | 前置=文档设计段闭合;文件在 PARITY_TOUCH_FACES——实跑对拍须经用户批准、不得借机重锚 |
|
||||
| 波2 | meta_tree_table+treasure_item_table+board_gen_table+enemy_table+forge_table+level_gen_params+meta_table+reward_table+skill_table+variation_table+status_effect_table+config_db_cross_validator+config_db_resolver | 40 | 数据校验族同病根:validate()/cross_validate() 过长过分支(treasure_item 147 行 44 分支、enemy 116 行 32 分支、cross_validate 107 行 21 分支);方向=校验骨架抽取或按校验域拆函数 | fail-fast 契约与校验覆盖面零变化;断言面=现有 validate 系单测逐字保留 |
|
||||
| 波2 | meta_tree_table+treasure_item_table+board_gen_table+enemy_table+forge_table+level_gen_params+meta_table+reward_table+skill_table+variation_table+status_effect_table+config_db_cross_validator+config_db_resolver | 40 | 数据校验族同病根:validate()/cross_validate() 过长过分支(treasure_item 147 行 44 分支、enemy 116 行 32 分支、cross_validate 107 行 21 分支);方向=各文件内部拆校验域私有函数族(2026-10-26 用户裁,不抽共享骨架) | fail-fast 契约与校验覆盖面零变化;断言面=现有 validate 系单测逐字保留 |
|
||||
| 波3 | grant_segment+combat_segment+settlement_table | 12 | 结算管线:grant_segment run() 211 行/36 局部/33 分支(全库最大单函数)+_judge_seal 84 行;combat_segment run() 83 行 | settlement/ 在 PARITY_TOUCH_FACES——对拍须用户批准;结算数值与行型协议零触碰(iter38 卡④刚收敛) |
|
||||
| 波4 | board_generator+node_map_generator | 17 | 生成器族:board_generator(measure_inferability 64 行 12 分支)+node_map_generator(validate_output 132 行 34 分支 22 局部) | 推理层生成正确性断言面在册;生成结果逐位零变化 |
|
||||
| 波5 | damage_controller+effect_engine | 17 | 伤害与效果管线:damage_controller(_hero_attack_ctx/redeem 双超长、open_ticket 参数 12/5)+effect_engine(_cond_ok return 19/6、多余 else 一条) | 伤害数值与效果语义零触碰;effect_engine.validate_trigger_row 的文案计数修正随 iter38 卡③,写卡时核现行 |
|
||||
| 波6 | camp_overlay_view+level_map_screen+board_cell_unit+standee_body+hero_info_panel_view+battle_end_overlay+debug_overlay+ui_assembler+battle_stage_view+curio_pick_overlay+settings_overlay+battle_log_view+curio_interact_controller+ap_bar_view+board_zone_view+board_fx_view+legend_overlay | 54 | 呈现层构建函数族同病根:_init/_build/_paint_cell/_draw 超长(camp_overlay _init 149 行 28 局部、board_cell_unit _draw 147 行 29 分支、_paint_cell 139 行 24 分支);循环内 new 多在本波 | 改前建 golden 基线或对拍 0.00%(先例=iter38 卡① level_map.png);对拍差异非零即红 |
|
||||
| 波6 | camp_overlay_view+level_map_screen+board_cell_unit+standee_body+hero_info_panel_view+battle_end_overlay+debug_overlay+ui_assembler+battle_stage_view+curio_pick_overlay+settings_overlay+battle_log_view+curio_interact_controller+ap_bar_view+board_zone_view+board_fx_view+legend_overlay | 54 | 呈现层构建函数族同病根:_init/_build/_paint_cell/_draw 超长(camp_overlay _init 149 行 28 局部、board_cell_unit _draw 147 行 29 分支、_paint_cell 139 行 24 分支);循环内 new 多在本波;2026-10-26 用户裁=视图内部拆私有函数,不拆构建步件(main_ui_build 先例动机是组合根超限,普通视图不类比) | 改前建 golden 基线或对拍 0.00%(先例=iter38 卡① level_map.png);对拍差异非零即红 |
|
||||
| 波7 | 结构小件定点修(吸收原「结构审查未立项小件候审」条目) | —(审计来源,无 S13 计数) | 卡已写:`reports/需求卡片-结构小件定点修批-2026-10-26.md` v1.2(main 死变量与 confirm 旁路/settle_batch 空判/row_pacer 常驻 flush/_fatal assert 剥离/rng_service early-return 五件);iter38 卡②施工中途停卡呈报(wr5/wr6 验收载体与闸机错误扫描结构性互斥),改动已还原零提交 | 随本事项重裁验收载体后续用;卡内行号按合回后 master 重核 |
|
||||
| 波8 | 散条兜底(19 文件) | 40 | 散条兜底:类级超标大户(config_db 公开方法 44、main 类变量 49、adventure_table 类变量 44、save_manager 公开方法 52)+参数族(curio_flow_context _init 16/5、hud_presenter 三件、unit_container spawn 10/5)+测量面(print 残留×2、循环内 await) | 测量面两件 print 是否留档豁免随批裁;散条可并卡也可零星随其他波搭车 |
|
||||
| 波8 | 散条兜底(19 文件) | 40 | 散条兜底:类级超标大户(config_db 公开方法 44、main 类变量 49、adventure_table 类变量 44、save_manager 公开方法 52)+参数族(curio_flow_context _init 16/5、hud_presenter 三件、unit_container spawn 10/5)+测量面(print 残留×2、循环内 await);config_db 公开方法收敛定性纯代码(2026-10-26 用户裁:删冗余、私有化内部方法,不动对外语义,架构表对外暴露列实现批后随动改写) | 测量面两件 print 是否留档豁免随批裁;散条可并卡也可零星随其他波搭车 |
|
||||
| 尾波 | 三宿主残留 | 待清点 | iter39 合回后 adventure_runner/level_runner/board_view 残留债重新清点并入 | 前置=迭代 39 合回 |
|
||||
|
||||
合计核对:波 1–6+波 8=202 键+三宿主规避 14 键=216 键(断言在生成脚本内)。
|
||||
@@ -402,3 +402,13 @@ S13 闸=「当前扫描 vs 基线对账」:判红仅两种——基线外新
|
||||
### game/presentation/views/legend_overlay.gd(1 条)
|
||||
- 文件级 循环内new
|
||||
|
||||
## 六、文档设计段裁定记录(2026-10-26,用户裁)
|
||||
|
||||
依据=architecture.md v1.16 与 code-conventions/test-conventions 交叉校验后的设计段首轮裁定:
|
||||
|
||||
1. **段组织=逐波开设计段**:每波写卡前过一遍设计确认——纯代码波确认零设计改动+按当时 master 重测读数即可写卡;波 1 拆件设计讨论单开(唯一硬设计前置,产出=architecture.md 模块归属表新行登记)。
|
||||
2. **波 2 形态=各文件内部拆校验域私有函数族**,不抽共享校验骨架(13 文件结构各异,强行归一有抽象层风险;零新概念零架构登记)。
|
||||
3. **波 6 形态=视图内部拆私有函数**,不拆构建步件(main_ui_build 先例的动机是组合根超限,普通视图不类比)。
|
||||
4. **波 8 config_db 公开方法收敛=纯代码**(删冗余、私有化内部方法,不动对外语义;架构表「对外暴露」列属现状登记,实现批后随动改写)。
|
||||
5. **判定口径**:全部波不改游戏规则与玩家可见行为——design/gdd/systems/ 零修订预期;唯一设计改动面=波 1 的 architecture.md;owner 契约若被触碰走迭代批反哺点通道(正常机制)。波 5 已实查落定:open_ticket 12 参全是单据声明形态,「九栏目」只在架构模块描述层、GDD 无此契约,参数收束不改单据栏目与明细行发射协议,纯代码。
|
||||
|
||||
@@ -4,19 +4,19 @@
|
||||
|
||||
#### gdstyle 存量债全量清偿——216 键按病根分波整改(2026-10-26 登记,来源=会话提及,优先级=P0)
|
||||
|
||||
**实况**:S13 闸实测存量债 216 键/60 文件(2026-10-26,master f3b148ce,gdstyle v0.4.0 默认阈值;基线登记 234 键=实存 216+陈旧 18)。全量清单、波次方案与纪律见清点报告(本条目裁决源)。2026-10-26 用户裁:撤销「一条总账」与「按病根拆多条」两案,并为本条单账(存量债全部清除,紧急优先级);原「gdstyle 基线陈旧键待人工清理」条目并入波 0(基线对账刷新),原「结构审查未立项小件候审」条目并入波 7(卡已写、停卡待裁)。
|
||||
**实况**:S13 闸实测存量债 216 键/60 文件(2026-10-26,master f3b148ce,gdstyle v0.4.0 默认阈值;基线登记 234 键=实存 216+陈旧 18)。全量清单、波次方案与纪律见清点报告(本条目裁决源)。2026-10-26 用户裁:撤销「一条总账」与「按病根拆多条」两案,并为本条单账(存量债全部清除,紧急优先级);原「gdstyle 基线陈旧键待人工清理」条目并入波 0(基线对账刷新),原「结构审查未立项小件候审」条目并入波 7(卡已写、停卡待裁)。**2026-10-26 设计段首轮裁定**:段组织=逐波开设计段;波 2 各文件内部拆、波 6 视图内部拆私有函数、波 8 config_db 纯代码收敛——三处定性零设计改动;全部波不改游戏规则与玩家可见行为,design/gdd/systems/ 零修订预期,唯一设计改动面=波 1 的 architecture.md 模块归属表(裁定全文见清点报告 §六)。
|
||||
|
||||
关联文档清单:
|
||||
- 清点报告 reports/审计-gdstyle存量债清点与清偿方案-2026-10-26.md(2026-10-26,216 键全量清单+波次方案+纪律)
|
||||
- 清点报告 reports/审计-gdstyle存量债清点与清偿方案-2026-10-26.md(2026-10-26,216 键全量清单+波次方案+纪律+设计段裁定记录 §六)
|
||||
- 需求卡片 reports/需求卡片-冒险域拆件与账本实体化批-2026-10-26.md v1.2(规避指向:三宿主债归此卡与姊妹副卡,本事项禁触,残留归尾波)
|
||||
- 需求卡片 reports/需求卡片-同调配装充能域封装批-2026-10-26.md v1.2(同上规避指向)
|
||||
- 需求卡片 reports/需求卡片-结构小件定点修批-2026-10-26.md v1.2(波 7 现成卡:iter38 卡②停卡退回上游,随本事项重裁验收载体)
|
||||
|
||||
**缺口**:波 1(battle_orchestrator 拆件)等结构类波次须先过文档设计段闭合才可写卡;逐波写卡前须按当时 master 重新实测读数(iter38 合回与后续批次漂移本清点数字)。
|
||||
**缺口**:逐波设计确认制——纯代码波(波 0/2/3/4/5/6/8)写卡前确认零设计改动+重测读数;波 1 须先完成 battle_orchestrator 拆件设计讨论并登记 architecture.md 新模块行;波 7 随本事项重裁 wr5/wr6 验收载体。
|
||||
|
||||
**改动面**:游戏代码+工具代码
|
||||
|
||||
**状态**:待文档设计
|
||||
**状态**:文档设计中
|
||||
|
||||
#### AdventureRunner 职责真拆分——三宿主共 25 条转发属性属 S13 计数迎合装置,须按变化原因重立协作件(2026-10-25 登记,来源=批次移交,优先级=P0)
|
||||
|
||||
|
||||
Reference in new issue
Block a user