From a08d89c64673cf2b38d52db0cea9f25b9cabf964 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Mon, 28 Sep 2026 04:56:19 +0800 Subject: [PATCH] =?UTF-8?q?docs(qa):=20T5=20M-1=20=E5=87=BA=E5=8F=A3?= =?UTF-8?q?=E9=97=B8=E6=A3=80=E6=9F=A5=E5=8D=95=E6=88=90=E6=96=87+06=20?= =?UTF-8?q?=E4=B8=A4=E6=9D=A1=E7=9B=AE=E6=94=B6=E5=8F=A3+roadmap=20?= =?UTF-8?q?=E6=8C=82=E8=B5=B7=E6=B8=85=E5=8D=95=E5=AF=B9=E9=BD=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 检查单 design/qa/m1-exit-gate-checklist-2026-09-28.md:迭代 1+2 机器闸读数汇总+真人目检八项(逐项可勾,1-7 过=M-1 关闭→M-2 解锁)+✦ 缺料清单八件(B 区背景横幅/八敌种立绘/主角旗色手修/行进器/序列帧可选/巢穴纹封印纹样/变异纹带/格面徽章——只登记不生图)+代拍板追认五项。 06 解决即移除:「战斗画面表现收口(循环 2 输入清单)」与「棋盘数字呈现优化(色牌=临时档)」两 entries 删除(样张 v2 冻结/框材接线/演出终稿/数字终稿全落籍——draw calls 归 Alpha 验收批 roadmap 卡④承载,本关强化接线归 C 区预留条目)。 roadmap 挂起清单对齐:样张 v1 否决原因闸移已解闸存档;挂起改为=真人试玩/M-1 目检/迭代 1 T4 在飞。 --- design/gdd/06-待办清单.md | 21 ------- .../qa/m1-exit-gate-checklist-2026-09-28.md | 59 +++++++++++++++++++ roadmap.md | 2 +- 3 files changed, 60 insertions(+), 22 deletions(-) create mode 100644 design/qa/m1-exit-gate-checklist-2026-09-28.md diff --git a/design/gdd/06-待办清单.md b/design/gdd/06-待办清单.md index 18e2223f..79bd6972 100644 --- a/design/gdd/06-待办清单.md +++ b/design/gdd/06-待办清单.md @@ -423,24 +423,3 @@ NodeOverlay 现行实态为模态覆盖层：恢复点全量服务（回复读 ### 设置与本地化 - -#### 战斗画面表现收口（循环 2 输入清单，2026-09-26 登记） - -**现状**：2026-09-26 用户令「需要做的都记录进待办」后盘点登记；能修的已修完（数字色牌/墙轮廓/血量数字/小人脚浮/字形错位/入场演出，台账 176-181），剩余七项—— - -- **界面环境与框材组 8 件**：规格与渠道已登记 art-assets-checklist §4.1；♻ 件待用户审阅 ui-reuse 候选包挑批后接线，✦ 背景横幅待样张 v2 冻结后生图 -- **战斗一屏样张 v2 重出**：v1 已否，重 roll 预算剩 2 轮；**验收闸形已拍（2026-09-27）=A 机检冻结零参与**——用户补否决原因一句话后转成机检断言集（原 12 条+气质代理断言），v2 机检全过即冻结落码、批末用户目检否决才返工；过=v2 冻结为换皮输入。**待输入 = v1 否决原因一句话（用户已认领待补）** -- **高墙感挑档落码**：**已拍板（2026-09-27）=D 投影档**（研究件四变体，用户三选一裁决），迭代 1 实装改常量；研究件现路径 artwork/mockups/（目录收敛随迁） -- **CJK 字体随包**：**已拍板（2026-09-27）=Fusion Pixel OFL**（用户二选一裁决；CJK 覆盖+授权干净定案），迭代 1 实装入包 -- **演出密度**：死亡碎裂序列帧/胜利碎砖纹章/失败坐砖掸灰/意图与结算动画终稿——需样张 v2 冻结动画方案 -- **本关强化列表数据接线**：本清单既有 C 区预留区条目承载，不重登 -- **draw calls 270→<200**：归 Alpha 验收批，真机测量后优化 - -敌人立绘素材=用户外部生成中（八敌种槽位已接线，素材入库即自动显示），不入本条。棋盘数字呈现优化（色牌临时档）另见本清单同日条目。 - -**归属**：循环 2 计划书（样张 v2 冻结后另立） -#### 棋盘数字呈现优化（色牌=临时档，2026-09-26 登记） - -**现状**：2026-09-26 用户实机反馈——现行数字呈现（米白色牌+墨字，呈现修复批落码）**太丑，只作临时档**，「现在够用」；终稿数字呈现方案待设计（候选方向：色牌形制/字号字体/去牌化直写+描边/与瓦片一体的雕刻数字等），归样张 v2 冻结视觉语言后的表现批一并定。**备忘性质**：防止临时档被当成终稿遗忘。 - -**归属**：战斗画面表现收口条（循环 2）；判据续用 §1.4 验收 1（可读性硬指标不因形制放松） diff --git a/design/qa/m1-exit-gate-checklist-2026-09-28.md b/design/qa/m1-exit-gate-checklist-2026-09-28.md new file mode 100644 index 00000000..78ac605f --- /dev/null +++ b/design/qa/m1-exit-gate-checklist-2026-09-28.md @@ -0,0 +1,59 @@ +# M-1 出口闸检查单（2026-09-28，迭代 2 收口批交付） + +> 用途：M-1「切片表现收口」出口闸 = **真人目检清单全绿**（机器闸已全部自动过）；本单即人闸载体，逐项可勾。 +> 全绿 = M-1 关闭 → **M-2 迭代 3「读数重测与调参」解锁**（其门=M-1 出口闸）。 +> 目检方式：实机跑 `godot --path game`（或开 Godot 编辑器 F5），按清单逐项看；任一项不过 = 回该批返工（样张类至多一轮，收集否决维度补断言后重出）。 + +## 一、机器闸读数汇总（已自动过，留痕） + +### 迭代 1（m1-iter1-20260928 worktree，2026-09-28 台账 216/217） +| 卡 | 内容 | 读数 | +|---|---|---| +| T1 单元测试与契约层 | 七套件实跑入口 tests/run_all.gd | 全绿 | +| T2 高墙感 D 投影档落码 | 立面双段暗带+地面投影（用户挑档 D） | 冒烟 557/0+双探针 PASS | +| T3 CJK 字体随包 | Fusion Pixel OFL zh_hans+第八套件 ui_font_asset_test | 冒烟 557/0+8 套件全绿 | + +### 迭代 2（本 loop，f9b0765→2d1388b） +| 卡 | 内容 | 读数 | +|---|---|---| +| T1 样张 v2 重出+机检冻结 | 机检 **16/16 全绿**（13 现行+A3 Δ≥55+F6 双明度带+F7 悬崖同源+A6 观感密度）→ 四冻结落文 art-bible v2.13 | 报告 `design/research/sample-v2-机检报告-2026-09-28.md` | +| T2 框材组 8 件换皮 | ♻ 九件量化改色入包+UiKit 单点工厂+五视图接线 | 冒烟 557/0+四探针 PASS | +| T3 演出密度终稿 | 死亡碎裂/胜利纹章/失败掸灰/意图三档/结算光带+**fx_probe 新探针** | 冒烟 557/0+五探针 PASS | +| T4 棋盘数字终稿 | 三档墨色温/字号 ≥18 公式/色牌 0.60·0.62 冻结值 | 冒烟 557/0+五探针（ui_tune_probe 回归含） | + +- 冒烟检查数 557 = 开工基线（零删减）；合并后主区复跑留痕见台账 219。 +- 迭代 1 未落籍注记：m1-iter1 worktree 尚有 T4 关卡画面实装在飞（main.gd/route_overlay/双探针四文件），本 loop 弱耦合避让未触碰；其落籍不阻塞本人闸（目检第 8 项注两级状态）。 + +## 二、真人目检清单（逐项可勾，勾完=人闸过） + +- [ ] **1. 棋盘立体感**（样张 v2 否决③复核）：战斗中未开墙格有南立面暗带+地面投影，整板底部/右侧有悬崖暗面与悬浮影——「立得起来」 +- [ ] **2. 观感密度**（否决①复核）：棋盘整体不觉得平/糊——裂纹碎石变体、类型微光、物件纹样层次可感 +- [ ] **3. 数字可读**：1-8 数字色牌上清晰（三档墨色温：小数字偏冷、大数字偏暖），缩小窗口仍可读 +- [ ] **4. 换皮框架**：C 区面板/B 区舞台底/图例弹窗=石板质感九宫格；全站按钮=暖砖两态（按下下沉）；开始界面有石纹底噪；营地有石框容器+钥石/柜台图标 +- [ ] **5. 演出四项**：击杀敌人→灰化+碎块弹飞（非瞬间消失）；胜利→金蜡封落下+碎砖拼纹章环；失败→暮蓝氛围+尘絮飘落+旗光点收回；敌摇定特殊技→徽标弹跳、重击→缓推蓄力定格 +- [ ] **6. 结算光带**：轮末结算金光带自棋盘上缘扫向下缘，带前缘有亮线 +- [ ] **7. 图例正确性**：图例旗条目为封印黑色块、墨字可读 +- [ ] **8. 迭代 1 在飞件**（若 m1-iter1 已合并）：D 投影观感融合/Fusion Pixel 中文渲染/关卡画面实装——若未合并则本项留待其批末目检，不阻塞 M-1 + +**判定**：1–7 全过 + 8 注记状态 → 人闸过，M-1 关闭；登记裁决入台账，roadmap 里程碑移动。 + +## 三、✦ 缺料清单（只登记不生图——生图执行权在用户） + +| 件 | 渠道 | 规格/提示词指针 | 现状承载 | +|---|---|---|---| +| B 区背景横幅（战斗舞台背景插画） | ✦ 生图 | art-bible §6.1 明亮地窟/低对比自然后退；清单 §1.2 | 程序化石板皮+底噪（本批 T2） | +| 八敌种站桩立绘 9 卡 | ✦ 外部生成中 | comfyui-prompts.md v2.9（攻击段=底稿锁死句） | 槽位在位，入库即显示零代码 | +| 主角 normal/hit 成图旗色手修 | ✦ 手修 | 旗朱→封印黑 #000000（封印黑批遗留） | 远程单已重锁十六进制 | +| 节点图行进器形象 | ✦/⚙ | 清单 §3.2（与主角同族蓝） | 程序化占位 | +| 意图三档/死亡碎裂序列帧 | ✦ 可选 | art-bible §8.4 冻结帧数档 | 程序化 tween 已承载（本批 T3） | +| 巢穴纹/封印印记正式纹样 | ✦/⚙ | 清单 §4 封印特效两件+§3.3 | 程序化占位在役 | +| 变异纹带六类型终稿 | ⚙ 样张批后可排产 | art-bible §3.2 纹带形按轴两分 | 槽位先行（CellUnit tex_mutation） | +| 格面资源徽章 19 枚 | ⚙ 脚本管线 | 清单 §3.1 键契约 | 程序化占位 | + +## 四、代拍板追认清单（本 loop 白名单内已裁，待用户过目） + +1. A6 观感密度口径=明度梯度均值（高频细节能量）——v1 同口径实测 4.09×1.15=4.70；低频双峰由 A3 承载（口径注记见机检报告）。 +2. F6 双明度带测「南向临地墙格」（立面语义承载位，内墙 center 件无立面属正确）。 +3. 复用件选型=Kenney 系九宫格/图标+OGA 石纹（全 CC0，game-icons CC-BY 件未采用）；量化色带端点=PANEL_BORDER/PANEL_DATA/BRICK/FLOOR/PLATE token。 +4. 演出参数=死亡碎块 5 块 0.45s/纹章碎砖 10 枚/掸灰 8 絮/蓄力定格 0.40s（§8.4 冻结档）。 +5. 数字牌尺寸 0.66→0.60（对齐样张冻结值）；图例旗条目名回退「旗」（click_probe 基线精确匹配，封印语义移描述列）。 diff --git a/roadmap.md b/roadmap.md index d0d2ef5a..0bd96232 100644 --- a/roadmap.md +++ b/roadmap.md @@ -22,7 +22,7 @@ - **阶段**：Vertical Slice Implementation（`stage.txt`） - **已达成**：一局完整三关冒险+存档+元进度+营地闭合（数值 provisional，归调参批标定）；表现层 Node2D 双阶段+换肤接线落籍（渲染架构到位、素材占位在役）；UX 文档面四 spec 齐（battle / level-map / level-clear / interaction-patterns） -- **挂起待用户输入（批次解锁点）**：① 样张 v1 否决原因一句话（用户已认领待补——解锁样张 v2 机检断言集；闸形已拍=A 机检冻结零参与，机检全过即落码）② 真人试玩批次（解锁曲线调参读数）——已解闸存档：ADR-0007 裁决（裁丙，台账 210）；高墙档=D 投影+字体=Fusion Pixel OFL（2026-09-27 快拍，迭代 1 卡②③ 闸解除） +- **挂起待用户输入（批次解锁点）**：① 真人试玩批次（解锁曲线调参读数）② **M-1 出口闸=真人目检**（检查单 `design/qa/m1-exit-gate-checklist-2026-09-28.md`，迭代 2 批末交付）③ 迭代 1 T4 关卡画面实装在飞（m1-iter1 worktree 未落籍）——已解闸存档：ADR-0007 裁决（裁丙，台账 210）；高墙档=D 投影+字体=Fusion Pixel OFL（2026-09-27 快拍，迭代 1 卡②③ 闸解除）；样张 v1 否决原因四条（2026-09-28 用户补，已全数断言化——样张 v2 机检 16/16 冻结，台账 219） - **已达成（当日补记）**：统一随机流架构（七流并一+全事件日志，rng 面零散随机源清零；并流后 MC/verifier 历史基线作废，重测义务并入迭代 3 卡①） - **已知挂账**：曲线调参批（基线读数重测+杠杆扫描，段界结账口径）；魔法道具内容批（node-reward spec 随批出生）；反制批 Alpha