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 旗均与基线持平零新增
This commit is contained in:
DKChan committed 2026-10-09 21:25:40 +08:00
1 parent 03c4b4c933
commit bbc849eac5
18 files changed
+91 -61

No files matched your search

+8 -1
View File
@@ -136,7 +136,7 @@
## 6. 流程纪律
1. **大改动三段走**:设计稿/伪代码 → 用户审阅 → 实现 → 修改记录(README + session-state)。实现不得先于审阅。
2. **实现批收尾双登记**:切片 README 修改记录 + `production/session-state/active.md` 条目,缺一不可。
2. **实现批收尾双登记**:切片 README 修改记录 + 根目录 `active.md` 条目(会话状态唯一状态源——2026-10-09 定性,路径自 production/session-state/ 迁根目录),缺一不可。
3. **规范变更必须成文进本文件**——发现未成文约定、或用户裁决产生新规则,当场补条文。
4. **呈现层缺陷的教训回写 D1 GDD 设计输入**(信号载荷 schema / 场景级测试 / 时点状态可见性)。
@@ -153,3 +153,10 @@
| 上帝对象 | main.gd ~1100 行 | 职责无边界持续堆积 | 1.1–1.3 |
| ID 前缀命名 | a1_/b1_ 与领域命名并存 | 事实约定未成文 | 1.4–1.5 |
| 可选类每关 24.8 件 | 速杀退化、囤刀秒 Boss | 单尺度校准未做跨尺度推演 | 5.3 |
## 版本历史
| 版本 | 日期 | 说明 |
|---|---|---|
| v1 | 2026-09-11 | 首版成文(垂直切片评审用户逐一指出,全部附真实反面案例) |
| v2 | 2026-10-09 | 文档正确性审查批·独立复核(worktree docaudit-2026-10-09):§6 流程纪律第 2 条「production/session-state/active.md」过期路径改「根目录 active.md」(会话状态唯一状态源,2026-10-09 用户定性为状态文件并迁根目录);本表系本批补建 |