
floorplan-3d
上传户型图,秒变可旋转的3D房间
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-05 · 当前星标 ★ 3847
使用教程
环境要求
- 现代浏览器(需支持 WebGL,用于 3D 场景渲染)
- Git(用于克隆仓库)
- Python 3(可选,用来自起本地静态服务器)
- 首次打开 3D 场景需联网(Three.js 通过 jsDelivr CDN 加载)
安装与启动步骤
-
1克隆仓库
把项目代码下载到本地,README 中仓库地址为占位符,这里填入项目实际地址。
git clone https://github.com/wy51ai/floorplan-3d.git -
2进入项目目录
切换到刚克隆下来的目录,后续命令都在此目录执行。
cd floorplan-3d -
3启动本地服务器
项目是纯前端页面,直接双击也可用;起静态服务器访问更稳定,端口用 8000。
python3 -m http.server 8000 -
4在浏览器中访问
打开 http://localhost:8000,也可直接双击项目里的 index.html 打开。
-
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···
FlexiDreamer
开源
单张照片秒变 3D 模型,用 FlexiCubes 快速生成网格。
An official implementation of FlexiDreamer: Single Image-to-3D Generation with Flexi···
ChatVRM
开源
浏览器里让 VRM 虚拟人开口和你聊天
Chat with VRM avatar via LLM
MHR
开源
Meta 开源参数化人体模型,骨骼+网格+表情一套搞定
Momentum Human Rig is an anatomically-inspired parametric full-body digital human mo···
MoDA
开源
一张照片加一段语音,生成口型同步的数字人视频
MoDA: Multi-modal Diffusion Architecture for Talking Head Generation
Hunyuan3D-Omni
开源
一句话生成3D模型,还能用文字改细节
Hunyuan3D-Omni: A Unified Framework for Controllable Generation of 3D Assets
StableGen
开源
在 Blender 里用 AI 一键生成纹理,告别繁琐贴图流程
Transform your 3D texturing workflow with the power of generative AI, directly withi···
Sin3DM
开源
一张3D模型,训练出无限变体,生成多样新形状
single 3D shape diffusion model
GE3D
开源
用文本编辑3D模型,无需重新训练,快速出效果
Text-to-3D Generation by 2D Editing