img2threejs:把参考图重建为可编辑 Three.js 代码
供 AI 编程助手使用的图像转 Three.js 工作流,通过分析、代码建模与浏览器视觉验收,重建可编辑的程序化三维场景。

它能做什么
供编码智能体使用的图像转 Three.js 程序化重建技能。通过参考图分析、规格定义、分阶段代码建模、浏览器渲染与视觉验收生成可编辑代码场景;主要路线不是摄影测量、扫描或下载现成网格。适合希望在网页里直接控制模型结构、动画与交互的前端开发者,以及已有编码智能体的创作者。它按 blockout、结构、形体、材质、表面、灯光、交互和优化逐步推进,并用浏览器截图对照参考图进行门禁和返工。这样输出的核心价值是可编辑代码:可以修改几何参数和动画逻辑,而不是只有一个不可解释的结果文件。它也意味着重建依赖代理多轮理解与生成,复杂角色或背面信息不足时需要补参考、调规则,并关注模型调用的成本。
输入、输出与使用流程
输入:参考图片、建模约束;宿主需有视觉及编程能力。输出:Three.js/TypeScript 程序化几何、材质、灯光、交互代码,默认不是 GLB 安装包。请按官方示例先完成最小流程,再依据自己的资产要求调整参数;下游软件的格式兼容性与交付质量需要分别检查。
安装与运行门槛
CLI 需 Node≥18、Git;脚本 Python≥3.10;支持 Hermes、Claude Code、Codex、OpenCode。基础技能和可选 img2 插件 harness 是两个独立包。 硬件说明:默认浏览器 Three.js 渲染,无仓库强制24GB显卡条件;速度/成本主要受所用智能体和模型推理限制。
使用边界与许可
单张图不可见面仍需假设或增加参考。 默认不输出下载网格;img2glb 为另选插件,走托管 TRELLIS。 environment 插件私有,需授权Git访问;不是全插件免费开放。 质量门禁不等于生产可用承诺,生成代码和素材权利仍需检查。 授权核对:Apache-2.0(实际 LICENSE 已读取,用户标注核实正确)。开源技能免费不代表智能体推理免费。依赖用户配置的 AI 宿主/模型,可能消耗订阅或 API token;Atlas Cloud/Tripo/Hyper3D 是赞助/可选路径,不应写必需全部购买。
官方资料
版本与下载
一起让项目更好
发现问题、写下使用心得,或分享你做的改进。小到一个修复、一份中文教程,都可以帮助下一位使用者。
分享改进版本
附上改动源码、适用版本与使用说明,让大家了解你做了什么。
网友改进版本
以改动源码、分支或 PR 的形式分享,审核通过后展示;请查看原许可证与改动说明后使用。
还没有网友分享改进版本。你可以成为第一位贡献者。
评分与讨论
还没有评分,期待你的真实使用感受
你的体验,也是项目的一部分
登录后可以点亮星级、发表评论,分享使用或复现过程中的经验。
从你的第一条分享开始
可以聊聊实际效果、安装经验,或者你想解决的一个小问题。