能做什么
img2threejs 是 GitHub 上的 Agent Skill(仓库 img2threejs/img2threejs,约 2 万星,Apache-2.0),用代码重建参考图里的物体或角色,产出可动画的 Three.js 模型。它不是摄影测量或网格提取,而是分阶段雕模、逐轮截图比对校正。当用户发来物体图片并要 3D 模型、雕刻规格或重建方案时,AI 会自动加载它,适配 Hermes、Claude Code、Codex、OpenCode 等宿主。
- 按分层观察协议拆解参考图,用 PBR 词汇描述材质
- 按 blockout→结构→形体→材质→灯光→交互→优化逐段生成
- 每阶段截图与参考图比对,关键特征错即判该阶段失败
- state.json 记录每步证据,脚本强制检查点并限制返工轮次
- 可选 generic、character、animated-character 等流程配置
- 图案类表面走投影优先路径,直接贴参考图的像素
- 单张图看不到背面,被遮挡的几何只能标注为近似
- 需 Python 3.10+ 与宿主自带的图像读取能力
怎么用
不用手动调用。像平时一样说需求,AI 会根据技能的描述自己决定加载。安装
只需要一次,之后所有对话都能用。请帮我安装这个 Agent Skill:https://github.com/img2threejs/img2threejs 。把 img2threejs 整个目录放到我的个人技能目录,装好后确认 SKILL.md 在位,并告诉我怎么使用。/skills 能看到 img2threejs 就装好了这句话由本站按源仓库地址生成,只让 AI 从 GitHub 下载这个目录,不经过本站。需要 Python 3.10+ 标准库,无需 pip 安装。可用 npx --yes img2threejs@latest install 为检测到的 Hermes、Claude Code、Codex、OpenCode 建立软链。
git clone --depth 1 https://github.com/img2threejs/img2threejs.git ~/skills-src/img2threejs.claude/skills/)mkdir -p ~/.claude/skills/ && cp -r ~/skills-src/img2threejs ~/.claude/skills/img2threejs/skills 能看到 img2threejs 就装好了Windows:在 Git Bash 里执行,或把 ~ 换成 %USERPROFILE%。需要 Python 3.10+ 标准库,无需 pip 安装。可用 npx --yes img2threejs@latest install 为检测到的 Hermes、Claude Code、Codex、OpenCode 建立软链。
git clone --depth 1 https://github.com/img2threejs/img2threejs.git ~/skills-src/img2threejsmkdir -p ~/.codex/skills/ && cp -r ~/skills-src/img2threejs ~/.codex/skills/img2threejs重启 Codex 后生效,需要支持 Skills 的版本。需要 Python 3.10+ 标准库,无需 pip 安装。可用 npx --yes img2threejs@latest install 为检测到的 Hermes、Claude Code、Codex、OpenCode 建立软链。
安全审核
编辑看过源码后的结论。审核只针对下面这个版本。- 脚本含 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+ 标准库即可。
程序先扫描脚本、网络请求、密钥读取和二进制文件,编辑再逐个看过脚本源码。之后仓库的改动不在审核范围内;每周自动比对,一旦有改动本页会标出来。
用中转站跑
重建过程中会读入参考图和大量规格、审查文本,多轮迭代截图比对,走中转站时 token 用量明显高于普通问答。
原文描述
摘自 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.