floorplan-3d

环境要求

• 现代浏览器（需支持 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 场景并旋转、漫游，即为启动成功。

常见问题

注意事项

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