img2threejs：一种使用仅代码几何体从参考图像重建对象的程序化 Three.js 模型生成器

它解决的问题

img2threejs 将单张对象、角色或生物的参考图像转换为程序化 Three.js 模型。不同于摄影测量或网格提取，它使用基元和着色器生成仅代码模型，确保结果轻量、可直接动画，并可在浏览器中直接运行，无需外部网格文件或美术包。

它是如何工作的

该项目采用分阶段雕刻流水线，将图像转化为技术规范，然后通过多个阶段迭代构建模型：块体、结构、形态、材质、表面、光照、交互和优化。

它被设计为与代理无关，可在 Claude Code、Codex、OpenCode 等 AI 编码代理中运行。流水线使用确定性的 Python 脚本进行验证和质量把关，而 AI 代理负责视觉判断和代码生成。对于角色，它采用解剖学感知的轨道，使用参数化模板和标记点拟合，以最大化相似度。

适用对象

需要快速从图像生成基于浏览器的 3D 资产的开发者和 3D 艺术家，尤其是希望使用程序化、代码驱动几何体而非静态网格的用户。

亮点

• 仅代码重建：生成 TypeScript 工厂函数，从基元和程序化着色器创建模型。
• 可直接动画：生成包含枢轴、插槽和碰撞体的运行时层级结构，可立即进行动画。
• 细节优先分析：使用严格的质量门，在生成开始前要求完整列出定义身份的细节（如倒角、铆钉和磨损）。
• 特定主题流水线：包括硬表面对象、人形角色和生物（四足、鸟类等）的专用轨道。
• 详细审查门：实施严格检查，包括 CS2 特定的武器合约和 CIEDE2000 颜色计算以确保准确性。