img2threejs来自 img2threejs/img2threejs

图生 Three.js 模型

把参考图重建为纯代码、带质量门禁的 Three.js 程序化模型。装好后不用记命令,说出需求它就会被自动加载。

SKILL.md技能资料
名称
img2threejs
目录
(仓库根目录)
星数
★ 21.4k
许可证
Apache-2.0
适用
Claude Code · Codex
脚本
218 个 · 会联网或访问本机
审核
11-08 · 提交 0c0c49b
01

能做什么

img2threejs 是 GitHub 上的 Agent Skill(仓库 img2threejs/img2threejs,约 2 万星,Apache-2.0),用代码重建参考图里的物体或角色,产出可动画的 Three.js 模型。它不是摄影测量或网格提取,而是分阶段雕模、逐轮截图比对校正。当用户发来物体图片并要 3D 模型、雕刻规格或重建方案时,AI 会自动加载它,适配 Hermes、Claude Code、Codex、OpenCode 等宿主。

  1. 按分层观察协议拆解参考图,用 PBR 词汇描述材质
  2. 按 blockout→结构→形体→材质→灯光→交互→优化逐段生成
  3. 每阶段截图与参考图比对,关键特征错即判该阶段失败
  4. state.json 记录每步证据,脚本强制检查点并限制返工轮次
  5. 可选 generic、character、animated-character 等流程配置
  6. 图案类表面走投影优先路径,直接贴参考图的像素
  7. 单张图看不到背面,被遮挡的几何只能标注为近似
  8. 需 Python 3.10+ 与宿主自带的图像读取能力
02

怎么用

不用手动调用。像平时一样说需求,AI 会根据技能的描述自己决定加载。
示意
把这张球鞋照片做成 Three.js 程序化模型,能拖动旋转
⏺ 加载技能 img2threejs
已按参考图生成球鞋的程序化 Three.js 模型,鞋面、鞋带与中底分层建模,页面内可拖动旋转;被遮挡的鞋底内侧按近似处理。
照这张人物设定图做一个能绑骨动画的角色这张机甲图重建一下,螺栓和分模线都要在
03

安装

只需要一次,之后所有对话都能用。
1复制下面这句话,发给 Claude Code 或 Codex
请帮我安装这个 Agent Skill:https://github.com/img2threejs/img2threejs 。把 img2threejs 整个目录放到我的个人技能目录,装好后确认 SKILL.md 在位,并告诉我怎么使用。
2AI 会自己下载源仓库、放到正确位置。它执行命令前会征求你同意,看一眼命令再允许
3重启后生效。Claude Code 里输入 /skills 能看到 img2threejs 就装好了

这句话由本站按源仓库地址生成,只让 AI 从 GitHub 下载这个目录,不经过本站。需要 Python 3.10+ 标准库,无需 pip 安装。可用 npx --yes img2threejs@latest install 为检测到的 Hermes、Claude Code、Codex、OpenCode 建立软链。

04

安全审核

编辑看过源码后的结论。审核只针对下面这个版本。
审核报告需留意:脚本会联网或访问本机服务2026-11-08 · 提交 0c0c49b
  • 脚本含 218 个脚本,主要是 Python 建模流程、状态门禁脚本和 Node 版 CLI 安装工具。.github/FUNDING.yml.github/ISSUE_TEMPLATE/bug_report.yml.github/ISSUE_TEMPLATE/contribution_intent.yml.github/ISSUE_TEMPLATE/feature_request.yml.github/pull_request_template.md.github/release.yml.github/workflows/beta-release.yml+293
  • 联网bin/img2threejs.mjs 会 fetch 版本发布地址做升级检查,测试脚本在本机 127.0.0.1 起 HTTP 服务。
  • 读写范围读写 .img2threejs/state.json 状态与证据文件、规格 JSON、截图以及生成的 TypeScript 代码。
  • 密钥与隐私bin 与 forge 脚本读取 IMG2THREEJS_RELEASES_LATEST_URL、XDG_CONFIG_HOME、IMG2_HOME、PATH 等环境变量,未发现读取密钥或浏览器数据。
  • 依赖无需额外依赖,Python 3.10+ 标准库即可。
已审核2026·11·08

程序先扫描脚本、网络请求、密钥读取和二进制文件,编辑再逐个看过脚本源码。之后仓库的改动不在审核范围内;每周自动比对,一旦有改动本页会标出来。

05

用中转站跑

重建过程中会读入参考图和大量规格、审查文本,多轮迭代截图比对,走中转站时 token 用量明显高于普通问答。

先检测我的接口
06

原文描述

摘自 SKILL.md 的 description,AI 靠这段话判断什么时候加载它。
Turn an object or character reference image into a quality-gated, animation-ready procedural Three.js model built in code. Use for image-to-3D reconstruction, detail-accurate object rebuilds, stylized/likeness-maximized human characters, sculpt specs, and staged code generation.
来源 img2threejs/img2threejs · 仓库根目录中文说明由 AI 整理、编辑核对说明有误或发现安全问题?反馈