1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | Three.js-Object-Sculptor-Codex-Plugin | GitHub API |
| 作者/维护者 | Vinh Hien（个人开发者，GitHub 用户名 vinhhien112） | GitHub API |
| 来源链接 | https://github.com/vinhhien112/Three.js-Object-Sculptor-Codex-Plugin | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars | 1,527 | GitHub API |
| Forks | 160 | GitHub API |
| 最新版本 | 0.3.0+codex.20260717164530（未打正式 Release/Tag，版本号记于插件清单） | 仓库 .codex-plugin/plugin.json |
| 安装方式 | 克隆到本地插件目录 + 注册 Codex 插件市场清单 + codex plugin add |
README |
2. 功能介绍与亮点
Three.js Object Sculptor 是一个 Codex 插件，把上传的物体参考图转成代码构建、可跑在浏览器里的 Three.js 程序化 3D 模型——不做照片扫描重建，不下载素材包，而是引导 Codex “先验图、再拆解建模、最后拿渲染图比对参考图”。
核心亮点：
- 分层建造：先写出含组件层级、材质、光照、动画锚点的结构化规格，逐模块搭建校验，而非一次性生成整块。
- 动作可用：模型自带关节枢轴、装配插槽和父子层级，可直接接动画、物理或拆解交互，非纯摆件。
- 视觉验证闭环：渲染截图与参考图核对，关键特征缺失或错误会被拦下，不以“生成成功”为完成标准。
- 零下载依赖：几何、材质全代码生成，不依赖外部模型库；自带较完整自动化测试套件。
3. 适用场景
所属分类：其他（现有固定分类未覆盖该场景）。适合往 Three.js/WebGPU 项目里添加程序化 3D 道具、场景装饰或可交互原型的前端开发者与独立游戏制作者，尤其是没有建模经验、只有一张参考图却想要浏览器可用、能加动画素材的场景，如网页展示道具、小游戏可破坏物件、创意可视化实验。
4. 跨 Agent 兼容性
- Codex：原生支持，README 给出插件市场配置与安装步骤，为第一目标平台。
- Claude Code：无原生安装命令，但技能本体遵循通用 Agent Skills 规范，理论上可手动迁移，需自行适配。
- OpenClaw / Hermes Agent：材料未提及，未验证。
5. 推荐理由
市面上“一张图变 3D”的工具多走神经网络网格重建路线，产出不透明网格文件，难以二次编辑或接动画。这个插件反其道而行：产出可读、可改的 Three.js 代码，并强制走渲染截图比对参考图的校验闭环，避免“看起来像但细节全错”的常见翻车场景，对需要可控 3D 素材的前端与游戏开发者是实打实的效率工具。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | GitHub 1,527 stars、160 forks，仓库创建 3 周内快速积累；已登上 Trendshift 趋势榜，并在 Threads、X（前 Twitter）、YouTube Shorts 及 AI 工具目录站 There’s An AI For That 等至少 4 个独立平台被第三方账号转发讨论，其中 Threads 一条转发帖获 171 赞、52 转发 |
| 可用性 | 8 | SKILL.md 与 README 文档详尽，附两个可交互在线演示验证真实产出效果；安装需要编辑本地插件市场清单文件、非一条命令直达，但步骤在文档中写得清楚；仅需 Python 3.10+，核心流程不依赖任何付费 API；最近一次代码提交在 2026-07-17 |
| 安全性 | 8 | 抽查核心校验与生成脚本（含最大的两个模块）未发现网络请求、子进程调用、eval/exec 或凭据相关代码，全部逻辑在本地文件系统内完成；MIT License 清晰；仓库仅有的一条 issue 是未附文字说明的问题反馈，未见负面定性 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ①Shell 命令及权限范围 | 仅本地 Python 脚本处理图片与生成代码文件，未见系统级命令调用 |
| ②运行时联网外发 | 抽查的核心脚本中无网络请求相关代码；展示用的演示站点为独立静态页面，不属于技能运行时的一部分 |
| ③API key/凭据存储方式 | 无需任何 API key，视觉校验直接复用 Agent 自身的图像理解能力 |
| ④可疑指令 | 未发现混淆代码或隐蔽指令 |
| ⑤作者信誉 | 个人开发者，身份公开，仓库有完整测试套件与详尽文档佐证工程投入 |
| ⑥License | MIT，明确 |
| ⑦最近维护 | 最近一次提交 2026-07-17，在活跃窗口内 |
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| threejs-game-director（majidmanzarpour/threejs-game-skills） | Three.js 浏览器小游戏的全流程编排入口，联动 8 个兄弟技能覆盖玩法系统、音效、UI、图形管线与 QA | 定位是“整局游戏怎么从零搭出来”，本技能只专注“一张参考图怎么变成一个可用的程序化 3D 物体”，可以作为前者搭建场景时的单点素材生产环节，而非替代整套编排流程 |
| 通用图生 3D 网格重建服务 | 用神经网络从图片/多视角照片重建网格，输出不透明的 3D 模型文件（如 .glb/.obj） | 产出网格文件难以在代码层面二次编辑或直接接程序化动画；本技能产出的是可读 Three.js 源码，天生适合需要持续调整参数、加动画锚点的开发场景 |
8. 用户评价
该技能在 Threads 平台被第三方账号 @drcintas 转发，配文称其“把物体图片变成一个完全由代码构建、动画就绪的浏览器 3D 模型……自带动画枢轴、物理锚点和 PBR 材质，完全免费”，获 171 次点赞、52 次转发。GitHub issue 区仅一条未附文字说明的反馈，尚无具名详细评价。
9. 其他补充
仓库自带较大规模自动化测试代码，并提供两个可在线打开、可交互的真实渲染演示，可作为产出质量的直接验证依据。
10. 安装使用方式
mkdir -p ~/plugins
git clone https://github.com/vinhhien112/Three.js-Object-Sculptor-Codex-Plugin.git ~/plugins/threejs-object-sculptor在 ~/.agents/plugins/marketplace.json 中注册该插件（不存在需新建，字段见 README），随后执行：
codex plugin add threejs-object-sculptor@local安装后需开启新 Codex 会话使插件生效，附上物体参考图并说明意图，例如：
Use Three.js Object Sculptor to turn the object in this attachment into a procedural Three.js model built entirely with code.需要动画、物理或拆解交互时可在提示中补充说明。
11. 注意事项
- 定位程序化重建而非精确复刻，复杂物体的高保真度依赖多轮迭代校验。
- 以 Codex 插件市场为主要分发渠道，其余 Agent 生态需自行迁移安装。
- 仅个人开发者维护、上线约 3 周、无正式版本节奏，长期可持续性待观察。
- 需本地 Python 3.10+ 环境；视觉校验依赖 Agent 自身图像理解能力。
- ⚠️ 该仓库已更名为
vinhhien112/img2obj（截至 2026-08-05）。本文所列旧链接经 GitHub 自动跳转仍可正常访问，但点开后看到的仓库名会是新名字。