rulings-4a-4b-5: 三裁决执行——①4A=乙+元进度配套:新建 ux/camp.md v1.0(存档级呈现面:三柜台/钥石徽/退役封存件状态语义)+元进度解锁双入口节更新(spec指路+9A终稿已落)+node-reward:22悬空指认修复;②4B=甲+乙:新建 ux/shop.md v1.0+关卡节点地图商店覆盖层呈现编排小节+level-map不覆盖清单对齐;③拍板点5=三分工原则(GDD概念/ArtBible美术/UX设计)裁甲:HUD框架立「可挖域指示(接触带微光)」节(五要素,生命周期按代码实态set_dig_glow_enabled=挖掘期门控)与类型微光成对;④新增拍板点11呈报=元进度树位结构性问题(用户立项,三案:甲第五循环目录/乙域声明/丙仅索引;分析三实据)⑤02索引补camp/shop+报告4A/4B/5收口记录+孤儿清零+流程义务段更新;doc死链闸=新文档零死链

This commit is contained in:
DKChan committed 2026-09-30 16:38:41 +08:00
1 parent 6610b22f62
commit dfd2eac0f2
9 files changed
+113 -21

No files matched your search

+2
View File
@@ -68,6 +68,8 @@
| `level-map.md` | 关卡画面 UX spec:选路枢纽三停点布局、GP 常驻徽章、交互映射与拍板点 | 占位升格版·视觉终稿后置 |
| `node-reward.md` | 节点奖励屏 UX spec:奖励节点三选一构筑点、可用池与池空直通(切片期过渡形态,随同调实施批退役改写) | v1.0(2026-09-29 本行 2026-09-30 补登) |
| `settlement-summary.md` | 结算总结 UX spec:战斗总结结算(战斗胜利面)与冒险总结结算(冒险终结面)——两面分节的纯呈现轻量 spec | v1.0·纯呈现已实装面成文 |
| `camp.md` | 营地覆盖层 UX spec:三柜台呈现、钥石余额、退役/封存件状态语义(存档级/局外呈现面) | v1.0(2026-09-30 拍板点 4A 落文;9A 视觉终稿实态成文) |
| `shop.md` | 商店覆盖层 UX spec:三商品卡全陈列、GP 余额、购买/离开(中循环节点兑付呈现面) | v1.0(2026-09-30 拍板点 4B 落文) |
## 子系统命名对照表(中文规范名 ↔ 英文代号)
+1 -1
View File
@@ -94,7 +94,7 @@
### 解锁界面:双入口框架
(2026-09-18 拍板)主菜单设营地独立入口(消费钥石、查看与管理永久强化);局内暂停层也可查看钥石余额与已解锁清单(只读)。钥石余额在 HUD 常驻展示。交互与视觉实现归[HUD 框架](../表现与支撑/HUD框架.md)协作批,且以表现层样张过审为前置——本批只锁框架,不动实现。
(2026-09-18 拍板)主菜单设营地独立入口(消费钥石、查看与管理永久强化);局内暂停层也可查看钥石余额与已解锁清单(只读)。钥石余额在 HUD 常驻展示。呈现 spec 已出生:[ux/camp.md](../../ux/camp.md) v1.0(2026-09-30 审计拍板点 4A 裁决落文——退役/封存件「已退役/已解锁·能力封存中」呈现语义随 spec 落位);视觉终稿已随 M-3 迭代 9 9A 段落码(2026-09-30)。本节锁框架与需求,呈现细节归 spec;局内暂停层入口未实装(随 HUD 批 M-4)。
### 单局循环零依赖:排期边界的推论
@@ -66,6 +66,8 @@
呈现侧口径(2026-09-17 用户拍板):节点图的画面表达走**方块地牢观感**——节点画成地牢房间的方块、连线画成通道——但逻辑拓扑就是本文的节点图,不产生任何额外选路或探索语义。关卡画面本体即节点链进度的呈现载体(选路覆盖层的常驻形态,节点态直接读图:已过暗金 / 当前金 / 候选下一跳通道亮金 / Boss 紫赤描边(旗朱→紫赤 2026-09-26 封印紫批)),不另设进度条组件;视觉规格归 [HUD 框架](../表现与支撑/HUD框架.md)。
**商店覆盖层呈现**(呈现 spec:[design/gdd/ux/shop.md](../../ux/shop.md) v1.0,2026-09-30):兑付 = 打开商店覆盖层(模态)——三商品卡全陈列、GP 余额读数、购买/离开;离开后兑付确认回选路。本节锁编排面(何时开/何时关/回选路),呈现细节归 spec;定价数值归[难度曲线与Boss](难度曲线与Boss.md)(shop.tres)。
### 行进与选路:兑付后确认,选路就是行进
**结论**:关卡里没有一次自动前进——每一步都是玩家亲手走出来的。关卡画面(节点图,选路覆盖层的常驻形态)是单关内的常驻枢纽:关卡开始即呈现,此后每次兑付结束都回到它再选路。
@@ -142,6 +142,18 @@ HUD框架站在玩家与全部玩法系统之间:挖掘期它是输入的翻
口径史注记(防复发):本概念曾只活在 06-待办清单登记与 art-bible 复述里,「常显」「全部未开格」等无范围表述于 2026-09-30 酿成理解事故;用户裁决「英雄周围 8 格」为正确口径并落位本节。教训=概念必须落地正主文档,零散复述不是定义。
### 可挖域指示(接触带微光):「这里能挖」的交互反馈光
> 本节是「接触带微光」(可挖域交互反馈光)的呈现规则正主(2026-09-30 用户裁决落位——目录职责三分工:概念/玩法内容归 GDD、美术风格指导归 art-bible、UI 设计归 UX;各目录只干职责内的事,引用走文档链接,不贴异域内容)。
| 要素 | 口径 |
|---|---|
| 定义与作用范围 | 接触带微光 = 可挖域的交互反馈光(「这里能挖」)——英雄格与可挖域(8 向相邻未开格;概念本体与动作合法性归[排雷玩法](../排雷循环/排雷玩法.md))接触面上的呼吸微光;与「未开格类型微光」同圈不同职责(类型微光=「这格是什么类型」,本光=「这里能挖」) |
| 画法 | 光画英雄格周界空间侧:正交邻墙=该侧整条边,斜向邻墙=共享角点+向两侧各延伸半条边;光只画英雄格一侧、不进墙格;色相=蓝族浅一档——画法细则归 [art-bible](../../../art/art-bible.md) §3.2 |
| 生命周期 | 挖掘期呈现且呼吸(挖掘期唯一在动元素——art-bible §2.1;相位门控 `set_dig_glow_enabled`,结算期停息);减动效开启=呼吸停格(静态保留指界功能);换图/装板随新可挖域重算 |
| 关联与边界 | 逐格指认=悬停金框(pattern 4 悬停预承诺——微光是常驻指界、悬停是意图预承诺,两概念分工);不携带类型/极性信息(那是类型微光的职责);零信息写入(纯呈现层) |
| 实装状态 | 已实装(呈现层现行在跑——2026-09-30 核证;程序化占位,画法终稿随样张批) |
### 视野迷雾:菱形灯光区与黑暗边界
> 本节是「视野迷雾」在全项目的唯一正主定义(2026-09-30 用户拍板立项):其他文档引用只许指路本节。定义一句话:**棋盘只完整渲染以角色为中心的菱形灯光区,区外一切呈迷雾黑暗,移动角色才逐步照亮**——像在洞穴里举灯探索。与已退役的「雾格」无关:雾格是格面机制(2026-09-15 退役),视野迷雾是纯呈现层机制,不改任何游戏数据。
+30
View File
@@ -0,0 +1,30 @@
# 营地覆盖层 UX spec(camp)
> 状态:v1.0(2026-09-30 审计拍板点 4A 用户裁决落文——乙案新建 ux spec+元进度配套更改;视觉终稿已随 M-3 迭代 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 件)、奖励格图鉴(结构位)。
- 底栏:关闭钮 + 操作注记;最近冒险收底栏条带(逐行只读账面)。
- 购买意图 `buy_requested(attr)` 经组合根转发 MetaProgression(纯视图 setter 面——零核心写调用、零账本持有);购买成功 `refresh_camp` 就地重刷(零重建回流)。
- 开合与开始层互斥:打开本层前由组合根隐藏开始层(遮挡纪律 2.3——开始覆盖层非模态且树序在后)。
## 口径
- 呈现数据源 = MetaProgression 只读投影经组合根喂入;本层不持有账本、不算价。
- 退役/封存件呈现语义(探宝罗盘「已退役」;显影尘/地穴全图卷「已解锁·能力封存中」)为本层职责——2026-09-30 前该语义无 spec 正主(node-reward.md 曾悬空指认),随本 spec 落位。
- 双入口框架(主菜单入口+局内暂停层只读入口)的需求面归元进度「解锁双入口框架」节;暂停层入口未实装(随 HUD 批 M-4),本 spec 不覆盖。
## 版本历史
| 版本 | 日期 | 改动 |
|---|---|---|
| v1.0 | 2026-09-30 | 首版落文(审计拍板点 4A 裁决:乙案新建+元进度配套更改;9A 视觉终稿实态成文) |
+1 -1
View File
@@ -6,7 +6,7 @@
> **Platform Target**: PC (Steam)——Keyboard/Mouse 主,全部操作纯鼠标可完成(同 [battle.md](battle.md))
> **Template**: UX Spec
> **覆盖范围**: 独立屏形态(关卡停点全景)· 入口停点 · 岔路停点 · 单链停点 · 放弃冒险入口
> **不覆盖**: 节点覆盖层(NodeOverlay——奖励/恢复兑付反馈,呈现义务随魔法道具内容重定批交付)、商店覆盖层、关卡结算屏([level-clear.md](level-clear.md))、战斗屏([battle.md](battle.md))
> **不覆盖**: 节点覆盖层(NodeOverlay——奖励/恢复兑付反馈,spec:[node-reward.md](node-reward.md))、商店覆盖层(spec:[shop.md](shop.md))、关卡结算屏([level-clear.md](level-clear.md))、战斗屏([battle.md](battle.md))
> **机制权威**: [关卡节点地图](../systems/冒险循环/关卡节点地图.md)(选路、兑付、停点语义;节点图逐局随机的来源另见[关卡节点图生成](../systems/冒险循环/关卡节点图生成.md)——只换图的来源,不换本屏的呈现语义);**系统契约**: [HUD框架](../systems/表现与支撑/HUD框架.md)(订阅纪律、模态层级、可访问性基线)
---
+1 -1
View File
@@ -20,7 +20,7 @@
## 口径
- 可用池 = aux 活行 ∩ 工坊解锁集(拍板③甲「解锁→进投放池」同源门控——未解锁不入奖励池与掉落池)。
- 退役件(探宝罗盘)/失义件(显影尘/地穴全图卷)不入池;营地呈现「已退役 / 已解锁·能力封存中」。
- 退役件(探宝罗盘)/失义件(显影尘/地穴全图卷)不入池;营地呈现「已退役 / 已解锁·能力封存中」(呈现 spec:[camp.md](camp.md) v1.0——2026-09-30 拍板点 4A 落位,原悬空指认解除)。
- 库存语义=关卡域(跨战斗延续、关卡末清空+快照反馈);使用=挖掘期两步交互(C 区槽选中→棋盘目标格)。
## 版本历史
+28
View File
@@ -0,0 +1,28 @@
# 商店覆盖层 UX spec(shop)
> 状态:v1.0(2026-09-30 审计拍板点 4B 用户裁决落文——甲+乙并行:编排面小节落关卡节点地图、呈现面独立成文)
> 事实源:`game/presentation/views/shop_overlay_view.gd`(ShopOverlay)
> 机制权威:[关卡节点地图](../systems/冒险循环/关卡节点地图.md)(商店房编排:每关恰 1/Boss 前一位必经/兑付触发);定价数值归[难度曲线与Boss](../systems/冒险循环/难度曲线与Boss.md)(shop.tres,provisional)
## 定位
商店覆盖层是商店房节点的兑付呈现面(**冒险-关卡中循环节点功能**):行进至商店房打开,玩家用 GP(显示名「金币」)购买三属性 flat 档商品,离开后兑付确认回选路。本 spec 只锁呈现;编排与定价归机制文档。
## 布局与交互
- 模态覆盖层(dim + 居中):标题「商店」/ 金币余额(GP 读数)/ 三商品卡全陈列(显示名·档位文案·现价·已购档数)/ 购买按钮(余额不足禁用置灰——pattern 8 禁用态即理由)/ 离开按钮。
- 购买意图 `buy_requested(product_id)` 经组合根转发 runner;成功后 `refresh_state` 就地重刷(现价=基价+关级加成+步长×已购档数,runner 现算)。
- 离开 → 关卡画面兑付确认回选路(零自动推进)。
- 无刷新、无三选一、全陈列(GP+商店房批裁决);商旅信物类刷新件与该校裁决冲突,留同调实施批二选一(同调提案 §5)。
## 口径
- GP 余额读数 = runner 钱包投影(账本归[冒险结构](../systems/冒险循环/冒险结构.md) GP 冒险账本);本层不算账。
- 与关卡画面 GP 常驻徽章的关系:进店语境余额与选路常驻总量不同义(本层带购买语境),不构成重复展示——钥石「进账/存量」拆名逻辑同款。
- 购买确认交互:现行直接购买(无二次确认步);是否需破坏性确认异位(pattern 7)未裁决,本 spec 只登记现状不立新裁。
## 版本历史
| 版本 | 日期 | 改动 |
|---|---|---|
| v1.0 | 2026-09-30 | 首版落文(审计拍板点 4B 裁决:甲+乙并行——编排面小节落关卡节点地图、呈现面独立成文) |