docs(qa目录退役·改判A): 40 张取证照与对比报告删除不留档——git 历史即档案
- 用户裁 A:验证截图不是黄金图(黄金图有 golden_baseline_refresh.sh 生成、golden_compare.py 逐像素比对,本批 40 张零代码消费),不配占仓库位置 - 撤回上一提交的搬移:game/tests/evidence/ 复原(README 回到改动前、.gdignore 撤销)、ui-audit-2026-10-06 整包 41 件(40 图+同名报告)删除——原件全在 master 树内,回看走 git show becb675a:design/qa/... - 删前核对未决面:报告 §① 底栏重设计草案已落码(game/presentation/views/level_map_screen.gd:122-125 定高 85px+特性持有行限宽截断+tooltip,注释直书「2026-10-06 审计差距①」),无未决项随删丢失 - 判据改写:doc-conventions §11「暂存地非档案库」行改为 design/ 六目录不留验证截图(结论进 06/卡片后图像即弃,在途图归 artwork/,机检基线才入库走 game/tests/golden/);AGENTS.md Project Layout 两行与结构闸 IMAGE_PREFIXES 同步复原到不含 evidence - 五道文档域闸全绿(gdd_lint/doc_link --strict/doc_term --strict/pipeline_gate/repo_structure_audit)
No files matched your search
@@ -27,9 +27,9 @@
|
||||
- `design/gdd/` — 现行设计文档树(根索引 `02-系统清单.md`,文档增删必须同步;`gdd/ux/` 战斗画面与交互规格)
|
||||
- `design/art/` — 美术纯文档(圣经/清单/提示词卡 + references/);评估调研归 `design/research/`;不放图片
|
||||
- `design/dev/` — 工程规范(五份规约 + architecture + engine-reference)
|
||||
- `design/research/` — 调研/提案/评估/历史验收(中间文档唯一暂存地,入内文件到期即死);`design/qa/` 已退役,验证取证归 `game/tests/evidence/`
|
||||
- `design/research/` — 调研/提案/评估/历史验收(中间文档唯一暂存地,入内文件到期即死);`design/qa/` 已退役,验证截图不进 `design/`(判据见 doc-conventions §11)
|
||||
- `artwork/` — 在途图像素材唯一工作区(文档归文档/在途图归一处/终稿归游戏);整目录不入 git(.gitignore 强制),收口归档 `archive/`
|
||||
- `game/assets/art/` — 已验收终稿(入包被游戏加载);`game/` — 游戏工程本体(代码 + smoke/ 冒烟 + tests/ 单元集成 + tests/evidence/ 验证取证照,该目录 `.gdignore` 令引擎跳过导入不入包)
|
||||
- `game/assets/art/` — 已验收终稿(入包被游戏加载);`game/` — 游戏工程本体(代码 + smoke/ 冒烟 + tests/ 单元集成)
|
||||
- `sim-data/` — 机器读数据产物;数据件不入 git(入库例外 = README+analyze.py+growth_model.py);MC 锚与读数常驻留盘,无数值调整禁重跑
|
||||
- `tools/` — python 工具脚本;`archive/` — 收口归档 zip(gitignored)
|
||||
- `reports/` — 迭代批产出物(实现报告/代拍板追认单/GDD 反哺点清单);**实现批唯一可写目录**,只放 .md,不是事实源(细则见 `reports/README.md`)
|
||||
|
||||
@@ -117,7 +117,7 @@
|
||||
| 删除不留死链 | 中间文档删除后,任何现行文档禁止再留指向它的文件路径;改指结论或提交号 |
|
||||
| sim-data 白名单 | 只留 README、日志、分析工具 .py、现行 MC 对拍锚、设计文档 md;可再生原始数据不入库 |
|
||||
| 出口清理项 | 每迭代出口检查单必含:本迭代中间产物逐份核对(结论已吸收、未决已迁移)后删除 |
|
||||
| 暂存地非档案库 | `design/research/` 是中间文档的唯一暂存地,入内文件默认到期即死;验证用的截图形凭据与它的对比报告不属文档,落 `game/tests/evidence/`(见该目录 README) |
|
||||
| 暂存地非档案库 | `design/research/` 是中间文档的唯一暂存地,入内文件默认到期即死;`design/` 六目录不留验证截图——截图属一次性凭据,结论写进 06 或需求卡片后图像即弃(在途图放 `artwork/`,整目录不入 git);只有需要机器逐像素比对的基线图长期入库,落 `game/tests/golden/` |
|
||||
| 落档必写接收方 | 新报告落档时头部必须写明接收方——`06-待办清单.md` 第几条,或哪张需求卡片。写不出接收方的不落文件,内容在会话里交付即可 |
|
||||
| 迭代实现报告 | 实现批收口的迭代级报告(各卡状态/代拍板追认单/GDD 反哺点清单),属中间文档,**落 `reports/` 不落 `design/`**(2026-10-17 用户裁:实现批禁写 `design/`,`reports/` 是其唯一可写目录):反哺点裁决落文吸收后按「证据只留最新」退役 |
|
||||
| 证据只留最新 | 测试证据只保留最新一次迭代或最新一轮同类审计版本;新证据落位后同批删上一份;待人清单过人闸后同规退役 |
|
||||
|
||||
@@ -4,20 +4,3 @@
|
||||
|
||||
面向表现/手感的验收(视觉锚三硬约束、格子样张测试、结算屏可读性、呈现义务台账核对)归此处——
|
||||
自动化探针(场景级)能覆盖的走 `tests/unit` / 探针场景,不能 G-W-T 的走本目录。
|
||||
|
||||
## 图像取证包
|
||||
|
||||
一次验证的图与它的对比报告放在同一个目录:`<主题>-<日期>/`,内部子目录装图(现例:`demo/` 原型截图 ·
|
||||
`real/` 实机截图 · `pairs/` 左右并排合成图),包内同名 `.md` 装报告(逐屏差异、结论、判定记录)。
|
||||
报告头部必须写明接收方——`design/gdd/06-待办清单.md` 第几条,或哪张需求卡片。接收方处理完毕后整包删除,
|
||||
历史进 git 提交信息。
|
||||
|
||||
## 引擎不导入本目录
|
||||
|
||||
本目录根的 `.gdignore` 让 Godot 整目录跳过:图不生成 `.import` 边车,也不进导出包。
|
||||
这里的图是验收凭据,不是被游戏加载的资源——要加载的走 `game/assets/`,机检基线图走 `game/tests/golden/`。
|
||||
|
||||
## 现存内容
|
||||
|
||||
`ui-audit-2026-10-06/`:实机 12 屏 × demo 原型 v2.1 逐屏对比,报告同名。
|
||||
产出它的探针 `game/smoke/ui_audit_probe.gd` 已退役(commit 94f1bba8「孤儿探针退役」批),该包图像不可重制。
|
||||
|
Before Width: | Height: | Size: 94 KiB |
|
Before Width: | Height: | Size: 487 KiB |
|
Before Width: | Height: | Size: 516 KiB |
|
Before Width: | Height: | Size: 374 KiB |
|
Before Width: | Height: | Size: 457 KiB |
|
Before Width: | Height: | Size: 415 KiB |
|
Before Width: | Height: | Size: 375 KiB |
|
Before Width: | Height: | Size: 372 KiB |
|
Before Width: | Height: | Size: 37 KiB |
|
Before Width: | Height: | Size: 57 KiB |
|
Before Width: | Height: | Size: 510 KiB |
|
Before Width: | Height: | Size: 538 KiB |
|
Before Width: | Height: | Size: 394 KiB |
|
Before Width: | Height: | Size: 479 KiB |
|
Before Width: | Height: | Size: 433 KiB |
|
Before Width: | Height: | Size: 392 KiB |
|
Before Width: | Height: | Size: 390 KiB |
|
Before Width: | Height: | Size: 40 KiB |
|
Before Width: | Height: | Size: 63 KiB |
|
Before Width: | Height: | Size: 932 KiB |
|
Before Width: | Height: | Size: 876 KiB |
|
Before Width: | Height: | Size: 445 KiB |
|
Before Width: | Height: | Size: 849 KiB |
|
Before Width: | Height: | Size: 761 KiB |
|
Before Width: | Height: | Size: 721 KiB |
|
Before Width: | Height: | Size: 730 KiB |
|
Before Width: | Height: | Size: 259 KiB |
|
Before Width: | Height: | Size: 262 KiB |
|
Before Width: | Height: | Size: 288 KiB |
|
Before Width: | Height: | Size: 256 KiB |
|
Before Width: | Height: | Size: 437 KiB |
|
Before Width: | Height: | Size: 337 KiB |
|
Before Width: | Height: | Size: 50 KiB |
|
Before Width: | Height: | Size: 375 KiB |
|
Before Width: | Height: | Size: 330 KiB |
|
Before Width: | Height: | Size: 337 KiB |
|
Before Width: | Height: | Size: 351 KiB |
|
Before Width: | Height: | Size: 218 KiB |
|
Before Width: | Height: | Size: 202 KiB |
|
Before Width: | Height: | Size: 93 KiB |
@@ -1,96 +0,0 @@
|
||||
# 全屏 UI 审计:实机 vs demo v2.1(2026-10-06 用户令返工)
|
||||
|
||||
> 方法:实机十二屏窗口化程序截图(`game/smoke/ui_audit_probe.gd`,真实信号路径+拟真数据,1280×800 归一)× demo 原型 v2.1 浏览器现截九屏(纯净模式,与 HTML md5 `78ebbee0…` 同代现渲染)。逐屏并排图=`pairs/pair_*.png`(左实机右 demo),原图在 `real/` 与 `demo/`。
|
||||
> 输入:用户截图的红砖「放弃」按钮(第二层地图屏,特性持有态)+「底栏重设计是根本解、不是限制按钮」裁决。
|
||||
|
||||
## 逐屏差距(demo 八映射屏)
|
||||
|
||||
### ① 关卡地图(pair_4_map)——用户点名核心屏,差距最大
|
||||
|
||||
| # | 差距 | demo | 实机 |
|
||||
|---|---|---|---|
|
||||
| 1 | **底栏** | 单条 **~85px** 紧凑亮条:头像+生命轨 \| 属性(含攻击加成副行) \| 本关加成(含持有行) \| 道具槽×2 \| **放弃=小号危险钮 ~90×38** | 亮条 + **放弃=216×50+ 危险钮**;特性持有行无限宽换行把栏爆到 130px+(用户截图实证),全栏跟着涨 |
|
||||
| 2 | 底栏内容 | 五段齐装(含道具槽与持有行) | 少道具槽、少持有行展示态(特性行爆栏);空态大片留白由放弃钮填充 |
|
||||
| 3 | 底栏淡墨 | 加成副行用 wood-deep 深棕(亮板上可读) | 特性组用 WARM/WARM_SOFT 暖白系(亮板上 ≈1:1,**不可读——§7.2 违例**) |
|
||||
| 4 | 背景 | 暖棕渐变聚焦、无纹理平铺 | 全屏石纹平铺(/busy,视觉焦点弱) |
|
||||
| 5 | 顶栏 | 关卡头与 GP 徽章均有框板(plate 感) | 裸文本浮在纹理上 |
|
||||
| 6 | 节点图 | 分支树多行多列+连线,分支结构一目了然 | 第一层为单行线性排布(深层有分支但连线视觉弱) |
|
||||
|
||||
**底栏重设计草案(待用户裁决后实施,本批未动代码)**:对齐 demo——①底栏定高 88px 单条,五个信息段一行排齐;②放弃改小号危险钮(~90×38,右端);③特性持有行限宽(固定栏宽内 1-2 行省略+tooltip 全文),杜绝爆栏;④特性组墨色换深墨系(INK_HINT/INK_TITLE)修 §7.2 违例;⑤道具槽段位预留(道具读数出口=台账 352 在册项)。
|
||||
|
||||
### ② 商店(pair_7_shop)
|
||||
|
||||
demo=**全屏页**(顶部标题+刷新徽+GP 框+池源/涨价规则行)+**竖卡三张**(色带/图标/名/效/价/类型脚注);实机=**战斗屏上的小模态**(dim 0.6)+三横行(名+现价+已购档+购买钮),标题与 HUD 行叠压。→ 即 06 在册 D1(卡片 232×352)/D2(商店全屏化)结构级差异,本次截图实证差距量级。实机独有「已购 N 档」档位语义 demo 无。
|
||||
|
||||
### ③ 三选一(pair_6_bonus)
|
||||
|
||||
demo=全屏页:标题+**GP 汇总行**+三张竖卡(色带/图标/名/效/类型脚注/**选中✓**)+确认选择钮+免费选择注记。实机=战斗内浮层:标题+三行引导文字(关卡奖励点/从提升池抽…/选择一件带走)+窄条卡(~140×220,无脚注无选中✓)+无确认钮(点卡即选)。
|
||||
**新证据(E5 追认)**:demo 的「工兵爆破」卡=**紫带(magic 族)**,实机按 T4a 归 TG_AOE=粉带——demo 自身的 blast 归属与 T4a 判定相反,建议回滚 E5(blast 归回 TG_MAGIC),随用户裁决。
|
||||
|
||||
### ④ 战斗结算·胜利(pair_8_end_victory;失败态同族)
|
||||
|
||||
demo=全屏 dim(仪式感)+石皮框板卡:标题+三行**两列对齐账目**(战利品/钥石/本关加成)+紧凑主钮「下一节点」;实机=**无 dim**(战斗屏裸露)+素面板+居中堆叠文本行+全宽黄钮「返回」。仪式感与排版差距大。
|
||||
|
||||
### ⑤ 战斗(pair_5_battle)
|
||||
|
||||
结构对齐度高(舞台/上轮摘要行/AP·RAP 行/左栏/提示条均在位)。差距:①demo 棋盘融进深棕场景、实机=亮米大平板+四周大片空白(观感最大点);②demo 左栏三段齐装(探险者+魔法道具槽有货+本关强化+流派件),实机左栏=探险者+秘宝空槽(强化/流派件编排不同源);③demo 站桩带名牌与头顶 HP 轨更紧凑。
|
||||
|
||||
### ⑥ 标题屏(pair_1_start)
|
||||
|
||||
1. **主操作语义反转**:demo=「继续上局」黄色主钮(有存档时继续是首动作)、「开始冒险」石钮;实机=「开始冒险」主黄钮、「继续上局」石钮。
|
||||
2. 主标题:demo 粗像素体大字+烛光副题装饰线;实机细体。
|
||||
3. 背景:demo 暗棕渐变+聚光;实机全铺石纹。
|
||||
4. demo 有「玩法速览」牌——**实机已按用户令删除,不回补**。
|
||||
5. 立绘/敌人群比例 demo 更大更聚中。
|
||||
|
||||
### ⑦ 营地(pair_2_camp)
|
||||
|
||||
面板明度关系相反(demo 暗石皮面板浮于暖渐变;实机亮米大板浮于石纹);demo 行带图标/Lv 徽章/价格按钮一格齐,实机行松、工坊行为纯文字行;关闭钮 demo 底部居中、实机左下;实机独有累计通关解锁进度列(功能差异非缺陷)。
|
||||
|
||||
### ⑧ 设置(pair_3_settings)
|
||||
|
||||
demo 石皮框板+两列对齐行(label 列/控制列)+减动效行;实机素面板+行内流式布局无列对齐+**减动效行缺失**(实机仅 主音量/全屏/结算演出动画 三行——减动效语义由结算行承担与否待核);返回钮 demo 紧凑、实机 216 宽。
|
||||
|
||||
### demo 无映射的实机屏(三屏,无对比基线)
|
||||
|
||||
调试浮窗(real_9_debug)· 图例(real_10_legend)· 确认框(real_11_confirm)——demo 八屏不含,维持现状,仅存档截图。
|
||||
|
||||
## 总体结论(差距量级排序)
|
||||
|
||||
1. **关卡地图底栏**(用户点名)——放弃钮尺寸语义错+特性行爆栏+淡墨违例;根本解=按 demo 88px 单条重设计(草案见上)。
|
||||
2. **商店/三选一形态级差距**(D1/D2 在册):全屏化+竖卡 232×352——06 已登记待立项,本轮截图把量级坐实。
|
||||
3. **结算仪式感**(dim+石皮框板+两列账目)——呈现批量级。
|
||||
4. **背景处理全局差距**:demo 暖渐变聚焦、石纹只作局部质感;实机全屏铺石纹——跨屏共通改。
|
||||
5. **标题屏主操作语义**(继续上局应为主钮)。
|
||||
6. 战斗屏结构对齐度最高,仅棋盘底色处理与左栏编排差距。
|
||||
7. E5 证据更新:demo 爆破卡紫带 → 建议 blast 归回 TG_MAGIC(推翻 T4a 的 blast→TG_AOE),随用户裁决。
|
||||
|
||||
## 批末判定(2026-10-06 /goal UI 对齐批收口——逐项复判全记)
|
||||
|
||||
/goal 令(「将游戏的 UI 对齐 demo 的 UI;完成后自验:ui_audit_probe 逐屏实机截图×demo 浏览器截图,重建并排对比图逐项判定;全部差距闭环或列明不可对齐原因」)执行完毕。判官=documents:visual-judge 两轮独立目检(初判 7 pass/2 partial/1 fail → 修复后复判 4 张全部转 pass),九组并排图已按合后态重摄重建(real/ 与 pairs/ 现内容=最终态)。
|
||||
|
||||
### 逐屏判定终态
|
||||
|
||||
| 屏 | 判定 | 闭环内容 | 留档差异(非本轮差距) |
|
||||
|---|---|---|---|
|
||||
| ①标题 | **pass** | 主操作语义反转(有档=继续上局主黄钮);背景=暖棕底+石纹 0.14+斜光带+暗角 | demo 玩法速览牌已按用户令删除,不回补 |
|
||||
| ②营地 | **pass**(用户实机复检后二次修复) | 背景氛围层(可见处石纹微弱+暗角);**用户实机两缺陷修(2026-10-06)**:①底改不透明暖亮档(原 0.45 半透 dim 在石纹降 0.14 后底下对局画面透出——demo #v-camp=bg-bright 实底同款)②三柜 EXPAND_FILL 等宽分屏+行标签截断兜底(原行标签按文字全宽算 min,进度/状态长文案随档变长把三柜总宽撑爆 1248=右柜裁出屏)+状态列 tooltip 兜底 | 面板明度/行密度/关闭钮位=camp ⑦ 遗留(06 留档) |
|
||||
| ③设置 | **pass** | 两列对齐(label 定宽 140)+返回钮紧凑 90+主音量滑轨实高修(HSlider 槽按 stylebox min 高绘制缺陷) | 减动效行不拆=reduced_motion 单设置同驱 motion_scale+结算演播(语义命名批裁决,demo 两行=同一设置) |
|
||||
| ④地图 | **pass** | 底栏 85px 定高单条+放弃 90 小钮+特性行限宽截断+深墨;顶栏关卡名框板+GP 烛光胶囊+两极排布;背景暖棕渐变 | 道具槽段位=台账 352 功能欠账(非呈现层) |
|
||||
| ⑤战斗 | **pass** | 背景氛围层成立;轮次条/上轮摘要结构一致 | 棋盘底板融景、左栏编排、站桩紧凑度=battle ⑤ 遗留(06 留档) |
|
||||
| ⑥三选一 | **pass** | 全屏页(page_shell 根底档)+D1 竖卡 232×352+类型脚注行+底注 | 稀有度词缺=数据面无投喂(词表随数据批补) |
|
||||
| ⑦商店 | **pass** | 全屏页(D2)+56px 通栏顶条+爬价规则行(实数投喂 shop_bp_visit_buys×shop_price_a)+D1 竖卡+底注池源 | 「已购 N 档」=实机独有档位语义(功能差异非缺陷) |
|
||||
| ⑧结算·胜/败 | **pass** | DIM_NIGHT 0.62/0.6 全屏压暗(判官实测亮度 218→97)+两列对齐账行+紧凑主钮 | 账行文案词序差异=Narrator 文案域 |
|
||||
| 无映射三屏 | 存档 | 调试浮窗/图例/确认框维持现状(demo 无基线) | — |
|
||||
|
||||
### 不可对齐/留档原因清单
|
||||
|
||||
1. **营地面板明度与行密度、关闭钮位**:camp 布局属 M 批落码形制,重排=独立呈现批量级,本批只落背景氛围层;06 留档。
|
||||
2. **战斗棋盘底板**:棋盘视觉=样张 v2 机检冻结域(golden 断言),动底板需过样张闸;06 留档。
|
||||
3. **地图道具槽**:道具读数无关卡画面=成文出口(台账 352),功能件非呈现层。
|
||||
4. **稀有度脚注词**:候选数据面无稀有度字段投喂,随数据批补。
|
||||
5. **减动效独立行**:与结算演出动画=同一设置(语义命名批 T17 裁决合并),拆行=一设置双行重复,不拆。
|
||||
|
||||
### 闸门记录
|
||||
|
||||
开工基线冒烟 782/0(4336fd2 净态)→ 每轮轻闸冒烟 782/0+probe_gate --click 全绿 → 批末 run_all 16 套全绿+全探针绿+doc 三闸零新增(2 处 06 陈旧断链系基线随 merge 自愈,非本批引入)→ 合 master 2ca6288 主区复跑(冒烟 782/0+click 全绿+run_all 17 套全绿〔含并行批新落 curio_refresh_paid_test〕)→ 判官修复轮复验全绿。
|
||||
@@ -30,10 +30,9 @@ ROOT_FILES = {"AGENTS.md", "README.md", "roadmap.md", "stage.txt", "review-mode.
|
||||
# 3) 图像允许目录(相对路径前缀;archive/ 为归档 zip 不扫)
|
||||
# game/tests/golden/ 收编(迭代 19 卡① T2/T6 2026-10-08——棋盘 golden 基线=机检测试资产非美术素材,
|
||||
# 素材齐盘态生成入库【基线换代权限 Q6】;T1 落库时漏改本白名单致熵增闸红,同批修订 commit 留痕)
|
||||
# game/tests/evidence/ = 验证取证照与它的对比报告(目录根 .gdignore 令 Godot 跳过导入,图不进包)
|
||||
IMAGE_EXTS = {".png", ".jpg", ".jpeg", ".webp", ".gif", ".svg", ".pxo", ".psd", ".bmp"}
|
||||
IMAGE_PREFIXES = ("artwork/", "game/assets/", "design/art/references/", "design/dev/architecture/",
|
||||
"game/tests/golden/", "game/tests/evidence/")
|
||||
"game/tests/golden/")
|
||||
# 4) 退役路径(目录或文件任一再现即 FAIL)
|
||||
RETIRED = ["production", "docs", "tests", "qa-data", "design/registry",
|
||||
"design/art/candidates", "production/mockups",
|
||||
|
||||