From 8506cc8e14ac6495f4223bc3f951bc82df265bb4 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Mon, 26 Oct 2026 00:43:34 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E7=BB=93=E9=A1=B9=E8=A1=A5=E8=B4=A6):=20?= =?UTF-8?q?=E4=BF=AE=20doc=5Fterm=20=E7=BA=A2=EF=BC=88P0=20=E6=9D=A1?= =?UTF-8?q?=E6=96=B0=E6=96=87=E9=80=80=E5=BD=B9=E8=AF=8D=E3=80=8C=E5=AF=B9?= =?UTF-8?q?=E6=8B=8D=E3=80=8D=E6=94=B9=E3=80=8C=E5=9F=BA=E7=BA=BF=E6=95=B0?= =?UTF-8?q?=E6=8D=AE=E9=80=90=E9=A1=B9=E6=AF=94=E5=AF=B9=E3=80=8D=EF=BC=89?= =?UTF-8?q?=EF=BC=8B=E7=99=BB=E8=AE=B0=E4=BF=AE=E8=A7=84=E5=BE=85=E5=8A=9E?= =?UTF-8?q?=E6=9D=A1=E3=80=8C=E5=90=88=E5=9B=9E=E9=97=B8=E5=88=86=E5=9F=9F?= =?UTF-8?q?=E5=88=A4=E6=8D=AE=E6=8C=89=E5=89=8D=E7=BC=80=E6=8E=A8=E5=9F=9F?= =?UTF-8?q?=E8=AF=AF=E5=88=A4=20game/=20=E5=86=85=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E4=BB=B6=E3=80=8D=E2=80=94=E2=80=94=E7=94=A8=E6=88=B7=202026-1?= =?UTF-8?q?0-25=20=E8=A3=81=E7=BB=93=E9=A1=B9=E6=89=B9=E6=94=B9=E5=8A=A8?= =?UTF-8?q?=E9=AA=8C=E8=AF=81=E9=9B=86=E6=B8=85=E5=8D=95.md=20=E4=BD=86?= =?UTF-8?q?=E4=B8=8D=E8=B7=91=E5=85=A8=E9=87=8F=E9=97=B8=EF=BC=8C=E5=88=A4?= =?UTF-8?q?=E6=8D=AE=E5=86=B2=E7=AA=81=E5=AE=9E=E8=AF=81=E7=95=99=E6=9D=A1?= =?UTF-8?q?=E7=9B=AE=E5=86=85?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 待办清单.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/待办清单.md b/待办清单.md index d803ae61..35e25e4b 100644 --- a/待办清单.md +++ b/待办清单.md @@ -9,7 +9,7 @@ - 存在理由已消失：S13 基线键治本已入库（master 37625317，键＝文件|规则|函数名，判定＝改小/持平不红、仅较登记值恶化判红）⇒ 撤除这 25 条属纯代码改动、不碰基线（但须与拆件同批——单撤会让三处测试直引与探针直读面成片红，见缺口⑤）。 - 撤装置后的实测计数（迭代 37 批内逐卡缺口盘点）：只撤 25 条转发属性＝adventure_runner 类变量 42→38、公开方法 23 不减；level_runner 类变量 38→30、公开方法 54 不减；board_view 类变量 45→32。结论＝单撤装置只还计数债、职责混合零解，撤除必须与拆件同批。 - 本体问题：adventure_runner 现 42 成员／23 公开方法／65 函数／989 行（level_runner 38／54、board_view 45／27 同状——只撤装置到不了阈值），按变化原因数混着七件事（生命周期与状态机／英雄账本与生命／三选一停点兑付／刷新 X 与 Y 双源／断点 schema 写读／呈现事件转发／商店池装配接线），属 God Class＋Data Clump；卡④ 只搬数据未搬决策，件的封装是名义的——测试仍从宿主面直改件内多重集（game/tests/unit/core/adventure_feats_test.gd:390-393、feat_vouchers_test.gd:92-93、level_shop_economy_test.gd:1351-1353）。 -- 验收面预案要点（迭代 37 批内成文，写卡输入）：每新件至少一条真实入口断言（RewardStop 走 start_adventure→通关三选一→选件→断言加算区/池余量/停点态清零；HeroLedger 的 rest 与 heal 封顶走真链；BreakpointSchema 承〔wr2〕三条＋ui_click_probe wc2 续玩真链）；撤销证明逐单元「回退本批 hunk→断言红→还原复绿」、禁注入式变异；断点 27 键键名/缺省/回退策略逐键冻结；RNG 流名（reward_pick）与消费序零漂移；`tools/gdstyle_baseline.txt` 禁改、计数下降属改善不判红；MC/对拍是否发起由用户裁（触及存档/RNG/结算面）。 +- 验收面预案要点（迭代 37 批内成文，写卡输入）：每新件至少一条真实入口断言（RewardStop 走 start_adventure→通关三选一→选件→断言加算区/池余量/停点态清零；HeroLedger 的 rest 与 heal 封顶走真链；BreakpointSchema 承〔wr2〕三条＋ui_click_probe wc2 续玩真链）；撤销证明逐单元「回退本批 hunk→断言红→还原复绿」、禁注入式变异；断点 27 键键名/缺省/回退策略逐键冻结；RNG 流名（reward_pick）与消费序零漂移；`tools/gdstyle_baseline.txt` 禁改、计数下降属改善不判红；MC 与基线数据逐项比对是否发起由用户裁（触及存档/RNG/结算面）。 - 目标切法（待裁，非结论；各件收编范围＝迭代 37 批内按变化原因划界的成文要点）：AdventureFlow（留名 adventure_runner；收 state/level_index/levels_total/_runner/_pending_next_level/_last_level_payload 与 start/resume/关序推进/结算受理方法族＝状态机＋关序推进＋结算受理一次）／RewardStop（收停点三态 _curio_pending/_curio_result/_node_curio_pending、刷新双源 _attune_refresh_x/_refresh_stock 与 pick_curio/refresh 族/兑付推进方法族）／CurioDeck（已在册：池与凭证计数已入件）／HeroLedger（收 ledger/run_ledger/_base_override/_override/purchased/keystone/_feats 与 effective_max_hp/apply_rest 等＝数值叠加与生命口径）／BreakpointSchema（收 BREAKPOINT_FIELDS 27 键登记的派生段与 _snapshot_breakpoint/_bp_read/`_resume_*` 六小函数＝存档格式）；呈现转名（`_forward_*` 六件＋信号面）下沉装配层。判据＝件拥有状态与决策、宿主不留同名数据槽、件→宿主只传值不回调宿主私有族。 - 相关文档：design/engineering/architecture/architecture.md（模块归属表须随拆分登记新件）· design/gdd/systems/表现与支撑/存档序列化.md（断点域契约，27 键冻结面）· 迭代 37 卡④ 契约 1 冻结公开面（commit e5ee4d04），正是本条无法在批内完成的原因（需求卡片已退役，口径见 git 历史） @@ -39,6 +39,19 @@ **状态**：待裁决 +#### 合回闸分域判据按路径前缀推域——game/ 内生成文档件被误判代码域，须改按改动性质判（2026-10-25 登记，来源=用户裁决） + +**实况**： +- 现行判据：合回闸（process-conventions §3.9）按 git diff 路径前缀推验收分域——`game/` 前缀一律代码域；AGENTS.md「运行与验证」红线「一次改动同批混触 `game/` 与文档面时跑全量档」。 +- 实证冲突（迭代 37 结项 2026-10-25）：结项批唯一 `game/` 前缀改动＝`game/tests/验证集清单.md`（tools/extract_checks.py 重生成的断言索引，零游戏行为影响），按前缀推域要跑全量档；而 batch-closure 技能明令「收尾批禁跑全量档、只跑 `--docs`」——两条规则正面相撞，用户裁「改动，但不需要跑全量闸」并判前缀判据错误。 +- 判据意图＝改动伤害哪个验证面：`.gd`/场景/素材影响游戏运行才需代码域；`game/` 里的文档件只伤文档面。「位置」当「性质」的代理判据，代码树内驻文档件必误判（验证集清单.md 即此类）。 + +**缺口**：修规方案未成文——①判据形态：`game/` 前缀下非代码件白名单（.md/生成清单），还是「扩展名非行为载体即文档域」通用规则；②「混触即全量档」条款是否废改为逐文件分域取并集；③同步面＝AGENTS.md 红线段、process-conventions §3.9、`tools/run_all_gates.sh` 与合回闸的分域推导和 `domain` 字段生成、batch-closure 等各段技能措辞。规则修订须过真实案例评估方算完成——本批 commit `c25daa30` 即现成样例（旧判据判 full、新判据应判 docs）。 + +**改动面**：工具代码 + +**状态**：待文档设计 + #### gdstyle 基线陈旧键待人工清理（2026-10-25 登记，来源=批次移交） **实况**：证据＝`tools/gdstyle_baseline.txt` 存量条目有不命中盘面的旧键——adventure_runner 的 `_draw_curio_candidates`/`resume_adventure`/`_start_current_level` 与 `_resume` 前族、level_runner 迁出函数名对应条目、board_view 已压回阈值内函数对应条目（迭代 37 卡②③④ 重构后函数已迁出或压回）。新键形态（文件|规则|函数名）下陈旧键无害，但属噪声。处置＝下次人工发起 `--refresh` 时一并清掉（骤降守卫已内建于 refresh 路径，commit `37625317`）。发起时点由用户定。