img2threejs

看图片，自动生成可动画的 Three.js 模型代码

img2threejs 是一个将参考图片中的物体重建为纯代码、程序化、质量门控、可动画的 Three.js 模型的开源项目。它利用 AI 智能体（如 Claude Code）理解图像，并生成高效的 Three.js 代码，从而实现图像到 3D 的转换。该项目解决了传统图像转 3D 模型方法中常见的文件体积大、难以编辑和动画化的问题，通过程序化生成和代码化表示，让生成的 3D 模型轻量、可定制且易于集成到 Web 应用中。其核心能力包括：基于视觉理解的自动建模、代码级质量控制、以及生成模型的动画就绪性。项目主要面向开发者，特别是那些需要在网页中快速生成可交互 3D 内容的场景。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 16572

维护状态较活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队img2threejs

所属国家

官网地址https://img2threejs.io

GitHubhttps://github.com/img2threejs/img2threejs

定价模式free

价格说明开源项目，Apache-2.0许可证，可免费使用和部署。

访问状态

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型3d,ai-agents,claude-code,computer-graphics,generative,image-to-3d,procedural-generation,threejs,typescript,webgl

GitHub 星标★ 16572

30天Star增速

HF 下载量

上线时间2026-07-15 00:00:00

最近更新2026-09-22 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

Claude Code 或其他兼容的智能体宿主（技能需放入其 skills 目录）
git（用于克隆仓库）
Node.js / npx（仅在安装 img2 harness 与领域插件时需要）
Python 3（仅在多会话重建、初始化状态索引时需要）

安装与启动步骤

1克隆到技能目录

把仓库直接克隆进宿主 skills 目录，路径按 README 给出的 ~/.claude/skills/img2threejs 放置。
```
git clone https://github.com/img2threejs/img2threejs.git ~/.claude/skills/img2threejs
```
2多宿主软链接

同时使用多个宿主时，只保留一份 checkout，让每个入口以软链接指向它，避免版本漂移。
3安装 img2 工具

可选。领域知识不在本仓库中，需先安装 img2 harness，它会创建 ~/.img2、插件注册表和 img2 启动器。
```
npx github:img2threejs/img2 install
```
4添加领域插件

可选。按需安装插件，如 CS2 皮肤重建。未装插件时仅 generic 与 character 两个 profile 可用。
```
img2 add img2threejs/plugin-cs2
```
5审计插件

可选。对每个已安装插件做 fail-loud 静态审计，检查安装是否完整可用。
```
img2 doctor
```
6调用重建技能

在 Claude Code 中附上或指向物体图片，然后执行该斜杠命令即可启动逐轮重建与质量门控。
```
/img2threejs Rebuild this object as a Three.js model, keep the proportions, angles, and colours.
```

7多会话初始化状态

跨多次会话重建时，先用脚本初始化本地状态索引，再取下一步任务继续推进。

python3 forge/state.py init --reference  --profile character --spec object-sculpt-spec.json
python3 forge/next.py --state .img2threejs/state.json

关键配置

配置项	必填	说明	示例
`profile`	是	选择重建档案，决定检查清单与质量门槛。	`character`
`--reference`	是	指定作为重建依据的参考图片路径。
`--spec`	否	指定重建规格文件，约束生成目标。	`object-sculpt-spec.json`
`--state`	是	本地状态索引文件路径，供下一步脚本读取。	`.img2threejs/state.json`

如何确认成功

执行 /img2threejs 后能看到图像校验、评估与规格输出，以及每轮的并排对比渲染；插件安装可用 img2 doctor 审计确认。

常见问题

Q：不装任何领域插件能用吗？

A：可以，此时 generic 与 character 两个 profile 可用。若指定了缺失的 profile（如 cs2、animated-character），会 fail loud 并提示已安装内容，不会静默降级。

Q：为什么 CS2 等领域知识不在本仓库里？

A：README 说明领域知识由已安装的插件提供，需先安装 img2 harness，再用 img2 add 添加插件。

Q：如何编写自己的插件？

A：可参考官方 plugin-hello-cube（最小参考插件），并查阅 harness 仓库的 docs/WRITING_A_PLUGIN.md。

Q：怎样卸载已安装的插件？

A：使用 img2 remove ，README 说明该操作可以干净地回滚。

注意事项

多个宿主共用时只保留一份 checkout，用软链接分别指向，防止版本漂移。
插件自带检查清单、证据收集、规格增强（质量下限只升不降）与阻塞式评审门槛。
插件未安装时失败会明确报错并列出已安装项，不会静默降级。

核心亮点

代码化输出，模型体积小，加载快
程序化生成，易于修改和二次开发
质量门控机制，确保输出模型符合标准

不足之处

依赖 AI 智能体，生成速度可能较慢
文档/社区待观察

适用场景

网页端快速原型设计，将草图或参考图转为 3D 展示
电商产品展示，生成可交互的 3D 商品模型
游戏开发，快速生成可动画的 3D 资产

替代项目

TripoSR、Meshy、3D AI Studio

项目介绍

img2threejs 是数字人3D领域的开源项目，由 img2threejs 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（16,572）位列前 3%，在数字人3D分类的 272 个项目里位列前 1%。

近 44 天，它的 GitHub 星标从 10,331 增加到 16,572，净增 6,241。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-22。Apache-2.0许可证，可免费使用和部署。

它主要面向的使用场景是：网页端快速原型设计，将草图或参考图转为3D展示。同类可对比的替代方案包括 TripoSR、Meshy、3D AI Studio。

上一篇：my-virtual-world

下一篇：NOC3D-chapter6