27 lines
1.2 KiB
Markdown
27 lines
1.2 KiB
Markdown
# 拼图玩法直达路由说明
|
||
|
||
## 背景
|
||
|
||
现有前端已经包含拼图运行时组件 `PuzzleRuntimeShell` 和本地运行时 `puzzleLocalRuntime`，但只能从平台创作中心、作品卡或拼图广场链路间接进入。为了快速验证玩法交互，需要补一个可直接打开的前端路由。
|
||
|
||
## 路由设计
|
||
|
||
- `/puzzle`：进入拼图玩法直达页。
|
||
- 路由挂到现有 `src/routing/appRoutes.tsx` 的轻量路由解析层，不引入 React Router，也不新增独立路由系统。
|
||
|
||
## 运行态边界
|
||
|
||
- 直达页复用 `PuzzleRuntimeShell`，不复制棋盘 UI。
|
||
- 初始关卡通过 `startLocalPuzzleRun` 生成，图片使用内联 SVG 占位图。
|
||
- 交换、拖动、重开均走 `puzzleLocalRuntime`，保持与现有前端玩法实现一致。
|
||
- 该入口仅用于直达体验和调试，不改变已发布拼图作品、Agent 创作、拼图广场和后端持久化链路。
|
||
|
||
## 验收口径
|
||
|
||
1. 浏览器访问 `/puzzle` 后直接显示全屏拼图画布。
|
||
2. 棋盘应显示占位图切片，而不是空白格。
|
||
3. 点击两块拼图可以交换；拖动拼图到目标格可以交换位置。
|
||
4. 左上返回按钮在直达页语义为重开当前占位关卡。
|
||
|
||
|