game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,474 Commits 23 Branches 0 Tags
c3b6403018928e0d2ce50fbbcbba1fb6499dcebd
Commit Graph
627 Commits
Author SHA1 Message Date
DKChan c3b6403018 docs(迭代29 T8): 回写架构事实源三张表 + 06 登记遗留七条 
architecture.md「测试与质量域」节（测试域唯一事实源）按批末真实状态回写：
· 五模块归属表：run_all 承载由「27 套件」改「33 套（单元＋L2 集成）」，判定口径列由「SCRIPT ERROR
  扫描缺失／断言数下限缺失」改为三硬闸齐备，并记下「子进程输出须落盘再读——OS.execute 管道在本机恒空」
  这一本机事实；probe_gate 增 screen_flow_probe 与 verdict 判定口径。
· 三条判定硬闸矩阵：probe_gate 的「退出码优先」与「SCRIPT ERROR 扫描」由缺失改在位；run_all 的
  「SCRIPT ERROR 扫描」「断言数下限」由缺失改在位；render_gate 的脚本错误扫描维持缺失并注明本批未收。
· 静态扫描域 S 表：S3 由「未落地…路径不存在恒零命中」改「在位（warning 级，路径已修正＋零命中自检）」；
  S5 由未落地改「在位（硬失败）」。
· 新增「三层承载与判定原则」小节：L1/L2/L3 各自的判什么／承载／入闸，以及判定原则——三硬闸是底线、
  PASS 串不作判据，两类静默失效（扫描面为空、子进程输出丢失）都以显式自检拦住。

06 待办清单新增「测试域遗留」条，集中登记本批未收的七项（均不阻塞不排期）：余下 3 个 core 零指名
模块、render_gate 的脚本错误扫描缺失、S7／S8（S6 亦仍在 TODO）、E 级卫生件、行覆盖率度量、
smoke_all 拆分、parity 触面判定偏粗。
 2026-10-16 16:18:17 +08:00
DKChan 698d864dcc docs(迭代29 T0): 开工日基线冻结与三反例缺陷坐实 
基线（master 752c9a0a，worktree 同点实测）：冒烟 1127/0、run_all 27 套、在闸探针 9（轻闸4+click1+full4）、
墙钟 run_all 34s/smoke 71s/轻闸 quick 363s、存量红仅 09 静态扫描 exit=1（S10 文件头 127 处）。

T0-① 三反例全部判绿＝三硬闸缺陷坐实（非推断）：
a 零断言套件 → run_all PASS；b SCRIPT ERROR 套件 → run_all PASS（错误未中断后续断言，仅外部扫描可抓）；
c 打印 PASS 后 quit(1) 的探针 → probe_gate 报「全绿」。三靶子验后已还原。

T0-④ 复核 F1'-F11' 全部 file:line 无漂移（core 23 文件、7 个真零指名、status_container 2 指名、
呈现层 5 件零指名、smoke 29 .gd/12 .tscn 均复核）。
 2026-10-16 05:00:06 +08:00
DKChan 849e4b1cd2 docs(卡片): 测试分层与门禁语义修正批升 v2.0（三轮复查结论落文，U0 门只欠发令） 
grilling 两轮＋一轮只读深挖后一次性升版。首轮十一问按推荐全裁（L2 承载+2 例／parity 收编为条件闸件以守「MC 无数值改动零跑」红线／CI timeout 前提已死改铸为轻闸墙钟预算／integration 并入 run_all manifest／S9 存量豁免维持但新写测试件全类型标注〔升契约 8〕／golden 显式重制+呈报+复闸／smoke 两名不改名只加注）；第二轮 N1＝§2 改指针（事实面归 architecture.md 测试域三张表，禁双载体漂移）、N2＝T6 收 S3 路径修正＋零命中自检（+0.25d）。

事实订正四处：PASS 串判定面实为 8 件探针（非 4）；game/smoke 实为 29 个 .gd（非 38）；T5 的 status_container 不是零覆盖（2 单测已指名）→ 换 board_generator；README「ci-removal 批已改写门禁节」前提不成立（分支未合入）→ CI 残留 8 处改由本批 T2 清除。死引用订正：CLAUDE.md 旧节号（文件已压到 71 行）、tests.yml（已删）、golden_compare.py 行号。新增义务：批末回写 architecture.md 三硬闸矩阵与 S 表。估时 T0-T8≈6.0-7.5d，软盒 7d。active.md 快照两行同步＋状态记录 504。文档三闸全绿。
 2026-10-16 04:24:29 +08:00
DKChan aad2999aba chore(zcode): 移除 .zcode 工具配置并更新忽略规则 
删除 .zcode 下的 hooks 与 plans 配置，将 .zcode/ 和
.zcodeignore 加入 .gitignore；同时重写试玩问题记录文档，
用新条目替换垂直切片 v1 的旧内容。
 2026-10-16 04:14:23 +08:00
DKChan d3356985a8 merge: 贫矿脉屏蔽+DS_DEBUG写死批全量入库(五提交, worktree g-plan2-shielddebug-20261016) 
用户令两项（2026-10-16）：①「地形变异特异关卡后续重新做设计，先屏蔽」——variation.tres
删 skewed_veins 行，Boss/精英图全局池空→region 兜底回落，玩家面零横幅零角标零偏斜；
②「debug 变量直接写死，不读环境变量」——main.gd _debug_entry 恒 true，全库 DS_DEBUG
引用清零。机械面文档四件同步（07 ⑪ 转记/架构行数/数据配置/06 条目）；设计语义面立
反哺点待裁（地形变异.md §全局作用域型/HUD 框架三层预告/教学引导手册行/难度曲线两行/
art-bible §4.6.3 括注）。闸面三修（冒烟作用域/shot_probe 浮窗归一/click_probe 断言
归位）+ 基线 09 指纹刷新（并行会话头注漂移，非本批引入——主区与分支审计逐行一致）。
全量闸验收通过（存量红零新增）；读数义务归 M4（Boss 图资源面/region 布置分布）。
 2026-10-16 03:53:30 +08:00
DKChan f1663ef935 docs(同步): 贫矿脉屏蔽的机械面四件——07 ⑪ 转记/架构行数/数据配置清单/06 条目 
- 07 ⑪：加「✅ 转记（2026-10-16 用户令屏蔽——前提失效，无需验）」注记，六项判据
  全部失效，重建设计立项时随新卡重立目检项
- architecture.md:96 variation 定义行：现行 7 行 → 6 行（global 型机制代码保留）
- 数据配置.md:61 变异表行：现行七行 → 六行（删行注记）
- 06 战斗节点地图类型差异化条：「已实装的部分」改写为贫矿脉已屏蔽删行、剩余面不变
- 设计语义面（地形变异.md §全局作用域型/HUD 框架三层预告/教学引导手册行/难度曲线
  两行/art-bible §4.6.3 括注）按「设计权威文档不随批直改」立反哺点，待用户裁决另批
 2026-10-16 03:11:55 +08:00
DKChan 21c83f5736 docs(roadmap): 迭代 29 编入测试分层与门禁语义修正批（2026-10-16 用户令） 
roadmap：迭代 29 行改写为「测试分层与门禁语义修正批」——需求卡片=design/research/需求卡片-测试分层与门禁语义修正批-2026-10-15.md（v1.4，T0-T8≈5.5-7d，开工门=U0〔Q3-Q7 裁点＋卡片 v2.0 重核＋/iter 发令〕）；新增「迭代 30+ 位空」行——原 M4 数值批已废（2026-10-16 用户删卡令「它就不是一个应该存在的东西」），禁止再以该名义立批/规划/引用已删卡，四项数值欠账归 06 在册、重新归属待用户裁；当前位置节迭代进度与近期主战场两处换代（下一前沿=迭代 29）；迭代 23+ 行（M4 原始泊位）追加作废注，仅作排期史保留。

需求卡片 v1.5：排期行与 §5 roadmap 同步行更新；登记 v2.0 重核遗留项（残留 CI 措辞四漏网点＋事实基线换代：冒烟 1086→1125/0、门禁五闸→run_all_gates.sh 编排、architecture.md 测试域节已成文、Q3 的 CI timeout 前提消失）；订正 v1.3 版本条目尾部重复段。文档三闸全绿（gdd_lint 0 不通过／死链 0／疑似现行 0）。
 2026-10-16 03:09:34 +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 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 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 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 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 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 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 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 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 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 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 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 39c6544783 docs: 迭代28定义已入库（启动装配与生命周期验收补全批） 
坏事实三件（main.gd:207-210 装配序错/smoke_all.gd:176 V2 断言保护 bug/菜单截图无内容断言）；M4 数值批占位行顺延 29+；需求卡片（不入 git）=design/research/需求卡片-启动装配与生命周期验收补全批-2026-10-15.md
 2026-10-15 06:30:45 +08:00
DKChan a2d6e03df2 feat(规约): 文件头≤8行白名单制第二轮立规+头注机器闸S10（2026-10-15 用户令） 
code-conventions §1.4.1 换代：## 文档注释载体+8行上限+五类白名单+黑名单+写法权威参照（Google Python Style Guide §3.8 + PEP 257，GDScript 官方指南无文件头条款不自造标准）；§2.1 信号契约改入发送方 ## 文档注释每信号一行、计入上限；CLAUDE.md 硬性红线同步换代；新建 tools/audit_file_headers.py（R1行数/R2日期/R3变更叙事，正例反例边界例盲测通过：恰好8行过/机制词结算批不误伤/无头注过），static_scan.sh 挂 S10。纯规则与工具零行为变更；实测存量 125 处约 90 文件，清偿批在册待发令
 2026-10-15 04:45:00 +08:00
DKChan 5f9d8e7b77 chore(代码卫生): 文件头零工作日志红线落文+全仓头注变更叙事清偿（2026-10-15 用户令） 
- CLAUDE.md 硬性红线新增「文件头零工作日志」；code-conventions.md 新增 §1.4.1（含反面案例）
- 全仓 .gd 文件头注清偿：删除全部带日期条目、批次叙事段与迁移退役叙述，保留并改写为
  现在时的职责、接口契约、GDD 锚内容（main.gd 头注 42→31 行、save_manager.gd 49→45 行）
- 纯注释改动零行为变更，按用户令免测试免冒烟
 2026-10-15 04:08:38 +08:00
DKChan 9a9fa7e8be fix(迭代27收口补遗): 卡片核对缺口三项+resolver 幽灵通道断根 
- V8 卫生 grep 断言落地 smoke（字符串 Callable 产品码零命中/FeatsEngine 退役/死代码抽查/GP 影子账零残留）
- 06 补登卡片两条义务（长函数余量 14 件+lambda 连接 76 处防回归）
- 漏网字符串 Callable×2 补装+validator 头注/main 死注记清理
- resolver 幽灵通道断根: reset_warn_dedup 门面参从未存在（字符串 Callable 零校验藏死引用，
  方法引用换装编译期暴露）——删参，注册表清空归 resolver 本类方法（门面 :115 直呼即正道）
- 实现报告补核对结案段

闸: 冒烟 1086/0（+V8×5）+类型闸归零
 2026-10-15 03:03:29 +08:00
DKChan dd418e5d7d merge: 迭代27 代码架构技术债修复批全量入库(七提交, worktree g-plan2-iter27-techdebt) 
五波: T1 场景拆分+会话物化/T2 _settle 五段/T3 RunLedger 账本收口/T4 ModalFlow+模态互斥域/T5+T6 类型闸+卫生件
核心验收: 同种子完整局输出逐位一致——parity_anchor 三变体五跑全同; 冒烟 1055→1081/0; run_all 25→27 套; static_scan 修复后全绿
 2026-10-15 01:46:17 +08:00
DKChan eea345882b feat(迭代27 T6+T7): 波五b 卫生件包+文档同步闸——对拍全同 
T6 卫生件（P2 组收口）:
- 死代码 13 函数删除（审计 16 处复核=ui_kit:486 实读现役不删，追认单#14）+FeatsEngine
  整文件退役（class_name 注销）
- 字符串 Callable×10 位→方法引用形态（编译期方法存在性校验；语法实证 METHOD_REF=true）
- 状态机 enum 化: adventure State（外部 String 契约 getter 词表逐位一致+外部纯读实证）/
  standee HeroState（register/set String 形参零变化+probe 面恒等）
- ConfigDB _fatal 退出归根（核心层去 quit/crash→_fatal_flag，决策归组合根 fail-fast 通道）
  +resolver 诊断/数据通道全面 Callable 化（ConfigDb↔Resolver 类型环断根）

T7 文档同步闸:
- 实现报告 design/qa/iter27-实现报告-2026-10-14.md（五波+闸表+追认单十五项+反哺点两条+目检五件）
- 06 迭代 27 条销号+GDD 反哺点两条新条；07 ㉖ 目检节+v1.0 版本行；roadmap ✅ 换代
- 审计报告本体按退役规则 git rm（吸收即死；修正计数由卡片承载）；卡片来源行改指路

闸: 对拍三变体全同（第五跑）+冒烟 1081/0+run_all 27 套+probe click+render golden+static_scan 全绿
 2026-10-15 01:41:37 +08:00
DKChan 4fba0d036e docs(qa收尾): 实现报告未处理项清零——14 条反哺落文+29 项追认+孤儿 7 项补登+人闸核销+14 份报告退役 
用户四裁（2026-10-14）：反哺点 14 条全部按呈报落文 / 追认单 29 项全部追认通过 /
孤儿遗留 7 项全部补登 06 / 实机目检已全部完成（回报未呈报问题）。

反哺落文 14 条：
- iter24 五条 → 敌人系统.md v0.18（敌表 attack_type 字段行+矩阵消费面双向在役/
  技能错峰两轨/敌种表两行池构成/hobgoblin 缺口登记）+ 难度曲线与Boss.md v0.29
  （N1/N2/N3 只测不判读数登记，数值终值归 M4）
- iter25 三条 → art-bible.md v3.14 §7.6(二) 原生控件组件规格 + 06「UI 元素细节修」
  条①措辞订正（「同一个深棕色」不符代码面，实为 2.84:1）+ §7.6 末注主题色值双源
- iter26 四条 → art-bible.md v3.14（§7.6(一) 按钮五态矩阵 / §4.1 三 token 语义岗
  登记+色板 42→45 / §7.6(三) 氛围层两派并存留样张批 / §8.2 Nearest+LINEAR 豁免清单）

追认单 29 项全追认（iter24 §四 8 含 #6 敌方克制消费补行=验收闸强制最小补点 /
iter25 §四 8 / iter26 §四 13），三报告追认单节已标注；iter20/21 按前序既有裁决
记录补齐簿记标注（十条/十二条前序已裁）。

孤儿七项补登 06 专条「qa/ 实现报告收尾·孤儿遗留七项」（design/diagrams 越界/
开场行后缀认加算区/STONE 外溢位/迷雾三关扩对/字面量墨收测前置/TG_* 装饰带判据/
数据配置 223+商店房截图纳屏）。

人闸核销：07 ⑮真人半+⑳㉑㉒㉓㉔㉕ 七节加核销注记（版本行升 v1.0）+iter20 五件
与 V20+iter19 存活八项+迭代18 清单 18 项（卡④ 提灯三项与卡③ 盯梢项标过期失效）。

报告退役：qa/ 下 14 份迭代实现报告删除（iter19 七份+iter20/21/24/25/26 本批+
iter22/23 前会话已删件经用户确认一并清出）——清理口径三条件（反哺全落文+追认全
通过+无报告自身未结项；07「不阻塞」人闸不计入）全部满足；保留 ui-audit 目录/
ui-audit-vs-demo/迭代18 清单（非实现报告）。06 五处指向已删报告的链接改
「已退役，git 历史可考」措辞。

闸：doc 三闸对基线零新增（gdd_lint FAIL=06/07/术语表基线三件；doc_link 死链=
存量 2；term 命中=存量 3）。git 历史可恢复全部已删报告。
 2026-10-15 00:24:31 +08:00
DKChan 7825dd0755 docs(美术审计): Cursor canvas 审计页转自包含 HTML——组件语义映射+双主题+行色条，浏览器渲染已验 2026-10-14 19:28:24 +08:00
DKChan fc7fee03bd chore(迭代27 T0): 逐位一致对拍锚冻结+探针迁移对照表 
- tools/parity_anchor.py: 三变体(base/attune/shop)×40局 RUNSUM+JSONL 双面哈希对拍（V1 核心验收载体）
- anchor.json: 重构前锚（种子面 71000/72000/73000 错开，覆盖 base/同调账/商店-GP 账三类重构面）
- 探针迁移对照表: 11 挂载面逐一列成员依赖与迁移方向（卡片 T0.3）
 2026-10-14 19:15:05 +08:00
DKChan f122df5571 docs(美术审计): Cursor 会话「Game UI and art optimization」全量存档——canvas 审计页终版+两轮会话记录（周额度中断，末条回复自会话库补齐） 2026-10-14 18:25:32 +08:00
DKChan 009a63c4a8 docs: 迭代27定义已入库 2026-10-14 18:22:54 +08:00
DKChan 900dfe9254 docs(迭代26 T6): 文档同步闸+实现报告+roadmap 换代 
- 06 五处状态：按钮矩阵/纹理过滤/<4.5:1/元素细节 四条销号（状态标注+去向），氛围层改记
  「九宫格半存续」（光柱半已修）；需求卡片条标已收口；新增「迭代26 GDD 反哺点四条」专条
- 08 升 v1.4：三·界面按钮矩阵行→在役；五·表现三行回填（纹理过滤→在役/氛围层→部分在役
  注明九宫格半未结/元素细节→在役）
- 07 增 ㉕ 逐屏巡检目检节（按钮五态/焦点环/Nearest 巡检/布局/诊断钮清零）+v0.9 版本行
- roadmap 迭代26 行→已全批入库；实现报告=design/qa/iter26-实现报告-2026-10-14.md
- 批末重闸全绿：冒烟 1055/0+run_all 25 套+probe click/full+render_gate golden 0.00%+
  doc 三闸/熵增对基线零新增（lint FAIL 集=基线三件；R3 措辞已规避 08 转绿）
 2026-10-14 06:09:19 +08:00
DKChan 04ec2175b1 docs: 迭代26定义已入库 2026-10-14 04:46:11 +08:00
DKChan 4dbb2b9f9e docs(审计): 代码架构与实现质量审计报告入库(2026-10-14) 2026-10-14 00:53:08 +08:00
DKChan ad4e0106a1 docs(迭代25收口): 文档同步面四件+实现报告+active.md 快照/489-490 记录 
- 06: 「UI 全局主题资源缺失」条移除（事项解决即移除，git 留痕）；
  「UI 元素细节修」①销号（两段对比度重配=BG_ROOT 对暖石 5.49:1），余②③④保留
- 08 v1.3: 三·界面「UI 全局主题资源」行→在役；五·表现「UI 元素细节修」行
  注①销号；余五条 06 指向行逐行核对零触碰（roadmap「六行回填」口径对账）
- 07 v0.8: ㉔ UI 全局主题批全屏巡检目检节（含 v1.2 两专项观察点）
- roadmap: 迭代 25 行换代+迭代进度行
- 实现报告=design/qa/iter25-实现报告-2026-10-13.md（代拍板追认单八项+
  GDD 反哺点五条+引擎事实三证+位图不入 git 政策口径呈报）
- active.md: 快照换代+489 开工条+490 收口条
 2026-10-13 21:39:49 +08:00
DKChan 321e6c9ba4 merge: 迭代24敌人表内容修批全量入库(346675e, worktree g-plan2-iter24-enemy) 2026-10-13 07:35:49 +08:00
DKChan 346675ef6c docs(迭代24收口): 实现报告落档+roadmap迭代24行换代+active.md快照/488收口条+06反哺点五条专条 2026-10-13 07:34:09 +08:00