SuperAPI AI 工具集

dojo-migrate

部署与运维

查看项目

更新于 10-15 21:11

技能介绍

用途:管理 Dojo 世界的迁移、升级与破坏性变更,适用于更新已部署世界、升级 Dojo 版本、处理 schema 变更等场景。

主要能力:分析迁移差异(sozo inspect 显示新增/修改的模型与系统及资源状态)、规划迁移策略、执行迁移、处理破坏性变更、升级 Dojo 版本。

使用方式:先检查变更 sozo inspect,再构建与测试 sozo build、sozo test,然后执行 sozo migrate(可用 --profile 指定配置,如 sozo migrate --profile sepolia)。版本升级需修改 Scarb.toml 中 dojo 与 dojo_cairo_test 的版本号,查看变更日志后重新构建、测试并迁移。

迁移类型:新增模型、新增系统、新增字段属于安全的新增式迁移(新字段默认零值);修改键字段、删除字段、修改字段类型属于破坏性迁移,可能造成数据丢失或类型不兼容。

处理破坏性变更的选项:使用不同 seed 部署全新世界;保留旧模型并新增并行版本模型;创建迁移系统读取旧格式并写入新格式。

限制与注意:模型无法从世界中移除,结构变化时建议使用带版本号的模型名或部署新世界;迁移失败需检查账户 gas、profile 配置并查看 sozo inspect 输出;迁移后需测试功能、更新客户端绑定(sozo build --typescript)、按需更新 Torii 索引器。具体收费、价格与平台信息暂未提供。