文档:补全 CLAUDE.md 文档索引并清理失效引用

- CLAUDE.md:编号 01→05/04 修正为 01→06/04,补三套文档优先级
  (硬红线以 dev-guide 为准)与「编号↔主题」对照表
- client README 阅读顺序表补上遗漏的 06 子游戏接入模式与Hooks外置
- 修正 README 及正文交叉链接的旧路径(server/docs、client/docs、
  docs/engineering → docs/{server,client,games/engineering},
  相对层级 ../../../ → ../../),共 7 处
- engineering 文档移除对已删除路径(docs/architecture、
  .github/copilot/skills)的引用,改为通用表述

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-07-05 23:15:39 +08:00
co-authored by Claude Opus 4.8
parent ae43bd528f
commit 182bb03d05
8 changed files with 22 additions and 15 deletions
+9 -1
View File
@@ -84,7 +84,15 @@ server/<游戏容器目录>/<游戏>/ ← 子游戏接入后**唯一
### 文档(改动前先读)
`docs/client/development-guide/`与`docs/server/development-guide/`(按 01→05/04 编号)是本项目遵循的权威、项目专属开发指南——改哪块就读对应编号的文档,而不是从代码反推约定。`docs/games/engineering/` 是位于两者之上的、与平台无关的工程方法论层(单一权威数据源 SSOT、单向依赖、职责单一、对扩展开放对修改封闭 OCP、配置优先于硬编码、显式失败优于隐式兜底)。
`docs/client/development-guide/`(01→06)与 `docs/server/development-guide/`(01→04)是本项目遵循的权威、项目专属开发指南——改哪块就读对应编号的文档,而不是从代码反推约定。`docs/games/engineering/`(01→03)是位于两者之上的、与平台无关的工程方法论层(单一权威数据源 SSOT、单向依赖、职责单一、对扩展开放对修改封闭 OCP、配置优先于硬编码、显式失败优于隐式兜底)。**三者互补不冲突:engineering 讲「该怎么设计、怎么长久演进」,dev-guide 讲「平台怎么接、红线是什么」;ES5/`require` 守卫/可编辑范围/`data.success` 等硬红线冲突时一律以 dev-guide 为准。**
各编号对应主题(改哪块查哪篇):
| 文档 | 编号与主题 |
|---|---|
| `client/development-guide/` | 01 前端架构与运行环境 · 02 渲染与UI组件体系 · 03 事件·动画·音频·Spine · 04 网络对接与启动编排 · 05 开发规范与红线 · 06 子游戏接入模式与Hooks外置 |
| `server/development-guide/` | 01 服务端环境与框架基础 · 02 子游戏接入与开发流程 · 03 数据收发与通信协议 · 04 开发规范与红线 |
| `games/engineering/` | 01 架构总则与分层 · 02 可扩展性与配置化 · 03 数据权威·错误处理·演进 |
两套文档中反复强调的硬性规则(文档记载均对应过真实事故):
- 全面严格 ES5(`var`/`function`,继承用 `Object.create`;禁止 `let/const`/箭头函数/模板字符串/`class`/解构/`Promise`)。