5.5 KiB
5.5 KiB
营地覆盖层 UX spec（camp）
状态：v1.1（2026-09-30 审计拍板点 4A 用户裁决落文——乙案新建 ux spec+元进度配套更改；视觉终稿已随迭代 9 9A 段落码，本 spec 成文其呈现规则） 事实源：
game/presentation/views/camp_overlay_view.gd（CampOverlay——9A 视觉终稿后实态） 机制权威：元进度（营地三柜台/钥石/永久强化——营地=界面壳、机制主语=永久强化） 相邻：settlement-summary.md（最近冒险摘要数据同源）/ level-map.md（主菜单语境）
定位
营地是存档内消费钥石的枢纽场所（界面壳，非机制实体——裁定见元进度）：主菜单营地独立入口进入，玩家在此用钥石换永久强化、查看秘宝匣解锁与最近冒险。本 spec 只锁呈现；机制（定价/解锁/入账）全部归元进度。循环层级：存档级（大循环/局外）呈现面——本层只在存档语境可达（主菜单入口），冒险进行中不可达。
布局与交互
- 石纹全屏底（样张 v2 冻结件，浅 dim 透出）+ 顶栏铭牌与钥石徽（余额常驻）。
- 三柜台列：属性锻造（三档行：等级/价格/购买钮）、秘宝匣（迭代 22 实装态呈现，2026-10-12——见下方「秘宝匣柜台呈现细则」节）、奖励格图鉴（结构位）。
- 树面板（图鉴柜台下段，现役程序占位）：营地内天赋树的节点购买与 Fork A/B 面切换承载——系统现行事实源=天赋树（33 节点在役），呈现终稿归 HUD框架；信号
tree_buy_requested/tree_fork_toggled。（本行 2026-10-09 补登——树侧跨文档欠账清偿：此前本 spec 零树面板登记。） - 底栏：关闭钮 + 操作注记；最近冒险收底栏条带（逐行只读账面）。
- 购买意图
buy_requested(attr)经组合根转发 MetaProgression（纯视图 setter 面——零核心写调用、零账本持有）；购买成功refresh_camp就地重刷（零重建回流）。 - 开合与开始层互斥：打开本层前由组合根隐藏开始层（遮挡纪律 2.3——开始覆盖层非模态且树序在后）。
口径
- 呈现数据源 = MetaProgression 只读投影经组合根喂入；本层不持有账本、不算价。
- 退役/封存件呈现语义已随旧目录整体退役消解（探宝罗盘/显影尘/地穴全图卷等状态行已删——迭代 22 旧 12 行删除后目录内零 deferred/retired 态，2026-10-12）；历史语义见版本历史 v1.1。
- 双入口框架（主菜单入口+局内状态面板只读入口〔2026-10-13 由「暂停层」改名——游戏非实时无暂停语义〕）的需求面归元进度「解锁双入口框架」节；状态面板入口已实装（2026-10-06 迭代 17 卡③〔时名暂停层〕——实机目检待用户，06 登记条在册），其呈现面不归本 spec。
秘宝匣柜台呈现细则（迭代 22 实装态，2026-10-12）
秘宝匣柜台=解锁面+同调装配段两部分（数据投影=treasure_shop_status 单点）：
- 解锁面：逐件一行——钥石购买件带购买钮（余额不足=禁用态不隐藏；已解锁=钮消失转已解锁态）；条件解锁件带条件进度呈现（计数键现值/阈值，如「通关 2/3」）；件名后缀·档位（普通/优秀/稀有）；悬停浮窗=行
desc直读。 - 装配段（同调装配）：装配行带档位标签（件档≤格档约束的可见面）；未解锁件禁装（列表不可选）；满位禁选；每件固定占 1 格。
- 空目录合法态：白板档（12 件全未解锁）柜台零可装行=合法态非缺陷（装配面空目录断言 V18 在役）。
- 状态面板只读概览：局内状态面板秘宝匣段=12 行只读清单（解锁态+装配态概览，零写入口——装配只在营地）。
- 机制权威=元进度/秘宝.md；本节只锁呈现规则。
版本历史
| 版本 | 日期 | 改动 |
|---|---|---|
| v1.4 | 2026-10-13 | 状态面板改名批补漏（用户质询发现——原改名批漏扫本文件：批内 grep 路径误写 design/ux/〔不存在〕致假阴性「零命中」）：正文两处换代（双入口框架句+秘宝匣段「状态面板只读概览」，均括注改名来历；版本历史行内旧名按历史记载保留）。机制零改动 |
| v1.0 | 2026-09-30 | 首版落文（审计拍板点 4A 裁决：乙案新建+元进度配套更改；9A 视觉终稿实态成文） |
| v1.1 | 2026-10-09 | 文档正确性审查批：①头注「M-3 迭代 9」前缀按里程碑口径删除只留「迭代 9」；②口径节「暂停层入口未实装（随 HUD 批 M-4）」过期订正——暂停层只读入口已实装（迭代 17 卡③，2026-10-06，实机目检待用户） |
| v1.2 | 2026-10-10 | 「道具工坊」改名「秘宝匣」扫改（2026-10-10 天赋树设计会话裁）：定位句与三柜台列两处。机制零改动 |
| v1.3 | 2026-10-12 | 迭代 22 反哺落文批（实现报告 §三⑤，用户裁「落文」）：新增「秘宝匣柜台呈现细则」节（购买钮禁用态/条件进度/名后缀·档位/装配行档位标签/未解锁禁装/悬停 desc/空目录合法态/暂停层 12 行只读概览）；三柜台列秘宝匣行换代指路；退役/封存件呈现语义口径随旧目录删除消解（历史语义留版本历史）。机制零改动 |