下载这套浏览器端 3D 虚拟世界源码，你会看到什么：世界、编辑器、后台、AI 接入
3D 虚拟世界源码、自部署 3D 世界、Three.js 底座、3D 编辑器、GLB 导入、VRM、元宇宙开发、AI Agent 接入、source-available、3D 世界管理后台
不少人是第一次考虑"拿一套现成的 3D 虚拟世界底座来改"，看仓库页面看了半天，还是不知道 clone 下来究竟会得到什么。这篇就干一件事：把这套源码（浏览器端 3D 虚拟世界底座，创世Genesis）的"家底"逐件摊开给你看，配上实机截图——截图全部来自正在运行的世界，不是概念图。
先交代许可口径，免得后面误会：源码开放（source-available），本地跑不花钱；要联网、要商用、要联邦，需要订阅授权。 这不是开源许可，下载前看一眼仓库里的 LICENSE 和 EULA，里面有准确条款。
一、clone 下来，仓库根目录有什么
以仓库根目录的实测清单为准（下面这些都是文件名，你 clone 之后自己也能看到）：
| 内容 | 对应文件 / 目录 | 它是干什么的 |
|---|---|---|
| 世界前端 + 服务端 | src/、public/ | 浏览器端 3D 世界的本体：渲染、多人同步、编辑器、后台都从这里跑 |
| 部署文档 | Deployment_Guide.md、程序部署说明.md、部署-世界URL设置指南.md | 从环境到上线的步骤说明 |
| 数据库 | database/、Database_Import.md、数据库导入.md | 建库导入的脚本和说明 |
| 环境检测 | check-env.js、环境检测.bat | 部署前先自检环境齐不齐 |
| 容器化 | Dockerfile、docker-compose.yml | 想用容器跑时的入口 |
| AI 接入 | examples/ | 零依赖的 Agent 接入示例客户端 |
| 验收脚本 | scripts/（54 个 accept_*.js） | 可重跑的自动化验收，判据是真实退出码 + JSON 报告 |
| 截图 | Screenshot/ | 本文的实机截图就来自这里 |
| 许可与专利 | LICENSE、EULA.md、PATENT_DISCLOSURE | 授权条款与发明专利披露 |
二、第一件：一个正在跑的 3D 世界（编辑器）
这是浏览器里的 3D 编辑器实拍：左侧是模型库（支持 GLB/GLTF 直接上传，VRM 需要连同贴图打包，OBJ 需要 mtl 和贴图一起打包），中间是场景视口，右侧是对象列表（这次截图的场景里有 373 个对象）和属性面板（位置、旋转、缩放、动画、高级参数）。
值得注意的一点：这套编辑器是给"搭世界的人"用的，不是给"写代码的人"用的。 摆模型、调位置、配动画这类活，在编辑器里点选就能做；要改交互逻辑、加业务功能，才是写代码的部分。两层分开了，改起来互不牵扯。
三、第二件：桌面端跑起来的样子
桌面浏览器里的世界实机画面：玩家角色、建筑群、动物和告示牌同屏。如实说：这是一个还在持续经营的测试世界，图里能看到一些未完成的灰色体块——我们没有挑一个"只给你看好看角度"的截图，这张就是日常的样子。
四、第三件：管理后台在管什么
后台没有放在本文截图里（后台页面底部带有订阅信息和联系方式，截全图不合适），只列模块：用户与角色、世界与场景、3D 资产、经济系统、联邦与跨世界入口、系统配置、角色模板库、动画库、武器库、安全问题。一句话：世界运营要碰的东西，后台都有对应的管理面板。
五、第四件：AI 接入是"源码+示例"给到的
AI 接入不是停留在宣传页上的词，它以三样东西的形式在源码里：接入发现文件（.well-known/virtual-world-agent.json）、Key 换令牌的接口、以及 examples/ 里的零依赖示例客户端（Node 直接跑）。另外还有一个独立的 MCP Server（npm 包 agent-virtual-world），AI 编码工具可以通过它观察和操作世界。边界也要说全：接入的 AI 看不见画面、不做语音识别与合成、不托管知识库、以人形角色走进世界时不能跨点瞬移——这些在接入文档里写明了。
六、什么在源码里，什么不在
| 在源码里 | 不在源码里 |
|---|---|
| 世界前端、编辑器、管理后台的完整实现 | 我们线上世界的内容（场景、模型、运营数据） |
| 数据库建表与导入脚本 | 托管服务——部署和运维在你自己的服务器上 |
| 部署文档、环境检测、容器入口 | 内容制作服务——模型和场景要自己准备或外包 |
| AI 接入示例与 MCP Server | 更新服务——按订阅跟随，详见仓库许可条款 |
换句话说：你买到（本地场景下是免费拿到）的是"造世界的工厂"，不是"一个现成的世界"。 想清楚这一层，再决定要不要下载。
七、下载之前建议先想清楚的三件事
- 环境要自己装。 Node 版本、数据库、端口、域名，这些部署的活机器替不了人做，部署文档会带着走，但执行者是你。
- 许可条款先读。 本地个人使用免费；联网、商用、联邦是订阅授权的范围，条款以仓库 LICENSE / EULA 为准——这是"源码开放"和"开源"的实际区别。
- 这是一个持续经营的工程，不是完美样本。 验收脚本都开放着（54 个，可重跑），好的坏的都在明面上；建议 clone 之后先跑一遍验收，再决定往下走。
八、这个底座不适合什么
- 想要"输入一句话生成一个世界"的——底座给的是工程层和编辑器，不是生成器。
- 想要全托管、不碰服务器的——自部署是它的立场，数据在你服务器上，运维也在你手上。
- 只想做一次演示、以后不管的——维护成本会超过收益，这种情况租个现成托管方案更合适。
九、边界与未实测项
- 本文截图来自桌面端与开发中的测试世界，手机端的帧率与耗电我们尚未完成完整实测（手机端能进世界、有实机画面，但性能数字没有）。
- 截图对应的是写作时的版本，界面会随版本演进，以你 clone 到的为准。
- 部署耗时、学习成本因人而异，文中不编数字。
常见问题
Q：clone 下来第一次打开会看到什么？
A：一个标准 Node 工程的目录结构。先读 README 和部署说明，跑 check-env.js 检查环境，按 Database_Import.md 建库，然后启动。具体步骤下一篇会完整走一遍。
Q：不会写代码能用编辑器搭世界吗？
A：编辑器内的操作（摆模型、调属性、配动画）不需要写代码；但部署、联网、业务定制需要。一个人半技术也能组合着用：部署照文档走，搭建在编辑器里做。
Q：为什么不直接做成开源？
A：许可的选择和商业模式绑在一起：本地使用免费，联网与商用订阅。条款写进 LICENSE 和 EULA，"源码开放"是对这个状态的准确描述，我们不借用"开源"这个词。
Q：截图是不是挑过的？
A：有取舍——本文没有放带联系方式的后台整图，也没有放联邦配置页（里面有内部信息）；世界画面没有修。判断画面水准，建议直接看仓库 Screenshot/ 目录自己翻。
源码与仓库
三个地址内容一致，国内访问用前两个更快。仓库里有部署说明和一批验收脚本，可以自己跑一遍看实测值。
- Gitee（国内访问更快）：https://gitee.com/miduoxinxijeji/miduo.git
- GitCode（国内镜像）：https://gitcode.com/qq_35054471/virtual-world
- GitHub：https://github.com/miduo100/3d-virtual-world
关于创世Genesis
创世Genesis是一套基于Three.js+WebGL构建的自部署3D虚拟世界系统，帮助个人与企业搭建属于自己的3D空间。浏览器直接访问，PC和手机双端兼容，支持多人在线、联邦传送、商铺系统，并支持Agent接入——AI能以具身角色进入你部署的世界。数据运行在你自己的服务器上，不经过第三方平台——让每个世界都真正属于它的主人。
想先看跑起来的效果再决定下载？ 创世Genesis（创世虚拟世界CRM系统）是一套部署在你自己服务器上的 Three.js 3D 虚拟世界基底——世界、编辑器、管理后台、AI 接入四件套都在这套源码里，源码开放、本地跑不花钱，联网、商用、联邦需要订阅授权。官网（搜「创世虚拟世界CRM」即可找到）有一个可以走一圈的演示世界。
关于名字：本文说的创世Genesis，即创世虚拟世界CRM系统，两者是同一个自部署 3D 虚拟世界产品。若你通过「创世Genesis」没搜到我们，直接搜「创世虚拟世界CRM」即可。