feat(闸): 验证闸按改动域分跑 + 迭代批禁写 design/ + 新建 reports/ 收实现批产出物
用户裁定（2026-10-17）五条：①代码批只跑代码闸、文档批只跑文档闸；②迭代批是代码实现批，
禁写 design/，文档只读、是实现批写测试与代码的输入依据；③迭代实现报告不写在 design/ 内；
④不设文档编写 skill——文档由用户在会话中讨论后落地；⑤本批属工具/规则面，不占迭代号。
一、tools/run_all_gates.sh（域划分唯一出处）
- 新增 `--code`（01 冒烟/02 单元/03 探针 --click/04 探针 --full/05 渲染闸/09 静态扫描/11 回放对拍）
与 `--docs`（06 gdd_lint/07 doc_link/08 doc_term/08b active.md 体量）；10 熵增闸两域都含
（文档批新增或挪动 .md 同样会绊它，且纯文本秒级）；不带参数＝全量，改闸件本身或跨两域时用。
- 域外闸不入 NAMES，不产生假变化；同时修「基线绿 → 现 SKIP」被误判为闸况变化（--quick 回执
此前永远自带三条假红）。
- 回执增 domain 与 not_run 字段。
- 导出 PYTHONIOENCODING=utf-8：GBK 控制台下 06/10 两闸打印 ✅/✗ 直接崩（假红）、09 的 FAIL 行
写成乱码字节致指纹漂移（假「红项清单变化」）、末尾汇总自身崩打不出结论——2026-10-16 实踩。
- 新增代码域素材齐盘预检：game/assets/art/** 与一切 *.import 边车都不入 git（2026-09-29 裁定），
worktree 冷检出必空盘 → main_theme.tres 解析失败 → 冒烟 V1 七项假红。缺位即拒跑并列缺哪件，
附处置命令（cp 主区素材 + --editor --quit 刷导入；--import 不生成新素材边车）。
二、tools/render_gate.sh（空跑判绿改判红）
- 棋盘/菜单两段 golden 在素材缺位时原为 SKIP，而闸末照样打印「全绿」exit 0——一个像素都没比
却报通过。2026-10-16 菜单废基线事故正是靠这个信号盲区混过 worktree 自检的。现改判红。
三、reports/ 新顶层目录（实现批唯一可写目录）
- 收迭代实现报告/代拍板追认单/GDD 反哺点清单；repo_structure_audit.py TOP_DIRS 与 CLAUDE.md
Project Layout 两处白名单同批改齐（熵增闸自陈的强制口径）；reports/README.md 立范围与生命周期。
四、规则文本五处同步
- CLAUDE.md：验收口径改按域；硬性红线新增「两类批」条（迭代批禁写 design/ 与根规则文件、
产出只落 reports/、只跑代码域闸；非迭代批不占迭代号）；Project Layout 登记 reports/。
- process-conventions：§3.10 批末按域验收；§3.12 补 active.md 例外（会话状态唯一源，钩子本就
豁免）；§3.13 重写为「实现批禁写文档、产出物落 reports/、反哺点由文档批裁决后写入」；
§4 分级周期口径改三档；§2 三段流程「三·实现」行加禁写面。
- doc-conventions 载体分工表：迭代实现报告落位由 design/qa/ 改 reports/。
- architecture.md「测试与质量域」：新增「改动域划分」节（域表＋唯一出处声明＋素材预检缘由），
本表是现状登记非第二份清单。
- 06-待办清单：登记本批两处代拍板（active.md 例外读法、reports/ 新顶层目录）与旧实现报告
iter27/iter28 两份仍在 design/qa/ 未迁位的欠账。
五、连带（不在本仓库，gitignored 本地 harness 配置）
- .zcode/hooks/worktree-guard.sh：合回校验由「不碰 game/ 即全免」改为按 diff 路径推定所需域、
要求回执 domain 覆盖之；未登记路径按最严处理，禁默认放行。旧豁免的漏洞：改闸件本身反而零验证。
- ~/.zcode/skills/iter/SKILL.md：顶部加批性质与闸域两条强制声明；批末重闸移出 doc 三闸；
总收口产出物改落 reports/、roadmap 换代移出本批；定义面入库注明是搬运非撰写。
验证：--docs 域全绿（06 由基线红改善为绿，因 fcb8c3f8 已补 01 篇流程图）；素材预检反例实测
（移走 button_stone.png → 拒跑 exit 1，还原后正常）；渲染闸缺盘反例实测（exit 1 并报 FAIL）；
--code --docs 互斥与非法参数 exit 2；guard 内嵌 python 编译通过并按 docs 域回执放行 docs 批。
This commit is contained in:
DKChan committed
1 parent
fcb8c3f843
commit
b27e4710b6
9 files changed
+157
-29
No files matched your search
@@ -14,7 +14,8 @@
|
||||
# ③ 棋盘 golden 逐像素（T2）：board 整屏帧按 board_meta.json 取样坐标裁剪棋盘区
|
||||
# （tools/golden_board_crop.py——禁硬编码像素）→ tools/golden_compare.py 对
|
||||
# game/tests/golden/ 三张基线（容差 provisional：差 ≤16/changed ≤2%，S2 停机点口径）。
|
||||
# 素材缺位=SKIP 不判红（Q5 运行时口径；基线生成期素材缺位=L3 停机——基线禁锚回退态）。
|
||||
# 素材缺位=判红（2026-10-17 改；此前是 SKIP 不判红——但缺盘时这一段根本不对比，闸末仍打
|
||||
# 「全绿」exit 0，等于空跑判绿。基线生成期素材缺位=L3 停机，运行期同样无权出验收结论）。
|
||||
# ④ 基准档 1280 单档（Q4）。1920 档注记：16:9 全屏下 stretch=canvas_items/aspect=keep 等比
|
||||
# 1.35×+左右黑边各 96px，构图与基准档一致（迭代 9 分辨率案甲）——分辨率维度不重复建闸。
|
||||
# （原由 ui_layout_probe 两档断言承担，探针已随 2026-10-15 裁「无使用的探针删除」退役，
|
||||
@@ -112,7 +113,9 @@ if [ ! -d "$REPO/game/tests/golden" ]; then
|
||||
elif [ ! -s "$BD/board_meta.json" ]; then
|
||||
echo "[render_gate] SKIP — board_meta.json 缺失（取证段已红），golden 对比不判"
|
||||
else
|
||||
# Q5 运行时素材缺位=SKIP：基线锚在素材齐盘态，缺盘态对比必误红——SKIP 不判红，注记在案
|
||||
# 素材缺位=判红（2026-10-17 由 SKIP 改）：缺盘态下这一段一个像素都不比，而闸末照样打印
|
||||
# 「全绿」退出码 0——那是空跑判绿，比误红危险得多（2026-10-16 菜单废基线事故正是靠它蒙过
|
||||
# worktree 自检的）。基线锚在素材齐盘态（Q5），缺盘态本就无权出验收结论。
|
||||
_asset_miss=0
|
||||
for a in assets/fonts/ui_font_fusion_pixel_zh_hans.ttf \
|
||||
assets/art/board/flag_seal.png \
|
||||
@@ -120,7 +123,7 @@ else
|
||||
assets/art/board/terrain_wall_n_dungeon.png assets/art/board/terrain_floor_dungeon_1.png \
|
||||
assets/art/board/terrain_wall_n_underdark.png assets/art/board/terrain_floor_underdark_1.png \
|
||||
assets/art/board/terrain_wall_n_deep_underdark.png assets/art/board/terrain_floor_deep_underdark_1.png; do
|
||||
[ -f "$GAME/$a" ] || { echo "[render_gate] SKIP — 棋盘素材缺位: $a（Q5——基线禁锚回退态，运行时 SKIP）"; _asset_miss=1; break; }
|
||||
[ -f "$GAME/$a" ] || { echo "[render_gate] FAIL — 棋盘素材缺位: $a（Q5：基线锚素材齐盘态，缺盘不得出验收结论）"; _asset_miss=1; }
|
||||
done
|
||||
if [ "$_asset_miss" -eq 0 ]; then
|
||||
CROP="$TMP/crop"
|
||||
@@ -143,7 +146,7 @@ if [ ! -s "$REPO/game/tests/golden/menu_boot.png" ]; then
|
||||
elif [ ! -s "$SHOT/shot_menu.png" ]; then
|
||||
echo "[render_gate] SKIP — shot_menu.png 缺失（shot_probe 段已红），菜单 golden 不判"
|
||||
elif [ ! -f "$GAME/assets/fonts/ui_font_fusion_pixel_zh_hans.ttf" ] || [ ! -f "$GAME/assets/art/ui/button_stone.png" ]; then
|
||||
echo "[render_gate] SKIP — 菜单素材缺位（字体/按钮石纹——Q5 口径：基线禁锚回退态，运行时 SKIP）"
|
||||
echo "[render_gate] FAIL — 菜单素材缺位（字体/按钮石纹）：基线锚素材齐盘态，缺盘不得出验收结论（2026-10-17 由 SKIP 改判红）"; _rc=1
|
||||
else
|
||||
MENUG="$TMP/menugolden"
|
||||
mkdir -p "$MENUG"
|
||||
|
||||
Reference in new issue
Block a user