@alpsckr/unitycli 0.4.0

package/unitypkg/Editor/Tools/asset/rename.cs

@@ -0,0 +1,84 @@
+#if UNITY_EDITOR
+using System;
+using System.Collections.Generic;
+using System.IO;
+using UnityEditor;
+
+namespace UnityCli
+{
+    /// <summary>
+    /// asset.rename — 重命名资产(不改目录)。禁止路径分隔符。
+    /// </summary>
+    public class AssetRenameTool : IUnityCliTool<AssetRenameTool.Request, AssetRenameTool.Result>
+    {
+        public sealed class Request
+        {
+            public string Path { get; set; }
+            public string Name { get; set; }
+        }
+
+        public sealed class Result
+        {
+            public AssetDetail Asset { get; set; }
+            public string Source { get; set; }
+            public List<AssetPlannedEffect> PlannedEffects { get; set; }
+        }
+
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "asset.rename",
+            Summary = "Rename an existing Assets/ asset file in place, without path separators.",
+            Description = "Rename an existing Assets/ asset file in place. The name must not include path separators; use asset.move to change directories.",
+            Group = "asset",
+            DestructiveHint = true,
+            SideEffects = new[] { "asset-write" },
+            Target = "editor",
+            PlayModeSupport = "editor-only",
+            DefaultTimeoutMs = 30000,
+            MaxTimeoutMs = 600000,
+            Examples = new[]
+            {
+                new ToolExample { Description = "Rename an asset", Input = new Request { Path = "Assets/Icons/old.png", Name = "new" } }
+            }
+        };
+
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            AssetToolSupport.EnsureEditorNotBusy("asset.rename");
+            var path = AssetToolSupport.RequireExistingAssetPath(request.Path);
+            var name = request.Name;
+            if (string.IsNullOrEmpty(name))
+            {
+                throw new UnityCliBridge.BridgeCommandException("E_ASSET_NAME_REQUIRED", "Asset rename requires a new name.", "Pass a filename without path separators.");
+            }
+            if (name.IndexOf('/') >= 0 || name.IndexOf('\\') >= 0)
+            {
+                throw new UnityCliBridge.BridgeCommandException("E_ASSET_NAME_INVALID", "Asset rename name must not include path separators: " + name, "Use asset move for changing directories.");
+            }
+            var guid = AssetDatabase.AssetPathToGUID(path);
+            ctx.CommitEffect();
+            var error = AssetDatabase.RenameAsset(path, name);
+            if (!string.IsNullOrEmpty(error))
+            {
+                throw new UnityCliBridge.BridgeCommandException("E_ASSET_RENAME_FAILED", "Failed to rename asset: " + error, "Check name validity and Unity Console diagnostics.");
+            }
+            AssetDatabase.Refresh();
+            var renamedPath = AssetToolSupport.NormalizeAssetPath(AssetDatabase.GUIDToAssetPath(guid));
+            if (string.IsNullOrEmpty(renamedPath))
+            {
+                renamedPath = AssetToolSupport.NormalizeAssetPath(Path.Combine(Path.GetDirectoryName(path) ?? "Assets", name));
+            }
+            if (!AssetToolSupport.AssetExists(renamedPath) || AssetToolSupport.AssetExists(path))
+            {
+                throw new UnityCliBridge.BridgeCommandException("E_ASSET_RENAME_STATE_MISMATCH", "Asset rename did not produce the expected source and destination state.", "Check Unity Console diagnostics and retry after the editor is idle.");
+            }
+            return new System.Threading.Tasks.ValueTask<Result>(new Result
+            {
+                Asset = AssetToolSupport.BuildAssetDetail(renamedPath),
+                Source = path,
+                PlannedEffects = new List<AssetPlannedEffect> { new AssetPlannedEffect { Type = "asset.rename", Path = renamedPath, Source = path } }
+            });
+        }
+    }
+}
+#endif

package/unitypkg/Editor/Tools/asset/search-built-in.cs

@@ -0,0 +1,90 @@
+#if UNITY_EDITOR
+using System;
+using System.Collections.Generic;
+using System.Globalization;
+using UnityEditor;
+
+namespace UnityCli
+{
+    /// <summary>
+    /// asset.search-built-in — 查找内置资源(Resources/ 与 Packages/ 路径),可按类型过滤。
+    /// </summary>
+    public class AssetSearchBuiltInTool : IUnityCliTool<AssetSearchBuiltInTool.Request, AssetSearchBuiltInTool.Result>
+    {
+        public sealed class Request
+        {
+            public string Keyword { get; set; }
+            public string Search { get; set; }
+            public string Type { get; set; }
+            public int? PageSize { get; set; }
+        }
+
+        public sealed class Result
+        {
+            public long Count { get; set; }
+            public List<BuiltInAsset> Assets { get; set; }
+        }
+
+        public sealed class BuiltInAsset
+        {
+            public string Path { get; set; }
+            public string Guid { get; set; }
+            public string Name { get; set; }
+        }
+
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "asset.search-built-in",
+            Summary = "Find built-in Unity assets under Resources/ and Packages/ by keyword and optional type.",
+            Description = "Find built-in Unity assets (Resources/ and Packages/ paths) by keyword and optional main-asset type name. Read-only; use this to discover built-in shaders, textures, or defaults before creating materials or assigning assets.",
+            Group = "asset",
+            DestructiveHint = false,
+            Target = "editor",
+            PlayModeSupport = "supported",
+            DefaultTimeoutMs = 30000,
+            MaxTimeoutMs = 600000,
+            Examples = new[]
+            {
+                new ToolExample { Description = "Find built-in textures", Input = new Request { Keyword = "Default", Type = "Texture2D", PageSize = 25 } }
+            }
+        };
+
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            var keyword = request.Keyword ?? request.Search;
+            var typeFilter = request.Type;
+            var guids = AssetDatabase.FindAssets(keyword ?? string.Empty);
+            var results = new List<BuiltInAsset>();
+            var pageSize = Math.Max(1, Math.Min(request.PageSize ?? 100, 500));
+            foreach (var guid in guids)
+            {
+                if (results.Count >= pageSize) break;
+                var assetPath = AssetDatabase.GUIDToAssetPath(guid);
+                // 仅保留 Resources/ 与内置包路径
+                if (!assetPath.StartsWith("Resources/", StringComparison.OrdinalIgnoreCase)
+                    && !assetPath.StartsWith("Packages/", StringComparison.OrdinalIgnoreCase)
+                    && !assetPath.Contains("/Resources/"))
+                {
+                    continue;
+                }
+                if (!string.IsNullOrEmpty(typeFilter))
+                {
+                    var mainAsset = AssetDatabase.LoadMainAssetAtPath(assetPath);
+                    if (mainAsset == null || !mainAsset.GetType().Name.Equals(typeFilter, StringComparison.OrdinalIgnoreCase)) continue;
+                }
+                results.Add(new BuiltInAsset
+                {
+                    Path = AssetToolSupport.NormalizeAssetPath(assetPath),
+                    Guid = guid,
+                    Name = System.IO.Path.GetFileNameWithoutExtension(assetPath)
+                });
+            }
+            return new System.Threading.Tasks.ValueTask<Result>(new Result
+            {
+                Count = results.Count,
+                Assets = results
+            });
+        }
+    }
+}
+#endif

package/unitypkg/Editor/Tools/asset/search.cs

@@ -0,0 +1,83 @@
+#if UNITY_EDITOR
+using System;
+using System.Collections.Generic;
+using UnityEditor;
+
+namespace UnityCli
+{
+    /// <summary>
+    /// asset.search — 搜索 AssetDatabase:支持 Unity 原生 filter、类型追加、多目录范围与分页。
+    /// </summary>
+    public class AssetSearchTool : IUnityCliTool<AssetSearchTool.Request, AssetSearchTool.Result>
+    {
+        public sealed class Request
+        {
+            public string Filter { get; set; }
+            public string Query { get; set; }
+            public string Type { get; set; }
+            public string Path { get; set; }
+            public List<string> SearchInFolders { get; set; }
+            public int? PageSize { get; set; }
+            public int? MaxResults { get; set; }
+            public int? Cursor { get; set; }
+        }
+
+        public sealed class Result
+        {
+            public List<AssetSummary> Items { get; set; }
+            public AssetPageInfo PageInfo { get; set; }
+        }
+
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "asset.search",
+            Summary = "Search the Unity AssetDatabase by native filter, type, and folder scope with paging.",
+            Description = "Search the Unity AssetDatabase using a native filter, optional type suffix, and one or more Assets/ or Packages/ folder scopes. Results are lightweight summaries, paged via cursor/pageSize.",
+            Group = "asset",
+            DestructiveHint = false,
+            Target = "editor",
+            PlayModeSupport = "supported",
+            DefaultTimeoutMs = 30000,
+            MaxTimeoutMs = 600000,
+            Examples = new[]
+            {
+                new ToolExample { Description = "Find textures by type", Input = new Request { Filter = "t:Texture2D", PageSize = 25 } },
+                new ToolExample { Description = "Search a folder scope", Input = new Request { Query = "Player", SearchInFolders = new List<string> { "Assets/Characters" } } }
+            }
+        };
+
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            var searchInFolders = AssetToolSupport.NormalizeAssetSearchFolders(request.Path, request.SearchInFolders);
+            var filterParts = new List<string>();
+            if (!string.IsNullOrEmpty(request.Filter)) filterParts.Add(request.Filter);
+            else if (!string.IsNullOrEmpty(request.Query)) filterParts.Add(request.Query);
+            if (!string.IsNullOrEmpty(request.Type)) filterParts.Add("t:" + request.Type);
+            var resolvedFilter = string.Join(" ", filterParts.ToArray()).Trim();
+            var guids = AssetDatabase.FindAssets(resolvedFilter, searchInFolders.Length == 0 ? null : searchInFolders);
+            var cursor = Math.Max(0, request.Cursor ?? 0);
+            var pageSize = Math.Max(1, Math.Min(request.PageSize ?? request.MaxResults ?? 100, 500));
+            var items = new List<AssetSummary>();
+            for (var index = cursor; index < guids.Length && items.Count < pageSize; index++)
+            {
+                var assetPath = AssetToolSupport.NormalizeAssetPath(AssetDatabase.GUIDToAssetPath(guids[index]));
+                var assetType = AssetDatabase.GetMainAssetTypeAtPath(assetPath);
+                items.Add(AssetToolSupport.BuildAssetSummary(assetPath, assetType));
+            }
+            long? nextCursor = cursor + items.Count < guids.Length ? (long?)(cursor + items.Count) : null;
+            return new System.Threading.Tasks.ValueTask<Result>(new Result
+            {
+                Items = items,
+                PageInfo = new AssetPageInfo
+                {
+                    PageSize = pageSize,
+                    Cursor = cursor,
+                    NextCursor = nextCursor,
+                    Total = guids.Length,
+                    Truncated = nextCursor != null
+                }
+            });
+        }
+    }
+}
+#endif

package/unitypkg/Editor/Tools/build/BuildSceneStateTool.cs

@@ -0,0 +1,37 @@
+#if UNITY_EDITOR
+using System.Linq;
+using UnityEditor;
+
+namespace UnityCli
+{
+    /// <summary>Build Settings 场景启用状态的共享读回校验。</summary>
+    public static class BuildSceneStateTool
+    {
+        public static System.Threading.Tasks.ValueTask<BuildSceneMutationResult> Execute(string rawPath, bool enabled, string toolName, UnityCliProjectToolContext ctx)
+        {
+            var path = BuildToolSupport.NormalizeAssetPath(rawPath);
+            if (string.IsNullOrEmpty(path))
+                throw new UnityCliBridge.BridgeCommandException("E_BUILD_SCENE_PATH_REQUIRED", toolName + " requires path.", "Pass a scene path such as Assets/Scenes/Main.unity.");
+            var scenes = ReadScenes();
+            var index = scenes.ToList().FindIndex(scene => scene.path == path);
+            if (index < 0)
+                throw new UnityCliBridge.BridgeCommandException("E_BUILD_SCENE_NOT_FOUND", "Build Settings does not contain scene: " + path, "Run build.scene.list and pass a listed path.");
+            if (!ctx.DryRun)
+            {
+                ctx.CommitEffect();
+                scenes[index] = new EditorBuildSettingsScene(path, enabled);
+                EditorBuildSettings.scenes = scenes;
+                scenes = ReadScenes();
+                if (!scenes.Any(scene => scene.path == path && scene.enabled == enabled))
+                    throw new UnityCliBridge.BridgeCommandException("E_BUILD_SCENE_STATE_MISMATCH", "Build Settings did not apply the requested enabled state for " + path + ".", "Inspect build.scene.list and retry.");
+            }
+            return new(new BuildSceneMutationResult { Count = scenes.LongLength, DryRun = ctx.DryRun });
+        }
+
+        public static EditorBuildSettingsScene[] ReadScenes()
+        {
+            return EditorBuildSettings.scenes ?? new EditorBuildSettingsScene[0];
+        }
+    }
+}
+#endif

package/unitypkg/Editor/Tools/build/BuildSettingsToolSupport.cs

@@ -0,0 +1,4 @@
+#if UNITY_EDITOR
+using UnityEditor;
+namespace UnityCli { public static class BuildSettingsToolSupport { public static BuildSettingsResult Read() => new BuildSettingsResult { ProductName = PlayerSettings.productName, BundleVersion = PlayerSettings.bundleVersion, CompanyId = PlayerSettings.companyName, ApplicationIdentifier = PlayerSettings.applicationIdentifier, ScriptingBackend = PlayerSettings.GetScriptingBackend(BuildTargetGroup.Unknown).ToString(), ApiCompatibilityLevel = PlayerSettings.GetApiCompatibilityLevel(BuildTargetGroup.Unknown).ToString() }; } }
+#endif

package/unitypkg/Editor/Tools/build/BuildToolDtos.cs

@@ -0,0 +1,15 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+namespace UnityCli
+{
+    public sealed class BuildPlatformResult { public string ActiveTarget { get; set; } public string ActiveTargetGroup { get; set; } public bool Switched { get; set; } public bool Changed { get; set; } public string NoOpReason { get; set; } public bool DryRun { get; set; } }
+    public sealed class BuildProfileEntry { public string Path { get; set; } public string Name { get; set; } public bool Active { get; set; } }
+    public sealed class BuildProfileListResult { public bool Available { get; set; } public string ActivePath { get; set; } public List<BuildProfileEntry> Profiles { get; set; } }
+    public sealed class BuildProfileMutationResult { public bool Available { get; set; } public string Action { get; set; } public string ActivePath { get; set; } public bool DryRun { get; set; } }
+    public sealed class BuildSceneEntry { public string Path { get; set; } public bool Enabled { get; set; } public long BuildIndex { get; set; } }
+    public sealed class BuildSceneListResult { public long Count { get; set; } public List<BuildSceneEntry> Scenes { get; set; } }
+    public sealed class BuildSceneMutationResult { public long Count { get; set; } public bool Changed { get; set; } public string NoOpReason { get; set; } public bool DryRun { get; set; } }
+    public sealed class BuildSettingsResult { public string ProductName { get; set; } public string BundleVersion { get; set; } public string CompanyId { get; set; } public string ApplicationIdentifier { get; set; } public string ScriptingBackend { get; set; } public string ApiCompatibilityLevel { get; set; } public List<string> Changed { get; set; } public bool DryRun { get; set; } }
+    public sealed class BuildSettingsMutationResult { public List<string> Changed { get; set; } public bool DryRun { get; set; } }
+}
+#endif

package/unitypkg/Editor/Tools/build/BuildToolSupport.cs

@@ -0,0 +1,111 @@
+#if UNITY_EDITOR
+using System.IO;
+using System.Reflection;
+using UnityEditor;
+using UnityEngine;
+
+namespace UnityCli
+{
+    /// <summary>
+    /// build 域 IUnityCliTool 共享的基础设施 helper:Build Profile 反射、路径规范化、忙状态拦截。
+    /// 仅供 build 域自包含工具复用;不实现 IUnityCliTool,不参与工具发现。
+    /// </summary>
+    public static class BuildToolSupport
+    {
+        /// <summary>拦截编译/导入/构建/PlayMode 过渡期的写入请求,避免脏状态写入。</summary>
+        public static void EnsureEditorNotBusy(string command)
+        {
+            if (EditorApplication.isCompiling)
+            {
+                throw new UnityCliBridge.BridgeCommandException("E_UNITY_COMPILING", "Unity Editor is compiling scripts.", "Wait for Unity to finish compiling and retry.", transient: true, retryAfterMs: 5000);
+            }
+            if (EditorApplication.isUpdating)
+            {
+                throw new UnityCliBridge.BridgeCommandException("E_UNITY_IMPORTING", "Unity Editor is importing assets.", "Wait for Unity to finish importing and retry.", transient: true, retryAfterMs: 5000);
+            }
+            if (UnityCliBridge.IsPlayModeChanging())
+            {
+                throw new UnityCliBridge.BridgeCommandException("E_UNITY_PLAY_MODE", "Unity Editor is entering or exiting Play mode.", "Wait for Play mode transition to complete and retry.", transient: true, retryAfterMs: 3000);
+            }
+            if (BuildPipeline.isBuildingPlayer)
+            {
+                throw new UnityCliBridge.BridgeCommandException("E_UNITY_BUSY", "Unity Editor is building the player.", "Wait for the build to complete and retry.", transient: true, retryAfterMs: 10000);
+            }
+        }
+
+        /// <summary>Assets/ 路径规范化:反斜杠转正斜杠并去首尾空白。</summary>
+        public static string NormalizeAssetPath(string rawPath)
+        {
+            return string.IsNullOrEmpty(rawPath) ? null : rawPath.Replace('\\', '/').Trim();
+        }
+
+        /// <summary>在已加载程序集中按完整名称查找 Unity 类型。</summary>
+        public static System.Type FindUnityType(string fullName)
+        {
+            foreach (var assembly in System.AppDomain.CurrentDomain.GetAssemblies())
+            {
+                System.Type type = null;
+                try { type = assembly.GetType(fullName, false); } catch { }
+                if (type != null) return type;
+            }
+            return null;
+        }
+
+        /// <summary>解析当前 Unity 版本可用的 Build Profile 类型。</summary>
+        public static System.Type BuildProfileType()
+        {
+            return FindUnityType("UnityEditor.Build.Profile.BuildProfile") ?? FindUnityType("UnityEditor.BuildProfile");
+        }
+
+        /// <summary>要求当前 Editor 提供 Build Profile API。</summary>
+        public static System.Type RequireBuildProfileType(string toolName)
+        {
+            var profileType = BuildProfileType();
+            if (profileType == null)
+            {
+                throw new UnityCliBridge.BridgeCommandException("E_BUILD_PROFILE_API_UNAVAILABLE", "Unity Build Profile API is not available in this Editor version.", "Use build.settings.get, build.scene.list, or build.platform.get, or upgrade Unity.");
+            }
+            return profileType;
+        }
+
+        /// <summary>验证并加载指定路径的 Build Profile 资产。</summary>
+        public static UnityEngine.Object LoadProfile(System.Type profileType, string path, string toolName)
+        {
+            if (string.IsNullOrEmpty(path)) throw new UnityCliBridge.BridgeCommandException("E_BUILD_PROFILE_PATH_REQUIRED", toolName + " requires path.", "Pass an existing Build Profile asset path.");
+            var profile = AssetDatabase.LoadAssetAtPath(path, profileType);
+            if (profile == null) throw new UnityCliBridge.BridgeCommandException("E_BUILD_PROFILE_NOT_FOUND", "Build Profile was not found: " + path, "Run build.profile.list and pass an existing path.");
+            return profile;
+        }
+
+        /// <summary>验证新建 Build Profile 所需的资产路径。</summary>
+        public static void RequireProfilePath(string path, string toolName)
+        {
+            if (string.IsNullOrEmpty(path)) throw new UnityCliBridge.BridgeCommandException("E_BUILD_PROFILE_PATH_REQUIRED", toolName + " requires path.", "Pass an Assets/*.asset path for the new Build Profile.");
+        }
+
+        /// <summary>通过反射读取当前激活 Build Profile；属性不可用时返回 null。</summary>
+        public static UnityEngine.Object ActiveBuildProfile(System.Type profileType)
+        {
+            var prop = typeof(EditorUserBuildSettings).GetProperty("activeBuildProfile", BindingFlags.Public | BindingFlags.Static);
+            return prop != null && profileType.IsAssignableFrom(prop.PropertyType) ? prop.GetValue(null, null) as UnityEngine.Object : null;
+        }
+
+        /// <summary>通过反射设置当前 Build Profile;API 不存在时抛稳定错误。</summary>
+        public static void SetActiveBuildProfile(System.Type profileType, UnityEngine.Object profile)
+        {
+            var prop = typeof(EditorUserBuildSettings).GetProperty("activeBuildProfile", BindingFlags.Public | BindingFlags.Static);
+            if (prop == null || !prop.CanWrite || !profileType.IsAssignableFrom(prop.PropertyType))
+            {
+                throw new UnityCliBridge.BridgeCommandException("E_BUILD_PROFILE_SWITCH_UNSUPPORTED", "This Unity version does not expose EditorUserBuildSettings.activeBuildProfile.", "Use build.platform.get or build.settings.get, or upgrade Unity.");
+            }
+            prop.SetValue(null, profile, null);
+        }
+
+        /// <summary>Unity 工程根目录(Assets 的父目录)。</summary>
+        public static string ProjectRoot()
+        {
+            return Directory.GetParent(Application.dataPath).FullName;
+        }
+    }
+}
+#endif

package/unitypkg/Editor/Tools/build/platform/get.cs

@@ -0,0 +1,12 @@
+#if UNITY_EDITOR
+using UnityEditor;
+namespace UnityCli
+{
+    public class BuildPlatformGetTool : IUnityCliTool<BuildPlatformGetTool.Request, BuildPlatformResult>
+    {
+        public sealed class Request { }
+        public ToolDescriptor Describe() => new() { Name = "build.platform.get", Summary = "Read the active Unity build target and target group.", Description = "Returns the active BuildTarget and selected BuildTargetGroup without modifying project or session state. Available in Edit and Play mode.", Group = "build",Target = "editor", PlayModeSupport = "editor-only", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Read active build target", Input = new Request() } } };
+        public System.Threading.Tasks.ValueTask<BuildPlatformResult> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default) => new(new BuildPlatformResult { ActiveTarget = EditorUserBuildSettings.activeBuildTarget.ToString(), ActiveTargetGroup = EditorUserBuildSettings.selectedBuildTargetGroup.ToString() });
+    }
+}
+#endif

package/unitypkg/Editor/Tools/build/platform/set.cs

@@ -0,0 +1,45 @@
+#if UNITY_EDITOR
+using System;
+using UnityEditor;
+
+namespace UnityCli
+{
+    public class BuildPlatformSetTool : IUnityCliTool<BuildPlatformSetTool.Request, BuildPlatformResult>
+    {
+        public sealed class Request { [UnityCliRequired] public string Target { get; set; } }
+
+        public ToolDescriptor Describe() => new() { Name = "build.platform.set", Summary = "Switch the active Unity build target and return its stable readback, with dry-run support.", Description = "Switch the Editor active BuildTarget, absorb platform reload/import, and return only after EditorUserBuildSettings.activeBuildTarget equals the requested target in a stable generation. dryRun=true previews the switch.", Group = "build", DestructiveHint = true, SupportsDryRun = true, SideEffects = new[] { "build-target-switch" }, Target = "editor", PlayModeSupport = "editor-only", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Preview Windows 64 switch", Input = new Request { Target = "StandaloneWindows64" }, Execution = new ToolExampleExecution { DryRun = true } }, new ToolExample { Description = "Use Windows 64 target", Input = new Request { Target = "StandaloneWindows64" } } } };
+
+        /// <summary>首次调用执行 switch；reload redelivery 只验证 active target，不重复切换。</summary>
+        public async System.Threading.Tasks.ValueTask<BuildPlatformResult> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            if (string.IsNullOrEmpty(request.Target))
+                throw new UnityCliBridge.BridgeCommandException("E_BUILD_TARGET_REQUIRED", "build.platform.set requires target.", "Pass a BuildTarget such as StandaloneWindows64, Android, or iOS.");
+            if (!Enum.TryParse(request.Target, true, out BuildTarget target))
+                throw new UnityCliBridge.BridgeCommandException("E_BUILD_TARGET_UNKNOWN", "Unknown BuildTarget: " + request.Target, "Pass a valid BuildTarget enum name.");
+            if (ctx.DryRun) return new BuildPlatformResult { DryRun = true };
+            // effect 前现场采集当前平台，用于 Switched/Changed 证明本次切换是否真实发生。
+            var changed = EditorUserBuildSettings.activeBuildTarget != target;
+            BuildToolSupport.EnsureEditorNotBusy("build.platform.set");
+            if (changed)
+            {
+                ctx.CommitEffect();
+                if (!EditorUserBuildSettings.SwitchActiveBuildTarget(BuildPipeline.GetBuildTargetGroup(target), target))
+                    throw new UnityCliBridge.BridgeCommandException("E_BUILD_TARGET_SWITCH_FAILED", "Unity rejected the build target switch to " + target + ".", "Inspect Unity Console and installed platform modules.");
+            }
+            var ready = await ctx.Wait.UntilEditorReady(TimeSpan.FromMilliseconds(Math.Max(1, ctx.TimeoutMs)), ct);
+            var active = EditorUserBuildSettings.activeBuildTarget;
+            if (!ready || active != target)
+                throw new UnityCliBridge.BridgeCommandException("E_BUILD_TARGET_PROOF_MISSING", "The active build target does not match the requested target after recovery.", "Inspect editor.state and installed platform support before submitting a new request.");
+            return new BuildPlatformResult
+            {
+                Switched = changed,
+                Changed = changed,
+                NoOpReason = changed ? null : "active-target-already-matched",
+                ActiveTarget = active.ToString(),
+                ActiveTargetGroup = BuildPipeline.GetBuildTargetGroup(active).ToString()
+            };
+        }
+    }
+}
+#endif

package/unitypkg/Editor/Tools/build/profile/create.cs

@@ -0,0 +1,44 @@
+#if UNITY_EDITOR
+using UnityEditor;
+using UnityEngine;
+
+namespace UnityCli
+{
+    public class BuildProfileCreateTool : IUnityCliTool<BuildProfileCreateTool.Request, BuildProfileMutationResult>
+    {
+        public sealed class Request { [UnityCliRequired] public string Path { get; set; } public string Name { get; set; } }
+
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "build.profile.create", Summary = "Create a persistent Unity Build Profile asset, with dry-run support.",
+            Description = "Creates a Build Profile asset at path and optionally assigns its name. dryRun=true previews without writing. Available in Edit and Play mode when the Unity Build Profile API exists.",
+            Group = "build",DestructiveHint = true, SupportsDryRun = true,
+            SideEffects = new[] { "asset-write" }, Target = "editor", PlayModeSupport = "editor-only",
+            DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000,
+            Examples = new[] { new ToolExample { Description = "Create Windows profile", Input = new Request { Path = "Assets/BuildProfiles/Windows.asset", Name = "Windows" }, Execution = new ToolExampleExecution { DryRun = true } } }
+        };
+
+        /// <summary>创建 Build Profile，并通过 AssetDatabase 重新加载证明路径、类型和名称终态。</summary>
+        public System.Threading.Tasks.ValueTask<BuildProfileMutationResult> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            var type = BuildToolSupport.RequireBuildProfileType("build.profile.create");
+            BuildToolSupport.RequireProfilePath(request.Path, "build.profile.create");
+            if (AssetDatabase.LoadMainAssetAtPath(request.Path) != null)
+                throw new UnityCliBridge.BridgeCommandException("E_BUILD_PROFILE_ALREADY_EXISTS", "An asset already exists at " + request.Path + ".", "Pass a new Assets/*.asset path.");
+            if (ctx.DryRun)
+                return new(new BuildProfileMutationResult { Available = true, Action = "create", DryRun = true });
+
+            ctx.CommitEffect();
+            var profile = ScriptableObject.CreateInstance(type);
+            if (!string.IsNullOrEmpty(request.Name)) profile.name = request.Name;
+            AssetDatabase.CreateAsset(profile, request.Path);
+            AssetDatabase.SaveAssets();
+
+            var observed = AssetDatabase.LoadAssetAtPath(request.Path, type);
+            if (observed == null || (!string.IsNullOrEmpty(request.Name) && observed.name != request.Name))
+                throw new UnityCliBridge.BridgeCommandException("E_BUILD_PROFILE_CREATE_MISMATCH", "Build Profile readback did not match the requested path and name.", "Inspect build.profile.list and the target asset before retrying.");
+            return new(new BuildProfileMutationResult { Available = true, Action = "create" });
+        }
+    }
+}
+#endif

package/unitypkg/Editor/Tools/build/profile/list.cs

@@ -0,0 +1,12 @@
+#if UNITY_EDITOR
+using System.Collections.Generic; using UnityEditor;
+namespace UnityCli
+{
+    public class BuildProfileListTool : IUnityCliTool<BuildProfileListTool.Request, BuildProfileListResult>
+    {
+        public sealed class Request { }
+        public ToolDescriptor Describe() => new() { Name = "build.profile.list", Summary = "List Unity Build Profiles and identify the active profile.", Description = "Returns Build Profile assets and their active state. When this Unity Editor has no Build Profile API, returns available=false and an empty list. Read-only and available in Edit and Play mode.", Group = "build",Target = "editor", PlayModeSupport = "editor-only", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "List build profiles", Input = new Request() } } };
+        public System.Threading.Tasks.ValueTask<BuildProfileListResult> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default) { var type = BuildToolSupport.BuildProfileType(); if (type == null) return new(new BuildProfileListResult { Available = false, Profiles = new List<BuildProfileEntry>() }); var active = BuildToolSupport.ActiveBuildProfile(type); var profiles = new List<BuildProfileEntry>(); foreach (var guid in AssetDatabase.FindAssets("t:" + type.Name)) { var path = AssetDatabase.GUIDToAssetPath(guid); var profile = AssetDatabase.LoadAssetAtPath(path, type); profiles.Add(new BuildProfileEntry { Path = path, Name = profile == null ? System.IO.Path.GetFileNameWithoutExtension(path) : profile.name, Active = profile == active }); } return new(new BuildProfileListResult { Available = true, ActivePath = active == null ? null : AssetDatabase.GetAssetPath(active), Profiles = profiles }); }
+    }
+}
+#endif

package/unitypkg/Editor/Tools/build/profile/modify.cs

@@ -0,0 +1,42 @@
+#if UNITY_EDITOR
+using UnityEditor;
+
+namespace UnityCli
+{
+    public class BuildProfileModifyTool : IUnityCliTool<BuildProfileModifyTool.Request, BuildProfileMutationResult>
+    {
+        public sealed class Request { [UnityCliRequired] public string Path { get; set; } [UnityCliRequired] public string Name { get; set; } }
+
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "build.profile.modify", Summary = "Rename a persistent Unity Build Profile asset, with dry-run support.",
+            Description = "Updates the name of an existing Build Profile asset. dryRun=true previews without writing. Available in Edit and Play mode when the Unity Build Profile API exists.",
+            Group = "build",DestructiveHint = true, SupportsDryRun = true,
+            SideEffects = new[] { "asset-write" }, Target = "editor", PlayModeSupport = "editor-only",
+            DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000,
+            Examples = new[] { new ToolExample { Description = "Rename profile", Input = new Request { Path = "Assets/BuildProfiles/Windows.asset", Name = "Windows Release" }, Execution = new ToolExampleExecution { DryRun = true } } }
+        };
+
+        /// <summary>修改 Build Profile 名称，并重新加载资产验证持久化终态。</summary>
+        public System.Threading.Tasks.ValueTask<BuildProfileMutationResult> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            var type = BuildToolSupport.RequireBuildProfileType("build.profile.modify");
+            var profile = BuildToolSupport.LoadProfile(type, request.Path, "build.profile.modify");
+            if (string.IsNullOrEmpty(request.Name))
+                throw new UnityCliBridge.BridgeCommandException("E_BUILD_PROFILE_NAME_REQUIRED", "build.profile.modify requires name.", "Pass the new profile name.");
+            if (ctx.DryRun)
+                return new(new BuildProfileMutationResult { Available = true, Action = "modify", DryRun = true });
+
+            ctx.CommitEffect();
+            profile.name = request.Name;
+            EditorUtility.SetDirty(profile);
+            AssetDatabase.SaveAssets();
+
+            var observed = AssetDatabase.LoadAssetAtPath(request.Path, type);
+            if (observed == null || observed.name != request.Name)
+                throw new UnityCliBridge.BridgeCommandException("E_BUILD_PROFILE_MODIFY_MISMATCH", "Build Profile name readback did not match the requested value.", "Inspect build.profile.list and the target asset before retrying.");
+            return new(new BuildProfileMutationResult { Available = true, Action = "modify" });
+        }
+    }
+}
+#endif

package/unitypkg/Editor/Tools/build/profile/switch.cs

@@ -0,0 +1,30 @@
+#if UNITY_EDITOR
+using System;
+using UnityEditor;
+
+namespace UnityCli
+{
+    public class BuildProfileSwitchTool : IUnityCliTool<BuildProfileSwitchTool.Request, BuildProfileMutationResult>
+    {
+        public sealed class Request { [UnityCliRequired] public string Path { get; set; } }
+
+        public ToolDescriptor Describe() => new() { Name = "build.profile.switch", Summary = "Set the active Unity Build Profile and return its stable readback, with dry-run support.", Description = "Select an existing Build Profile, absorb any Editor reload/import, and return only after activeBuildProfile resolves to the requested asset path. dryRun=true previews the selection. Available only where Unity exposes activeBuildProfile.", Group = "build", DestructiveHint = true, SupportsDryRun = true, SideEffects = new[] { "build-profile-switch" }, Target = "editor", PlayModeSupport = "editor-only", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Activate Windows profile", Input = new Request { Path = "Assets/BuildProfiles/Windows.asset" }, Execution = new ToolExampleExecution { DryRun = true } } } };
+
+        /// <summary>reload redelivery 只读取 activeBuildProfile；不会再次设置 profile。</summary>
+        public async System.Threading.Tasks.ValueTask<BuildProfileMutationResult> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            var type = BuildToolSupport.RequireBuildProfileType("build.profile.switch");
+            var profile = BuildToolSupport.LoadProfile(type, request.Path, "build.profile.switch");
+            if (ctx.DryRun) return new BuildProfileMutationResult { Available = true, ActivePath = AssetDatabase.GetAssetPath(profile), DryRun = true };
+            ctx.CommitEffect();
+            BuildToolSupport.SetActiveBuildProfile(type, profile);
+            var ready = await ctx.Wait.UntilEditorReady(TimeSpan.FromMilliseconds(Math.Max(1, ctx.TimeoutMs)), ct);
+            var active = BuildToolSupport.ActiveBuildProfile(type);
+            var activePath = active == null ? null : AssetDatabase.GetAssetPath(active);
+            if (!ready || active != profile || !string.Equals(activePath, request.Path, StringComparison.Ordinal))
+                throw new UnityCliBridge.BridgeCommandException("E_BUILD_PROFILE_PROOF_MISSING", "The active Build Profile does not match the requested profile after recovery.", "Run build.profile.list and inspect Editor state before submitting a new request.");
+            return new BuildProfileMutationResult { Available = true, ActivePath = activePath };
+        }
+    }
+}
+#endif