feat(flow): 停点前移批——LevelRunner 入口停点模式(opt-in defer+零RNG漂移)+关卡开局即出图选路+A 区进度条退役(转 C 区钱包行,底行 548)+GDD 四文件对齐三区+art-bible 连带+06 条目解决移除（用户拍板 2026-09-23，台账 142）
This commit is contained in:
DKChan committed
1 parent
c22174274c
commit
8eddcdd5a7
19 files changed
+190
-208
No files matched your search
+17
-17
@@ -2,7 +2,7 @@
|
||||
|
||||
> **Status**: Complete — /ux-review 修订落稿（2026-09-12，blocking 7 项已修，待复检）
|
||||
> **Author**: user + ux-designer
|
||||
> **Last Updated**: 2026-09-20（敌人卡形态裁决收口：全站桩形态拍板——主角与敌人均无框立绘+底座、状态小图标挂血条下、卡片式退役；B 区行/组件表/线框图/OQ4 同步改写——见文末修订记录）
|
||||
> **Last Updated**: 2026-09-23（停点前移批：A 区关卡进度条退役、布局四区→三区、C/D 底行 548、关卡画面为选路常驻枢纽——见文末修订记录）
|
||||
> **Platform Target**: PC (Steam)——Keyboard/Mouse 主（全部操作纯鼠标可完成）、Gamepad Partial 非 MVP、Touch None（同 technical-preferences）
|
||||
> **上游修订依赖**: 弃图刷新挖掘期受理已随布局决策 4 落稿上游（2026-09-12：行动经济 Active 受理 + 每轮上限 2 次、排雷玩法 Active·仅刷新路径装板、战斗结算 `refresh_board` 编排 + 恒 same_board、registry `rap_rules` 同步——见 OQ11）
|
||||
> **Template**: UX Spec
|
||||
@@ -28,7 +28,7 @@
|
||||
## Player Context on Arrival
|
||||
|
||||
- **首次到达**：从关卡首节点（战×2 的第一战）进入。MVP 无引导流，chord 肌肉记忆提示等非模态提示承担首次教学（见 §States）
|
||||
- **到达前刚在做**：关卡节点图上点击战斗节点（LevelRunner 推进）；或上一场战斗胜利后点下一节点
|
||||
- **到达前刚在做**：关卡画面（选路覆盖层常驻形态）上点击战斗节点（LevelRunner 推进）；或上一场战斗胜利后返回关卡画面再选下一节点
|
||||
- **情绪状态**：棋手式清明专注（art-bible §2.1，能量 2/10）——挖掘期画面必须无杂音；结算期转为清算爽感（7/10）
|
||||
- **到达方式**：游戏推进送入（非自愿导航），进入即处于挖掘阶段（棋盘已 install、初始 3×3 已展开、小人出生）
|
||||
|
||||
@@ -39,13 +39,13 @@
|
||||
## Navigation Position
|
||||
|
||||
```
|
||||
存档 → 冒险 → 关卡（节点图，关卡节点地图 lite） → 【战斗屏】
|
||||
├─ 胜利 → 节点奖励/恢复覆盖层 → 下一节点（下一场战斗屏）
|
||||
存档 → 冒险 → 关卡（关卡画面 = 节点图选路常驻枢纽） → 【战斗屏】
|
||||
├─ 胜利 → 节点奖励/恢复覆盖层 → 返回关卡画面选下一节点（→ 下一场战斗屏）
|
||||
├─ 胜利（末节点 Boss）→ 关卡结算（level_clear，清库反馈义务载体 = 魔法道具背包，随魔法道具 P0 落地）→ 下关
|
||||
└─ 失败 → 冒险终结 → 返回存档/营地
|
||||
```
|
||||
|
||||
战斗屏是**上下文相关屏**（仅由战斗节点进入），非顶层常驻。关卡内节点进度常驻屏顶（A 区），玩家始终知道自己身处图中第几环。
|
||||
战斗屏是**上下文相关屏**（仅由战斗节点进入），非顶层常驻。关卡内节点进度常驻关卡画面（选路覆盖层的常驻形态，节点态即进度呈现：已过暗金、当前金、候选通道亮金、Boss 旗朱描边），战斗屏零进度承载——战斗结束返回关卡画面，玩家始终知道自己身处图中第几环。
|
||||
|
||||
- 上游屏：关卡节点图（分支节点图形态，切片第一关为单链特例）
|
||||
- 下游屏：节点奖励/恢复覆盖层（NodeOverlay，已有 demo 组件——建议后续单独出 spec `design/ux/node-reward.md`）
|
||||
@@ -60,7 +60,7 @@
|
||||
| Entry Source | Trigger | Player carries this context |
|
||||
|---|---|---|
|
||||
| 关卡战斗节点 | 点击节点（LevelRunner 推进 encounter） | 携带 HP（跨战斗延续）、RAP=0（战斗域新开） |
|
||||
| 上一场战斗胜利 → 下一节点 | 同上 | 同上 |
|
||||
| 上一场战斗胜利 → 返回关卡画面 → 选下一节点 | 同上 | 同上 |
|
||||
|
||||
**离开**：
|
||||
|
||||
@@ -83,7 +83,7 @@
|
||||
2. **本轮行动资源**：AP 余量（决定还能挖几格）、停手/弃图刷新按钮——紧贴棋盘上缘（动作发生地）
|
||||
3. **战果兑现面**（结算期为第一注视点）：敌人血条变化、逐行结算明细、高光（完美排雷/标中旗）
|
||||
4. **规划面**（边缘注视，常读）：HP、攻击、RAP 池、状态效果（己方/敌方）、敌人意图徽标与顺位
|
||||
5. **进度语境**：轮次/阶段指示、关卡节点进度、图例入口
|
||||
5. **进度语境**：轮次/阶段指示、图例入口（关卡节点进度常驻关卡画面，战斗屏不承载——见 Navigation Position）
|
||||
|
||||
依据：挖掘期玩家视线锚定棋盘（art-bible §2.1"视线始终被数字牵引"）；结算期视线转向战斗画面区（§2.2"兑现光带逐行横扫"）。规划信息必须常读但不得抢焦——这正是用户布局图三分下栏的合理性：**动作区居中，规划区两翼**。
|
||||
|
||||
@@ -93,10 +93,11 @@
|
||||
|
||||
| 区 | 位置与尺寸 | 内容 |
|
||||
|---|---|---|
|
||||
| **A 关卡进度条** | 全宽 × 28px 顶栏 | 节点图步进（战 → 战 → 赏 → 战 → 战 → 疗 → 王——文字签槽，对应 battle/reward/rest/boss 四型节点），当前节点奖励金高亮、已过暗金、Boss 旗朱描边 |
|
||||
| **B 战斗画面** | 全宽 × 252px | 主角站桩立绘（左）+ 兑现演出区（中）+ 敌人站桩立绘 ×1–3（右）——**全站桩形态（2026-09-20 用户拍板，敌人卡形态待办裁决收口）：主角与敌人均为无框立绘+底座，零卡片**；底部结算明细带（24px 摘要 / 结算期 84px 实时流）；顶部中央轮次·阶段指示 |
|
||||
| **C 角色信息** | 左下 240px × 520px | HP 条、攻击值（含修正显示）、RAP 池、状态效果槽（固定 4 槽）、小人立绘占位 |
|
||||
| **D 扫雷图** | 中下 ~1036px × 520px（原右下面板删除后横向加宽，吸收其宽度） | 顶部 AP 条（44px：左——AP 点阵 + 停手按钮；右——图例按钮 + 弃图刷新按钮〔雷图右上角，2026-09-12 拍板〕）；棋盘主体（居中，格 36–45px 见方）；toast 槽（上缘内侧） |
|
||||
| **C 角色信息** | 左下 240px × 548px | HP 条、攻击值（含修正显示）、RAP 池、状态效果槽（固定 4 槽）、小人立绘占位 |
|
||||
| **D 扫雷图** | 中下 ~1036px × 548px（原右下面板删除后横向加宽，吸收其宽度） | 顶部 AP 条（44px：左——AP 点阵 + 停手按钮；右——图例按钮 + 弃图刷新按钮〔雷图右上角，2026-09-12 拍板〕）；棋盘主体（居中，格 36–45px 见方）；toast 槽（上缘内侧） |
|
||||
|
||||
> 布局为 B/C/D 三区——关卡进度条不在战斗屏（节点链进度常驻关卡画面，见 Navigation Position；字母不重编沿用 B/C/D）。
|
||||
|
||||
**布局决策 1（本 spec 最大决策，用户拍板）**：**常驻双舞台分屏**——战斗画面与扫雷图同屏常驻，挖掘期敌人待机可见，结算期不切场景。
|
||||
- 备选（已否决）：Peglin 式"结算时才切入独立战斗场景"——切换打断推理心流，且资产管线成本翻倍
|
||||
@@ -109,7 +110,6 @@
|
||||
|
||||
| 区 | 组件 | 类型 | 内容 | 交互 | 现有 demo 组件 |
|
||||
|---|---|---|---|---|---|
|
||||
| A | LevelStripView | 步进条 | 节点图 + 当前位置 | 只读（点击节点不可跳） | ✅ level_strip_view.gd 迁移 |
|
||||
| B | 主角站桩立绘 | 站桩（无框立绘+底座） | HP 条悬浮头顶、状态效果小图标一排挂血条正下方（形状+色相双通道、层数角标同 C 区状态槽键）；攻击值等规划数据仍归 C 区数据框（2026-09-20 全站桩拍板，英雄卡退役） | 只读 | HUDView 拆分改造 |
|
||||
| B | 敌人站桩立绘 ×1–3 | 站桩（无框立绘+底座） | 血条+顺位徽标悬浮头顶、状态小图标挂血条正下方（敌方 side-wide 增益各立绘同值呈现——蓄力/硬化/削弱/暴走/警觉；伏击层数通道随 2026-09-20 八型批退役——数据源 = 战斗结算流水经增益状态投影，敌人系统×4④；2026-09-16 敌人技能池批改型：行为环点拆除〔proposal §2.4〕，意图占位 = 本拍摇定结果的动画占位——普通攻击零表示 / 特殊技类型级提示，敌方增益〔蓄力/硬化〕入状态图标行）；死亡灰化加碎裂退场直接演在立绘上（2026-09-20 全站桩拍板，敌人卡退役） | 只读 | 新建 |
|
||||
| B | 轮次·阶段指示 | 标签 | "第 N 轮 · 挖掘中/结算中"（终局定格「战斗结束」；Boss 变体附 Boss 名） | 只读 | 新建 |
|
||||
@@ -149,13 +149,12 @@
|
||||
|
||||
### ASCII Wireframe
|
||||
|
||||
> **2026-09-23 停点前移批**：A 区关卡进度条退役，下方线框图为 B/C/D 三区（28px 纵向空间划归 C/D 底行 520 → 548；关卡内节点进度常驻关卡画面，战斗屏零进度承载）；旧四区线框留档于 git 历史。
|
||||
> **2026-09-20 全站桩形态改版**：敌人卡形态裁决收口（卡片式退役、主角与敌人均站桩——无框立绘+底座、状态小图标挂血条下），下方线框图 B 区已随裁决重绘；旧卡片式线框留档于 git 历史。
|
||||
|
||||
```
|
||||
1280 × 800 ────────────────────────────────────────────────────────────────────
|
||||
┌─[A] 关卡进度条 28px ─────────────────────────────────────────────────────────┐
|
||||
│ 战→战→赏→战→战→疗→王 (当前节点奖励金高亮，已过节点暗金) │
|
||||
├─[B] 战斗画面 252px ──────────────────────────────────────────────────────────┤
|
||||
┌─[B] 战斗画面 252px ──────────────────────────────────────────────────────────┐
|
||||
│ HP▓▓▓▓░ ①HP▓▓▓░ ②HP▓▓░░ │
|
||||
│ ⬆2 🛡1 [⚔特殊技] (普攻·零表示) │
|
||||
│ /小人\ 第 3 轮 · 挖掘中 伏×2 伏×2 │
|
||||
@@ -165,7 +164,7 @@
|
||||
│ │ ▸上轮: 主角攻击3→蛆虫-3 | 攻击+50%(1结算) | 警觉+1×2 … [展开明细▾] │ │ # 2026-09-17 数值压缩批：UI 示意文本同步（atk 7→3〔地精格数÷3 + L1 锚行；UX 示意按当前地精行值读〕、伏击 +3 → +1/层，幅度参考 data/tables/）
|
||||
│ └────────────────────────────────────────────────────────────────────────┘ │
|
||||
├─[C] 角色信息 240px ───┬─[D] 扫雷图 ~1036px ──────────────────────────────────┤
|
||||
│ 520px │ 520px │
|
||||
│ 548px │ 548px │
|
||||
│ ┌──────────────────┐ │ ┌─────────────────────────────────────────────────┐ │
|
||||
│ │ HP 42/50 ▓▓▓░ │ │ │ AP ●●●●●○○○ 5/8 │ │
|
||||
│ │ 攻击 6 (+50%) │ │ │ [⏹停手] [?图例] [↻刷新 8|剩2] │ │
|
||||
@@ -281,7 +280,7 @@
|
||||
| 敌单位 hp/顺位/摇定动作（pending_skill/type/name）/敌方增益/enemy_id/存活 | 敌人系统 只读面（经战斗结算呈现快照） | Read | 意图线索映射全局恒定（敌人系统×4②，技能池批三档口径）；**despawn 前捕获**（旧版台账 entry 17③——缺陷②教训） |
|
||||
| 状态效果投影（含空态/极性/溢出） | 增益状态 投影口径 | Read | 极性映射数据源 = 战斗结算 SettlementTable 效果语义，非 magnitude 符号（增益状态×③） |
|
||||
| 已开格奖励身份（奖励徽章） | 地图战斗资源 `query_identity`（经 board_view 身份解析只读回调，组合根注入） | Read | 已开格身份常读——挖掘期 Active 相位内有效；reward_id 全局恒定、禁止重掷；徽章绘制优先级见 §Component Inventory BoardView 行 |
|
||||
| 节点图/当前节点/HP 携带 | 关卡节点地图 lite · LevelRunner | Read | A 区进度条 |
|
||||
| 节点图/当前节点/HP 携带 | 关卡节点地图 lite · LevelRunner | Read | 关卡画面选路覆盖层节点态呈现（战斗屏零进度承载） |
|
||||
| 意图提交 | 排雷玩法 | **Write** | `settle_batch`（stop 亦经此——不直调行动经济） |
|
||||
| 弃图刷新 | 行动经济 | **Write** | `request_refresh`（挖掘期 Active 当场受理——布局决策 4 2026-09-12 上游已落稿；战斗结算 `refresh_board` 编排承载） |
|
||||
| 节点推进 | LevelRunner | **Write** | 胜利 overlay「下一节点」 |
|
||||
@@ -321,7 +320,7 @@
|
||||
|
||||
**布局与可读**
|
||||
|
||||
- [ ] 1280×800 与 16:9 全屏（canvas_items/expand）下四区无遮挡、无重叠、无内容裁切（棋盘 12×12 全部格子 + 数字完整可见）
|
||||
- [ ] 1280×800 与 16:9 全屏（canvas_items/expand）下三区（B/C/D）无遮挡、无重叠、无内容裁切（棋盘 12×12 全部格子 + 数字完整可见）
|
||||
- [ ] 进入战斗屏 ≤500ms 内可交互（棋盘 install 淡入完成后首格可点）；同屏 draw calls < 200（technical-preferences 预算）
|
||||
- [ ] 两种格态（已开格 / 未开格）灰度截图下一眼可辨（排雷玩法×6②）
|
||||
- [ ] 悬停光标区分移动/挖/旗三语义；可挖域（8 向相邻）常驻指示；非相邻格悬停显禁止反馈（排雷玩法×6③）
|
||||
@@ -404,3 +403,4 @@
|
||||
| 2026-09-15 | 雾格残留清理：格态收窄为已开 / 未开两态（删除雾图变体状态行、四格态 AC 与已开雾格 tint / 雾区全开信号两条 AC）；图例面板与 toast 槽去掉雾条目与雾首遇提示；BoardView 纹带、绘制优先级与色弱冗余改按通用变异纹带表述；`ux_hint_shown` 的 hint_id 枚举去掉 fog_first；输入义务与 §13 义务对照表去掉 地形变异×3 一项；目标感知示例与提示文案 OQ 措辞同步。本 spec 不装载被移除机制的呈现义务 |
|
||||
| 2026-09-16 | 格面资源批 UI 欠账收口（随 2026-09-15 可选类道具删除的代码收口同步文档）：① 布局四区化——删 E 区道具面板行、布局决策 2（道具窗口形态=右栏原位激活）整段删除（编号留空防交叉引用失锚）、ASCII 线框图重绘为 A/B/C/D 四区（D 区横向加宽 ~1036px）、A 区节点链示例改文字签槽实际渲染（战/赏/疗/王）；② States 删道具窗口态与零库存空态（「道包空空」）；③ 结算口径五段化（授予→增益/减益→战斗→衰减→判定）与明细行 10 类封闭协议（删 15 类行、四类行旧口径；「奖励未生效」行保留）；④ 交互/动效/事件表删道具窗口行、跳过按钮、`ux_window_choice`、`submit_window_selection`；⑤ 数据源登记删 `query_inventory` 与窗口载荷，奖励身份按现行 `query_identity` 只读回调口径校正；⑥ 验收清单删窗口断言、五区改四区、未生效类行改现行两型（溢出未生效/奖励未生效）；⑦ 关卡末清库反馈义务改载魔法道具背包（随魔法道具 P0 落地，本批不设计具体呈现）；⑧ OQ7（道具窗口原位激活）删除、OQ 重编号，「囤刀待机」等旧可选类措辞清理。本 spec 不装载被删除机制的呈现义务 |
|
||||
| 2026-09-20 | **敌人卡形态裁决收口（2026-09-20 用户看对照样张拍板，06 待办「敌人卡形态」解决移除——台账 99）**：全站桩形态定稿——① B 区主角与敌人均为无框立绘+底座（站桩式），**英雄卡/敌人卡组件整体退役，卡片式不再作为候选**；主角血条悬浮头顶、状态效果小图标一排挂血条正下方，敌人血条+顺位徽标悬浮头顶、状态小图标同款挂血条下；攻击值等规划数据仍归 C 区数据框（C 区不动）；② 布局表 B 区行、Component Inventory 英雄卡/敌人卡两行随裁决改写（敌方 side 池共享层数各立绘同值、意图动画占位等既有语义平移到站桩载体，不随形态改变）；③ ASCII 线框图 B 区重绘（旧"意图:爪击/环点"示意早已随行为环退役，本次一并清掉）；④ OQ4 改写为裁决已收口注记，对照样张存档 `production/mockups/`；呈现义务细节重述（受击/退场演出挂点等）随表现层升级批执行 |
|
||||
| 2026-09-23 | **停点前移批（冒险入口流程倒置修复，用户 2026-09-23 拍板；上位裁决 `docs/architecture/adr-0006-board-node2d-rendering.md` 与 `docs/architecture/board-node2d-migration-plan.md` §1，代码实装另批并行）**：① 布局四区 → 三区——删布局表 A 区关卡进度条行与 Component Inventory LevelStripView 行（LevelStripView 退役删除，节点链进度只留关卡画面，战斗屏零进度承载）；C/D 底行 520 → 548；ASCII 线框图重绘为 B/C/D 三区；② 新流程口径落文——关卡画面（选路覆盖层常驻形态）为关卡内常驻枢纽：Navigation Position 图、到达语境、Entry 表、信息层级第 5 层、Data Requirements 节点图行改「关卡开始即出图选路、战后返回关卡画面再选路」；③ AC 四区措辞改三区。**批内代拍板三项待追认**：① B/C/D 字母保持不重编；② 28px 纵向空间划归 C/D 底行（520 → 548）；③ 关卡画面进度呈现由选路覆盖层节点态承载（暗金已过 / 金当前 / 亮金候选通道 / 旗朱 Boss）、不另设进度条组件 |
|
||||
Reference in new issue
Block a user