DATASPACE3D是面向 3D 产品展示、数字孪生、在线展厅与交互演示的 Web3D 可视化搭建平台。
开放能力要做的事很具体:把工作台接到 Cursor / Claude Code 等 Agent——说清意图,空间里就出现可预览的真实项目;不满意就进编辑器继续改。生成是起点,控制权仍在你手里。本文按这条顺序写:先结论 → 五分钟接入 → 两个真实案例 → 再拆 Token / MCP / Skills → 扩展与工程边界。配图都是真实跑通结果,不是示意稿。
图 1 · 实际生成:Beijing Daily Max Temp (7d),柱顶标注日最高气温
Skills 包:https://cdn.dataspace3d.com/system/skills.zip
01. 先看结论:工作台接到 Agent,不是又写一段 Three.js
Web3D / 数字孪生里,费时间的通常不是画一根柱,而是整条工程链路:数据怎么进对象、资源能不能进空间库、对象树 / 相机 / 环境挂不齐就没法预览、确认后再进编辑器微调并决定是否发布。
「让 AI 写段 Three.js」多半停在本地片段——能看一眼,进不了平台资源体系,也接不上团队已有的项目与权限。开放能力换一条路:
任意 MCP 客户端,用你的空间权限,直接操作同一套工作台——不是另起一个玩具沙箱。
示意图 · 开放能力端到端闭环:自然语言 → Skills 编排 → MCP 写入 → 预览 → 编辑器 / 人工发布
| 以前 | 现在 |
|---|---|
| 手写几何体 + 本地页面 | Loader 进资源库,项目可复用 |
| 数据与展示各写一套胶水 | Agent 拉数 + Skills 组场景 |
| 生成完不知怎么给同事看 | 标准/project/run/{uid} |
| 上线与草稿搅在一起 | 预览优先,发布仍是显式操作 |
图 1 来自一键接入页推荐指令:Open-Meteo 拉北京近 7 日最高气温 → 3D 柱图 → 预览链接。下面先让你把 MCP / Skills 装上,再拆这条指令是怎么跑通的;原理放到案例后面。
02. 五分钟接入:复制一条提示词
- 登录工作台 →设置 → 开放能力 → Token 管理,创建私人访问 Token(明文仅创建时可见,请妥善保存)。
- 打开一键接入,把 Token 粘贴到本页(页面不会回读历史明文)。
- 复制生成的全能提示词,粘贴到任意 Agent 聊天框。
- Agent 会配置名为
dataspace3d的 MCP,并从 CDN 安装 / 覆盖四个 Skills。 - MCP 可用后,直接用 §03 / §04 的自然语言试跑。
设置菜单按上手顺序排:一键接入 → Token 管理 → MCP。
MCP 端点:
https://www.dataspace3d.com/api/mcp/dataspace3d/stateless/streamSkills 包(同名覆盖,可重复升级):
https://cdn.dataspace3d.com/system/skills.zip| Skill | 一句话 |
|---|---|
dav-object-loader | 自然语言 → 双引擎对象 Loader(.js+.md) |
dav-project-gui | 自然语言 → 项目 GUI(.js+.md) |
dav-register-asset | 已有交付物经 MCP 上架到空间资源库 |
dav-project-compose | 合成 / 改写项目与场景,返回预览链接 |
提示词模板(与产品一致)
请帮我安装或更新 dataspace3d 的 MCP 与 Skills(幂等:已有则覆盖更新,没有则新建)。 ## 1. 配置 MCP 在当前 Agent 的 MCP 配置中写入(或更新)名为 dataspace3d 的服务: - URL: https://www.dataspace3d.com/api/mcp/dataspace3d/stateless/stream - Header: Authorization: Bearer <your-token> 配置完成后请确认该 MCP 可用。 ## 2. 安装 / 更新 Skills 从 https://cdn.dataspace3d.com/system/skills.zip 下载并解压,安装到当前 Agent 的 skills 目录。 包内应包含:dav-object-loader、dav-project-gui、dav-register-asset、dav-project-compose。 已存在同名 skill 时直接覆盖更新。 ## 3. 完成后简要回报 说明 MCP 是否已接通、Skills 安装路径,以及下一步可试的一条示例指令。Cursor 手动配置时可用:
{"mcpServers":{"dataspace3d":{"url":"https://www.dataspace3d.com/api/mcp/dataspace3d/stateless/stream","headers":{"Authorization":"Bearer <your-token>"}}}}03. 跑通主案例:Open-Meteo → 北京气温 3D 柱图
一键接入页推荐场景卡原文:
基于 Open-Meteo 公开天气数据,拉取北京近 7 天日最高气温,生成一座 3D 柱状图场景并给我预览链接
图 1 就是这条指令跑出来的。
| 日期 | 日最高气温(℃) |
|---|---|
| 08-23 | 31.4 |
| 08-24 | 31.9 |
| 08-25 | 30.8 |
| 08-26 | 27.1 |
| 08-27 | 29.1 |
| 08-28 | 23.4 |
| 08-29 | 28.7 |
蓝粉双色立体柱、浅绿台面、柱顶数值与底部日期——已经是能挂进预览链接的场景,不是平面图表截图。
分工先钉死:Agent 调 Open-Meteo 等公开 API,整理日期与温度序列;DATASPACE3D 经 MCP 落项目、对象与预览。平台不托管天气服务。换能源、客流、KPI 也一样——换数据源,不换闭环。
本案例默认L1 Layout(场景 + 柱体 + 相机 / 环境)。换色面板是可选 L2,不必一次做满。
示意图 · 主案例典型 Skill 链路(L1):compose 主编排;缺 Loader 时生成并上架,再经 MCP 挂树并返回预览
你应拿到:可打开的预览链接;可选编辑器地址/editor/{projectUid};摘要(项目 / 场景 id、tier、新注册资源、降级项)。观感 OK 再进编辑器调相机、材质、灯光,最后人工发布。
04. 换数据源:仓库 2025 年 Git 日提交柱阵
天气柱图是「开放 API → 短时序」。工程团队更常讲贡献密度——同一套开放能力,把全年日提交落成可继续编辑的三维场景。
一句话生成该仓库 2025 年 Git 日提交记录的 3D 柱状图:X 轴为周序号,Z 轴为星期,Y 轴为当日提交次数;搭好场景并给我预览链接。
| 轴 | 含义 |
|---|---|
| X | 周(年内第几周) |
| Z | 星期(周一~周日) |
| Y | 当日提交次数(柱高) |
图 2 · 场景「2025 commits」:深绿柱体铺在网格地面上;左侧对象树按日期列出提交数,右侧可继续调环境光、背景与渲染
| 对比项 | 北京气温(图 1) | Git 全年提交(图 2) |
|---|---|---|
| 数据来源 | Open-Meteo 等公开 API | Agent 侧git log/ 贡献统计 |
| 时间跨度 | 近 7 日 | 全年按日 |
| 布局 | 一维日期序列柱 | 周 × 星期网格 + 高度 |
| 对象规模 | 约 7 根柱 | 可达数百根(宜批量建对象) |
| 能力层级 | L1 | L1 |
Agent 汇总每日提交并映射到 (周, 星期, 次数);平台按 Scene Plan 挂柱、设相机 / 环境、返回预览。平台不托管 Git 仓库。
图 2 是编辑器里的真实场景,不是导出静帧:顶部是当前场景: 2025 commits;左侧对象树如2025-01-01 (1);右侧环境光、背景 / 天空、渲染参数可继续改。一句话负责从 0 到可预览;精细观感仍在工作台里调。
大批量柱体时,优先batch_create_objects(或 compose 规定的批量挂树),避免逐条创建拖垮编排。
进阶:不必永远「一根柱子一个对象」。
可用dav-object-loader把整座柱阵收敛成一个对象资源,再配合uiGroups(颜色、间距、高度倍率、标签)、蓝图(定时 / 按钮 / 场景事件)、以及 Loader 内实时拉数。
路径:dav-object-loader→dav-register-asset→ 场景只挂一个图表对象 →(可选)dav-project-gui+ 蓝图。
图 1 / 图 2 适合快速验证叙事;要可运维的数据组件,优先走「自定义 Loader 单对象」。专项写法见 白鸽文(对象 Loader)、仓鼠文(GUI + 蓝图)。
05. 回头看原理:Token · MCP · Skills
跑通之后,三块积木就好记了——缺一不可:
| 积木 | 角色 | 记住一句 |
|---|---|---|
| Token | 鉴权 | Authorization: Bearer …,权限跟随可访问空间 |
| MCP | 原子工具 | 查空间、建项目、改场景、挂对象、上下架资源;参数以运行时 Schema 为准 |
| Skills | 编排 | 规定生成物格式与调用顺序,把原子工具串成可交付闭环 |
示意图 · 能力三角:Token 鉴权、Skills 编排,共同落到 dataspace3d MCP 原子能力
| 常见误解 | 实际 |
|---|---|
| 「装了 Skills 就够了」 | 没有 Token / MCP URL,编排无处落地 |
| 「MCP 工具很多,要背参数」 | 以设置页实时目录与 Input Schema 为准;Skills 不抄百科 |
| 「Agent 生成完就算上线」 | 默认不 publish;先预览,确认后再人工发布 |
这就是和「聊天写代码」的分界:开放的是带权限的空间与场景操作面,不是又一个无落库的 demo 沙箱。
06. Skills 地图与能力分层
| Skill | 做 | 不做 |
|---|---|---|
dav-object-loader | 生成双引擎registerDavLoader脚本与配置说明 | 不直接上架、不挂场景 |
dav-project-gui | 生成registerDavGUI脚本与配置说明 | 不写guiConfigs、不上架 |
dav-register-asset | MCP 上传脚本,创建/更新 Loader 与 Resource | 不写业务几何、不改项目 GUI 配置 |
dav-project-compose | 合成/改写项目与场景,可串联上三者,返回预览 | 不替代生成 skill;不默认发布;不做像素级图生 3D |
主编排是compose;缺资产再交接生成与上架。已有modelLoader/fontLoader/pointLightLoader/projectGUILoader等时,先 list 再 reuse,避免同语义重复注册。
写 Scene Plan 前先选层级,默认选能满足需求的最低层:
| Tier | 含义 | 举例 |
|---|---|---|
| L1 | 布局:对象 + 灯光/相机/环境 | 气温柱图、Git 提交柱阵、立体字 |
| L2 | + 项目 GUI shell | 换色、开关、加载遮罩 |
| L3 | + 时间轴动画与定时蓝图 | 停车场路径动画 |
| L4 | + 复杂蓝图 / 材质叶子绑定 | 展厅换色到车身零件(常需编辑器补全) |
07. 接着做什么
一键接入页第二条场景卡:
帮我做一个可切换柱体颜色的控制面板
在 L1 柱图上补L2 GUI:dav-project-gui→dav-register-asset→ compose 写入guiConfigs。
图表要长期对接实时数据时,别停在「批量散对象」:生成自定义图表 Loader(单对象),用uiGroups暴露参数,再用蓝图做刷新 / 显隐 / 告警——从演示场景走到可运维组件。
| 你想说的话 | 大致落点 |
|---|---|
| 「做一个 Hello World 立体字场景」 | compose L1 + 复用fontLoader |
| 「生成仓库某年 Git 日提交 3D 柱阵」 | compose L1 + Agent 侧 git 统计 + 批量挂柱 |
| 「做一个可配置的 3D 柱状图对象 Loader,对接实时数据」 | dav-object-loader单对象 +uiGroups+ 蓝图 / 数据口 |
| 「按这张参考图改现有展厅」 | composeedit+ 聚合查询后增量改 |
| 「把旧 Three.js 场景迁过来」 | compose + 批量对象接口;先读 skill 内迁移说明 |
单一 skill 的工程化细节:
- 一句话和三张图,生成对象 Loader(卡通白鸽)
- 从 Uiverse 到可编排项目 GUI(仓鼠跑轮)
设置入口与字段级说明:开放能力 · MCP 协议 · Agent Skills
08. 工程不变量与短问答
- Token 是密钥:不要提交到公开仓库;泄漏后立即在 Token 管理作废重建。
- 不默认 publish:Agent 交付预览链接即可;发布是人工确认后的动作。
- 不做像素级图生 3D:参考图表达造型与布局意图,不是网格烘焙承诺。
- 运行时读 MCP Schema:工具增减以设置 → 开放能力 → MCP 实时目录为准。
- 对象树是链表:挂载要维护
parent/child/ 兄弟指针;勿只create_object不连边。 - 同任务同语义只注册一次:先
list_resources/list_loaders。 - 多空间必须确认
workspaceId:唯一空间可默认,多个空间禁止猜测。
和「AI 写 Three.js」有何不同?
后者多半停在本地片段;开放能力写入你的空间项目,带权限、资源库与/project/run/{uid}预览。
会不会一句话就公开发布?
不会。默认只给预览;publish_project需你显式确认。
天气 / Git 数据存在哪?
在 Agent 侧拉取或统计;平台不托管天气服务或 Git 仓库,只承接「已整理好的序列 → 3D 场景」。
四个 Skill 必须都手搓一遍吗?
日常从dav-project-compose进;缺 Loader / GUI 时再自动或手动交接生成与上架。
09. 带走三条
图 1、图 2 只是证据。更值得带走的是:
- 开放能力 = Token + MCP + Skills,缺一不可。
- 合格交付是可预览、可进编辑器继续改的平台项目,不是聊天里的代码块。
- 数据进 3D可复用:天气 API、Git 提交、业务 KPI——Agent 负责数,DATASPACE3D 负责空间与场景;要可运维时,再收敛成自定义 Loader 单对象,接 UI 配置、蓝图与实时数据。
当你能稳定跑通「一键接入 → 一句指令 → 预览链接」,下一步就不是多画几根柱,而是把对象生成、GUI 生成、场景编排收成团队可重复的搭建链路——与 白鸽文、仓鼠文 同一条生产线。