Commit Graph
7 Commits
Author SHA1 Message Date
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 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 74f97231fd docs(dev+gdd): 测试函数落码规范落 code-conventions §3.5 + 术语表开发流程两词条(逻辑验收方法论批,2026-10-11 用户裁) 2026-10-11 18:42:01 +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 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 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