DKChan
081027c579
①死链修复7处：秘宝.md 10-10目录归位批漏网5处改指 systems/跨局循环/秘宝.md（01-核心循环v1.6行/02-系统清单v1.3行/奇物.md v3.5行〔连反斜杠路径一并改正〕/地形变异.md负责表+依赖表两行）+camp.md树面板行两处补../systems/前缀（天赋树/HUD框架）；数据配置.md:221存量挂账维持（iter19基线在册） ②gdd_lint三文件清零：01-核心循环 R10版本历史v1.5同号顺延（10-10分界尺行→v1.7）+R5「生命周期轴（五档）」节补五档嵌套字符画〔报错原文误记「死了之后」系工具prev/cur错位——tools/gdd_lint.py R5报错节名一行修正〕+「死了之后」节顺带补死亡重开环字符画；02-系统清单 R6术语表行多余版本列摘除+R3三行状态格改写现行白话句并换代（天赋树v0.4换代定稿29节点/武器锻造v0.2/奇物27件扩容后）+版本v1.21；03-内容规模 R1超长段拆两段+目录计数换代15→12件（普通7/优秀3/稀有2——回能器删/换装券撤/第四只手删三轮漏网面）+版本v1.3 闸：gdd_lint 9文件2不通过（=06/07基线存量，01/02/03转绿）/doc_link死链2（=06:505 worktree环境假象待主区复验+数据配置221存量）/熵增PASS；版本行01 v1.8/02 v1.21/03 v1.3
34 lines
3.6 KiB
Markdown
34 lines
3.6 KiB
Markdown
# 营地覆盖层 UX spec（camp）
|
||
|
||
> 状态：v1.1（2026-09-30 审计拍板点 4A 用户裁决落文——乙案新建 ux spec+元进度配套更改；视觉终稿已随迭代 9 9A 段落码，本 spec 成文其呈现规则）
|
||
> 事实源：`game/presentation/views/camp_overlay_view.gd`（CampOverlay——9A 视觉终稿后实态）
|
||
> 机制权威：[元进度](../systems/跨局循环/元进度.md)（营地三柜台/钥石/永久强化——营地=界面壳、机制主语=永久强化）
|
||
> 相邻：[settlement-summary.md](settlement-summary.md)（最近冒险摘要数据同源）/ [level-map.md](level-map.md)（主菜单语境）
|
||
|
||
## 定位
|
||
|
||
营地是存档内消费钥石的枢纽场所（界面壳，非机制实体——裁定见元进度）：主菜单营地独立入口进入，玩家在此用钥石换永久强化、查看秘宝匣解锁与最近冒险。本 spec 只锁呈现；机制（定价/解锁/入账）全部归元进度。**循环层级：存档级（大循环/局外）呈现面**——本层只在存档语境可达（主菜单入口），冒险进行中不可达。
|
||
|
||
## 布局与交互
|
||
|
||
- 石纹全屏底（样张 v2 冻结件，浅 dim 透出）+ 顶栏铭牌与钥石徽（余额常驻）。
|
||
- 三柜台列：属性锻造（三档行：等级/价格/购买钮）、秘宝匣（行：解锁进度与状态呈现——「已解锁·能力封存中」=deferred 件、「已退役」=retired 件）、奖励格图鉴（结构位）。
|
||
- 树面板（图鉴柜台下段，现役程序占位）：营地内天赋树的节点购买与 Fork A/B 面切换承载——系统现行事实源=[天赋树](../systems/跨局循环/天赋树.md)（33 节点在役），呈现终稿归 [HUD框架](../systems/表现与支撑/HUD框架.md)；信号 `tree_buy_requested` / `tree_fork_toggled`。（本行 2026-10-09 补登——树侧跨文档欠账清偿：此前本 spec 零树面板登记。）
|
||
- 底栏：关闭钮 + 操作注记；最近冒险收底栏条带（逐行只读账面）。
|
||
- 购买意图 `buy_requested(attr)` 经组合根转发 MetaProgression（纯视图 setter 面——零核心写调用、零账本持有）；购买成功 `refresh_camp` 就地重刷（零重建回流）。
|
||
- 开合与开始层互斥：打开本层前由组合根隐藏开始层（遮挡纪律 2.3——开始覆盖层非模态且树序在后）。
|
||
|
||
## 口径
|
||
|
||
- 呈现数据源 = MetaProgression 只读投影经组合根喂入；本层不持有账本、不算价。
|
||
- 退役/封存件呈现语义（探宝罗盘「已退役」；显影尘/地穴全图卷「已解锁·能力封存中」）为本层职责——2026-09-30 前该语义无 spec 权威定义（node-reward.md 曾悬空指认），随本 spec 落位。
|
||
- 双入口框架（主菜单入口+局内暂停层只读入口）的需求面归元进度「解锁双入口框架」节；暂停层入口已实装（2026-10-06 迭代 17 卡③——实机目检待用户，06 登记条在册），其呈现面不归本 spec。
|
||
|
||
## 版本历史
|
||
|
||
| 版本 | 日期 | 改动 |
|
||
|---|---|---|
|
||
| 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 天赋树设计会话裁）：定位句与三柜台列两处。机制零改动 |
|