game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(iter30-fb): 迭代 30 卡① 文档批——代拍板七项追认＋反哺点七条回写

Browse Source 
用户令「追认没有问题;反哺点可以都进行回写」两项一波走完（文档批，
不占迭代号，分支 iter30-fb-20261017，基于 master 0a164958）。

追认：
- reports/iter30-代拍板追认单-2026-10-17.md 文末加追认结果行——§9
  白名单 7 项全部同意。

反哺点七条全部回写：
- 06-待办清单：徽章条状态待办→已完成（入库 7ffd1dc0、冒烟 1151/0、
  单测 34 套、探针 case⑰、07 ㉘ 人闸五项）；色相措辞修正为「样张
  v2 冻结既裁值，本批只动明度」；2026-10-05 实查读数刷新
  （bonus_pick_overlay.gd 已改名 curio_pick_overlay.gd:97、TG_* 五族
  在役 ui_kit.gd:49-53、裸 Color8 读数作废）；新增「卡顶色带与格面
  微光两带统一」待办条（Q3 甲案）。
- HUD框架：实装状态行转「已实装（迭代 30 卡① 2026-10-17 入库，
  合并 7ffd1dc0）」；验收行转正式验收；版本历史 v0.19；口径史注记
  后补两带分工注记（卡顶带=条目级静态色带／格面微光=棋盘格内动态
  微光，禁互为引用）。
- 08-Alpha版本标准：「五 · 表现」表新增「未开格类型微光（五组色相＋
  明度档）」行（在役；明度档 provisional 值，样张批复核转正）；
  版本历史 v1.9；文头状态行 v1.8→v1.9。
- art-bible：五组明度档 provisional 值（芥末黄 #F7DF43／黄绿 #68D042／
  青 #30A6A6／紫罗兰 #7B5BD6／绯红 #A61D37＝冻结 #FF2D55 的 V=0.65
  档，五组 ΔH ≤0.13° 色相零移动）＋生成口径（渲染合成空间伽马阶梯、
  相邻组模型 CR 1.245/1.234/1.239/1.270、判据线 1.20、实测最弱对
  1.232、群伤暗档停机呈报留痕）落版本历史 v3.15；§4.2/§4.6.3 权威面
  零改动、§2.1 未追加（Q5 甲案静态）；头注「现行为」v3.11→v3.15
  漏更订正。
- roadmap：迭代进度行、近期主战场行与迭代 30 表行状态列同步卡①已
  入库（②③待 /iter 发令）。
- 07-体验验证清单：新增 ㉘ 节五项人闸（五组一眼可分／不遮数字
  〔环不外溢〕／出圈灭入圈复亮／整屏不脏／群伤暗档 #A61D37 观感
  〔provisional，读数归样张批〕）；版本历史 v1.5。
- reports/iter30-反哺点-2026-10-17.md 加「回写结果」节逐条标已回写。
- active.md：快照「更新于」行追加文档批从句；未决面待用户追认行补
  iter30 七项已同意；追加状态记录 511。

验收：文档域闸 tools/run_all_gates.sh --docs 五闸（06 gdd_lint／07
doc_link／08 doc_term／08b active.md 体量／10 熵增）全绿，闸况与
基线一致无新增红，回执 commit=分支尖。

遗留：卡②③待 /iter 发令；07 ㉘ 实机目检五项待用户过目；群伤暗档
provisional 待样张批转正；g-plan2-iter30-fb 工作区待合回后清理。
This commit is contained in:
DKChan committed 2026-10-17 17:40:29 +08:00
1 parent 0a16495842
commit 34f3cdb36d
9 files changed
+57 -12
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

design/art/art-bible.md
+2 -1
View File
@@ -1,6 +1,6 @@
# 美术圣经(Art Bible)— Dungeon Sweeper
> 项目:Dungeon Sweeper(扫雷 × 自动战斗 闯关 Roguelike)· 状态:**第 1–9 节定稿**(§6 环境/§7 UI/§8 资产规范/§9 参考与反参考已于 2026-09-23 v1.8 按 D1/D2/D4/D5 框架成文;D3=§5 角色已于 v1.6 落地、v1.7 抽离独立文档;框架 2026-09-22 用户拍板,原登记于中间产物修订指导,经裁决不入库,明细归状态记录 125);历次修订明细见文末版本历史(现行为 v3.11)
> 项目:Dungeon Sweeper(扫雷 × 自动战斗 闯关 Roguelike)· 状态:**第 1–9 节定稿**(§6 环境/§7 UI/§8 资产规范/§9 参考与反参考已于 2026-09-23 v1.8 按 D1/D2/D4/D5 框架成文;D3=§5 角色已于 v1.6 落地、v1.7 抽离独立文档;框架 2026-09-22 用户拍板,原登记于中间产物修订指导,经裁决不入库,明细归状态记录 125);历次修订明细见文末版本历史(现行为 v3.15)
>
> **Art Director Sign-Off (AD-ART-BIBLE)**:历次批均 SKIPPED(v1.8 §6–9 补全亦 SKIPPED)— Lean/Solo mode(非 PHASE-GATE;§6–9 已成文,full 门禁签核时机待用户表态)
> 风格基调(2026-09-10 用户定稿):地牢题材但**非暗黑风**——轻快明亮的幻想冒险风,全年龄;像素风;角色 2~3 头身
@@ -546,6 +546,7 @@
## 版本历史
- **v3.15(2026-10-17)未开格类型微光明度档 provisional 值登记(迭代 30 卡①实装随批;§4.2/§4.6.3 权威面零改动、§2.1 不追加)**:①**五组明度档 provisional 值登记**(色相零移动——样张 v2 冻结的五组色相本身不动,本批只定各组明度档,归「待定现用」第三态〔v3.10 立〕,复核转正归战斗一屏样张〔迭代 30 序位②〕):通用增益芥末黄 `#F7DF43`(冻结 `#D6C13A` 提亮档)、治疗黄绿 `#68D042`(冻结 `#5CB83A` 提亮档)、穿刺青 `#30A6A6`(冻结 `#2E9E9E` 提亮档)、魔法紫罗兰 `#7B5BD6`(与冻结值同)、群伤绯红 `#A61D37`(冻结 `#FF2D55` 的 V=0.65 暗档);五组 ΔH ≤0.13° 全数只动明度;实装落点 = `ui_kit.gd` TG_GLOW_* 五常量,呈现参数 α170/带宽 cell÷8 维持 §4.2 v2 口径不动;②**明度排档口径**——阶梯在渲染合成空间(伽马)排档:引擎 canvas 混合在帧缓冲 sRGB 域做线性插值,按 CIE L* 线性排档曾把群伤/魔法两档排反;相邻组对比度(CR)四对模型值 1.245/1.234/1.239/1.270 全数过判据线 1.20,实测最弱对 1.232;③**停机呈报留痕**(契约 5):群伤暗档初版 `#FF1A31`(ΔH 5.40° 超差)作废,用户裁「换更暗档」→ `#A61D37`(色相零移动);④连带=头注「现行为」漏更订正(v3.12–v3.14 三代未回头注,本批订正为 v3.15)。零素材新增,微光语义零改动
- **v3.14(2026-10-14)迭代 24/25/26 反哺写入批(用户裁「全部按呈报写入文档」——qa 收尾批)**:①**§4.1 新入三 token**(GOLD_BRIGHT #E0B860 收益金亮档 / HERO_BLUE_BRIGHT #7EBAF0 小人蓝亮档 / SLOT_BACKDROP_SOFT #806A4E 图标槽柔和档——迭代 26 反哺③语义岗登记转正,色板计数 42→45);②**§7.6 新增「引擎原生控件与按钮状态规格」节**(迭代 25 反哺①+迭代 26 反哺①④——原无条款,两批实现临时权威转正:按钮五态矩阵〔悬停 modulate 1.06/按下本族下沉/禁用 α0.45 幽灵化/焦点 INK 2px 内缩 1px 环〕+原生控件组件规格〔滚动条 StyleBox 柄/滑轨两段可辨/气泡/输入件/预盖件/字体防御〕+氛围层平滑件与抖动派并存留样张批+主题色值双源注记〔迭代 25 反哺④〕);③**§8.2 增全局纹理过滤与平滑渐变件例外条款**(迭代 26 反哺②——Nearest 全局+三件 LINEAR 豁免清单);④连带 = §7 白话章节清单补 §7.6。色值遵守定值单点纪律指路 theme README 溯源表,零复述
- **v3.13(2026-10-10)营地柜台名扫改（2026-10-10 天赋树设计会话裁「道具工坊」改名「秘宝匣」）**：§2.8 承载元素与 §6.2 场景构成两处三柜台括注改名。零素材新增
- **v3.12(2026-10-07)类型微光组粒度批（用户裁——道具三层重设计·地图层顺带）**：§4.2 类型微光色带「组内明度梯度分型」降为「组间五色相+组内不细分」——逐型明度映射从未定义、cell÷8 泛光上五级明度物理不可读；色弱通道随迁组粒度（§2 验收2/§4.5⑨ 同批措辞同步）；gp 不拆独立色相（用户裁：攻击三类+治疗+通用=五色已达玩家记忆上限）；五组色相本身不动（样张 v2 冻结维持）
design/gdd/06-待办清单.md
+11 -3
View File
@@ -446,13 +446,21 @@
**归属**：HUD 批（M-4，批未立项）——已随迭代 17 卡③实施
**状态**：✅ 代码面已交付待实机目检（2026-10-06，迭代 17 卡③暂停层只读入口批〔时名——2026-10-13 改名状态面板〕——worktree g-plan2-iter17-pause 分支 iter17-pause-20261006，提交 c08a901/fc9eb1e/d44fdd5+完成笔；P1丁常驻角标/P2甲设置层同档 dim 遮罩/P3甲余额+三柜台进度/P4甲零动效直开直关全落；badge 已按 Q10 甲工厂化入 ui_kit 并同步迁营地钥石徽；机检=冒烟 788/0+run_all 17 套+四探针全绿〔含输入锁 case⑯/只读巡检/零动效契约/钥石徽对比度对〕+doc 三闸零新增；改名批机检=冒烟 938/0+run_all 24 套+probe --click/--full+render_gate 全绿；**人闸=用户实机目检** 迭代17人闸清单（已退役，git 历史可查）——过闸后本条注销；Esc 快捷通道维持本清单键盘/手柄条登记随键盘批办理）
#### 未开格类型徽章呈现时机（2026-09-18 方向已拍板，待实施批）
#### 未开格类型徽章呈现时机（2026-09-18 方向已拍板，2026-10-17 迭代 30 卡①实装入库）
**现状**：2026-09-18 用户拍板方向——未开格常显奖励类型微光（周围 8 格泛光：魔法=紫 / 穿刺=蓝 / 群伤=红 / 治疗=绿 / 其他增益=黄），让玩家能针对敌人护甲类型规划优先开哪些格。设计依据：护甲克制轴已落地（穿刺弹/魔法矢），玩家需要类型先验才能兑现克制博弈。**2026-09-22 美术圣经审阅批更新（T1 裁决：采纳彩色常显微光）**：原五色与圣经语义色条款三方冲突（紫落 300°–345° 禁入带/治疗绿违反绿零逻辑/穿刺蓝违反蓝只说己方），经用户裁决采纳微光后五组色相已重选候选——芥末黄(通用增益)/黄绿(治疗)/青(穿刺)/紫罗兰(魔法)/绯红(群伤)，见 [art-bible](../art/art-bible.md) §4.2「类型微光色带」（候选值，样张批冻结）；圣经 §4.6.3 呈现约束已同步为「角嵌纹样(形状)+常显微光(色彩)」双通道，类型预读呈现方案在美术侧已成文。连带裁决面：① 本方向修订[不做清单](05-不做清单.md)「未开格不显示奖励身份」裁定（owner 修订，合法）；② ~~与 art-bible §4.6.3 家族类型徽章口径对齐归美术批~~——已完成（2026-09-22 美术文档修订批）；③ 探宝罗盘（预读 3×3）价值被清空，效果重定归秘宝内容批；④ ~~色板与既有格面徽标/UI 用色冲突检查归样张批~~——冲突面已在色相重选时规避，样张批保留组间互辨抽测义务；⑤ 原「资源预读与推理的边界」条目并入口径（2026-09-19 用户拍板：预读边界按本条微光方案定——类型级常显；探宝罗盘重定两方案另立条目评估）；⑥ 实施窗口 = 表现层升级批（会改推理信息面，切片期默认不开、保护验收读数基线）。**2026-09-30 口径校正（用户裁决）**：微光正确口径=**英雄周围 8 格内的未开格显示类型微光**（非全板常显）——本条历史文本中的「常显」为无范围复述、「魔法=紫/穿刺=蓝…」为 2026-09-18 原案旧色（已被 T1 重选五组取代，现行见 art-bible §4.2）；概念权威定义已落 [HUD框架](systems/表现与支撑/HUD框架.md)「未开格类型微光」节（2026-09-30 完成批落位），本条此后只承载实施状态、不再承载定义。
**现状**：2026-09-18 用户拍板方向——未开格常显奖励类型微光（周围 8 格泛光：魔法=紫 / 穿刺=蓝 / 群伤=红 / 治疗=绿 / 其他增益=黄），让玩家能针对敌人护甲类型规划优先开哪些格。设计依据：护甲克制轴已落地（穿刺弹/魔法矢），玩家需要类型先验才能兑现克制博弈。**2026-09-22 美术圣经审阅批更新（T1 裁决：采纳彩色常显微光）**：原五色与圣经语义色条款三方冲突（紫落 300°–345° 禁入带/治疗绿违反绿零逻辑/穿刺蓝违反蓝只说己方），经用户裁决采纳微光后五组色相已重选候选——芥末黄(通用增益)/黄绿(治疗)/青(穿刺)/紫罗兰(魔法)/绯红(群伤)，见 [art-bible](../art/art-bible.md) §4.2「类型微光色带」（五组色相 = 样张 v2 冻结既裁值，依据 art-bible :66/:551；明度档 provisional 值登记见 art-bible 版本历史 v3.15，复核转正归战斗一屏样张批）；圣经 §4.6.3 呈现约束已同步为「角嵌纹样(形状)+常显微光(色彩)」双通道，类型预读呈现方案在美术侧已成文。连带裁决面：① 本方向修订[不做清单](05-不做清单.md)「未开格不显示奖励身份」裁定（owner 修订，合法）；② ~~与 art-bible §4.6.3 家族类型徽章口径对齐归美术批~~——已完成（2026-09-22 美术文档修订批）；③ 探宝罗盘（预读 3×3）价值被清空，效果重定归秘宝内容批；④ ~~色板与既有格面徽标/UI 用色冲突检查归样张批~~——冲突面已在色相重选时规避，样张批保留组间互辨抽测义务；⑤ 原「资源预读与推理的边界」条目并入口径（2026-09-19 用户拍板：预读边界按本条微光方案定——类型级常显；探宝罗盘重定两方案另立条目评估）；⑥ 实施窗口 = 表现层升级批（会改推理信息面，切片期默认不开、保护验收读数基线）。**2026-09-30 口径校正（用户裁决）**：微光正确口径=**英雄周围 8 格内的未开格显示类型微光**（非全板常显）——本条历史文本中的「常显」为无范围复述、「魔法=紫/穿刺=蓝…」为 2026-09-18 原案旧色（已被 T1 重选五组取代，现行见 art-bible §4.2）；概念权威定义已落 [HUD框架](systems/表现与支撑/HUD框架.md)「未开格类型微光」节（2026-09-30 完成批落位），本条此后只承载实施状态、不再承载定义。
**归属**：[地图战斗资源](systems/战斗循环/地图战斗资源.md)极性提案实施批与HUD框架共裁
**状态**：待办（**Alpha 阶段需完成**——2026-10-13 用户令随「UI 美化三层诊断」登记：本条属第三层「观感提升」）。**2026-10-05 注**：类型色五族已由迭代 16「UI 设计对齐批」§3-N4c 立项 `TG_*` 常量（实查 `ui_kit.gd` 现无 tg 常量，五族以裸 `Color8` 内联于 `bonus_pick_overlay.gd:96-102` / `shop_overlay_view.gd:189`，且缺第五族 aoe `#E25676`）；本条（**格面**未开格类型徽章）与卡顶色带同族不同落点，**不并入本批**，维持待办。**2026-10-07 注**：呈现规格简化为组粒度——组间五色相、组内不细分（通用增益组五族不再承诺组内分型；art-bible v3.12）；实施批按组粒度执行。**2026-10-16 用户令编入迭代 30**（UI 呈现三卡批序位①，需求卡片=[未开格类型徽章批](../research/需求卡片-未开格类型徽章批-2026-10-16.md) v1.2 裁点已留痕；本行 2026-10-05 实查读数系过期值，批内刷新义务随卡片同步面；开工门=U0 `/iter` 发令）。
**状态**：✅ **已完成**（2026-10-17 迭代 30 卡①未开格类型徽章批入库，合并 `7ffd1dc0`——shader 主路径五组微光实装：归组/色板/开关/生命周期全落；冒烟 1151/0〔新增八相 24 项〕＋单测 34 套件〔type_glow_test 51 检查〕＋探针 case⑰＋渲染双帧取证全绿；实机目检人闸五项登记 07 ㉘、待用户过目）。**2026-10-05 注**：类型色五族已由迭代 16「UI 设计对齐批」§3-N4c 立项 `TG_*` 常量（当日实查 `ui_kit.gd` 无 tg 常量、五族以裸 `Color8` 内联于 `bonus_pick_overlay.gd:96-102` / `shop_overlay_view.gd:189`，且缺第五族 aoe `#E25676`——**2026-10-17 读数刷新：该实查系立项当日时点值，现行 `TG_*` 五族在役 `ui_kit.gd:49-53`〔含第五族 aoe `#E25676`〕，消费面经 `tg_band()` 单点取色〔`curio_pick_overlay.gd:97`——原 `bonus_pick_overlay.gd` 已改名／`shop_overlay_view.gd:209`〕，裸 `Color8` 内联读数作废**）；本条（**格面**未开格类型徽章）与卡顶色带同族不同落点。**2026-10-07 注**：呈现规格简化为组粒度——组间五色相、组内不细分（通用增益组五族不再承诺组内分型；art-bible v3.12）；实施批按组粒度执行。**2026-10-16 用户令编入迭代 30**（UI 呈现三卡批序位①，需求卡片=[未开格类型徽章批](../research/需求卡片-未开格类型徽章批-2026-10-16.md) v1.4；开工门 U0 `/iter` 发令已于 2026-10-17 执行完毕）。
#### 卡顶色带与格面微光两带统一（2026-10-17 迭代 30 卡① Q3 甲案登记——原 T3 条件卡不并入该批）
**现状**：类型色现有两套并存——**卡顶色带** `TG_*` 五族（三选一卡面/商店货架消费，`ui_kit.gd:49-53`，`tg_band()` 按 id 小写子串判定）与**格面未开格微光** `TG_GLOW_*` 五组（`ui_kit.gd:87-95`，`glow_group_for_cell_type()` 按 cell_type 精确值判定）。分工口径：卡顶带管货架卡面的类型标识，格面微光管未开格的类型先读，两套禁互为引用。统一面（原 T3 条件卡内容）：`TG_*` 取值改圣经五组冻结值、归组输入改 cell_type 精确值、E5 回滚注记清偿——影响面 = 三选一与商店货架观感变化＋既有断言改写（触碰「只增不减」契约，须按异常分级 L3 先呈报）。
**归属**：UI 呈现线后续批（用户点名开工）
**状态**：待办（2026-10-17 登记。与战斗一屏样张批〔迭代 30 序位②〕的明度档复核转正无互踩——本统一改的是卡顶带取值，不动格面微光五组 provisional 值）
#### 呈现层残余 <4.5:1 文字位（迭代 16 批外邻接发现，2026-10-06 登记）
design/gdd/07-体验验证清单.md
+15
View File
@@ -279,6 +279,7 @@
| v1.2 | 2026-10-15 | **冲突标记清理解（迭代 28 随批）**——本文件 v1.0/v1.1 两行处残留 `<<<<<<<`/`=======`/`>>>>>>>` 合并冲突标记（迭代 27 分支 iter27-techdebt-20261014 合并进 master 时漏解，两侧均有效故全留：qa 收尾批人闸核销行 + ㉖ 目检节登记行与正文节）；清理后两行内容照旧，仅版本号顺延。同批新增 ㉗ 启动态菜单目检节（迭代 28 卡①随批登记） |
| v1.3 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 35 处（随批→顺带 25、收口→完成/合并进 master 5、台账→状态记录 1、销号→注销 2、报错→返回错误 1、对拍→与基线数据逐项比对 1；均系正文现役文本，版本历史既有行按豁免不动）＋失同步修复 0 处 |
| v1.4 | 2026-10-17 | ㉖① 机检承接注记（迭代 29 GDD 反哺点经用户逐条裁决写入）：屏壳切换正确性已由 `screen_flow_probe` 机检承接（入轻闸必跑段）；该项**保留不注销**——承载机器抓不到的观感半（演出时序/文案/布局逐屏零漂移） |
| v1.5 | 2026-10-17 | 新增 ㉘ 未开格类型徽章批类型微光实机目检节（迭代 30 卡①随批登记：五组一眼可分/微光不遮数字〔环不外溢〕/出圈灭入圈复亮/整屏不脏/群伤暗档 #A61D37 观感〔provisional，读数归样张批复核〕——登记不阻塞；能力验证半=双帧 glow 作用集 2/4/4·outside=0＋golden off 帧 0.10–0.14%＋探针 case⑰＋单测五段 51 检查） |
## ㉖ 代码架构技术债修复批——全流程走查（迭代 27 卡①顺带登记；能力验证半=冒烟 V1-V9+parity 三变体逐位一致、与基线数据逐项比对五跑全同）
@@ -308,3 +309,17 @@
| 3 | 菜单与战斗互不遮挡 | 开新冒险后菜单让位、战斗界面完整可见；回菜单后战斗内容不再透出（模态互斥观感与改前一致） |
| 4 | 各覆盖层开合层级正确 | 图鉴/关卡地图/奇物/终局/商店/营地/设置/状态/生涯/确认框/调试浮窗逐个开合——浮层都在内容之上，调试浮窗浮于菜单之上且不吃下层点击 |
| 5 | 音量与减动效启动即生效 | 改设置退出重进：音量/减动效保持上次值（boot 链路后置条件的人眼侧） |
---
## ㉘ 未开格类型徽章批——类型微光实机目检（迭代 30 卡①顺带登记；能力验证半=双帧 glow 作用集取证 2/4/4·outside=0＋golden off 帧 0.10–0.14%＋探针 case⑰＋单测五段 51 检查）
> 类型微光实装（默认开、组合根布尔可切）后，玩家可见面=棋盘格内五组类型微光。机检只能证明「作用集正确/开帧一致/关帧逐位一致」，真机上「五组分不分得清、看着脏不脏」仍需人眼。**群伤组明度档为 provisional 值**（art-bible 版本历史 v3.15 登记），观感复核归战斗一屏样张批（迭代 30 卡②）——本节第 5 项读数作该复核的输入。登记不阻塞（2026-10-12 真人检测立规）。
| # | 目检项 | 判据 |
|---|---|---|
| 1 | 五组一眼可分 | 对局中相邻未开格微光五组（芥末黄/黄绿/青/紫罗兰/绯红暗档）肉眼可辨，且不与格底明度档糊成一团 |
| 2 | 微光不遮数字 | 微光环只住本格内缘（带宽 cell÷8），不外溢遮邻格已开格数字；与接触带微光同屏时两层可辨 |
| 3 | 出圈灭、入圈复亮 | 角色走远出 8 格圈→微光灭；走回→复亮；换图随旧图全重置 |
| 4 | 整屏不脏 | 满圈微光同屏时棋盘不显脏、不抢焦点（焦点预算观感的人眼侧） |
| 5 | 群伤暗档观感 | 绯红暗档 #A61D37（V=0.65 provisional）与其余四组同屏时的区分度、以及与危险红不误读的观感——读数归样张批复核 |
design/gdd/08-Alpha版本标准.md
+3 -1
View File
@@ -2,7 +2,7 @@
> **一句话定位**：本文定义这个项目的 **Alpha 版本包含哪些东西**——它是里程碑 M3 的完成标准，也是判断"还差什么"的对照表。
> **本文只列条目，不写内容**：每样东西是什么、规则怎么走，一律归各自的权威文档，本文只给指路链接。想知道某样东西的定义，请点链接，不要在本文里找解释。
> **状态**：**已定稿（v1.8）**——2026-10-13 用户令定稿（v1.0），同日升版 v1.1（界面美化八条）与 v1.2（敌种池行注摘除）；v1.3/v1.4 为迭代 25/26 完成回填；v1.5 简明技术中文用语规范批；v1.6 状态刷新批（锻造工坊在役回填 + 数值统一标定按 2026-10-09 里程碑立规结案归 Beta）；v1.7 状态刷新批（立绘方向随 2026-10-14 用户裁结案 + 样张/棋盘观感编入迭代 30 注记 + 贫矿脉屏蔽注记）；v1.8 playnote 二轮对照批（状态面板行名随改名批换代 + 瘦身义务入册〔2026-10-16 用户令〕）。Alpha 的内容范围自此冻结：增删条目一律须经用户裁决，并记入文末版本历史。
> **状态**：**已定稿（v1.9）**——2026-10-13 用户令定稿（v1.0），同日升版 v1.1（界面美化八条）与 v1.2（敌种池行注摘除）；v1.3/v1.4 为迭代 25/26 完成回填；v1.5 简明技术中文用语规范批；v1.6 状态刷新批（锻造工坊在役回填 + 数值统一标定按 2026-10-09 里程碑立规结案归 Beta）；v1.7 状态刷新批（立绘方向随 2026-10-14 用户裁结案 + 样张/棋盘观感编入迭代 30 注记 + 贫矿脉屏蔽注记）；v1.8 playnote 二轮对照批（状态面板行名随改名批换代 + 瘦身义务入册〔2026-10-16 用户令〕）；v1.9 未开格类型微光实装回填（迭代 30 卡①，反哺点回写用户令授权）。Alpha 的内容范围自此冻结：增删条目一律须经用户裁决，并记入文末版本历史。
> **成文**：2026-10-13。
## 本文怎么用
@@ -142,6 +142,7 @@
|---|---|---|
| 像素美术风格与色板 | [美术圣经](../art/art-bible.md) | 在役 |
| 棋盘瓦片与格面资源图标 | [美术圣经](../art/art-bible.md) | 在役 |
| 未开格类型微光（五组色相＋明度档） | [HUD框架](systems/表现与支撑/HUD框架.md) | 在役（明度档 provisional 值登记见 art-bible 版本历史，复核转正归战斗一屏样张） |
| 棋盘观感（第二 / 三关亮度与对比度） | [06-待办清单](06-待办清单.md) | 待做（2026-10-16 用户令编入迭代 30，序位③） |
| 立绘清晰度回退评估（是否改用高清图） | [角色设计](../art/character-design.md) | 待做（评估已结——2026-10-14 用户裁维持像素风、升级精细手绘像素、不回退高清图，裁决录=[美术审计-cursor会话存档](../art/美术审计-cursor会话存档-2026-10-14.md) §2.2；余=立绘按新口径重产＋大小比例子题用户复核） |
| 敌人立绘（全敌种） | [角色设计](../art/character-design.md) | 在役 |
@@ -226,3 +227,4 @@
| v1.6 | 2026-10-16 | **状态刷新批（用户令）**：① 「一 · 跨局循环」锻造工坊行 待做→在役（实装批 2026-10-12 入库，06 载明；满级特效按裁 6 留扩展位不影响判定）；② 「二 · 内容量」锻造路线行族事实源订正 `meta_forge.tres`→`forge.tres` 并转在役；③ 「三 · 界面」营地行锻造柜台注 占位面板→工作间实形态（目检 07 ㉒ 已核销；柜台贴图占位归表现表贴图批行）——以上三行为 v1.0 定稿时失实残留；④ 「四 · 工程与质量」数值统一标定行撤销（待裁→归「六 · Alpha 不含」，依据=2026-10-09 里程碑立规 M4=Beta 且用户 2026-10-16 重申），未决项八项减为七项重编号；⑤ 文头状态行 v1.4→v1.6（v1.5 漏更）。除④外条目集合零增删 |
| v1.7 | 2026-10-16 | **状态刷新批（用户令）**：① 「五 · 表现」立绘清晰度回退评估行 待裁→待做（方向已裁——2026-10-14 用户裁维持像素风、升级精细手绘像素、不回退高清图，裁决录=美术审计-cursor会话存档 §2.2；余下义务=立绘按新口径重产与大小比例人闸复核），「七 · 未决项」七项减为六项重编号；② 「五 · 表现」战斗一屏样张、棋盘观感两行加编入注记（2026-10-16 用户令编入迭代 30 序位②③，状态维持待做）；③ 「一 · 排雷循环」「二 · 内容量」地形变异两行加屏蔽注记（2026-10-16 贫矿脉整图型屏蔽删行，variation.tres 回 region 六行；机制代码保留，重建设计加行即恢复）。除未决项销项外条目集合零增删；连带 06 立绘条子问题二与状态行随裁换代（方向已裁+08 指路改注，权威面 art-bible/character-design 反哺另批） |
| v1.8 | 2026-10-16 | **playnote 二轮对照批（用户令立框架：不需要讨论的写进 08 并同步 06、需要讨论的挂 06 待裁）**：① 「三 · 界面」「暂停层」行改名「状态面板（局内）」（随 2026-10-13 暂停层改名批换代——08 行名漏扫）并在役→部分在役（瘦身义务入册：去跨关解锁内容〔秘宝匣解锁态 12 行概览 / 天赋树已购概览〕、只留本局五件〔带的秘宝 / 已获专长 / 当前属性 / 现有 GP / 钥石总量〕——来源=playnote「状态界面不需要有具体的解锁内容」条；同步登记 06「状态面板瘦身」专条）；② playnote 余下增量两条不进本表：成长系数节奏语义两读待澄清→06 专条待裁（数值调优义务 v1.6 起不入版本标准）；路径长度统计与递增增幅=关卡节点图重构的设计输入→补进 06 既有专条。条目集合零增删（改名不算增删），未决项与「六 · Alpha 不含」零触碰 |
| v1.9 | 2026-10-17 | **未开格类型微光实装回填（迭代 30 卡①，反哺点回写用户令授权）**：「五 · 表现」表新增「未开格类型微光（五组色相＋明度档）」行（事实源 = HUD框架 微光节——2026-10-17 实装入库），状态 = 在役（明度档 provisional 值登记见 art-bible 版本历史，复核转正归战斗一屏样张〔迭代 30 序位②〕）；文头状态行 v1.8→v1.9。条目集合 +1 行（回写授权＝用户裁），未决项与「六 · Alpha 不含」零触碰 |
design/gdd/systems/表现与支撑/HUD框架.md
+5 -2
View File
@@ -137,10 +137,12 @@ HUD框架站在玩家与全部玩法系统之间：挖掘期它是输入的翻
| 信息内容 | 只表达格面资源的类型（九类格面资源归五组色相呈现，色相/明度/画法规格归 [art-bible](../../../art/art-bible.md) §4.2）；不表达极性（安全/雷）、不表达具体收益档位 |
| 生命周期 | 资源身份装板期摇定（微光只是显示，不改任何游戏数据）→ 未开 ∧ 在 8 格内 → 亮；格子被挖开/连锁开/踩雷 → 灭；角色走远出圈 → 灭，走回 → 复亮；换图随旧图全重置 |
| 关联与边界 | 信息本体（格面资源身份）归[地图战斗资源](../战斗循环/地图战斗资源.md)；棋盘格态与动作合法性归[排雷玩法](../排雷循环/排雷玩法.md)；与「接触带微光」同圈不同职责——接触带微光=可挖域的交互反馈光（「这里能挖」），类型微光=相邻格的类型先读（「这格是什么类型」） |
| 实装状态 | 呈现契约已定稿（五组色相经样张 v2 冻结 2026-09-28）；**游戏内待实施批**（2026-09-30 核证：呈现层仅接触带微光在跑，类型微光无独立实现；实施状态挂 06-待办清单「未开格类型徽章呈现时机」条） |
| 实装状态 | 呈现契约已定稿（五组色相经样张 v2 冻结 2026-09-28）；**已实装（迭代 30 卡① 2026-10-17 入库，合并 `7ffd1dc0`）**——2026-09-30 核证的「呈现层仅接触带微光在跑，类型微光无独立实现」状态自此注销；在役实现（五组色相 = ui_kit TG_GLOW_*、格面微光子件 + 距离场 shader）与验收转正见本节末「验收标准」类型微光行，登记面归 [06-待办清单](../../06-待办清单.md)「未开格类型徽章呈现时机」条（已完成） |
口径史注记（防复发）：本概念曾只活在 06-待办清单登记与 art-bible 复述里，「常显」「全部未开格」等无范围表述于 2026-09-30 酿成理解事故；用户裁决「英雄周围 8 格」为正确口径并落位本节。教训=概念必须落地权威文档，零散复述不是定义。
两带分工注记（2026-10-17 迭代 30 卡①登记）：类型微光实装后，棋盘外另有「卡顶色带」（徽章/条目顶边色带，悬赏与秘宝等面板格面条目顶边的类型色带）与本格面微光并存——卡顶带 = 条目级静态色带（一眼扫类型），格面微光 = 棋盘格内动态微光（相邻先读）；两套载体不同、职责不同，**禁互为引用**。两带统一面（卡顶带取值改用 art-bible 五组色值、归组改 cell_type 精确值）归 [06-待办清单](../../06-待办清单.md)「卡顶色带与格面微光两带统一」条（待办）。
### 可挖域指示（接触带微光）：「这里能挖」的交互反馈光
> 本节是「接触带微光」（可挖域交互反馈光）的呈现规则现行事实源（2026-09-30 用户裁决落位——目录职责三分工：概念/玩法内容归 GDD、美术风格指导归 art-bible、UI 设计归 UX；各目录只干职责内的事，引用走文档链接，不贴异域内容）。
@@ -266,7 +268,7 @@ HUD框架站在玩家与全部玩法系统之间：挖掘期它是输入的翻
- 三区无遮挡、无重叠、无内容裁切（棋盘全部格子与数字完整可见），分区尺寸与 battle.md 布局表一致；同屏 draw calls < 200；进入战斗屏 500ms 内首格可点。
- 两档板装板后格边长取定值档（36 / 45px）且可行性校验通过；数字字号不低于下限、整数倍缩放无模糊。
- 已开 / 未开格态在灰度截图下可逐格分类；已引爆危险格"可通行可读"（已开底加巢穴纹、可作移动目标）。
- 类型微光（待实施批落地后验收）：微光只在英雄周围 8 格内的未开格显示；出圈即灭、入圈即亮；已开格与封锁格恒无微光；微光呈现不随格是雷是安变化（不泄危险格与安全格）。
- 类型微光：微光只在英雄周围 8 格内的未开格显示；出圈即灭、入圈即亮；已开格与封锁格恒无微光；微光呈现不随格是雷是安变化（不泄危险格与安全格）。（迭代 30 卡①实装后转正式验收）
- 视野迷雾：棋盘仅菱形灯光区内完整渲染；区外已开格灰显可读、区外未开格不可见；灯光区随角色移动跟随；同一张板同一份动作序列，迷雾开关两种状态下的结算结果逐位一致（纯呈现，零游戏数据改动）。
- 悬停光标三语义（移动 / 挖 / 旗）随目标切换并高亮目标格；悬停已开格画出合法路径（不可达不显示）；可挖域常驻呼吸微光。
- 一帧内意图整批到达，停手点击终结当帧收集。
@@ -310,3 +312,4 @@ HUD框架站在玩家与全部玩法系统之间：挖掘期它是输入的翻
| v0.15 | 2026-10-09 | **文档正确性审查批·独立复核（worktree docaudit-2026-10-09）**：①视野迷雾配套拍板段补魔法提灯退役注（2026-10-09 用户裁——fog_lantern 数据行与卡④接线拆除归退役删行批，功能由新目录「阔视野带」承接，06 登记条在册）；②呈现义务清单秘宝行「库存条常读」改「装配件与充能常读」（同调形态无库存条——与秘宝.md v1.7 依赖表对齐）+补在役旧框架注；③P0 闭环第 6 步与验收「终局」条的关卡末清库载体补机械惰性承载注（关卡域库存恒空、拆线归实装批——与战斗结算 v0.28 同款口径）；④P1 相邻域屏行「节点奖励屏随秘宝内容重定批」过期批次名清偿（node-reward.md v2.5 令牌池已在役） |
| v0.16 | 2026-10-10 | 柜台名扫改（2026-10-10 天赋树设计会话裁「道具工坊」改名「秘宝匣」）：迭代 19 卡④入库注记内「营地道具工坊同调装配获渠」改「营地秘宝匣同调装配获渠」。机制与接线零改动 |
| v0.18 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 5 处——核心规则导语「收口」→「完成」；装板校验「报错中止」→「显示错误并中止」；迷雾实施状态注记「随批」→「顺带」2 处（探针断言扩、测试引导语）；营地覆盖层注记「随批补缺」→「顺带补缺」。机制、数值、结构零改动 |
| v0.19 | 2026-10-17 | **未开格类型微光实装入库注记（迭代 30 卡①，合并 `7ffd1dc0`）**：①微光节实装状态行「游戏内待实施批」→「已实装」（2026-09-30 核证的「无独立实现」状态注销），在役实现（ui_kit TG_GLOW_* 五组、格面微光子件 + 距离场 shader）随行登记；②口径史注记后补「两带分工」注记（卡顶色带 = 条目级静态色带 / 格面微光 = 棋盘格内动态微光，禁互为引用；统一面归 06 两带统一条）；③验收标准类型微光行去「待实施批落地后验收」括注转正式验收。微光定义（一句话/作用范围/生命周期/关联边界）零改动；明度档 provisional 值登记归 art-bible 版本历史 |