迁移旧版 SDK6 场景

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

如果你有一个旧的 SDK6 场景，想让它更新到最新版本，你可以借助 AI 助手自动将其迁移到 SDK7。该 Decentraland SDK 技能 包括一个专门的迁移工作流，AI 会逐步遵循，因此你无需手动翻译代码。

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

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

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

选项 A — Creator Hub

1. 打开 Creator Hub。

2. 选择顶部导航栏上的 场景 标签页并点击 新场景.

3. 选择 空场景 模板。

选项 B — 命令行

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

npx @dcl/sdk-commands init

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

2. 安装 SDK Skills

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

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

选项 A — 让 AI 安装它们

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

安装 Decentraland SDK skills。

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

选项 B — 从命令行安装

npx skills add decentraland/sdk-skills --all

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

有关可用 skills 及其工作方式的更多详情，请参见 使用 AI 进行 Vibe Coding.

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（交互、动画、音频等）逐个修复问题。不断迭代，直到场景的表现与原版一致。

💡 提示：一次只修复一个 bug，并在每次修改后预览。当改动较小时，更容易发现回归问题。

下一步

• 使用 AI 进行 Vibe Coding — 与 AI 助手和 SDK Skills 协作的完整参考。

• SDK 快速入门 — 学习 SDK7 基础知识，以便你审查并优化迁移后的代码。