game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
2,209 Commits 23 Branches 0 Tags
a92ef2e3f4a98e3a806387e3afad45fe13ce8f3d
Commit Graph
2209 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
DKChan 9723c1524b feat(屏蔽): 贫矿脉地形变异删行——用户令「特异关卡后续重新设计，先屏蔽」（2026-10-16） 
- variation.tres 删 skewed_veins 行（scope=global/resource_face/effect_value=30）：
  Boss/精英图全局池空 → _resolve_global_variant 空行回落 → region 布置原路兜底，
  玩家面零横幅零角标零资源偏斜；删行依据与首发批裁决记录改写为屏蔽注记（git 历史可溯）
- smoke_all.gd 7 处断言换代为「全局池空→region 兜底回落」路径：
  行数 7→6 / boss 池去 skewed_veins / L2 boss+elite 全局决议改断言空行 /
  Boss 图改断言恰一行 region 变异+格子级布置恢复+取号恢复 / 快照投影与板载一致 /
  同种子确定性（region 路径）；节头与 print 同步换代
- resource_face 机制代码（RewardEconomy 偏斜投影/schema 互锁/负样本）零触碰，
  重建设计直接加行即可
 2026-10-16 03:05:26 +08:00
DKChan e8ceb27243 chore(闸门): doc_term 升级为硬判定（2026-10-16 用户令，用语规范批第二步）——tools/run_all_gates.sh 文档三闸段 08 doc_term 加 --strict：疑似现行 ≥1 即该闸红 → 回执红 → worktree-guard 拦截合回主分支；专项补扫通道（随批/台账）本并入同一判定。通电验证——现状全绿 exit 0、注入违规行 exit 1、删除回绿；基线零漂移（此前全库疑似现行已随换代批清零，exit 码不变）。按用户令不做编辑期钩子（每编辑起 Python 进程的性能损耗否决，改为定期跑批扫描），不做豁免清单机制 tools/doc_term_known.txt 2026-10-16 02:55:36 +08:00
DKChan 175aa3f9ea docs(架构): v1.7 补修两处——①架构原则 1 残留英文层名 Core/Feature 改中文（核心层/功能层），与本文层名对照注记统一；②模块归属命名规约描述同步 code-conventions 文件头第三轮新规：头注禁写文档链接，「实现 GDD：xxx」一类已废止，代码↔设计追溯由 GDD 文档与 registry 承担。三闸全绿（gdd_lint 0 不通过/doc_link 死链 0/doc_term 疑似现行 0） 2026-10-16 02:28:10 +08:00
DKChan 86169065af docs(用语): A 表全量词面换代批（2026-10-16 用户令第一步）——design 四域 36 文件机械替换约 371 处：随批→顺带 123、收口→完成 114、落文→写入文档 76、不得→禁止 53、台账→状态记录 35、对拍→逐项比对 12、销号/销账→注销 12、在飞→正在执行中 3、不报错→不返回错误 1；豁免面零触碰——版本历史既有行、对照性替换记载句（「X」→「Y」）、术语表与 doc-conventions 条文自身、engine-reference 留档区、美术审计会话存档、buff/debuff 代码标识符、「不得不」惯用语；难度曲线与Boss「随批次扩展」改「随后续批次扩展」避词面误中；三闸全绿（gdd_lint 0 不通过/doc_link 死链 0/doc_term 疑似现行 0 含 --strict 复核）；闸门升级（--strict 入钩子+豁免基线清单）按用户令留待后续讨论 2026-10-16 02:17:00 +08:00
DKChan 0ea3a0f53a merge: 纯文档合入豁免条款+active.md 501 条入库 2026-10-16 02:05:31 +08:00
DKChan 3b083b2257 docs(guard): 纯文档合入豁免条款入库（合回闸：merge diff 不触 game/ 放行，2026-10-16 用户令「改了代码的合入才做测试验证」）+active.md 501 条（用语规范批收口登记） 2026-10-16 02:04:48 +08:00
DKChan ddb598f712 docs(06): 用语规范 A 表清残留——「在飞」五处→「正在执行中」（2026-10-16 用户令；M4 族四条状态行内〔不影响 17 在飞开发〕括注词面换代，语义零改动；08 无命中）；三闸全绿（gdd_lint 0 不通过/doc_link 死链 0/doc_term 在飞组仅余 registry/architecture.yaml:30 一处——06/08 范围外，留后续换代批） 2026-10-16 01:50:03 +08:00
DKChan 0ad7931907 docs(规约): 文件头第三轮定稿——介绍本模块入规范（Python 存在性条款成文）+白名单两类+一切文档反向链接废止（用户令） 
§1.4.1 换代：头注存在性=pyguide §3.8.2 明文要求（module docstring 介绍 contents and usage）+PEP 257；白名单五类砍两类（①职责摘要 ②使用约束）；黑名单新增一切文档反向链接（实现 GDD：/指路：废止，追溯归 GDD 文档与 registry 侧）；§1.4 GDD 锚行条款同步废止；§2.1 删留指路行死句；CLAUDE.md 红线同步
 2026-10-16 01:45:27 +08:00
DKChan 067173f1bf merge: ADR 清除补漏（tests.yml 6 处 + 冒险结构复活行；纯文本改动） 2026-10-16 01:23:48 +08:00
DKChan bfa44b138e docs: ADR 清除批补漏两处——①.github/workflows/tests.yml 6 处 ADR-0004 引用（原批 --include 过滤遗漏 .yml 扩展名；该文件存废归迭代 29 CI 批，本次只清 ADR 关联）；②冒险结构.md:187 的 ADR-0007 裁丙复活（并行会话 4d3f8d66 合并冲突解法倒回未清除版，重新清除） 2026-10-16 01:23:26 +08:00
DKChan 4ca2d10245 docs(08): 状态刷新批 v1.6（2026-10-16 用户令）——锻造工坊行/路线行族（事实源订正 meta_forge.tres→forge.tres）/营地锻造柜台占位注 三处失实回填为在役；数值统一标定按 2026-10-09 里程碑立规（M4=Beta）结案、移入「六 · Alpha 不含」，未决项八减为七重编号；文头状态行 v1.4→v1.6（v1.5 漏更一并补）；06 立绘条未决项指路由旧编号改按名指路。三闸全绿（gdd_lint 0 不通过/doc_link 死链 0/doc_term 仅存量备忘） 2026-10-16 00:50:39 +08:00
DKChan af321c0385 merge: 简明技术中文用语规范批——GDD 全库词面换代约 250 处+术语表用语规范节（A 表 12 行+豁免条款）+词条五组+死链清零+doc_term_audit 吸收 A 表（2026-10-15 用户令；九提交含 master 两轮吸收；纯文档合入未跑测试闸，同日 4ed48b86 前例） 2026-10-16 00:12:35 +08:00
DKChan 4d3f8d6653 merge: master 二次吸收（ADR 体系废除批+布局闸入库） 
# Conflicts:
#	design/gdd/02-系统清单.md
#	design/gdd/systems/冒险循环/冒险结构.md
#	design/gdd/systems/表现与支撑/数据配置.md
#	design/gdd/ux/battle.md
 2026-10-16 00:08:01 +08:00
DKChan 19d036ce2c merge: 布局闸入库（layout_probe 补回分辨率几何断言·两档） 
档位表是数据、断言是一份函数据——测试代码量与档数无关，增删档只改数组一行。
档位按 battle.md 现登记的两档（1280×800 / 1920×1080），未新增。

修正旧探针的假断言：headless 下 get_window().size 不改变视口（实测），
正确接口是 content_scale_size。旧探针「1920 档恒定」永远为真。

变异验证两发：B区高度撑爆→5 条红✓；注入全幅兄弟控件→未见红✗（边界已如实标注）。
挂 probe_gate 默认必跑段。全量闸 9绿1存量红，回执 commit=5af6c8a8。
 2026-10-15 23:55:53 +08:00
DKChan 3b9629d8a3 docs(active): 500 条——决策文档体系废除批收口；修正 499 条分支台账失实（ci-removal-20261015 实际未合入，其 ADR 两条已被本批取代）；架构行改 v1.6 2026-10-15 23:54:47 +08:00
DKChan 4ed48b8620 merge: ADR 体系废除 + architecture.md 确立架构唯一事实源（文档批，73 文件；死链 1206 链接 0 死链、gdd_lint 0 不通过；按用户令未跑测试闸） 2026-10-15 23:52:54 +08:00
DKChan 6c2dbc37c1 docs: ADR 体系废除 + architecture.md 确立为架构唯一事实源（2026-10-15 用户令：决策记录归 git commit log，不另存决策文档） 
- 删除 design/dev/architecture/adr-0001~0007 共 7 份文件（内容留 git 历史可查）
- architecture.md：删「ADR 审计」「ADR 立项清单」两节；清除全文 ADR-000X 注记、QQ 表/S 表 ADR 引用；未决表关闭已落定项（QQ-01/02/03），立项清单在途事项转登记 QQ-11~14；补 A1 生成姿态事实、autoload 四件清单、board_generator 性能姿态；文档状态立「事实源地位」条
- CLAUDE.md：恢复 RNG 单点硬性红线（去 ADR-0007 引用）；新增「架构事实唯一源」红线；规范导航架构行标注唯一事实源
- doc-conventions：§5 增「架构事实唯一源」行；§11 活文档清单补架构文档
- registry：architecture.yaml 删 18 处 adr 字段、autoload_set 补 SaveManager/MetaProgression、board_rending 更新为 Node2D 已落地事实；entities.yaml 12 处引用清除
- game/ 代码注释约 60 处清 ADR-000X 引用（事实与日期保留）；豁免标记 ADR-0007-exempt → rng-seed-exempt（main.gd/static_scan.sh/architecture.md/06/iter27 五处同步）
- GDD/qa 实现报告/research 卡片/roadmap/tests README 引用全清；死链校验 1206 链接 0 死链、gdd_lint 0 不通过
- 代码中 adr/adr5 等为 adventure_runner 既有局部变量名（非 ADR 引用），未动
 2026-10-15 23:52:30 +08:00
DKChan 5af6c8a8b4 feat(布局闸): layout_probe 补回分辨率几何断言（两档·一份断言函数据） 
背景：孤儿探针 ui_layout_probe 退役后1920 档布局几何无机器承载。重建但改形态——
「档位表（数据）+ 一份不变量断言（代码）+ 循环代入」，测试代码量与档数无关，
增删档位只改 VIEWPORTS 数组一行。这与业界 Playwright parametrize/projects 同构：
同一个 test body 跑多档，变的只是输入表与基线图张数（数据非代码）。

档位按 battle.md §验收现登记的两档：基座 1280×800、16:9 全屏 1920×1080。不新增档。

关键修正——旧探针那条「1920 档几何恒定」断言是假的：
  设get_window().size = 1920×1080 → 逻辑视口仍是 1280×800（headless 下不生效）
  设 content_scale_size = 1422×800 → 逻辑视口 = 1422×800（真生效）
Godot 文档指定的运行时改基座接口是 content_scale_size；旧探针用错了 API，
其断言永远为真、当年报 PASS 是假绿。本探针改用正确接口。

断言面（每档跑一遍）：三区非零/不越视口/两两不重叠/board_view ⊆ board_zone/
格子边长 ≥36px（battle.md §棋盘格尺寸公式 1280 档 12×12 → 36px）。

变异验证（CLAUDE.md 第9条）两发：
  ① battle_stage_view B区 252→700 → 5 条红（两档都中）✓ 还原后 PASS
  ② 注入全幅 ColorRect → 未见红 ✗ —— 判据只点名三区不覆盖第四个兄弟，
    该缺陷类不在拦截面内。已在代码注释标明边界，未过度设计补递归遍历
    （递归全子树查重叠极易误报容器父子关系）。

挂 probe_gate 默认必跑段（轻闸即跑）。S10 文件头闸本批零新增。
 2026-10-15 23:46:39 +08:00
DKChan c963004236 merge: master 吸收（收口机制批+闸收敛批二+10-15 文档落库）——冲突五件解毕：术语表/02/数据配置取本批超集（用语规范节/同源两行/死链史实版），元进度 v1.12 与天赋树 v0.5 取主区侧（更名记载显示文字保真），doc_term_audit 语境豁免并集（主区六组+本批 buff 组） 2026-10-15 23:32:01 +08:00
DKChan 07382a4e70 docs(gdd): 用语规范批 W4——06 在办现役条目词面 32 处（随批 11/落文 8/收口 5/不得 3/台账 2/销号 1/对拍 1/语序适配 1），已办结与裁决记载 87 处按豁免保留并逐条分类；战斗表现/敌人系统台账引路 3 处换代状态记录（终扫）。06 无版本历史节不新增 2026-10-15 23:28:10 +08:00
DKChan 83c88c4566 docs(gdd): 用语规范批 W3——表现与支撑 16 处+ux 55 处词面换代（收口 19/台账 17/随批 11/不得 12/buff 1 等按 A 表）＋死链终清（config_fatal_probe 迭代19退役去向双证并入数据配置 v0.4 行注）＋camp 文头 v1.5/level-clear Last Updated 失同步补齐。伏击者留痕与验收口径子串误报按豁免保留 2026-10-15 23:11:18 +08:00
DKChan f22adb5564 docs: 落库 10-15 日间未提交文档改动——architecture.md v1.5（测试与质量域节迁入+中文化+现状同步）/ CLAUDE.md 规约导航表去 adr 指针（同 diff 删了 RNG 单点红线一行，疑似误删，由 ADR 清除批处理）/ 02-系统清单补 08-Alpha 登记行（10-13 遗留） 2026-10-15 23:02:55 +08:00
DKChan 07a0ae6e31 merge: 收口机制批（active.md 体量闸 08b + 退役清理 + 收口 skill） 
- tools/audit_active_state.py：五条膨胀签名（条目超 30、快照超 10、编号重复、快照整行自我重复、design/qa|research 死指针）
- 并入 tools/run_all_gates.sh 为 08b，由既有合回闸回执强制，不另立第二份闸清单
- active.md 严格退役：118 行/34 条 → 45 行/4 条，快照换代为 10 行
- doc-conventions §10、process-conventions 记机械闸与豁免面（补 .qoder/）
 2026-10-15 22:55:22 +08:00
DKChan 99a09ad6a0 docs(收口机制批): 台账按合并现状校正——499 去掉「待发令合回」失真措辞并补记 hooks 不随仓库传播（Qoder 侧活体探针未被执行、成因待诊断，Claude 侧配置为空，仅 ZCode 在跑）；快照与未决面按 gatefix-20261015、ci-removal-20261015 已合入 master 换代，t17 存量红改记「曾有」 2026-10-15 22:54:52 +08:00
DKChan 59fdb15567 docs(gdd): 用语规范批 W2——systems 十九篇词面换代 74 处（收口 21/不得 13/报错 7/若干 8/对拍 3/在飞 1/落文 2/随批 2 等按 A 表与语境义改写）+死链修复 2 处（武器锻造→锻造工坊漏改指路）+锻造工坊文头 v0.7→v0.8 失同步补齐；doc_term_audit 增设随批/台账专项补扫通道（白名单自豁免词的版本历史节外可见性）。秘宝充能 2 处与对照性收口 3 处按豁免保留 2026-10-15 22:45:56 +08:00
DKChan de8d28b630 merge: 闸收敛批四（合回闸入库） 
修流程性错误：worktree-guard 的合回闸代码此前只改了主工作区未提交，
master 上 hook 仍是旧版（只拦 commit 不拦 merge），闸机制实际未生效。
八态实测通过。回执 commit=a4fba15e。
 2026-10-15 22:45:18 +08:00
DKChan a4fba15eac feat(闸收敛批四): 合回闸入库（worktree-guard 拦 merge 前校验全量回执） 
修自己的流程性错误：合回闸代码此前只改了主工作区的 .zcode/hooks/worktree-guard.sh，
从未提交——.zcode/ 是 worktree 铁律的豁免直改面，但豁免直改不等于豁免提交，
改完必须 commit 进库。结果是 master 上的 hook 仍是旧版（只拦 commit 不拦 merge），
闸机制实际未生效。

Bash 分支加第三路：merge/rebase/cherry-pick 进 master 前按目标分支反查
worktree 回执（git worktree list --porcelain 定位，兜底扫 sibling 目录），
校验三态——回执 commit == 分支 tip、非 --quick 档、无新增红项；任一不满足 exit 2。

八态实测：匹配回执放行 / commit 错拦 / quick 档拦 / 含红项拦 / 无回执拦 /
worktree 内 commit 放行 / 只读命令放行 / rebase 拦。
 2026-10-15 22:35:06 +08:00
DKChan 28265773af docs(收口机制批): 台账 499 条入档 + 豁免面补 .qoder（本机 harness 配置不入 git，走 worktree 带不进去） 2026-10-15 22:33:37 +08:00
DKChan 20f4a7dc01 feat(收口闸): active.md 体量闸并入全量闸清单——收口漏删旧条目在合回时被拦 
- tools/audit_active_state.py：判四条可机械测的膨胀签名（状态记录条目数>30、
  快照行数>10、条目编号重复含并行撞号、指向 design/qa|research 中间文档的死指针），
  另加快照整行自我重复一项（换代不彻底只往顶部 prepend 的签名）。
- 变异验证：对换代前的 34 条版本报 5 项红（A1/A2/A3/A4/A5 全见红），
  对退役后的 3 条版本报绿；两态实测 RC=1/0。
- 入 run_all_gates.sh 为 08b（脚本即清单，不另立第二份闸清单），baseline.json
  随批补 08b 绿项（本分支内实测绿，非臆造）。
- 规约挂指针两处：doc-conventions §10 机械闸句、process-conventions 批次清单 12。
- active.md 按 §10 退役：状态记录 34→3 条，快照 21 行自我重复压回 10 行，
  删「项目当前位置」整节（滞后且与 roadmap/快照重复），未决面按迭代 27/28 重列。
- 不动 Stop 钩子：回合末判收口时机错配（一轮答完≠任务完成），机械层交合回闸，
  语义层交收口技能。
 2026-10-15 22:23:53 +08:00
DKChan 458085ed32 merge: 闸收敛批三（.gates/.gitignore 入库 + 脚本自愈重建） 
修合回时发现的 receipt.json 误入库——它每跑批覆写，属中间产物。
成因是重跑闸前 rm -rf .gates 把 .gitignore 一起带走，脚本自身不重建。
 2026-10-15 22:16:54 +08:00
DKChan e0ec255d7c docs(gdd): 用语规范批 W1——主档五篇词面与失同步（01 篇六处+行序归位；08 篇状态行 v1.4+现状四值枚举+销号注销；02 篇三处含 08 行版本同步；07 篇 35 处流程动词换代；术语表 A 表补注销词义限定注）。03/04/05 零改动有据 2026-10-15 22:11:19 +08:00
DKChan eb5e892456 fix(闸收敛批三): .gates/.gitignore 入库 + 脚本自愈重建 
合回 master 时发现：.gates/.gitignore 未入库，receipt.json 被纳入版本管理——
它是每跑批覆写的当次回执，属中间产物。

成因：重跑闸前用 rm -rf game/tests/.gates 清目录，把 .gitignore 一起带走了；
脚本自身不重建，跑得再多次也不会回来。

- .gates/.gitignore 入库（挡 receipt.json 与 *.log）。
- run_all_gates.sh 启动时自愈：.gitignore 缺失则重建，杜绝复发。
 2026-10-15 22:07:13 +08:00
DKChan 4a8d57bca0 merge: 闸收敛批全量入库（验收闸唯一入口 run_all_gates.sh + 合回闸回执强制 + 存量红清零） 
两提交：1d4ac91e 闸收敛批一（唯一入口脚本 + 合回闸 + t17 隔离修复 + doc_link 死链归零
+ 规则单一事实源）／94f1bba8 闸收敛批二（gdd_lint 分域豁免 + doc_term 语境豁免 +
孤儿探针退役 + roadmap 同步）。

闸况 9 道绿：冒烟/单元/--click/--full/渲染/gdd_lint/doc_link/doc_term/熵增；
static_scan S10 文件头 125 处按用户令不在本批处理，已落 baseline.json 作存量红。
回执 commit=94f1bba8（合回闸校验通过）。
 2026-10-15 22:06:08 +08:00
DKChan 3105052c51 docs(tools): 用语规范批 M8——doc_term_audit 吸收用语规范 A 表 10 词（对标/若干/不得/报错/buff/收口/在飞/对拍/销账销号/落文）+用语规范节入节级豁免+buff 行内代码语境豁免；术语表对外命名纪律 不得→禁止（A 表自洁）。随批/台账系白名单信号自豁免不列扫，注释在案 2026-10-15 21:54:40 +08:00
DKChan 3eb54002de docs(gdd): 用语规范批 M0——术语表新立用语规范节（STC 权威+已裁替换 12 行+豁免三类）+词条五组（装板/摇号/机能件/机制件/总线/抽屉/坍塌显形）+版本史重排修复双 v1.2 2026-10-15 21:50:04 +08:00
DKChan 94f1bba840 fix(闸收敛批二): gdd_lint 分域豁免 + doc_term 语境豁免 + 孤儿探针退役 
用户令四条：清单类与术语表免 GDD 规范性检查、退役词统一处理、文件头另处解决、
无使用的探针全删。

- tools/gdd_lint.py：新增 RULE_EXEMPT（规则粒度分域豁免，**按规则不按文件**）——
  06 免 R3/R4/R7、07 免 R3/R5/R7、术语表免 R2/R5。
  理由逐条写进代码注释：R3 禁修订注记与「登记处条目要能回答谁在何时裁的」直接冲突；
  R4 版本历史节与 06「解决即移除」的状态登记体裁冲突；R5 是节名含「流程」即触发的误匹配
  （07 的「㉖全流程走查」是目检清单节、术语表「开发流程」是词条节）；
  R7 长括注在登记处是常态。
  **机械可判的完整性规则 R6/R8/R9/R10/R11 一律不豁免**，真缺陷不得藏起来。
- design/gdd/术语表.md：版本号撞号订正（10-12 那条 v1.2→v1.9，两条 10-13 顺延 v1.10/v1.11），
  按真实时序重排。原撞号源于 2026-10-11 与 10-12 两批各写一个 v1.2。
- tools/doc_term_audit.py：五组退役词按语境豁免而非改正文——
  充能（秘宝主动件现行机制，扩 exempt 信号）、可选类道具与雾格（否定式引用「现行池内无可选类」
  「不做清单」——替换会毁掉句意）、伏击/heavy_multiplier（battle.md 占位表里的退役敌人 id，
  现行规格在 敌人系统.md）、拔旗（06 待办「件派生动词白名单」是待评估设计意图非在用机制）。
  疑似现行 6 处 → 0。
- 孤儿探针退役：ui_layout_probe 与 ui_audit_probe 共 6 文件（.gd/.uid/.tscn）删除——
  两者均无任何闸脚本执行（全仓仅注释与历史报告提及）。
  连带清理 render_gate.sh 头注、board_view.gd cell_size 注释、game/README.md roster 行。
  **遗留**：ui_layout_probe 原承担 1920 档布局机检面，现无承载，已在 render_gate 头注标明待补。
- roadmap.md 迭代循环第 4/5 条：轻闸/重闸改指 run_all_gates.sh，闸清单不再散落第四处。

闸况：9 道绿（含 gdd_lint / doc_link / doc_term 三闸全绿）；static_scan S10 文件头 125 处
按用户令不在本批处理，已落 baseline.json 作为存量红。
 2026-10-15 21:42:35 +08:00
DKChan 1d4ac91e3b feat(闸收敛批): 验收闸唯一入口 run_all_gates.sh + 合回闸回执强制 + t17 探针隔离修复 + 文档闸清单单一事实源 
用户令「迭代完成前必须全量跑一遍所有测试」。起因是 iter27 台账只记 probe --click 未记
--full，t17_defer_probe 红了整个迭代无人发现——根因是闸清单散落 CLAUDE.md /
process-conventions.md / test-conventions.md 三处、彼此不一致、且无任何机器校验。

- tools/run_all_gates.sh（新）：全部验证闸的唯一入口与唯一清单，串跑冒烟/单元/探针
  --click/--full/渲染/doc 三闸/静态扫描/熵增闸共十道，写回执 game/tests/.gates/receipt.json。
  与 baseline.json 比对判定：基线红且红项清单未变＝存量红零新增（不判失败），
  基线绿转红或红项清单变化＝新增红（判红）。python 解释器自动解析带 PIL 的解释器
  并前置 PATH（渲染闸三个脚本依赖 PIL，用错解释器会假红）。
- .zcode/hooks/worktree-guard.sh：Bash 分支加合回闸——merge/rebase/cherry-pick 进
  master 前按目标分支反查 worktree 回执，校验 commit 匹配/非 quick/无新增红三态，
  任一不满足 exit 2 拦截（九态实测：匹配放行、commit 错/quick/含红/无回执/rebase 全拦）。
- game/smoke/t17_defer_probe.gd：隔离面从 main.save_manager = iso_c 改
  ProbeUiUtil.isolate_save（iter27 已确立口径）。原写法对 getter-only 属性赋值无效
  ——组合根 save_manager/meta 是 autoload 读视图，隔离必须落在单例上。修复后 --full 转绿。
- doc_link 三处死链归零：数据配置.md 已退役探针指路、元进度.md/天赋树.md 已改名文档链接。
- CLAUDE.md / process-conventions.md §3第10条 / test-conventions.md §4 三处
  「交付前跑什么」统一为一句话＝跑 run_all_gates.sh，删散落清单。

闸况：冒烟 0 / 单元 0 / --click 0 / --full 0 / 渲染 0 / doc_link 0 / doc_term 0 /
熵增 0；gdd_lint 与 static_scan 为存量红，已落 baseline.json 待判读清偿。
 2026-10-15 21:16:38 +08:00
DKChan 81c0ee2bb6 merge: 规则文件审计与目录划分批——150行上限/领域拆分/范本密度二刀+迭代28变异验证规则吸收（2026-10-15 用户令） 2026-10-15 16:34:50 +08:00
DKChan 8bfe7f6d1b merge: master 吸收——迭代28变异验证硬规则按新结构归位（细则迁 test-conventions §6+批次清单插第9条+红线索引一行） 2026-10-15 16:34:10 +08:00
DKChan 5858629719 docs(规约): 第二刀按真实范本密度压缩——CLAUDE.md 67行祈使句体+流程纪律独立成文（2026-10-15 用户令） 
- 对照实测范本（anthropics/claude-code 40 行、openai/codex ≈250 行纯祈使句等七份）逐类清除叙事层：
- CLAUDE.md 140→67：三段开发流程/批次清单/分支纪律/两入口与MC细则/像素纪律全部降级出主文件；红线压成一行一条祈使句+指路；呈报六问压缩为单条索引行
- 新增 process-conventions.md（86 行）：三段流程表格化+批次清单 14 条+两入口/MC 触发/分级周期/MC 档位/闸机轮次细则+像素结构件纪律——批次开工时加载
- 新增 code-conventions-cases.md（55 行）：全部反面案例+缺陷对照表迁入（不常驻加载）；code-conventions 148→92 行纯规则
- doc-conventions 149→120：总纲收一行、论证段压括注、骨架与生命周期条款表格全保
- 规则名全保（两入口铁规/文档同步闸/MC 触发细则等外部按名引用零断链，已全仓扫描核实）
- 机械闸：七文件≤150 ✓ IMPORTANT=0 ✓ 日期残留=0 ✓ 主文件叙事残留=0 ✓ 熵增闸 PASS ✓ doc 两闸零波及 ✓
- 行为验证：全新上下文子代理六问导航 6/6 正确（新增流程/像素面全命中）
 2026-10-15 15:38:16 +08:00
DKChan 0d308d7156 docs(active): 迭代28 台账 495 开工条 + 496 收口条（主区侧写——本批台账不入分支避合并互撞） 2026-10-15 15:19:40 +08:00
DKChan 5b958ff61d Merge branch 'iter28-bootlife-20261015'——迭代28 启动装配与生命周期验收补全批（冒烟 1125/0；甲裁：--full t17 存量红认列不阻合并） 2026-10-15 15:11:55 +08:00
DKChan 674f88a0cf docs(迭代28): 实现报告成文（含类型闸自纠与 static_scan 结果） 2026-10-15 08:24:52 +08:00
DKChan 140e440896 fix(迭代28 T1 补): 类型闸 S9 归零（main.gd 合同装配容器注解） 
_apply_layer_contract 内 `var tags: Array` 未带元素类型，被 static_scan S9
（tools/audit_type_hints.py R1 无类型容器）判红——iter27 立的类型闸本批唯一
新增违规，随批修为 Array[Variant]（与项目机械参数化口径一致）。

S9 由 FAIL(存量 1 处) 归零；冒烟复跑 1125/0 不变。S10 文件头闸存量 125 处
系 2026-10-15 新立规的清偿批在册项，非本批引入，不动。
 2026-10-15 08:24:12 +08:00
DKChan 18e22f1b44 docs(规约): 规则文件审计与目录划分批——150行上限+领域拆分+日期注记清零（2026-10-15 用户令） 
- CLAUDE.md 137→140：日期注记全清；文件头红线收敛为指针（全表唯一权威=code-conventions §1.4.1）；测试两入口/闸机轮次/MC 档位超长红线拆子条目（MC 精度数字收敛为 sim-data/README 档位表指针）；规范导航补 test-conventions/concept-conventions 两行
- code-conventions 210→148：§3 测试纪律拆出独立成文；缺陷对照表与版本历史表退役（历史归 git）；反面案例去日期化；与 §1.5 重复的流程条目合并
- doc-conventions 210→149：概念封装/引用纪律/归档三节拆出 concept-conventions.md（原 §7–9 合并桩节标注）；§10/§11 保号——active.md 与 tools 脚本存量引用零断链；数值纪律强制收口条款移出表格单元格
- 新增 test-conventions.md（49 行）：探针标配/回归断言/提交前全量验证/验收清单落码规范
- 新增 concept-conventions.md（54 行）：概念封装建模/跨文档引用纪律/归档与事实源
- 机械闸：五文件行数≤150 ✓ IMPORTANT=0 ✓ 日期残留=0 ✓ 熵增闸 PASS ✓ doc 三闸（gdd_lint/doc_link_audit/doc_term_audit）对改动文件零波及（存量 GDD 基线失败与本批无关）
- 行为验证：全新上下文只读子代理五问导航 5/5 正确（含两份新文档命中与 §10/§11 交叉印证）
 2026-10-15 08:07:09 +08:00
DKChan db1bf42322 docs(迭代28 T6): 变异验证硬规则落文+机械面文档同步闸 
规范落文三处（本批新硬规则「验收函数无变异红记录不算验收成立」）：
- CLAUDE.md：批次工作流实施段新增第 9 条（原 9-14 顺延 10-15）
- design/dev/code-conventions.md：新增 §3.6 变异验证操作细则
  （注入→最窄闸见红→git 精确还原→记录四步；变异不红二选一处理；
  判据强弱分层：运行期断言/golden 逐像素/占比统计类三档）
- req-card 技能（仓外 ~/.workbuddy/skills/req-card/SKILL.md §7 验证闸，
  ZCode 副本同步；CodeBuddy/Qoder CN 无此技能副本，不动）

机械面文档同步：
- roadmap.md：迭代 28 行换代为已入库（冒烟 1086→1125/0）、近期主战场
  前沿改迭代 29+ M4
- design/gdd/06-待办清单.md：登记条销号改写为已入库收口 + 新增 GDD 反哺点
  三条专条（装配合同/boot 后置条件/生命周期矩阵，待用户逐点裁决）
- design/gdd/07-体验验证清单.md：新增 ㉗ 启动态菜单目检节五观测项

顺带清理（非本批引入，基线带入）：07-体验验证清单.md v1.0 行处残留
<<<<<<</=======/>>>>>>> 合并冲突标记（iter27-techdebt-20261014 分支合并进
master 时漏解）——两侧均有效故全留（qa 收尾批人闸核销行 + ㉖ 目检节登记行
与正文节），版本号顺延 v1.1，清理注记入 v1.2 行。

doc 三闸对基线零新增（lint 三件/死链 3/术语 5 组均与 master 39c6544 同）。
 2026-10-15 07:59:25 +08:00
DKChan 67342c690e feat(迭代28 T4): 渲染面内容断言三件（探针自检+墨色判据+启动态菜单 golden） 
①shot_probe.gd 两条自检进 _problems：boot 态顶层可见层=start_overlay（内容层树遍历——屏壳容器不当候选，camp 壳透明实证）；菜单标题/副标题 label is_visible_in_tree 且 rect 落屏内；隔离档 refresh_resume 开=菜单截图不依赖真实档断点态。②shot_checker.py 增 F 字在判据：菜单文字框与中位灰度差>60 像素占比带 [2%,55%]（极性无关——亮字暗底同判；实测标题 13.07%/副标题 11.47% 定 provisional 阈值；对比度只判反差不判字在的缺口由此补）。③启动态菜单 golden：帧差前置验 0.0000%/max_diff=0（光柱静态贴片零动画）；golden_baseline_refresh.sh 扩 --menu 模式（shot_probe 取材→game/tests/golden/menu_boot.png，字体+按钮石纹素材守卫）；render_gate.sh 补菜单 golden 对比段（素材缺位 SKIP 同 Q5 口径）。闸=render_gate 全绿（探针问题=0+checker A-D/F 全过+棋盘 golden 0.00%×3+菜单 golden 0.00%）。注：本机 render_gate 需 gamedev venv Python 前置 PATH（闸机脚本调 python(PIL)，本机默认 python 无 PIL——用户侧环境自带）
 2026-10-15 07:28:38 +08:00
DKChan 77075e6e7a feat(迭代28 T3): 生命周期存活性矩阵冒烟段（_smoke_lifecycle_matrix 九阶段×五引用面） 
驱动复用：V3 debug seed 开局路径+_auto_play_round 活战斗模式（phase/round 守卫+choose_dig）+ui_struct resume 夹具模式，不另起点击链。阶段=闲时/开局停点(地图选路停点态合并)/战斗中/结算后(胜利停点)/选路页/终局面/回菜单收束/各模态开合后(菜单域四模态)/两连局/续玩断点。五引用面=_treasure_ui 2/_bonus 6/_camp_pres 3/_modal_flow 4/_row_pacer 5 句柄+2 Callable+run_scope 13 成员；判据=恒活面有效+会话三面阶段存活态(alive/null/both)+现值回调与 run_scope 成员同源(回调链无悬挂)+收束/续玩换会话无真空窗+旧局 queue_free 消亡。三处判据订正实录：隔离后刷新续玩钮定基/战斗收场判 is_battle_live(胜利停点 settlement 陈旧有效非 null)/调试浮窗开不隐菜单。冒烟 1097→1125/0
 2026-10-15 07:18:54 +08:00
DKChan a35581e441 feat(迭代28 T2): boot 链路时序后置条件冒烟段（_smoke_boot_chain 六断言） 
挂 _split_tail（协程纪律 await）：V2a ConfigDB 就绪+表载/V2b 设置已应用（Master 总线 mute/volume_db+UiKit.motion_scale=settings_store 现值，一致性判据与真实设置文件内容无关）/V2c 启动态菜单可见/V2d 续玩钮态==断点在档态（boot 路径关系判据+隔离新档双向：无断点隐/合成断点显/清断点回隐）/V2e 闲时会话在树/V2f 调试浮窗态==DS_DEBUG 门控（两侧同判据）。存档隔离 attach_path 禁碰真实档。冒烟 1087→1097/0
 2026-10-15 07:07:44 +08:00
DKChan 6f71509421 feat(迭代28 T1): 装配语义合同单点化+装配序修复+V2 断言重写 
合同常量 LAYER_CONTRACT（16 层全视觉层序唯一事实源：屏壳/两全屏态/12 模态，level_screen 宿主/camp_screen 同槽/curio 对位三特例数据化）；_apply_layer_contract 统一落位单口（add_child 后排序+登记同源派生，两处散落 move_child 删除）；装配序修复=冒险屏先挂菜单屏后挂（F5 见战斗界面坏事实）；V2 断言重写=V1a 启动态顶层可见层=start_overlay（内容层遍历，屏壳容器不当候选——camp 壳透明实证）/V1b 菜单壳在冒险壳之上/V1c 合同树序链逐对保序/V1d 落位单口源码断言；ui_struct_probe career 专属登记序契约推广为全模态 _modal_registry_contract（旧件同批退役）。红→绿记录：修复前 1086 项 3 失败（V1a/b/c），修复后 1087/0。代拍板=合同数据形态（有序数组+host/shell/tags 特例字段）
 2026-10-15 07:04:02 +08:00