DATASPACE3D是面向 3D 产品展示、数字孪生、在线展厅与交互演示的 Web3D 可视化搭建平台。开放能力要做的事很具体把工作台接到 Cursor / Claude Code 等 Agent——说清意图空间里就出现可预览的真实项目不满意就进编辑器继续改。生成是起点控制权仍在你手里。本文按这条顺序写先结论 → 五分钟接入 → 两个真实案例 → 再拆 Token / MCP / Skills → 扩展与工程边界。配图都是真实跑通结果不是示意稿。图 1 · 实际生成Beijing Daily Max Temp (7d)柱顶标注日最高气温Skills 包https://cdn.dataspace3d.com/system/skills.zip01. 先看结论工作台接到 Agent不是又写一段 Three.jsWeb3D / 数字孪生里费时间的通常不是画一根柱而是整条工程链路数据怎么进对象、资源能不能进空间库、对象树 / 相机 / 环境挂不齐就没法预览、确认后再进编辑器微调并决定是否发布。「让 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.zipSkill一句话dav-object-loader自然语言 → 双引擎对象 Loader.js.mddav-project-gui自然语言 → 项目 GUI.js.mddav-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-2331.408-2431.908-2530.808-2627.108-2729.108-2823.408-2928.7蓝粉双色立体柱、浅绿台面、柱顶数值与底部日期——已经是能挂进预览链接的场景不是平面图表截图。分工先钉死Agent 调 Open-Meteo 等公开 API整理日期与温度序列DATASPACE3D 经 MCP 落项目、对象与预览。平台不托管天气服务。换能源、客流、KPI 也一样——换数据源不换闭环。本案例默认L1 Layout场景 柱体 相机 / 环境。换色面板是可选 L2不必一次做满。示意图 · 主案例典型 Skill 链路L1compose 主编排缺 Loader 时生成并上架再经 MCP 挂树并返回预览你应拿到可打开的预览链接可选编辑器地址/editor/{projectUid}摘要项目 / 场景 id、tier、新注册资源、降级项。观感 OK 再进编辑器调相机、材质、灯光最后人工发布。04. 换数据源仓库 2025 年 Git 日提交柱阵天气柱图是「开放 API → 短时序」。工程团队更常讲贡献密度——同一套开放能力把全年日提交落成可继续编辑的三维场景。一句话生成该仓库 2025 年 Git 日提交记录的 3D 柱状图X 轴为周序号Z 轴为星期Y 轴为当日提交次数搭好场景并给我预览链接。轴含义X周年内第几周Z星期周一周日Y当日提交次数柱高图 2 · 场景「2025 commits」深绿柱体铺在网格地面上左侧对象树按日期列出提交数右侧可继续调环境光、背景与渲染对比项北京气温图 1Git 全年提交图 2数据来源Open-Meteo 等公开 APIAgent 侧git log/ 贡献统计时间跨度近 7 日全年按日布局一维日期序列柱周 × 星期网格 高度对象规模约 7 根柱可达数百根宜批量建对象能力层级L1L1Agent 汇总每日提交并映射到 (周, 星期, 次数)平台按 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-assetMCP 上传脚本创建/更新 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 GUIdav-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 Skills08. 工程不变量与短问答Token 是密钥不要提交到公开仓库泄漏后立即在 Token 管理作废重建。不默认 publishAgent 交付预览链接即可发布是人工确认后的动作。不做像素级图生 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 生成、场景编排收成团队可重复的搭建链路——与 白鸽文、仓鼠文 同一条生产线。