@alpsckr/unitycli 0.4.0

package/extensions/cinemachine/unitypkg/Editor/Cinemachine/lens.cs

@@ -0,0 +1,142 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+using UnityEditor;
+
+namespace UnityCli.Cinemachine
+{
+    /// <summary>
+    /// cinemachine.lens — 修改虚拟相机 Lens 结构中的常用镜头字段。
+    /// </summary>
+    public class LensTool : IUnityCliTool<LensTool.Request, LensTool.Result>
+    {
+        public sealed class Request
+        {
+            [UnityCliRequired] public string Target { get; set; }
+            public double? FieldOfView { get; set; }
+            public double? NearClipPlane { get; set; }
+            public double? FarClipPlane { get; set; }
+            public double? OrthographicSize { get; set; }
+            public double? Dutch { get; set; }
+        }
+
+        public sealed class Result
+        {
+            public CinemachinePackageStatus Cinemachine { get; set; }
+            public CinemachineObjectInfo Object { get; set; }
+            public List<CinemachinePlannedEffect> PlannedEffects { get; set; }
+        }
+
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "cinemachine.lens",
+            Summary = "Get or set Cinemachine virtual camera lens properties via SerializedObject-backed fields.",
+            Description = "Set Cinemachine virtual camera lens properties through SerializedObject so the tool remains resilient across internal field renames. Supported fields are fieldOfView, nearClipPlane, farClipPlane, orthographicSize, and dutch.",
+            Group = "cinemachine",
+            DestructiveHint = false,
+            RequiresPackages = new[] { "com.unity.cinemachine" },
+            SideEffects = new[] { "scene-modify" },
+            Target = "editor",
+            PlayModeSupport = "session-affecting",
+            DefaultTimeoutMs = 30000,
+            MaxTimeoutMs = 60000,
+            Examples = new[]
+            {
+                new ToolExample { Description = "设置 60 度视野", Input = new Request { Target = "PlayerCam", FieldOfView = 60 } }
+            }
+        };
+
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            CinemachineToolSupport.EnsureEditorReady("cinemachine.lens");
+            CinemachineToolSupport.EnsureCinemachineAvailable();
+
+            var gameObject = CinemachineToolSupport.ResolveRequiredTarget(request.Target, "cinemachine lens requires --target <go>.");
+            var camera = CinemachineToolSupport.RequireCameraComponent(gameObject);
+            var effects = new List<CinemachinePlannedEffect>();
+            if (!request.FieldOfView.HasValue && !request.NearClipPlane.HasValue && !request.FarClipPlane.HasValue && !request.OrthographicSize.HasValue && !request.Dutch.HasValue) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_LENS_INPUT_REQUIRED", "cinemachine.lens requires at least one lens value.", "Pass a supported lens field.");
+            if (request.FieldOfView.HasValue) CinemachineToolSupport.RequireFinite(request.FieldOfView.Value, "fieldOfView");
+            if (request.NearClipPlane.HasValue) CinemachineToolSupport.RequireFinite(request.NearClipPlane.Value, "nearClipPlane");
+            if (request.FarClipPlane.HasValue) CinemachineToolSupport.RequireFinite(request.FarClipPlane.Value, "farClipPlane");
+            if (request.OrthographicSize.HasValue) CinemachineToolSupport.RequireFinite(request.OrthographicSize.Value, "orthographicSize");
+            if (request.Dutch.HasValue) CinemachineToolSupport.RequireFinite(request.Dutch.Value, "dutch");
+            if (request.FieldOfView.HasValue && (request.FieldOfView.Value <= 0d || request.FieldOfView.Value >= 180d)) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_LENS_RANGE_INVALID", "fieldOfView must be between 0 and 180 degrees.", "Pass a fieldOfView greater than 0 and less than 180.");
+            if (request.NearClipPlane.HasValue && request.NearClipPlane.Value <= 0d) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_LENS_RANGE_INVALID", "nearClipPlane must be greater than zero.", "Pass a positive nearClipPlane.");
+            if (request.FarClipPlane.HasValue && request.FarClipPlane.Value <= 0d) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_LENS_RANGE_INVALID", "farClipPlane must be greater than zero.", "Pass a positive farClipPlane.");
+            if (request.NearClipPlane.HasValue && request.FarClipPlane.HasValue && request.FarClipPlane.Value <= request.NearClipPlane.Value) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_LENS_RANGE_INVALID", "farClipPlane must be greater than nearClipPlane.", "Pass a farClipPlane greater than nearClipPlane.");
+            if (request.OrthographicSize.HasValue && request.OrthographicSize.Value <= 0d) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_LENS_RANGE_INVALID", "orthographicSize must be greater than zero.", "Pass a positive orthographicSize.");
+            using (var validate = new SerializedObject(camera))
+            {
+                var lens = validate.FindProperty("Lens") ?? validate.FindProperty("m_Lens");
+                if (lens == null) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_LENS_PROPERTY_NOT_FOUND", "Cinemachine Lens property not accessible via SerializedObject.", "Use a supported Cinemachine package version.");
+                if (request.FieldOfView.HasValue) CinemachineToolSupport.RequireLensFloat(lens, "FieldOfView");
+                if (request.NearClipPlane.HasValue) CinemachineToolSupport.RequireLensFloat(lens, "NearClipPlane");
+                if (request.FarClipPlane.HasValue) CinemachineToolSupport.RequireLensFloat(lens, "FarClipPlane");
+                if (request.OrthographicSize.HasValue) CinemachineToolSupport.RequireLensFloat(lens, "OrthographicSize");
+                if (request.Dutch.HasValue) CinemachineToolSupport.RequireLensFloat(lens, "Dutch");
+            }
+            ctx.CommitEffect();
+            using (var serializedObject = new SerializedObject(camera))
+            {
+                var lensProperty = serializedObject.FindProperty("Lens") ?? serializedObject.FindProperty("m_Lens");
+                if (lensProperty == null)
+                {
+                    throw new UnityCliBridge.BridgeCommandException(
+                        "E_CINEMACHINE_LENS_PROPERTY_NOT_FOUND",
+                        "Cinemachine Lens property not accessible via SerializedObject.",
+                        "The Cinemachine package version may differ; inspect the Unity Console for details.");
+                }
+
+                if (request.FieldOfView.HasValue)
+                {
+                    CinemachineToolSupport.SetLensFloat(lensProperty, "FieldOfView", (float)request.FieldOfView.Value);
+                    effects.Add(new CinemachinePlannedEffect { Type = "cinemachine.lens", Target = GameObjectToolSupport.HierarchyPath(gameObject), Field = "fieldOfView", Value = request.FieldOfView.Value.ToString() });
+                }
+                if (request.NearClipPlane.HasValue)
+                {
+                    CinemachineToolSupport.SetLensFloat(lensProperty, "NearClipPlane", (float)request.NearClipPlane.Value);
+                    effects.Add(new CinemachinePlannedEffect { Type = "cinemachine.lens", Target = GameObjectToolSupport.HierarchyPath(gameObject), Field = "nearClipPlane", Value = request.NearClipPlane.Value.ToString() });
+                }
+                if (request.FarClipPlane.HasValue)
+                {
+                    CinemachineToolSupport.SetLensFloat(lensProperty, "FarClipPlane", (float)request.FarClipPlane.Value);
+                    effects.Add(new CinemachinePlannedEffect { Type = "cinemachine.lens", Target = GameObjectToolSupport.HierarchyPath(gameObject), Field = "farClipPlane", Value = request.FarClipPlane.Value.ToString() });
+                }
+                if (request.OrthographicSize.HasValue)
+                {
+                    CinemachineToolSupport.SetLensFloat(lensProperty, "OrthographicSize", (float)request.OrthographicSize.Value);
+                    effects.Add(new CinemachinePlannedEffect { Type = "cinemachine.lens", Target = GameObjectToolSupport.HierarchyPath(gameObject), Field = "orthographicSize", Value = request.OrthographicSize.Value.ToString() });
+                }
+                if (request.Dutch.HasValue)
+                {
+                    CinemachineToolSupport.SetLensFloat(lensProperty, "Dutch", (float)request.Dutch.Value);
+                    effects.Add(new CinemachinePlannedEffect { Type = "cinemachine.lens", Target = GameObjectToolSupport.HierarchyPath(gameObject), Field = "dutch", Value = request.Dutch.Value.ToString() });
+                }
+
+                serializedObject.ApplyModifiedProperties();
+            }
+
+            var observedCamera = CinemachineToolSupport.RequireCameraComponent(CinemachineToolSupport.ResolveRequiredTarget(gameObject.GetInstanceID().ToString(), "Cinemachine camera could not be resolved after setting lens."));
+            using (var observed = new SerializedObject(observedCamera))
+            {
+                if (request.FieldOfView.HasValue) CinemachineToolSupport.VerifyLensFloat(observed, "FieldOfView", (float)request.FieldOfView.Value);
+                if (request.NearClipPlane.HasValue) CinemachineToolSupport.VerifyLensFloat(observed, "NearClipPlane", (float)request.NearClipPlane.Value);
+                if (request.FarClipPlane.HasValue) CinemachineToolSupport.VerifyLensFloat(observed, "FarClipPlane", (float)request.FarClipPlane.Value);
+                if (request.OrthographicSize.HasValue) CinemachineToolSupport.VerifyLensFloat(observed, "OrthographicSize", (float)request.OrthographicSize.Value);
+                if (request.Dutch.HasValue) CinemachineToolSupport.VerifyLensFloat(observed, "Dutch", (float)request.Dutch.Value);
+            }
+
+            if (effects.Count > 0)
+            {
+                CinemachineToolSupport.MarkDirty(gameObject);
+            }
+
+            return new System.Threading.Tasks.ValueTask<Result>(new Result
+            {
+                Cinemachine = CinemachineToolSupport.BuildPackageStatus(),
+                Object = CinemachineToolSupport.BuildObjectInfo(gameObject),
+                PlannedEffects = effects
+            });
+        }
+    }
+}
+#endif

package/extensions/cinemachine/unitypkg/Editor/Cinemachine/noise.cs

@@ -0,0 +1,126 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+using UnityEditor;
+using UnityEngine;
+
+namespace UnityCli.Cinemachine
+{
+    /// <summary>
+    /// cinemachine.noise — 添加、配置或移除基础多通道 Perlin 噪声组件。
+    /// </summary>
+    public class NoiseTool : IUnityCliTool<NoiseTool.Request, NoiseTool.Result>
+    {
+        public sealed class Request
+        {
+            [UnityCliRequired] public string Target { get; set; }
+            public string NoiseProfile { get; set; }
+            public double? Amplitude { get; set; }
+            public double? Frequency { get; set; }
+            public bool? Remove { get; set; }
+        }
+
+        public sealed class Result
+        {
+            public CinemachinePackageStatus Cinemachine { get; set; }
+            public CinemachineObjectInfo Object { get; set; }
+            public List<CinemachinePlannedEffect> PlannedEffects { get; set; }
+        }
+
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "cinemachine.noise",
+            Summary = "Add, configure, or remove a CinemachineBasicMultiChannelPerlin noise component on a virtual camera.",
+            Description = "Add, configure, or remove a CinemachineBasicMultiChannelPerlin noise component on a Cinemachine virtual camera. remove=true deletes the noise component from the target camera.",
+            Group = "cinemachine",
+            DestructiveHint = false,
+            RequiresPackages = new[] { "com.unity.cinemachine" },
+            SideEffects = new[] { "scene-modify" },
+            Target = "editor",
+            PlayModeSupport = "session-affecting",
+            DefaultTimeoutMs = 30000,
+            MaxTimeoutMs = 60000,
+            Examples = new[]
+            {
+                new ToolExample { Description = "配置噪声", Input = new Request { Target = "PlayerCam", NoiseProfile = "Handheld_tele" } },
+                new ToolExample { Description = "移除噪声", Input = new Request { Target = "PlayerCam", Remove = true } }
+            }
+        };
+
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            CinemachineToolSupport.EnsureEditorReady("cinemachine.noise");
+            CinemachineToolSupport.EnsureCinemachineAvailable();
+
+            var gameObject = CinemachineToolSupport.ResolveRequiredTarget(request.Target, "cinemachine noise requires --target <go>.");
+            var camera = CinemachineToolSupport.RequireCameraComponent(gameObject);
+            var noiseType = CinemachineToolSupport.RequireComponentType("CinemachineBasicMultiChannelPerlin", "Noise");
+            CinemachineToolSupport.RequirePipelineComponentStage(noiseType, "Noise");
+            var effects = new List<CinemachinePlannedEffect>();
+            var existing = CinemachineToolSupport.GetPipelineComponent(camera, "Noise");
+            if (request.Remove == true && (request.Amplitude.HasValue || request.Frequency.HasValue || !string.IsNullOrWhiteSpace(request.NoiseProfile)))
+                throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_NOISE_REMOVE_CONFLICT", "remove cannot be combined with noise settings.", "Pass remove alone, or omit it when configuring noise.");
+            if (request.Remove == true && existing == null)
+                throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_NOISE_NOT_FOUND", "No CinemachineBasicMultiChannelPerlin component found on target: " + GameObjectToolSupport.HierarchyPath(gameObject), "The noise component may have already been removed.");
+            if (request.Amplitude.HasValue) CinemachineToolSupport.RequireFinite(request.Amplitude.Value, "amplitude");
+            if (request.Frequency.HasValue) CinemachineToolSupport.RequireFinite(request.Frequency.Value, "frequency");
+
+            var profile = string.IsNullOrWhiteSpace(request.NoiseProfile) ? null : CinemachineToolSupport.FindNoiseProfile(request.NoiseProfile);
+            if (!string.IsNullOrWhiteSpace(request.NoiseProfile) && profile == null)
+                throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_NOISE_PROFILE_NOT_FOUND", "Noise profile not found: " + request.NoiseProfile, "Pass the name of an imported NoiseSettings asset.");
+            var profilePlan = profile == null ? null : CinemachineToolSupport.PrepareFirstComponentObjectMember(noiseType, profile, "NoiseProfile", "m_NoiseProfile");
+            var amplitudePlan = request.Amplitude.HasValue ? CinemachineToolSupport.PrepareFirstComponentMember(noiseType, request.Amplitude.Value.ToString(System.Globalization.CultureInfo.InvariantCulture), "AmplitudeGain", "Amplitude", "m_AmplitudeGain", "m_Amplitude") : null;
+            var frequencyPlan = request.Frequency.HasValue ? CinemachineToolSupport.PrepareFirstComponentMember(noiseType, request.Frequency.Value.ToString(System.Globalization.CultureInfo.InvariantCulture), "FrequencyGain", "Frequency", "m_FrequencyGain", "m_Frequency") : null;
+
+            ctx.CommitEffect();
+            if (request.Remove == true)
+            {
+                CinemachineToolSupport.RemovePipelineComponent(camera, existing);
+                var removedTarget = CinemachineToolSupport.ResolveRequiredTarget(gameObject.GetInstanceID().ToString(), "Cinemachine noise target could not be resolved after removal.");
+                var removedCamera = CinemachineToolSupport.RequireCameraComponent(removedTarget);
+                if (CinemachineToolSupport.GetPipelineComponent(removedCamera, "Noise") != null)
+                    throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_NOISE_VERIFY_FAILED", "Cinemachine noise component still exists after removal.", "Inspect the virtual camera before retrying.");
+                CinemachineToolSupport.MarkDirty(removedTarget);
+                effects.Add(new CinemachinePlannedEffect { Type = "cinemachine.noise.remove", Target = GameObjectToolSupport.HierarchyPath(removedTarget) });
+                return new System.Threading.Tasks.ValueTask<Result>(new Result { Cinemachine = CinemachineToolSupport.BuildPackageStatus(), Object = CinemachineToolSupport.BuildObjectInfo(removedTarget), PlannedEffects = effects });
+            }
+
+            if (existing == null) CinemachineToolSupport.SwapPipelineComponent(gameObject, camera, "Noise", noiseType);
+            var noise = CinemachineToolSupport.GetPipelineComponent(camera, "Noise");
+            if (noise == null)
+                throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_NOISE_COMPONENT_NOT_FOUND", "Cinemachine noise component could not be resolved after installation.", "Inspect the virtual camera before retrying.");
+
+            if (profilePlan != null)
+            {
+                CinemachineToolSupport.ApplyComponentMember(noise, profilePlan);
+                effects.Add(new CinemachinePlannedEffect { Type = "cinemachine.noise", Target = GameObjectToolSupport.HierarchyPath(gameObject), Field = "noiseProfile", Value = request.NoiseProfile });
+            }
+            if (amplitudePlan != null)
+            {
+                CinemachineToolSupport.ApplyComponentMember(noise, amplitudePlan);
+                effects.Add(new CinemachinePlannedEffect { Type = "cinemachine.noise", Target = GameObjectToolSupport.HierarchyPath(gameObject), Field = "amplitude", Value = request.Amplitude.Value.ToString(System.Globalization.CultureInfo.InvariantCulture) });
+            }
+            if (frequencyPlan != null)
+            {
+                CinemachineToolSupport.ApplyComponentMember(noise, frequencyPlan);
+                effects.Add(new CinemachinePlannedEffect { Type = "cinemachine.noise", Target = GameObjectToolSupport.HierarchyPath(gameObject), Field = "frequency", Value = request.Frequency.Value.ToString(System.Globalization.CultureInfo.InvariantCulture) });
+            }
+
+            var observedObject = CinemachineToolSupport.ResolveRequiredTarget(gameObject.GetInstanceID().ToString(), "Cinemachine noise target could not be resolved after mutation.");
+            var observedCamera = CinemachineToolSupport.RequireCameraComponent(observedObject);
+            var observedNoise = CinemachineToolSupport.GetPipelineComponent(observedCamera, "Noise");
+            if (observedNoise == null)
+                throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_NOISE_VERIFY_FAILED", "Cinemachine noise component is missing after mutation.", "Inspect the virtual camera before retrying.");
+            if (profilePlan != null) CinemachineToolSupport.VerifyComponentMember(observedNoise, profilePlan, "E_CINEMACHINE_NOISE_VERIFY_FAILED");
+            if (amplitudePlan != null) CinemachineToolSupport.VerifyComponentMember(observedNoise, amplitudePlan, "E_CINEMACHINE_NOISE_VERIFY_FAILED");
+            if (frequencyPlan != null) CinemachineToolSupport.VerifyComponentMember(observedNoise, frequencyPlan, "E_CINEMACHINE_NOISE_VERIFY_FAILED");
+            CinemachineToolSupport.MarkDirty(observedObject);
+            return new System.Threading.Tasks.ValueTask<Result>(new Result
+            {
+                Cinemachine = CinemachineToolSupport.BuildPackageStatus(),
+                Object = CinemachineToolSupport.BuildObjectInfo(gameObject),
+                PlannedEffects = effects
+            });
+        }
+    }
+}
+#endif

package/extensions/cinemachine/unitypkg/Editor/Cinemachine/ping.cs

@@ -0,0 +1,43 @@
+#if UNITY_EDITOR
+namespace UnityCli.Cinemachine
+{
+    /// <summary>
+    /// cinemachine.ping — 只读探测 Cinemachine 包与关键反射 API 可用性。
+    /// </summary>
+    public class PingTool : IUnityCliTool<PingTool.Request, PingTool.Result>
+    {
+        public sealed class Request { }
+
+        public sealed class Result
+        {
+            public CinemachinePackageStatus Cinemachine { get; set; }
+        }
+
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "cinemachine.ping",
+            Summary = "Check Cinemachine package availability and reflected camera/brain API status.",
+            Description = "Check Cinemachine package availability and reflected camera/brain API status without changing the scene. Returns whether Cinemachine camera, brain, extension, and brain override APIs are available in the current Unity session.",
+            Group = "cinemachine",
+            DestructiveHint = false,
+            RequiresPackages = new[] { "com.unity.cinemachine" },
+            Target = "editor",
+            PlayModeSupport = "supported",
+            DefaultTimeoutMs = 5000,
+            MaxTimeoutMs = 10000,
+            Examples = new[]
+            {
+                new ToolExample { Description = "检查 Cinemachine 可用性", Input = new Request() }
+            }
+        };
+
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            return new System.Threading.Tasks.ValueTask<Result>(new Result
+            {
+                Cinemachine = CinemachineToolSupport.BuildPackageStatus()
+            });
+        }
+    }
+}
+#endif

package/extensions/cinemachine/unitypkg/Editor/Cinemachine/priority.cs

@@ -0,0 +1,113 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+using System.Globalization;
+
+namespace UnityCli.Cinemachine
+{
+    /// <summary>
+    /// cinemachine.priority — 修改虚拟相机优先级与启用标志。
+    /// </summary>
+    public class PriorityTool : IUnityCliTool<PriorityTool.Request, PriorityTool.Result>
+    {
+        public sealed class Request
+        {
+            [UnityCliRequired] public string Target { get; set; }
+            public int? Priority { get; set; }
+            public bool? Enabled { get; set; }
+        }
+
+        public sealed class Result
+        {
+            public CinemachinePackageStatus Cinemachine { get; set; }
+            public CinemachineObjectInfo Object { get; set; }
+            public List<CinemachinePlannedEffect> PlannedEffects { get; set; }
+        }
+
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "cinemachine.priority",
+            Summary = "Get or set the priority and enabled flag on a Cinemachine virtual camera.",
+            Description = "Set the priority and enabled flag on a Cinemachine virtual camera through the SerializedObject-backed PrioritySettings struct.",
+            Group = "cinemachine",
+            DestructiveHint = false,
+            RequiresPackages = new[] { "com.unity.cinemachine" },
+            SideEffects = new[] { "scene-modify" },
+            Target = "editor",
+            PlayModeSupport = "session-affecting",
+            DefaultTimeoutMs = 30000,
+            MaxTimeoutMs = 60000,
+            Examples = new[]
+            {
+                new ToolExample { Description = "提高优先级", Input = new Request { Target = "PlayerCam", Priority = 20 } }
+            }
+        };
+
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            CinemachineToolSupport.EnsureEditorReady("cinemachine.priority");
+            CinemachineToolSupport.EnsureCinemachineAvailable();
+
+            var gameObject = CinemachineToolSupport.ResolveRequiredTarget(request.Target, "cinemachine priority requires --target <go>.");
+            var camera = CinemachineToolSupport.RequireCameraComponent(gameObject);
+            var effects = new List<CinemachinePlannedEffect>();
+            if (!request.Priority.HasValue && !request.Enabled.HasValue) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_PRIORITY_INPUT_REQUIRED", "cinemachine.priority requires priority or enabled.", "Pass at least one priority field.");
+            using (var validate = new UnityEditor.SerializedObject(camera))
+            {
+                var priority = validate.FindProperty("Priority") ?? validate.FindProperty("m_Priority");
+                var value = priority != null && priority.propertyType == UnityEditor.SerializedPropertyType.Integer ? priority : priority?.FindPropertyRelative("Value") ?? priority?.FindPropertyRelative("m_Value");
+                var enabled = priority?.FindPropertyRelative("Enabled") ?? priority?.FindPropertyRelative("m_Enabled");
+                if (priority == null || (request.Priority.HasValue && (value == null || value.propertyType != UnityEditor.SerializedPropertyType.Integer)) || (request.Enabled.HasValue && (enabled == null || enabled.propertyType != UnityEditor.SerializedPropertyType.Boolean))) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_PRIORITY_PROPERTY_NOT_FOUND", "Cinemachine priority fields are not writable.", "Use a supported Cinemachine package version.");
+            }
+
+            if (request.Enabled.HasValue) CinemachineToolSupport.RequirePriorityEnabledWritable(camera);
+
+            ctx.CommitEffect();
+            if (request.Priority.HasValue)
+            {
+                CinemachineToolSupport.SetPriority(camera, request.Priority.Value);
+                effects.Add(new CinemachinePlannedEffect
+                {
+                    Type = "cinemachine.priority",
+                    Target = GameObjectToolSupport.HierarchyPath(gameObject),
+                    Field = "priority",
+                    Value = request.Priority.Value.ToString(CultureInfo.InvariantCulture)
+                });
+            }
+
+            if (request.Enabled.HasValue)
+            {
+                CinemachineToolSupport.SetPriorityEnabled(camera, request.Enabled.Value);
+                effects.Add(new CinemachinePlannedEffect
+                {
+                    Type = "cinemachine.priority",
+                    Target = GameObjectToolSupport.HierarchyPath(gameObject),
+                    Field = "enabled",
+                    Value = request.Enabled.Value ? "true" : "false"
+                });
+            }
+
+            var observedCamera = CinemachineToolSupport.RequireCameraComponent(CinemachineToolSupport.ResolveRequiredTarget(gameObject.GetInstanceID().ToString(CultureInfo.InvariantCulture), "Cinemachine camera could not be resolved after setting priority."));
+            using (var observed = new UnityEditor.SerializedObject(observedCamera))
+            {
+                var priority = observed.FindProperty("Priority") ?? observed.FindProperty("m_Priority");
+                var value = priority != null && priority.propertyType == UnityEditor.SerializedPropertyType.Integer ? priority : priority?.FindPropertyRelative("Value") ?? priority?.FindPropertyRelative("m_Value");
+                var enabled = priority?.FindPropertyRelative("Enabled") ?? priority?.FindPropertyRelative("m_Enabled");
+                if (request.Priority.HasValue && (value == null || value.intValue != request.Priority.Value)) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_PRIORITY_VERIFY_FAILED", "Cinemachine priority did not retain the requested value.", "Check the camera and retry.");
+                if (request.Enabled.HasValue && (enabled == null || enabled.boolValue != request.Enabled.Value)) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_PRIORITY_VERIFY_FAILED", "Cinemachine priority enabled flag did not retain the requested value.", "Check the camera and retry.");
+            }
+
+            if (effects.Count > 0)
+            {
+                CinemachineToolSupport.MarkDirty(gameObject);
+            }
+
+            return new System.Threading.Tasks.ValueTask<Result>(new Result
+            {
+                Cinemachine = CinemachineToolSupport.BuildPackageStatus(),
+                Object = CinemachineToolSupport.BuildObjectInfo(gameObject),
+                PlannedEffects = effects
+            });
+        }
+    }
+}
+#endif

package/extensions/cinemachine/unitypkg/Editor/Cinemachine/target.cs

@@ -0,0 +1,84 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+using UnityEngine;
+
+namespace UnityCli.Cinemachine
+{
+    /// <summary>
+    /// cinemachine.target — 设置虚拟相机的 Follow / LookAt 目标。
+    /// </summary>
+    public class TargetTool : IUnityCliTool<TargetTool.Request, TargetTool.Result>
+    {
+        public sealed class Request
+        {
+            [UnityCliRequired] public string Target { get; set; }
+            public string Follow { get; set; }
+            public string LookAt { get; set; }
+        }
+
+        public sealed class Result
+        {
+            public CinemachinePackageStatus Cinemachine { get; set; }
+            public CinemachineObjectInfo Object { get; set; }
+            public List<CinemachinePlannedEffect> PlannedEffects { get; set; }
+        }
+
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "cinemachine.target",
+            Summary = "Set the Follow and/or LookAt targets on a Cinemachine virtual camera.",
+            Description = "Set the Follow and/or LookAt targets on a Cinemachine virtual camera. target must resolve to a GameObject that already owns a Cinemachine camera component.",
+            Group = "cinemachine",
+            DestructiveHint = false,
+            RequiresPackages = new[] { "com.unity.cinemachine" },
+            SideEffects = new[] { "scene-modify" },
+            Target = "editor",
+            PlayModeSupport = "session-affecting",
+            DefaultTimeoutMs = 30000,
+            MaxTimeoutMs = 60000,
+            Examples = new[]
+            {
+                new ToolExample { Description = "设置 Follow", Input = new Request { Target = "PlayerCam", Follow = "Player" } }
+            }
+        };
+
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            CinemachineToolSupport.EnsureEditorReady("cinemachine.target");
+            CinemachineToolSupport.EnsureCinemachineAvailable();
+
+            var gameObject = CinemachineToolSupport.ResolveRequiredTarget(request.Target, "Cinemachine target requires --target <go>.");
+            var camera = CinemachineToolSupport.RequireCameraComponent(gameObject);
+            var effects = new List<CinemachinePlannedEffect>();
+            var follow = string.IsNullOrWhiteSpace(request.Follow) ? null : CinemachineToolSupport.ResolveRequiredTarget(request.Follow, "Pass an existing GameObject name or path.");
+            var lookAt = string.IsNullOrWhiteSpace(request.LookAt) ? null : CinemachineToolSupport.ResolveRequiredTarget(request.LookAt, "Pass an existing GameObject name or path.");
+            if (follow == null && lookAt == null) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_TARGET_INPUT_REQUIRED", "cinemachine.target requires follow or lookAt.", "Pass at least one target field.");
+            var followPlan = follow == null ? null : CinemachineToolSupport.PrepareComponentObjectMember(camera.GetType(), "Follow", follow.transform, "E_CINEMACHINE_FOLLOW_NOT_WRITABLE");
+            var lookAtPlan = lookAt == null ? null : CinemachineToolSupport.PrepareComponentObjectMember(camera.GetType(), "LookAt", lookAt.transform, "E_CINEMACHINE_LOOKAT_NOT_WRITABLE");
+            ctx.CommitEffect();
+            if (follow != null)
+            {
+                CinemachineToolSupport.ApplyComponentMember(camera, followPlan);
+                effects.Add(new CinemachinePlannedEffect { Type = "cinemachine.target", Target = GameObjectToolSupport.HierarchyPath(gameObject), Field = "follow", Value = follow.name });
+            }
+            if (lookAt != null)
+            {
+                CinemachineToolSupport.ApplyComponentMember(camera, lookAtPlan);
+                effects.Add(new CinemachinePlannedEffect { Type = "cinemachine.target", Target = GameObjectToolSupport.HierarchyPath(gameObject), Field = "lookAt", Value = lookAt.name });
+            }
+            var observedObject = CinemachineToolSupport.ResolveRequiredTarget(gameObject.GetInstanceID().ToString(System.Globalization.CultureInfo.InvariantCulture), "Cinemachine camera could not be resolved.");
+            var observed = CinemachineToolSupport.RequireCameraComponent(observedObject);
+            if (followPlan != null) CinemachineToolSupport.VerifyComponentMember(observed, followPlan, "E_CINEMACHINE_TARGET_VERIFY_FAILED");
+            if (lookAtPlan != null) CinemachineToolSupport.VerifyComponentMember(observed, lookAtPlan, "E_CINEMACHINE_TARGET_VERIFY_FAILED");
+            CinemachineToolSupport.MarkDirty(observedObject);
+
+            return new System.Threading.Tasks.ValueTask<Result>(new Result
+            {
+                Cinemachine = CinemachineToolSupport.BuildPackageStatus(),
+                Object = CinemachineToolSupport.BuildObjectInfo(observedObject),
+                PlannedEffects = effects
+            });
+        }
+    }
+}
+#endif

package/extensions/cinemachine/unitypkg/UnityCli.Extensions.Cinemachine.Editor.asmdef

@@ -0,0 +1,18 @@
+{
+  "name": "UnityCli.Extensions.Cinemachine.Editor",
+  "rootNamespace": "UnityCli.Cinemachine",
+  "references": [
+    "UnityCli.Editor"
+  ],
+  "includePlatforms": [
+    "Editor"
+  ],
+  "excludePlatforms": [],
+  "allowUnsafeCode": false,
+  "overrideReferences": false,
+  "precompiledReferences": [],
+  "autoReferenced": true,
+  "defineConstraints": [],
+  "versionDefines": [],
+  "noEngineReferences": false
+}

package/extensions/hdrp/bridge/domains/hdrp.ts

@@ -0,0 +1,41 @@
+import { boolFlag, compactArgs, floatFlag, stringFlag } from "../args.js";
+import type { BridgeCommandSpec } from "../types.js";
+
+export const hdrpBridgeSpecs: BridgeCommandSpec[] = markToolsOnly([
+  { group: "hdrp", command: "volume-list", bridgeCommand: "project-tool.run", toolName: "hdrp.volume.list", buildArgs: emptyArgs },
+  { group: "hdrp", command: "volume-create", bridgeCommand: "project-tool.run", toolName: "hdrp.volume.create", buildArgs: volumeCreateArgs },
+  { group: "hdrp", command: "volume-info", bridgeCommand: "project-tool.run", toolName: "hdrp.volume.info", buildArgs: volumeTargetArgs },
+  { group: "hdrp", command: "volume-add-effect", bridgeCommand: "project-tool.run", toolName: "hdrp.volume.add-effect", buildArgs: volumeEffectArgs },
+  { group: "hdrp", command: "volume-set", bridgeCommand: "project-tool.run", toolName: "hdrp.volume.set", buildArgs: volumeSetArgs },
+  { group: "hdrp", command: "settings-get", bridgeCommand: "project-tool.run", toolName: "hdrp.settings.get", buildArgs: emptyArgs },
+  { group: "hdrp", command: "settings-set", bridgeCommand: "project-tool.run", toolName: "hdrp.settings.set", buildArgs: hdrpSettingsArgs, destructiveHint: true, supportsDryRun: true }
+]);
+
+function markToolsOnly(specs: BridgeCommandSpec[]): BridgeCommandSpec[] {
+  return specs.map((spec) => ({ ...spec, toolsOnly: true }));
+}
+
+function emptyArgs(): Record<string, unknown> { return {}; }
+
+function volumeTargetArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({ target: positionalTarget ?? stringFlag(flags, "target") });
+}
+
+function volumeCreateArgs({ flags }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({ name: stringFlag(flags, "name"), isGlobal: boolFlag(flags, "is-global"), priority: floatFlag(flags, "priority"), weight: floatFlag(flags, "weight") });
+}
+
+function volumeEffectArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({ target: positionalTarget ?? stringFlag(flags, "target"), effectType: stringFlag(flags, "effect-type") ?? stringFlag(flags, "type") });
+}
+
+function volumeSetArgs({ flags, positionalTarget }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({ target: positionalTarget ?? stringFlag(flags, "target"), effectType: stringFlag(flags, "effect-type") ?? stringFlag(flags, "type"), property: stringFlag(flags, "property"), value: stringFlag(flags, "value") });
+}
+
+function hdrpSettingsArgs({ flags }: Parameters<BridgeCommandSpec["buildArgs"]>[0]): Record<string, unknown> {
+  return compactArgs({
+    property: stringFlag(flags, "property"),
+    value: stringFlag(flags, "value")
+  });
+}

package/extensions/hdrp/docs/hdrp.md

@@ -0,0 +1,15 @@
+# HDRP Tools
+
+The extension contributes independent tools for the active High Definition Render Pipeline asset.
+
+| Tool | Description |
+| --- | --- |
+| `hdrp.volume.list` | List scene-session volumes. |
+| `hdrp.volume.create` | Create a scene-session volume. |
+| `hdrp.volume.info` | Read one scene-session volume. |
+| `hdrp.volume.add-effect` | Add one effect to an in-memory profile. |
+| `hdrp.volume.set` | Set one effect parameter and return its verified typed serialized readback. |
+| `hdrp.settings.get` | Read active pipeline asset settings. |
+| `hdrp.settings.set` | Set one active pipeline asset setting. |
+
+The project must install `com.unity.render-pipelines.high-definition` and select an active `HDRenderPipelineAsset`.

package/extensions/hdrp/extension.json

@@ -0,0 +1,31 @@
+{
+  "id": "hdrp",
+  "name": "High Definition Render Pipeline",
+  "version": "1.0.0",
+  "description": "HDRP rendering tools for volume components and High Definition Render Pipeline asset settings.",
+  "unityPackages": [
+    { "packageId": "com.unity.render-pipelines.high-definition", "displayName": "High Definition Render Pipeline" }
+  ],
+  "contributions": {
+    "tools": [
+      { "name": "hdrp.volume.list" },
+      { "name": "hdrp.volume.create" },
+      { "name": "hdrp.volume.info" },
+      { "name": "hdrp.volume.add-effect" },
+      { "name": "hdrp.volume.set" },
+      { "name": "hdrp.settings.get" },
+      { "name": "hdrp.settings.set" }
+    ],
+    "csharpEntries": [
+      { "type": "UnityCli.HdrpVolumeListTool", "description": "Implements hdrp.volume.list." },
+      { "type": "UnityCli.HdrpVolumeInfoTool", "description": "Implements hdrp.volume.info." },
+      { "type": "UnityCli.HdrpVolumeCreateTool", "description": "Implements hdrp.volume.create." },
+      { "type": "UnityCli.HdrpVolumeAddEffectTool", "description": "Implements hdrp.volume.add-effect." },
+      { "type": "UnityCli.HdrpVolumeSetTool", "description": "Implements hdrp.volume.set." },
+      { "type": "UnityCli.HdrpSettingsGetTool", "description": "Implements hdrp.settings.get." },
+      { "type": "UnityCli.HdrpSettingsSetTool", "description": "Implements hdrp.settings.set." }
+    ]
+  },
+  "unityInstall": { "layout": "directory", "include": ["extension.json", "unitypkg/", "docs/"] },
+  "tags": ["rendering", "pipeline", "hdrp"]
+}