docs(架构): v1.7 补修两处——①架构原则 1 残留英文层名 Core/Feature 改中文(核心层/功能层),与本文层名对照注记统一;②模块归属命名规约描述同步 code-conventions 文件头第三轮新规:头注禁写文档链接,「实现 GDD:xxx」一类已废止,代码↔设计追溯由 GDD 文档与 registry 承担。三闸全绿(gdd_lint 0 不通过/doc_link 死链 0/doc_term 疑似现行 0)

This commit is contained in:
DKChan committed 2026-10-16 02:28:10 +08:00
1 parent 86169065af
commit 175aa3f9ea
1 file changed
+4 -4
+4 -4
View File
@@ -2,8 +2,8 @@
## 文档状态
- 版本:1.6
- 最近更新:2026-10-15(①废除历史决策文档体系:七份决策文件删除(沿革归 git commit log),原审计与立项两节移除,全部在效事实并入本文;②「测试与质量域」节改纯事实陈述;③现状同步:autoload 清单补 SaveManager/MetaProgression,A1 生成姿态与事件载体事实登记,未决问题表已落定项关闭)
- 版本:1.7
- 最近更新:2026-10-16(④架构原则层名中文化补漏——原则 1 残留 Core/Feature 英文层名改中文;⑤模块归属命名规约描述同步 code-conventions 文件头新规——头注禁写文档链接,「实现 GDD:xxx」一类已废止)
- 引擎:Godot 4.7.2-stable(GDScript 单语言;2026-09-07 锁定)
- 评审模式:solo(`review-mode.txt`,2026-09-12 用户拍板——TD/LP 门禁按 solo 跳过,用户授权架构产出自主推进、迭代期回调)
- 覆盖 GDD:现行全集——`design/gdd/` 顶层 00–08 共 9 件 + `systems/` 五域 25 件(排雷循环 4 / 战斗循环 5 / 冒险循环 5 / 跨局循环 5 / 表现与支撑 6)+ `ux/` 8 件;原英文命名 12 份系统 GDD 已全部迁入中文域目录,原「未设计」预留(A5 扫雷秘宝 / C1–C4 / B5 / D3–D6)均已立项成文
@@ -84,7 +84,7 @@
## 模块归属
> 命名遵循 `design/dev/code-conventions.md`:领域命名、禁 ID 前缀、头注溯源行(实现 GDD:design/gdd/…)。切片已按此规范完成领域命名批。
> 命名遵循 `design/dev/code-conventions.md`:领域命名、禁 ID 前缀(文件头注不写文档链接——「实现 GDD:xxx」一类已废止,代码↔设计追溯由 GDD 文档与 registry 承担)。切片已按此规范完成领域命名批。
### 基础层
@@ -260,7 +260,7 @@ D1 ◀──呈现数据源:A2 事件流 / B1 步骤流 / A3 ap-rap / ConfigDB
## 架构原则
1. **Core 纯逻辑、headless 完整可跑**——Core/Feature 玩法逻辑零 Control/场景引用、零 UI 依赖;`--headless --script` 可跑完整战斗(D2 Rule 7 工程债;切片 88 冒烟实证)。输入是意图对象、输出是事件流/步骤流,D1 与输入设备皆可替换。
1. **核心层纯逻辑、headless 完整可跑**——核心层/功能层玩法逻辑零 Control/场景引用、零 UI 依赖;`--headless --script` 可跑完整战斗(D2 Rule 7 工程债;切片 88 冒烟实证)。输入是意图对象、输出是事件流/步骤流,D1 与输入设备皆可替换。
2. **单一事实源与零字面量**——玩法数值只存在于 `data/tables/*.tres`,经 ConfigDB 类型化单点读取;代码零玩法数值字面量;参数禁止跨系统复制(D2 Rule 1/2)。
3. **封闭 RNG 与可回放**——玩法代码零随机;一切随机经 RngService 具名封闭流(增流走 P1 评审);同种子 + 同输入序列 ⇒ 事件流/步骤流逐位相同(结算禁 await,B1 承重约束)。
4. **编排唯一性与事件面封闭**——战斗域跨系统调用权集中 B1(静态扫描承载);A2 三事件面封闭即负空间;每格受理、每雷转化、每次推进、每次衰减各恰一次。