Merge branch 'master' into iter23-forge-20261012

# Conflicts: # design/gdd/systems/表现与支撑/存档序列化.md
2026-10-13 01:34:15 +08:00
commit 3392ea7e2d
@@ -79,7 +79,7 @@

 ### 停手与储备行动点

-停手是玩家在挖掘期任意时刻的主动决定：立即结束本轮，剩余行动点按 1:1 原值存入储备池——没有乘数、没有加成。图没开完，下一轮接着在同一张图上挖。停手不是收入来源，而是纯粹的风险管理工具：它买到的是"退出权"，不是战斗收益。停手意图经排雷玩法的批次提交入口进入账本（保证单一结算序），由账本仲裁后自行外发轮次结束消息。
+停手是玩家在挖掘期任意时刻的主动决定：立即结束本轮，剩余行动点按 1:1 原值存入储备池——基线没有乘数、没有加成。图没开完，下一轮接着在同一张图上挖。停手不是收入来源，而是纯粹的风险管理工具：它买到的是"退出权"，不是战斗收益。停手意图经排雷玩法的批次提交入口进入账本（保证单一结算序），由账本仲裁后自行外发轮次结束消息。**转存率参数化（迭代 22 秘宝批反哺落文，2026-10-12）**：转存率实现为 `finish_round_stop(transfer_pct)` 参数面——缺省 100=1:1 与旧口径逐位一致；秘宝「储备罐」注入 125=1.25:1（整数除法向下取整——每 4 点剩余 AP 多转 1 点 RAP，零头顺延向下）；无装配时行为与参数化前逐位相同。转存率归秘宝操作包络参数，本账本的仲裁与发射结构不变。

 储备池的生命周期以一场战斗为界：战斗内跨轮次、跨雷图一直累积；战斗结束立刻清零。清零必须在界面上可见，防止玩家觉得"攒的钱凭空没了"。MVP 阶段储备池没有上限。

@@ -267,6 +267,7 @@
 | v0.2 | 2026-09-16 | AP 压速批文档面值同步（用户拍板 8→6，削标旗 rush 单轮兑付吞吐为无伤通关根因的主阀门）：ap_per_round 与 rap_refresh_cost 现行值 8→6，随动保持"满预算停手 = 恰好一刷"耦合；数据表与 registry 已同批改，本批补文档面正文两处与调参表两行 |
 | v0.3 | 2026-09-17 | 数值纪律收口批：正文与调参表 knob 现行值改指路存根（事实源 data/tables/*.tres 与 registry），0 处失同步修正——价目改「统一价目 / 标准价（见 action_economy.tres）」口径，每轮点数与刷新门槛改表值指路；调参表「现行值」列整列指路化；注记 refresh_cap_per_round 与表字段 refresh_max_per_round 命名不一致（字段名对齐待批）。顺带：P0 闭环「扣 1 点」改「按价扣费」；终扫补两处漏网——巢穴约束例句「每轮花 2 点重插」改「重复计费重插」、P0 闭环「每轮至多 2 次」改刷新上限读表 |
 | v0.4 | 2026-09-19 | 插旗不可逆批（用户拍板全套落地）：拔旗动作退役——设计目的/统一价目/价目表/布尔入口清单/P0 闭环/调参表六处删"拔旗"，flag_pull_ap_cost 字段随 schema 与 data 表同批删除；插旗行补"旗 = 一次性承诺、纠错 = 直接挖开"口径 |
+| v0.12 | 2026-10-12 | **迭代 22 反哺落文批（实现报告 §三⑦，用户裁「落文」）**：「停手与储备行动点」节补转存率参数化注记——`finish_round_stop(transfer_pct)` 缺省 100=1:1 逐位同旧；秘宝「储备罐」注入 125=1.25:1（整数除法向下取整，每 4 点剩余 AP 多转 1）。机制结构零改动（参数面已随迭代 22 T3 在役） |
 | v0.5 | 2026-09-20 | **格面资源八型批同步（用户拍板——与敌人系统 / 战斗结算 / 地图战斗资源 / registry / 切片代码同批）**：① F1 条款 3 改写——原"敌方伏击暴露不等式"随伏击机制退役作废，惩罚当量对账模型归难度曲线与Boss 调参批重立；② 新增「下轮行动点修正」节——action 型格面资源经 queue_ap_delta 排队、下一轮开始兑现（基线 ap_per_round + 净值、下限 0、兑现后清零），跨轮携带量口径改写（RAP 唯一显式携带资源 + 一次性修正队列）；③ 节拍不变式（满停一轮 = 恰好一刷）补扰动注记 |
 | v0.6 | 2026-10-01 | **失同步清偿 + 跨冒险行动点加成轴节（迭代 10 奖励重构批——与冒险结构 / registry 同批）**：①失同步欠账清偿——ap_per_round 真实配置 = **8**（action_economy.tres，Package B 2026-09-22 批 6→8 回调，表内批注在案）；v0.2 批 8→6 系最后一次文档面记录，此后配置面单独回调未回写本文，本批补记（rap_refresh_cost 与 ap_per_round 的「满预算停手 = 恰好一刷」节拍耦合以现行 8/8 维持）；②新增「跨冒险行动点加成轴」节——统一冒险加算区扩第四轴（行动点），经战斗开始入参覆盖值通道、只在每场战斗开轮首轮兑现一次；价值锚 = 冒险表 bonus_ap_flat / bonus_cap_ap（迭代 10 三选一 AP 件，全冒险 2 次上限），调参表补跨表行 |
 | v0.7 | 2026-10-03 | **两 AP 件兑现通道注记（迭代 11 第①批同调实施批——需求卡片 §十连带）**：同调目录两 AP 件兑现通道落位——①工兵晨令（被动·限时）=战斗开始首轮 queue_ap_delta 入队 + 轮始段续队（前 effective_rounds 轮每轮 +1，表值化 P4 甲），复用「跨冒险行动点加成轴」同族排队通道；②掘进蓄能（主动·充能）=grant_ap 当轮加量（同挖掘期 ap_grant 通道），受理闸=战斗域安全开格积点（charge_n 格/点）；账本零新机制（queue_ap_delta/grant_ap 两既有原语），充能扣减经共享账本（attune_charges）同引用直改 |
@@ -99,12 +99,13 @@ SaveManager 不依赖任何玩法系统就能工作：它是被动的承载方
 | `recent_summaries` | 最近冒险摘要副本，最新在前，最多 10 条 | [冒险结构](../冒险循环/冒险结构.md) |
 | `first_adventure_done` | 首冒险完成标记（新档默认 false；旧档缺省按已完成兜底） | [元进度](../跨局循环/元进度.md) |
 | `adventure_total` | 冒险总局数终身计数（开局即计、含放弃与失败，v6） | [生涯](../跨局循环/生涯.md) |
-| `adventure_cleared` | 通关局数终身计数（三关全通才计 1，v6） | [生涯](../跨局循环/生涯.md) |
+| `adventure_cleared` | 通关局数终身计数（三关全通才计 1，v6；秘宝条件解锁计数键） | [生涯](../跨局循环/生涯.md) |
+| `vision_used` | 真视类工具累计使用次数终身计数（迭代 22 新增——信标网络解锁行为条件；**v6 域后扩列补零、不升版本**；写入唯一经 `add_vision_used`，冒险收束聚合入账；断点随件键=`vision_counter_used`，续玩回填缺省 0） | [秘宝](../跨局循环/秘宝.md) |
 | ~~`forge_levels`~~ | ~~属性锻造三档等级~~ | **已退役**（迭代 21 T5：行族/访问器/域随攻防所有权切分删除——`save_manager.gd:12-14/:399-401` 白名单收口；继任 = 锻造工坊路线等级域，见下行计划登记） |
 | `forge_routes`（**已落地 v7——锻造工坊实装批 T5，迭代 23**） | {levels: 六路线等级（sword/spear/staff/light/heavy/ward）, unlocked: 直购解锁路线 id 清单, weapon: 当前武器路线 id, armor: 当前甲路线 id}；无特效域；旧档缺键补齐 = 初始持有态 | [锻造工坊](../跨局循环/锻造工坊.md) |
 | `breakpoint` | 冒险断点快照（停点粒度续玩域；空字典 = 无断点合法态——「继续上局」隐藏） | [冒险结构](../冒险循环/冒险结构.md) |

-v4/v5/v6 各域缺键由读取方按默认值补齐（空集合/0），旧档零迁移损失；收束自增域（通关次数/Boss 计数/终身计数）的唯一入账点 = `apply_adventure_summary`。
+v4/v5/v6 各域缺键由读取方按默认值补齐（空集合/0），旧档零迁移损失；收束自增域（通关次数/Boss 计数/终身计数/真视使用计数）的唯一入账点 = `apply_adventure_summary`（vision_used 走 `add_vision_used` 收束）。**v6 域后扩列不升版先例**：`vision_used`（迭代 22，2026-10-12——迭代 21 同款口径；断点随件 `vision_counter_used` 同批新增；旧断点随件键 `bonus_aux_carry` 已随替换子交互拆除退役，迭代 22 T5）。

 消费面纪律：其他系统只经 SaveManager 的类型化访问器（读余额/加钥石/花钥石、读写树等级等）与域更新原语（`apply_adventure_summary`）操作存档，不碰内部数据结构。

@@ -192,4 +193,5 @@ MVP 不要求本系统的闭环（[不做清单](../../05-不做清单.md)把单
 | v1.3 | 2026-10-01 | **版本兼容口径批（迭代 10 追加批 g 裁——用户拍板：版本兼容对齐 semantic version 标准）**：①版本策略成文口径——本域版本号语义 = **向后兼容的次序版本**：升版只允许「旧档在新代码可读可玩可续玩」（缺新键=合法空态、内容零丢失、断点可续），禁「新档在旧代码可读」承诺（向前兼容不做）；②v2→v3 迁移体=空迁移（断点附随件扩列〔bonus_taken/bonus_pending/bonus_result/bonus_aux_carry/keystone_drops + bonus.ap 轴〕与摘要 additive 键 keystone_drops 均由读取方 .get 兜底——兼容性由冒烟 v1→v3 与 v2→v3 断点续玩断言承载，2026-10-01 增）；③中断节点兼容义务：每升版必须在冒烟断言「旧版断点→新版续玩受理」（现行三档 v1/v2/v3 齐） |
 | v1.4 | 2026-10-09 | **文档正确性审查批·独立复核（worktree docaudit-2026-10-09——版本滞后四代换代，全部代码实证 save_manager.gd SAVE_FORMAT_VERSION=6）**：①数据模型 JSON 与域清单表换代 v2→v6——补 v4 同调三域（boss_kill_count/attunement_equipped/attune_refresh_level，迭代 11①）、v5 树域（tree_nodes/fork_sides，迭代 12）、v6 生涯两终身计数域（adventure_total/adventure_cleared，迭代 18 卡④）逐域 owner 行；②版本与迁移节换代——当前=6、迁移链五件（v1→v2…v5→v6，含 v4→v5 三体系迁移指路天赋树）；③调参表版本常量 2→6；④缺键补齐纪律句补记（读取方默认补零/空集合，收束自增唯一入账=apply_adventure_summary）。注：v3/v4/v5/v6 四次升版当时均未回写本文，本批一次性清偿 |
 | v1.5 | 2026-10-12 | **锻造工坊完备性检查批随迁（用户令：新加内容现在补、不等实装批）**：①**预登记锻造路线域**（计划 v7）：域清单表 + 版本沿革补 `forge_routes`（三武器等级+三甲等级+当前选中标记、无特效域、旧档破坏性废弃归锻造工坊实装批；域名以实装批定名为准）；②**清偿 forge_levels 残留**——JSON 示例、域清单表删该域（代码侧已随迭代 21 T5 删除：`save_manager.gd:12-14/:399-401` 白名单收口）；迁移链 v4→v5 的「三体系迁移」体改述为已删除（`save_manager.gd:96-98`、`meta_progression.gd:294-295`）；③**补登两漏域**（代码实证 `save_manager.gd:119-139`）：`tree_struct`（树结构版本标记，迭代 21 T5，缺失=换代前结构加载废弃重置，owner 天赋树）、`first_adventure_done`（首冒险完成标记，新档默认 false、旧档缺省按已完成兜底，`meta_progression.gd:100` 置位，owner 元进度）；④消费面纪律句「读写锻造等级」→「读写树等级」（访问器已随行族退役删除）。版本号常量仍 =6（v7 未落地） |
-| v1.6 | 2026-10-12 | **锻造工坊实装批随迁（迭代 23 T5——v7 落地）**：①域清单表 `forge_routes` 计划行→实际落地态（{levels 六路线等级 + unlocked 直购解锁清单 + weapon/armor 当前选中标记}，域内键名以实装批定名）；②版本与迁移节——当前 =7、迁移链补 v6→v7（空迁移=缺键补齐模式，解锁态派生不落档三通道）；③旧档口径订正——「破坏性废弃」→「缺键补齐 = 初始持有态」（开发阶段禁迁移禁折算纪律不变，契约 4）；④域界注记——forge_routes 属 meta 永久进度域（契约 2 反面清单不涉） |
+| v1.6 | 2026-10-12 | **迭代 22 反哺落文批（实现报告 §三⑥，用户裁「落文」）**：域清单表补 `vision_used` 行（真视使用终身计数，迭代 22 新增，v6 域后扩列补零不升版本——迭代 21 先例；断点随件 `vision_counter_used` 同批新增、旧随件键 `bonus_aux_carry` 随替换子交互拆除退役）；缺键补齐纪律句补 v6 扩列注；零迁移口径复核=SAVE_FORMAT_VERSION 仍 6（`save_manager.gd:49`），无迁移分支新增 |
+| v1.7 | 2026-10-12 | **锻造工坊实装批随迁（迭代 23 T5——v7 落地；承 v1.6 的 vision_used 登记）**：①域清单表 `forge_routes` 计划行→实际落地态（{levels 六路线等级 + unlocked 直购解锁清单 + weapon/armor 当前选中标记}，域内键名以实装批定名）；②版本与迁移节——当前 =7、迁移链补 v6→v7（空迁移=缺键补齐模式，解锁态派生不落档三通道）；③旧档口径订正——「破坏性废弃」→「缺键补齐 = 初始持有态」（开发阶段禁迁移禁折算纪律不变，契约 4）；④域界注记——forge_routes 属 meta 永久进度域（契约 2 反面清单不涉） |
@@ -62,7 +62,7 @@
 | 柜台 | 内容 | 解锁渠道 |
 |---|---|---|
 | 属性锻造 | 生命上限、基础攻击、护甲等级——三档可重复升级的属性强化 | 钥石直购 |
-| 秘宝匣 | 秘宝解锁与同调装配——**件的目录与效果权威定义在[秘宝](秘宝.md)「目录（重设计 v1）」**（12 件三档〔2026-10-11 裁回能器删/换装券撤/第四只手删〕；旧目录全退役只作素材库） | 解锁=混合制（基础件钥石购买/特定件条件解锁——见秘宝.md「道具从哪来」；装配只在冒险开始前配置，冒险中零更换途径〔2026-10-11 终裁〕）；同调装配段已随同调实施批落地（2026-10-03，见版本历史 v1.6）；钥石定价与阈值归定价批/调参批 |
+| 秘宝匣 | 秘宝解锁与同调装配——**件的目录与效果权威定义在[秘宝](秘宝.md)「目录（重设计 v1）」**（12 件三档〔2026-10-11 裁回能器删/换装券撤/第四只手删〕；旧目录全退役只作素材库） | 解锁=混合制（基础件钥石购买/特定件条件解锁——见秘宝.md「道具从哪来」；装配只在冒险开始前配置，冒险中零更换途径〔2026-10-11 终裁〕）；**迭代 22 实装批落地（2026-10-12）**：购买钮（余额不足禁用态）+条件解锁进度呈现+分档装配呈现（名后缀·档位/未解锁禁装）+空目录合法态；柜台数据投影=`treasure_shop_status`（解锁态/条件进度/价格单点）；旧道具工坊渠道面（行族/词表/解锁函数）已随批退役；钥石定价与阈值 provisional 归调参批 |
 | 奖励格图鉴 | 特殊奖励格的解锁——更强效果的格面 | 结构位现定；格子内容排 Alpha，随[地图战斗资源](../战斗循环/地图战斗资源.md)差异化批落地 |

 属性锻造的树形节点结构已随迭代 12 落地在役——**结构/节点/数值的现行事实源 = [天赋树](天赋树.md)，本文不复制树侧内容、只作指路**；本柜台三档直线强化与树淬炼 flat 在注入面叠加生效（注入口径见下文「跨局注入」节）。
@@ -73,7 +73,7 @@

 **投值语言锁定（2026-09-18 数值语言拍板）**：三柜台属性强化一律 **flat 整数加减**（"每级 +1 基础攻击"式，而非"+50% 攻击"式）——避开百分比词条被数值成长稀释的先例陷阱、守住数字可读性锚；具体每级数值仍归元进度设计批投值。

-三条柜台纪律：**定价曲线一律几何递增**（每级费用按公比上浮——原则已拍板，起步价与公比数字归设计批配读数），与产出逻辑配套：深层关钥石产出多、后级强化贵，逼玩家往深处走。**秘宝匣首版只挂通关次数渠道**是排期裁决（定价体系未建时的零定价依赖落地形态），不是终态。**存档义务随柜台产生**：钥石余额、永久强化等级表、每关通关次数表、Boss 首杀标记位——四件已逐域登记在 registry `save_file` 条目（内容 owner = 元进度，承载 owner = [存档序列化](../表现与支撑/存档序列化.md)）。
+三条柜台纪律：**定价曲线一律几何递增**（每级费用按公比上浮——原则已拍板，起步价与公比数字归设计批配读数），与产出逻辑配套：深层关钥石产出多、后级强化贵，逼玩家往深处走。~~秘宝匣首版只挂通关次数渠道~~（历史排期裁决已消解：秘宝匣现役=钥石直购+条件解锁混合制，迭代 22 落地，2026-10-12）。**存档义务随柜台产生**：钥石余额、永久强化等级表、每关通关次数表、Boss 首杀标记位——四件已逐域登记在 registry `save_file` 条目（内容 owner = 元进度，承载 owner = [存档序列化](../表现与支撑/存档序列化.md)）。

 护甲等级进首版属性柜台是 2026-09-18 拍板（用户选 A），其代价条款见下方换算率节的强条目登记。

@@ -130,7 +130,7 @@ MVP 不要求本系统的闭环（[不做清单](../../05-不做清单.md)整体
 | 优先级 | 内容 | 后置原因 |
 |---|---|---|
 | P1 | 三柜台内容铺量与定价数字 | 柜台结构已定稿；清单明细、几何定价的起步价与公比、Boss 两档产出数值，随设计批配读数投值 |
-| P1 | 秘宝匣钥石直购价 | 首版只挂通关次数渠道（零定价依赖）；定价体系建成后补价，收敛双渠道 |
+| P1 | 秘宝匣钥石直购价 | **已投 provisional 占位**（普通档 10/优秀档 25 钥石，迭代 22 落地，2026-10-12）；终值归调参批（原「首版只挂通关次数渠道」排期态随混合制落地消解） |
 | P1 | 奖励格图鉴的格子内容 | 排 Alpha，随[地图战斗资源](../战斗循环/地图战斗资源.md)差异化批 |
 | P1 | 换算率表数值行标定 | **已完成**（2026-09-23 换算率标定批——首版三行投值 6/9/1，护甲行强条目重测随批履行并修复护甲断链）（原系笔误孤例，registry 与 meta.tres 均为 6/9/1——2026-09-30 勘误） |
 | P2 | 营地界面与解锁呈现实现 | 归[HUD 框架](../表现与支撑/HUD框架.md)协作批，以表现层样张过审为前置 |
@@ -183,3 +183,4 @@ MVP 不要求本系统的闭环（[不做清单](../../05-不做清单.md)整体
 | v1.14 | 2026-10-11 | **营地统一案甲随迁（2026-10-11 天赋树设计会话终裁）**：三柜台节补「营地统一」段——树=营地本体、属性升级唯一入口=树脊柱淬炼节点、本属性锻造柜台随 06「天赋树实装批」退役吸收进脊柱（落地前维持现役）、锻造柜台与秘宝匣转工作间钥匙模型、图鉴常开；设计权威文档指路 = 天赋树.md v0.2。机制零改动（退役与公式换代随实装批） |
 | v1.15 | 2026-10-11 | 锻造工坊更名批随迁（机械扫）：三柜台节指路句随系统更名「武器锻造→锻造工坊」换代链接与名称（06 实装批条名同步「锻造工坊实装批」；版本历史行内旧名按历史记载保留）。机制零改动 |
 | v1.16 | 2026-10-12 | **完备性检查批随迁（用户令：有缺漏即补齐）**：①「跨局注入」节补开局属性四层叠加公式（角色基础值+树生命/命中 flat+锻造路线加值+局内加算区 flat；入战 AC 三层）——锻造工坊与天赋树两文档共指本节为「通道现行事实源」而公式缺位，本次落实；原「属性锻造三档是数值覆盖」随迭代 21 T5 行族退役换代；②锻造工坊 v0.6 引用版本号 v0.1→v0.5 连带校正（三柜台节）。机制零改动 |
+| v1.17 | 2026-10-12 | **迭代 22 反哺落文批（实现报告 §三④，用户裁「落文」）**：秘宝匣行补迭代 22 实装实录（购买钮禁用态/条件进度呈现/分档装配呈现/空目录合法态/treasure_shop_status 投影/旧道具工坊渠道面退役）；柜台纪律「首版只挂通关次数渠道」排期态消解注记；P1 秘宝匣定价行换代（provisional 10/25 已投，终值归调参批）。机制零改动 |
@@ -7,55 +7,55 @@

 ## 定位与形态

-**现行形态 = 局外同调件**：开局前在营地装配（营地·秘宝匣柜台「同调装配」段）、占同调位（0 起步、固定 3 格，每件固定占 1 格）、被动件整局生效/主动件每冒险充能（冒险开始重置）。实现面 = `treasure_items.tres` + `game/core/attunement.gd`（同调位数量判定源=天赋树同调位节点点亮数——2026-10-11 Q2 裁甲、迭代 21 T4 槽位收编落地；原 `attunement_growth.tres` 谓词表已随批退役；解锁条件表由秘宝实装批另建承载）；新目录实装批落地前，现役代码按本框架运行。
+**现行形态 = 局外同调件**：开局前在营地装配（营地·秘宝匣柜台「同调装配」段）、占同调位（0 起步、固定 3 格，每件固定占 1 格）、被动件整局生效/主动件每冒险充能（冒险开始重置）。实现面 = `treasure_items.tres` + `game/core/attunement.gd`（同调位数量判定源=天赋树同调位节点点亮数——2026-10-11 Q2 裁甲、迭代 21 T4 槽位收编落地；原 `attunement_growth.tres` 谓词表已随批退役；解锁条件=数据行内 `unlock_requires` 字段承载——迭代 22 实装落地，2026-10-12）。**新目录 12 件已随迭代 22 实装批全量落地（2026-10-12，T1-T7）**，逐件实录见「目录（重设计 v1）」各表实态列。

 **沿革一句话**：本系统前身为切片期掉落消耗品形态（2026-09-29 迭代 7），2026-10-03 随同调实施批整体替换为现行形态；旧目录九件已全数退役入素材库（2026-10-08/10 用户裁）。历史细节见版本历史与 git 提交史。

 **现行形态速览**：

- **同调位分档**（2026-10-07 用户裁）：同调位分三档=普通格/优秀格/稀有格；装配规则=**槽位可装 ≤ 槽位档位的件**（向下兼容，不惩罚早解锁）；格品质随天赋树同调位节点递增（1=普通格/2=优秀格/3=稀有格，2026-10-10 用户裁；树侧接线由天赋树的批次承接）。装配面须呈现槽位档位；实装归实装批。
- **旧目录退役指针**：旧目录九件、魔法提灯、机制向三件处置已全数退役入素材库（表一 14 件）——现行目录见下方「目录（重设计 v1）」节。
+- **同调位分档**（2026-10-07 用户裁）：同调位分三档=普通格/优秀格/稀有格；装配规则=**槽位可装 ≤ 槽位档位的件**（向下兼容，不惩罚早解锁）；格品质随天赋树同调位节点递增（1=普通格/2=优秀格/3=稀有格，2026-10-10 用户裁；树侧接线=迭代 21 T4 槽位收编落地）。装配面呈现槽位档位（迭代 22 秘宝匣柜台落地）。
+- **旧目录退役指针**：旧目录九件、魔法提灯、机制向三件处置已全数退役入素材库（表一 14 件）——现行目录见下方「目录（重设计 v1）」节；代码旧行已全数删除（迭代 20 先行删 2 行+迭代 22 T1 删 12 行，2026-10-12）。
 - **三选一刷新双源**：刷新能力=**存量账+临时账**两本账——存量账=持久（开局注入基值 0；来源=秘宝匣刷新升级行购买〔meta.tres attune_refresh_upgrade 行族〕+刷新练习件加仓；跨呈现持续、用完即无）、临时账=每次三选一呈现重置为基线 0（来源=效果件的临时注入，未用不结转）；**消耗顺序=先扣临时、不足再扣存量**（2026-10-10 用户复述定案；代码字段名 X/Y 与两账的字母对表归实装批 T0，正文不依赖字母）。重抽复用现有洗牌逻辑（reward_pick），池规则全保留；自动游玩模式默认不刷。**GP（局内金币）付费档（2026-10-06 用户令）**：免费双源用尽后可 GP 付费刷新，价=ceil(20×1.8^本次停点已付费刷) provisional（与商店货架刷新读同两个调参参数 shop_refresh_*，单点调参）；付费刷计数每停点清零；钱包=冒险 GP 同一账本（唯一入口 LevelRunner.spend_gp）；余额不足=钮禁用（不隐藏）。店内专长凭证三选一暂不挂刷新面（扩面须先裁凭证保底计数交互）。**两账语义**两账语义的框架定义见[核心循环](../../01-核心循环.md)「生命周期轴」节。「三选一呈现」是比节点更细的事件——奖励节点、Boss 通关奖励、商店（凭证）三处都触发。奇物「刷新次数+1」类资源件的语义=存量账一次性加仓。
 - **🔴 承重契约**（红线；其中真视范围等由数据加载校验强制）：效果不允许写成直接加减属性的裸数值——效果类型只能取封闭白名单；真视（直接标出危险格的效果，定义见「核心规则」）单次范围 ≤3×3；核心逻辑不做异步等待；零随机；排雷玩法零特判；危险格与安全格的分布同池冻结——资源类件只能调整权重投影、不能改池结构；**棋盘事实不可变**（秘宝效果不移除、不增改危险格位置与邻接数字——效果形态只允许信息呈现与开格动作；2026-10-10 用户裁，原爆破工兵包「中立移除」即违规形态、随件退役废止）。
 - **验收分层**：难度验收分两层——同调系统关闭时沿用现行通关率验收带；开启时验收带按投值平移（归[难度曲线与Boss](../冒险循环/难度曲线与Boss.md)投值；商店开关分层同法）。

 ## 目录（重设计 v1）

-> 秘宝目录的权威版本（2026-10-08 用户终审全落——「都可以先落；旧的去掉只保留新的」）。代号制：正式命名归用户；数值全 provisional 归调参批；实装归实装批。准入约束（机能件判定尺/定义卡 3+1 句）见[核心循环](../../01-核心循环.md)「道具三层职责与分界」节。旧目录全数退役，名单与处置映射见[道具退役素材库](../../../research/道具退役素材库.md)表一。
+> 秘宝目录的权威版本（2026-10-08 用户终审全落——「都可以先落；旧的去掉只保留新的」；**2026-10-12 迭代 22 实装批全量落地**，逐件实态=item_id/解锁/效果实现三实态列）。代号制：正式命名归用户；数值全 provisional 归调参批。准入约束（机能件判定尺/定义卡 3+1 句）见[核心循环](../../01-核心循环.md)「道具三层职责与分界」节。旧目录全数退役，名单与处置映射见[道具退役素材库](../../../research/道具退役素材库.md)表一。

 ### 三档骨架

 - 数量：普通档 7 件 / 优秀档 3 件 / 稀有档 2 件（优秀档两位空位=2026-10-11 回能器删〔孤儿件〕/换装券撤〔冒险中零更换途径无此件〕；稀有档一位空位=2026-10-11 第四只手删〔净收益为零的自指件——占一槽换一槽、携带量 3=3 且自锁唯一稀有格〕——空位不构成补件议程；传说位留空，与跨系统的四级稀有度框架〔普通/优秀/稀有/传说〕兼容——秘宝不用满四档）。
- 解锁方式（2026-10-10 用户裁**混合制**）：基础件=秘宝匣内**钥石购买**解锁（定价归定价批）；特定件=**条件解锁**（游玩里程碑或行为条件——如通关次数、某类工具使用次数，逐件定条件写解锁条件表，阈值 provisional 归调参批）。逐件分配（哪几件钥石、哪几件条件）随实装批需求卡片定；旧「档位谓词分级（普通 0/优秀中/稀有高里程碑）」口径作废。
+- 解锁方式（2026-10-10 用户裁**混合制**）：基础件=秘宝匣内**钥石购买**解锁（定价归定价批）；特定件=**条件解锁**（游玩里程碑或行为条件，阈值 provisional 归调参批）。逐件分配已随实装批锁定（2026-10-11 用户裁 C1）：钥石购买 8 件（普通 7 件各 10 钥石+双管装填 25 钥石）+条件解锁 4 件（远程镐=生涯通关≥1/刷新执照=Boss 击杀≥3/天眼=通关≥3 且 Boss 击杀≥4/信标网络=真视类工具累计使用≥10）；解锁条件承载=`treasure_items.tres` 行内 `unlock_requires` 字段（计数键 adventure_cleared/boss_kill_count/vision_used，schema 词表校验单点——2026-10-12 迭代 22 落地）；旧「档位谓词分级（普通 0/优秀中/稀有高里程碑）」口径作废。
 - 验收纪律：**同档内不许存在严格支配关系**（同档 A 在所有维度不劣于 B 即违规）——防首选内定的结构检查。
 - 装配面：同调位分档（普通格/优秀格/稀有格，槽位可装 ≤ 槽位档位的件）——见「定位与形态」速览。

 ### 普通档（7 件）

-| 代号 | 一句话 | 写哪本账/时点 |
-|---|---|---|
-| 晨操令 | 每场战斗第 1 轮 +1 AP | AP 池/轮始 |
-| 阔视野带 | 类型微光范围 8 格→12 格 | 视野参数/常时 |
-| 试炼镐 | 每开 4 安全格积 1 点，满 2 点换当轮 +1 AP | AP 池/主动触发 |
-| 刷新练习 | 三选一刷新存量 +1 | 刷新存量账/装配即得 |
-| 储备罐 | 停手转存率 1:1 → 1.25:1 | 储备行动点（RAP）转存率参数/停手时 |
-| 巢穴预告 | 装板后揭示本板危险格数量 | 危险格计数（不碰危险格分布）/装板时 |
-| 线香 | 每战一次：真视单格 | 真视窄域（≤3×3 契约内）/主动 |
+| 代号 | item_id | 一句话 | 写哪本账/时点 | 解锁（迭代 22 实态） | 效果实现 |
+|---|---|---|---|---|---|
+| 晨操令 | morning_order | 每场战斗第 1 轮 +1 AP | AP 池/轮始 | 钥石 10 provisional | 订阅行 round_start→grant_ap |
+| 阔视野带 | wide_scout_band | 类型微光范围 8 格→12 格 | 视野参数/常时 | 钥石 10 provisional | 参数面 light_radius_bonus（+4） |
+| 试炼镐 | trial_pick | 每开 8 个安全格，当轮 AP +1（自动） | AP 池/开格自动兑付 | 钥石 10 provisional | ap_charge_safe 满 charge_n=8 自动 grant_ap（2026-10-12 反哺批⑤用户裁自动兑付） |
+| 刷新练习 | refresh_practice | 三选一刷新存量 +1 | 刷新存量账/装配即得 | 钥石 10 provisional | 参数面 refresh_stock_grant |
+| 储备罐 | reserve_jar | 停手转存率 1:1 → 1.25:1 | 储备行动点（RAP）转存率参数/停手时 | 钥石 10 provisional | 参数面 rap_transfer_mult（125） |
+| 巢穴预告 | nest_forecast | 装板后揭示本板危险格数量 | 危险格计数（不碰危险格分布）/装板时 | 钥石 10 provisional | 订阅行 board_installed→mine_count_preview（呈现=开局 toast） |
+| 线香 | incense_stick | 每战一次：真视单格 | 真视窄域（≤3×3 契约内）/主动 | 钥石 10 provisional | reveal_tiles（战斗级充能） |

 ### 优秀档（3 件）

-| 代号 | 一句话 | 写哪本账/时点 |
-|---|---|---|
-| 双管装填 | 每战前 2 轮各 +1 AP | AP 池/轮始 |
-| 远程镐 | 挖掘距离 +1（可挖距英雄 2 格的格） | 可达性规则/常时 |
-| 刷新执照 | 商店免费刷新 +2/店 | 商店刷新计数/进店时 |
+| 代号 | item_id | 一句话 | 写哪本账/时点 | 解锁（迭代 22 实态） | 效果实现 |
+|---|---|---|---|---|---|
+| 双管装填 | twin_loader | 每战前 2 轮各 +1 AP | AP 池/轮始 | 钥石 25 provisional | 订阅行 round_start→grant_ap |
+| 远程镐 | ranged_pick | 挖掘距离 +1（可挖距英雄 2 格的格） | 可达性规则/常时 | 条件：生涯通关 ≥1 provisional | 参数面 dig_range_bonus |
+| 刷新执照 | refresh_license | 商店免费刷新 +2/店 | 商店刷新计数/进店时 | 条件：Boss 击杀 ≥3 provisional | 参数面 shop_refresh_bonus |

 ### 稀有档（2 件）

-| 代号 | 一句话 | 写哪本账/时点 |
-|---|---|---|
-| 天眼 | 每关一次：选 3×3，危险格显示且安全格直接开 | 真视+开格复合/主动 |
-| 信标网络 | 插旗不限相邻（可对任何未开格插旗） | 旗的可达性规则/常时 |
+| 代号 | item_id | 一句话 | 写哪本账/时点 | 解锁（迭代 22 实态） | 效果实现 |
+|---|---|---|---|---|---|
+| 天眼 | sky_eye | 每关一次：选 3×3，危险格显示且安全格直接开 | 真视+开格复合/主动 | 条件：通关 ≥3 且 Boss 击杀 ≥4 provisional | reveal_tiles+safe_dig（关卡级充能；安全格开格按普通挖格全额兑付免 AP——C5 裁） |
+| 信标网络 | beacon_network | 插旗不限相邻（可对任何未开格插旗） | 旗的可达性规则/常时 | 条件：真视类工具累计使用 ≥10 provisional（vision_used 生涯计数域） | 参数面 flag_range_free |

 ## 设计骨架（可设计方向 × 代价空间）

@@ -74,16 +74,16 @@

 ### 代价轴（新件设计时与效果格组合选用）

-**获取代价**（解锁侧）：钥石购买（基础件）/ 条件解锁（游玩里程碑·行为条件，逐件写解锁条件表）。
+**获取代价**（解锁侧）：钥石购买（基础件）/ 条件解锁（游玩里程碑·行为条件）——逐件分配与阈值实录见「目录（重设计 v1）」三表解锁列。

 **使用代价**（使用侧，按重置周期分层）：

 | 形态 | 语义 | 计量与重置 | 现状 |
 |---|---|---|---|
-| 冒险级限量 | 每次冒险共 N 次 | 开局满额，用完即止 | 现役形态（旧目录主动件充能 2 次；新目录暂无对应件） |
+| 冒险级限量 | 每次冒险共 N 次 | 开局满额，用完即止 | 空位（旧目录主动件充能 2 次形态随目录退役） |
 | 关卡级限量 | 每关 N 次 | 每关开始重置 | 天眼（每关一次） |
 | 战斗级限量 | 每场战斗 N 次 | 每场战斗开始重置 | 线香（每战一次） |
-| 转化获取 | 付出换取使用次数：行为转化（开 N 格→+1）/ 资源转化（耗 N AP→+1）/ 时间触发（每 N 回合→+1） | 积点或触发账本，滑动消耗 | 试炼镐（行为通道在役）；资源/时间两通道空位 |
+| 转化获取 | 付出换取使用次数：行为转化（开 N 格→+1）/ 资源转化（耗 N AP→+1）/ 时间触发（每 N 回合→+1） | 行为账本满额即时兑付 | 试炼镐（行为通道在役——**每开 8 个安全格自动兑当轮 AP+1：无玩家发起入口、账即时清空〔2026-10-12 反哺批⑤用户裁自动兑付〕；战斗级重置=账即时清空自然无感；兑付时序=揭示先于本格扣费，AP 归零恰逢满点时先兑再扣、轮次不因本格结束**）；资源/时间两通道空位 |
 | 常时（无使用代价） | 被动件无「使用」概念——占装配位即全部代价 | — | 现役被动件 |

 **恢复机制**（独立参数，不与限量周期混同）：基准=冒险开局满额；中途回充现役**无来源**——回能器已删（2026-10-11 用户裁孤儿件：新目录无冒险级限量件，而关卡级/战斗级件天然周期重置、开局回充对其结构性冗余）；恢复机制留作骨架参数，未来冒险级限量件出现时启用。
@@ -96,7 +96,7 @@
 2. 档位（普通/优秀/稀有）=代价×效果的预置平衡带：普通=弱效果配松代价，稀有=强效果配紧代价——骨架与档位体系在此接口。
 3. 覆盖检查只跑效果三方向；细分格空位**不构成补件议程**（预读格教训记录在案）。
 4. 信息方向的价值检验按目的做（减少了多少盲赌），不按信息形式堆料；强效果必须配紧代价。
-5. 各周期账本独立、互不换算；全部限量值 provisional 归调参批；逐件的效果格与代价格归属随实装批登记。
+5. 各周期账本独立、互不换算；全部限量值 provisional 归调参批；逐件的效果格与代价格归属见「目录（重设计 v1）」三表（2026-10-12 迭代 22 落地登记）。


 ## 设计目的
@@ -111,7 +111,7 @@

 | 负责 | 说明 |
 |---|---|
-| 道具定义表 | 秘宝件的字段定义：名称、效果格归属、效果组合、目标形态、数值；现行目录=「目录（重设计 v1）」节 12 件（实装归实装批，实装批落地前表内旧目录同调行冻结维持）；承重护栏在加载期校验中强制 |
+| 道具定义表 | 秘宝件的字段定义：名称、效果格归属、效果组合、目标形态、数值；现行目录=「目录（重设计 v1）」节 12 件（已随迭代 22 实装批全量落地，2026-10-12）；承重护栏在加载期校验中强制 |
 | 设计骨架与覆盖检查 | 效果三方向（信息/行动资源/操作能力）覆盖检查——每方向至少一件承载（口径见「设计骨架」节）；加载后自动检查 |
 | 同调装配与充能账 | 营地装配入同调位（每件固定占 1 格、共 3 格；分档规则见「定位与形态」速览）；主动件充能每冒险开始重置 |
 | 使用规则与目标校验 | 什么时候能用、目标合不合法、失败分几级、哪一级不消耗 |
@@ -158,12 +158,12 @@

 ### 道具从哪来：解锁与营地装配

-秘宝不可购买、不可合成，唯一来路=**营地解锁**（2026-10-10 用户裁混合制——基础件钥石购买/特定件条件解锁）。**装配只在冒险开始前于营地配置；冒险中不存在任何更换途径**（2026-10-11 用户裁，无例外——拾取与效果均不产生装配变化；原当日早间试行的「冒险拾取未知秘宝」渠道同日废止，奇物侧无对应实现）。解锁细目：**特定件**凭条件解锁（游玩里程碑或行为条件，逐件定条件写解锁条件表——秘宝实装批另建承载表、改表不动码，阈值 provisional 归调参批（原「现役同调增长表 attunement_growth.tres 改造」句随表退役换代——迭代 21 T5））。同调位槽位由天赋树同调位节点提供（1=普通格/2=优秀格/3=稀有格递增，共 3 格）——树与秘宝同为角色属性的贡献者，槽位参数的提供方在树侧。开局前在营地·秘宝匣柜台「同调装配」段装入同调位（每件固定占 1 格；分档装配规则见「定位与形态」速览）。
+秘宝不可合成，唯一来路=**营地解锁**（2026-10-10 用户裁混合制——基础件钥石购买/特定件条件解锁；冒险中无购买）。**装配只在冒险开始前于营地配置；冒险中不存在任何更换途径**（2026-10-11 用户裁，无例外——拾取与效果均不产生装配变化；原当日早间试行的「冒险拾取未知秘宝」渠道同日废止，奇物侧无对应实现）。解锁条件实录（2026-10-12 迭代 22 落地，阈值 provisional 归调参批）：钥石购买 8 件（晨操令/阔视野带/试炼镐/刷新练习/储备罐/巢穴预告/线香各 10 钥石+双管装填 25 钥石）；条件解锁 4 件——远程镐=生涯通关 ≥1（adventure_cleared）、刷新执照=Boss 击杀 ≥3（boss_kill_count）、天眼=通关 ≥3 且 Boss 击杀 ≥4、信标网络=真视类工具累计使用 ≥10（vision_used，行为计数域随迭代 22 新增）；承载=`treasure_items.tres` 行内 `unlock_requires` 字段（改表不动码；schema 计数键词表校验单点）。同调位槽位由天赋树同调位节点提供（1=普通格/2=优秀格/3=稀有格递增，共 3 格）——树与秘宝同为角色属性的贡献者，槽位参数的提供方在树侧。开局前在营地·秘宝匣柜台「同调装配」段装入同调位（每件固定占 1 格；分档装配规则见「定位与形态」速览）。


 ### 什么时候怎么用：挖掘期发起，战斗结算编排

-受理框架为新目录主动件（线香/天眼/试炼镐）沿用；新目录实装批落地前，现役代码按同框架运行。
+受理框架现役=主动使用件线香/天眼（2026-10-12 迭代 22 落地）；**试炼镐为自动兑付件，无使用动作、不经本节四步**（每开 8 个安全格自动当轮 AP+1——2026-10-12 反哺批⑤用户裁，兑付时序见「设计骨架·代价轴」转化获取行）。

 使用动作在挖掘期发起：轮次进行中的任意时点都行。战斗阶段没有道具使用窗口（战斗道具已于 2026-09-15 随可选类删除下线），秘宝的使用窗口独占挖掘期。发起之后由战斗结算编排受理，按固定次序走四步：

@@ -176,7 +176,7 @@

 所有会失败的情况都被前两步拦下，后两步在合法输入下不会失败——"产生效果"和"消耗道具"永远成对发生。带两个效果的稀有道具，施加顺序钉死为先空间效果、后加行动点；定义表里效果的书写顺序不承载运行时语义。

-用道具不扣行动点：成本在装配时已经付过——它占了一格同调位；挖格、插旗的价格不受任何影响。道具只产生信息与行动点、不产生动作：系统没有任何自动使用入口——不会自动替你挖，也不会自动替你插旗。真视尤其要说清：它是信息不是保护，被标出的危险格挖开照样惊动；靠真视插旗仍按标准动作价计费（价目见 action_economy.tres），标中收益照走既有结算路径。本节纯流程，无计算。
+用道具不扣行动点：成本在装配时已经付过——它占了一格同调位；挖格、插旗的价格不受任何影响。道具只产生信息与行动点、不产生动作：使用入口仅线香/天眼两主动件——不会自动替你挖，也不会自动替你插旗（试炼镐的自动兑付是行为转化的兑付、非使用动作——它不挖格不插旗，只在玩家自己挖格时按开格数兑行动点）。真视尤其要说清：它是信息不是保护，被标出的危险格挖开照样惊动；靠真视插旗仍按标准动作价计费（价目见 action_economy.tres），标中收益照走既有结算路径。本节纯流程，无计算。

 ### 信息住在哪：整图叠加层，随图消亡

@@ -228,11 +228,11 @@

 ## 调参表

-道具定义表的全部数值均为 provisional，归[难度曲线与Boss](../冒险循环/难度曲线与Boss.md)调参；registry `aux_items` 条目现承载旧目录历史口径，新目录 12 件登记随实装批换代；表 schema 归[数据配置](../表现与支撑/数据配置.md)承载、本系统回填。
+道具定义表的全部数值均为 provisional，归[难度曲线与Boss](../冒险循环/难度曲线与Boss.md)调参；registry `aux_items` 条目已随迭代 22 换代为新目录 12 件登记（2026-10-12）；表 schema 归[数据配置](../表现与支撑/数据配置.md)承载、本系统回填。

 结构冻结（非调参项，改动走本文修订流程）：真视窄域护栏、零信息目标不消耗、边缘窗口照常受理、使用零行动点成本、同调位装配与充能每冒险重置、用后不可逆、零随机。

-效果声明形态（内容数据驱动扩展批落地，在役沿用）：被动件的效果行为=**订阅行**——行内声明**订阅哪个事件（on）/ 什么条件（when）/ 什么效果（do）**，由效果引擎统一解释执行；主动件按效果类型通用分发（受理闸=使用事件订阅+积点计数器账本）。事件/效果类型/条件事实/算子四词表封闭（效果引擎单一事实源）；卡面效果摘要=行 `desc` 字段直读（文案表值化）。新目录 12 件的效果行随实装批登记。
+效果声明形态（内容数据驱动扩展批落地，在役沿用）：被动件的效果行为=**订阅行**——行内声明**订阅哪个事件（on）/ 什么条件（when）/ 什么效果（do）**，由效果引擎统一解释执行；主动件按效果类型通用分发（受理闸=使用事件订阅）；常时参数面件（阔视野带/储备罐/远程镐/信标网络/刷新练习/刷新执照六件）effect_kinds 挂参数 kind、由注入面按装配集分发读取；试炼镐=自动兑付（ap_charge_safe 满 charge_n 直接 grant_ap）。事件/效果类型/条件事实/算子四词表封闭（效果引擎单一事实源）；卡面效果摘要=行 `desc` 字段直读（文案表值化）。新目录 12 件的效果行已随迭代 22 落地登记。

 playtest 预警（预注册，归难度曲线与Boss）：

@@ -243,8 +243,8 @@ playtest 预警（预注册，归难度曲线与Boss）：

 ## 验收标准

- 护栏强制：任何标出危险格的道具定义，目标域字段超过 3×3 时数据加载直接报错拒绝；现役表内旧目录行维持加载通过至实装批替换，新目录 12 件逐件过护栏校验归实装批验收。
- 覆盖检查：效果三方向（信息/行动资源/操作能力）各有新目录承载，检查按「设计骨架」节口径执行；逐件的效果格归属随实装批登记。
+- 护栏强制：任何标出危险格的道具定义，目标域字段超过 3×3 时数据加载直接报错拒绝；现行 12 件逐件过护栏校验（迭代 22 已交付，2026-10-12）。
+- 覆盖检查：效果三方向（信息/行动资源/操作能力）各有新目录承载，检查按「设计骨架」节口径执行；逐件的效果格归属见「目录（重设计 v1）」三表。
 - 两域正交：秘宝件经同调位装配生效，不入局内道具背包，与奇物背包互不混装。
 - 使用窗口：非挖掘期的使用请求被拒绝且不消耗；挖掘期任意时点可发起。
 - 零消耗拒绝：目标不合法（例如点在已挖开的格子上）时道具不消耗、装配位不变、反馈可辨认；整图零信息时图标置灰、入口禁用。
@@ -263,6 +263,7 @@ playtest 预警（预注册，归难度曲线与Boss）：

 | 版本 | 日期 | 改动 |
 |---|---|---|
+| v3.0 | 2026-10-12 | **迭代 22 反哺落文批（实现报告 §三①②③，用户逐点裁「落文」）**：①目录三表补实态三列（item_id/解锁〔价格或条件，阈值 provisional〕/效果实现 kind）+试炼镐行换代自动兑付语义+全部「实装批落地前」现状句换代（定位形态节/目录引言/负责表/受理框架节/调参表/验收护栏覆盖两行）+旧目录退役指针补代码旧行已删；②代价轴转化获取行换代=试炼镐每开 8 安全格自动兑当轮 AP+1（2026-10-12 用户裁：无玩家发起入口、战斗级重置、兑付时序=揭示先于扣费故 AP 归零恰逢满点轮不结束）——设计留白〔积点账重置周期〕随裁补记；③解锁混合制节条件表实录（钥石 8 件 10/25+条件 4 件三计数键阈值）+承载换代=行内 unlock_requires 字段 |
 | v0.1 | 2026-09-15 | 自归档 GDD 压缩改写 |
 | v0.2 | 2026-09-16 | 更名批（用户拍板 2026-09-16）：系统更名"辅助道具"→"秘宝"——定位已非纯数值道具，含信息/妙用向效果；文件同步重命名；英文代号 AUXILIARY_ITEMS 暂沿用 |
 | v0.3 | 2026-09-17 | 切片期空内容拍板（用户拍板）：道具定义表为空列为合法态——五维度覆盖检查改为仅对非空清单执行；验收标准覆盖检查条目同步；06「维度覆盖检查破缺」「失义道具的掉落投放」两条随批关闭 |