> **一句话，生成可预览、可编辑、可发布的 3D 场景。**  
> 1、说清意图，Agent 就能搭出空间里的真实项目；不满意就进编辑器继续调相机、材质、灯光与交互——生成是起点，控制权始终在你手里。
>
> 2、这不是又一次「让 AI 写段 Three.js」的演示，而是把 **工作台接到 Agent**：用 Token 鉴权、用 MCP 暴露原子能力、用 Skills 编排「生成 → 上架 → 组场景 → 预览」。开放数据、业务指标、产品展陈，都可以落成自由可控的 Web3D 体验。
>
> 3、下面先看一键接入推荐示例的真实跑通结果——自然语言拉取公开天气数据，生成可预览的 3D 柱状图；文中还会补一个「仓库全年 Git 日提交」的三维热力柱场景，说明同一闭环如何落到工程数据叙事。

![北京近 7 日最高气温 3D 柱状图](https://developer.qcloudimg.com/http-save/yehe-12587840/898eb3dc14e16a93d9bb4ae141e52c8d.jpg)

*图 1 · 实际生成示例：Beijing Daily Max Temp (7d)，柱顶标注日最高气温*

> Skills 包下载：[https://cdn.dataspace3d.com/system/skills.zip](https://cdn.dataspace3d.com/system/skills.zip)

---

## 01. 为什么需要「开放能力」？

在 Web3D / 数字孪生落地里，真正耗时的往往不是「画一根柱子」，而是整条工程链路：

- 数据从哪来、怎么变成场景对象  
- 资源要进空间库，才能被项目复用  
- 场景要挂对象树、相机、环境光，才能预览  
- 确认效果后，再进编辑器微调、发布  

传统「聊天生成代码」停在本地片段：能看一眼，却进不了平台资源体系，也接不上团队已有的项目与权限。

DATASPACE3D 的 **AI 开放能力**要解决的，是另一件事：

> 让 Cursor / Claude Code / Windsurf 等任意 MCP 客户端，用你的空间权限，直接操作同一套工作台能力——而不是另起一套玩具沙箱。

一句话目标：

```text
自然语言（或图片）
  → Agent + Skills 编排
  → dataspace3d MCP 写入空间/项目/场景
  → /project/run/{projectUid} 预览
  → 编辑器继续改 → 再人工发布
```

---

## 02. 能力三角：Token · MCP · Skills

开放能力不是单一开关，而是三块积木，分工清晰：

| 积木 | 角色 | 要记住的一句 |
|------|------|----------------|
| **Token** | 鉴权凭证 | `Authorization: Bearer …`，权限跟随账号可访问的空间 |
| **MCP** | 原子工具 | 查空间、建项目、改场景、挂对象、上下架资源……参数以运行时 Schema 为准 |
| **Skills** | 编排手册 | 规定生成物格式与调用顺序，把原子工具串成可交付闭环 |

```text
┌─────────┐     ┌──────────────────┐     ┌────────────────────────────┐
│  Token  │────►│ dataspace3d MCP  │◄────│ Agent Skills（可移植 zip）  │
│  凭证   │     │ 原子 CRUD / 查询  │     │ 生成 · 上架 · 组场景 · 预览 │
└─────────┘     └──────────────────┘     └────────────────────────────┘
```

常见误解对照：

| 误解 | 实际 |
|------|------|
| 「装了 Skills 就够了」 | Skills 必须能调到 MCP；没有 Token / URL，编排无处落地 |
| 「MCP 工具很多，要背参数」 | 以设置页实时目录与 Input Schema 为准；Skills 不抄百科 |
| 「Agent 生成完就算上线」 | **默认不 publish**；先预览，确认后再人工发布 |

设置里菜单顺序也故意按「最快上手 → 凭证 → 协议细节」排列：

**一键接入 → Token 管理 → MCP**

---

## 03. 五分钟接入：复制一条提示词

### 步骤

1. 登录工作台，进入 **设置 → 开放能力 → Token 管理**，创建私人访问 Token（明文仅创建时可见，请妥善保存）。  
2. 打开 **一键接入**，把 Token 粘贴到本页（页面不会回读历史明文，避免二次暴露）。  
3. 复制生成的全能提示词，粘贴到任意 Agent 聊天框。  
4. Agent 会配置名为 `dataspace3d` 的 MCP，并从 CDN 安装 / 覆盖四个 Skills。  
5. 确认 MCP 可用后，直接用自然语言试跑（见下一节主案例）。

平台 MCP 端点：

```text
https://www.dataspace3d.com/api/mcp/dataspace3d/stateless/stream
```

Skills 固定包：

```text
https://cdn.dataspace3d.com/system/skills.zip
```

包内四个 skill（同名覆盖更新，保证可重复升级）：

| Skill | 一句话 |
|-------|--------|
| `dav-object-loader` | 自然语言 → 双引擎对象 Loader（`.js` + `.md`） |
| `dav-project-gui` | 自然语言 → 项目 GUI（`.js` + `.md`） |
| `dav-register-asset` | 把已有交付物经 MCP 上架到空间资源库 |
| `dav-project-compose` | 合成 / 改写项目与场景，返回预览链接 |

### 提示词模板（与产品一致）

```text
请帮我安装或更新 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 侧 MCP JSON 形态（手动配置时）：

```json
{
  "mcpServers": {
    "dataspace3d": {
      "url": "https://www.dataspace3d.com/api/mcp/dataspace3d/stateless/stream",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}
```

---

## 04. 主案例：Open-Meteo → 北京气温 3D 柱状图

一键接入页的推荐场景卡原文：

> **基于 Open-Meteo 公开天气数据，拉取北京近 7 天日最高气温，生成一座 3D 柱状图场景并给我预览链接**

这正是图 1 的来源指令。

### 4.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 |

视觉上：蓝粉双色立体柱、浅绿台面、柱顶数值与底部日期标签——已经是可放进展厅 / 大屏叙事的「数据雕塑」，而不是平面图表截图。

### 4.2 数据在 Agent，场景在平台

边界必须说清：

| 一侧 | 做什么 |
|------|--------|
| **Agent** | 调用 Open-Meteo 等公开 API，整理日期与温度序列 |
| **DATASPACE3D** | 接收「要一座怎样的 3D 场景」；经 MCP 落项目、对象与预览 |

平台不托管天气服务；开放能力开放的是 **空间与场景操作面**。  
这也是「开放数据 → 3D」模式可复用到其它公开指标（能源、客流、KPI）的原因：换数据源，不换闭环。

### 4.3 典型 Skill 链路（L1）

能力分层上，本案例默认落在 **L1 Layout**：场景 + 柱体对象 + 相机 / 环境即可。换色面板属于可选 L2，不必一次做满。

```text
用户：开放数据 + 自然语言
        │
        ▼
dav-project-compose
  · 选 workspace / create_project
  · 写 Scene Plan（tier: L1）
  · 缺柱体 Loader？
        ├─► dav-object-loader 生成 .js + .md
        └─► dav-register-asset 上架到空间
        │
        ▼
dataspace3d MCP
  · update_scene / create_object（挂对象树）
        │
        ▼
预览 URL：/project/run/{projectUid}?status=…
（不默认 publish_project）
```

Agent 交付时你应拿到：

1. 可打开的预览链接  
2. 可选编辑器地址：`/editor/{projectUid}`  
3. 摘要：项目 / 场景 id、tier、新注册资源、降级项（若有）

确认观感后，再进场景编辑器调相机、材质、灯光，最后人工发布。

### 4.4 这个案例证明了什么？

| 以前 | 现在 |
|------|------|
| 手写几何体 + 本地 demo 页 | Loader 进资源库，项目可复用 |
| 数据与展示各写一套胶水 | Agent 拉数 + Skills 组场景 |
| 「生成完」不知如何给同事预览 | 标准 `/project/run/{uid}` 链接 |
| 上线与草稿混在一起 | 预览优先，发布仍是显式操作 |

---

## 05. 再一例：仓库 2025 年 Git 日提交 3D 柱状图

天气柱图是「开放 API → 少样本时序」；工程团队更常讲的是 **贡献密度**。同一套开放能力，可以把本地 / 远程仓库的全年日提交，落成可在编辑器里继续调的三维场景。

示例指令：

> **一句话生成该仓库 2025 年 Git 日提交记录的 3D 柱状图：X 轴为周序号，Z 轴为星期，Y 轴为当日提交次数；搭好场景并给我预览链接。**

坐标约定（与指令对齐）：

| 轴 | 含义 |
|----|------|
| **X** | 周（年内第几周） |
| **Z** | 星期（周一～周日） |
| **Y** | 当日提交次数（柱高） |

![2025 Git 日提交 3D 柱状图](https://developer.qcloudimg.com/http-save/yehe-12587840/f80596fa79f99e688edd6b9d71066950.jpg)

*图 2 · 场景「2025 commits」：深绿柱体铺在网格地面上；左侧对象树按日期列出提交数，右侧可继续调环境光、背景与渲染——生成之后仍可自由控制*

### 5.1 和气温案例同一闭环，换的是数据与几何布局

| 对比项 | 北京气温（图 1） | Git 全年提交（图 2） |
|--------|------------------|----------------------|
| 数据来源 | Open-Meteo 等公开 API | Agent 侧 `git log` / 贡献统计 |
| 时间跨度 | 近 7 日 | 全年按日 |
| 布局 | 一维日期序列柱 | 周 × 星期的二维地面网格 + 高度 |
| 对象规模 | 约 7 根柱 | 可达数百根（宜走批量建对象） |
| 能力层级 | L1 | L1（大批量时仍属布局，不必先上 L2） |

边界依旧：

| 一侧 | 做什么 |
|------|--------|
| **Agent** | 汇总 2025 每日提交次数，映射到 (周, 星期, 次数) |
| **DATASPACE3D** | 按 Scene Plan 挂柱体、设相机 / 环境，返回预览；你可进编辑器改光、天空、材质 |

平台不托管 Git 仓库；开放的是把「已算好的日序列」写成可控 3D 项目的能力。

### 5.2 为什么这个例子更能说明「自由可控」

图 2 不是一张导出的静态图，而是编辑器里的真实场景：

- 顶部场景名：**当前场景: 2025 commits**  
- 左侧对象树：如 `2025-01-01 (1)`，日期与提交数可追溯  
- 右侧属性：环境光、背景 / 天空、渲染相关参数随时可改  

也就是说：**一句话负责从 0 到可预览；精细观感仍在工作台里由你掌控。**

大批量柱体时，Skills / MCP 侧应优先 `batch_create_objects`（或 compose 规定的批量挂树），避免逐条创建拖垮编排。

> **进阶提示：不必永远「一根柱子一个对象」。**  
> 也可以让 AI 用 `dav-object-loader` **生成自定义对象 Loader**：把整座柱阵（或整块数据可视化）收敛成 **一个对象资源**，而不是对象树上数百个零散节点。再配合：
>
> - **UI 配置（`uiGroups`）**：在属性面板调颜色、间距、高度倍率、是否显示标签等  
> - **蓝图编排**：定时刷新、按钮触发、场景事件驱动更新  
> - **实时数据对接**：Loader 内按约定拉取 / 接收推送数据，柱高随指标变化  
>
> 路径大致是：`dav-object-loader` → `dav-register-asset` → 场景只挂 **一个** 图表对象 →（可选）`dav-project-gui` + 蓝图接实时源。  
> 图 1 / 图 2 适合快速验证叙事；要做可运维的数据组件，优先走「自定义 Loader 单对象」这条线。专项写法见 [白鸽文（对象 Loader）](https://zhuanlan.zhihu.com/p/2059587445696606709)、[仓鼠文（GUI + 蓝图）](https://zhuanlan.zhihu.com/p/2062288416381916312)。

---

## 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`。

若图表要长期对接实时数据，不要停在「批量散对象」：用 AI 生成 **自定义图表 Loader（单对象）**，用 `uiGroups` 暴露可调参数，再用蓝图做刷新 / 显隐 / 告警编排——同一套开放能力，从「演示场景」升级到「可运维组件」。

若你要深入「单一 skill 如何工程化」，可继续读两篇专项实践：

- [一句话和三张图，生成对象 Loader（卡通白鸽）](https://zhuanlan.zhihu.com/p/2059587445696606709)  
- [从 Uiverse 到可编排项目 GUI（仓鼠跑轮）](https://zhuanlan.zhihu.com/p/2062288416381916312)

其它常见自然语言入口：

| 你想说的话 | 大致落点 |
|------------|----------|
| 「做一个 Hello World 立体字场景」 | compose L1 + 复用 `fontLoader` |
| 「生成仓库某年 Git 日提交 3D 柱阵」 | compose L1 + Agent 侧 git 统计 + 批量挂柱 |
| 「做一个可配置的 3D 柱状图对象 Loader，对接实时数据」 | `dav-object-loader` 单对象 + `uiGroups` + 蓝图 / 数据口 |
| 「按这张参考图改现有展厅」 | compose `edit` 模式 + 聚合查询后增量改 |
| 「把旧 Three.js 场景迁过来」 | compose + 批量对象接口；先读 skill 内迁移踩坑说明 |

产品侧模块说明（设置入口、工具分组、字段级细节）：

[开放能力](https://www.dataspace3d.com/docs/product?module=open-capability) · [MCP 协议](https://www.dataspace3d.com/docs/product?module=mcp) · [Agent Skills](https://www.dataspace3d.com/docs/product?module=agent-skills)

---

## 08. 工程不变量（建议贴在团队墙）

1. **Token 是密钥**：不要提交到公开仓库；泄漏后立即在 Token 管理作废重建。  
2. **不默认 publish**：Agent 交付预览链接即可；发布是人工确认后的动作。  
3. **不做像素级图生 3D**：参考图用于造型与布局意图，不是网格烘焙承诺。  
4. **运行时读 MCP Schema**：工具增减以设置 → 开放能力 → MCP 实时目录为准。  
5. **对象树是链表**：挂载要维护 `parent` / `child` / 兄弟指针；Skills 已规定算法，勿只 `create_object` 不连边。  
6. **同任务同语义只注册一次**：先 `list_resources` / `list_loaders`。  
7. **多空间必须确认 `workspaceId`**：唯一空间可默认，多个空间禁止猜测。

---

## 09. 结语：带走的是生产线，不是一张柱状图

图 1、图 2 好看，但更值得带走的是三条结论：

1. **开放能力 = Token + MCP + Skills**，缺一不可。  
2. **合格交付是可预览、可进编辑器继续改的平台项目**，不是聊天里的代码块。  
3. **数据进 3D** 的范式可复用：天气 API、Git 提交、业务 KPI——Agent 负责数，DATASPACE3D 负责空间与场景闭环；要可运维时，再收敛成自定义 Loader 单对象，接 UI 配置、蓝图与实时数据。

当你能稳定跑通「一键接入 → 一句指令 → 预览链接」，下一步就不是多画几根柱子，而是：

> 把对象生成、GUI 生成、场景编排，收成团队可重复的智能搭建生产线。

一句话，生成可预览、可编辑、可发布的 3D 场景。   1、说清意图，Agent 就能搭出空间里的真实项目；不满意就进编辑器继续调相机、材质、灯光与交互——生成是起点，控制权始终在你手里。

DATASPACE3D AI 开放能力：一句话，生成可预览、可编辑、可发布的 3D 场景

一句话，生成可预览、可编辑、可发布的 3D 场景

人工智能

开发工具

前端

DATASPACE3D开放能力通过Token鉴权、MCP协议与四个Skills编排，实现自然语言直接生成可预览、可编辑、可发布的3D场景。用户以北京天气与Git提交数据为例，验证从数据拉取到场景落地的完整闭环，支持编辑器微调与人工发布，适用于数据叙事与工程可视化场景。

数据可视化

数字孪生

代码解释

Agent

CDN免费试用


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

DATASPACE3D AI 开放能力：一句话，生成可预览、可编辑、可发布的 3D 场景-腾讯云开发者社区-腾讯云

DATASPACE3D AI 开放能力：一句话，生成可预览、可编辑、可发布的 3D 场景

DATASPACE3D AI 开放能力：一句话，生成可预览、可编辑、可发布的 3D 场景

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐