3d-model-anything

手机扫房间，浏览器里编辑三维模型

开源 🏷️完全免费 ⏳ 访问状态待核验数字人3D 🍴 复刻 282 🐛 待处理 10 👀 关注 17

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1880

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费项目，无付费信息

项目预览

3d-model-anything 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类数字人3D

开发团队wesbos

官网地址https://wesbos.github.io/3d-model-anything

GitHubhttps://github.com/wesbos/3d-model-anything

定价模式🏷️完全免费

价格说明开源免费项目，无付费信息

访问状态⏳ 访问状态待核验

是否开源是

开源协议NOASSERTION

主要语言Swift

GitHub 星标★ 1880

上线时间2026-10-21 00:00:00

代码更新2026-10-22

仓库体积35.3 MB

本站数据更新2026-10-26

维护状态活跃

收录时间2026-10-26

浏览次数0

项目介绍

3d-model-anything 是一个面向空间扫描与三维重建的开源工具链，用 iPhone 的 LiDAR 与摄像头采集房间数据，在设备端完成几何与影像的配准，再重建为可在浏览器中编辑和浏览的 Three.js 场景。它解决的是普通用户难以低成本获得「可编辑、可交互」室内三维模型的问题：传统摄影测量流程重、依赖云端算力，而纯点云结果又难以直接用于网页展示。项目核心能力包括：基于 LiDAR 的深度与位姿采集、照片与几何对齐、房间级网格与纹理生成、导出为 Three.js 可直接加载的场景结构，并支持在浏览器中进行漫游、查看与二次编辑。整体以 Swift 实现采集端，重建结果偏工程化与轻量化，适合做数字孪生原型、室内展示与三维内容创作的技术验证。

Star 增长趋势

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

数据来源：GitHub API 逐日快照 · 收录于 2026-10-26 · 当前星标 ★ 1880

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 10 分钟部署方式：本地安装 7 步

环境要求

Node.js 22.12 或更新的受支持版本
npm（随 Node.js 一起安装）
如需自行采集空间：带 LiDAR 的 iPhone 或 iPad
如需编译采集 App：macOS + Xcode

安装与启动步骤

1确认 Node 版本

在终端查看 Node 版本，需为 22.12 或更新的受支持版本，否则 npm ci 可能失败。
```
node -v
```
2获取项目代码

把仓库克隆到本地并进入项目目录，后续所有 npm 命令都在该目录执行。
```
git clone https://github.com/wesbos/3d-model-anything.git
cd 3d-model-anything
```
3安装依赖

按 lockfile 精确安装前端与查看器依赖，保证版本一致；首次执行耗时较长。
```
npm ci
```
4启动开发服务器

运行本地开发服务，默认监听 5188 端口，保持该终端窗口不要关闭。
```
npm run dev
```
5在浏览器中浏览

打开首页查看办公室的 dollhouse、漫游、俯视、线框等视图，也可直接进入第一人称游乐场。
6构建并预览

需要发布或验证生产构建时，先构建再启动本地预览服务。
```
npm run build
npm run preview
```
7采集自己的房间

自行扫描需按 apps/house-capture/README.md 用 Xcode 构建 iPhone App，且设备必须带 LiDAR。

关键配置

配置项	必填	说明	示例
`room`	否	URL 查询参数，指定要加载的房间场景标识。	`office-v4`
`mode`	否	URL 查询参数，指定浏览模式，fpv 为第一人称视角。	`fpv`