结合 iPhone LiDAR 扫描、Three.js 查看器与智能体技能,将房间重建为可编辑的 3D 场景。
img2threejs/plugin-interior
一种由 AI 代理驱动的技能,可将单张室内图片重建为可编辑的 Blender 场景、Three.js 查看器和便携 GLB 模型。
- Star
- 262
- Fork
- 28
- 未关闭 Issue
- 0
- 最近提交
- 19天前
这是什么?
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;将该工具本身商业化需事先获得书面许可。
收录于专题
标签
常见问题
- plugin-interior 是什么?
- 一种由 AI 代理驱动的技能,可将单张室内图片重建为可编辑的 Blender 场景、Three.js 查看器和便携 GLB 模型。 img2 Interior 是一个面向 Claude Code、Codex 和 OpenCode 的代理技能,基于 img2 框架运行。输入一张室内参考图后,代理会分析图片构图、相机、房间结构、家具和光照,在 Blender 中搭建带几何体和 PBR 材质的场景,渲染后与参考图逐项对比并修正。
- plugin-interior 可以免费使用吗?用的什么许可证?
- plugin-interior 以 Other 许可证开源。用于商业产品前,请先确认许可证条款。
- plugin-interior 还在维护吗?
- 活跃维护中。plugin-interior 最近一次提交是在 2026年10月19日。
- plugin-interior 适合用来做什么?
- 将室内设计概念图转换为可探索的 3D 房间,用于客户评审。 基于单张参考照片,生成可继续编辑的 Blender 室内场景起点。 用 Three.js 查看器发布可在浏览器中漫游的房间展示。 为其他支持 glTF 的工具导出独立的房间 GLB 模型。
- plugin-interior 怎么安装和运行?
- 从 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 重启代理会话,打开项目并使用复制提示词,附上一张房间图片
- 在哪里获取 plugin-interior?
- 源代码和安装说明在 GitHub 上:https://github.com/img2threejs/plugin-interior
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
一套面向 AI 编程代理的 3D 可视化技能,帮助把创意转化为 Three.js 或 Blender 场景。
一个 Claude Code 技能,通过脚本驱动 Blender、Octane 和 DaVinci Resolve,从设计专利或照片制作产品影片与静物渲染。
基于 Blender 的 Python 工具包,从房产挂牌照片重建三维房屋模型并渲染漫游视频。
面向 Node.js 与 Web 的 glTF 2.0 三维模型读写、编辑与优化 SDK 及命令行工具。
一个智能体技能,可把课程论点转化为学习者能预测、调整并解释的交互式教学图示。