> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/qi-ta/migrate-legacy-sdk6-scenes.md).

# 迁移旧版 SDK6 场景

使用 AI 助手将旧版 SDK6 场景迁移到 SDK7。

如果你有一个旧的 SDK6 场景，想让它更新到最新版本，你可以借助 AI 助手自动将其迁移到 SDK7。该 [Decentraland SDK 技能](/creator/content-creator-zh/chang-jing-sdk7/ru-men/vibe-coding.md#install-skills-for-any-ai-agent) 包括一个专门的迁移工作流，AI 会逐步遵循，因此你无需手动翻译代码。

本指南将带你完成整个流程。

## 1. 创建一个新的空白 SDK7 场景

从一个全新、空白的 SDK7 项目开始。AI 会把你的旧代码和资源迁移到这个干净的结构中。

**选项 A — Creator Hub**

1. 打开 Creator Hub。
2. 选择顶部导航栏上的 **场景** 标签页并点击 **新场景**.
3. 选择 **空场景** 模板。

**选项 B — 命令行**

在一个空文件夹中运行以下命令：

```bash
npx @dcl/sdk-commands init
```

这会将 SDK7 项目的默认文件填充到该文件夹中。

## 2. 安装 SDK Skills

SDK Skills 会教你的 AI 代理如何使用 Decentraland SDK7，包括如何正确地执行 SDK6 → SDK7 迁移。

你可以通过两种方式安装它们。

**选项 A — 让 AI 安装它们**

在场景文件夹中打开你的 AI 助手，只需说：

> 安装 Decentraland SDK skills。

AI 知道这个命令，并会为你安装它们。

**选项 B — 从命令行安装**

```bash
npx skills add decentraland/sdk-skills --all
```

该 `--all` 该 flag 会安装所有可用的 skills。如果你省略它，就会打开一个交互式选择器，让你选择要安装哪些 skills。

有关可用 skills 及其工作方式的更多详情，请参见 [使用 AI 进行 Vibe Coding](/creator/content-creator-zh/chang-jing-sdk7/ru-men/vibe-coding.md#install-skills-for-any-ai-agent).

## 3. 让 AI 迁移场景

把你的旧 SDK6 项目文件放在 AI 可以读取的地方——例如你电脑上的一个单独文件夹，或一个公开的 GitHub 仓库中。

然后提示 AI：

> 将这个 SDK6 场景迁移到 SDK7。

这些 skills 包含完整的迁移操作手册，因此 AI 将会：

* 识别 SDK6 场景中使用的入口点和组件。
* 将实体、组件和系统转换为它们在 SDK7 中对应的版本。
* 将 3D 模型、音频和其他资源迁移到新项目中。
* 更新 `scene.json` 以及项目配置。
* 用当前的 SDK7 对应 API 替换已弃用的 API。

## 4. 测试并迭代

迁移完成后，预览场景并完整运行一遍。

* 在 Creator Hub 中，点击 **预览**.
* 从命令行运行 `npm run start`.

在测试时，注意查找：

* 视觉问题——缺失模型、位置或缩放错误、材质损坏。
* 交互问题——点击无响应、触发器未激活、对话框未出现。
* 多人或联网问题（如果你的场景使用了它们）。
* 预览窗口中的控制台错误。

当你发现 bug 时，用简单明了的语言向 AI 描述它：

> 桌子上的红色按钮现在不再打开门了。它以前会播放声音并将门旋转 90 度。

AI 可以使用相关的 skills（交互、动画、音频等）逐个修复问题。不断迭代，直到场景的表现与原版一致。

{% hint style="info" %}
**💡 提示**：一次只修复一个 bug，并在每次修改后预览。当改动较小时，更容易发现回归问题。
{% endhint %}

## 下一步

* [使用 AI 进行 Vibe Coding](/creator/content-creator-zh/chang-jing-sdk7/ru-men/vibe-coding.md) — 与 AI 助手和 SDK Skills 协作的完整参考。
* [SDK 快速入门](/creator/content-creator-zh/chang-jing-sdk7/ru-men/sdk-101.md) — 学习 SDK7 基础知识，以便你审查并优化迁移后的代码。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/qi-ta/migrate-legacy-sdk6-scenes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.