DKChan
6951632d25
- 新建 design/gdd/术语表.md v1.0（四节术语+退役词对照；02 清单登记；用户令查表阅读） - 全库更名：雷格/惩罚格→危险格（113 处）、雷安→危险格与安全格（39）、板级→整图（29）、门票→专长凭证（88）、雷位→危险格位置（5）；排雷玩法定义句换代+版本行 - 秘宝.md v2.5 可读性批：术语指路+黑话清扫（正主/落籍/P1甲死指针/charges/结构闸等）+承重契约白话化+验收分层白话化+两处过时事实修正（战斗道具窗口 2026-09-15 已下线/21 项义务死指针）+版本行序修复
30 lines
3.1 KiB
Markdown
30 lines
3.1 KiB
Markdown
# 商店覆盖层 UX spec（shop）
|
||
|
||
> 状态：v1.1（2026-09-30 审计拍板点 4B 用户裁决落文——甲+乙并行：编排面小节落关卡节点地图、呈现面独立成文）
|
||
> 事实源：`game/presentation/views/shop_overlay_view.gd`（ShopOverlay）
|
||
> 机制权威：[关卡节点地图](../systems/冒险循环/关卡节点地图.md)（商店房编排：每关恰 1/Boss 前一位必经/兑付触发）；定价数值归[难度曲线与Boss](../systems/冒险循环/难度曲线与Boss.md)（shop.tres，provisional）
|
||
|
||
## 定位
|
||
|
||
商店覆盖层是商店房节点的兑付呈现面（**冒险-关卡中循环节点功能**）：行进至商店房打开，玩家用 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 钱包投影（账本归[冒险结构](../systems/冒险循环/冒险结构.md) 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 对照保留），定位/布局/口径三节订正 |
|