floorplan-3d

上传户型图,秒变可旋转的3D房间

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 数字人3D 🍴 复刻 810 🐛 待处理 12 👀 关注 12
GitHub ↗
GitHub 星标 ★ 3847
维护状态 维护中
是否开源 开源
定价模式 🏷️完全免费 开源项目,免费使用

项目预览

floorplan-3d 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类数字人3D
开发团队wy51ai
定价模式🏷️完全免费
价格说明开源项目,免费使用
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言HTML
GitHub 星标★ 3847
上线时间2026-09-29 00:00:00
代码更新2026-10-02
仓库体积18 KB
本站数据更新2026-11-20
维护状态维护中
收录时间2026-10-05
浏览次数98

项目介绍

floorplan-3d 是一个基于 HTML/WebGL 的开源项目,用于将二维户型图快速转换为可交互的三维室内模型。用户只需上传或绘制平面户型图,项目就能自动识别墙体、房间边界,并生成带地板、墙面的 3D 场景,支持在浏览器中旋转、缩放和漫游查看。它解决了传统室内设计软件门槛高、建模慢的问题,让房产展示、装修预览、游戏关卡原型等场景可以低成本获得三维空间。核心能力包括户型图解析、墙体挤出、材质贴图、视角控制以及可嵌入网页的轻量渲染,适合前端开发者直接集成到现有网站或应用中,无需依赖专业建模工具。项目以 HTML 为主,部署简单,适合快速验证和二次开发。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-05 · 当前星标 ★ 3847

使用教程

难度:入门 约 5 分钟 部署方式:本地安装 5 步

环境要求

  • 现代浏览器(需支持 WebGL,用于 3D 场景渲染)
  • Git(用于克隆仓库)
  • Python 3(可选,用来自起本地静态服务器)
  • 首次打开 3D 场景需联网(Three.js 通过 jsDelivr CDN 加载)

安装与启动步骤

  1. 1克隆仓库

    把项目代码下载到本地,README 中仓库地址为占位符,这里填入项目实际地址。

    git clone https://github.com/wy51ai/floorplan-3d.git
  2. 2进入项目目录

    切换到刚克隆下来的目录,后续命令都在此目录执行。

    cd floorplan-3d
  3. 3启动本地服务器

    项目是纯前端页面,直接双击也可用;起静态服务器访问更稳定,端口用 8000。

    python3 -m http.server 8000
  4. 4在浏览器中访问

    打开 http://localhost:8000,也可直接双击项目里的 index.html 打开。

  5. 5切换到 3D 场景

    按 T 键在 2D / 3D 之间切换;3D 首次加载需联网拉取 CDN 资源,稍等片刻。

如何确认成功

浏览器打开 http://localhost:8000 能看到 2D 户型图,按 T 可切换到 3D 场景并旋转、漫游,即为启动成功。

常见问题

Q:需要 npm install 或构建吗?

A:不需要。项目是原生 HTML/CSS/JavaScript,无框架、无构建步骤,整个应用就是一个 index.html,打开即用。

Q:3D 场景是空白或加载不出来?

A:Three.js 通过 jsDelivr CDN 加载,首次打开 3D 需要联网。请检查网络是否可访问 CDN,或刷新页面重试。

Q:8000 端口被占用怎么办?

A:换一个端口启动即可,例如 python3 -m http.server 8080,然后访问 http://localhost:8080。

Q:我的方案会丢吗?

A:方案会自动保存在浏览器本地存储中,同时也可以用导出 / 导入方案 JSON 的方式备份和迁移。

注意事项

  • README 中的 git clone 命令写的是 <仓库地址> 占位符,克隆时请替换为项目真实地址。
  • 首次打开 3D 场景必须联网加载 Three.js CDN 资源。
  • 设计好的方案保存在浏览器本地,换浏览器或清理缓存可能丢失,建议导出 JSON 备份。
  • 2D 平面图按原始户型 1:60 / 1:100 比例显示,尺寸单位为 mm。

核心亮点

  • 纯前端实现,浏览器打开即用,无需安装建模软件
  • 支持从二维户型图自动生成三维墙体与地板,降低建模门槛
  • 可嵌入网页,方便房产、装修类网站快速集成展示

不足之处

  • 项目以 HTML 为主,工程化与模块化程度有限,复杂户型识别精度待验证
  • 文档和社区生态较新,长期维护与扩展性待观察

适用场景

  • 房产中介网站展示房源三维户型
  • 装修公司快速生成客户户型预览
  • 游戏或虚拟场景中搭建室内关卡原型

替代项目

three.js、Sweet Home 3D、Blender

上一篇:xiaokeai

下一篇:CorbeauSplat

同类项目推荐

Nova3D 开源

一句话生成可编辑3D模型,支持文本和图片输入。

Design workspace for programmable 3D. Nova builds assets and worlds as editable, ver···

★ 767 2026-08-09
FlexiDreamer 开源

单张照片秒变 3D 模型,用 FlexiCubes 快速生成网格。

An official implementation of FlexiDreamer: Single Image-to-3D Generation with Flexi···

★ 78 2026-08-09
ChatVRM 开源

浏览器里让 VRM 虚拟人开口和你聊天

Chat with VRM avatar via LLM

★ 151 2026-10-28
MHR 开源

Meta 开源参数化人体模型,骨骼+网格+表情一套搞定

Momentum Human Rig is an anatomically-inspired parametric full-body digital human mo···

★ 908 2026-09-13
MoDA 开源

一张照片加一段语音,生成口型同步的数字人视频

MoDA: Multi-modal Diffusion Architecture for Talking Head Generation

★ 276 2026-08-09
Hunyuan3D-Omni 开源

一句话生成3D模型,还能用文字改细节

Hunyuan3D-Omni: A Unified Framework for Controllable Generation of 3D Assets

★ 667 2026-08-09
StableGen 开源

在 Blender 里用 AI 一键生成纹理,告别繁琐贴图流程

Transform your 3D texturing workflow with the power of generative AI, directly withi···

★ 1689 2026-08-09
Sin3DM 开源

一张3D模型,训练出无限变体,生成多样新形状

single 3D shape diffusion model

★ 141 2026-08-09
GE3D 开源

用文本编辑3D模型,无需重新训练,快速出效果

Text-to-3D Generation by 2D Editing

★ 112 2026-08-09