12 Commits
Author SHA1 Message Date
DKChan 9f94c9e100 工程(合回闸关联档+闸机编排快速失败): 收口跑批按改动关联面选测+红树快速失败——①tools/run_all_gates.sh 关联档选闸(推广 2026-10-28 影响面选闸):00 冒烟/01 系统测试/09 静态扫描三件保险恒跑不降(测量面批不再免 00);03/04 探针与 05 渲染闸维持影响面口径;02 单元与集成改「选套件跑」——套件集=需求卡片申报∪diff 推导并集(申报=本批 diff 触及卡片∪roadmap 进行中行登记卡片的对照表「验收测试」列测试文件名;推导=脚本内套件族映射表按 game/ 代码面文件归族,映射不到一律横切),横切(公共件前缀 config_db*/rng_service*/save_manager*/meta_progression*/main*、project.godot autoload 注册面、game/data/tables、PARITY 触面表)→ 02 回落全部套件;PARITY 触面表上移单点定义(gate 11 与横切判定共用同一清单);回执加 scope(full|related)与 scope_terms 字段,worktree-guard 校验逻辑不动——②game/tests/run_all.gd 快速失败:连续 3 个套件超时(可调常量 CONSECUTIVE_TIMEOUT_ABORT 初值 3)即中止整轮、汇总已见失败与超时清单、退出码非 0,不连续超时照旧逐个回收;_run_suite 改返 {fail, timed_out};新增 --only-source=gates 来源标记(关联档选跑横幅,区别于开发期选跑免责句),无选跑参数时行为与现状完全一致——③规则同批同步(禁只改闸不改规则):AGENTS.md「交付前验收」句与硬性红线改按关联档选测口径(所选域绿即可合回,全量回归由用户自发、合入后无自动兜底,2026-10-29 用户裁)+规范导航行同步;process-conventions §3 第 8 条合回闸细则同口径;test-conventions §4 改「提交前验证」、code-conventions §3 主题行随改;game/tests/README.md 工具速查 run_all.gd 行(快速失败+闸机关联档选跑+manifest 实数 65)与挂死防护注、门禁/本地闸回执字段句同步——④待办清单「合回闸关联档」「闸机编排快速失败」两条目完成整条删除。孤立验证:推导沙箱七场景(行为面归族/触面横切/测量面批/main* 横切/project.godot 横切/申报并集/横切优先)+run_all 闸源选跑 9/65 绿+2s 截止连续超时第 3 个中止(exit 1 带汇总) 2026-10-29 04:36:26 +08:00
DKChan 7f49a8c27b 文档设计(拆分边界纪律落文): code-conventions §1.1拆分判据补全——用户2026-10-28裁「任何拆分满足DDD职责切分与类的高内聚」,迭代40实现所见凑阈值拆分立规
①code-conventions §1.1拆分判据扩为五款——①拆分边界沿职责轴不沿阈值轴(拆出单元须有职责语句+单一变化原因)②集体身份(成员共同表达可命名的领域概念,命不出名字的打包=凑计数袋,禁)③「过阈值」只许作发现信号,作拆分/收拢动机即违规④拆不出内聚单元→停卡呈报走豁免/还债通道禁硬拆凑绿⑤原禁为机检保留无效成员条款保留;①-④=拆分边界纪律(2026-10-28用户裁:任何拆分满足领域驱动设计〔DDD〕的职责切分与类的高内聚)

②req-card SKILL双份同步(.zcode/.qoder本机件不入库)——必备结构新增第15节「拆分边界纪律」结构类卡必填条款(判据权威=code-conventions §1.1,先例=迭代41两卡v1.2契约7/9)+grilling复核门新增拆分边界审点(职责语句/集体身份/凑计数袋回炉)+description同步;生效=文件名日期≥2026-10-28

③中间件退役——删未入库《需求澄清-结构债清偿改走领域职责设计-2026-10-27.md》(2026-10-27用户签发的返工交接单,从未执行):其核心诊断(拿指标当目标/凑计数拆分/纸面豁免)已按用户2026-10-28新裁以轻量形态吸收——迭代41两卡v1.2契约+本批规约落文,推倒重做设计段的原路径作废,按「吸收即死」删除;该文件未入库无git痕迹,处置记录以本提交信息为准

④登记与完成同会话坍缩,待办条目免落(dd99884e先例)
2026-10-28 06:46:22 +08:00
DKChan ab79a71eb7 docs(规则修订): code-conventions/test-conventions 文首读触发前移——「写任何代码前必须通读本文件」改「定代码方案前必须通读本文件」、「写任何测试前必须通读本文」改「定测试方案前必须通读本文」(2026-10-25 用户裁两处一起改;与 d121d653 导航行前移口径对齐,测试侧实际时点更早——验收断言在写卡期设计;process-conventions 经呈报维持不改) 2026-10-26 02:38:22 +08:00
DKChan c25daa30cd docs(迭代37结项): 批后收尾——反哺落文六处+账面换代+迭代37产出物九件退役(四卡批2026-10-25合回8faf1763)
反哺落文(reports/iter37-反哺点 逐条出账,清单随批退役):
- architecture.md v1.12→v1.13:模块归属表登记迭代37拆件新模块(CurioDeck/ShopSession/board_resolvers/main_ui_build/main_adventure_flow/main_overlay_flow/main_debug_flow/TilePalette/HeroSprite/BoardWorld 在册补行+HudPresenter 数据投影+文案拼装静态族加注;表内原无 HudPresenter 行,按新增落表)。
- 存档序列化.md:断点域豁免段注记 27 顶层键登记单源=core/adventure_runner.gd const BREAKPOINT_FIELDS(写侧 _bp_parts()、读侧 _bp_read/_bp_read_int)。
- 冒险结构.md 共享池账本节:载体注记 AdventureRunner._bonus_deck→CurioDeck(池与判定)+ShopSession(货架/定价/购买/刷新),规则文字零改动。
- code-conventions.md §1.1:新立拆分判据硬纪律——重构卡禁为迎合机检计数保留无效成员/别名,机检键与卡片契约互斥时实现段停卡呈报(反哺条7+条9口径同落;行访问器直读=db即ConfigDB,口径由该条与既有数值单点纪律覆盖)。.zcode/.qoder 两份 req-card 技能同步第13项。
- game/tests/验证集清单.md:extract_checks.py --extract --force 重生成(64源1583调用点);〔wr2〕三条走 check_quiet 通道不在提取器现行口径(旧清单同口径零条),属工具覆盖面既成事实,未扩口径。
- 反哺条4/10 批内已执行、条8 无义务、条5/6 分别由本批重生成/转待办新条出账。

代拍板:B-1~B-8 由用户 2026-10-25 结项发令整单追认(E-1/E-2 补救已入账于 P0 待办条)。

账面换代:roadmap 迭代37行=已完成(2026-10-25)+卡列/报告列退役保留字+当前位三行换代;待办清单删「game代码结构审查批」条(未决六小件迁「结构审查未立项小件候审」、gdstyle基线陈旧键迁新条)、P0「AdventureRunner职责真拆分」吸收拆分卡缺口件(撤装置计数读数/五件收编范围/验收面预案);体验验证清单录迭代37实机目检七条。

退役九件(判据逐份核对,引用面改写后 git rm):iter37 产出物五份(代拍板/反哺点/实现报告/拆分卡缺口/验收审计)+四张需求卡片(迭代已完成,roadmap 已填退役保留字)。
2026-10-25 23:46:01 +08:00
DKChan bcb5cce3b6 docs(架构与规范对齐批·闭合落文): ②案甲组合根拆件概念成文(呈现层归属行+装配节定义+code-conventions §1.3 括注,控制器一词弃用,视图禁直连)+③案a effect_engine 圈层归位基础层(A3/B4 消费依赖登记,反向依赖悬案消解); ④条目七件全结按吸收即死删除,⑦校验文案未决先迁独立条目,⑤收敛码改登记扩展总型收敛批条目,S6~S8 条目冻结解除改工程直改类待执行(2026-10-25 用户裁案甲/案a) 2026-10-25 20:22:47 +08:00
DKChan 82d0cf24a6 docs(架构与规范对齐批·部分落文): ⑤明细行协议两层化(基础9+扩展行1,概念+指引法,效果身份指向实现头注)+来源豁免封闭清单五类对齐; ①归属表API对齐实况(A2撤便捷形/A3补预授权通道/B2换check_skill_unlocks/B4撤equivalence_supply/level_runner撤幻影grant_node_active)+damage_controller与settlement五段段类入表+B1域文件集成文(S7前置备齐); ④层合同计数18; ⑥§1.3例举换代player_request_refresh; ②③两裁决点保持开放待用户拍板(2026-10-25用户令部分执行) 2026-10-25 18:47:14 +08:00
DKChan b2583f75f5 chore(变异类测试全项目清除): 用户裁——变异验证/变异测试全项目禁用,验收一律只走撤销证明。AGENTS.md 红线行删除+导航行改词;test-conventions §6 整节退役(§7–§9 重编号为 §6–§8,对照表第六格改「撤销证明」,§8.4 新增行为证明改撤销式);process-conventions 批清单第 8 条删除(后续条目重编号)+闸件义务句改人工确认;code-conventions/roadmap 同步;pipeline_gate 对照表证明标记删「变异」+报错文案改;run_all_gates.sh 注释同步;游戏测试面 8 件测试语义改写(layout_probe/ui_struct_probe/save_manager/save_boot/level_gen_params/forge_table/save_manager.gd/4 件表值措辞)——玩法术语(地形变异/变异格/变异角标/变异池等)逐个甄别后全数保留;活卡「状态面板瘦身批」变异列全量改写为撤销证明口径。全库方法术语 grep 零残留;全量域闸验收通过(回执随本批重跑补齐) 2026-10-24 08:35:18 +08:00
DKChan 16c6f1362e refactor(波2 目录收尾): game/smoke/ 目录退役——44 件探针三件套迁 game/probe/、30 件测量/诊断/驱动件迁 game/sim/;全仓 100+ 处 res://smoke 与 game/smoke 引用改指(闸件/产品码 tune_sim_controller/宿主 preload/根规则/README/设计文档);熵增闸 RETIRED 收编 game/smoke 防回潮;AGENTS.md Project Layout 换代;static_scan 豁免理由换新宿主;波 2 施工件预计算表全部命中(8d 预扫零红灯);全量域闸验收通过零新增红 2026-10-24 02:09:27 +08:00
DKChan 7aee5eb71a docs(流程文档迁出GDD批): 待办清单与体验验证清单移到仓库根并去掉编号前缀
两文件是流水线流程件而非游戏描述件,此前住在 design/gdd/ 造成三处不适配:
gdd_lint 必须为它们逐条关掉体裁规则、格式权威却写在 doc-conventions §12、
与同族的 roadmap(在仓库根)分居两处。迁到根后按 roadmap.md 的无编号风格改名。

- 迁出:design/gdd/06-待办清单.md → 待办清单.md;07-体验验证清单.md → 体验验证清单.md
- 指向改写 53 个文件:GDD 各系统文档指路存根、四份规约、02 根索引、README/roadmap/AGENTS
- 两份清单自身 74 处出站链接按新基址重指(../art → design/art、systems → design/gdd/systems)
- gdd_lint:待办/体验验证两文件的 R1/R3/R5/R7 豁免行随迁删除(已脱离扫描面),后门表清零
- pipeline_gate 默认路径、log_analysis/render_gate 称谓、repo_structure_audit 根文件白名单同步
- 保护面补写:两份清单列入实现批禁写清单(AGENTS 两类批条 / process-conventions §12 / 架构文档域表),
  条目状态只由流水线各段推进
- 范围外未动(用户令「全不碰」):reports/ 与 design/research/ 的 22 处历史指向、game/ 两处注释
2026-10-21 00:09:40 +08:00
DKChan 811f988032 rules(规则审阅落地批): 十条评审意见落地——呈报四问/文件头缩窄/禁词表冻结/lean死条文退役/日期批注清除/AGENTS瘦身/分域闸口径/状态栏纯化
- AGENTS.md: 呈报六问改读后自检四问;文件头红线删行数上限与白名单;日期批注清除;回执五况细则挪 process-conventions §3.10;流水线闸过时状态句改事实句
- process-conventions: §1.2 非迭代批改按改动域跑闸;§3.10 承接五况;两处日期批注清除;§2 表格凭据落点改现状清单
- code-conventions: §1.4.1 重写(删 8 行上限/两类白名单/90 文件清偿义务);§2.1 联动;两处日期批注清除
- test-conventions: 三处日期批注清除(三处实证日期属证据保留)
- doc-conventions: §1 lean 死条文删除;§4 词表冻结条款;§12.1 重写(状态行只写状态词;现状=关联文档清单;删括号凭据全部条款);三处日期批注清除;§5 重复词修复
- 术语表: 用语规范节加词表冻结句
- 06-待办清单: 11 条带括号状态行迁移(括号证据移入现状关联文档清单;待裁决说明并入现状;每条状态行只留状态词)
- tools/audit_file_headers.py: 删 R1 行数上限(R0 载体/R2 日期/R3 变更叙事保留)
- tools/gdd_lint.py: R2 表格占比判据与 R2_EXEMPT 整体退役(lean 解读对象已亡,只产存量噪音)
- tools/doc_term_audit.py: 词表冻结注释
- tools/pipeline_gate.py: 状态栏括号凭据核对废止,新增状态行禁括号判据(点名病因短路);闭合证据改现状正文核对(卡片路径磁盘存在性+交叉核、文档路径+版本、art-bible+版本)
- game/tests/static_scan.sh: S10 注释同步

变异验证(test-conventions §6):pipeline_gate 注入括号→状态行含括号内容红 exit1;删正文卡片路径→正文缺卡片路径+交叉核红 exit1;audit_file_headers 注入变更叙事→R2/R3 红 exit1、头注 12 行纯说明→0 红(上限停用实证)。坑册新增:未提交工作区禁 git checkout 变异还原(会连带回滚在途改动),须备份文件法。

全批净变化 +155/−146(12 文件)。
2026-10-20 23:15:05 +08:00
DKChan 8a68c9ea11 merge: 同步 master e92a18e1(卡片落位 reports/+dev→engineering 改名批)——四处版本历史节冲突取本批删除侧,reports 卡片重放禁写变更记录清理,06b 闸扫描面扩 reports/ 2026-10-20 05:46:28 +08:00
DKChan f406002766 docs(dev目录正名·engineering): design/dev 更名 design/engineering——名实对齐(目录实存=架构+五规约+引擎参考的工程知识域)
- git mv 15 件本体;13 个引用文件 34 处路径同步+熵增闸 DESIGN_SUBDIRS 白名单同批改判
- 白名单漏改时熵增闸当场真红(子目录越界拦截能力实录验证),同步后全绿
- game/tests 三件套注释按用户特别授权批后主区直改(不入本批);reports/research 暂存档按吸收即死原则不改
- 文档域闸全绿:gdd_lint/doc_link/doc_term/流水线闸/熵增闸
2026-10-20 05:33:34 +08:00