文档(实现指证清理): GDD 全树纯代码指证换代中文设计表述+纯度闸新增反引号调用形态判红——六类清算(方法/信号/类/常量/探针/调试与遥测入口名/提交号与运行时文件路径),保留面=数据索引(.tres 表路径与表名、表字段、表内枚值、存档键、封闭词表标签)并在 doc-conventions §5 明文写死;能力审计闸加 CALL_FORM_RE 窄规则兜底;顺修 §5 表两行误合并
This commit is contained in:
1 parent
fafb4fee0a
commit
6690c2a75b
35 files changed
+309
-306
No files matched your search
@@ -34,7 +34,7 @@
|
||||
| 11 | tooltip 规范 | Feedback | **已实现**(状态/道具悬停——规格全文待补) |
|
||||
| 12 | 单意图帧批次提交 | Input | **已实现**(组合根——规格全文待补) |
|
||||
| 13 | 状态效果槽 | Data Display | **已实现**(状态图标行呈现件——规格全文待补;载体变更留档:C 区四槽已退役,现役载体=B 区站桩伴随件) |
|
||||
| 14 | 步进进度条 | Navigation | **已退役留档**(level_strip_view 已删,节点态承载进度) |
|
||||
| 14 | 步进进度条 | Navigation | **已退役留档**(步进进度条呈现件已删,节点态承载进度) |
|
||||
| 15 | 移动路径预览 | Input | **已实现**(棋盘视图 BFS 蓝点——规格全文待补) |
|
||||
| 16 | 清图/换图演出编排 | Feedback | **已实现·占位级**(棋盘演出呈现件 金粒彩纸——规格随战斗表现 美术批补) |
|
||||
| 17 | 胜利/失败终局编排 | Feedback | **已实现·占位级**(战斗终局覆盖层——规格随战斗表现补) |
|
||||
@@ -53,11 +53,11 @@ MVP 未使用标准控件(不入库):toggle / dropdown / input field / tab
|
||||
**Category**: Feedback
|
||||
**Used In**: 战斗屏(棋盘/资源全部意图动作)
|
||||
|
||||
**Description**: 玩家意图被核心拒绝时,反馈必须同时做到:(a) 每次拒绝玩家可感知(防静默拒绝读感欺骗);(b) 来源可区分——棋盘面(排雷玩法判,携 sub_reason 封闭枚举)/资源面(行动经济判,客户端推断)/相位(排雷玩法 ActionOutcome)三源各异;(c) 图标+文案双通道,非色相独载。
|
||||
**Description**: 玩家意图被核心拒绝时,反馈必须同时做到:(a) 每次拒绝玩家可感知(防静默拒绝读感欺骗);(b) 来源可区分——棋盘面(排雷玩法判,携细分原因封闭枚举)/资源面(行动经济判,客户端推断)/相位(排雷玩法意图回执)三源各异;(c) 图标+文案双通道,非色相独载。
|
||||
|
||||
**Specification**:
|
||||
- 触发:`ActionOutcome{accepted=false, reject_reason, sub_reason}` **返回值驱动**(拒绝无事件外发——排雷玩法发射面封闭,实现层禁止等待拒绝信号)
|
||||
- 反馈映射:board_face → 目标格危险红 `#A8321F` 边框闪(拒绝语义红族——旗朱→封印紫→封印黑 #000000,2026-09-28 用户拍板现行) + toast 具体原因(sub_reason→文案映射表:not_adjacent/target_revealed/target_concealed/flag_present/flag_absent/no_path/out_of_catalog);resource_face → 对应资源数字脉冲(AP/RAP)+「AP 不足 · 剩 0 点」式文案;phase → toast(结算中/非挖掘期)
|
||||
- 触发:意图回执(受理标志 + 拒绝原因 + 细分原因)**返回值驱动**(拒绝无事件外发——排雷玩法发射面封闭,实现层禁止等待拒绝信号)
|
||||
- 反馈映射:棋盘面 → 目标格危险红 `#A8321F` 边框闪(拒绝语义红族——旗朱→封印紫→封印黑 #000000,2026-09-28 用户拍板现行) + toast 具体原因(细分原因→文案映射表:非相邻 / 目标已开格 / 目标未开格 / 该格已有封印 / 该格无封印 / 无可达路径 / 坐标越界);资源面 → 对应资源数字脉冲(AP/RAP)+「AP 不足 · 剩 0 点」式文案;相位 → toast(结算中/非挖掘期)
|
||||
- 即时性:拒绝当帧呈现;toast 自动消退 2.5s
|
||||
- **voided 区分**:作废 ≠ 拒绝(零效果零扣费零事件)——须独立文案如「本轮已清图,停手未执行 · 剩余 AP 已作废」,至少 stop 作废可感知
|
||||
- Accessibility:危险红边框闪为形状+运动通道;文案常驻
|
||||
@@ -84,11 +84,11 @@ MVP 未使用标准控件(不入库):toggle / dropdown / input field / tab
|
||||
**Description**: 轮末结算逐行流水实时呈现 + 可回看——「扫雷之因逐行兑现为战果」(P2 归因)的承载面。挖掘期收起为 1 行上轮摘要;结算期展开 84px 实时流;点击开完整回看 overlay。
|
||||
|
||||
**Specification**:
|
||||
- 数据源:[战斗结算](../systems/战斗循环/战斗结算.md#明细流水每一行都能指回你刚才的哪一步棋)步骤流(9 类行封闭协议(现行);公共字段 `type/source_class/origin_cell/round_index/display_name/value/highlight?`);**无来源行 = 断言失败**
|
||||
- 数据源:[战斗结算](../systems/战斗循环/战斗结算.md#明细流水每一行都能指回你刚才的哪一步棋)步骤流(9 类行封闭协议(现行);公共字段:来源类别 / 来源格 / 轮次 / 显示名 / 数值 / 可空高光标记);**无来源行 = 断言失败**
|
||||
- 行模板:「{行为} {值} → {目标}(来源)」——来源标注(第 N 轮 · 安全格式);行文案最长 token = 来源标签(4 汉字封闭枚举),模板预留 40% 膨胀宽度
|
||||
- 聚合纪律:未生效类行(奖励未生效——现行 9 类行协议唯一未生效型,2026-09-20 收敛)按聚合计数呈现(防逐行惩罚轰炸);衰减行聚合计数;效果行 value=单次贡献值、禁与 pool_value(池合成值)相加呈现;零值行可见不吞(免伤轮归因不断点)
|
||||
- 高亮:highlight 字段 {flag_hit, clear_reward_h2, perfect_broken} → 金框强调;完美封印 = 独立高光行 + 全屏喝彩级反馈。`perfect_broken` 的判据句读作「本板首次标错受检」,不等于完美资格已失——专长「完美保险」可在本场首次标错时豁免,实际资格按有效误标(误标总数 − 豁免数)判定
|
||||
- 布局:固定槽高 + clip_contents;正文 ≥14px;数值暗底高对比;未生效类行带 icon/划线形状冗余
|
||||
- 聚合纪律:未生效类行(奖励未生效——现行 9 类行协议唯一未生效型,2026-09-20 收敛)按聚合计数呈现(防逐行惩罚轰炸);衰减行聚合计数;效果行数值 = 单次贡献值、禁与池合成值相加呈现;零值行可见不吞(免伤轮归因不断点)
|
||||
- 高亮:高亮标记(封印标中、清图奖励、完美破除) → 金框强调;完美封印 = 独立高光行 + 全屏喝彩级反馈。「完美破除」的判据句读作「本板首次标错受检」,不等于完美资格已失——专长「完美保险」可在本场首次标错时豁免,实际资格按有效误标(误标总数 − 豁免数)判定
|
||||
- 布局:固定槽高 + 裁剪兜底;正文 ≥14px;数值暗底高对比;未生效类行带 icon/划线形状冗余
|
||||
- 击杀标记呈现(H3 数据源 = 战斗结算流水击杀结果字段)
|
||||
|
||||
**When to Use**: 任何「因果可归因」的逐行流水呈现
|
||||
@@ -101,7 +101,7 @@ MVP 未使用标准控件(不入库):toggle / dropdown / input field / tab
|
||||
### 4. 悬停预承诺光标(hover pre-commitment cursor)
|
||||
|
||||
**Category**: Input
|
||||
**Used In**: 扫雷图 BoardView
|
||||
**Used In**: 扫雷图(棋盘视图)
|
||||
|
||||
**Description**: 左键双义(已开格=移动 / 未开相邻格=挖)的消歧完全依赖格态一瞥可辨 + 悬停光标区分——**误挖不可逆**(1 AP + 可能触雷)的感知保险。
|
||||
|
||||
@@ -130,7 +130,7 @@ MVP 未使用标准控件(不入库):toggle / dropdown / input field / tab
|
||||
**Specification**:
|
||||
- 形态:`●●●●●○○○` + 「5/8」;直角细线数据框(信息=直线直角,art-bible §3.3)
|
||||
- 更新触发:组合根每次调用返回后重查(**行动经济无推送信号**——实现层禁止等待资源变更事件)
|
||||
- 拒绝反馈:资源不足时数字脉冲(pattern 1 的 resource_face 腿)
|
||||
- 拒绝反馈:资源不足时数字脉冲(pattern 1 的资源面腿)
|
||||
- Accessibility:点阵=形状通道、数字=文本通道;对比 ≥4.5:1
|
||||
|
||||
**When to Use**: 小整数离散资源(≤16 量级)
|
||||
@@ -150,7 +150,7 @@ MVP 未使用标准控件(不入库):toggle / dropdown / input field / tab
|
||||
**Specification**:
|
||||
- 打开:遮挡物隐藏或禁用 + 输入锁定;单一模态栈(无叠模态)
|
||||
- 关闭:恢复被遮挡物;关闭按钮/再点入口切换
|
||||
- 内容:固定槽高 + clip_contents(缺陷①——悬停文案换行禁止推挤布局)
|
||||
- 内容:固定槽高 + 裁剪兜底(缺陷①——悬停文案换行禁止推挤布局)
|
||||
- 验收:**场景级断言「打开时遮挡物隐藏/输入锁定」为每个模态 overlay 的强制 AC**(battle.md 场景级测试节)
|
||||
|
||||
**When to Use**: 全屏打断级信息、只读回看、仪式性终局
|
||||
@@ -170,7 +170,7 @@ MVP 未使用标准控件(不入库):toggle / dropdown / input field / tab
|
||||
**Specification**:
|
||||
- 弃图刷新:确认微交互显式呈现全部代价(RAP−8 · **旧板封印印记随旧板作废**提示);确认交互位置与常规确认不同位
|
||||
- 双通道:图标 + 文案冗余
|
||||
- 拒绝路径:RAP<8 → pattern 1 resource_face(EC13 合法拒绝可见)
|
||||
- 拒绝路径:RAP<8 → pattern 1 的资源面(EC13 合法拒绝可见)
|
||||
|
||||
**When to Use**: 任何消耗资源/不可逆的操作确认
|
||||
**When NOT to Use**: 无代价操作(直接执行 + 直接反馈)
|
||||
@@ -189,7 +189,7 @@ MVP 未使用标准控件(不入库):toggle / dropdown / input field / tab
|
||||
**Specification**:
|
||||
- 形态:灰置 + tooltip「HP 已满 · 禁选」;点击无效 + 原因 toast 兜底
|
||||
- 语义区分:满血 = 零收益守卫(禁选、不烧包)≠ 缺血不足(超量 clamp 部分回复,**不**禁选)
|
||||
- usable_now 由战斗结算组装进窗口载荷(地图战斗资源零跨系统读)——呈现层只消费不推断
|
||||
- 「当前可用」标记由战斗结算组装进窗口载荷(地图战斗资源零跨系统读)——呈现层只消费不推断
|
||||
|
||||
**When to Use**: 任何可见但不可交互的元素
|
||||
**When NOT to Use**: 完全隐藏的不可用功能(不存在的东西无需解释)
|
||||
@@ -201,7 +201,7 @@ MVP 未使用标准控件(不入库):toggle / dropdown / input field / tab
|
||||
## Gaps & Patterns Needed
|
||||
|
||||
- **目录 #9–#20 已全部实现**(2026-09-12 战斗屏实现批,冒烟 149/149 + 三探针全绿);规格全文回写 = HUD框架正式化批义务
|
||||
- 实现期新增技术件(不单独立 pattern,规格归并):去饱和+金橙状态切换 = 逐格共享 ShaderMaterial(明度不变,gl_compatibility 安全);敌人死亡残位 = 卡体灰化+碎裂禁瞬消(归入 #17 终局编排规格)
|
||||
- 实现期新增技术件(不单独立 pattern,规格归并):去饱和+金橙状态切换 = 逐格共享 ShaderMaterial(明度不变,兼容渲染器下安全);敌人死亡残位 = 卡体灰化+碎裂禁瞬消(归入 #17 终局编排规格)
|
||||
- **MVP 未使用标准控件**:toggle / dropdown / input field / tab bar(无需求不设占位);TunePanel slider 为调试专用不入库
|
||||
- **实现偏差规则**:pattern 近似但不完全适配时,实现层禁止静默变体——登记偏差交 ux-designer 复核后回写
|
||||
|
||||
|
||||
Reference in new issue
Block a user