docs(iter9): 用户验收新 v3.5 后立项插表——迭代 9 改「视觉规格落码+Alpha 验收」(前置卡组=批A冻结+批B落码六卡,任务书固化);原验收卡组不变

design/research/任务书-美术圣经v3.5冻结与落码-2026-09-29.md

@@ -0,0 +1,54 @@
+# 任务书:美术圣经 v3.5 冻结与落码(棋盘高墙+UI 视觉规格落地,迭代 9 前置卡组)
+
+> 2026-09-29 由主会话固化,交执行会话。用户新 v3.5 方向稿验收通过(原话「暂时没有其他问题,可以使用」,台账 281 验收记录)后立项;本任务书=批 A(机检冻结)+批 B(落码)两段的执行规格,编入 roadmap 迭代 9 前置卡组。
+> **执行前必读**(按序):
+> 1. `tools/render_sample_sheet_v3.py`——**视觉规格正文**(用户验收态脚本,新 v3.5=merge 4f6ac17);三条用户指令的落地实现都在此文件
+> 2. `design/art/art-bible.md` v3.0(2026-09-29 中修批——明度分层/色牌降级/语义色域限定/装饰解禁/整屏样张闸/舞台正面目标/全局对比度/字号 16-14)
+> 3. `design/research/art-bible-ux-review-2026-09-29.md`(六病根审视报告——本批修法依据,merge d88dae8)
+> 4. `artwork/mockups/sample-batch-v35-draft-2026-09-29.png` + `v35-new-board-zoom-2026-09-29.png`——**用户验收基准图**(落码后实机与此对齐)
+> 5. `artwork/mockups/v33-tile-consensus-2026-09-29.png`——板块共识图((a)–(j) 概念定案,用户全确认)
+> 6. `CLAUDE.md` 分支纪律(worktree 铁律)
+> 规格均已拍板,勿重新发明需求;**规格理解有分歧→停下向用户复述确认,勿自行变通**(2026-09-29 流程红线:复述确认制——视觉类改动先文字复述+疑点列清,用户逐条确认后才动手;「顺手改」零容忍)。
+
+## 1. 背景与现状
+
+- 圣经 v3.0 中修批已落(案 B,merge 9d69c7e);样张方向稿 v3.x 系列经用户逐轮目检+复述确认制收敛至**新 v3.5**(旧 v3.5/v3.6 被用户删除视同不存在,基线=v3.4 文件+三条指令)。
+- **新 v3.5 视觉规格(用户验收定案,本任务事实源)**:
+  1. **格底明度分档**:已开格底=地板瓦片归一 L≈0.10(候选带 0.08–0.14;现行瓦片 L0.036 实为**提亮**;方向稿用程序归一示意,终稿归地板素材重产,§8.5);
+  2. **数字亮墨直画**:三档色温——1–3 冷亮 `#D8ECF0`/4–5 暖白 `#F0E2C8`/6–8 金亮 `#F8E3A8`,直接画已开格底,实测对比 6.0–6.3:1;
+  3. **色牌后备**:`#F5EAD3` 仅复杂格底(物件纹样/装饰变体格)垫牌兜底,牌上用深墨族(12:1);
+  4. **E 格高墙(用户三条指令)**:地面格南邻墙→南部 **30%** 承接墙面(=墙顶瓦片纹理**原亮度**直贴,零暗档零阴影——用户终裁「没有什么阴影影响,它们是同样颜色的」);(b)-(c) 连接处**无边框**(渲染格线跳过该交界段);连续墙体内侧不出立面;
+  5. **南向厚度面**:v3.4 现状保留(南向墙格底部暗档+D 投影黑带在用户验收图内,本批不动);
+  6. **装饰物件级解禁**(小石块堆演示态,专属形状家族+零信息纪律)、**B 区舞台**(世界底层暗背景+顶光柱+地台落影,§6.1);
+  7. **整屏四屏方向稿已出**(战斗=样张内嵌;关卡/菜单/营地=`artwork/mockups/v3-draft-2026-09-29/`;营地屏首次成稿)。
+
+## 2. 批 A:机检冻结批(纯脚本断言定值,零视觉变化,半日级)
+
+- **A1 断言定值**:`render_sample_sheet_v3.py` 内「候选/参考/待校准」口径转正式——A3b 图底分离 Δ≥30 定值(实测 38);F6 沿用 v3.4 双明度带口径;A4 尺寸基线按现行资产实态固化(立绘 46×48 等)。
+- **A2 产物转正**:输出名转 `sample-batch-v3-final-<日期>.png`+机检报告落 `design/research/` 标注「冻结」;圣经 §1.4 补样张 v3 冻结条目(四冻结之①④**重冻**:数字形制=亮墨直画+色牌后备;砖面形态=E 格高墙 30% 词表扩展)——圣经版本号 v3.1。
+- **A3 人闸豁免说明**:气质终审已由用户 2026-09-29 验收完成(台账 281),冻结批不再开人闸。
+- **验收**:机检 17/17 全绿+圣经 v3.1 落籍。
+
+## 3. 批 B:落码批(迭代 9 前置卡组,逐卡对应 06 条目)
+
+- **B1 棋盘渲染**(`board_world.gd`/`board_cell_unit.gd`):E 格高墙进实机渲染(方向稿 draw_facade/is_facade_cell 算法移植——30% 高/顶面纹理原亮度/连续墙内不出立面;(b)-(c) 交界无边框=格线绘制跳过该段);地板归一 L0.10(程序归一同方向稿,素材重产归资产批);南向厚度面保持现行。
+- **B2 数字承载切换**(`ui_kit.gd`+数字渲染路径):亮墨三档直画+色牌后备路径(复杂格底判定=物件纹样/装饰变体格);旧「数字必垫色牌」路径退役。
+- **B3 ui_kit 对比度与字号**:现行 4 处不达标修复(C 区属性行 1.31:1/结算明细条 2.63:1/菜单说明 2.58:1/菜单副标题 3.54:1——实测数据=`artwork/ui-redesign-2026-09-29/对比报告.md` §一,其「落地顺序」1/2 步并入本卡);字号下限正文 ≥16px/tooltip ≥14px;暗底呈现态双色墨制扩展到全部暗底件。
+- **B4 B 区舞台**:世界底层暗背景+立绘地台落影+顶光柱氛围(§6.1 正面目标落码;方向稿 B 区画法=render_sample_sheet_v3.py render_battle_screen)。
+- **B5 整屏样张闸首跑**(§1.4 新闸):战斗/关卡/菜单/营地四屏断言——全局文字 ≥4.5:1/明度三档带(信息面>世界中>世界底)/整屏焦点预算/文字禁压纹理;HTML 方向稿(v3-draft 目录)为关卡/菜单/营地屏基准。
+- **B6 探针与冒烟**:ui_input/click/layout 三探针随动+run_smoke 全量;**重闸**=全量轻闸+doc 三闸+熵增闸(涉呈现不涉核心,MC 对拍预期零扰动——呈现层改动不触逻辑)。
+- **人闸**:实机目检由用户终验(对照 v35 验收基准图)。
+
+## 4. 纪律与边界
+
+- worktree 铁律;**复述确认制**(视觉类改动先复述后动手);素材不入 git(`load_tex` exists 守卫);§8.5 结构件纪律(禁渐变伪造结构件)。
+- **明确不在本批**:资产升档重产(64/96 档——06「资产升档重产批」独立挂账)/地板瓦片素材重产(落码用程序归一,重产归资产批)/underdark·deep_underdark 换色/营地 2D 画面(M-4)/关卡地图屏结构改动(冻结件不动)。
+- 已知限制逐条知悉,不在本批顺手修。
+
+## 5. 参考料
+
+- 06-待办清单对应条目:「样张 v3 重跑批」(本任务书批 A 即其执行)/「ui_kit 与棋盘渲染落码批」(=批 B)/「资产升档重产批」(不在本批)。
+- 用户验收链:审视报告(d88dae8)→圣经 v3.0(9d69c7e)→方向稿 v3.x 系列(273-281 台账)→新 v3.5 验收(4f6ac17)。
+- 反面清单(已有教训,勿重犯):E 墙面禁平涂新颜色(材质必须取墙顶瓦片);禁自加光影/明度分档类「专业表达」;改渲染层先清查既有结构件叠加时序;worktree remove 前先拷产物回主区。
+
+*任务书 2026-09-29 由主会话固化;规格源头=用户逐条拍板(台账 273–281+圣经 v3.0+新 v3.5 三条指令)。*