一个世界里放了多少东西,怎么数得清:自部署 3D 世界的资产台账
3D世界资产台账、自部署3D资产管理、GLB模型版本管理、模型引用位置与回滚、3D素材来源与授权记录、模型库193个上传模型、对象列表1152、模型限额与三角面数、3D展厅资产替换流程、创世Genesis模型库
编辑器里能看到「已上传模型 193 个」「场景对象 1152 个」。数字很直观,但它回答不了另外几个问题:哪个是正式版、哪个是谁临时传上来试的、换掉一个模型要动哪几处、删了会不会让别的对象找不到引用。这些不是渲染问题,是记录问题。
这篇讲的是创世Genesis/创世虚拟世界CRM系统里,一个自己部署的世界应该怎么立一份资产台账。压缩、减面、贴图瘦身是另一件事,线上已有专门文章谈技术过程;这里只谈记录、责任与替换流程。
写在前面:我们提供的是部署在你自己服务器上的浏览器端 3D 基座,不接展厅代建、不派团队实施。文中图是我们自己测试世界与自部署后台的截图,不是客户环境;我们没有资产托管客户案例。
许可口径:源码开放(source-available),本地跑不花钱;要联网、要商用、要联邦,需要订阅授权。 准确条款在仓库 LICENSE / EULA 里。底座是完整可用的,下面说的是怎么管,不是补功能。
这篇讲三件事

- 一个世界里的东西先分成几类,分类错了台账就立不住
- 台账该记哪几列,以及每列为什么不能省
- 替换一个模型时实际动了哪几处,怎么回滚
上图是编辑器「Model Library」一页:左侧已上传模型 193 个,右侧对象列表 1152 个,中间是同一个世界的网格视口。这两个数字来自我们自己的测试世界,不是客户数据,也不代表容量上限。它说明台账的起点是「现在有多少、叫什么」,而不是先去想怎么优化。
一、先把资产分成几类
把什么都叫「模型」,后面一定乱。按「改动后影响什么」分,比较稳:
| 类别 | 具体是什么 | 改动影响 | 归属 |
|---|---|---|---|
| 立体模型 | GLB / GLTF / VRM / OBJ 等文件,角色、建筑、展品 | 几何、贴图、动画与碰撞 | 文件 + 引用它的对象 |
| 图片与贴图 | 展板上的图、地面材质、天空全景图 | 画面内容,不改几何 | 图片文件 + 贴图槽位 |
| 文字与展签 | 标题、说明、AI 描述、多语言文案 | 读到的内容,不改画面结构 | 数据库里的记录 |
| 场景状态 | 对象摆位、朝向、初始视角、天气与地形参数 | 走进去看到的样子 | 场景配置与库表 |
| 代码与依赖 | 前端打包产物、服务端代码、配置项 | 整套系统能不能跑 | 仓库与部署目录 |
前三类是「素材」,后两类是「状态」。 素材可以整份替换,状态只能逐项改。台账要把这两类分开记:素材记文件与授权,状态记谁在什么时候改了哪一格。

上图是测试世界里立着的图片展板与文字标牌,角色可以走到跟前看。平面素材与立体模型是两类资产,台账里该分开放;图里是产品自带的示意内容,不是任何客户的展品。
二、台账该记哪几列
不要求上系统,一张表就够。列的意义在于「换人的时候还能接得上」:
| 字段 | 写什么 | 省了会怎样 |
|---|---|---|
| 标识名 | 文件名与场景里的对象名,两者对得上 | 换模型时找不到引用在哪 |
| 类别 | 按上一节的五类填 | 图片和模型混着删 |
| 来源与授权 | 谁做的、从哪来、能否公开与商用 | 上线后被要求撤下,来不及找依据 |
| 版本与日期 | 当前是哪一版、什么时候换的 | 新旧文件同名,分不清哪个在用 |
| 改动人 | 谁上传、谁摆位、谁改的文字 | 出问题没人知道问谁 |
| 引用位置 | 被哪些场景/对象用到 | 删掉后别处出现空白或报错 |
| 体积与规格 | 文件大小、三角面数、贴图尺寸 | 换上去才发现超过限额或加载变慢 |
「来源与授权」这一列别省。 自己生成的模型、第三方下载的模型、客户提供的素材,能不能公开展示不是一回事,得由你确认。我们自己也做过一次资产盘点,把 3.1GB 瘦到 390MB,那是压缩与清理的工作,跟「这些资产能不能用」是两个问题。
后台还有一组限额参数值得抄进台账:文件大小、三角面数、骨骼数、Agent 数量等上限都做成了可调项,并写明超限后的处理方式。它们是配置阈值,不是性能实测结果;写下来之后,换模型的人不用猜边界在哪。
三、替换一个模型,实际动了哪几处

| 顺序 | 动作 | 容易漏掉的 |
|---|---|---|
| 1 | 记下旧文件的标识名、版本与被引用位置 | 没记引用,回滚时不知道要还原哪些对象 |
| 2 | 确认新文件的格式、体积与三角面数在限额内 | 只看了能不能打开,没看规格 |
| 3 | 在测试世界先传一份,不覆盖正式文件 | 直接覆盖,出问题没有退路 |
| 4 | 复核骨骼、动画与缩放是否和旧版一致 | 角色动画错位、物体忽大忽小 |
| 5 | 把引用切到新文件,逐处走一遍 | 只改了看得到的那一个,别处还是旧的 |
| 6 | 更新台账,旧文件标记保留期限而不是立刻删 | 立刻删掉,后来发现某处仍在引用 |
这套顺序的核心是先留退路,再切换。自部署的好处是文件与库都在你手上,回滚不用求人;代价是没有别人替你记这六步,也没有别人替你确认旧文件能不能删。
顺带说清一个边界:对象摆位、天气、地形参数属于场景状态,换模型不会自动带着它们走。跨世界复用一套内容,要另做配置迁移,不是复制文件就完事。
四、明确做不到的
- 不托管资产库、不托管知识库,模型与图片需自备,文件存在你自己的服务器上,我们不替你保管
- 不提供受版权保护的商业模型或图片,公开授权由你确认
- 不自动判断素材能不能商用,也不做版权审查
- 不自动记录改动人、审批流与版本历史,台账要你自己立;系统给的是对象列表与文件列表,不是管理制度
- 不替你做替换后的业务验收,骨骼、动画、缩放与引用完整性都要人走一遍
- 不接代建、不派团队实施,上传、命名、布场、写展签都由你做或另请人做
- 自动整理孤儿资产、自动写资产说明属于 planned(规划中,尚未实现);即便接入,AI 看不见画面、不知道你的意图,每条结论要人核
五、这块的边界
- 我们没有资产托管客户案例,上面的字段与替换顺序来自我们自己维护这套系统的经验,不是行业标准
- 文中「193 个模型 / 1152 个对象」是测试世界某一刻的存量,不是容量上限,也不是性能结论
- 文中图是测试世界的录屏帧与自部署后台截图,不是客户环境;画面里是产品自带的示意内容
- 限额数值随你的部署与内容变化,需要在你自己的设备上实测,这里不给通用数值
- 手机端的完整体验需要在真实设备上实测,资产体积变化后的加载与发热随内容变化
- 许可性质以仓库 LICENSE / EULA 为准(仓库标注为 Subscription License);我们一律用「源码开放 / source-available」来称呼它,请勿按 OSI 许可理解
六、常见问题
问:只有几十件东西,也要立台账吗?
可以先只记三列:标识名、来源与授权、引用位置。等到出现第二个人帮你改内容,再把版本和改动人补上。台账是为了换人时接得上,不是为了好看。
问:旧文件什么时候能删?
过了一个完整的替换周期,且确认没有对象仍指向它之后。后台的清理类任务能帮你查孤儿引用,但删不删由你定;我们不建议在切换当天删。
问:一个模型被好几个场景引用,改一处其他会跟着变吗?
文件只有一份,指向它的对象都会看到新内容,摆位与朝向不会跟着变。所以「引用位置」那一列不是形式,它决定了你要走几处复核。
问:能不能把资产交给你们托管?
不托管。数据落在你自己的服务器上正是这套东西的用法,备份与文件管理也一并归你。要做可以自己来,或另找人。
问:AI 能帮我自动写资产说明吗?
目前不能自动出。写说明这件事涉及意图与授权判断,AI 看不见画面、不知道你的意图,写出来要人核;相关能力属于规划中,尚未实现。
源码与仓库
- 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能以具身角色进入你部署的世界。数据运行在你自己的服务器上,不经过第三方平台——让每个世界都真正属于它的主人。
台账不是为了记录而记录,是为了换模型时留得下退路、换人时接得上;把素材与状态分开记,把来源与授权写进表里,替换按六步走,自部署才真的把改动权留在自己手上。 SEO / AI 友好关键词:3D世界资产台账、自部署3D资产管理、GLB模型版本管理、模型引用位置与回滚、3D素材来源与授权记录、模型库193个上传模型、对象列表1152、模型限额与三角面数、3D展厅资产替换流程、创世Genesis模型库
关于名字:本文说的创世Genesis,即创世虚拟世界CRM系统,是一套浏览器端自部署的 3D 虚拟世界基底;搜「创世Genesis 3D」不一定找得到,直接搜「创世虚拟世界CRM」即可。