From 8fd99092dbc4fb4d88c7ea8c66df5e5002482ba7 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Mon, 12 Oct 2026 00:45:09 +0800 Subject: [PATCH] =?UTF-8?q?docs(sync):=20=E8=BF=AD=E4=BB=A320=20=E6=9C=BA?= =?UTF-8?q?=E6=A2=B0=E9=9D=A2=E6=96=87=E6=A1=A3=E9=9A=8F=E6=89=B9=E5=90=8C?= =?UTF-8?q?=E6=AD=A5=EF=BC=88=E5=90=8C=E6=AD=A5=E9=97=B8=20v2=EF=BC=89?= =?UTF-8?q?=E2=80=94=E2=80=94registry=20curio/adventure=5Ftable=20?= =?UTF-8?q?=E6=8D=A2=E4=BB=A3=E6=B3=A8=E8=AE=B0+roadmap=20=E8=BF=AD?= =?UTF-8?q?=E4=BB=A320=20=E8=A1=8C=E5=B7=B2=E5=85=A5=E5=BA=93=E6=8D=A2?= =?UTF-8?q?=E4=BB=A3+06=20=E4=B8=A4=E5=A4=84=E9=94=80=E5=8F=B7=EF=BC=88?= =?UTF-8?q?=E7=A7=98=E5=AE=9D=E6=89=B9=E2=91=A2=E6=8B=86=E5=87=BA/?= =?UTF-8?q?=E7=94=9F=E5=91=BD=E6=AF=94=E4=BE=8B=E5=89=8D=E7=BD=AE=E6=9D=A1?= =?UTF-8?q?=EF=BC=89+07=20=E7=9B=AE=E6=A3=80=E9=A1=B9=E4=BA=94=E4=BB=B6?= =?UTF-8?q?=E7=99=BB=E8=AE=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- design/gdd/06-待办清单.md | 4 ++-- design/gdd/07-体验验证清单.md | 9 +++++++++ design/registry/entities.yaml | 2 ++ roadmap.md | 2 +- 4 files changed, 14 insertions(+), 3 deletions(-) diff --git a/design/gdd/06-待办清单.md b/design/gdd/06-待办清单.md index 8c2a1675..1176b279 100644 --- a/design/gdd/06-待办清单.md +++ b/design/gdd/06-待办清单.md @@ -144,7 +144,7 @@ **状态**：已编入迭代 22（2026-10-11 用户令；需求卡片 v1.2 零待裁——开工门=U0） -**进展注记（2026-10-10）**：数据文件面本批不依赖武器锻造线；**槽位面依赖修正（2026-10-10 设计骨架批后）**——同调位数量与品质的语义已裁归天赋树同调位节点（树侧接线归天赋树线/天赋树实装批），本批与该批存在槽位定序点（先树后宝或合并评估，随排期裁），现役谓词表求值作为本批落地前的过渡基座仍成立；秘宝体系文档正确性检查已过（五文件交叉核对：仅 registry 三处现行旧称「魔法道具」残留，已随检查批修正；其余命中均为版本历史与更名记载的合法引述）——**检查通过；设计侧裁点经 grilling 审查轮+设计骨架批已清零（秘宝.md v2.3），按三段流程设计段完成**。**③专长侧联动已拆出独立成卡（2026-10-11 用户发令；同日用户纠正=奇物线单独成卡、秘宝面不并入）**：design/research/需求卡片-专长实装批-2026-10-11.md（T0-T10 ≈10-12d 单迭代交付；**Q1-Q3 已全裁清零**〔Q1 Boss 兑付换代/Q2 占位值/Q3 单迭代〕——**卡片成立，零待裁点，状态=已编入迭代 20（2026-10-11 用户令，待开工 U0）**；奇物侧设计+命名+裁定齐备〔奇物.md v3.15〕）——本条目余项（①②④⑤⑥⑦）维持冻结待发令，其中⑥效果引擎扩签核实与停手挂点由专长实装批 T1 先行承载。两条线交叉核对点一处随本批 T0：feats.tres 的 magic_vs_magic 条件值所属专长件是否在素材库表二 27 件删除名单内（若在，武器锻造实装批③「改值复活」随之作废）。 +**进展注记（2026-10-10）**：数据文件面本批不依赖武器锻造线；**槽位面依赖修正（2026-10-10 设计骨架批后）**——同调位数量与品质的语义已裁归天赋树同调位节点（树侧接线归天赋树线/天赋树实装批），本批与该批存在槽位定序点（先树后宝或合并评估，随排期裁），现役谓词表求值作为本批落地前的过渡基座仍成立；秘宝体系文档正确性检查已过（五文件交叉核对：仅 registry 三处现行旧称「魔法道具」残留，已随检查批修正；其余命中均为版本历史与更名记载的合法引述）——**检查通过；设计侧裁点经 grilling 审查轮+设计骨架批已清零（秘宝.md v2.3），按三段流程设计段完成**。**③专长侧联动已拆出独立成卡（2026-10-11 用户发令；同日用户纠正=奇物线单独成卡、秘宝面不并入）**：design/research/需求卡片-专长实装批-2026-10-11.md（T0-T10 ≈10-12d 单迭代交付；**Q1-Q3 已全裁清零**〔Q1 Boss 兑付换代/Q2 占位值/Q3 单迭代〕——**卡片成立，零待裁点；✅ 专长实装批已入库（2026-10-11 迭代 20 T0-T10 全落 master——③专长侧联动由该批承载销账：feats.tres 29 行换代/词表扩签/停手挂点 dig_stop 全落；mana_weaver 随旧 27 件退役入素材库表二→武器锻造实装批③「magic_vs_ward 改值复活」随之作废〔T0 交叉核对结论，与武器锻造裁决会话 D 组办结一致〕）**；奇物侧设计+命名+裁定齐备〔奇物.md v3.15〕）——本条目余项（①②④⑤⑥⑦）维持冻结待发令。 #### 效果引擎条件事实扩签——生命比例（背水实现前置需求）（2026-10-11 用户批登记） @@ -152,7 +152,7 @@ **归属**：[奇物](systems/冒险循环/奇物.md)「扩签登记」节（词表扩项现行事实源）+ 效果引擎（`game/core/effect_engine.gd` 条件事实词表修订随实装批） -**状态**：待办（冻结——迭代规划冻结覆盖，随专长实装批重启） +**状态**：✅ 已落地销号（2026-10-11 专长实装批 T1——hp_ratio 事实入 FACTS 词表〔百分比 int 口径〕，背水行 when hp_ratio lte 50 在役；effect_words_t1_test 钉面） #### 内部分类禁写入玩家可见面——奇物呈现三处违规待改（2026-10-04 用户立意登记） diff --git a/design/gdd/07-体验验证清单.md b/design/gdd/07-体验验证清单.md index b59c713e..ae9d4cac 100644 --- a/design/gdd/07-体验验证清单.md +++ b/design/gdd/07-体验验证清单.md @@ -6,6 +6,15 @@ ## 行为变化速览（体验前先读） +### 专长实装批追加（2026-10-11 迭代 20——实机目检项，登记面） + +- **Boss 专长三选一呈现**：非末关通关停点候选=全专长新 29 件（按档配比加权——普通打底/稀有稀缺）；旧「提升三选一」属性件不再出现于通关渠道；回血读数照旧随载荷。 +- **曝光槽三卡观感**：奖励节点/商店三选一=2 格全池+1 格优秀档以上子池（子池空回退全池）；新凭证四件（储备金袋/同调电池/时沙/完美保险）稀有档投放观感。 +- **卡面文案与稀有度档位显示**：新 29 件专长 display_name/desc 直读行字段（封印/陷阱风味系命名）；四级档位（普通/优秀/稀有/传说）在卡面档位显示位是否正确渲染。 +- **同调电池选件面**：拾取同调电池后的充能分配交互（choose_battery_target 核心面已落，呈现层选件窗=本批登记观测——若呈现缺窗，登记缺陷回反哺点）。 +- **HUD 特性段降级态**：流派聚合行退役后 C 区逐件行显示是否可读（呈现改法归 06 在册，本批不随批改）。 + + | 改动 | 旧行为 | 新行为 | 直接体感 | |---|---|---|---| | 硬化（敌方技） | 主角打硬化目标**翻倍**（符号 bug） | 主角攻击**折半** | Boss 战显著变长变难（预期内） | diff --git a/design/registry/entities.yaml b/design/registry/entities.yaml index 89fa26d1..5939fbd7 100644 --- a/design/registry/entities.yaml +++ b/design/registry/entities.yaml @@ -603,6 +603,7 @@ entities: boundary: 判据走生命周期——**一次冒险内获得、冒险收束即清零的是奇物；跨冒险跟着你走的是秘宝**。奇物永不进同调位，秘宝永不进当局随机渠道；与元进度天赋树两层互不代位 data_sources: feats.tres（专长定义行——效果声明=triggers 订阅行〔订阅哪个事件 on / 什么条件 when / 什么效果 do〕，旧挂点+效果字典形态 2026-10-06 内容数据驱动扩展批退役）/ adventure.tres（属性值提升与资源的种类配额与值）/ shop.tres（货架取舍） effect_declaration: **效果行为=事件订阅（2026-10-06 内容数据驱动扩展批换代）**——事件/效果类型/条件事实/算子四词表封闭于效果引擎 `game/core/effect_engine.gd`（事件 16 发射点 / 效果类型 24 / 条件事实 9 / 算子封闭；四词表出域=加载期校验致命）；组合规则六族（加法/乘法/任意真/按序改写/按序消耗/即时执行）为效果类型必填属性；遍历序=数据表声明序写死保种子复放；订阅重建=每战开始从持有集/装备集重建（中途获得下一战生效） + iter20_rebuild: **专长重设计换代（2026-10-11 专长实装批迭代 20）**——feats.tres 29 行（基础 27+迁入淬毒刃纹/封印爆裂，卡文 §10.4 口径）整表替换旧 27 件〔素材库表二〕；rarity 四级（普通 12/优秀 9/稀有 8/传说 0）直映射令牌档+cap 已拿上限字段；**流派标签/档位激活机制退役**（奇物.md v1「不设流派标签不设档位」——ARCHETYPES/FeatsEngine 档位质变摘除，charge 档二不可达缺陷随框架退役消解）；词表扩签=事件 18（+dig_stop/battle_won）/效果类型 30（+heal/ac_bonus/damage_reduce/bonus_delta/blast_scaled/preview_area/target_attack_bonus，rewrite_board 除名）/事实 18（+生命比例等 9）/算子 +mod_eq；池结构案D=四级档位 70/25/9/0=104+曝光槽 2+1+概率上限解耦（案②令牌池+提前退役 cap）+Boss 按档配比加权抽取；凭证五件入池（刷新券 F-1 修复/储备金袋/同调电池/时沙/完美保险）；adventure 域计数器跨战账本（domain 键+counters_export/seed） charge_defect: **charge 档二不可达登记（T7 奇物批迭代15②——数据缺陷留痕，白名单4授权「只登记不硬补」）**：feats.tres 现行 charge 标签仅 3 件（<4），档二激活要求同标签 ≥4 件——charge 流派永远达不到档二，即使获取次数无限。补哪几件系内容裁决，转独立内容批（硬补占位件已否决）；档二可达性复裁=第四关内容批落地后实测（C2 待裁点）。 pool_architecture: **池架构=总池-渠道子集（多级缓存形，用户 2026-10-05 裁 T6 时确立）**：总池=单一令牌库（TIER_QUOTAS 70/25/3=98 + 专长活行追加）；三渠道按分类白名单从总池取**子集视图**（关底 Boss 击败=只出专长子集；奖励节点/商店=属性值提升+资源子集，专长只以门票形态出现）——渠道不各建物理池，白名单在候选视图层生效（T4 过滤式）。配额挤占重裁：heal rare 5→3、refresh rare 0→2（方案B，总量 98 锚不变；用户裁「渠道从总量里拿子集」时同步裁）。 refresh_boundary: **刷新次数边界写死（T6 奇物批迭代15②——防后续混淆结算）**：「商店独立刷新机制」（shop_refresh_free/shop_refresh_cost_base/shop_refresh_cost_curve 三旋钮——进店后的免费次数+GP 付费刷新）系**商店自身服务**，作用对象=货架重抽；奇物 refresh 件（资源类成员，作为奇物授予的重抽次数）作用对象=**三选一界面**（兑付即 _attune_refresh_x 增量，X 余量=三选一重抽次数），不进加算区（§2.2 加算区四轴不含它）。两者不是一回事，禁止混算。 @@ -624,6 +625,7 @@ entities: ~~bonus_weight_*（E-S 加权洗牌权重族）~~ / ~~bonus_cap_*（种类次数上限族）~~：**v2.2 令牌池换代退役（迭代 12 TP0——2026-10-03 追认 b 实施批；洗牌改令牌 Fisher-Yates、池消耗即上限）** curio_quota_{kind}_{tier}: int [0,99]（**TP0 令牌配额族**——kind×tier 计数：attack 18/5 · max_hp 17/5 · armor 17/5 · gp 18/5 · heal 0/5 · ap 0/0/3〔common/rare/rarest〕；未列组合=0；档位结构锚 70/25/3=98 张入 schema validate 硬断言〔罕见档原列「道具件 2」随 aux_item 池种退役收窄——台账自决披露项〕） curio_value_attack_rare / curio_value_max_hp_rare / curio_value_armor_rare / curio_value_gp_rare: int [0,999]（稀有档大数值对——+2/+10/+2/50）；curio_value_heal_rare: int [0,999]（恢复件 +6 当即回血——新入池种类 rare 档）；MC 策略 316-f（autoplay 1 级最稀有/2 级最左）随批落地 + **迭代 20 换代（2026-10-11 专长实装批 T2/T4）**：TIERS 四级 common/excellent/rare/legendary（档名映射承袭——旧 rare→excellent、旧 rarest→rare，物理字段改名）；TIER_QUOTAS 70/25/9/0=104（T2 直映射 98+T4 凭证投放 6——rap 2/attune_battery 1/time_sand 2/perfect_insurance 1，provisional 归调参批）；CURIO_KINDS 7→11；curio_cap_* 每成员已拿上限字段（案②概率上限解耦——99=无上限占位）；boss_feat_weight Boss 三选一按档配比权重（100/45/15/5 provisional）；新旧字段映射注释随 schema 头注 transitional_sync_slots: int [0,9]（同调位过渡读数源，默认 1——道具持有上限；正主 = attunement_growth.tres 里程碑谓词表，同调实施批落地后切换读数源） mvp_content: 单行全局默认值即 MVP 行（provisional 归 曲线调参批——迭代 10 扩列批注） extension_reserve: 大奖励形态扩列位已消费（迭代 10 奖励重构批落地三选一/攻击型——本键使命完成退役；冒险结构 OQ2 收口） diff --git a/roadmap.md b/roadmap.md index dd06593a..d8714b51 100644 --- a/roadmap.md +++ b/roadmap.md @@ -75,7 +75,7 @@ | 迭代 18 | **⑤混编遭遇首批投放批（2026-10-06 用户令入迭代 18；纯内容批——机制前置=迭代 17 卡①敌人表行集多行批）**：07「后续内容批义务」落地——首个混编遭遇行+Boss 多行内容投放（敌种候选与坐标=本批裁点）；首遇教学位纪律与 expect_pools 断言面逐项复核（巨蜘蛛首遇位「固定 2 不加骰」等表注释为准）；难度带读数义务随批登记 07，MC 取证跑批**顺延 Alpha 收官 M4 数值批统一执行**〔未排期，届时另令——2026-10-06 用户令：数值统一调整殿后；投放本身不阻塞〕。需求卡片=`design/research/需求卡片-混编遭遇首批投放批-2026-10-07.md`（v1.0——纯内容批零代码，机制面全由卡①承载，机制缺口=L3 停机；裁点 P1 首批投放方案〔荐甲=L2 单点试水〕/P2 Boss 多行不入首批/P3 教学界保护待裁） | 迭代 17 卡①已入库（✅ 已满足 9cc4b8b）+**✅ 裁点全裁（P1-P4 甲，2026-10-07）**——开工=U0 | T0-T5≈1.75d（MC 取证顺延另计）——**✅ 已全批落表（2026-10-07，worktree g-plan2-iter18-mixenc 分支 iter18-mixenc 基点 adadf56，批内提交 ad36e35(T1 设计稿)/6272fc8(T3 落表)/43b1306(T4 断言)/⑤T5 收口批；出口报告=[iter18-mixenc-exit-report](design/qa/iter18-mixenc-exit-report-2026-10-07.md)）**：(2,5) 双行混编落表〔重击手+巨蜘蛛巢群（行值复制 (2,6)，P4 甲零数值新增），R6 行序=重击手在前〕；d5/d7 候选与行值来源全案留痕（d5 案选定）；断言面随迁（expect_pools 三元键新池模板+行集构成/行序/Σ≤4 断言）；首遇教学位 (2,4)/(3,0)/(3,1) 零触碰；07 ⑱ 目检与读数义务登记+:174 逐行骰措辞订正；闸=冒烟 814/0（基线 811/0，+3）+run_all+doc 三闸/熵增零新增（批末重闸数字见出口报告）；实机目检三项归用户（同场两敌种/行序/总数 ≤4）；MC 零跑（顺延 Alpha 收官 M4 数值批在案） | | 迭代 18 | **⑦新冒险种子随机化+调试浮窗升级（2026-10-07 用户令入迭代 18，同日两裁点全裁+浮窗目标态已定）**：**(a) 种子随机化**——现状考证 main.gd:1210 `_seed_value()` 调试种子框为空时硬编码返回 42=每次新冒险同一种子全程可复现；改法=玩家界面入口（主菜单开新冒险）默认分支随机生成；**✅ 裁点全裁（2026-10-07 用户令）：①首次冒险维持固定种子（教学态可复现）/②测试脚本与调试接口维持显式指定种子（冒烟·MC·探针全链显式传种子零影响，锚零作废）/③种子不进玩家 UI**；断点续玩零影响（存档已载 master_seed 回填，main.gd:447 现役）；与⑥收官批零耦合、排序自由。**(b) 调试浮窗升级**（承载「调试浮窗可查当局数据」裁点=种子的唯一查看位；**本项修订迭代 15 卡① P3 甲「仅开始菜单可开·对局不可达」裁决**）——目标态三件：独立于整体界面的**最高层浮窗**（对局中也可开）/DS_DEBUG=1 调试态下**默认打开**/新增**当局数据只读区块**（当前局种子/关卡/节点/HP/GP/钥石等——玩家 UI 不展示、调试浮窗可查）。考证在册（2026-10-07 实查）：现行=开始覆盖层角标入口〔main.gd:292-293，DS_DEBUG=1 点亮〕+main.gd:1189 门禁「仅开始菜单可开」+Dialog 形态走 ModalStack 模态栈登记〔非最高层〕+visible=false 初始非默认开+五区块（胜利演出/种子输入/数值滑条/批量模拟/两层调试）无当局数据面。需求卡片待裁点：最高层与模态栈登记制的关系〔置顶/登记序末+move_child 或独立层〕/输入吞噬边界〔浮窗矩形外透传游戏输入〕/对局发起「随开随收」逻辑改向/ui_tune_probe 断言面换代/入口形态（角标宿主迁移或热键）。需求卡片=`design/research/需求卡片-种子随机化与调试浮窗升级批-2026-10-07.md`（v1.0——实装级裁点 P1 遮挡语义〔荐甲=维持登记制〕/P2 入口形态〔荐甲=角标迁宿主〕/P3 默认打开范围〔荐甲=启动即开〕/P4 当局数据字段集〔荐甲=六项〕/P5 首局种子值〔荐甲=沿用 42〕待裁；估时勘误 1d→2.0d 含探针换代与收口） | **✅ 已落地（2026-10-07 worktree iter18-seed：C1 种子三分+浮窗升级 P1-P6 甲全落；批末重闸全绿=冒烟 811/0+四探针+run_all 17 套+doc 三闸/熵增闸零新增；MC 零跑；实机人闸挂账待用户〔不阻塞已入库与后续卡④〕）** | T0-T5≈2.0d | | 迭代 19 | **卡⓪主菜单开局缺陷修复批（原迭代 20 头卡A；2026-10-08 用户令并入本迭代、执行序第一）**：①**主菜单开新冒险+继续上局两入口补传同调三键**（attunement/attune_refresh_y/tree_rules——main.gd:510/:470，接收面 adventure_runner.gd:129-138/215-217 现成；静态考证缺陷成立：全仓无补偿路径、真实入口同调/X/Y 恒空、仅冒烟夹具喂值）；②**关卡开场行攻血改传当前生效值**（main.gd:519-521 现传初始表值，与战斗面板不一致=用户确认缺陷；「含面板加成」后缀判断同步改为认局外加成）；③冒烟补主菜单入口传参断言；④顺手删 adventure_runner.gd:129-134 三行重复赋值（零行为变化）。范围外=被动同调件呈现（用户令不动）、Fork 规则归因行（呈现层）、X/Y 刷新双源语义倒置（实现与用户口径镜像互换——X=刷新件源每节点重置不结转/Y=营地源整局持久/先扣 X，见 adventure_runner.gd:658-659/:706-709；用户口径=X 持久·Y 每节点重置·先扣 Y；真实局因①此前恒 0 未暴露——待用户裁定甲改实现/乙认现状，裁定落 GDD）。**卡①自动化验收补齐批（2026-10-07 用户令立项——全迭代两阶段验收盘点〔功能性+展示性，均自动化口径，不含人工目检〕的落地批）**：三件主内容——①**渲染闸自动化**：新增 `tools/render_gate.sh` 窗口化自动闸（shot_probe 四屏→shot_checker.py A-D 语义断言自动判定+fx_shot/board_shot 抓帧取证），棋盘 L1-L3 golden 逐像素基线入库 `game/tests/golden/`（测试资产入库先例，.gitignore 已核只挡 artwork/）；**probe_gate 头注释「渲染闸归真人目检」纪律句删除改写**（用户 2026-10-07 明示授权=历史偷懒标记），迭代 15③ 屏蔽挂账的机器补跑半随批核销〔07⑮ 目检半仍归用户不销号〕；②**探针收编**：ui_probe/ui_tune_probe/t17_defer_probe/fx_probe 四件游离探针（实测 17.4s/49.6s/63.0s/21.9s 全绿）收进 probe_gate `--full` 段挂重闸，轻闸默认段零改；damage_probe 出闸留盘标注诊断件、config_fatal_probe 删除（与 run_all 致命类单测重复）、零断言三件标注分析工具+ui_layout 补 1280/1920 最小断言；③**账务修正**：tests/README 套件数/断言数漂移（十五→17、752+→双口径说明）+integration 空目录处置（代拍板）。〔2026-10-07 范围改道：原「明示不收」的 B4/B5/B6 三缺口经用户令各立需求卡片并入本迭代，本卡改称卡①，新增卡②③④见后〕。需求卡片=`design/research/需求卡片-自动化验收补齐批-2026-10-07.md`（v1.1——**待裁点 0 项**，P1-P5+拷打轮一 Q1-Q8 全裁 2026-10-07〔重闸定义正式扩容 CLAUDE.md/过程截图即弃/shot_probe 扩屏三新屏/1280 单档/素材缺位 SKIP 而基线禁锚回退态/基线换代权限呈现批 agent/取证失败=闸红/integration 删空壳〕；🔴 契约 6 条含运行时代码零 diff/轻闸零删减/并行避让；停机点 S1 首跑存量 FAIL 全量呈报登记 06+S3 基线生成素材缺位停机；代拍板白名单四项）。**卡②旧界面呈现断言回补批（B5，2026-10-07 用户令立项）**：迭代 16 前落地旧屏追溯补 ui_contrast 测点对+ui_struct 契约——普查结论=对比度测点对旧屏 0 对（15 对现役全属 HUD/锚点/徽章/生涯）、专项契约仅 pause/career、legend/node 两屏从未过结构族；优先级=战斗结算框>商店>营地柜台+天赋树>设置面>三选一>迷雾锚定对；红线=只加断言零改旧屏、违例登记呈报不修（处置权归用户）；需求卡片=`design/research/需求卡片-旧界面呈现断言回补批-2026-10-07.md`（v1.1 grilling 三轮全裁——待裁点 0 项，WL 豁免边界/迷雾合成对最坏判据/时长闸 ≤2s/出口报告/06 遗留件登记全钉死；停机点 2〔对比度首跑存量违例/legend-node 结构首跑〕，T0-T4≈1.0d，worktree iter19-uibackfill）〔2026-10-08 施工已入库·**S1 停机态**——T1+T2 测点对 15→38 对（+23：battle_end 3/shop 5/camp 9/settings 2/curio 2/迷雾合成对 1，全 UiKit 常量实时求值）；**新对首跑暴露存量对比度违例 7 项**（结算 GP 账行 2.67:1/商店 legacy 行卡名 1.12:1/货架价签 1.46:1/营地铭牌副题 3.59:1/行价格 4.02:1/树分组头 2.67:1/工坊状态 3.00:1）——全量登记清单+修复建议案〔全现役常量换墨可落〕随出口报告呈用户裁，处置权归用户、批内零修（红线）；违例对在册=闸红登记存量形态，修复批落后自然转绿；T3 struct 13→15 根（legend/node 全真路径开合）首跑全绿 S2 未命中、WL 零新增；冒烟 840/0+run_all 17 套件持平；出口报告=`design/qa/iter19-uibackfill-exit-report-2026-10-08.md`；settlement_review 遗留件已在 06 登记落位〕。**卡③CI 预接线批（B6，2026-10-07 用户令立项）**：tests.yml 场景探针段解封——轻 CI 段=input/struct/contrast 三探针（示例引用的 ui_probe/ui_click 归 --full 重闸不进轻 CI）、Linux 独立命令形态（probe_gate.sh 系 Windows 专用）、窗口化四件禁入 headless CI；本地无远端端到端验证不可能=验收全静态核验，「首次 push 后人工盯首跑」入移交清单；远端仓库计划两文档零登记=待裁呈报项；需求卡片=`design/research/需求卡片-CI预接线批-2026-10-07.md`（v1.2——**触发分支死角已并入修正范围=tests.yml push/pull_request 两处 [main]→[master]**〔实查：实际分支 master、main 不存在，不修则远端建好后 CI 仍永不触发〕+冷检出导入步前置 smoke 步骤之前；裁点①远端仓库=✅ 2026-10-08 裁暂不建维持待命〔预接线待命=终态〕/裁点② ui_layout 入 CI 候卡①后裁；T0-T3≈0.25d，worktree iter19-ciwire）。**✅ 卡③已入库（2026-10-08，B6 闭环——出处=自动化验收补齐批 §一明示不收件，随本批销账）**：注释探针段解封=正式轻闸三探针段（input/struct/contrast，timeout 120s 外壳+退出码 124/137 超时判+PASS 串判定=probe_gate 判定逻辑 Linux 独立镜像，三探针全跑不短路汇总定红绿）+冷检出 `--import` 导入步 300s 前置冒烟之前（job 级基础设施步同覆盖冒烟与探针 .godot 依赖）+触发分支两处 [main]→[master] 修死角+头注释追加「远端仓库建好后无需改本文件即自动生效」；探针日志落 logs/probe_ci/ 顺现有 upload-artifact 段零改并入；验收全静态过（pyyaml 解析/CI 段 res:// 引用逐一实存/timeout 外壳清单齐/轻闸术语与 probe_gate 口径对齐/diff 面=tests.yml 单文件+roadmap 本行）；**⚠ S1 呈报项（该段冻结未代修，处置待用户裁）=tests.yml setup-godot 步 `nikeee/godot-actions/setup-godot@v2` 指向不存在仓库**（2026-10-08 实查：GitHub API 404+nikeee 全部 159 公共仓 grep godot 零命中+marketplace 同名件=Vitorgus/Setup-Godot v1 系 Godot3 旧件；现存活跃替代=chickensoft-games/setup-godot v2.4.3）——远端建好首跑前必须先裁此段，否则 smoke job 必红；首跑盯梢清单随需求卡片 §七 待远端立项之日激活。**卡④提灯载体道具批（B4，2026-10-07 用户令立项；原登记去向「Alpha 信息件重定批」就此改道入本迭代）**：board_view.set_fog_lantern 死接口（迭代 14⑤ 接线+case⑮ 断言在位，载体始终未造=完成度 0）补载体道具；备选案五件全列（案 A 秘宝同调位新行=原登记指向·推荐/案 B 专长新行·撞重设计冻结不推荐/案 C 商店货架·分类判据需新裁/案 D 显影尘行激活合并·与改道相逆/案 E 元进度树·破坏读数归因不推荐）+淘汰案六件各附依据，设计权全归用户；需求卡片=`design/research/需求卡片-提灯载体道具批-2026-10-07.md`（v1.2——**✅ 裁点全裁：2026-10-08 载体=案A秘宝同调位新行**〔行字段推荐值=执行中一次秒答，「按推荐」即全收〕；缺陷处置=卡⓪随同 goal 先行入库=本卡 T1 前置门〔缺陷实查定案影响全部开局入口；原记迭代 20 缺陷批，2026-10-08 并入本迭代为卡⓪〕；呈现桥=只读访问器/复原语义=begin_battle 显式重算/MC=静态论证/测试三形态等工程面全钉死，T0-T5≈2.5d，worktree iter19-lantern）。**✅ 卡④已入库（2026-10-08）**：T1=treasure_items.tres 表尾追加 fog_lantern「魔法提灯」行（行字段=用户「按推荐」全收——display_name 魔法提灯/desc 灯光区半径+2/id fog_lantern/slot_cost 1/稀有度不设字段/unlock_requires 键省略=已解锁；form=passive+triggers 显式空数组〔活行空 effect_kinds 豁免以 row.has(triggers) 为条件〕+effect_kinds=[]/target=none/magnitude=0/use_phase=active_dig/dimension_tags=[info]；表尾追加保 MC 自动档装配画像逐位不变=零漂移）；T2=接线生产路径贯通——orchestrator 装配集公共只读出口 attune_has（_attune_has 契约化）+组合根呈现桥 main._sync_fog_lantern 挂每战首轮装配链显式重算含否（round_started 首轮发射位在 begin_battle 尾 attunement 注入后=时序安全；board_changed 先发后注入故不挂）；T3=测试三形态（case⑮ 内载体级段不开新 case+smoke 现有套件加断言〔冒烟 840→844〕+存档回归 breakpoint Part 6+新单测 fog_lantern_wiring〔run_all 17→18 套〕，case⑮ 既有断言零删减）；T4=改道指路句实查六处全换代（board_view.gd :139/:145+art-bible.md:387〔顺手对齐常量实名 FOG_LANTERN_BONUS〕+HUD框架.md :168/:170〔:170 同句 2 处整段换代〕；qa 历史成文零触碰）+06 缺陷条已入库回写+秘宝.md 目录九件→十件（v1.1 行）；T5=重闸三件全绿（冒烟 844/0+probe_gate 含 --click 全绿+run_all 18 套，残留 Godot=0）；MC=静态论证零实跑（纯呈现层 off 态零生产路径变化）。出口报告=design/qa/iter19-lantern-exit-report-2026-10-08.md | 迭代 18 出口（✅ 已解——2026-10-07 四卡总收口已入库）——**开工=goal 一次跑完（2026-10-08 裁：卡⓪缺陷卡先行+卡①-④打包，全绿前禁停；subagent 并发 ≤3；唯一预期交互=卡④行字段推荐值秒答；卡⓪原迭代 20 头卡A 同日用户令并入本迭代）** | 卡⓪≈1.0-1.5d（随计划书定稿）+卡①T0-T6≈4.25d（超软盒预挂；天然切分点 T2 末——段一 T0-T2 渲染闸≈2.25d / 段二 T3-T6 收编退役账务≈2d，两段同属一迭代一次合并）+卡②T0-T4≈1.0d+卡③T0-T3≈0.25d+卡④T0-T5≈2.5-3.0d（切分点 S0：考证呈报 0.25d/实装收口 2.25-2.75d）——五卡合计≈9.0-10.0d | -| 迭代 20 | **专长实装批（奇物）**——需求卡片=design/research/需求卡片-专长实装批-2026-10-11.md（零待裁点已成立）；**2026-10-11 用户令编入**（=规划冻结的直接发令解锁，仅解迭代 20；21/22 冻结维持）。范围：T0-T10（效果引擎词表扩签/池结构案D 实装/专长 27 件换代/凭证五件/Boss 兑付换代〔已裁换代〕/状态账/断点扩容/MC 新基线/迁出行删除/空配置验收闸）；估时 ≈10-12d；内部 A/B/C 三段推进+段末汇报。候选 B-F 留档不变 | 需求卡片成文（Q1-Q3 全裁清零） | T0-T10 | +| 迭代 20 | **专长实装批（奇物）**——需求卡片=design/research/需求卡片-专长实装批-2026-10-11.md（v1.1）。范围：T0-T10（效果引擎词表扩签/池结构案D 实装/专长 27 件换代/凭证五件/Boss 兑付换代〔已裁换代〕/状态账/断点扩容/MC 新基线/迁出行删除/空配置验收闸）。候选 B-F 留档不变。**✅ 已入库（2026-10-11 goal 会话 U0 开工——A/B/C 三段 T0-T10 全落 master：T1 词表扩签 a57489e/T2 案D 池 0640b0c/T3 29 行换代 54ab330/T4 凭证五件 1387aed/V4 补齐 5ebd05d/C 段收尾 3333187；冒烟 864/0+run_all 21 套+MC 同种子重放逐位复现；29 行件数口径+四级配额 104+疼痛记忆同战消费放宽+时沙/弃图兑换落法映射系代拍板追认单待用户）** | ✅ 已入库（出口闸全绿+实机目检归用户 07 在册） | T0-T10 ✅ | | 迭代 21 | **天赋树实装批（2026-10-11 用户令编入——整卡不切分，迭代容量放宽容纳全卡）**：按 [天赋树](design/gdd/systems/跨局循环/天赋树.md) v0.4 设计权威文档实装——29 节点结构换代（schema 等级阈值前置新形态/Fork 词表 4→3 组/规则键词表 2→6 键）+三组 Fork 真效果（开局姿态每关首轮窗/危险直觉与财富之道·限次计数随冒险持久按关重置）+营地统一案甲（树=营地主界面/属性升级唯一入口/工作间钥匙模型/图鉴常开/占位面板零副作用硬要求）+注入公式换代（基础值+树淬炼+锻造路线加值位预留+局内加算）+旧属性柜台退役+旧档废弃与旧逻辑删除（开发阶段无迁移，Q3 裁决）+同调位槽位判定源切树节点（旧条件删除随批清扫）+树上刷新升级接线（双入口并存写同账）。需求卡片=design/research/需求卡片-天赋树实装批-2026-10-11.md（v1.1，grilling 五裁+歧义扫描六裁全落，零开放待裁点成立）；并行在外=武器锻造 17 裁点会话（不阻塞，Q5 默认本批先行）；T0 含标错机制存在性实查（查无则守侧换案经用户裁） | 卡片成立（2026-10-11 用户令编入） | T0-T7≈7.0-8.5d（整卡单迭代） | | 迭代 22 | **秘宝体系实现重构落地批**——需求卡片=design/research/需求卡片-秘宝体系实现重构落地批-2026-10-11.md（v1.2 零待裁点已成立）；**2026-10-11 用户令编入**：新目录 12 件实装+解锁混合制（逐件分配锁定表在卡）+装配不可变（冒险中零更换）+旧 14 行数据清理+效果引擎接入；槽位来源不在本批（树接口接缝、无槽位不能带、测试走调试注入——C4 裁）；估时 6d（区间 5-7d）；开工门=U0 | 迭代 23+ | **M4 数值批（**原 22+；迭代 21 已编入天赋树实装批、迭代 22 已编入秘宝实装批，均 2026-10-11 用户令**——**Alpha 收官位·未排期**〔2026-10-09 语义换代：M4=Beta 阶段、非 Alpha 收官位，M3 未由用户明令关闭前不排期维持〕——2026-10-05 用户令编入迭代 17 卡②；2026-10-06 用户令移出独立成批并定序「Alpha 阶段最后——内容补全先行、统一数值调整殿后」〔当日曾被编入迭代 18 为收官卡，2026-10-07 用户令撤回〕；**2026-10-07 用户令二次后移：后续新迭代（迭代 20 起）一律不先做 M4，除非用户明确要求启动 M4 批次**）**：四件数值欠账合一批——①削弱档位终值（weaken 现值 −65/duration 2/refresh 考证在册；叠层改续时语义已定案，差 duration 终值+当量锚复算）②调参批数值点评（06 条目现行登记五条——任务口径「八条」与条目五条不符，需求卡片 §2.2 已呈报差异以条目为准）③迭代 10 奖励重构联动欠账①②（钥石产出重标 boss_keystone 首杀 3/3/3·复杀 2/2/3 provisional + 通关率带重扫〔通关回血 20%+AP 件首轮 +1〕）④元进度定价剩余面（forge base 20/比 150 考证在册——06 条目文本「base 10」滞后于 2026-09-22 对齿批已呈报；Boss 两档终值）。读数义务随批=迭代 14 两件后置复算（T6 MC 四带复算+T7 技能池节奏重测，均挂 07）；顺路修复 damage_probe A1 改前既有红灯（判式换代批出口报告 §四.7 在册）。**硬约束：一切 MC/verifier 跑批发起前须用户批准；调参联动禁独立调参网络（β 带 [1.2,2.5] 逐 u 检算）**。需求卡片=`design/research/需求卡片-M4数值批-2026-10-05.md`（**v1.2 2026-10-06 案C 增补+联审修订**：v1.1 三事实与第五推算件照旧；联审=P3 转正顺延至重扫读数后/检算工具 WEAKEN_PCT 入同步面/F11 两句死文本全刷/T3·T5 四带复算并账一次跑批双认账/R5 改前锚=本批新立案C 锚/估时段一勘误 4.25d；案C 增补内容照旧=§2.6 三事实〔行为换代/锚全作废/难度预判〕+T0 推算稿第五件=对拍锚按新序重推导+T6 四带复算按案C 新行为首采；T0-T8≈6.25d，天然切分点 T4 末；🔴 契约 5 条含跑批批准制；**✅ 裁点全裁（2026-10-06 用户令：P1甲=维持 2 场·magnitude [60,85] 带内当量锚复算、具体值随出口 provisional 追认/P2甲 不对称有意/P3甲 3-3-3·2-2-3 维持、转正顺延至重扫读数到账且带内（Q4 二裁）/P4甲 不立直购价）；开工=U0**） | 迭代 18 全部内容卡（③④⑤⑦）出口+全部内容批行为变更落定+**用户发令（未排期）**——重锚窗口须收尽全部内容批行为变更 | T0-T8≈6.25d（超软盒预挂，段一 T0-T4≈4.25d〔v1.2 勘误，原 4.5 系加总错误〕/段二 T5-T8≈2.0d） |