game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,518 Commits 23 Branches 0 Tags
161d90c38e1e802fb0a73ae2f2ccc96a49db87ed
Commit Graph
41 Commits
Author SHA1 Message Date
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
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 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 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 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 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 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 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 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 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 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 c5a09fd90c refactor(改名批): 暂停层/暂停角标→状态面板/状态角标——用户令全量改名(文案4处+标识符全套PauseOverlay→StatusPanel/pause_overlay.gd→status_panel.gd/成员方法族+探针快照键+注释与探针消息86处清零;行为契约四件零动——只读R4/模态遮罩P2甲/输入锁R3/零动效P4甲)+render_gate截图键shot_pause→shot_status同步+文档六面(元进度v1.19/07/生涯/06条/architecture json+html;camp零命中;08-Alpha版本标准untracked禁碰留置)——冒烟938/0+run_all24套+probe --click/--full+render_gate全绿;rg 暂停|pause game/归零 2026-10-13 05:41:59 +08:00
DKChan 5d254f7e11 merge: master 并入分支（并行十八笔——active 清理批/改名批/奇物呈现批；冲突=active 快照与记录块手工融合，469 弃用上游清档口径、收口条顺延 476） 2026-10-12 14:28:50 +08:00
DKChan 74f97231fd docs(dev+gdd): 测试函数落码规范落 code-conventions §3.5 + 术语表开发流程两词条（逻辑验收方法论批，2026-10-11 用户裁） 2026-10-11 18:42:01 +08:00
DKChan ac19754374 docs(glossary): 退役词对照表全库强制清扫——正主→现行事实源130行+落籍→已入库79行（39文件194行，语境微调=权威文档/权威定义节/拼表制主选/入库注记等；对照性文本豁免保留）+五词终验零真残留+术语表v1.3+active 446（2026-10-11 用户令收尾） 2026-10-11 05:46:49 +08:00
DKChan 6951632d25 docs(glossary): 术语表建立+全库术语统一批——危险格/整图/专长凭证（2026-10-11 用户四裁）+秘宝.md v2.5 可读性审查批 
- 新建 design/gdd/术语表.md v1.0（四节术语+退役词对照；02 清单登记；用户令查表阅读）
- 全库更名：雷格/惩罚格→危险格（113 处）、雷安→危险格与安全格（39）、板级→整图（29）、门票→专长凭证（88）、雷位→危险格位置（5）；排雷玩法定义句换代+版本行
- 秘宝.md v2.5 可读性批：术语指路+黑话清扫（正主/落籍/P1甲死指针/charges/结构闸等）+承重契约白话化+验收分层白话化+两处过时事实修正（战斗道具窗口 2026-09-15 已下线/21 项义务死指针）+版本行序修复
 2026-10-11 03:56:12 +08:00
DKChan 933e1a9421 docs(conventions): 用语纪律落正面总则「见名知意，所见即所得」（2026-10-10 用户立规） 
正文三处：§4 标题补八字总则；开篇新增正面总则段（见名知意管名字、所见即所得管句子，注明管语义透明不与第 8 节指路存根冲突）；版本历史 v16 行。随批：active.md 状态记录 437 号。
 2026-10-10 18:33:48 +08:00
DKChan c848cefe9a docs(rules): 「工作日志」废止全仓改「状态记录」+会话状态清除新规+秘宝实装待办登记（2026-10-10 用户令） 
- 五文件 105 处「工作日志」→「状态记录」（active.md 31/doc-conventions 13/CLAUDE.md 5/06 10/roadmap 46；残留 2 处系更名动作引述保留）
- doc-conventions §10 章程：定性补「状态记录，不是工作日志——旧叫法废止」+退役规则首句落新规「用户确认任务完成时清除当前会话写过的状态条目——状态清除即任务完成证明」
- 06 新条「秘宝体系实现重构落地批」（冻结待发令）：新 15 件实装+旧数据行清理（deferred 清零）+27 专长行删除+空配置验收闸+池选型三案+效果引擎扩签核实+两疑似漏项 T0
 2026-10-10 15:17:08 +08:00
DKChan fa430f2584 docs(rules): 三段开发流程立规+文档同步闸v2——设计/写卡/实现三段出入口（2026-10-10 用户令） 
- CLAUDE.md 新增「三段开发流程」节：设计（用户点头心智模型一致才落文档+裁点清零才算完成）→写需求卡片（grilling 多轮复核零待裁+入库必登记 06）→实现（迭代号 U0+设计正主文档批内一律不更新）；批次工作流清单引言同步改指
- CLAUDE.md 批次工作流第 12 条改 v2：机械面文档（roadmap 行/registry/active.md/README/工具注）合并前随批同步不变；GDD/art-bible 等设计正主改走迭代实现报告反哺制——收口出迭代级实现报告（design/qa/iter<N>-实现报告-<日期>.md，含各卡状态+代拍板追认单+GDD 反哺点节），反哺点收口时登记 06，用户逐点裁决后另批落文
- doc-conventions §11 新增「迭代实现报告」行+「证据只留最新」措辞换代+版本历史 v15：实现报告属中间文档，替代原每卡出口报告

背景：武器锻造取证确认「迭代」曾被当作一切批次容器（迭代18卡③设计提案混进迭代通道）致「迭代完成了但游戏里没有」口径错位；用户立规依据=文档与用户想法等同对等，文档修改必须经用户同意，只出报告、同意后再更新。纯文档批零代码零测试（两入口铁规）
 2026-10-10 02:08:16 +08:00
DKChan bbc849eac5 docs(audit): 文档正确性审查·独立复核批（worktree docaudit-2026-10-09，基点 03c4b4c——18 文件语义级清漏，主区零触碰） 
R1 状态与证据对齐（全部代码实证）：
- 存档序列化 v2→v6 换代（save_manager.gd SAVE_FORMAT_VERSION=6 实证）：数据模型 JSON+域清单补 v4 同调三域/v5 树域/v6 生涯两域逐行 owner、版本与迁移节五件迁移链、调参表常量 6；v3-v6 四次升版当时均未回写本文，本批一次清偿（v1.4）
- 数据配置表清单四处失同步：变异表六行→七行（variation.tres 实测 7 行含贫矿脉）/RewardConfigTable 行删除（reward_config.tres 与类名全仓零命中）/AuxItemTable→TreasureItemTable（treasure_items.tres）/MetaTable 四行族→五行族（+attune_refresh_upgrade）+HeroTable 补 armor_class（v0.6）
- node-reward 令牌池六种→七种（adventure_table.gd CURIO_KINDS 实测七类含 refresh，curio_quota_refresh_rare=2 在役；v2.5 修订漏登，v2.6）
- interaction-patterns #19 inventory_panel_view.gd『已实现』系失实登记（git 全史零记录，从未入库）→占位失效
- level-clear『加权洗牌掷 3』漏网旧口径→令牌池洗牌不放回（与冒险结构 v0.14 对齐）
- 奇物依赖表 relics.tres→feats.tres（表文件已换代）+§1.3 异质性账清单对齐凭证件表（AP 上限摘除）（v3.10）

R3/R4 退役残留清漏：
- 行动经济依赖表『挖/插/拔』拔旗残留（v0.4 批漏网，v0.11）
- 地图战斗资源依赖表『秘宝的背包』同调形态残留（v0.22）
- 冒险结构『秘宝件受同调位约束』替换交互无现役触发面补注+『06 在册』悬空指针清偿（v0.19）
- HUD框架秘宝义务行『库存条常读』→装配件与充能常读（v0.15）
- 教学引导/P0 闭环/战斗结算/level-clear 等六处『秘宝背包/关卡末清库』补机械惰性承载注（treasure_inventory 代码实证在役但投放渠道全退役恒空、拆线归实装批——battle.md『无关卡域清库面』表述精确化）

R2 里程碑/批次口径：
- level-map 四处 M-1/M-2 前缀删（迭代 2 框材组=git 9abf5ff 实证；迭代 4 三处）
- 07『难度修正批』全替『数值批（Beta 阶段，未排期）』（v0.4）
- 教学引导『里程碑定位 Alpha』两处→Beta 阶段（2026-10-04 用户拍板漏同步，v0.5）
- HUD框架 P1『秘宝内容重定批』过期批次名→node-reward v2.5 在役

指路断链：
- 06 archive 死链改写（不入库目录表述）+两条『用户令删除』死条目整条移除（git 留痕）
- 07 三处伪死链去链接语法
- 奇物 §1.6 两处 ../ux/→../../ux/（v2.7 旧债，doc_link 复验清零）+06 欠账条目同步清偿注

规范两份：
- doc-conventions §1『现行文档不跑 lint』与现实对齐（gdd_lint=机检三闸之一在役，v14）
- code-conventions active.md 旧路径迁根目录+版本表补建（v2）

doc 三闸终验：doc_link 死链 4→1（剩 1=版本历史行内历史引文按纪律保留）；gdd_lint 5 不通过/doc_term 6 旗均与基线持平零新增
 2026-10-09 21:25:40 +08:00
DKChan 03c4b4c933 docs: 文档正确性审查批+去毒+命名统一+天赋树成文等十一批落籍（2026-10-09 用户令） 
一、里程碑语义立规：M3=Alpha 完整实现/M4=Beta 完整实现，未明令关闭 M3 前只排 M3 需求（roadmap M-4 节头立规注+M-3 节头口径指针+迭代 21+ 行注+06 倍率差条注）；迭代 20/21/22 规划冻结（roadmap 迭代 20 行注——先解决眼前问题，重启=用户直接发令）
二、文档正确性审查批三波：全 GDD 29 份过审——状态记录按代码证据订正/里程碑删前缀（M-x+迭代N→迭代N，裸 M-4→Beta 阶段（未排期））/退役词退役件当现役清零/在役旧实现节加隔离横幅；重件=秘宝.md v1.7 老正文深层清算（横幅重写消「过渡形态已退役」误读/沿革节换代/六件旧件登记摘除/验收与 charges 矛盾订正）+奇物 v3.8+冒险结构 v0.18+关卡节点地图 v1.7+图生成 v0.7+难度曲线与Boss v0.26+战斗结算 v0.27+敌人系统 v0.16+地图战斗资源 v0.21+增益状态 v0.13+战斗表现 v0.6+元进度 v1.9+生涯 v0.3+00 v1.3+02 v1.16+03 v1.1+ux 八份（battle 23 处/camp/shop/node-reward/level-clear/interaction-patterns/settlement-summary/level-map）
三、去毒批：奇物 v3.7（魔法道具→秘宝/档名三档→四级/门票与刷新「尚未入表」假话订正/验收第 3 条改令牌口径/资源成员指路凭证件表）+秘宝 v1.6（速览旧目录退役标注/退役件示例换现役）
四、道具退役素材库新建（design/research/道具退役素材库.md，案乙已追认）：秘宝退役 9 件含去向+专长退役 27 件名单+待核 4 行；魔法提灯（fog_lantern）裁退役（06 条目已裁+秘宝.md 注记换代+素材库迁表一；拆线归实装批）
五、B2/B3/B4 裁决落文：元进度.md 道具工坊行删旧写新（v1.10——旧六行登记作废、指路秘宝新目录+解锁门槛谓词分级）；奇物.md P1「两项合成高阶项」注销（v3.9——用户定性脏信息）；§3 刷新句按最新口径换代（刷新券替代、不进持有集）
六、天赋树独立成文（B1 裁决）：新建 design/gdd/systems/跨局循环/天赋树.md v0.1（33 节点机制全按 meta_tree.tres 实态+迭代 12 落籍裁决+被删底稿 git 取证——脊柱行门槛/钥石单币/Fork A/B 面/存档 v5 域/注入双通道）+元进度.md 定名节换代（v1.11）+02-系统清单跨局循环区加行（v1.17）
七、A 类卫生包：版本历史表理排四份（秘宝/奇物含 v2.7 断裂行修复/敌人系统/图生成，只调行序）+缺号注记三处（增益状态 v0.6 未考/冒险结构 v0.15/关卡节点地图 v1.6=MC-1 批）+node-reward v2.2 双号改 a/b+07 补建版本历史表+06 删「设置与本地化」空节+「文档/结构闸存量欠账」块挪文末「文档与结构」节+「L1 商店编排」两悬空指针改指 GP 换算失衡条+难度曲线两处过期指向核销注记（v0.27）+B5「现役 UI/文案两处自相冲突」登记 06 待办（battle_narrator.gd:160 旧话/hero_info_panel 两段同标「特性」——随后续迭代修）
八、命名统一（用户令「任务书」全库改「需求卡片」）：167 文件约 800 处（design/ 全部文档+roadmap+CLAUDE.md+active.md+entities.yaml+game/ 注释与数据批注）；两文件改名（需求卡片-M4数值批/需求卡片-冒险前资源配比预设批）；残留=自造短语全量清单（黑话证据文档故意跳过）
九、CLAUDE.md：批次工作流标准清单收口段新增第 12 条「文档同步闸」（需求卡片必列关联文档同步面、合并前同步完毕方算收口，原 12/13 顺延）；呈报六问铁规适用范围补立（前序批随批落籍）
十、active.md 快照节+工作日志 414-421（并行会话 416 黑话清扫条目按共享工作日志惯例一并入库）；06 中并行会话「active.md 定性与裁剪」条目未提交，按零吞并纪律留在工作区未入库

零测试（文档批两入口铁规）；主区前序脏件（.gitignore/.zcode/config.json/playnote/project.godot/.zcodeignore/美术审计报告 html 等）未带
 2026-10-09 19:12:46 +08:00
DKChan 7974e4a074 docs(architecture): 代码实现架构图 archify 交付——code-architecture HTML+可编辑 JSON 两件（showcase 9/9 闸 0错0警+三视口无溢出+视觉判官四轮收敛后 4/4 pass；节点=场景/autoload/视图/逻辑层 36 件全部实读自 game/ 工程，逻辑层 21 件仅列名；七条动作边含翻开·插旗·和弦→组合根→战斗编排器→结算回流主链；smoke 探针 13 场景不入图；单例层以裸节点+卡片承载语义） 2026-10-09 06:50:24 +08:00
DKChan 8e02dcf05b 清理: design/存量超期批——删86件（dev四组11+qa证据39=只留最新规首跑+research 34）+引用改写17处/15文件+doc-conventions §11新增证据只留最新（v13）+美术审计报告留置呈报（工作日志 413） 2026-10-09 03:58:50 +08:00
DKChan 442cd511a0 修复: design/结构批——diagrams 迁入 dev/architecture（案甲，熵增闸红灯清零）+旧档 GDD 引用全量摘除（31处/29文档+code/schema头注13文件+registry 5行）+doc双工具摘design/ux死路径（工作日志 412） 2026-10-09 03:29:09 +08:00
DKChan ffb0e36bcd docs: 另账修正批——悬空指路句13处+architecture旧API三处+06登记MC重锚（用户令『文档修改现在就修正』）——①docs/proposal-*两提案悬空引用13处（敌人系统4/战斗结算2/增益状态1/registry2/README2/unit_container/enemy_table/skill_table/smoke_all注释4处）改指路句〔提案已吸收退役git a6833b6a——事实源=敌人系统.md〕，系7f24b640三层收敛搬迁+a6833b6a死亡清单批漏改的登记遗留（7f24b640提交信息『余7条全为搬前幽灵链』）；②architecture.md活契约面三处旧API换代——:190调用序query_attack→apply_damage→advance改按摇定技能行兑现→apply_damage→commit_action+案C段内序、:152图示行stock/advance退役改伤害单据submit、:176 clear_inventory随库存轴下线退役改通关结算指路（:105/:222/:252系历史记录/已自带注记不动）；③06-待办清单新登记『旧行为MC行为锚全数作废——重锚归数值批』（用户确认系影响数值难度重要变量；归属M-4）；gdd_lint对基线零新增（8文件2存量） 2026-10-06 09:43:37 +08:00
DKChan dfd5fdd4df 秘宝批T2组C：architecture.md 两处既有断链清偿（../../design/gdd→../../gdd） 2026-10-05 08:27:11 +08:00
DKChan 430419cf01 消歧更名批：魔法道具 → 秘宝（仅文档层，代码零改动） 
用户拍板 2026-10-05。命名理由：「魔法」一词在本作已被征用为敌方侧
伤害/护甲语汇（magic_bolt 魔法矢 / magic_recoil 魔法反噬 / magic 魔法族
格面微光 / ward 魔法护甲），「魔法道具」易被读成"魔法属性的道具"；
「秘宝」取"神秘·强大·稀有"义，与九件内容气质（工兵/工程/手艺向）契合，
且与局内道具（奇物）不冲突。**同调位机制名保留不变**（attunement 仍为
DND 词，机制血统不受更名影响）。

改动面（26 个文件，仅 design/ 目录）：
- 正主重命名 systems/排雷循环/魔法道具.md → 秘宝.md，正文 17 处 + v0.9 版本行
- 称谓权威源 02-系统清单：文档树行 + 命名对照表 a5 行；英文代号
  AUXILIARY_ITEMS 沿用不变（代码标识符口径，另批对齐）
- registry/entities.yaml 30 处（referenced_by 九处 / owner 路径三处 /
  存档域注释 / 承重规则段）；文件头新增 2026-10-05 注记并还原
  2026-09-16 段旧名原文
- GDD 现行文档 16 个 + 美术 2 个 + 架构 1 个
- 历史定稿加名称已变更横幅（正文不改）：同调提案底稿（现行形态设计权威）、
  同调实施批任务书
- 修复 research 内 2 处指向旧文件名的活链接（历史文档不改称谓但链接须可达）

刻意保留旧名：8 处版本历史行 + 自造短语全量清单 16 处（出口即删的
中间审计底稿，改称谓会令统计失真）。

代码层零改动（用户明令），遗留欠债 4 项待可跑冒烟批次收口：
1. 代码标识符仍为 aux_* / AUXILIARY_ITEMS（auxiliary 词根为过渡形态遗留）
2. battle_narrator.gd:117-118 仍输出"魔法道具"，且与同文件 139 行
   arch_names["magic"]="魔法" 同屏两义共现——"魔法道具"进入玩家视野的
   唯一残余通道
3. bonus_interact_controller.gd:76 清空 toast 仍写"魔法道具"
4. Godot 类名与文件名（AuxItemTable 等）改需同步 .uid 与 .tscn 引用

校验：registry 键集合前后一致（214 键零丢失零新增，仅增 7 行注记）；
改动文件正文类零残留（残留 8 处全在版本历史/换名说明内）；owner 路径
全部可达；链接检查除 2 处既有欠债（architecture.md 的 ../../design/ 多一层，
改动前即存在）外零断链。

注：局内道具名「奇物」全仓 md 零命中，本批未碰，避免两个换名批纠缠。
 2026-10-05 06:50:44 +08:00
DKChan d8dc9b42a1 全局作用域变异首发批 T6 文档七正主（迭代14③号卡）：地形变异.md v0.7（类型清单+贫矿脉行/§全局作用域型语义节〔板级承载·替换制·兜底回落·恒定制·资源面偏斜·三层预告〕/「每图一型」板级推广/候选池门控第三维/布置段全局决议前置注记/调参表+验收/P1P2表Alpha行换代=撤2026-09-19留Alpha挂起/版本史+Q3知情代价注记）；难度曲线与Boss.md（P2全局投放计划行升级现行+调参表 resource_face 行=带A注册M-4禁独立调参）；registry=architecture.md variation 行换代（7行+三维门控+决议访问器）；HUD框架.md v0.13（义务来源清单+地形变异行三层预告+验收线）；教学引导.md v0.4（+Boss图整图变异说明行条目）；行动经济.md（P2地形成本修饰价目钩子=案D留位不启用注记）；06「全局作用域变异」条解决移除（去向=本批台账+git历史） 2026-10-04 17:52:50 +08:00
DKChan cc7952ce29 用语红线补强：自造词三形态禁令落文（2026-10-04用户令，黑话审计后——doc-conventions §4新增三种固定形态禁令表〔工作包代号/机制造词/流程造词，各带本仓反例与正确写法〕+通行检验标准+写后自查+v11版本历史；CLAUDE.md硬性红线新增用语红线一行） 2026-10-04 07:01:51 +08:00
DKChan 631b1dfe99 台账去压缩：废除active.md每条≤3行约束（2026-10-04用户立规「能看懂比字数少更重要」——doc-conventions §10改白话句子口径+第4节黑话禁令对台账同等生效+v10版本历史；CLAUDE.md会话进度记录行同步；起因=黑话审计证实≤3行压缩压力系自造缩略语繁殖地） 2026-10-04 06:56:08 +08:00
DKChan bd63a70754 docs: doc-conventions v9 新增§11文档生命周期吸收即死(2026-10-01用户立规)+CLAUDE.md硬性红线同款条目——中间文档寿命=迭代寿命/结论吸收进正主即删/未决先迁06与roadmap再死/永不入库/引用面口径/台账记结论/sim-data白名单/迭代出口清理项；顺手修文首与§10两处过期路径(docs/、production/)；三闸=基线零新增(死链增量3处系gitignored目标在fresh worktree不存在的环境差,06清单本批零改动) 2026-10-02 05:20:48 +08:00
DKChan 12e934be01 rulings: 试玩反馈两题裁决落文+doc-conventions 两条款成文——题一拍案甲视野迷雾（暗淡记忆态/半径8格同圈/提灯灯甲+微光不随扩/收窄后置）HUD框架「视野迷雾」正主节+v0.13；题二拍「不动」各案不采用留档；doc-conventions v8 增落位五要素+无正主不下定义+口径携带纪律 2026-09-30 06:59:44 +08:00
DKChan 24123616d8 feat(rng): 统一随机流批落地(ADR-0007 裁丙)——rng_service 七流并一+全事件日志:单盐单全局计数器+用途标签 open_stream(purpose) 不参与派生+derive_at(scope) 单参+事件日志会话制 rng_log_<seed>.jsonl;七消费点迁移+behavior_roll 子流派生向量退役(单敌轨迹独立复放面随退)+armor_roll_stream 降格纯标签;统一向量 8 常量重登记(scope0-3 与旧 board_gen 逐位连续);测试重锚(nat20/极性路由/L2max 改行为面扫描+ui_input_probe 移位扩边前置);冒烟 557/0+四探针全绿+MC20 局+日志落盘;数据配置 v0.5/registry 两实体/冒险结构 v0.10/节点图生成 v0.4 前置解除/ADR-0007 裁决落档+落地记录/CLAUDE.md 红线措辞/06 架构批条目解决移除 2026-09-27 20:01:29 +08:00
DKChan 137902fe92 design(node-map-gen): v0.3 ②③终裁落文+ADR-0007 评估书交付——②统一用一个流(两轮复裁终选,rng 架构批先行/特性排队,P0 补前置) ③特性内机制先行骨架随后;ADR-0007 核心发现=七流系同一主种子盐值分栏、字面目标现行已满足,待裁决=甲维持分栏/乙物理并流/丙并流+全事件日志(消费点七处+连带改动面清单在册);06 新立架构批条目 2026-09-27 17:23:05 +08:00
DKChan 7f24b640ea refactor: production 解散+docs 并入 design+tests 归 game 三层收敛——active.md/roadmap/stage/review-mode 升根目录;qa 报告→design/qa(gate-checks/alpha 验收/任务书→research);docs/→design/dev+registry 并档+散提案→research;tests/→game/tests(空架子 README+示例,真测试在 game/smoke);game/tools→tools+样例输出→sim-data;qa-data→sim-data;design/ux→gdd/ux;删 loop-dashboard.html(可再生成)+route_overlay_preview(零引用);钩子三件+loop_dashboard/balance_verifier/render_sample_sheet 路径随迁;断链修复 12 文件,余 7 条全为搬前幽灵链 2026-09-27 04:56:27 +08:00