Add Switch game framework target

game/docs/ARCHITECTURE.md

@@ -21,6 +21,7 @@ game/
    ├─ movement/         可复用的移动和碰撞辅助工具
    ├─ scene/            游戏场景和关卡编排
    ├─ stage/            关卡视觉层渲染
+   ├─ switch_game_main.cpp Switch/NS 游戏入口
    └─ main.cpp          游戏可执行文件入口点
 ```
 
@@ -99,8 +100,8 @@ main.cpp
 
 ## 当前构建目标
 
-`xmake.lua` 为 Windows 定义 `Frostbite2DGame`。它编译所有
-`game/src/**.cpp` 文件，链接到 `Frostbite2D`，并在构建后
+`xmake.lua` 为 Windows 定义 `Frostbite2DGame`。它编译桌面游戏入口
+`game/src/main.cpp` 和所有通用游戏源码，链接到 `Frostbite2D`，并在构建后
 将 `game/assets` 复制到可执行文件旁边。
 
 构建命令：
@@ -115,6 +116,29 @@ xmake -b Frostbite2DGame
 build/windows/x64/release/Frostbite2DGame.exe
 ```
 
+Switch/NS 游戏框架目标为 `Frostbite2DGameSwitch`。它使用
+`game/src/switch_game_main.cpp` 作为平台入口，复用同一套 Scene、Stage、
+Actor、Movement、Debug 和 Data 模块。
+
+构建命令：
+
+```powershell
+xmake -b Frostbite2DGameSwitch
+```
+
+输出：
+
+```text
+build/switch/aarch64/release/Frostbite2DGame.elf
+build/switch/aarch64/release/switch_game/NSUnknownGame.nro
+```
+
+Switch 运行时资源目录：
+
+```text
+/switch/Frostbite2D/NS Unknown Game/assets
+```
+
 ## 后续架构步骤
 
 1. 添加 `actor/enemy_actor.*` 并复用 `PlatformMover`

game/docs/GAME_ARCHITECTURE_BOARD.md

@@ -77,6 +77,7 @@ mindmap
       Hitbox可视化
       帧率与日志
       构建文档
+      NS平台构建
 ```
 
 ## 白板总览
@@ -295,6 +296,26 @@ mindmap
 - 绘制 hitbox / hurtbox。
 - 输出当前场景、角色状态、FPS。
 
+### 11. Platform
+
+职责：
+
+- 保持 PC 和 NS 共用游戏逻辑。
+- 只在入口、构建、资源部署、平台输入处做差异化。
+
+已有：
+
+- `game/src/main.cpp`：Windows/PC 游戏入口。
+- `game/src/switch_game_main.cpp`：Switch/NS 游戏入口。
+- `Frostbite2DGame`：Windows 游戏目标。
+- `Frostbite2DGameSwitch`：Switch 游戏目标，生成 `NSUnknownGame.nro`。
+
+下一步：
+
+- 将 Switch Joy-Con 输入接入 `InputStateProvider`。
+- 整理资源部署脚本，把 `assets` 放到 `/switch/Frostbite2D/NS Unknown Game/assets`。
+- 在 Ryujinx 或真机上验证主循环、shader 和角色纹理。
+
 ## 数据流白板
 
 ```text
@@ -380,10 +401,11 @@ mindmap
 下一步建议按这个顺序做：
 
 1. `BattleZone`：做清版推进的核心框架。
-2. `EnemyActor`：做第一个敌人占位。
-3. `CombatSystem`：把 hitbox/hurtbox 真正跑起来。
-4. `SpriteAnimator`：把玩家动画从硬编码改成组件。
-5. `StageLayer`：把白盒视觉层扩展为背景、tiles 和 props。
+2. `SwitchInput`：把 Joy-Con/手柄输入接入 `InputStateProvider`。
+3. `EnemyActor`：做第一个敌人占位。
+4. `CombatSystem`：把 hitbox/hurtbox 真正跑起来。
+5. `SpriteAnimator`：把玩家动画从硬编码改成组件。
+6. `StageLayer`：把白盒视觉层扩展为背景、tiles 和 props。
 
 ## 素材协作提示