From 84dc3e4bc0911771dd7919a4525da8dc6838d6e7 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Sun, 25 Oct 2026 17:53:46 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E7=99=BB=E8=AE=B0):=20=E6=96=B0=E5=A2=9E?= =?UTF-8?q?=20P0=20=E6=9D=A1=E7=9B=AE=E3=80=8CAdventureRunner=20=E8=81=8C?= =?UTF-8?q?=E8=B4=A3=E7=9C=9F=E6=8B=86=E5=88=86=E3=80=8D=E2=80=94=E2=80=94?= =?UTF-8?q?=E5=8D=A1=E2=91=A3=20=E9=81=97=E7=95=99=2012=20=E6=9D=A1?= =?UTF-8?q?=E8=BD=AC=E5=8F=91=E5=B1=9E=E6=80=A7=E5=B1=9E=20S13=20=E8=AE=A1?= =?UTF-8?q?=E6=95=B0=E8=BF=8E=E5=90=88=E8=A3=85=E7=BD=AE=EF=BC=88=E9=94=AE?= =?UTF-8?q?=E6=B2=BB=E6=9C=AC=2037625317=20=E5=90=8E=E5=85=B6=E5=AD=98?= =?UTF-8?q?=E5=9C=A8=E7=90=86=E7=94=B1=E5=B7=B2=E6=B6=88=E5=A4=B1=EF=BC=89?= =?UTF-8?q?=EF=BC=8C=E5=9B=9B=E4=BB=B6=E6=8B=86=E5=88=86=E8=BE=B9=E7=95=8C?= =?UTF-8?q?=E5=BE=85=E6=96=87=E6=A1=A3=E8=A3=81=EF=BC=9B=E7=94=A8=E6=88=B7?= =?UTF-8?q?=E6=9C=AC=E8=BD=AE=E6=98=8E=E7=A4=BA=E6=8E=88=E6=9D=83=E5=AE=9E?= =?UTF-8?q?=E7=8E=B0=E6=89=B9=E7=9B=B4=E5=86=99=E6=9C=AC=E6=B8=85=E5=8D=95?= =?UTF-8?q?=EF=BC=88=E6=89=B9=E6=80=A7=E8=B4=A8=E7=BA=A2=E7=BA=BF=E8=B1=81?= =?UTF-8?q?=E5=85=8D=E4=BB=85=E9=99=90=E6=9C=AC=E6=9D=A1=E7=99=BB=E8=AE=B0?= =?UTF-8?q?=EF=BC=89=EF=BC=8Cpipeline=5Fgate=20=E6=96=87=E6=A1=A3=E5=9F=9F?= =?UTF-8?q?=E5=8D=95=E4=BB=B6=E8=87=AA=E6=9F=A5=20exit=3D0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 待办清单.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/待办清单.md b/待办清单.md index 7fbee2cf..0153c602 100644 --- a/待办清单.md +++ b/待办清单.md @@ -2,6 +2,21 @@ 本清单是流水线的唯一登记处：要做的事先在此登记一条，随流水线段推进改状态，做完整条删除；各系统文档的「待办」节只留一行指路存根，不再自建条目。条目格式（标题＝登记元数据含可选优先级，正文＝实况/缺口/改动面/状态四属性）与状态机以 [doc-conventions §12.1](design/engineering/doc-conventions.md) 为权威。 +#### AdventureRunner 职责真拆分——12 条转发属性属 S13 计数迎合装置，须按变化原因重立协作件（2026-10-25 登记，来源=批次移交，优先级＝P0） + +**实况**： +- 迎合装置本体：迭代 37 卡④ 实现（commit e5ee4d04）在 game/core/adventure_runner.gd:60-77 留 4 条、game/core/level_runner.gd:50-64 留 8 条转发属性（get/set 直指 CurioDeck/ShopSession 件内同名状态），唯一理由＝让 S13 基线消息里的类变量数逐字保持 42/38；实现报告已按「指标迎合债」登记。 +- 存在理由已消失：S13 基线键治本已入库（master 37625317，键＝文件|规则|函数名，判定＝改小/持平不红、仅较登记值恶化判红）⇒ 撤除这 12 条只改代码，不碰基线。 +- 本体问题：adventure_runner 现 42 成员／23 公开方法／65 函数／989 行，按变化原因数混着七件事（生命周期与状态机／英雄账本与生命／三选一停点兑付／刷新 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）。 +- 目标切法（待裁，非结论）：AdventureFlow（状态机＋关序推进＋结算受理一次）／RewardStop（停点态＋兑付推进＋刷新双源）／CurioDeck（已在册）／HeroLedger（ledger＋run_ledger＋effective_max_hp＋rest 公式）／BreakpointSchema（27 键单源＋写读两派生）；呈现转名下沉装配层。判据＝件拥有状态与决策、宿主不留同名数据槽、件→宿主只传值不回调宿主私有族。 +- 相关文档：design/engineering/architecture/architecture.md（模块归属表须随拆分登记新件）· design/gdd/systems/表现与支撑/存档序列化.md（断点域契约，27 键冻结面）· reports/需求卡片-重构runner拆件与断点schema单点批-2026-10-24.md（卡④ 契约 1 冻结公开面，正是本条无法在批内完成的原因） + +**缺口**：拆分边界未裁四件——①RewardStop 与 CurioDeck 的分界（停点态 `_curio_pending`/`_curio_result`/`_node_curio_pending` 归谁、凭证兑付 `_redeem_feat_ticket` 在哪侧）；②HeroLedger 与既有 RunLedger 的关系（合并还是分层，RunLedger 已被 LevelRunner 共享引用）；③断点 schema 是否独立成件（卡④ §11 以「27 键多数取宿主态、开洞面＞收益」淘汰过独立件，真拆分后该论据失效，需重裁）；④公开面收缩后 main.gd／camp_shop_presenter／curio_interact_controller 与三处测试直引点的改法与验收面。裁完才进写卡段。 + +**改动面**：游戏代码 + +**状态**：待文档设计 + #### 超预算图策略升级路径——等比缩放与滚动视口两案待裁（2026-10-24 登记，来源=批次移交） **实况**：迭代 34 卡④（信息迷雾可见性批，已合回 master，提交 16a7ec80）按「参数限图」交付，图包络约 10 层×8 槽即当前冻结画布的屏预算上限。若后续定值批需要更大的完整可见图，两条升级路径都要动冻结件，均未设计：①等比缩放——动「节点图标 20px 烘焙 1:1」与「通道折线冻结 2/3/4px」两条冻结值；②滚动视口——新增视口交互范式。迭代 35 生成图实测深度域 L3 达 0–13，已超出该上限（level-map 已登记随动缺口，本批不裁方案）。