@alpsckr/unitycli 0.4.4 → 0.5.0

package/unitypkg/Editor/Tools/{graphics/skybox-set-fog.cs → lighting/skybox/set-fog.cs}

@@ -3,11 +3,11 @@ using System.Collections.Generic;
 using UnityEngine;
 namespace UnityCli
 {
-    public class GraphicsSkyboxSetFogTool : IUnityCliTool<GraphicsSkyboxSetFogTool.Request, GraphicsSkyboxSetFogTool.Result>
+    public class LightingSkyboxSetFogTool : IUnityCliTool<LightingSkyboxSetFogTool.Request, LightingSkyboxSetFogTool.Result>
     {
         public sealed class Request { public bool? Enabled { get; set; } public string Mode { get; set; } public string Color { get; set; } public float? Density { get; set; } public float? StartDistance { get; set; } public float? EndDistance { get; set; } }
         public sealed class Result { public bool Fog { get; set; } public string FogMode { get; set; } public string FogColor { get; set; } public double FogDensity { get; set; } public double FogStartDistance { get; set; } public double FogEndDistance { get; set; } public List<GraphicsPlannedEffect> PlannedEffects { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "graphics.skybox-set-fog", Summary = "Set fog.", Description = "Set RenderSettings fog values.", Group = "graphics",SideEffects = new[] { "settings-write" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Enable linear fog", Input = new Request { Enabled = true, Mode = "Linear", Color = "#808080", StartDistance = 0f, EndDistance = 100f } } } };
+        public ToolDescriptor Describe() => new() { Name = "lighting.skybox.set-fog", Summary = "Set fog.", Description = "Set RenderSettings fog values.", Group = "lighting",SideEffects = new[] { "settings-write" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Enable linear fog", Input = new Request { Enabled = true, Mode = "Linear", Color = "#808080", StartDistance = 0f, EndDistance = 100f } } } };
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             FogMode? mode = string.IsNullOrEmpty(r.Mode) ? (FogMode?)null : GraphicsToolSupport.ParseEnum<FogMode>(r.Mode, "mode"); var color = string.IsNullOrEmpty(r.Color) ? (Color?)null : GraphicsToolSupport.ParseColor(r.Color);
@@ -16,7 +16,7 @@ namespace UnityCli
             if (!r.Enabled.HasValue && !mode.HasValue && !color.HasValue && !density.HasValue && !start.HasValue && !end.HasValue) return new System.Threading.Tasks.ValueTask<Result>(Read(new List<GraphicsPlannedEffect>()));
             ctx.CommitEffect(); if (r.Enabled.HasValue) RenderSettings.fog = r.Enabled.Value; if (mode.HasValue) RenderSettings.fogMode = mode.Value; if (color.HasValue) RenderSettings.fogColor = color.Value; if (density.HasValue) RenderSettings.fogDensity = density.Value; if (start.HasValue) RenderSettings.fogStartDistance = start.Value; if (end.HasValue) RenderSettings.fogEndDistance = end.Value;
             if ((r.Enabled.HasValue && RenderSettings.fog != r.Enabled.Value) || (mode.HasValue && RenderSettings.fogMode != mode.Value) || (color.HasValue && !GraphicsToolSupport.SameColor(RenderSettings.fogColor, color.Value)) || (density.HasValue && !Mathf.Approximately(RenderSettings.fogDensity, density.Value)) || (start.HasValue && !Mathf.Approximately(RenderSettings.fogStartDistance, start.Value)) || (end.HasValue && !Mathf.Approximately(RenderSettings.fogEndDistance, end.Value))) throw new UnityCliBridge.BridgeCommandException("E_FOG_STATE_MISMATCH", "Fog settings readback did not match the request.", "Retry after the editor is idle.");
-            return new System.Threading.Tasks.ValueTask<Result>(Read(new List<GraphicsPlannedEffect> { new GraphicsPlannedEffect { Type = "graphics.skybox-set-fog", Property = "fog", Value = "updated" } }));
+            return new System.Threading.Tasks.ValueTask<Result>(Read(new List<GraphicsPlannedEffect> { new GraphicsPlannedEffect { Type = "lighting.skybox.set-fog", Property = "fog", Value = "updated" } }));
         }
         private static Result Read(List<GraphicsPlannedEffect> effects) { return new Result { Fog = RenderSettings.fog, FogMode = RenderSettings.fogMode.ToString(), FogColor = GraphicsToolSupport.ColorHtml(RenderSettings.fogColor), FogDensity = RenderSettings.fogDensity, FogStartDistance = RenderSettings.fogStartDistance, FogEndDistance = RenderSettings.fogEndDistance, PlannedEffects = effects }; }
     }

package/unitypkg/Editor/Tools/{graphics/skybox-set-material.cs → lighting/skybox/set-material.cs}

@@ -6,15 +6,15 @@ using UnityEngine.Rendering;
 
 namespace UnityCli
 {
-    /// <summary>graphics.skybox-set-material — 设置 RenderSettings.skybox 材质。</summary>
-    public class GraphicsSkyboxSetMaterialTool : IUnityCliTool<GraphicsSkyboxSetMaterialTool.Request, GraphicsSkyboxSetMaterialTool.Result>
+    /// <summary>lighting.skybox.set-material — 设置 RenderSettings.skybox 材质。</summary>
+    public class LightingSkyboxSetMaterialTool : IUnityCliTool<LightingSkyboxSetMaterialTool.Request, LightingSkyboxSetMaterialTool.Result>
     {
         public sealed class Request { public string Material { get; set; } }
         public sealed class Result { public string Skybox { get; set; } public List<GraphicsPlannedEffect> PlannedEffects { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "graphics.skybox-set-material", Summary = "Set the RenderSettings skybox material from an Assets/*.mat path.", Description = "Set RenderSettings.skybox. Accepts builtin:Default-Skybox to restore the built-in skybox.", Group = "graphics",DestructiveHint = false, SideEffects = new[] { "settings-write" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Set skybox material", Input = new Request { Material = "Assets/Skyboxes/Day.mat" } } } };
+        public ToolDescriptor Describe() => new() { Name = "lighting.skybox.set-material", Summary = "Set the RenderSettings skybox material from an Assets/*.mat path.", Description = "Set RenderSettings.skybox. Accepts builtin:Default-Skybox to restore the built-in skybox.", Group = "lighting",DestructiveHint = false, SideEffects = new[] { "settings-write" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Set skybox material", Input = new Request { Material = "Assets/Skyboxes/Day.mat" } } } };
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
-            if (string.IsNullOrEmpty(r.Material)) throw new UnityCliBridge.BridgeCommandException("E_MATERIAL_PATH_REQUIRED", "Pass --material <Assets/*.mat path>.", "Use tools run graphics.skybox-set-material --input '{\"material\":\"Assets/Skyboxes/Day.mat\"}'.");
+            if (string.IsNullOrEmpty(r.Material)) throw new UnityCliBridge.BridgeCommandException("E_MATERIAL_PATH_REQUIRED", "Pass --material <Assets/*.mat path>.", "Use tools run lighting.skybox.set-material --input '{\"material\":\"Assets/Skyboxes/Day.mat\"}'.");
             var material = GraphicsToolSupport.ResolveSkyboxMaterial(r.Material);
             if (material == null) throw new UnityCliBridge.BridgeCommandException("E_MATERIAL_NOT_FOUND", "Skybox material not found: " + r.Material, "Pass an existing Assets/*.mat path.");
             var materialPath = AssetDatabase.GetAssetPath(material);
@@ -26,7 +26,7 @@ namespace UnityCli
             var observedPath = observed == null ? null : AssetDatabase.GetAssetPath(observed);
             var observedGuid = string.IsNullOrEmpty(observedPath) ? null : AssetDatabase.AssetPathToGUID(observedPath);
             if (observed == null || !string.Equals(observedGuid, materialGuid, System.StringComparison.Ordinal) || (materialGuid == null && observed != material)) throw new UnityCliBridge.BridgeCommandException("E_SKYBOX_MATERIAL_STATE_MISMATCH", "Skybox material GUID readback did not match the request.", "Retry after the editor is idle.");
-            return new System.Threading.Tasks.ValueTask<Result>(new Result { Skybox = observed.name, PlannedEffects = new List<GraphicsPlannedEffect> { new GraphicsPlannedEffect { Type = "graphics.skybox-set-material", Property = "skybox", Value = r.Material } } });
+            return new System.Threading.Tasks.ValueTask<Result>(new Result { Skybox = observed.name, PlannedEffects = new List<GraphicsPlannedEffect> { new GraphicsPlannedEffect { Type = "lighting.skybox.set-material", Property = "skybox", Value = r.Material } } });
         }
     }
 }

package/unitypkg/Editor/Tools/{graphics/skybox-set-properties.cs → lighting/skybox/set-properties.cs}

@@ -6,16 +6,16 @@ using UnityEngine.Rendering;
 
 namespace UnityCli
 {
-    /// <summary>graphics.skybox-set-properties — 设置当前 skybox 材质的 shader 属性。</summary>
-    public class GraphicsSkyboxSetPropertiesTool : IUnityCliTool<GraphicsSkyboxSetPropertiesTool.Request, GraphicsSkyboxSetPropertiesTool.Result>
+    /// <summary>lighting.skybox.set-properties — 设置当前 skybox 材质的 shader 属性。</summary>
+    public class LightingSkyboxSetPropertiesTool : IUnityCliTool<LightingSkyboxSetPropertiesTool.Request, LightingSkyboxSetPropertiesTool.Result>
     {
         public sealed class Request { public string Property { get; set; } public string Value { get; set; } }
         public sealed class Result { public string Skybox { get; set; } public List<GraphicsPlannedEffect> PlannedEffects { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "graphics.skybox-set-properties", Summary = "Set a shader property on the current skybox material.", Description = "Set a float or color property on RenderSettings.skybox. Requires a skybox to be assigned first.", Group = "graphics",DestructiveHint = true, SideEffects = new[] { "settings-write" }, Target = "editor", PlayModeSupport = "editor-only", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Set exposure", Input = new Request { Property = "_Exposure", Value = "1.5" } } } };
+        public ToolDescriptor Describe() => new() { Name = "lighting.skybox.set-properties", Summary = "Set a shader property on the current skybox material.", Description = "Set a float or color property on RenderSettings.skybox. Requires a skybox to be assigned first.", Group = "lighting",DestructiveHint = true, SideEffects = new[] { "settings-write" }, Target = "editor", PlayModeSupport = "editor-only", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Set exposure", Input = new Request { Property = "_Exposure", Value = "1.5" } } } };
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             var skybox = RenderSettings.skybox;
-            if (skybox == null) throw new UnityCliBridge.BridgeCommandException("E_SKYBOX_NOT_SET", "No skybox material is assigned to RenderSettings.", "Use graphics.skybox-set-material first.");
+            if (skybox == null) throw new UnityCliBridge.BridgeCommandException("E_SKYBOX_NOT_SET", "No skybox material is assigned to RenderSettings.", "Use lighting.skybox.set-material first.");
             var effects = new List<GraphicsPlannedEffect>();
             if (string.IsNullOrEmpty(r.Property) != string.IsNullOrEmpty(r.Value)) throw new UnityCliBridge.BridgeCommandException("E_SKYBOX_PROPERTY_INPUT_INVALID", "property and value must be provided together.", "Pass a material property and value.");
             if (!string.IsNullOrEmpty(r.Property))
@@ -42,7 +42,7 @@ namespace UnityCli
                 var observed = GraphicsToolSupport.ReloadAsset<Material>(skyboxPath, skyboxGuid);
                 if (observed == null || (color.HasValue && !GraphicsToolSupport.SameColor(observed.GetColor(r.Property), color.Value)) || (number.HasValue && !Mathf.Approximately(observed.GetFloat(r.Property), number.Value)) || (isInt && observed.GetInt(r.Property) != parsedInt)) throw new UnityCliBridge.BridgeCommandException("E_SKYBOX_PROPERTY_STATE_MISMATCH", "Skybox property readback did not match the request.", "Retry after the editor is idle.");
                 skybox = observed;
-                effects.Add(new GraphicsPlannedEffect { Type = "graphics.skybox-set-properties", Property = r.Property, Value = r.Value });
+                effects.Add(new GraphicsPlannedEffect { Type = "lighting.skybox.set-properties", Property = r.Property, Value = r.Value });
             }
             return new System.Threading.Tasks.ValueTask<Result>(new Result { Skybox = skybox.name, PlannedEffects = effects });
         }

package/unitypkg/Editor/Tools/{graphics/skybox-set-reflection.cs → lighting/skybox/set-reflection.cs}

@@ -4,11 +4,11 @@ using UnityEngine;
 using UnityEngine.Rendering;
 namespace UnityCli
 {
-    public class GraphicsSkyboxSetReflectionTool : IUnityCliTool<GraphicsSkyboxSetReflectionTool.Request, GraphicsSkyboxSetReflectionTool.Result>
+    public class LightingSkyboxSetReflectionTool : IUnityCliTool<LightingSkyboxSetReflectionTool.Request, LightingSkyboxSetReflectionTool.Result>
     {
         public sealed class Request { public string Mode { get; set; } public int? Bounces { get; set; } public float? Intensity { get; set; } public string Resolution { get; set; } }
         public sealed class Result { public string DefaultReflectionMode { get; set; } public long ReflectionBounces { get; set; } public double ReflectionIntensity { get; set; } public List<GraphicsPlannedEffect> PlannedEffects { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "graphics.skybox-set-reflection", Summary = "Set reflection settings.", Description = "Set RenderSettings reflection values.", Group = "graphics",SideEffects = new[] { "settings-write" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Configure skybox reflections", Input = new Request { Mode = "Skybox", Bounces = 1, Intensity = 1f, Resolution = "128" } } } };
+        public ToolDescriptor Describe() => new() { Name = "lighting.skybox.set-reflection", Summary = "Set reflection settings.", Description = "Set RenderSettings reflection values.", Group = "lighting",SideEffects = new[] { "settings-write" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Configure skybox reflections", Input = new Request { Mode = "Skybox", Bounces = 1, Intensity = 1f, Resolution = "128" } } } };
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             DefaultReflectionMode? mode = string.IsNullOrEmpty(r.Mode) ? (DefaultReflectionMode?)null : GraphicsToolSupport.ParseEnum<DefaultReflectionMode>(r.Mode, "mode"); if (r.Bounces.HasValue && (r.Bounces.Value < 0 || r.Bounces.Value > 100)) throw new UnityCliBridge.BridgeCommandException("E_GRAPHICS_RANGE_INVALID", "Invalid reflection bounces.", "Pass bounces from 0 to 100."); var intensity = r.Intensity.HasValue ? GraphicsToolSupport.ParseFinite(r.Intensity.Value.ToString(System.Globalization.CultureInfo.InvariantCulture), "intensity", 0f, 8f) : (float?)null;
@@ -23,7 +23,7 @@ namespace UnityCli
             if (!mode.HasValue && !r.Bounces.HasValue && !intensity.HasValue && !resolution.HasValue) return new System.Threading.Tasks.ValueTask<Result>(Read(new List<GraphicsPlannedEffect>()));
             ctx.CommitEffect(); if (mode.HasValue) RenderSettings.defaultReflectionMode = mode.Value; if (r.Bounces.HasValue) RenderSettings.reflectionBounces = r.Bounces.Value; if (intensity.HasValue) RenderSettings.reflectionIntensity = intensity.Value; if (resolution.HasValue) RenderSettings.defaultReflectionResolution = resolution.Value;
             if ((mode.HasValue && RenderSettings.defaultReflectionMode != mode.Value) || (r.Bounces.HasValue && RenderSettings.reflectionBounces != r.Bounces.Value) || (intensity.HasValue && !Mathf.Approximately(RenderSettings.reflectionIntensity, intensity.Value)) || (resolution.HasValue && RenderSettings.defaultReflectionResolution != resolution.Value)) throw new UnityCliBridge.BridgeCommandException("E_REFLECTION_STATE_MISMATCH", "Reflection settings readback did not match the request.", "Retry after the editor is idle.");
-            return new System.Threading.Tasks.ValueTask<Result>(Read(new List<GraphicsPlannedEffect> { new GraphicsPlannedEffect { Type = "graphics.skybox-set-reflection", Property = "reflection", Value = "updated" } }));
+            return new System.Threading.Tasks.ValueTask<Result>(Read(new List<GraphicsPlannedEffect> { new GraphicsPlannedEffect { Type = "lighting.skybox.set-reflection", Property = "reflection", Value = "updated" } }));
         }
         private static Result Read(List<GraphicsPlannedEffect> effects) { return new Result { DefaultReflectionMode = RenderSettings.defaultReflectionMode.ToString(), ReflectionBounces = RenderSettings.reflectionBounces, ReflectionIntensity = RenderSettings.reflectionIntensity, PlannedEffects = effects }; }
     }

package/unitypkg/Editor/Tools/{graphics/skybox-set-sun.cs → lighting/skybox/set-sun.cs}

@@ -6,19 +6,19 @@ using UnityEngine.Rendering;
 
 namespace UnityCli
 {
-    /// <summary>graphics.skybox-set-sun — 设置 RenderSettings.sun 方向光。</summary>
-    public class GraphicsSkyboxSetSunTool : IUnityCliTool<GraphicsSkyboxSetSunTool.Request, GraphicsSkyboxSetSunTool.Result>
+    /// <summary>lighting.skybox.set-sun — 设置 RenderSettings.sun 方向光。</summary>
+    public class LightingSkyboxSetSunTool : IUnityCliTool<LightingSkyboxSetSunTool.Request, LightingSkyboxSetSunTool.Result>
     {
         public sealed class Request { public string Target { get; set; } }
         public sealed class Result { public string Sun { get; set; } public List<GraphicsPlannedEffect> PlannedEffects { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "graphics.skybox-set-sun", Summary = "Set the directional Light used as the scene sun for RenderSettings.", Description = "Set RenderSettings.sun from a target GameObject with a Light component. Pass null/empty to clear.", Group = "graphics",DestructiveHint = false, SideEffects = new[] { "settings-write" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Set sun light", Input = new Request { Target = "DirectionalLight" } } } };
+        public ToolDescriptor Describe() => new() { Name = "lighting.skybox.set-sun", Summary = "Set the directional Light used as the scene sun for RenderSettings.", Description = "Set RenderSettings.sun from a target GameObject with a Light component. Pass null/empty to clear.", Group = "lighting",DestructiveHint = false, SideEffects = new[] { "settings-write" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Set sun light", Input = new Request { Target = "DirectionalLight" } } } };
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             Light sun = null;
             var expectedId = 0;
             if (!string.IsNullOrEmpty(r.Target))
             {
-                var go = GameObjectToolSupport.ResolveUniqueTarget(r.Target, "graphics.skybox-set-sun requires --target <go>.");
+                var go = GameObjectToolSupport.ResolveUniqueTarget(r.Target, "lighting.skybox.set-sun requires --target <go>.");
                 sun = go.GetComponent<Light>();
                 if (sun == null || sun.type != LightType.Directional) throw new UnityCliBridge.BridgeCommandException("E_DIRECTIONAL_LIGHT_REQUIRED", "Target must have a Directional Light component: " + GameObjectToolSupport.HierarchyPath(go), "Pass a GameObject with a directional Light component.");
                 expectedId = sun.GetInstanceID();
@@ -28,7 +28,7 @@ namespace UnityCli
             var observed = RenderSettings.sun;
             if ((expectedId == 0 && observed != null) || (expectedId != 0 && (observed == null || observed.GetInstanceID() != expectedId))) throw new UnityCliBridge.BridgeCommandException("E_SKYBOX_SUN_STATE_MISMATCH", "Skybox sun readback did not match the requested target.", "Retry after the editor is idle.");
             var sunPath = observed == null ? "null" : GameObjectToolSupport.HierarchyPath(observed.gameObject);
-            return new System.Threading.Tasks.ValueTask<Result>(new Result { Sun = sunPath, PlannedEffects = new List<GraphicsPlannedEffect> { new GraphicsPlannedEffect { Type = "graphics.skybox-set-sun", Property = "sun", Value = sunPath } } });
+            return new System.Threading.Tasks.ValueTask<Result>(new Result { Sun = sunPath, PlannedEffects = new List<GraphicsPlannedEffect> { new GraphicsPlannedEffect { Type = "lighting.skybox.set-sun", Property = "sun", Value = sunPath } } });
         }
     }
 }

package/unitypkg/Editor/Tools/{project → project-settings}/ProjectSettingsToolSupport.cs

@@ -61,7 +61,7 @@ namespace UnityCli
         /// <summary>只更新显式提供的三个 Audio 字段，并从新 SerializedObject 与磁盘文件验证终态。</summary>
         internal static ProjectAudioSettingsSetResult SetAudio(ProjectAudioSettingsSetRequest request, UnityCliProjectToolContext ctx)
         {
-            const string toolName = "project.audio-settings.set";
+            const string toolName = "project-settings.audio-settings.set";
             EnsureReady(toolName);
             request = request ?? new ProjectAudioSettingsSetRequest();
             if (!request.Volume.HasValue && !request.RolloffScale.HasValue && !request.DopplerFactor.HasValue)
@@ -149,7 +149,7 @@ namespace UnityCli
         /// <summary>冻结唯一命名axis和三个批准字段，effect后按index/name/value与文件身份重新证明。</summary>
         internal static ProjectInputSettingsSetResult SetInput(ProjectInputSettingsSetRequest request, UnityCliProjectToolContext ctx)
         {
-            const string toolName = "project.input-settings.set";
+            const string toolName = "project-settings.input-settings.set";
             EnsureReady(toolName);
             request = request ?? new ProjectInputSettingsSetRequest();
             if (string.IsNullOrEmpty(request.Axis))
@@ -171,7 +171,7 @@ namespace UnityCli
             {
                 var axes = RequireArray(inspect, surface.InputAxes);
                 var matches = FindAxes(axes, request.Axis, surface);
-                if (matches.Count == 0) throw new UnityCliBridge.BridgeCommandException("E_PROJECT_INPUT_AXIS_NOT_FOUND", "No legacy Input Manager axis exactly matches '" + request.Axis + "'.", "Run project.input-settings with an axis filter or inspect a bounded page before retrying.");
+                if (matches.Count == 0) throw new UnityCliBridge.BridgeCommandException("E_PROJECT_INPUT_AXIS_NOT_FOUND", "No legacy Input Manager axis exactly matches '" + request.Axis + "'.", "Run project-settings.input-settings with an axis filter or inspect a bounded page before retrying.");
                 // 官方name selector固定选择配置顺序中的首项；index/name在barrier前共同冻结。
                 beforeAxis = ReadAxis(axes.GetArrayElementAtIndex(matches[0]), matches[0], surface);
             }
@@ -261,7 +261,7 @@ namespace UnityCli
         /// <summary>PlayerSettings enum按当前Unity定义精确解析；reload风险显式投影但不在断线后重放。</summary>
         internal static ProjectPlayerSettingsSetResult SetPlayer(ProjectPlayerSettingsSetRequest request, UnityCliProjectToolContext ctx)
         {
-            const string toolName = "project.player-settings.set";
+            const string toolName = "project-settings.player-settings.set";
             EnsureReady(toolName);
             request = request ?? new ProjectPlayerSettingsSetRequest();
             if (request.CompanyName == null && request.ProductName == null && request.BundleVersion == null && request.ScriptingBackend == null && request.ApiCompatibilityLevel == null)
@@ -323,7 +323,7 @@ namespace UnityCli
         /// <summary>Time写入先验证effective fixed/maximum关系，再保存唯一TimeManager asset并fresh证明。</summary>
         internal static ProjectTimeSettingsSetResult SetTime(ProjectTimeSettingsSetRequest request, UnityCliProjectToolContext ctx)
         {
-            const string toolName = "project.time-settings.set";
+            const string toolName = "project-settings.time-settings.set";
             EnsureReady(toolName);
             request = request ?? new ProjectTimeSettingsSetRequest();
             if (!request.FixedDeltaTime.HasValue && !request.MaximumDeltaTime.HasValue && !request.TimeScale.HasValue)

package/unitypkg/Editor/Tools/{project → project-settings}/audio-settings/set.cs

@@ -2,14 +2,14 @@
 namespace UnityCli
 {
     /// <summary>修改AudioManager批准字段并证明精确文件持久化。</summary>
-    public sealed class ProjectAudioSettingsSetTool : IUnityCliTool<ProjectAudioSettingsSetRequest, ProjectAudioSettingsSetResult>
+    public sealed class ProjectSettingsAudioSettingsSetTool : IUnityCliTool<ProjectAudioSettingsSetRequest, ProjectAudioSettingsSetResult>
     {
         public ToolDescriptor Describe() => new()
         {
-            Name = "project.audio-settings.set",
+            Name = "project-settings.audio-settings.set",
             Summary = "Set declared project Audio fields and prove persisted AudioManager readback.",
             Description = "Changes only provided volume, rolloffScale, or dopplerFactor fields. volume accepts 0..1 and the other fields accept non-negative finite Unity floats. Framework dry-run returns the exact planned fields without crossing the effect barrier.",
-            Group = "project",
+            Group = "project-settings",
             DestructiveHint = true,
             SupportsDryRun = true,
             SideEffects = new[] { "project-settings-write" },

package/unitypkg/Editor/Tools/{project → project-settings}/audio-settings.cs

@@ -2,14 +2,14 @@
 namespace UnityCli
 {
     /// <summary>读取AudioManager批准字段和磁盘身份。</summary>
-    public sealed class ProjectAudioSettingsTool : IUnityCliTool<ProjectSettingsReadRequest, ProjectAudioSettingsSnapshot>
+    public sealed class ProjectSettingsAudioSettingsTool : IUnityCliTool<ProjectSettingsReadRequest, ProjectAudioSettingsSnapshot>
     {
         public ToolDescriptor Describe() => new()
         {
-            Name = "project.audio-settings",
+            Name = "project-settings.audio-settings",
             Summary = "Read bounded project Audio settings with exact settings-file identity.",
             Description = "Reads only volume, rolloffScale, and dopplerFactor from the verified AudioManager surface for the current Unity version. The result includes the exact ProjectSettings file SHA-256 and performs no write, import, or reload.",
-            Group = "project",
+            Group = "project-settings",
             DestructiveHint = false,
             SupportsDryRun = false,
             SideEffects = System.Array.Empty<string>(),
@@ -24,7 +24,7 @@ namespace UnityCli
         public System.Threading.Tasks.ValueTask<ProjectAudioSettingsSnapshot> ExecuteAsync(ProjectSettingsReadRequest request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             ct.ThrowIfCancellationRequested();
-            return new System.Threading.Tasks.ValueTask<ProjectAudioSettingsSnapshot>(ProjectSettingsReader.ReadAudio("project.audio-settings"));
+            return new System.Threading.Tasks.ValueTask<ProjectAudioSettingsSnapshot>(ProjectSettingsReader.ReadAudio("project-settings.audio-settings"));
         }
     }
 }

package/unitypkg/Editor/Tools/{project → project-settings}/info.cs

@@ -5,9 +5,9 @@ using UnityEngine;
 namespace UnityCli.Tools.Project
 {
     /// <summary>
-    /// project.info 只读 Tool：读取 Unity 项目基础元数据。
+    /// project-settings.info 只读 Tool：读取 Unity 项目基础元数据。
     /// </summary>
-    public class ProjectInfoTool : IUnityCliTool<ProjectInfoTool.Request, ProjectInfoTool.Result>
+    public class ProjectSettingsInfoTool : IUnityCliTool<ProjectSettingsInfoTool.Request, ProjectSettingsInfoTool.Result>
     {
         public sealed class Request { }
 
@@ -23,10 +23,10 @@ namespace UnityCli.Tools.Project
         // ── desc:只声明人工字段,source=built-in 表示进入只读 Tool 表 ──
         public ToolDescriptor Describe() => new()
         {
-            Name = "project.info", Summary = "Project metadata: name, path, Unity version, and overall project structure.",
+            Name = "project-settings.info", Summary = "Project metadata: name, path, Unity version, and overall project structure.",
             Description = "Project metadata: name, path, Unity version, and overall project structure.",
             DestructiveHint = false,
-            Group = "project",
+            Group = "project-settings",
             Target = "editor",
             PlayModeSupport = "supported",
             Examples = new[] { new ToolExample { Description = "Read project metadata", Input = new Request { } } }

package/unitypkg/Editor/Tools/{project → project-settings}/input-settings/set.cs

@@ -2,14 +2,14 @@
 namespace UnityCli
 {
     /// <summary>按唯一axis名称修改legacy Input Manager批准字段。</summary>
-    public sealed class ProjectInputSettingsSetTool : IUnityCliTool<ProjectInputSettingsSetRequest, ProjectInputSettingsSetResult>
+    public sealed class ProjectSettingsInputSettingsSetTool : IUnityCliTool<ProjectInputSettingsSetRequest, ProjectInputSettingsSetResult>
     {
         public ToolDescriptor Describe() => new()
         {
-            Name = "project.input-settings.set",
+            Name = "project-settings.input-settings.set",
             Summary = "Set declared fields on one exact legacy Input Manager axis and prove persistence.",
             Description = "Requires one exact case-sensitive axis name and changes only provided sensitivity, gravity, or dead. If the legacy Input Manager contains duplicate names, the first configured entry is selected and its index/name identity is frozen before the effect. InputManager scanning fails closed above 4096 entries. Framework dry-run returns the exact planned fields without writing InputManager.asset.",
-            Group = "project",
+            Group = "project-settings",
             DestructiveHint = true,
             SupportsDryRun = true,
             SideEffects = new[] { "project-settings-write" },

package/unitypkg/Editor/Tools/{project → project-settings}/input-settings.cs

@@ -2,14 +2,14 @@
 namespace UnityCli
 {
     /// <summary>分页读取legacy Input Manager批准字段。</summary>
-    public sealed class ProjectInputSettingsTool : IUnityCliTool<ProjectInputSettingsRequest, ProjectInputSettingsResult>
+    public sealed class ProjectSettingsInputSettingsTool : IUnityCliTool<ProjectInputSettingsRequest, ProjectInputSettingsResult>
     {
         public ToolDescriptor Describe() => new()
         {
-            Name = "project.input-settings",
+            Name = "project-settings.input-settings",
             Summary = "Read a bounded page of legacy Input Manager axis settings.",
             Description = "Returns only axis name, index, sensitivity, gravity, and dead with total/matched counts and pagination. axis is an optional exact case-sensitive name filter; offset defaults to 0 and limit defaults to 50 with a maximum of 200. InputManager scanning fails closed above 4096 entries.",
-            Group = "project",
+            Group = "project-settings",
             DestructiveHint = false,
             SupportsDryRun = false,
             SideEffects = System.Array.Empty<string>(),
@@ -28,7 +28,7 @@ namespace UnityCli
         public System.Threading.Tasks.ValueTask<ProjectInputSettingsResult> ExecuteAsync(ProjectInputSettingsRequest request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             ct.ThrowIfCancellationRequested();
-            return new System.Threading.Tasks.ValueTask<ProjectInputSettingsResult>(ProjectSettingsReader.ReadInput(request, "project.input-settings"));
+            return new System.Threading.Tasks.ValueTask<ProjectInputSettingsResult>(ProjectSettingsReader.ReadInput(request, "project-settings.input-settings"));
         }
     }
 }

package/unitypkg/Editor/Tools/project-settings/layer/add.cs

@@ -0,0 +1,3 @@
+#if UNITY_EDITOR
+namespace UnityCli { public class ProjectSettingsLayerAddTool : IUnityCliTool<ProjectSettingsLayerAddTool.Request, ProjectTagLayerResult> { public sealed class Request { [UnityCliRequired] public string Name { get; set; } public int? Index { get; set; } } public ToolDescriptor Describe() => new() { Name = "project-settings.layer.add", Summary = "Add a persistent Unity user layer.", Description = "Adds name to ProjectSettings/TagManager.asset user layers at index 8 through 31, optionally using index. Available in Edit and Play mode.", Group = "project-settings",DestructiveHint = true, SideEffects = new[] { "project-settings-write" }, Target = "editor", PlayModeSupport = "editor-only", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Add water layer", Input = new Request { Name = "Water" } } } }; public System.Threading.Tasks.ValueTask<ProjectTagLayerResult> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default) => ProjectTagLayerToolSupport.Apply(true, true, request.Name, request.Index, "project-settings.layer.add", ctx); } }
+#endif

package/unitypkg/Editor/Tools/project-settings/layer/remove.cs

@@ -0,0 +1,3 @@
+#if UNITY_EDITOR
+namespace UnityCli { public class ProjectSettingsLayerRemoveTool : IUnityCliTool<ProjectSettingsLayerRemoveTool.Request, ProjectTagLayerResult> { public sealed class Request { [UnityCliRequired] public string Name { get; set; } public int? Index { get; set; } } public ToolDescriptor Describe() => new() { Name = "project-settings.layer.remove", Summary = "Remove a persistent Unity user layer.", Description = "Removes name from ProjectSettings/TagManager.asset user layers. index selects a layer slot when needed. Available in Edit and Play mode.", Group = "project-settings",DestructiveHint = true, SideEffects = new[] { "project-settings-write" }, Target = "editor", PlayModeSupport = "editor-only", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Remove water layer", Input = new Request { Name = "Water" } } } }; public System.Threading.Tasks.ValueTask<ProjectTagLayerResult> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default) => ProjectTagLayerToolSupport.Apply(true, false, request.Name, request.Index, "project-settings.layer.remove", ctx); } }
+#endif

package/unitypkg/Editor/Tools/{project → project-settings}/layers.cs

@@ -5,9 +5,9 @@ using UnityEngine;
 namespace UnityCli.Tools.Project
 {
     /// <summary>
-    /// project.layers 只读 Tool：读取 TagManager 中定义的 Layer 索引和名称。
+    /// project-settings.layers 只读 Tool：读取 TagManager 中定义的 Layer 索引和名称。
     /// </summary>
-    public class ProjectLayersTool : IUnityCliTool<ProjectLayersTool.Request, ProjectLayersTool.Result>
+    public class ProjectSettingsLayersTool : IUnityCliTool<ProjectSettingsLayersTool.Request, ProjectSettingsLayersTool.Result>
     {
         public sealed class Request { }
 
@@ -26,10 +26,10 @@ namespace UnityCli.Tools.Project
         // ── desc:只声明人工字段,source=built-in 表示进入只读 Tool 表 ──
         public ToolDescriptor Describe() => new()
         {
-            Name = "project.layers", Summary = "List all layers defined in the project's Tag Manager.",
+            Name = "project-settings.layers", Summary = "List all layers defined in the project's Tag Manager.",
             Description = "List all layers defined in the project's Tag Manager.",
             DestructiveHint = false,
-            Group = "project",
+            Group = "project-settings",
             Target = "editor",
             PlayModeSupport = "supported",
             Examples = new[] { new ToolExample { Description = "List configured project layers", Input = new Request { } } }

package/unitypkg/Editor/Tools/{project → project-settings}/player-settings/set.cs

@@ -2,14 +2,14 @@
 namespace UnityCli
 {
     /// <summary>修改active build target的PlayerSettings批准字段。</summary>
-    public sealed class ProjectPlayerSettingsSetTool : IUnityCliTool<ProjectPlayerSettingsSetRequest, ProjectPlayerSettingsSetResult>
+    public sealed class ProjectSettingsPlayerSettingsSetTool : IUnityCliTool<ProjectPlayerSettingsSetRequest, ProjectPlayerSettingsSetResult>
     {
         public ToolDescriptor Describe() => new()
         {
-            Name = "project.player-settings.set",
+            Name = "project-settings.player-settings.set",
             Summary = "Set declared active-target PlayerSettings and return persisted typed readback.",
-            Description = "Changes only provided companyName, productName, bundleVersion, scriptingBackend, or apiCompatibilityLevel. Enum names must exactly match values supported by the current Unity version. Backend or API changes may trigger a domain reload; after timeout callers must read project.player-settings before deciding whether to retry.",
-            Group = "project",
+            Description = "Changes only provided companyName, productName, bundleVersion, scriptingBackend, or apiCompatibilityLevel. Enum names must exactly match values supported by the current Unity version. Backend or API changes may trigger a domain reload; after timeout callers must read project-settings.player-settings before deciding whether to retry.",
+            Group = "project-settings",
             DestructiveHint = true,
             SupportsDryRun = true,
             SideEffects = new[] { "project-settings-write", "domain-reload" },

package/unitypkg/Editor/Tools/{project → project-settings}/player-settings.cs

@@ -2,14 +2,14 @@
 namespace UnityCli
 {
     /// <summary>读取active build target的PlayerSettings批准字段。</summary>
-    public sealed class ProjectPlayerSettingsTool : IUnityCliTool<ProjectSettingsReadRequest, ProjectPlayerSettingsSnapshot>
+    public sealed class ProjectSettingsPlayerSettingsTool : IUnityCliTool<ProjectSettingsReadRequest, ProjectPlayerSettingsSnapshot>
     {
         public ToolDescriptor Describe() => new()
         {
-            Name = "project.player-settings",
+            Name = "project-settings.player-settings",
             Summary = "Read bounded PlayerSettings for the active named build target.",
             Description = "Returns companyName, productName, bundleVersion, scriptingBackend, and apiCompatibilityLevel for the active build target plus the verified ProjectSettings file identity. It does not change build target or project state.",
-            Group = "project",
+            Group = "project-settings",
             DestructiveHint = false,
             SupportsDryRun = false,
             SideEffects = System.Array.Empty<string>(),
@@ -24,7 +24,7 @@ namespace UnityCli
         public System.Threading.Tasks.ValueTask<ProjectPlayerSettingsSnapshot> ExecuteAsync(ProjectSettingsReadRequest request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             ct.ThrowIfCancellationRequested();
-            return new System.Threading.Tasks.ValueTask<ProjectPlayerSettingsSnapshot>(ProjectSettingsReader.ReadPlayer("project.player-settings"));
+            return new System.Threading.Tasks.ValueTask<ProjectPlayerSettingsSnapshot>(ProjectSettingsReader.ReadPlayer("project-settings.player-settings"));
         }
     }
 }

package/unitypkg/Editor/Tools/project-settings/tag/add.cs

@@ -0,0 +1,3 @@
+#if UNITY_EDITOR
+namespace UnityCli { public class ProjectSettingsTagAddTool : IUnityCliTool<ProjectSettingsTagAddTool.Request, ProjectTagLayerResult> { public sealed class Request { [UnityCliRequired] public string Name { get; set; } } public ToolDescriptor Describe() => new() { Name = "project-settings.tag.add", Summary = "Add a persistent Unity Tag Manager tag.", Description = "Adds name to ProjectSettings/TagManager.asset tags. Available in Edit and Play mode.", Group = "project-settings",DestructiveHint = true, SideEffects = new[] { "project-settings-write" }, Target = "editor", PlayModeSupport = "editor-only", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Add enemy tag", Input = new Request { Name = "Enemy" } } } }; public System.Threading.Tasks.ValueTask<ProjectTagLayerResult> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default) => ProjectTagLayerToolSupport.Apply(false, true, request.Name, null, "project-settings.tag.add", ctx); } }
+#endif

package/unitypkg/Editor/Tools/project-settings/tag/remove.cs

@@ -0,0 +1,3 @@
+#if UNITY_EDITOR
+namespace UnityCli { public class ProjectSettingsTagRemoveTool : IUnityCliTool<ProjectSettingsTagRemoveTool.Request, ProjectTagLayerResult> { public sealed class Request { [UnityCliRequired] public string Name { get; set; } } public ToolDescriptor Describe() => new() { Name = "project-settings.tag.remove", Summary = "Remove a persistent Unity Tag Manager tag.", Description = "Removes name from ProjectSettings/TagManager.asset tags. Available in Edit and Play mode.", Group = "project-settings",DestructiveHint = true, SideEffects = new[] { "project-settings-write" }, Target = "editor", PlayModeSupport = "editor-only", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Remove enemy tag", Input = new Request { Name = "Enemy" } } } }; public System.Threading.Tasks.ValueTask<ProjectTagLayerResult> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default) => ProjectTagLayerToolSupport.Apply(false, false, request.Name, null, "project-settings.tag.remove", ctx); } }
+#endif

package/unitypkg/Editor/Tools/{project → project-settings}/tags.cs

@@ -4,9 +4,9 @@ using UnityEditorInternal;
 namespace UnityCli.Tools.Project
 {
     /// <summary>
-    /// project.tags 只读 Tool：读取 TagManager 中定义的标签列表。
+    /// project-settings.tags 只读 Tool：读取 TagManager 中定义的标签列表。
     /// </summary>
-    public class ProjectTagsTool : IUnityCliTool<ProjectTagsTool.Request, ProjectTagsTool.Result>
+    public class ProjectSettingsTagsTool : IUnityCliTool<ProjectSettingsTagsTool.Request, ProjectSettingsTagsTool.Result>
     {
         public sealed class Request { }
 
@@ -19,10 +19,10 @@ namespace UnityCli.Tools.Project
         // ── desc:只声明人工字段,source=built-in 表示进入只读 Tool 表 ──
         public ToolDescriptor Describe() => new()
         {
-            Name = "project.tags", Summary = "List all tags defined in the project's Tag Manager.",
+            Name = "project-settings.tags", Summary = "List all tags defined in the project's Tag Manager.",
             Description = "List all tags defined in the project's Tag Manager.",
             DestructiveHint = false,
-            Group = "project",
+            Group = "project-settings",
             Target = "editor",
             PlayModeSupport = "supported",
             Examples = new[] { new ToolExample { Description = "List configured project tags", Input = new Request { } } }

package/unitypkg/Editor/Tools/{project → project-settings}/time-settings/set.cs

@@ -2,14 +2,14 @@
 namespace UnityCli
 {
     /// <summary>修改TimeManager批准字段并证明持久化。</summary>
-    public sealed class ProjectTimeSettingsSetTool : IUnityCliTool<ProjectTimeSettingsSetRequest, ProjectTimeSettingsSetResult>
+    public sealed class ProjectSettingsTimeSettingsSetTool : IUnityCliTool<ProjectTimeSettingsSetRequest, ProjectTimeSettingsSetResult>
     {
         public ToolDescriptor Describe() => new()
         {
-            Name = "project.time-settings.set",
+            Name = "project-settings.time-settings.set",
             Summary = "Set declared project Time fields and prove persisted TimeManager readback.",
             Description = "Changes only provided fixedDeltaTime, maximumDeltaTime, or timeScale. Delta values must be positive, maximumDeltaTime must not be below the effective fixedDeltaTime, and timeScale accepts 0..100. Framework dry-run returns the exact planned fields without writing TimeManager.asset.",
-            Group = "project",
+            Group = "project-settings",
             DestructiveHint = true,
             SupportsDryRun = true,
             SideEffects = new[] { "project-settings-write" },

package/unitypkg/Editor/Tools/{project → project-settings}/time-settings.cs

@@ -2,14 +2,14 @@
 namespace UnityCli
 {
     /// <summary>读取TimeManager批准的持久化字段。</summary>
-    public sealed class ProjectTimeSettingsTool : IUnityCliTool<ProjectSettingsReadRequest, ProjectTimeSettingsSnapshot>
+    public sealed class ProjectSettingsTimeSettingsTool : IUnityCliTool<ProjectSettingsReadRequest, ProjectTimeSettingsSnapshot>
     {
         public ToolDescriptor Describe() => new()
         {
-            Name = "project.time-settings",
+            Name = "project-settings.time-settings",
             Summary = "Read persisted project Time settings from the verified TimeManager surface.",
             Description = "Reads only fixedDeltaTime, maximumDeltaTime, and timeScale from TimeManager.asset. Values are project configuration rather than transient Play Mode runtime state, and the result includes the exact file SHA-256.",
-            Group = "project",
+            Group = "project-settings",
             DestructiveHint = false,
             SupportsDryRun = false,
             SideEffects = System.Array.Empty<string>(),
@@ -24,7 +24,7 @@ namespace UnityCli
         public System.Threading.Tasks.ValueTask<ProjectTimeSettingsSnapshot> ExecuteAsync(ProjectSettingsReadRequest request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             ct.ThrowIfCancellationRequested();
-            return new System.Threading.Tasks.ValueTask<ProjectTimeSettingsSnapshot>(ProjectSettingsReader.ReadTime("project.time-settings"));
+            return new System.Threading.Tasks.ValueTask<ProjectTimeSettingsSnapshot>(ProjectSettingsReader.ReadTime("project-settings.time-settings"));
         }
     }
 }

package/unitypkg/Editor/Tools/{graphics → rendering}/GraphicsToolSupport.cs

@@ -12,8 +12,8 @@ using UnityEngine.Rendering;
 namespace UnityCli
 {
     /// <summary>
-    /// graphics 域 IUnityCliTool 共享 helper:渲染管线摘要、QualitySettings、Volume 反射、
-    /// 渲染统计、颜色解析、天空盒环境设置。仅供 graphics 域自包含工具复用。
+    /// rendering、lighting、volume 组 IUnityCliTool 共享 helper:渲染管线摘要、QualitySettings、
+    /// Volume 反射、渲染统计、颜色解析、天空盒环境设置。仅供这些 graphics 域自包含工具复用。
     /// </summary>
     public static class GraphicsToolSupport
     {
@@ -111,7 +111,7 @@ namespace UnityCli
             {
                 if (string.Equals(QualitySettings.names[i], rawLevel, StringComparison.OrdinalIgnoreCase)) return i;
             }
-            throw new UnityCliBridge.BridgeCommandException("E_QUALITY_LEVEL_INVALID", "Quality level is invalid: " + rawLevel, "Run tools run graphics.quality --input '{}' to inspect available quality level names and indexes.");
+            throw new UnityCliBridge.BridgeCommandException("E_QUALITY_LEVEL_INVALID", "Quality level is invalid: " + rawLevel, "Run tools run rendering.quality --input '{}' to inspect available quality level names and indexes.");
         }
 
         /// <summary>构造渲染管线摘要 DTO。</summary>

package/unitypkg/Editor/Tools/rendering/pipeline/info.cs

@@ -0,0 +1,19 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+using System.Reflection;
+using UnityEditor;
+using UnityEngine;
+using UnityEngine.Rendering;
+
+namespace UnityCli
+{
+    /// <summary>rendering.pipeline.info — 读取渲染管线摘要与 QualitySettings(只读)。</summary>
+    public class RenderingPipelineInfoTool : IUnityCliTool<RenderingPipelineInfoTool.Request, RenderingPipelineInfoTool.Result>
+    {
+        public sealed class Request { }
+        public sealed class Result { public GraphicsSummary Graphics { get; set; } public QualitySettingsInfo QualitySettings { get; set; } }
+        public ToolDescriptor Describe() => new() { Name = "rendering.pipeline.info", Summary = "Read active/default render pipeline identity and current quality settings.", Description = "Read-only in Edit and Play mode. Returns the active/default render pipeline identity plus current QualitySettings; use rendering.pipeline.settings for default pipeline writes and rendering.quality for quality writes.", Group = "rendering",DestructiveHint = false, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Read pipeline info", Input = new Request { } } } };
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default) => new System.Threading.Tasks.ValueTask<Result>(new Result { Graphics = GraphicsToolSupport.BuildGraphicsSummary(), QualitySettings = GraphicsToolSupport.BuildQualitySettings() });
+    }
+}
+#endif

package/unitypkg/Editor/Tools/{graphics/pipeline-settings.cs → rendering/pipeline/settings.cs}

@@ -8,12 +8,12 @@ using UnityEngine.Rendering;
 
 namespace UnityCli
 {
-    /// <summary>graphics.pipeline-settings — 设置 GraphicsSettings.defaultRenderPipeline。</summary>
-    public class GraphicsPipelineSettingsTool : IUnityCliTool<GraphicsPipelineSettingsTool.Request, GraphicsPipelineSettingsTool.Result>
+    /// <summary>rendering.pipeline.settings — 设置 GraphicsSettings.defaultRenderPipeline。</summary>
+    public class RenderingPipelineSettingsTool : IUnityCliTool<RenderingPipelineSettingsTool.Request, RenderingPipelineSettingsTool.Result>
     {
         public sealed class Request { public string RenderPipeline { get; set; } }
         public sealed class Result { public GraphicsSummary Graphics { get; set; } public List<GraphicsPlannedEffect> PlannedEffects { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "graphics.pipeline-settings", Summary = "Read or set the project's default render pipeline asset.", Description = "Dedicated GraphicsSettings.defaultRenderPipeline reader/writer for Edit and Play mode. Omit renderPipeline for a pure read; pass one imported Assets/*.asset RenderPipelineAsset, or built-in/null to reset. Success re-resolves the asset by path and GUID before returning the fresh pipeline summary; QualitySettings belong to graphics.quality.", Group = "graphics",DestructiveHint = true, SideEffects = new[] { "settings-write", "asset-import", "session-affecting" }, Target = "editor", PlayModeSupport = "session-affecting", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Set URP pipeline", Input = new Request { RenderPipeline = "Assets/Settings/URP.asset" } } } };
+        public ToolDescriptor Describe() => new() { Name = "rendering.pipeline.settings", Summary = "Read or set the project's default render pipeline asset.", Description = "Dedicated GraphicsSettings.defaultRenderPipeline reader/writer for Edit and Play mode. Omit renderPipeline for a pure read; pass one imported Assets/*.asset RenderPipelineAsset, or built-in/null to reset. Success re-resolves the asset by path and GUID before returning the fresh pipeline summary; QualitySettings belong to rendering.quality.", Group = "rendering",DestructiveHint = true, SideEffects = new[] { "settings-write", "asset-import", "session-affecting" }, Target = "editor", PlayModeSupport = "session-affecting", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Set URP pipeline", Input = new Request { RenderPipeline = "Assets/Settings/URP.asset" } } } };
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             var effects = new List<GraphicsPlannedEffect>();
@@ -38,7 +38,7 @@ namespace UnityCli
             if ((resetToBuiltIn && observedPipeline != null) || (!resetToBuiltIn && (reloadedPipeline == null || observedPipeline != reloadedPipeline)))
                 throw new UnityCliBridge.BridgeCommandException("E_RENDER_PIPELINE_STATE_MISMATCH", "GraphicsSettings.defaultRenderPipeline did not match the requested asset after path/GUID reload.", "Check Unity Console diagnostics and retry after the editor is idle.");
 
-            effects.Add(new GraphicsPlannedEffect { Type = "graphics.pipeline-settings", Property = "renderPipeline", Value = resetToBuiltIn ? "built-in" : pipelinePath });
+            effects.Add(new GraphicsPlannedEffect { Type = "rendering.pipeline.settings", Property = "renderPipeline", Value = resetToBuiltIn ? "built-in" : pipelinePath });
             return new System.Threading.Tasks.ValueTask<Result>(new Result { Graphics = GraphicsToolSupport.BuildGraphicsSummary(), PlannedEffects = effects });
         }
     }