From 44bf9d69f51e1e3f16ce19acbb0f1a0a153d30fa Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Tue, 29 Sep 2026 22:43:58 +0800 Subject: [PATCH] =?UTF-8?q?docs(iter9):=20=E7=94=A8=E6=88=B7=E9=AA=8C?= =?UTF-8?q?=E6=94=B6=E6=96=B0=20v3.5=20=E5=90=8E=E7=AB=8B=E9=A1=B9?= =?UTF-8?q?=E6=8F=92=E8=A1=A8=E2=80=94=E2=80=94=E8=BF=AD=E4=BB=A3=209=20?= =?UTF-8?q?=E6=94=B9=E3=80=8C=E8=A7=86=E8=A7=89=E8=A7=84=E6=A0=BC=E8=90=BD?= =?UTF-8?q?=E7=A0=81+Alpha=20=E9=AA=8C=E6=94=B6=E3=80=8D(=E5=89=8D?= =?UTF-8?q?=E7=BD=AE=E5=8D=A1=E7=BB=84=3D=E6=89=B9A=E5=86=BB=E7=BB=93+?= =?UTF-8?q?=E6=89=B9B=E8=90=BD=E7=A0=81=E5=85=AD=E5=8D=A1,=E4=BB=BB?= =?UTF-8?q?=E5=8A=A1=E4=B9=A6=E5=9B=BA=E5=8C=96);=E5=8E=9F=E9=AA=8C?= =?UTF-8?q?=E6=94=B6=E5=8D=A1=E7=BB=84=E4=B8=8D=E5=8F=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...务书-美术圣经v3.5冻结与落码-2026-09-29.md | 54 +++++++++++++++++++ roadmap.md | 2 +- 2 files changed, 55 insertions(+), 1 deletion(-) create mode 100644 design/research/任务书-美术圣经v3.5冻结与落码-2026-09-29.md diff --git a/design/research/任务书-美术圣经v3.5冻结与落码-2026-09-29.md b/design/research/任务书-美术圣经v3.5冻结与落码-2026-09-29.md new file mode 100644 index 00000000..c3603ff6 --- /dev/null +++ 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 三条指令)。* diff --git a/roadmap.md b/roadmap.md index e9bf0280..4c776a01 100644 --- a/roadmap.md +++ b/roadmap.md @@ -50,7 +50,7 @@ | 迭代 6 | 战斗演出完善（原 M-4 迭代 7，2026-09-29 前移；2026-09-28 用户立项，收编历史登记「战斗表现批」——台账 106「真实立绘/动画密度终稿归战斗表现批」,前置 P0 样张已随 M-1 解除） | 迭代 5 出口（已解） | ①资产管线正式化：pixelfixer 网格段+封闭灰袋清除并入 `tools/pixelize_candidates.py`（--fixer）+九张 48px 站桩槽位档生成（8 敌种+主角 normal,底中锚/NEAREST）②敌种立绘落位：按 `ui_kit.gd` TEX_ENEMY_* 常量名入 `game/assets/art/character/`,字形「敌」回退退役,目检 ③主角 portrait 替换（新 normal 态）+attack/hit 两态素材入包（命名/路径随计划书定）④主角三态切换挂事件：攻击演出→attack 态/受击→hit 态/回 idle,槽位 2× 整数放大适配 ⑤命中特效密度终稿：命中瞬间打击特效（台账 106 动画密度欠账清偿）⑥受击白光/演出链复核：弹道→闪白→血条→灰化全链+flash_hit 强度时长 ⑦fx_probe 断言扩充+轻闸接线 ⑧用户实机目检清单（战斗演出专项,本迭代人闸）；**2026-09-29 全流程审计追加四件（用户裁定归本迭代,台账 243）**：⑨终局面板「明细回看」z 序修复（main.gd:361 绕模态栈直开,回看层登记序在终局层下、被全屏遮罩压死——改走 _open_modal+ui_click_probe 补终局入口断言）⑩GP 冒险收束呈现（adventure_runner.gd:231 清零前,冒险终局面板补「本局 GP 入账」行,兑现 ui_assembler.gd:52 双展示位承诺）⑪主角受击反馈+死亡演出（敌→主角伤害弹道 main.gd:505 直接 return、无白光——补弹道+flash_hit,死亡补专属演出,与敌方演出密度对等）⑫flat_damage 变异格视觉标记（tex_mutation 槽恒空、数字照常显示——接变异纹理或角标,可归因）。**T0 注（2026-09-29 裁定）**：美术素材不入 git 维持,`game/assets/art/` 目录补 .gitignore（现行素材在盘不入库,缺位走字形回退;素材移交方式=用户放盘,打包发布方案随 Alpha 前另议）；**2026-09-29 落地**：T0-T8 十轮全落（worktree m3-iter6-20260929,台账 247-255）——卡①-⑫全兑现+审计四件;重闸全绿（冒烟 576/0+五探针+doc 三闸/熵增零新增+素材机检 11/11+MC 对拍 400/400 逐位一致〔锚已重锚 HEAD,原迭代 5 锚过期〕）；**出口人闸=T9 目检进行中**（检查单+代拍板追认五项=design/qa/m3-iter6-exit-checklist-2026-09-29.md,素材移交口径更新=八敌+主角三态已管线自产落盘用户无需放盘）；**已完成（2026-09-29 用户 U2 目检过闸，台账 256）**——迭代 6 出口成立，迭代 7 门解 | | 迭代 7 | 魔法道具内容+元进度数值标定（原迭代 8+ 前两项编入） | 迭代 6 出口 | node-reward spec 随批出生+C 区道具槽接线+魔法道具内容（奖励节点空占位 node_overlay.gd:36 由本迭代兑现,营地工坊六件死解锁同批接局内效果）；换算率复核/柜台定价标定；批末复跑 verifier 关键带（新力量源入局读数漂移属预期，破带才回调）；**2026-09-29 落地**：T0-T8 八卡全落（worktree m3-iter7-20260929，台账 259-263）——八拍板点裁决落锁（①乙罗盘退役/②丙三选一/③甲解锁进投放池/④甲封存呈现/⑤甲两步交互/⑥甲三件 10/池 88/⑦⑧读数后裁与只测不判）；重闸=冒烟 577/0+五探针+单测 12 套（含 aux 三新套件）+doc 三闸/熵增零新增+素材机检 11/11+MC 剥 additive 字段 0/400 逐位（门控空集=夹具态零投放零扰动）；verifier 换算率复核读数出讫（生命 6→实测 1.7/攻击 9→4.1/护甲 1→0.0——U1 呈报待裁）；**已完成（2026-09-29 用户 U2 目检过闸——七项目检过+追认五项全认+T5-hotfix 实机复验；台账 267）**——迭代 7 出口成立，迭代 8 门解 | | 迭代 8 | 冒险续玩断点+设置面+打磨包（2026-09-29 立项：用户裁「中断可续玩/退出即结算」两口径分离+审计 #5#6 随移；**同日二批：真人试玩反馈三件编入+排布与选型已追认**〔2026-09-29 用户拍板：雷当量甲·直伤当量抬升／胜利总结结算接线按既有拍板面／轮间节奏甲·演出层排播队列，三件全编本迭代——计划书 `.zcode/plans/m3-iter8-loop-plan-2026-09-29.md`〕） | 迭代 7 出口 | ①run 快照序列化：停点粒度断点（关卡序号/节点位/生命/本关加成区/GP 钱包/商店已购档/已抽模板），入 save.json 新域+schema 版本迁移；战斗中中断不存棋盘中局，续玩恢复至最近停点、当场战斗从头打 ②开始菜单「继续上局」按钮（存在断点才亮起；续玩与新冒险互斥确认）③中断/退出口径分离：中断=关游戏留断点可续；退出冒险=现行放弃流程（失败结算+清除断点）④最小设置面（音量/全屏/退出按钮/减动效开关从测试调整板转正+调试入口门控）⑤打磨包（RAP 与九徽章图例解码入 legend、封印旗纹理落位退役文字占位、放弃按钮文案收敛至 level-map 4 字上限、判定文案两处措辞统一）⑥**战斗胜利总结结算接线**（冒险模式普通战斗胜利挂 BattleEndOverlay 胜利形态：金蜡封+GP 增量+总量+判定行+「下一节点」——battle.md OQ14 已拍板面接线，Boss/失败分支不动；06「战斗胜利总结结算接线」条目）⑦**轮间结算节奏化**（演出层排播队列：结算行按段分组阶梯延迟进明细带+轮切换「第 N 轮」横幅驻留——核心层零 await 契约与 MC 对拍不破、减动效开=延迟归零横幅静态化，与卡④减动效开关联动；06「轮间结算节奏化」条目）⑧**雷格负向当量抬升**（直伤三行 power 抬档投值+挖掘风险不等式对账复跑+通关率双窗复测；前置=普通 L2 缺口数字批点丙追认；06「雷格负向当量抬升」条目）⑨冒烟/探针断言：断点写读往返、续玩幂等、退出清断点、无断点时按钮隐藏+卡⑥结算框呈现断言+卡⑦节奏断言（减动效双态）⑩实机目检人闸（中断重开续玩全流程+战后结算框+轮间节奏）；**2026-09-29 落地（T0-T10 全落，worktree m3-iter8-20260929 六批次，台账 274-277+280，合并 77cc727）**：断点域 save v2（七字段+附随件，续玩确定性 400 局对拍零扰动）+继续上局/互斥确认/退出口径分离+最小设置面（减动效转正/DS_DEBUG 门控）+打磨包三件一降级（旗纹理缺盘 06 债务）+战斗胜利总结结算框+轮间排播队列与轮横幅（核心层零 await 零触碰，pacing_queue_test 第 15 套）+雷当量 4/5/5 provisional（MC 完美档读数逐位不动=只打踩雷轴反证；**普通 L2 7.9% 缺口加深四选一待裁**）+人闸三件交付=design/qa/m3-iter8-exit-checklist-2026-09-29.md；**出口人闸=用户目检进行中**——过闸则迭代 8 出口成立、迭代 9（Alpha 验收）门解 | -| 迭代 9 | Alpha 验收（原迭代 6；2026-09-29 一批后移迭代 8、二批因新立迭代 8 顺延至此——内容闭环后验收） | 迭代 8 出口 | ①draw calls 真机测量（270→<200）②真人目检清单总清 ③07-体验验证清单总对账 ④真人通关率标定（真人 k 补跑并入） | +| 迭代 9 | **视觉规格落码 + Alpha 验收**（2026-09-29 用户验收样张新 v3.5 并立项插入：美术圣经 v3.0 中修+方向稿收敛后的落码批为 Alpha 验收前置——验收对象应是视觉完整版本；任务书=`design/research/任务书-美术圣经v3.5冻结与落码-2026-09-29.md`） | 迭代 8 出口 | **前置卡组·视觉落码**（任务书批 A+批 B）：⓪批 A 机检冻结（断言定值+产物转正+圣经 v3.1 记录，人闸已由 2026-09-29 方向稿验收豁免）①棋盘渲染落码（E 格高墙 30%/连接无边框/地板归一 L0.10）②数字承载切换（亮墨三档直画+色牌后备）③ui_kit 对比度修复（现行 4 处不达标+字号 16/14）④B 区舞台（暗背景+地台落影+顶光柱）⑤整屏样张闸首跑（四屏断言）⑥探针与冒烟重闸；**Alpha 验收（原卡组不变）**：⑦draw calls 真机测量（270→<200）⑧真人目检清单总清 ⑨07-体验验证清单总对账 ⑩真人通关率标定（真人 k 补跑并入） | ### M-4 Alpha 后深化与内容扩展（Release 4；2026-09-29 起内容闭环迭代（战斗演出/魔法道具/元进度标定）上移 M-3，本里程碑=Alpha 验收通过后的深化批） | # | 迭代 | 门（进入条件） | 更改任务 |