用途:面向 Unity 编辑器的 Addressables 自动化,覆盖资源组增删、资源条目分配、Profile 切换与内容构建,属于创作侧(AddressableAssetSettings 资产)操作,不含运行时加载代码。
主要能力:环境探测 addressables_check_installed;组操作 addressables_group_list、addressables_group_create、addressables_group_add_entry、addressables_group_delete;Profile 操作 addressables_profile_get、addressables_profile_set;构建 addressables_build。所有调用通过反射解析 Unity.Addressables.Editor 程序集,因此无论是否安装 Addressables,UnitySkills 编辑器程序集都能一致编译,无需脚本宏或重新编译。
使用方式:必须先调用 addressables_check_installed,它是唯一在两种失败状态下都可用的技能,其 installed/configured 可判断缺失的前置条件。前置条件有两个:已安装 com.unity.addressables;已创建 AddressableAssetSettings 资产(需人工从 Window > Asset Management > Addressables > Groups 创建,无对应技能)。运行模式分三层:SemiAuto 下 check_installed、group_list、profile_get 直接运行;FullAuto 下 group_create、group_add_entry、profile_set、build 在 Approval 下需用户授权,Auto/Bypass 下直接运行并审计;group_delete 属 Auto-forbidden,仅 Bypass 或 Allowlist 可执行。
适用场景:检查安装与配置、创建资源组并添加资源、切换激活 Profile、构建 Addressables 内容。
限制:仅创作侧,条目枚举/移除、地址重命名、组 schema、Profile 变量、标签、Analyze 规则与内容更新均不提供,需用 Groups 窗口;构建目标隐式为当前 activeBuildTarget,无参数;无批量技能;所有变更立即写入设置资产且不可工作流撤销;group_create 遇重名会追加计数重命名,应使用返回的 groupName;group_add_entry 是移动而非复制。版本锚定 2.x 编辑器源码,1.22.x API 表面相同。