Update Match3D/image-generation docs & code

Adds/updates documentation, assets and implementation for Match3D and puzzle image generation workflows. Key changes: decision logs and pitfalls updated to prefer VectorEngine Gemini for Match3D material sheets and to require edits (multipart) for 1:1 container reference images; guidance added for when to use APIMart vs VectorEngine. .env.example clarified APIMart/Responses config. Many new public assets and PPT visuals added. Code changes across frontend and backend: updated shared contracts, server-rs match3d/puzzle/image-generation handlers, VectorEngine/OpenAI image generation clients, and multiple React components/tests to handle UI/background/container image signing, edits workflow, and puzzle UI background resolution. Added src/services/puzzle-runtime/puzzleUiBackgroundSource.ts and related test updates. Includes notes about multipart HTTP/1.1 requirement and test/verification commands in docs.

docs/technical/RUNTIME_INPUT_DEVICE_ABSTRACTION_2026-05-10.md

@@ -19,18 +19,18 @@
 
 `useMocapInput` 解析 mocap `hands[].landmarks` 时应优先用 MediaPipe 21 点里的 `wrist / index_mcp / middle_mcp / ring_mcp / pinky_mcp` 加权计算掌心派生点；少于 3 个掌心关键点时才回退到 `wrist` 或直出 `hand.x/y`。这样运行态光标不会直接贴在腕部或指尖。
 
-拼图运行态已接入该层：
+2026-05-14 临时关闭：拼图运行态不再调用 `useMocapInput`，也不渲染 mocap 光标或调试面板。`src/services/input-devices/` 仍保留为鼠标 / 触控等输入的统一拖拽状态机；mocap 解析能力继续供儿童动作 Demo 和宝贝识物等明确需要体感输入的玩法使用。
+
+拼图运行态当前接入该层：
 
 - 鼠标/触控 `pointerdown / pointermove / pointerup` 进入同一个 drag controller。
-- mocap `grab` 进入同一个 drag controller，并强制使用持续拖拽语义。
-- mocap 光标按 60Hz 插值更新 UI 位置，并在拖拽中用插值后的当前点持续驱动输入层，避免输入包帧率低或抖动时出现明显跳变。
-- 合并大块由拼图运行态把手部坐标命中到任一成员拼块；本地拼图运行时再按 `mergedGroupId` 执行整组平移。
+- 合并大块由拼图运行态把指针坐标命中到任一成员拼块；本地拼图运行时再按 `mergedGroupId` 执行整组平移。
 
 ## 调试模式
 
 前端全局调试模式统一通过 `src/config/debugMode.ts` 判断。默认跟随 Vite 开发态：`import.meta.env.DEV` 为真时开启，生产构建默认关闭；如需显式覆盖，可设置 `VITE_DEBUG_MODE=true` 或 `VITE_DEBUG_MODE=false`。
 
-拼图运行态的 mocap 调试面板只在全局调试模式下渲染。面板默认折叠，只保留一行连接状态，展开后才显示动作、手势、解析告警和原始包预览，避免开发诊断信息遮挡拼图棋盘和底部操作。
+拼图运行态不再渲染 mocap 调试面板。需要排查 mocap 数据源时，应在仍消费 `useMocapInput` 的儿童动作 Demo 或宝贝识物运行态中验证数据链路。
 
 ## 接入规则
 
@@ -40,7 +40,7 @@
 2. 设备适配层只负责把原始输入转换成通用输入事件。
 3. 玩法壳层负责从通用输入点解析本玩法目标，例如拼块、洞口、角色或实体。
 4. 玩法壳层负责决定 drop 后调用哪个本地运行态函数或后端接口。
-5. 需要取消输入时优先按 `inputId` 取消，避免 mocap 丢帧误伤正在进行的鼠标/触控会话。
+5. 需要取消输入时优先按 `inputId` 取消，避免某一输入设备误伤正在进行的鼠标/触控会话。
 
 ## 验证