告别手动3D建模！img2threejs单图生成3D代码模型，效率翻倍！

告别手动3D建模！img2threejs单图生成3D代码模型，效率翻倍！

🚀 核心亮点：告别传统网格文件

• 代码即模型：它不依赖传统的摄影测量（Photogrammetry）或神经网格提取，而是让 AI 分析图片后，用 Three.js 的基础几何原语（Box、Cylinder、Extrude 等）程序化地组合拼装出目标物体。
• 极致轻量与可编辑：最终产物是纯 TypeScript 代码（通常仅 5-50 KB），无需加载庞大的 .glb 或 .obj 文件。代码完全可编辑、可 Diff、自带层级结构，且原生支持动画挂载点（Socket/Pivot）。
• 零依赖运行：整个工具链仅需 Python 3.10+ 标准库，无需安装 npm 包或额外依赖，克隆代码即可运行，避免了环境冲突问题。

⚙️ 工作原理：分阶段雕刻与视觉门禁

• 8阶段流水线：模型生成需经过 8 个严格的 Pass（大体轮廓 → 结构细化 → 形体精修 → 材质贴合 → 表面细节 → 光照 → 交互 → 性能优化）。
• 视觉审核机制：每个阶段完成后，系统会在浏览器中渲染当前模型，并截取真实渲染图与参考原图进行并排对比。AI Agent 会进行视觉评分，只有达标才能解锁下一阶段，不达标则自动修正代码或规格，确保最终效果。

🎮 最佳适用场景与局限

• 擅长领域：目前最擅长硬表面物体（如耳机、武器、刀具、机械载具、宝箱等），结构清晰、边缘可读的物体效果最佳。非常适合网页 3D 展示、浏览器游戏原型和程序化资产系统。
• 当前局限：由于单张参考图存在视角盲区，背面的结构靠 AI 推测；此外，它本质上是“风格化重建”，目前不太适合写实人物面部、大型建筑群或需要精确尺寸的工程模型（相关功能正在 v1.5 及后续版本规划中）。

💻 快速上手指南

1. 安装：将项目克隆到本地（以 Claude Code 为例：git clone https://github.com/img2threejs/img2threejs.git ~/.claude/skills/img2threejs）。
2. 一键生成：在 AI Agent 中附上参考图，输入指令 /img2threejs Rebuild this object as a Three.js model, keep the proportions, angles, and colours. 即可自动跑完全流程。
3. 成本参考：一次完整的硬表面物体重建大约消耗 80k–180k Tokens（约合 $1-$6），每轮渲染审查约 5k–12k Tokens。