merge: 同步 master e8a29342（qa目录退役批）——四张卡冲突按「卡已退役」取删除，master 侧改动仅为 design/qa/ 路径内联，信息零损失

2026-10-20 03:51:25 +08:00
commit fe47f48e0c
@@ -19,7 +19,7 @@
 - **交付前验收 = 跑 `tools/run_all_gates.sh`，按本批改动域选档（`--code` 只跑代码域／`--docs` 只跑文档域／不带参数＝两域全量），所选域全绿才合回 master**——它是全部验证闸的唯一入口与唯一清单，**域划分也只写在它这一个地方**，闸件增减与分域调整都只改它，文档禁另列清单。一次改动同批混触 `game/` 与文档面时跑全量档。跑完写回执 `game/tests/.gates/receipt.json`（含 `domain` 字段），合回时由 worktree-guard 按 diff 路径推出该验哪个域再校验回执（缺回执／quick 模式／回执 commit ≠ HEAD／域不覆盖本次改动／含新增红，五况一律拦截）
 - 单件直跑（调试期最窄确认用，**不构成验收**）：系统级断言面 `python tools/run_smoke.py`（名带 smoke 但不止存活检查，术语见 `game/tests/README.md`）· 场景探针 `…console.exe --headless --path . res://smoke/ui_probe.tscn` · 单元 `… --script res://tests/run_all.gd`
 - 调参批量：`--script res://smoke/adventure_monte_carlo.gd`（全冒险期望）· `res://smoke/reward_expectation.gd`（奖励期望）；通关率/难度类测量一律走全冒险
- 数值验证：`python tools/balance_verifier.py`（采集端 `res://smoke/verifier_batch.gd`，报告落 `design/qa/`）
+- 数值验证：`python tools/balance_verifier.py`（采集端 `res://smoke/verifier_batch.gd`，报告与原始数据落 `sim-data/`）
 - 熵增闸（新类别 = 同批修订 Project Layout + 白名单）：`python tools/repo_structure_audit.py`

 ## Project Layout
@@ -27,7 +27,7 @@
 - `design/gdd/` — 现行设计文档树（根索引 `02-系统清单.md`，文档增删必须同步；`gdd/ux/` 战斗画面与交互规格）
 - `design/art/` — 美术纯文档（圣经/清单/提示词卡 + references/）；评估调研归 `design/research/`；不放图片
 - `design/dev/` — 工程规范（五份规约 + architecture + engine-reference）
- `design/qa/` — 验证报告 + QA 呈现产物图；`design/research/` — 调研/提案/评估/历史验收
+- `design/research/` — 调研/提案/评估/历史验收（中间文档唯一暂存地，入内文件到期即死）；`design/qa/` 已退役，验证截图不进 `design/`（判据见 doc-conventions §11）
 - `artwork/` — 在途图像素材唯一工作区（文档归文档/在途图归一处/终稿归游戏）；整目录不入 git（.gitignore 强制），收口归档 `archive/`
 - `game/assets/art/` — 已验收终稿（入包被游戏加载）；`game/` — 游戏工程本体（代码 + smoke/ 冒烟 + tests/ 单元集成）
 - `sim-data/` — 机器读数据产物；数据件不入 git（入库例外 = README+analyze.py+growth_model.py）；MC 锚与读数常驻留盘，无数值调整禁重跑
@@ -487,7 +487,7 @@
  - **显示档登记例外(2026-10-06 UI 设计对齐批 P6 甲——64 源 0.5×,待素材批消除)**:柜台四枚 `icon_forge/workshop/atlas/keystone`(64×64 源)显示档统一 **32px = 0.5×**;状态九枚(32×32 源)mini(站桩)档 **16px = 0.5×**。两处均系「显示尺寸侧唯一可调、素材一字节禁改」红线下的人工检整数半倍档,登记为**待消除例外**——素材批出 32px 源后回归 1×。常规档显示一律 1×(状态九枚 32px、手绘十枚 20px/40px 双档、BCard 图标槽 40px=2×)。
  - **乙类·角色与单位精灵**(有机形体、非文字):允许运行时非整数倍缩放(NEAREST 过滤不变),容忍轻度像素宽窄不均;判据 = 实机目检,可感不适即回整数档。乙类今后免逐案豁免(豁免蔓延断根)。
  - **站桩立绘槽位=高定宽随(2026-10-04 原型审计教训落规)**:立绘/精灵槽位只定「高度的整数倍档」,宽度随源图宽高比自适应——**禁止把全部立绘塞进统一方框强拉**(纵横倍率必须恒等)。实例=UI 原型 88×92 方框把 23×48 地精源横拉 3.83×/纵拉 1.92×、26×48 熊地精 3.38×/1.92× 压扁发花,46×48 主角近方恰等比故独活——方框是按主角比例定的,窄条生物(细长本体裁掉透明边)进主角的框必变形。乙类的非整数豁免只覆盖**等比**缩放,不含纵横异倍变形。
-  - **1920×1080 档策略(2026-09-30 三裁决案甲落定——三案呈报见 design/qa/m3-iter9-t8-rulings-2026-09-30.md)**:全局等比(stretch=canvas_items+aspect **keep**)——16:10 设计在 16:9 窗口=等比 1.35×+左右黑边各 ~96px,构图与 1280×800 基准档完全一致(逻辑布局 1920/1280 逐键一致实测);甲类 1.35 非整数缩放例外注记:轻度宽窄不均系本档位接受代价(像素游戏 shipped 常态),实机目检可感不适→回乙案(1920 独立 2× 基准)重议;乙类同前款。
+  - **1920×1080 档策略(2026-09-30 三裁决案甲落定——三案呈报原件已随中间文档退役，删除批见 commit 8e02dcf0)**:全局等比(stretch=canvas_items+aspect **keep**)——16:10 设计在 16:9 窗口=等比 1.35×+左右黑边各 ~96px,构图与 1280×800 基准档完全一致(逻辑布局 1920/1280 逐键一致实测);甲类 1.35 非整数缩放例外注记:轻度宽窄不均系本档位接受代价(像素游戏 shipped 常态),实机目检可感不适→回乙案(1920 独立 2× 基准)重议;乙类同前款。
 - **画布基准(2026-09-23 用户暂定值)**:
  - **主角人设原图 = 48×72**(1× 基准,暂定;与站姿降采样可读性验证一致);
  - **主角战斗状态图(含 B 区站桩侧向)= 48×72**(同上暂定;v1.9 待决注记「主角立绘档空缺」由此完成);
@@ -117,7 +117,8 @@
 | 删除不留死链 | 中间文档删除后，任何现行文档禁止再留指向它的文件路径；改指结论或提交号 |
 | sim-data 白名单 | 只留 README、日志、分析工具 .py、现行 MC 对拍锚、设计文档 md；可再生原始数据不入库 |
 | 出口清理项 | 每迭代出口检查单必含：本迭代中间产物逐份核对（结论已吸收、未决已迁移）后删除 |
-| 暂存地非档案库 | `design/research/` 与 `design/qa/` 是中间文档暂存地，入内文件默认到期即死 |
+| 暂存地非档案库 | `design/research/` 是中间文档的唯一暂存地，入内文件默认到期即死；`design/` 六目录不留验证截图——截图属一次性凭据，结论写进 06 或需求卡片后图像即弃（在途图放 `artwork/`，整目录不入 git）；只有需要机器逐像素比对的基线图长期入库，落 `game/tests/golden/` |
+| 落档必写接收方 | 新报告落档时头部必须写明接收方——`06-待办清单.md` 第几条，或哪张需求卡片。写不出接收方的不落文件，内容在会话里交付即可 |
 | 迭代实现报告 | 实现批收口的迭代级报告（各卡状态/代拍板追认单/GDD 反哺点清单），属中间文档，**落 `reports/` 不落 `design/`**（2026-10-17 用户裁：实现批禁写 `design/`，`reports/` 是其唯一可写目录）：反哺点裁决落文吸收后按「证据只留最新」退役 |
 | 证据只留最新 | 测试证据只保留最新一次迭代或最新一轮同类审计版本；新证据落位后同批删上一份；待人清单过人闸后同规退役 |

@@ -479,6 +479,12 @@

 ### 文档与结构

+#### game/tests/README 分级表证据落点行仍指 design/qa/（2026-10-20 登记，来源=批次移交，设计面=工程直入）
+
+**现状**：qa/ 目录退役批（分支 `qa-retire-20261020`，提交 897a0742）已把 13 处活指针改判到 `design/research/`、`reports/`、`sim-data/`，唯 `game/tests/README.md:81` 测试分级表 Config/Data 行的证据落点仍写 `design/qa/`（该目录本批已退役），正解＝`sim-data/`——该行是机器读数出口，与 `tools/balance_verifier.py` 的报告落点改动属同一口径。本批未顺手改：改动路径一旦落在 `game/` 前缀内，合回闸即按路径推定本批需代码域验收，而本批零代码改动（见 `.zcode/hooks/worktree-guard.sh` 推域段）；死链闸也判不出——`tools/doc_link_audit.py` 只扫 `design/gdd/`。故列为已知欠账，等下一批真改 `game/` 时一并纠正。
+**归属**：`game/tests/README.md` 测试分级表
+**状态**：待写卡（备选）
+
 #### qa/ 实现报告收尾·孤儿遗留七项（2026-10-14 登记，来源=批次移交，设计面=工程直入）

 **现状**：qa 收尾批核查 iter19 系列出口报告遗留移交项时发现**不在 06 在册**的七项（acceptance-package §三.2/card0 §5.3/followup §七.3/uibackfill §6.2-4/verify §6.1/3/7）。已结案的（tree_rules 受理闭环、X/Y 双源、S1 七项违例修复、提灯目检项、tests.yml 休眠等）已在各报告标注结案证据，不入本条。七项均为挂号备查/顺路件，无排期承诺：
@@ -543,7 +549,7 @@

 #### 代码术语刷新批——禁用词全库清扫＋flag→seal 标识符重命名（2026-10-18 登记，来源=会话提及，设计面=工程直入）

-**现状**：2026-10-18 用户裁定三组术语刷新（记忆 `project-terminology-rulings-20261018.md`）：①GP 是唯一正式命名，「金币」系 AI 噪音全库禁用；②「插旗」全库禁用，正式动作名=封印，「旗」概念不存在；③代码英文标识符 flag_* 全换 seal_*。另「雷格」「惩罚格」2026-10-11 已裁退役→危险格，代码域尚未执行。审计报告（`design/qa/代码术语审计报告-2026-10-18.md`）实查：game/ 代码域实测读数（2026-10-18 需求卡片 v1.4 复核；口径＝区分大小写逐处计数，命令见卡片 §2）：含 `flag` 的文件 57 个（.gd 53 ＋ .tres 4）共 617 处，剔除 `size_flags_*` 70 处（19 个文件）与 `_fatal_flag` 4 处后**净待改 543 处/42 个文件**；中文禁用词 金币 39 处、插旗 62 处、雷格 75 处、惩罚格 1 处、「旗」含复合词共 376 处。涉及核心逻辑（minesweeper_rules.gd 净 59、battle_orchestrator.gd 33、grant_segment.gd 38）、数据表（feats.tres 15、settlement.tres、action_economy.tres、reward.tres、treasure_items.tres）、呈现层（board_view.gd 23、battle_end_overlay.gd 11、shop_overlay_view.gd、legend_overlay.gd）与冒烟测试（smoke_all.gd 单文件净 156 处＝全集 29%）。订正说明：审计报告原记「game/ 约 757 处（flag_ 314 处/29 个 .gd；金币 116／插旗 210／雷格 109）」在现行代码上两种口径都复现不出：中文三词的读数属全库面（全库实测 金币 381／插旗 600／雷格 394 处），与本条的 game/ 范围混记；flag 侧则低估约一倍。逐文件读数以需求卡片 §2 为准。文档面（design/）由另批处理，本条只覆盖 game/ 代码域。
+**现状**：2026-10-18 用户裁定三组术语刷新（记忆 `project-terminology-rulings-20261018.md`）：①GP 是唯一正式命名，「金币」系 AI 噪音全库禁用；②「插旗」全库禁用，正式动作名=封印，「旗」概念不存在；③代码英文标识符 flag_* 全换 seal_*。另「雷格」「惩罚格」2026-10-11 已裁退役→危险格，代码域尚未执行。审计报告（`design/research/代码术语审计报告-2026-10-18.md`）实查：game/ 代码域实测读数（2026-10-18 需求卡片 v1.4 复核；口径＝区分大小写逐处计数，命令见卡片 §2）：含 `flag` 的文件 57 个（.gd 53 ＋ .tres 4）共 617 处，剔除 `size_flags_*` 70 处（19 个文件）与 `_fatal_flag` 4 处后**净待改 543 处/42 个文件**；中文禁用词 金币 39 处、插旗 62 处、雷格 75 处、惩罚格 1 处、「旗」含复合词共 376 处。涉及核心逻辑（minesweeper_rules.gd 净 59、battle_orchestrator.gd 33、grant_segment.gd 38）、数据表（feats.tres 15、settlement.tres、action_economy.tres、reward.tres、treasure_items.tres）、呈现层（board_view.gd 23、battle_end_overlay.gd 11、shop_overlay_view.gd、legend_overlay.gd）与冒烟测试（smoke_all.gd 单文件净 156 处＝全集 29%）。订正说明：审计报告原记「game/ 约 757 处（flag_ 314 处/29 个 .gd；金币 116／插旗 210／雷格 109）」在现行代码上两种口径都复现不出：中文三词的读数属全库面（全库实测 金币 381／插旗 600／雷格 394 处），与本条的 game/ 范围混记；flag 侧则低估约一倍。逐文件读数以需求卡片 §2 为准。文档面（design/）由另批处理，本条只覆盖 game/ 代码域。

 **归属**：全工程（排雷循环/战斗循环/冒险循环/呈现层/数据表/冒烟测试均触及；主责=术语表裁定执行）

@@ -100,7 +100,7 @@

 **局后随手记**（一句话即可，事后对日志）：每局大概掉了多少血 / 有没有整轮一点血没掉的轮次 / 通关与否 / 有没有"这局特别顺/特别倒霉"的体感（种子体感核对用）。

-**结果回流**：日志取数 → 真人修正系数 k（真人整关承伤中位 ÷ 模拟完美档中位；**正常预期 k>0.5、预警线 k<0.3**——2026-10-03 用户裁）并入 T19 标定报告（落 design/qa/，换代 2026-09-19 判读报告为现行锚）；①–⑤ 体感按各条目的回流位分流。
+**结果回流**：日志取数 → 真人修正系数 k（真人整关承伤中位 ÷ 模拟完美档中位；**正常预期 k>0.5、预警线 k<0.3**——2026-10-03 用户裁）并入 T19 标定报告（落 design/research/，换代 2026-09-19 判读报告为现行锚）；①–⑤ 体感按各条目的回流位分流。

 **2026-10-01 数值修复批后试玩注记**（master 4b4a011 起的正式标定局）：本批已落 hero 血池 20→26 / 直伤雷三行 4/5/5→6/8/8 / L1 系敌 atk 2→1（轨迹与读数见 numfix 报告（已退役，git 历史可查））。试玩时对号新增两点：
 1. **踩雷疼痛感**（本批主刀）：「踩很多雷还是轻松活」应是过去式——单雷 6-8 直伤、两三连雷应明显肉疼；若仍无痛感=回调信号，记一句话即可；
@@ -78,7 +78,7 @@

 | 期 | 内容 | 前置 | 建议窗口（候选） |
 |---|---|---|---|
-| 期一 | 跨局汇总页 + 主菜单生涯入口落位。总局数/通关局数两个终身计数域随该批做存档 schema 迁移——**✅ 已实装（2026-10-07 迭代 18 卡④）**：汇总段六类九项+营地与系统组生涯钮+存档 v6 两终身计数域〔v5 升 v6 幂等迁移〕；闸读数与代拍板追认单见 design/qa/iter18-career-exit-report-2026-10-07.md | 提纲评审通过。实装批前置义务 = 对齐迭代 16 UI 批后的现行基线：`FS_*` 六档字号 / `TG_*` 语义色 / `BUTTON_MIN_H=40`（`ui_kit.gd:437`）/ 色板单源 / `page_shell` 模态栈纪律（`ui_kit.gd:394`）——与卡③需求卡片同款红线，本文只登记、不展开 | Alpha 后最近一个 UI 窗口 |
+| 期一 | 跨局汇总页 + 主菜单生涯入口落位。总局数/通关局数两个终身计数域随该批做存档 schema 迁移——**✅ 已实装（2026-10-07 迭代 18 卡④）**：汇总段六类九项+营地与系统组生涯钮+存档 v6 两终身计数域〔v5 升 v6 幂等迁移〕；闸读数与代拍板追认单原记于该批出口报告，该件已按「吸收即死」在提交 8e02dcf0 删除，读数以本行与该批提交信息为准 | 提纲评审通过。实装批前置义务 = 对齐迭代 16 UI 批后的现行基线：`FS_*` 六档字号 / `TG_*` 语义色 / `BUTTON_MIN_H=40`（`ui_kit.gd:437`）/ 色板单源 / `page_shell` 模态栈纪律（`ui_kit.gd:394`）——与卡③需求卡片同款红线，本文只登记、不展开 | Alpha 后最近一个 UI 窗口 |
 | 期二 | 历史冒险回看整段：N 扩容 + 用时埋点 + 旧档摘要迁移 + 逐局列表 + 单局明细（`settlement_review_overlay.gd` 复活承接）+ 营地条带处置（P6 裁案落地） | 期一。实装批开工前须向用户呈报两件：N 终值读数（20 / 50 / 维持 10 三选一）与「用时」埋点口径（计时起点、暂停是否计入——字段级细节本文不做） | 期一落地后独立批 |
 | 期三 | 图鉴承接（敌人优先，范围与顺序随 P3 甲）；「见过」记账面 schema 义务随该批执行 | 期二或独立评估 | Beta 窗口候选（与教学引导同段评估——图鉴的「认得」轴与教学相关；06 教学引导节各条 2026-10-04 起已整体标 Beta 阶段） |

@@ -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〕）→ 判官修复轮复验全绿。
@@ -1,52 +0,0 @@
-# 迭代 18 四卡实机目检总清单（2026-10-07 交付）
-
-迭代 18 四卡已全部已合并进 master：卡③ 提案批（merge de067ae）/卡⑤ 混编投放批（merge 0dbe3c3）/卡⑦ 种子随机化批（merge b91b973）/卡④ 生涯界面批（本批）。目检归用户逐项过；每节标注详细判据所在的出口报告。目检不阻塞后续开发，但发现的问题按正常缺陷修复流程登记。
-
-> **✅ 核销状态（2026-10-14 qa 收尾批）**：用户实机目检回报全部完成，未呈报问题——卡⑤ 四项、卡⑦ 八项、卡④ 六项共 18 项同批核销（卡③ 纯文档批无实机目检项；卡⑤ 难度带 MC 取证读数挂账条随 M4 数值批履行，不属人闸）。
-
-## 一、卡③ 武器锻造系统设计提案（纯文档批——无实机目检）
-
-人闸=**提案盘问裁决**（异步，不阻塞其余卡）：
-
- 提案正文：`design/research/提案-武器锻造系统-2026-10-07.md`（八节框架）。
- 17 个设计裁点的全备选案一览表：`design/qa/iter18-forge-exit-report-2026-10-07.md` §四（推荐主线=丙案「当前武器单选+每件武器独立等级与特效」等，逐点呈裁）。
-
-## 二、卡⑤ 混编遭遇首批投放批
-
-目检四项（详细判据：`design/qa/iter18-mixenc-exit-report-2026-10-07.md` §7）：
-
-1. 第 2 关深度 5 的普通节点触发战斗：同场出现两种敌人——熊地精重击手 + 巨蜘蛛巢群（巨蜘蛛 2-3 只）。
-2. 同场敌人出场顺序与表序一致：重击手在前、巨蜘蛛巢群在后。
-3. 同场敌人实例总数不超过 4。
-4. 首遇教学位回归不变：巨蜘蛛首遇位（第 2 关节点 4）固定 2 只不加骰；钩爪恐魔（第 3 关节点 0/1）固定数量。
-
-## 三、卡⑦ 种子随机化与调试浮窗升级批
-
-前置：以 `DS_DEBUG=1` 启动游戏（详细判据：`design/qa/iter18-seed-exit-report-2026-10-07.md` A-I 九节）：
-
-1. 应用启动后调试浮窗默认打开（手动可关、角标可再开）。
-2. 主菜单连续开多次新冒险（非首局、种子框留空）：各局种子互不相同（当局数据区块可查本局种子）；首次冒险（新档第一局）固定种子 42。
-3. 调试种子框输入合法整数时全场景按输入值生效（含首局）。
-4. 对局中可从战斗屏 HUD 角标与关卡地图屏角标开合浮窗；其他层打开时浮窗暂隐、关闭后自动恢复。
-5. 当局数据区块六项（种子/关卡/节点/HP/GP/钥石）与实际局况逐项一致。
-6. 从浮窗发起调试对局正常；对局进行中批量模拟与调试对局两按钮禁用。
-7. 浮窗开着时棋盘输入不被锁死、暂停角标不置灰；开新冒险/续玩路径正常（浮窗自动收起）。
-8. 断点续玩逐位正常（存档种子回填）。
- 随附：代拍板追认单六项（区块标题/占位提示词/角标落点等）见出口报告追认单节。
-
-## 四、卡④ 生涯界面实装批·期一
-
-目检六项（详细判据：`design/qa/iter18-career-exit-report-2026-10-07.md` A-H 八节）：
-
-1. 主菜单「营地与系统」组出现「生涯」钮（营地钮之后），点击开生涯全屏页、关闭返回主菜单。
-2. 汇总页六类九项数值与存档实况逐项一致：总局数/通关局数/各关通关次数/Boss 首杀/Boss 总击杀/钥石余额/属性锻造合计/道具工坊解锁计数/天赋树已购聚合。
-3. 旧档（v5 格式）载入后生涯页正常显示（终身计数缺省补零），无损坏。
-4. 生涯页开着=游戏输入锁定（与其他层同语义）；与设置/确认弹窗等他层开合关系正常。
-5. 页内零「前往他处」跳转入口（只有返回）；零动效。
-6. 局内（战斗屏/地图屏）无生涯入口；存档往返（退出重进）后计数不漂移。
- 随附：代拍板追认单十一项（字段命名/文案/行序排版/分组标题等）见出口报告追认单节。
-
-## 挂账提醒（非目检项）
-
- 卡⑤ 难度带 MC 取证读数：顺延 Alpha 收官 M4 数值批统一执行，届时另行报批（07-⑱ 在册）。
- 卡⑦ 三裁决（首次固定/显式指定/种子不进玩家 UI）2026-10-07 已裁，本批即其执行。
@@ -10,6 +10,7 @@
 | `iter<N>-实现报告-<日期>.md` | 各任务卡状态、实机目检总清单、遗留读数义务 | 迭代批 |
 | `iter<N>-代拍板-<日期>.md` | 批内 agent 替你拍的决定清单，等你追认或推翻 | 迭代批 |
 | `iter<N>-反哺点-<日期>.md` | 需要写进 `design/` 权威文档的点，逐条列清"哪个文件哪一节、改成什么、依据是什么" | 迭代批 |
+| `iter<N>-<交付物名>-<日期>.md` | 需求卡片点名的其它交付物（例：`iter27-探针迁移对照-2026-10-14.md`＝11 个探针的成员依赖面清单） | 迭代批 |

 ## 不放什么

@@ -33,7 +33,8 @@ r"""数值验证工具（判定端）——自动化评判 + 元进度爬升测
  python tools/balance_verifier.py --na 60 --k 60 --seed0 9000 --spend atk_first
  python tools/balance_verifier.py --only adventure --inject max_hp:3 --na 100
  python tools/balance_verifier.py --from-raw <raw.jsonl>   # 免重跑，对既有采集重新判定/出报告
-输出：控制台判定结论 + design/qa/balance-verifier-<时间戳>.md（报告）+ 同名 .raw.jsonl（原始逐局数据）。
+输出：控制台判定结论 + sim-data/balance-verifier-<时间戳>.md（报告）+ 同名 .raw.jsonl（原始逐局数据）。
+      两件均落 sim-data/（整目录不入 git，读数以最新一份为准）。
 兼容注：2026-09-23 前的旧 raw.jsonl 含 level 段（直入口单关）行——本版判定自动忽略，
 逐关读数一律由冒险行派生。
 """
@@ -51,7 +52,7 @@ ROOT = Path(__file__).resolve().parent.parent
 SLICE = ROOT / "game"
 GODOT = r"D:\code\godot\Godot_v4.7.2-stable_win64_console.exe"
 SCRIPT = "res://smoke/verifier_batch.gd"
-QA_DIR = ROOT / "design" / "qa"
+READINGS_DIR = ROOT / "sim-data"
 VJSON_PREFIX = "VJSON "
 ERROR_MARKERS = ("SCRIPT ERROR", "Parse Error")

@@ -728,8 +729,8 @@ def main():
        print(f"[数值验证] 已载入既有采集 {len(rows)} 局：{raw_path}")
    else:
        rows, _ = collect(args)
-        QA_DIR.mkdir(parents=True, exist_ok=True)
-        raw_path = QA_DIR / f"balance-verifier-{ts}.raw.jsonl"
+        READINGS_DIR.mkdir(parents=True, exist_ok=True)
+        raw_path = READINGS_DIR / f"balance-verifier-{ts}.raw.jsonl"
        with open(raw_path, "w", encoding="utf-8") as f:
            for r in rows:
                f.write(json.dumps(r, ensure_ascii=False) + "\n")
@@ -747,7 +748,7 @@ def main():
    if args.from_raw:
        md_path = raw_path.with_suffix(".md")
    else:
-        md_path = QA_DIR / f"balance-verifier-{ts}.md"
+        md_path = READINGS_DIR / f"balance-verifier-{ts}.md"
    md_path.write_text(md, encoding="utf-8")
    print(f"[数值验证] 报告：{md_path}")
    print(f"[数值验证] 原始逐局数据：{raw_path}（--from-raw 可免重跑重判）")
@@ -28,18 +28,17 @@ TOP_DIRS = {"archive", "artwork", "design", "game", "sim-data", "tools", "report
 ROOT_FILES = {"AGENTS.md", "README.md", "roadmap.md", "stage.txt", "review-mode.txt",
              ".gitignore", ".zcodeignore"}
 # 3) 图像允许目录（相对路径前缀；archive/ 为归档 zip 不扫）
-# design/qa/ 收编（迭代 5 返工批 2026-09-29——U2 目检预览图/QA 呈现产物归位，commit 留痕）
 # game/tests/golden/ 收编（迭代 19 卡① T2/T6 2026-10-08——棋盘 golden 基线=机检测试资产非美术素材，
 #   素材齐盘态生成入库【基线换代权限 Q6】；T1 落库时漏改本白名单致熵增闸红，同批修订 commit 留痕）
 IMAGE_EXTS = {".png", ".jpg", ".jpeg", ".webp", ".gif", ".svg", ".pxo", ".psd", ".bmp"}
 IMAGE_PREFIXES = ("artwork/", "game/assets/", "design/art/references/", "design/dev/architecture/",
-                  "design/qa/", "game/tests/golden/")
+                  "game/tests/golden/")
 # 4) 退役路径（目录或文件任一再现即 FAIL）
 RETIRED = ["production", "docs", "tests", "qa-data", "design/registry",
           "design/art/candidates", "production/mockups",
-           "design/ux", "game/tools"]
+           "design/ux", "game/tools", "design/qa"]
 # design/ 一级子目录白名单（防 ad-hoc 新目录）
-DESIGN_SUBDIRS = {"art", "dev", "gdd", "qa", "research"}
+DESIGN_SUBDIRS = {"art", "dev", "gdd", "research"}


 def scan():