Files
Genarrative/docs/technical/PUZZLE_DIRECT_ROUTE_PLAYGROUND_2026-04-24.md
kdletters cbc27bad4a
Some checks failed
CI / verify (push) Has been cancelled
init with react+axum+spacetimedb
2026-04-26 18:06:23 +08:00

1.2 KiB
Raw Permalink Blame History

拼图玩法直达路由说明

背景

现有前端已经包含拼图运行时组件 PuzzleRuntimeShell 和本地运行时 puzzleLocalRuntime,但只能从平台创作中心、作品卡或拼图广场链路间接进入。为了快速验证玩法交互,需要补一个可直接打开的前端路由。

路由设计

  • /puzzle:进入拼图玩法直达页。
  • 路由挂到现有 src/routing/appRoutes.tsx 的轻量路由解析层,不引入 React Router也不新增独立路由系统。

运行态边界

  • 直达页复用 PuzzleRuntimeShell,不复制棋盘 UI。
  • 初始关卡通过 startLocalPuzzleRun 生成,图片使用内联 SVG 占位图。
  • 交换、拖动、重开均走 puzzleLocalRuntime,保持与现有前端玩法实现一致。
  • 该入口仅用于直达体验和调试不改变已发布拼图作品、Agent 创作、拼图广场和后端持久化链路。

验收口径

  1. 浏览器访问 /puzzle 后直接显示全屏拼图画布。
  2. 棋盘应显示占位图切片,而不是空白格。
  3. 点击两块拼图可以交换;拖动拼图到目标格可以交换位置。
  4. 左上返回按钮在直达页语义为重开当前占位关卡。