Repolode
img2threejs

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. 1

    从 npm 将软件包安装到专用目录

    npm install --prefix "$HOME/.local/share/img2interior" @img2threejs/img2interior@0.3.1
  2. 2

    将已安装副本注册到 img2 框架

    npx --yes @img2threejs/img2@0.4.0 add --link "$HOME/.local/share/img2interior/node_modules/@img2threejs/img2interior" --yes
  3. 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 数据每日更新。

相关项目