Files
gplan-2/design/gdd/ux/camp.md
T
DKChan 7aee5eb71a docs(流程文档迁出GDD批): 待办清单与体验验证清单移到仓库根并去掉编号前缀
两文件是流水线流程件而非游戏描述件,此前住在 design/gdd/ 造成三处不适配:
gdd_lint 必须为它们逐条关掉体裁规则、格式权威却写在 doc-conventions §12、
与同族的 roadmap(在仓库根)分居两处。迁到根后按 roadmap.md 的无编号风格改名。

- 迁出:design/gdd/06-待办清单.md → 待办清单.md;07-体验验证清单.md → 体验验证清单.md
- 指向改写 53 个文件:GDD 各系统文档指路存根、四份规约、02 根索引、README/roadmap/AGENTS
- 两份清单自身 74 处出站链接按新基址重指(../art → design/art、systems → design/gdd/systems)
- gdd_lint:待办/体验验证两文件的 R1/R3/R5/R7 豁免行随迁删除(已脱离扫描面),后门表清零
- pipeline_gate 默认路径、log_analysis/render_gate 称谓、repo_structure_audit 根文件白名单同步
- 保护面补写:两份清单列入实现批禁写清单(AGENTS 两类批条 / process-conventions §12 / 架构文档域表),
  条目状态只由流水线各段推进
- 范围外未动(用户令「全不碰」):reports/ 与 design/research/ 的 22 处历史指向、game/ 两处注释
2026-10-21 00:09:40 +08:00

4.1 KiB
Raw Blame History

营地覆盖层 UX spec(camp)

状态:v1.5(2026-10-15 简明技术中文用语规范批:文头状态行按实态订正;spec 基线=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);
  • 双入口框架(主菜单入口+局内状态面板只读入口〔2026-10-13 由「暂停层」改名——游戏非实时无暂停语义〕)的需求面归元进度「解锁双入口框架」节;状态面板入口已实装(2026-10-06 迭代 17 卡③〔时名暂停层〕——实机目检待用户,待办清单登记条在册),其呈现面不归本 spec。

秘宝匣柜台呈现细则(迭代 22 实装态,2026-10-12)

秘宝匣柜台=解锁面+同调装配段两部分(数据投影=treasure_shop_status 单点):

  • 解锁面:逐件一行——钥石购买件带购买钮(余额不足=禁用态不隐藏;已解锁=钮消失转已解锁态);条件解锁件带条件进度呈现(计数键现值/阈值,如「通关 2/3」);件名后缀·档位(普通/优秀/稀有);悬停浮窗=行 desc 直读。
  • 装配段(同调装配):装配行带档位标签(件档≤格档约束的可见面);未解锁件禁装(列表不可选);满位禁选;每件固定占 1 格。
  • 空目录合法态:白板档(12 件全未解锁)柜台零可装行=合法态非缺陷(装配面空目录断言 V18 在役)。
  • 状态面板只读概览:局内状态面板秘宝匣段=12 行只读清单(解锁态+装配态概览,零写入口——装配只在营地)。
  • 机制权威=元进度/秘宝.md;本节只锁呈现规则。