img2threejs

一张图丢进去,吐出来一段 TypeScript 代码,浏览器里跑起来就是个带层级结构、能动画的 3D 模型,省 token 也省事儿。

Github地址

https://github.com/hoainho/img2threejs

功能特性

  • 硬表面物体最拿手:耳机盒、枪械、刀具、机械载具这类棱角分明的物体,还原度比较高
  • 细节不糊弄:会专门盘点照片里的螺丝、倒角、磨损痕迹、发光标志这些小东西,缺了不往下走
  • 分阶段做,一步一验:从粗模到结构、外形精修、材质、灯光、交互,每层做完都要对比原图检查,不行就返工
  • 省token:机器干机器的活(验证、打包、写规范),人眼只负责最后看对比图打勾或打叉,不把算力浪费在反复重读代码上
  • 角色也能做,但偏风格化:有人体比例和面部特征的分析流程,不过单张照片别指望100%像真人

怎么用

Python 3.10以上就行,零依赖:

1
git clone https://github.com/hoainho/img2threejs.git ~/.claude/skills/img2threejs

然后在Claude Code这类支持视觉的AI助手环境里,贴张图,打指令:

1
/img2threejs Rebuild this object as a Three.js model, keep the proportions, angles, and colours.

之后跟着流程走:分析图片适不适合→写规格说明书→代码生成→浏览器渲染→对比原图→过就下一层,不过就改。每一步都有脚本管状态,人只看最终的左右对比图。

想手动跑也行,按顺序执行forge目录下的Python脚本,从探查图片、评估复杂度、写规范、验证、生成代码一路下来。