拼图

docs/technical/BIG_FISH_DIRECT_ROUTE_PLAYGROUND_2026-04-24.md

@@ -0,0 +1,25 @@
+# 大鱼吃小鱼玩法直达路由说明
+
+## 背景
+
+现有前端已经包含 `BigFishRuntimeShell`，正式链路从创作中心或作品卡启动后端运行局。为了便于快速验收玩法手感，需要补一个不依赖后端会话的直达入口。
+
+## 路由设计
+
+- `/big-fish`：进入大鱼吃小鱼玩法直达页。
+- 路由挂在 `src/routing/appRoutes.tsx`，与 `/puzzle` 一样走现有轻量路由解析层，不新增独立路由系统。
+- 每个玩法仅保留一个直达入口，避免 `/play` 这类重复路径造成维护分叉。
+
+## 运行态边界
+
+- 直达页复用 `BigFishRuntimeShell`，不复制运行时 UI。
+- 初始快照由前端本地构造，背景使用内联 SVG 占位图。
+- 摇杆输入在本地推进角色位置、碰撞与成长等级，仅用于直达体验。
+- 该入口不改变正式 `api-server` 运行局、作品发布、资产生成和 SpacetimeDB 持久化链路。
+
+## 验收口径
+
+1. 浏览器访问 `/big-fish` 后直接显示竖屏大鱼吃小鱼舞台。
+2. 左下摇杆可移动玩家实体。
+3. 玩家碰到不高于自身等级的实体后成长，并在事件日志显示成长结果。
+4. 左上返回按钮在直达页语义为重开当前占位局。