T7(迭代22秘宝批): 文档同步闸——registry三代目换代注记(aux_items迭代22批/attunement_growth表删史注/attunement_slots树点亮+档位格/save域boss_kill_count语义换代+vision_used新域)+06秘宝条已入库状态+07㉑秘宝解锁-装配正常流程观测项+roadmap迭代22行✅+实现报告(代拍板追认单十五条/GDD反哺点七条/实机目检=07㉑/闸读数/余项去向)

This commit is contained in:
DKChan committed 2026-10-12 19:45:28 +08:00
1 parent f7cee4b581
commit 44fee05b14
5 files changed
+82 -4

No files matched your search

@@ -0,0 +1,67 @@
# 迭代 22 实现报告——秘宝体系实现重构落地批(2026-10-12)
> 执行:/goal+iter 技能 U0 开工令,单会话交付(worktree g-plan2-iter22-treasure,分支 iter22-treasure,基点 5a2ab8c)。
> 需求卡片:design/research/需求卡片-秘宝体系实现重构落地批-2026-10-11.md(v1.3,C1-C6 全裁,零阻塞待裁点)。
> 设计权威:秘宝.md v2.9「目录(重设计 v1)」。
## 一、各任务卡交付状态
| 卡 | 交付 | 提交 |
|---|---|---|
| T0 | 基线复读(冒烟 886/0+run_all 22 套+probe --click 全绿)+四项核实(X/Y 对表/magic_vs_magic 结案/扩签清单/真视计数接入点)+自洽扫描四处事实换代登记(卡片 F1/F2/F4 预设被迭代 20/21 推进) | (active.md 状态记录 477) |
| T1 | treasure_items.tres 新 12 行全量换代(旧 12 行删)+schema 换代(tier/charge_reset/unlock_keystone_cost 三键+TIERS/TIER_RANK/CHARGE_RESETS 词表+TARGETS 扩 cell+参数面 kind 六型+REVEAL_KINDS 护栏扩面+charges=0 积点制+解锁互斥校验+UNLOCK_COUNTER_KEYS 换代)+引擎扩签(EVENTS+board_installed/ACTIVE_KINDS+safe_dig/EFFECT_KINDS+mine_count_preview)+V13 旧断言摘除换代 | T1 提交 |
| T2 | 解锁服务换代(buy_treasure_unlock/refresh_treasure_unlocks/treasure_shop_status/_treasure_unlock_progress 单点)+工坊渠道面退役(行族/词表/三函数/访问器全删)+vision_used 生涯计数域(补零不升版本)+toggle_attunement 三重校验(未解锁拒+满位禁选+件档 rank≤装入位序)+秘宝匣呈现数据管道换代 | a7bd4e4 |
| T3 | board_installed 发射+巢穴预告读数口/天眼 safe_dig=fx_reveal 通道复用(C5 全额兑付免 AP)/reveal_tiles 入真视叠加层/试炼镐 use_attune_convert 积点受理口+计数通用化/充能重置周期 _reseed_attune_charges(battle/level)/常时参数面注入(挖距/旗可达/转存率/刷新加仓/商店刷新)/vision 计数链(共享 dict→summary→settle 入档+断点随件)/validate_use 扩 cell+新空间 kind/修现役潜伏缺陷(use_treasure 板维度读不存在的 Rules.width)+新单测 treasure_effects_test(V7 附属表 12 件逐件正常/边界/反例) | T3 提交 |
| T4 | 秘宝匣柜台购买钮+分档呈现+档位标签+未解锁禁装/呈现桥换代(旧提灯布尔桥退役→set_fog_glow_bonus 参数面,main._sync_treasure_glow)/巢穴预告 toast/试炼镐 HUD 兑换钮(ap_bar+board_zone 转发链)/ui_input_probe case⑮ 换代主语+4/V13 功能残留换代/修 BoardZoneView 缺 convert_pressed 转发(呈现组装挂死根因) | b7a2ead |
| T5 | 替换子交互整体拆除(装配不可变契约 1 死通道:core 六函数+_bonus_treasure_carry 携带+_last_draw_treasure 掷定链+bonus_aux_carry 断点键+grant_treasure_item+holding_records+呈现三态+overlay replace 状态机+探针/autoplay 策略)/treasure_inventory 保留注记(主动件骑库存承载在役)/apply_node_curio 普通兑付主体误删补回 | 7095505(amend 后) |
| T6 | 验收闸断言(V9 词表零改写/V10 三方向覆盖/V18 空目录合法态/V6 装配不可变三面同源快照)+批末重闸全绿+ui_probe 柜台行数断言换代(6→12) | T6 两提交 |
## 二、代拍板追认单(十五条,待用户逐条追认)
1. **回补点 1 执行**:按设计权威 12 件全量落地,刷新练习归钥石购买(C1「普通档全钥石」直接应用)——卡片推荐案。
2. **回补点 2 消解**:迭代 20 已删 venom_edge/flag_burst,本批实删 12 行(非 14)。
3. **回补点 3 执行形态**:treasure_inventory **部分拆除+保留注记**——拆除=替换子交互死通道全清(装配不可变实现面保证);保留=库存类本体(新目录主动件线香/天眼的骑库存承载在役:handle 注入+use_treasure 受理+断点 aux_items 快照)。卡片「拆除或保留注记」双路线并写的第三形态,理由=T3 复用现役机制零新建。
4. **试炼镐两级积点单级化**:设计「每开 4 安全格积 1 点、满 2 点换 AP+1」→ 实现=ap_charge_safe charge_n=8 滑耗(行为等价:每 8 格兑 1 AP,免上限滑动消耗)——代拍板白名单「订阅行等价实现细节」;desc 保留设计原文两级表述。
5. **试炼镐受理口与入口**:绕库存直呼 use_attune_convert(charges=0 零骑库存)+HUD 行动条兑换钮(ap_bar convert_pressed 转发链,未装配隐藏、积点未达禁用、文案含进度 N/M)——卡片未列明入口形态,本批落 HUD 最小入口。
6. **解锁条件表落位**:卡片 T1「attunement_growth.tres 改造为解锁条件表」——该表已被迭代 21 删除,落位改为 treasure_items 行内 unlock_requires(单一事实源,schema 校验单点)。
7. **计数键换代**:UNLOCK_COUNTER_KEYS 旧键 clear_count(旧工坊按关累计语义)与 C6 通关口径不符,换名 adventure_cleared(生涯通关局数)+扩 vision_used——旧键零行消费安全换名。
8. **vision_used 承载**:save v6 meta 域补零新键(不升版本,迭代 21 先例)+断点随件 vision_counter_used;计数点=use_treasure 受理成功(真视类 kind),冒险共享 dict 聚合、收束 add_vision_used 入档。
9. **呈现桥换代**:旧提灯布尔桥(set_fog_lantern/FOG_LANTERN_BONUS)随行退役,换代 set_fog_glow_bonus 参数面(阔视野带 magnitude 4→半径 8+4);off 态写 0 复原契约保持。
10. **巢穴预告呈现**:开局 toast「巢穴预告——本板危险格共 N 个」(读数口 nest_preview_count);不走结算明细行(行来源纪律——无格来源)。
11. **积点兑换零明细行**:对齐 use_treasure「效果即时可见零明细行」纪律,兑付反馈=AP 条即时刷新。
12. **价格 provisional 占位**:普通档 10 钥石/优秀档 25 钥石(稀有档全条件无价)——调参批终值。
13. **magic_vs_magic 结案维持**:行已随迭代 20 删除(grep 零命中),锻造工坊实装批③「改值复活」作废(06 已核结)。
14. **reward_dangling_treasure_test 保留**:悬空引用拦截机制在役,注入主语=故意悬空旧 id(fixture 本体非旧件验证)——V13「随行清亡」指注入行,机制测试保留。
15. **过程修正**:T5 提交误入拷贝嵌套素材(assets/ui/ui/ 9 png)已 amend 剔除,终态零素材变更。
## 三、GDD 反哺点(实现与设计权威差异——待用户逐点裁决后另批落文,本批零直改 GDD)
1. **秘宝.md「目录(重设计 v1)」节**:逐件表补实录列(item_id/tier/解锁方式与价格或条件/参数 kind);「实装批落地前表内旧目录同调行冻结维持」「受理框架为新目录主动件沿用——现役代码按同框架运行」两处现状句已过期须换代;旧目录退役指针节补「代码旧行已删(2026-10-12)」。
2. **秘宝.md 代价轴**:试炼镐两级积点结构→单级 8 格滑耗等价实现注记(若用户裁保两级呈现,改 desc 与 HUD 进度文案即可,机制不动)。
3. **秘宝.md 解锁混合制节**:解锁条件表实录(三计数键+阈值 provisional:远程镐 1/刷新执照 3/天眼 3+4/信标网络 10;价格 10/25)。
4. **元进度.md**:道具工坊→秘宝匣换代实录(工坊渠道面退役、购买钮、条件进度呈现、treasure_shop_status 投影);「forge base 20/比 150」等工坊史句核对。
5. **camp.md**:秘宝匣柜台呈现细则(购买钮禁用态/名后缀·档位/装配行档位标签/未解锁禁装/悬停 desc/空目录合法态);暂停层秘宝匣 12 行只读概览。
6. **存档序列化.md**:vision_used 域+vision_counter_used 断点随件+bonus_aux_carry 键退役(v6 不变零迁移口径复核)。
7. **行动经济.md**:finish_round_stop 转存率参数化(transfer_pct 缺省 100 逐位同旧;储备罐 125=1.25:1 整除 floor 口径)。
## 四、实机目检清单(唯一人闸)
07-体验验证清单 ㉑「秘宝解锁-装配正常流程体验」(本批随批登记):解锁面/装配面/生效面抽查/装配不可变四组——验证人=用户。
## 五、闸读数(批末全绿)
- 冒烟 898/0(基线 886→898:V1/V2/V3/V4/V5/V9/V10/V18 断言净增,V13 摘除同步)
- run_all 22 套全绿(含新套件 treasure_effects_test)
- probe_gate --click/--full 全绿(ui_probe 柜台行数断言换代后);残留 Godot=0
- render_gate 全绿(golden 3 屏 0.00%)
- doc 三闸对主区基线零新增(死链 3/拔旗 1 均存量);熵增闸 PASS
- MC 零跑(本批零随机无概率面——卡片 7.1 备用项未触发)
## 六、卡片余项去向
- ①新目录实装 ②旧数据行清理:本批 T1-T5 全量交付销号。
- ③专长侧联动:迭代 20 已承载销账(06 进展注记在案)。
- ④空配置验收闸:装配面本批 V18 交付;池空兜底/商店空货架归奇物/商店侧另批(卡片 §4 去向不变)。
- ⑤池结构选型/配额数字:奇物侧另批(卡片 §4 去向不变)。
- ⑥效果引擎扩签核实:本批 T0 清单+T3 落地(board_installed/safe_dig/mine_count_preview/参数面六 kind)。
- ⑦两疑似漏项:T0 核实结案——件级跨事件状态账=counter domain=adventure 承载(试炼镐积点);参数注入面=六常时参数 kind 注入点全落(_adjacent_to_hero 两分支/finish_round_stop/shop_refresh_free_left/set_fog_glow_bonus/_refresh_stock)。