img2threejs Vibe 项目

img2threejs 是一个开源的 AI 驱动 3D 建模工具，它的核心理念是「Reconstruction by code, not by mesh」——不给网格文件，直接给你代码。

用户只需上传一张物体的参考图，img2threejs 就会通过 AI Agent（Claude Code / Codex / OpenCode 均可）分析图片内容，然后分阶段生成一段 TypeScript 写的 THREE.Group 工厂函数。这段代码可以在浏览器里直接运行，渲染出该物体的 3D 模型——可旋转、可动画、可改参数、可接入业务逻辑。

与传统的「图片→生成黑盒 3D 文件」（GLB/OBJ/FBX）不同，img2threejs 生成的是纯代码，天然支持 Git 版本控制，可以 diff、可以 code review、可以改参数继续生成变体。模型自带骨骼级层级结构（pivot、socket、collider），可直接加动画。

技术实现上，Pipeline 分 8 个阶段递进：blockout → structural → form-refinement → material → surface → lighting → interaction → optimization，每阶段 AI 自我视觉审核，通过才进入下一阶段。Python 标准库做验证脚本，Token 只花在视觉判断和代码生成上，效率极高。

适用场景：电商 3D 商品展示、游戏道具原型、网页 3D 交互、教育可视化、数字展厅等，尤其适合需要快速生成 3D 资产又不希望碰 Blender 的前端开发者。当前版本 v1.5，Apache 2.0 开源。