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