1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | img2threejs |
| 作者/维护者 | img2threejs 组织（活跃贡献者：hoainho、kokorolx） |
| 来源链接 | https://github.com/img2threejs/img2threejs |
| 许可证 | Apache License 2.0（数据来自 GitHub API，仓库根目录含 LICENSE 文件） |
| GitHub Stars | 9,572（数据来自 GitHub API） |
| Forks | 715（数据来自 GitHub API） |
| 最新版本 | SKILL.md 声明 v1.4.4-beta.3；GitHub 标签发布最新为 v1.4.0（2026-07-26，“Weapon pipeline”） |
| 安装方式 | git clone 到 Claude Code 技能目录 |
2. 功能介绍与亮点
给定一张物体或角色的参考图，img2threejs 会产出一个纯代码的 THREE.Group 工厂函数（TypeScript），把参考图重建成程序化生成的 Three.js 3D 模型——不依赖照片扫描、网格提取或下载好的美术资源，模型自带完整运行时层级（枢轴点、挂载点、碰撞体），可直接用于动画和交互。
核心亮点：
- 分阶段“雕刻”流水线：blockout → structural → form → material → surface → lighting → interaction → optimization，每个阶段都用 AI 视觉将渲染截图与参考图比对、自我校正后才能进入下一阶段。
- 细节清单优先：生成代码前必须列出所有决定物体身份的细节（倒角、螺丝铆钉、刻线、磨损痕迹等），每项都要映射到真实组件，质量门禁未通过不允许继续。
- 多主体路径：物体、角色（含解剖学感知的比例锁定与姿态处理）、以及针对特定人物/角色的“最大相似度”投影管线（参数化模板拟合关键点、去光照、相机匹配），并给出逐区域重建置信度。
- 纯本地工具链：校验与生成脚本只依赖 Python 3.10+ 标准库，无需额外依赖包。
3. 适用场景
所属分类：前端与设计
适合前端开发者、独立游戏制作者、3D 网页作品集创作者：手头只有一张参考图，需要快速拿到一个可编辑、可直接嵌入浏览器项目、可加动画的程序化 3D 模型代码，而不想安装建模软件或处理网格文件。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——README 给出明确安装路径
~/.claude/skills/img2threejs与/img2threejs调用方式。 - Codex：✅ 原生支持——README 明确列出可在 Claude Code、Codex、OpenCode 下运行。
- OpenClaw：❓ 未验证——README 提到的是 “OpenCode”（与 OpenClaw 是两个不同项目），未见针对 OpenClaw 的说明。
- Hermes Agent：❓ 未验证——README 与 SKILL.md 均未提及。
5. 推荐理由
在“参考图生成程序化 3D 模型”这一细分方向里，img2threejs 不到一个月冲到近万星，验证了真实需求；分阶段质量门禁与细节清单机制让输出比一次性生成更可信，纯本地 Python 工具链、零外部依赖、无需 API key，安装门槛低，适合想快速获得可动画 3D 网页素材、又不想碰建模软件的开发者。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | GitHub 9,572 stars；第三方指数追踪（SkillsLLM 一周内 4.2k→6.1k）与媒体报道（Enterprise DNA「AI Pulse」）均独立证实其近一个月内的快速增长 |
| 可用性 | 9 | 单条 git clone 命令安装、单条 slash 命令调用；README/ARCHITECTURE.md/ROADMAP.md 及 grimoire 参考文档体系完整；纯 Python 3.10+ 标准库无需额外依赖；近日仍在持续发布 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单：
① Shell 执行——仅在技能目录内跑确定性本地 Python 脚本完成校验与代码生成，范围明确 ② 联网外发——未见运行时联网行为，图像读取依赖宿主 agent 自带能力 ③ 凭据要求——无需 API key 或任何凭据 ④ 可疑指令——抽查 README 与 SKILL.md 未见 prompt injection 或隐蔽指令 ⑤ 作者信誉——组织下 2 名活跃人类贡献者，代码开源可审计，无造假迹象 ⑥ License——Apache License 2.0，仓库根目录含 LICENSE 文件 ⑦ 维护时间——近日仍有提交，版本迭代频繁
综合评分：8.7（三项均值）
7. 跟同类 Skills 相比的优势
| 维度 | img2threejs | 同类竞品（vinhhien112/img2obj） |
|---|---|---|
| 定位 | 分阶段质量门禁式重建流水线，含细节清单与角色专用审核轨道 | Codex 插件，将物体参考图转为可动画程序化 Three.js 模型代码 |
| 生成流程 | 八阶段流水线，每阶段都有 AI 视觉截图自校验 | 未见公开的分阶段质量门禁说明 |
| 主体覆盖 | 通用物体、角色（含相似度最大化投影）、特定专项组件重建 | 以通用物体重建为主 |
| 依赖 | 纯 Python 3.10+ 标准库 | 依赖 Codex 插件运行环境 |
另有 CloudAI-X/threejs-skills 这类知识库型技能，定位是给 Claude Code 补充 Three.js API 用法与最佳实践参考，不做图片到模型的生成——与 img2threejs 是两类不同工具，不能互相替代。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。可查的报道（如 Enterprise DNA「AI Pulse」专栏）聚焦于其热度增长曲线与技术架构，未附带使用者的书面评论。
9. 其他补充
仓库存在社区发起的公开数据集提案（构建开源“图片→Three.js代码”数据集），显示已有外部开发者围绕该项目做延伸贡献。文档目前仅提供英文版本。
10. 安装使用方式
-
克隆到 Claude Code 技能目录：
git clone https://github.com/img2threejs/img2threejs.git ~/.claude/skills/img2threejs -
在对话中附上参考图片并调用：
/img2threejs Rebuild this object as a Three.js model, keep the proportions, angles, and colours.一句话即可触发：技能会自动分类主体、跑完细节清单、并在每一步自行把关质量。
-
也可跳过对话直接分步调用底层脚本（如
forge/stage1_intake/probe_image.py）手动驱动流水线，完整脚本列表见仓库docs/ARCHITECTURE.md。
注意事项：安装后无需重启，直接在对话中附图触发即可；脚本仅需本机 Python 3.10+，无需额外 pip 安装。
11. 注意事项
- 目前仍是 beta 版本（1.4.4-beta.3），行为可能随后续迭代调整。
- 单张图片无法还原物体背面或隐藏结构的真实几何，工具会明确标注输出是近似或风格化结果，而非伪造置信度。
- 角色重建目前是风格化重建，不是照片级真实肖像还原。
- 建筑、场景、多物体环境等复杂主体尚在路线图后续阶段，当前版本未覆盖。
- 需要宿主 agent 具备读图能力（原生视觉、浏览器 MCP、项目预览或用户提供截图），宿主不支持读图则无法使用。