一套面向 AI 编程代理的 3D 可视化技能,帮助把创意转化为 Three.js 或 Blender 场景。
img2threejs/img2interior
一种由 AI 代理驱动的技能,可将单张室内图片重建为可编辑的 Blender 场景、Three.js 查看器和便携 GLB 模型。
- Star
- 46
- Fork
- 6
- 未关闭 Issue
- 0
- 最近提交
- 16小时前
这是什么?
img2 Interior 是一个面向 Claude Code、Codex 和 OpenCode 的代理技能,基于 img2 框架运行。输入一张室内参考图后,代理会分析图片构图、相机、房间结构、家具和光照,在 Blender 中搭建带几何体和 PBR 材质的场景,渲染后与参考图逐项对比并修正。
整个流程输出三类成果:可编辑的打包 Blender 源文件;包含光照贴图、探针等附属文件和查看器代码的运行时 GLB;以及烘焙外观的独立便携 GLB 模型。由于单张图片信息有限,尺寸、遮挡面和相机参数都会标注为估计值,项目不承诺精确还原或照片级真实感,也不是预训练的图像到网格模型。
安装时通过 npm 将包下载到专用目录,再注册到 img2 框架中。原生建模需要单独的 Python 3.11 环境并安装 bpy 和 numpy。源码以可用但限制商业化的许可证发布。
核心功能
- 01从一张室内参考图生成可编辑的 Blender 场景。
- 02渲染结果并与参考图对比,逐步修正几何和材质。
- 03导出打包的 .blend 源文件、带 Three.js 查看器的运行时 GLB 以及便携 GLB。
- 04在项目中记录素材来源、假设条件和验证证据。
- 05通过 npm 安装,并注册到 img2 框架,支持 Claude Code、Codex 和 OpenCode。
适用场景
- 将室内设计概念图转换为可探索的 3D 房间,用于客户评审。
- 基于单张参考照片,生成可继续编辑的 Blender 室内场景起点。
- 用 Three.js 查看器发布可在浏览器中漫游的房间展示。
- 为其他支持 glTF 的工具导出独立的房间 GLB 模型。
快速上手
- 1
从 npm 将软件包安装到专用目录
npm install --prefix "$HOME/.local/share/img2interior" @img2threejs/img2interior@0.3.1 - 2
将已安装副本注册到 img2 框架
npx --yes @img2threejs/img2@0.4.0 add --link "$HOME/.local/share/img2interior/node_modules/@img2threejs/img2interior" --yes - 3
重启代理会话,打开项目并使用复制提示词,附上一张房间图片
使用前须知
- 不是预训练或一键生成模型;结果依赖场景化的人工编写与视觉审核。
- 需要 Claude Code、Codex 或 OpenCode,以及单独的 Python 3.11 环境并安装 bpy 4.3.0。
- 需要 img2 框架(0.4.0 或更新版本)和支持 WebGL 的浏览器。
- 许可证显示为 NOASSERTION;将该工具本身商业化需事先获得书面许可。
标签
常见问题
- img2interior 是什么?
- 一种由 AI 代理驱动的技能,可将单张室内图片重建为可编辑的 Blender 场景、Three.js 查看器和便携 GLB 模型。 img2 Interior 是一个面向 Claude Code、Codex 和 OpenCode 的代理技能,基于 img2 框架运行。输入一张室内参考图后,代理会分析图片构图、相机、房间结构、家具和光照,在 Blender 中搭建带几何体和 PBR 材质的场景,渲染后与参考图逐项对比并修正。
- img2interior 可以免费使用吗?用的什么许可证?
- img2interior 以 Other 许可证开源。用于商业产品前,请先确认许可证条款。
- img2interior 还在维护吗?
- 活跃维护中。img2interior 最近一次提交是在 2026年10月19日。
- img2interior 适合用来做什么?
- 将室内设计概念图转换为可探索的 3D 房间,用于客户评审。 基于单张参考照片,生成可继续编辑的 Blender 室内场景起点。 用 Three.js 查看器发布可在浏览器中漫游的房间展示。 为其他支持 glTF 的工具导出独立的房间 GLB 模型。
- img2interior 怎么安装和运行?
- 从 npm 将软件包安装到专用目录: npm install --prefix "$HOME/.local/share/img2interior" @img2threejs/img2interior@0.3.1 将已安装副本注册到 img2 框架: npx --yes @img2threejs/img2@0.4.0 add --link "$HOME/.local/share/img2interior/node_modules/@img2threejs/img2interior" --yes 重启代理会话,打开项目并使用复制提示词,附上一张房间图片
- 在哪里获取 img2interior?
- 源代码和安装说明在 GitHub 上:https://github.com/img2threejs/img2interior
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
将单张参考图重建为可动画的程序化 Three.js 代码模型,而不是网格文件。
面向 Claude Code、Codex CLI、Cursor CLI 和 Gemini CLI 的通俗语言 Agent 技能包,把会话汇报改写成普通人也能看懂的结论。
一个 Claude Code 技能,输入网站 URL 即可用 HTML 生成带音效与动态模糊的 60 fps 产品发布视频。
一个 Agent Skill,把主题做成带配音、硬字幕和封面的讲解视频,用 HTML 写画面并本地渲染为 MP4。
面向 Claude Code 和 Codex 的智能体技能,用你应用的真实界面制作发布宣传片和短视频,按音乐节拍剪辑并在本机渲染。