v3.2.8 — 文生3D 接入（M1：Hyper3D 云端 + 本地开源 Hunyuan3D-2）
背景
结合开源 Blender MCP 项目（见 docs/BLENDER_MCP_INTEGRATION.md）的 M1 方案：为「生成飞机」等需求提供云端文生3D 能力，并补齐免费本地替代，使「文生3D」在无付费 Key 时仍可零成本使用。
新增能力
- 云端文生3D：
runHyper3DTextTo3D调用 Hyper3D(Rodin) text-to-3d，新增POST /api/text-to-3d路由（复用/api/split的二进制 + manifest 响应格式）。 - 本地开源文生3D（免费）：新增
scripts/hunyuan3d_text_infer.py，调用腾讯开源 Hunyuan3D-2（hy3dgen）本地生成 GLB；runLocalTextTo3D负责 spawn 与结果回收。 - 智能回退：
handleTextTo3D支持mode=auto|cloud|local；auto默认有 Hyper3D Key 走云端，否则回退本地 Hunyuan3D-2。 - 前端：AI 绘画面板新增「🌐文生3D」按钮 + 提供方模式下拉（自动/云端/本地），复用现有加载与拆解流程（生成后点「爆炸」即可拆解）。
测试
tests/provider-test.mjs新增runHyper3DTextTo3D成功路径、空提示词 400、缺 Key 400 三个用例。- Node 测试 32/32 通过（含新增用例）。
- 本地推理脚本错误守卫验证：未装 hy3dgen 时返回清晰安装引导，退出码 1。
- 端到端链路验证（本机无 GPU）：
POST /api/text-to-3d?mode=local正确走到本地脚本并返回清晰错误 JSON。 - 注：本机为 macOS 无 NVIDIA GPU，未做「成功生成」实测；需在带 CUDA 的机器
pip install hy3dgen后验证真实生成。
验证
- 语法检查通过（server.js / ai-paint-panel.js / hunyuan3d_text_infer.py）。
- markdownlint 对涉及文档校验通过。