Files
Genarrative/docs/technical/BIG_FISH_DIRECT_ROUTE_PLAYGROUND_2026-04-24.md

1.4 KiB

大鱼吃小鱼玩法直达路由说明

背景

现有前端已经包含 BigFishRuntimeShell,正式链路从创作中心或作品卡启动后端运行局。为了便于快速验收玩法手感,需要补一个不依赖后端会话的直达入口。

路由设计

  • /big-fish:进入大鱼吃小鱼玩法直达页。
  • 路由挂在 src/routing/appRoutes.tsx,与 /puzzle 一样走现有轻量路由解析层,不新增独立路由系统。
  • 每个玩法仅保留一个直达入口,避免 /play 这类重复路径造成维护分叉。

运行态边界

  • 直达页复用 BigFishRuntimeShell,不复制运行时 UI。
  • 初始快照由前端本地构造,背景使用内联 SVG 占位图。
  • 摇杆输入在本地推进角色位置、碰撞与成长等级,仅用于直达体验。
  • 该入口不改变正式 api-server 运行局、作品发布、资产生成和 SpacetimeDB 持久化链路。

验收口径

  1. 浏览器访问 /big-fish 后直接显示竖屏大鱼吃小鱼舞台。
  2. 屏幕任意位置按下并拖动可移动玩家实体。
  3. 玩家碰到不高于自身等级的实体后成长,并在事件日志显示成长结果。
  4. 左上返回按钮在直达页语义为退出到平台首页。
  5. 直达页通关或失败后,结算浮层继续复用正式运行态出口;失败态点击“重来”重开本地占位局,点击“退出”回到平台首页。