hoainho/img2threejs

Rebuild the object in a reference image as a code-only, procedural, quality-gated, animation-ready Three.js model. Token-efficient image-to-3D.

解决的问题

它解决了将单张参考图像转换为高质量、可进行动画处理的 3D 模型的困难。它不使用沉重的网格文件或摄影测量法，而是生成可以直接在 Web 浏览器中渲染的轻量级程序化代码。

工作原理

该项目使用分阶段雕刻流水线，其中 AI 代理（如 Claude Code）充当雕刻师。过程遵循严格的顺序：blockout、structural pass、form refinement、material pass、surface pass、lighting pass、interaction pass 和 optimization pass。每个阶段都由 Python 脚本把关，以根据参考图像验证工作成果。代理在进入下一阶段之前必须通过视觉审查（将侧向对比渲染图与原图进行比较）。这确保了最终输出是一个使用原语、程序化着色器和生成的几何体来构建对象的 TypeScript 工厂。

适用对象

游戏开发人员：正在寻找轻量级、基于代码的 3D 资产的人员。
Web 开发人员：需要无需大型文件下载即可进行动画处理的 Three.js 模型的人员。
AI 工程师：正在构建用于 3D 资产生成的代理工作流的人员。

亮点

令牌效率高的设计：使用确定性的 Python 脚本进行验证和记账，仅将昂贵的 LLM 令牌保留用于视觉判断。
动画就绪：生成包括轴心 (pivots)、插槽 (sockets) 和碰撞体 (colliders) 在内的运行时层级结构。
程序化重建：从代码（原语和着色器）重建对象，而不是提取网格。
代理无关性：通过基于技能的架构设计，旨在与各种 AI 编码工具和视觉模型协同工作。