| name | hunyuan-3d |
| description | Generate PBR meshes (Hunyuan 3D Pro) for Canvas Studio chapters only. Use when presentation is studio and subjects need realistic 3D. Studio chrome lives in ui-studio-style — this skill owns mesh generation only. |
hunyuan-3d
Produce a GLB (or batch of GLBs) for the studio stage. Soft-fail to procedural geometry.
UI chrome: follow skills/ui-studio-style/ (editorial specimen-explorer shell). Do not invent a separate layout.
When
presentation: studio only — never call generate_mesh for page/slide lessons (cost gate)viz-engineer / mesh role during asset_plancapsule-author embeds mesh(es) inside the clipped studio stage canvas
Steps
- Prompt — educational, single centered object, PBR, no text overlays
- Optional image-to-3D —
get_media().generate_image, then generate_mesh(image_url=...) for complex detail
- Mesh tool —
generate_mesh(prompt=..., enable_pbr=true, face_count=150000) via providers.registry.get_mesh()
- Embed in studio shell:
<canvas id="studio-canvas" width="640" height="420"></canvas>
<div data-mesh-src="/build/mesh/model.glb" data-mesh-canvas="studio-canvas" hidden></div>
- Multi-subject catalogs —
propose_studio_subjects + run_studio_mesh_catalog build a sidebar catalog; up to MESH_STUDIO_MAX_HUNYUAN (default 3) use Hunyuan, the rest procedural. Wire SUBJECTS[id].meshSrc and swap via __hitutoReloadMesh.
Do not
- Start a second Three.js loop when
data-mesh-src is present (mesh runtime owns the canvas)
- Invent OrbitControls CDN / ES modules
- Mix studio tokens with cobalt paper theme
- Generate Hunyuan meshes outside studio presentation
Soft-fail
Missing mesh credentials (TENCENTCLOUD_SECRET_ID/KEY preferred; GMI/Atlas are optional fallbacks), API errors, or timeouts must not fail the lesson — procedural abstract fallback inside the clipped stage.
