game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,740 Commits 23 Branches 0 Tags
e425ef1be0fd8f4949fb2b4dfae42d786e0a0831
Commit Graph
45 Commits
Author SHA1 Message Date
DKChan a66a977491 chore(research/退役批): UI预览demo三路对照件退出入库——上一笔 git add -A 误收，该件按 doc-conventions §11「永不入库」与「跨会话对照稿不落库」保持未跟踪，盘上留在 reports/ 不删 2026-10-21 15:28:02 +08:00
DKChan f958a03f51 docs(research/退役批): design/research 全目录退役落地——中间文档唯一暂存地收敛为 reports/（用户 2026-10-20 令「design/ 只放持久化设计文档，过程件一律出 design/」的执行补完，2026-10-21 会话复述确认） 
八件受版文件 git mv 进 reports/（一律先迁不删，删除归后续批或用户点名）：提案三件（冒险前资源配比预设／效果引擎无状态化／武器锻造系统）、审计两件（代码术语审计／单测与验收门禁标准测试审计）、美术审计两件（cursor 会话存档 md ＋ canvas 转 HTML 渲染件）、需求澄清-营地交互重做；未入库的 UI预览demo 三路对照件只搬盘不入库。

GDD 落文：锻造工坊.md「满级特效扩展位」节收下七条候选池（长剑破甲／长剑暴击面扩大／长枪先手连击／法杖开局魔法矢／轻甲灵巧／重甲反震／魔法护甲护盾），按现役 EFFECT_KINDS 与 settlement.tres:51/52 逐条复核实现代价分档，效果类型闭集口径取正文现行 31 种、不抄过程稿旧记 24 种；候选池定性为备用清单非承诺清单。

引用面换代 08（playnote 之外两处 ../research/ 改 ../../reports/）、待办清单四处、reports 八张卡片（跨目录前缀改同目录）、art-assets-checklist 与 sim-data/README 两处既存死指改「沿革查 git 提交史」、content-archive 出处句标注该目录已退役。迁入件内部相对链接随迁移重基准（../gdd/ → ../design/gdd/，playnote 与待办清单改回仓库根），并订正上一批遗留错误：两张迭代 30 卡片的 playnote 链接原写 ../../playnote.md（从 reports/ 出发指到仓库外），现改 ../playnote.md。

规则与机检：doc-conventions §11「暂存地非档案库」行改为单暂存地＋禁在 design/ 下设过程件目录＋图像载体与报告渲染件口径分列（禁图留 artwork/ 沿用 2026-09-27 用户裁；.html/.json 允许作为报告的一种＝2026-10-21 用户裁，原「只放 .md」句系 10-17 建目录时顺带照搬、无单独点头记录）；AGENTS Project Layout 两行同步；reports/README 补「设计讨论段过程稿」命名行。repo_structure_audit：DESIGN_SUBDIRS 去 research、RETIRED 加 design/research；doc_ref_audit 排除面清空（design 全树入扫描面）；doc_term/doc_link 扫描域注释换代；三件样张脚本 OUT_REPORT 改落 reports/ 并补 os.makedirs（改前只对 OUT_PNG 建目录，目录缺失即 FileNotFoundError）。

变异验证：重建 design/research 并放文件 → 结构闸退出码 1、同时报「退役路径再现」与「子目录越界」两条；design/ 内放两条指向不存在文件的引用 → 引用可核机检报「路径不存在」红项 2（该闸暂未注册进闸壳，无基线记录必判变化）；清场后结构闸 PASS。
 2026-10-21 15:27:16 +08:00
DKChan e364814294 merge(关卡节点图重构写卡批): 四张需求卡片＋已写卡状态回写，机检 12 卡口径全过 2026-10-21 08:36:35 +08:00
DKChan 52cc139d9b docs(关卡节点图重构写卡批): 四卡落定——生成器核心/消费侧换代/敌人表深度带/信息迷雾，各自 grilling 复核零待裁，状态推已写卡，文档域闸全绿 2026-10-21 08:36:34 +08:00
DKChan c66d8fee99 merge(营地交互重做): 卡④退回美术设计段＋迭代 33 编入卡①③②（回执 commit=8a2f80fe） 2026-10-21 07:48:32 +08:00
DKChan 8a2f80fe7c docs(营地交互重做): 卡④退回美术设计段（v2.3 非有效卡，美术设计闭合后重立卡）＋编排四查③增总估时下限（区间中值求和不得低于 5 天）＋迭代 33 编入卡①③②（≈2.5 周带超上限特批），文档域闸全绿 2026-10-21 07:48:26 +08:00
DKChan 224a947559 merge: 分支并入 master（推进 84 提交，2026-10-21）——research/ 治理批按现master重取四处冲突 
解冲突取法＝master 现文为准、本批新增语义打上去，不照抄分支旧文本：
- doc-conventions §11：活文档清单与「暂存地非档案库」行取本批新增全文（content-archive 退役内容留底／research/ 无常驻例外／跨会话交接文件禁入库／根 playnote 定性），清单称呼按 docmove 批现文写作「待办清单」，「落档必写接收方」「迭代实现报告」两行照收 master 版（旧日期注记不复活）。
- 08-Alpha版本标准：Alpha 出口裁决与营地五卡入 Alpha 的全部现行行照收 master，仅把 playnote 链接按新位置改指 ../../playnote.md。
- tools/repo_structure_audit.py：ROOT_FILES 取 master 全集（含待办清单/体验验证清单两件根文件）后追加 playnote.md。
- design/research/Alpha未完成事项梳理-2026-10-13.md：modify/delete 冲突按删除解——master 侧自分叉只改过两处指路句（f100e192／281d471e），其结论已由 08 v1.11-v1.12 与待办清单承载，吸收判据今日重核成立。

随批补两处 master 前进后暴露的同步面：AGENTS.md Project Layout 根目录段补 playnote.md 一行（白名单收了新根文件而目录说明未跟上）；技能层 batch-closure 两份副本（.zcode 原件→整文件覆盖 .qoder）补「research/ 无常驻例外」的候选呈报口径与 playnote 不入退役候选。
 2026-10-21 07:18:31 +08:00
DKChan 7493aebca8 chore(文档缺陷订正与机检补件): 四份根文件用词与死指订正＋新增引用可核机检件 
修文档缺陷四处：AGENTS.md「收口」×2、「不得」×3 换白话；roadmap.md:87「对拍」「标旗」换代；
reports/README.md 指向已迁移的 design/gdd/06-待办清单.md 改指仓库根；待办清单 iter19 遗留第⑦项
前半「数据配置.md:223 历史行死指」实查核销（该文件版本史行已随禁写变更记录规约消亡，现 212 行）。
补机检：tools/doc_ref_audit.py 核文档内「文件:行号」指针的目标存在性与行界，带扫描面为空与
引用数为零双自检；双向变异证据——注入不存在路径 EXIT=1、注入超界行号 EXIT=1、还原 EXIT=0。
doc_term 扫描面扩到四份根文件：扩面前实测这批文件自身含 3 处用语表废止词，先改现实再扩面，
扩面后「疑似现行」0、注入「完美排雷」见红 EXIT=1、还原 EXIT=0。
08d 引用可核暂不注册进闸壳：建档须改 game/tests/.gates/baseline.json，触 game/ 即要求代码域全量测试，
文档域批按测试两入口铁规零跑——注册欠账已登记待办清单。内容锚核对实测 81 处出 58 条未命中（约七成噪声），
按建议级交付不判红。文档域闸全绿。
 2026-10-21 05:51:17 +08:00
DKChan cd72943032 docs(迭代32收尾批): 批后收尾与中间文档退役——八件产出物退役＋账面换代，文档域闸全绿 
- reports/ 退役六件 iter32 产出物（实现报告/代拍板追认单/反哺点清单×2卡）＋两张需求卡片（判据全过：29 项反哺已写入、代拍板 14 条用户全追认、遗留读数义务已迁体验验证清单 ㉚/待办清单重锚条目）
- 待办清单整条删除四处：计数器寿命域未统一／代码注释禁用词清扫批（完成即删）／卡①卡②反哺专条（已写入即删）；重锚条目指针改结论内联＋git 提交号
- 提案死链改写（卡片指路句换 git 提交号 f2bb5871）；roadmap 迭代 32 行「已完成（2026-10-21）」＋卡片与报告列填退役保留字；当前位三行换代（下一动作=编排迭代 33）
〔迭代 32 收口登记：卡① 880ee91b／卡② d00f24a8／反哺写入 fc1e8027〕
 2026-10-21 04:19:06 +08:00
DKChan feaf01454a docs(验收闭合): 测试规范新增 §9 改动级验收闭合——每个需求点与行为改动都要真实入口断言＋撤销证明，合回前独立验收审计 
病根=测试规范 §5.2 只要求「每条清单条目至少一个自动断言」，没要求断言从改动的真实入口进入：
裸 EffectEngine 断言可替 BattleOrchestrator 接线，报告写「V1 绿」而 V1 断言并不存在。

- test-conventions §9（9.1–9.8）：验收单位=行为改动；四层与真实入口；改动—验收对照表六列
  双端对上（需求点正向、diff 反向、断言挂载测试侧）；撤销证明（改既有行为回退变红、新增行为
  变异变红）；禁削弱测试；明确不要求 TDD；合回前独立验收审计；旧卡不回头改、开工前补齐
- process-conventions §3：第 7 条挂对照表、第 9 条补撤销证明、第 10 条合回前审计、新增第 16 条
- AGENTS.md 硬性红线新增「验收闭合」，与变异验证并列
- pipeline_gate 新增 C3：卡片须有对照表节、五个必需列、至少一行、必填格非空、全文声明验收审计；
  只查结构不判语义（生效 2026-10-21，按卡片文件名日期追新）
- reports/README 与 batch-closure 同步验收审计报告的落点与退役判据
- 待办清单登记「验收闭合规则——下一次迭代实测评估」，按规则评估红线等真实迭代检验
 2026-10-21 03:42:37 +08:00
DKChan d8622ee271 docs(卡②报告更新): §9 逐需求点 V1-V14 全落地表 + 补漏记录 + V1/V4/V9/V10 变异 2026-10-21 02:47:10 +08:00
DKChan 6491f7d5f6 docs(卡②产出物): 实现报告＋代拍板追认单＋反哺点清单三份落 reports/ 
实现报告含完成定义 8 条逐项核对、V12 三组判读表（off 逐字节一致）、变异验证表、V14 目检登记；
代拍板 7 条＋S11/S12 编号冲突与 V12 基线重采呈报；反哺点 13 条（architecture 三处/tests README/06/07/提案三处订正/sim-data 例外）。
 2026-10-20 23:56:53 +08:00
DKChan 9a4eddba3f docs(卡①产出物): 实现报告＋代拍板追认单＋反哺点清单三份落 reports/ 
实现报告含改前改后读数对照、N7 修正、A10–A12、变异验证表、parity 已记档差异两例、06 重锚登记；
反哺点 16 条（GDD 九篇完美排雷→完美封印措辞、07 目检入册、移交归类、词表扩收、卡片与现实偏差）。
 2026-10-20 22:28:53 +08:00
DKChan f230bde1c3 docs(卡①失效避让陈述清账): 06 归属段与卡片三处（契约 10／不做表行／停机条件 5）删去「changelog-retire-20261019 在盘未合回」避让前提（该批已于 c5200b6b 入 master，前提失效），约束本体保留并改挂流水线红线依据（迭代批禁写 design/ 与根规则文件）；顺带把旧目录 design/dev/ 三处写法改为 design/engineering/ 2026-10-20 20:02:20 +08:00
DKChan bd0ad0e441 docs(迭代 32 编排): 效果引擎无状态化批编入迭代 32——roadmap 行卡片列追加为第二执行序、预计周期 ≈0.5 周改 ≈1.75 周、当前位迭代位同步两卡；06 条目状态末尾追加「已编迭代 32」（累积段保留）；卡片「不做」表补两行：当前位归编排段维护、与卡①禁并行开工（同改三文件注释面） 2026-10-20 19:25:09 +08:00
DKChan 0b95a0c333 docs(代码注释禁用词清扫批·目录整改): 卡①从 design/research/ 移入 reports/（需求卡片唯一容器规约）——06 状态行与 roadmap 迭代 32 行卡片列两处路径同批改指，流水线闸两红（凭据缺失／已编迭代无可引卡路径）消解，现 PASS 2026-10-20 19:22:14 +08:00
DKChan d42c8f1a7e merge: master 同步（迭代 30/31 收尾批）——06 末尾两条目并存，冲突逐条保留 2026-10-20 18:57:42 +08:00
DKChan 3304850d17 docs(效果引擎无状态化·复核裁决入卡): 对抗复核六项裁并写进正文——V12 复放基线改批内重采（批前三组 40 局已采完留盘带哈希、批后同种子复放，现行锚 24 字段面与现采 33 字段面不同构故判废）；前缀判据采松版＋新增装载期引用闭合校验（feats.tres 现有 14 枚 id 全含下划线，封闭前缀词表误伤既有 battle id）；改名面扩到读点 :39/:501、合成行与夹具的 domain 残留、七处过期注释；pain_layers 措辞改「单战零变更＋旧档续玩不再跨战」列第三处预期差异；V1/V5/V9 夹具写死、V9 assert 侧注入点改直调 _push_trigger；采集器 rules 注入类型缺陷（split 产出 PackedStringArray 被 is Array 静默丢弃）修复列为 T0 首提交 2026-10-20 18:56:21 +08:00
DKChan df4518d878 chore(批后收尾): 迭代 31 产出物与两卡退役——吸收即死删除，06/roadmap 账面换代 
- 反哺点 14 条已于 7682559 落文（术语表 seal_* 契约键与效果词条、奇物完美保险指向、07 ㉙ 七项目检、美术件名与守卫例外条款、06 新候选）
- 代拍板追认：13 项全部追认（卡① 1-6、卡② 7-13）；待裁 A=甲——玩家面残留禁字另开小批、已登记 06；B=乙——perfect_broken 判据句改文档措辞、代码零动
- 实现报告 §六-1 未闭项迁 06「计数器寿命域未统一」：domain=battle/adv​enture 寿命判据无法由单测 rig 变异证红，闭合时补 runner/MC 对照读数或确认不设机检
- 06 删除两条已完成条目（代码术语刷新批、凭证件裁削批·代码侧）
- roadmap 迭代 31 行改「已完成（2026-10-19）」、两列改已退役保留字；当前位换代至迭代 1–31 全完成
- 代码术语审计报告的卡片指路句改指合回 commit 4f953ce8/3e076e22（卡片退役后不留死径）
 2026-10-20 15:28:38 +08:00
DKChan 893aac795f chore(批后收尾): 迭代 30 产出物退役——实现报告/代拍板追认单/反哺点清单三份按吸收即死删除（反哺点七条已于 2026-10-17 全部回写并复核落文、7 项代拍板已追认、07 ㉘ 五项实机目检在册、.uid 卫生缺口已随后续批闭合）；报告 §六-1 阔视野带表述冲突迁 06 新条（秘宝表与 treasure_items.tres desc 仍写「类型微光 8→12 格」，与 HUD框架「微光不随视野扩」冲突，待数据文本订正）；存档制卡片 F8 的基线读数指路改内联＋commit 7ffd1dc0；roadmap 迭代 30 行实现报告列改退役保留字 2026-10-20 15:08:18 +08:00
DKChan 487c2072f1 chore(批后收尾): 迭代 29 实现报告退役——吸收即死删除（反哺点三条已落文 test-conventions §7/§8 与 07 ㉖ 机检承接注记、12 项代拍板已追认、测试域遗留七项在册 06、§六.1 parity 待批准事项按「MC 无数值改动零跑」红线判闭合：本批对 battle_orchestrator.gd 仅加断言豁免常量、零数值改动，不补跑，理由用户裁 2026-10-20）；本批无实机目检项、07 无新增；roadmap 迭代 29 行实现报告列改退役保留字 2026-10-20 15:03:26 +08:00
DKChan f8191a3bc6 chore(批后收尾): 迭代 28 实现报告退役——吸收即死删除（反哺点三条已落文 architecture 2026-10-17 版、追认 1–13 已同意、#14 待裁已迁 06、t17_defer 存量红已消解--full 现绿、目检已登记 07 ㉗）；roadmap 迭代 28 行实现报告列改退役保留字 2026-10-20 14:59:04 +08:00
DKChan ed19453d25 chore(批后收尾): 迭代 27 产出物退役——实现报告与探针迁移对照按吸收即死删除（反哺点已落 architecture/code-conventions 2026-10-17 版、追认单十五项已追认、目检已登记 07 ㉖、观察义务已迁 06）；roadmap 迭代 27 行实现报告列改退役保留字，reports/README 示例注记退役 2026-10-20 14:54:53 +08:00
DKChan f7be1f47c4 docs(效果引擎无状态化·写卡补丁): grilling 审查轮事实修正——T3 补 :390 回灌调用删除（漏列即编译断裂面）；T2/T1 补 run_ledger 头注与 level_runner :630 过期契约句清理面（「战斗侧只走 read/append 原语」随 ctx 直写字面失义）；T5 counter_id_legal 修回提案 §3.3 字面（仅 meta_ 非法——「其余未知前缀非法」语法不可判定，残剩风险归 V10 扫描与评审） 2026-10-20 07:39:30 +08:00
DKChan 31fe87d122 docs(research/治理批): 暂存地职责收口——§11 立「research/ 无常驻例外」＋卡片死期=实现批合回 master＋跨会话交接文件禁入库＋根 playnote 定性用户随手记；道具退役素材库迁 design/content-archive/ 转正活文档（3 处 GDD 引用同步）；playnote.md 挪仓库根（引用面 6 处＋ROOT_FILES 白名单）；research/ 清 6 件（会话交接四件＋读数 dump＋Alpha梳理已吸收件，H11 指路改结论内联）；熵增闸 DESIGN_SUBDIRS/ROOT_FILES 白名单同批改；技能层旧卡片路径 7 处在主区就地修（harness 配置不入 git） 2026-10-20 07:34:46 +08:00
DKChan f2bb587170 docs(效果引擎无状态化·写卡): 需求卡片成文（reports/需求卡片-效果引擎无状态化批-2026-10-20.md，零待裁点开工门=U0）——T0–T8 九卡带签名/断言/落点、验收 V1–V14 三问逐条可答、变异验证五条、V12 具名锚＋锚新鲜度核对步；06 条目推进「已写卡（本卡路径）」；提案 §10.1 补行号再漂移注记（c5200b6b 注释清偿后以卡片开工前实查为准）；卡片经独立会话对抗复核五项回炉全落（行号群订正/V9 assert 侧闭环/判定函数名落定/估时对齐/裸引擎段实数 53 处）——--docs 闸全绿 2026-10-20 07:19:29 +08:00
DKChan cddd13ff40 docs(禁写变更记录批·补): iter30 反哺点末处「版本历史追加」措辞换代首状态行 2026-10-20 05:46:51 +08:00
DKChan 8a68c9ea11 merge: 同步 master e92a18e1（卡片落位 reports/＋dev→engineering 改名批）——四处版本历史节冲突取本批删除侧，reports 卡片重放禁写变更记录清理，06b 闸扫描面扩 reports/ 2026-10-20 05:46:28 +08:00
DKChan d6356d8dbe merge: 同步 master d5f95e7f（art/ 边界批）——三处冲突＝对方 art 改名/迁移 vs 我方路径重基准，取对方内容改动＋按新落位换算路径（comfyui-prompts→art-prompts、美术审计件迁 research/） 2026-10-20 05:30:37 +08:00
DKChan 0616af94fb docs(卡片): 需求卡片落位迁至 reports/——路径依赖、规则说明、流水线闸、工作流技能全量同步 
用户裁：需求卡片属过程件，不留在 design/；统一落 reports/（不新设目录，卡片靠「需求卡片-」文件名前缀与报告区分）。

搬移：
- 10 张在役卡片 design/research/ → reports/（git mv，历史保留）
- 卡内相对链接全部重基准：../gdd→../design/gdd、../art→../design/art、../../→../、
  同目录 research 引用→../design/research/（营地澄清、playnote、资源配比提案）；
  链接解析校验 BROKEN=0

路径依赖（全库 48 处）：
- 06 待办清单 10 条卡片路径、roadmap 迭代 31 行 2 条、reports/iter31 报告与反哺点各 1 条
- 代码术语审计报告 2 处、会话提示 1 处、资源配比提案 1 处

规则说明：
- AGENTS.md Project Layout：design/research 行注明「需求卡片不在此」；reports 行扩为「过程件容器」
- doc-conventions §11 暂存地表拆为两处；§12.1 状态机示例改 reports/
- reports/README.md：定位由「迭代批产出物」扩为「过程件容器」并新增需求卡片行

流水线闸：
- pipeline_gate.py CARD_DIR / RESEARCH_RE / 报错文案三处改 reports/（闸 PASS，卡片口径 10 张全过）

工作流技能（.zcode/skills，不入 git）：
- req-card :8 落位 / :27 三份已退役范本改指现行卡片 / :92 06 回写口径
- iter :19、iter-plan :28/:66、batch-closure :3/:63/:65
- 用户级副本 C:/Users/DK/.workbuddy/skills/req-card/SKILL.md 同步三处（技能列表启动时加载，需重开会话生效）

未动：design/art、design/qa、提案、playnote、道具退役素材库、会话交接件（归其它会话）。
闸：run_all_gates.sh --docs 验收通过。
 2026-10-20 05:28:42 +08:00
DKChan fe47f48e0c merge: 同步 master e8a29342（qa目录退役批）——四张卡冲突按「卡已退役」取删除，master 侧改动仅为 design/qa/ 路径内联，信息零损失 2026-10-20 03:51:25 +08:00
DKChan 55cdf683da docs(卡片): 退役 11 张失归属需求卡片（迭代 20–30 已完成批）＋清偿全部指路与死链 
按 doc-conventions §11「吸收即死」「删除不留死链」执行：
- 删 11 张：迭代 20–30 各批卡片（含迭代 28 启动装配卡——roadmap 卡片列早已写「已退役」、文件却仍在盘，属漏删）
- roadmap 卡片列 10 行改「已退役（git 历史可考）」（流水线闸对保留字豁免，pipeline_gate.py:303-309）
- reports/iter27–30 四份报告头部卡片路径改保留字，不留指向已删文件的路径
- 保留卡（战斗一屏样张批／二三关棋盘观感批）对已删卡的 6 处指路改结论内联＋提交号
  （徽章卡 7ffd1dc0／测试分层卡 fff4f120），各加一行「指路订正（2026-10-20）」
- 顺带清偿 2 处既存死链：07-体验验证清单 ㉑ 节、HUD框架 视野迷雾注记（两卡早已退役，历史删卡未做引用面清理）
- 顺带清偿 3 处 game//tools/ 下遗漏引用：theme/README、forge.tres T1 注、parity_anchor.py 头注

保留 10 张未开工卡（迭代 31 两张、06 在册营地五卡＋资源配比、被剔除回待设计的样张/观感两张）。
零设计裁决变更、零数值变更。
 2026-10-20 03:37:31 +08:00
DKChan 75fafc3965 docs(qa目录退役): design/qa/ 清空删除，四路分流＋§11 立接收方条款 
- 40 张取证照与同名对比报告 → game/tests/evidence/ui-audit-2026-10-06/（该目录既有章程「人工测试证据」，目录根新增 .gdignore 令 Godot 整目录跳过导入，图不生成 .import 边车也不进导出包；parity/anchor.json 走文件系统路径读取不受影响）
- 有接收方的两份审计（代码术语审计→06:546＋迭代31 卡①／测试审计→测试分层卡片）平移 design/research/；iter27-探针迁移对照（T1 未施工＝活交付物）迁 reports/，reports/README 放什么表补一行交付物类型
- 已核销的迭代18-实机目检总清单（2026-10-14 十八项全过）删除，顺带清掉其内 4 条指向 8e02dcf0 已删件的回指
- doc-conventions §11：暂存地唯一归 design/research/，验证凭据不归文档目录；新增「落档必写接收方」一行——写不出接收方的不落文件，内容在会话里交付
- tools/balance_verifier.py 报告与原始数据改落 sim-data/（QA_DIR→READINGS_DIR）
- 活指针 13 处改判：AGENTS.md:22/30 与 Project Layout game 行、06:546、07:103、career 卡片×4、art-bible §8.2 L490 与 生涯.md:81 两处 8e02dcf0 遗留死指涉、game/tests/README 分级表与台账行、reports/README
- 结构闸白名单三处同批收口：IMAGE_PREFIXES 去 design/qa/ 加 game/tests/evidence/、DESIGN_SUBDIRS 去 qa、RETIRED 加 design/qa（目录复活即 FAIL）
- .qoder 技能 doc-consistency-check 两处指路改判（harness 配置不入 git，主区直接改）

单件试跑全绿：gdd_lint 10/10、doc_link --strict 死链 0、doc_term --strict 疑似现行 0、pipeline_gate 63 条目/21 卡、repo_structure_audit PASS。
本批 diff 触及 game/ 路径，合回需全量档回执（含代码域测试），待用户点名。
 2026-10-20 02:07:39 +08:00
DKChan fdaa10cb1c docs(rules): 批后收尾技能 batch-closure 落地指认——AGENTS.md 技能对照加第六入口＋process-conventions 12/13 接上悬空的「归文档批做」＋doc-conventions §11 删除方式与 reports/README 生命周期各补执行入口；技能文件本身在 .zcode/skills/（不入 git），反哺落文仍归 doc-design，本技能只做退役编排 2026-10-20 00:10:43 +08:00
DKChan d54cbed7a5 docs(registry): 注销 design/registry 两处 yaml——GDD 现在时指针 76 处改指真权威＋地形变异/存档序列化/数据配置等同批换代＋iter31 反哺点 §三 registry 节删除＋doc_term 登记 registry 退役词 --strict 零疑似现行 2026-10-19 19:57:00 +08:00
DKChan c46d976811 docs(reports): 迭代 31 反哺点补扫结果——门禁词全类型复扫零命中成文＋玩家面残留「雷/插」五处全表 
原 V1/V4 判据按四类扩展名扫，本次按 game/ 全部文件类型不排除扩展名重扫：
金币/插旗/雷格/惩罚格 0 命中、flag 不分大小写减豁免后 0 命中；
「旗」仅存在于守卫被检查字面量六处（改写＝自毁对外命名纪律守卫），已建议成文；
玩家可见文本残留 雷/排雷/插 由一处补全为五处全表（含字形「雷」连带 golden 基线换代的提示）。
 2026-10-19 16:41:26 +08:00
DKChan da67a87130 docs(reports): 迭代 31 反哺点补 roadmap 两条（迭代行状态换代＋当前位换代） 
卡② §5 明列 roadmap 属反哺点面，前笔漏列，随收口补齐（本批仍禁写根规则文件）。
 2026-10-19 05:25:23 +08:00
DKChan 85470918f0 docs(reports): 迭代 31 三卡收口产出物——实现报告＋代拍板追认单＋反哺点清单 
两卡状态、改前改后读数对照（卡① 120 行真差异 0／jsonl 六面行数全同；卡② 差异面归因到裁断）、
变异验证 6 条记录、实机目检总清单 7 项、遗留读数义务 4 项、代拍板 13 项、反哺点 18 条。
禁写 design/ 与根规则文件：06 推进句、术语表、entities.yaml、art-bible/asset-path-map、
07 目检项、roadmap 行换代全部列进反哺点清单等你裁决后归文档批落笔。
 2026-10-19 05:24:26 +08:00
DKChan 27812167ef refactor(状态规矩): 废除根目录会话状态文件 active.md 与全套执法件（2026-10-18 用户裁） 
判据（对 869 个 ZCode 会话与 16 个 Qoder 会话的读写统计）：active.md 被整文件读 448 次、
单次中位数 14 KB、累计 6.09 MB 进上下文，311/320 个碰它的会话把它当第一个工具调用读；
但 7311 个提及它的思考片段的语境分布是——写入与编号簿记 327 个会话、并行冲突与避让 234 个、
退役与失真核对 162 个，而明确写「从它所载内容得知某事实」的只有 20 个会话。
逐条核 41 个条目：独特且现行 2 条（另 3 个子句）、别处已有权威源 14 条、陈旧或自相矛盾 7 条、
已完结批次的历史叙述 18 条；按字节约 95% 属后三类。失实样本：architecture 版本记 v1.6 实为 v1.8、
规则文件数记 7 份实为 6 份、迭代 27/28 记「位预留追加卡」而 roadmap 记已完成、三个已删 worktree
仍记「在盘待删」、同一条既宣称「文档禁列闸清单」又自行列出 01–11 全套闸。
执法件已建一轮仍拦不住：08b 体量闸只测条目数/行数/编号/死链，测不出语义失真；钩子不随仓库传播，
只有 ZCode 在跑；10-15 清到 8.6 KB、10-17 回到 40 KB，用户为「只写不删」连续三次发火。

改动面：
- 删 active.md 与 tools/audit_active_state.py；run_all_gates.sh 摘除 08b 闸件与头注、
  baseline.json 删 08b 记录（现存 12 闸）、repo_structure_audit.py 根文件白名单去 active.md
- doc-conventions §10 改写为「仓库根不设状态文件」并留裁决与判据（保持 §11/§12 编号不漂）；
  §11 表两行去状态文件口径；§4 适用范围去 active.md
- process-conventions §1 第 2/3 条（合回前查尾号防撞号、豁免面）、§3 第 12 条（批次完成后的
  登记义务）、§6 分级周期口径（闸件清单不再在文档重列）四处换代
- code-conventions「实现批收尾双登记」改为单登记；CLAUDE.md 目录节、规范导航行、worktree 豁免
  行三处换代，红线新增「仓库根禁止设会话状态文件」一条
- roadmap.md 顶部新增「当前位」三行（阶段／迭代位／下一步）接替原快照职责，头注、执行纪律第 3 条、
  loop 规范第 8 条、维护纪律四处改指 06 与本文；reports/README.md 与 sim-data/README.md 两处
  现行指路改口；architecture.md 文档域闸表行去 active.md 体量闸与触发路径
- 06-待办清单迁入七条真残值（原仅载于该文件）：卡片入库纪律悬空待办、req-card 两副本取齐、
  魔法道具与罕见残留（实数 23/17 处，旧记约 30/18）、通关口径统一（gdd 内 188 处，旧记 273）、
  黑话第二波待发令、数据整改批九条存疑待抽查（该批未提交面所载）、发布前删除 main.gd:196 调试
  入口写死行（工程直入·待写卡）

harness 侧另批处理（.zcode/ 与用户级技能不入 git）：session-snapshot.sh 与 config.json 注册、
worktree-guard.sh 的 active.md 豁免白名单、active-closing 技能、doc-consistency-check 第 8/9 项、
iter 与 req-card 技能里的「唯一例外=active.md」与查尾号条款。
 2026-10-18 07:28:48 +08:00
DKChan 34f3cdb36d docs(iter30-fb): 迭代 30 卡① 文档批——代拍板七项追认＋反哺点七条回写 
用户令「追认没有问题;反哺点可以都进行回写」两项一波走完（文档批，
不占迭代号，分支 iter30-fb-20261017，基于 master 0a164958）。

追认：
- reports/iter30-代拍板追认单-2026-10-17.md 文末加追认结果行——§9
  白名单 7 项全部同意。

反哺点七条全部回写：
- 06-待办清单：徽章条状态待办→已完成（入库 7ffd1dc0、冒烟 1151/0、
  单测 34 套、探针 case⑰、07 ㉘ 人闸五项）；色相措辞修正为「样张
  v2 冻结既裁值，本批只动明度」；2026-10-05 实查读数刷新
  （bonus_pick_overlay.gd 已改名 curio_pick_overlay.gd:97、TG_* 五族
  在役 ui_kit.gd:49-53、裸 Color8 读数作废）；新增「卡顶色带与格面
  微光两带统一」待办条（Q3 甲案）。
- HUD框架：实装状态行转「已实装（迭代 30 卡① 2026-10-17 入库，
  合并 7ffd1dc0）」；验收行转正式验收；版本历史 v0.19；口径史注记
  后补两带分工注记（卡顶带=条目级静态色带／格面微光=棋盘格内动态
  微光，禁互为引用）。
- 08-Alpha版本标准：「五 · 表现」表新增「未开格类型微光（五组色相＋
  明度档）」行（在役；明度档 provisional 值，样张批复核转正）；
  版本历史 v1.9；文头状态行 v1.8→v1.9。
- art-bible：五组明度档 provisional 值（芥末黄 #F7DF43／黄绿 #68D042／
  青 #30A6A6／紫罗兰 #7B5BD6／绯红 #A61D37＝冻结 #FF2D55 的 V=0.65
  档，五组 ΔH ≤0.13° 色相零移动）＋生成口径（渲染合成空间伽马阶梯、
  相邻组模型 CR 1.245/1.234/1.239/1.270、判据线 1.20、实测最弱对
  1.232、群伤暗档停机呈报留痕）落版本历史 v3.15；§4.2/§4.6.3 权威面
  零改动、§2.1 未追加（Q5 甲案静态）；头注「现行为」v3.11→v3.15
  漏更订正。
- roadmap：迭代进度行、近期主战场行与迭代 30 表行状态列同步卡①已
  入库（②③待 /iter 发令）。
- 07-体验验证清单：新增 ㉘ 节五项人闸（五组一眼可分／不遮数字
  〔环不外溢〕／出圈灭入圈复亮／整屏不脏／群伤暗档 #A61D37 观感
  〔provisional，读数归样张批〕）；版本历史 v1.5。
- reports/iter30-反哺点-2026-10-17.md 加「回写结果」节逐条标已回写。
- active.md：快照「更新于」行追加文档批从句；未决面待用户追认行补
  iter30 七项已同意；追加状态记录 511。

验收：文档域闸 tools/run_all_gates.sh --docs 五闸（06 gdd_lint／07
doc_link／08 doc_term／08b active.md 体量／10 熵增）全绿，闸况与
基线一致无新增红，回执 commit=分支尖。

遗留：卡②③待 /iter 发令；07 ㉘ 实机目检五项待用户过目；群伤暗档
provisional 待样张批转正；g-plan2-iter30-fb 工作区待合回后清理。
 2026-10-17 17:40:29 +08:00
DKChan 7ffd1dc0e1 docs(reports): 订正 .uid 状态读数——type_glow_test.gd.uid 已由批末编辑器导入通行补齐并随断言三件笔提交，自产 .uid 实为 4 个（原写「无 .uid 伴生、不随本批提交」滞后于编辑器通行事实）；存量 9 个未跟踪 .uid 仍归卫生批。实现报告 §六-2／反哺点附注／追认单第 7 项三处同步。 2026-10-17 10:21:58 +08:00
DKChan 2aa7e8fdc1 Merge branch 'master' into iter30-glow-20261017 2026-10-17 10:20:28 +08:00
DKChan 161d90c38e docs(reports): 迭代 30 卡①三份产出物落位（T4 末卡收口）——实现报告（各卡状态 T0-T4／停机呈报与裁定留痕：群伤组初版 #FF1A31 ΔH 5.40° 触冻结色相 L3 停机呈报→用户裁「换更暗档 #A61D37」＝冻结 #FF2D55 的 V=0.65 档色相零移动／board_shot 双帧 glow=0 假绿根因修复（裸视图未接身份解析）／合成空间阶梯口径订正／闸读数表：冒烟 1151 项、单测 51/51 34 套件、探针十八断言、判据源探针 CR 最弱 1.232、双帧 outside=0、golden 0.10-0.14%／变异验证记录表 M1-M5 五组反例实证含红输出实录／实机目检总清单 V10 人闸登记不阻塞／遗留读数义务：阔视野带 desc「微光范围 8→12 格」与卡 §4「不扩微光」冲突属数据文本批、type_glow_test.gd.uid 卫生缺口、golden 基线未重制、群伤暗档 provisional 待样张转正）；代拍板追认单（§9 白名单 7 项逐项留痕：命名落点／shader 距离场取舍／uniform 参数表／呼吸未启用／夹具配置／阈值 provisional／提交切分）；反哺点清单（§5 七条逐条落点：06 条目状态+措辞修正、HUD框架 :140/:269、08 表现表新增行、art-bible 明度档修订条目、roadmap 批内状态、Q3 两带分工+06 新待办、07 目检人闸条）。零 design/ 与根规则文件直改（v1.3 口径）；active.md 状态记录另随主区会话批更新。 2026-10-17 10:19:16 +08:00
DKChan abe5f180fb docs(反哺): 迭代 27/28/29 GDD 反哺点八条＋一条建议逐点裁决写入（2026-10-17 用户令「全部按推荐案」）——①③④⑤architecture.md v1.8：新增「战斗域装配现状」（结算五段/RunLedger 四账）与「呈现层装配与会话生命周期」（三屏壳/装配合同立条款不摘录表/RunScope 九阶段×五引用面矩阵认账/ModalFlow tags）两节＋初始化顺序补启动后置条件六条，呈现层 D1 行与实现实证读数换代；②code-conventions.md §4 第 7–12 条（S9 三规则口径/:= {} 不算债/type-hint-ignore 与 rng-seed-exempt 两豁免通道/禁裸 autoload/Variant 参数化口径）；⑥⑦⑨test-conventions.md 新增 §7 判定三硬闸（含新写测试件全类型标注写法纪律）与 §8 判定可靠性优先于覆盖率（含脚本错误静默中断断言的机制事实与自证义务）；⑧07 v1.4：㉖① 保留不注销、加 screen_flow_probe 机检承接注记。同步清三笔在册旧账：iter27/28/29 三份实现报告 git mv 往 reports/（06 条③迁位账清零，全库引用改指新路径、iter24/25/26 等已删报告死指针改「已退役（git 历史可考）」）；iter29 报告 §六第 0 项按合并现实（fff4f120，两红各自结案 dac9a94b/fcb8c3f8＋8c18b52b）改写；06 补登迭代 29 反哺专条（该批漏登）。登记时「16 层/十断言」读数按代码实态 17 项/11 条订正。非迭代批不占迭代号；active.md 改动留主区工作副本不随本批提交，等闸回执。 2026-10-17 06:25:28 +08:00
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