docs(待办登记): 误诊条「第二/三关棋盘观感——亮度与对比度」退役，改立「棋盘瓦片与立体表现重做」（2026-11-07 用户令）
- 删除旧卡 reports/需求卡片-二三关棋盘观感批-2026-10-16.md（用户裁「删除就行了,过期的东西」） - 待办清单整条换代：新条实况＝用户裁定根因是瓦片素材与立体画法（非亮度/对比度）＋真 3D/HD-2D 排除＋三条证据指针（art-bible §3.2 自含岩体冻结、cell_base_layer 全本格内绘制、digit_plate 亮度修补失败）；缺口＝立体画法设计讨论四要点；改动面＝文档＋美术素材＋游戏代码 - 08-Alpha 表现清单行同步换代（出口＝实机目检立体感与素材观感达标） - roadmap 待编池措辞同步 区内凭据: run_all_gates.sh --docs【验收通过】无新增红（gdd_lint/死链/术语/流水线闸/引用/能力审计/熵增闸全过）。按用户令，本批不合入 master，待会话最终产出目标完成后另行请示。
This commit is contained in:
DKChan committed
1 parent
f7d7761e7c
commit
1aab4dbaf1
4 files changed
+7
-299
No files matched your search
@@ -146,7 +146,7 @@ Alpha 内以玩法循环本身的内容与表现为主（棋盘、关卡、战
|
||||
| 像素美术风格与色板 | [美术圣经](../art/art-bible.md) | 在役 |
|
||||
| 棋盘瓦片与格面资源图标 | [美术圣经](../art/art-bible.md) | 在役 |
|
||||
| 未开格类型微光（五组色相＋明度档） | [HUD框架](systems/表现与支撑/HUD框架.md) | 在役（明度档 provisional 值登记见 art-bible 的 git 提交史；观感复核已随战斗一屏样张过闸完成——用户实机目检核销，沿革查 git 提交史） |
|
||||
| 棋盘观感（第二 / 三关亮度与对比度） | [待办清单](../../待办清单.md) | 待做（开工前置＝先做素材轴／UI 轴对照截图定性，再按定轴修复；旧卡 v1.4 存 reports/ 作素材、非已写卡状态，重启须重新立卡；出口＝用户实机目检第二、三关不再判「看着费劲」） |
|
||||
| 棋盘瓦片与立体表现重做 | [待办清单](../../待办清单.md) | 待做（根因＝瓦片素材与立体画法，非亮度/对比度；原误诊条退役、旧卡删除；真 3D/HD-2D 排除；开工前置＝呈现层立体画法设计讨论＋样张先行用户目检定风格；出口＝用户实机目检棋盘立体感与素材观感达标） |
|
||||
| 立绘显示清晰度（原稿分辨率＋三档显示） | [角色设计](../art/character-design.md) | 在役（原稿分辨率入包禁降采样、显示按三档绝对高缩放、现有形象即终稿；定值单点=art-bible §8.2（档值定值面＝站桩守门测试）；实机目检清晰度与同屏体量顺序登记体验验证清单 ㊻） |
|
||||
| 敌人立绘（全敌种） | [角色设计](../art/character-design.md) | 在役 |
|
||||
| 主角立绘三态 | [角色设计](../art/character-design.md) | 在役 |
|
||||
|
||||
@@ -1,292 +0,0 @@
|
||||
# 需求卡片：第二 / 三关棋盘观感——亮度与对比度批（T1 定性人闸 · T2 按轴修法 · 验收三件套 · 文档面全走反哺点）
|
||||
|
||||
- 版本：**v1.4（2026-10-17 开工前预授权 U1〔用户于开工前一次性决断，防开发中反复打断〕——①Q2 甲/乙由「延裁·T1 出口现场裁」改**判据自动裁**：甲案候选样张读数达标即直接走甲不停机，仅当读数证伪「纹理太碎」假说时才呈报裁乙；②V2 定向目标带数值授权批内按 T1 实测读数自定并随定性报告呈报，T1 出口人闸只确认轴归因与修法方向；③详见 §10 Q2 条与开工门 U1 预授权条）；v1.3（2026-10-17 文档同步闸 v3 口径修订，纯文档批〔分支 carddoc-20261017〕按用户六条裁定执行——①本批（代码实现批）禁写 `design/` 整目录与根规则文件，§5 同步面的同步义务一律执行为「列进 `reports/iter30-反哺点-<完成日>.md`（哪个文件哪一节、改成什么、依据），用户会话裁决后归文档批落文」；②产出物落位换代：实现报告／代拍板追认单／反哺点清单三份落 `reports/`，不再 `design/qa/`；③T5 末卡改「产出物落位卡」（三份 reports/ 文件写齐才算收口）；④闸口径按域选档：重闸 = `tools/run_all_gates.sh` 按改动域选档（本批 → `--code`），卡内不再写死闸件名单与「全量档」类字样；⑤实机目检项写进 `reports/iter30-实现报告-<完成日>.md` 实机目检总清单，「登记 07」转反哺点；§10 裁决留痕原文不动）；v1.2（2026-10-16 裁决留痕版：三卡待裁项按用户令定案——Q3 已裁甲·同批、Q2 延裁留痕并将裁点挂至 T1 出口呈报硬流程步骤、排期栏定实「已编入迭代 30」与三卡串行序位、§4B 跨卡依赖按已裁事实改实、全卡零悬空待裁点；v1.1 同日 grilling 审查修订见 §11；v1.0 同日成文）**
|
||||
- **指路订正（2026-10-20）**：徽章卡（迭代 30 卡①）已按 doc-conventions §11「吸收即死」退役，本卡对其三处指路句改为结论内联＋提交号 `7ffd1dc0`，裁决内容零变更。
|
||||
- 来源：[06-待办清单](../design/gdd/06-待办清单.md)「第二 / 三关棋盘观感——亮度与对比度」小节（2026-10-13 用户裁定条）+ [playnote](../playnote.md) 用户试玩原始记录：「UI优化，第二第三关的棋盘看着太累了；不知道是因为亮度还是对比度的原因，看着非常费劲，非常不舒服」
|
||||
- 归属：**表现层美术修批**（06 在册条目直接写卡；两轴归属 = [HUD框架](../design/gdd/systems/表现与支撑/HUD框架.md)（UI 轴）+ [美术圣经](../design/art/art-bible.md)（素材轴），定性前两方共裁——沿用 06 条裁决）
|
||||
- 排期：**已编入迭代 30（2026-10-16 用户令编入，roadmap 行已在案；批内状态刷新列反哺点）**。同迭代三卡串行序位第 3：未开格类型徽章批卡（迭代 30 卡①，已入库合并 7ffd1dc0，卡片已退役）→[战斗一屏样张批卡](需求卡片-战斗一屏样张批-2026-10-16.md)→本卡（徽章→样张→观感）。**并行例外**：本卡 T1/T1b 采样与定性读数允许与前两卡并行穿插——依据=采样是只读动作（出帧/读数/样张均不触碰 golden 三张、样张主板、§5 同步面文档等汇聚文件），落码修改（T2 起）仍按上述序位串行。开工门 = U0，须用户 `/iter` 发令；且 T1 出口定性人闸未过之前禁止动码——该闸 = [06 本条](../design/gdd/06-待办清单.md)既有裁决硬步骤（「开工前先过『素材轴 / UI 轴』定性人闸」，2026-10-13 用户裁定；[08 git 提交史](../design/gdd/08-Alpha版本标准.md) v0.3 同款注），**不是待裁点**（v1.1 撤销原 Q1，见 §10）。
|
||||
- **立场前提（用户原话，本卡设计的第一约束）**：此条立项原因就是用户实机觉得现在的画面累眼、且对「纯程序化重产现状」明确不满——「如果还是用原有方式弄出来的东西，有没有可能还是我不满意的？」。本卡对此的正面回应 = ①第一步定性用**可量化的读数归因**（明度直方图 / 相邻格对比 / 高频能量 / WCAG 对），禁止凭感觉猜轴；②两条修法各自的产出物写清**相对现状新增什么**（§6 T2 两案效果上限表）；③**诚实的效果声明**：观感是主观项，机检只能证伪（读数红 = 必有问题）不能证真（读数绿 ≠ 用户满意），**阻塞性人闸全部前置**（T1 定性闸 + 契约 4 方向闸），入库后实机目检按 2026-10-12 用户令口径**登记不阻塞**——目检项登记进 `reports/iter30-实现报告-<完成日>.md` 实机目检总清单（「入册 07」列反哺点；[AGENTS.md](../AGENTS.md) 红线「真人检测只登记不阻塞——禁以等目检为停工理由」口径不变），用户复判否决走 §7 V4 回补机制（行回待做 + 06 立残留条，落文按 v3 口径归文档批）。防「改一轮还是不满意」的机制 = **先出改前/改后并排对比读数样张给用户定性确认方向，方向过了人闸才落码**（🔴 契约 4）——方向若被否决，返工停在样张层，不烧落码与基线。
|
||||
|
||||
---
|
||||
|
||||
### 0. 前置依赖与既有裁决
|
||||
|
||||
| # | 前置 | 内容 |
|
||||
|---|---|---|
|
||||
| P1 | **定性人闸（06 条既有裁决——流程硬步骤，非待裁点）** | 06 原文（445 节内）：「开工前须先定性（沿用既有裁决）……两轴修法完全不同，定性错了等于白改一轮」+ 状态行「开工前先过『素材轴 / UI 轴』定性人闸」（2026-10-13 用户裁定条；该要求最早载于 06「奇物呈现优化探讨备忘两孤儿点」(e)，本条承接转正）。本卡 T1 即该闸承载，结论过用户确认才进 T2——v1.0 曾把此闸再列 Q1 待裁，v1.1 撤销（禁再问已裁项） |
|
||||
| P2 | **与「呈现层残余 <4.5:1 文字位」条的分工（06 条既有注记）** | 06:451 分工句原文：「本条管**棋盘区域整体的观感**（亮度/对比度/费劲感），是体感问题；『呈现层残余 <4.5:1 文字位』管**具体文字位的对比度读数不达标**（B 区站桩名行/敌顺位徽标/RAP 反馈行三处），是机检可判的硬指标。两条不同面，不互相替代，各自保留」；该文字位条已随迭代 26 T3 完成（06:443）。本卡管棋盘区域整体观感（体感问题），**禁吞并该条**（🔴 契约 2）；T1 读数若发现新的文字位红点，另行登记，不并入本卡 |
|
||||
| P3 | **08 标准覆盖行** | [08-Alpha版本标准](../design/gdd/08-Alpha版本标准.md)「五 · 表现」表「棋盘观感（第二/三关亮度与对比度）」行（08:145）现为**待做**（事实源指向本 06 条）；Alpha 完成判据 = 全部条目在役 ⇒ 本卡完成时该行 待做→在役 改写列反哺点（§6 T5；时机=本批入库，落文归文档批，目检复判否决的回补机制见 V4） |
|
||||
| P4 | **08 未决项关联（按名指路；v1.1 按实查改写）** | 08「七 · 未决项」现行表含「**素材升档重产进不进 Alpha**」行（2026-10-16 实查为该表第 6 行，另有「**立绘清晰度回退评估**」行——未决项表 2026-10-16 v1.6 重编号过，**行号不作指路依据，一律按名找**）；「素材升档重产」在「五 · 表现」表现为**待裁**（08:154）。06「资产升档重产批」条现行状态注记 = 2026-10-04 用户令「暂不做、先忽略，重启=用户点名」+ 2026-10-06「优先级再降」+ 2026-10-06 方案二注记（原升档路线已被八敌逐键定档实质走完、剩余挂起项=提灯点亮解禁候选）。划界：该批面向**立绘/小人帧尺寸升档**，本卡素材轴乙案 = **L2/L3 棋盘瓦片色板/纹理方案重做**——对象、管线、闸面均不同面，**裁本卡乙案 ≠ 放开升档重产**，呈报时须带此划界（§6 T2 乙案行） |
|
||||
| P5 | **渲染闸与基线现状** | 棋盘三关 golden 基线冻结于 2026-09-30（`tools/golden_compare.py:11`），改瓦片/改常量**必然**破 Δ≤16/changed≤2% 容差 ⇒ 基线换代是本卡的确定义务而非例外处理（§7 V3） |
|
||||
|
||||
---
|
||||
|
||||
## 1. 目标与完成定义
|
||||
|
||||
**目标**：把 L2/L3 棋盘「看着太累」的观感问题**归因到轴**（素材轴 / UI 轴 / 两轴共因），按轴修复，并经用户实机复核确认体感改善。
|
||||
|
||||
**完成定义**（五件齐才算完成，缺一即该条在 06 保持待办）：
|
||||
1. T1 定性报告交付：逐关三测面（棋盘瓦片区 / 舞台底与屏根 / 叠加层）读数表 + 归因结论（轴判定，引用具体数值）；**T1 出口定性人闸过**（06 已裁硬步骤，P1）；
|
||||
2. T2 修法按裁定轴别落码/落素材，既有样张口径闸全部保持绿（A6 梯度均值 ≥4.70、F6 立面双明度带 Δ≥18、格底明度档 §4.1、图底分离——见 §2.4；**注**：该组断言现行落点=样张主板（dungeon 拼板，`render_sample_sheet_v3.py:130-131`），L2/L3 分关实测属本批新建读数件（T1b），见 §11 攻击面 2）；
|
||||
3. 验收三件套走完：机检读数达标 + 渲染闸 golden 基线显式重制并呈报换代面 + 用户实机目检轮**登记**（目检项登记进 `reports/iter30-实现报告-<完成日>.md` 实机目检总清单，「入册 07」列反哺点；2026-10-12 用户令=登记不阻塞入库，否决走 V4 回补）；
|
||||
4. 08「五 · 表现」棋盘观感行 待做→在役 改写列反哺点（含 07 目检登记注；落文归文档批）；
|
||||
5. §5 同步面每条在 `reports/iter30-反哺点-<完成日>.md` 有落点（06 对应条目状态更新条在内）；权威文档与根规则文件零直改。
|
||||
|
||||
**效果不确定性的诚实声明**：观感是主观项。机检读数能证伪（超带 = 必有问题）不能证真（达标 ≠ 满意）。证真面由**前置人闸**承担（T1 定性闸 + 契约 4 方向样张闸——方向不过不落码）；入库后的实机目检轮按 2026-10-12 用户令「真人检测只登记不阻塞」执行，用户复判若仍不满意 = V4 回补机制触发（08 行回待做 + 06 记残留、下批重开），不算本批未入库。
|
||||
|
||||
---
|
||||
|
||||
## 2. 现状事实（2026-10-16 实查；开工日自行复核行号）
|
||||
|
||||
### 2.1 关级与瓦片（素材轴现状）
|
||||
|
||||
| # | 事实 | 出处 |
|
||||
|---|---|---|
|
||||
| F1 | 三关板型与图类型：L2 12×12 underdark / L3 13×13 deep_underdark；**L1 行群主体 10×10 dungeon、但含 12×12 dungeon 行**（2026-10-16 逐行实查 `board_gen.tres`——level_index 1 段内有一行 12×12），故 T1 的 L1 参照位读数面须覆盖两种板型（词表 v1.1） | `game/data/tables/board_gen.tres` 各行；`game/data/schemas/board_gen_table.gd:13` |
|
||||
| F2 | 每关瓦片 = **墙 16 件 + 地面 5 变体，合计 21 件**（v1.0 误写「墙类 21 件」，v1.1 订正：16 唯一墙名单单点在 `TILE_WALL_NAMES` 常量数组，件名数=16；21 为总数）按 `terrain_%s_%s.png` / `terrain_floor_%s_%d.png` 格式装载；源 dungeon 套为 v9.3 定稿，underdark/deep_underdark 套由程序换色产出；另有**不参与换色的板面相关件**：`flag_seal.png`（封印旗，三关共用独立可选件） | `game/presentation/views/board_view.gd:80-89`；`tools/recolor_terrain_tiles.py` 头注；素材实盘 `game/assets/art/board/`（underdark/deep_underdark 各 21 件与 dungeon 套同构；素材不入 git，用户裁定） |
|
||||
| F3 | 换色方法 = 槽位家族重映射（wall/facade/floor/crater 四族），**亮度秩序逐像素保持**、确定性零随机、唯一色数与源一致；目标色表在脚本 `PALETTES` 内 | `tools/recolor_terrain_tiles.py:10-12`（方法注）+ `:40-60`（色表） |
|
||||
| F4 | 现行换色色表读值：underdark 地面 `G_BASE (62,66,80)`、crater 最深 `P_DEEP (9,10,15)`；deep_underdark 地面 `G_BASE (46,48,64)`、crater 最深 `P_DEEP (5,5,9)`——**冷蓝紫、低明度、crater 近纯黑**；对照 dungeon 源 `G_BASE (88,66,50)` 暖中明度 | 同上 `PALETTES` |
|
||||
| F5 | 色相域方向（机检在案）：underdark ≈180°–260° 灰白蓝紫 / deep_underdark ≈200°–280° 蓝黑紫黑；断言「deep 墙顶明度恒暗于 underdark」 | `game/tests/unit/presentation/terrain_tile_sets_test.gd:61-64, :82`；方向权威 = art-bible §4.3 |
|
||||
| F6 | 图类型换皮四槽（`tile_closed`/`tile_open`/`wall_ambient`/`variant_tint`）与恒定不变槽（信息语义色全图型恒定、格底两档明度关系恒定）；格底硬指标：未开墙顶 L≥0.30、已开底走世界底层档候选 L 0.08–0.14、饱和 ≤0.55、避 300°–345° 禁入带 | [art-bible](../design/art/art-bible.md) §4.3 / §4.1「对比硬指标」/ §4.2 紫赤条 |
|
||||
|
||||
### 2.2 UI 轴现状（舞台底与叠加层常量位点）
|
||||
|
||||
| # | 事实 | 出处 |
|
||||
|---|---|---|
|
||||
| F7 | 舞台底 `STAGE_BG #3E342A`（62,52,42）= B 区舞台面板暗底；屏根 `BG_ROOT #3A2E22`；暖亮档 `BG_BRIGHT #453723`（提暖提亮禁近黑配色总纲在册） | `game/presentation/views/ui_kit.gd:111-113, :121`；`battle_stage_view.gd:44-47` |
|
||||
| F8 | 视野迷雾叠加层：灯光区半径 `FOG_RADIUS 8`（基准值改动 = 非白名单须用户）；**区外未开格 = 全黑不渲染（不透明纯黑盖全部叠层）**；区外已开格 = 记忆态灰显；雾轮廓 `UiKit.FOG_OUTLINE` | `board_view.gd:137, :817-822`；`board_cell_unit.gd:111-117, :252-256`；规格 = art-bible §6.5 + HUD框架「视野迷雾」节 |
|
||||
| F9 | 数字墨三态管线（v3.4 定案）：双峰纹理板（underdark/deep_underdark 系）= 色牌垫底 `DIGIT_PLATE + 深墨 #33261B`；亮族判据 p90 ≥4.5:1 / 均值 ≥2.5:1 | `board_view.gd:987-989`；art-bible §4.1 数字墨条 |
|
||||
| F10 | 类型微光 v2 呈现**规格** = 内缘带状泛光 α170 / 带宽 cell÷8，亮度不压格底明度档（§2 微光例外）；五组色带样张 v2 定稿。**v1.1 注**：类型微光游戏内**尚无独立实装**（呈现层仅接触带微光在跑；实施归同迭代 30 的未开格徽章批，见 §4A）——本卡 T1 的微光测面读数源=样张 v2 静态定稿图，实机渲染帧里没有该层 | art-bible §4.2「类型微光色带」条；HUD框架「未开格类型微光」节实装状态行（:130-142） |
|
||||
|
||||
### 2.3 L2/L3 差异面（同批与否的判据）
|
||||
|
||||
- 板型不同（12×12 vs 13×13）、色板不同（F4/F5 两套槽值，deep 系整体再暗一档）、格边长换算随板型变（06 在册「格边长三方取值不一致」条为已知偏差，本卡不动）；数字墨模式两关同属双峰板色牌态（F9）。⇒ L2、L3 观感读数**必须分开设点**，修法同批——Q3 已裁甲·同批（2026-10-16 用户令，§10），两关槽值差异由 T1 分关读数（T1b）承载。
|
||||
|
||||
### 2.4 既有量化口径（样张 v3 与机检链，验收判据引用面）
|
||||
|
||||
| # | 口径 | 定值 | 出处 |
|
||||
|---|---|---|---|
|
||||
| C1 | **A6 观感密度：明度梯度均值**（相邻像素相对亮度差均值——高频细节能量；低频双峰由 A3 承载） | ≥4.70（v1 同口径实测 4.09 上调 15%） | `tools/render_sample_sheet_v3.py:26, :338, :1007-1022`（历史脚本注释含 v1 实测值）。**v1.1 核注**：该组断言（A3/A6/F6）现行作用面 = 样张主板（`terrain_*_dungeon` 拼板，脚本 `:130-131`）——L2/L3 瓦片改动**既不会触动这组闸、也测不到它们**；「分关实测」属本批新建读数件（T1b），非现成能力 |
|
||||
| C2 | **F6 立面双明度带** | Δ≥18（现行执法定值 `FACADE_MIN`） | 同上 `:339`、`:996` 消费点与 v3.5 冻结口径注（`:1154`） |
|
||||
| C3 | **A3 图底分离**（墙/地） | **现行执法 = v3.5 冻结定值 A3b Δ≥30**（方向稿实测 38）；旧 Δ≥55 系色牌制地板 L0.036 时代校定，与格底分档带数学冲突已退役 | 同上 `:975-979`（退役注+现行 check）、`:1154`；`:23, :340` 之 55 为历史注释残迹 |
|
||||
| C4 | 格底明度档 | §4.1：世界底层档候选 L 0.08–0.14 / 墙顶 L≥0.30 / 饱和 ≤0.55（48 色上限与 RGB 三通道差 ≥8/255 双门在 §4.1 增量纪律在案；「待定现用」态释义同节） | art-bible §4.1 |
|
||||
| C5 | 渲染闸现行链 | `tools/render_gate.sh` 四段：shot_probe 七屏→`shot_checker.py` A–D+F 语义断言（B 文字对比 ≥4.5:1 / C 明度三档带 / D 文字禁压纹理 / F 文字在判据〔2026-10-15 补〕；E 焦点预算归人闸）→ fx/board 取证 → 棋盘三张 golden（差 ≤16、changed ≤2%）→ 菜单 golden；基线重制工具 `tools/golden_baseline_refresh.sh`（缺省模式=棋盘三张；`--menu`=菜单全屏；素材缺位拒跑；呈现批 agent 自行换代+提交说明强制写明触发原因——权限口径在其头注） | `render_gate.sh:8-25, :109-155`；`shot_checker.py:8-19`；`golden_baseline_refresh.sh:2-14` |
|
||||
| C6 | 三关棋盘抓帧承载（读数采样源） | `board_shot_probe` targets = L1_dungeon / L2_underdark / L3_deep_underdark，随 render_gate 周期跑；同关驱动确定性=种子 420000+关号 + novice 18 步 + 1.2s 动画完结等待（可复现）。**v1.1 边界注**：帧面 = 空视口上裸挂 BoardView（900×900）——棋盘瓦片区与迷雾遮罩层**在帧内**，**舞台底/屏根像素不在帧内**（battle_stage_view/BG_ROOT 未实例化）；「舞台底/叠加层只在渲染帧里存在」系 v1.0 不准确表述，舞台底为常量平铺（UiKit 可读值）。且 render_gate 过程帧落 mktemp 即弃禁入 git——T1 用帧须自行留档于库外目录 | `game/smoke/board_shot_probe.gd:34, :38-66`；`render_gate.sh:22`（过程产物纪律） |
|
||||
|
||||
---
|
||||
|
||||
## 3. 设计契约（红线，违反 = L3 停机呈报）
|
||||
|
||||
🔴 **契约 1 · 零玩法逻辑变更**：只动呈现（瓦片素材/色表、舞台底与叠加层常量、样张脚本判据）。板生成、数字真值、迷雾判定逻辑、`FOG_RADIUS` 基准值（改动须用户，`board_view.gd:137` 注）零触碰。
|
||||
|
||||
🔴 **契约 2 · 禁吞并文字位条**：「呈现层残余 <4.5:1 文字位」是另一面（该条已随迭代 26 完成，本卡不复活、不并账）；本卡发现的任何文字位新红点 = 新登记条目，另批处理。
|
||||
|
||||
🔴 **契约 3 · 色板纪律不破**：任何换色/重产色板须过 art-bible §4.1 增量纪律双门（48 色上限、与既有任一色 RGB 三通道差 ≥8/255）+ §4.2 语义检查与信息面禁入带 300°–345°；素材轴甲案并须保持 recolor 脚本的亮度秩序逐像素保持方法学（改了方法 = 换案，须重述本契约）。
|
||||
|
||||
🔴 **契约 4 · 样张先行、方向人闸后落码**：T2 任一修法落码前，必先出**改前/改后并排对比样张 + 读数表**给用户定性；用户未确认方向 = 停在样张层，禁先行改素材改常量。此条是「防改一轮还是不满意」的机制本体。**v1.2 注**：素材轴甲/乙裁决呈报件（§6 T1 呈报硬步骤）与本闸是同批产物——用户呈报现场裁甲后，裁甲案时本闸即已过关、不重复呈报；裁乙案时乙方向样张另走本闸。
|
||||
|
||||
🔴 **契约 5 · 机检 ≠ 观感，前置人闸承担方向证真**：读数达标只构成必要条件，机检不能证明满意——「证真」面由**前置**人闸承担（T1 定性闸〔06 已裁〕+ 契约 4 方向样张闸）。入库后的实机目检轮按 2026-10-12 用户令口径执行（AGENTS.md 红线「真人检测只登记不阻塞」）：目检项登记进 `reports/iter30-实现报告-<完成日>.md` 实机目检总清单即完成义务、不卡入库（「入册 07」列反哺点）；**禁把「机检全绿」写成「用户满意」的等价表述**——用户复判否决时按 V4 回补（08 行回待做 + 06 记残留、下批重开，落文按 v3 口径归文档批）。（v1.1 改写注：v1.0 本条「完成判定必须含用户实机目检轮、目检未过禁宣布在役」与 2026-10-12 用户令冲突，已对齐。）
|
||||
|
||||
🔴 **契约 6 · golden 基线换代显式化**：改图必破基线——重制走 `tools/golden_baseline_refresh.sh` 显式流程（缺省模式重制棋盘三张：board_shot_probe 抓帧→`golden_board_crop.py` 按 meta 坐标裁剪→覆盖 `game/tests/golden/` 三张；触及菜单态加跑 `--menu`），并逐屏呈报换代面（新旧基线并排，沿 render_gate S2 停机点口径）；权限与义务=呈现批 agent 自行换代、**提交说明强制写明触发原因**（refresh 脚本头注 Q6 在册）；前置=素材齐盘（脚本逐项守卫，缺位拒跑）。**禁先刷基线后改图**（基线是判据不是障碍物）。
|
||||
|
||||
---
|
||||
|
||||
## 4. 范围边界
|
||||
|
||||
**做**：L2/L3 棋盘区域观感的定性归因（T1）、按轴修复落码（T2）、同批策略（T3）、验收三件套与基线换代（T4）、产出物落位（T5）。
|
||||
|
||||
**不做**（明示去向）：
|
||||
- 不动 L1 dungeon 套外观——除非 T1 读数显示问题为系统性共因（如迷雾档/舞台底全关同因，则 UI 轴修法天然全关生效，素材轴仍只动 L2/L3 色表）；
|
||||
- 不动数字墨三态管线本身（`_digit_ink_mode` 选模逻辑维持），只动其消费的板面；改后三模式断言 `terrain_tile_sets_test` 必仍绿；
|
||||
- 不做「格边长三方取值不一致」条的处置（06 在册待扩板定档，另批）；
|
||||
- 不做「立绘清晰度回退评估」/「素材升档重产」两未决项的代裁（本卡甲/乙裁点仅覆盖棋盘瓦片重产路线，且已挂至 T1 出口呈报硬流程步骤——裁决留痕见 §10，未决项不代裁、禁重开）；
|
||||
- 不动未开格类型微光的呈现规格（§4.2 单通道纪律维持；**该层引擎尚未实装，实施归未开格徽章批——§4B**；T1 会把微光层列为读数额外测面〔证据级别=样张 v2 静态图，F10〕，T2 无「动参数」可言——若归因指向它，处置为联裁或走 art-bible §4.2 修订登记）。
|
||||
|
||||
---
|
||||
|
||||
## 4B. 跨卡依赖（同迭代 30 的两张同板面批——v1.1 新增；v1.2 按 2026-10-16 三卡已裁定案改实）
|
||||
|
||||
本卡与**未开格类型徽章批**（迭代 30 卡①，已入库合并 7ffd1dc0，卡片已退役）、**战斗一屏样张批**（`需求卡片-战斗一屏样张批-2026-10-16.md`）共用 L2/L3 板面，事实与已裁结果如下（只列事实与裁决留痕，他批未裁项仍不代裁）：
|
||||
|
||||
| # | 交叠面 | 事实 | 本卡处置 |
|
||||
|---|---|---|---|
|
||||
| X1 | **徽章批微光层 × 本卡格底/墙顶瓦片改色，同一张未开格面** | 徽章批把五组类型微光实装进未开格（其 T0-② 五组明度档以 art-bible §4.1「未开格底 L≥0.30 不被压破」为约束基线）；本卡素材轴改的正是 `tile_closed`（墙顶/未开底）明度——**两批改同一板面、先后互为约束**：本卡若抬/压墙顶档，徽章批五组明度档取值基线随之移动。art-bible §4.3 共同纪律已册：「三套候选色相均须与五组类型微光色带（§4.2）抽测互辨（格底与微光同在未开格面，邻近色相有吞没风险）」（:379） | 色板/微光互辨复测两批并档一次跑；本卡新色表呈报件须含「对五组微光色带吞没风险」逐项比对；**v1.2 定实（2026-10-16 用户令）**：三卡串行序位徽章→样张→观感（排期栏），golden 棋盘三张换代次数=先落者（徽章批）刷一次、本卡作为后落者再刷一次，不再挂呈报定序；徽章批微光**明度档 provisional 值**（其 Q2 已裁甲=本批定档）与本卡**格底明度档同基线**（art-bible §4.1 格底档 L 0.08–0.14、墙顶/未开格底 L≥0.30）——两卡改格底/叠光时须逐位比对 golden 防互踩，该约束已同步写入 §6 T2 修法约束 |
|
||||
| X2 | **战斗一屏样张批 Q1（素材输入级别）/Q3（渲染手段）与本卡乙案（瓦片重产）** | 样张批 Q1 丙案语义 =「样张反向给素材重产提规格」；样张批明示「本批不重产任何正式素材」——**重产的产出义务全在本卡（若裁乙）**，样张的规格输入义务也在本卡上游对齐；若样张批先以占位板面冻结，本卡乙案重产后整屏样张的板面内容过期 | **v1.2 定实（2026-10-16 用户令）**：样张批已裁 **Q1 丙**（样张反提素材规格）/**Q3 乙**（引擎实拍+shader）——本卡乙案（远程生图重产）**若**在 T1 出口呈报后被裁，瓦片规格**必须与样张卡已冻结的目标规格清单对齐，先后次序=样张规格先行、本卡乙案在后**；甲案 recolor 换色不触样张主板（dungeon 拼板，C1 核注），对样张批零连带、不受该次序约束 |
|
||||
| X3 | **徽章批「不动格底明度档、棋盘瓦片素材、图类型换皮四槽」红线（其 §4 不做条）** | 徽章批单向避撞本卡面；反向不成立——本卡改瓦片会动其微光绘制基面（其 F5：微光画在 CellUnit `_draw` 瓦片层上） | 本卡任何改图产物过 V5 时须同时跑徽章批既有断言面（若其已入库）；串行序位已定实（徽章→样张→观感，排期栏）——徽章批先落，本卡 T1 报告按该序位复核 X1/X3 承接项，不再挂定序呈报 |
|
||||
|
||||
**结论笔**：两依赖均为**次序与规格联动**问题，不是范围冲突；2026-10-16 用户令已定案——串行序位徽章→样张→观感（排期栏）、Q3 已裁甲（同批）、Q2 甲/乙裁点挂 T1 出口呈报硬流程步骤（§6 T1/§10）；本卡无悬空待裁点。
|
||||
|
||||
---
|
||||
|
||||
## 5. 关联文档同步面
|
||||
|
||||
> **v1.3 执行口径（2026-10-17 文档同步闸 v3）**：本批（代码实现批）**禁写 `design/` 整目录与根规则文件**，唯一可写目录 = `reports/`（`active.md` 唯一例外）。下表「同步义务」列一律执行为「列进 `reports/iter30-反哺点-<完成日>.md`：哪个文件哪一节、改成什么、依据，用户会话裁决后归文档批落文」——下表保留原关联点事实供写反哺点条目时对表。
|
||||
|
||||
| 文档 | 关联点 | 同步义务（v1.3 全部=反哺点列清单，另注者除外） |
|
||||
|---|---|---|
|
||||
| [06-待办清单](../design/gdd/06-待办清单.md) 本条 | 状态行改写（定性报告交付/完成注记）；T1 发现的新红点若立新条则同批登记 | 反哺点 · 列清单待裁 |
|
||||
| [08-Alpha版本标准](../design/gdd/08-Alpha版本标准.md) 「五 · 表现」棋盘观感行 | 待做→在役（完成定义第 4 件；批入库时改写并顺带 07 目检登记注；用户复判否决走 V4 回补——行回待做+06 记残留） | 反哺点 · 完成时列清单 |
|
||||
| [art-bible](../design/art/art-bible.md) §4.1/§4.3（素材轴改色表值）或 §6.5/§7（UI 轴改常量方向） | 数值定值单点纪律：改值 = 走该节修订并登记（「待定现用」态），禁只改代码不改文档 | 反哺点 · 列清单待裁（条目写明改值与修订登记要求） |
|
||||
| [HUD框架](../design/gdd/systems/表现与支撑/HUD框架.md) 视野迷雾节 | 仅当 T2 裁到迷雾灰显档参数时 | 反哺点 · 条件列清单 |
|
||||
| [07-体验验证清单](../design/gdd/07-体验验证清单.md) | T4 登记实机目检条目（L1/L2/L3 并排看后问卷式回报） | 反哺点 · 列清单待裁（目检项另进 reports/ 实现报告目检总清单） |
|
||||
| [roadmap](../roadmap.md) | 迭代 30 行已编入（2026-10-16 用户令，行已在案）；余留义务=估时刷新（T5） | 反哺点 · 列清单待裁 |
|
||||
| `active.md` 状态记录 | 本批条目进度刷新 | **本批更新（唯一例外 · 会话状态源）** |
|
||||
| `tools/recolor_terrain_tiles.py` / `game/tests/golden/` | 甲案色表修订 = 脚本内定值换代；golden 基线三张重制 | 工程面 · 随修法落地（可写） |
|
||||
| [playnote](../playnote.md) | 历史试玩记录不回改（沿革留档），本卡即其正式承接 | 无义务 |
|
||||
|
||||
---
|
||||
|
||||
## 6. 任务卡
|
||||
|
||||
> 估时按工作日口径；每卡出口自跑轻闸；批末重闸 = `tools/run_all_gates.sh` 按改动域选档（本批 → `--code`）全绿才合入（脚本即唯一闸清单，卡内不另列名单）。
|
||||
|
||||
### T1 定性步骤（人闸前置；含 T1b 新建采样件合计 ≈2–2.5d，**必先做，产出物 = 定性报告 + 对比样张**）
|
||||
|
||||
逐关（L1 参照位·注意含 10×10 与 12×12 两板型〔F1〕 / L2 / L3）三测面采样。**采样源按测面分治（v1.1 修正）**：
|
||||
- 测面一（棋盘瓦片区）与测面三（迷雾遮罩部分）= `board_shot_probe` 实机渲染帧（确定性可复现，C6；过程帧 render_gate 即弃——本批帧自行留档于库外目录，读数表进 `reports/iter30-实现报告-<完成日>.md`）；**禁拿素材文件代替渲染帧**（迷雾遮罩/揭示态只在渲染帧里存在）；
|
||||
- 测面二（舞台底与屏根）= **现有探针拿不到**（board_shot_probe 帧内无舞台底/屏根像素；shot_probe 战斗屏只到 L1 首战）⇒ 由 **T1b 新建采样件**补齐，见下；退而求其次可用 UiKit 常量×帧内实测值合成 WCAG 对（可算，但板缘对比带需几何语境，合成判据只能佐证不能实证）；
|
||||
- 测面三中的类型微光贡献 = 读数源仅样张 v2 静态定稿图（引擎未实装，F10），T1 报告如实标注该测面的证据级别。
|
||||
|
||||
输出读数表：
|
||||
|
||||
| 测面 | 指标（全部数值化，禁裸形容词） |
|
||||
|---|---|
|
||||
| 棋盘瓦片区 | 整板明度直方图 p10/p50/p90；A6 同口径**明度梯度均值**（相邻格/相邻像素亮度差——高频能量）；唯一色数与色域跨度 |
|
||||
| 舞台底与屏根 | `STAGE_BG`/`BG_ROOT` 对棋盘墙顶、米白装饰族的两两 **WCAG 对比对**；三档带序（shot_checker C 断言口径的层带思想，按帧实测复算——其现行取样面是 L1 战斗屏，不直接复用）实测值——**取样依赖 T1b 全框帧** |
|
||||
| 叠加层 | 迷雾**全黑档面积占比**（区外未开格 = 不透明纯黑）与记忆档灰显值；色牌占板面像素占比；微光带宽与泛光 α 的观感贡献（**证据级别=样张 v2 静态图，引擎未实装——F10**；若徽章批同迭代先行实装则可升级为帧内实测，见 §4B） |
|
||||
|
||||
**T1b 新建采样件（批内任务，≈0.5–1d；v1.1 补——v1.0 默认现成件够用，实查不成立）**：给测面二供帧、并承载 **L2/L3 分关读数**（直方图/A6 同口径梯度按关出值——样张 v3 断言现只跑主板，C1 核注）。落点取一（白名单 1 域内）：① 扩 `board_shot_probe` 加全框模式（BoardView 挂进 battle_stage_view/屏根底之上出 L2/L3 全框帧，与既有三张 golden 取样帧互不污染）；② 新建 L2/L3 战斗整屏取证探针（shot_probe 真实路径口径只达 L1 首战，扩关需确定性到达方案）。出口判据：帧面含棋盘+舞台底+屏根三层且逐跑可复现。
|
||||
|
||||
**归因判据（写死在报告模板里）**：
|
||||
- 素材轴信号 = L2/L3 板区读数与 L1 参照位在 明度带（对照 §4.1 档）/ 梯度均值 / 色域 上的偏离为主因（例：crater `P_DEEP (5,5,9)` 近纯黑叠加迷雾纯黑 ⇒ 大面积死黑；亮部墙顶跨度过大 ⇒ 闪烁感；「纹理太碎」假说在案最强证据 = 2026-10-14 美术审计结论条「第二 / 三关地面是近黑斑加亮筋的双峰纹理——数字无论亮墨还是垫牌，盯久了都会累。这不是再叠一层界面能救的」〔`reports/美术审计-cursor会话存档-2026-10-14.md` 结论区〕）；
|
||||
- UI 轴信号 = 舞台底/叠加层贡献为主因（例：全黑面积占比 × 边缘对比产生的频闪感；`STAGE_BG` 对板缘对比带过宽）；
|
||||
- 两轴共因 = 两类偏离同时显著（报告须给出各自量级占比，修法按主次分配工作量）。
|
||||
|
||||
出口 = 定性报告 + **改前基准样张**提交用户，过 **T1 出口定性人闸**——06 已裁硬步骤（P1：「开工前先过『素材轴 / UI 轴』定性人闸」），闸上同时冻结轴归因结论与 §7 V2 定向目标带数值；v1.0 曾误把该闸本身列为待裁点 Q1，v1.1 撤销（禁再问已裁项）。
|
||||
|
||||
**T1 出口素材轴甲/乙裁决呈报点（v1.2 新增硬流程步骤——Q2 延裁所挂裁点的具名呈报动作，裁决留痕见 §10）**：
|
||||
- **触发条件**：T1 归因结论产出即触发，随定性报告一并呈报（无论归因指向哪条轴，呈报不可省略）；
|
||||
- **动作**：开工默认先做**甲案（recolor 换色）候选样张**——按甲案试算槽值出改前/改后并排样张，用 T1b 分关读数证伪「纹理太碎」假说（甲样张读数达标而用户方向仍否决 = 指向乙）；
|
||||
- **产物与落点**：改前/改后并排样张 + 分关读数表（含甲案试算槽值清单）随定性报告呈报用户。**v1.4 预授权（2026-10-17 用户裁）**：甲案样张读数达标即按 §10 Q2 判据**自动走甲**、不停机等现场裁；仅当读数证伪「纹理太碎」假说时才呈报裁乙（呈报内容照旧：改前/改后并排样张＋分关读数表）。结论按 §10 格式补记留痕后即成 T2 执行依据——裁点由该具名动作承载，全卡不留悬空待裁点。
|
||||
|
||||
### T2 修法（按轴分支；≈1.5–2.5d，落码前须过契约 4 对比样张人闸）
|
||||
|
||||
**素材轴——甲/乙裁点已由 2026-10-16 用户令定为「延至 T1 定性读数出具后再裁；开工默认先做甲案候选样张以证伪纹理说」（裁决留痕 §10；呈报硬流程步骤见 §6 T1 末）**：
|
||||
|
||||
| 案 | 产出物**相对现状新增什么** | 效果上限 | 成本与风险 |
|
||||
|---|---|---|---|
|
||||
| **甲 · recolor 程序换色重校** | 新色表（`PALETTES` 两族槽值修订：抬地面明度地板、压 crater 近黑与墙顶亮端跨度、家族间 Δ 重排）+ 改前/改后并排样张 + 基线换代。输入面（v1.1 实查）：脚本只重映射 wall/facade/floor/crater 四族颜色的 `terrain_*_dungeon.png`→underdark/deep_underdark 两套，**L2/L3 板面瓦片 2×21 件全在其输入面内**；不在输入面的板面相关件=`flag_seal.png`（三关共用，若归因触它另行呈报） | 确定性、可复现、逐项可机检比对；**明度水平与色相可调，纹理高频结构逐像素保持**——若 T1 归因指向「亮度秩序/对比带」，本案直达；若指向「纹理本身太碎/太 busy」，本案调不动（方法学上限——脚本头注定死「亮度秩序逐像素保持」，高频结构不改；在案佐证=2026-10-14 美术审计「双峰纹理…不是再叠一层界面能救的」） | 低；零新素材；不破 §4.3 三关方向需在修订登记中说明偏转幅度 |
|
||||
| **乙 · 瓦片重产（远程生图管线）** | 按新规格重出 L2/L3 瓦片（[remote-gen-prompts](../design/art/remote-gen-prompts.md) 对话操作单 + [art-prompts](../design/art/art-prompts.md) 词库），纹理本体可重设计 | 上限高——高频细节/材质/装饰密度均可换；代价 = 非确定性、过闸周期长、需重锁色板与重跑 `terrain_tile_sets_test`+样张全套 | 高；与 08「五 · 表现」**待裁**行「素材升档重产」及 06「资产升档重产批」条（按名指路，08 未决项表行号以实查为准）方向相邻不同面——该批=立绘/小人帧尺寸升档（2026-10-04 用户令暂不做、重启=用户点名），本卡=棋盘瓦片色板/纹理方案重做，**裁本案不等于放开升档**，呈报须带划界；样张批 Q1 已裁丙案（样张反提素材规格，2026-10-16 用户令）——本案规格以其已冻结目标规格清单为上游，次序=样张规格先行（§4B X2） |
|
||||
|
||||
**T2 修法约束（v1.2 新增，承载 §4B X1/X2 已裁事实）**：①本卡改格底明度档与徽章批叠微光同基线（art-bible §4.1 格底档 L 0.08–0.14）——落码后两卡逐位比对 golden 棋盘三张防互踩；②串行序位徽章→样张→观感（排期栏），本卡落码在两批落码之后，基线换代走契约 6 显式流程；③若 T1 出口裁乙，瓦片规格与样张卡已冻结目标规格清单对齐，次序=样张规格先行（§4B X2）；裁甲则对样张批零连带。
|
||||
|
||||
**UI 轴——参数重校（现读常量与候选方向，全部走样张人闸后定值）**：
|
||||
- 迷雾全黑档：现值 = 不透明纯黑盖全部叠层（HUD框架/art-bible §6.5 三档信息阶梯的既有裁决，改它 = 改概念定义，须回 HUD框架 修订）；候选方向 = 保持三档结构下调不透明度或对纯黑加主题 tint——**列为 T2 内二级裁点，报告须呈报不动定义的纯参数位有哪些先穷尽**；
|
||||
- 舞台底：`STAGE_BG #3E342A` 对板缘对比带宽——候选 = 向 `BG_BRIGHT #453723` 方向提一档或收窄棋盘外缘留白；
|
||||
- 色牌/微光占用：色牌垫底是 v3.4 定案（改板纹理高频结构才谈撤牌）；**类型微光引擎未实装（F10），本卡对该层无可动参数——读数若显示微光规格（α170/带宽 cell÷8）贡献显著，处置=与未开格徽章批联裁实施参数或走 art-bible §4.2 修订登记，呈报为 L3 停机点（触既定裁决面），不在本卡单方改动**。
|
||||
|
||||
### T3 L2/L3 同批与否（≈0.25d 结论笔）
|
||||
|
||||
事实：两关色板两套槽值、板型 12×12 vs 13×13、数字墨同模式（§2.3）。两案成本对照（v1.1 中立化留档；v1.2 已裁，见下）：**同批** = 一次基线换代、一轮目检登记，色表两套槽值各改各的、互不连带；**分两批** = golden 链换代两次、目检登记两轮，单批体量更小、L3 可在 L2 复判后单独叫停。**Q3 已裁（2026-10-16 用户令，§10）：甲·同批**——理由=基线换代与目检各只走一轮；两关槽值差异由 T1 分关读数（T1b）承载，不需以拆批消化。
|
||||
|
||||
### T4 验收三件套与换代（≈1–1.5d）
|
||||
|
||||
1. 机检读数达标：见 §7 V2 判据表；
|
||||
2. **渲染闸基线换代**：跑 `tools/golden_baseline_refresh.sh`（缺省模式=棋盘三张；触及菜单态加 `--menu`）显式重制基线，呈报换代面与新旧读数差、提交说明写明触发原因（契约 6 实操步骤）；
|
||||
3. 用户实机目检轮：目检项（玩法：L1/L2/L3 各开一局，并排回报「费劲感」相对改善）登记进 `reports/iter30-实现报告-<完成日>.md` 实机目检总清单——登记即完成本批义务、不阻塞入库（2026-10-12 用户令；「入册 07」列反哺点）；用户复判否决走 V4 回补。方向级否决（样张层）已在契约 4 前置拦截，本步只剩终验。
|
||||
|
||||
### T5 产出物落位卡（≈0.5d，末卡——三份 reports/ 文件写齐才算收口）
|
||||
|
||||
轻闸全绿后、合并前，把本批三份 `reports/` 产出物写齐（权威文档与根规则文件零直改；`active.md` 状态记录照常更新）：
|
||||
|
||||
1. `reports/iter30-实现报告-<完成日>.md`——各卡状态＋**实机目检总清单**（T4-3 目检条目）＋遗留读数义务＋T1 定性报告读数表归档指引＋变异验证记录表（新建断言/读数件的注入实验记录）；
|
||||
2. `reports/iter30-代拍板追认单-<完成日>.md`——§9 白名单内代拍板逐项留痕（含 Q2 甲/乙现场裁决的留痕补记）；
|
||||
3. `reports/iter30-反哺点-<完成日>.md`——§5 同步面每条一落点（哪个文件哪一节、改成什么、依据）：06 本条状态行、08「五 · 表现」棋盘观感行（含 07 目检登记注与 V4 回补条款）、art-bible §4.1/§4.3 或 §6.5/§7 修订登记条（色值/常量若动）、HUD框架迷雾节（迷雾参数若动）、07 入册条、roadmap 估时刷新。
|
||||
|
||||
**原 §5 机械面直改义务零执行（v3 口径），落文归文档批。**
|
||||
|
||||
**估时合计 ≈ 5–7d**（v1.1 上调：T1 新增 T1b 采样件 0.5–1d；v1.0 为 4–6d——彼时漏了采样件，批内各卡加总实为 4.25–6.25d）；**v1.2 估时不动**：Q2 延裁的甲案候选样张与契约 4/T2 样张同源产出，仅时点前移至 T1 出口呈报点，批内不新增总量；T1b 职责不变（全框帧+分关读数与甲/乙裁决无涉），不因本批裁决再调；天然切分点：**T1 末**（定性报告+甲/乙裁决呈报即交付物，人闸天然停点）、**T2+T3 末**（修法落地）。
|
||||
|
||||
---
|
||||
|
||||
## 7. 验证闸（逐需求点验收清单）
|
||||
|
||||
| # | 需求点 | 测什么 | 判据 |
|
||||
|---|---|---|---|
|
||||
| V1 | T1 定性报告 | 读数表覆盖 3 关 × 3 测面 × 各指标（§6 T1 表全列，测面二经 T1b 全框帧）；L1 参照位在场（含两板型，F1）；归因结论引用数值；**v1.2 增**：甲/乙裁决呈报件（甲案候选样张+分关读数表）随报告同出、用户当场裁决记录在案（§6 T1 呈报硬步骤） | 报告模板齐件 + 用户过闸记录在案（**T1 出口定性人闸=06 已裁硬步骤，P1**；**v1.4 预授权：人闸只确认轴归因与修法方向，V2 定向目标带数值由批内按 T1 实测读数自定并随定性报告呈报，禁拍脑袋现编**）+ 裁决留痕补记 §10 |
|
||||
| V2 | 修法后机检达标 | **既有口径不破坏**：样张主板断言 A6 ≥4.70 / F6 Δ≥18 / A3b Δ≥30 / 格底明度档（已开 L 0.08–0.14 / 墙顶 ≥0.30 / 饱和 ≤0.55）保持绿（v1.1 注：该组现行只跑 dungeon 拼板主板，对 L2/L3 属「不动即可」约束而非覆盖，C1 核注）；**L2/L3 分关实测 = T1b 新建读数件出值**；shot_checker A–D+F 零新增红；`terrain_tile_sets_test`/`ui_contrast_probe` 全绿。**定向判据**（针对「累眼」的归因侧）：若 T1 判「死黑面积」→ 全黑档面积占比与明度直方图 p10 改善入目标带；若判「对比带过宽」→ 墙顶/地面 Δ 与板/舞台底对值入 T1 定标带——目标带数值由 T1 报告给出、**T1 出口定性人闸冻结**，禁拍脑袋现编。**目标带自设的合法性注（v1.1）**：art-bible §4.1「待定现用」态只管圣经在册数值（现行即执法、调整=修订登记，:207 释义）；本卡自设目标带**首先只是批次验收判据**，过闸即合法生效于本批；若某带值要长期执法，须写入 art-bible 相应节修订登记转「待定现用」态，禁以批次判据身份直接成为执法值 | 读数表（改前/改后并排）进 `reports/iter30-实现报告-<完成日>.md`；**v1.4 预授权：目标带数值由批内按 T1 实测读数自定、随定性报告呈报即生效**（原「人闸冻结目标带」改为「人闸确认方向与量级」，数值仍禁拍脑袋现编） |
|
||||
| V3 | 渲染闸换代 | 先跑 `render_gate.sh` 见棋盘 golden 段红（确认破的是预期面）→ 跑 `golden_baseline_refresh.sh`（缺省=棋盘三张，菜单态触及加 `--menu`；素材齐盘前置）→ 复跑 `render_gate.sh` 全绿；三张新旧基线并排呈报，changed 面 = 预期面，零超预期漂移 | 闸日志 + 呈报件；提交说明含触发原因（契约 6） |
|
||||
| V4 | 用户实机目检 | 目检项登记（实现报告目检总清单；「入册 07」列反哺点）+ 用户回报「费劲感」相对改善且 L1 无退化——**登记不阻塞入库（2026-10-12 用户令）**；用户复判否决 = 回补机制触发：08 行回待做、06 本条记残留重开（落文按 v3 口径经反哺点归文档批）、返工起点=T1/T2 重议（不回滚已入库码面，按新条处置） | 主观判据的唯一权威=用户回报；入库前方向由契约 4 样张闸把关 |
|
||||
| V5 | 邻接零回归 | 冒烟全套 + 单元 + 探针链零新增红（呈现面触碰加跑 ui_contrast）；同迭代徽章批断言面零回归（§4B X3） | 重闸 = `tools/run_all_gates.sh --code`（脚本即唯一闸清单） |
|
||||
| V6 | 反哺点清单 | §5 所列各条（08 行改写要求＋目检登记注、06 状态刷新、art-bible 修订登记〔色值若动〕、HUD框架〔迷雾参数若动〕、07 入册、roadmap 估时）在 `reports/iter30-反哺点-<完成日>.md` 逐条有落点（文件/节/改成什么/依据） | 件核：§5 反哺点行数=清单条数 |
|
||||
|
||||
**闸口径**：机检（V2/V3/V5）自动判；V1 = 人闸停点（T1 出口定性闸，06 已裁）；V4 = 登记后回补机制（非停点，2026-10-12 用户令）；契约 5——机检绿 ≠ 用户满意，禁作等价表述写入 06/08。
|
||||
|
||||
---
|
||||
|
||||
## 8. 异常分级
|
||||
|
||||
- **L1（自救）**：采样脚本参数笔误、读数表排版缺件、文档行号漂移——立红即修。
|
||||
- **L2（记录继续）**：色表具体槽值、候选样张的构图取舍、07 目检条目的问法措辞——批内消化并登记。
|
||||
- **L3（停机呈报）**：①T1 读数显示 L1 同病（范围外溢，重划批次）；②归因指向三态墨管线/迷雾概念定义本体（触既有裁决面）；③用户否决对比样张方向两次以上（说明读数口径与体感脱节，须重议 T1 指标本身）；④golden 重制后 changed 面超出预期（隐性回归）；⑤色板增量纪律双门过不了且无合并方案；⑥跨卡同板面次序破裂——与徽章批/样张批的 §4B 联动被裁决成互相破坏已冻结断言面的顺序（§4B 呈报件被否即停，禁单方推进）。
|
||||
|
||||
---
|
||||
|
||||
## 9. 代拍板白名单（超清单必呈报）
|
||||
|
||||
1. 采样读数脚本的实现落点（新工具件 vs 扩 `shot_checker.py`，禁动其现有 A–D+F 断言语义）。**v1.1 注**：T1b 全框帧件（扩 board_shot_probe 或新建 L2/L3 整屏探针）即落在本条授权域内。
|
||||
2. 明度直方图/梯度均值在「整板」与「灯光区内」两口径的取舍（以 T1 报告说明为准）。
|
||||
3. 甲案色表的具体槽值设计（参数域内自由，出域即 L3）。
|
||||
4. 对比样张的排版形式（并排同屏 vs 逐关两帧）。
|
||||
5. 目检轮的注册话术与回报表格式（07 口径内）。
|
||||
6. 基线重制的执行时机（T2 出口 vs T4 出口，取一）。
|
||||
7. 提交切分与 worktree 分支命名（走既有纪律）。
|
||||
|
||||
---
|
||||
|
||||
## 10. 裁决留痕（v1.2 换代：原 Q1 撤销结论保留——已裁项禁再问；Q3 已裁甲·同批；Q2 延裁留痕；全卡零悬空待裁点）
|
||||
|
||||
**统一来源（逐条留痕均引此令）**：「2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕）」。以下 Q2/Q3 各行引该令留痕；两案选项原文照录，供后续复看。
|
||||
|
||||
**已裁移除项（原 Q1「定性报告要不要用户过目才进 T2」）——撤销结论不动（2026-10-16 用户令未触及，维持 grilling 结论）**：06 本条条内已明文裁决——「开工前须先定性（沿用既有裁决）……**开工前先过『素材轴 / UI 轴』定性人闸**」（06:449/:453，2026-10-13 用户裁定条；08 的 git 提交史同款注「P2 棋盘观感标『Alpha 阶段需完成 · 开工前过素材轴/UI 轴定性人闸』」）。「要不要过闸」不成立为问句，本卡处置 = 落为 T1 出口**流程硬步骤**（P1/V1），闸上同时冻结轴归因与 V2 目标带数值——**既裁人闸，不占裁点**。
|
||||
|
||||
### Q2 · 素材轴修法走哪案：程序换色重校（甲）还是瓦片重产（乙）？——**延裁留痕**
|
||||
|
||||
- **裁决（2026-10-16 用户令，来源句见本节顶）**：「待 T1 定性读数出来后再裁甲/乙；开工默认先做甲案（recolor 换色）候选样张以证伪纹理说」。
|
||||
- **v1.4 预授权（2026-10-17 用户裁）：延裁改判据自动裁，不再停机等现场裁**——甲案候选样张读数达标（进入 §7 V2 定向目标带）→ **直接走甲**；仅当读数**证伪**「纹理太碎」假说（甲样张读数不达标、方向仍不成立）时才呈报裁乙。乙案分支的代价与划界（P4/§6 乙案行：本卡重产 ≠ 放开升档、规格与样张卡已冻结目标规格清单对齐）全部不变。
|
||||
- **延裁≠回避**：裁点挂到 T1 出口的**具名呈报动作**——硬流程步骤（触发条件/动作/产物）已成文于 §6 T1「素材轴甲/乙裁决呈报点」：产物=改前/改后并排样张+分关读数表，呈报后**用户当场裁**。本节不留悬空 Q。
|
||||
- **判据（原文照录）**：判据 = T1 归因指向：亮度秩序/对比带问题 → 甲可直达；纹理本身太碎太 busy → 甲调不动（recolor 头注定死「亮度秩序逐像素保持」，方法学上限；碎纹理假说在案证据 = 2026-10-14 美术审计双峰纹理结论条），须乙。乙与 08/06「素材升档重产」的关系已划界（P4/§6 乙案行）：本卡重产 ≠ 放开升档，裁乙不重开该未决项。
|
||||
- **选项原文（保留）**：甲＝recolor 换色重校（确定性、可复现、逐项可机检比对、零新素材；效果上限 = 参数域内明度/色相重排）；乙＝远程生图重产（可重设计纹理与高频细节，上限高；周期长、非确定性、全套闸重跑；若裁，规格与样张卡已冻结目标规格清单对齐、样张规格先行——§4B X2）。
|
||||
- **换向处置**：呈报点甲样张被当场否决→裁乙，属裁决规则本身（即「证伪纹理说」动作的出口分岔），不计入 §8 L3③「否决两次以上重议 T1 指标」计数；裁乙即为批次正式进入 T2 乙案行执行。
|
||||
|
||||
### Q3 · L2 与 L3 同批修还是分两批？——**已裁·甲（同批）**
|
||||
|
||||
- **裁决（2026-10-16 用户令，来源句见本节顶）**：**甲·同批**。理由 = 基线换代与目检登记各只走一轮；两关槽值差异（两套色板槽值、12×12 vs 13×13）由 T1 分关读数（§2.3 分关设点 / T1b）承载，无需拆批消化。
|
||||
- **事实（原文保留）**：两关色板两套槽值、板型 12×12 vs 13×13、数字墨同属双峰板色牌态；06 以单条覆盖两关。
|
||||
- **选项原文（保留）**：甲＝同批（一次基线换代、一轮目检登记，色表各改各的）；乙＝分两批先 L2 后 L3（单批更小、L3 可在 L2 复判后单独叫停；基线换代两次、目检登记两轮）。
|
||||
|
||||
**开工门（v1.2 定实）**：Q3 已裁甲·同批；Q2 裁点由 T1 出口呈报硬流程步骤承载（§6 T1）——开工门 = U0，用户 `/iter` 发令即开（已编入迭代 30，2026-10-16 用户令，排期栏）；原「Q2/Q3 裁决落」前置表述不再成立。本卡全卡无悬空待裁点（§10 之外各处 Q 指涉均已改为裁决留痕/流程步骤引用）。
|
||||
|
||||
**U1 预授权（2026-10-17 用户于开工前一次性决断，防开发中反复打断）**：
|
||||
1. **Q2 判据自动裁**——甲案候选样张读数达标即走甲，不停机等现场裁；仅读数证伪「纹理太碎」才呈报裁乙（§10 Q2、§6 T1 出口呈报点）。
|
||||
2. **V2 定向目标带授权批内自定**——按 T1 实测读数定并随定性报告呈报；T1 出口定性人闸（06 已裁硬步骤，不可跳过）只确认轴归因与修法方向。
|
||||
3. 其余 L3 停机点维持不变：触既有裁决面类（L1 同病外溢／迷雾概念定义本体／方向被否决两次以上／golden changed 超预期／色板双门／跨卡次序破裂）一律停机呈报。三卡串行序位不变（徽章→样张→观感），本卡位第 3。
|
||||
|
||||
---
|
||||
|
||||
## 11. grilling 审查记录（v1.0→v1.1，2026-10-16 对抗性审查；逐攻击面：结论/证据/处置）
|
||||
|
||||
| # | 攻击面 | 结论 | 证据（2026-10-16 实查） | v1.1 处置 |
|
||||
|---|---|---|---|---|
|
||||
| 1 | 工具实存性 | `board_shot_probe` **实存非臆名**（三关 targets 名/行号 :34 全对，且自带确定性驱动可复现）；render_gate/golden_compare/shot_checker 能力与 C5 描述相符。**翻案**：board_shot_probe 帧 = 空视口裸挂 BoardView，**不含舞台底/屏根像素**（探针只实例化 BoardView，battle_stage_view/BG_ROOT 未挂载）；shot_probe 战斗屏真实路径只达 **L1 首战**（其头注商店房不纳屏段自证）⇒ T1「舞台底与屏根」测面与「L2/L3 分关实测」均**无现成采样件**，v1.0「采样源=board_shot_probe 渲染帧」对该测面不成立 | `game/smoke/board_shot_probe.gd:34, :55-61`；`game/smoke/shot_probe.gd:12-14, :159-164`；`tools/render_gate.sh:9, :55-68, :95-107` | 新增 **T1b 新建采样件任务**（≈0.5–1d，白名单 1 域内）；T1 估时上调、合计 4–6d→**5–7d**；C6 加帧面边界注 + 过程帧即弃纪律注 |
|
||||
| 2 | 量化判据出处 | A6 ≥4.70（`:26/:338/:1021-1022`，v1 4.09×1.15）、F6 Δ≥18（`:339/:996`）、格底档 L 0.08–0.14/墙顶 ≥0.30/饱和 ≤0.55（art-bible :194/:205/:225-227）、48 色+三通道差 ≥8/255（art-bible :207）**全部实值相符**。**翻案两件**：①A3 现行执法 = **v3.5 冻结定值 Δ≥30**（实测 38），Δ≥55 已数学冲突退役（`:975-979`），v1.0 C3「开工时以当期为准复核」含糊化——已写死；②样张 v3 断言（A3/A6/F6）只跑 **dungeon 拼板主板**（`:130-131`），S3 underdark 仅为 HSV 示意不参断言——「分关实测」非现成能力。自设目标带合法性：「待定现用」态释义（:207）只覆盖**圣经在册数值**的执法态，不自动覆盖批次自设判据——二者不冲突但须写明边界 | 如上各行号 | C1–C3 加核注重写；V2 增「批次判据身份≠执法值，转执法须 art-bible 修订登记」条款；T1b 承载分关读数 |
|
||||
| 3 | 「重产≠放开升档」划界 | 划界**成立但引据须换代**：08 未决项表 2026-10-16 v1.6 已重编号（八项减七项）——行号指路不可靠，按名「素材升档重产进不进 Alpha」「立绘清晰度回退评估」现行确在第 6/7 行（实查）；06「资产升档重产批」现行状态 = 2026-10-04 令暂不做 + 2026-10-06 优先级再降 + **2026-10-06 方案二注记：原 64/96/128 升档路线已被八敌逐键定档实质走完，剩余挂起=提灯点亮解禁候选**——v1.0 P4「该条方向=帧尺寸升档」表述滞后 | 08:154, :209-210, v1.6 行（:226）；06 升档批条状态行全文 | P4 重写（按名指路+行号注明以实查为准+方案二注记现状）；T2 乙案行同改 |
|
||||
| 4 | recolor 能力边界 | 头注方法=仅对 `terrain_*_dungeon.png` 按 wall/facade/floor/crater 四族槽重映射、输出 underdark/deep_underdark 两套；实盘 board/ 目录两套各 21 件（**墙 16+地 5**）与脚本输入面完全对齐，`flag_seal.png` 不在输入面。v1.0 F2「墙类 21 件」**件数错**（21 为总数，16 唯一墙名单单点 `TILE_WALL_NAMES`）。「纹理太碎调不动」有实证：recolor 头注定死亮度秩序逐像素保持（方法学上限）+ 2026-10-14 美术审计结论区「第二/三关地面=近黑斑加亮筋双峰纹理，盯久了累，不是再叠一层界面能救的」（该审计 md 在盘；同日另存 2026-10-06 旧审计 HTML，其棋盘相关结论未涉 L2L3 瓦片碎度） | `tools/recolor_terrain_tiles.py:1-12`；`game/presentation/views/board_view.gd:81-88`（16 件名数组+头注「16 唯一墙瓦片名单」）；`reports/美术审计-cursor会话存档-2026-10-14.md` 结论区；Glob `game/assets/art/board/` 两套件名清点 | F2 订正件数+flag_seal 例外注；甲案行写明输入面全覆盖；T1 归因判据与 Q2 引审计实证 |
|
||||
| 5 | 文字位条分工句 | 06:451 原文在册：「两条不同面，不互相替代，各自保留」；三处文字位=站桩名行/敌顺位徽标/RAP 反馈行，06:443 已随迭代 26 T3 完成——v1.0 P2 语义与原文一致 | 06:451, :437-443 | P2 补原文引述 |
|
||||
| 6 | V 条判具 | V2=样张 v3（主板）+T1b 分关读数+shot_checker A–D**+F**（v1.0 漏 F 判据，2026-10-15 已入闸）+`terrain_tile_sets_test`/`ui_contrast_probe`（两探针实存）；V3=`golden_baseline_refresh.sh` **实存**且用法查明：缺省模式=棋盘三张（probe 抓帧→crop→覆盖 `game/tests/golden/`），`--menu`=菜单全屏，素材缺位拒跑，呈现批 agent 自换代+提交说明强制写触发原因（其头注 Q5/Q6/S3 在册） | `tools/golden_baseline_refresh.sh:2-14, :52-76`；`tools/shot_checker.py:8-19` | C5/契约 6/T4/V2/V3 补齐实操步骤与 F 断言 |
|
||||
| 7 | Q1/Q3 已裁检索 | **Q1 属已裁项**：06:449 条内明文「开工前须先定性（沿用既有裁决）」+ 状态行「开工前先过定性人闸」（2026-10-13 用户裁定）+ 08 的 git 提交史同款注——v1.0 一边在 P1 引该裁决、一边把同一闸列为 Q1 待裁，自相矛盾，触用户红线。Q3（同批与否）与 Q2（甲/乙）全库检索**无既裁**（06 单条覆盖两关但未裁批次数；playnote 无；git log 无）——保留为待裁 | 06:445-453；08:220（v0.3）；playnote.md:5；git log 2026-10 检索 | Q1 从 §10 删除、改 P1/T1 出口/V1 流程硬步骤引用（§10 载明移除理由）；Q2/Q3 保留 |
|
||||
| 8 | 中立性 | v1.0 四处「推荐」：Q1（已裁项附裁决，撤销后消失）、T1 出口句（撤销）、T3「推荐=同批」与 §10 Q3「推荐 甲」（**无既裁依据→中立化**）、Q2 立场句「开工默认先做甲案候选样张」（改写为白名单内样张层探针动作，非路线裁决） | 全文 grep 推荐=0 残留（仅剩「已删字样」自述与列名注） | 列头改「卡片立场（不代裁）」；§10/§6 T3 中立化 |
|
||||
| 9 | 跨卡依赖 | 两卡同抢 L2/L3 板面：徽章批（类型微光实装者，其 T0-② 五组明度档以未开格底 L≥0.30 为基线——本卡改的正是该基线；art-bible :379 已册「格底与微光同在未开格面，邻近色相有吞没风险」互辨复测义务；其 §4「不动格底/瓦片/四槽」系单向避撞）；样张批（Q1 丙案语义=样张反提素材规格、Q3 路线选型——本卡乙案重产与其冻结次序互锁） | `徽章卡（迭代 30 卡①，合并 7ffd1dc0，卡片已退役）:13/82/109`；`需求卡片-战斗一屏样张批:33/59/70-71/168/170`；art-bible:379 | 新增 **§4B 跨卡依赖**（X1/X2/X3 三行+结论笔：次序与规格联动问题，不新增裁点，随 Q2/Q3 呈报交用户定序）；§8 L3 增⑥跨卡次序破裂停机型 |
|
||||
| 10 | 外加翻案（非清单内，敌意自查所得） | **契约 5/完成定义 3/V4/T5「目检未过禁宣布完成/在役」与 2026-10-12 用户令红线冲突**：AGENTS.md「真人检测只登记不阻塞——禁以等目检为停工理由」（入库先例：迭代 25/26/28 均入库翻行、07 目检留残，git 提交 d337c9e5 立规）。另：F1「L1 10×10」不全——`board_gen.tres` level_index 1 段含一行 **12×12 dungeon**；F10/C6：类型微光引擎未实装（徽章批 F2 引 HUD框架实装状态行佐证），v1.0 把它当实机可测层不成立 | AGENTS.md:68；git log d337c9e5；roadmap 迭代 25/28 行「残留人闸=目检」先例；`game/data/tables/board_gen.tres` 行段实查 | 契约 5 重写（阻塞闸全前置：T1 定性闸+契约 4；V4 改登记不阻塞+回补机制：否决→08 行回待做+06 记残留重开）；F1 补两板型注；F10/T1 微光测面降为样张 v2 证据级别并注升级路径 |
|
||||
|
||||
**词面合规自查**：v1.1 全部新增/改写文本已按仓库现行用语规范禁词表逐词 grep 复扫，命中 0（他文档引文原貌除外）；本次修订同时把卡片里 v1.0 残留的两处旧措辞换代为规范词。**v1.2 增补**：本次裁决留痕新增/改写文本同口径 grep 复扫，禁词命中 0。**v1.2 留档注**：下表 §11 中「Q2/Q3 保留待裁」「随 Q2/Q3 呈报交用户定序」「无既裁→中立化」均为 v1.1 时点的审查动作实录，不作现行状态读——2026-10-16 用户令已定案（Q3=甲·同批；Q2=延裁挂 T1 出口呈报硬步骤），现行裁决状态一律以 §10 为准。
|
||||
+1
-1
@@ -6,7 +6,7 @@
|
||||
|
||||
- **阶段**：M3——Alpha 版本的完整实现（2026-10-09 立规：未明令宣布完成前停留 M3，迭代只排 M3 需求，M4 不排期；根目录 stage.txt 为旧阶段开关仅存档）。
|
||||
- **迭代位**：迭代 1–54 已完成。各迭代收口与批后收尾沿革查 git 提交信息与 `reports/`。
|
||||
- **下一步**：迭代 55 未编；待编池：QA harness 覆盖遗漏余量 B4/B5（待写卡，P0）、效果通道与事件词零现役普查（待写卡）、结算明细文案入表（待文档设计）、二三关棋盘观感（待设计＋待美术）、测试面真输入化批发现四项待裁（待执行）；EC8 热重载实装待用户另立条目。
|
||||
- **下一步**：迭代 55 未编；待编池：QA harness 覆盖遗漏余量 B4/B5（待写卡，P0）、效果通道与事件词零现役普查（待写卡）、结算明细文案入表（待文档设计）、棋盘瓦片与立体表现重做（待设计＋待美术）、测试面真输入化批发现四项待裁（待执行）；EC8 热重载实装待用户另立条目。
|
||||
|
||||
## 里程碑时间线
|
||||
|
||||
|
||||
@@ -191,14 +191,14 @@
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### 第二 / 三关棋盘观感——亮度与对比度（2026-10-13 登记，来源=playnote）
|
||||
#### 棋盘瓦片与立体表现重做（2026-11-07 登记，来源=会话提及）
|
||||
|
||||
**实况**：来源＝playnote 试玩记录「第二第三关棋盘看着费劲」；用户裁定要做，[08-Alpha版本标准](design/gdd/08-Alpha版本标准.md)「五 · 表现」已立行标待做。旧卡 reports/需求卡片-二三关棋盘观感批-2026-10-16.md（v1.4）在册但非已写卡状态，重启须重新立卡。分工：本条管棋盘区域整体观感（亮度/对比度/费劲感，体感问题），与已注销的「呈现层残余 <4.5:1 文字位」条（机检硬指标）不同面不互代。Alpha 出口＝用户实机目检不再判「看着费劲」。
|
||||
**实况**：用户裁定（2026-11-07 会话）棋盘难看根因＝瓦片素材与立体画法，非亮度/对比度；原「第二 / 三关棋盘观感——亮度与对比度」条误诊退役、旧卡 reports/需求卡片-二三关棋盘观感批-2026-10-16.md 删除。真 3D 与 HD-2D 排除（风格不合）。证据：art-bible §3.2「未挖格＝一整块 32×32 自含凸起岩体」冻结条款锁死立体表现；cell_base_layer.gd 南立面/北投影全在本格内、board_view.gd 无 y-sort；tile_palette.gd digit_plate 落牌＝亮度修补已失败（违 §9.2 满屏白牌反参考）。
|
||||
|
||||
**缺口**：还差「素材轴 / UI 轴」定性设计讨论与甲（recolor 现瓦片）／乙（远程生图重产）素材裁点裁决——定性是既有条款的开工前置；素材轴若走重产，依赖战斗一屏样张批目标规格清单（已随 art-bible v3.22 落定）。
|
||||
- 相关文档：[HUD框架](design/gdd/systems/表现与支撑/HUD框架.md)（UI 轴：舞台底与叠加层）+ [美术圣经](design/art/art-bible.md)（素材轴：瓦片与格面图标的明度色相）——定性前两方共裁
|
||||
**缺口**：还差呈现层立体画法设计讨论四要点——越格绘制规则、绘制序（y-sort/锚点）、素材部件化（墙顶/立面/地面拆件）、验收面换代（金标/探针禁越圈条款）；样张先行、用户目检定风格，方案优先级待目检后裁。
|
||||
- 相关文档：[美术圣经](design/art/art-bible.md) §3.2/§9.1（画法解冻＋参考池）＋ board_view.gd/cell_base_layer.gd（绘制序与越格）＋ game/tests/golden/README.md、board_shot_probe.gd（验收面）
|
||||
|
||||
**改动面**：美术素材＋游戏代码
|
||||
**改动面**：文档＋美术素材＋游戏代码
|
||||
|
||||
**状态**：待文档设计＋待美术设计
|
||||
|
||||
|
||||
Reference in new issue
Block a user