SuperAPI AI 工具集

migrate-sdk6-to-sdk7

通用与其它

查看项目

更新于 10-16 05:05

技能介绍

用途:把已有的 Decentraland SDK6 场景移植到 SDK7,包括把 package.json 中的 decentraland-ecs 换成 @dcl/sdk、替换构建脚本、更新 scene.json 与 tsconfig,并改写源码中的 SDK6 API。它是移植技能而非脚手架:面向磁盘上已存在的 SDK6 项目,新建场景应使用 create-scene。

使用方式与前置校验:操作前先确认项目确实为 SDK6,需同时满足多个信号(依赖含 decentraland-ecs、脚本为 build-ecs/dcl start、scene.json 无 runtimeVersion 或 ecs7、代码中符号为全局且使用 new Entity() 等)。部分匹配通常意味着半迁移项目,需要不同处理。

主要规则:不要修改 scene.json 的 main 字段(保持原值,如 bin/game.js);应添加 "runtimeVersion": "7"。迁移同样适用 composite-first 规则,但最低可行迁移可先保留代码创建实体,之后再可选地迁入 assets/scene/main.composite。

迁移流程:1)审计所有源文件,列出自定义组件、ISystem、事件、形状、单例、setParent;2)替换依赖与脚本、更新 tsconfig 与 scene.json;3)把根目录资源(models、images、audio、videos、textures)整理到 assets/ 下(如 assets/Models/、assets/Images/、assets/Audio/),并重写所有引用路径,避免重复副本;4)创建导出 main() 的 src/index.ts;5)组件改为 engine.defineComponent;6)系统改为自由函数;7)实体与组件创建改用 Component.create;8)输入改为 pointerEventsSystem 或 inputSystem.isTriggered;9)动画改用 Animator.create 与 Animator.playSingleAnimation。每步以 grep 检查旧符号清零为完成标准。

限制:在 Creator Hub 的嵌入式 AI 助手中该技能被禁用,因为 Creator Hub 不附带其 SKILL.md,且自身为 SDK7-only;其 references/ 文件仍会随包分发。在 Claude Code、Cursor 或 SDK 代理中可正常使用。资料未提供收费、价格或平台支持等信息。