正在加载入行工作台
面向 Codex、Claude Code 和 OpenCode 的开源 Agent Skill：输入一张物体或角色参考图，分阶段生成可审查、可继续修改、可动画的 TypeScript Three.js 模型。它不是一键照片转网格，单张图片看不到的背面和隐藏结构仍需要人工确认或补充视图。
## 什么时候用 当你有一张物体或角色参考图，希望得到可读、可版本管理、可动画的 Three.js TypeScript 模型时使用。它采用“先规格、再分阶段生成、逐步对比验收”的路线，不是摄影测量或直接提取网格。 ## 准备条件 - Codex、Claude Code 或 OpenCode - Python 3.10 及以上 - 可运行和预览 Three.js 的项目 - Agent 能读取参考图并查看浏览器渲染或截图 ## 安装 ```bash git clone https://github.com/img2threejs/img2threejs.git ~/.codex/skills/img2threejs ``` ## 最短使用路径 1. 提供清晰参考图并说明最终用途。 2. 要求 Agent 使用 img2threejs，先判断图片适用性。 3. 按阶段生成并查看参考图与渲染对比。 4. 遇到门禁失败时修正规格或补充视图。 5. 验收 TypeScript 工厂、结构化规格、对比证据、部件层级和动画接口。 ## 完成标准 - TypeScript 可在 Three.js 项目中运行。 - 关键轮廓、比例、材质区域和身份细节有对比证据。 - 可动部件有明确 pivot、socket 或运行时层级。 - 不可见区域被标为推断或低置信度。 ## 失败后怎么调整 图片不适合时更换清晰、背景简单的参考图；隐藏结构重要时补充多角度图片；外形不对先修规格，材质不对再修材质证据。 ## 风险提示 这是第三方社区 Skill，会运行本地脚本并写入项目文件。安装前应阅读 SKILL.md 和脚本，优先在可回退的独立项目中使用并固定版本。人物、品牌角色和游戏资产还需要核对肖像、商标与版权授权。 来源：https://github.com/img2threejs/img2threejs 许可证：Apache-2.0