From e65e967dd8e434a0900f08656968717968bb808c Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Sat, 17 Oct 2026 01:24:50 +0800 Subject: [PATCH 1/3] =?UTF-8?q?docs(cards):=20=E8=BF=AD=E4=BB=A330?= =?UTF-8?q?=E4=B8=89=E9=9C=80=E6=B1=82=E5=8D=A1=E7=89=87v1.3=E2=80=94?= =?UTF-8?q?=E2=80=94=E6=96=87=E6=A1=A3=E5=90=8C=E6=AD=A5=E9=97=B8v3?= =?UTF-8?q?=E5=8F=A3=E5=BE=84=E4=BF=AE=E8=AE=A2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 按 2026-10-17 用户六条裁定(纯文档批 carddoc-20261017): - 实现批禁写 design/ 与根规则文件:三卡同步面义务全部改列 reports/iter30-反哺点-<完成日>.md,用户会话裁决后归文档批落文 - 产出物落位换代:实现报告/代拍板追认单/反哺点清单落 reports/, 不再 design/qa/ - 末卡改「产出物落位卡」(三份 reports/ 文件写齐才算收口) - 闸口径按域选档指路 tools/run_all_gates.sh,摘除死闸件名单与 「全量档全绿」「文档三闸」字样 - 实机目检项转 reports/ 实现报告目检总清单,「入册 07」转反哺点 - 裁定留痕原文不动,落文类表述加执行口径注记(卡①§10/卡②§7/§7.5) - roadmap/CLAUDE.md/game/tests/README.md 零触碰 --- .../需求卡片-二三关棋盘观感批-2026-10-16.md | 60 +++++++------ .../需求卡片-战斗一屏样张批-2026-10-16.md | 90 ++++++++++--------- .../需求卡片-未开格类型徽章批-2026-10-16.md | 71 ++++++++------- 3 files changed, 123 insertions(+), 98 deletions(-) diff --git a/design/research/需求卡片-二三关棋盘观感批-2026-10-16.md b/design/research/需求卡片-二三关棋盘观感批-2026-10-16.md index a1c27968..f2481f72 100644 --- a/design/research/需求卡片-二三关棋盘观感批-2026-10-16.md +++ b/design/research/需求卡片-二三关棋盘观感批-2026-10-16.md @@ -1,10 +1,10 @@ -# 需求卡片:第二 / 三关棋盘观感——亮度与对比度批(T1 定性人闸 · T2 按轴修法 · 验收三件套 · 08 表现行换代) +# 需求卡片:第二 / 三关棋盘观感——亮度与对比度批(T1 定性人闸 · T2 按轴修法 · 验收三件套 · 文档面全走反哺点) -- 版本:**v1.2(2026-10-16 裁决留痕版:三卡待裁项按用户令定案——Q3 已裁甲·同批、Q2 延裁留痕并将裁点挂至 T1 出口呈报硬流程步骤、排期栏定实「已编入迭代 30」与三卡串行序位、§4B 跨卡依赖按已裁事实改实、全卡零悬空待裁点;v1.1 同日 grilling 审查修订见 §11;v1.0 同日成文)** +- 版本:**v1.3(2026-10-17 文档同步闸 v3 口径修订,纯文档批〔分支 carddoc-20261017〕按用户六条裁定执行——①本批(代码实现批)禁写 `design/` 整目录与根规则文件,§5 同步面的同步义务一律执行为「列进 `reports/iter30-反哺点-<完成日>.md`(哪个文件哪一节、改成什么、依据),用户会话裁决后归文档批落文」;②产出物落位换代:实现报告/代拍板追认单/反哺点清单三份落 `reports/`,不再 `design/qa/`;③T5 末卡改「产出物落位卡」(三份 reports/ 文件写齐才算收口);④闸口径按域选档:重闸 = `tools/run_all_gates.sh` 按改动域选档(本批 → `--code`),卡内不再写死闸件名单与「全量档」类字样;⑤实机目检项写进 `reports/iter30-实现报告-<完成日>.md` 实机目检总清单,「登记 07」转反哺点;§10 裁决留痕原文不动);v1.2(2026-10-16 裁决留痕版:三卡待裁项按用户令定案——Q3 已裁甲·同批、Q2 延裁留痕并将裁点挂至 T1 出口呈报硬流程步骤、排期栏定实「已编入迭代 30」与三卡串行序位、§4B 跨卡依赖按已裁事实改实、全卡零悬空待裁点;v1.1 同日 grilling 审查修订见 §11;v1.0 同日成文)** - 来源:[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)——方向若被否决,返工停在样张层,不烧落码与基线。 +- 排期:**已编入迭代 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 用户令口径**登记不阻塞**——目检项登记进 `reports/iter30-实现报告-<完成日>.md` 实机目检总清单(「入册 07」列反哺点;[CLAUDE.md](../../CLAUDE.md) 红线「真人检测只登记不阻塞——禁以等目检为停工理由」口径不变),用户复判否决走 §7 V4 回补机制(行回待做 + 06 立残留条,落文按 v3 口径归文档批)。防「改一轮还是不满意」的机制 = **先出改前/改后并排对比读数样张给用户定性确认方向,方向过了人闸才落码**(🔴 契约 4)——方向若被否决,返工停在样张层,不烧落码与基线。 --- @@ -14,7 +14,7 @@ |---|---|---| | 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) | +| 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) | @@ -27,9 +27,9 @@ **完成定义**(五件齐才算完成,缺一即该条在 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)全部到位。 +3. 验收三件套走完:机检读数达标 + 渲染闸 golden 基线显式重制并呈报换代面 + 用户实机目检轮**登记**(目检项登记进 `reports/iter30-实现报告-<完成日>.md` 实机目检总清单,「入册 07」列反哺点;2026-10-12 用户令=登记不阻塞入库,否决走 V4 回补); +4. 08「五 · 表现」棋盘观感行 待做→在役 改写列反哺点(含 07 目检登记注;落文归文档批); +5. §5 同步面每条在 `reports/iter30-反哺点-<完成日>.md` 有落点(06 对应条目状态更新条在内);权威文档与根规则文件零直改。 **效果不确定性的诚实声明**:观感是主观项。机检读数能证伪(超带 = 必有问题)不能证真(达标 ≠ 满意)。证真面由**前置人闸**承担(T1 定性闸 + 契约 4 方向样张闸——方向不过不落码);入库后的实机目检轮按 2026-10-12 用户令「真人检测只登记不阻塞」执行,用户复判若仍不满意 = V4 回补机制触发(08 行回待做 + 06 记残留、下批重开),不算本批未入库。 @@ -84,7 +84,7 @@ 🔴 **契约 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 用户令冲突,已对齐。) +🔴 **契约 5 · 机检 ≠ 观感,前置人闸承担方向证真**:读数达标只构成必要条件,机检不能证明满意——「证真」面由**前置**人闸承担(T1 定性闸〔06 已裁〕+ 契约 4 方向样张闸)。入库后的实机目检轮按 2026-10-12 用户令口径执行(CLAUDE.md 红线「真人检测只登记不阻塞」):目检项登记进 `reports/iter30-实现报告-<完成日>.md` 实机目检总清单即完成义务、不卡入库(「入册 07」列反哺点);**禁把「机检全绿」写成「用户满意」的等价表述**——用户复判否决时按 V4 回补(08 行回待做 + 06 记残留、下批重开,落文按 v3 口径归文档批)。(v1.1 改写注:v1.0 本条「完成判定必须含用户实机目检轮、目检未过禁宣布在役」与 2026-10-12 用户令冲突,已对齐。) 🔴 **契约 6 · golden 基线换代显式化**:改图必破基线——重制走 `tools/golden_baseline_refresh.sh` 显式流程(缺省模式重制棋盘三张:board_shot_probe 抓帧→`golden_board_crop.py` 按 meta 坐标裁剪→覆盖 `game/tests/golden/` 三张;触及菜单态加跑 `--menu`),并逐屏呈报换代面(新旧基线并排,沿 render_gate S2 停机点口径);权限与义务=呈现批 agent 自行换代、**提交说明强制写明触发原因**(refresh 脚本头注 Q6 在册);前置=素材齐盘(脚本逐项守卫,缺位拒跑)。**禁先刷基线后改图**(基线是判据不是障碍物)。 @@ -92,7 +92,7 @@ ## 4. 范围边界 -**做**:L2/L3 棋盘区域观感的定性归因(T1)、按轴修复落码(T2)、同批策略(T3)、验收三件套与基线换代(T4)、文档义务(T5)。 +**做**:L2/L3 棋盘区域观感的定性归因(T1)、按轴修复落码(T2)、同批策略(T3)、验收三件套与基线换代(T4)、产出物落位(T5)。 **不做**(明示去向): - 不动 L1 dungeon 套外观——除非 T1 读数显示问题为系统性共因(如迷雾档/舞台底全关同因,则 UI 轴修法天然全关生效,素材轴仍只动 L2/L3 色表); @@ -119,23 +119,25 @@ ## 5. 关联文档同步面 -| 文档 | 关联点 | 同步义务 | +> **v1.3 执行口径(2026-10-17 文档同步闸 v3)**:本批(代码实现批)**禁写 `design/` 整目录与根规则文件**,唯一可写目录 = `reports/`(`active.md` 唯一例外)。下表「同步义务」列一律执行为「列进 `reports/iter30-反哺点-<完成日>.md`:哪个文件哪一节、改成什么、依据,用户会话裁决后归文档批落文」——下表保留原关联点事实供写反哺点条目时对表。 + +| 文档 | 关联点 | 同步义务(v1.3 全部=反哺点列清单,另注者除外) | |---|---|---| -| [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 基线三张重制 | 机械面 · 随修法落地 | +| [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 并排看后问卷式回报) | 反哺点 · 列清单待裁(目检项另进 reports/ 实现报告目检总清单) | +| [roadmap](../../roadmap.md) | 迭代 30 行已编入(2026-10-16 用户令,行已在案);余留义务=估时刷新(T5) | 反哺点 · 列清单待裁 | +| `active.md` 状态记录 | 本批条目进度刷新 | **本批更新(唯一例外 · 会话状态源)** | +| `tools/recolor_terrain_tiles.py` / `game/tests/golden/` | 甲案色表修订 = 脚本内定值换代;golden 基线三张重制 | 工程面 · 随修法落地(可写) | | [playnote](playnote.md) | 历史试玩记录不回改(沿革留档),本卡即其正式承接 | 无义务 | --- ## 6. 任务卡 -> 估时按工作日口径;每卡出口自跑轻闸,批末跑 render_gate 全链。 +> 估时按工作日口径;每卡出口自跑轻闸;批末重闸 = `tools/run_all_gates.sh` 按改动域选档(本批 → `--code`)全绿才合入(脚本即唯一闸清单,卡内不另列名单)。 ### T1 定性步骤(人闸前置;含 T1b 新建采样件合计 ≈2–2.5d,**必先做,产出物 = 定性报告 + 对比样张**) @@ -190,11 +192,17 @@ 1. 机检读数达标:见 §7 V2 判据表; 2. **渲染闸基线换代**:跑 `tools/golden_baseline_refresh.sh`(缺省模式=棋盘三张;触及菜单态加 `--menu`)显式重制基线,呈报换代面与新旧读数差、提交说明写明触发原因(契约 6 实操步骤); -3. 用户实机目检轮:07 登记条目(玩法:L1/L2/L3 各开一局,并排回报「费劲感」相对改善)——登记即完成本批义务、不阻塞入库(2026-10-12 用户令);用户复判否决走 V4 回补。方向级否决(样张层)已在契约 4 前置拦截,本步只剩终验。 +3. 用户实机目检轮:目检项(玩法:L1/L2/L3 各开一局,并排回报「费劲感」相对改善)登记进 `reports/iter30-实现报告-<完成日>.md` 实机目检总清单——登记即完成本批义务、不阻塞入库(2026-10-12 用户令;「入册 07」列反哺点);用户复判否决走 V4 回补。方向级否决(样张层)已在契约 4 前置拦截,本步只剩终验。 -### T5 文档同步与完成定义改写(≈0.5d,末卡) +### T5 产出物落位卡(≈0.5d,末卡——三份 reports/ 文件写齐才算收口) -§5 全部机械面同步;08「五 · 表现」棋盘观感行 待做→在役(批入库时改写并顺带 07 目检登记注;V4 回补机制适用);06 本条状态改写(完成注记或阶段注记);roadmap 估时刷新。 +轻闸全绿后、合并前,把本批三份 `reports/` 产出物写齐(权威文档与根规则文件零直改;`active.md` 状态记录照常更新): + +1. `reports/iter30-实现报告-<完成日>.md`——各卡状态+**实机目检总清单**(T4-3 目检条目)+遗留读数义务+T1 定性报告读数表归档指引+变异验证记录表(新建断言/读数件的注入实验记录); +2. `reports/iter30-代拍板追认单-<完成日>.md`——§9 白名单内代拍板逐项留痕(含 Q2 甲/乙现场裁决的留痕补记); +3. `reports/iter30-反哺点-<完成日>.md`——§5 同步面每条一落点(哪个文件哪一节、改成什么、依据):06 本条状态行、08「五 · 表现」棋盘观感行(含 07 目检登记注与 V4 回补条款)、art-bible §4.1/§4.3 或 §6.5/§7 修订登记条(色值/常量若动)、HUD框架迷雾节(迷雾参数若动)、07 入册条、roadmap 估时刷新。 + +**原 §5 机械面直改义务零执行(v3 口径),落文归文档批。** **估时合计 ≈ 5–7d**(v1.1 上调:T1 新增 T1b 采样件 0.5–1d;v1.0 为 4–6d——彼时漏了采样件,批内各卡加总实为 4.25–6.25d);**v1.2 估时不动**:Q2 延裁的甲案候选样张与契约 4/T2 样张同源产出,仅时点前移至 T1 出口呈报点,批内不新增总量;T1b 职责不变(全框帧+分关读数与甲/乙裁决无涉),不因本批裁决再调;天然切分点:**T1 末**(定性报告+甲/乙裁决呈报即交付物,人闸天然停点)、**T2+T3 末**(修法落地)。 @@ -207,9 +215,9 @@ | 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框架(迷雾参数若动) | 逐件核对 | +| V4 | 用户实机目检 | 目检项登记(实现报告目检总清单;「入册 07」列反哺点)+ 用户回报「费劲感」相对改善且 L1 无退化——**登记不阻塞入库(2026-10-12 用户令)**;用户复判否决 = 回补机制触发:08 行回待做、06 本条记残留重开(落文按 v3 口径经反哺点归文档批)、返工起点=T1/T2 重议(不回滚已入库码面,按新条处置) | 主观判据的唯一权威=用户回报;入库前方向由契约 4 样张闸把关 | +| V5 | 邻接零回归 | 冒烟全套 + 单元 + 探针链零新增红(呈现面触碰加跑 ui_contrast);同迭代徽章批断言面零回归(§4B X3) | 重闸 = `tools/run_all_gates.sh --code`(脚本即唯一闸清单) | +| V6 | 反哺点清单 | §5 所列各条(08 行改写要求+目检登记注、06 状态刷新、art-bible 修订登记〔色值若动〕、HUD框架〔迷雾参数若动〕、07 入册、roadmap 估时)在 `reports/iter30-反哺点-<完成日>.md` 逐条有落点(文件/节/改成什么/依据) | 件核:§5 反哺点行数=清单条数 | **闸口径**:机检(V2/V3/V5)自动判;V1 = 人闸停点(T1 出口定性闸,06 已裁);V4 = 登记后回补机制(非停点,2026-10-12 用户令);契约 5——机检绿 ≠ 用户满意,禁作等价表述写入 06/08。 diff --git a/design/research/需求卡片-战斗一屏样张批-2026-10-16.md b/design/research/需求卡片-战斗一屏样张批-2026-10-16.md index a465ef7c..0a59eb18 100644 --- a/design/research/需求卡片-战斗一屏样张批-2026-10-16.md +++ b/design/research/需求卡片-战斗一屏样张批-2026-10-16.md @@ -1,16 +1,16 @@ # 需求卡片:战斗一屏样张批(整屏样张判定物首跑 · 四屏样张排程 · 防不满意工序重排) -- 版本:**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 条逐条改挂实存工具,判不了项降级并注明手段。 +- 版本:**v1.3**(2026-10-17 文档同步闸 v3 口径修订,纯文档批〔分支 carddoc-20261017〕按用户六条裁定执行——①本批(代码实现批,此处含样张工具面)禁写 `design/` 整目录与根规则文件,§8 同步面的同步义务一律执行为「列进 `reports/iter30-反哺点-<完成日>.md`(哪个文件哪一节、写成什么、依据),用户会话裁决后归文档批落文」;冻结记录段全文、目标规格清单、H1–H11 逐项处置、徽章明度档复核转正记录等**成文内容本体随反哺点条目交付**;②产出物落位换代:实现报告/代拍板追认单/反哺点清单三份落 `reports/`,不再 `design/qa/`;③T5 末卡改「产出物落位卡」(三份 reports/ 文件写齐才算收口);④闸口径按域选档:重闸 = `tools/run_all_gates.sh` 按改动域选档(本批触碰 `tools/` 样张面 → `--code`),卡内不再用「全量档全绿」类字样;⑤实机目检项写进 `reports/iter30-实现报告-<完成日>.md` 目检总清单,「入册 07」转反哺点;§7 裁决留痕原文不动,其落文类表述的执行口径随本版换代);**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) +- 排期:**迭代 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。 +**串行位**:按 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。**v1.3 注**:三卡文档直写义务已按 2026-10-17 文档同步闸 v3 全部转为反哺点(落 `reports/`,见 §8),上列汇聚文件重叠随之消解,但 2026-10-16 串行序位裁定不因此失效——序内仍有 golden 基线先后(§4B/§7.5 D2)与 art-bible 冻结内容先后(D1)依赖,禁三线并行维持。 **闸已立、机检面已跑过实机帧、样张判定物从未出**:整屏样张闸条款已于 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 排队行归后续批**)。**不新立闸条款。** @@ -93,20 +93,20 @@ **完成定义**(全部满足才算本批完成): 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. 冻结记录**成文**(内容 = art-bible §1.4 新增整屏样张冻结记录段全文——设计权威文档零直改,**仅过闸后成文**):同段逐条写明「本样张冻结了什么、没冻结什么」,并对 §0.5 的 H1–H11 **逐项给出处置**(本批冻结/本批不冻结并写明去向批次),禁留空;**同段另须产出两件交付物:① 目标规格清单(Q1 已裁丙案:尺寸档/色板/明度档逐件成文,反向给素材重产批提要求,承接 H1–H4 尺寸欠账);② 徽章卡 Q2 甲案 provisional 明度档之复核转正记录(H5 组间明度档复核+组间互辨抽测,复核转正义务按 §7.5 D1 落本卡冻结件,为本卡交付义务)**——全文随 `reports/iter30-反哺点-<完成日>.md` 对应条目交付(「改成什么」栏即全文),「写入 art-bible §1.4」列反哺点,落文归文档批; +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 排队行登记内容属本批交付义务**(排队行措辞含 P10 注记与营地屏「待目标规格清单反提要求」注记),随反哺点清单交付、落文归文档批;关卡屏既有 v1 冻结样张保留为注记(**其后续批是「对既有 v1 冻结样张补判整屏四项」,不是从零出图**,P10); +5. §8 同步面清单每条在反哺点清单有落点;权威文档与 06/08/看板零直改(v3 口径)。 --- ## 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 行号读数自身订正、战斗表现内容清单「四区」旧措辞订正。 +**做**:战斗屏样张全流程(方向稿→精制→双口径机检→终审→冻结);四屏排程落地按 **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 贴图重构批 / 资产升档批各自立项; @@ -126,7 +126,7 @@ ### 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); +- P4 死指涉按 **Q5 已裁甲案**处置:T0 实查盘面**定稿具体指哪份代稿**(v31/v32/v33-draft 择一,该实查拍板为本批动作);其落文动作——art-bible:68/:562 与看板:13 三处死指涉改指代稿并注「指代稿」、同族死指涉(§8.2 L490 呈报单死路径)按同案口径一并处置、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)——逐条列进 `reports/iter30-反哺点-<完成日>.md`(v3 口径零直改,归文档批落文);新冻结记录按 art-bible §8.3 描述性出处纪律成文; - §0.5 H1–H11 继承义务清单**逐条复核是否仍然在册**(漂移即订正本表);Q 项已全部裁决(§7),不再随 Q 呈报,清单逐项处置落 T3 冻结记录(契约 7); - 复核本卡 §0 全部行号与事实,漂移即订正卡片。 - **新增**:开工日可跑性证据+现有机检面读数基线(现状:shot_checker 周期在跑,样张脚本自 2026-09-30 后无跑动记录)。**防不满意**:先验证旧管线还活着、先量出现有机检代码到底判到哪一项,再决定它在新工序里的角色——避免「新工序设计了,旧工具已哑火」或「重复造一套已存在的判据」两种空转。 @@ -154,23 +154,29 @@ ### T3 气质终审(用户目检,闸形 A)(≈0.5d 含往返) - 精制版 + 断言报告一并呈用户终审;「过」→ 冻结;「不过」→ 按战斗表现判定回退条款分面回炉(演出/构图面回 T1 或 T2 对应项,已过项保留); -- 过闸同时产出三笔裁决记录:①敌人层绘制优先级插入位置(战斗表现:75 登记原句「随美术测试一并裁决,不在本文提前定」保留,清偿时点经 Q6 裁定随本样张一并——T3 即其清偿点);②氛围层两派统一结论(Q3 已裁乙为主:在实拍图上呈报;若方向稿层未完成,此层完成即为最迟期限);③徽章明度档 provisional 复核转正结论(H5,承接 §7.5 D1 已裁义务)。 +- 过闸同时产出三笔裁决记录:①敌人层绘制优先级插入位置(战斗表现:75 登记原句「随美术测试一并裁决,不在本文提前定」保留,清偿时点经 Q6 裁定随本样张一并——T3 即其清偿点);②氛围层两派统一结论(Q3 已裁乙为主:在实拍图上呈报;若方向稿层未完成,此层完成即为最迟期限);③徽章明度档 provisional 复核转正结论(H5,承接 §7.5 D1 已裁义务)。**三笔记录本体写进 `reports/`(实现报告+追认单),其文档落位(战斗表现:75 登记、art-bible §7.6(三) 改写、冻结记录段)列反哺点**。 - **新增**:明确不申请验收豁免(v3 先例有豁免,本批关闭该通道)。**防不满意**:终审语义 = 用户说不过就是不过,无「机检全绿应视为过」的反向论证空间。 ### T4 后续三屏排程(Q2 已裁甲案:本卡退役为登记行)(≈0d,06 排队行登记动作并入 T5) -- **执行 Q2 甲案裁定案**:本批仅出战斗屏;关卡/菜单/营地三屏在 06 **登记排队行属本批交付义务**,动作列入同步面(T5/§8),写入文档时点=批次出口; +- **执行 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,末卡) +### T5 产出物落位卡(≈0.5d,末卡——三份 reports/ 文件写齐才算收口) -- 冻结记录写入 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 条的「转正边界条款」写入(防「样张过闸」被误读为占位素材全体转正)。**防不满意**:冻结记录里逐条写明「本样张冻结了什么、没冻结什么」,后续批对表施工,杜绝各自解释。 +轻闸全绿后、合并前,把本批三份 `reports/` 产出物写齐(权威文档与 06/08/看板零直改;`active.md` 状态记录照常更新): + +1. `reports/iter30-实现报告-<完成日>.md`——各卡状态+**实机目检总清单**(T3 终审轮次记录、V1 方向稿三段记录表〔方向稿→选划→精制〕随附)+遗留读数义务(本批冻结基线读数供观感卡对表,§7.5 D2)+变异验证记录表(新建断言段的注入实验记录); +2. `reports/iter30-代拍板追认单-<完成日>.md`——冻结记录段系列编号口径等白名单内代拍项逐条留痕; +3. `reports/iter30-反哺点-<完成日>.md`——§8 同步面每条一落点(哪个文件哪一节、写成什么、依据),其中: + - **art-bible §1.4 冻结记录段全文**(新段,沿 v2/v3 记录格式;**段内系列编号口径属批内代拍**——格子样张序列已用到 v3,整屏样张是否续称 v4 还是自成一列〔关卡屏已用「样张 v1」名〕在冻结记录里一次说清,禁两处各按一种叫法);§0.5 H1–H11 逐项处置写入该段;**随段两件交付物(v1.2 新增):目标规格清单(Q1 丙案,尺寸档/色板/明度档逐件成文)+徽章明度档复核转正记录(H5/§7.5 D1)**——三件全文即反哺点条目的「写成什么」栏; + - art-bible §7.6(三) 氛围层并存条改写为已裁决口径(经 T3 记录); + - [art-status-checklist](../art/art-status-checklist.md) 战斗屏行 ✅+余三屏行刷新为「入 06 排队」态;08「五 · 表现」行待做→在役;06 对应条注销(去向登记当批状态记录);**06 为关卡/菜单/营地三屏新立排队行(Q2 甲案交付义务;措辞含 P10 注记「后续批=对既有 v1 冻结样张补判整屏四项,非从零出图」与营地屏「待目标规格清单反提要求」注记)**; + - roadmap 迭代 30 行状态刷新(编入笔已在案,只刷状态);完成定义第 3 条「转正边界条款」与 P11 定性连带注记随 08 行条目交付(防「样张过闸」被误读为占位素材全体转正)。 +- **防不满意**:冻结记录段全文逐条写明「本样张冻结了什么、没冻结什么」,后续批对表施工,杜绝各自解释。 **估时合计 ≈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),本批单屏口径恰在一迭代盒内。 @@ -182,15 +188,15 @@ | # | 需求点 | 测什么 | 落点/判定手段(实存工具,2026-10-16 核) | |---|---|---|---| -| V1 | 方向稿先行工序 | 每张精制样张有对应「方向稿 + 用户选划记录」在案;无记录直接精制 = 违红线 L3 呈报 | **人闸留痕,无工具可判**(降级为件核:开工单/出口报告附「方向稿 → 选划 → 精制」三段记录表;禁称机检化) | +| 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 随终审一并呈) | +| 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` 等文档闸由该脚本承载 | +| V7 | 产出物落位 | `reports/` 三份写齐且互一致:反哺点清单 §8 每条有落点(08 行/看板行/06 注销/art-bible 冻结段全文四处对应),边界条款与 §0.5 处置表、06 三屏排队行(Q2 甲案)与目标规格清单(Q1 丙案)内容在册;文档落文与链接/废止词复核归文档批(不进本批域) | 件核:反哺点清单逐条对表 §8;闸面由 `tools/run_all_gates.sh` 按改动域选档承载(唯一闸入口与唯一闸清单,卡内不另列名单) | -**闸口径**:本批零玩法零数值——MC 零跑;批末跑 `tools/run_all_gates.sh` 全量档全绿(该脚本是闸件唯一入口与唯一清单,增减闸件只改它本体——CLAUDE.md:19/56);**样张脚本不入门禁常设闸表**(周期件属性,本批零闸件增删),跑动记录留档。 +**闸口径**:本批零玩法零数值——MC 零跑;批末重闸 = `tools/run_all_gates.sh` 按本批改动域选档(本批触碰 `tools/` 样张面与断言扩面、零 `game/` 运行时改动 → `--code`)全绿才合并;**样张脚本不入门禁常设闸表**(周期件属性,本批零闸件增删),跑动记录留档。卡内不另列闸件名单(脚本即唯一清单)。 --- @@ -200,7 +206,7 @@ 🔴 **契约 2 · 方向稿不可跳**:目检先行是闸形(art-bible §1.4 原文),跳过方向稿直接精制 = 本批最高级违例。 🔴 **契约 3 · 卡片不代拍路线**:渲染手段、素材输入级别、四屏范围、字重前提——全部以 Q 项呈用户,批内任何任务禁止预设某路线已成立。**v1.2 闭合**:六项已全部经用户令裁定(2026-10-16 用户令:三卡全部待裁项按推荐方案裁决〔用户将裁权授出,由主线会话代拍板留痕〕,见 §7),本契约转为执法面——各卡按已裁口径执行,批内禁止自行升档、改线或另开路线。 🔴 **契约 4 · 机检不豁免目检**:断言全绿不构成过闸;终审权恒归用户;本批不申请验收豁免。 -🔴 **契约 5 · 权威文档仅过闸后写入**:art-bible §1.4 冻结段、08、06 的回写全部挂在 T3「过」之后;未过闸状态下同步面只许登记「进行中」注记。 +🔴 **契约 5 · 权威文档零直改(v1.3 换代)**:art-bible §1.4 冻结段、08、06 等一切文档回写义务一律转为反哺点清单条目——**过闸后成文**(未过闸状态下清单内对应条目只许注记「进行中」),用户会话裁决后归文档批落文;实现批唯一可写目录 = `reports/`(`active.md` 唯一例外)。 🔴 **契约 6 · 已裁项不可重开(v1.1 新增,用户红线)**:§0.6 核收表所列事项一律禁止以「样张冻结须总览」「再确认一遍」名义重列备选或再出推荐;本批 Q 项若与 §0.6 任一行相撞,以 §0.6 为准,该 Q 项当场收缩或删除并登记删除依据。 🔴 **契约 7 · 继承义务禁静默丢弃(v1.1 新增)**:§0.5 H1–H11 必须在冻结记录里逐项给「冻结/不冻结+去向批次」;留空即视为本批未完成,禁止以「不在本批范围」一句带过。 @@ -216,6 +222,8 @@ ## 7. 裁决记录(v1.2 改实:本卡 Q1–Q6 全部已裁。裁决来源统一措辞逐条留痕:「2026-10-16 用户令:三卡全部待裁项按推荐方案裁决(用户将裁权授出,由主线会话代拍板留痕)」;本节保留选项原文+裁定案+一句理由,v1.1 的「不带推荐案、逐条亲裁」呈报框架随用户授出裁权关闭,备选案文字仅存档供对表) +> **v1.3 执行口径注(2026-10-17 文档同步闸 v3)**:本节裁定文中「目标规格清单…落 §1 完成定义 2/T5/§8」「三屏登记 06 排队条的动作列入同步面,写入文档时点=批次出口(T5/§8)」等落文类表述,一律执行为「成文内容随 `reports/iter30-反哺点-<完成日>.md` 交付,用户会话裁决后归文档批落文」——裁定内容(做什么)不变,落文方式随 v3 换代。 + | # | 事项 | 备选案与影响 | |---|---|---| | **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 留兜底)** | @@ -225,7 +233,7 @@ | **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)。 +**开工门(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 用户令裁定=徽章→样张→观感,禁各自假设对方状态) @@ -233,28 +241,30 @@ |---|---|---|---| | 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「不预设结论、归用户排期令」呈报框架关闭 | +| D3 | **触碰面重叠与合入次序** | 三张卡共同 | 三卡都写 06/08/07/art-bible 版本历史/roadmap/active.md,徽章卡另动 `presentation/views`+冒烟,本卡另动 `tools/` 样张面。按 roadmap.md:93「单迭代串行」与 roadmap.md:101「一迭代 = 一次合并登记」⇒ 三卡禁止三线并行。**已改实(2026-10-16 用户令):三卡串行序位=徽章→样张→观感,本卡位第 2**;「一次合并、批内分波」组织方式随序位裁定确定,v1.1「不预设结论、归用户排期令」呈报框架关闭。**v1.3 注**:三卡文档直写义务已按文档同步闸 v3 全部转反哺点(落 `reports/`),汇聚文件重叠消解,但串行序位裁定不失效——golden 基线与冻结内容的先后依赖仍在(D1/D2) | | D4 | **门禁语义改动的先后** | 迭代 29 测试分层与门禁语义修正批 | 该批改的就是 `tools/run_all_gates.sh`/探针判定/退出码权威语义(其契约 2「三硬闸不可绕过」),本卡 V7 的闸口径完全依赖该语义;**该批先行则本卡按其当期读数重采基线**(同其卡片 v1.3 串行裁决口径);若用户令本卡先行,本卡 V7 只按其当期闸表跑、不改写任何判定脚本 | -| D5 | **08 表现表同一表的多行改写** | 三卡+08 v1.6 定稿纪律 | 08 头注 L5 明文「Alpha 内容范围冻结,增删条目须经用户裁决」——三卡都只有**改状态列**的权限,**无一行可新增/删除**;本卡 T5 回写仅动「战斗一屏样张」一行,若需要为新条目动集合,一律 L3 呈报 | +| D5 | **08 表现表同一表的多行改写** | 三卡+08 v1.6 定稿纪律 | 08 头注 L5 明文「Alpha 内容范围冻结,增删条目须经用户裁决」——三卡都只有**改状态列**的权限,**无一行可新增/删除**;本卡 T5 回写仅动「战斗一屏样张」一行,若需要为新条目动集合,一律 L3 呈报。**v1.3 注**:该「回写」执行为反哺点条目(仅动该行的改写要求照录进清单),零直改 | --- ## 8. 关联文档同步面 -| 文档 | 关联点 | 同步义务 | +> **v1.3 执行口径(2026-10-17 文档同步闸 v3)**:本批**禁写 `design/` 整目录与根规则文件**,唯一可写目录 = `reports/`(`active.md` 唯一例外)。下表「同步义务」列一律执行为「列进 `reports/iter30-反哺点-<完成日>.md`:哪个文件哪一节、写成什么、依据,用户会话裁决后归文档批落文」;成文内容本体(冻结记录段全文、目标规格清单、处置表等)随对应反哺点条目交付。 + +| 文档 | 关联点 | 同步义务(v1.3 全部=反哺点列清单,另注者除外) | |---|---|---| -| [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 自身纪律**) | 机械面 · 顺带登记 | +| [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`);样张脚本仍不入常设闸表 | 工程面 · 批内更新(可写) | +| [roadmap.md](../../roadmap.md) | 迭代 30 行编入笔已发(2026-10-16 用户令,行已在案);批内状态刷新 | 反哺点 · 列清单待裁 | +| active.md | 状态快照与批次记录 | **本批更新(唯一例外 · 会话状态源)** | +| [07-体验验证清单.md](../gdd/07-体验验证清单.md) | T3 目检轮次与后续实机目检衔接项登记(**现行 07 无样张类条目,实查 2026-10-16 零命中——本批为首次登记,属新增条目须走 07 自身纪律**) | 反哺点 · 列清单待裁(目检项另进 reports/ 实现报告目检总清单) | --- diff --git a/design/research/需求卡片-未开格类型徽章批-2026-10-16.md b/design/research/需求卡片-未开格类型徽章批-2026-10-16.md index 8c746afb..f1d4b682 100644 --- a/design/research/需求卡片-未开格类型徽章批-2026-10-16.md +++ b/design/research/需求卡片-未开格类型徽章批-2026-10-16.md @@ -1,9 +1,9 @@ # 需求卡片:未开格类型徽章批(类型微光实施)——迭代 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 审查记录) +- 版本:**v1.3**(2026-10-17 文档同步闸 v3 口径修订,纯文档批〔分支 carddoc-20261017〕按用户六条裁定执行——①本批(代码实现批)禁写 `design/` 整目录与根规则文件,§5 同步面的同步义务一律执行为「列进 `reports/iter30-反哺点-<完成日>.md`(哪个文件哪一节、改成什么、依据),用户会话裁决后归文档批落文」;②产出物落位换代:实现报告/代拍板追认单/反哺点清单三份落 `reports/`,不再 `design/qa/`;③T4 末卡改「产出物落位卡」(三份 reports/ 文件写齐才算收口);④闸口径按域选档:重闸 = `tools/run_all_gates.sh` 按改动域选档(本批只碰 `game/` 代码与断言面 → `--code`),卡内不再写死闸件名单、不再用「全量档全绿」「文档三闸」类字样;⑤实机目检项写进 `reports/iter30-实现报告-<完成日>.md` 实机目检总清单,「入册 07-体验验证清单」转反哺点;§10 裁定留痕原文不动,其落文类表述的执行口径随本版换代);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)。 +- 排期:**迭代 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 内置「路线原型先行」步骤,先出一帧给用户看再全线推进。 --- @@ -33,11 +33,11 @@ | 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. 反哺点列明待裁(若有),不擅落。 +1. S1–S6 全闭合;Q1–Q5 裁决落进代码。 +2. 呈现上线(Q4 已裁丙案:默认开入库):五组微光在真机战斗屏可见;实机目检项登记进 `reports/iter30-实现报告-<完成日>.md` 实机目检总清单(登记不阻塞;「入册 07-体验验证清单」列反哺点)。 +3. 机检全绿:重闸 = `tools/run_all_gates.sh` 按本批改动域选档(本批只碰 `game/` 代码与断言面 → `--code`)全绿;冒烟新增断言段(微光集合正确性 + 零玩法写入 + off 态基线逐位一致)与 golden 棋盘基线默认态漂移判读(判据见 §7)由该脚本闸段承载。 +4. 文档义务全部反哺点化:§5 同步面所列每条写进 `reports/iter30-反哺点-<完成日>.md`(哪个文件哪一节、改成什么、依据),零直改 `design/` 与根规则文件,落文归文档批;含 06 条目状态改写、HUD框架 :140 实装状态行+:269 验收行、08 表现表新增行(按 Q2 甲案注 provisional 待样张复核)、art-bible 明度档 provisional 登记条(§2.1 修订条目不追加——Q5 已裁甲案静态,该分支不触发)各一条。 +5. 反哺点清单逐条待用户裁决,本批不擅落文。 --- @@ -53,7 +53,7 @@ | 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` | +| 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` | --- @@ -72,12 +72,12 @@ ## 4. 范围边界 -**做**:路线裁决执行(Q1 已裁丙案)、归组机读表与五族色值常量新建、CellUnit 微光绘制面/shader 叠加实施、生命周期接线(入圈/出圈/开格/换图)、开关与灰度(Q4 已裁丙案)、机检断言新增(冒烟 + render_gate 段扩)、文档改写面(§5)、Q2 甲案下的 06 滞后措辞修正(批内机械面)。 -**Q3 已裁甲案(不并入)**:TG_* 两带统一迁移(原 T3 条件卡)不启动;「卡顶带与格面带分工」说明写入文档并另登 06 一条的动作列入本批同步面清单(§5),写入时点=批次出口。 +**做**:路线裁决执行(Q1 已裁丙案)、归组机读表与五族色值常量新建、CellUnit 微光绘制面/shader 叠加实施、生命周期接线(入圈/出圈/开格/换图)、开关与灰度(Q4 已裁丙案)、机检断言新增(冒烟 + 渲染取证段扩)、文档义务=反哺点清单(§5 全部条目,含 Q2 甲案下 06 滞后措辞修正条)。 +**Q3 已裁甲案(不并入)**:TG_* 两带统一迁移(原 T3 条件卡)不启动;「卡顶带与格面带分工」说明写入文档并另登 06 一条的动作列入本批同步面清单(§5),执行=列进反哺点清单、归文档批落文。 **不做**(明示去向): - **不做样张正式冻结动作**——冻结归样张线(08「战斗一屏样张」行);本批只按 Q2 甲案取 provisional 值实施、复核移交样张卡(见跨卡依赖 v1.2 注记)。 -- **不动卡顶色带视觉**——Q3 已裁甲案(不并入);两带统一归批次出口另登的 06 新条。 +- **不动卡顶色带视觉**——Q3 已裁甲案(不并入);两带统一归反哺点清单所列的 06 新条(文档批落文)。 - **不做探宝罗盘/预读道具重定**——归秘宝内容批(06 :431 裁决③)。 - **不动格底明度档、棋盘瓦片素材、图类型换皮四槽**(art-bible §4.3 不变槽含类型微光五组——换皮不触发微光变色,棋盘生成 board_type 词表零触碰)。 - **不扩微光环半径**——贴身 8 格是已拍板口径(HUD框架 :167),阔视野带类道具一律不扩微光。 @@ -86,23 +86,25 @@ ## 5. 关联文档同步面 -| 文档 | 关联点(本批改变其哪条陈述) | 同步义务 | +> **v1.3 执行口径(2026-10-17 文档同步闸 v3)**:本批是代码实现批,**禁写 `design/` 整目录与根规则文件**,唯一可写目录 = `reports/`(`active.md` 是唯一例外,会话状态源)。下表「同步义务」列一律执行为「**列进 `reports/iter30-反哺点-<完成日>.md`**:写清哪个文件哪一节、改成什么、依据,用户会话裁决后归文档批落文」——下表保留原关联点事实供写反哺点条目时对表。 + +| 文档 | 关联点(本批改变其哪条陈述) | 同步义务(v1.3 全部=反哺点列清单) | |---|---|---| -| `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) | 实施本体 | +| `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 用户令);批内状态更新 | 反哺点 · 列清单待裁 | +| `design/gdd/06-待办清单.md`(Q3 甲案追加动作) | ①「卡顶带与格面带分工」说明写入文档(art-bible/HUD框架 注记面);②另登 06 一条「卡顶色带与格面微光两带统一」新待办 | 反哺点 · 列清单待裁 | +| `active.md` | 状态快照与本批条目 | **本批更新(唯一例外 · 会话状态源)** | +| `design/gdd/07-体验验证清单.md` | 新增实机目检人闸条(五组互辨观感/不遮数字/出圈灭) | 反哺点 · 列清单待裁(目检项另进 reports/ 实现报告目检总清单) | +| `game/presentation/views/*`、`game/smoke/*` | 代码与断言(见 §6) | 实施本体(可写) | --- ## 6. 任务卡 -> 估时按工作日口径;每卡出口自跑轻闸,批末全闸绿才合入;开工日 T0-④ 复核本卡全部行号。 +> 估时按工作日口径;每卡出口自跑轻闸;批末重闸 = `tools/run_all_gates.sh` 按改动域选档(本批 → `--code`)全绿才合入(脚本即唯一闸清单,卡内不另列);开工日 T0-④ 复核本卡全部行号。 ### T0 证据坐实、规格闭合与路线原型(≈1–1.5d,必先做;Q1 丙案下 shader 原型帧+共存实测为新增先行件,估时上限相应上调) @@ -123,16 +125,20 @@ - **冒烟(数据侧)**:新段断言——微光格集合恒等于 `_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)零新增红。 +- **渲染闸(像素侧)**:渲染取证段扩——board_shot_probe 夹具板加微光 on/off 双帧:①on 帧逐格取样判定「非生效格像素零变化」(禁整格染色/禁越圈);②微光格砖心区(数字字形占位区等效域)灰度差 ≤阈值;③五组两两灰度带互辨抽检(shot_checker 同型 WCAG/灰度工具复用);④off 帧对 golden 基线 ≤2% 带(**Q4 丙案默认 on**,golden 棋盘三基线判读呈报——预期漂移在生效格集合内,超出即红)。 +- **全闸**:批末重闸 = `tools/run_all_gates.sh --code`(本批只碰 `game/` 代码与断言面;脚本即唯一闸清单)全绿。 ### T3(条件卡·Q3 已裁甲案不并入——本卡不启动,内容留档)TG_* 两带统一迁移(≈0.5d) 卡顶色带取值改圣经五组值、归组输入改 cell_type 精确值、E5 回滚注记清偿(curio_pick/shop 消费面视觉回归 + 相关对比度对断言刷新)。**影响面**:三选一与商店货架观感变化 + 既有断言改写(触碰「只增不减」契约须按 §8 L3 先呈报)。 -### T4 目检与出口(≈0.5d) +### T4 产出物落位卡(≈0.5d,末卡——三份 reports/ 文件写齐才算收口) -实机目检人闸(07 登记条:五组一眼可分/不遮数字/出圈灭/整屏不脏);§5 文档改写面全落;出口报告。 +轻闸全绿后、合并前,把本批三份 `reports/` 产出物写齐(零 `design/` 与根规则文件直改;`active.md` 状态记录照常更新): + +1. `reports/iter30-实现报告-<完成日>.md`——各卡状态+**实机目检总清单**(五组一眼可分/不遮数字/出圈灭/整屏不脏;登记不阻塞)+遗留读数义务+变异验证记录表(§7 新建断言段的注入实验:变异点 file:行、跑的闸、红输出、还原结论); +2. `reports/iter30-代拍板追认单-<完成日>.md`——§9 白名单内代拍板逐项留痕; +3. `reports/iter30-反哺点-<完成日>.md`——§5 同步面所列每条都要有落点(哪个文件哪一节、改成什么、依据),含 07 入册条、Q2 甲案明度档 provisional 值登记条、Q3 甲案「两带分工说明+06 新条」条目。 --- @@ -143,13 +149,13 @@ | 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),格面像素版断言本批新建 | +| V4 | 禁侵与不遮(F5/契约 3/4) | 砖心留白区灰度扰动 ≤阈值;数字 ≥4.5:1 复核零降档;格内零附加图形 | 渲染取证段扩(`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 既裁) | +| V6 | 五组互辨 | 组间色相 + 明度双码在去色相模拟下仍可分组(误读率指标归样张线,本批只跑机检抽检) | 去色相抽检脚本 = T2 新建段(沿 `tools/shot_checker.py` 的 PIL 取样同型,挂渲染取证段);**判不稳时降级**:目检辅助 + 实现报告登记缺口,误读率终判恒归样张批(§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 新增条(人闸不可代) | +| V9 | 反哺点清单 | §5 所列每条在 `reports/iter30-反哺点-<完成日>.md` 有落点(哪个文件哪一节、改成什么、依据),清单条数 = §5 反哺点行数;文档落文与链接/废止词复核归文档批(不进本批 `--code` 域) | 件核:反哺点清单逐条对表 §5 | +| V10 | 目检人闸 | 用户实机看过并点头(「很丑」质疑的终审位) | 实现报告目检总清单登记(人闸不可代,登记不阻塞);「入册 07」列反哺点 | **目检与机检两分**:V1–V7 机检自动化(其中 V4/V5/V6 的断言段为 T2 新建——工具管线实存、判定件新建,开工前不存在「直接可用」假象);V8 半机检;V10 唯一人闸不可代。T0-③ 原型帧是目检第一道,批末 V10 是第二道。 @@ -170,7 +176,7 @@ 3. shader uniform 命名与参数表组织(Q1 裁二域内)。 4. 呼吸相位驱动写法(Timer vs `_process` 累积,沿接触带先例)。 5. 冒烟/探针断言的具体取值与夹具板配置。 -6. 取样阈值 provisional 数值(砖心扰动带/灰度抽检带)——首版取严,出口报告登记。 +6. 取样阈值 provisional 数值(砖心扰动带/灰度抽检带)——首版取严,实现报告登记。 7. 提交切分与 worktree 分支命名。 (Q1–Q5 本体**不在**白名单——2026-10-16 用户令裁权授出、由主线会话代拍板留痕完成裁决,五项裁定见 §10,本批不再开放重裁。) @@ -180,6 +186,7 @@ ## 10. 裁点(v1.2:Q1–Q5 全部已裁) > **裁决来源(统一措辞·代拍板追认单形态,逐条留痕)**:「2026-10-16 用户令:三卡全部待裁项按推荐方案裁决(用户将裁权授出,由主线会话代拍板留痕)」。五项裁定:Q1 丙/Q2 甲/Q3 甲/Q4 丙/Q5 甲。各 Q 选项原文保留备查,裁定行附后。 +> **v1.3 执行口径注(2026-10-17 文档同步闸 v3)**:本节裁定行中「写入文档/另登 06/批内机械面修正入同步面/写入时点=批次出口」类落文表述,一律执行为「列进 `reports/iter30-反哺点-<完成日>.md`,用户会话裁决后归文档批落文」——裁定内容(做什么)不变,落文方式随 v3 换代。 ### Q1 · 渲染技术路线(第一裁点;v1.2 已裁=丙) @@ -256,7 +263,7 @@ art-bible §2.1 已裁:挖掘期画面里唯一在动的是接触带呼吸微 **裁定(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 全线铺码(若回退兜底案,断言面两案通用)。 +**开工门**:U0 = 用户 `/iter` 发令——Q1–Q5 已于 v1.2 全裁(「2026-10-16 用户令:三卡全部待裁项按推荐方案裁决(用户将裁权授出,由主线会话代拍板留痕)」),迭代 30 编入同令定档(roadmap 编入已在案)。T0-③ 原型帧(Q1 丙案:shader 接触带柔光先行件)过目检后方可进 T1 全线铺码(若回退兜底案,断言面两案通用)。 --- From d5fe74708338e83bee0e70c70dad500fe8ebdf0b Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Sat, 17 Oct 2026 03:35:48 +0800 Subject: [PATCH 2/3] =?UTF-8?q?docs(cards):=20=E6=8C=89=202026-10-17=20?= =?UTF-8?q?=E6=96=87=E6=A1=A3=E5=90=8C=E6=AD=A5=E9=97=B8=20v3=20=E6=8D=A2?= =?UTF-8?q?=E4=BB=A3=E8=BF=AD=E4=BB=A3=2030=20=E4=B8=89=E5=8D=A1=EF=BC=88?= =?UTF-8?q?=E8=A1=A5=E9=81=97=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 在分支既有 v1.3 口径修订基础上补齐缺口,三卡对齐"代码实现批禁写 design/ 与根规则文件、产出物只落 reports/"的新批次规则: 卡① 未开格类型徽章批 - T2 末条「全闸」改「代码域闸(批末重闸)」:tools/run_all_gates.sh --code 对基线零新增红,并明示文档域闸不属本批改动域 - §11 grilling 审查记录末尾加 v1.3 口径注记:「三文档闸」一类闸件 枚举只读为历史记录,闸清单唯一出处=run_all_gates.sh 卡② 战斗一屏样张批 - §7.5 D4「迭代 29 门禁语义改动先后」由待定依赖改写为已结案: 2026-10-16 合入 master(fff4f120,roadmap.md:88 状态=已入库), 闸口径直接按当期语义跑 --code,原两分支消解 - §0 与开工门两处「迭代 29 自身 U0 未解」陈旧读数同步作废(与 D4 同源,避免卡内自相矛盾),「不构成排期承诺」口径不变 - §9 grilling 审查记录末尾加 v1.3 口径注记:「doc 三闸」一类闸件 枚举与「写入文档/登记 06」类落文表述只读为历史记录 卡③ 二三关棋盘观感批 - T1 采样源与 V2 判据两处「读数表进实现报告」补落位路径 reports/iter30-实现报告-<完成日>.md 闸:tools/run_all_gates.sh --docs 零新增红(回执 commit=d6b0c9fc 与 分支尖一致)。CLAUDE.md/roadmap.md/game/tests/README.md 与闸脚本零触碰。 --- .../research/需求卡片-二三关棋盘观感批-2026-10-16.md | 4 ++-- design/research/需求卡片-战斗一屏样张批-2026-10-16.md | 10 ++++++---- .../research/需求卡片-未开格类型徽章批-2026-10-16.md | 4 +++- 3 files changed, 11 insertions(+), 7 deletions(-) diff --git a/design/research/需求卡片-二三关棋盘观感批-2026-10-16.md b/design/research/需求卡片-二三关棋盘观感批-2026-10-16.md index f2481f72..6a9d1be8 100644 --- a/design/research/需求卡片-二三关棋盘观感批-2026-10-16.md +++ b/design/research/需求卡片-二三关棋盘观感批-2026-10-16.md @@ -142,7 +142,7 @@ ### T1 定性步骤(人闸前置;含 T1b 新建采样件合计 ≈2–2.5d,**必先做,产出物 = 定性报告 + 对比样张**) 逐关(L1 参照位·注意含 10×10 与 12×12 两板型〔F1〕 / L2 / L3)三测面采样。**采样源按测面分治(v1.1 修正)**: -- 测面一(棋盘瓦片区)与测面三(迷雾遮罩部分)= `board_shot_probe` 实机渲染帧(确定性可复现,C6;过程帧 render_gate 即弃——本批帧自行留档于库外目录,读数表进实现报告);**禁拿素材文件代替渲染帧**(迷雾遮罩/揭示态只在渲染帧里存在); +- 测面一(棋盘瓦片区)与测面三(迷雾遮罩部分)= `board_shot_probe` 实机渲染帧(确定性可复现,C6;过程帧 render_gate 即弃——本批帧自行留档于库外目录,读数表进 `reports/iter30-实现报告-<完成日>.md`);**禁拿素材文件代替渲染帧**(迷雾遮罩/揭示态只在渲染帧里存在); - 测面二(舞台底与屏根)= **现有探针拿不到**(board_shot_probe 帧内无舞台底/屏根像素;shot_probe 战斗屏只到 L1 首战)⇒ 由 **T1b 新建采样件**补齐,见下;退而求其次可用 UiKit 常量×帧内实测值合成 WCAG 对(可算,但板缘对比带需几何语境,合成判据只能佐证不能实证); - 测面三中的类型微光贡献 = 读数源仅样张 v2 静态定稿图(引擎未实装,F10),T1 报告如实标注该测面的证据级别。 @@ -213,7 +213,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 冻结版为准 | +| V2 | 修法后机检达标 | **既有口径不破坏**:样张主板断言 A6 ≥4.70 / F6 Δ≥18 / A3b Δ≥30 / 格底明度档(已开 L 0.08–0.14 / 墙顶 ≥0.30 / 饱和 ≤0.55)保持绿(v1.1 注:该组现行只跑 dungeon 拼板主板,对 L2/L3 属「不动即可」约束而非覆盖,C1 核注);**L2/L3 分关实测 = T1b 新建读数件出值**;shot_checker A–D+F 零新增红;`terrain_tile_sets_test`/`ui_contrast_probe` 全绿。**定向判据**(针对「累眼」的归因侧):若 T1 判「死黑面积」→ 全黑档面积占比与明度直方图 p10 改善入目标带;若判「对比带过宽」→ 墙顶/地面 Δ 与板/舞台底对值入 T1 定标带——目标带数值由 T1 报告给出、**T1 出口定性人闸冻结**,禁拍脑袋现编。**目标带自设的合法性注(v1.1)**:art-bible §4.1「待定现用」态只管圣经在册数值(现行即执法、调整=修订登记,:207 释义);本卡自设目标带**首先只是批次验收判据**,过闸即合法生效于本批;若某带值要长期执法,须写入 art-bible 相应节修订登记转「待定现用」态,禁以批次判据身份直接成为执法值 | 读数表(改前/改后并排)进 `reports/iter30-实现报告-<完成日>.md`;带值以 T1 冻结版为准 | | V3 | 渲染闸换代 | 先跑 `render_gate.sh` 见棋盘 golden 段红(确认破的是预期面)→ 跑 `golden_baseline_refresh.sh`(缺省=棋盘三张,菜单态触及加 `--menu`;素材齐盘前置)→ 复跑 `render_gate.sh` 全绿;三张新旧基线并排呈报,changed 面 = 预期面,零超预期漂移 | 闸日志 + 呈报件;提交说明含触发原因(契约 6) | | V4 | 用户实机目检 | 目检项登记(实现报告目检总清单;「入册 07」列反哺点)+ 用户回报「费劲感」相对改善且 L1 无退化——**登记不阻塞入库(2026-10-12 用户令)**;用户复判否决 = 回补机制触发:08 行回待做、06 本条记残留重开(落文按 v3 口径经反哺点归文档批)、返工起点=T1/T2 重议(不回滚已入库码面,按新条处置) | 主观判据的唯一权威=用户回报;入库前方向由契约 4 样张闸把关 | | V5 | 邻接零回归 | 冒烟全套 + 单元 + 探针链零新增红(呈现面触碰加跑 ui_contrast);同迭代徽章批断言面零回归(§4B X3) | 重闸 = `tools/run_all_gates.sh --code`(脚本即唯一闸清单) | diff --git a/design/research/需求卡片-战斗一屏样张批-2026-10-16.md b/design/research/需求卡片-战斗一屏样张批-2026-10-16.md index 0a59eb18..44cfecea 100644 --- a/design/research/需求卡片-战斗一屏样张批-2026-10-16.md +++ b/design/research/需求卡片-战斗一屏样张批-2026-10-16.md @@ -10,7 +10,7 @@ ## 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。**v1.3 注**:三卡文档直写义务已按 2026-10-17 文档同步闸 v3 全部转为反哺点(落 `reports/`,见 §8),上列汇聚文件重叠随之消解,但 2026-10-16 串行序位裁定不因此失效——序内仍有 golden 基线先后(§4B/§7.5 D2)与 art-bible 冻结内容先后(D1)依赖,禁三线并行维持。 +**串行位**:按 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 已于 2026-10-16 合入 master(合并提交 fff4f120,roadmap.md:88 状态=✅ 已入库;本卡原「迭代 29 U0 未解」读数随之作废,见 §7.5 D4),该前置已满足;本批开工时点仍取决于用户 `/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。**v1.3 注**:三卡文档直写义务已按 2026-10-17 文档同步闸 v3 全部转为反哺点(落 `reports/`,见 §8),上列汇聚文件重叠随之消解,但 2026-10-16 串行序位裁定不因此失效——序内仍有 golden 基线先后(§4B/§7.5 D2)与 art-bible 冻结内容先后(D1)依赖,禁三线并行维持。 **闸已立、机检面已跑过实机帧、样张判定物从未出**:整屏样张闸条款已于 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 排队行归后续批**)。**不新立闸条款。** @@ -233,7 +233,7 @@ | **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)。 +**开工门(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 已于 2026-10-16 合入 master(fff4f120,roadmap.md:88 状态=✅ 已入库,见 §7.5 D4),「迭代 29 完成后开工」的前置已满足,但仍不构成排期承诺(见 §0)。 ### 7.5 跨卡依赖(v1.1 新增——三卡次序耦合;v1.2 改实:三卡已编入迭代 30,串行序位已随 2026-10-16 用户令裁定=徽章→样张→观感,禁各自假设对方状态) @@ -242,7 +242,7 @@ | 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「不预设结论、归用户排期令」呈报框架关闭。**v1.3 注**:三卡文档直写义务已按文档同步闸 v3 全部转反哺点(落 `reports/`),汇聚文件重叠消解,但串行序位裁定不失效——golden 基线与冻结内容的先后依赖仍在(D1/D2) | -| D4 | **门禁语义改动的先后** | 迭代 29 测试分层与门禁语义修正批 | 该批改的就是 `tools/run_all_gates.sh`/探针判定/退出码权威语义(其契约 2「三硬闸不可绕过」),本卡 V7 的闸口径完全依赖该语义;**该批先行则本卡按其当期读数重采基线**(同其卡片 v1.3 串行裁决口径);若用户令本卡先行,本卡 V7 只按其当期闸表跑、不改写任何判定脚本 | +| D4 | **门禁语义改动的先后** | 迭代 29 测试分层与门禁语义修正批 | **已结案(2026-10-16 合入 master,合并提交 fff4f120;roadmap.md:88 状态=✅ 已入库)**:该批改的 `tools/run_all_gates.sh`/探针判定/退出码权威语义(其契约 2「三硬闸不可绕过」)已在现行闸内生效,本卡 V7 的闸口径直接按当期语义执行(本批 → `--code`)并按其当期读数采基线;原「该批先行/本卡先行」两种分支随之消解,本卡仍不改写任何判定脚本。(原两分支表述留档供沿革查 git log) | | D5 | **08 表现表同一表的多行改写** | 三卡+08 v1.6 定稿纪律 | 08 头注 L5 明文「Alpha 内容范围冻结,增删条目须经用户裁决」——三卡都只有**改状态列**的权限,**无一行可新增/删除**;本卡 T5 回写仅动「战斗一屏样张」一行,若需要为新条目动集合,一律 L3 呈报。**v1.3 注**:该「回写」执行为反哺点条目(仅动该行的改写要求照录进清单),零直改 | @@ -329,4 +329,6 @@ ### 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 订正面对表登记;其中头注版本号与他文档措辞是否订正,归各文档自身纪律与用户裁决。 \ No newline at end of file +`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 订正面对表登记;其中头注版本号与他文档措辞是否订正,归各文档自身纪律与用户裁决。 + +> **v1.3 口径换代注(2026-10-17 文档同步闸 v3)**:本节为 v1.1 时点的审查实录,原文不重写;其中「doc 三闸」一类闸件枚举字样与「写入文档/登记 06」类落文表述,按 v3 口径只读为历史记录——闸清单与域划分的唯一出处恒为 `tools/run_all_gates.sh`(本批按改动域跑 `--code` 档),文档落文一律列进 `reports/iter30-反哺点-<完成日>.md` 归文档批。 \ No newline at end of file diff --git a/design/research/需求卡片-未开格类型徽章批-2026-10-16.md b/design/research/需求卡片-未开格类型徽章批-2026-10-16.md index f1d4b682..55d51187 100644 --- a/design/research/需求卡片-未开格类型徽章批-2026-10-16.md +++ b/design/research/需求卡片-未开格类型徽章批-2026-10-16.md @@ -126,7 +126,7 @@ - **冒烟(数据侧)**:新段断言——微光格集合恒等于 `_diggable` 中身份可查者;九 cell_type 全值域归组五组封闭;封锁格/已开格零微光;**同板同序列 on/off 两态结算逐位一致**(契约 1,MC 触发细则内以探针级断言承载,不新起跑批)。 - **静态段**:ui_contrast_probe 静态段守卫延续——新增色值一律入 ui_kit 单点,呈现层裸 Color8 保持 0。 - **渲染闸(像素侧)**:渲染取证段扩——board_shot_probe 夹具板加微光 on/off 双帧:①on 帧逐格取样判定「非生效格像素零变化」(禁整格染色/禁越圈);②微光格砖心区(数字字形占位区等效域)灰度差 ≤阈值;③五组两两灰度带互辨抽检(shot_checker 同型 WCAG/灰度工具复用);④off 帧对 golden 基线 ≤2% 带(**Q4 丙案默认 on**,golden 棋盘三基线判读呈报——预期漂移在生效格集合内,超出即红)。 -- **全闸**:批末重闸 = `tools/run_all_gates.sh --code`(本批只碰 `game/` 代码与断言面;脚本即唯一闸清单)全绿。 +- **代码域闸(批末重闸)**:`tools/run_all_gates.sh --code`(本批只碰 `game/` 代码与断言面;脚本即唯一闸清单)对基线零新增红。文档域闸不属本批改动域,不进本批闸面。 ### T3(条件卡·Q3 已裁甲案不并入——本卡不启动,内容留档)TG_* 两带统一迁移(≈0.5d) @@ -300,3 +300,5 @@ art-bible §2.1 已裁:挖掘期画面里唯一在动的是接触带呼吸微 - **术语与中立性**:全文复扫新规用语表词形零命中(对照 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 未检出版本历史即把已裁面留进了待裁清单)。 + +> **v1.3 口径换代注(2026-10-17 文档同步闸 v3)**:本节为 v1.1 时点的审查实录,原文不重写;其中「三文档闸」一类闸件枚举字样按 v3 口径只读为历史记录,不作闸清单引用——闸清单与域划分的唯一出处恒为 `tools/run_all_gates.sh`,本批按改动域跑 `--code` 档。 From 480d811820172804dc9d3ec1061177e4c9ea5f72 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Sat, 17 Oct 2026 04:04:55 +0800 Subject: [PATCH 3/3] =?UTF-8?q?docs(cards):=20=E8=BF=AD=E4=BB=A330?= =?UTF-8?q?=E4=B8=89=E5=8D=A1=20v1.4=E2=80=94=E2=80=94=E5=BC=80=E5=B7=A5?= =?UTF-8?q?=E5=89=8D=E9=A2=84=E6=8E=88=E6=9D=83=20U1=20=E8=90=BD=E5=8D=A1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 用户在开工前一次性决断四项,防开发中反复打断;不写进卡片则 /iter 仍会按原文停机等话,故逐条落卡(2026-10-17): 卡① 未开格类型徽章批 - T0-③ shader 原型帧改「判据自判」:满足三条像素判据(五组去色相 可分/砖心不遮数字/接触带不越圈且非生效格零变化)即自行推进铺码, 不等回话;调参轮次上限 2 轮,超限停线回 Q1 复议(原「目检不过不过夜、 不承诺轮数」) - §8 增设「L3 预授权类」:共存撞墙退 a 案程序绘制兜底/golden 换代按 契约 6 显式流程/色弱不可分先在 provisional 梯度内自调一轮——三件 批内处置+留痕;触既有裁决面类(翻动五组色相/on-off 位差/T3 触发/ 重开裁点)维持停机 - §10 开工门新增 U1 预授权条 卡③ 二三关棋盘观感批 - Q2 甲/乙由「延裁·T1 出口现场裁」改「判据自动裁」:甲案候选样张读数 达标即走甲不停机,仅读数证伪「纹理太碎」才呈报裁乙 - V2 定向目标带授权批内按 T1 实测读数自定、随定性报告呈报即生效; T1 出口定性人闸(06 已裁硬步骤)只确认轴归因与修法方向 - §10 开工门新增 U1 预授权条,其余 L3 维持停机 卡② 战斗一屏样张批(复查结论留痕,零机制改动) - U1 预授权对本卡不适用:两处人闸(T1 方向稿选划/T3 气质终审)是 防不满意机制本体,取消即拆机制 - 四项 L3 经分类全部属「触既有裁决面/超本批面」,维持停机呈报; §6 留分类结论注防重复呈报 闸:tools/run_all_gates.sh --docs 零新增红。roadmap/CLAUDE.md/ game/tests/README.md 与闸脚本零触碰。 --- .../需求卡片-二三关棋盘观感批-2026-10-16.md | 14 ++++++++++---- .../research/需求卡片-战斗一屏样张批-2026-10-16.md | 3 ++- .../需求卡片-未开格类型徽章批-2026-10-16.md | 12 +++++++++--- 3 files changed, 21 insertions(+), 8 deletions(-) diff --git a/design/research/需求卡片-二三关棋盘观感批-2026-10-16.md b/design/research/需求卡片-二三关棋盘观感批-2026-10-16.md index 6a9d1be8..a191a028 100644 --- a/design/research/需求卡片-二三关棋盘观感批-2026-10-16.md +++ b/design/research/需求卡片-二三关棋盘观感批-2026-10-16.md @@ -1,6 +1,6 @@ # 需求卡片:第二 / 三关棋盘观感——亮度与对比度批(T1 定性人闸 · T2 按轴修法 · 验收三件套 · 文档面全走反哺点) -- 版本:**v1.3(2026-10-17 文档同步闸 v3 口径修订,纯文档批〔分支 carddoc-20261017〕按用户六条裁定执行——①本批(代码实现批)禁写 `design/` 整目录与根规则文件,§5 同步面的同步义务一律执行为「列进 `reports/iter30-反哺点-<完成日>.md`(哪个文件哪一节、改成什么、依据),用户会话裁决后归文档批落文」;②产出物落位换代:实现报告/代拍板追认单/反哺点清单三份落 `reports/`,不再 `design/qa/`;③T5 末卡改「产出物落位卡」(三份 reports/ 文件写齐才算收口);④闸口径按域选档:重闸 = `tools/run_all_gates.sh` 按改动域选档(本批 → `--code`),卡内不再写死闸件名单与「全量档」类字样;⑤实机目检项写进 `reports/iter30-实现报告-<完成日>.md` 实机目检总清单,「登记 07」转反哺点;§10 裁决留痕原文不动);v1.2(2026-10-16 裁决留痕版:三卡待裁项按用户令定案——Q3 已裁甲·同批、Q2 延裁留痕并将裁点挂至 T1 出口呈报硬流程步骤、排期栏定实「已编入迭代 30」与三卡串行序位、§4B 跨卡依赖按已裁事实改实、全卡零悬空待裁点;v1.1 同日 grilling 审查修订见 §11;v1.0 同日成文)** +- 版本:**v1.4(2026-10-17 开工前预授权 U1〔用户于开工前一次性决断,防开发中反复打断〕——①Q2 甲/乙由「延裁·T1 出口现场裁」改**判据自动裁**:甲案候选样张读数达标即直接走甲不停机,仅当读数证伪「纹理太碎」假说时才呈报裁乙;②V2 定向目标带数值授权批内按 T1 实测读数自定并随定性报告呈报,T1 出口人闸只确认轴归因与修法方向;③详见 §10 Q2 条与开工门 U1 预授权条);v1.3(2026-10-17 文档同步闸 v3 口径修订,纯文档批〔分支 carddoc-20261017〕按用户六条裁定执行——①本批(代码实现批)禁写 `design/` 整目录与根规则文件,§5 同步面的同步义务一律执行为「列进 `reports/iter30-反哺点-<完成日>.md`(哪个文件哪一节、改成什么、依据),用户会话裁决后归文档批落文」;②产出物落位换代:实现报告/代拍板追认单/反哺点清单三份落 `reports/`,不再 `design/qa/`;③T5 末卡改「产出物落位卡」(三份 reports/ 文件写齐才算收口);④闸口径按域选档:重闸 = `tools/run_all_gates.sh` 按改动域选档(本批 → `--code`),卡内不再写死闸件名单与「全量档」类字样;⑤实机目检项写进 `reports/iter30-实现报告-<完成日>.md` 实机目检总清单,「登记 07」转反哺点;§10 裁决留痕原文不动);v1.2(2026-10-16 裁决留痕版:三卡待裁项按用户令定案——Q3 已裁甲·同批、Q2 延裁留痕并将裁点挂至 T1 出口呈报硬流程步骤、排期栏定实「已编入迭代 30」与三卡串行序位、§4B 跨卡依赖按已裁事实改实、全卡零悬空待裁点;v1.1 同日 grilling 审查修订见 §11;v1.0 同日成文)** - 来源:[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)。 @@ -166,7 +166,7 @@ **T1 出口素材轴甲/乙裁决呈报点(v1.2 新增硬流程步骤——Q2 延裁所挂裁点的具名呈报动作,裁决留痕见 §10)**: - **触发条件**:T1 归因结论产出即触发,随定性报告一并呈报(无论归因指向哪条轴,呈报不可省略); - **动作**:开工默认先做**甲案(recolor 换色)候选样张**——按甲案试算槽值出改前/改后并排样张,用 T1b 分关读数证伪「纹理太碎」假说(甲样张读数达标而用户方向仍否决 = 指向乙); -- **产物与落点**:改前/改后并排样张 + 分关读数表(含甲案试算槽值清单)随定性报告呈报用户,**用户当场裁甲/乙**,结论按 §10 格式补记留痕后即成 T2 执行依据——裁点由该具名动作承载,全卡不留悬空待裁点。 +- **产物与落点**:改前/改后并排样张 + 分关读数表(含甲案试算槽值清单)随定性报告呈报用户。**v1.4 预授权(2026-10-17 用户裁)**:甲案样张读数达标即按 §10 Q2 判据**自动走甲**、不停机等现场裁;仅当读数证伪「纹理太碎」假说时才呈报裁乙(呈报内容照旧:改前/改后并排样张+分关读数表)。结论按 §10 格式补记留痕后即成 T2 执行依据——裁点由该具名动作承载,全卡不留悬空待裁点。 ### T2 修法(按轴分支;≈1.5–2.5d,落码前须过契约 4 对比样张人闸) @@ -212,8 +212,8 @@ | # | 需求点 | 测什么 | 判据 | |---|---|---|---| -| 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 相应节修订登记转「待定现用」态,禁以批次判据身份直接成为执法值 | 读数表(改前/改后并排)进 `reports/iter30-实现报告-<完成日>.md`;带值以 T1 冻结版为准 | +| V1 | T1 定性报告 | 读数表覆盖 3 关 × 3 测面 × 各指标(§6 T1 表全列,测面二经 T1b 全框帧);L1 参照位在场(含两板型,F1);归因结论引用数值;**v1.2 增**:甲/乙裁决呈报件(甲案候选样张+分关读数表)随报告同出、用户当场裁决记录在案(§6 T1 呈报硬步骤) | 报告模板齐件 + 用户过闸记录在案(**T1 出口定性人闸=06 已裁硬步骤,P1**;**v1.4 预授权:人闸只确认轴归因与修法方向,V2 定向目标带数值由批内按 T1 实测读数自定并随定性报告呈报,禁拍脑袋现编**)+ 裁决留痕补记 §10 | +| V2 | 修法后机检达标 | **既有口径不破坏**:样张主板断言 A6 ≥4.70 / F6 Δ≥18 / A3b Δ≥30 / 格底明度档(已开 L 0.08–0.14 / 墙顶 ≥0.30 / 饱和 ≤0.55)保持绿(v1.1 注:该组现行只跑 dungeon 拼板主板,对 L2/L3 属「不动即可」约束而非覆盖,C1 核注);**L2/L3 分关实测 = T1b 新建读数件出值**;shot_checker A–D+F 零新增红;`terrain_tile_sets_test`/`ui_contrast_probe` 全绿。**定向判据**(针对「累眼」的归因侧):若 T1 判「死黑面积」→ 全黑档面积占比与明度直方图 p10 改善入目标带;若判「对比带过宽」→ 墙顶/地面 Δ 与板/舞台底对值入 T1 定标带——目标带数值由 T1 报告给出、**T1 出口定性人闸冻结**,禁拍脑袋现编。**目标带自设的合法性注(v1.1)**:art-bible §4.1「待定现用」态只管圣经在册数值(现行即执法、调整=修订登记,:207 释义);本卡自设目标带**首先只是批次验收判据**,过闸即合法生效于本批;若某带值要长期执法,须写入 art-bible 相应节修订登记转「待定现用」态,禁以批次判据身份直接成为执法值 | 读数表(改前/改后并排)进 `reports/iter30-实现报告-<完成日>.md`;**v1.4 预授权:目标带数值由批内按 T1 实测读数自定、随定性报告呈报即生效**(原「人闸冻结目标带」改为「人闸确认方向与量级」,数值仍禁拍脑袋现编) | | V3 | 渲染闸换代 | 先跑 `render_gate.sh` 见棋盘 golden 段红(确认破的是预期面)→ 跑 `golden_baseline_refresh.sh`(缺省=棋盘三张,菜单态触及加 `--menu`;素材齐盘前置)→ 复跑 `render_gate.sh` 全绿;三张新旧基线并排呈报,changed 面 = 预期面,零超预期漂移 | 闸日志 + 呈报件;提交说明含触发原因(契约 6) | | V4 | 用户实机目检 | 目检项登记(实现报告目检总清单;「入册 07」列反哺点)+ 用户回报「费劲感」相对改善且 L1 无退化——**登记不阻塞入库(2026-10-12 用户令)**;用户复判否决 = 回补机制触发:08 行回待做、06 本条记残留重开(落文按 v3 口径经反哺点归文档批)、返工起点=T1/T2 重议(不回滚已入库码面,按新条处置) | 主观判据的唯一权威=用户回报;入库前方向由契约 4 样张闸把关 | | V5 | 邻接零回归 | 冒烟全套 + 单元 + 探针链零新增红(呈现面触碰加跑 ui_contrast);同迭代徽章批断言面零回归(§4B X3) | 重闸 = `tools/run_all_gates.sh --code`(脚本即唯一闸清单) | @@ -252,6 +252,7 @@ ### Q2 · 素材轴修法走哪案:程序换色重校(甲)还是瓦片重产(乙)?——**延裁留痕** - **裁决(2026-10-16 用户令,来源句见本节顶)**:「待 T1 定性读数出来后再裁甲/乙;开工默认先做甲案(recolor 换色)候选样张以证伪纹理说」。 +- **v1.4 预授权(2026-10-17 用户裁):延裁改判据自动裁,不再停机等现场裁**——甲案候选样张读数达标(进入 §7 V2 定向目标带)→ **直接走甲**;仅当读数**证伪**「纹理太碎」假说(甲样张读数不达标、方向仍不成立)时才呈报裁乙。乙案分支的代价与划界(P4/§6 乙案行:本卡重产 ≠ 放开升档、规格与样张卡已冻结目标规格清单对齐)全部不变。 - **延裁≠回避**:裁点挂到 T1 出口的**具名呈报动作**——硬流程步骤(触发条件/动作/产物)已成文于 §6 T1「素材轴甲/乙裁决呈报点」:产物=改前/改后并排样张+分关读数表,呈报后**用户当场裁**。本节不留悬空 Q。 - **判据(原文照录)**:判据 = T1 归因指向:亮度秩序/对比带问题 → 甲可直达;纹理本身太碎太 busy → 甲调不动(recolor 头注定死「亮度秩序逐像素保持」,方法学上限;碎纹理假说在案证据 = 2026-10-14 美术审计双峰纹理结论条),须乙。乙与 08/06「素材升档重产」的关系已划界(P4/§6 乙案行):本卡重产 ≠ 放开升档,裁乙不重开该未决项。 - **选项原文(保留)**:甲=recolor 换色重校(确定性、可复现、逐项可机检比对、零新素材;效果上限 = 参数域内明度/色相重排);乙=远程生图重产(可重设计纹理与高频细节,上限高;周期长、非确定性、全套闸重跑;若裁,规格与样张卡已冻结目标规格清单对齐、样张规格先行——§4B X2)。 @@ -265,6 +266,11 @@ **开工门(v1.2 定实)**:Q3 已裁甲·同批;Q2 裁点由 T1 出口呈报硬流程步骤承载(§6 T1)——开工门 = U0,用户 `/iter` 发令即开(已编入迭代 30,2026-10-16 用户令,排期栏);原「Q2/Q3 裁决落」前置表述不再成立。本卡全卡无悬空待裁点(§10 之外各处 Q 指涉均已改为裁决留痕/流程步骤引用)。 +**U1 预授权(2026-10-17 用户于开工前一次性决断,防开发中反复打断)**: +1. **Q2 判据自动裁**——甲案候选样张读数达标即走甲,不停机等现场裁;仅读数证伪「纹理太碎」才呈报裁乙(§10 Q2、§6 T1 出口呈报点)。 +2. **V2 定向目标带授权批内自定**——按 T1 实测读数定并随定性报告呈报;T1 出口定性人闸(06 已裁硬步骤,不可跳过)只确认轴归因与修法方向。 +3. 其余 L3 停机点维持不变:触既有裁决面类(L1 同病外溢/迷雾概念定义本体/方向被否决两次以上/golden changed 超预期/色板双门/跨卡次序破裂)一律停机呈报。三卡串行序位不变(徽章→样张→观感),本卡位第 3。 + --- ## 11. grilling 审查记录(v1.0→v1.1,2026-10-16 对抗性审查;逐攻击面:结论/证据/处置) diff --git a/design/research/需求卡片-战斗一屏样张批-2026-10-16.md b/design/research/需求卡片-战斗一屏样张批-2026-10-16.md index 44cfecea..27c8a88b 100644 --- a/design/research/需求卡片-战斗一屏样张批-2026-10-16.md +++ b/design/research/需求卡片-战斗一屏样张批-2026-10-16.md @@ -1,6 +1,6 @@ # 需求卡片:战斗一屏样张批(整屏样张判定物首跑 · 四屏样张排程 · 防不满意工序重排) -- 版本:**v1.3**(2026-10-17 文档同步闸 v3 口径修订,纯文档批〔分支 carddoc-20261017〕按用户六条裁定执行——①本批(代码实现批,此处含样张工具面)禁写 `design/` 整目录与根规则文件,§8 同步面的同步义务一律执行为「列进 `reports/iter30-反哺点-<完成日>.md`(哪个文件哪一节、写成什么、依据),用户会话裁决后归文档批落文」;冻结记录段全文、目标规格清单、H1–H11 逐项处置、徽章明度档复核转正记录等**成文内容本体随反哺点条目交付**;②产出物落位换代:实现报告/代拍板追认单/反哺点清单三份落 `reports/`,不再 `design/qa/`;③T5 末卡改「产出物落位卡」(三份 reports/ 文件写齐才算收口);④闸口径按域选档:重闸 = `tools/run_all_gates.sh` 按改动域选档(本批触碰 `tools/` 样张面 → `--code`),卡内不再用「全量档全绿」类字样;⑤实机目检项写进 `reports/iter30-实现报告-<完成日>.md` 目检总清单,「入册 07」转反哺点;§7 裁决留痕原文不动,其落文类表述的执行口径随本版换代);**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 条逐条改挂实存工具,判不了项降级并注明手段。 +- 版本:**v1.4**(2026-10-17 开工前预授权复查:本卡**不适用** U1 预授权——两处人闸(T1 方向稿选划/T3 气质终审)是防不满意机制本体,取消即拆机制;四项 L3 经分类**全部属「触既有裁决面/超出本批面」类,维持停机呈报**,详见 §6 分类结论注);**v1.3**(2026-10-17 文档同步闸 v3 口径修订,纯文档批〔分支 carddoc-20261017〕按用户六条裁定执行——①本批(代码实现批,此处含样张工具面)禁写 `design/` 整目录与根规则文件,§8 同步面的同步义务一律执行为「列进 `reports/iter30-反哺点-<完成日>.md`(哪个文件哪一节、写成什么、依据),用户会话裁决后归文档批落文」;冻结记录段全文、目标规格清单、H1–H11 逐项处置、徽章明度档复核转正记录等**成文内容本体随反哺点条目交付**;②产出物落位换代:实现报告/代拍板追认单/反哺点清单三份落 `reports/`,不再 `design/qa/`;③T5 末卡改「产出物落位卡」(三份 reports/ 文件写齐才算收口);④闸口径按域选档:重闸 = `tools/run_all_gates.sh` 按改动域选档(本批触碰 `tools/` 样张面 → `--code`),卡内不再用「全量档全绿」类字样;⑤实机目检项写进 `reports/iter30-实现报告-<完成日>.md` 目检总清单,「入册 07」转反哺点;§7 裁决留痕原文不动,其落文类表述的执行口径随本版换代);**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) @@ -217,6 +217,7 @@ - **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 跨卡前提冲突**(任一后续卡的前提在执行中被否定——三卡串行序位已裁=徽章→样张→观感,本条保留为序内冲突兜底)。 +- **L3 分类结论注(2026-10-17 用户裁 U1 预授权时一并复查,留痕防重复呈报)**:本卡四项 L3 **全部归入「触既有裁决面/超出本批面」类,一律维持停机呈报**——①v3 管线不可跑通且修复超样张面=超出本批面;②方向稿全否=回 Q1 口径复核(Q1 已裁丙案,重裁须用户);③A4 尺寸基线解冻=圣经 §1.4 L68 明文须走修订;④跨卡前提冲突=序位裁定面。本卡无一属于「可自动处置类」,故 U1 预授权对本卡零改动。**两处人闸(T1 方向稿选划/T3 气质终审)同属不可取消项**:契约 2「跳过方向稿=本批最高级违例」、契约 4「机检全绿不构成过闸且本批关闭豁免通道」,取消即拆掉防不满意机制本体。 --- diff --git a/design/research/需求卡片-未开格类型徽章批-2026-10-16.md b/design/research/需求卡片-未开格类型徽章批-2026-10-16.md index 55d51187..41c54177 100644 --- a/design/research/需求卡片-未开格类型徽章批-2026-10-16.md +++ b/design/research/需求卡片-未开格类型徽章批-2026-10-16.md @@ -1,6 +1,6 @@ # 需求卡片:未开格类型徽章批(类型微光实施)——迭代 30 -- 版本:**v1.3**(2026-10-17 文档同步闸 v3 口径修订,纯文档批〔分支 carddoc-20261017〕按用户六条裁定执行——①本批(代码实现批)禁写 `design/` 整目录与根规则文件,§5 同步面的同步义务一律执行为「列进 `reports/iter30-反哺点-<完成日>.md`(哪个文件哪一节、改成什么、依据),用户会话裁决后归文档批落文」;②产出物落位换代:实现报告/代拍板追认单/反哺点清单三份落 `reports/`,不再 `design/qa/`;③T4 末卡改「产出物落位卡」(三份 reports/ 文件写齐才算收口);④闸口径按域选档:重闸 = `tools/run_all_gates.sh` 按改动域选档(本批只碰 `game/` 代码与断言面 → `--code`),卡内不再写死闸件名单、不再用「全量档全绿」「文档三闸」类字样;⑤实机目检项写进 `reports/iter30-实现报告-<完成日>.md` 实机目检总清单,「入册 07-体验验证清单」转反哺点;§10 裁定留痕原文不动,其落文类表述的执行口径随本版换代);v1.2(2026-10-16 裁决五项+排期定档——「2026-10-16 用户令:三卡全部待裁项按推荐方案裁决(用户将裁权授出,由主线会话代拍板留痕)」:Q1 丙/Q2 甲/Q3 甲/Q4 丙/Q5 甲,逐条留痕见 §10 各 Q 裁定行;排期定档迭代 30 已编入);v1.1(2026-10-16 成文;同日 grilling 对抗性审查修订——事实五处复核/Q2 缩窄为明度档裁点(五组色相属已裁项不再问)/全部推荐语中立化/轮次承诺与性能预判撤下/验证闸判具补全/跨卡次序依赖单列——修订清单见 §11 审查记录) +- 版本:**v1.4**(2026-10-17 开工前预授权 U1〔用户于开工前一次性决断,防开发中反复打断〕——①T0-③ shader 原型帧改**判据自判**:三条像素判据过即自行推进铺码,调参轮次上限 2 轮、超则停线回 Q1 复议;②L3 分类预授权:可自动处置类(shader 与 `_desat_mat` 共存撞墙退 a 案程序绘制兜底/色弱抽检五组灰度不可分先在 provisional 梯度内自调一轮再判/golden 换代按契约 6 显式流程执行)由批内处置+留痕,触既有裁决面类维持停机呈报;③详见 §10 开工门 U1 预授权条);**v1.3**(2026-10-17 文档同步闸 v3 口径修订,纯文档批〔分支 carddoc-20261017〕按用户六条裁定执行——①本批(代码实现批)禁写 `design/` 整目录与根规则文件,§5 同步面的同步义务一律执行为「列进 `reports/iter30-反哺点-<完成日>.md`(哪个文件哪一节、改成什么、依据),用户会话裁决后归文档批落文」;②产出物落位换代:实现报告/代拍板追认单/反哺点清单三份落 `reports/`,不再 `design/qa/`;③T4 末卡改「产出物落位卡」(三份 reports/ 文件写齐才算收口);④闸口径按域选档:重闸 = `tools/run_all_gates.sh` 按改动域选档(本批只碰 `game/` 代码与断言面 → `--code`),卡内不再写死闸件名单、不再用「全量档全绿」「文档三闸」类字样;⑤实机目检项写进 `reports/iter30-实现报告-<完成日>.md` 实机目检总清单,「入册 07-体验验证清单」转反哺点;§10 裁定留痕原文不动,其落文类表述的执行口径随本版换代);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)。 @@ -110,7 +110,7 @@ - **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-③ 路线原型先行(对「很丑」质疑的实证步骤)**:**按 Q1 已裁丙案执行——「shader 接触带柔光原型帧」为本件先行产出物**:CellUnit 共享 ShaderMaterial 距离场柔光渐变原型帧(微光 on/off + 五组并列 + 相邻格泛光接触),同时给出 shader 参数面板(uniform 暴露带宽/α/衰减形状),后续调优可直接改参数表不改代码;程序绘制(a 案)兜底件同帧出对比,供 §8 L3 回退判据留样。**v1.4 预授权(2026-10-17 用户裁):原型帧改判据自判,不再逐轮等回话**——满足三条像素判据即视为过闸、自行推进铺码:①五组并列在去色相模拟下仍可分(V6 同口径抽检);②砖心数字字形占位区灰度扰动 ≤阈值(V4);③接触带不越圈、非生效格像素零变化(V4)。**调参轮次上限 = 2 轮**(出帧+改参各记一轮),超上限即停线回 Q1 复议,禁批内自开第三轮;未过原型判据禁止全线铺码。批末 V10 仍是唯一终审人闸(登记不阻塞)。能力申报保留:视觉调优不承诺一次到位。 - **T0-④ 基线与行号复核**:本卡 §2 全部出处复核一遍;冒烟/golden 当期读数冻结为改前锚(golden 基线 2026-09-30 代,若判失效按 iter29 卡先例呈报,禁擅自重制)。 ### T1 实施主卡(≈1–1.5d,内容按 Q1 丙/Q3 甲/Q4 丙 既裁案收敛) @@ -165,7 +165,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 复核结论)。 +- **L3(停机呈报)**:偏离 Q1–Q5 既裁案(丙/甲/甲/丙/甲,v1.2)或未经追加裁决重开裁点先动;原型帧调参超 2 轮上限、或实施判为路线级存疑(停线回 Q1 复议);on/off 两态结算出现任一位差(契约 1 破);色弱抽检自调一轮后仍判五组灰度不可分(S5 值域重裁);T3 触发既有断言改写;实施中任何翻动 art-bible §4.2 五组色相既裁冻结面的诉求(Q2 复核结论)。 +- **L3 预授权类(2026-10-17 用户裁:批内处置+留痕,不停机等话)**:①shader 与 `_desat_mat` 共存实测撞墙 → 直接退 Q1 丙案兜底路径(a 案程序绘制),断言面两案通用,留痕即可;②golden 基线判失效 → 按契约 6 显式流程重制并呈报换代面(脚本逐项守卫+提交说明写明触发原因),不再停机等批令;③色弱抽检首次判五组灰度不可分 → 先在 Q2 甲案 provisional 明度梯度域内自调一轮再判,仍不可分才升 L3 停机。 --- @@ -265,6 +266,11 @@ art-bible §2.1 已裁:挖掘期画面里唯一在动的是接触带呼吸微 **开工门**:U0 = 用户 `/iter` 发令——Q1–Q5 已于 v1.2 全裁(「2026-10-16 用户令:三卡全部待裁项按推荐方案裁决(用户将裁权授出,由主线会话代拍板留痕)」),迭代 30 编入同令定档(roadmap 编入已在案)。T0-③ 原型帧(Q1 丙案:shader 接触带柔光先行件)过目检后方可进 T1 全线铺码(若回退兜底案,断言面两案通用)。 +**U1 预授权(2026-10-17 用户于开工前一次性决断,防开发中反复打断)**: +1. **原型帧判据自判**——满足三条像素判据(五组去色相可分/砖心不遮数字/接触带不越圈且非生效格零变化)即自行推进铺码,不等回话;调参上限 2 轮,超限停线回 Q1 复议(§6 T0-③)。 +2. **L3 分类预授权**——可自动处置三件(共存撞墙退 a 案/golden 换代走契约 6/色弱不可分先自调一轮)批内处置+留痕;触既有裁决面类(翻动五组色相、on/off 位差、T3 触发、重开裁点)维持停机呈报(§8)。 +3. 上述两点之外,批内不再停机等话;三卡串行序位不变(徽章→样张→观感),本卡位第 1。 + --- ## 11. grilling 审查记录(v1.1,2026-10-16,对抗性审查)