@alpsckr/unitycli 0.4.2 → 0.4.4

package/unitypkg/Editor/Tools/extension/status.cs

@@ -1,87 +0,0 @@
-#if UNITY_EDITOR
-using System;
-using System.Collections.Generic;
-using System.IO;
-using System.Linq;
-
-namespace UnityCli
-{
-    /// <summary>
-    /// extension.status — 返回可选 Unity 包的安装可用性(Library/PackageCache 探测)。
-    /// </summary>
-    public class ExtensionStatusTool : IUnityCliTool<ExtensionStatusTool.Request, ExtensionStatusTool.Result>
-    {
-        public sealed class Request
-        {
-            public string ExtensionId { get; set; }
-            public string Id { get; set; }
-        }
-
-        public sealed class Result
-        {
-            public bool Ok { get; set; } = true;
-            public List<string> Installed { get; set; }
-            public List<PackageAvailability> Packages { get; set; }
-        }
-
-        public sealed class PackageAvailability
-        {
-            public string Name { get; set; }
-            public bool Available { get; set; }
-        }
-
-        public ToolDescriptor Describe() => new()
-        {
-            Name = "extension.status",
-            Summary = "Report optional Unity package availability for CLI extension flows.",
-            Description = "Return basic package availability status for CLI-side extension flows. Probes Library/PackageCache for known optional packages (probuilder, cinemachine, visualeffectgraph, URP, HDRP). Install/remove are handled by the CLI command layer.",
-            Group = "extension",
-            DestructiveHint = false,
-            Target = "editor",
-            PlayModeSupport = "supported",
-            DefaultTimeoutMs = 30000,
-            MaxTimeoutMs = 600000,
-            Examples = new[]
-            {
-                new ToolExample { Description = "Check extension package availability", Input = new Request { } }
-            }
-        };
-
-        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
-        {
-            // 已知可选包列表,用于检测扩展依赖的 Unity 包是否已安装
-            var optionalPackages = new[]
-            {
-                "com.unity.probuilder",
-                "com.unity.cinemachine",
-                "com.unity.visualeffectgraph",
-                "com.unity.render-pipelines.universal",
-                "com.unity.render-pipelines.high-definition"
-            };
-
-            var packages = new List<PackageAvailability>();
-            foreach (var pkg in optionalPackages.OrderBy(p => p, StringComparer.Ordinal))
-            {
-                var available = false;
-                try
-                {
-                    var matches = Directory.GetFiles("Library/PackageCache", pkg + "@*", SearchOption.TopDirectoryOnly);
-                    available = matches.Length > 0;
-                }
-                catch
-                {
-                    available = false;
-                }
-                packages.Add(new PackageAvailability { Name = pkg, Available = available });
-            }
-
-            return new System.Threading.Tasks.ValueTask<Result>(new Result
-            {
-                Ok = true,
-                Installed = new List<string>(),
-                Packages = packages
-            });
-        }
-    }
-}
-#endif

package/unitypkg/Editor/Tools/go/inspect.cs

@@ -1,49 +0,0 @@
-#if UNITY_EDITOR
-using UnityEngine;
-
-namespace UnityCli
-{
-    /// <summary>
-    /// go.inspect — 查看单个 GameObject 的摘要(id/name/path/active/tag/layer/transform/components/children)。
-    /// </summary>
-    public class GameObjectInspectTool : IUnityCliTool<GameObjectInspectTool.Request, GameObjectInspectTool.Result>
-    {
-        public sealed class Request
-        {
-            public string Target { get; set; }
-            public string Name { get; set; }
-            public string Path { get; set; }
-            public string Id { get; set; }
-        }
-
-        public sealed class Result
-        {
-            public GameObjectDetail GameObject { get; set; }
-        }
-
-        public ToolDescriptor Describe() => new()
-        {
-            Name = "go.inspect",
-            Summary = "Inspect one GameObject summary by name/path/id; use component.get for deep component fields.",
-            Description = "Inspect one GameObject by name, hierarchy path, or instance id. Returns transform, components and direct children; use object.get-data or component.get for deeper serialized data and keep go.find/scene.hierarchy for discovery.",
-            Group = "go",
-            DestructiveHint = false,
-            Target = "editor",
-            PlayModeSupport = "supported",
-            DefaultTimeoutMs = 30000,
-            MaxTimeoutMs = 600000,
-            Examples = new[]
-            {
-                new ToolExample { Description = "Inspect by hierarchy path", Input = new Request { Target = "Player/CameraRig" } }
-            }
-        };
-
-        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
-        {
-            var target = request.Target ?? request.Name ?? request.Path ?? request.Id;
-            var gameObject = GameObjectToolSupport.ResolveUniqueTarget(target, "GameObject inspect requires a target.");
-            return new System.Threading.Tasks.ValueTask<Result>(new Result { GameObject = GameObjectToolSupport.BuildGameObjectDetail(gameObject) });
-        }
-    }
-}
-#endif

package/unitypkg/Editor/Tools/graphics/pipeline-quality.cs

@@ -1,24 +0,0 @@
-#if UNITY_EDITOR
-using System.Collections.Generic;
-using UnityEditor;
-using UnityEngine;
-namespace UnityCli
-{
-    public class GraphicsPipelineQualityTool : IUnityCliTool<GraphicsPipelineQualityTool.Request, GraphicsPipelineQualityTool.Result>
-    {
-        public sealed class Request { public string QualityLevel { get; set; } }
-        public sealed class Result { public QualitySettingsInfo QualitySettings { get; set; } public List<GraphicsPlannedEffect> PlannedEffects { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "graphics.pipeline-quality", Summary = "Set the active quality level by name or index.", Description = "Set QualitySettings quality level.", Group = "graphics",DestructiveHint = true, SideEffects = new[] { "settings-write" }, Target = "editor", PlayModeSupport = "editor-only", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Select a quality level by name", Input = new Request { QualityLevel = "Medium" } } } };
-        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
-        {
-            if (string.IsNullOrEmpty(r.QualityLevel)) return new System.Threading.Tasks.ValueTask<Result>(new Result { QualitySettings = GraphicsToolSupport.BuildQualitySettings(), PlannedEffects = new List<GraphicsPlannedEffect>() });
-            var level = GraphicsToolSupport.ResolveQualityLevel(r.QualityLevel); // immutable validated plan
-            ctx.CommitEffect();
-            QualitySettings.SetQualityLevel(level, true);
-            AssetDatabase.SaveAssets();
-            if (QualitySettings.GetQualityLevel() != level) throw new UnityCliBridge.BridgeCommandException("E_PIPELINE_QUALITY_STATE_MISMATCH", "Quality level readback did not match the request.", "Retry after the editor is idle.");
-            return new System.Threading.Tasks.ValueTask<Result>(new Result { QualitySettings = GraphicsToolSupport.BuildQualitySettings(), PlannedEffects = new List<GraphicsPlannedEffect> { new GraphicsPlannedEffect { Type = "graphics.pipeline-quality", Property = "qualityLevel", Value = level.ToString() } } });
-        }
-    }
-}
-#endif

package/unitypkg/Editor/Tools/graphics/probe-positions.cs

@@ -1,58 +0,0 @@
-#if UNITY_EDITOR
-using System.Collections.Generic;
-using System.Globalization;
-using UnityEditor;
-using UnityEngine;
-using UnityEngine.Rendering;
-
-namespace UnityCli
-{
-    /// <summary>graphics.probe-positions — 读取/写入探针位置(ReflectionProbe 或 LightProbeGroup)。</summary>
-    public class GraphicsProbePositionsTool : IUnityCliTool<GraphicsProbePositionsTool.Request, GraphicsProbePositionsTool.Result>
-    {
-        public sealed class Request { public string Target { get; set; } public string Type { get; set; } public string Positions { get; set; } }
-        public sealed class Result { public string ProbeType { get; set; } public List<GraphicsPlannedEffect> PlannedEffects { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "graphics.probe-positions", Summary = "Read or update probe positions for a ReflectionProbe or LightProbeGroup.", Description = "Resolve a probe component by type (reflection or light), then optionally set positions.", Group = "graphics",DestructiveHint = false, SideEffects = new[] { "scene-modify" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Read probe positions", Input = new Request { Target = "Probes" } } } };
-        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
-        {
-            var probeType = r.Type ?? "reflection";
-            var reflection = string.Equals(probeType, "reflection", System.StringComparison.OrdinalIgnoreCase);
-            var light = string.Equals(probeType, "light", System.StringComparison.OrdinalIgnoreCase);
-            if (!reflection && !light) throw new UnityCliBridge.BridgeCommandException("E_PROBE_TYPE_INVALID", "Unsupported probe type: " + probeType, "Pass reflection or light.");
-            Component component = reflection ? (Component)PhysicsToolSupport.ResolveReflectionProbe(r.Target) : ResolveLightProbeGroup(r.Target);
-            if (component == null) throw new UnityCliBridge.BridgeCommandException("E_PROBE_NOT_FOUND", "Probe component not found: " + r.Target + " (type=" + probeType + ")", "Pass a GameObject name / hierarchy path with a ReflectionProbe or LightProbeGroup component.");
-            var effects = new List<GraphicsPlannedEffect>();
-            if (!string.IsNullOrEmpty(r.Positions))
-            {
-                var positions = GraphicsToolSupport.ParseVector3Array(r.Positions);
-                if (reflection && positions.Length != 1) throw new UnityCliBridge.BridgeCommandException("E_PROBE_POSITIONS_INVALID", "ReflectionProbe requires exactly one position.", "Pass one x,y,z position.");
-                ctx.CommitEffect();
-                UnityCliSceneMutation.RecordObject(component, "Set probe positions");
-                if (component is ReflectionProbe rp) { rp.center = positions.Length > 0 ? positions[0] : rp.center; effects.Add(new GraphicsPlannedEffect { Type = "graphics.probe-positions", Property = "reflectionCenter", Value = positions.Length.ToString() }); }
-                else if (component is LightProbeGroup lpg) { lpg.probePositions = positions; effects.Add(new GraphicsPlannedEffect { Type = "graphics.probe-positions", Property = "lightProbePositions", Value = positions.Length.ToString() }); }
-                UnityCliSceneMutation.MarkSceneObjectDirty(component);
-                UnityCliSceneMutation.MarkSceneDirty(component.gameObject.scene);
-                var observedObject = GameObjectToolSupport.ResolveUniqueTarget(component.gameObject.GetInstanceID().ToString(CultureInfo.InvariantCulture), "Probe target could not be re-resolved after mutation.");
-                var observedComponent = string.Equals(probeType, "reflection", System.StringComparison.OrdinalIgnoreCase) ? (Component)observedObject.GetComponent<ReflectionProbe>() : observedObject.GetComponent<LightProbeGroup>();
-                if (observedComponent == null || (observedComponent is ReflectionProbe observedReflection && (positions.Length == 0 || observedReflection.center != positions[0])) || (observedComponent is LightProbeGroup observedLight && !SamePositions(observedLight.probePositions, positions))) throw new UnityCliBridge.BridgeCommandException("E_PROBE_STATE_MISMATCH", "Probe positions did not retain the request.", "Retry after the editor is idle.");
-                component = observedComponent;
-            }
-            return new System.Threading.Tasks.ValueTask<Result>(new Result { ProbeType = probeType, PlannedEffects = effects });
-        }
-        private static bool SamePositions(Vector3[] actual, Vector3[] expected)
-        {
-            if (actual == null || actual.Length != expected.Length) return false;
-            for (var index = 0; index < expected.Length; index++) if (actual[index] != expected[index]) return false;
-            return true;
-        }
-
-        private static LightProbeGroup ResolveLightProbeGroup(string target)
-        {
-            var groups = UnityEngine.Object.FindObjectsOfType<LightProbeGroup>();
-            if (string.IsNullOrEmpty(target)) return groups.Length > 0 ? groups[0] : null;
-            foreach (var g in groups) if (GameObjectToolSupport.HierarchyPath(g.gameObject) == target || g.gameObject.name == target || g.GetInstanceID().ToString() == target) return g;
-            return null;
-        }
-    }
-}
-#endif

package/unitypkg/Editor/Tools/graphics/settings.cs

@@ -1,104 +0,0 @@
-#if UNITY_EDITOR
-using System.Collections.Generic;
-using UnityEditor;
-using UnityEngine;
-using UnityEngine.Rendering;
-
-namespace UnityCli
-{
-    /// <summary>
-    /// graphics.settings — 读取/写入 QualitySettings + GraphicsSettings.defaultRenderPipeline。
-    /// </summary>
-    public class GraphicsSettingsTool : IUnityCliTool<GraphicsSettingsTool.Request, GraphicsSettingsTool.Result>
-    {
-        public sealed class Request
-        {
-            public int? AntiAliasing { get; set; }
-            public float? ShadowDistance { get; set; }
-            public int? VSyncCount { get; set; }
-            public int? MasterTextureLimit { get; set; }
-            public float? LodBias { get; set; }
-            public int? MaximumLODLevel { get; set; }
-            public string RenderPipeline { get; set; }
-            public string Property { get; set; }
-            public string Value { get; set; }
-        }
-
-        public sealed class Result
-        {
-            public GraphicsSummary Graphics { get; set; }
-            public QualitySettingsInfo QualitySettings { get; set; }
-            public List<GraphicsPlannedEffect> PlannedEffects { get; set; }
-        }
-
-        public ToolDescriptor Describe() => new()
-        {
-            Name = "graphics.settings", Summary = "Read and update graphics settings including render pipeline asset and quality fields.",
-            Description = "Read or update QualitySettings fields and GraphicsSettings.defaultRenderPipeline. renderPipeline='built-in' or 'null' resets to built-in.",
-            Group = "graphics", DestructiveHint = true, SideEffects = new[] { "settings-write" },
-            Target = "editor", PlayModeSupport = "editor-only",
-            DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000,
-            Examples = new[] { new ToolExample { Description = "Read graphics settings", Input = new Request { } } }
-        };
-
-        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
-        {
-            var effects = new List<GraphicsPlannedEffect>();
-            var hasWrite = request.AntiAliasing.HasValue || request.ShadowDistance.HasValue || request.VSyncCount.HasValue || request.MasterTextureLimit.HasValue || request.LodBias.HasValue || request.MaximumLODLevel.HasValue || !string.IsNullOrEmpty(request.RenderPipeline) || (!string.IsNullOrEmpty(request.Property) && !string.IsNullOrEmpty(request.Value));
-            if (request.ShadowDistance.HasValue) GraphicsToolSupport.ParseFinite(request.ShadowDistance.Value.ToString(System.Globalization.CultureInfo.InvariantCulture), "shadowDistance", 0f, float.MaxValue);
-            if (request.LodBias.HasValue) GraphicsToolSupport.ParseFinite(request.LodBias.Value.ToString(System.Globalization.CultureInfo.InvariantCulture), "lodBias", 0.01f, 100f);
-            if (request.VSyncCount.HasValue && (request.VSyncCount.Value < 0 || request.VSyncCount.Value > 4)) throw new UnityCliBridge.BridgeCommandException("E_GRAPHICS_SETTING_INPUT_INVALID", "vSyncCount must be from 0 to 4.", "Pass a vSyncCount from 0 to 4.");
-            if (request.AntiAliasing.HasValue && request.AntiAliasing.Value != 0 && request.AntiAliasing.Value != 2 && request.AntiAliasing.Value != 4 && request.AntiAliasing.Value != 8) throw new UnityCliBridge.BridgeCommandException("E_GRAPHICS_SETTING_INPUT_INVALID", "antiAliasing must be 0, 2, 4, or 8.", "Pass a supported antiAliasing value.");
-            if (request.MasterTextureLimit.HasValue && !GraphicsToolSupport.IsValidTextureLod(request.MasterTextureLimit.Value)) throw new UnityCliBridge.BridgeCommandException("E_GRAPHICS_SETTING_INPUT_INVALID", "masterTextureLimit must be from 0 to 8.", "Pass a masterTextureLimit from 0 to 8.");
-            if (request.MaximumLODLevel.HasValue && !GraphicsToolSupport.IsValidMaximumLod(request.MaximumLODLevel.Value)) throw new UnityCliBridge.BridgeCommandException("E_GRAPHICS_SETTING_INPUT_INVALID", "maximumLODLevel must be from 0 to 100000.", "Pass a non-negative maximumLODLevel.");
-            RenderPipelineAsset requestedPipeline = null; var resetPipeline = false; string requestedPipelinePath = null; string requestedPipelineGuid = null;
-            if (!string.IsNullOrEmpty(request.RenderPipeline)) { resetPipeline = string.Equals(request.RenderPipeline, "null", System.StringComparison.OrdinalIgnoreCase) || string.Equals(request.RenderPipeline, "built-in", System.StringComparison.OrdinalIgnoreCase); if (!resetPipeline) { requestedPipelinePath = GraphicsToolSupport.NormalizeAssetPathRequired(request.RenderPipeline, ".asset"); requestedPipeline = AssetDatabase.LoadAssetAtPath<RenderPipelineAsset>(requestedPipelinePath); if (requestedPipeline == null) throw new UnityCliBridge.BridgeCommandException("E_RENDER_PIPELINE_NOT_FOUND", "RenderPipelineAsset not found: " + request.RenderPipeline, "Pass an existing Assets/*.asset RenderPipelineAsset path."); requestedPipelineGuid = AssetDatabase.AssetPathToGUID(requestedPipelinePath); if (string.IsNullOrEmpty(requestedPipelineGuid)) throw new UnityCliBridge.BridgeCommandException("E_RENDER_PIPELINE_NOT_FOUND", "RenderPipelineAsset has no stable GUID: " + request.RenderPipeline, "Pass an imported Assets/*.asset RenderPipelineAsset path."); } }
-            if (!string.IsNullOrEmpty(request.Property) || !string.IsNullOrEmpty(request.Value)) { if (string.IsNullOrEmpty(request.Property) || string.IsNullOrEmpty(request.Value)) throw new UnityCliBridge.BridgeCommandException("E_GRAPHICS_SETTING_INPUT_INVALID", "property and value must be provided together.", "Use a supported setting member and value."); if (request.Property != "vSyncCount" && request.Property != "antiAliasing" && request.Property != "shadowDistance" && request.Property != "masterTextureLimit" && request.Property != "lodBias" && request.Property != "maximumLODLevel") throw new UnityCliBridge.BridgeCommandException("E_GRAPHICS_SETTING_UNSUPPORTED", "Unsupported graphics setting: " + request.Property, "Use named graphics setting flags."); if (request.Property == "shadowDistance") GraphicsToolSupport.ParseFinite(request.Value, request.Property, 0f, float.MaxValue); else if (request.Property == "lodBias") GraphicsToolSupport.ParseFinite(request.Value, request.Property, 0.01f, 100f); else { int parsed; if (!int.TryParse(request.Value, System.Globalization.NumberStyles.Integer, System.Globalization.CultureInfo.InvariantCulture, out parsed) || (request.Property == "vSyncCount" && (parsed < 0 || parsed > 4)) || (request.Property == "antiAliasing" && parsed != 0 && parsed != 2 && parsed != 4 && parsed != 8) || (request.Property == "masterTextureLimit" && !GraphicsToolSupport.IsValidTextureLod(parsed)) || (request.Property == "maximumLODLevel" && !GraphicsToolSupport.IsValidMaximumLod(parsed))) throw new UnityCliBridge.BridgeCommandException("E_GRAPHICS_SETTING_INPUT_INVALID", "Invalid value: " + request.Value, "Pass a value within the supported range."); } }
-            if (hasWrite) ctx.CommitEffect();
-            if (request.AntiAliasing.HasValue) { QualitySettings.antiAliasing = request.AntiAliasing.Value; effects.Add(new GraphicsPlannedEffect { Type = "graphics.settings", Property = "antiAliasing", Value = request.AntiAliasing.Value.ToString() }); }
-            if (request.ShadowDistance.HasValue) { QualitySettings.shadowDistance = request.ShadowDistance.Value; effects.Add(new GraphicsPlannedEffect { Type = "graphics.settings", Property = "shadowDistance", Value = request.ShadowDistance.Value.ToString(System.Globalization.CultureInfo.InvariantCulture) }); }
-            if (request.VSyncCount.HasValue) { QualitySettings.vSyncCount = request.VSyncCount.Value; effects.Add(new GraphicsPlannedEffect { Type = "graphics.settings", Property = "vSyncCount", Value = request.VSyncCount.Value.ToString() }); }
-            if (request.MasterTextureLimit.HasValue) { QualitySettings.globalTextureMipmapLimit = request.MasterTextureLimit.Value; effects.Add(new GraphicsPlannedEffect { Type = "graphics.settings", Property = "masterTextureLimit", Value = request.MasterTextureLimit.Value.ToString() }); }
-            if (request.LodBias.HasValue) { QualitySettings.lodBias = request.LodBias.Value; effects.Add(new GraphicsPlannedEffect { Type = "graphics.settings", Property = "lodBias", Value = request.LodBias.Value.ToString(System.Globalization.CultureInfo.InvariantCulture) }); }
-            if (request.MaximumLODLevel.HasValue) { QualitySettings.maximumLODLevel = request.MaximumLODLevel.Value; effects.Add(new GraphicsPlannedEffect { Type = "graphics.settings", Property = "maximumLODLevel", Value = request.MaximumLODLevel.Value.ToString() }); }
-            if (!string.IsNullOrEmpty(request.RenderPipeline))
-            {
-                GraphicsSettings.defaultRenderPipeline = resetPipeline ? null : requestedPipeline;
-                effects.Add(new GraphicsPlannedEffect { Type = "graphics.settings", Property = "renderPipeline", Value = request.RenderPipeline });
-            }
-            if (!string.IsNullOrEmpty(request.Property) && !string.IsNullOrEmpty(request.Value))
-            {
-                ApplyGenericGraphicsSetting(request.Property, request.Value, effects);
-            }
-            if (effects.Count > 0) AssetDatabase.SaveAssets();
-            RenderPipelineAsset observedPipeline = null;
-            if (!string.IsNullOrEmpty(request.RenderPipeline) && !resetPipeline) observedPipeline = GraphicsToolSupport.ReloadAsset<RenderPipelineAsset>(requestedPipelinePath, requestedPipelineGuid);
-            var observed = GraphicsToolSupport.BuildQualitySettings();
-            if ((request.AntiAliasing.HasValue && observed.AntiAliasing != request.AntiAliasing.Value) || (request.VSyncCount.HasValue && observed.VSyncCount != request.VSyncCount.Value) || (request.ShadowDistance.HasValue && !Mathf.Approximately((float)observed.ShadowDistance, request.ShadowDistance.Value)) || (request.MasterTextureLimit.HasValue && observed.MasterTextureLimit != request.MasterTextureLimit.Value) || (request.LodBias.HasValue && !Mathf.Approximately((float)observed.LodBias, request.LodBias.Value)) || (request.MaximumLODLevel.HasValue && observed.MaximumLODLevel != request.MaximumLODLevel.Value) || (!string.IsNullOrEmpty(request.Property) && !GenericSettingMatches(observed, request.Property, request.Value)) || (!string.IsNullOrEmpty(request.RenderPipeline) && GraphicsSettings.defaultRenderPipeline != observedPipeline)) throw new UnityCliBridge.BridgeCommandException("E_GRAPHICS_SETTINGS_STATE_MISMATCH", "Graphics settings readback did not match the request.", "Retry after the editor is idle.");
-            return new System.Threading.Tasks.ValueTask<Result>(new Result { Graphics = GraphicsToolSupport.BuildGraphicsSummary(), QualitySettings = observed, PlannedEffects = effects });
-        }
-
-        private static bool GenericSettingMatches(QualitySettingsInfo observed, string property, string value)
-        {
-            if (property == "vSyncCount") return observed.VSyncCount == int.Parse(value, System.Globalization.CultureInfo.InvariantCulture);
-            if (property == "antiAliasing") return observed.AntiAliasing == int.Parse(value, System.Globalization.CultureInfo.InvariantCulture);
-            if (property == "shadowDistance") return Mathf.Approximately((float)observed.ShadowDistance, GameObjectToolSupport.ParseFloat(value, property));
-            if (property == "masterTextureLimit") return observed.MasterTextureLimit == int.Parse(value, System.Globalization.CultureInfo.InvariantCulture);
-            if (property == "lodBias") return Mathf.Approximately((float)observed.LodBias, GameObjectToolSupport.ParseFloat(value, property));
-            return property == "maximumLODLevel" && observed.MaximumLODLevel == int.Parse(value, System.Globalization.CultureInfo.InvariantCulture);
-        }
-
-        private static void ApplyGenericGraphicsSetting(string property, string value, List<GraphicsPlannedEffect> effects)
-        {
-            if (property == "vSyncCount") QualitySettings.vSyncCount = int.Parse(value, System.Globalization.CultureInfo.InvariantCulture);
-            else if (property == "antiAliasing") QualitySettings.antiAliasing = int.Parse(value, System.Globalization.CultureInfo.InvariantCulture);
-            else if (property == "shadowDistance") QualitySettings.shadowDistance = GameObjectToolSupport.ParseFloat(value, property);
-            else if (property == "masterTextureLimit") QualitySettings.globalTextureMipmapLimit = int.Parse(value, System.Globalization.CultureInfo.InvariantCulture);
-            else if (property == "lodBias") QualitySettings.lodBias = GameObjectToolSupport.ParseFloat(value, property);
-            else if (property == "maximumLODLevel") QualitySettings.maximumLODLevel = int.Parse(value, System.Globalization.CultureInfo.InvariantCulture);
-            else throw new UnityCliBridge.BridgeCommandException("E_GRAPHICS_SETTING_UNSUPPORTED", "Unsupported graphics setting: " + property, "Use named flags such as --anti-aliasing, --shadow-distance or --render-pipeline.");
-            effects.Add(new GraphicsPlannedEffect { Type = "graphics.settings", Property = property, Value = value });
-        }
-    }
-}
-#endif

package/unitypkg/Editor/Tools/graphics/stats-counters.cs

@@ -1,28 +0,0 @@
-#if UNITY_EDITOR
-using System.Collections.Generic;
-using UnityEditor;
-using UnityEngine;
-
-namespace UnityCli
-{
-    /// <summary>graphics.stats-counters — 读取渲染统计计数器列表。</summary>
-    public class GraphicsStatsCountersTool : IUnityCliTool<GraphicsStatsCountersTool.Request, GraphicsStatsCountersTool.Result>
-    {
-        public sealed class Request { }
-        public sealed class Result { public List<GraphicsPlannedEffect> Counters { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "graphics.stats-counters", Summary = "Read render stats as a flat counter list (drawCalls, batches, triangles, vertices, setPass, renderTextures).", Description = "Read-only: returns render stats as key-value counter entries.", Group = "graphics",DestructiveHint = false, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Read counters", Input = new Request { } } } };
-        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
-        {
-            var s = GraphicsToolSupport.BuildRenderStats();
-            return new System.Threading.Tasks.ValueTask<Result>(new Result { Counters = new List<GraphicsPlannedEffect> {
-                new GraphicsPlannedEffect { Property = "drawCalls", Value = s.DrawCalls.ToString() },
-                new GraphicsPlannedEffect { Property = "batches", Value = s.Batches.ToString() },
-                new GraphicsPlannedEffect { Property = "triangles", Value = s.Triangles.ToString() },
-                new GraphicsPlannedEffect { Property = "vertices", Value = s.Vertices.ToString() },
-                new GraphicsPlannedEffect { Property = "setPassCalls", Value = s.SetPassCalls.ToString() },
-                new GraphicsPlannedEffect { Property = "renderTextureCount", Value = s.RenderTextureCount.ToString() },
-            } });
-        }
-    }
-}
-#endif

package/unitypkg/Editor/Tools/graphics/stats-memory.cs

@@ -1,21 +0,0 @@
-#if UNITY_EDITOR
-using System.Collections.Generic;
-using UnityEditor;
-using UnityEngine;
-
-namespace UnityCli
-{
-    /// <summary>graphics.stats-memory — 读取渲染内存统计。</summary>
-    public class GraphicsStatsMemoryTool : IUnityCliTool<GraphicsStatsMemoryTool.Request, GraphicsStatsMemoryTool.Result>
-    {
-        public sealed class Request { }
-        public sealed class Result { public long UsedTextureMemory { get; set; } public long RenderTextureBytes { get; set; } public long UsedVertexBuffer { get; set; } public long UsedVertexBufferVRAM { get; set; } public long RenderTextureCount { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "graphics.stats-memory", Summary = "Read render memory statistics (texture memory, render texture bytes, vertex buffer).", Description = "Read-only: returns GPU memory usage from render stats.", Group = "graphics",DestructiveHint = false, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Read memory stats", Input = new Request { } } } };
-        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
-        {
-            var s = GraphicsToolSupport.BuildRenderStats();
-            return new System.Threading.Tasks.ValueTask<Result>(new Result { UsedTextureMemory = s.UsedTextureMemory, RenderTextureBytes = s.RenderTextureBytes, UsedVertexBuffer = s.UsedVertexBuffer, UsedVertexBufferVRAM = s.UsedVertexBufferVRAM, RenderTextureCount = s.RenderTextureCount });
-        }
-    }
-}
-#endif

package/unitypkg/Editor/Tools/instances/list.cs

@@ -1,71 +0,0 @@
-#if UNITY_EDITOR
-using System.Collections.Generic;
-using System.IO;
-using UnityEngine;
-
-namespace UnityCli.Tools.Instances
-{
-    /// <summary>
-    /// instances.list 只读 Tool：读取当前 Unity Bridge 进程自身实例摘要。
-    /// </summary>
-    public class InstancesListTool : IUnityCliTool<InstancesListTool.Request, InstancesListTool.Result>
-    {
-        public sealed class Request { }
-
-        public sealed class InstanceInfo
-        {
-            public string InstanceId { get; set; }
-            public string ProjectPath { get; set; }
-            public string UnityVersion { get; set; }
-            public string Status { get; set; }
-        }
-
-        public sealed class Result
-        {
-            public List<InstanceInfo> Instances { get; set; }
-            public long Count { get; set; }
-        }
-
-        public ToolDescriptor Describe() => new()
-        {
-            Name = "instances.list",
-            Summary = "Read the current logical Unity project instance summary from the live Editor process.",
-            Description = "Read the CanonicalPath v1 project identity, canonical project path, Unity version, and ready status visible to the current Editor process.",
-            DestructiveHint = false,
-            Group = "instances",
-            Target = "editor",
-            PlayModeSupport = "supported",
-            Examples = new[] { new ToolExample { Description = "Read the current Bridge instance", Input = new Request { } } }
-        };
-
-        /// <summary>读取当前 Editor 的逻辑项目 identity 和业务 readiness 摘要。</summary>
-        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
-        {
-            var identity = UnityCliCanonicalProjectPath.Resolve(ProjectRoot(ctx));
-            var instances = new List<InstanceInfo>
-            {
-                new InstanceInfo
-                {
-                    InstanceId = identity.InstanceId,
-                    ProjectPath = identity.CanonicalProjectPath,
-                    UnityVersion = Application.unityVersion,
-                    Status = "ready"
-                }
-            };
-
-            return new System.Threading.Tasks.ValueTask<Result>(new Result
-            {
-                Instances = instances,
-                Count = instances.Count
-            });
-        }
-
-        // 优先使用 registry 注入的项目路径；缺失时回退到当前 Unity project root。
-        private static string ProjectRoot(UnityCliProjectToolContext ctx)
-        {
-            if (ctx != null && !string.IsNullOrEmpty(ctx.ProjectPath)) return ctx.ProjectPath;
-            return Path.GetDirectoryName(Application.dataPath);
-        }
-    }
-}
-#endif

package/unitypkg/Editor/Tools/physics/raycast-all.cs

@@ -1,67 +0,0 @@
-#if UNITY_EDITOR
-using System;
-using System.Collections.Generic;
-using UnityEngine;
-
-namespace UnityCli
-{
-    /// <summary>
-    /// physics.raycast-all — 3D/2D 射线查询,返回所有命中。
-    /// </summary>
-    public class PhysicsRaycastAllTool : IUnityCliTool<PhysicsRaycastAllTool.Request, PhysicsRaycastAllTool.Result>
-    {
-        public sealed class Request
-        {
-            public string Mode { get; set; }
-            public float OriginX { get; set; }
-            public float OriginY { get; set; }
-            public float OriginZ { get; set; }
-            public float DirectionX { get; set; }
-            public float DirectionY { get; set; }
-            public float DirectionZ { get; set; } = 1f;
-            public float Distance { get; set; } = 100f;
-            public int? LayerMask { get; set; }
-        }
-
-        public sealed class Result
-        {
-            public long HitCount { get; set; }
-            public List<RaycastHitInfo> Hits { get; set; }
-        }
-
-        public ToolDescriptor Describe() => new()
-        {
-            Name = "physics.raycast-all",
-            Summary = "Cast a 3D or 2D ray and return all hits along the path.",
-            Description = "Cast a ray and return all collider hits, sorted by distance (3D). mode=3d (default) or 2d.",
-            Group = "physics",DestructiveHint = false,
-            Target = "editor", PlayModeSupport = "supported",
-            DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000,
-            Examples = new[] { new ToolExample { Description = "All hits forward", Input = new Request { OriginY = 1f, DirectionZ = 1f } } }
-        };
-
-        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
-        {
-            var mode = PhysicsToolSupport.NormalizeMode(request.Mode);
-            var distance = Math.Max(0f, request.Distance);
-            var layerMask = request.LayerMask ?? Physics.DefaultRaycastLayers;
-            if (mode == "2d")
-            {
-                var origin = new Vector2(request.OriginX, request.OriginY);
-                var direction = PhysicsToolSupport.NormalizeVector2(new Vector2(request.DirectionX, request.DirectionY));
-                var hits = Physics2D.RaycastAll(origin, direction, distance, layerMask);
-                var hitList = new List<RaycastHitInfo>();
-                foreach (var h in hits) hitList.Add(PhysicsToolSupport.BuildRaycast2DHit(h));
-                return new System.Threading.Tasks.ValueTask<Result>(new Result { HitCount = hits.Length, Hits = hitList });
-            }
-            var origin3d = new Vector3(request.OriginX, request.OriginY, request.OriginZ);
-            var direction3d = PhysicsToolSupport.NormalizeVector3(new Vector3(request.DirectionX, request.DirectionY, request.DirectionZ));
-            var hits3d = Physics.RaycastAll(origin3d, direction3d, distance, layerMask);
-            Array.Sort(hits3d, (a, b) => a.distance.CompareTo(b.distance));
-            var list = new List<RaycastHitInfo>();
-            foreach (var h in hits3d) list.Add(PhysicsToolSupport.BuildRaycast3DHit(h));
-            return new System.Threading.Tasks.ValueTask<Result>(new Result { HitCount = hits3d.Length, Hits = list });
-        }
-    }
-}
-#endif

package/unitypkg/Editor/Tools/scene/build-settings.cs

@@ -1,69 +0,0 @@
-#if UNITY_EDITOR
-using UnityEditor;
-using UnityEngine.SceneManagement;
-
-namespace UnityCli
-{
-    /// <summary>
-    /// scene.build-settings — 列出 Editor Build Settings 中注册的场景(enabled 与路径)。
-    /// </summary>
-    public class SceneBuildSettingsTool : IUnityCliTool<SceneBuildSettingsTool.Request, SceneBuildSettingsTool.Result>
-    {
-        public sealed class Request
-        {
-            // scene.build-settings 无入参
-        }
-
-        public sealed class Result
-        {
-            public System.Collections.Generic.List<BuildSceneEntry> Scenes { get; set; }
-            public long Count { get; set; }
-        }
-
-        public sealed class BuildSceneEntry
-        {
-            public string Path { get; set; }
-            public bool Enabled { get; set; }
-            public long BuildIndex { get; set; }
-        }
-
-        public ToolDescriptor Describe() => new()
-        {
-            Name = "scene.build-settings",
-            Summary = "List scenes registered in the Editor Build Settings (enabled scenes and their paths).",
-            Description = "List scenes registered in the Editor Build Settings (enabled scenes and their paths). Read-only; use build.scene.add or build.scene.remove to change the build list.",
-            Group = "scene",
-            DestructiveHint = false,
-            Target = "editor",
-            PlayModeSupport = "supported",
-            DefaultTimeoutMs = 30000,
-            MaxTimeoutMs = 600000,
-            Examples = new[]
-            {
-                new ToolExample { Description = "List build settings scenes", Input = new Request { } }
-            }
-        };
-
-        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
-        {
-            var scenes = EditorBuildSettings.scenes ?? new EditorBuildSettingsScene[0];
-            var entries = new System.Collections.Generic.List<BuildSceneEntry>();
-            for (var index = 0; index < scenes.Length; index++)
-            {
-                var scene = scenes[index];
-                entries.Add(new BuildSceneEntry
-                {
-                    Path = SceneToolSupport.NormalizeAssetPath(scene.path),
-                    Enabled = scene.enabled,
-                    BuildIndex = (long)index
-                });
-            }
-            return new System.Threading.Tasks.ValueTask<Result>(new Result
-            {
-                Scenes = entries,
-                Count = (long)scenes.Length
-            });
-        }
-    }
-}
-#endif