img2threejs Vibe 项目

一张图，AI给你跑出一套可动的3D资产

img2threejs是一个开源的AI图像转3D模型Skill，核心理念是用AI编程Agent把照片重建为纯代码的Three.js模型——不是生成mesh文件，不是photogrammetry，而是让Claude Code、Codex或OpenCode对着一张参考图，写出一段TypeScript代码，这段代码运行起来就是一个立体的、有比例的、可以旋转动画的Three.js 3D对象。

它的本质是一套AI驱动的分步雕刻流水线

img2threejs的工作方式是一系列质量门控的雕刻阶段：块面阶段、结构阶段、形态细化、材质阶段、表面阶段、光照阶段、交互阶段、优化阶段。每个阶段必须通过质量门，才能进入下一个阶段；模型tokens只在真正需要视觉判断的地方才被消耗。

具体来说，十个纯标准库的Python脚本负责所有机械性工作——验证输入图像是否合适、编写JSON规格文档、提取PBR材质参数、生成对比图、推进流水线状态。这些脚本从来不打分数，模型只需要做一件事：看一张并排对比图（原图+渲染结果），然后判断通过还是打回重做。

token效率是它的核心竞争力

传统image-to-3D Agent工作流容易陷入token内耗：让模型反复读取完整模型文件、核验JSON、手动重跑已有步骤。img2threejs把这一切全推给确定性脚本，模型tokens只花在真正需要判断力的地方。这是它自称token高效的原因。

生成结果不是二进制mesh文件，而是一段TypeScript工厂函数，返回一个THREE.Group，包含正确的runtime层级结构（pivot、socket、collider），直接可以挂动画。这段代码和JSON规格文件都可以用Git管理、code review、diff比较。

适用场景

网页3D展示：快速把产品图转成可交互的3D展示；小游戏资产生产：不需要建模基础，让AI帮你生成可动的游戏物件；电商展示：把产品照片变成立体可旋转的展示对象；AI视频素材：用Codex串联img2threejs做成完整生产线。

安装使用

在Claude Code中执行：/img2threejs Rebuild this object as a Three.js model, keep proportions, angles, and colours。完全开源（Apache-2.0），纯Python标准库，无任何pip依赖。