精读
开源项目
img2threejs:按一张参考图用代码重建可动画 Three.js 模型的 agent 技能
题为编者所加
新颖证据可用
img2threejs 让 agent 照一张图写出可动画的 Three.js 代码模型,不出网格文件。
批注最值得借的是分工,脚本管校验,模型只判一张对比图,我写 agent 工具时也想照搬。
它解决什么
常见的图生 3D 走摄影测量或生成网格,img2threejs 改成让 agent 用基本体、程序化着色器和生成几何写一个 TypeScript 的 THREE.Group 工厂函数,自带枢轴、挂点和碰撞体,可以直接做动画。校验、门控和进度记录都交给纯标准库的 Python 脚本,模型只看参考图和渲染图并排的一张对比图,以此省 token。
能力和边界
- 按 blockout 到 optimization 共 8 轮逐轮生成、逐轮审图,--strict-quality 门不过就不写代码
- 物体和角色分两条线,角色有骨骼和蒙皮;CS2 武器皮肤、动画角色走插件,environment 插件是私有仓库
- README 说明单张图保证不了 100% 像,会按区域报置信度并要求补视角
- 演示表 15 个模型里有 4 个还标着 placeholder
健康度
2026-07-15 创建,最新版本 v2.0.0(2026-09-06),最近提交 2026-10-08,Apache-2.0,前 1 名贡献者占 64%,未归档。
上手成本
需要 Node.js 18 以上、Git 和 Python 3.10 以上,npx --yes img2threejs@latest install 装进检测到的 agent,插件要另装 img2 harness。核心脚本不需要 pip 依赖,但 README 很长,要先分清基础技能、harness 和插件。