把“智慧仓储数字孪生”这种听着就很重的项目，用一套轻量工具组合在几天内跑通Demo，放在一年前我觉得是痴人说梦。但现在有了 AI 编程代理配合 Blender MCP，这件事的难度直接从“需要一个五人小组”降到了“一个人 + 会聊天”。我最近完整走了一遍这套流程，踩了不少坑，也积累了一套可以直接复用的工作方法，趁着热乎劲把上半篇整理出来——先说清思路和基础搭建，重点讲怎么把 Antigravity 和 Blender MCP 接起来，用自然语言直接操控 Blender 把三维仓储场景一点点建出来。如果你正准备做数字孪生方向的课题、毕设、产品原型，或者只是想在公司内部快速做一个可视化演示方案，这篇文章应该能省下你大量试错时间。
1. 项目整体拆解：为什么数字孪生偏要选 Antigravity + Blender MCP
1.1 智慧仓储数字孪生到底是个什么东西
先说一个容易被绕进去的概念。智慧仓储数字孪生不是“建一个仓库的 3D 模型”这么简单，它真正的价值在于“映射”和“联动”：三维场景里的货架、库位、货物、AGV（自动导引车）、叉车、传送带，要和现实世界里的物理对象一一对应，还要能接收实时数据（库存、设备状态、订单流），让虚拟场景跟着现实一起动。这其实是一条完整链路：数据采集 → 数据传输 → 场景建模 → 数据绑定 → 可视化渲染 → 业务联动。
很多人在第一步就卡住，觉得选型太痛苦。用 Unity/DCC 大厂套件功能全但要钱要人，用 Web 轻量化方案 Three.js 好上手但建模又不行。从这里就能看出 Antigravity + Blender MCP 这个组合的特殊之处：Antigravity 是一个云端的 AI 编程代理，能理解自然语言并自动写代码、执行代码、预览效果；Blender MCP 则是一座桥，把 AI 大模型和 Blender 这个开源三维创作软件直接打通。两者结合在一起，你等于拥有了一个“听得懂人话的三维建模师”，它能按你的口头描述在 Blender 里建模、摆放、打光、渲染，甚至帮你写 Python 脚本处理大批量数据。
1.2 这套组合的设计核心：用对话代替手动建模
我之所以选这套组合，核心原因是“效率密度”极高。传统 Blender 建模流程是：记住菜单位置 → 反复拖拽点线面 → 调参数 → 渲染看效果 → 不满意推翻重来。一个仓储场景哪怕简化到三十个货架、五条通道，也要耗费一整天。但配上 MCP 之后，大模型直接拿到了 Blender 的“眼睛”（场景状态）和“手”（执行指令的通道），你只需要说“在坐标（2, 2, 0）到（10, 2, 0）这段长度上，生成一排 5 组双面货架，每组 4 层，层高 0.5 米，颜色统一用灰蓝色”，它就能在你面前实时把这个模型垒出来。
这个流程的本质是通过 MCP 协议把 AI 从“只能输出代码文本”升级成“能操作真实软件实例”。Antigravity 本身作为代理，负责理解你的意图、规划步骤、执行命令、观察反馈，遇到渲染异常或建模偏差还能自己纠正。人和 AI 之间不是“你问我答”，而是你在旁边看它干活、随时插手修正，这比纯自然语言聊天生成一段代码要有掌控感得多。
1.3 一个 Demo 应该覆盖哪些核心模块
为了不让项目失控，我强烈建议第一版只做四个模块：仓储主体结构（墙地顶）、存储系统（货架 + 库位 + 托盘/周转箱）、搬运设备（AGV + 叉车 + 传送带）、路径标识（地面导引线 + 安全区域）。这四个模块基本覆盖了仓储场景的所有典型视觉元素，做出来之后数字孪生的“形”就有了。数据驱动部分（库存变化、设备运行动画）放在第二期再接，因为建模阶段就把实时接口耦合进来，会极大拖慢迭代速度，而且一旦模型改动还要来回切换环境，痛不欲生。
2. 环境准备：Antigravity 和 Blender MCP 的安装接线
2.1 Antigravity 端的准备
Antigravity 算是我最近用得比较顺手的 AI 编程工具，它的工作模式介于传统 IDE 和 AI Chat 之间，给的是一个云端工作空间，能直接启动服务器、预览页面、执行 Python 脚本。我这边建议直接在官网注册账号后用它自带的浏览器工作区，不要本地化折腾。打开工作区之后，你首先会看到的是一个类似在线 IDE 的界面，左侧文件树，中间代码区，右侧还有预览面板，新手也不需要额外安装任何东西。
首次使用会有几道基础检查，比如账号资格验证、地区服务开通等，网速不稳定时偶尔会报“eligibility check failed”或“403”。这类问题大多是网络链路不稳定造成的，怎么做我会放到后面第四部分专门讲，这里只需要记住三条原则：优先使用稳定的网络环境、清理当前会话后重新登录、不要同时开多个代理任务抢占资源。技术上不要在自己的环境里乱挂代理或随意改 hosts，避免把 Antigravity 官方 API 的路由搞乱。如果一直失败，可以考虑换个时段再试，常见于高峰期拥堵。
2.2 Blender 端准备与 MCP 插件的加载
接下来是三维创作端。我使用的是 Blender 4.2 LTS 版本，MCP 插件兼容性较好。先把 GitHub 上的 blender-mcp 项目下载下来，解压后你会看到两个关键部件：一个是放在 Blender 插件目录里的 addon（MCP 服务器插件），一个是用来启动 MCP 控制台的 Python 脚本。
加载插件流程十分标准化：打开 Blender，进入 Edit → Preferences → Add-ons，右上角点击 Install，选中插件压缩包或解压后的目录，然后勾选启用（比如叫 “Blender MCP”）。启用后你需要在 3D 视图右侧的 N 面板里找到 Blender MCP 选项卡，把 MCP Server 的入口打开，也就是点击“Start MCP Server”按钮。此时 Blender 已经在本地 TCP 端口上实际运行了一个 MCP 服务器。这个步骤容易卡在端口被占用，解决方案很简单：换一个端口（比如 9876 改成 9877），或者关掉其他占用了本地端口的程序再重启。
以下是我这里实际加载成功的配置示意：
MCP Server Address: 127.0.0.1 MCP Server Port: 9876 Auth Token:（默认空白即可，本机调试不需要）2.3 把 Antigravity 和 Blender MCP 接起来
这一步是整个流程的“接线核心”。在 Antigravity 工作区里找到 MCP 配置入口（不同版本位置略有不同，搜索“MCP”或“Connections”即可），你需要添加一个自定义 MCP Server，类型选stdio，然后告诉它去本地启动那个控制台脚本。
我会贴一个通用的启动配置，根据你的实际路径调整即可：
{ "mcpServers": { "blender": { "command": "python", "args": [ "D:/Projects/blender-mcp/blender_mcp_console.py" ], "cwd": "D:/Projects/blender-mcp" } } }这里有个细节：command里的 python 必须是能访问你整个 Python 环境可执行文件路径的那个解释器，在 Windows 上踩坑最多的是直接裸写python但系统 PATH 没配好，导致 Antigravity 怎么都连不上。改成绝对路径是最稳妥的，比如C:/Users/你的用户名/AppData/Local/Programs/Python/Python312/python.exe。
配置保存后，回到 Antigravity 的对话界面，先打一句“list tools in blender”或者“查看 blender 这个 MCP 服务器有哪些工具”，能看到 tools 列表就说明连接成功。我这边当时成功返回了一套工具清单，包括创建物体、变换、材质、顶点编辑等能力——到这里就可以开始建模对话了。
3. 实操全过程：用自然语言搭建一个仓储三维场景
3.1 先定场景尺寸与地基：这是后续所有尺寸的基准
我把整个仓储场景设计成一个模块化的矩形空间，长 60 米、宽 30 米、高 8 米。之所以选这个尺寸，是因为它能容纳 6-8 排双面货架，中间还能塞下两条输送带和若干个 AGV 充电位，视觉比例也符合真实仓库的长宽比。在 Blender 里先按这个尺寸生成一块地板：
import bpy bpy.ops.mesh.primitive_plane_add(size=60, location=(0, 0, 0)) bpy.context.object.name = "Warehouse_Floor" bpy.context.object.scale[1] = 1 # 单独控制缩放时注意这里并不改变长宽比实际上上面这段会生成一个 60×60 的平面，要得到 60×30 需要针对 X/Y 轴做非等比缩放，或者直接用primitive_plane_add后修改顶点坐标。MCP 执行时经常会把“size=60”理解成单个参数而不是二维宽高，所以我在第二版直接让 MCP 生成一个长方体作为地面更省事：
bpy.ops.mesh.primitive_cube_add(size=1, location=(30, 15, -0.1)) bpy.context.object.scale = (60, 30, 0.2)这里把地面做成了一个厚度 0.2 米的超薄长方体，后续做碰撞、渲染、加阴影都不会穿帮。地面之上，又让 MCP 补了四面围墙和顶部框架。与地面做法类似，全部用 Cube 缩放生成，材料统一用灰色金属质感。
3.2 一排排货架与库位：理解“批量思维”
仓储建模最忌讳一个货架一个货架地手动画。正确的思路是：先定义单组货架，然后阵列复制。每排双面货架的逻辑结构是“底座 + 两根立柱 + 横梁 + 隔板 + 库位”，我用 Blender MCP 一次性生成一个“单位货架”，然后让它沿着 X 方向重复 6 次、再镜像一排、做成两排对向布局。
以下是简化后的示意，重点是让 MCP 按这个思路执行：
import bpy # 定义单排货架参数 shelf_width = 2.4 shelf_depth = 1.2 shelf_height = 4.5 level_count = 4 unit_count = 6 gap = 0.5 # 以循环生成一排货架 for i in range(unit_count): x = i * (shelf_width + gap) bpy.ops.mesh.primitive_cube_add(size=1, location=(x, 0, 0)) bpy.context.object.scale = (shelf_width, shelf_depth, shelf_height) bpy.context.object.name = f"Shelf_Unit_{i+1}"真实的对话里，我并不会一句句把这种代码打出来，而是给 Antigravity 下指令：“创建一个单排 6 组货架，每组宽度 2.4m、深度 1.2m、高度 4.5m，4 层库位，货架间距 0.5m，整体沿 X 轴第一排放在 Y 轴负侧 5 米位置，第二排放在 Y 轴正侧 5 米位置、镜像翻转。”几个来回内它就把整个货架区创建完了，还自动给每层生成了库位编号（A-01-01 到 B-02-04 这种格式）。这一步特别能体现 MCP 的威力：它不只是执行单个命令，而是拆解你的描述、规划一个多步骤流程、逐步执行并汇总结果。
货架完成后的状态应该是这样的：两排货架平行于 X 轴，中间留出一条宽阔的主通道，主通道宽度大概在 3.5 米左右，符合叉车转弯半径，中央还能再划出 AGV 导引路径。建模到这里，“空房间”就开始有仓库的样子了。
3.3 通道与地面标识：用颜色和贴花表达规则
数字孪生场景里，地面标识不仅仅是装饰，它们代表着业务规则：蓝色路径是 AGV 行走通道，黄色区域是安全围挡，红白相间的是叉车作业区。通过 MCP 我在地面上生成了一堆扁平的平行四边形和半透明色块，用最简单的原理——纯色材质 + 低层厚立方体——拼出路径和分区。
需要注意的一个操作点是：地面标识这类元素必须单独放一个集合（Collection）里，例如叫Markings，因为后续导出到游戏引擎或 Web 前端时，标识可以整体显隐。如果你让 MCP 把标识和地面混在同一个集合里，后面改透明度会遇到“连带影响地面”的尴尬局面。我自己第一次图省事就踩了这个坑，后来花了半小时重新分集合，得不偿失。
3.4 添加关键设备：传送带、叉车和 AGV
下一步是给场景配备核心作业设备。传送带我让 MCP 用多个长方体拼成：支架、辊筒、传送面，再加个简单的循环动画——不过第一版建议先不做动画，等数据联动时再绑定。叉车模型相对复杂，Blender 里没内置现成的，我在网上找了一个免费低模 STL 导入，再丢给 MCP 做简化和重命名。
如果你也打算导入外部模型，有个重要经验：导入后第一件事就是清空原点、统一比例尺、重命名对象。Antigravity 操作 Blender 时经常依赖对象名称识别场景，一套乱七八糟的名字会让它抓狂。MCP 工具里一般有 rename 工具，直接在对话里让它扫描所有未命名对象并批量重命名即可。AGV 我用的是几个圆柱体（车轮）加一个倒角立方体（车体）搭的，属于“能看出是 AGV”的程度，第一版完全够用。
3.5 灯光、相机与第一张效果图
建模到最后，场景需要一个好的呈现效果。Blender 默认的灯光是点光源，仓储这种大空间要用面光或者日光模拟天窗效果。我给 Antigravity 的指令是：“在场景顶部 Y=7 的位置生成 6 盏面光，光源方向朝下，强度 500W，色温偏冷白；再在入口处打一盏柔光灯补齐阴影。”之后又设置了一个环绕相机的相机约束，让它能沿椭圆轨迹围绕仓库中心旋转。
相机调好后，我用 MCP 发了一个渲染指令，Blender 开始跑 Cycles 或 Eevee。这里我强烈建议预览渲染用 Eevee，快且够用，ArchView 级别的出图才切 Cycles。通过 MCP 渲染出第一张图之后，可以把它直接回传展示给 Antigravity，它会基于图片继续判断空间布局是否有问题。这一步能显著提升后续修改的精准度——你问它“第一张图能不能看到左侧通道太窄”它会真的看图，然后直接下手改。
4. 常见问题排查与避坑实录
4.1 Antigravity 端连接报错处理
实际使用中遇到最多的报错是agent execution terminated due to error。一看到这个提示很多人以为项目废了，其实绝大多数情况下是任务队列堵塞或者 MCP 调用超时。我的排查顺序是：
- 检查 Blender 的 MCP Server 状态是否还在运行，长时间未操作会自动掉线，点一下 Start 重新拉起。
- 检查 Antigravity 工作区是否因为长时间运行内存暴涨，直接刷新页面重进，比冷静找 bug 更快。
- 把任务拆小。比如“生成整个仓储”改成“生成地面 → 生成货架 → 生成设备”，每个指令执行完确认结果没问题再发下一个。不是 MCP 能力不够，而是单次任务上下文太大时校验成本高，容易把 agent 拖死。
eligibility check failed和403一起说，因为它们都是账户/访问链路层面的问题。出现后先去官方状态页看看服务是否有异常，再确认本地网络是否可正常访问外网服务，最后检查账户是否完成必要验证。反复失败就过几分钟重试，这招对付临时性风控很管用。配置文件层面不要乱改请求头、代理参数，这些修改只会增加不确定性。
4.2 Blender MCP 常见的建模翻车现场
MCP 执行删除指令时有时会很激进——你明明只是让它删掉一个多余的立方体，它顺带把同一集合里别的物体也清了。这是因为我给的指令不够精确，比如我写的是“删除临时物体”，而语义上”临时“是模糊限定词。改成“删除名为 Temp_002 的物体，保留集合 Markings 中所有对象”，它就不会误伤。
场景里对象多了之后，MCP 返回场景状态会变慢，因为每次操作后它都要把当前场景快照信息推送给大模型。我的优化办法是：尽量避免一次在场景里堆上千个对象。仓储 Demo 场景里共有大概 200 个左右对象就很流畅了，数量骤增时可以让 MCP 使用实例化（Instance）代替复制（Duplicate），模型逻辑清晰且内存占用也小。
4.3 提示词模板：让 AI 更懂你的仓储术语
经过多次实验，我总结出一套高成功率的建模范式，跟纯聊天完全不同。核心公式是“目标 + 位置 + 尺寸 + 材质 + 命名规范 + 集合归属 + 检查项”。举个例子：
创建一组货架，位置在 X 轴 8 到 20 米，Y 轴 -6 米，双面四层，每层高度 0.5 米， 货架整体用深灰色金属材质，立柱用深蓝色，所有对象命名以 Shelf_ZoneA_ 开头， 放在集合 Storage_Rack 下。完成后列出创建的对象数量和每个对象的位置。这个补全能力相当实用，因为“双面货架”“库位净空”“托盘位”这些行业概念，AI 会有意无意地做出偏差，你只有把约束写清楚，它才有机会给你真正想要的东西。跟人沟通一样，越精确的意图越容易获得高质量输出。
4.4 关于 3D 点云辅助建模的一点经验
搜索热词里边我看见有人问“点云怎么拉框”。如果你的仓储项目有三维激光扫描点云，可以通过 Blender 插件把.ply/.las点云导入场景。这时候 Antigravity + MCP 能帮你做的，是根据点云轮廓在场景里生成简化的实体盒子和边界框，用来反推真实货架尺寸。但注意，点云计算非常吃显存，几十 GB 的数据大家分块导入，一次导入 5% 的场景，生成粗模后再整体合并。不要试图一步到位让 AI 根据全景点云重建全套货架，慢且不稳定，分块化简反而是最佳路径。
5. 二期展望与实际产线衔接方向
做到这里，这套“Antigravity + Blender MCP”打造的智慧仓储数字孪生已经具备了看得见、摸得着的三维场景骨架。但离真正的“智慧”还差最后一步：数据。我的二期计划是为每个货架库位绑定实时库存数据，用前端数字孪生网站（基于 Three.js 或 WebGIS）去读取仓库数据库，然后动态更新三维场景里的托盘、库存色块和数量标签；AGV 则用 Nav2 路径规划算法在仿真环境里跑通调度逻辑，再把轨迹实时回传到 Blender 三维场景里叠加渲染。这套斜街目前圈内讨论也多，等我把数据通道这一层调试稳定，再更新下半篇，到时候把 Antigravity 如何写 Web 前端、如何和 Blender 场景交互、如何在移动端甚至 VR 眼镜里看仓库这些问题一次讲透。
在整个实操过程中，我最大的体会是：工具进步并没有消除思考，而是把思考的层次抬高了——以前花时间记快捷键拉模型，现在腾出精力去设计场景逻辑、规划数据流和校验业务合理性。Antigravity 加 Blender MCP 只是第一步，真正拉开差距的，是你能不能把这套数字孪生场景变成业务决策的工具，而不仅仅是一张好看的效果图。
