docs(结项补账): 修 doc_term 红(P0 条新文退役词「对拍」改「基线数据逐项比对」)+登记修规待办条「合回闸分域判据按前缀推域误判 game/ 内文档件」——用户 2026-10-25 裁结项批改动验证集清单.md 但不跑全量闸,判据冲突实证留条目内
This commit is contained in:
1 parent
c25daa30cd
commit
8506cc8e14
1 file changed
+14
-1
@@ -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`)。发起时点由用户定。
|
||||
|
||||
Reference in new issue
Block a user