SuperAPI AI 工具集

unity-prefab-workflow

编程与开发

查看项目

更新于 10-15 16:46

技能介绍

用途:通过 unity-cli 管理 Unity 预制体(prefab)资源,负责预制体编辑模式的生命周期,包括创建、打开、编辑、保存和实例化。场景实例的编辑属于 unity-gameobject-edit,不在本技能范围内。

适用场景:需要创建或更新预制体资源;需要进入预制体编辑模式并把改动保存回资源;需要以指定变换把预制体实例化到场景。不适用:编辑不涉及预制体资源的普通场景对象(用 unity-gameobject-edit);新建场景(用 unity-scene-create);资源导入设置或材质(用 unity-asset-management)。

推荐流程:用 open_prefab 进入编辑模式,或从场景对象 create_prefab;通过 add_component、modify_component 或 set_component_field 施加修改;save_prefab 把改动持久化回资源;exit_prefab_mode 返回场景编辑。

示例命令(保持原样): unity-cli raw create_prefab --json '{"gameObjectPath":"/Player","prefabPath":"Assets/Prefabs/Player.prefab"}' unity-cli raw open_prefab --json '{"prefabPath":"Assets/Prefabs/Player.prefab"}' unity-cli raw save_prefab --json '{}' unity-cli raw exit_prefab_mode --json '{}' unity-cli raw instantiate_prefab --json '{"prefabPath":"Assets/Prefabs/Player.prefab","position":{"x":0,"y":0,"z":0}}'

限制:具体前置条件、连接与实例要求见 runtime-checklist.md,编辑模式安全顺序、场景切换与实例化检查见 prefab-edit-mode.md;其余细节资料未提供。