img2threejs

img2threejs/img2threejs,以 Agent Skill 形态交付的”图生 3D”项目(Apache-2.0)。接收一张参考图,驱动 Claude Code / Codex / OpenCode 等编程 Agent 分阶段写出可编辑、可动画的 Three.js 代码模型——不是端到端神经网络(不输出 .glb 黑盒),交付物是返回 THREE.Group 的 TypeScript 工厂函数。

基本事实

  • 数据:9,310 stars / 707 forks(2026-08-03 核对);仓库创建 2026-07-15(三周近万星,增速异常快,需观察留存);正式 Release v1.4.0(2026-07-26)。
  • 八阶段质量门槛流水线:blockout → structural → form → material → surface → lighting → interaction → optimization;脚本检查 + 视觉模型观察写码;状态持久化 .img2threejs/state.json,可中断续跑。
  • 防失控设计:每轮最多纠正 3 次、全流程最多 6 次,连续不达标即停下报告失败(不无限烧 token)。
  • 能力边界(官方):单图看不到背面/隐藏结构;硬表面物体优势最大;角色仅风格化重建。
  • 官方案例:Glock、BMX 自行车、Sony 耳机、哆啦A梦房屋等;BMX 工厂函数超 1,000 行。

路线意义

代表”Agent 代码重建” vs “端到端网格生成”两条图生 3D 路线之一:牺牲几何精度,换取可编辑性/可动画性/可维护性。

来源

  • img2threejs 实测(280/283 测试通过,3 项失败为 Windows symlink 环境问题)