DKChan
f958a03f51
八件受版文件 git mv 进 reports/（一律先迁不删，删除归后续批或用户点名）：提案三件（冒险前资源配比预设／效果引擎无状态化／武器锻造系统）、审计两件（代码术语审计／单测与验收门禁标准测试审计）、美术审计两件（cursor 会话存档 md ＋ canvas 转 HTML 渲染件）、需求澄清-营地交互重做；未入库的 UI预览demo 三路对照件只搬盘不入库。 GDD 落文：锻造工坊.md「满级特效扩展位」节收下七条候选池（长剑破甲／长剑暴击面扩大／长枪先手连击／法杖开局魔法矢／轻甲灵巧／重甲反震／魔法护甲护盾），按现役 EFFECT_KINDS 与 settlement.tres:51/52 逐条复核实现代价分档，效果类型闭集口径取正文现行 31 种、不抄过程稿旧记 24 种；候选池定性为备用清单非承诺清单。 引用面换代 08（playnote 之外两处 ../research/ 改 ../../reports/）、待办清单四处、reports 八张卡片（跨目录前缀改同目录）、art-assets-checklist 与 sim-data/README 两处既存死指改「沿革查 git 提交史」、content-archive 出处句标注该目录已退役。迁入件内部相对链接随迁移重基准（../gdd/ → ../design/gdd/，playnote 与待办清单改回仓库根），并订正上一批遗留错误：两张迭代 30 卡片的 playnote 链接原写 ../../playnote.md（从 reports/ 出发指到仓库外），现改 ../playnote.md。 规则与机检：doc-conventions §11「暂存地非档案库」行改为单暂存地＋禁在 design/ 下设过程件目录＋图像载体与报告渲染件口径分列（禁图留 artwork/ 沿用 2026-09-27 用户裁；.html/.json 允许作为报告的一种＝2026-10-21 用户裁，原「只放 .md」句系 10-17 建目录时顺带照搬、无单独点头记录）；AGENTS Project Layout 两行同步；reports/README 补「设计讨论段过程稿」命名行。repo_structure_audit：DESIGN_SUBDIRS 去 research、RETIRED 加 design/research；doc_ref_audit 排除面清空（design 全树入扫描面）；doc_term/doc_link 扫描域注释换代；三件样张脚本 OUT_REPORT 改落 reports/ 并补 os.makedirs（改前只对 OUT_PNG 建目录，目录缺失即 FileNotFoundError）。 变异验证：重建 design/research 并放文件 → 结构闸退出码 1、同时报「退役路径再现」与「子目录越界」两条；design/ 内放两条指向不存在文件的引用 → 引用可核机检报「路径不存在」红项 2（该闸暂未注册进闸壳，无基线记录必判变化）；清场后结构闸 PASS。
58 KiB
58 KiB
需求卡片：第二 / 三关棋盘观感——亮度与对比度批（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-待办清单「第二 / 三关棋盘观感——亮度与对比度」小节（2026-10-13 用户裁定条）+ playnote 用户试玩原始记录：「UI优化，第二第三关的棋盘看着太累了；不知道是因为亮度还是对比度的原因，看着非常费劲，非常不舒服」
- 归属：表现层美术修批（06 在册条目直接写卡；两轴归属 = HUD框架（UI 轴）+ 美术圣经（素材轴），定性前两方共裁——沿用 06 条裁决）
- 排期：已编入迭代 30（2026-10-16 用户令编入，roadmap 行已在案；批内状态刷新列反哺点）。同迭代三卡串行序位第 3：未开格类型徽章批卡（迭代 30 卡①，已入库合并 7ffd1dc0，卡片已退役）→战斗一屏样张批卡→本卡（徽章→样张→观感）。并行例外：本卡 T1/T1b 采样与定性读数允许与前两卡并行穿插——依据=采样是只读动作（出帧/读数/样张均不触碰 golden 三张、样张主板、§5 同步面文档等汇聚文件），落码修改（T2 起）仍按上述序位串行。开工门 = U0，须用户
/iter发令；且 T1 出口定性人闸未过之前禁止动码——该闸 = 06 本条既有裁决硬步骤（「开工前先过『素材轴 / UI 轴』定性人闸」，2026-10-13 用户裁定；08 git 提交史 v0.3 同款注），不是待裁点（v1.1 撤销原 Q1，见 §10）。 - 立场前提（用户原话，本卡设计的第一约束）：此条立项原因就是用户实机觉得现在的画面累眼、且对「纯程序化重产现状」明确不满——「如果还是用原有方式弄出来的东西，有没有可能还是我不满意的？」。本卡对此的正面回应 = ①第一步定性用可量化的读数归因（明度直方图 / 相邻格对比 / 高频能量 / WCAG 对），禁止凭感觉猜轴；②两条修法各自的产出物写清相对现状新增什么（§6 T2 两案效果上限表）；③诚实的效果声明：观感是主观项，机检只能证伪（读数红 = 必有问题）不能证真（读数绿 ≠ 用户满意），阻塞性人闸全部前置（T1 定性闸 + 契约 4 方向闸），入库后实机目检按 2026-10-12 用户令口径登记不阻塞——目检项登记进
reports/iter30-实现报告-<完成日>.md实机目检总清单（「入册 07」列反哺点；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版本标准「五 · 表现」表「棋盘观感（第二/三关亮度与对比度）」行（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 保持待办）：
- T1 定性报告交付：逐关三测面（棋盘瓦片区 / 舞台底与屏根 / 叠加层）读数表 + 归因结论（轴判定，引用具体数值）；T1 出口定性人闸过（06 已裁硬步骤，P1）；
- T2 修法按裁定轴别落码/落素材，既有样张口径闸全部保持绿（A6 梯度均值 ≥4.70、F6 立面双明度带 Δ≥18、格底明度档 §4.1、图底分离——见 §2.4；注：该组断言现行落点=样张主板（dungeon 拼板，
render_sample_sheet_v3.py:130-131），L2/L3 分关实测属本批新建读数件（T1b），见 §11 攻击面 2）； - 验收三件套走完：机检读数达标 + 渲染闸 golden 基线显式重制并呈报换代面 + 用户实机目检轮登记（目检项登记进
reports/iter30-实现报告-<完成日>.md实机目检总清单，「入册 07」列反哺点；2026-10-12 用户令=登记不阻塞入库，否决走 V4 回补）； - 08「五 · 表现」棋盘观感行 待做→在役 改写列反哺点（含 07 目检登记注；落文归文档批）；
- §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 §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-待办清单 本条 | 状态行改写（定性报告交付/完成注记）；T1 发现的新红点若立新条则同批登记 | 反哺点 · 列清单待裁 |
| 08-Alpha版本标准 「五 · 表现」棋盘观感行 | 待做→在役（完成定义第 4 件；批入库时改写并顺带 07 目检登记注；用户复判否决走 V4 回补——行回待做+06 记残留） | 反哺点 · 完成时列清单 |
| art-bible §4.1/§4.3（素材轴改色表值）或 §6.5/§7（UI 轴改常量方向） | 数值定值单点纪律：改值 = 走该节修订并登记（「待定现用」态），禁只改代码不改文档 | 反哺点 · 列清单待裁（条目写明改值与修订登记要求） |
| HUD框架 视野迷雾节 | 仅当 T2 裁到迷雾灰显档参数时 | 反哺点 · 条件列清单 |
| 07-体验验证清单 | T4 登记实机目检条目（L1/L2/L3 并排看后问卷式回报） | 反哺点 · 列清单待裁（目检项另进 reports/ 实现报告目检总清单） |
| roadmap | 迭代 30 行已编入（2026-10-16 用户令，行已在案）；余留义务=估时刷新（T5） | 反哺点 · 列清单待裁 |
active.md 状态记录 |
本批条目进度刷新 | 本批更新（唯一例外 · 会话状态源） |
tools/recolor_terrain_tiles.py / game/tests/golden/ |
甲案色表修订 = 脚本内定值换代；golden 基线三张重制 | 工程面 · 随修法落地（可写） |
| playnote | 历史试玩记录不回改（沿革留档），本卡即其正式承接 | 无义务 |
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 对话操作单 + art-prompts 词库），纹理本体可重设计 | 上限高——高频细节/材质/装饰密度均可换；代价 = 非确定性、过闸周期长、需重锁色板与重跑 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）
- 机检读数达标：见 §7 V2 判据表；
- 渲染闸基线换代：跑
tools/golden_baseline_refresh.sh（缺省模式=棋盘三张；触及菜单态加--menu）显式重制基线，呈报换代面与新旧读数差、提交说明写明触发原因（契约 6 实操步骤）； - 用户实机目检轮：目检项（玩法：L1/L2/L3 各开一局，并排回报「费劲感」相对改善）登记进
reports/iter30-实现报告-<完成日>.md实机目检总清单——登记即完成本批义务、不阻塞入库（2026-10-12 用户令；「入册 07」列反哺点）；用户复判否决走 V4 回补。方向级否决（样张层）已在契约 4 前置拦截，本步只剩终验。
T5 产出物落位卡（≈0.5d，末卡——三份 reports/ 文件写齐才算收口）
轻闸全绿后、合并前，把本批三份 reports/ 产出物写齐（权威文档与根规则文件零直改；active.md 状态记录照常更新）：
reports/iter30-实现报告-<完成日>.md——各卡状态＋实机目检总清单（T4-3 目检条目）＋遗留读数义务＋T1 定性报告读数表归档指引＋变异验证记录表（新建断言/读数件的注入实验记录）；reports/iter30-代拍板追认单-<完成日>.md——§9 白名单内代拍板逐项留痕（含 Q2 甲/乙现场裁决的留痕补记）；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. 代拍板白名单（超清单必呈报）
- 采样读数脚本的实现落点（新工具件 vs 扩
shot_checker.py，禁动其现有 A–D+F 断言语义）。v1.1 注：T1b 全框帧件（扩 board_shot_probe 或新建 L2/L3 整屏探针）即落在本条授权域内。 - 明度直方图/梯度均值在「整板」与「灯光区内」两口径的取舍（以 T1 报告说明为准）。
- 甲案色表的具体槽值设计（参数域内自由，出域即 L3）。
- 对比样张的排版形式（并排同屏 vs 逐关两帧）。
- 目检轮的注册话术与回报表格式（07 口径内）。
- 基线重制的执行时机（T2 出口 vs T4 出口，取一）。
- 提交切分与 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 用户于开工前一次性决断，防开发中反复打断）：
- Q2 判据自动裁——甲案候选样张读数达标即走甲，不停机等现场裁；仅读数证伪「纹理太碎」才呈报裁乙（§10 Q2、§6 T1 出口呈报点）。
- V2 定向目标带授权批内自定——按 T1 实测读数定并随定性报告呈报；T1 出口定性人闸（06 已裁硬步骤，不可跳过）只确认轴归因与修法方向。
- 其余 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 为准。