gplan-2/design/gdd/d1-hud-framework.md

D1 HUD 与界面框架（HUD & UI Framework）

状态：Designed · 版本：v2 · 2026-09-14 · 作者：user + agents 承载支柱：P1 主（"我算对了"看得见的感知面）· P2 主（逐行归因的呈现半边）· P4（地牢氛围容器） · 层级：Layer 4 Presentation · Milestone MVP（设计顺序第 10 位） 一句话：D1 把 A1–B4 的全部玩法事实变成玩家看得见、点得动、归因得了的界面——零玩法状态的双层边界呈现框架。 推演件：design/gdd/analysis/d1-hud-framework.md（本文件只收结论，理由在那里）

设计目的

D1 是项目首个零玩法上游假设的表现层系统：战斗屏（MVP 唯一玩法屏，五区常驻双舞台布局，屏级 spec = design/ux/battle.md）+ 一族共享呈现设施——toast 提示体系、模态覆盖层家族、输入翻译、模态层级管理、面向呈现的信号载荷契约、ux 遥测。少了 D1，A2 的三事件流没有读者、B1 的流水协议没有呈现面、27 项上游呈现义务没有兑付点。

1. 「我看见的每一步都是真的」——四种格态一瞥可辨、每次拒绝可感知、结算逐行可归因（P1 感知面）。
2. 「这个结果是我哪步扫雷带来的」——结算明细逐行兑现且每行带来源标注；四类未生效行不静默、零值行不被吞（P2 呈现半边）。
3. 「挖掘期一块干净的玻璃，结算期一场丰收」——能量档转场由 D1 承载：挖掘 2/10 → 结算 7/10 → 清图 8/10 → 失败 1/10（P4 容器）。
4. 「完美被加倍看见」——完美排雷全屏喝彩级反馈、标中旗与 H2 清图奖励金框行（高光节拍）。
5. 界面绝不替玩家思考、绝不静默改判、绝不用装饰伪装逻辑差异——玩家对 D1 的正确感觉是"一块干净的玻璃"。

系统范围

负责：

• 五区布局落位与常驻组件呈现形态（战斗屏）
• 输入翻译（鼠标意图 → A2 意图对象）与单意图帧收集
• toast 提示体系 / 图例面板 / 一次性提示
• 模态覆盖层家族（图例 / 明细回看 / 胜负终局）与模态层级纪律
• 13 项面向呈现的信号载荷 schema 与消费侧断言
• 命令式回执刷新面（零事件外发动作的界面刷新契约）
• 程序化占位策略与 art-bible §4.6 键位映射表挂接
• ux 遥测六行族（playtest JSONL ux 行）
• F1 呈现几何与 F2 可读性判据的执行

不负责：

• 任何玩法状态与玩法数值（各玩法 GDD；数值表归 D2）——读经核心只读面、写经组合根
• 合法性判定与机制语义裁定（A2 / A3 / B1 等上游系统）
• 屏级布局/组件/交互/动画时长的裁决权威（design/ux/battle.md）
• 美术裁决与终稿资产（art-bible / asset-spec 批）；动画密度（B5）
• 音频（D4）· 教学内容（D5）· 本地化文本生产（D6——D1 仅消费契约）
• 任何随机消费（呈现层零 RNG）

核心循环

玩家输入（D 区，仅挖掘期可交互；全部操作纯鼠标可完成——Gamepad Partial 非 MVP）
  │ 左键已开格 = 移动 ─ 左键未开相邻格 = 挖 ─ 右键 = 插拔旗 ─ 停手按钮 = settle_batch([stop])
  ▼
单意图帧收集（一帧内 collected 意图整批；stop 点击终结当帧收集；F4 语义序仲裁退为防御性兜底）
  ▼
组合根 ──► A2 settle_batch(intents)            [唯一写路径；零直调 A3]
  │
  ├─ 回执链（零事件外发动作：旗插拔 / 移动 / AP / RAP / 库存——规则 2 命令式回执）
  │    settle_batch 返回 → 组合根立刻重查只读面（current_board / A3 getter / query_inventory）
  │    → 视图 setter 只读注入 → 就地更新（字段级 setter，禁全量重建）
  │
  └─ 事件链（A2 cell_revealed / flag_judged → B1 按轮缓冲）
       ▼
     B1 结算编排（七段）→ 步骤流（13 类行协议——呈现层唯一订阅面之一）
       │
       ├─ 明细带：逐行来源标注「{行为} {值} → {目标}（来源）」→ 84px 实时流（挖掘期收起为 24px 摘要）
       ├─ 窗口锚点（授予段后、增益/减益段前）：E 区原位激活（usable_now 投影；空库存 skip 不弹窗）
       ├─ 高光：flag_hit 金框行 ─ clear_reward_h2 金框 ─ perfect 独立高光行（全屏喝彩级）
       ├─ 状态栏刷新（B3 零信号外发）：绑 B1 结算编排完成时点（命令式）
       ▼
     判定段 → 判定行（终局呈现数据锚）→ presentation_snapshot()（despawn 前捕获——规则 18①）
       ▼
     终局呈现（胜利金蜡封 / 失败暮蓝 overlay）→ 状态槽全清 + RAP 清零反馈（battle_over）
       ▼
     level_clear（关卡末）→ 库存清空反馈「剩余道具 ×N」→ 下一节点 / 返回（runner 推进，写经组合根）

出口	触发	呈现动作	约束
继续挖掘	settle_batch 回执、轮次未结束	命令式重查刷新对应面；明细带保持上轮摘要 1 行	每帧至多一批提交（单意图帧）
结算展示	round_end（A2 棋盘路径 / A3 stopped 直发——双发射源同构）	D 区锁输入（去饱和 + 金橙色相偏移、明度不变、数字保持全对比）；明细带展开 84px 逐行兑现；阶段指示→"结算中"；能量 7/10	呈现订阅面 = B1 步骤流；零直订 A2/A3
清图换图	cleared 判定	金粒喷泉 + 彩纸 3–5s 即收；H2 清图奖励行金框强调；随后换新图 install（200ms 淡入）	完美排雷高光叠加于清图瞬间之上
道具窗口	B1 授予段完成（窗口锚点信号）	E 区原位激活（规则 13）；选用/跳过 → 回结算流（结算阶段续）	空库存直接 skip 不弹窗、结算零停顿
战斗终局	判定行 verdict=win / lose	胜利 = 金蜡封 + 暖白金 overlay；失败 = 暮蓝 overlay（明度不变）；终局数据全部来自流水行 + presentation_snapshot()	出口 = 下一节点（win）/ 返回（lose）——写经组合根
关卡结束	level_clear 编排	库存清空反馈「剩余道具 ×N 随关卡结束清空」（N = 清空前快照计数）	与 battle_over 反馈不合并、时序不倒挂

呈现边界与数据通道

规则 1：界面只当翻译不当裁判——数值不写死、对错不自己判、核心数据不碰

1. D1 显示任何玩法数字时，全部从上游系统只读接口现读现显；不写死玩法数值。
2. D1 遇到"动作合不合法、结果算什么意思"时一律交上游裁定；只把裁定结果翻译成画面，不自行判对错。
3. 玩家改变游戏状态的操作（挖格 / 插旗 / 选道具），D1 只递话；写调用唯一发生在组合根一处。
4. 界面单元只做两件事：向外发信号、被 setter 注入数据后就地刷新（字段级 setter，禁全量重建）。

依据：视图单元九件套 = BoardView / HUDView / HudPresenter / BattleLogView / ItemWindowOverlay / NodeOverlay / LevelStripView / TunePanel / UiKit（切片九单元形态转正）；读表口径 = D2 Rule 1 对呈现消费面的适用；写路径唯一入口 = 组合根（ADR-0003 Key Interfaces）。无计算。

规则 2：界面听消息只走中转，不私接玩法系统的线

1. D1 永不直接订阅 A2 / A3 的通知；要听的消息全部由组合根接线转发，或直接来自 B1 步骤流信号与 runner 信号。
2. 棋盘 / AP / RAP / 库存等"不发通知"的数据面，D1 在动作调用返回后由组合根立刻重查只读面刷新（命令式回执）；不干等通知信号。

依据：订阅纪律固化自 ADR-0001；battle.md §Events Fired 的"呈现订阅 A2 三事件"表述按本条收窄为"经组合根转发或命令式回执"（冲突清单⑥，见 analysis 附录 C）。无计算。

规则 3：读数据只走登记过的口子，内部字段一律不碰

1. D1 要显示的每个数据只允许从成文读数清单（下表）拿；清单之外的私有字段直读一律禁止。登记载体 = registry d1_presentation_surface。

数据从哪来	允许读的口子
A2 扫雷	current_board()（格态/旗/小人/变异只读投影）、reveal_record()、compute_move_path(cell)（不可达返回空——预览与执行同源）
A3 行动经济	phase / ap / rap / last_round_end（getter-only）
B1 结算编排	presentation_snapshot() / is_battle_live() / stock_count() / query_reward_identity() + 步骤流信号
B2 战斗单位	hero_unit() / all_enemies() 投影
B3 / B4	零直读——经 B1 呈现面与流水投影（协作对象私有化）
runner	节点链 / 当前节点 / HP 携带（A 区）

依据：读接口白名单 = 上表（封装收口批 entry 39/40 转正）；接口漂移见 OQ3（analysis 开放问题）。无计算。

规则 4：界面的每个动作都走同一条提交通道，总闸只有组合根

1. 玩家在界面上能发起的每类操作各只有一条提交通道，全部先过组合根这道总闸再转给对应系统；不存在绕过总闸的第二写入口。每帧至多提交一批意图（规则 7）。

玩家动作	提交通道
挖掘 / 插拔旗 / 移动 / 停手	A2 settle_batch(intents)——停手也打包成 stop 走同一接口，不直调 A3
窗口里选道具	B1 submit_window_selection(窗口条目位置序)——传窗口条目位置，不传库存句柄
弃图刷新	组合根提交刷新意图 → B1 refresh_board 编排：A3 扣费 → A2 retire → A1 generate → A2 install → B4 roll_board
节点推进	runner

依据：窗口选择传位置序 = 切片缺陷④的契约修正；停手不经 A3 直调 = 义务 A2×6①。无计算。

规则 17：界面收到的每份消息，字段清单先写成合同

1. D1 消费的每一份跨系统载荷（事件 / 快照 / 回执 / 遥测行）都必须先把字段清单写成文（13 项，下表）；清单既是实现契约也是消费侧断言——逐字段断言防缺字段、防多字段（信号参数没有运行时类型检查）。

#	载荷	来源	字段 schema	状态
1	cell_revealed	A2	{cell, kind ∈ {safe,mine}, digit（仅 safe 携带，恒真透传）, variant_ids, channel ∈ {initial,chain,dig}, reward_eligible}	A2 Core Rule 2 已 schema——引用
2	flag_judged	A2	{cell, hit}（轮末判定批、行主序）	同上
3	round_end_board / round_end_stopped	A2 / A3	{path_tag ∈ {ap_exhausted,cleared}, continuation_hint ∈ {same_board,new_board}}（双发射源 payload 同构；信号实名 per ADR-0001）	同上 + ADR-0001
4	流水行 ×13 类	B1	公共 7 字段 type / source_class / origin_cell（板级行可空）/ round_index / display_name / value / highlight?（{flag_hit, clear_reward_h2, perfect_broken}） + 特有：伤害行/道具行（生效）→ target；效果行 → effect_id + pool_value；未生效四类 + 标旗未中行 → 聚合计数/批次字段；source_class 值域 ⊆ source_label_map 键集（B3 source_class ∪ {道具/判定扩展, enemy_action, flag_miss, hero_attack}）	B1 Core Rule 14 已 schema——引用+重述
5	结算快照	B1	presentation_snapshot() 返回（终局呈现数据面——despawn 前全量状态）；独立 settlement_snapshot 信号系切片实现、B1 GDD 未登记契约——D1 现行消费 = 步骤流判定行 + presentation_snapshot()；若需独立信号回 B1 修订批补登记（OQ3）	切片实现 / 契约待登记
6	意图回执	A2	ActionOutcome{accepted, outcome ∈ {executed, voided, rejected}, reject_reason ∈ {board_face, resource_face, phase, board_invalid}, sub_reason（仅 board_face：not_adjacent / target_revealed / target_concealed / flag_present / flag_absent / no_path / out_of_catalog）}	A2 已 schema——拒绝呈现数据源
7	资源面拒绝	A3	无载荷（try_spend / request_refresh 仅 bool + debug 诊断）——呈现文案按动作上下文映射（诚实登记：资源面原因客户端推断，双源可辨由"动作种类 + 拒绝源"组合承载）	A3 AC 前言口径——引用
8	窗口载荷	B1 组装	query_inventory 逐件 {item_id, source{cell,round}（不呈现于库存列表与 tooltip）, 行值快照投影, 状态 InStock/Used}（枚举序 = stock 受理序）+ usable_now（B1 守卫预判——满血治疗包 false）	B4/B1 已 schema——引用
9	奖励身份投影	B1 呈现面	query_reward_identity(cell) → {reward_id, category, tier} | null（引用级投影；未开格可查但 MVP 不呈现）	B4 AC-2 已 schema——引用
10	状态投影	B3 经 B1	query_active(side) 元素 = 六归因字段 + display_name + 授予时快照 (magnitude, unit)；有效值 = L×快照 magnitude	B3 已 schema——引用
11	单位投影	B2	敌单位七字段 enemy_id/hp/max_hp/atk/heavy_multiplier/pattern/cap + beat + 存活态；hero 投影 hp/max_hp/atk（经 hero_unit()/all_enemies()）	B2 已 schema——引用
12	零事件外发动作刷新面（命令式回执清单）	A2/A3/B3/B4	旗插/拔与移动成功（A2 零事件外发）→ settle_batch 回执后重查 current_board()；AP/RAP（A3 无推送）→ 每次写路径回执后重读 getter；状态效果（B3 零信号）→ B1 结算编排完成时点刷新；库存（B4 查询面）→ 写路径回执后重查 query_inventory / stock_count()	battle.md 更新触发注记——本行成文为契约
13	D1 自有遥测	D1	ux_round_input_ratio{ratio} · ux_round_exit{path_tag} · ux_refresh_attempt{result ∈ {accepted,rejected_rap,rejected_cap}, round_refresh_index ∈ [1,2]} · ux_window_choice{selected_item_id, usable_now, skip} · ux_reject{source ∈ {board,resource,phase}, sub_reason} · ux_hint_shown{hint_id}——写 playtest JSONL ux 行族（playtest_logger 扩展）	本 GDD 成文（新）

依据：口径对齐 A2 三事件先例；消费侧断言 = ADR-0001"信号参数无运行时类型检查"的缓解；AC-24 承载。无计算。

规则 18：对象销毁前先拍快照——界面永远不回读已销毁的东西

1. 核心对象销毁前后，D1 不准"回头查"核心内部——只许用三样东西：消息载荷自带的数据、销毁前已取好的快照、封装好的只读投影。

细则	内容
销毁前捕获	终局与死亡的呈现数据（血条归零、卡体灰化、判定行）在核心对象销毁前已进流水行与快照
载荷自包含	每行流水自带来源 / 值 / 目标——界面不按行序反推目标状态机、不回查容器补数据
生命周期态禁读	"战斗还能不能刷"只准问 is_battle_live() 与阶段投影，禁止读核心对象内部状态位

2. 敌卡死亡灰化后仍留场的呈现 = 就地更新保留的最后已知投影（规则 6）；不回读 Dead 句柄以外的任何东西。

依据：销毁时序 = B1 判定段先于 battle_over 清理序列（快照含 despawn 前终局）；自包含字段 = target / effect_id / pool_value / origin_cell；生命周期观测口经组合根；AC-20 静态扫描承载。无计算。

规则 20：切片里的临时名字统一换成正式名

1. D1 正式实现时，切片阶段的临时名换成本 GDD 正式名——只换名字、不改任何行为；can_request_refresh 不引入（上游 A3 没有这个接口）。

切片 provisional 名	GDD 正式名	载体
request_refresh_active()	request_refresh	A3 API（Active 相位受理——A3 Rule 11 现行口径）
can_request_refresh()	不引入（A3 无此 API）	入口可用性 = 组合根按只读观测量预判 + request_refresh 返回值兜底（规则 16）
refresh_max_per_round	refresh_cap_per_round	ActionEconomyTable 结构位（默认 2）——D2/registry 字段回写随实现批（A3 Schema 定稿节已预留）
during_round（A2 装板参数）	无独立参数（受理域语义）	A2 install_board 受理域增 Active·仅弃图刷新路径（B1 refresh_board 编排内）——A2 Core Rule 3
round_end（信号名）	实名 round_end_board（A2 面）/ round_end_stopped（A3 面）	ADR-0001 信号实名映射

依据：入口可用性 = 组合根按只读观测量预判 + request_refresh 返回值兜底（规则 16）；AC-25 grep 断言承载。无计算。

设计意图：呈现层零玩法状态、零写、零 RNG，是切片两起呈现层崩溃之后的结构性防线。

战斗屏布局与组件

规则 5：战斗画面分五区常驻同屏，棋盘与敌人不切场景

1. 1280×800 基座下（canvas_items/expand 拉伸），战斗画面固定分成五块常驻区域；战斗画面与扫雷图同屏常驻是硬形态：挖掘期敌人在上方待机可见、结算期原地展开明细，全程不切场景。

区	位置 / 尺寸	内容	数据源
A 关卡进度条	全宽 28px	节点链步进、当前高亮、已过暗金（LevelStripView）	runner
B 战斗画面	全宽 252px	英雄卡 + 敌人卡 ×1–3 + 轮次·阶段指示 + 结算明细带（24px 摘要 / 84px 实时流）	B2 投影 + B1 步骤流
C 角色信息	左下 240×520	HP / 攻击值含修正显示 / RAP 数据框（直角细线素面）+ 状态效果槽固定 4 槽 + 小人立绘占位	A3 getter + B3 投影（经 B1）
D 扫雷图	中下 ~760×520	AP 点阵条 44px（停手按钮居左、图例与弃图刷新按钮居右——刷新按钮置雷图右上角）+ BoardView 棋盘 + toast 槽（上缘内侧）	A2 呈现面
E 道具栏	右下 280×520	库存常读列表 + 窗口态原位激活	B4 库存载荷（经 B1）

依据：分区尺寸与组件落位的屏级权威 = design/ux/battle.md；拉伸模式 = ADR-0002；五区布局为结构冻结项（非调参 knob，修订走 GDD 流程）。无计算。

规则 6：敌人卡把"它是谁、下拍干什么、还剩几滴血"全写在脸上

卡面元素	玩家读出什么
敌像	这是谁——姿态即线索
血条	还剩多少血（hp/max_hp 数字可读）
顺位徽标	它第几个出手（固定顺位可读）
意图徽标	下一拍它要干什么——把即将执行的一拍的视觉状态摆出来；挖掘期全程可见，结算期不另设播片
行为环点	行动周期多长（环点数 = 环长）、现在走到哪（当前位置高亮）
状态槽	它身上挂着什么增益减益

1. 伏击层数是全体敌人共享的一个数——各卡显示同一个值（数据源 = B1 流水经 B3 投影）。
2. 敌人死亡 = 血条直角递减归零 → 卡体灰化 + 碎裂退场；禁止瞬间消失。
3. 战斗段被短路掐灭的重击不单独产行动明细行（从行序可推断）。
4. 敌卡刷新必须就地更新（字段级 setter），禁止逐行重建——全量重建会把死亡灰化态吞掉。

依据：敌像线索键 = art-bible §4.6.4；意图预告时序 = B2 Rule 8⑤；义务源 = B2×4④ / D1×4③④；禁瞬消 = B2 资产下限；就地更新 = 切片 entry 36 教训。无计算。

意图线索映射目录（B2×4① 成文载体——继承 battle.md 目录 + art-bible §4.6.4 键契约；资产定稿归 B5，本表为 D1 侧成文占位）

enemy_id（§4.6.4 冻结键集）	视觉状态（下一拍预告）	强度档位编码	环长编码
grub（蛆虫）	攻击 ×1 态	小体量墩形 = 轻击（§3.1 普通怪）	环点 1（单拍环——无蓄力态 = 每拍都动手）
ambusher（伏击兽）	攻击 / 蓄力 / 重击 ×3 态	垂直延伸体量 = 重击（heavy_multiplier 直觉）	环点 = 拍数；蓄力态在场 = 环里空一拍（"可以贪"）

• 预告时序 = 下一拍预告、挖掘期全程可见、结算期不另设意图播片（B2 Rule 8⑤）；精确数值只在结算明细兑现（B2 Rule 8④——图像不报数）。
• 映射键 = enemy_id，跨 run 恒定、禁重掷（B2 Rule 8③）；形状 + 色相双通道；蓄力姿态必须含可辨识蓄力记号（§4.6.4）。
• 资产需求下限三类（受击反馈 / 死亡表现 / 顺位标记）在程序化占位中先行（占位纹样挂键）；终稿归 B5/样张批。
• 键集注记：切片 DND 更名（goblin/bugbear/ogre_chief）与 GDD 键集 {grub, ambusher} 差异登记冲突清单②——键位映射表以 GDD 键集为锚，切片更名随 B2/C3 修订批对齐。

规则 21：弹层排队进出——打开哪层，哪层就真的能用

1. 全部模态弹层（图例面板 / 明细回看 / 胜利 overlay / 失败 overlay）走同一张登记序栈：统一入栈出栈、后开置顶、关闭逐层恢复；任何一层打开时，被它遮住的东西要么隐藏、要么锁输入。
2. 道具窗口不是模态：不入栈，但锁 D 区输入（规则 13）。
3. TunePanel 显式初始化为不可见；它是切片调试入口，正式侧归 C4 天赋树——C4 落位时退役；Playtest 诊断按钮（卡死转储）保留为调试设施。

依据：退役时点 = battle.md OQ10 承接；AC-21 承载。无计算。

战斗屏状态机

触发全部来自核心信号/回执——呈现层不自持玩法状态；"阶段"投影枚举 = {挖掘中, 结算中, 道具窗口}。

屏状态	进入触发	变化 / 出口
挖掘阶段（默认态）	轮次开始 / 结算完毕回 Active	D 区可交互（AP 条点亮、可挖域呼吸微光）；B 区敌人待机（意图徽标全程可见）；明细带收起为上轮摘要 1 行；能量 2/10
结算阶段	round_end（A2 棋盘路径 / A3 stopped 直发）	D 区锁输入（棋盘去饱和 + 金橙色相偏移，明度不变，数字保持全对比）；明细带展开 84px 逐行滚动；阶段指示→"结算中"；能量 7/10；B1 步骤流驱动逐行兑现
道具窗口态	B1 授予段完成（窗口锚点信号）	E 区原位激活（规则 13）；空库存直接 skip 不弹窗；选用/跳过 → 回结算流（结算阶段续）
清图瞬间	cleared 判定（round_end）	金粒喷泉 + 彩纸 3–5s 即收（§2.3）；H2 清图奖励行金框强调；随后换新图 install
完美排雷高光	B1 高光行（perfect_sweep）	全屏喝彩级：金光带加倍扫射 + 「完美排雷 ×2」横幅（叠加于清图瞬间之上）
标中旗高光	流水行 highlight=flag_hit	该旗化暴击弹道加重 + 明细行金框（当轮即兑付）
敌人死亡呈现	流水行击杀标记（target 字段）	该敌卡血条归零 → 灰化 + 碎裂退场（禁瞬消、就地更新）
胜利终局	判定行 verdict=win	金蜡封落于扫雷图区中央 + 暖白金 overlay + 判定行 + 状态槽全清反馈 + RAP 清零反馈；出口 = 下一节点（runner）
失败终局	判定行 verdict=lose	暮蓝氛围 overlay（明度不变）+ 旗化光点收回 + 判定行 + 明细回看 + 状态槽全清反馈 + RAP 清零反馈；出口 = 返回
Boss 遭遇变体	encounter=boss	战斗开始一次性紫赤影子爬棋盘 + 敌卡体量最大 + 阶段指示附 Boss 名
雾图变体	板含雾格	雾纹带 + 首遇提示（每 run 一次）+ 已开雾格 tint 残留 + 雾区全开合并域完成信号
空态：无状态效果	query_active 双侧空	状态槽隐藏、数据框上移补位（规则 11）
空态：零库存	关卡初 / 清空后	E 区「道包空空——安全格里藏着补给」（指引性空态，非报错）
调试变体	测试模式	TunePanel 入口（正式侧归 C4 退役）+ Playtest 诊断按钮

不变式：全部状态触发来自核心信号/回执——呈现层不自持玩法状态；模态子栈（规则 21 统一登记序）= 图例面板 / 明细回看 / 胜利 overlay / 失败 overlay——任一打开时遮挡物隐藏或输入锁定；非模态层 = toast（自动消退）与窗口态（锁 D 区）。

挖掘输入与棋盘可读

规则 7：鼠标点哪就是哪个意思，一帧内的操作合成一批提交

鼠标操作	翻译成
左键点已开格	移动（免费）
左键点未开的相邻格	挖
右键	插旗 / 拔旗
点停手按钮	提交 stop——本轮结束

1. 单意图帧：一帧内收集到的意图整批提交，点到停手当帧收集立即终结；F4 语义序仲裁只作防御性兜底（生产面造不出会乱序的输入）。
2. 悬停预承诺：光标按目标切换三种语义、目标格边框高亮——点下去会发生什么，先看见再点。
3. 可挖域常驻指示：小人八向相邻的未开格呼吸微光，是挖掘期唯一在动的元素。
4. 悬停不可挖域 = 禁止光标 + 每 run 一次提示「需先走近（点击已开格移动，免费）」。
5. 点击远格自动"先移动再挖"的复合意图本期不做（见 P1/P2 后置表）。

依据：光标三语义见「光标语义」；no_adjacent 提示见「一次性提示 hint_id」；义务源 = A2×6①③⑥。无计算。

规则 8：悬停已开的格，先画给你看小人会怎么走

1. 玩家悬停任何已开格时，D1 立刻把小人到该格的合法路径用蓝色细线点迹画出——它是合法性指示，不是穿行动画。
2. 移动执行用不超过 150 毫秒的短滑表现；不做"穿行动画轨道"。
3. 路径数据 = compute_move_path 的 BFS 结果（不可达返回空）——预览与执行同源。

依据：短滑 ≤150ms 与再议挂 playtest 观测（battle.md OQ5，knob = move_slide_ms）；义务源 = A2×6⑤（继承 battle.md 布局决策 D3）。无计算。

规则 9：四种格子一眼分得清，黑白截图也能逐格分类

1. 四种格态必须一眼可辨，灰度截图下也能逐格分类——这是左键双义的消歧前提（点已开格 = 移动、点未开格 = 挖），误挖不可逆（花 1 AP、可能触雷）。
2. 已引爆的雷格要"可通行可读"：已开的底 + 巢穴纹（危险红族）+ 可作移动目标的视觉线索。
3. 数字显示判定数据源 = variant_ids（digit 恒真透传、雾格隐藏呈现——A2 Core Rule 2）；呈现层禁读真实数字自行判定。

依据：绘制优先级栈 = 数字 > 小人 > 旗 > 徽章 > 变异纹理 > 底色，任何元素不遮挡数字、小人与旗不得覆盖文本（art-bible §1.2）；义务源 = A2×6②④。无计算。

四种格态（A2×6②——灰度截图逐格可分类）

格态	视觉构成	语义
已开 0 格	裸土地板	携带"八邻无雷"推理信息——与已开雾格必须灰度可判定区分（混淆即污染推理）
已开雾格	地板无字 + 底色层淡雾 tint 残留	雾格只是不显示；tint 为残留视觉锚（battle.md OQ8 采纳）
未开格	掩尘完整砖	左键 = 挖（1 AP）
未开雾格	掩尘砖 + 雾纹带	左键 = 挖；雾语义 = 无雷盲区（图例恒在条目）

光标语义（A2×6③⑤——悬停预承诺）

光标	悬停目标	伴随指示
移动箭头	已开格	compute_move_path 路径蓝细线点迹（规则 8）+ 目标格边框高亮
挖镐	可挖未开格	目标格边框高亮（可挖域另有常驻呼吸微光）
旗形	旗插拔语义	目标格边框高亮
禁止	不可挖域	+ 首 run 一次 no_adjacent toast

规则 15：雾格有雾的样子，整片雾开完只报一次"开完了"

1. 未开的雾格 = 掩尘完整砖 + 雾纹带——雾身份走形状通道、色相不承载。
2. 开过的雾格 = 地板无字 + 底色层淡雾 tint 残留——残留 tint 与"已开 0 格"必须灰度可判定区分（0 格携带"八邻无雷"推理信息，混淆即污染推理）。
3. 整片连续雾区全开时，完成信号以视觉合并域为单位一次呈现——相邻两个雾区规则上是独立实例、呈现上合并成一片；禁止逐实例响两次。

依据：雾语义条目（无雷盲区）见图例（规则 14）；tint 与完成信号随雾重设计批可复核（art-bible 雾格资产占位——内容封禁期）；双雾区相邻 = A4 EC11（边界情况表）；义务源 = A4×3③。无计算。

一次性提示 hint_id（封闭枚举——遥测值域与去重键）

值	触发	必含要点	频次
fog_first（雾首遇——A4×3②）	首个实际含雾格的板进入可操作状态（挖掘阶段开始；生成期一次查询即判定，免疫降级板误触发）	无雷盲区不赌命 / 雾格不传播连锁（连锁止于雾界属正常）/ 雾内插旗纯损	每 run 一次
chord（chord 肌肉记忆——A2×6③）	经典扫雷玩家首日尝试双击快开	本作无双击快开——插旗后轮末自动判定标中；点数字格可移动小人	每 run 一次
no_adjacent（不可挖域——规则 7）	不可挖域悬停	需先走近（点击已开格移动，免费）	每 run 一次

• hint_id 封闭枚举 = 上表三值；拒绝 / voided / 零合法板 toast 族不占 hint_id（拒绝须每次可感知——见边界情况表）。
• 文案定稿权归实现期文案 pass（本 GDD 只锁必含要点与形态约束）。

拒绝与 voided 呈现映射（A2×6⑥——映射源 = reject_reason + sub_reason）

拒绝源	触发	呈现动作	文案
board_face·not_adjacent	挖非相邻格	目标格旗朱 #C63D22 边框闪 + toast	「需先走近」
board_face·target_revealed	目标已开	同上	「该格已翻开」
board_face·target_concealed	目标未探明	同上	「该格未探明」
board_face·flag_present	目标有旗	同上	「须先拔旗」
board_face·flag_absent	目标无旗	同上	「该格没有旗」
board_face·no_path	路径不通	同上	「路径不通」
board_face·out_of_catalog	调试态	debug 级	不与玩家语义混桶
resource_face（AP 不足 / RAP 不足——无上游载荷，按动作上下文映射）	资源不足	AP/RAP 数字脉冲 + toast	「AP 不足 · 剩 0 点」
phase	非 Active	toast	「结算进行中」

• 图标 + 文案冗余（非色相独载）。

信息与归因呈现

规则 10：奖励是什么、包里有什么，随时一眼可读

1. 已开的格子里若藏着奖励，格面显示它的家族类型徽章、拾取瞬间档位可读。
2. 右侧道具栏是挖掘期的规划面——背包每一件一行（下表）；悬停看完整描述与触发注记，但看不到来源——来源归因是结算明细行的职责。
3. 奖励身份键全局恒定、跨 run 禁重掷。

常读条每行显示	说明
图标	家族键定纹样（同族不同档可互辨——刀的两档并排分得清）
名称	道具显示名
属性简述	行值快照派生的一句话（伤害 / 回复 / 增益）
状态	在包 / 已用（已用的过滤出常读条）

实现参照——奖励徽章与库存常读条：

口径	内容	依据
格面家族徽章	五键 attack/defense/heal/blast/weaken——键集冻结；五键槽位在程序化占位映射表预留、未启用键不呈现	art-bible §4.6.3
拾取瞬间	格面徽章 tier 档位可读	H1 节拍
库存徽章	八键、reward_id 键——knife_t1/knife_adv 同族互辨是硬需求	art-bible §4.6.2
MVP 呈现范围	格面徽章只在已开格呈现（未开格不预告身份）	B4 Rule 8 现行锁定；冲突清单⑤
徽章栈位	旗之下、变异纹理之上、不进数字区、不构成格内第二焦点	art-bible §3.4
常读条枚举序	入包受理序	B4 E21
tooltip	完整描述 + 触发注记、不含来源（来源归因由结算明细行承载）	battle.md 口径
Used 过滤	已用件过滤出常读条——查询面保留只读、过滤归呈现	query_inventory 保留只读
身份恒定	reward_id / enemy_id / effect_id 三键全局恒定、跨 run 禁重掷	B4×5①

依据：义务源 = B4×5①。无计算。

规则 11：身上的增益减益看得见、好坏分得清、没了有交代

槽位元素	玩家读出什么
图标	哪种效果（形状纹样定身份，色相不承载身份）
层数角标（L）	叠了几层
剩余结算次数点（R）	还会结算几次
悬停 tooltip	来源 + 语义 + 剩余

1. C 区固定 4 个状态槽；好坏一望即知：有利 = 金族满框、有害 = 红族缺框——判别按效果键的极性表，不看数值正负。
2. 开局没有任何状态 → 整排槽隐藏、HP/攻击/RAP 数据框上移补位；图例面板载空态说明「战斗中拾取的增益在此显示，随战斗结束消散」。
3. 状态系统不发任何信号——状态栏刷新绑定在结算编排完成的时点（命令式）。

口径	内容	依据
图标键	效果图标七键——形状纹样身份、色相不承载身份	art-bible §4.6.1（七键冻结）
极性判别	键级极性表：attack_up/defense_up/weaken 有利、ambush 有害——禁以 magnitude 符号判极性（负值增益存在；pool 亦不足以判——enemy_output 池两向并存）	B3×4③
极性键扩容	提案扩展键 enrage/off_guard/sapped 随极性提案实施批	极性提案实施批
语义归属	经 SettlementTable effect_pool_map 成文（作用面）	B3×4③
空态裁决	槽整体隐藏 + HP/攻击/RAP 上移补位（D1 定稿）	B3×4①
数据源	B3 投影：六归因字段 + display_name + 授予时数值快照（经 B1 编排面）	B3 已 schema——引用
tooltip 文案	source_class 文案经 B1 source_label_map	B1/B3 协作

依据：义务源 = B3×4①②③。无计算。

规则 12：结算逐行念账——每笔收益标明来源，该高光的当场高光

1. 结算推进时，明细带把 B1 流水逐行实时滚出，每行标明「做了什么、多少、到谁头上、因为什么」——玩家能把每一分收益对回自己哪一步扫雷决策。
2. 高光分三档：标中旗金框、清图奖励金框、完美排雷全屏喝彩级——庆祝不打在空兑现上。

行的类型	呈现口径	依据
生效行（伤害 / 道具入库）	实时滚出，逐行来源标注「{行为} {值} → {目标}（来源）」——模板插值，行宽预留 40% 膨胀 + 固定槽高 + clip_contents	切片缺陷①回归
效果行	两列分示：value = 单次贡献值、pool_value = 池合成值——禁相加（防"−130%×2 行 = −260%"误读）	B1 Core Rule 14 字段
零值伤害行	照常可见、不被吞	B4×5③
未生效四类行 + 标旗未中行	聚合计数呈现（防逐行惩罚轰炸）+ 形状冗余（图标 / 划线——非色相独载，色弱清单 #9）	B4×5③
四类未生效行划分	道具行（入库 / 生效语境注记）/「奖励未生效」（聚合计数）/「已消耗未生效」/「使用被拒」	B4×5③
未选用件	语境注记「未选用件随关卡结束清空」（关卡域口径）	B4×5③
标中旗高光行	旗化暴击弹道加重 + 明细行金框（chord 缺席的即时兑现补偿）	B1×3①
H2 清图奖励行	金框高亮行（轮末仪式峰值）	B1×3① / B4×5④
完美排雷	全屏喝彩级：金光带加倍扫射 + 「完美排雷 ×2」横幅；高光行 value = 实际有效兑付当量；首份即零兑付不发高光	B1×3② / art-bible §2.2 最高档（创意风险 #2 落点）

依据：行协议 = 13 类封闭枚举（B1 Core Rule 14——字段分层见规则 17 载荷表 #4）；高光使用规则 = 事件型用独立高光行、属性型强调用行字段标记（B1）；义务源 = B4×5③④ / B1×3①②。无计算。

规则 13：轮末道具窗口在道具栏原地亮起，至多选一件

1. 结算推进到窗口锚点（授予段之后、增益减益段之前）时，E 区道具栏原地激活：面板点亮金描边、标题换成「轮末道具窗口 · 至多选用 1 件」，阶段指示同步标出窗口锚点位置；棋盘区去饱和 + 金橙色相偏移并锁输入（明度不变）。
2. 满血的治疗包灰置、悬停说明禁选原因（「HP 已满 · 禁选」）。
3. 选中即承诺——窗口关闭、回结算流，提交的是窗口条目位置；跳过按钮恒在；政策注记常驻「未选用件随关卡结束清空」。
4. 背包为空就不弹窗（窗口标记照常登记——回放输入完整性归 B1），结算零停顿。
5. 窗口期棋盘输入不竞争（结算期棋盘本就锁输入）；窗口激活期间跳过常读条全量重建——全量刷新会冲掉窗口态。

依据：E 区原位激活 = battle.md 布局决策 D2；usable_now 投影 = B1 组装载荷；去饱和 + 金橙偏移 = art-bible §2 明度恒定硬规则的合规化实例；窗口触发政策 = MVP 有库存恒弹（候选取舍见 analysis）；义务源 = B4×5②。无计算。

设计意图：本节每条呈现口径都是"把每一分收益对回玩家哪一步扫雷决策"的落点——P2 裁剪判据的最后半米由 D1 走完。

提示·终局反馈·美术与可访问性

规则 14：新机制第一次遇到给提示，忘了随时查图例

1. toast = 棋盘区上缘内侧浮出的非模态提示：自动消退 2.5 秒、不劫持输入、不打断挖掘流。
2. 一次性提示共三种（雾首遇 / chord 肌肉记忆 / 不可挖域走近），每个整 run 只弹一次；拒绝、voided、零合法板的提示不属于一次性族——每次都要可感知。
3. 图例面板 = 模态覆盖层：格态 / 变异 / 雾语义三组条目，「迷雾 = 无雷盲区」条目恒在、不设解锁门、可随时回看，并载状态槽空态说明（规则 11）。文案定稿权归实现期文案 pass——本规则只锁必含要点与形态。

依据：义务源 = A2×6③ / A4×3①②。无计算。

规则 16：一场打完，输了赢了、剩什么没了什么，样样有交代

1. 六种反馈各有触发与呈现（下表）。
2. 暮蓝 overlay 是全部界面里唯一的暮蓝档、明度不变——失败氛围靠色相与运动表达、不靠变暗。
3. 不存在"RAP 满自动刷"——刷新的决策主体恒为玩家（A3 Rule 11）。

反馈	触发	呈现
胜利终局	判定行 verdict=win	金蜡封落于扫雷图区中央 + 全屏暖白金 overlay + 判定行（终局判定行 = 胜负画面数据锚）+「下一节点」+ 明细回看入口
失败终局	判定行 verdict=lose	明度不变的暮蓝 #5A6C8C 氛围 overlay（全作唯一暮蓝档）+ 小人坐砖掸灰 + 插过的旗逐面化光点收回 + 判定行 + 返回
状态槽全清	battle_over（B3×4④）	状态逐槽化光收回 + 微文案「状态随战斗结束消散」（防"我的 buff 哪去了"误读——胜负两终局同款）
RAP 清零	battle_over（A3）	RAP 数字滚动归零 + 微文案（防"攒的钱凭空没了"）
库存清空	level_clear（B4×5⑤——关卡域口径）	道包逐件化光点飞出 +「剩余道具 ×N 随关卡结束清空」（N = clear_inventory 返回的清空前快照计数——B1 编排义务⑤数据面）
Boss 遭遇变体	encounter=boss	战斗开始一次性紫赤影子爬过棋盘（§2.6——纯视觉预告）+ 敌人卡体量最大 + 阶段指示附 Boss 名
弃图刷新确认	按钮点击（A3 契约的呈现半边）	按钮置 AP 条右端，文案实时「RAP−{rap_refresh_cost 表读值} · 本轮剩 N 次」（剩余次数 = refresh_cap_per_round − 本轮已用；轮内已用次数读数 = A3 只读观测量缺口，接口漂移登记见 OQ2）；入口可用性 = 组合根按只读观测量预判（rap ≥ rap_refresh_cost ∧ 剩余次数 > 0）+ request_refresh 返回值兜底（A3 无 can_request_refresh API——不引入）；确认微交互显式提示代价与旧板旗失效；确认交互与常规确认不同位（位置通道——破坏性确认异位，色弱清单 #7）；RAP<8 / cap 超限拒绝可见（边界情况表）；换图后 AP 不重置、剩余次数扣减可见

依据：battle_over 与 level_clear 两反馈不合并、时序不倒挂（边界情况表）；义务源 = B3×4④ / A3 / B4×5⑤。无计算。

规则 19：美术没画好先用代码画的占位图顶着，占位图同样要过硬指标

1. 全部等终稿美术的面（砖面 / 雾纹 / 敌像 / 图标 / 徽章 / 立绘 / 蜡封）以程序化占位先行：色值直接取冻结色板、形状按形状语言参数域用代码绘制（圆角砖 / 直角数据框 / 纹带形）；图标、徽章、线索按键契约挂进键位映射表（数据键 → 占位纹样 ID，一键一槽位）——终稿美术到位时零数据层改动、零运行时换图。
2. 占位图同样要过硬指标：数字可读性（1–8 全档对格底 ≥4.5:1、0.5× 缩放可辨、纹带不侵数字字形区）必须通过。
3. 样张定稿 = 砖面形态与色板的冻结闸、终稿资产开工的前置；样张批不阻塞 D1 其余全部验收。

依据：判据 = F2；色板 = art-bible §4.1 冻结色板（底 L≥0.30 ∧ 饱和 ≤0.40 ∧ 墨 L≤0.027）；形状语言 = §3；样张标准 = §1.4 第一验收项；键集扩容走 §4.6 修订；终稿开工 = asset-spec 批。

规则 22：中文不缺字、字看得清、颜色不独挑大梁、不用键盘也能玩

基线	要求
中文字体	随包内置 + 设为主题默认字体——运行时默认字体无 CJK 字形，豆腐块 = 验收硬断言
按钮文案	4 汉字上限（「停手」「弃图刷新」「跳过」「选用」）；译英 ≤1.6× 不破版；德语长词允许两行或图标+缩写
明细行宽	模板预留 40% 膨胀
对比度	数字对格底 ≥4.5:1（WCAG AA）
色弱安全	无信息仅靠色相承载（九对语义对逐项成立）、灰度可辨
字号下限	棋盘数字 ≥18px / 明细正文 ≥14px / tooltip ≥13px（@1280×800）
闪烁	无 >3 次/秒
减动效	全部动画时长减半或跳终态开关；结算逐行兑现是信息载体——不可整体跳过、可加速
输入	纯鼠标可完成全部操作

依据：对比判据引用 = F2；本地化契约消费方 = D6（CJK / 按钮宽 / 术语表）；正式分层（文本缩放 / 色盲模式 / 按键重映射）待 accessibility-requirements.md 定稿（OQ7）；承载 AC-23 / AC-26。无计算。

Visual/Audio 执行锚点（art-bible 逐条执行）

D1 是本体系中唯一的自有渲染面系统——视觉义务从"数据供给规格"反转为"执行 art-bible"。

art-bible 锚点	D1 执行
§1.2 绘制优先级栈	数字 > 小人 > 旗 > 徽章 > 变异纹理 > 底色——BoardView 分层绘制/控件叠序按此栈实现，任何元素不遮挡数字（小人与旗不得覆盖文本；小人所在格边框高亮）
§1.4 格子样张（引用依据）	样张 = 砖面形态定稿闸；D1 引用其验收标准（第一验收项 = 数字可读性硬指标）作为程序化占位与正式资产的共同判据；样张未制作不阻塞 D1（规则 19）；样张通过后冻结为制作标准，终稿资产替换走 asset-spec 批
§3.3 UI 形状语法	半拟物——面板 = 石板圆角矩形（与地砖同圆角率）、按钮 = 凸圆角"可按的砖"、仪式性确认（胜利蜡封）= 圆形；数据框/准线/进度条一律直角细线无纹理（"圆角 = 可触摸的物件，直角 = 须精确的信息"）
§4.1/§4.4 UI 色板	数据素面墨族（#33261B 系）——棋盘与面板读同一种墨；战斗容器中性石色（防暖色渗入分走数字对比预算）；语义色规则（红只说危险 / 金只说收益 / 蓝只说己方 / 紫赤只说 Boss / 绿零逻辑语义 / 禁入色相带 300°–345°）逐条适用；明度恒定硬规则（状态区分只经色相/饱和/运动/元素——去饱和 + 金橙偏移即其合规化实例）
§4.5 色弱安全清单（逐对执行）	九对语义对的冗余通道（形/图标/位置/运动）在对应组件落实——四格态靠完整/碎裂形、奖励金 vs 危险红靠剪影+运动、UI 红/金强调对加图标+文案冗余、破坏性确认异位（位置通道）、图标键族一键一纹样色相不承载身份
§4.6 图标键契约（键位挂接）	效果图标 §4.6.1（七键——sapped 键冻结未入表前禁引用）、奖励徽章 §4.6.2（八键 + clear_blast 并列预留）、格面类型 §4.6.3（五键——MVP 只挂已开格）、敌种线索 §4.6.4（行为拍姿态键）——键位映射表（规则 19）为唯一挂接点，键集扩容走 §4.6 修订、禁运行时换图
§2 能量档承载	五区布局的动效与色彩转场按 §2.1–2.6 能量档实现（挖掘 2/10 唯一微光在动 → 结算 7/10 金橙光带 → 清图 8/10 金粒喷泉 → 胜利 6/10 克制 → 失败 1/10 暮蓝最静一拍 → Boss 5/10 紫赤）——"状态间区分度自检"三条（挖掘 vs 结算靠谁在动+饱和；胜负以色相即判；Boss 以紫赤登场标记）为转场验收锚
音频（D4，Alpha 占位）	MVP 无音频；挂点清单引用 B1/B4 音频挂钩点（明细行类型流 / 负反馈聚合单次 / 开格拾取按 category 分色 / 清图奖励音）+ toast 提示触发（本 GDD 新增挂点候选）；临时 SFX 随垂直切片（AD 项先例）

Asset Spec：Visual/Audio 义务已定义。art-bible 已定稿（§1–4），样张批后运行 /asset-spec system:d1-hud-framework 产出逐资产视觉描述/尺寸/生成提示词（样张先行——§1.4 为定稿闸）。

边界情况

条件	行为	依据
每次拒绝（A2×6⑥）	棋盘面拒绝（sub_reason 七值）→ 目标格旗朱 #C63D22 边框闪 + toast（文案映射见「拒绝与 voided 呈现映射」）；资源面拒绝（AP 不足 / RAP 不足——无上游载荷，按动作上下文映射）→ AP/RAP 数字脉冲 + toast；相位拒绝 → toast「结算进行中」；图标+文案冗余（非色相独载）	映射源 = reject_reason + sub_reason——每次拒绝玩家可感知
轮末意图 voided（至少 stop 被清零须可感知）	toast「本轮已清图，停手未执行 · 剩余 AP 已清零」——防 [dig清, stop] 静默改判清图、剩余 AP 清零不入 RAP 的读感欺骗（F4 联合清图让位在生产面不可构造，本条为诚实兜底）	A2×6⑥ / A2 voided 语义
零合法板（A1 EC5 → B1×3③——三形态选型定稿）	B1 上抛非法产物标记 → toast 诚实提示（非模态、不打断）；补偿与回退不提供（补偿逻辑归 B1 域外、确定性回退已知好种子 = 实现期 ADR 候选〔A1 OQ2 关联〕——MVP 面向玩家的形态 = 仅提示）；玩家永不卡死由 A1 验收三分支保证，提示是体验债的诚实兜底（原"玩家不可见遥测域"口径由本条承接闭合）	B1×3③ / A1 EC5
弃图刷新被拒（RAP 不足）	按钮 + RAP 读数脉冲 + toast	A3 EC13
弃图刷新被拒（本轮 cap=2 超限）	toast「本轮刷新次数已用完」	A3 EC15
确认微交互缺一步	不提交（防误触——破坏性确认异位）	规则 16
两个雾区相邻（A4 EC11）	规则上独立布置实例、呈现合并为一片——雾区全开完成信号以视觉合并域为单元、禁实例级双响（信号只响一次）；样张最坏用例含"宽度 1 雾带两侧毗邻数字格"	A4 EC11 / A4 AC-9
雾首遇触发边界	触发谓词 = 首个实际含雾格的板进入可操作状态——免疫 EC2 降级板（无变异）误触发、免疫贴脸雾 t=0 歧义；一次性作用域 = 每 run	A4 UI Requirements 修正口径
敌人死亡与终局同帧（despawn 时序）	死亡呈现数据 = 流水行击杀标记 + 目标字段（despawn 前已产出——规则 18①）；battle_over 清理序列后呈现层零核心回读；is_battle_live() false 后视图进入终局态只消费快照	规则 18①
窗口打开时库存为空	不弹窗、直接 skip（结算零停顿）；窗口标记照常登记（B1 回放输入完整性）	B4 E8
满血时窗口含治疗包	usable_now=false 灰置 + 禁选原因 tooltip；强制提交（不可经 UI 达成——禁选态拦截）→「使用被拒」行兜底	B1 守卫
battle_over 与 level_clear 反馈叠加（关卡末战）	RAP 清零 + 状态槽全清反馈先行（battle_over），库存清空反馈随后（level_clear 编排）——两反馈不合并（防"N 道具消失"误读为战斗结算内容）	规则 16
模态覆盖层叠开（图例上开明细回看）	统一登记序栈——后开者置顶、关闭逐层恢复；任一层打开时其遮挡物隐藏/输入锁定断言成立	切片缺陷⑤回归
悬停文案换行	全部动态区固定槽高 + clip_contents——换行裁剪不推挤布局（明细行 40% 膨胀 + tooltip 独立浮层）	切片缺陷①回归
CJK 字形缺失	豆腐块 = AC 硬断言失败（字体随包 + theme 默认；首次导出 checklist 项）	ADR-0003
敌卡刷新与死亡灰化竞争	就地更新（字段级 setter）禁全量重建——死亡灰化态不被后续刷新吞掉；窗口激活期同理跳过常读重建	entry 36 教训
减动效开启	全部转场/高光/演出时长减半或跳终态；结算逐行兑现降速不跳过（信息载体）；无闪烁 >3 次/秒恒成立	规则 22
移动目标 = 当前格	幂等零移动——无动画、无 toast	A2 EC14（合法受理的呈现静默）
compute_move_path 返回空（不可达）	路径预览不显示 + 禁止光标（预览与执行同源）	A2 AC-14② 对侧
键集扩容（新 effect_id / reward_id / enemy_id 上线）	键槽映射表缺键 = 呈现层 fail-fast（debug 断言 + 占位"?"纹样 + 诊断，禁静默空图标）——扩容走 art-bible §4.6 修订（禁运行时换图）	规则 19 / AC-15

呈现几何与可读性判据

D1 零玩法公式——本节仅承载呈现几何与可读性判据。全部取色禁新增色值，一切经 art-bible §4.1/§4.4 冻结色板。

F1 棋盘格尺寸（cell_size）

结论：cell 为两档定值（battle.md 拍板）——12×12 → 36px、10×10 → 45px；F1 公式为可行性校验器而非闭式推导：floor(min(D_w − pad_h, D_h − ap_bar_h − pad_v) ÷ N) ≥ cell(N) 且 cell(N) ∈ [30, 45] 断言成立；数字字号 = max(18, ceil(cell × 0.5))，像素字体整数倍缩放。

两档定值：cell(12) = 36px、cell(10) = 45px（battle.md 拍板值，非公式导出）
可行性校验（装板期断言，违例 fail-fast）：
  floor(min(D_w − pad_h, D_h − ap_bar_h − pad_v) / N) ≥ cell(N)
  且 cell(N) ∈ [30, 45]
N ∈ {10, 12}（A1 BoardGenTable 尺寸档）；D 区基准 1280×800 下 D_w=760、D_h=520−44(AP 条)
@1280×800 实算（pad_h=pad_v=16）：min(744, 460) = 460
  460 ÷ 12 → 38 ≥ 36 ✓    460 ÷ 10 → 46 ≥ 45 ✓
数字字号 = max(18, ceil(cell × 0.5))，像素字体整数倍缩放（canvas_items stretch 保证清晰）

变量	符号	类型	范围	说明
D 区宽/高	D_w / D_h	int px	布局常量	五区布局基准（battle.md Layout）
AP 条高	ap_bar_h	int px	44	D 区顶条
棋盘维数	N	int	{10, 12}	A1 行值（MVP 两档）
定值档	cell(N)	int px	{36, 45}	battle.md 拍板两档；非闭式导出（为何定值而非闭式见 analysis 问题 4）

• Example：12×12 → floor(min(760−16, 476−16)/12) = 38 ≥ 36 ✓（定值取 36）→ 数字字号 = 18px；10×10 → floor(460/10) = 46 ≥ 45 ✓（定值取 45）。

设计意图：两档值来源 = battle.md 拍板（"格 36–45px 见方"两端），公式只承载界限与可行性断言。

F2 数字对比恒等式（引用 art-bible §4.1——D1 不新增参数）

结论：1–8 全档数字对所在格底 WCAG 对比 ≥4.5:1（§1.4 第一验收项，对程序化占位同样适用）——由色板参数域结构保证：格底相对亮度 L≥0.30 ∧ HSV 饱和 ≤0.40 ∧ 数字墨 L≤0.027 ⇒ 任意底墨组合 ≥4.5:1 恒成立。

实测锚（底 / 墨）	对比
#33261B / #C9AF83	6.9:1
#4A1E14 / #B39A78	5.3:1

• D1 侧判据 = 灰度截图分类 + 对比抽测进 AC；换 biome 色板须重跑 §1.4（换皮只换四槽、永不变信）。

显式排除声明

对象	归属
伤害 / 经济 / 概率 / 生成公式	A1–B4/B1/C3
AP/RAP/价目显示值	A3 表读值投影
伤害数字	B1 流水行 value 投影
D1 拥有的全部	F1 几何换算、F2 可读性判据的引用执行、调参表呈现常量
随机	零——呈现层无任何 RNG 消费（S1/S2 扫描域适用）

依赖与输出

权威分层：冲突时以 battle.md + art-bible 为呈现形态权威、以本 GDD 为系统契约权威、以各玩法 GDD 为机制语义权威。

系统	方向 / 性质	接口要点
A2	上游 hard	读：current_board() / reveal_record() / compute_move_path(cell)（呈现面，entry 39 E2 收口）；订阅：零直订（ADR-0001——B1 facts 与组合根转发）；写：settle_batch(intents) 经组合根（D1×6①）；消费其三事件 schema（规则 17 载荷表 #1–3）与 ActionOutcome（#6）；D1×6 六项义务全落位（台账表）
A3	上游 hard	读：phase / ap / rap / last_round_end（getter-only——entry 39 E5）；刷新意图经组合根 → B1 refresh_board 编排内 A3 request_refresh（挖掘期 Active 受理、每轮上限 refresh_cap_per_round=2）；接口漂移登记：轮内已用刷新次数读数缺口（OQ2）；AP/RAP 常显、RAP 清零反馈、双源拒绝呈现（A3 契约）
B1	上游 hard（数据供给主通道）	读：步骤流信号（13 类行协议——载荷表 #4）、presentation_snapshot() / is_battle_live() / stock_count() / query_reward_identity()（切片实现、registry d1_presentation_surface 登记、B1 GDD 契约登记待批——冲突⑧/OQ3）；写：submit_window_selection(窗口位置序) / 刷新提交面；level_clear 反馈行数据面（清空前快照计数）；B1×3 + B4×5 + B3×4 呈现义务的统一数据源契约 = B1 Core Rule 14
B2	上游投影	hero_unit() / all_enemies() 只读投影（entry 39 E3；切片实现、B2 GDD 契约登记待批——冲突⑧）；血条/顺位/姿态/存活数据面；despawn 前捕获纪律（规则 18）；B2×4 四项义务落位（规则 6）
B3	上游投影（经 B1）	零直读（B1 协作对象私有化）——状态投影经 B1 编排面（载荷表 #10）；EC12 空态、极性映射、全清反馈（规则 11/16）
B4	上游投影（经 B1）	零直读——query_reward_identity() / 库存载荷经 B1（载荷表 #8–9）；奖励徽章键 §4.6.2、窗口呈现、四类行、H2、关卡末清空反馈（规则 10/12/13/16）
A4	上游 soft（呈现规格）	雾纹理双通道、图例条目、首遇提示三要点、tint + 完成信号（A4×3——规则 9/14/15）；A4 UI Requirements 为本 GDD 引用源
A1	间接	零直接接口——EC5 零合法板数据面经 B1 上抛（非法产物标记 → toast 告知）；biome 标签 = 换皮色板数据锚（程序化占位消费）；产物字段保真是呈现诚实的数据前提
D2	数据读取	display_name 等本地化名经核心读表面；D1 自有常量不入 D2 玩法表（调参表载体声明）
C1-lite（level_runner）	上游 hard	A 区节点链 / 当前节点 / HP 携带（关卡域）；胜利 overlay「下一节点」→ runner 推进（写经组合根）；level_clear 编排反馈；C1 GDD 未开始——本三项为切片代码契约，C1 GDD 定稿时回填（接口漂移回 C1 批）
C2	预留	关卡结算屏（关卡末清空反馈的完整屏形态）归后续 spec design/ux/level-clear.md（battle.md OQ9）——MVP 以 overlay 反馈承载
B5	下游 hard	D1→B5 交付物：五区布局与双舞台裁决（第三形态）、B 区演出区结构、明细带呈现位、流水行协议呈现语义、敌人卡呈现语义（死亡灰化/禁瞬消）、art-bible §4.6 键位映射表——B5 只叠加动画密度与演出（受击反馈/弹道/退场动画），呈现语义已在本 GDD 定稿；"战斗表现美术测试"以本布局出样
D4	下游 soft	音频挂点事件源 = 明细行类型流 + toast 提示触发（B1/B4 音频挂钩点清单引用）；MVP 无音频（Alpha）
D5	下游 soft	教学承载位 = toast 体系 + 图例面板（雾三要点 / chord 提示 / 蓄力拍提示候选 / RAP 清零 / 库存清空教学条目）——D5 GDD 定稿口径
A5	预留	探测类道具显影面（未开格身份呈现深度 OQ2）——接口归 A5 GDD，本 GDD 不预写
D6	下游	本地化契约消费方（CJK/按钮宽/术语表——规则 22）

• 索引分层注记：systems-index 依赖分层 "D1 ← A2,A3,B1"——本 GDD 实际投影消费扩至 B2/B3/B4/A4/runner，全部经 B1 编排呈现面 + 封装收口批成文呈现面（entry 39/40），零新增运行时直调边；D1 无游戏状态、无 knob 联动、无 RNG——层 4 Presentation 定位不变。

呈现义务台账逐项落位表（门禁核对用——27 项，缺项即 blocking）

义务源	义务	承接方式（本 GDD 落点）	状态
A2×6	① stop 意图经 settle_batch 提交、不直调 A3	规则 7 + 写路径总表（规则 4）+ AC-13	落位
A2×6	② 四种格态一眼可辨	规则 9 + AC-4	落位
A2×6	③ 悬停预承诺 + 可挖域常驻指示 + chord 首遇提示	规则 7 / 14② + AC-5 / AC-14	落位
A2×6	④ 已引爆雷格"可通行可读"	规则 9 + AC-4	落位
A2×6	⑤ compute_move_path 呈现语义 = 合法性指示（裁决继承 battle.md D3）	规则 8 + AC-6	落位
A2×6	⑥ 单意图帧收集 + voided 呈现 + 每次拒绝可感知	规则 7 + 边界情况表 + AC-7 / AC-8	落位
B2×4	① enemy_id→图像线索映射清单成文（预告时序 = 下一拍、挖掘期全程可见；含强度档位/环长直觉编码；双通道）	规则 6 + 意图线索映射目录 + AC-10	落位
B2×4	② 线索映射全局恒定（enemy_id 键，跨 run 禁重掷）	规则 6 / 10 + AC-10	落位
B2×4	③ 单位顺位与存活可读	规则 6（顺位徽标）+ AC-10	落位
B2×4	④ 敌方 side 池呈现口径（共享单值、各卡同值）	规则 6 + AC-10	落位
B3×4	① HUD 常显 + EC12 空态规格定稿（裁决：槽隐藏）	规则 11 + AC-12	落位
B3×4	② effect_id→icon 映射键契约	规则 11（引用 art-bible §4.6.1 七键冻结）+ AC-15	落位
B3×4	③ 有利/有害极性呈现映射（非 magnitude 符号）	规则 11（键级极性表 + pool 语义归属）+ AC-12	落位
B3×4	④ 战斗结束全清的状态栏去留	规则 16 + 状态机胜负终局 + AC-16	落位
B4×5	① 已开格 + 库存奖励身份恒定可读（常读条 = 挖掘期规划面）	规则 10 + AC-9	落位
B4×5	② 道具使用窗口呈现（原位激活/单件/usable_now/政策注记/空库存）	规则 13 + AC-13 / AC-17	落位
B4×5	③ 结算明细四类行呈现（聚合计数 + 语境注记）	规则 12 + AC-11	落位
B4×5	④ H2 清图奖励行强调呈现	规则 12 + 状态机清图瞬间 + AC-11	落位
B4×5	⑤ 关卡末（level_clear）库存清空可见反馈	规则 16 + 边界情况表 + AC-16	落位
B1×3	① 高光行强调呈现（标中旗金框 / H2 金框）	规则 12 + AC-11	落位
B1×3	② 完美排雷呈现形态	规则 12 + 状态机 + AC-11	落位
B1×3	③ EC5 零合法板提示/补偿/回退形态（裁决：仅提示）	边界情况表 + AC-19	落位
A4×3	① 图例「迷雾 = 无雷盲区」条目（恒在/可回看）	规则 14① + AC-14	落位
A4×3	② 雾首遇提示（每 run 一次、三要点、非模态）	规则 14② + AC-14	落位
A4×3	③ 已开雾格 tint 残留 + 雾区全开合并域完成信号（battle.md OQ8 采纳）	规则 9 / 15 + AC-4	落位
A3	AP/RAP 常显 + 刷新入口（玩家发起）+ RAP 清零反馈 + 双源拒绝	规则 16 + 边界情况表 + AC-8 / AC-16	落位
A1	EC5 零合法板诚实呈现（数据面经 B1×3③ 上抛）	同 B1×3③	落位

屏级 spec 与配套文档（UI 要求）

项	要点
权威屏级 spec	design/ux/battle.md（APPROVED，B1 UX Flag 的 /ux-design 产物——覆盖子屏：挖掘主界面 / 结算明细 / 道具窗口 / 终局 / 明细回看）：本 GDD 为其系统级承接（布局/组件/交互裁决全部继承）；本节不重复 spec 内容，stories 引用 design/ux/battle.md 而非本 GDD 直引组件细节
UX Flag 处置	B1 UX Flag（结算明细屏 + 道具窗口 → Phase 4 前置 /ux-design）已由 battle.md 兑现闭合；D1 自身无新增屏（战斗屏 = 唯一 MVP 玩法屏）；相邻域屏 NodeOverlay / 关卡结算 = 后续 spec design/ux/node-reward.md / design/ux/level-clear.md（battle.md OQ9——本 GDD 只锁出口锚点）
pattern 库	design/ux/interaction-patterns.md 已建（核心 8 条：双源拒绝反馈 / 原位窗口激活 / 逐行兑现明细带 / 悬停预承诺光标 / 点阵资源显示 / 模态 overlay 层级纪律 / 破坏性确认异位 / 禁用态即理由全文）——本 GDD 组件全部对号入座；12 目录占位（实现期回写义务）
accessibility	design/accessibility-requirements.md 未建（gate-check Pre-Production 缺口在案）——本 GDD 内建基线承诺（规则 22），正式分层（文本缩放/色盲模式/按键重映射）待该文档定稿
场景探针标配（code-conventions）	每个可交互 UI 区域配套场景级探针——切片三探针（ui_probe / ui_click_probe / ui_tune_probe）扩展 + 战斗屏场景级探针（AC 硬性块）；探针即呈现层契约的活文档

P0 最小闭环

1. 玩家进入战斗屏——五区同屏就绪，≤500ms 内首格可点。
2. 挖掘期鼠标操作经单意图帧整批提交 settle_batch（唯一写路径，经组合根）。
3. 回执链：组合根立刻重查只读面 → 视图字段级 setter 就地刷新。
4. 停手或 AP 尽 → round_end → D 区锁输入，明细带展开 84px 逐行兑现（B1 步骤流驱动）。
5. 窗口锚点：E 区原位激活，选用/跳过 → 回结算流。
6. 判定行 → 终局呈现（胜利金蜡封 / 失败暮蓝）+ 状态槽全清 + RAP 清零反馈。
7. level_clear → 库存清空反馈「剩余道具 ×N」→ 下一节点 / 返回（runner 推进，写经组合根）。

P1 / P2 后置

优先级	内容	后置原因
P1	远格点击自动"先移动再挖"复合意图	移动免费高频，两击摩擦符合观测假设——先经 playtest 验证 P4 ≤2 观测假设
P1	Gamepad 焦点序	Partial 支持非 MVP（OQ5）
P1	相邻域屏 node-reward / level-clear 完整屏形态	归后续 spec（OQ6 / battle.md OQ9）；MVP 以 overlay 反馈承载
P1	accessibility 正式分层（文本缩放/色盲模式/按键重映射）	待 accessibility-requirements.md 定稿（OQ7）
P2	存档级"一生一次"提示作用域	归 D3/C4 后重议（hint_once_scope）
P2	TunePanel 退役	C4 天赋树落位批（OQ12）；Playtest 诊断按钮保留
P2	探测类道具显影面	接口归 A5 GDD，本 GDD 不预写
P2	未开格预读徽章	随极性提案实施批（冲突⑤/OQ9）——B4 Rule 8 现行锁定 MVP 不呈现
P2	音频挂点出声	MVP 无音频（Alpha，归 D4）

调参表

D1 knob = 呈现节奏与可读性常量（非玩法数值——D2 Rule 1"全部玩法数值入表"纪律不适用）；单一来源登记防散落，载体 = presentation 主题资源/常量单点（实现期裁决载体形态）；修订走本 GDD 流程非调参。

字段	域（尺度）	默认	owner	调过高 / 调过低
toast_display_ms	每条提示	2500	D1	信息滞留、遮挡节奏 / 读不完即消（拒绝原因漏读）
move_slide_ms	每次移动	≤150	D1	移动拖沓（违反 P4 摩擦护栏）/ "太瞬"无方向感（battle.md OQ5 playtest 观测调）
board_install_fade_ms	每次装板	200	D1	换图迟滞 / 闪切无地牢感
clear_celebration_ms	每次清图	3000–5000	D1	拖节奏（§2.3"三五秒即收"上限约束）/ 丰收感不足
font_min_board / detail / tooltip	@1280×800 基座	18 / 14 / 13 px	D1	挤占格内空间 / 可读性下限击穿（可访问性基线）
hint_once_scope	每提示项	per_run	D1	—— / ——（存档级"一生一次"归 D3/C4 后重议）
reduce_motion_scale	每动画	0.5（或跳终态）	D1	减动效失效 / 等效关闭动效
detail_band_height	摘要 / 实时流	24 / 84 px	D1	挤压 B 区演出区 / 行数不足（逐行归因截断）

• 非 knob（结构冻结，修订走 GDD 流程）：五区布局与分区尺寸（battle.md 拍板）、双舞台常驻、窗口原位激活形态、单意图帧纪律、模态层级纪律、键位映射契约（§4.6）、程序化占位策略、订阅纪律（ADR-0001）。
• 性能预算（引用非 knob）：同屏 draw calls < 200、进入战斗屏 ≤500ms 可交互、headless 全套 < 30s（technical-preferences / ADR-0004）。
• Knob 交互：font_min_board × cell 尺寸（F1 字号下限随格尺寸联动——12×12 板 36px 格是 18px 下限的绑定域）；toast_display_ms × 一次性提示去重（提示频率观感）。
• 调参流程：改先测量后复测（切片 mock 数据先行——code-conventions 数值纪律）；playtest 观测项 = 移动手感（OQ5 关联 battle.md）/ 明细带常驻（OQ10）/ 窗口存在感。

验收标准

测试口径

口径	要点
测试载体	ADR-0004 双载体定稿（gdUnit4 deferred——D2 OQ1 关闭形态）：逻辑断言类 = godot --headless --script 冒烟扩展；场景级类 = 场景探针（godot --headless --path . res://smoke/<probe>.tscn 走正常项目引导——autoload 在位、真实 SceneTree；切片三探针为先例）
期望值纪律	呈现断言引用表读值（AP=ap_per_round 表读值、RAP 门槛=rap_refresh_cost 表读值等）与 art-bible 冻结参数，不写死玩法数值；呈现常量（toast 时长等）为本 GDD 调参表登记值可直断；每用例先 reset_diagnostics()
覆盖声明（out-of-scope）	玩法行为正确性（上游 GDD AC 域——D1 只断言呈现投影与上游契约一致）· 美术终稿质量（样张/asset-spec 批）· 动画密度（B5）· 音频（D4）· gamepad 焦点序（OQ5）

AC 清单（编号不变，Given-When-Then）

AC	Given	When	Then	覆盖
AC-1	1280×800 与 16:9 全屏（canvas_items/expand）	进入战斗屏（12×12 板）	五区无遮挡/无重叠/无内容裁切（棋盘全部格子+数字完整可见）、分区尺寸 = battle.md 布局表值、同屏 draw calls < 200、进入后 ≤500ms 内首格可点	五区布局与基座
AC-2	12×12 / 10×10 两档板	装板渲染	cell = F1 定值档（36 / 45px @1280×800）且可行性校验通过、数字字号 ≥ max(18, cell/2)、像素字体整数倍缩放无模糊	F1 格尺寸与字号
AC-3	全部格底×数字组合	灰度截图 + 对比抽测	1–8 全档对比 ≥4.5:1（F2）、0.5× 缩放数字仍可辨、纹带不侵数字字形区；全部状态转场（去饱和+金橙偏移 / 暮蓝 / Boss 紫赤）明度恒定（无变亮/变暗表达）	对比度与明度恒定（F2）
AC-4	含雾板	逐格渲染后灰度截图（+代码走查）	四种格态一眼可辨；已引爆雷格呈"可通行可读"（已开底+巢穴纹+可作移动目标）；已开雾格 = 地板无字 + 底色层 tint 残留且与已开 0 格灰度可判定区分；数字显示判定消费 variant_ids（呈现层无独立雾判定——代码走查）	A2×6②④ / A4×3③
AC-5	小人在场	挖掘期任意时刻静止截图	8 向相邻未开格常驻呼吸微光（挖掘期唯一在动元素——其余静止截图断言）；绘制优先级栈成立（徽章在旗之下纹理之上、不进数字区、无第二焦点）	可挖域与绘制栈
AC-6	悬停已开格	悬停 / 点击移动	compute_move_path BFS 路径以小人蓝细线点迹高亮（合法性指示）；移动执行 ≤150ms 短滑；不可达格返回空且禁止光标（预览执行同源——A2 AC-14② 对侧）；点击远格无自动 move+dig 复合意图（负空间）	A2×6⑤ 定稿
AC-7	一帧内多意图（含 stop）	提交	整批经 settle_batch 单批到达（stop 终结当帧收集——探针断言单批）；光标三语义（移动/挖/旗）随悬停目标正确切换 + 目标格边框高亮	A2×6⑥③
AC-8	Active 挖掘期	① 点击停手 ② 弃图刷新成功 ③ RAP<8 或 cap 超限提交	① 意图经 settle_batch([stop]) 提交（代码走查 + 探针：零直调 A3 符号）+ 按钮下压 + AP→RAP 飞行数字（RAP 增量 = 剩余 AP 读数投影）② RAP 扣 rap_refresh_cost、AP 不重置、剩余次数扣减可见、旧板旗失效提示可见 ③ 资源面拒绝可见（脉冲 + toast——EC13/EC15）	A2×6① / A3
AC-9	已开格 + 库存	渲染已开格与库存常读条	已开格家族徽章（§4.6.3 键）+ tier 档位拾取瞬间可读；库存常读条逐件 icon+名称+属性简述、枚举序 = stock 受理序、不含来源信息（列表与 tooltip 均无）；Used 件不在常读条；同族刀（knife_t1/knife_adv）并排互辨	B4×5①
AC-10	双敌种遭遇	渲染敌卡 + 击杀驱动	意图徽标 = 下一拍预告且挖掘期全程可见、映射按 enemy_id 全局恒定（跨 run 重放同姿态）、含强度档位与环长编码（环点数 = 拍数）、蓄力态含蓄力记号；顺位徽标可读（固定顺位最前者可辨）；血条 hp/max_hp 数字可读；多敌伏击层数各卡同值呈现；敌死亡 = 血条归零→灰化+碎裂退场（禁瞬消）、就地更新不丢灰化态（entry 36 回归）	B2×4①②③④
AC-11	完整结算	B1 步骤流驱动明细带	逐行明细实时可见且每行带来源标注（source_label_map 文案）、四类未生效行按聚合计数呈现且带形状冗余、零值行可见、效果行 value/pool_value 分示禁相加；标中旗行金框+弹道加重；H2 清图奖励行金框；完美排雷 = 金光带加倍+「完美排雷 ×2」横幅、value = 实际有效兑付当量、首份零兑付时高光降级不发；战斗后可经明细回看 overlay 复看完整流水	B4×5③④ / B1×3①②
AC-12	状态在场/清空	渲染状态槽	槽显示 icon（§4.6.1 键）+层数+剩余结算次数点+tooltip（来源+语义）；极性按键级表呈现（金满框/红缺框——非 magnitude 符号：负 magnitude 有利行测试例）；空态 = 槽隐藏 + 数据框上移 + 图例载空态说明；battle_over 逐槽化光收回 + 微文案	B3×4①③④
AC-13	窗口触发	窗口交互	E 区原位激活（非中央弹窗）+ 至多选 1 件 + usable_now=false 灰置带禁选原因 + 政策注记「未选用件随关卡结束清空」常驻 + 空库存不弹窗 + 选中提交 = 窗口条目位置（选中件库存态必变 Used——缺陷④回归探针）+ 窗口期不被常读刷新 stomped（entry 36 回归）+ D 区去饱和锁输入（明度不变）	B4×5②
AC-14	含雾板首遇 + 图例/提示系统在位	驱动各 hint_id 触发条件（含同 run 重复触发）	图例面板「迷雾 = 无雷盲区」条目恒在可随时回看、载状态空态说明；雾首遇提示每 run 一次、非模态不劫持输入、必含三要点；chord 提示每 run 一次含「点数字格 = 移动小人」锚点；no_adjacent 首次提示；hint_id 去重生效（同 run 二次触发零 toast）	A2×6③ / A4×3①②
AC-15	程序化占位渲染全组件集	键位映射表挂接核查 + 未知键注入	全部 icon/徽章/线索经键位映射表挂接（数据键→纹样 ID）；§4.6.1 七键/§4.6.2 八键/§4.6.3 五键/§4.6.4 姿态键逐一在位；未知键 = fail-fast 断言 + "?"占位 + 诊断（禁静默空图标）；sapped 键未入 StatusEffectTable 前零引用	键契约执行
AC-16	battle_over 与 level_clear 信号（关卡末战）	清空反馈逐项到达	battle_over：RAP 数字滚动归零+微文案、状态槽逐槽化光+微文案；level_clear：库存逐件化光飞出+「剩余道具 ×N 随关卡结束清空」（N = 清空前快照计数）；两反馈不合并、时序不倒挂	A3 / B3×4④ / B4×5⑤
AC-17	判定行 verdict=win/lose（Boss encounter 变体）	终局呈现	胜利 = 金蜡封落于扫雷图区中央+暖白金 overlay+判定行+明细回看入口；失败 = 暮蓝 overlay（明度不变）+旗化光点收回+判定行；判定行内容 = B1 终局判定行投影（数据锚）；Boss 战 = 紫赤影子爬棋盘一次性演出 + 阶段指示附 Boss 名	终局与变体
AC-18	完整对局驱动	采集 playtest JSONL	六类 ux 行按规则 17 载荷表 #13 schema 写入 playtest JSONL（字段名与值域逐项对表）；ux_round_exit.path_tag 值域 = 上游封闭枚举	遥测
AC-19	真实实例化战斗屏场景（探针场景加载、autoload 在位）	驱动完整对局（两场遭遇 × 含雾板 × 窗口选用/跳过 × 刷新 × 胜负两终局）	全程零脚本错误（stderr 归零）+ 五区断言 + 首格可点计时 ≤500ms（切片 ui_probe/click_probe 模式扩展）	战斗屏场景级探针
AC-20	AC-19 对局至 despawn 与 battle_over 之后	静态扫描 views/ 文件集 + 终局后重放渲染比对	呈现层对核心生命周期状态的读数 = 零（静态扫描：views/ 文件集禁 is_battle_live() 以外的核心状态位读取、禁核心内部字段访问——只许成文呈现面）；终局呈现数据全部来自流水行/快照（断言终局后重放渲染与实时渲染逐像素一致——快照自包含判据）	信号时点状态可见性——缺陷②回归
AC-21	逐一打开全部模态覆盖层（含叠开）	逐层打开 / 关闭	每层打开时遮挡物隐藏/输入锁定断言成立、关闭逐层恢复；TunePanel 默认不可见（显式初始化）	模态层级——缺陷⑤回归
AC-22	悬停 tooltip 最长文案 / 明细行 40% 膨胀宽度构造	渲染后截图差分	全部动态区固定槽高 + clip_contents：布局零推挤（截图差分断言）	布局稳定——缺陷①回归
AC-23	全部中文文案界面	渲染 + 字形覆盖抽测	全部中文文案渲染非豆腐块（字形覆盖抽测——ADR-0003 硬性前置）	CJK 字体
AC-24	AC-19 对局全载荷流 + 六面回执	探针逐字段断言 + 代码走查	探针对规则 17 载荷表 #1–#9 载荷逐字段断言（消费侧校验——缺字段/多字段 = 失败，切片"窗口载荷缺 round_index"崩溃回归）；#12 命令式刷新面 = 代码走查（旗插拔/移动/AP/RAP/状态/库存六面各一个回执后重查断言）	payload schema 消费断言——硬性要求①兑现
AC-25	呈现层文件集	静态扫描 / grep	零 randomize()/randi()/randf*（S1/S2）、零玩法数值字面量（期望值经只读面推导——人工三要素口径 warning 级 + AC-1/2/8 表读值推导合成判定）、核心写调用仅组合根（S7 呈现侧）、切片 provisional 名（request_refresh_active / can_request_refresh / refresh_max_per_round / during_round）零残留（grep 断言——entry 35 命名统一核销）；每视图单元头注含「实现 GDD：design/gdd/d1-hud-framework.md（系统 ID D1）」溯源行	静态扫描与命名
AC-26	1280×800 全量界面（含 AC-19 对局）	截图抽测 + 静态扫描 + 探针	字号下限成立（棋盘数字 ≥18px / 明细正文 ≥14px / tooltip ≥13px）；无闪烁 >3 次/秒（动画时长/频率参数扫描）；减动效开启 = 全部转场/高光/演出减半或跳终态、结算逐行兑现降速不跳过（探针断言）；AC-19 对局全程纯鼠标驱动（零键盘依赖）	可访问性基线（规则 22）

版本历史

版本	日期	改动
v2	2026-09-14	两件套迁移：按模板 v2 重排——设计推演（存在理由/候选取舍/数值论证/体验锚点论证）与审计附录（切片教训落位表/覆盖矩阵/冲突清单/复核注记）迁至 design/gdd/analysis/d1-hud-framework.md；规则 1–22 / F1–F2 / AC-1–26 / OQ1–12 / 27 项义务台账编号全保留，零规则与数值变更
v1.1	2026-09-14	/design-review（lean）NEEDS REVISION 同日核销：F1 改两档定值 + 可行性校验式（原闭式在固定边距下无法同时得出 36/45——用户裁决方案 A）；呈现面 API 接口漂移登记扩条（冲突⑧/OQ3 覆盖 B1×5 函数 + B2×2 投影 + settlement_snapshot 信号）；状态头 C3 状态更正（Designed 非 Approved）；C1-lite 切片契约注记（C1 GDD 定稿时回填）；新增 AC-26 可访问性基线（字号下限/无闪烁/减动效/纯鼠标）并扩覆盖矩阵 Rule 22→AC-23/26；"尸位"用语替换为直白表述；RAP 文案模板改表读值占位
v1.0-lean	2026-09-13	格式迁移：legacy 原稿按 lean 样例重排——修订注记出正文收敛至本表；核心规则/枚举/边界情况/AC 转表格；呈现刷新链路转字符画 + 出口分发表；13 项载荷 schema、27 项呈现义务台账、意图线索目录、切片教训落位表、冲突清单、25 条 AC 全保留；语义与当日定稿版对齐，零规则变更
v1	2026-09-13	/design-system 一次会话定稿：27 项呈现义务落位 + 22 条核心规则 + 13 项载荷 schema 成文 + 25 条 AC + 三条切片硬性要求（solo 模式出稿，未经 /design-review）