Three.js Object Sculptor 是一个面向 Codex 的本地插件，用于把用户附加的物体图片转化为“纯代码生成”的 Three.js 程序化 3D 模型。它不是摄影测量或单图精确建模工具，而是通过一套结构化工作流引导 Codex：先判断图片是否适合重建，再生成 ObjectSculptSpec 规格说明，拆解几何结构、材质、层级、动画锚点和质量目标，随后分阶段生成 Three.js 工厂代码，并通过渲染截图与参考图进行视觉对比和自我修正。该项目适合需要快速制作浏览器实时 3D 道具、游戏物体、程序化资产原型的开发者。
适用领域
Three.js / Web 3D / 程序化建模 / AI 辅助开发 / Codex 插件 / 游戏开发 / 可交互 3D 原型 / 实时渲染 / 图像到代码工作流 / PBR 材质辅助生成
配置难度
中高级。安装本身不复杂，主要是克隆插件、配置 marketplace.json 并在 Codex 中启用；但要真正发挥价值，需要开发者熟悉 Codex 本地插件、Three.js 项目、程序化建模思路、截图验收流程以及多轮 AI 辅助迭代。对于只会基础前端的开发者，理解 ObjectSculptSpec、动画层级、材质和质量门禁会有一定学习成本。
商业价值
该项目的商业价值主要在于提升 3D 原型和程序化资产生成效率。对于 Web 3D、互动营销、小游戏、产品演示、数字展陈和可视化团队，它可以把参考图快速转化为可运行的 Three.js 代码资产，减少早期建模沟通和手工搭建成本。它尤其适合快速验证创意、生成非写实道具、制作可动画化对象和构建浏览器实时场景。不过，它不适合替代专业美术生产管线或高精度扫描建模，更适合作为 AI 辅助程序化建模工具、内部原型生产工具或 Three.js 资产生成加速器。
01
技术亮点
- 以工作流方式约束 Codex，不是简单一次性提示生成代码，更强调规格、阶段、质量门禁和自我修正。
- 输出代码原生 Three.js 模型，不依赖下载模型、艺术包或外部 mesh 资源。
- 强调 animation-ready：会规划 pivot、socket、父子层级、transform channel、collider proxy、可拆卸部件等。
- 支持从粗略 blockout 到结构、形体、材质、表面、灯光、交互、优化的分阶段生成。
- 通过 ObjectSculptSpec 明确物体组件、材质、灯光响应、关键特征、动画锚点和质量指标。
- 内置视觉质量门禁思路：整体匹配度和关键语义特征都需要达标。
- 支持将参考图和渲染截图生成 comparison sheet，方便 AI 视觉评审。
- 提供 PBR 证据提取脚本，可从图片中近似生成调色板、albedo、roughness、height、normal、AO 等材料依据。
- 适合生成树木、船、车辆、机械零件、产品道具、游戏物件等结构明显的程序化资产。
- MIT 许可证，便于个人和商业项目集成或二次开发。
02
目标用户
- 使用 Codex 进行本地插件开发或 AI 编程的开发者
- Three.js / WebGL / WebGPU 方向的前端开发者
- 需要快速生成 3D 道具原型的独立游戏开发者
- 需要把参考图转为浏览器 3D 资产的交互产品开发者
- 从事程序化建模、创意编码、可视化实验的开发者
- 希望用代码而不是外部模型资源构建 3D 场景的团队
- 需要动画友好层级、枢轴、挂点、可破坏结构规划的 3D 工程师
03
配置要求
- 需要 Codex 本地插件支持。
- 需要 Python 3.10+。
- 需要配置 ~/.agents/plugins/marketplace.json 以注册本地插件。
- 需要将插件源码放置在本地可访问路径，例如 ~/plugins/threejs-object-sculptor。
- 如果要实际运行生成的模型，需要一个 Three.js 浏览器项目。
- 如果要做视觉验收，需要参考图、模型渲染截图，以及可用于图像比较的 AI vision reviewer。
- 辅助脚本主要依赖 Python 标准库，部分图像处理能力会使用系统中可用的 shell image tooling。
- 不要求 Playwright，也不要求下载 Chromium bundle。
- PBR 提取功能需要输入参考图，并可通过 target-threshold、allow-low-confidence 等参数控制置信度门槛。
- 该项目输出默认不是 GLB 文件，而是 Three.js 工厂代码和 ObjectSculptSpec；如需 GLB 需在目标项目中自行增加导出流程。
04
适用场景
- 根据一张参考图生成纯 TypeScript / Three.js 代码形式的程序化模型工厂
- 为网页游戏或交互 Demo 快速制作实时渲染的 3D 道具
- 生成带有父子层级、pivot、socket、collider proxy 的动画友好对象
- 根据参考图拆解物体结构，产出 ObjectSculptSpec 作为后续建模和迭代依据
- 制作可变形、可拆解、可破坏对象的结构规划
- 通过参考图与渲染截图对比，利用 AI 视觉评审发现形状、比例、关键特征偏差
- 为 Three.js 游戏、WebGPU Demo、交互原型生成可复用程序化资产
- 从参考图提取近似 PBR 材质证据，例如调色板、albedo、roughness、height、normal、AO 等
05
部署与配置
- 确保本地已安装 Python 3.10 或更高版本。
- 确保使用的 Codex 环境支持本地插件。
- 准备一个后续用于实现生成模型的 Three.js 浏览器项目。
- 克隆仓库到本地插件目录，例如：mkdir -p ~/plugins && git clone REPOSITORY_URL ~/plugins/threejs-object-sculptor。
- 编辑或创建 ~/.agents/plugins/marketplace.json，将 threejs-object-sculptor 作为 local plugin 加入 plugins 数组。
- 在 marketplace.json 中配置插件 source.path，例如 ./plugins/threejs-object-sculptor，并设置 installation 为 AVAILABLE。
- 执行 codex plugin add threejs-object-sculptor@local 安装插件。
- 安装后开启新的 Codex 会话，使插件 skill 被加载。
- 在 Codex 中附加物体图片，并提示：Use Three.js Object Sculptor to turn the object in this attachment into a procedural Three.js model built entirely with code。
- 可选：在插件根目录使用 scripts 下的 Python 脚本执行图片探测、规格生成、规格校验、工厂代码生成、截图对比和评审记录。
06
风险与注意事项
- 它不是摄影测量工具，无法从单张图片恢复精确网格、隐藏面或真实尺寸。
- 生成结果高度依赖 Codex 能力、提示质量、参考图清晰度和后续人工迭代。
- README 明确说明不保证从一张图片生成生产级完美几何体。
- 复杂物体可能需要多轮评审、截图对比和人工修正，不能视为完全自动化建模管线。
- 默认输出是 Three.js 代码，不是 GLB / FBX / OBJ 等通用 3D 资产格式。
- 需要开发者理解 Three.js 项目结构、材质、几何、渲染和动画层级，否则集成成本较高。
- 质量门禁依赖 AI vision review 时，评审结果可能存在主观性和不稳定性。
- PBR 提取只是基于单张图的近似证据，不是准确的逆向渲染或真实材质扫描。
- 项目语言标记为 Python，但核心使用场景最终会落到 TypeScript / Three.js 代码生成，技术栈横跨 Python、Codex、Three.js。
- 本地 Codex 插件生态和配置方式对部分国内开发者可能较陌生，初次配置可能有门槛。
2026-07-16
第2名
新收录 · github_search
2026-07-15
第5名
新收录 · github_search
2026-07-14
第4名
新收录 · github_search
2026-07-13
第10名
新收录 · github_search
