Split game module documentation

game/docs/modules/README.md

@@ -0,0 +1,25 @@
+# Game Modules
+
+本目录按游戏源码模块拆分说明文档。查具体代码时优先从这里进入；跨模块路线、阶段计划和验收流程仍放在 `../planning/`、`../game_skeleton.md` 和 `../scene_acceptance.md`。
+
+## 模块索引
+
+- `core_services.md`：游戏启动、`GameServices`、资源路径、基础配置。
+- `assets.md`：全局资源槽位、角色资源优先级、地图和 stage 资源落位。
+- `data_map.md`：`LevelDefinition`、`.map` 加载、地图数据格式。
+- `stage_rendering.md`：`StageRenderer`、场景分层、贴图/色块 fallback。
+- `scene_camera.md`：`WhiteboxScene`、摄像机跟随、battle zone 锁镜头。
+- `movement_collision.md`：`PlatformWorld`、`PlatformMover`、横版基础碰撞。
+- `actor_player.md`：`PlayerActor`、玩家状态、动画和音效触发。
+- `input.md`：`InputState`、PC/Switch 输入语义和后续配置计划。
+- `ui_overlay.md`：`GameUiOverlay`、`UIScene`、`TextSprite` 和 fallback UI。
+- `audio_save.md`：`GameAudio`、`GameSave`、音频 cue 和 debug 存档。
+- `debug_tools.md`：`DebugOverlay`、调试开关、可视化范围。
+- `combat.md`：当前 hitbox 预留和后续战斗模块拆分方向。
+
+## 维护规则
+
+- 新增源码模块时，同步新增或更新本目录对应文档。
+- 单个模块文档只写模块职责、入口文件、数据流、当前状态和下一步。
+- 跨模块验收结果写到 `../scene_acceptance.md`。
+- 长期计划写到 `../planning/`，不要塞进模块文档。