Files
gplan-2/tools
DKChan b27e4710b6 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 批。
2026-10-17 00:40:53 +08:00
..
feat(resource): 格面资源八型批——伏击退役换装警觉+新增行动点第8型+护甲型数值对齐(2026-09-20 用户拍板)——①动机=全字典镜像对账(系统设计分析):伏击的层数×出手敌数复利集中在主角单血条、与爆裂粉尘摊 N 条敌方血条双重不对称;护甲型惩罚 −2 比奖励 +1 反向偏重;敌方护甲等级轴全系统空缺;②伏击退役=伤害公式拆除伏击附加项(敌方技能攻击=max(damage_floor, floor(掷点档位技能基础分量)×乘区)+rider)、快照 ambush_layers 字段拆除、效果行/毒爆复算断言同步;③blast 负向换装=enemy_alert 警觉(敌方全体护甲等级 +1/层,1 结算,side-wide 逐颗叠加无上限)——消费=_defender_ac 敌方侧 ac 型状态读法本批接线(防守方 AC=表值+Σac 型效果,敌方路径从纯表值扩展);④第 8 型 action=ap_up 行动点(正向,下轮 AP+1,weight 6)/ap_drain 迟滞(负向,下轮 AP−1)——action_economy 排队面 queue_ap_delta/pending_ap_delta 新增,notify_round_start 兑现(基线 6+净值,下限 0,兑现清零),明细记 effect 行;⑤护甲型对齐=off_guard −2→−1;⑥schema=八型封闭枚举十六格、伏击加层行特例校验退役、effect_pool_map 删 ambush/flat_attach 键;⑦表现层=敌卡伏击池行拆除(警觉入敌方增益投影,percent|ac 双量纲)、状态槽图标 ambush→alert;⑧文档=敌人系统 v0.12(伏击节退役改写)/战斗结算 v0.20(公式与授予段)/地图战斗资源 v0.14(八型字典)/行动经济 v0.5(下轮行动点修正节+F1 条款3 改写)/难度曲线 v0.15/增益状态 v0.8/06 清单(伏击量纲条目随批解决+调参批数值点评登记)/registry 22 处(ambush_unit_definition 退役+继任 alert、clause3_supply 伏击暴露口径作废、reward_table 八型 74 权重、行动经济排队面)/ux battle/关卡节点地图;⑨工具=analyze_playtest M_AMB 归零保旧日志兼容、clear_dominance 伏击暴露模型转历史口径注记(新口径归调参批);⑩验证=冒烟 330 项 0 失败三闸全过(新增警觉在位+action 正负抵消排队断言)+gdd_lint 与 master 基线一致(8 文件存量);遗留=警觉/行动点数值 provisional 归曲线调参批(06 已登记),真人批试玩建议在终版规则上执行
2026-09-20 03:58:15 +08:00
2026-09-14 18:18:49 +08:00