From 165a28f6d1a260316b6a022f9bc1cb6200906ed1 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Tue, 3 Nov 2026 03:21:53 +0800 Subject: [PATCH] =?UTF-8?q?=E5=B7=A5=E7=A8=8B(ci=E8=BF=9C=E7=AB=AF?= =?UTF-8?q?=E5=8C=96=C2=B7=E4=BB=B6=E6=A0=B8=E4=BF=AE=E5=A4=8D):=20doc=5Ft?= =?UTF-8?q?erm=E9=80=80=E5=BD=B9=E8=AF=8D=E3=80=8C=E9=9A=8F=E6=89=B9?= =?UTF-8?q?=E3=80=8D=E4=B8=80=E5=A4=84=E6=94=B9=E5=86=99(=E7=9B=AE?= =?UTF-8?q?=E6=A3=80=E6=B8=85=E5=8D=95=E3=8A=BE=E5=88=A4=E6=8D=AE=E5=88=97?= =?UTF-8?q?);=20run=5Fall=5Fgates=E5=A4=B4=E6=B3=A8=E6=9C=AC=E5=9C=B0CI?= =?UTF-8?q?=E8=A1=A8=E8=BF=B0=E6=8D=A2=E4=BB=A3(=E4=BB=B6=E6=A0=B8grep?= =?UTF-8?q?=E6=AE=8B=E7=95=99=E5=BD=92=E9=9B=B6);=20architecture.md?= =?UTF-8?q?=E8=BD=A6=E9=81=93=E5=88=86=E5=B1=82=E8=8A=82=E9=AA=8C=E8=AF=81?= =?UTF-8?q?=E5=8F=A3=E5=BE=84=E6=8D=A2=E4=BB=A3=E8=BF=9C=E7=AB=AFCI?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- design/engineering/architecture/architecture.md | 2 +- tools/run_all_gates.sh | 4 ++-- 体验验证清单.md | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/design/engineering/architecture/architecture.md b/design/engineering/architecture/architecture.md index 7aab90d8..ff7060fa 100644 --- a/design/engineering/architecture/architecture.md +++ b/design/engineering/architecture/architecture.md @@ -267,7 +267,7 @@ |---|---|---|---| | **worktree-guard**（ZCode PreToolUse） | `.zcode/hooks/worktree-guard.sh`（本机件，不入 git） | agent 侧车道纪律：主工作区 Edit/Write 与主区非 merge `git commit` 拦截（豁免 `.zcode/`、`.qoder/`；worktree 内目标快速放行；合并收尾提交凭 MERGE_HEAD 豁免）；`git commit --no-verify` 拦截（该旗标仅属用户）；iter 分支合回一卡一提交数卡校验；规则闸 | 路径性质＋分支名＋MERGE_HEAD＋git 图 | -验证收拢为合回后本地 CI 全量（post-merge 触发），commit 点零执法；主工作区防污染由 ZCode 层守卫承担——只约束 agent，用户手工改动不受限。子代理覆盖面（2026-10-26 冷启动评估实测）：子代理的工具调用不经过 ZCode 层守卫——ZCode 层实际只覆盖主会话工具调用；残余暴露面＝子代理写主工作区与蓄意 `--no-verify`（该旗标整族跳过 git 层钩子），属故意越权而非遗忘型失误，与防遗忘的设计目标正交。 +验证收拢为合回后远端 CI（post-merge 钩子推送 origin master 触发 Gitea Actions，runner＝Mac 本机 host 模式；按改动域分流，分流单点＝tools/ci/domain_route.sh），commit 点零执法；主工作区防污染由 ZCode 层守卫承担——只约束 agent，用户手工改动不受限。子代理覆盖面（2026-10-26 冷启动评估实测）：子代理的工具调用不经过 ZCode 层守卫——ZCode 层实际只覆盖主会话工具调用；残余暴露面＝子代理写主工作区与蓄意 `--no-verify`（该旗标整族跳过 git 层钩子），属故意越权而非遗忘型失误，与防遗忘的设计目标正交。 ### 三条判定硬闸现行状态 diff --git a/tools/run_all_gates.sh b/tools/run_all_gates.sh index 399c0b51..bc396897 100755 --- a/tools/run_all_gates.sh +++ b/tools/run_all_gates.sh @@ -4,8 +4,8 @@ # 漏跑 probe_gate --full 的成因：清单散落三份文档、彼此不一致、且无机器校验）。 # # 跑完写回执 game/tests/.gates/receipt.json（commit＋内容树哈希＋各闸退出码＋存量基线比对＋时间戳）； -# 本地 CI（tools/ci_runner.sh，2026-10-30 用户裁）读回执写 ci-status.json——强制验证点＝合回 master -# 后 post-merge 钩子触发的全量跑批；本脚本手动调用（--code/--docs/全量档）只服务开发期按域跑批。 +# 远端 CI（2026-11-03 用户裁）读回执判定，回执经 tools/ci_watch.sh remote 轮询 Gitea API 写 ci-status.json—— +# 强制验证点＝合回 master 后 post-merge 钩子推送触发的远端跑批；本脚本手动调用（--code/--docs/全量档）只服务开发期按域跑批。 # 跑闸时代码面带着未提交改动，回执会标 dirty_game（验的不是 HEAD 字节），CI 判定照常落账留痕。 # # 用法：tools/run_all_gates.sh [--code|--docs|--quick] diff --git a/体验验证清单.md b/体验验证清单.md index a5e8f82b..71e352e7 100644 --- a/体验验证清单.md +++ b/体验验证清单.md @@ -599,7 +599,7 @@ | # | 目检项 | 判据 | |---|---|---| -| 1 | Mac 端 golden 基线正确性 | mac/ 子目录四张基线（棋盘三图＋menu_boot）重制生成后人工判定：布局骨架与现网一致、无素材缺位字形回退、无渲染异常（错位/透明块/花屏）；判定通过随批提交入库，此后渲染闸在 Mac 上以该套基线逐像素比对 | +| 1 | Mac 端 golden 基线正确性 | mac/ 子目录四张基线（棋盘三图＋menu_boot）重制生成后人工判定：布局骨架与现网一致、无素材缺位字形回退、无渲染异常（错位/透明块/花屏）；判定通过后经下一批提交入库，此后渲染闸在 Mac 上以该套基线逐像素比对 | | 2 | Mac 端渲染闸全链目检 | 远端游戏码批跑渲染闸时 Mac 桌面短暂弹 Godot 窗口属预期（窗口化截图取证）；七屏截图与三段取证文件齐全、shot_checker A–D 无红 | - **红灯信号**：基线帧出现素材缺位字形、明显错位或花屏；渲染闸报「取证缺失/零字节」。