feat: add shared runtime input device layer

docs/technical/PUZZLE_RUNTIME_FRONTEND_LOGIC_REHOME_2026-05-02.md

@@ -23,6 +23,9 @@
 7. 当前作品没有下一关时，通关弹窗展示后端 handoff 返回的相似作品；用户点击具体候选作品时直接 `startPuzzleRun(profileId, null)`，从目标作品第 `1` 关重新开始。
 8. 失败状态点击“重新开始”时，正式 run 使用当前关 `levelId` 重新 `startPuzzleRun`，草稿/本地 run 使用本地重建，二者都保留当前失败关卡。
 9. 结果页草稿试玩没有正式后端 run 时，继续使用本地 run、local leaderboard 和本地下一关兜底。
+10. 运行态输入采用全项目通用的 `src/services/input-devices/` 抽象层承接，指针、触控、mocap 等设备都先归一为 `press / move / release / tap / drop` 拖拽语义，再由拼图运行态解析具体拼块和落点。
+11. mocap `grab` 不是点击选中语义，而是持续拖拽语义；松手时按当前棋盘归一坐标提交 drop。合并大块只需要提交其中任一成员拼块 `pieceId`，本地拼图运行时会按 `mergedGroupId` 解析整组平移。
+12. 拼图作品详情或开局遇到后端 `404 / NOT_FOUND / 资源不存在` 时，平台入口不再停留在空详情或运行态错误页，而是清理当前拼图详情/run 状态并返回首页。
 
 ## 工程落点
 
@@ -38,6 +41,15 @@
 3. `src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx`
    - 公开拼图玩法交互测试断言前端本地交换函数被调用。
    - 同时断言后端 `swap / drag` 不参与棋盘交互，后端 `leaderboard / next-level` 继续参与非即时链路。
+4. `src/services/input-devices/`
+   - `runtimeDragInputController` 提供设备无关的拖拽会话状态机。
+   - `runtimeInputGeometry` 提供屏幕坐标、归一坐标和网格命中的通用转换能力。
+   - 玩法组件只传入“这个点对应哪个目标”和“drop 到哪个目标”的玩法解释，不在输入层写拼图专用规则。
+5. `src/components/puzzle-runtime/PuzzleRuntimeShell.tsx`
+   - 鼠标/触控与 mocap 共用同一个 runtime drag controller。
+   - 合并块成员不再被 mocap 路径过滤；mocap 可从合并块任一占用格抓取，并复用本地运行时的大块拖拽规则。
+6. `src/components/platform-entry/PlatformEntryFlowShellImpl.tsx`
+   - `openPuzzleDetail`、`openPuzzlePublicWorkDetail`、`startPuzzleRunFromProfile` 对拼图作品缺失统一回首页。
 
 ## 边界