From 241726215fc14d7c947c6c82a7899f7db2c2c407 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Mon, 26 Oct 2026 22:52:09 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=87=E6=A1=A3=E8=AE=BE=E8=AE=A1(gdstyle?= =?UTF-8?q?=E5=AD=98=E9=87=8F=E5=80=BA=E6=B8=85=E5=81=BF=C2=B7=E8=AE=BE?= =?UTF-8?q?=E8=AE=A1=E6=AE=B5=E9=A6=96=E8=BD=AE):=20=E5=9B=9B=E9=A1=B9?= =?UTF-8?q?=E7=94=A8=E6=88=B7=E8=A3=81=E5=AE=9A=E8=90=BD=E6=96=87=E2=80=94?= =?UTF-8?q?=E2=80=94=E6=AE=B5=E7=BB=84=E7=BB=87=3D=E9=80=90=E6=B3=A2?= =?UTF-8?q?=E5=BC=80=E8=AE=BE=E8=AE=A1=E6=AE=B5(=E7=BA=AF=E4=BB=A3?= =?UTF-8?q?=E7=A0=81=E6=B3=A2=E5=86=99=E5=8D=A1=E5=89=8D=E7=A1=AE=E8=AE=A4?= =?UTF-8?q?=E9=9B=B6=E8=AE=BE=E8=AE=A1=E6=94=B9=E5=8A=A8+=E9=87=8D?= =?UTF-8?q?=E6=B5=8B=E8=AF=BB=E6=95=B0,=E6=B3=A21=E6=8B=86=E4=BB=B6?= =?UTF-8?q?=E8=AE=BE=E8=AE=A1=E5=8D=95=E5=BC=80)+=E6=B3=A22=E5=90=84?= =?UTF-8?q?=E6=96=87=E4=BB=B6=E5=86=85=E9=83=A8=E6=8B=86=E6=A0=A1=E9=AA=8C?= =?UTF-8?q?=E5=9F=9F=E7=A7=81=E6=9C=89=E5=87=BD=E6=95=B0=E6=97=8F(?= =?UTF-8?q?=E4=B8=8D=E6=8A=BD=E5=85=B1=E4=BA=AB=E9=AA=A8=E6=9E=B6,13?= =?UTF-8?q?=E6=96=87=E4=BB=B6=E7=BB=93=E6=9E=84=E5=90=84=E5=BC=82=E9=98=B2?= =?UTF-8?q?=E5=BC=BA=E8=A1=8C=E5=BD=92=E4=B8=80)+=E6=B3=A26=E8=A7=86?= =?UTF-8?q?=E5=9B=BE=E5=86=85=E9=83=A8=E6=8B=86=E7=A7=81=E6=9C=89=E5=87=BD?= =?UTF-8?q?=E6=95=B0(=E4=B8=8D=E6=8B=86=E6=9E=84=E5=BB=BA=E6=AD=A5?= =?UTF-8?q?=E4=BB=B6,main=5Fui=5Fbuild=E5=85=88=E4=BE=8B=E5=8A=A8=E6=9C=BA?= =?UTF-8?q?=E6=98=AF=E7=BB=84=E5=90=88=E6=A0=B9=E8=B6=85=E9=99=90)+?= =?UTF-8?q?=E6=B3=A28=20config=5Fdb=E5=85=AC=E5=BC=80=E6=96=B9=E6=B3=95?= =?UTF-8?q?=E6=94=B6=E6=95=9B=E5=AE=9A=E6=80=A7=E7=BA=AF=E4=BB=A3=E7=A0=81?= =?UTF-8?q?(=E6=9E=B6=E6=9E=84=E8=A1=A8=E5=AF=B9=E5=A4=96=E6=9A=B4?= =?UTF-8?q?=E9=9C=B2=E5=88=97=E9=9A=8F=E5=8A=A8=E6=94=B9=E5=86=99);?= =?UTF-8?q?=E4=BA=A4=E5=8F=89=E6=A0=A1=E9=AA=8C=E5=88=A4=E5=AE=9A=3D?= =?UTF-8?q?=E5=85=A8=E9=83=A8=E6=B3=A2=E4=B8=8D=E6=94=B9=E6=B8=B8=E6=88=8F?= =?UTF-8?q?=E8=A7=84=E5=88=99=E4=B8=8E=E7=8E=A9=E5=AE=B6=E5=8F=AF=E8=A7=81?= =?UTF-8?q?=E8=A1=8C=E4=B8=BA,design/gdd=E9=9B=B6=E4=BF=AE=E8=AE=A2?= =?UTF-8?q?=E9=A2=84=E6=9C=9F,=E5=94=AF=E4=B8=80=E8=AE=BE=E8=AE=A1?= =?UTF-8?q?=E6=94=B9=E5=8A=A8=E9=9D=A2=3D=E6=B3=A21=E7=9A=84architecture.m?= =?UTF-8?q?d=E6=A8=A1=E5=9D=97=E5=BD=92=E5=B1=9E=E8=A1=A8;=E6=B3=A25?= =?UTF-8?q?=E5=AE=9E=E6=9F=A5=E8=90=BD=E5=AE=9Aopen=5Fticket=2012=E5=8F=82?= =?UTF-8?q?=3D=E5=8D=95=E6=8D=AE=E5=A3=B0=E6=98=8E=E5=BD=A2=E6=80=81,?= =?UTF-8?q?=E4=B9=9D=E6=A0=8F=E7=9B=AE=E5=8F=AA=E5=9C=A8=E6=9E=B6=E6=9E=84?= =?UTF-8?q?=E6=8F=8F=E8=BF=B0=E5=B1=82GDD=E6=97=A0=E6=AD=A4=E5=A5=91?= =?UTF-8?q?=E7=BA=A6,=E5=8F=82=E6=95=B0=E6=94=B6=E6=9D=9F=E7=BA=AF?= =?UTF-8?q?=E4=BB=A3=E7=A0=81;=E8=A3=81=E5=AE=9A=E8=AE=B0=E5=BD=95?= =?UTF-8?q?=E8=90=BD=E6=B8=85=E7=82=B9=E6=8A=A5=E5=91=8A=C2=A7=E5=85=AD,?= =?UTF-8?q?=E6=B3=A2=E6=AC=A1=E8=A1=A8=E4=B8=89=E8=A1=8C=E9=9A=8F=E5=8A=A8?= =?UTF-8?q?;=E6=9D=A1=E7=9B=AE=E7=8A=B6=E6=80=81=E6=8E=A8=E8=BF=9B?= =?UTF-8?q?=E6=96=87=E6=A1=A3=E8=AE=BE=E8=AE=A1=E4=B8=AD,=E7=BC=BA?= =?UTF-8?q?=E5=8F=A3=E6=94=B9=E9=80=90=E6=B3=A2=E8=AE=BE=E8=AE=A1=E7=A1=AE?= =?UTF-8?q?=E8=AE=A4=E5=88=B6;pipeline=5Fgate=E7=BB=BF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...计-gdstyle存量债清点与清偿方案-2026-10-26.md | 16 +++++++++++++--- 待办清单.md | 8 ++++---- 2 files changed, 17 insertions(+), 7 deletions(-) diff --git a/reports/审计-gdstyle存量债清点与清偿方案-2026-10-26.md b/reports/审计-gdstyle存量债清点与清偿方案-2026-10-26.md index 8cfecf22..70d22440 100644 --- a/reports/审计-gdstyle存量债清点与清偿方案-2026-10-26.md +++ b/reports/审计-gdstyle存量债清点与清偿方案-2026-10-26.md @@ -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 无此契约，参数收束不改单据栏目与明细行发射协议，纯代码。 + diff --git a/待办清单.md b/待办清单.md index 22fbdc2a..34324139 100644 --- a/待办清单.md +++ b/待办清单.md @@ -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）