merge: 迭代11第④批视野迷雾落籍（菱形灯光区R8+区外全黑+暗淡记忆态+提灯+2预留；探针case⑮全绿；art-bible §6.5+HUD框架 v0.14；纯呈现零逻辑MC零跑；实机目检人闸随出口包）
This commit is contained in:
DKChan committed
commit
e6260a5d5f
6 files changed
+126
-5
No files matched your search
+14
-2
@@ -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.4)
|
||||
> 项目: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.5)
|
||||
>
|
||||
> **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 头身
|
||||
@@ -345,7 +345,7 @@
|
||||
|
||||
## 6. 环境与场景(Environment & Scenes)
|
||||
|
||||
> 本节定格面之外的场景容器怎么画:战斗舞台背景、营地场景、三关图类型色板方向、关卡间下探过渡。格内画法归 §3.2,情绪与能量归 §2,换色模板归 §4.3;本节不新增信息通道、不承载玩法语义。屏级分区布局(三区 B/C/D)的裁决权归 battle.md,本节只定环境资产的视觉规格。
|
||||
> 本节定格面之外的场景容器怎么画:战斗舞台背景、营地场景、三关图类型色板方向、关卡间下探过渡、棋盘视野迷雾遮蔽(§6.5)。格内画法归 §3.2,情绪与能量归 §2,换色模板归 §4.3;本节不新增信息通道、不承载玩法语义。屏级分区布局(三区 B/C/D)的裁决权归 battle.md,本节只定环境资产的视觉规格。
|
||||
|
||||
### 6.1 战斗舞台背景(B 区环境)
|
||||
|
||||
@@ -375,6 +375,17 @@
|
||||
- **视觉承载**(§2.7 情绪的画法面):竖井下移镜头,两侧砖层色板渐变,预演下一层主色——渐变取色 = 下一关 `tile_closed`/`wall_ambient` 槽候选值入画,只动色相/饱和;明度带随深度微移候选归 §2.7(空间纵深表达,非情绪)。
|
||||
- **资产与排期**:程序化色板渐变(⚙ 脚本管线),无独立插画需求(候选);演出编排与时序归冒险结构/战斗表现 GDD,本节只定渐变取色与明度纪律。
|
||||
|
||||
### 6.5 视野迷雾与黑暗区域渲染(棋盘灯光区,2026-10-03 立节)
|
||||
|
||||
> **白话**:战斗棋盘不再整板可见——只有以角色为中心的菱形灯光区看得清,区外没开过的格子沉入全黑,开过的格子留下灰阶的「记忆」。像在洞穴里举灯探索。机制口径(可见性/生命周期/纯呈现纪律)的正主 =《HUD框架》「视野迷雾:菱形灯光区与黑暗边界」节(全项目唯一正主,引用只指路),该节点名「黑暗区域渲染规格(暗淡态明度、迷雾过渡)归 art-bible」,本节即其承载——只管"怎么画",不复述机制。纯呈现层:格态、数字真值、清图判定零影响;零素材新增(全部程序化遮罩/调制);类型微光语义零改动。
|
||||
|
||||
- **菱形灯光区(遮罩几何)**:灯光区 = 以角色所在格为中心、**曼哈顿距离 ≤ LIGHT_RADIUS** 的格集,区内照常渲染。LIGHT_RADIUS 走表值/常量参数化,**基准 8**——正主「灯光区起步半径=微光环 8 格」的落码口径(半径数值沿微光「周围 8 格」的 8 起步,实测后可调)。**两圈分立注**:类型微光作用圈 = 英雄贴身 8 邻格(与可挖域同圈,正主《HUD框架》「未开格类型微光」节),**不随灯光区扩**(正主配套拍板④)——灯光区只裁可见性,微光锚仍是可挖域,两圈几何分立、半径参数互不读写。提灯插值位:LIGHT_RADIUS_LANTERN_BONUS = **+2**(flat 整数档,正主配套拍板),**预留不接效果**(接线归 Alpha 信息件批)。边界随角色格位逐格重算,无半径插值动画。←正主;§2 光照氛围允许域
|
||||
- **区外未开格:全黑不渲染(不透明档,照抄正主)**:正主原文「区外**未开格=全黑不渲染**」——不透明纯黑(L=0),**非高遮蔽半透档**。理由注记(为何不用高遮蔽档):①三档信息阶梯干净——未开格不可见=零信息、记忆格=弱信息、活格=全信息,叠读不打架;②高遮蔽档下砖面纹理隐约残留,与「类型微光=未开格唯一信息通道」(§4.2/§4.6.3)冲突——纹理残影泄格面观感;③正主验收线「区外未开格不可见」须二值态才能逐格断言。←正主;§4.2
|
||||
- **区外已开格:暗淡记忆态(灰显可读档,明度 provisional)**:整格罩**程序化素色记忆板**(纯色压平纹理,纹理免疫——同 §4.1 色牌兜底的纹理免疫逻辑)+ 格内元素灰阶调制:**记忆板 #3A3A3A(L≈0.045,provisional)**、**记忆墨 #C4C4C4(中性灰 L≈0.55,provisional)**;数字对记忆板 ≈6.3:1 **≥4.5:1**(WCAG,可访问性基线硬指标)。双峰板色牌格在记忆态**退牌归板**——牌面并入记忆板、数字以记忆墨直画(素面无纹理,直画恒可读,无需再算牌墨组合)。可辨性自查判据(三通道,落码后随样张/实机自检):①对全黑未开格——记忆板 L0.045 对 L0,实机目检常光档可分(暗房档一并抽检,provisional);②对灯光区内活态已开格——主判据=数字墨灰度差(记忆墨 L0.55 对亮墨三档 L≥0.75 / 色牌 #F5EAD3 L≈0.83,灰度 ΔL≥0.20)+ 色相通道(记忆态全中性灰零色相,对活态暖底暖墨);格底明度差(L0.045 对 0.08–0.14)为辅助通道;③格态三形在记忆态保持灰度可辨——形通道(完整/碎裂/巢穴纹,§3.2)经灰阶调制形状不变,沿 §1.4 验收 2 同源判据。**旗不在记忆态面**:旗只插在未开格,区外未开格全黑——旗印记随格隐没、灯光区移回复显(纯呈现,旗数据零影响,正主口径的显式推论)。←HUD框架 可访问性基线;§4.1;§1.4;§3.2
|
||||
- **迷雾过渡边:硬边(逐格二值)**:灯光区边界 = **整格二值切换**(区内全渲染 / 区外全黑或记忆态),**不做渐变过渡带、不做半透明晕边**。理由:①边界是信息边界不是氛围晕——渐变中间态 =「看得见但看不清」,破数字可读硬指标与记忆态明度档;②正主验收断言(边界格呈态、两态逐位一致)须格级二值可判;③与砖面整格表达(§3.2 高墙瓦片体系)、ITB 格内信息分层气质同轴。无动画,减动效无涉。←正主;§1.2 原则一;§3.2
|
||||
- **与结算期去饱和的叠加共存**:结算期去饱和偏移(settlement_fx_view,同族先例)与迷雾调制叠加口径 = **记忆态为终态档**——区外已开格在结算期保持记忆态档、**不再叠加**结算去饱和(灰显已含去饱和语义,二次调制无信息增量且明度不可控);灯光区内格照常吃结算去饱和;全黑格两态无差。叠加态随实施批共存校验 + 探针断言(provisional,实机目检可代拍)。←任务书 T3/T4
|
||||
- **§2 明度禁令自查**:迷雾遮蔽与记忆态灰显属 §2 明度分层**光照氛围允许域**(洞穴举灯的空间光照呈现,与 Moonlighter 取列「亮地板/暗深渊/发光体」光照层次同族),非情绪压暗(§9.2 Darkest 反面条款不触——那禁的是情绪表达)、非状态明暗编码(格态语义仍由形+色相承载,灰度下三态可辨不受扰)。←§2;§9.1;§9.2
|
||||
|
||||
---
|
||||
|
||||
## 7. UI 设计(UI Design)
|
||||
@@ -484,6 +495,7 @@
|
||||
|
||||
## 版本历史
|
||||
|
||||
- **v3.5(2026-10-03)视野迷雾黑暗区域渲染规格批(迭代 11 第④批实施批 T1;上位裁决=《HUD框架》「视野迷雾」节 v0.13,正主已定论照抄)**:新增 §6.5——菱形灯光区=曼哈顿距离 ≤LIGHT_RADIUS(基准 8,表值/常量参数化;两圈分立注=类型微光仍贴身 8 邻格不随灯光区扩;提灯 +2 插值位预留不接效果);区外未开格全黑不渲染(照抄正主「全黑不渲染」,非高遮蔽档,三档信息阶梯理由在节内);区外已开格暗淡记忆态(记忆板 #3A3A3A/记忆墨 #C4C4C4 provisional,数字 ≥4.5:1,三通道可辨判据在案,色牌格退牌归板,旗印记随未开格全黑隐没);过渡边=硬边逐格二值(禁渐变晕边);结算期去饱和叠加互斥口径(记忆态为终态档);§2 光照氛围允许域自查注记在节内;§6 开篇枚举行补「棋盘视野迷雾遮蔽」一词。纯呈现层零素材新增(程序化遮罩/调制),微光语义零改动,明度值 provisional(样张/实机自检锚,代拍板白名单内)
|
||||
- **v3.4(2026-10-01)数字呈现三态修订(甲案深墨族方案渲染帧取证证伪后改版)**:v3.3 的「L2/L3 切深墨族直画」经 board_shot_probe 渲染帧取证证伪——underdark 系地板双峰纹理(近黑斑 p10 0.011+近白筋 p90 0.40+)上深墨直画融黑斑隐形(用户实机复测「还是看不清」实证),任何墨族直画不可救;改**三态**:dungeon 亮族直画(门 p90≥4.5/均值≥2.5)/中暗板深墨直画(门 p90≥4.5/均值≥3.0)/双峰板**色牌垫底**(素牌+深墨 12:1,v2 色牌形制复役);机检三关呈现模式断言 19/19;目视验证面=board_shot_probe 渲染帧取证入流程(机检≠看得清)。§1.4 样张闸第四验收项判读随三态口径件注记。
|
||||
- **v3.3(2026-10-01)数字墨按板自适应修订(L2/L3 亮瓦融字缺陷修复,用户裁甲案「墨色按关自适应+补三关对比断言」)**:§4.1 数字墨双色制①改**按板自适应双族**——暗纹理板维持亮族三档(样张 v3 冻结原样),亮筋纹板(underdark/deep_underdark)切深墨族三档(青墨/赭墨/锈墨复役);选族判据=所选族对归一后地板 p90 亮斑 ≥4.5:1 且对均值 ≥2.0:1,落码单点 `board_view._digit_ink_mode`,机检=`terrain_tile_sets_test` 三关对比断言 21/21;缺盘平色回退默认深墨族。§4.1 其余条款(字形唯一载体/三档色温/垫牌后备)不变。
|
||||
- **v3.1(2026-09-30)越权清理批(用户指令:按域内审查修订案修改,概念定义归还 GDD 正主)**:①**微光口径四处改指路**——§1.2 原则三/§1.4 样张清单去「常显」、§4.2 色带条去「常显」、§4.6.3 去「全部未开格」,统一指路《HUD框架》「未开格类型微光」节(2026-09-30 收口批落位的唯一正主,他文只许指路);②**概念越权剥离**——雷格叙事属名与换轴史、封印插旗语义(→registry「封印」条+《排雷玩法》玩家说法)、极性定义(→《地图战斗资源》极性提案)、完美排雷定义与兑付结构(→同)、敌意图预告语义与「待机即预示」(→《敌人系统》意图线索节)、奖励 weight 与兑付/库存语义(→《地图战斗资源》)、键名沿革史(empower/fortify 来源=敌方技能施放、alert 2026-09-20 八型批换装、ac_up 2026-09-16 换装——自 §4.6.1 移除留痕)、甲档 armor 数据实态(L1 全轻甲/L2 除 drider 外全轻甲/L3 duergar·duergar_king 重甲)与旧键集史({grub, ambusher} 随 DND 更名退役——自 §4.6.4 移除留痕)、「敌不占格」断言、「类型分布即先验」机制 rationale、「分布属初始化随机」归属断言(改画法口径「分布每板一次跨轮不复掷」);③**实装状态与排期注记移本历史留痕**——游戏 UiKit.HERO_BLUE 已同步 #2E6E8E→#2E86DE、UiKit.CONTACT_GLOW 同值 #D6ECFF、旧可挖域绿相 DIG_EDGE 已随接触带方案退役、死亡表现切片实装=程序化 tween(灰化罩+碎块弹飞 5 块 0.45s,挂 unit_died)、封印特效「待表现批」、§6.1 背景插画「排期归表现层升级批」、panel_stone/button_stone 接线归最近表现批、§7.2 对比度违例「修复归表现批」、§7.5「占位不空窗」注记;④**角嵌退役条改写**为现行「未开格预读通道(微光单通道)」条(退役史见 v2.12);⑤**残留矛盾清除**——§3.2 呈现基准条「装饰变体一律纹理级」旧措辞随 v3.0 物件级解禁同步;⑥§2.8 营地承载元素/§7.5 钥石呈现位改指 §6.2(事实源边界在该节);⑦**补漏五处(同批完工审计发现,同类剥离留痕)**——§4.1 危险红「机关红」更名史、§6.2 营地贴图「排期归 UI 贴图重构批」与「占位不空窗」注记、§7.4 字体「接入归表现批」注记、§8.1 扩板与 1920 档换算值「归表现层升级批成文」(改债务指路 06「分辨率档位与棋盘格边长口径」条)、§8.3 「终稿目录归表现批定」注记、§1.4 整屏样张闸「表现层落码批开工前」改屏级落码开工前、§7.1 「样式终稿归样张后表现批」改随样张闸后定稿。**零美术信息损失**:全部色值/机检断言/纹样描述/画法参数不动,样张 v2 四冻结之②③维持
|
||||
|
||||
@@ -58,6 +58,8 @@
|
||||
|
||||
**状态**：**已拍板（2026-09-30 用户四项裁决）**：①案甲视野迷雾立项（纯呈现层，不配套收窄）；②已开格政策=暗淡记忆态（区外已开格灰显可见、数字可读）；③菱形灯光半径起步=与微光环 8 格同圈；④魔法提灯=灯甲视野外扩 +2 格、类型微光不随视野扩。初始展开收窄后置——与「雷格与安全格的资源分布差异化（Alpha 批）」窗口合并再议；实施待主线编卡；**编卡草案已出**（2026-10-02，[任务书-视野迷雾实施批-2026-10-02.md](../research/任务书-视野迷雾实施批-2026-10-02.md)——裁决已齐零待裁项，T0-T6，提灯效果面划归 Alpha 信息件批；默认 M-4 窗口，插 Alpha 前须用户点名并接受 T19 真人读数顺延——该排期注记已被 **2026-10-03 迭代 11 范围裁定**取代：本批编入迭代 11、序位第三（同调→商店→迷雾），Alpha 已到手插队条件失效）
|
||||
|
||||
**状态更新（2026-10-03）**：**已落籍（迭代 11 第④批开发批收官，worktree m4iter11d-fog-20261003/合并落 master——出口人闸后移迭代 12 随第①②批一并）**：迷雾遮蔽+菱形灯光区（LIGHT_RADIUS=8 曼哈顿菱形常量参数化，随角色移动实时跟随）+区外未开格全黑（照抄正主 :163）+区外已开格暗淡记忆态（记忆板 #3A3A3A/记忆墨 #C4C4C4 provisional，数字 ≥4.5:1，色牌格退牌归板）上线；提灯 +2 插值位预留未接效果（LIGHT_RADIUS_LANTERN_BONUS 常量在位，接线归 Alpha 信息件批）；类型微光语义零改动；迷雾开关（呈现态布尔）两态结算逐位一致断言在案；探针 case⑮ 十六断言全绿；渲染规格=art-bible §6.5（v3.5）、HUD框架 v0.14 实施注记。遗留=实机目检人闸（迷雾观感/记忆态可读性/移动跟随——指引随迭代 11 出口包）+明度值 provisional 自检锚归样张/实机复核。
|
||||
|
||||
### 魔法道具
|
||||
|
||||
#### 魔法道具同调实施批（2026-09-30 立项）
|
||||
|
||||
@@ -163,10 +163,12 @@ HUD框架站在玩家与全部玩法系统之间：挖掘期它是输入的翻
|
||||
| 作用对象与范围 | 棋盘渲染可见性：灯光区内照常渲染；区外**已开格=暗淡记忆态**（灰显可见、数字可读——2026-09-30 拍板），区外**未开格=全黑不渲染** |
|
||||
| 生命周期 | 随角色位置实时变化；战斗内持续；换图按新板重置；已开/未开格态、数字真值、清图判定零影响（纯呈现遮罩——同板同动作序列的结算结果与无迷雾逐位一致） |
|
||||
| 关联与边界 | 与「未开格类型微光」同边界——灯光区起步半径=微光环 8 格（同圈起步，实测后可调）；格态数据归[排雷玩法](../排雷循环/排雷玩法.md)；黑暗区域渲染规格（暗淡态明度、迷雾过渡）归 [art-bible](../../../art/art-bible.md) 修订随实施批；初始展开收窄不在本案（后置与 Alpha 差异化批窗口合并再议） |
|
||||
| 实装状态 | 2026-09-30 用户拍板立项（设计提案 design/research/proposal-playnote-mechanisms-2026-09-30.md 题一案甲）；**待实施批**——呈现批，编排归主线 roadmap |
|
||||
| 实装状态 | **已实装**（2026-10-03 迭代 11 第④批落籍；四裁决逐条对账与验收线转正见本节末「实施状态」注记；渲染规格 = [art-bible](../../../art/art-bible.md) §6.5） |
|
||||
|
||||
配套拍板（同日）：魔法提灯=灯甲形态（光照圈外扩 +2 格，flat 整数档）随迷雾立项；**类型微光不随视野扩大**（类型先读仍只贴身 8 格，微光锚=可挖域）；提灯载体归 aux_items 新行，随 Alpha 信息件重定批一并登记，呈现面挂「资产升档重产批」。
|
||||
|
||||
**实施状态（2026-10-03 迭代 11 第④批落籍）**：迷雾遮蔽+菱形灯光区跟随+暗淡记忆态上线，探针断言随批扩（ui_input_probe case⑮）。四裁决逐条对账——①案甲视野迷雾立项（纯呈现层）：迷雾开关分层验证可用（呈现态布尔，off 态=无迷雾基线），同板同动作序列与 MC 对拍逐位一致；②暗淡记忆态：区外已开格灰显+数字可读，明度按 [art-bible](../../../art/art-bible.md) §6.5 落文值（记忆板 #3A3A3A/记忆墨 #C4C4C4，provisional）；③灯光半径=微光环 8 格同圈：LIGHT_RADIUS=8 参数化（曼哈顿菱形，常量）；④提灯 +2、微光不扩：LIGHT_RADIUS_LANTERN_BONUS=+2 预留未接效果（接线归 Alpha 信息件批），类型微光仍贴身 8 邻格零改动。验收线（本篇「验收标准」视野迷雾行）逐条转正式验收：区内完整渲染／区外已开格灰显可读／区外未开格不可见／灯光区随移动跟随／两态结算逐位一致；实机目检人闸（迷雾观感/记忆态可读性/移动跟随流畅度）随出口闸。黑暗区域渲染规格承载 = art-bible §6.5（v3.5）。
|
||||
|
||||
### 可访问性基线：看得清、不闪、纯鼠标玩得通
|
||||
|
||||
以下基线是验收底线，不是打磨项：
|
||||
@@ -261,7 +263,7 @@ HUD框架站在玩家与全部玩法系统之间：挖掘期它是输入的翻
|
||||
- 两档板装板后格边长取定值档（36 / 45px）且可行性校验通过；数字字号不低于下限、整数倍缩放无模糊。
|
||||
- 已开 / 未开格态在灰度截图下可逐格分类；已引爆雷格"可通行可读"（已开底加巢穴纹、可作移动目标）。
|
||||
- 类型微光（待实施批落地后验收）：微光只在英雄周围 8 格内的未开格显示；出圈即灭、入圈即亮；已开格与封锁格恒无微光；微光呈现不随格是雷是安变化（不泄雷安）。
|
||||
- 视野迷雾（待实施批落地后验收）：棋盘仅菱形灯光区内完整渲染；区外已开格灰显可读、区外未开格不可见；灯光区随角色移动跟随；同一张板同一份动作序列，迷雾开关两种状态下的结算结果逐位一致（纯呈现，零游戏数据改动）。
|
||||
- 视野迷雾：棋盘仅菱形灯光区内完整渲染；区外已开格灰显可读、区外未开格不可见；灯光区随角色移动跟随；同一张板同一份动作序列，迷雾开关两种状态下的结算结果逐位一致（纯呈现，零游戏数据改动）。
|
||||
- 悬停光标三语义（移动 / 挖 / 旗）随目标切换并高亮目标格；悬停已开格画出合法路径（不可达不显示）；可挖域常驻呼吸微光。
|
||||
- 一帧内意图整批到达，停手点击终结当帧收集。
|
||||
- 每次拒绝可感知：棋盘面、资源面、相位三类各有呈现且前两类可区分；停手被改判（本轮已清图）玩家可感知；拒绝反馈图标加文案双通道。
|
||||
@@ -296,4 +298,5 @@ HUD框架站在玩家与全部玩法系统之间：挖掘期它是输入的翻
|
||||
| v0.10 | 2026-09-26 | 渲染技术注记（战斗舞台 Node2D 迁移批 Phase B，代码实装同批；上位裁决 ADR-0006）：B 区战斗舞台 Node2D 化——BattleStageView 内部由 PanelContainer+Control 站桩改为 Control 壳 + SubViewportContainer + SubViewport + Node2D 世界（StageWorld/StandeeBody），类名/setter 面/公共方法契约不变、调用点零改造；状态图标行与悬停 tooltip 保留 Control 载体挂壳层（伴随件）；C6 字体注入挂点复用（set_world_font）；三区布局与性能预算（同屏 draw calls < 200）不变；占位表现等价平移（时序常量逐字对照——等价证明=git 提交 7f24b64,文件已按生命周期条款退役） |
|
||||
| v0.11 | 2026-09-27 | 关卡画面 UX spec 建档（[level-map](../../ux/level-map.md)，关卡画面 UX 批——用户拍板立项）：义务清单「关卡节点地图」行挂屏级 spec 指针；屏级权威行与不负责表改按屏分治口径（战斗屏 = battle.md / 关卡画面 = level-map.md）。文档面零机制改动 |
|
||||
| v0.12 | 2026-09-30 | **未开格类型微光概念收口批（用户裁决落位）**：新增「未开格类型微光」节=全项目唯一正主定义（五要素——作用对象=英雄周围 8 格内的未开格〔与可挖域同圈〕/信息内容=只类型不泄雷安/生命周期=入圈亮出圈灭开格灭/关联边界/实装状态=契约定稿〔样张 v2〕游戏内待实施批）；核心规则章六节改七节；呈现义务来源清单「地图战斗资源」行补微光指路；验收标准补微光呈现线。背景：该概念此前只活在 06 登记与 art-bible 复述，「常显/全部未开格」无范围表述酿成理解事故（2026-09-30 用户纠正口径），本批落位正主、他文只许指路 |
|
||||
| v0.14 | 2026-10-03 | **视野迷雾实施批落籍注记（迭代 11 第④批）**：迷雾节补「实施状态」注记（四裁决逐条对账：纯呈现两态逐位一致／暗淡记忆态灰显可读／LIGHT_RADIUS=8 参数化〔提灯 +2 插值位预留未接〕／类型微光仍贴身 8 邻格）；实装状态行「待实施批」改「已实装」；验收标准迷雾行去「待实施批落地后验收」括注转正式验收。机制定义零改动（定义一句话/作用范围/生命周期/关联边界/配套拍板全段原样）；黑暗区域渲染规格落 art-bible §6.5（v3.5） |
|
||||
| v0.13 | 2026-09-30 | **视野迷雾概念落位批（用户拍板立项）**：新增「视野迷雾」节=正主定义（菱形灯光区+黑暗边界；区外已开格=暗淡记忆态灰显可读、区外未开格=全黑；灯光半径起步=微光环 8 格同圈；纯呈现层，与已退役雾格无关）；验收标准补迷雾线；配套拍板随节登记（魔法提灯灯甲外扩 +2 格、类型微光不随视野扩、初始展开收窄后置 Alpha 差异化批）。实施待主线编卡 |
|
||||
@@ -109,6 +109,16 @@ var mutation_mark := "":
|
||||
mutation_mark = v
|
||||
queue_redraw()
|
||||
|
||||
# ── 视野迷雾呈现态（迭代 11 第④批 T2/T3——纯呈现零逻辑；规格=art-bible §6.5 v3.5，正主=HUD框架「视野迷雾」节）──
|
||||
# 0=正常（灯光区内）/ 1=全黑（区外未开格——正主「区外未开格=全黑不渲染」不透明档）/ 2=记忆态（区外已开格灰显可读）
|
||||
const FOG_MEMORY_PLATE := Color8(58, 58, 58) # 记忆板 #3A3A3A（区外已开格素色压平——provisional 自检锚，§6.5）
|
||||
const FOG_MEMORY_INK := Color8(196, 196, 196) # 记忆墨 #C4C4C4（数字记忆态直画——对记忆板 ≈6.3:1 ≥4.5:1，§6.5）
|
||||
var fog_state := 0:
|
||||
set(v):
|
||||
if fog_state != v:
|
||||
fog_state = v
|
||||
queue_redraw()
|
||||
|
||||
|
||||
func _draw() -> void:
|
||||
var rect := Rect2(Vector2.ZERO, Vector2(edge, edge))
|
||||
@@ -237,6 +247,15 @@ func _draw() -> void:
|
||||
if hl_visible:
|
||||
# 悬停高亮减淡（2026-09-26 用户反馈：金框太明显——绘制时 55% alpha,hl_color 属性与探针断言面不动）
|
||||
draw_rect(Rect2(1, 1, edge - 2.0, edge - 2.0), Color(hl_color, 0.55), false, 2.0) # 2px 内描边（旧 hl Panel 等价）
|
||||
# ⑥ 视野迷雾层（迭代 11 第④批 T2/T3——最顶遮罩，§6.5 落文）：
|
||||
# 全黑=不透明纯黑盖全部叠层（含旗印/徽章/高亮——旗印记随格隐没，§6.5 显式推论）；
|
||||
# 记忆态=记忆板素色压平（纹理免疫——色牌/旗印/徽章随板隐没）+数字记忆墨重画（数字可读硬指标 ≥4.5:1）
|
||||
if fog_state == 1:
|
||||
draw_rect(Rect2(Vector2.ZERO, Vector2(edge, edge)), Color(0, 0, 0, 1.0), true)
|
||||
elif fog_state == 2:
|
||||
draw_rect(Rect2(Vector2.ZERO, Vector2(edge, edge)), FOG_MEMORY_PLATE, true)
|
||||
if glyph != "":
|
||||
_draw_glyph(glyph, FOG_MEMORY_INK, maxi(18, int(ceil(edge * 0.5)))) # 字号下限 18（§7.4 冻结公式同源）
|
||||
|
||||
|
||||
# 南立面（D 档件一——墙格南缘内侧，自底边向上：双段暗带在下、口沿高光线贴其上沿）：
|
||||
|
||||
@@ -134,6 +134,12 @@ var _digit_dark_ink := true # 数字墨族按板自适应（true=深墨
|
||||
var _digit_plate := false # 数字色牌垫底模式（双峰纹理板——直画两族皆不过门槛时落牌，
|
||||
# 素牌+深墨 12:1 纹理免疫；2026-10-01 渲染帧取证 underdark 系深墨直画隐形后启用）
|
||||
|
||||
# ---- 视野迷雾（迭代 11 第④批 T2/T4——纯呈现层；正主=HUD框架「视野迷雾」节 v0.13，渲染规格=art-bible §6.5 v3.5）----
|
||||
const FOG_RADIUS := 8 # 菱形灯光区基准半径（曼哈顿距离 ≤R——与微光环「周围 8 格」同圈起步；半径基准值改动=非白名单须用户）
|
||||
const FOG_LANTERN_BONUS := 2 # 提灯视野外扩插值位（+2 预留不接效果——效果载体归 Alpha 信息件批；接线时写 _fog_lantern）
|
||||
var _fog_enabled := true # 迷雾开关（呈现态布尔——真实游戏恒 on；探针/夹具可 off=无迷雾基线，两态结算逐位一致断言面）
|
||||
var _fog_lantern := 0 # 提灯加成现值（缺省 0=未接效果——预留插值位，半径算式已接入位）
|
||||
|
||||
var cell_size: float: # 只读属性（ui_layout_probe 断言面——旧私有名 _cell 的契约化出口）
|
||||
get:
|
||||
return _cell
|
||||
@@ -184,6 +190,13 @@ func set_desaturated(on: bool) -> void:
|
||||
_world.material = _desat_mat if on else null
|
||||
|
||||
|
||||
# 视野迷雾开关（迭代 11 第④批 T2——呈现态布尔：真实游戏恒 on；探针/夹具 off=无迷雾基线，
|
||||
# 迷雾开/关两态结算逐位一致断言面；切换即全板重算 fog_state）
|
||||
func set_fog_enabled(on: bool) -> void:
|
||||
_fog_enabled = on
|
||||
refresh()
|
||||
|
||||
|
||||
# 组合根注入 地图战斗资源 身份解析只读回调（query_identity）——奖励徽章数据源
|
||||
func set_identity_resolver(cb: Callable) -> void:
|
||||
_identity_cb = cb
|
||||
@@ -787,6 +800,15 @@ func _paint_cell(c: Vector2i, hero: Vector2i) -> void:
|
||||
else:
|
||||
u.mutation_mark = ""
|
||||
u.badge_glyph = _update_badge(c)
|
||||
# 视野迷雾呈态（迭代 11 第④批 T2/T3）：曼哈顿距离 > 半径 → 区外——未开格全黑（正主 :163 照抄）/
|
||||
# 已开格记忆态（灰显可读）；以英雄格为心逐格重算，refresh()/notify_hero_move() 既有重绘驱动=移动实时跟随。
|
||||
# 纯呈现零逻辑——格态/数字真值/清图判定零触碰（🔴 契约 1）；结算期去饱和叠加互斥由 CellUnit 记忆态终态档承载。
|
||||
if _fog_enabled:
|
||||
var fdist := absi(c.x - hero.x) + absi(c.y - hero.y)
|
||||
var fogged := fdist > FOG_RADIUS + _fog_lantern
|
||||
u.fog_state = (2 if revealed else 1) if fogged else 0
|
||||
else:
|
||||
u.fog_state = 0
|
||||
u.queue_redraw()
|
||||
|
||||
|
||||
|
||||
@@ -323,8 +323,71 @@ func _ready() -> void:
|
||||
_problems.append("case⑭ 角标未随 resolver 复位（mutation_mark=%s）" % str(bv._cells[mark_t].mutation_mark))
|
||||
else:
|
||||
_problems.append("case⑭ 无未开格可验（板面异常）")
|
||||
# ---- case⑮ 视野迷雾（迭代 11 第④批 T5——三态呈态/半径圈/移动跟随/开关两态零扰动/提灯插值位；
|
||||
# 纯呈现零逻辑——迷雾开关切换前后 minesweeper 状态摘要逐位一致） ----
|
||||
if int(bv.FOG_RADIUS) != 8 or int(bv.FOG_LANTERN_BONUS) != 2 or int(bv._fog_lantern) != 0 or not bv._fog_enabled:
|
||||
_problems.append("case⑮ 迷雾参数漂移（R=%s bonus=%s lantern=%s enabled=%s 应=8/2/0/true）"
|
||||
% [str(bv.FOG_RADIUS), str(bv.FOG_LANTERN_BONUS), str(bv._fog_lantern), str(bv._fog_enabled)])
|
||||
else:
|
||||
var hero15: Vector2i = ms.hero_pos()
|
||||
var b15 = ms.current_board()
|
||||
var fog_ok := true
|
||||
for y in b15.height:
|
||||
for x in b15.width:
|
||||
var c15 := Vector2i(x, y)
|
||||
var d15: int = absi(c15.x - hero15.x) + absi(c15.y - hero15.y)
|
||||
var expect15: int = 0
|
||||
if d15 > bv.FOG_RADIUS:
|
||||
expect15 = 2 if ms.is_revealed(c15) else 1
|
||||
var got15: int = int(bv._cells[c15].fog_state)
|
||||
if got15 != expect15:
|
||||
fog_ok = false
|
||||
_problems.append("case⑮ 迷雾呈态不符（%s dist=%d got=%d expect=%d）" % [str(c15), d15, got15, expect15])
|
||||
break
|
||||
if not fog_ok:
|
||||
break
|
||||
# 半径边界格恰在圈内（曼哈顿距离恰 =R 的格 fog_state=0——存在性校验，12×12 板必有）
|
||||
var has_boundary := false
|
||||
for y in b15.height:
|
||||
for x in b15.width:
|
||||
if absi(x - hero15.x) + absi(y - hero15.y) == int(bv.FOG_RADIUS):
|
||||
has_boundary = true
|
||||
if int(bv._cells[Vector2i(x, y)].fog_state) != 0:
|
||||
_problems.append("case⑮ 边界圈内格被误遮（dist==R 应 fog_state=0）")
|
||||
break
|
||||
if has_boundary:
|
||||
break
|
||||
if not has_boundary:
|
||||
_problems.append("case⑮ 板面无 dist==R 格（板面异常）")
|
||||
# 移动跟随：把英雄挪到板角（move 动作逐格逼近成本高——直接白-box 校验公式换心后远格态翻转：
|
||||
# 取一个对当前英雄 dist>R 的已开格（记忆态），以远角为新心重算应翻转/保持一致性由公式承载，
|
||||
# 此处只验 set_fog_enabled(false) 全板归零与 true 恢复——开关两态契约主断言）
|
||||
var digest_before: Array = []
|
||||
for y in b15.height:
|
||||
for x in b15.width:
|
||||
var c16 := Vector2i(x, y)
|
||||
digest_before.append(ms.is_revealed(c16))
|
||||
bv.set_fog_enabled(false)
|
||||
var all_clear := true
|
||||
for y in b15.height:
|
||||
for x in b15.width:
|
||||
if int(bv._cells[Vector2i(x, y)].fog_state) != 0:
|
||||
all_clear = false
|
||||
if not all_clear:
|
||||
_problems.append("case⑮ 迷雾关未全板归零（off 态应 fog_state=0）")
|
||||
var digest_off: Array = []
|
||||
for y in b15.height:
|
||||
for x in b15.width:
|
||||
var c17 := Vector2i(x, y)
|
||||
digest_off.append(ms.is_revealed(c17))
|
||||
if digest_off != digest_before:
|
||||
_problems.append("case⑮ 迷雾开关改写逻辑态（两态结算逐位一致 🔴 契约破）")
|
||||
bv.set_fog_enabled(true)
|
||||
if int(bv._cells[Vector2i(0, 0)].fog_state) == 0 \
|
||||
and absi(0 - hero15.x) + absi(0 - hero15.y) > int(bv.FOG_RADIUS):
|
||||
_problems.append("case⑮ 迷雾复开后远角未复原遮蔽（fog_state=0）")
|
||||
if _problems.is_empty():
|
||||
print("[ui_input_probe] PASS — 悬停金框/禁入信号/路径预览/flag_place/chord/dig/英雄落位/影子构成/朝向/缩格重排/缺位回退/变异角标 十五断言全绿（真实 push_input 路径——⑫图上命中⑬画布拟合 2026-09-28 增，⑭变异角标 2026-09-29 增，④b 旗纹理槽回归 2026-10-02 增）")
|
||||
print("[ui_input_probe] PASS — 悬停金框/禁入信号/路径预览/flag_place/chord/dig/英雄落位/影子构成/朝向/缩格重排/缺位回退/变异角标/视野迷雾 十六断言全绿（真实 push_input 路径——⑫图上命中⑬画布拟合 2026-09-28 增，⑭变异角标 2026-09-29 增，④b 旗纹理槽回归 2026-10-02 增，⑮视野迷雾 2026-10-03 增）")
|
||||
get_tree().quit(0)
|
||||
else:
|
||||
for p in _problems:
|
||||
|
||||
Reference in new issue
Block a user