merge: 同步 master（60449941 迭代 30 编入批 + 08 状态刷新批）并解决 roadmap 冲突
roadmap 冲突面：本批改了迭代 29 行与「迭代进度／近期主战场」两处，master 同期编入了迭代 30 （UI 呈现三卡批）并把空位行顺延为「迭代 31+」。以 master 为基重新应用本批三处换代： 迭代 29 行（卡片 v1.4→v2.0、门列→实耗、状态→已入库）、迭代进度行、近期主战场行 （下一前沿改指迭代 30，迭代 29 收口遗留注明 11 号闸待批准）。 active.md 与 06 无冲突（自动合并）：状态记录 505 在册，快照三行换代保留。
This commit is contained in:
DKChan committed
commit
3dc168cd3d
14 files changed
+922
-29
No files matched your search
@@ -2,7 +2,7 @@
|
||||
|
||||
一句话：下洞 → 扫雷攒筹码 → 自动战斗兑现 → 变强再下洞；死了，从头再来。
|
||||
|
||||
## 一场战斗：扫雷的因，战斗的果
|
||||
## 一场战斗的流程
|
||||
|
||||
每场战斗都在一张雷图上打。战斗本身不用手操——你能做的全部决策，都在它的"准备期"里：
|
||||
|
||||
|
||||
@@ -40,7 +40,7 @@
|
||||
|
||||
**归属**：美术线（战斗一屏样张的验收标准归 [战斗表现](systems/战斗循环/战斗表现.md) 与 [美术圣经](../art/art-bible.md) §5.1 共裁）
|
||||
|
||||
**状态**：待办（**Alpha 阶段需完成**）——**意义提示**：按圣经条款，占位态禁止跨里程碑，本条只要不做，界面美术就始终处于未定稿状态，上面所有呈现层改动做完也缺少验收依据。
|
||||
**状态**：待办（**Alpha 阶段需完成**）——**意义提示**：按圣经条款，占位态禁止跨里程碑，本条只要不做，界面美术就始终处于未定稿状态，上面所有呈现层改动做完也缺少验收依据。**2026-10-16 用户令编入迭代 30**（UI 呈现三卡批序位②，需求卡片=[战斗一屏样张批](../research/需求卡片-战斗一屏样张批-2026-10-16.md) v1.2 裁点已留痕；开工门=U0 `/iter` 发令）。
|
||||
|
||||
#### UI 氛围层与九宫格切片观感修——光柱硬边与面板切片错位（2026-10-13 登记，UI 美化三层诊断 · 第三层）
|
||||
|
||||
@@ -432,7 +432,7 @@
|
||||
|
||||
**归属**：[地图战斗资源](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）；实施批按组粒度执行。
|
||||
**状态**：待办（**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` 发令）。
|
||||
|
||||
#### 呈现层残余 <4.5:1 文字位（迭代 16 批外邻接发现，2026-10-06 登记）
|
||||
|
||||
@@ -452,7 +452,7 @@
|
||||
|
||||
**归属**：[HUD框架](systems/表现与支撑/HUD框架.md)（UI 轴：舞台底与叠加层）+ [美术圣经](../art/art-bible.md)（素材轴：瓦片与格面图标的明度色相）——定性前两方共裁
|
||||
|
||||
**状态**：待办（**Alpha 阶段需完成**）——开工前先过「素材轴 / UI 轴」定性人闸；未排批
|
||||
**状态**：待办（**Alpha 阶段需完成**）——开工前先过「素材轴 / UI 轴」定性人闸。**2026-10-16 用户令编入迭代 30**（UI 呈现三卡批序位③，需求卡片=[二三关棋盘观感批](../research/需求卡片-二三关棋盘观感批-2026-10-16.md) v1.2；素材轴甲/乙案裁点挂 T1 出口呈报；开工门=U0 `/iter` 发令）。
|
||||
|
||||
#### 棋盘格边长三方取值不一致——待扩板定档处置（2026-10-06 登记）
|
||||
|
||||
@@ -476,11 +476,11 @@
|
||||
|
||||
**两个子问题现状不同，勿混为一谈**：
|
||||
- **子问题一 = 怪物大小比例不合理**：**已兑现**——体量语义改生物体型（character-design §5.2，弃强度线性映射）+ 八敌逐键定档（art-bible §8.2）。剩余面 = 用户是否复核验收。
|
||||
- **子问题二 = 像素粒度过低看不清 / 是否改回高清图**：**未决，且与既定方向冲突**。粒度问题已改派生管线（八敌源档 36–94 全过可读门槛：24 糊 / 32 可读 / 48 清楚），但用户「改回高清图」这句提问与现行**像素风定档**是相反方向。方向未裁：是维持像素风继续优化派生管线，还是真的回退到高清图。
|
||||
- **子问题二 = 像素粒度过低看不清 / 是否改回高清图**：**方向已裁（2026-10-14 用户裁）**——「还是像素风格立绘，但是不需要像现在太过于像素」，定性为**精细手绘像素**（不是插画、不是 HD-2D、不回退高清图），整屏方向稿与地面/立绘密度同批锁（裁决录=[美术审计-cursor会话存档](../art/美术审计-cursor会话存档-2026-10-14.md) §2.2；权威面 art-bible/character-design 口径节反哺另批）。粒度问题已改派生管线（八敌源档 36–94 全过可读门槛：24 糊 / 32 可读 / 48 清楚）。
|
||||
|
||||
**归属**：[角色设计](../art/character-design.md)（立绘规格与体量语义）+ [美术圣经](../art/art-bible.md)（像素管线与档位）
|
||||
|
||||
**状态**：待办（**Alpha 阶段需完成**）——**方向待裁**（维持像素风 vs 回退高清图），已列 [08-Alpha版本标准](08-Alpha版本标准.md)「七 · 未决项」之「立绘清晰度回退评估」行（v1.6 起该表重编号，按名指路不按号）；子问题一（大小比例）待用户复核验收
|
||||
**状态**：待办（**Alpha 阶段需完成**）——**方向已裁（2026-10-14 用户裁：维持像素风、升级精细手绘像素，不回退高清图**，裁决录见上）；[08-Alpha版本标准](08-Alpha版本标准.md) 未决项已随裁删除（2026-10-16 状态刷新批）；余=立绘按新口径重产（美术线，与战斗一屏样张/整屏方向稿同批锁密度）＋子问题一（大小比例）待用户复核验收
|
||||
|
||||
#### 站桩帧动画——Alpha 定版闸前完成（2026-10-06 P0-3 延后登记，用户拍板）
|
||||
|
||||
|
||||
@@ -300,7 +300,7 @@
|
||||
|
||||
| # | 目检项 | 判据 |
|
||||
|---|---|---|
|
||||
| 1 | 启动即见主菜单 | F5 启动后第一屏是主菜单（标题「Dungeon Sweeper」+副标题「扫雷的因」+开始/继续上局/营地/生涯/设置/退出六钮），**不再**是战斗界面/棋盘背景 |
|
||||
| 1 | 启动即见主菜单 | F5 启动后第一屏是主菜单（标题「Dungeon Sweeper」+开始/继续上局/营地/生涯/设置/退出六钮），**不再**是战斗界面/棋盘背景 |
|
||||
| 2 | 菜单按钮可点 | 六钮逐个点：鼠标悬停有反馈、点击有响应（继续上局在无断点时不显示——有断点时显示且文案带关卡号） |
|
||||
| 3 | 菜单与战斗互不遮挡 | 开新冒险后菜单让位、战斗界面完整可见；回菜单后战斗内容不再透出（模态互斥观感与改前一致） |
|
||||
| 4 | 各覆盖层开合层级正确 | 图鉴/关卡地图/奇物/终局/商店/营地/设置/状态/生涯/确认框/调试浮窗逐个开合——浮层都在内容之上，调试浮窗浮于菜单之上且不吃下层点击 |
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
> **一句话定位**：本文定义这个项目的 **Alpha 版本包含哪些东西**——它是里程碑 M3 的完成标准，也是判断"还差什么"的对照表。
|
||||
> **本文只列条目，不写内容**：每样东西是什么、规则怎么走，一律归各自的权威文档，本文只给指路链接。想知道某样东西的定义，请点链接，不要在本文里找解释。
|
||||
> **状态**：**已定稿（v1.6）**——2026-10-13 用户令定稿（v1.0），同日升版 v1.1（界面美化八条）与 v1.2（敌种池行注摘除）；v1.3/v1.4 为迭代 25/26 完成回填；v1.5 简明技术中文用语规范批；v1.6 状态刷新批（锻造工坊在役回填 + 数值统一标定按 2026-10-09 里程碑立规结案归 Beta）。Alpha 的内容范围自此冻结：增删条目一律须经用户裁决，并记入文末版本历史。
|
||||
> **状态**：**已定稿（v1.7）**——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 注记 + 贫矿脉屏蔽注记）。Alpha 的内容范围自此冻结：增删条目一律须经用户裁决，并记入文末版本历史。
|
||||
> **成文**：2026-10-13。
|
||||
|
||||
## 本文怎么用
|
||||
@@ -27,7 +27,7 @@
|
||||
| 棋盘生成 | [棋盘生成](systems/排雷循环/棋盘生成.md) | 在役 |
|
||||
| 排雷玩法 | [排雷玩法](systems/排雷循环/排雷玩法.md) | 在役 |
|
||||
| 行动经济 | [行动经济](systems/排雷循环/行动经济.md) | 在役 |
|
||||
| 地形变异（六类型） | [地形变异](systems/排雷循环/地形变异.md) | 在役 |
|
||||
| 地形变异（六类型） | [地形变异](systems/排雷循环/地形变异.md) | 在役（2026-10-16 贫矿脉整图型屏蔽删行，variation.tres 回 region 六行；机制代码保留，重建设计加行即恢复；设计语义面反哺待裁） |
|
||||
|
||||
### 战斗循环
|
||||
|
||||
@@ -81,7 +81,7 @@
|
||||
| 敌种池（含三个 Boss） | `enemy.tres` | 在役 |
|
||||
| 敌人技能池 | `skills.tres` | 在役 |
|
||||
| 棋盘按关配置尺寸 | `board_gen.tres` | 在役 |
|
||||
| 地形变异六类型 | `variation.tres` | 在役 |
|
||||
| 地形变异六类型 | `variation.tres` | 在役（2026-10-16 贫矿脉屏蔽删行后表为 region 六行） |
|
||||
| 格面资源九型 × 正负 | `reward.tres` | 在役 |
|
||||
| 状态表 | `status_effects.tres` | 在役 |
|
||||
| 奇物池（专长 / 属性值提升 / 资源） | `feats.tres`、`adventure.tres` | 在役 |
|
||||
@@ -142,8 +142,8 @@
|
||||
|---|---|---|
|
||||
| 像素美术风格与色板 | [美术圣经](../art/art-bible.md) | 在役 |
|
||||
| 棋盘瓦片与格面资源图标 | [美术圣经](../art/art-bible.md) | 在役 |
|
||||
| 棋盘观感（第二 / 三关亮度与对比度） | [06-待办清单](06-待办清单.md) | 待做 |
|
||||
| 立绘清晰度回退评估（是否改用高清图） | [角色设计](../art/character-design.md) | 待裁 |
|
||||
| 棋盘观感（第二 / 三关亮度与对比度） | [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) | 在役 |
|
||||
| 主角立绘三态 | [角色设计](../art/character-design.md) | 在役 |
|
||||
| 状态图标 | [美术圣经](../art/art-bible.md) | 在役 |
|
||||
@@ -155,7 +155,7 @@
|
||||
| 全局纹理过滤设为邻近采样 | [06-待办清单](06-待办清单.md) | 在役（迭代 26 · 2026-10-14 入库：default_texture_filter=0＋平滑渐变件三处显式 LINEAR 白名单，翻转面全枚举闭合） |
|
||||
| UI 贴图重构批（营地与元进度件出终稿） | [美术资产清单](../art/art-assets-checklist.md) | 待做 |
|
||||
| UI 字体补完（拉丁像素字专件 + 字重两档） | [美术圣经](../art/art-bible.md) §7.4 | 待做 |
|
||||
| 战斗一屏样张（界面美术的终稿闸） | [美术圣经](../art/art-bible.md) §1.4 | 待做 |
|
||||
| 战斗一屏样张（界面美术的终稿闸） | [美术圣经](../art/art-bible.md) §1.4 | 待做（2026-10-16 用户令编入迭代 30，序位②） |
|
||||
| UI 氛围层与九宫格切片观感修 | [06-待办清单](06-待办清单.md) | 部分在役（迭代 26 · 2026-10-14：光柱硬边半已修＝连续 alpha 渐变；九宫格切片错位半未结——待素材尺寸核对，属美术线连带面） |
|
||||
| UI 元素细节修（滑轨填充 / 图标垫块 / 留白 / 开发件外泄） | [06-待办清单](06-待办清单.md) | 在役（迭代 26 · 2026-10-14 入库：①滑轨填充随迭代 25 注销；余②图标垫块明度差降档/③商店+营地布局修/④诊断钮迁调试浮窗 全落地） |
|
||||
|
||||
@@ -207,7 +207,6 @@
|
||||
| 4 | 混编遭遇第二批（Boss 多行）进不进 Alpha | 二 · 内容量 |
|
||||
| 5 | 站桩帧动画进不进 Alpha | 五 · 表现 |
|
||||
| 6 | 素材升档重产进不进 Alpha | 五 · 表现 |
|
||||
| 7 | 立绘清晰度回退评估——改回高清图，还是维持像素风定档 | 五 · 表现 |
|
||||
|
||||
---
|
||||
|
||||
@@ -225,3 +224,4 @@
|
||||
| v1.4 | 2026-10-14 | **UI 交互与观感批收口回填（迭代 26 卡①机械面随批）**：「三 · 界面」表「UI 按钮状态矩阵」行 待做→在役（五态矩阵补齐）；「五 · 表现」表三行——「全局纹理过滤设为邻近采样」待做→在役、「UI 氛围层与九宫格切片观感修」待做→部分在役（光柱半已修，九宫格半未结注明）、「UI 元素细节修」待做（余②③④）→在役（②③④全落地）；06 对应四条销号或改写+反哺点四条新条登记（待用户裁决另批落文）；条目集合零增删，未决项与「六 · Alpha 不含」零触碰 |
|
||||
| v1.5 | 2026-10-15 | 简明技术中文用语规范（用户令）：文头状态行换代 v1.2→v1.4（v1.3/v1.4 两批漏更）；「现状」取值枚举三种改四种（补「部分在役」定义，与「五 · 表现」九宫格切片行既有状态对齐）。条目集合零增删，未决项与「六 · Alpha 不含」零触碰 |
|
||||
| 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 反哺另批） |
|
||||
@@ -51,7 +51,7 @@ HUD框架站在玩家与全部玩法系统之间：挖掘期它是输入的翻
|
||||
|
||||
### 战斗屏三区双舞台：挖掘与结算同屏不切场景
|
||||
|
||||
战斗屏是 MVP 唯一的玩法屏，采用"双舞台"布局——战斗画面与扫雷图两块区域同屏常驻、互不顶替：挖掘期敌人在上方待机可见，轮末结算在原地逐行展开，全程不切换场景。"扫雷的因"与"战斗的果"因此永远摆在一起，因果不需要玩家凭记忆拼接。
|
||||
战斗屏是 MVP 唯一的玩法屏，采用"双舞台"布局——战斗画面与扫雷图两块区域同屏常驻、互不顶替：挖掘期敌人在上方待机可见，轮末结算在原地逐行展开，全程不切换场景，因果不需要玩家凭记忆拼接。
|
||||
|
||||
三区各管一块：
|
||||
|
||||
|
||||
@@ -80,7 +80,7 @@ HUD 框架定稿时已为教学留好两个承载位，本系统的内容将来
|
||||
|
||||
## P0 最小闭环
|
||||
|
||||
教学引导整体后置，MVP 不要求最小闭环。Alpha 期的最小集合候选：三动作教学 + 行动点价目 + "扫雷的因 = 战斗的果"归因提示 + chord 首遇提示。
|
||||
教学引导整体后置，MVP 不要求最小闭环。Alpha 期的最小集合候选：三动作教学 + 行动点价目 + chord 首遇提示。
|
||||
|
||||
## P1 / P2 后置
|
||||
|
||||
|
||||
@@ -0,0 +1,277 @@
|
||||
# 需求卡片：第二 / 三关棋盘观感——亮度与对比度批（T1 定性人闸 · T2 按轴修法 · 验收三件套 · 08 表现行换代）
|
||||
|
||||
- 版本：**v1.2（2026-10-16 裁决留痕版：三卡待裁项按用户令定案——Q3 已裁甲·同批、Q2 延裁留痕并将裁点挂至 T1 出口呈报硬流程步骤、排期栏定实「已编入迭代 30」与三卡串行序位、§4B 跨卡依赖按已裁事实改实、全卡零悬空待裁点；v1.1 同日 grilling 审查修订见 §11；v1.0 同日成文）**
|
||||
- 来源：[06-待办清单](../gdd/06-待办清单.md)「第二 / 三关棋盘观感——亮度与对比度」小节（2026-10-13 用户裁定条）+ [playnote](playnote.md) 用户试玩原始记录：「UI优化，第二第三关的棋盘看着太累了；不知道是因为亮度还是对比度的原因，看着非常费劲，非常不舒服」
|
||||
- 归属：**表现层美术修批**（06 在册条目直接写卡；两轴归属 = [HUD框架](../gdd/systems/表现与支撑/HUD框架.md)（UI 轴）+ [美术圣经](../art/art-bible.md)（素材轴），定性前两方共裁——沿用 06 条裁决）
|
||||
- 排期：**已编入迭代 30（2026-10-16 用户令，roadmap 同步在批）**。同迭代三卡串行序位第 3：[未开格类型徽章批卡](需求卡片-未开格类型徽章批-2026-10-16.md)→[战斗一屏样张批卡](需求卡片-战斗一屏样张批-2026-10-16.md)→本卡（徽章→样张→观感）。**并行例外**：本卡 T1/T1b 采样与定性读数允许与前两卡并行穿插——依据=采样是只读动作（出帧/读数/样张均不触碰 golden 三张、样张主板、§5 同步面文档等汇聚文件），落码修改（T2 起）仍按上述序位串行。开工门 = U0，须用户 `/iter` 发令；且 T1 出口定性人闸未过之前禁止动码——该闸 = [06 本条](../gdd/06-待办清单.md)既有裁决硬步骤（「开工前先过『素材轴 / UI 轴』定性人闸」，2026-10-13 用户裁定；[08 版本历史](../gdd/08-Alpha版本标准.md) v0.3 同款注），**不是待裁点**（v1.1 撤销原 Q1，见 §10）。
|
||||
- **立场前提（用户原话，本卡设计的第一约束）**：此条立项原因就是用户实机觉得现在的画面累眼、且对「纯程序化重产现状」明确不满——「如果还是用原有方式弄出来的东西，有没有可能还是我不满意的？」。本卡对此的正面回应 = ①第一步定性用**可量化的读数归因**（明度直方图 / 相邻格对比 / 高频能量 / WCAG 对），禁止凭感觉猜轴；②两条修法各自的产出物写清**相对现状新增什么**（§6 T2 两案效果上限表）；③**诚实的效果声明**：观感是主观项，机检只能证伪（读数红 = 必有问题）不能证真（读数绿 ≠ 用户满意），**阻塞性人闸全部前置**（T1 定性闸 + 契约 4 方向闸），入库后实机目检按 2026-10-12 用户令口径**登记 07 不阻塞**（[CLAUDE.md](../../CLAUDE.md)：「真人检测只登记不阻塞——禁以等目检为停工理由」），用户复判否决走 §7 V4 回补机制（行回待做 + 06 立残留条）。防「改一轮还是不满意」的机制 = **先出改前/改后并排对比读数样张给用户定性确认方向，方向过了人闸才落码**（🔴 契约 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版本标准](../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 基线显式重制并呈报换代面 + 用户实机目检轮**登记**（[07-体验验证清单](../gdd/07-体验验证清单.md) 口径；2026-10-12 用户令=登记不阻塞入库，否决走 V4 回补）；
|
||||
4. 08「五 · 表现」棋盘观感行 待做→在役 改写完成（时机=本批入库时，并顺带 07 目检登记注）；
|
||||
5. 06 对应条目状态更新（完成注记），本卡涉及的文档同步面（§5）全部到位。
|
||||
|
||||
**效果不确定性的诚实声明**：观感是主观项。机检读数能证伪（超带 = 必有问题）不能证真（达标 ≠ 满意）。证真面由**前置人闸**承担（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](../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 用户令口径执行（CLAUDE.md 红线「真人检测只登记不阻塞」）：登记 07 即完成义务、不卡入库；**禁把「机检全绿」写成「用户满意」的等价表述**——用户复判否决时按 V4 回补（08 行回待做 + 06 记残留、下批重开）。（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 三卡已裁定案改实）
|
||||
|
||||
本卡与**未开格类型徽章批**（`需求卡片-未开格类型徽章批-2026-10-16.md`）、**战斗一屏样张批**（`需求卡片-战斗一屏样张批-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. 关联文档同步面
|
||||
|
||||
| 文档 | 关联点 | 同步义务 |
|
||||
|---|---|---|
|
||||
| [06-待办清单](../gdd/06-待办清单.md) 本条 | 状态行改写（定性报告交付/完成注记）；T1 发现的新红点若立新条则同批登记 | 机械面 · 顺带更新 |
|
||||
| [08-Alpha版本标准](../gdd/08-Alpha版本标准.md) 「五 · 表现」棋盘观感行 | 待做→在役（完成定义第 4 件；批入库时改写并顺带 07 目检登记注；用户复判否决走 V4 回补——行回待做+06 记残留） | **完成时改写义务** |
|
||||
| [art-bible](../art/art-bible.md) §4.1/§4.3（素材轴改色表值）或 §6.5/§7（UI 轴改常量方向） | 数值定值单点纪律：改值 = 走该节修订并登记（「待定现用」态），禁只改代码不改文档 | 机械面 · 顺带更新 |
|
||||
| [HUD框架](../gdd/systems/表现与支撑/HUD框架.md) 视野迷雾节 | 仅当 T2 裁到迷雾灰显档参数时 | 条件同步 |
|
||||
| [07-体验验证清单](../gdd/07-体验验证清单.md) | T4 登记实机目检条目（L1/L2/L3 并排看后问卷式回报） | 机械面 · 顺带登记 |
|
||||
| [roadmap](../../roadmap.md) | 迭代 30 行已编入（2026-10-16 用户令，roadmap 同步在批）；余留义务=估时刷新（T5） | 机械面 · 批内顺带更新 |
|
||||
| `active.md` 状态记录 | 本批条目进度刷新 | 机械面 · 顺带更新 |
|
||||
| `tools/recolor_terrain_tiles.py` / `game/tests/golden/` | 甲案色表修订 = 脚本内定值换代；golden 基线三张重制 | 机械面 · 随修法落地 |
|
||||
| [playnote](playnote.md) | 历史试玩记录不回改（沿革留档），本卡即其正式承接 | 无义务 |
|
||||
|
||||
---
|
||||
|
||||
## 6. 任务卡
|
||||
|
||||
> 估时按工作日口径；每卡出口自跑轻闸，批末跑 render_gate 全链。
|
||||
|
||||
### T1 定性步骤（人闸前置；含 T1b 新建采样件合计 ≈2–2.5d，**必先做，产出物 = 定性报告 + 对比样张**）
|
||||
|
||||
逐关（L1 参照位·注意含 10×10 与 12×12 两板型〔F1〕 / L2 / L3）三测面采样。**采样源按测面分治（v1.1 修正）**：
|
||||
- 测面一（棋盘瓦片区）与测面三（迷雾遮罩部分）= `board_shot_probe` 实机渲染帧（确定性可复现，C6；过程帧 render_gate 即弃——本批帧自行留档于库外目录，读数表进实现报告）；**禁拿素材文件代替渲染帧**（迷雾遮罩/揭示态只在渲染帧里存在）；
|
||||
- 测面二（舞台底与屏根）= **现有探针拿不到**（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 美术审计结论条「第二 / 三关地面是近黑斑加亮筋的双峰纹理——数字无论亮墨还是垫牌，盯久了都会累。这不是再叠一层界面能救的」〔`design/art/美术审计-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 分关读数证伪「纹理太碎」假说（甲样张读数达标而用户方向仍否决 = 指向乙）；
|
||||
- **产物与落点**：改前/改后并排样张 + 分关读数表（含甲案试算槽值清单）随定性报告呈报用户，**用户当场裁甲/乙**，结论按 §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/remote-gen-prompts.md) 对话操作单 + [comfyui-prompts](../art/comfyui-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. 用户实机目检轮：07 登记条目（玩法：L1/L2/L3 各开一局，并排回报「费劲感」相对改善）——登记即完成本批义务、不阻塞入库（2026-10-12 用户令）；用户复判否决走 V4 回补。方向级否决（样张层）已在契约 4 前置拦截，本步只剩终验。
|
||||
|
||||
### T5 文档同步与完成定义改写（≈0.5d，末卡）
|
||||
|
||||
§5 全部机械面同步；08「五 · 表现」棋盘观感行 待做→在役（批入库时改写并顺带 07 目检登记注；V4 回补机制适用）；06 本条状态改写（完成注记或阶段注记）；roadmap 估时刷新。
|
||||
|
||||
**估时合计 ≈ 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**）+ 裁决留痕补记 §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 相应节修订登记转「待定现用」态，禁以批次判据身份直接成为执法值 | 读数表（改前/改后并排）进实现报告；带值以 T1 冻结版为准 |
|
||||
| V3 | 渲染闸换代 | 先跑 `render_gate.sh` 见棋盘 golden 段红（确认破的是预期面）→ 跑 `golden_baseline_refresh.sh`（缺省=棋盘三张，菜单态触及加 `--menu`；素材齐盘前置）→ 复跑 `render_gate.sh` 全绿；三张新旧基线并排呈报，changed 面 = 预期面，零超预期漂移 | 闸日志 + 呈报件；提交说明含触发原因（契约 6） |
|
||||
| V4 | 用户实机目检 | 07 条目登记 + 用户回报「费劲感」相对改善且 L1 无退化——**登记不阻塞入库（2026-10-12 用户令）**；用户复判否决 = 回补机制触发：08 行回待做、06 本条记残留重开、返工起点=T1/T2 重议（不回滚已入库码面，按新条处置） | 主观判据的唯一权威=用户回报；入库前方向由契约 4 样张闸把关 |
|
||||
| V5 | 邻接零回归 | 冒烟全套 + run_all + probe 链零新增红（呈现面触碰加跑 ui_contrast）；同迭代徽章批断言面零回归（§4B X3） | 全闸 |
|
||||
| V6 | 文档义务 | 08 行改写（批入库时+目检登记注）、06 状态刷新、art-bible 修订登记（色值若动）、HUD框架（迷雾参数若动） | 逐件核对 |
|
||||
|
||||
**闸口径**：机检（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 版本历史 v0.3 同款注「P2 棋盘观感标『Alpha 阶段需完成 · 开工前过素材轴/UI 轴定性人闸』」）。「要不要过闸」不成立为问句，本卡处置 = 落为 T1 出口**流程硬步骤**（P1/V1），闸上同时冻结轴归因与 V2 目标带数值——**既裁人闸，不占裁点**。
|
||||
|
||||
### Q2 · 素材轴修法走哪案：程序换色重校（甲）还是瓦片重产（乙）？——**延裁留痕**
|
||||
|
||||
- **裁决（2026-10-16 用户令，来源句见本节顶）**：「待 T1 定性读数出来后再裁甲/乙；开工默认先做甲案（recolor 换色）候选样张以证伪纹理说」。
|
||||
- **延裁≠回避**：裁点挂到 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 指涉均已改为裁决留痕/流程步骤引用）。
|
||||
|
||||
---
|
||||
|
||||
## 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 唯一墙瓦片名单」）；`design/art/美术审计-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 版本历史 v0.3 同款注——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 路线选型——本卡乙案重产与其冻结次序互锁） | `需求卡片-未开格类型徽章批: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 用户令红线冲突**：CLAUDE.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 把它当实机可测层不成立 | CLAUDE.md:63；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 为准。
|
||||
@@ -0,0 +1,322 @@
|
||||
# 需求卡片：战斗一屏样张批（整屏样张判定物首跑 · 四屏样张排程 · 防不满意工序重排）
|
||||
|
||||
- 版本：**v1.2**（2026-10-16 用户裁决回写：Q1–Q6 六项全部已裁——裁决来源统一措辞「2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕）」，§7 逐条留痕；本版改动：§7 由「待裁点」改为「裁决记录」（选项原文保留＋裁定案＋一句理由），排期改实（迭代 30 已编入、roadmap 同步在批；三卡串行位第 2＝徽章→样张→观感），§0/§1/§2/§3/§6/§7.5/§8 按裁定口径改实，T0 承接 Q5 甲案死指涉处置（指代稿候选 v31/v32/v33-draft 实查拍板），T1 新增 Q3 乙案试验件前闸（半天，不过闸退甲案预设退路），T2/T3 承接徽章卡 Q2 甲案之明度档复核转正义务（§7.5 D1 改实），T4 随 Q2 甲案退役为登记行（06 三屏排队行=本批交付义务，写入文档时点=批次出口），估时随 Q3 乙案重算为 **≈5–6d** 并改软盒拆批线，全卡不留已裁 Q 项的「待裁」字样）。v1.1（2026-10-16 grilling 对抗审查修订；v1.0 同日成文）v1.0→v1.1 改动八项，逐条证据见文末「grilling 审查记录」：①**事实面订正七处**——整屏四项的机检代码并非「从无」（`tools/shot_checker.py` 头注自述承载 §1.4 整屏闸机检，迭代 9 T8 已首跑实测 PASS，git 053baeee；缺的是样张判定物与③焦点预算）；死指涉行号 527→**562**；v1 四否决原因补全四条（②封印色冲突、④微光格只留微光此前漏列）；playnote 引文改逐字；P5「worktree 不可直接跑」证伪（两级回退＋自动建目录）；旧锚 §5.1 另存于 06:41（此前只登记看板一处）；战斗表现内容清单仍写「四区」（现行三区 B/C/D）。②新增 **P10**（关卡屏样张 v1 已冻结 2026-09-28，系立闸前产物）与 **P11**（§1.4 的执行时机已被屏级落码批越过，本批性质=闸后补跑）。③新增 **§0.5 样张批继承的既有待裁义务清单**（全库检索「待样张批冻结/终审/追认」得十项，本批禁止静默丢弃）。④新增 **§0.6 已裁项核收表**（Q 清单据此收敛，已裁面不复问；同时关闭本卡三处隐性重问）。⑤Q1 补乙案连带（A4 尺寸基线须显式解冻重校）、Q2 补关卡屏既有件、目标句与完成定义去掉「并集单闸」预设（合体方式归 Q6 未裁）。⑥新增 **§7.5 跨卡依赖**（与迭代 30 并行两卡的次序耦合＋触碰面重叠禁三线并行）。⑦估时加总订正（T4 上限与合计重算）＋补先例出处。⑧验收 V 条逐条改挂实存工具，判不了项降级并注明手段。
|
||||
- 来源：[06-待办清单](../gdd/06-待办清单.md)「战斗一屏样张 P0 未开工——界面成品是否过审的那把尺子还没建（2026-10-13 登记，UI 美化三层诊断 · 第二层）」条（:37-43；注：该条「尺子到现在还没造出来」的措辞与 P1 读数有差——机检代码在位，缺的是样张判定物，T0 订正面连带此句）；依赖素材取自同清单相邻条「UI 贴图重构批」（:21-27）「UI 字体补完」（:29-35）「资产升档重产批」（:465-471）「立绘清晰度回退评估」（:473 起）「迭代 26 反哺点④」（:78）「美术资产链路审计两项 P0」（:609-615）
|
||||
- 归属：**美术线**（06 原条归属栏：战斗屏样张的验收标准归[战斗表现](../gdd/systems/战斗循环/战斗表现.md)与[美术圣经](../art/art-bible.md)共裁）；样张生产脚本与机检面归呈现层工具面（工程）
|
||||
- 排期：**迭代 30 已编入**（2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕），[roadmap](../../roadmap.md) 同步在批）；三卡串行序位第 2（徽章→样张→观感，§7.5 D3 改实）；开工门 = U0〔用户 `/iter` 发令——Q1–Q6 已全部裁决（见 §7），无遗留待裁项〕；v1.1 之「Q1 必须先裁」前提随其裁决（丙案）关闭，本批依赖链与任务顺序已按丙案口径改实（见 §0/§3）
|
||||
- **立场前提（用户原话，本卡每环节据此设计）**：「现在做优化就是因为它丑；如果还是用原有方式产出，很可能还是不满意。」⇒ 本卡对现状的改动不是「再跑一次程序化产图」，而是**工序重排 + 选型交用户裁决 + 否决成本前移**；每张任务卡自带「相对现状新增什么」与「防重蹈不满意怎么防」两栏。
|
||||
|
||||
---
|
||||
|
||||
## 0. 前置依赖与并行性
|
||||
|
||||
**串行位**：按 roadmap 执行纪律「一迭代一 loop、单迭代串行」（roadmap.md:93），本批**已编入迭代 30**（2026-10-16 用户令，roadmap 同步在批），前置=迭代 29（[需求卡片-测试分层与门禁语义修正批-2026-10-15.md](需求卡片-测试分层与门禁语义修正批-2026-10-15.md)）完成后开工；三卡串行序位第 2（徽章→样张→观感，2026-10-16 用户令裁定，§7.5 D3 改实）。**两处限定（v1.1 补）**：①迭代 29 自身开工门 U0 未解（roadmap.md:88 载明「Q3–Q7 裁点＋卡片 v2.0 重核＋`/iter` 发令」），本批开工时点因此不可估，禁把「迭代 29 完成后」读成排期承诺；②触碰面重叠除 iter29（`tools/`、06、08、07、roadmap、active.md）外，**还包括另两张迭代 30 卡**（徽章卡动 `presentation/views`＋06/08/07＋art-bible 修订行；棋盘观感卡动 `tools/recolor_terrain_tiles.py`＋golden 基线＋art-bible §4.1/§4.3＋08 表现行）——三卡各写 06/08/07/art-bible/roadmap/active.md，序位既裁则「禁三线并行」转为逐批串行执行，详见 §7.5。
|
||||
|
||||
**闸已立、机检面已跑过实机帧、样张判定物从未出**：整屏样张闸条款已于 art-bible v3.0（2026-09-29）写入 §1.4（L64）——四屏各出一张整屏样张、验收四项、闸形「方向稿目检先行」、执行时机 = 屏级视觉落码开工前；§7.1 占位完成条款同步在位（L411，程序化占位 = 临时态，终稿闸 = §1.4 整屏样张过闸，占位态禁止跨里程碑）。**机检面并非空白**：`tools/shot_checker.py` 头注自述「整屏样张闸机检（迭代 9 卡⑤/T8 2026-09-30）」，四项中 ①文字对比 ②明度三档带 ④文字禁压纹理 已有实现（B/C/D 段，另 F 段补「文字在判据」），③整屏焦点预算明文「语义面无法机检 → 归实机目检人闸」（E 段）；该断言集 2026-09-30 已对**实机渲染帧**首跑实测 PASS（git 提交 053baeee：「实测 PASS——WCAG 5.79-13.14／三档 204>79>55／骨架四屏过；焦点预算=目检项归段闸人闸」），随闸三裁决亦已裁毕（见 §0.6；呈报单原文件 design/qa/m3-iter9-t8-rulings-2026-09-30.md 已按吸收即死纪律在提交 8e02dcf0 删除，结论以各权威文档现行为准），现挂在 `tools/render_gate.sh` ①段周期跑。**本批要补的是剩下的半截**：出 §1.4 意义上的整屏**样张判定物**（目标图，非现状截图）、走「方向稿目检先行→精制→冻结」的闸形、补 ③焦点预算的判定、按屏扩取样点位、立四屏冻结记录（**v1.2 按已裁范围收窄：Q2 裁甲案，本批只出战斗屏判定物与其冻结记录，余三屏登记 06 排队行归后续批**）。**不新立闸条款。**
|
||||
|
||||
**前置事实（2026-10-16 实读）**：
|
||||
|
||||
| # | 事实 | 出处 |
|
||||
|---|---|---|
|
||||
| P1 | 格子样张 v3 已冻结（2026-09-30，机检 17/17 全绿，四冻结①④重冻生效）。整屏四项的**机检代码在位且已对实机渲染帧跑过**（B 文字对比／C 明度三档带／D 文字禁压纹理＋F 文字在判据），**唯 ③整屏焦点预算明文不可机检（E 段归人闸）**；§1.4 意义上的「整屏样张判定物」与四屏冻结记录两件从未产出 | [art-bible](../art/art-bible.md) §1.4（L64 闸条款／L68 v3 冻结记录）；[shot_checker.py](../../tools/shot_checker.py) 头注 L1-25；git 提交 053baeee（iter9-T8 卡⑤ 首跑实测 PASS）；[render_gate.sh](../../tools/render_gate.sh) ①段 L11-13 |
|
||||
| P2 | 现行 v3 脚本头注自称「战斗一屏样张方向稿生成脚本 v3-draft」，实际出的是 B/C/D 三区 1280×800 全内容合成图 + S2/S3/S4 附录 + A1–A6 程序化审计——但**冻结记录登记在格子样张闸名下**（圣经 §1.4 v3 段），且它验的是「格＋一张合成 mockup」，不是「屏级气质判定物 + 四项逐项断言 + 冻结记录」三件齐 | [render_sample_sheet_v3.py](../../tools/render_sample_sheet_v3.py) 头注 L2、L28「一屏样张 = B/C/D 三区全内容（1280×800 1:1 实比）」、L1100-1144 版式与断言清单；art-bible §1.4 L68 |
|
||||
| P3 | 看板十五件：✅4 / ◐8 / ⬜3（实点计数核过）；「战斗一屏样张」行 = ⬜ 未开始，需求文档指针为战斗表现 + art-bible §5.1。**注：§5 已抽离至 [character-design.md](../art/character-design.md)（v1.7 批），指针系旧锚；同型旧锚另有 06:41「归属」栏一处**（写作「验收标准归战斗表现与美术圣经 §5.1 共裁」——正确锚应为 §1.4 整屏闸＋§7.2 文字硬指标，§5.1 只管剪影轮廓），T0 两处一并订正 | [art-status-checklist.md](../art/art-status-checklist.md) L5/L13-14；06:41 |
|
||||
| P4 | 旧冻结样张产物 `sample-batch-v3-final-2026-09-30.png` 磁盘实测不在盘（`artwork/mockups/` 现存 v0/v2/v31/v32/v33/v34/v35-draft 等同系列图与 level-map-sheet-v1），06 在册 P0①（死指涉条，其原记状态至 2026-10-16 前悬而未决）**已由 Q5 裁甲案（2026-10-16 用户令），处置落 T0**（2026-10-14 审计会话存档 :290/:316 仍记「未读到」）。**订正：06:611 原文写「art-bible 第 68/527 行」，现行为 68 与 562**（527 行实为 §9.1 正面参考表，不含该指涉；562=v3.2 版本历史行）——T0 订正面对 art-bible:68/:562 与 06:611 的行号自身一并核。**同类死指涉另检出一处（v1.1 新增）**：art-bible §8.2 L490 指路 `design/qa/m3-iter9-t8-rulings-2026-09-30.md`（迭代 9 三裁决呈报单）该文件已在提交 8e02dcf0「存量超期清理批」删除，盘上不存在——裁决结论本身已由 art-bible §8.2/§8.4 与 06:465-471 承载，指路须改指现行文档或改「描述性出处」 | 2026-10-16 目录实查；06:609-615；design/art/美术审计-cursor会话存档-2026-10-14.md:290,:316；git 只读查询（053baeee 建件／8e02dcf0 删件） |
|
||||
| P5 | 素材不入 git（归档纪律 art-bible §8.3 L500），v3 脚本 `asset_root()` 做「本仓库→主检出 D:/code/g-plan2」两级回退，且 OUT_PNG 落笔前 `os.makedirs(..., exist_ok=True)`——**故 worktree 分支内可直接跑（v1.0 的「不可直接跑」判断证伪）**；真实约束是**产物落进该 worktree 的 `artwork/mockups/`，而 `artwork/` 整目录不入库**，冻结件不随合并进 master，须按 §8.3 归档纪律打包（这亦是 P4 丢件的成因）。素材在盘实测：board 瓦片 64 件、character 立绘/小人、`game/assets/ui/icons` 状态图标 18 件、fusion-pixel 字体齐 | 脚本头注 L31 + `asset_root` L50-56 + L62/L1147-1149；art-bible §8.3 L500；2026-10-16 目录实查 |
|
||||
| P6 | 样张 v1 曾被用户**四原因整体否决**（2026-09-28），四条已全部断言化。**权威映射表在脚本写报告的那段代码里（L1156-1160），不在头注**——头注只逐条标了 ①③ 的编号，②④ 需从映射表补：①**显示太丑（总纲）**→ A6 观感密度＋装饰变体 ≥2 种；②**封印色冲突**→ 封印黑 #000000（A1a 色板对表自动覆盖）；③**立体感不够**→ A3 图底分离阈值上调＋F6 顶面/立面双明度带 Δ≥18＋F7 整板悬崖 DEPTH_PX 与游戏渲染常量同源；④**微光格只留微光**→ F5c 微光段零 draw_inlay（另见 art-bible v2.12 角嵌退役批）。注：脚本头注 L23 仍写 A3 Δ≥55、L1157 仍写「整板明度 std ≥50.9」，两处均是**旧口径残留文本**，现行定值以圣经 §1.4 v3 记录为准（A3b Δ≥30、A6 明度梯度均值 ≥4.70） | 脚本 L12-26（F1–F7／A1–A6 头注）＋L1156-1160（四否决映射表）；art-bible L68（Δ≥30 定值）／L570（v2.13「v1 四否决原因断言化收官」）／L569（v2.12 ④） |
|
||||
| P7 | 用户气质否决另有两例点名先例：①站桩排版旧格式「盒顶固定 y 与盒内居中在高盒下拉开血条-立绘空洞」2026-10-06 用户点名否决，由 art-bible §8.2「站桩立绘排版 = 方案二」代替（L496）；②playnote 立绘批评，**逐字原文**：「现在的立绘太丑了，像素化的粒度太低了，导致根本看不清立绘；看是否可以改回用较为高清的图片?」（playnote.md:9，文件本身无日期；日期系 06「资产升档重产批」条 2026-10-06 注所记「同日 playnote 立绘批评」，裁定日为 2026-10-13 归美术线） | [playnote.md](playnote.md):9；art-bible §8.2 L496；06:465-471／06「立绘清晰度回退评估」条 |
|
||||
| P8 | 氛围层两派并存（平滑渐变件 vs Bayer 有序抖动）——**已裁半**：vignette/gradient_base/beams 三件保平滑连续 alpha（2026-10-13 grilling Q5 裁，已入 §7.6(三)＋§8.2 LINEAR 豁免清单）；**未裁半** = 两派是否统一，明文「留整屏样张批统一裁决」——本批承接的正是这未裁半（**Q3 已裁乙为主**：统一结论在引擎实拍图上呈报、落 T3 裁决记录，见 §7） | art-bible §7.6(三) L465、§8.2 L486；06:78（迭代 26 反哺点④）／06:82（用户裁「全部按呈报写入文档」） |
|
||||
| P9 | 渲染手段现状：**全仓 `.gdshader` 实测仅一枚**（`game/presentation/views/desaturation.gdshader`，结算去饱和），`ShaderMaterial` 消费面实测仅 `board_view.gd` 一处（:111 声明／:170-172 创建／:194 tween 参数），`.tscn` 内无 shader 节点；样张面全部为 PIL 代码绘制；「Godot shader 能否胜任特效」是用户已提出的未验证疑问（已由 Q3 裁定乙案承接：开工先半天试验件坐实，见 §7；另卡亦载，见 §7.5） | 2026-10-16 全仓检索（`find *.gdshader`＋grep `ShaderMaterial`）；[徽章卡](需求卡片-未开格类型徽章批-2026-10-16.md) F5／用户立场前提行 |
|
||||
| P10 | **关卡屏并非零样张**：关卡画面样张 v1 已于 2026-09-28 冻结（机检 11/11 全绿，闸形 A=机检全绿即冻结，气质终审走 M-2 出口闸真人目检八项过），产物 `artwork/mockups/level-map-sheet-v1-2026-09-28.png` **在盘**。它立闸于整屏样张闸条款（v3.0，2026-09-29）之前，**从未按整屏四项判定过**——Q2 若裁含关卡屏，动作是「按四项补判既有样张」而非从零出图 | art-bible v2.14 L565、§7.2 L418；[level-map.md](../gdd/ux/level-map.md):3/:222/:244；roadmap.md:21（M-2 出口闸目检通过）；2026-10-16 目录实查 |
|
||||
| P11 | **闸的执行时机已被越过，本批性质=闸后补跑**：§1.4 明文执行时机 =「屏级视觉落码开工前」，而屏级落码已发生四轮（迭代 9 视觉落码段、迭代 16 UI 设计对齐、迭代 25 全局主题、迭代 26 交互与观感），Alpha 亦已于 2026-10-03 到手（M-3 关闭）；08「三 · 界面」多行已标在役、五 · 表现仍载「战斗一屏样张=待做」——即 §7.1「占位态禁止跨里程碑」在事实上已被跨。此定性直接影响完成定义第 1/3 条的语义（过闸≠事前定方向，而是对已在役形态出目标图判定物）与 T3 回炉半径 | art-bible §1.4 L64、§7.1 L411；roadmap.md:53/:68/:84-85；08:100-118/:158；美术审计-cursor会话存档-2026-10-14.md:168 |
|
||||
|
||||
**与相邻 06 条的依赖关系（Q1 已裁丙案——样张即设计目标图，本节按丙案口径改实，Q1 原文见 §7）**：
|
||||
- 「UI 贴图重构批」（营地与元进度件出终稿，08 标待做 08:156，06:21-27 状态待办）——判例前置件；**Q1 丙案裁定下不构成本批前置**：样张不待其终稿，反之本卡目标规格清单（尺寸档/色板/明度档逐件成文）反向给其重产/终稿提要求；
|
||||
- 「资产升档重产批」（06:465-471：**已裁案乙**〔2026-09-30 迭代 9 三裁决，本迭代不升档〕＋2026-10-04 用户令暂不做、重启=用户点名＋2026-10-06 优先级再降；v1.0 的「档位上调方向候选」已被 v3.7 八敌逐键定档实质完成，剩余挂起项仅「提灯点亮解禁候选」）与「立绘清晰度回退评估」（08「五 · 表现」L146 待裁＋08 §7 未决项第 7 行 L210，方向待裁）——素材线两个闸口，**性质不同**：前者=已裁且挂起（本批禁代裁、禁重开），后者=真未裁；**Q1 丙案裁定下两者均不再是样张前置**，本卡反提规格反而是其重启时的输入；
|
||||
- 「UI 字体补完」（08:157 标待做，06:29-35 归属栏载明须先裁「补不补拉丁专件、要不要上第二个字重」）——**Q4 已裁丙案**：样张按「目标字重效果」示意出图、本批按样张补真件；「补不补拉丁专件、上不上第二字重」仍归该条自身未裁点，本卡不代裁（见 §7）。
|
||||
|
||||
### 0.5 样张批继承的既有待裁义务清单（v1.1 新增——全库检索「待样张批冻结／终审／追认／重议」所得）
|
||||
|
||||
**为什么要这一节**：这些事项不是本卡新造的议题，而是各权威文档**明文把裁决动作挂名到「样张批」**的既有欠账——本卡若不受理，就会在「本批做完了」的读数里静默丢掉十件在册义务；若受理，就必须逐项写清「本批冻结／本批不冻结并说明去向」。**受理方式已随 §7 已裁 Q 项改实（v1.2）**：Q1 丙案——H1–H4 的尺寸欠账由「目标规格清单随样张冻结产出」承接；Q2 甲案——本批只判战斗屏；Q3 乙案——H10 之氛围统一结论在实拍图上呈报；Q6 乙案——两闸分跑。**本表对 H 项内容本身仍不预设结论——逐项最终处置（冻结／不冻结＋去向批次）按契约 7 落 T3 冻结记录。**
|
||||
|
||||
| # | 欠账项 | 现行状态与出处 | 与本批的关系 |
|
||||
|---|---|---|---|
|
||||
| H1 | 19 枚格面奖励徽章**尺寸**（源 40×40；显示 20/40 双档候选） | art-bible §4.6.2 L309「尺寸候选，样张批冻结」 | 整屏样张要放徽章位即触到该尺寸；未放则显式写「本批不冻结，归贴图批」 |
|
||||
| H2 | 地形变异纹带族**尺寸**（源 64×64 无缝） | art-bible §4.6.3 L328 同口径 | 同上 |
|
||||
| H3 | B 区舞台背景 `stage_bg.png` **尺寸**（源 1280×270 基准一张） | art-bible §6.1 L364 同口径；§6.1 L361 地窟看台「规格与终值归整屏样张闸冻结」 | 战斗屏样张的 B 区背景件，正面触到 |
|
||||
| H4 | 护甲类型（light/ward/heavy）视觉区分方案 | art-bible §4.6.4 L335／§5 存根 L350／[character-design.md](../art/character-design.md) §5.3 L27「候选方案，样张批冻结」 | 站桩名行/徽标呈现触到；是否本批裁归用户 |
|
||||
| H5 | 类型微光**组间互辨抽测**义务（含明度档） | 06:431 裁决④「样张批保留组间互辨抽测义务」；§4.2 L218 组间明度档值从未定义 | **与徽章卡 Q2 直接耦合**（见 §7.5 跨卡 D1） |
|
||||
| H6 | 面板间距/内边距 4px 步进档**终值** | art-bible §7.3 L426「终值归样张批」 | 整屏构图量取即触到 |
|
||||
| H7 | 棋盘小人源档与格边长占比摩擦终值（36px 板 × 32px 源超 ≤0.75 红线） | art-bible §8.2 L494、v1.9 待决注记 L581 | 格边长三方取值不一致另条在册（06「棋盘格边长三方取值不一致」），本批禁代裁，只登记 |
|
||||
| H8 | 镜像与「旗面恒画右」纪律相容口径（代拟待追认） | art-bible §8.4 L508「代拟口径，样张批追认」 | 冻结记录逐条写明已追认/未追认 |
|
||||
| H9 | 钩爪恐魔「宽≥高」豁免（待样张批终审） | character-design L71 | 站桩样张含该敌种即触到终审位 |
|
||||
| H10 | 记忆态/明度带随深度微移/提灯点亮形制/滑轨两段可辨 等 provisional 读数 | art-bible §6.5 L392（「样张/实机自检锚」）、§2.7 L129（「候选，整屏样张冻结」）、§7.6(二) L456（滑轨归样张目检）、character-design L45（提灯点亮形制归整屏样张批重议） | 整屏样张即其判定物；本批须逐项在冻结记录写「裁了／留哪一批」 |
|
||||
| H11 | 「圣经口号型条款机检化批」前置整备（约 55% 条款属口号型无可机检值，分章推进） | 06:513-515「随整屏样张闸前整备批启动」；Alpha未完成事项梳理-2026-10-13.md:133 | 跨卡次序已改实（§7.5 D3 已裁三卡串行序位＝徽章→样张→观感，本卡位第 2）；本整备批是否纳入本批开工门仍属排期题，归用户呈报，本卡不自裁 |
|
||||
|
||||
### 0.6 已裁项核收表（v1.1 新增——铁律「禁再问已裁项」的检索留档）
|
||||
|
||||
下列事项**已被用户明文裁决**，本卡全部 Q 项一律**禁止重开**；表中同时是本卡相关表述的执法依据。
|
||||
|
||||
| 事项 | 现行裁决 | 出处 |
|
||||
|---|---|---|
|
||||
| 格子样张 v2 四冻结（砖面/色板/动画/数字形制） | v2 冻结（2026-09-28）→ v3.0 解冻①④ → **v3 重冻生效（2026-09-30，机检 17/17）**；②色板③动画全程未动 | art-bible §1.4 L66/L68、v3.2 L562 |
|
||||
| 类型微光五组**色相** | **样张 v2 定稿（2026-09-28）**；HUD框架:140 同记「五组色相经样张 v2 冻结」——06:431「候选值，样张批冻结」系滞后措辞，**冻结为真实现状**；本批不重裁色相值 | art-bible §4.2 L218；[HUD框架](../gdd/systems/表现与支撑/HUD框架.md)「未开格类型微光」节实装状态行；详见 §7.5 D1 |
|
||||
| 微光组粒度 | v3.12 批已裁：组间五色相、组内不细分 | art-bible v3.12 L551、§4.2 L218 |
|
||||
| 未开格类型微光作用圈 | 英雄周围 8 格（非全板常显），2026-09-30 用户裁；不随灯光区扩 | 06:431 口径校正；HUD框架同节；art-bible §6.5 L390 两圈分立注 |
|
||||
| 站桩形态（卡片式退役） | 2026-09-20 用户裁决全站桩式，对照义务解除 | [战斗表现](../gdd/systems/战斗循环/战斗表现.md):77/:83/:93；[battle.md](../gdd/ux/battle.md):395/:437 |
|
||||
| 站桩排版 | 2026-10-06 用户拍板方案二（旧「盒顶固定 y＋盒内居中」点名否决退役） | art-bible §8.2 L496 |
|
||||
| 八敌立绘源档 | 2026-10-06 逐键定档批完成（36–94，显示 ×2）；「48/64/96 三档候选」一并完成 | art-bible §8.2 L495、v3.7 L556 |
|
||||
| 资产升档重产 | 已裁案乙（本迭代不升档）＋2026-10-04 令暂不做＋2026-10-06 优先级再降；重启=用户点名 | 06:465-471 |
|
||||
| 1920 档缩放策略／动画帧数规格／资产升档与否（迭代 9「随闸三裁决」） | **三件全部已裁**：1920=案甲全局等比（v3.2）；帧数=样张 v2 ③冻结（§8.4 L505-507）；升档=案乙 Alpha 后（06 已裁） | art-bible §8.2 L490、v3.2 L562、§8.4 L505；git 提交 053baeee（呈报单原文件已按吸收即死纪律删除，见 P4 附注）；本卡禁以「随样张裁」名义重列 |
|
||||
| 氛围层三件保平滑 | 2026-10-13 grilling Q5 已裁（统一与否另裁，见 P8） | art-bible §7.6(三) L465、§8.2 L486 |
|
||||
| 封印色 | 封印黑 #000000（2026-09-28 用户拍板；紫→黑因色相冲突） | art-bible §4.1 L196、v2.11 L568 |
|
||||
| 角嵌／微光格附加图形 | 2026-09-28 用户裁「微光格只留微光」，角嵌彻底退役 | art-bible v2.12 L569、§3.2 L168 |
|
||||
| 关卡屏视觉终稿 | 样张 v1 机检 11/11 冻结（2026-09-28）＋M-2 出口闸真人目检八项过 | art-bible v2.14 L565；level-map.md:3/:222；roadmap.md:21 |
|
||||
| 按钮五态／全局 Nearest／主题资源 | 迭代 25/26 入库并经用户 2026-10-14 裁「全部按呈报写入文档」 | art-bible §7.6、v3.14 L549；08:117-118/:155 |
|
||||
|
||||
---
|
||||
|
||||
## 1. 目标与完成定义
|
||||
|
||||
**目标（一句话）**：把「判定界面美术算不算过关的那把尺子」补齐并按它跑通战斗屏——**尺子 = art-bible §1.4 整屏闸四项 ＋ [战斗表现](../gdd/systems/战斗循环/战斗表现.md)「一屏样张的验收标准」节五项（:79-93）构成的断言集，两套口径的合体方式已由 Q6 裁定乙案——两闸分跑（见 §7）；跑通 = 方向稿目检先行 → 精制 → 机检 → 用户终审 → 冻结记录写入文档**。
|
||||
|
||||
**相对现状，新增了什么（批次级；v1.1 按 P1 读数重写第 1/4 条）**：
|
||||
1. 现状：**格子闸执行并冻结过；整屏闸的四项机检代码也已存在并对实机渲染帧跑过**（迭代 9 T8，shot_checker B/C/D＋F），但**从未产出「整屏样张判定物」、从未立整屏冻结记录、③焦点预算从未判定**——本批新增=样张判定物本体＋整屏冻结记录首条（战斗屏；四屏全套随 Q2 甲案余三屏登记 06 排队行归后续批）＋③焦点项的目检判定＋取样点位按屏扩面（T2）；
|
||||
2. 现状产图工序 = 脚本一次合成单路线成品直接呈报——本批新增**方向稿先行**硬工序（本批战斗屏先出 2–3 张低成本方向稿供用户选划，方向判完才准精制，T1；后续各屏各自立此闸）；
|
||||
3. 现状渲染手段默认锁死「PIL 程序化代码绘制」——本批把代码绘制 / shader / 新素材三路线的选型呈用户裁决（Q3），**已裁乙为主、预设甲案退路（2026-10-16 用户令）**：Godot 引擎实拍＋shader 为目标路线，开工先半天试验件坐实，不过闸即退甲案纯代码管线（退路预裁定，见 §7）；
|
||||
4. 现状两套标准并存未合体（§1.4 整屏四项 / 战斗表现专项五项）——本批合成一张逐项比对表（T2），合体方式**已由 Q6 裁定乙案：两闸分跑**（专项第 5 项只产裁决记录）。
|
||||
|
||||
**防产出重蹈不满意（批次级，三道防线）**：
|
||||
- **防线一（工序）**：否决成本前移——方向稿阶段否决只损失半天，精制阶段否决按战斗表现判定回退条款只回炉不过项（继承既有口径「已过项结果保留」，战斗表现:93）；禁止跳过方向稿直接出精制版（V1：无目检记录即开工精制 = 违红线）。
|
||||
- **防线二（判据）**：P6 四条否决原因（①显示太丑／②封印色冲突／③立体感不够／④微光格只留微光）＋P7 两例（站桩排版空洞、立绘像素粒度）逐条映射为整屏断言集内的具名项；断言不过不出图（「生成即验，不过闸不出图」纪律沿 v3 脚本原文 L12）。
|
||||
- **防线三（终审）**：气质终审权恒归用户目检，机检全绿不等于过闸。先例：v3 冻结时气质终审走的是「验收豁免」（art-bible L68，2026-09-29 用户验收豁免，状态记录 281），本批**不申请豁免**——此为**本批自我从严的执行纪律，不是对用户裁决的改动**；用户若主动以豁免方式判定本批完成，从其裁决。
|
||||
|
||||
**完成定义**（全部满足才算本批完成）：
|
||||
1. 战斗屏样张过闸：方向稿用户选划记录在案 + **按 Q6 已裁乙案两闸分跑、两闸全绿**（含 ③焦点预算的目检判定记录；专项第 5 项只产裁决记录不产过/不过） + 用户终审「过」记录；
|
||||
2. 冻结记录写入 art-bible §1.4（新增整屏样张冻结记录段——设计权威文档，**仅过闸后写入**，走文档同步闸）；同段逐条写明「本样张冻结了什么、没冻结什么」，并对 §0.5 的 H1–H11 **逐项给出处置**（本批冻结／本批不冻结并写明去向批次），禁留空；**同段另须产出两件交付物：① 目标规格清单（Q1 已裁丙案：尺寸档/色板/明度档逐件成文，反向给素材重产批提要求，承接 H1–H4 尺寸欠账）；② 徽章卡 Q2 甲案 provisional 明度档之复核转正记录（H5 组间明度档复核＋组间互辨抽测，复核转正义务按 §7.5 D1 落本卡冻结件，为本卡交付义务）**；
|
||||
3. 状态回写对齐「占位态禁止跨里程碑」条款（**条款在 art-bible §7.1 L411**；08 侧的行是「五 · 表现」表「战斗一屏样张」行 L158，08 无 §7.1 小节——v1.0 此处指路写错已订正）：
|
||||
- 08「五 · 表现」表「战斗一屏样张（界面美术的终稿闸）」行：待做 → 在役；
|
||||
- [art-status-checklist](../art/art-status-checklist.md)「战斗一屏样张」行：⬜ → ✅；
|
||||
- **边界条款**：样张过闸只是**判据生效**，不是各屏占位素材的转正条件——看板其余 ◐ 行（营地件、格面徽章、演出类等）仍须各自素材交付后才可改 ✅，禁止把「样张过闸」扩解为「全部占位转在役」；样张同时按**已裁 Q1 丙案**冻结目标规格清单、反向给素材重产批提规格要求（尺寸档/色板/明度档逐件成文），转正仍逐件走闸；
|
||||
- **P11 定性连带**：本批属闸后补跑，回写禁写成「落码前定方向」口径，须如实注记「屏级落码已先行四轮，本样张为对已在役形态的目标图判定与冻结」；
|
||||
4. **Q2 已裁甲案**：本批仅出战斗屏；关卡/菜单/营地三屏在 06 **登记排队行属本批交付义务**，动作列入同步面（T5/§8），写入文档时点=批次出口；关卡屏既有 v1 冻结样张保留为注记（**其后续批是「对既有 v1 冻结样张补判整屏四项」，不是从零出图**，P10）；
|
||||
5. 06 对应条注销；§8 同步面清单逐项核对完毕；反哺点（如有）登记待用户裁决，不直改权威文档。
|
||||
|
||||
---
|
||||
|
||||
## 2. 范围边界
|
||||
|
||||
**做**：战斗屏样张全流程（方向稿→精制→双口径机检→终审→冻结）；四屏排程落地按 **Q2 已裁甲案**（本批仅战斗屏＋余三屏 06 排队行登记，写入文档时点=批次出口）；整屏断言集的**承载与扩面**——**优先复用 `tools/shot_checker.py`（已有 B/C/D/F）＋ `game/smoke/shot_probe.gd` 的 shot_meta.json 坐标源**，缺口（③焦点判定、逐点位覆盖、色数上限计数）才新建，禁另起一套并行判据；§0.5 H1–H11 继承义务的**逐项受理与处置登记**（冻结或写明去向，不自裁内容）；氛围层两派统一裁决的**裁决与登记**（**Q3 已裁乙为主**：统一结论在引擎实拍图上呈报、落 T3 裁决记录并写入文档，落码归后续呈现批）；P3 看板与 06:41 两处旧锚订正、P4 死指涉处置（**Q5 已裁甲案**：改指在盘最近稿 v31/v32/v33-draft 之一并注「指代稿」，具体指哪份 T0 实查盘面后定）＋ 06:611 行号读数自身订正、战斗表现内容清单「四区」旧措辞订正。
|
||||
|
||||
**不做**（明示去向）：
|
||||
- **不重产任何正式素材**——终稿素材出图归 UI 贴图重构批 / 资产升档批各自立项；
|
||||
- **不改游戏运行时渲染代码**——样张是判定物不是实现物；**Q3 已裁乙案（shader/实拍路线）**，样张侧 shader 试验件与实拍管线只进样张管线，游戏侧落码另批；
|
||||
- **不执行格子闸重跑**——格底明度档、数字承载面已随 v3 冻结（art-bible §1.4 L68），整屏样张直接在其上合成；
|
||||
- **不重裁 §0.6 表内任何已裁项**——尤其微光五组色相（v2 已定稿）、1920 档策略（案甲）、动画帧数（v2 ③冻结）、资产升档（案乙＋挂起）、站桩形态与排版（2026-09-20／2026-10-06 两裁）；
|
||||
- **不代裁 08 未决项**——「站桩帧动画进不进 Alpha」（08 §7 第 5 行 L208）、「素材升档重产进不进 Alpha」（第 6 行 L209）、「立绘清晰度回退评估」（第 7 行 L210）三行归各自条，本卡只登记连带，禁以「样张过闸时顺带」名义吃掉（v1.0 把站桩帧动画写成「Beta/后批事项」属定性失实，已订正：它是 08 在册待裁，不是已排 Beta）；
|
||||
- **不动玩法规则与数值**——纯呈现层判定批，MC 零跑（零数值零行为）；
|
||||
- 键盘输入／手柄（08:191 已明列「六 · Alpha 不含」，排 Beta）不涉。
|
||||
|
||||
---
|
||||
|
||||
## 3. 任务分解
|
||||
|
||||
> 估时按 Claude 工作日口径；每卡自带两栏：**相对现状新增什么 / 怎么防重蹈不满意**。**Q1–Q6 已全部裁决（2026-10-16 用户令，见 §7），开工门 U0（用户 `/iter` 发令）后即可按任务序开工；T0 事实坐实段零路线依赖，可先行**。
|
||||
|
||||
### T0 事实坐实与旧账处置（≈0.5d）
|
||||
|
||||
- 实跑现行 [render_sample_sheet_v3.py](../../tools/render_sample_sheet_v3.py) 与 `tools/render_gate.sh`（worktree 内可直接跑，见 P5 两级回退＋自动建目录；跑前须防**覆盖在盘产物与机检报告**——OUT_PNG/OUT_REPORT 是硬编码旧文件名 L62-63，开工日一律改出到临时区或加日期后缀，禁写回 `sample-batch-v3-final-2026-09-30.png` 与 `sample-v3-final-机检报告-2026-09-30.md`），确认管线今天仍可出图、A1–A6＋F1–F7 全绿基线读数冻结进开工记录（A4 尺寸基线硬等在盘实测成立：立绘 46×48、棋盘小人 32×32）；
|
||||
- P4 死指涉按 **Q5 已裁甲案**处置：art-bible:68/:562 与看板:13 三处死指涉**改指在盘最近稿 v31/v32/v33-draft 之一并注「指代稿」（具体指哪份 T0 实查盘面后定）**，同族死指涉（§8.2 L490 呈报单死路径）按同案口径一并处置；新冻结记录按 art-bible §8.3 描述性出处纪律；P3 两处旧锚（art-status-checklist:14 与 06:41 的 §5.1 → 正确锚 art-bible §1.4/§7.2 或 character-design）订正；06:611 行号读数（68/527 → 68/562）订正；战斗表现:83/:116「四区」→「三区 B/C/D」措辞订正（事实源 battle.md:126/:184）；
|
||||
- §0.5 H1–H11 继承义务清单**逐条复核是否仍然在册**（漂移即订正本表）；Q 项已全部裁决（§7），不再随 Q 呈报，清单逐项处置落 T3 冻结记录（契约 7）；
|
||||
- 复核本卡 §0 全部行号与事实，漂移即订正卡片。
|
||||
- **新增**：开工日可跑性证据＋现有机检面读数基线（现状：shot_checker 周期在跑，样张脚本自 2026-09-30 后无跑动记录）。**防不满意**：先验证旧管线还活着、先量出现有机检代码到底判到哪一项，再决定它在新工序里的角色——避免「新工序设计了，旧工具已哑火」或「重复造一套已存在的判据」两种空转。
|
||||
|
||||
### T1 方向稿（战斗屏 2–3 张，目检先行）（≈1.5–2d 含 Q3 乙案试验件前闸 0.5d）
|
||||
|
||||
- **Q3 乙案前闸（开工第一个动作，半天）**：Godot 引擎实拍＋shader 试验件坐实发光类特效能力边界（光带/泛光/呼吸感）——过闸即走实拍目标路线；**试验件不过闸即按 §7 Q3 预设退路退甲案纯代码管线重出（退路预裁定已写入，不回炉问用户，仅留痕）**；
|
||||
- 战斗屏方向稿 2–3 张：内容骨架按 [battle.md](../gdd/ux/battle.md) 现行 B/C/D 三区布局（:126/:184；**战斗表现:83/:116 仍写「四区」系旧措辞，T0 订正**）与 [战斗表现](../gdd/systems/战斗循环/战斗表现.md) 一屏样张内容清单（:83——站桩单版〔卡片式已 2026-09-20 裁退，§0.6〕、三语境剪影同图、受击/退场/高光三组动画关键帧条、敌层遮挡对照组），**气质方向分岔**（Q3 已裁乙为主：A 引擎实拍目标形态〔主线〕/ B 实拍＋氛围层统一后形态（两派差异在实拍图上直接可见，统一结论呈报落 T3）/ C 代码绘制甲案基线对照张〔试验件不过闸时 C 升主线〕）；
|
||||
- 方向稿张数与气质分岔在 2–3 内自定（2026-10-16 用户令已把三卡各 Q 项全数裁定，方向稿层无待裁项遗留）；
|
||||
- 方向稿允许低成本形态（构图级即可，细节参数不必全冻结），每张附「本方向解决了哪条否决先例」标注（P6/P7 逐条）；
|
||||
- **用户选划 = 人闸**：判完方向才准进 T2；选划记录（哪张、为什么、否决了哪张）登记开工单。
|
||||
- **新增**：现状无此工序（v1–v3 均为单路线成品一次呈报）。**防不满意**：把「不满意」拦在最便宜的阶段；多路线并呈使用户从「验收者」变「选择者」，气质分歧在方向稿层解决而不是精制品层返工。
|
||||
|
||||
### T2 战斗屏精制版 + 双口径断言集（≈2–2.5d，含实拍静态定格工序新建：shot_probe 现出「现状图」，目标构图定格工序为本批新建——§7 Q3 乙案真实成本）
|
||||
|
||||
- 按选划方向精制战斗屏 1280×800 整屏样张（1:1 实比）；
|
||||
- 断言集扩展（**先复用后新建**：`tools/shot_checker.py` 的 B/C/D/F 段已承载整屏 ①②④，`game/smoke/shot_probe.gd` 已产 shot_meta.json 坐标源；本批缺口＝①的逐点位覆盖（现行 B 段只判 meta 登记的已知文字框三处，禁把「三处」报成「全部文字」）、②的非战斗屏取样（现行 C 段只算战斗屏 C 区/棋盘/舞台三点——**Q2 已裁甲案，本批不动非战斗屏，取样面仅扩战斗屏逐点位**）、③焦点预算（明文归人闸，**禁伪装成机检**）、色板 48 色上限计数（现行 A1a 是「对表圣经冻结色值＋禁入带零命中」，**不是 48 色计数**；全仓无 48 色工具，`tools/` 实查零命中，须本批新建，且与 art-bible §8.3 计划的入包色板检查器分工不同——本批只做全图色数计数，不建入包闸）；落点扩旧脚本 vs 建新脚本按工程就近原则批内自定）：
|
||||
- **整屏四项**（art-bible §1.4 L64 闸条款，与 §7.2 L416 同源）：①全部文字（含菜单/说明/tooltip/按钮）对直接背景 WCAG ≥4.5:1，大字〔≥18px 或加粗档〕底线 3:1、目标 4.5:1；②明度三档带成立（信息面层 > 世界中层 > 世界底层，层间灰度可分）；③整屏焦点预算（§3.4 首焦唯一，无第二焦点竞争）；④文字禁直接压纹理底（须垫容器或罩层）；
|
||||
- **A1–A6 口径上屏**（脚本 L21-26＋L925-1031 现行义，**逐项按实义引，禁改名义**）：A1 色板对表冻结色值＋禁入带 300°–345° 全图扫描、**A2 拼缝周界闭合（墙↔地墨线带亮度）**、A3/A3b 图底分离 Δ≥30（L23 头注的 Δ≥55 与 L1157 的「std ≥50.9」是旧文本，现行以圣经 §1.4 L68 定值为准）、A4 混排相融（语义色 == ui_kit 常量＋在库原件可载＋**尺寸基线硬等 立绘 46×48／小人源 32×32**）、A5 画布四缘净空、A6 观感密度梯度均值 ≥4.70；
|
||||
- **战斗屏专项五项**（[战斗表现](../gdd/systems/战斗循环/战斗表现.md):85-93：棋盘区零打扰／剪影三语境灰度可辨／三组动画关键帧可读／双舞台战斗空间／敌层插入位置对照组可裁）——与整屏四项的**合体方式已裁乙案：两闸分跑**（专项闸与整屏闸各跑各退，:93 已成文）；battle.md:152 另载一条挂在样张上的验收项「徽章不进数字区」，一并入表；
|
||||
- **H5 复核项（v1.2 新增，承接 §7.5 D1 已裁义务）**：徽章卡 Q2 甲案 provisional 明度档的复核转正＋组间互辨抽测（06:431 裁决④保留给样张批的义务），结论随 T3 终审一并呈报、写入冻结记录；
|
||||
- 生成即验，不过闸不出图（沿用 v3 脚本纪律原文）。
|
||||
- **新增**：整屏样张判定物本体＋③焦点项的判定＋逐点位取样覆盖（跨屏取样随 Q2 甲案归后续批）（v1.0 所称「该四项只存在于条款文字、无对应代码」经 v1.1 实查证伪，见 P1）。**防不满意**：机检只拦「可量化的丑」（对比度、抢焦、色板越限），拦不住的部分强制留给 T3 目检——机检绿不豁免终审。
|
||||
|
||||
### T3 气质终审（用户目检，闸形 A）（≈0.5d 含往返）
|
||||
|
||||
- 精制版 + 断言报告一并呈用户终审；「过」→ 冻结；「不过」→ 按战斗表现判定回退条款分面回炉（演出/构图面回 T1 或 T2 对应项，已过项保留）；
|
||||
- 过闸同时产出三笔裁决记录：①敌人层绘制优先级插入位置（战斗表现:75 登记原句「随美术测试一并裁决，不在本文提前定」保留，清偿时点经 Q6 裁定随本样张一并——T3 即其清偿点）；②氛围层两派统一结论（Q3 已裁乙为主：在实拍图上呈报；若方向稿层未完成，此层完成即为最迟期限）；③徽章明度档 provisional 复核转正结论（H5，承接 §7.5 D1 已裁义务）。
|
||||
- **新增**：明确不申请验收豁免（v3 先例有豁免，本批关闭该通道）。**防不满意**：终审语义 = 用户说不过就是不过，无「机检全绿应视为过」的反向论证空间。
|
||||
|
||||
### T4 后续三屏排程（Q2 已裁甲案：本卡退役为登记行）（≈0d，06 排队行登记动作并入 T5）
|
||||
|
||||
- **执行 Q2 甲案裁定案**：本批仅出战斗屏；关卡/菜单/营地三屏在 06 **登记排队行属本批交付义务**，动作列入同步面（T5/§8），写入文档时点=批次出口；
|
||||
- 关卡屏既有件保留为注记（P10）：v1 冻结样张已在盘（2026-09-28，机检 11/11），排队行措辞须注明「其后续批=对既有 v1 冻结样张按整屏四项补判，非从零出图」；
|
||||
- 营地屏连带改实：Q1 已裁丙案（非乙案），「等贴图批终稿」串行分支不发生；营地排队行注明「待本卡目标规格清单反提要求，终稿后再出样」；
|
||||
- **跨卡次序改实（§7.5 D2/D3）**：三卡串行序位已随 2026-10-16 用户令裁定＝徽章→样张→观感，本卡位第 2——观感卡排本卡之后，其 L2/L3 落地对本卡冻结读数的复核归该卡义务，本批不为其预留参数域、不被其阻塞。
|
||||
- **新增**：现状四屏闸只立了条款、机检面跑过实机帧，但四屏**样张**零张（唯关卡屏有立闸前的 v1 一张）。**防不满意**：逐屏目检逐屏冻结，禁止「一套断言四处套用」把首屏过闸经验未经验证直接外推（本批只判战斗屏，余屏按排队行各自立闸）。
|
||||
|
||||
### T5 文档同步与状态回写（≈0.5d，末卡）
|
||||
|
||||
- 冻结记录写入 art-bible §1.4（新段，沿 v2/v3 记录格式；**段内系列编号口径属批内代拍**——格子样张序列已用到 v3，整屏样张是否续称 v4 还是自成一列（关卡屏已用「样张 v1」名）在冻结记录里一次说清，禁两处各按一种叫法）；§7.6(三) 氛围层并存条改写为已裁决口径（经 T3 记录）；§0.5 H1–H11 逐项处置写入冻结记录；**随段产出两件（v1.2 新增交付物）：目标规格清单（Q1 丙案，尺寸档/色板/明度档逐件成文）＋徽章明度档复核转正记录（H5/§7.5 D1）**；
|
||||
- [art-status-checklist](../art/art-status-checklist.md) 战斗屏行 ✅ + 余三屏行刷新为「入 06 排队」态；08「五 · 表现」行待做→在役；06 对应条注销（去向登记当批状态记录）；**06 为关卡/菜单/营地三屏新立排队行（Q2 甲案交付义务，写入文档时点=批次出口）**；
|
||||
- roadmap 迭代 30 行状态刷新（编入笔已随 2026-10-16 用户令发出，本批只刷新状态并同步在批）；反哺点（如有）登记待用户裁决，权威文档不直改。
|
||||
- **新增**：完成定义第 3 条的「转正边界条款」写入（防「样张过闸」被误读为占位素材全体转正）。**防不满意**：冻结记录里逐条写明「本样张冻结了什么、没冻结什么」，后续批对表施工，杜绝各自解释。
|
||||
|
||||
**估时合计 ≈5–6d（v1.2 按已裁口径重算）**：Q2 甲案 → T4 退役为登记行（0d）；Q3 乙案 → 新增试验件 0.5d（T1 前闸）＋实拍静态定格工序新建 ≈0.5d（T2 增量）。T0 0.5 ＋ T1 1.5–2（含试验件 0.5）＋ T2 2–2.5 ＋ T3 0.5 ＋ T4 0 ＋ T5 0.5 ＝ **下限 5d、上限 6d**；**若试验件不过闸退预设甲案退路，回退 ≈4.5–5.5d**（扣实拍新建增量，已耗 0.5d 试验件保留）。**软盒拆批线改实**：v1.1 的「四屏全推超 7d 拆两批」分支随 Q2 甲案不再发生——本批 5–6d 在 7d 软盒内单批跑完；若实拍路线超支逼近 7d，仍在 T3 末截断（战斗屏已过闸可单独交付见效），余三屏已列 06 排队行无批内拆分需求。
|
||||
**估时构成依据（先例出处，v1.1 补、v1.2 沿用）**：整屏四项机检的建造＋三裁决呈报＝迭代 9 T8 实测 3–4h 量级（.zcode/plans/m3-iter9-loop-plan-2026-09-30.md:65）——故 T2 走「复用＋扩面」而非重建，增量只花在实拍定格工序新建；同窗格子样张机检冻结＝迭代 9 批 A T1 估 2–3h（同计划书:58）；方向稿多轮呈报的先例工时见迭代 26（估 2–2.5d 实际单会话）、迭代 16（估 6.9d 实际单会话）、迭代 13（估 4.8–5.3d）、迭代 29（估 5.5–7d）；本批估时主要吃在「方向稿＋用户往返目检＋实拍管线新建」，roadmap 迭代粒度界定已裁「迭代周期 ≈ 一周左右」（2026-10-11 用户裁定，roadmap.md:101），本批单屏口径恰在一迭代盒内。
|
||||
天然切分点：T3 末（战斗屏已过闸可单独交付见效）。
|
||||
|
||||
---
|
||||
|
||||
## 4. 验收（逐任务对应，全绿 + 记录齐备才走 T5）
|
||||
|
||||
| # | 需求点 | 测什么 | 落点／判定手段（实存工具，2026-10-16 核） |
|
||||
|---|---|---|---|
|
||||
| V1 | 方向稿先行工序 | 每张精制样张有对应「方向稿 + 用户选划记录」在案；无记录直接精制 = 违红线 L3 呈报 | **人闸留痕，无工具可判**（降级为件核：开工单/出口报告附「方向稿 → 选划 → 精制」三段记录表；禁称机检化） |
|
||||
| V2 | 整屏四项 | ①文字对底 ≥4.5:1 逐点位（大字档 3:1 底线）②三档明度带层间灰度可分 ③首焦唯一 ④无文字裸压纹理 | ①②④＝`tools/shot_checker.py` B/C/D 段（＋F 段），坐标源 `game/smoke/shot_probe.gd` 产的 shot_meta.json，**须先按屏扩取样点位**；**③＝人闸**（shot_checker E 段明文「语义面无法机检」），本批以目检记录判定并留档 |
|
||||
| V3 | A1–A6 上屏 | A1 色板对表＋禁入带全图扫描、A2 拼缝周界闭合、A3b Δ≥30、A4 混排相融（含尺寸基线硬等）、A5 四缘净空、A6 密度 ≥4.70；**另新建 48 色计数**（现行无此工具，art-bible §8.3 入包色板检查器另属他批） | 同上脚本机检段（`render_sample_sheet_v3.py` L925-1031 复用扩展），生成即验 |
|
||||
| V4 | 战斗屏专项五项 | 按 Q6 已裁乙案**两闸分跑**执行（专项第 5 项只产裁决记录）；敌层插入位置随本样张一并清偿，产出裁决记录一条 | 第 1 项借 V2/V3 断言（数字占位区零侵入沿 F5 族）；第 2 项三语境灰度可辨**须新建**（可仿 §1.4 验收 2 灰度分类法）；第 3/4/5 项＝图上元素存在性＋判读，**归 T3 目检**；裁决记录（含 H5 徽章明度档复核转正结论）落 T3 |
|
||||
| V5 | 否决先例映射表 | P6 四条 + P7 两例逐条对到具名断言项（映射底表=脚本 L1156-1160），表格随样张一并归档 | 人工产物，出口报告附件（T2 出表、T3 随终审一并呈） |
|
||||
| V6 | 用户终审 | 「过」字记录；不过则回炉轮次计数留痕 | T3 人闸（active.md 开工单/状态记录留痕） |
|
||||
| V7 | 状态回写 | 08 行 / 看板行 / 06 注销 / art-bible 冻结段四处一致，边界条款与 §0.5 处置表在册；06 三屏排队行（Q2 甲案）与目标规格清单（Q1 丙案）于批次出口时写入；跑文档闸零新增死链 | `tools/run_all_gates.sh`（CLAUDE.md:19/56＝唯一闸入口与唯一闸清单，**文档禁另列闸清单**——v1.0 在 §4 列「doc 三闸＋熵增」名目属违例，已改指路）＋`tools/doc_link_audit.py` 等文档闸由该脚本承载 |
|
||||
|
||||
**闸口径**：本批零玩法零数值——MC 零跑；批末跑 `tools/run_all_gates.sh` 全量档全绿（该脚本是闸件唯一入口与唯一清单，增减闸件只改它本体——CLAUDE.md:19/56）；**样张脚本不入门禁常设闸表**（周期件属性，本批零闸件增删），跑动记录留档。
|
||||
|
||||
---
|
||||
|
||||
## 5. 设计契约（红线）
|
||||
|
||||
🔴 **契约 1 · 零游戏运行时改动**：本批只产图、只动样张工具面与文档；任何「要改 game/ 代码才能让样张成立」的发现 = L3 停机呈报，改动另批。
|
||||
🔴 **契约 2 · 方向稿不可跳**：目检先行是闸形（art-bible §1.4 原文），跳过方向稿直接精制 = 本批最高级违例。
|
||||
🔴 **契约 3 · 卡片不代拍路线**：渲染手段、素材输入级别、四屏范围、字重前提——全部以 Q 项呈用户，批内任何任务禁止预设某路线已成立。**v1.2 闭合**：六项已全部经用户令裁定（2026-10-16 用户令：三卡全部待裁项按推荐方案裁决〔用户将裁权授出，由主线会话代拍板留痕〕，见 §7），本契约转为执法面——各卡按已裁口径执行，批内禁止自行升档、改线或另开路线。
|
||||
🔴 **契约 4 · 机检不豁免目检**：断言全绿不构成过闸；终审权恒归用户；本批不申请验收豁免。
|
||||
🔴 **契约 5 · 权威文档仅过闸后写入**：art-bible §1.4 冻结段、08、06 的回写全部挂在 T3「过」之后；未过闸状态下同步面只许登记「进行中」注记。
|
||||
🔴 **契约 6 · 已裁项不可重开（v1.1 新增，用户红线）**：§0.6 核收表所列事项一律禁止以「样张冻结须总览」「再确认一遍」名义重列备选或再出推荐；本批 Q 项若与 §0.6 任一行相撞，以 §0.6 为准，该 Q 项当场收缩或删除并登记删除依据。
|
||||
🔴 **契约 7 · 继承义务禁静默丢弃（v1.1 新增）**：§0.5 H1–H11 必须在冻结记录里逐项给「冻结／不冻结＋去向批次」；留空即视为本批未完成，禁止以「不在本批范围」一句带过。
|
||||
|
||||
---
|
||||
|
||||
## 6. 异常分级
|
||||
|
||||
- **L1（自救）**：脚本路径/字体回退（素材两级回退失效时改主检出跑）、断言阈值取数笔误、图片命名不合归档纪律、样张产物误写回旧硬编码文件名（T0 已禁）。
|
||||
- **L2（记录继续）**：方向稿张数在 2–3 内自选、断言实现落点（扩 shot_checker/旧脚本 vs 建新脚本）、精制版像素级微调不触发重目检的边界（构图级 = 需重目检，参数级 = 免）、冻结记录段的样张系列编号口径（见 T5 代拍注记）、**Q3 试验件不过闸 → 按 §7 预设退路退甲案纯代码管线重出（预裁定已成立，留痕即可，禁回炉问用户）**。
|
||||
- **L3（停机呈报）**：T0 实跑发现 v3 管线或 shot_checker 链已不可跑通且修复超出样张面；方向稿全部被否决（触发 Q1 口径复核呈报——Q1 已裁丙案，改动须重新裁决留痕，禁批内自开重裁）；发现整屏断言与格子 v3 冻结参数数学冲突（先例：v3.0 时代 Δ≥55 与明度分档带数学冲突退役）；**本卡目标规格清单（Q1 已裁丙案）反提后，素材重产批若发生档位换代，触 A4 尺寸基线（立绘 46×48／小人源 32×32 硬等）变更——圣经 §1.4 L68 明文「资产升档批换代须显式解冻重校」，解冻须走 §1.4 修订，禁批内自改，本批样张侧亦禁预先解冻**；（v1.2 修订：原「Q1 裁乙案但前置批逾期未出终稿」等待场景随丙案裁定不发生，条目删除）；**§7.5 跨卡前提冲突**（任一后续卡的前提在执行中被否定——三卡串行序位已裁＝徽章→样张→观感，本条保留为序内冲突兜底）。
|
||||
|
||||
---
|
||||
|
||||
## 7. 裁决记录（v1.2 改实：本卡 Q1–Q6 全部已裁。裁决来源统一措辞逐条留痕：「2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕）」；本节保留选项原文＋裁定案＋一句理由，v1.1 的「不带推荐案、逐条亲裁」呈报框架随用户授出裁权关闭，备选案文字仅存档供对表）
|
||||
|
||||
| # | 事项 | 备选案与影响 |
|
||||
|---|---|---|
|
||||
| **Q1** | **素材输入级别（本卡核心裁点）**：样张用什么料出？ | **甲 · 纯现有占位资产合成**：最快（T1 可直接开跑），零前置依赖；代价 = 量的是占位态的屏——素材重产后样张作废须重跑，且「丑」的一半源头恰是占位素材本身，用户不满可能原样复现。**乙 · 等贴图重构批与素材终稿出件后再出样张**：样张一次到位量真料；代价 = 串行依赖两批（UI 贴图重构批 06:21-27 待办；立绘清晰度回退评估 08 §7 第 7 行待裁——**注意：「资产升档重产」不是未裁方向，而是 2026-09-30 已裁案乙＋2026-10-04 令暂不做、重启=用户点名，本案只能等其被点名，**禁止代裁****），周期以周计起步，期间「判定尺子没造出来」状态持续；**连带硬账**：素材换代即触 art-bible §1.4 L68「A4 尺寸基线…资产升档批换代须显式解冻重校」，样张的 A4 硬等断言（立绘 46×48／小人源 32×32）须先解冻（走 §1.4 修订），不是零成本串行。**丙 · 样张即设计目标图**：样张承担定稿目标职能，冻结的规格反向给素材重产批提要求（尺寸档/色板/明度档逐件成文，正对 §0.5 H1–H4 的尺寸欠账）；代价 = 要求方向稿本身已接近目标气质，用户对既有程序化气质不满时，方向稿的路线选型（Q3）权重陡增；素材批按样张规格返工的工程量未估，**且本案出的「规格建议单」不改变 08 未决项 6/7 的待裁性质（升档与否、回退高清与否仍归各条用户裁）**。**三案可混合**（如战斗屏走甲/丙、营地屏走乙）——混合粒度亦请一并裁定 **〔已裁：丙——2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕）〕裁定案：样张即设计目标图，样张承担定稿目标职能，冻结规格反向给素材重产批提要求。理由：唯丙案直接服务立场前提（因丑而改），且消除对已挂起素材闸口的串行等待。任务面同步（v1.2）：① 新增交付物「目标规格清单随样张冻结产出（尺寸档/色板/明度档逐件成文）」，落 §1 完成定义 2／T5／§8；② 「三案可混」语义关闭——战斗屏适用丙案，其余三屏按 Q2 裁定（甲案）不在本批，无混合对象；③ 乙案「A4 尺寸基线须显式解冻重校」连带仅于规格清单引发后续素材档位换代时在另批触发（§6 L3 留兜底）** |
|
||||
| **Q2** | **四屏范围与次序**：本批做几屏？ | 战斗屏第一优先的依据已成文（06:37-43「最高优先级」+ 战斗表现:73「一屏样张是硬前置」+ 看板 ⬜ 现状），不复议；剩余 = 关卡/菜单/营地三屏：**甲 · 本批仅战斗屏**，余三屏 06 立排队行；**乙 · 战斗＋营地**（营地是全作最暖屏、贴图债最重，Q1 裁乙案时此组合依赖最重）；**丙 · 四屏全本批**（按 v1.1 重算估时 ≈8.5–11d，超 7d 软盒，按 T4 拆分点强制拆两批）。**次序连带（v1.1 补，与 §7.5 D2 同读）**：关卡屏已有立闸前的 v1 冻结样张（P10），若排在本批之后且其 L2/L3 换色/重产落地，本批冻结的明度三档带与观感密度读数即作废须重跑——四屏的先后不是纯排期题，是作废范围题 **〔已裁：甲——2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕）〕裁定案：本批仅战斗屏；关卡/菜单/营地三屏登记 06 排队条的动作列入同步面，写入文档时点=批次出口（T5/§8）。理由：单批 5–6d 在迭代盒内跑透一屏一闸，胜过四屏平摊超盒。关卡屏已有 v1 冻结样张（P10）事实保留为注记；乙/丙案及其作废范围连带段仅存档不执行** |
|
||||
| **Q3** | **渲染手段选型**：样张怎么画出来？（用户已质疑 Godot shader 做特效的能力边界——选项、影响、代价列全，已裁见右栏） | **甲 · 纯代码绘制（PIL，现行管线）**：零新依赖、A1–A6 断言体系现成；已知上限 = v1 四否决原因全部产自该路线，氛围类效果（光带/泛光/呼吸感）只能静态模拟。**乙 · Godot 引擎实拍 + shader**：样张=引擎真实渲染（截屏管线先例 **`game/smoke/shot_probe.gd`＋`tools/shot_checker.py`**——v1.0 误写为 `tools/shot_probe.gd`，已按实存路径订正；`tools/render_gate.sh` ①段即为该通路），发光/抖动/去饱和与实机逐位一致，氛围层两派并存（§7.6(三) L465）可在实拍层直接看出统一效果；代价 = 全仓 shader 仅 desaturation.gdshader 一枚先例（P9 实测），发光类特效能力边界未验证，须先半天试验件坐实「能不能」再谈「好不好」，且实机依赖动画与光照时序、静态定格取样工序需新建（shot_probe 现按「真实按钮信号路径驱动＋双帧抓视口纹理」出帧，无「目标构图」概念——它出的是现状图，样张要的是目标图，这层差距即本案的真实成本）。**丙 · 新素材合成**（贴图批/远程生图件入样张画布）：质感上限最高；代价 = 即 Q1 乙案语义，本选项在 Q1 裁甲/丙时不可用。**丁 · 混合**（底板引擎实拍 + 标注层脚本，或方向稿用甲精制版换乙）：灵活；代价 = 两套管线双份维护与断言口径分岔。〔氛围层两派统一（平滑 vs 抖动）随本案一并裁：选了乙，两派差异在实拍图上直接可见，裁决成本最低〕 **〔已裁：乙为主、预设甲案退路——2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕）〕裁定案：Godot 引擎实拍＋shader 为目标路线；开工先半天试验件坐实发光类特效能力——试验件不过闸即退甲案纯代码管线重出。理由：目标图须与实机渲染同语系，而退路预裁定已写入本栏，失败面不再回炉问用户（留痕即可，见 §6 L2）。连带：氛围层两派统一结论在实拍图上呈报、落 T3 裁决记录；丙案即 Q1 乙案语义，随 Q1 裁丙不可用；估时已按本案重算（§3）** |
|
||||
| **Q4** | **字重与拉丁专件是否入样张前提**：06:29-35「UI 字体补完」条载明现行单字重、层级只能靠字号档差一个手段（art-bible §7.4 L434 字重纪律定的口径是**字号档差〔相邻层级 ≥1.25×〕＋墨色深浅＋字重两档**三件齐用）——样张用现行单字重出，还是先补字重再出？ | 甲 · 现行单字重出样张：零前置；风险 = 样张冻结的层级观感建立在缺一个手段的基座上，字重补齐后层级重排可能追改样张；**另一处连带读数**：§1.4/§7.2 的大字档判据写作「≥18px **或加粗档**」，现行单字重下「加粗档」这一腿在实机上不存在（FS_TITLE 24/FS_H1 34 只吃字号档，§7.4 L432 六档），故本案直接决定整屏①项能不能按原文全判。乙 · 字体补完先行：样张一次到位；代价 = 又添一条串行前置（字体条本身含「补不补拉丁专件、上不上第二字重」未裁点——该未裁点归字体条 06:33，本 Q 只裁先后次序，禁在本卡代裁）。丙 · 样张按「目标字重效果」示意出图（方向稿级），字体批按样张补真件（即 Q1 丙案语义在字体面的特化） **〔已裁：丙——2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕）〕裁定案：样张按「目标字重效果」示意出图，字体补完批按样张补真件——即 Q1 丙案语义在字体面的特化，两案口径一致。理由：样张即目标图口径下层级观感不必建在缺手段的基座上，且零串行前置。「补不补拉丁专件、上不上第二字重」仍归字体条自身裁点（06:33），本卡不代裁；甲/乙案文字仅存档** |
|
||||
| **Q5** | **旧样张死指涉处置**（06:609-615 在册 P0①，本 Q5 已裁，处置落 T0）：art-bible **L68 与 L562**（06 原文写「68/527 行」，527 行现为 §9.1 参考表——**行号读数已过期，T0 连 06 该行一并订正**）与看板 L13 仍引用磁盘已不在盘的 `sample-batch-v3-final-2026-09-30.png`；同系列 v0/v2/v31/v32/v33/v34/v35-draft 在盘。 | 甲 · 死指涉改指在盘最近稿并加注「冻结原件失管，指代稿」；乙 · 判过期——旧引用随本批整屏样张冻结记录一并换代重写；丙 · 随本批重跑后新产物自然替代（不做单独修复动作）。〔登记纪律注：art-bible §8.3 L500 归档纪律本就规定主文档禁引用 artwork/ 散文件路径——无论何案，新冻结记录按「描述性出处」写，不再挂散路径；**同条 P0②（主角棋盘小人未走像素管线，重产未在册）属 06 同条另一未裁事项，本卡禁把 P0② 一并吃掉**〕 **〔已裁：甲——2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕）〕裁定案：art-bible 68/562 行与看板 13 行三处死指涉改指在盘最近稿 v31/v32/v33-draft 之一并注「指代稿」，具体指哪份由 T0 实查盘面后定；新冻结记录按 §8.3 描述性出处纪律。理由：指代稿保留判定物演进链可追溯，优于判过期换代重写。P0② 与本裁分离，仍归 06 条；乙/丙案文字仅存档** |
|
||||
| **Q6** | **双口径断言集合体方式**：整屏四项（art-bible §1.4 L64）与战斗屏专项五项（[战斗表现](../gdd/systems/战斗循环/战斗表现.md):85-93）合并为一张断言集一次判定，还是两闸分跑（先专项后整屏，各自回退语义不同——专项第 5 项只产裁决记录不产过/不过，:93 已成文）？ | 甲 · 并集单闸：一次出图一次判定，报告最简；乙 · 两闸分跑：与两文档各自 owner 语义对齐，回退定位更准；代价 = 双份跑批记录。**注（v1.1）：本案只裁「两套既有口径怎么合体」，不重裁两套口径本身的内容——四项与五项均是既有条款。** 另附裁：敌层插入位置裁决义务是否随本样张一并清偿（战斗表现:75 登记「随美术测试一并裁决，不在本文提前定」——该义务本就挂在本样张上，本 Q 只裁清偿时点，不裁是否要做） **〔已裁：乙——2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕）〕裁定案：整屏四项与战斗表现专项五项两闸分跑，各自回退语义独立；专项第 5 项（敌层插入位置对照组可裁）只产裁决记录、不产过/不过。理由：两口径各有 owner 文档，分闸回退定位更准。敌层绘制优先级插入位置「随本样张一并清偿」的原句保留（战斗表现:75），清偿点=T3；甲案文字仅存档** |
|
||||
|
||||
**开工门（v1.2 改实）**：Q1–Q6 已全部裁决（2026-10-16 用户令：三卡全部待裁项按推荐方案裁决〔用户将裁权授出，由主线会话代拍板留痕〕；v1.1 检索结论——六项当时均未被既有条款裁过、且关闭三处隐性重问（①「微光五组色相是否重冻」归 §0.6/徽章卡 Q2，②「1920 档／帧数规格／资产升档」随闸三裁决已闭，③「敌层插入位置要不要裁」已登记为样张义务）——保留为本次裁决的对表依据）。U0 剩余条件 = 用户 `/iter` 发令。Q3 已裁乙为主：半天试验件置于 T1 最前作前闸，试验件不过闸即按 §7 预设退路退甲案，**不再回炉请裁**（v1.1 原文「复核亦归用户裁」随退路预裁定关闭）。T0 事实坐实段（含 Q5 指代稿的实查拍板）凭本卡即可先行（零路线依赖）。**排期状态**：本卡已编入迭代 30（2026-10-16 用户令，[roadmap](../../roadmap.md) 同步在批）；迭代 29 自身 U0 未解（roadmap.md:88），「迭代 29 完成后开工」仍不构成排期承诺（见 §0）。
|
||||
|
||||
### 7.5 跨卡依赖（v1.1 新增——三卡次序耦合；v1.2 改实：三卡已编入迭代 30，串行序位已随 2026-10-16 用户令裁定＝徽章→样张→观感，禁各自假设对方状态）
|
||||
|
||||
| # | 耦合点 | 谁的前提 | 次序与理由 |
|
||||
|---|---|---|---|
|
||||
| D1 | **类型微光色值与明度档的冻结口径** | [徽章卡](需求卡片-未开格类型徽章批-2026-10-16.md) Q2 与其 S6 行 | **已改实（2026-10-16 用户令：三卡全部待裁项按推荐方案裁决〔用户将裁权授出，由主线会话代拍板留痕〕——徽章卡 Q2 已裁甲案：明度档取 provisional 值）**：「徽章卡 Q2 先裁」义务随其裁定关闭；**其复核转正义务落本卡样张冻结件**——本卡 T2 新增 H5 组间明度档复核＋组间互辨抽测、T3 呈转正结论、写入完成定义第 2 条交付义务（见 §1/§3）。事实核对保留为对表依据：五组**色相**确已随样张 v2 定稿（art-bible §4.2 L218「样张 v2 定稿(2026-09-28)」＋HUD框架:140 同记——「样张 v2 已冻结」与 08「战斗一屏样张=待做」并不矛盾：前者是**格子样张**序列（§1.4 L66/L68），后者是**整屏样张**序列（§1.4 L64），两条序列各有其闸），本卡不承接色相重冻义务；「徽章卡若裁乙（等本卡总闸）」分支不再发生。**本卡禁把色相值列进 Q 项**（已按契约 6 关闭） |
|
||||
| D2 | **棋盘瓦片重产 vs 换色**（素材线同一入口） | [二三关棋盘观感卡](需求卡片-二三关棋盘观感批-2026-10-16.md) Q2（甲 recolor 换色 / 乙 远程生图重产） | **已改实（2026-10-16 用户令）**：序位裁定＝徽章→样张→观感、本卡位第 2——观感卡排本卡之后，「同窗呈报两案代价」义务关闭；该卡 L2/L3 落地对本卡整屏②明度三档带与 A6 观感密度读数的复核，属该卡开工时按其 V2（A6 ≥4.70 保持）自跑的复验项，本卡冻结记录注明本样张基线读数供其对表即可；本卡 Q1 已裁丙案（非乙案），与其 Q2 各案不再有工期串行耦合 |
|
||||
| D3 | **触碰面重叠与合入次序** | 三张卡共同 | 三卡都写 06／08／07／art-bible 版本历史／roadmap／active.md，徽章卡另动 `presentation/views`＋冒烟，本卡另动 `tools/` 样张面。按 roadmap.md:93「单迭代串行」与 roadmap.md:101「一迭代 = 一次合并登记」⇒ 三卡禁止三线并行。**已改实（2026-10-16 用户令）：三卡串行序位＝徽章→样张→观感，本卡位第 2**；「一次合并、批内分波」组织方式随序位裁定确定，v1.1「不预设结论、归用户排期令」呈报框架关闭 |
|
||||
| D4 | **门禁语义改动的先后** | 迭代 29 测试分层与门禁语义修正批 | 该批改的就是 `tools/run_all_gates.sh`／探针判定／退出码权威语义（其契约 2「三硬闸不可绕过」），本卡 V7 的闸口径完全依赖该语义；**该批先行则本卡按其当期读数重采基线**（同其卡片 v1.3 串行裁决口径）；若用户令本卡先行，本卡 V7 只按其当期闸表跑、不改写任何判定脚本 |
|
||||
| D5 | **08 表现表同一表的多行改写** | 三卡＋08 v1.6 定稿纪律 | 08 头注 L5 明文「Alpha 内容范围冻结，增删条目须经用户裁决」——三卡都只有**改状态列**的权限，**无一行可新增/删除**；本卡 T5 回写仅动「战斗一屏样张」一行，若需要为新条目动集合，一律 L3 呈报 |
|
||||
|
||||
|
||||
---
|
||||
|
||||
## 8. 关联文档同步面
|
||||
|
||||
| 文档 | 关联点 | 同步义务 |
|
||||
|---|---|---|
|
||||
| [art-bible.md](../art/art-bible.md) §1.4 | 新增**整屏样张冻结记录段**（编号口径见 T5 代拍注记——格子序列已用 v2/v3、关卡屏自成一列，禁两处各叫各的）；段内随附**目标规格清单（Q1 已裁丙案：尺寸档/色板/明度档逐件成文）＋徽章明度档复核转正记录（H5/§7.5 D1）**两件交付物；§7.6(三) 氛围层并存条改写为已裁决口径（经 T3 实拍图记录，Q3 乙案）；§0.5 H1–H11 逐项处置写进该段；死指涉三处按 Q5 甲案改指「指代稿」（T0） | **权威文档 · 仅 T3 过闸后写入**（契约 5） |
|
||||
| [art-status-checklist.md](../art/art-status-checklist.md) | 战斗一屏样张行 ⬜→✅；:14 指针旧锚 §5.1 订正；余屏行按 Q2 刷新 | 机械面 · 过闸后 |
|
||||
| [06-待办清单.md](../gdd/06-待办清单.md) | 战斗一屏样张条（:37-43）注销（去向登记当批状态记录）＋:41 归属栏旧锚订正＋:39「尺子还没造出来」措辞按 P1 读数订正；**关卡/菜单/营地三屏新立排队行（Q2 已裁甲案之本批交付义务，写入文档时点=批次出口）**；P0① 死指涉条（:609-615）按 **Q5 已裁甲案**处置（改指指代稿并注）＋该行「68/527」行号读数订正 | 机械面 · 顺带更新 |
|
||||
| [08-Alpha版本标准.md](../gdd/08-Alpha版本标准.md) | 「五 · 表现」战斗一屏样张行（:158）待做→在役（过闸后）；完成定义边界条款注记（样张过闸 ≠ 占位素材全体转正）。**禁动项**：头注 :5 已定稿、增删条目须用户裁；「七 · 未决项」:208-210 三行（站桩帧动画/素材升档/立绘回退）本批一律不改 | 机械面 · 过闸后 |
|
||||
| [战斗表现.md](../gdd/systems/战斗循环/战斗表现.md) | 敌层插入位置裁决记录登记（Q6 附带，:75/:93 既有义务）；「一屏样张的验收标准」节（:79-93）状态刷新；**:83/:116「四区」旧措辞订正为三区 B/C/D** | **权威文档 · 随裁决写入** |
|
||||
| [character-design.md](../art/character-design.md) | **Q1 已裁丙案**：样张反提的立绘/小人规格（目标规格清单）回写其档位节；H4（§5.3 护甲三档视觉区分）与 H9（钩爪恐魔宽≥高豁免）处置登记 | 视裁决 · 随冻结记录 |
|
||||
| [HUD框架.md](../gdd/systems/表现与支撑/HUD框架.md) | **D1 已改实（徽章卡 Q2 裁甲案）**：本卡承接微光组间明度档复核转正/互辨抽测（H5）义务，按其「唯一事实源」纪律回报结论，定义与口径零复述 | 条件同步 · 义务已成立 |
|
||||
| `tools/shot_checker.py`／`tools/render_sample_sheet_v3.py`／`game/smoke/shot_probe.gd` | 取样点位与断言扩面（T2）；**闸件集合本身不改**（增减只走 `tools/run_all_gates.sh`，CLAUDE.md:19/56 纪律）；样张脚本仍不入常设闸表 | 工程面 · 批内更新 |
|
||||
| [roadmap.md](../../roadmap.md) | 迭代 30 行编入笔已发（2026-10-16 用户令，同步在批）；批内状态刷新 | 机械面 · 同步在批 |
|
||||
| active.md | 状态快照与批次记录 | 机械面 · 顺带更新 |
|
||||
| [07-体验验证清单.md](../gdd/07-体验验证清单.md) | T3 目检轮次与后续实机目检衔接项登记（**现行 07 无样张类条目，实查 2026-10-16 零命中——本批为首次登记，属新增条目须走 07 自身纪律**） | 机械面 · 顺带登记 |
|
||||
|
||||
---
|
||||
|
||||
## 9. grilling 审查记录（v1.1，2026-10-16，对抗审查员；逐攻击面给结论／证据／处置）
|
||||
|
||||
**审查方法**：卡片每一处引用逐一开文件核行号与措辞；Q1–Q6 逐条全库检索既有条款与裁决（design/gdd/06、08 及其版本历史、design/art/art-bible.md、character-design.md、art-status-checklist.md、systems/战斗循环/战斗表现.md、systems/表现与支撑/HUD框架.md、ux/battle.md、design/research/playnote.md、roadmap.md、active 侧状态记录残留、`tools/` 与 `game/` 实码、git 只读历史）；与迭代 30 另两张并行卡逐 Q 比对互斥面。**只编辑本卡，未动任何其他文件；git 仅只读查询。**
|
||||
|
||||
### G1 事实引用核实（攻击面 1）
|
||||
|
||||
| 引用 | 核实结论 | 证据 | v1.1 处置 |
|
||||
|---|---|---|---|
|
||||
| art-bible §1.4 整屏样张闸 | **真** | §1.4 L64 全文（四屏／四项／闸形方向稿先行／执行时机＝屏级视觉落码开工前） | 保留并补 L64 行号 |
|
||||
| art-bible §7.1 占位完成条款 | **真** | §7.1 L411 | 完成定义 3 原写「08 §7.1 指路」**错**（08 无 §7.1），已改指 art-bible §7.1 L411 ＋ 08:158 行 |
|
||||
| art-bible §7.4 字重三件口径 | **真** | §7.4 L434（字号档差 ≥1.25×＋墨色深浅＋字重两档）、L432 六档表 | 保留，补 L434；并新增连带读数：「加粗档」在单字重下不存在，直接决定整屏①项可判面（Q4） |
|
||||
| v3 脚本 A1–A6 | **半真** | 头注 L21-26 确有 A1–A6；**A2 拼缝周界闭合被 v1.0 漏列**；A1 实义=色板对表冻结值＋禁入带（L928-930），**不是 48 色计数**；A4 含尺寸基线硬等（L1029-1031）；L23「Δ≥55」与 L1157「std ≥50.9」是旧文本（现行定值 A3b Δ≥30，L35 与圣经 L68） | V3 与 T2 逐名义重写，48 色单列为新建项 |
|
||||
| 「v1 四否决原因」 | **v1.0 只列两条编号，漏 ②④** | 脚本 L1156-1160 映射表：①显示太丑→A6；②封印色冲突→封印黑（A1a）；③立体感→A3/F6/F7；④微光格只留微光→F5c；头注 L12-26 仅标 ①③ | P6 补全四条＋标注权威表位置；V5 底表指到 L1156-1160 |
|
||||
| 08 当前行状态 | **真** | 08:158「战斗一屏样张=待做」；:156 UI 贴图重构批待做；:157 UI 字体补完待做；:146 立绘清晰度回退待裁；:154 素材升档待裁；§7 未决项 :208-210 | 保留；「站桩帧动画」原被本卡写作「Beta/后批事项」**定性失实**（实为 08 未决项第 5 行待裁），已订正并入「不做」禁代裁清单 |
|
||||
| 看板 13 行／§5.1 旧锚 | **真，但 v1.0 漏了 06:41 同型旧锚** | art-status-checklist:14；06:41 | P3 补记；T0 订正面扩为两处 |
|
||||
| 死指涉行号 | **v1.0 沿用 06:611 的过期读数** | 06:611 写「68/527」；art-bible grep 实测指涉在 **L68 与 L562**，L527 现为 §9.1 参考表 | P4／Q5 改为 68/562，并把 06:611 自身列入 T0 订正面 |
|
||||
| 2026-10-06 playnote 引文 | **原文被压缩改写** | playnote.md:9 逐字：「现在的立绘太丑了，像素化的粒度太低了，导致根本看不清立绘；看是否可以改回用较为高清的图片?」；日期出处=06:465-471「同日 playnote 立绘批评」 | P7 改逐字引＋注明文件本身无日期 |
|
||||
|
||||
### G2 「v2 已冻结／样张批冻结候选值／08 待做」三者是否矛盾（攻击面 2）
|
||||
|
||||
**结论：不矛盾，v1.0 与并行徽章卡都需把两条序列分开。**
|
||||
- 格子样张序列：v2 冻结（2026-09-28，圣经 §1.4 L66，四冻结含②色板）→ v3.0 解冻①④ → **v3 重冻生效（2026-09-30，L68，机检 17/17）**；类型微光五组**色相**属②色板面，§4.2 L218 明文「样张 v2 定稿(2026-09-28)」，HUD框架:140 同记「五组色相经样张 v2 冻结」——**冻结为真实现状**。
|
||||
- 整屏样张序列：条款 2026-09-29 v3.0 才立（L64），**从未出过一张整屏样张判定物，四屏冻结记录零条**——08:158「待做」与看板 ⬜ 因此为真。
|
||||
- 「候选值，样张批冻结」的出处是 06:431 里 **2026-09-22 那次更新的历史文本**，滞后于 v2/v3 两次冻结；06:431 同时**明文保留**「样张批组间互辨抽测义务」，且**组间明度档值从未定义**——这才是真挂在样张批上的东西。
|
||||
- **v1.1 处置**：①新增 §0.6 关闭「重裁色相」的可能；②新增 §0.5 H5 承接互辨抽测与明度档；③新增 §7.5 D1 写明徽章卡 Q2 与本卡的先后与理由。
|
||||
- **另两处状态读数订正（本攻击面的真发现）**：(a) 整屏四项的**机检代码已存在并跑过实机渲染帧**——shot_checker.py 头注自述「整屏样张闸机检（迭代 9 卡⑤/T8 2026-09-30）」，git 053baeee 记「实测 PASS（WCAG 5.79-13.14／三档 204>79>55／骨架四屏过）」，现挂 render_gate.sh ①段周期跑；**③焦点预算 E 段明文「无法机检→人闸」**。v1.0 的「四项从未作为断言集执行」「只存在于条款文字、无对应代码」「本批=该闸首次执行」三句按此改写为「判定物与冻结记录从未出、③从未判」。(b) 新增 P11：§1.4 的执行时机（屏级落码开工前）已被迭代 9/16/25/26 四轮落码越过、Alpha 已于 2026-10-03 到手，§7.1「占位禁止跨里程碑」事实上已被跨——本批定性=**闸后补跑**，冻结语义随之注明，禁写成事前定方向。(c) 新增 P10：关卡屏已有立闸前的 v1 冻结样张（2026-09-28，11/11，产物在盘），Q2/T4/估时三处按「补判四项」而非从零改写。
|
||||
|
||||
### G3 「全仓 shader 仅一枚先例」（攻击面 3）
|
||||
|
||||
**结论：真。** `find -name *.gdshader` 全仓命中 1 件（`game/presentation/views/desaturation.gdshader`）；`ShaderMaterial` 消费面仅 `board_view.gd`（:111 声明／:170-172 创建／:194 参数 tween），`.tscn` 内无 shader 节点；样张与机检面全为 PIL 代码绘制。**处置**：P9 补实测细节；Q3 乙案的「能力边界未验证」措辞保留，另补 shot_probe 出的是「现状图」不是「目标图」这一真实成本（防把「实拍管线已有」误读为「样张管线已有」）。
|
||||
|
||||
### G4 Q1 三案依赖链与「混合粒度」（攻击面 4）
|
||||
|
||||
- 「UI 贴图重构批」= 06:21-27 待办（Alpha 需完成）＋08:156 待做 → **v1.0 读数真**。
|
||||
- 「资产升档重产批」= **不是未裁**：06:465-471 载明已裁案乙（2026-09-30 迭代 9 三裁决）＋2026-10-04 令暂不做（重启=用户点名）＋2026-10-06 优先级再降，且 v3.0「档位上调方向候选」已被 v3.7 八敌逐键定档实质完成；08:154/§7 第 6 行的「待裁」只问**进不进 Alpha**。v1.0 把它与「立绘清晰度回退评估」并列为「两个未裁闸口」**不准确** → Q1 乙案改写为「一已裁挂起＋一真未裁」，并补 A4 尺寸基线须显式解冻重校的连带硬账（圣经 L68）。
|
||||
- 「立绘清晰度回退评估」= 08:146 待裁＋§7 第 7 行真未裁 → **v1.0 读数真**。
|
||||
- 「三案可混合」的粒度：全库无既裁边界（样张序列只做整屏闸，从未有文档规定四屏可用不同素材级别），**故保留为请裁项**，不属再问已裁。
|
||||
- **处置**：Q1 文字改写；新增契约 6/7；「不做」新增禁代裁 08 未决项三条。
|
||||
|
||||
### G5 估时 4–7d 的构成依据（攻击面 5）
|
||||
|
||||
**结论：v1.0 无出处且加总错误。** T4 自述「逐屏 1.5–2d × 三屏」= 4.5–6d，却把 T4 上限定为 3d；六卡相加实为下限 4d／上限 11d。**处置**：T4 上限改 0–6d，合计改「≈4–11d（单跑战斗屏 4–5d，四屏全推超盒拆两批）」，并补先例出处：迭代 9 T8 整屏机检建造＝3–4h（`.zcode/plans/m3-iter9-loop-plan-2026-09-30.md:65`，故 T2 走复用不重建）、迭代 9 批 A T1 样张机检冻结＝2–3h（同计划书:58）、迭代 13 4.8–5.3d／迭代 16 6.9d／迭代 26 2–2.5d／迭代 29 5.5–7d（roadmap.md:63/:68/:85/:88），周期上限口径=「迭代周期 ≈ 一周左右」（2026-10-11 用户裁，roadmap.md:101）。
|
||||
|
||||
### G6 与另两张并行卡的互斥面（攻击面 6）
|
||||
|
||||
**结论：存在三处「一张卡裁了另一张卡前提」的次序耦合，v1.0 完全未写。** 已新增 §7.5 D1–D5：D1 徽章卡 Q2（色值冻结口径）须先于本卡（它决定本卡是否继承色相重冻义务——核查结论：不继承，但继承 H5 明度档与互辨抽测）；D2 棋盘观感卡 Q2（重产 vs 换色）与本卡 Q1 指同一条素材线、且其落地会使本卡冻结的明度带/密度读数作废（**双向作废关系，须同窗呈报**）；D3 三卡共写 06/08/07/art-bible/roadmap/active ⇒ 单迭代串行纪律下禁三线并行；D4 迭代 29 改的正是本卡 V7 依赖的门禁语义；D5 08 定稿纪律下三卡都只有改状态列权限、无增删条目权限。
|
||||
|
||||
### G7 验收 V 条可执行性（攻击面 7）
|
||||
|
||||
逐条对 `tools/` 实存脚本核：**V1 无工具**（方向稿留痕不可机检）→ 从「机检化」降级为件核；**V2 ①②④ = shot_checker B/C/D（＋F）**，但 B 段只判 meta 登记的已知文字框、C 段只有战斗屏三点 → 标「须先扩取样点位」，**③焦点 = 人闸**（E 段明文）；**V3 = 样张脚本机检段复用扩展＋48 色新建**（全仓无 48 色工具，grep 零命中）；**V4 五项中第 1 项可借既有断言、第 2 项须新建、第 3/4/5 项目检**；**V7 原写「跑 doc 三闸＋熵增对基线」违反 CLAUDE.md:19/56「run_all_gates.sh 是唯一闸入口与唯一闸清单，文档禁另列清单」** → 改为指路该脚本，并声明本批零闸件增删。附带核实：`game/smoke/shot_probe.gd`、`tools/golden_compare.py`、`tools/golden_baseline_refresh.sh`、`tools/repo_structure_audit.py`、`tools/doc_link_audit.py` 均实存（07 无样张条目为实查所得，已注明本批首登）。
|
||||
|
||||
### G8 红线自检：卡片有没有替用户拍板（攻击面 8）
|
||||
|
||||
- **发现两处预设**：①目标句把尺子写成「§1.4 ＋ 战斗表现五项的**并集**断言集」，完成定义第 1 条同样预设并集——而合体方式正是 Q6 未裁项 → 改为「两套口径的合体方式归 Q6 裁决（本卡不预设并集或分闸）」。②完成定义第 2 条写死「新增 **v4** 冻结记录段」——v4 这一编号预设了「整屏续用格子序列编号」，而关卡屏已自成一列（「样张 v1」）→ 改为「编号口径属批内代拍，在冻结记录一次说清」。
|
||||
- **一处定性失实而非拍板**：「站桩帧动画」被写成 Beta/后批事项（实为 08 待裁）→ 已改，并列入「不做」的禁代裁清单。
|
||||
- **审过判为保留（不属代拍）**：防线三「本批不申请验收豁免」= 本批自我从严的执行纪律，非改动用户裁决；Q2「战斗屏第一优先不复议」= 引用既成文依据（06:37-43／战斗表现:73）；§0.5 各 H 项与 §7.5 只呈代价与次序、不给推荐案；Q1–Q6 全条无推荐语（历批「推荐案被推翻」纪律维持）。
|
||||
- 本批 Q 项清单净变动（v1.1 记录；**六项已全部经 2026-10-16 用户令裁定，见 §7，本节当时呈报的六项全保留口径现为裁决对表依据**）：**Q1–Q6 六项全保留**（无一被既有条款裁过，逐条检索见 §0.6 与本节 G2/G4），另关闭本卡内三处隐性重问（色相重冻／随闸三裁决／敌层义务存废），依据已写入开工门。
|
||||
- 词面规范扫描：v1.1 全文按本次审查指定的十项废止词逐一扫描，初稿命中五处（否定副词一项四处、完成动词一项一处）已全部换代，复扫零命中。
|
||||
|
||||
### G9 审查中判定为「本卡无权处置、已登记呈报」的文档面
|
||||
|
||||
`tools/render_sample_sheet_v3.py` 头注 L23/L1157 旧口径残留文本；06:39「尺子还没造出来」与 shot_checker 现状有差；06:41／checklist:14 的 §5.1 旧锚；06:611 行号读数（68/527 应为 68/562）；**art-bible §8.2 L490 指路 m3-iter9-t8-rulings 文件已在 8e02dcf0 删除（死指涉第二例，属 Q5 同族，处置口径与 Q5 同案在本批一并呈报）**；战斗表现:83/:116「四区」旧措辞；art-bible 头注 L3 仍写「现行为 v3.11」而版本历史已到 v3.14。**以上均为他文件文本，本审查一律未改**，只作为本批 T0 订正面对表登记；其中头注版本号与他文档措辞是否订正，归各文档自身纪律与用户裁决。
|
||||
@@ -0,0 +1,295 @@
|
||||
# 需求卡片：未开格类型徽章批（类型微光实施）——迭代 30
|
||||
|
||||
- 版本：v1.2（2026-10-16 裁决五项+排期定档——「2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕）」：Q1 丙／Q2 甲／Q3 甲／Q4 丙／Q5 甲，逐条留痕见 §10 各 Q 裁定行；排期定档迭代 30 已编入）；v1.1（2026-10-16 成文；同日 grilling 对抗性审查修订——事实五处复核／Q2 缩窄为明度档裁点（五组色相属已裁项不再问）／全部推荐语中立化／轮次承诺与性能预判撤下／验证闸判具补全／跨卡次序依赖单列——修订清单见 §11 审查记录）
|
||||
- 来源：[06-待办清单](../gdd/06-待办清单.md)「未开格类型徽章呈现时机」条（:429-435；裁决史三段：2026-09-22 T1 采纳彩色常显微光并重选五组色相／2026-09-30 口径校正＝英雄周围 8 格内／2026-10-07 组粒度简化＝组间五色相、组内不细分，art-bible v3.12）
|
||||
- 归属：呈现层升级批（06 归属行口径：[地图战斗资源](../gdd/systems/战斗循环/地图战斗资源.md)类型提案实施批与 [HUD框架](../gdd/systems/表现与支撑/HUD框架.md) 共裁）；概念权威定义 = [HUD框架](../gdd/systems/表现与支撑/HUD框架.md)「未开格类型微光」节（:130-142，本文只指路不复述）
|
||||
- 排期：**迭代 30 已编入**（2026-10-16 用户令，roadmap 同步在批）；三卡串行序位第 1（徽章→样张→观感，禁并行依据=汇聚文件冲突）。开工门 = U0：用户 `/iter` 发令（Q1–Q5 已于 v1.2 全裁，见 §10）。
|
||||
- 用户立场前提（正面回应，不回避）：用户对既有程序化产出明确不满（「很丑」「原有方式再产一遍可能还是不满意」），并专门质疑「你是否会用 Godot 的 shader 做特效」。据此本卡把**渲染技术路线列为第一裁点 Q1**，各案的天花板与代价摊开对比；v1.2 依「2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕）」裁定**丙案**（shader 为主、程序绘制兜底）。对 shader 能力边界**如实交底**（见 Q1 能力行）——canvas_item shader 代码写得出来，视觉调优必须走目检迭代，无法一次到位，故 T0 内置「路线原型先行」步骤，先出一帧给用户看再全线推进。
|
||||
|
||||
---
|
||||
|
||||
## 0. 前置依赖与并行性
|
||||
|
||||
- **设计面已闭合**：概念定义（HUD框架权威节）、五组色相（art-bible §4.2，样张 v2 四冻结②既裁入库——见 F3/S6，本卡不再问）、呈现约束（§4.6.3 与 §1.4 验收 2）、信息口径（只类型、不泄雷/安、不表极性）全部成文；[地图战斗资源](../gdd/systems/战斗循环/地图战斗资源.md) v0.17 类型层身份裁决已把「微光实施归呈现批」写定（:12/:205）。**本批无设计定稿前置，是纯实施卡**——Q1（路线＝丙）/Q2（明度档值来源＝甲——五组色相已冻结不入裁）/Q3（收编＝甲·不并入）/Q4（开关＝丙）/Q5（动效＝甲·静态）五点已于 v1.2 依「2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕）」全部裁定，逐条见 §10。
|
||||
- **数据链已在位**（零 core 层新接口）：装板摇号后 `query_identity(cell)` 返回 `{reward_id, cell_type, tier}`（`game/core/reward_economy.gd:109`），组合根已把该只读回调注入棋盘（`board_view.set_identity_resolver`，`game/presentation/views/board_view.gd:206-208`）；生效格集合 = `_diggable`（英雄 8 向相邻未开格，`board_view.gd:102`——与 HUD 框架「与可挖域同一圈」逐字同圈）。
|
||||
- **并行面**：与在役的接触带微光（`board_view.gd:838-875`）、视野迷雾（`board_view.gd:137` FOG_RADIUS=8）触碰同一 `board_cell_unit.gd` `_draw` 面——两役件契约零改动是红线（§3 契约 6）。微光环（切比雪夫 1 邻，曼哈顿距离 ≤2）恒在灯光区（曼哈顿 ≤8）内，**与迷雾零遮挡冲突**（区外未开格全黑不渲染条款触不到本批作用格；art-bible §6.5）。
|
||||
- **前置卡片关系**：与 [需求卡片-测试分层与门禁语义修正批-2026-10-15](需求卡片-测试分层与门禁语义修正批-2026-10-15.md)（迭代 29）无文件冲突面预判（那批动测试基建/闸判定，本批动 presentation/views 与 game/smoke 断言新增）；若 iter29 先行完成合入，本批 T0-④ 按其契约以当期读数重采基线。
|
||||
|
||||
---
|
||||
|
||||
## 1. 目标与完成定义
|
||||
|
||||
**目标**：把已定稿未实装的「未开格类型微光」落进游戏——英雄周围 8 格内的未开格，在格面显示该格资源类型的组粒度微光（通用增益芥末黄／治疗黄绿／穿刺青／魔法紫罗兰／群伤绯红，art-bible §4.2 五组），纯呈现层、零玩法数据写入；渲染技术路线按 Q1 既裁丙案（shader 为主、程序绘制兜底）实施，效果以「玩家一眼分清五组且不伤数字可读性」为唯一及格线。
|
||||
|
||||
**实施规格闭合清单**（T0 逐项确认，缺一即开工不成立）：
|
||||
|
||||
| # | 规格项 | 现行口径 | 出处 | 闭合状态 |
|
||||
|---|---|---|---|---|
|
||||
| S1 | 生效范围 | 英雄周围 8 格内未开格；已开格不显示；封锁格恒无 | HUD框架 :136 | 已成文 |
|
||||
| S2 | 分组粒度 | 九型 → 五组，组间分、组内不细分（attack/defense/weaken/action/gp 同芥末黄） | art-bible §4.2 :218；06 :435 v3.12 | 已成文，**代码侧无归组表**（见 F6） |
|
||||
| S3 | 生命周期 | 入圈亮／出圈灭／开格灭／换图重置；身份装板期摇定、微光只显示不改数据 | HUD框架 :138 | 已成文 |
|
||||
| S4 | 信息禁令 | 只类型；不表极性、不泄雷/安、不泄收益档位 | HUD框架 :137 | 已成文 |
|
||||
| S5 | 泛光参数 | 内缘带状泛光 α170／带宽 cell÷8（v2 呈现参数） | art-bible §4.2 :218 | 已成文；**组间明度档值从未定义**——色弱通道「各组一档明度互辨」（§1.4 验收 2 :58、§4.5 第 9 项 :248）只有方向没有数值（v3.12 版本历史 :551 自证「逐型明度映射从未定义」），数值来源与冻结路径 = Q2 裁点（v1.2 已裁甲案：本批取 provisional 值、样张批复核转正） |
|
||||
| S6 | 色值冻结态 | **五组色相 = 既裁项**：样张 v2 四冻结②色板「类型微光五组定稿」（art-bible :66，2026-09-28，闸形 A 批末用户目检拍板 2026-09-27）；v3.0 批「四冻结之②③维持冻结不变」（:563）；v3.12 用户裁「五组色相本身不动（样张 v2 冻结维持）」（:551）。06 :431「候选值，样张批冻结」系该条状态叙述中的滞后复述——06 :431 本身 2026-09-30 校正注已声明「本条此后只承载实施状态、不再承载定义」，措辞修正属批内机械面不入裁（2026-10-16 用户令后按 Q2 甲案于批内机械修正入同步面）；**本案裁点只剩明度档值**（无值可冻，v2 未承诺数值）——v1.2 已裁甲案 | art-bible :66/:218/:551/:563；06 :431；HUD框架 :140 | **色相=既裁；明度档值=已裁（Q2 甲案：provisional 取值、样张批复核转正）** |
|
||||
|
||||
**完成定义**：
|
||||
1. S1–S6 全闭合；Q1–Q5 裁决落进代码与文档。
|
||||
2. 呈现上线（Q4 已裁丙案：默认开入库）：五组微光在真机战斗屏可见，目检人闸过审（07 登记条）。
|
||||
3. 机检全绿：冒烟新增断言段（微光集合正确性 + 零玩法写入 + off 态基线逐位一致）+ `run_all` 全套 + `probe --click/--full` + `render_gate.sh` 全段绿，golden 棋盘基线在默认态的漂移判读完成（判据见 §7）。
|
||||
4. 文档改写面（§5）全部到位：06 条目状态改写为完成、HUD框架 :140 实装状态行改「已实装」+:269 验收行转正式验收、08 表现表行按 Q2 甲案改写（新增行并注 provisional 待样张复核）、art-bible §2.1 修订条目不追加（Q5 已裁甲案静态，该分支不触发）。
|
||||
5. 反哺点列明待裁（若有），不擅落。
|
||||
|
||||
---
|
||||
|
||||
## 2. 现状事实（2026-10-16 实查；开工日 T0-④ 复核行号）
|
||||
|
||||
| # | 事实 | 出处 |
|
||||
|---|---|---|
|
||||
| F1 | 06 条目状态 = 待办（Alpha 阶段需完成，2026-10-13 归「UI 美化三层诊断」第三层观感提升）；:435 明写「本条（格面未开格类型徽章）与卡顶色带同族不同落点，**不并入**（迭代 16 批）」 | `design/gdd/06-待办清单.md:429-435` |
|
||||
| F2 | 权威定义节五要素齐备；实装状态行原文：「呈现契约已定稿（五组色相经样张 v2 冻结 2026-09-28）；**游戏内待实施批**（2026-09-30 核证：呈现层仅接触带微光在跑，类型微光无独立实现）」；配套拍板「类型微光不随视野扩大（仍贴身 8 格）」（2026-10-09 提灯退役后由阔视野带承接，微光仍不扩） | `design/gdd/systems/表现与支撑/HUD框架.md:130-142/:167/:269` |
|
||||
| F3 | 五组色相值：芥末黄 `#D6C13A`／黄绿 `#5CB83A`／青 `#2E9E9E`／紫罗兰 `#7B5BD6`／绯红 `#FF2D55`（后两值避 300°–345° 禁入带、绯红刻意错开危险红）；v2 呈现参数 α170/带宽 cell÷8；§4.6.3 呈现约束 = 微光单通道、格内零角嵌/箭头/加号附加形（2026-09-28 用户裁）；§1.4 验收 2：微光禁止侵入数字字形占位区、明度梯度禁止压破格底明度档、三态分类不受扰；§2 明度分层：微光明度梯度属信息面层内梯度、不扰世界层明度档；§1.2：微光 = 底效泛光层、**不入遮挡栈、不遮任何元素、不作焦点** | `design/art/art-bible.md:218/:325/:58/:76/:25` |
|
||||
| F4 | 类型判定数据链：九型封闭枚举（attack/defense/heal/blast/weaken/pierce/magic/action/gp）；`reward.tres` 各行带 `cell_type` 字段（:9-:195）；`query_identity` 未开格恒可查（雷安同权）；**kind→五组归组的权威文本表只存在于 art-bible §4.2 条文里，代码与数据侧无机读表**——九值闭合的归组函数需新建 | `地图战斗资源.md:22/:73-79`；`game/data/tables/reward.tres`；`game/README.md:476` |
|
||||
| F5 | 渲染通道现状：格子 = 每格一个 `CellUnit`（Node2D/CanvasItem），`_draw()` 内 `draw_texture_rect`（瓦片素材）/`draw_rect`/`draw_style_box`（程序化回退）+ 接触带微光同面绘制；呼吸 = `BoardView._process` 正弦（0.48Hz，:846 注 3 rad/s）改 `contact_col` 后 `queue_redraw`。**全库唯一 shader 先例**：结算去饱和 `_desat_mat`（CanvasItem shader `desaturation.gdshader`，挂在世界根 CanvasItem 整体，`board_view.gd:111/:170-172/:196`）——每格尚无独立 ShaderMaterial。grilling 复核（2026-10-16）：全仓 `*.gdshader` 仅一枚、`ShaderMaterial` 引用面仅 board_view.gd 单点、`shader_type` 仅 desaturation 一处命中——「唯一先例」成立 | `board_cell_unit.gd:124-199`；`board_view.gd:838-875` |
|
||||
| F6 | `TG_*` 常量现况：迭代 16 N4c（2026-10-06，提交 af5f317a）已立五族常量与 `tg_band()` 子串归带（常量实存 `ui_kit.gd:51-55`、判定函数 :60-69、E5 回滚注 :58-59），消费面 = 卡顶色带（`curio_pick_overlay.gd:101`／`shop_overlay_view.gd:216`）。**06 :435 所指「`bonus_pick_overlay.gd:96-102`/`shop_overlay_view.gd:189` 裸 Color8」是 2026-10-05 旧读数——该文件已不存（git 8e2694de 奇物批改名 curio_pick_overlay，Glob 复核零命中），呈现层裸 Color8 现值为 0（ui_kit 之外），守卫 = ui_contrast_probe 静态段（:107-130，R1 白名单机制在、现零消费）。grilling 复核（2026-10-16）口径声明：`Color8(` grep 限定 `game/presentation/` 目录 = 104 处全在 ui_kit.gd；`game/smoke/` 另有 5 处（smoke_all 2 + ui_contrast_probe 3）属测试面不在呈现层守卫域。TG_BUFF=Color8(194,178,100) 逐值核 = #C2B264 无误。附带发现：`curio_pick_overlay.gd:101` 行注仍写「aoe/blast 归 TG_AOE」——与 ui_kit.gd:65 现行行为（blast 归 TG_MAGIC）不符的滞注——Q3 已裁甲案（不并入），该滞注记 L1 卫生面处置）。卡带与格面微光是**两套色值两套归组**：卡带用 demo 冻结值（如 `TG_BUFF #C2B264`）且 E5 回滚把 blast 子串归 TG_MAGIC，圣经典故五组用 `#D6C13A` 系且 blast 应归群伤组绯红——**不可直接复用 tg_band 作格面归组** | `ui_kit.gd:49-69`；`presentation` 全目录 grep `Color8(` 计数 = 104 处且全在 ui_kit.gd |
|
||||
| F7 | 动效纪律在位：art-bible §2.1「挖掘期棋盘唯一体感在动的是接触带呼吸微光」（:84/:170）；类型微光若做呼吸态即破该条——**静态是缺省合规态，呼吸是需裁决的修订面**（Q5） | `design/art/art-bible.md:84/:170` |
|
||||
| F8 | 机检工具链可承接本批：`tools/shot_checker.py`（A 屏级骨架/B 文字 WCAG ≥4.5:1/C 明度三档带/D 文字禁压纹理/F 文字在判据，坐标源 shot_meta.json 禁硬编码像素）；`tools/golden_compare.py`（灰度差 >16 像素占比 ≤2% 判据）；`tools/render_gate.sh` 四段（shot_probe 七屏→shot_checker；fx/board_shot_probe L1-L3 抓帧取证；golden 棋盘区裁剪对比；1280 单档）——明度档/禁侵入类断言一律走**截图像素判读**，与本批禁整格染色、不遮数字的验收同型 | 三脚本头注（2026-10-16 实读） |
|
||||
| F9 | roadmap「迭代 30+」= 位空·无批次（原 M4 数值批已废，禁止再引用）；编入本批 = 用户发令——**v1.2 更新：2026-10-16 用户令已编入（roadmap 同步在批）** | `roadmap.md:88-89` |
|
||||
| F10 | 08-Alpha版本标准「五 · 表现」表现表无「未开格类型微光」独立行（棋盘观感/UI 贴图重构/战斗一屏样张等行在表）——本批完成后按 Q2 甲案新增行并注 provisional（见 §5），06 :429 条为登记事实源 | `design/gdd/08-Alpha版本标准.md:139-160` |
|
||||
|
||||
---
|
||||
|
||||
## 3. 设计契约（红线，违反 = L3 停机呈报）
|
||||
|
||||
🔴 **契约 1 · 纯呈现层零玩法写入**：微光只读身份不改身份；同板同动作序列的结算结果与微光 on/off 两态逐位一致（迷雾批先例同款断言）。
|
||||
🔴 **契约 2 · 信息口径零越线**：微光承载且仅承载组粒度类型；禁止表达极性、雷/安、收益档位（HUD框架权威节 :137）。
|
||||
🔴 **契约 3 · 数字可读性硬指标零破坏**：1–8 全档对格底 ≥4.5:1 恒成立；微光禁止侵入数字字形占位区（未开格砖心留白纪律同型）；明度梯度禁止压破格底明度档——三态灰度分类不受扰（art-bible §1.4 验收 1/2）。
|
||||
🔴 **契约 4 · F5 呈现纪律**：接触带泛光（内缘带），**禁止整格均匀染色**；微光层为底效泛光，不入遮挡栈、不遮任何元素、不作第二焦点；格内禁止新增角嵌/箭头/加号类附加图形（2026-09-28 用户裁，§4.6.3）。
|
||||
🔴 **契约 5 · 色值零自决**：五组色相恒按 art-bible §4.2 样张 v2 冻结值取值（既裁项，本批无重开资格，翻动=L3）；明度档值只许取 Q2 裁定的来源；禁止实施中自调色值「看着更好」。
|
||||
🔴 **契约 6 · 在役件契约零破坏**：接触带微光、视野迷雾、去饱和 shader、`_diggable`/`query_identity` 回调契约、既有冒烟/探针断言面只增不减。
|
||||
🔴 **契约 7 · 频闪与减动效**：任何态每秒闪烁 ≤3 次（可访问性基线）；本批 Q5 已裁甲案静态、呼吸态不启用——若出口后追加裁决重议呼吸，减动效开启必须停格（接触带先例 `board_view.gd:844-845`）。
|
||||
|
||||
---
|
||||
|
||||
## 4. 范围边界
|
||||
|
||||
**做**：路线裁决执行（Q1 已裁丙案）、归组机读表与五族色值常量新建、CellUnit 微光绘制面/shader 叠加实施、生命周期接线（入圈/出圈/开格/换图）、开关与灰度（Q4 已裁丙案）、机检断言新增（冒烟 + render_gate 段扩）、文档改写面（§5）、Q2 甲案下的 06 滞后措辞修正（批内机械面）。
|
||||
**Q3 已裁甲案（不并入）**：TG_* 两带统一迁移（原 T3 条件卡）不启动；「卡顶带与格面带分工」说明写入文档并另登 06 一条的动作列入本批同步面清单（§5），写入时点=批次出口。
|
||||
|
||||
**不做**（明示去向）：
|
||||
- **不做样张正式冻结动作**——冻结归样张线（08「战斗一屏样张」行）；本批只按 Q2 甲案取 provisional 值实施、复核移交样张卡（见跨卡依赖 v1.2 注记）。
|
||||
- **不动卡顶色带视觉**——Q3 已裁甲案（不并入）；两带统一归批次出口另登的 06 新条。
|
||||
- **不做探宝罗盘/预读道具重定**——归秘宝内容批（06 :431 裁决③）。
|
||||
- **不动格底明度档、棋盘瓦片素材、图类型换皮四槽**（art-bible §4.3 不变槽含类型微光五组——换皮不触发微光变色，棋盘生成 board_type 词表零触碰）。
|
||||
- **不扩微光环半径**——贴身 8 格是已拍板口径（HUD框架 :167），阔视野带类道具一律不扩微光。
|
||||
|
||||
---
|
||||
|
||||
## 5. 关联文档同步面
|
||||
|
||||
| 文档 | 关联点（本批改变其哪条陈述） | 同步义务 |
|
||||
|---|---|---|
|
||||
| `design/gdd/06-待办清单.md` | :429-435 条目状态：待办 → 完成（目检人闸过审后注销）；:431「候选值，样张批冻结」色相措辞修正 = 批内机械面（五组色相既有冻结依据 art-bible :66/:551，Q2 甲案裁定确认按此路径修正）；:435 旧读数（bonus_pick_overlay 位点）刷新亦属机械面；明度档登记去向按 Q2 甲案（provisional 值入 art-bible 修订条目、复核义务移交样张卡） | **机械面·批内更新** |
|
||||
| `design/gdd/systems/表现与支撑/HUD框架.md` | :140 实装状态行「游戏内待实施批」→「已实装（本批）」；:269 验收行去「待实施批落地后验收」括注转正式验收；版本历史追加一行 | **反哺·批内写入** |
|
||||
| `design/gdd/08-Alpha版本标准.md` | 「五 · 表现」表：新增「未开格类型微光」行（待做→在役）——**写法按 Q2 甲案**：行内注「明度档 provisional 值，样张批复核转正」；版本历史追加 | **机械面·批内更新** |
|
||||
| `design/art/art-bible.md` | §4.2/§4.6.3 **零改动**（权威面）；§2.1 修订条目**不追加**（Q5 已裁甲案静态，条件分支不触发）；明度档 provisional 值按 Q2 甲案以修订条目登记 | **登记面·批内写入（Q2 项）** |
|
||||
| `roadmap.md` | 迭代 30 行编入+状态更新（2026-10-16 用户令编入，roadmap 同步在批） | **机械面·本批更新** |
|
||||
| `design/gdd/06-待办清单.md`（Q3 甲案追加动作） | 批次出口时：①「卡顶带与格面带分工」说明写入文档（art-bible/HUD框架 注记面）；②另登 06 一条「卡顶色带与格面微光两带统一」新待办 | **机械面·批次出口写入** |
|
||||
| `active.md` | 状态快照与本批条目 | **机械面·本批更新** |
|
||||
| `design/gdd/07-体验验证清单.md` | 新增实机目检人闸条（五组互辨观感/不遮数字/出圈灭） | **机械面·批内更新** |
|
||||
| `game/presentation/views/*`、`game/smoke/*` | 代码与断言（见 §6） | 实施本体 |
|
||||
|
||||
---
|
||||
|
||||
## 6. 任务卡
|
||||
|
||||
> 估时按工作日口径；每卡出口自跑轻闸，批末全闸绿才合入；开工日 T0-④ 复核本卡全部行号。
|
||||
|
||||
### T0 证据坐实、规格闭合与路线原型（≈1–1.5d，必先做；Q1 丙案下 shader 原型帧+共存实测为新增先行件，估时上限相应上调）
|
||||
|
||||
- **T0-① 归组表新建落点确认**：写定九 cell_type → 五组封闭表（通用增益 {attack, defense, weaken, action, gp}／治疗 {heal}／穿刺 {pierce}／魔法 {magic}／群伤 {blast}——art-bible §4.2 成员集合逐字照抄，禁止子串匹配复用 `tg_band`）；大宝箱（未来第十型）按地图战斗资源 :106 归通用增益组、不新增色相。
|
||||
- **T0-② 明度档 provisional 值设计**：五组各一档明度（色弱互辨通道，S5 缺口）取值方案——以 §4.1 硬指标（未开格底 L≥0.30 档不被压破）为约束给出候选梯度，按 Q2 已裁甲案执法（本批定 provisional 值、样张批复核转正）。
|
||||
- **T0-③ 路线原型先行（对「很丑」质疑的实证步骤）**：**按 Q1 已裁丙案执行——「shader 接触带柔光原型帧」为本件先行产出物**：CellUnit 共享 ShaderMaterial 距离场柔光渐变原型帧（微光 on/off + 五组并列 + 相邻格泛光接触），同时给出 shader 参数面板（uniform 暴露带宽/α/衰减形状），后续调优可直接改参数表不改代码；程序绘制（a 案）兜底件同帧出对比，供 §8 L3 回退判据留样。交用户目检——**目检不过不过夜**：效果不满意即在原型阶段调参或回 Q1 复议，禁止未过原型就全线铺码。能力申报保留：视觉调优走「出帧→目检→改参」迭代直至用户过目，不承诺轮数。
|
||||
- **T0-④ 基线与行号复核**：本卡 §2 全部出处复核一遍；冒烟/golden 当期读数冻结为改前锚（golden 基线 2026-09-30 代，若判失效按 iter29 卡先例呈报，禁擅自重制）。
|
||||
|
||||
### T1 实施主卡（≈1–1.5d，内容按 Q1 丙／Q3 甲／Q4 丙 既裁案收敛）
|
||||
|
||||
- **色值与归组单点**：`ui_kit.gd` 新增五族泛光常量（拟名 `TG_GLOW_*`，命名归代拍板）+ `glow_group_for_cell_type(type)` 九值闭合函数（清单外值返回错误并显式占位「?」——图标键错误处理同款纪律，禁静默空光）。
|
||||
- **shader 面**（Q1 丙案主路径）：CellUnit 挂共享 ShaderMaterial（每格 uniform：色相/α/带宽/呼吸相位——相位通道仅预留，Q5 已裁甲案静态不启用），canvas_item 距离衰减柔光渐变；与 `_desat_mat` 共存方案（世界整体 vs 每格材质叠加次序）实测验证后进断言。
|
||||
- **绘制面**（Q1 丙案兜底路径，仅当共存/性能实测撞墙按 §8 L3 回退时启用）：`board_cell_unit.gd` `_draw()` 瓦片之下/泛光档新增微光泛光层——内缘带状（带宽 cell÷8 起、provisional 可调），砖心留白（数字字形占位区禁入），`draw_rect`/`draw_circle` 参数化半透叠层；叠层序遵守 §1.2「底效不入遮挡栈」。断言面两案通用。
|
||||
- **生命周期接线**（Q1 两案共用）：微光作用集 = `_diggable` ∩ 身份可查格；`refresh()` 与英雄移动路径挂点重算；开格/连锁开/踩雷随格态灭；出圈灭、复亮走回；换图随 rebuild 清零；结算相位灭（与 `set_dig_glow_enabled` 同款相位门控，Q4 细则）。封锁格恒无（不在摇号清单 ⇒ query 为 null，天然惰性，仍进断言）。
|
||||
- **开关**（Q4 丙案）：呈现态布尔入 `board_view`（探针/夹具/调试浮窗可显式 off），生产写入面组合根单点，不新增设置项。
|
||||
|
||||
### T2 机检断言批（≈1d）
|
||||
|
||||
- **冒烟（数据侧）**：新段断言——微光格集合恒等于 `_diggable` 中身份可查者；九 cell_type 全值域归组五组封闭；封锁格/已开格零微光；**同板同序列 on/off 两态结算逐位一致**（契约 1，MC 触发细则内以探针级断言承载，不新起跑批）。
|
||||
- **静态段**：ui_contrast_probe 静态段守卫延续——新增色值一律入 ui_kit 单点，呈现层裸 Color8 保持 0。
|
||||
- **渲染闸（像素侧）**：`render_gate.sh` 取证段扩——board_shot_probe 夹具板加微光 on/off 双帧：①on 帧逐格取样判定「非生效格像素零变化」（禁整格染色/禁越圈）；②微光格砖心区（数字字形占位区等效域）灰度差 ≤阈值；③五组两两灰度带互辨抽检（shot_checker 同型 WCAG/灰度工具复用）；④off 帧对 golden 基线 ≤2% 带（**Q4 丙案默认 on**，golden 棋盘三基线判读呈报——预期漂移在生效格集合内，超出即红）。
|
||||
- **全闸**：批末冒烟 + run_all + probe --click/--full + render_gate + 文档三闸（doc_link_audit/gdd_lint/doc_term_audit）零新增红。
|
||||
|
||||
### T3（条件卡·Q3 已裁甲案不并入——本卡不启动，内容留档）TG_* 两带统一迁移（≈0.5d）
|
||||
|
||||
卡顶色带取值改圣经五组值、归组输入改 cell_type 精确值、E5 回滚注记清偿（curio_pick/shop 消费面视觉回归 + 相关对比度对断言刷新）。**影响面**：三选一与商店货架观感变化 + 既有断言改写（触碰「只增不减」契约须按 §8 L3 先呈报）。
|
||||
|
||||
### T4 目检与出口（≈0.5d）
|
||||
|
||||
实机目检人闸（07 登记条：五组一眼可分/不遮数字/出圈灭/整屏不脏）；§5 文档改写面全落；出口报告。
|
||||
|
||||
---
|
||||
|
||||
## 7. 验证闸（逐需求点验收清单）
|
||||
|
||||
| # | 需求点 | 测什么 | 手段（实存工具 + 新建判具标注） |
|
||||
|---|---|---|---|
|
||||
| V1 | 生效范围 S1 | 微光格集合 == `_diggable` ∩ 有身份；已开/封锁/出圈零微光 | `tools/run_smoke.py` 承载 `game/smoke/smoke_all.gd` 新增数据断言段（判具现成，断言新建） |
|
||||
| V2 | 组粒度 S2 | 九值 → 五组封闭、组内不分色；清单外值返回错误 + 诊断 | 同上冒烟归组表断言（判具现成） |
|
||||
| V3 | 生命周期 S3 | 移动复亮/开格灭/换图灭/结算相位灭 | `tools/run_smoke.py` + `game/smoke/ui_input_probe.gd`（实存）走查段扩 |
|
||||
| V4 | 禁侵与不遮（F5/契约 3/4） | 砖心留白区灰度扰动 ≤阈值；数字 ≥4.5:1 复核零降档；格内零附加图形 | `tools/render_gate.sh` 取证段扩（`game/smoke/board_shot_probe.tscn` L1-L3 实存，双帧断言 = T2 新建）+ `tools/shot_checker.py`；注：「微光格零墨色附加像素」先例 = 样张侧机检（art-bible v2.12 版本历史 :569），格面像素版断言本批新建 |
|
||||
| V5 | 明度档不压破 | 三态灰度分类抽检（on/off 两帧灰度逐格分类结果一致）；shot_checker C 明度三档带零破坏 | `tools/shot_checker.py` C 段实存；「两帧逐格分类一致」取样段 = T2 新建判具（依托 board_shot_probe 双帧） |
|
||||
| V6 | 五组互辨 | 组间色相 + 明度双码在去色相模拟下仍可分组（误读率指标归样张线，本批只跑机检抽检） | 去色相抽检脚本 = T2 新建段（沿 `tools/shot_checker.py` 的 PIL 取样同型，挂 render_gate 取证段）；**判不稳时降级**：目检辅助 + 出口报告登记缺口，误读率终判恒归样张批（§4.6.3 :325 既裁） |
|
||||
| V7 | 零玩法扰动 | on/off 两态结算逐位一致；off 态 golden 零漂移 | `tools/run_smoke.py`（逐位一致断言，迷雾批先例同款）+ `tools/golden_compare.py`（render_gate 第三段实存，`game/tests/golden/` 三基线，差 ≤16/占比 ≤2% 带） |
|
||||
| V8 | 频闪/减动效 | 呼吸态 ≤3 次/秒且减动效停格（原「仅 Q5 乙」预案条款） | 冒烟相位断言（频率由 `_process` 参数直查，`board_view.gd:846` 先例）+ `UiKit.motion_scale` 停格路径断言（:844-845 先例同款）+ 目检；**Q5 已裁甲案（静态），本案空转**（无呼吸态；若出口后追加裁决重议呼吸再启用本判据） |
|
||||
| V9 | 文档面 | 06/08/HUD框架/roadmap 改写到位；链接闸零死链；废止词零命中 | `tools/doc_link_audit.py` / `tools/gdd_lint.py` / `tools/doc_term_audit.py`（三闸实存，经 `tools/run_all_gates.sh` 闸段跑批） |
|
||||
| V10 | 目检人闸 | 用户实机看过并点头（「很丑」质疑的终审位） | 07 新增条（人闸不可代） |
|
||||
|
||||
**目检与机检两分**：V1–V7 机检自动化（其中 V4/V5/V6 的断言段为 T2 新建——工具管线实存、判定件新建，开工前不存在「直接可用」假象）；V8 半机检；V10 唯一人闸不可代。T0-③ 原型帧是目检第一道，批末 V10 是第二道。
|
||||
|
||||
---
|
||||
|
||||
## 8. 异常分级
|
||||
|
||||
- **L1（自救）**：断言写法、取样坐标源选择、内部命名、注释补漏。
|
||||
- **L2（记录继续）**：明度档 provisional 值微差（在 Q2/Q3 裁定域内）、泛光分段绘制的具体参数写法（Q1 裁定域内）、夹具板构造细节。
|
||||
- **L3（停机呈报）**：偏离 Q1–Q5 既裁案（丙/甲/甲/丙/甲，v1.2）或未经追加裁决重开裁点先动；目检原型帧用户不认可（本卡不承诺调参轮次上限——每轮交付后是否续调由用户判；若用户或实施判为路线级存疑，停线回 Q1 复议）；shader 与 `_desat_mat` 共存实测冲突；golden 基线判失效；on/off 两态结算出现任一位差（契约 1 破）；色弱抽检判五组灰度不可分（S5 值域重裁）；T3 触发既有断言改写；实施中任何翻动 art-bible §4.2 五组色相既裁冻结面的诉求（Q2 复核结论）。
|
||||
|
||||
---
|
||||
|
||||
## 9. 代拍板白名单（超清单必呈报）
|
||||
|
||||
1. 新常量与函数命名、文件落点（ui_kit vs 新建泛光单点件）。
|
||||
2. 泛光实现细节：draw_rect 分段叠层 vs `draw_polygon` 渐变近似的取舍（Q1 裁一域内）。
|
||||
3. shader uniform 命名与参数表组织（Q1 裁二域内）。
|
||||
4. 呼吸相位驱动写法（Timer vs `_process` 累积，沿接触带先例）。
|
||||
5. 冒烟/探针断言的具体取值与夹具板配置。
|
||||
6. 取样阈值 provisional 数值（砖心扰动带/灰度抽检带）——首版取严，出口报告登记。
|
||||
7. 提交切分与 worktree 分支命名。
|
||||
|
||||
（Q1–Q5 本体**不在**白名单——2026-10-16 用户令裁权授出、由主线会话代拍板留痕完成裁决，五项裁定见 §10，本批不再开放重裁。）
|
||||
|
||||
---
|
||||
|
||||
## 10. 裁点（v1.2：Q1–Q5 全部已裁）
|
||||
|
||||
> **裁决来源（统一措辞·代拍板追认单形态，逐条留痕）**：「2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕）」。五项裁定：Q1 丙／Q2 甲／Q3 甲／Q4 丙／Q5 甲。各 Q 选项原文保留备查，裁定行附后。
|
||||
|
||||
### Q1 · 渲染技术路线（第一裁点；v1.2 已裁＝丙）
|
||||
|
||||
**a) 既有 CanvasItem 通道内程序绘制（渐变参数化泛光，零新依赖）**
|
||||
- 效果上限：**中**。半透矩形/圆叠加近似柔光，α170/带宽 cell÷8 可直落；无内建模糊图元，光晕「柔」有天花板——存在「又是程序化、还是不满意」的复发风险（用户既有不满正源于此类平色产出）。
|
||||
- 性能代价：**低（通道先例外推，非实测）**。与接触带同通道同预算；静态态每帧零成本，呼吸态 ≤8 格逐帧重绘（现接触带 1 格在跑）——量级估算以 T0-③ 原型帧实测读数（帧耗时）为准，卡片不承诺帧时数字。
|
||||
- 圣经 F5 符合度：**良**。带宽/α/留白区皆可参数守死；但渐变细腻度受限，「接触带微光不整格染色」靠人工叠层纪律维持。
|
||||
- 机检可行性：**优**。现状同型，像素断言直接可用。
|
||||
- 能力边界：**可一次到位**（几何与参数都在代码里，调参即所得）。
|
||||
|
||||
**b) shader_material（每格 CanvasItem shader：接触带柔光渐变/可选呼吸态）**
|
||||
- 效果上限：**高**。距离场平滑衰减、柔光晕、渐变边缘一步到位，是「不像程序化平色」的正解；呼吸态天然平滑。
|
||||
- 性能代价：**未实测 = T0-③ 实测义务项，本卡不预判档位**。理论面 = ≤8 格激活、共享材质+uniform；但每格 ShaderMaterial 实例化成本、首帧着色器编译微抖与预热效果、与全世界 `_desat_mat` 双层 canvas_item shader 共存的叠加次序（全库先例仅单层，2026-10-16 grilling 全仓复核坐实：`*.gdshader` 仅 desaturation 一枚、`ShaderMaterial` 引用面仅 board_view 单点）——均无本仓实测值，原型阶段逐件记录（帧耗时/编译耗时/共存帧比对）随原型帧一并交用户，实测数字不进裁前依据。
|
||||
- 圣经 F5 符合度：**最高**。带宽/α/衰减形状全在 shader 参数域，砖心留白可用距离阈值硬保证；渲染参数即文档参数（α170/cell÷8 一一对应）。
|
||||
- 机检可行性：**良**。验收面在截图像素侧（工具链已具备），代码侧新增「材质参数表」可读断言；shader 内部逻辑不可直接单测，判定权交给像素闸。
|
||||
- 能力边界（**如实交底——义务申报，不承诺轮数**）：Godot 4 的 `shader_type canvas_item` 代码我可以写；**视觉调优我无法一次到位**——渐变曲线、柔和度属主观审美，必须走「出帧→用户目检→改参→再出帧」迭代直至用户过目；本卡**不预设迭代轮次**（一轮即过或多轮皆以用户每轮判定为准），T0-③ 原型帧 + uniform 参数表是为压低每轮成本而设。
|
||||
|
||||
| 案 | 一句话 |
|
||||
|---|---|
|
||||
| **甲 = 纯 a** | 零新依赖最稳，但效果天花板可能重蹈「不满意」 |
|
||||
| **乙 = 纯 b** | 效果上限最高，接受目检迭代节奏（轮数不设承诺，逐轮由用户判定去留） |
|
||||
| **丙 = b 为主、a 兜底** | shader 过闸走 b；若共存/性能实测撞墙（§8 L3）回退 a，断言面两案通用 |
|
||||
|
||||
（v1.1 历史陈文备查：本卡当时不出推荐案——路线无既有裁决可引：全库 shader 先例仅一枚是现状事实而非路线裁定；用户「你是否会用 shader 做特效」的质疑抬升 b 的关注优先级，不构成路线拍板；原拟 T0-③ 两路线各出一帧对比原型再裁。）
|
||||
|
||||
**裁定（v1.2·已裁）＝丙**（b 为主、a 兜底）。裁决来源：「2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕）」。一句理由：丙案取 shader 效果上限之高为主路径，同时保留共存/性能实测撞墙（§8 L3）时回退程序绘制的既定退路，断言面两案通用、进可推退可守。任务面同步：T0-③ 已增「shader 接触带柔光原型帧」先行件（兜底案对比帧同帧留样）；能力申报保留——视觉调优必须走「出帧→目检→改参」迭代直至用户过目，不承诺轮数。
|
||||
|
||||
### Q2 · 明度档值来源与样张线联动（五组色相已冻结，非本案裁点；v1.2 已裁＝甲）
|
||||
|
||||
**复核结论（先立事实）**：五组色相 = 既裁项，本卡不再问——art-bible §1.4 样张 v2 记录（:66，2026-09-28）「四冻结②色板：小人蓝 #2E86DE／接触带微光 #D6ECFF／**类型微光五组定稿**（§4.1/§4.2）」，机检 16/16、气质终审 = 批末用户目检（闸形 A 2026-09-27 拍板）；v3.0 批注「四冻结之②③（色板/动画）维持冻结不变」（:563）；v3.12 用户裁（2026-10-07）明写「**五组色相本身不动（样张 v2 冻结维持）**」（:551）；HUD框架 :140 同读数。06 :431「候选值，样张批冻结」= 该条状态叙述里的滞后复述，且 06 :431 自身的 2026-09-30 口径校正已声明「本条此后只承载实施状态、不再承载定义」——措辞修正属 §5 批内机械面，不进裁。
|
||||
**真未决面**：§4.2「各组一档明度互辨」的**档值**从未定义（v3.12 自证 :551「逐型明度映射从未定义」）；§4.6.3（:325）与 06 :431 裁决④把「微光组间互辨抽测（含明度档互辨；误读率指标出处=《地图战斗资源》极性提案）」保留在样张线，而 08 :158 战斗一屏样张 = 待做。色相已裁、明度无值，本批绕不开（色相+明度双码是 2026-09-28 角嵌退役批既裁通道）。
|
||||
- **甲** = 本批定明度档 provisional 值：T0-② 以 §4.1 硬指标（未开格底 L≥0.30 档不被压破，:205）为约束出五档候选梯度，按 art-bible 修订条目登记；组间互辨抽测本批跑像素抽检预判（V6），误读率终判仍归样张批复核。影响 = 本批自成闭环、样张批为下游复核方。
|
||||
- **乙** = 明度档值归战斗一屏样张批先冻结再实施：本批只落色相单通道、明度双码待样张冻结后补。影响 = 过渡期呈现偏离 §1.4 验收 2 双码条款与 §4.5 第 9 项色弱主通道条款（均 2026-09-28 既裁），偏离时长随样张批排期；且与本批「目检一眼分清五组」及格线正面冲突（无明度档时色弱玩家通道缺失）。
|
||||
- **丙** = 同甲取值实施，但微光默认关，待样张过闸后转正（挂在 Q4 开关案上）。影响 = 验收读数保护最彻底，玩家侧功能延后生效。
|
||||
（v1.1 历史陈文备查：本卡当时不出推荐案——既有裁决只锁色相与双码方向，档值归属无先例裁决可引。）
|
||||
|
||||
**裁定（v1.2·已裁）＝甲**（本批取 provisional 值、样张批复核转正）。裁决来源：「2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕）」——06 :431「候选值」措辞滞后按批内机械修正入同步面（§5 已列）。一句理由：甲案让本批自成闭环（T0-② provisional 梯度 + V6 像素抽检预判），复核义务移交样张批有既成承接面，乙案的色弱双码通道缺失与本批「一眼分清五组」及格线正面冲突、且串行放大风险（见跨卡次序依赖），丙案默认关又与 Q4 既裁丙案（默认开）相抵。
|
||||
|
||||
**若实施中用户翻色相**：触 art-bible §4.2 既裁冻结面，按 §8 L3 停机呈报，本批无预授权。
|
||||
|
||||
**跨卡次序依赖（与 [需求卡片-战斗一屏样张批-2026-10-16](需求卡片-战斗一屏样张批-2026-10-16.md) 前提耦合，单列备查）**：
|
||||
- 样张卡 Q1（素材输入级别）裁**甲**（纯占位资产合成）或**丙**（样张=设计目标图）→ 样张线不前置阻塞本批：色板②既冻结（v3.0「维持冻结不变」条款），本批按 §4.2 现值执法成立；本批 Q2 若裁甲，样张 v4 冻结记录须加注复核本批明度档 provisional 值。
|
||||
- 样张卡 Q1 裁**乙**（等贴图重构批/素材终稿出件）→ 样张冻结以周计后移：本批 Q2 裁甲/丙时明度档已定，样张批仍是下游复核方、零阻塞；本批 Q2 裁乙时则串行放大——样张批顺延直接改期本批完工，此风险即 Q2-乙案的固有代价，裁乙前须与样张卡 Q1 结果对表。
|
||||
- 样张批先冻结且明度档值与本批 provisional 值不一致 → 以 art-bible 修订条目为终，本批走 ui_kit 色值单点改值 + 冒烟色值断言同步（机械面，不构成路线翻案）。
|
||||
- 样张卡终审若主张**色相**重定（其 Q1 丙案「样张反提规格」语义扩至微光带）→ 触 art-bible §4.2 既裁面 = 本批 §8 L3，两卡口径冲突呈报回炉，禁止各自解释。
|
||||
- **v1.2 裁定生效注记**：本卡 Q2 已裁甲案（2026-10-16 用户令代拍板留痕），明度档 provisional 值的**复核义务移交样张卡**（由其 Q1/Q3 产物承接复核）——上列各条中「本批 Q2 若裁甲/乙/丙」等假设语气自此失效，仅按甲案联动路径执行。
|
||||
|
||||
### Q3 · TG_* 收编是否并入本批（v1.2 已裁＝甲·不并入）
|
||||
|
||||
现况比 06 :435 登记前进了一步（F6）：裸 Color8 已清零、TG_* 常量已立，**残留问题变成「两套色带两套归组并存」**——卡顶带（demo 值 + tg_band 子串、blast 归魔法带）vs 圣经典故格面带（#D6C13A 系 + cell_type 精确、blast 归群伤绯红）。原裁决 =「同族不同落点、不并入」（2026-10-05 注）。
|
||||
- **甲** = 维持不并入：本批只新建格面五族单点，两带并存、分工在 art-bible/HUD 注记成文；卡顶带统一另登 06。
|
||||
- **乙** = 并入本批：格面 + 卡顶一次归一（取值圣经五组、归组 cell_type 精确），T3 全量迁移 + 观感回归（触既有断言改写，L3 先呈报）。
|
||||
- **丙** = 并入但只统一归组函数、不改卡顶色值（最小合并）。
|
||||
（v1.1 历史陈文备查：本卡当时不出推荐案。）复核补注两条：① 2026-10-05 注「不并入本批」= 迭代 16 批的范围记录（未并入**该批**），非跨批禁裁裁决——本 Q 为新增裁点、不构成再问；② 两套并存证据位点（2026-10-16 逐文件核实）——`ui_kit.gd:51-55` 五族常量（TG_BUFF=Color8(194,178,100)=#C2B264，demo 冻结值）、`:60-69` tg_band 子串归带（:65 blast→TG_MAGIC，:58-59 E5 回滚注）、`curio_pick_overlay.gd:101` 与 `shop_overlay_view.gd:216` 两消费点；格面侧 #D6C13A 系（art-bible :218）与 cell_type 精确归组在代码侧零实存（F4/F6）。06 :435 文本含 2026-10-05 旧读数（bonus_pick_overlay 裸 Color8 位点已不存在），无论甲乙丙均须批内刷新该段（机械面）。
|
||||
|
||||
**裁定（v1.2·已裁）＝甲**（不并入本批）。裁决来源：「2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕）」——「是否翻 2026-10-05 口径」即本案所裁：甲案与原文径一致，口径不翻。一句理由：本批只新建格面五族单点、不触在役卡顶带的既有断言改写面（免 T3 的 L3 先呈报负担），两带分工以成文+另登 06 承接统一路径。执行落点：「卡顶带与格面带分工」说明写入文档并另登 06 一条的动作已列入本批同步面清单（§5），**写入时点=批次出口**；curio_pick_overlay.gd:101 滞注按甲案记 L1 卫生面处置（见 F6）；T3 条件卡不启动。
|
||||
|
||||
### Q4 · 开关与实施窗口口径（v1.2 已裁＝丙）
|
||||
|
||||
06 :431 裁决⑥原文：实施窗口 = 表现层升级批，「切片期默认不开、保护验收读数基线」。该句写于 2026-09-22，其保护对象（验收读数基线）现由 off 态逐位一致断言 + golden 双帧承接（T2），本批为迭代 30 正式实施批。**切片期前提现行性复核（grilling 2026-10-16）**：roadmap 执行记录 2026-09-24「垂直切片转正（prototypes/ → game/）」（:16）、2026-09-28「M-1 切片表现阶段完结」（:20）——「切片期」为已闭合的历史阶段；该「默认不开」条款无明文作废痕迹，但其前提（护切片验收读数）已随阶段终结而消失，条款可否随阶段过期解除 = 本 Q 的实质裁点（非再问已裁：原裁决只约束切片期）。
|
||||
- **甲** = **默认开**：游戏内恒可见（这是设计意图「玩家能针对护甲类型规划开格」的兑现前提）；探针/夹具显式 off 态；off 态基线逐位一致进冒烟硬断言；若 Q2 裁甲，无需再留「样张前默认关」状态。
|
||||
- **乙** = 默认关 + 设置面板开关：保护读数最彻底，但玩家侧功能实际不生效，与设计意图相悖，目检也需先开设置。
|
||||
- **丙** = 默认开但不新增设置项、仅组合根布尔（调试浮窗可切）——界面无感、工程有闸。
|
||||
（v1.1 历史陈文备查：本卡当时不出推荐案——开关默认态无先例裁决：06 :431 裁决⑥只约束切片期，2026-10-13 用户令「Alpha 阶段需完成」只定完成义务、未定开关载体。）参考事实留档：甲/丙案与 HUD框架 :132「玩家由此读到相邻格类型」的设计意图（06 :431「针对护甲类型规划开格」）直接兑现；乙案玩家侧功能实际不生效。
|
||||
|
||||
**裁定（v1.2·已裁）＝丙**（默认开、组合根布尔+调试浮窗可切、不新增设置项）。裁决来源：「2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕）」。一句理由：默认开直接兑现设计意图且界面无感、工程有闸，原「切片期默认不开」条款的验收读数保护义务由 off 态逐位一致断言+golden 双帧承接（契约 1/T2），基线保护不丢。呼吸态停格义务仅 Q5 追加裁决重议呼吸时生效（契约 7，Q5 已裁甲案静态）——减动效承载面为既存在役设置项（08 :152，事实源 [设置与本地化](../gdd/systems/表现与支撑/设置与本地化.md)），不新增设置载体。
|
||||
|
||||
### Q5 · 呼吸态与 §2.1 唯一在动元素纪律（v1.2 已裁＝甲·静态）
|
||||
|
||||
art-bible §2.1 已裁：挖掘期画面里唯一在动的是接触带呼吸微光。类型微光若也呼吸（选项 b 的卖相之一），即破该条；且「>3 次/秒」频闪红线恒在。
|
||||
- **甲** = **静态**：微光常亮不呼吸（零纪律修订、零减动效面；v2 呈现参数本就按静态 α170 定）。
|
||||
- **乙** = 呼吸：须 art-bible §2.1 修订条目先行（接触带失去唯一动效位，两光同动是否仍守「画面在动=可交互」语义需重审），减动效停格 + ≤0.48Hz 沿接触带参数。
|
||||
案位说明（v1.1 陈文备查，当时标注「非裁决」）：**甲 = 现行条款的默认合规态**——依据为既有裁决而非本卡取向：art-bible §2.1「画面里唯一在动的是玩家的思路」承载元素=接触带呼吸微光（:84），且 §3.2 接触带条明写「呼吸=§2.1 挖掘期唯一在动元素，减动效停格」（:170，2026-09-25 用户拍板批）；v2 呈现参数本就按静态 α170 定（:218）。**乙 = 须先获 §2.1 修订条目的明确授权**（接触带失去唯一动效位，两光同动是否仍守「画面在动=可交互」语义需重审），减动效停格 + ≤0.48Hz 沿接触带参数（`board_view.gd:844-846` 先例）。
|
||||
|
||||
**裁定（v1.2·已裁）＝甲**（静态）。裁决来源：「2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕）」。一句理由：静态即 §2.1 既裁的默认合规态，零纪律修订零减动效面，乙案需先获 §2.1 修订条目授权而本批不预授权。追加裁决面重议路径保留原文：**补充事实——shader 路线（Q1 乙/丙）下呼吸实现成本低；若用户看过静态效果后想重议乙，迭代 30 出口后追加裁决，本批不预授权。**
|
||||
|
||||
**开工门**：U0 = 用户 `/iter` 发令——Q1–Q5 已于 v1.2 全裁（「2026-10-16 用户令：三卡全部待裁项按推荐方案裁决（用户将裁权授出，由主线会话代拍板留痕）」），迭代 30 编入同令定档（roadmap 同步在批）。T0-③ 原型帧（Q1 丙案：shader 接触带柔光先行件）过目检后方可进 T1 全线铺码（若回退兜底案，断言面两案通用）。
|
||||
|
||||
---
|
||||
|
||||
## 11. grilling 审查记录（v1.1，2026-10-16，对抗性审查）
|
||||
|
||||
> 审查方式：卡片每个实查断言独立复跑检索复核；每处含糊/预判/越权表述按敌意主张逼问后处置。证据位点均为审查当日全库检索所得（工具：Glob/Grep/Read + git log 只读）。
|
||||
> v1.2 时点注：本节为 v1.1 历史记录原文留档；其中 B 表标「存留」的 Q1–Q5 待裁点已全部于 v1.2 依 2026-10-16 用户令代拍板裁定（见 §10 各裁定行），本节不再具有裁前效力。
|
||||
|
||||
### A. §2 事实五断言复核（必查攻击面 1）
|
||||
|
||||
| 项 | 卡片宣称 | 复核方法与证据 | 结论/处置 |
|
||||
|---|---|---|---|
|
||||
| 1a | bonus_pick_overlay.gd 已不存 | Glob `game/**/bonus_pick_overlay.gd` 零命中；`*pick_overlay*` 仅 curio_pick_overlay.gd；git 8e2694de（奇物批）载明 bonus_pick_overlay→curio_pick_overlay 改名沿革 | **成立**，F6 补 git 出处 |
|
||||
| 1b | 呈现层裸 Color8 现为 0 | Grep `Color8(` 限定 `game/presentation/` = 104 处全在 ui_kit.gd（ui_kit 自身为色板工厂，守卫域外）；全 `game/` 另有 smoke_all.gd 2 处 + ui_contrast_probe.gd 3 处 = 测试面，不在「呈现层」口径内；守卫条款实存（ui_contrast_probe.gd:107-130 R1 白名单，现零消费）；git af5f317a 提交说明自证「探针白名单清零=呈现层裸Color8=0」 | **成立**，F6 补口径声明（哪些目录、什么正则计入） |
|
||||
| 1c | TG_* 已随迭代 16 N4c 入库 | 通读 ui_kit.gd：五常量实存 :51-55（TG_BUFF=Color8(194,178,100) 逐值换算 = #C2B264 ✓）、tg_band() :60-69、E5 回滚注 :58-59（blast→TG_MAGIC 与代码 :65 行为一致 ✓）；git af5f317a = N4c 立项笔 | **成立**；附带发现：curio_pick_overlay.gd:101 行注「aoe/blast 归 TG_AOE」与现行代码行为不符（滞注）——已写入 F6，Q3 裁丙随修、裁甲记 L1 |
|
||||
| 1d | 九 cell_type→五组归组表代码侧缺失 | Grep `glow_group`/归组相关函数零命中；唯一近似件 = tg_band()（输入为 id/kind 小写子串，非 cell_type 精确值，且 blast 归属与圣经五组相左）；「不可复用」论据另有 art-bible :218（blast→群伤绯红）vs ui_kit :65（blast→TG_MAGIC）直接对照 | **成立**，T0-① 新建义务维持 |
|
||||
| 1e | 组间明度档值从未定义 | 逐读 art-bible §4.2 :218：只有「各组一档明度互辨」方向、无任何 L/α 数值；§1.4 验收 2 :58、§4.5 第 9 项 :248 同状态；v3.12 版本历史 :551 自证「逐型明度映射从未定义」；§4.6.3 :325 把明度档互辨抽测保留在样张线 | **成立**，且由此引出 Q2 缩窄（见 B） |
|
||||
|
||||
### B. 待裁点存留/关闭清单（禁再问已裁项核查）
|
||||
|
||||
| Q | 处置 | 证据（既有裁决检索面：06 裁决史/art-bible §4.2·§4.6.3·§2.1·版本历史/HUD框架 :130-142·:167·:269/08/roadmap/git log） |
|
||||
|---|---|---|
|
||||
| Q1 路线 | **存留**（用户「是否会用 shader」质疑只是关切非拍板；全库 shader 路线零先例裁决） | 卡片不拍板声明保留；修订三处越权表述：b 案性能「低-中」→ 实测义务项（a 案「低」同步标注为先例外推待实测）；「预计 2–3 轮」与「接受 2–3 轮节奏」→ 义务申报不承诺轮数；§8 L3「调参两轮仍不达标」→ 去轮次数值、每轮去留归用户判；「推荐：丙」删除 |
|
||||
| Q2 冻结 | **缩窄**：五组色相部分 = 已裁项删除不再问——样张 v2 四冻结②「类型微光五组定稿」（art-bible :66，2026-09-28，闸形 A 批末用户目检、2026-09-27 拍板）+ v3.0「②③维持冻结不变」（:563）+ v3.12 用户裁「五组色相本身不动（样张 v2 冻结维持）」（:551）；06 :431「候选值」措辞按 06 自身 2026-09-30「不再承载定义」注降级为批内机械修正。真未决 = 明度档值来源（无值可冻）+ 互辨抽测（§4.6.3 :325 归样张线而 08 :158 样张待做）联动路径——Q2 按此重写，原乙案（整批等样张总闸）因与②冻结既裁冲突而撤销；推荐语删除；新增「跨卡次序依赖」小节（样张卡 Q1 裁甲/乙/丙 三口径的联动规则逐条陈明） |
|
||||
| Q3 收编 | **存留**：核查认定 06 :435「不并入本批」= 迭代 16 批范围记录（该批未并入），非跨批禁裁；两带并存证据位点逐点开文件核实行号（ui_kit.gd:51-55/:58-59/:60-69、curio_pick_overlay.gd:101、shop_overlay_view.gd:216、art-bible :218）；「推荐：甲」删除，改为事实陈明+「是否翻口径归用户」 |
|
||||
| Q4 开关 | **存留**：06 :431 裁决⑥「切片期默认不开」前提复核——roadmap :16（2026-09-24 垂直切片转正）/:20（2026-09-28 M-1 切片表现完成）证明「切片期」已闭合；该条款无明文作废记录、但保护对象已随阶段终结（off 态逐位一致断言+golden 双帧承接，卡片原论据成立），「条款可否随阶段过期解除」即本 Q 实质——已写入卡内；「推荐：丙」删除（「开关=工程件而非玩家件」系卡片自裁理由，撤销）；减动效承载面为既存在役项（08 :152 + 设置与本地化.md 事实源 + board_view.gd:844-845 停格先例），不随本案新设 |
|
||||
| Q5 呼吸 | **存留（甲案有既有裁决支撑，按铁律例外保留依据）**：§2.1 条文原文核实——:84「画面里唯一在动的，是玩家的思路」承载元素=接触带呼吸微光、:170「呼吸=§2.1 挖掘期唯一在动元素，减动效停格」（2026-09-25 用户拍板批）；「减动效停格」条款实存性另经 08 :152/battle.md §Transitions/iter28 冒烟断言三处旁证；「推荐：甲」改述为「甲=现行条款默认合规态（依据 §2.1 既裁，非卡片取向）；乙=须 §2.1 修订条目明确授权」 |
|
||||
|
||||
### C. 其余攻击面处置汇总
|
||||
|
||||
- **Q1 共存表述核查**：`_desat_mat` 挂世界根 CanvasItem（board_view.gd:111/:170-172/:196 `_world.material` 写入点补入 F5）；「每格尚无独立 ShaderMaterial」经全仓 `ShaderMaterial` 引用面检索成立；「双层共存须实测」保留为义务（单层先例经复核属实，未见第二枚 gdshader）。
|
||||
- **§0 行号抽检**：reward_economy.gd:109 query_identity 返回键 `{reward_id, cell_type, tier}` 逐字核对 ✓；board_view.gd:102/:206-208/:838-875/:844-846、HUD :136-138/:140/:167/:269、08 :139-160 表域/:158、roadmap :89、art-bible :25/:58/:76/:205/:218/:248/:325 全部命中且读数与卡片一致——零翻案。
|
||||
- **V1–V10 判具**：工具五件（run_smoke.py/probe_gate.sh/render_gate.sh/golden_compare.py/shot_checker.py）+ 三文档闸 + ui_input_probe/board_shot_probe/ui_contrast_probe 均实存；V4/V5/V6 断言段标注「T2 新建」（工具管线现成、判定件新建），V6 补降级方案（抽检判不稳→目检辅助+报告登记，误读率终判恒归样张批），V8 条件化（Q5 甲时空转）。
|
||||
- **术语与中立性**：全文复扫新规用语表词形零命中（对照 2026-10-16 用语换代批 A 表的九组词形——含「阶段完结」类替换；本轮修订自撰文本全部按新规写，历史引文两处词形已改写规避）；buff 仅存代码标识符域（TG_BUFF/通用增益措辞合规）；五处「推荐」全部按 B 表处置（四处删除中立化、一处改为既裁依据标注）。
|
||||
- **契约 5 改写**：色相取值依据从「Q2 裁定来源」更正为「art-bible §4.2 既冻结值 + 明度档按 Q2」，消除把已裁项挂进待裁项的口径倒置。
|
||||
- **翻案记录**：本轮复核 v1.0 五断言（1a–1e）全部成立、零翻案；被修订的是表述层（性能预判/轮次承诺/推荐语/Q2 裁域/判具落点），非事实层。v1.0 唯一实质口径升级 = Q2 缩窄（发现 v3.0/v3.12 版本历史两处「②冻结维持」直接裁住了色相重问空间，v1.0 未检出版本历史即把已裁面留进了待裁清单）。
|
||||
@@ -124,8 +124,6 @@ static func build_start_overlay(host: Control, db = null) -> Dictionary:
|
||||
|
||||
var title := UiKit.label("Dungeon Sweeper",UiKit.FS_H1, true, UiKit.INK_ON_DEEP)
|
||||
box.add_child(title)
|
||||
var sub := UiKit.label("扫雷的因 · 逐行兑现的果",UiKit.FS_BODY, false, UiKit.WARM_SOFT)
|
||||
box.add_child(sub)
|
||||
box.add_child(HSeparator.new())
|
||||
|
||||
# 组帽·冒险（M2 分组）
|
||||
|
||||
@@ -44,8 +44,8 @@ func _ready() -> void:
|
||||
# apply 隔离档出厂默认=窗口化 1280x800，恢复本探针设计前提。探针侧环境修正，零运行时改动）
|
||||
main.settings_store.apply()
|
||||
await get_tree().process_frame
|
||||
# ① 菜单（启动态）——meta 锚经 S1 裁后换代（2026-10-08 用户裁：副标题锚改认现行文案；
|
||||
# 帮助文腿整个退役——载体玩法速览牌 2026-10-06 用户令退役，checker 对应断言段同撤）
|
||||
# ① 菜单（启动态）——帮助文腿整个退役（载体玩法速览牌 2026-10-06 用户令退役，checker 对应断言段同撤）；
|
||||
# 副标题件 2026-10-16 用户令整个删除（无意义标语），菜单文字锚只剩标题
|
||||
# 自检一（迭代 28 T4）：boot 态顶层可见全屏层=start_overlay（内容层树遍历——屏壳是容器不当候选：
|
||||
# camp 壳 boot 态 vis=true 但成员恒隐，裸树遍历自顶向下会先命中透明壳）
|
||||
var top: Node = null
|
||||
@@ -66,10 +66,10 @@ func _ready() -> void:
|
||||
if top != main._start_overlay:
|
||||
_problems.append("boot 态顶层可见层≠start_overlay（实测 %s——菜单被埋）〔装配生命批 V4〕"
|
||||
% (top.name if top != null else "null"))
|
||||
# 自检二（迭代 28 T4）：菜单标题/副标题 label 必须 is_visible_in_tree 且 rect 落屏内
|
||||
# 自检二（迭代 28 T4）：菜单标题 label 必须 is_visible_in_tree 且 rect 落屏内
|
||||
#（对比度只判反差不判「字在」——本条+checker 墨色占比共同补内容判据）
|
||||
var vp := get_viewport().get_visible_rect()
|
||||
for pair in [["menu_title", "Dungeon Sweeper"], ["menu_sub", "扫雷的因"]]:
|
||||
for pair in [["menu_title", "Dungeon Sweeper"]]:
|
||||
var lbl: Label = ProbeUiUtil.find_label(main._start_overlay, String(pair[1]))
|
||||
if lbl == null:
|
||||
_problems.append("菜单文字缺失: %s（find_label 零命中）〔装配生命批 V4〕" % String(pair[1]))
|
||||
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 313 KiB After Width: | Height: | Size: 325 KiB |
+6
-5
@@ -24,8 +24,8 @@
|
||||
## 当前位置（2026-10-16 刷新）
|
||||
|
||||
- **里程碑语义（2026-10-09 立规换代，详见下方里程碑表的换代注）**：现行里程碑 = **M3「Alpha 版本的完整实现」**——用户未明令宣布完成前停留 M3，迭代只排 M3 需求；M4=Beta 版本的完整实现，一律不排期。下文里程碑表的旧编号（M-3/M-4）保留作历史序列，语义以本节为准。
|
||||
- **迭代进度**：迭代 19 五卡全部已入库（2026-10-08）；**迭代 20=专长实装批 ✅ 已入库**（2026-10-11，出口闸全绿；残留人闸=实机目检五件+V20/V21/V22 人工核对半，07 在册）；**迭代 21=天赋树实装批 ✅ 已入库（2026-10-12 U0 开工单会话交付，T0-T7 全绿；残留人闸=实机目检四柜台）**；**迭代 22=秘宝体系实现重构落地批 ✅ 已入库（2026-10-12 单会话交付，T1-T7 全绿；残留人闸=实机目检秘宝解锁-装配流程）**；**迭代 23=锻造工坊实装批 ✅ 已入库（2026-10-12 单会话交付，T0-T7 全绿；残留人闸=实机目检工作间形态与购买交互）**；**迭代 24=敌人表内容修批（三关）✅ 已入库（2026-10-13 /goal+iter U0 开工单会话交付——N1 (1,2) 降档 hp22/ac2·N2 毒吐盾击两行六池·N3 敌方 attack_type 轴全填 normal+敌方结算克制消费点；冒烟 949/0+run_all 25 套+重闸全绿+MC 同种子配对 40 局×both 位移在带；实现报告=design/qa/iter24-实现报告-2026-10-13.md；残留人闸=实机目检三观测〔07 ㉓〕；代拍板追认单+GDD 反哺点五条待用户；**本迭代位仍预留后续追加卡——用户将把其他需求陆续编入本迭代**）；；**迭代 25=UI 全局主题批 ✅ 已入库**（2026-10-13 用户令编入，/goal+iter U0 单会话交付：全局主题资源 main_theme.tres 挂载+两处局部做法退役+冒烟 V1-V6 断言 38 条，冒烟 987/0+重闸全绿；实现报告=design/qa/iter25-实现报告-2026-10-13.md；残留人闸=实机目检全屏巡检〔07 ㉔〕）；**迭代 26=UI 交互与观感批已编入待开工**（2026-10-14 用户令；需求卡片 v1.2 零待裁点；开工门=U0——用户新会话 /iter 26 发令；本迭代位预留后续追加卡，同迭代 24 先例）；**迭代 27=代码架构技术债修复批 ✅ 已入库**（2026-10-14 /goal+iter U0 开工单会话交付：三屏场景化+会话物化+五段 Segment+RunLedger+ModalFlow+类型闸+卫生件五波全落；逐位一致对拍三变体五跑全同；实现报告=design/qa/iter27-实现报告-2026-10-14.md；残留人闸=实机目检五件〔07 ㉖〕；代拍板追认单十五项+GDD 反哺点两条待用户）；**迭代 28=启动装配与生命周期验收补全批 ✅ 已入库**（2026-10-15 用户令编入并预批连做全批，单会话交付：T1 装配语义合同 `LAYER_CONTRACT` 单点化＋冒险屏先挂/菜单屏后挂的顺序修复＋V1a-d 断言重写／T2 `_smoke_boot_chain` boot 链路十断言／T3 `_smoke_lifecycle_matrix` 九阶段×五引用面／T4 渲染面三件（shot_probe 两自检＋shot_checker 墨色判据＋启动态菜单 golden）／T5 变异验证六次注入全见红并精确还原／T6 规范三处落文；冒烟 **1086/0→1125/0**（+39＝新增 42−退役裸下标断言 3）；实现报告=design/qa/iter28-实现报告-2026-10-15.md；残留人闸=实机目检启动态菜单〔07 ㉗〕；代拍板追认单＋GDD 反哺点待用户裁决）；**迭代 29=测试分层与门禁语义修正批 ✅ 已入库**（2026-10-16 /iter U0 开工单会话交付：T1 三硬闸〔退出码／脚本错误扫描／断言数下限，三反例改前判绿改后判红〕／T2 术语订正＋CI 残留 8 处清除／T3 `tests/integration/` 建承载＋parity 收编为重闸 11 号条件闸件／T4 `screen_flow_probe` 入轻闸／T5 新增六套单测〔27→33 套〕／T6 S3 路径修正＋零命中自检＋补 S5／T7 游离脚本台账＋golden 判有效／T8 架构事实源三张表回写＋06 登记遗留七条；冒烟 1127/0 持平、重闸全绿存量红零新增；实现报告=design/qa/iter29-实现报告-2026-10-16.md；**无用户目检项**；代拍板追认单十二项＋GDD 反哺点三条待用户裁决；**遗留：11 号闸 parity 对拍判为触面，需用户批准才发起**）；**迭代 30+ 位空·无批次**（原 M4 数值批已废——2026-10-16 用户删卡令「它就不是一个应该存在的东西」，禁止再以该名义立批/规划/引用已删卡；四项数值欠账归 06 在册、重新归属待用户裁）。
|
||||
- **近期主战场**：迭代 20/21/22/23/24/25/26 残留人闸（实机目检六批，07 在册）；**迭代 29 已入库，下一前沿待用户令编入**（迭代 29 收口遗留=11 号闸 parity 对拍待批准发起＋GDD 反哺三条待裁；各批 provisional 终值的统一标定义务随 M4 数值批废除归 06 在册、重新归属待裁；迭代 20~28 残留人闸八批 07 在册）。
|
||||
- **迭代进度**：迭代 19 五卡全部已入库（2026-10-08）；**迭代 20=专长实装批 ✅ 已入库**（2026-10-11，出口闸全绿；残留人闸=实机目检五件+V20/V21/V22 人工核对半，07 在册）；**迭代 21=天赋树实装批 ✅ 已入库（2026-10-12 U0 开工单会话交付，T0-T7 全绿；残留人闸=实机目检四柜台）**；**迭代 22=秘宝体系实现重构落地批 ✅ 已入库（2026-10-12 单会话交付，T1-T7 全绿；残留人闸=实机目检秘宝解锁-装配流程）**；**迭代 23=锻造工坊实装批 ✅ 已入库（2026-10-12 单会话交付，T0-T7 全绿；残留人闸=实机目检工作间形态与购买交互）**；**迭代 24=敌人表内容修批（三关）✅ 已入库（2026-10-13 /goal+iter U0 开工单会话交付——N1 (1,2) 降档 hp22/ac2·N2 毒吐盾击两行六池·N3 敌方 attack_type 轴全填 normal+敌方结算克制消费点；冒烟 949/0+run_all 25 套+重闸全绿+MC 同种子配对 40 局×both 位移在带；实现报告=design/qa/iter24-实现报告-2026-10-13.md；残留人闸=实机目检三观测〔07 ㉓〕；代拍板追认单+GDD 反哺点五条待用户；**本迭代位仍预留后续追加卡——用户将把其他需求陆续编入本迭代**）；；**迭代 25=UI 全局主题批 ✅ 已入库**（2026-10-13 用户令编入，/goal+iter U0 单会话交付：全局主题资源 main_theme.tres 挂载+两处局部做法退役+冒烟 V1-V6 断言 38 条，冒烟 987/0+重闸全绿；实现报告=design/qa/iter25-实现报告-2026-10-13.md；残留人闸=实机目检全屏巡检〔07 ㉔〕）；**迭代 26=UI 交互与观感批已编入待开工**（2026-10-14 用户令；需求卡片 v1.2 零待裁点；开工门=U0——用户新会话 /iter 26 发令；本迭代位预留后续追加卡，同迭代 24 先例）；**迭代 27=代码架构技术债修复批 ✅ 已入库**（2026-10-14 /goal+iter U0 开工单会话交付：三屏场景化+会话物化+五段 Segment+RunLedger+ModalFlow+类型闸+卫生件五波全落；逐位一致对拍三变体五跑全同；实现报告=design/qa/iter27-实现报告-2026-10-14.md；残留人闸=实机目检五件〔07 ㉖〕；代拍板追认单十五项+GDD 反哺点两条待用户）；**迭代 28=启动装配与生命周期验收补全批 ✅ 已入库**（2026-10-15 用户令编入并预批连做全批，单会话交付：T1 装配语义合同 `LAYER_CONTRACT` 单点化＋冒险屏先挂/菜单屏后挂的顺序修复＋V1a-d 断言重写／T2 `_smoke_boot_chain` boot 链路十断言／T3 `_smoke_lifecycle_matrix` 九阶段×五引用面／T4 渲染面三件（shot_probe 两自检＋shot_checker 墨色判据＋启动态菜单 golden）／T5 变异验证六次注入全见红并精确还原／T6 规范三处落文；冒烟 **1086/0→1125/0**（+39＝新增 42−退役裸下标断言 3）；实现报告=design/qa/iter28-实现报告-2026-10-15.md；残留人闸=实机目检启动态菜单〔07 ㉗〕；代拍板追认单＋GDD 反哺点待用户裁决）；**迭代 29=测试分层与门禁语义修正批 ✅ 已入库**（2026-10-16 /iter U0 开工单会话交付：T1 三硬闸〔退出码／脚本错误扫描／断言数下限，三反例改前判绿改后判红〕／T2 术语订正＋CI 残留 8 处清除／T3 `tests/integration/` 建承载＋parity 收编为重闸 11 号条件闸件／T4 `screen_flow_probe` 入轻闸／T5 新增六套单测〔27→33 套〕／T6 S3 路径修正＋零命中自检＋补 S5／T7 游离脚本台账＋golden 判有效／T8 架构事实源三张表回写＋06 登记遗留七条；冒烟 1127/0 持平、重闸全绿存量红零新增；实现报告=design/qa/iter29-实现报告-2026-10-16.md；**无用户目检项**；代拍板追认单十二项＋GDD 反哺点三条待用户裁决；**遗留：11 号闸 parity 对拍判为触面，需用户批准才发起**）；**迭代 30=UI 呈现三卡批（徽章→样张→观感，迭代内串行）已编入·待开工**（2026-10-16 用户令编入——三卡待裁项同日用户令「按推荐方案」全部代拍板留痕、卡片均 v1.2，详见迭代 30 表行；开工门=U0 `/iter` 发令）；**迭代 31+ 位空·无批次**（原 M4 数值批已废——2026-10-16 用户删卡令「它就不是一个应该存在的东西」，禁止再以该名义立批/规划/引用已删卡；四项数值欠账归 06 在册、重新归属待用户裁）。
|
||||
- **近期主战场**：迭代 20/21/22/23/24/25/26 残留人闸（实机目检六批，07 在册）；**迭代 29 已入库；下一前沿=迭代 30 UI 呈现三卡批**（迭代 29 收口遗留=11 号闸 parity 对拍待批准发起＋GDD 反哺三条待裁；其后**迭代 30=UI 呈现三卡批**同日用户令编入·待开工〔三卡裁点已留痕，见迭代 30 表行〕；各批 provisional 终值的统一标定义务随 M4 数值批废除归 06 在册、重新归属待裁；迭代 20~28 残留人闸八批 07 在册）。
|
||||
- **实时状态**：以根目录 [active.md](active.md) 顶部「当前状态快照」节为准（`stage.txt` 已定性为旧阶段开关，仅存档）。
|
||||
|
||||
## 主线路线（里程碑 × 迭代序列）
|
||||
@@ -78,15 +78,16 @@
|
||||
| 迭代 20 | **专长实装批（奇物）**——需求卡片=design/research/需求卡片-专长实装批-2026-10-11.md（v1.1）。范围：T0-T10（效果引擎词表扩签/池结构案D 实装/专长 27 件换代/凭证五件/Boss 兑付换代〔已裁换代〕/状态账/断点扩容/MC 新基线/迁出行删除/空配置验收闸）。候选 B-F 留档不变。**✅ 已入库（2026-10-11 goal 会话 U0 开工——A/B/C 三段 T0-T10 全落 master：T1 词表扩签 a57489e/T2 案D 池 0640b0c/T3 29 行换代 54ab330/T4 凭证五件 1387aed/V4 补齐 5ebd05d/C 段收尾 3333187；冒烟 864/0+run_all 21 套+MC 同种子重放逐位复现；29 行件数口径+四级配额 104+疼痛记忆同战消费放宽+时沙/弃图兑换落法映射系代拍板追认单待用户）** | ✅ 已入库（出口闸全绿+实机目检归用户 07 在册） | T0-T10 ✅ |
|
||||
| 迭代 21 | **天赋树实装批（2026-10-11 用户令编入——整卡不切分，迭代容量放宽容纳全卡）**：按 [天赋树](design/gdd/systems/跨局循环/天赋树.md) **v0.8** 设计权威文档实装——**33→12 节点**结构换代（三轮换代：攻防所有权切分 29→21〔树零攻防来源=红线，攻/AC 唯一入口=锻造工坊路线〕/一线一节点 21→15〔生命·命中淬炼各一节点×4 级、row 字段退役〕/Fork 一节点双态 15→12〔开局姿态·危险直觉·财富之道三组各一节点、购买解锁后 A/B 零币切换〕；schema=Fork 词表 4→3 组/规则键词表 2→6 键、「等级阈值前置」形态去留=R1 开放待裁点〔推荐裁撤，**不阻开工门**〕）+三组 Fork 真效果（开局姿态每关首轮窗/危险直觉与财富之道·限次计数随冒险持久按关重置）+营地统一案甲（树=营地主界面/属性升级唯一入口/工作间钥匙模型/图鉴常开/占位面板零副作用硬要求）+注入公式换代（基础值+树淬炼+锻造路线加值位预留+局内加算）+旧属性柜台退役+旧档废弃与旧逻辑删除（开发阶段无迁移，Q3 裁决）+同调位槽位判定源切树节点（旧条件删除随批清扫）+树上刷新升级接线（双入口并存写同账）。需求卡片=design/research/需求卡片-天赋树实装批-2026-10-11.md（**v1.7**——grilling 五裁+歧义扫描六裁+**2026-10-12 完备性/跨系统歧义审查十一裁**全落；零阻塞待裁点）；锻造工坊（原「武器锻造」）**17 裁点已清零**（2026-10-12 逐裁落文 v0.5，06 在册），Q5 排期前置已满足、默认本批先行；T0 的「标错机制存在性」与「boss_kill_count 消费面」两项**已预查结案**（标错机制查实存在且有代价，守侧 contingency 作废） | ✅ **已入库（2026-10-12，/goal+iter U0 开工令——T0-T7 全量交付；R1 按既定默认裁撤案执行；实现报告=design/qa/iter21-实现报告-2026-10-12.md；残留人闸=实机目检营地四柜台〔07 在册〕）** | T0-T7≈7.0-8.0d（整卡单迭代——实际 2026-10-12 单会话交付） |
|
||||
| 迭代 22 | **秘宝体系实现重构落地批**——需求卡片=design/research/需求卡片-秘宝体系实现重构落地批-2026-10-11.md（v1.3 C1-C6 全裁）；**2026-10-11 用户令编入**：新目录 12 件实装+解锁混合制（逐件分配锁定表在卡）+装配不可变（冒险中零更换）+旧数据行清理+效果引擎接入；槽位来源不在本批（树接口接缝——迭代 21 已实装树点亮数槽位源，本批直接消费）+装配档位格约束；估时 6d（区间 5-7d）——**✅ 已入库（2026-10-12，/goal+iter U0 开工单会话交付：T1 数据层 12 行换代+schema 扩签/T2 解锁服务+工坊面退役+档位格约束/T3 效果引擎接入+扩签+常时参数面+试炼镐积点口+充能周期/T4 呈现换代+呈现桥+试炼镐 HUD 入口/T5 替换子交互拆除+库存保留注记/T6 验收闸断言；冒烟 898/0+run_all 22 套+重闸全绿；实现报告=design/qa/iter22-实现报告-2026-10-12.md；残留人闸=实机目检秘宝解锁-装配正常流程〔07 ㉑〕）**
|
||||
| 迭代 23+ | **M4 数值批（**原 22+；迭代 21 已编入天赋树实装批、迭代 22 已编入秘宝实装批，均 2026-10-11 用户令**——**Alpha 收官位·未排期**〔2026-10-09 语义换代：M4=Beta 阶段、非 Alpha 收官位，M3 未由用户明令关闭前不排期维持〕——2026-10-05 用户令编入迭代 17 卡②；2026-10-06 用户令移出独立成批并定序「Alpha 阶段最后——内容补全先行、统一数值调整殿后」〔当日曾被编入迭代 18 为收官卡，2026-10-07 用户令撤回〕；**2026-10-07 用户令二次后移：后续新迭代（迭代 20 起）一律不先做 M4，除非用户明确要求启动 M4 批次**）**：四件数值欠账合一批——①削弱档位终值（weaken 现值 −65/duration 2/refresh 考证在册；叠层改续时语义已定案，差 duration 终值+当量锚复算）②调参批数值点评（06 条目现行登记五条——任务口径「八条」与条目五条不符，需求卡片 §2.2 已呈报差异以条目为准）③迭代 10 奖励重构联动欠账①②（钥石产出重标 boss_keystone 首杀 3/3/3·复杀 2/2/3 provisional + 通关率带重扫〔通关回血 20%+AP 件首轮 +1〕）④元进度定价剩余面（forge base 20/比 150 考证在册——06 条目文本「base 10」滞后于 2026-09-22 对齿批已呈报；Boss 两档终值）。读数义务随批=迭代 14 两件后置复算（T6 MC 四带复算+T7 技能池节奏重测，均挂 07）；顺路修复 damage_probe A1 改前既有红灯（判式换代批出口报告 §四.7 在册）。**硬约束：一切 MC/verifier 跑批发起前须用户批准；调参联动禁独立调参网络（β 带 [1.2,2.5] 逐 u 检算）**。需求卡片=`design/research/需求卡片-M4数值批-2026-10-05.md`（**v1.2 2026-10-06 案C 增补+联审修订**：v1.1 三事实与第五推算件照旧；联审=P3 转正顺延至重扫读数后/检算工具 WEAKEN_PCT 入同步面/F11 两句死文本全刷/T3·T5 四带复算并账一次跑批双认账/R5 改前锚=本批新立案C 锚/估时段一勘误 4.25d；案C 增补内容照旧=§2.6 三事实〔行为换代/锚全作废/难度预判〕+T0 推算稿第五件=对拍锚按新序重推导+T6 四带复算按案C 新行为首采；T0-T8≈6.25d，天然切分点 T4 末；🔴 契约 5 条含跑批批准制；**✅ 裁点全裁（2026-10-06 用户令：P1甲=维持 2 场·magnitude [60,85] 带内当量锚复算、具体值随出口 provisional 追认/P2甲 不对称有意/P3甲 3-3-3·2-2-3 维持、转正顺延至重扫读数到账且带内（Q4 二裁）/P4甲 不立直购价）；开工=U0**） | 迭代 18 全部内容卡（③④⑤⑦）出口+全部内容批行为变更落定+**用户发令（未排期）**——重锚窗口须收尽全部内容批行为变更 | T0-T8≈6.25d（超软盒预挂，段一 T0-T4≈4.25d〔v1.2 勘误，原 4.5 系加总错误〕/段二 T5-T8≈2.0d）。**⚠ 2026-10-16 作废注：本行所载「M4 数值批」需求卡片已由用户删除、批次名义废除（四项数值欠账归 06 在册·重新归属待用户裁）——本行仅作排期史保留，不再是任何在途批次；现行空位记录见「迭代 30+」行** |
|
||||
| 迭代 23+ | **M4 数值批（**原 22+；迭代 21 已编入天赋树实装批、迭代 22 已编入秘宝实装批，均 2026-10-11 用户令**——**Alpha 收官位·未排期**〔2026-10-09 语义换代：M4=Beta 阶段、非 Alpha 收官位，M3 未由用户明令关闭前不排期维持〕——2026-10-05 用户令编入迭代 17 卡②；2026-10-06 用户令移出独立成批并定序「Alpha 阶段最后——内容补全先行、统一数值调整殿后」〔当日曾被编入迭代 18 为收官卡，2026-10-07 用户令撤回〕；**2026-10-07 用户令二次后移：后续新迭代（迭代 20 起）一律不先做 M4，除非用户明确要求启动 M4 批次**）**：四件数值欠账合一批——①削弱档位终值（weaken 现值 −65/duration 2/refresh 考证在册；叠层改续时语义已定案，差 duration 终值+当量锚复算）②调参批数值点评（06 条目现行登记五条——任务口径「八条」与条目五条不符，需求卡片 §2.2 已呈报差异以条目为准）③迭代 10 奖励重构联动欠账①②（钥石产出重标 boss_keystone 首杀 3/3/3·复杀 2/2/3 provisional + 通关率带重扫〔通关回血 20%+AP 件首轮 +1〕）④元进度定价剩余面（forge base 20/比 150 考证在册——06 条目文本「base 10」滞后于 2026-09-22 对齿批已呈报；Boss 两档终值）。读数义务随批=迭代 14 两件后置复算（T6 MC 四带复算+T7 技能池节奏重测，均挂 07）；顺路修复 damage_probe A1 改前既有红灯（判式换代批出口报告 §四.7 在册）。**硬约束：一切 MC/verifier 跑批发起前须用户批准；调参联动禁独立调参网络（β 带 [1.2,2.5] 逐 u 检算）**。需求卡片=`design/research/需求卡片-M4数值批-2026-10-05.md`（**v1.2 2026-10-06 案C 增补+联审修订**：v1.1 三事实与第五推算件照旧；联审=P3 转正顺延至重扫读数后/检算工具 WEAKEN_PCT 入同步面/F11 两句死文本全刷/T3·T5 四带复算并账一次跑批双认账/R5 改前锚=本批新立案C 锚/估时段一勘误 4.25d；案C 增补内容照旧=§2.6 三事实〔行为换代/锚全作废/难度预判〕+T0 推算稿第五件=对拍锚按新序重推导+T6 四带复算按案C 新行为首采；T0-T8≈6.25d，天然切分点 T4 末；🔴 契约 5 条含跑批批准制；**✅ 裁点全裁（2026-10-06 用户令：P1甲=维持 2 场·magnitude [60,85] 带内当量锚复算、具体值随出口 provisional 追认/P2甲 不对称有意/P3甲 3-3-3·2-2-3 维持、转正顺延至重扫读数到账且带内（Q4 二裁）/P4甲 不立直购价）；开工=U0**） | 迭代 18 全部内容卡（③④⑤⑦）出口+全部内容批行为变更落定+**用户发令（未排期）**——重锚窗口须收尽全部内容批行为变更 | T0-T8≈6.25d（超软盒预挂，段一 T0-T4≈4.25d〔v1.2 勘误，原 4.5 系加总错误〕/段二 T5-T8≈2.0d）。**⚠ 2026-10-16 作废注：本行所载「M4 数值批」需求卡片已由用户删除、批次名义废除（四项数值欠账归 06 在册·重新归属待用户裁）——本行仅作排期史保留，不再是任何在途批次；现行空位记录见「迭代 31+」行** |
|
||||
| 迭代 23 | **锻造工坊实装批（2026-10-12 用户令编入——设计面 v0.6 就绪）**：按 [锻造工坊](design/gdd/systems/跨局循环/锻造工坊.md) **v0.6** 设计权威文档实装——迁移面：①新建锻造路线行族（现役 `meta.tres` forge_products 已随迭代 21 T5 退役、无改造对象；钥石定价历史考古 20/150%、投值归 M4）②两根类型轴所有权移交（默认值归锻造工坊配置常驻持有、hero.tres 静态表两轴删除、选中态写存档域+冒险开始参数面注入）③存档域 forge_routes（已预登记存档序列化.md v7 计划行）④满级特效本期不实装（只留扩展位）⑤敌方 attack_type 填值归敌人系统/战斗结算侧（非本批——敌方定义数据、与名字血量同时读写、无独立时序）⑥术语登记（v0.6 已做完：术语表+registry）⑦数值验证义务=改前/改后同种子配对读数。解锁通道=并联双通道；一次冒险=一武器类型+一甲型。**✅ 已全批入库（2026-10-12，/goal+iter U0 开工单会话交付——worktree g-plan2-iter23-forge 七提交；T1 行族+T2 两轴移交+T3 写口族+T5 存档 v7（序调先行）+T4 注入链+T6 工作间 UI+T7 收口；冒烟 938/0+run_all 24 套+probe click/full+render_gate+doc 三闸/熵增对基线零新增+MC 同种子配对零漂移；实现报告=design/qa/iter23-实现报告-2026-10-12.md；残留人闸=实机目检工作间形态与购买交互〔07 在册〕；代拍板追认单+GDD 反哺点待用户）** | ✅ 已入库（出口闸全绿+实机目检归用户 07 在册） | 估时随需求卡片立项（实际单会话） |
|
||||
| 迭代 24 | **①敌人表内容修批（三关）（2026-10-13 用户令编入；**本迭代位预留后续追加卡**——用户将把其他需求陆续编入本迭代）**：需求卡片=`design/research/需求卡片-敌人表内容修批-2026-10-13.md`（**v1.1**——grilling 复核九问 Q1-Q9 已全裁、零待裁点、开工门=U0）。三件事合一：**N1** 第一关 (1,2) 降档（`enemy.tres:48` 改两值：`hp` 50→22、`armor_class` 3→2；**敌种 `bugbear` 不动**——`enemy.tres:594-600` 注释载明该行 50 血系 2026-09-24 用户裁决的设计而非填错，且 `hobgoblin` 无立绘，故「改敌种」案已否决；本批定性=阶名化解方案实机未达预期按 2026-10-13 体验反馈重裁）· **N2** 第二/三关普通敌技能投放（`skills.tres` 12→14 行：新增 `venom_spit` 毒吐 damage 1.6/CD2 挂 (2,5)/(2,6)/(2,7) 巨蜘蛛族、`shield_bash` 盾击 damage 1.7/CD3 挂 (3,0)/(3,5)/(3,7) 灰矮人族；**首遇教学位 (2,4) 池不动**，venom_spit 自 (2,5) 起投；两新行均不带 `rider_mult`——低 atk 下恒被 `damage_floor` 兜成 1 与 0.75 档等效）· **N3** 敌方 `attack_type` 加列并全填 `normal`（挂**敌种行**、20 行同值，不做差异化；`enemy_table.gd` 加枚举校验 + `unit_container.gd:119` 加单位快照 + `battle_orchestrator.gd:1406` 第 9 参由 `""` 改传值；全局平移=穿重甲受伤 −1 / 魔法护甲 +1 / 轻甲 0，使锻造甲路线首次具备战斗意义）。**契约要点**：池与敌种键属**契约级**，改必同步 `smoke_all.gd:3211` `expect_pools`（N1 因键值不变零改动、N2 同步 6 键）；节点图拓扑零触碰（A1 关卡节点图重构的地盘）；(1,1) 地精一伙不在本批范围（「第二个节点」字面偏差已登记 06）。**收口去向**：06「第一关遭遇表数值异常」「第二关技能池与投放」与锻造工坊条迁移面⑥ 三条一并销号；08「二·内容量」敌种池行注摘除 | ✅ 已入库（2026-10-13 单会话交付，出口闸全绿：冒烟 949/0+run_all 25 套〔485 批基线漂移 24→25 在案〕+探针 click/full+render_gate golden 0.00%+doc 三闸/熵增对基线零新增+MC 配对三组读数；实现报告=design/qa/iter24-实现报告-2026-10-13.md；残留人闸=实机目检三观测 07 ㉓） |
|
||||
| 迭代 25 | **①UI 全局主题批（引擎原生控件接管皮肤）（2026-10-13 用户令编入；UI 美化三层诊断 · 第一层第一条）**：**✅ 已全批入库（2026-10-13 /goal+iter U0 开工单会话交付，worktree g-plan2-iter25-theme 分支 iter25-theme-20261013）**——**T0 主题资源**：新建 `game/assets/theme/main_theme.tres` 挂 `project.godot` `gui/theme/custom`（15 类型全覆盖：V/HScrollBar·ScrollContainer·H/VSlider·TooltipPanel/Label·LineEdit·SpinBox·H/VSeparator + 预盖 CheckBox/CheckButton/OptionButton/PopupMenu 弹层；`default_font` 显式指向现役同字体文件=V6 中文字形防御；位图由 `tools/gen_theme_icons.py` 一次性生成落 `game/assets/art/ui/gen/`，色值溯源表落 `game/assets/theme/README.md`）· **T1 换代退役**：`ui_kit.gd` 的 `tooltip_theme()`/`_tip_theme` 与 `styled_slider()` 样式段、`ui_assembler.gd` 挂载行同批删除（禁新旧并存），settings_overlay 几何内联+debug_overlay `_slider_row` 双轨消隐· **T2 断言与文档同步闸**：冒烟新增 V1-V6 主题词条断言 38 条。**顺手销号**＝06 第三层「UI 元素细节修」之①（音量滑轨两段对比度重配＝已填充段 BG_ROOT #3A2E22 对暖石 #B8A582 实测 5.49:1）。**契约遵守**：🔴 Button 类型词条零接触（冒烟断言在闸）· 🔴 focus 族词条零定义（全主题扫描断言）· 🔴 零新增美术素材（位图=脚本生成纯色/几何）· 🔴 全局纹理过滤未动。**引擎事实订正（呈报追认）**：Godot 4.7.2 源码+默认主题链双查实证——①CheckButton 图标词条名与 CheckBox 同套 `checked`/`unchecked`（卡片 v1.2 注③「CheckButton 用 on/off」不成立，按引擎事实落位）②Slider 无 `grabber_pressed` 图标槽（冻结表「柄·按」值 GOLD_DEEP 留档未落位）③ScrollBar 柄是 StyleBox 非 Icon（无需位图）④4.7 导入参数已无逐贴图 filter 标志（位图原生尺寸消费无滤波伪影）。**闸**：冒烟 987/0（基线 949+本批 38 断言）+run_all 25 套+probe click/full+render_gate golden 0.00%+doc 三闸/熵增对基线零新增；MC 零跑（零数值零行为=纯呈现）。**收口去向**：06「UI 全局主题资源缺失」条移除+「UI 元素细节修」①销号；08 升 v1.3（三·界面主题行→在役、五·表现细节修行注①销号）；07 ㉔ 全屏巡检登记；实现报告=design/qa/iter25-实现报告-2026-10-13.md。**待用户**：实机目检全屏巡检+专项观察点二（07 ㉔，登记不阻塞）+代拍板追认单（位图不入 git 政策口径/CheckButton 词条名订正等）+GDD 反哺点（组件规格是否立条款入 art-bible §7 等）。↓ 原任务登记：三件事合一——**T0** 新建 `game/assets/theme/main_theme.tres` 并挂 `project.godot` 的 `gui/theme/custom`，覆盖滚动条 / 滑轨 / 悬停气泡 / 输入件 / 分隔线等引擎原生控件，并预盖 CheckBox / CheckButton / OptionButton 及其弹层 PopupMenu（须在新主题内显式设 `default_font`＝现役同一字体文件；新增小位图落 `game/assets/art/ui/gen/`，色值溯源表落 `game/assets/theme/README.md`）· **T1** 退役 `ui_kit.gd` 的 `tooltip_theme()` 与 `styled_slider()` 两处局部做法、消 `debug_overlay._slider_row` 双轨（🔴 旧实现同批删除）· **T2** 断言与文档同步闸。契约要点：🔴 Button 类型词条零接触 · 🔴 focus 族词条零定义 · 🔴 不新增美术素材、不改美术圣经 §7 · 🔴 全局纹理过滤不动 | ✅ 已入库（出口闸全绿+实机目检归用户 07 ㉔ 在册） | T0-T2≈0.5–1d（实际单会话） |
|
||||
| 迭代 26 | **①UI 交互与观感批（2026-10-14 用户令编入；UI 美化三层诊断 · 第一层第二/三条＋第三层四件；本迭代位预留后续追加卡，同迭代 24 先例）**：需求卡片=`design/research/需求卡片-UI交互与观感批-2026-10-13.md`（**v1.2**——grilling 两轮八裁全落、零待裁点、卡片成立）。六项：**T1 按钮五态矩阵**（悬停=乙案 modulate 提亮〔与 primary_button 现行 `CANDLE.lightened(0.06)` 同纪律〕/禁用=本族底+α0.45 幽灵化/焦点=INK 2px 内缩 1px/危险钮补本族 pressed；走逐实例 override，迭代 25 两条主题红线断言维持不换代）· **T2 全局纹理过滤**（`project.godot` `default_texture_filter=0`＋vignette/gradient_base/beams 显式 LINEAR 白名单＋翻转面全枚举）· **T3 <4.5:1 换墨**（站桩顺位/护甲徽标换同族亮档＋RAP 行 STONE_DEEP，机检断言锚定）· **T4 光柱连续 alpha 渐变**（0→0.05→0 横向＋纵向衰减）· **T5 元素细节余②③**（BCard 图标槽明度差降档/商店卡片区垂直居中/营地四栏等高）· **T5b 诊断转储钮移调试浮窗**（`dump_diagnosis` 功能保留）。🔴 契约 5 条（主题层零新增词条/零新美术素材/棋盘零触碰/对比度 ≥4.5:1/旧实现同批清理）；验证闸 V1-V7；代拍板白名单八项；反哺点四条；**渲染闸 golden 面处置**=T6 第 4 步（徽标换墨落 board golden 裁剪区：闸红→核热区限预期面→显式重制基线+呈报→复闸，超预期=L3）。**范围订正**（grilling 实查，iter25 滑轨条同款先例）：②垫块仅三选一 BCard（商店卡实为纯文字行卡）/③仅商店+营地（三选一已居中）/危险钮「无按下态」订正为「在但皮肤错配」。估时 T0-T6≈2–2.5d | **✅ 已全批入库（2026-10-14 /goal+iter U0 开工单会话交付，worktree g-plan2-iter26-ui 分支 iter26-ui-20261014 七提交）**——T0 基线+枚举（含卡片 §2.2 枚举漏项勘误）/T1 按钮五态（悬停 modulate 提亮/禁用 α0.45 幽灵化/焦点 INK 2px 内缩 1px/危险钮本族按压态）/T2 全局 Nearest+平滑渐变件 LINEAR 白名单/T3 三处换墨（GOLD_BRIGHT/HERO_BLUE_BRIGHT/STONE_DEEP，6.47/5.88/5.98:1）/T4 光柱连续 alpha/T5 图标槽柔和档+商店居中+营地四栏等高/T5b 诊断钮迁调试浮窗；冒烟 987→1055/0（+68 断言）+run_all 25 套+probe click/full+render_gate golden 0.00%（登记即结未重制）+doc 三闸/熵增对基线零新增；MC 零跑（零数值零行为=纯呈现）；实现报告=design/qa/iter26-实现报告-2026-10-14.md；残留人闸=实机目检五项（07 ㉕）；待用户=代拍板追认单十三项+GDD 反哺点四条 | T0-T6≈2–2.5d（实际单会话） |
|
||||
| 迭代 27 | **①代码架构技术债修复批（2026-10-14 用户令编入；来源=[代码架构与实现质量审计报告-2026-10-14](design/research/代码架构与实现质量审计报告-2026-10-14.md)，双席审计基线 97de02c，已逐条复核）**：需求卡片=`design/research/需求卡片-代码架构技术债修复批-2026-10-14.md`（**v1.2——三点全裁零待裁〔2026-10-14 用户三裁全按推荐案：①第三个 autoload／②单类持四账／③审计五段〕，卡片成立**）。五波：· **波一 场景拆分＋局生命周期物化（≈4-5d）**〔P0-1/P0-2：屏容器 .tscn 切分＝开始菜单根场景＋营地场景＋冒险场景〔内含 level_map/battle 两容器〕，视图代码原样搬、**40+ views 不转 .tscn**；SaveManager/MetaProgression 升格跨场景持有者；「一局」物化为可整体 `queue_free()` 的节点，`main.gd:647-657`/`:555-559` 手工清单消亡；13 个 smoke 探针挂载假设同批迁移〕· **波二 `_settle` 拆段（≈1.5d）**〔P1-1：五段 Segment 类 grant/aura/combat/decay/verdict，24 处 kind 分派随段归位，姊妹病灶 `damage_controller.gd:272` 148 行同批拆〕· **波三 账本收口（≈1.5d）**〔P1-4 共享四账 Ledger 类化＋P1-2 刷新双账删 main 副本＋P1-3 summary 增 `gp_final` 键、删 `gp_shadow_ledger.gd`〕· **波四 组合根可测化抽取＋模态协议内聚（≈1.5-2d）**〔P1-5/P2-7；**须在波一落地后重估抽取面再动**〕· **波五 类型闸收尾＋卫生件包（≈3d）**〔P1-6 拉闸＋存量 73 处收口，**须在其他重构全部落地后**；P2 七组顺手带〕。🔴 契约 6 条（**零行为变更·重构前后同种子完整局输出逐位一致**／只拆不重写／views 不转 .tscn／探针契约零破坏／信号纪律不变／执行顺序锁＋渲染零漂移）；**核心验收＝逐位一致对拍**（RngService 单盐流在役）；验证闸 V1-V9；代拍板白名单九项；反馈点两条（architecture／code-conventions）。 | **✅ 已全批入库（2026-10-14 /goal+iter U0 开工单会话交付，worktree g-plan2-iter27-techdebt 分支 iter27-techdebt-20261014 七提交）**——波一 三屏场景化+run_scope 会话物化+双 autoload（7a0d57d）/波二 _settle 五段 Segment+英雄攻击拆步（26301ba）/波三 RunLedger 单类四账+刷新双账删副本+gp_final 删影子账（6fd7d78）/波四 ModalFlow+互斥域 tags+双 context（8b9e556）/波五a 类型闸 368 参数化+审计器+warning 配置（b605022）/波五b 卫生件 13 死代码+FeatsEngine 退役+Callable 换装+状态机 enum 化+ConfigDB 归根+resolver 解耦（T6 笔）/T7 文档同步（本笔）。**闸**：逐位一致对拍三变体五跑全同（V1 核心验收）+冒烟 1055→1081/0（+V2 屏壳 11+V3 两连局 11+V4 段类 16+V6 模态 19+V5 快照 3+V7 2 断言）+run_all 25→27 套+probe click+render golden 0.00%+static_scan S1/S2/S4/S9 全绿（历史 cd 静默空转顺修）；MC 对拍=parity_anchor 三变体×40 局×RUNSUM+JSONL 双面（工具入库 tools/parity_anchor.py）；实现报告=design/qa/iter27-实现报告-2026-10-14.md（代拍板追认单十五项+GDD 反哺点两条）；残留人闸=实机目检五件（07 ㉖）；审计报告本体按退役规则 git rm | T0-T7≈12-14d（实际单会话） |
|
||||
| 迭代 28 | **①启动装配与生命周期验收补全批（2026-10-15 用户令编入）**：需求卡片=design/research/需求卡片-启动装配与生命周期验收补全批-2026-10-15.md（v1.0——零待裁点，用户预批连做全批）。六任务：T1 装配语义合同单点化+装配顺序修复+V2 断言重写/T2 boot 链路时序后置条件（_smoke_boot_chain 六断言）/T3 生命周期存活性矩阵（_smoke_lifecycle_matrix 十阶段×五引用面）/T4 渲染面内容断言（shot_probe 两自检+shot_checker 墨色占比+启动态菜单 golden）/T5 变异验证（横切随批）/T6 规范落文+文档同步闸+收口；修复坏事实三件（main.gd:207-210 装配序错致 F5 见战斗界面、smoke_all.gd:176 V2 断言保护 bug、菜单截图无内容断言）。🔴 契约 7 条（零玩法行为变更/合同单点化/断言禁裸下标/测试先行/变异验证门槛/只加不重构/闸机轮次纪律） | ✅ 已入库（2026-10-15 单会话交付：T0-T6 全绿；冒烟 1125/0、run_all 全套、probe_gate --click/--full、render_gate 四闸全绿；变异验证六次注入全见红；实现报告=design/qa/iter28-实现报告-2026-10-15.md；残留人闸=实机目检启动态菜单〔07 ㉗〕） | 实耗≈1 会话（原估 T0-T6≈5.25d） |
|
||||
| 迭代 29 | **①测试分层与门禁语义修正批（2026-10-16 用户令编入）**：把验收语义从「跑一遍没崩＝冒烟通过」扭转为「**三层完备＋判定可靠**」——兑现用户三条诉求（①最单元的逻辑代码有单元测试 ②整体模块有接口测试 ③整体系统有 UI 方面与场景切换相关的测试）且验收不止于冒烟。四件事：**①本地闸三硬闸**（退出码为唯一权威判据·PASS 串降级为日志；`SCRIPT ERROR`/`Parse Error` 扫描命中即红；断言数为零即红——`probe_gate.sh` 四探针判定改退出码优先、`test_kit.finish` 零断言判红、`run_all` 汇总校验实跑套件数，全部反例实证留档）；**②L2 接口层从零建承载**（建 `game/tests/integration/`＋`parity_anchor` 收编入闸表＋存档⇄RNG 快照往返首个集成用例）；**③L3 屏壳切换探针**（新建 `screen_flow_probe`：六步主流程＋三屏壳 `visible` 互斥＋放弃回退路径，入轻闸）；**④L1 补洞＋术语订正＋状态记录清理**（4 个 core 零指名模块＋呈现层风险前三补单测；「冒烟」唯一保留语义＝秒级存活检查；15 个游离脚本逐个定性、golden 基线时效判定、补 S5 扫描规则）。🔴 契约 7 条（零玩法行为变更／三硬闸不可绕过／现有断言面只增不减／不引入第三方测试框架／架构事实唯一源＝architecture.md／探针契约零破坏／测试执行两入口铁规）；验证闸 V1–V11；代拍板白名单 10 项；**无用户目检项（纯基建）**。需求卡片=`design/research/需求卡片-测试分层与门禁语义修正批-2026-10-15.md`（**v2.0**——三轮复查定稿、零待裁点；§2 事实用例改指针归 architecture.md「测试与质量域」节，T2 吸收 CI 残留 8 处，T6 收 S3 路径修正＋零命中自检，T5 补洞选面换 board_generator；T0–T8≈6.0–7.5d） | ✅ 已入库（2026-10-16 /iter U0 发令；八提交 `698d864d`…`c3b64030`，worktree `g-plan2-iter29-testlayers`，分支 `iter29-testlayers-20261016`；重闸全绿、存量红零新增） | 实耗≈1 会话（原估 T0–T8≈6.0–7.5d） |
|
||||
| 迭代 30+ | **（位空·无批次——原「M4 数值批」已废）**：2026-10-16 用户令删除需求卡片（原话「它就不是一个应该存在的东西」）⇒ **禁止再以「M4 数值批」名义立批、再规划、再引用已删卡片**。四件数值欠账本身仍在册——①削弱档位终值 ②调参批数值点评（06 条目现行五条）③钥石产出重标＋通关率带重扫（迭代 10 奖励重构联动欠账）④元进度定价剩余面（forge 定价·Boss 两档终值）——连同各批 provisional 终值标定义务，**一律归 `design/gdd/06-待办清单.md` 跟踪，重新归属待用户裁**；随批读数义务（迭代 14 两件后置复算）仍挂 07，damage_probe A1 既有红灯在册。M4=Beta 阶段口径不变（M3 未由用户明令关闭前不排期）；本迭代位留空待用户令编入 | 用户发令编入（未排期） | —— |
|
||||
| 迭代 29 | **①测试分层与门禁语义修正批（2026-10-16 用户令编入）**：把验收语义从「跑一遍没崩＝冒烟通过」扭转为「**三层完备＋判定可靠**」——兑现用户三条诉求（①最单元的逻辑代码有单元测试 ②整体模块有接口测试 ③整体系统有 UI 方面与场景切换相关的测试）且验收不止于冒烟。四件事：**①本地闸三硬闸**（退出码为唯一权威判据·PASS 串降级为日志；`SCRIPT ERROR`/`Parse Error` 扫描命中即红；断言数为零即红——`probe_gate.sh` 四探针判定改退出码优先、`test_kit.finish` 零断言判红、`run_all` 汇总校验实跑套件数，全部反例实证留档）；**②L2 接口层从零建承载**（建 `game/tests/integration/`＋`parity_anchor` 收编入闸表＋存档⇄RNG 快照往返首个集成用例）；**③L3 屏壳切换探针**（新建 `screen_flow_probe`：六步主流程＋三屏壳 `visible` 互斥＋放弃回退路径，入轻闸）；**④L1 补洞＋术语订正＋状态记录清理**（4 个 core 零指名模块＋呈现层风险前三补单测；「冒烟」唯一保留语义＝秒级存活检查；15 个游离脚本逐个定性、golden 基线时效判定、补 S5 扫描规则）。🔴 契约 7 条（零玩法行为变更／三硬闸不可绕过／现有断言面只增不减／不引入第三方测试框架／架构事实唯一源＝architecture.md／探针契约零破坏／测试执行两入口铁规）；验证闸 V1–V11；代拍板白名单 10 项；**无用户目检项（纯基建）**。需求卡片=`design/research/需求卡片-测试分层与门禁语义修正批-2026-10-15.md`（**v2.0**——三轮复查定稿、零待裁点；§2 事实面改指针归 architecture.md「测试与质量域」节，T2 吸收 CI 残留 8 处，T6 收 S3 路径修正＋零命中自检，T5 补洞选面换 board_generator；T0–T8≈6.0–7.5d） | ✅ 已入库（2026-10-16 /iter U0 发令；worktree `g-plan2-iter29-testlayers`，分支 `iter29-testlayers-20261016`；重闸全绿、存量红零新增；**遗留＝11 号闸 parity 对拍待用户批准发起**） | 实耗≈1 会话（原估 T0–T8≈6.0–7.5d） |
|
||||
| 迭代 30 | **①UI 呈现三卡批（2026-10-16 用户令编入——三卡待裁项同日用户令「按推荐方案」全部代拍板留痕，卡片均 v1.2；迭代内串行 ①→②→③，禁三线并行，依据=06/08/07/art-bible/roadmap/active 汇聚文件互踩〔grilling 审查记录 D3〕）**：**①未开格类型徽章批**——类型微光实装：英雄周界 8 格内未开格、组粒度五组色相（色相系既裁=art-bible 样张 v2 定稿，本批只补从未定义的组间明度档 provisional 值、复核转正义务移交②）、渲染路线裁丙=每格 CanvasItem shader 接触带柔光为主+程序绘制兜底（T0 原型帧先行件前置；视觉调优走「出帧→目检→改参」迭代，不承诺轮数）、开关裁丙=默认开+组合根布尔+调试浮窗可切（off 态逐位一致断言承接基线保护）、静态态（§2.1 既裁合规）、两套色带不并入本批（统一另登 06 条·批次出口写入文档）。卡片=`design/research/需求卡片-未开格类型徽章批-2026-10-16.md` → **②战斗一屏样张批**——裁丙「样张即设计目标图」：本批仅战斗屏（Q2 甲，余三屏登 06 排队）、引擎实拍+shader 为主路线（Q3 乙，半天试验件前置、证伪预设退甲案纯代码管线）、字重按目标效果示意（Q4 丙，字体补完批按样张补真件）、双口径两闸分跑（Q6 乙）、死指涉改指在盘最近稿注「指代稿」（Q5 甲）；交付含目标规格清单（尺寸档/色板/明度档逐件成文，反向给素材批）+徽章明度档复核转正。卡片=`design/research/需求卡片-战斗一屏样张批-2026-10-16.md`（≈5–6d）→ **③第二/三关棋盘观感批**——L2/L3 同批（Q3 甲）；T1 定性采样+归因报告过 06 既裁「素材轴/UI 轴」定性人闸（含 T1b 新建舞台底采样件）；素材轴默认甲案 recolor 换色候选样张先行，甲/乙（远程生图重产）裁点挂 T1 出口呈报硬步骤；若裁乙，瓦片规格随②目标规格清单、与徽章明度档同基线防互踩。卡片=`design/research/需求卡片-二三关棋盘观感批-2026-10-16.md`（5–7d）。验收共性=机检断言+用户目检（真人检测按 CLAUDE.md 既裁登记不阻塞、否决即回补）；08「五 · 表现」对应三行出口改写 | 迭代 29 完成（汇聚文件串行）＋**U0 开工门**：用户 `/iter` 发令（三卡裁点已全部留痕·无待裁残留） | 三批串行合计 ≈11–14d——超软盒 7d，按批次分会话逐个 U0 发令（各卡内部切分点见卡），禁单会话连做跨卡 |
|
||||
| 迭代 31+ | **（位空·无批次——原「M4 数值批」已废）**：2026-10-16 用户令删除需求卡片（原话「它就不是一个应该存在的东西」）⇒ **禁止再以「M4 数值批」名义立批、再规划、再引用已删卡片**。四件数值欠账本身仍在册——①削弱档位终值 ②调参批数值点评（06 条目现行五条）③钥石产出重标＋通关率带重扫（迭代 10 奖励重构联动欠账）④元进度定价剩余面（forge 定价·Boss 两档终值）——连同各批 provisional 终值标定义务，**一律归 `design/gdd/06-待办清单.md` 跟踪，重新归属待用户裁**；读数复算义务（迭代 14 两件后置）仍挂 07，damage_probe A1 既有红灯在册。M4=Beta 阶段口径不变（M3 未由用户明令关闭前不排期）；本迭代位留空待用户令编入 | 用户发令编入（未排期） | —— |
|
||||
|
||||
## 执行纪律（2026-09-27 用户立规）
|
||||
|
||||
|
||||
@@ -160,11 +160,11 @@ def main() -> int:
|
||||
failures.append("明度三档带: meta 几何缺失")
|
||||
if "shot_menu.png" in imgs:
|
||||
m = imgs["shot_menu.png"]
|
||||
check_text_box(m, box_of(meta, "menu_sub"), "菜单·副标题", failures)
|
||||
check_text_presence(m, box_of(meta, "menu_title"), "菜单·标题", failures)
|
||||
check_text_presence(m, box_of(meta, "menu_sub"), "菜单·副标题", failures)
|
||||
# 菜单·帮助文断言腿退役（迭代 19 卡① S1 裁 2026-10-08——载体玩法速览牌 2026-10-06 用户令
|
||||
# 退役「界面禁玩法文字墙」，锚/取样键/断言段三处同撤，不重锚）
|
||||
# 菜单·副标题断言腿退役（2026-10-16 用户令——副标题件整个删除〔无意义标语〕，
|
||||
# meta 键/断言两腿同撤，不重锚）
|
||||
print("[shot_checker] 焦点预算〔首焦唯一〕= 目检项（T15 段闸人闸清单判定——语义面不机检）")
|
||||
if failures:
|
||||
print("[shot_checker] FAIL——")
|
||||
|
||||
Reference in new issue
Block a user