DKChan
1460cf9077
补 42d64ec2／17ef0180 两笔漏掉的两件执行层：
一、版本历史行（22 个文档各一行，doc-conventions R4 与项目惯例要求每批改动落行）
00 v1.4／01 v1.10／02 v1.28／03 v1.4／05 v1.5／08 v1.11／关卡节点地图 v1.9／
冒险结构 v0.23／难度曲线 v0.30／战斗结算 v0.30／排雷玩法 v0.7／行动经济 v0.14／
存档序列化 v1.10／教学引导 v0.6／元进度 v1.22／天赋树 v0.12／秘宝 v2.5／
锻造工坊 v0.11／camp v1.6／settlement-summary v1.4／shop v1.2／术语表 v1.14
（奇物.md 已于前批加 v3.20，不重复）
二、06 新建两条（pipeline_gate PASS：06 条目 63）
「定名传导遗留二项」（来源=会话提及，设计面=文档轨）：
①增益状态.md 用「账」指战斗内状态容器——经用户确认与「系统资源」不是同一个
东西，仅用词冲突；改名与否（候选：容器／状态池）与连带范围待用户裁
②art/ 两处＋entities.yaml 三处 GP 更名已在分支 gpsweep-20261019 改完但未合回
master，合并归用户另会话，本批不代做
「代码注释旧称二处」（来源=会话提及，设计面=工程直入，状态=待写卡）：
adventure_table.gd:21/:24 注释仍写「资源类」；kind 字面是账名不是分类名，
数据零改动，只改注释两处；按用户令等建需求卡片
坑：06 状态行写「金币分支」触发 doc_term（「金币」退役 2026-10-18，该行无日期
白名单信号）→ 改「GP 更名分支」；06 现状段引述退役词带日期信号，合规放行。
闸：worktree 内 run_all_gates.sh --docs 验收通过，对基线零新增红。
3.4 KiB
3.4 KiB
商店覆盖层 UX spec（shop）
状态：v1.1（2026-09-30 审计拍板点 4B 用户裁决写入文档——甲+乙并行：编排面小节落关卡节点地图、呈现面独立成文） 事实源：
game/presentation/views/shop_overlay_view.gd（ShopOverlay） 机制权威：关卡节点地图（商店房编排：每关恰 1/Boss 前一位必经/兑付触发）；定价数值归难度曲线与Boss（shop.tres，provisional）
定位
商店覆盖层是商店房节点的兑付呈现面（冒险-关卡中循环节点功能）：行进至商店房打开，玩家用 GP（显示名「GP」）在令牌级货架上购买，离开后兑付确认回选路。现行 = pool 模式（货架与三选一共享令牌池）；legacy 三商品卡模式保留为 shop=off 对照形态。本 spec 只锁呈现；编排与定价归机制文档。
布局与交互
- 模态覆盖层（dim + 居中）：标题「商店」/ GP 余额读数/ 令牌级货架卡（进店自共享池抽 3 张：显示名·效果·现价——六行池面含回复与专长凭证；买一件 = 池少一件、货架随即全架重抽）/ 购买按钮（余额不足禁用置灰——pattern 8 禁用态即理由）/ 刷新按钮（GP 付费刷新，价 = ceil(20×1.8^本次进店已付费刷) provisional，余额不足禁用）/ 离开按钮。
- 购买意图
buy_requested经组合根转发 runner（pool 模式载荷 = kind_id）；成功后货架整架重建（买 1 全重抽反馈）。刷新意图refresh_requested经组合根转发 presenter。 - 离开 → 关卡画面兑付确认回选路（零自动推进）。
- 刷新与货架口径（2026-10-04 P-C2+Q2 裁决，SR-1 落码）：基础免费 0 次 + GP 付费刷新 + 池源同源（与三选一同一令牌库本）——原「无独立刷新、全陈列」裁决随该批被推翻；天赋侧「刷新次数」增益预留 free_count 位（06 登记条在册）。
口径
- GP 余额读数 = runner 钱包投影（GP 归冒险结构 GP 节）；本层不作计算。
- 与关卡画面 GP 常驻徽章的关系：进店语境余额与选路常驻总量不同义（本层带购买语境），不构成重复展示——钥石「写入/存量」拆名逻辑同款。
- 购买确认交互：现行直接购买（无二次确认步）；是否需破坏性确认异位（pattern 7）未裁决，本 spec 只登记现状不立新裁。
版本历史
| 版本 | 日期 | 改动 |
|---|---|---|
| v1.0 | 2026-09-30 | 首版落文（审计拍板点 4B 裁决：甲+乙并行——编排面小节落关卡节点地图、呈现面独立成文） |
| v1.1 | 2026-10-09 | 文档正确性审查批（在役态对齐）：商店现行 = pool 模式（令牌级货架与三选一同池六行，含回复与专长凭证；进店抽 3、买一件 = 池少一件货架重抽）+ GP 付费刷新（SR-1/MC-1 已落码）——原「三商品卡全陈列、无刷新」为 legacy 形态（shop=off 对照保留），定位/布局/口径三节订正 |
| v1.2 | 2026-10-19 | 系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）：「同一令牌账」→ 同一令牌库；「账本归冒险结构」→ GP 归冒险结构；「本层不算账」→ 本层不作计算——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |