@alpsckr/unitycli 0.4.0

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

@@ -0,0 +1,96 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+using UnityEngine;
+
+namespace UnityCli.Cinemachine
+{
+    /// <summary>
+    /// cinemachine.aim — 切换或配置 Aim 管线组件。
+    /// </summary>
+    public class AimTool : IUnityCliTool<AimTool.Request, AimTool.Result>
+    {
+        public sealed class Request
+        {
+            [UnityCliRequired] public string Target { get; set; }
+            public string Aim { get; set; }
+            public string Property { get; set; }
+            public string Value { 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.aim",
+            Summary = "Swap or configure the Cinemachine Aim pipeline component on a virtual camera.",
+            Description = "Swap the Aim pipeline component on a Cinemachine virtual camera, or configure a writable public/serialized member on the current Aim component. aim may be omitted when property and value target the existing Aim 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 = "切换 Aim 组件", Input = new Request { Target = "PlayerCam", Aim = "CinemachineRotationComposer" } },
+                new ToolExample { Description = "配置现有 Aim 属性", Input = new Request { Target = "PlayerCam", Property = "m_HorizontalDamping", Value = "0.25" } }
+            }
+        };
+
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            CinemachineToolSupport.EnsureEditorReady("cinemachine.aim");
+            CinemachineToolSupport.EnsureCinemachineAvailable();
+
+            var gameObject = CinemachineToolSupport.ResolveRequiredTarget(request.Target, "cinemachine aim requires --target <go>.");
+            var camera = CinemachineToolSupport.RequireCameraComponent(gameObject);
+            var effects = new List<CinemachinePlannedEffect>();
+            if (string.IsNullOrWhiteSpace(request.Aim) && string.IsNullOrWhiteSpace(request.Property))
+                throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_AIM_INPUT_REQUIRED", "cinemachine.aim requires aim or property/value.", "Pass aim to swap the stage component, or property and value to configure the existing Aim component.");
+            if (string.IsNullOrWhiteSpace(request.Property) != string.IsNullOrWhiteSpace(request.Value))
+                throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_COMPONENT_PROPERTY_REQUIRED", "Configuring an Aim component requires both property and value.", "Pass property and value together.");
+
+            var existing = CinemachineToolSupport.GetPipelineComponent(camera, "Aim");
+            var aimType = string.IsNullOrWhiteSpace(request.Aim) ? existing?.GetType() : CinemachineToolSupport.RequireComponentType(request.Aim, "Aim");
+            if (aimType == null)
+                throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_AIM_COMPONENT_NOT_FOUND", "No Aim pipeline component is installed on target: " + GameObjectToolSupport.HierarchyPath(gameObject), "Provide aim to install an Aim component before configuring properties.");
+            CinemachineToolSupport.RequirePipelineComponentStage(aimType, "Aim");
+            var memberPlan = string.IsNullOrWhiteSpace(request.Property) ? null : CinemachineToolSupport.PrepareComponentMember(aimType, request.Property, request.Value);
+
+            ctx.CommitEffect();
+            if (!string.IsNullOrWhiteSpace(request.Aim))
+            {
+                CinemachineToolSupport.SwapPipelineComponent(gameObject, camera, "Aim", aimType);
+                effects.Add(new CinemachinePlannedEffect { Type = "cinemachine.aim", Target = GameObjectToolSupport.HierarchyPath(gameObject), AimType = aimType.Name });
+            }
+            var applied = CinemachineToolSupport.GetPipelineComponent(camera, "Aim");
+            if (memberPlan != null)
+            {
+                CinemachineToolSupport.ApplyComponentMember(applied, memberPlan);
+                effects.Add(new CinemachinePlannedEffect { Type = "cinemachine.aim", Target = GameObjectToolSupport.HierarchyPath(gameObject), Field = request.Property, Value = request.Value, AimType = aimType.Name });
+            }
+
+            var observedObject = CinemachineToolSupport.ResolveRequiredTarget(gameObject.GetInstanceID().ToString(), "Cinemachine Aim target could not be resolved after mutation.");
+            var observedCamera = CinemachineToolSupport.RequireCameraComponent(observedObject);
+            var observedAim = CinemachineToolSupport.GetPipelineComponent(observedCamera, "Aim");
+            if (observedAim == null || observedAim.GetType() != aimType)
+                throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_AIM_VERIFY_FAILED", "Cinemachine Aim component did not retain the requested type.", "Inspect the virtual camera before retrying.");
+            if (memberPlan != null) CinemachineToolSupport.VerifyComponentMember(observedAim, memberPlan, "E_CINEMACHINE_AIM_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/blend.cs

@@ -0,0 +1,140 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+using UnityEditor;
+
+namespace UnityCli.Cinemachine
+{
+    /// <summary>
+    /// cinemachine.blend — 修改 Brain 的默认切镜样式与时长。
+    /// </summary>
+    public class BlendTool : IUnityCliTool<BlendTool.Request, BlendTool.Result>
+    {
+        public sealed class Request
+        {
+            public string Target { get; set; }
+            public string Style { get; set; }
+            public double? Duration { get; set; }
+        }
+
+        public sealed class Result
+        {
+            public CinemachinePackageStatus Cinemachine { get; set; }
+            public CinemachineObjectInfo Object { get; set; }
+            public CinemachineBrainInfo Brain { get; set; }
+            public List<CinemachinePlannedEffect> PlannedEffects { get; set; }
+        }
+
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "cinemachine.blend",
+            Summary = "Get or set the DefaultBlend style and duration on a CinemachineBrain.",
+            Description = "Set the DefaultBlend style and duration on a CinemachineBrain. target is optional; when omitted the first scene brain is used.",
+            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 = "Main Camera", Style = "ease_in_out", Duration = 2 } }
+            }
+        };
+
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            CinemachineToolSupport.EnsureEditorReady("cinemachine.blend");
+            CinemachineToolSupport.EnsureCinemachineAvailable();
+
+            var brainOwner = CinemachineToolSupport.ResolveBrainOwner(request.Target);
+            var brain = CinemachineToolSupport.RequireBrainComponent(brainOwner);
+            var effects = new List<CinemachinePlannedEffect>();
+            if (string.IsNullOrWhiteSpace(request.Style) && !request.Duration.HasValue) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_BLEND_INPUT_REQUIRED", "cinemachine.blend requires style or duration.", "Pass at least one blend field.");
+            if (request.Duration.HasValue) { CinemachineToolSupport.RequireFinite(request.Duration.Value, "duration"); if (request.Duration.Value < 0d) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_BLEND_RANGE_INVALID", "duration must be non-negative.", "Pass a duration greater than or equal to zero."); }
+            var requestedStyle = string.IsNullOrWhiteSpace(request.Style) ? (int?)null : CinemachineToolSupport.BlendStyleToEnumIndex(request.Style);
+            if (!string.IsNullOrWhiteSpace(request.Style) && !requestedStyle.HasValue) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_BLEND_STYLE_INVALID", "Unsupported Cinemachine blend style: " + request.Style, "Pass a supported blend style.");
+            using (var validate = new SerializedObject(brain))
+            {
+                var blend = validate.FindProperty("DefaultBlend") ?? validate.FindProperty("m_DefaultBlend");
+                if (blend == null || (requestedStyle.HasValue && (blend.FindPropertyRelative("Style") ?? blend.FindPropertyRelative("m_Style")) == null) || (request.Duration.HasValue && (blend.FindPropertyRelative("Time") ?? blend.FindPropertyRelative("m_Time")) == null)) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_BLEND_PROPERTY_NOT_FOUND", "DefaultBlend fields are not writable.", "Use a supported Cinemachine package version.");
+            }
+
+            ctx.CommitEffect();
+            using (var serializedObject = new SerializedObject(brain))
+            {
+                var blendProperty = serializedObject.FindProperty("DefaultBlend") ?? serializedObject.FindProperty("m_DefaultBlend");
+                if (blendProperty == null)
+                {
+                    throw new UnityCliBridge.BridgeCommandException(
+                        "E_CINEMACHINE_BLEND_PROPERTY_NOT_FOUND",
+                        "DefaultBlend property not accessible on CinemachineBrain.",
+                        "The Cinemachine package version may differ; inspect the Unity Console for details.");
+                }
+
+                if (!string.IsNullOrWhiteSpace(request.Style))
+                {
+                    var enumIndex = requestedStyle;
+                    if (enumIndex.HasValue)
+                    {
+                        var styleProperty = blendProperty.FindPropertyRelative("Style") ?? blendProperty.FindPropertyRelative("m_Style");
+                        if (styleProperty != null)
+                        {
+                            styleProperty.enumValueIndex = enumIndex.Value;
+                            effects.Add(new CinemachinePlannedEffect
+                            {
+                                Type = "cinemachine.blend",
+                                Target = GameObjectToolSupport.HierarchyPath(brainOwner),
+                                Field = "style",
+                                Value = request.Style
+                            });
+                        }
+                    }
+                }
+
+                if (request.Duration.HasValue)
+                {
+                    var timeProperty = blendProperty.FindPropertyRelative("Time") ?? blendProperty.FindPropertyRelative("m_Time");
+                    if (timeProperty != null)
+                    {
+                        timeProperty.floatValue = (float)request.Duration.Value;
+                        effects.Add(new CinemachinePlannedEffect
+                        {
+                            Type = "cinemachine.blend",
+                            Target = GameObjectToolSupport.HierarchyPath(brainOwner),
+                            Field = "duration",
+                            Value = request.Duration.Value.ToString()
+                        });
+                    }
+                }
+
+                serializedObject.ApplyModifiedProperties();
+            }
+
+            var observedBrain = CinemachineToolSupport.RequireBrainComponent(CinemachineToolSupport.ResolveRequiredTarget(brainOwner.GetInstanceID().ToString(), "CinemachineBrain could not be resolved after setting blend."));
+            using (var observed = new SerializedObject(observedBrain))
+            {
+                var blend = observed.FindProperty("DefaultBlend") ?? observed.FindProperty("m_DefaultBlend");
+                var style = blend?.FindPropertyRelative("Style") ?? blend?.FindPropertyRelative("m_Style");
+                var time = blend?.FindPropertyRelative("Time") ?? blend?.FindPropertyRelative("m_Time");
+                if (requestedStyle.HasValue && (style == null || style.enumValueIndex != requestedStyle.Value)) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_BLEND_VERIFY_FAILED", "Cinemachine blend style did not retain the requested value.", "Check the brain and retry.");
+                if (request.Duration.HasValue && (time == null || !UnityEngine.Mathf.Approximately(time.floatValue, (float)request.Duration.Value))) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_BLEND_VERIFY_FAILED", "Cinemachine blend duration did not retain the requested value.", "Check the brain and retry.");
+            }
+
+            if (effects.Count > 0)
+            {
+                CinemachineToolSupport.MarkDirty(brainOwner);
+            }
+
+            return new System.Threading.Tasks.ValueTask<Result>(new Result
+            {
+                Cinemachine = CinemachineToolSupport.BuildPackageStatus(),
+                Object = CinemachineToolSupport.BuildObjectInfo(brainOwner),
+                Brain = CinemachineToolSupport.BuildBrainInfo(brain),
+                PlannedEffects = effects
+            });
+        }
+    }
+}
+#endif

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

@@ -0,0 +1,96 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+using UnityEngine;
+
+namespace UnityCli.Cinemachine
+{
+    /// <summary>
+    /// cinemachine.body — 切换或配置 Body 管线组件。
+    /// </summary>
+    public class BodyTool : IUnityCliTool<BodyTool.Request, BodyTool.Result>
+    {
+        public sealed class Request
+        {
+            [UnityCliRequired] public string Target { get; set; }
+            public string Body { get; set; }
+            public string Property { get; set; }
+            public string Value { 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.body",
+            Summary = "Swap or configure the Cinemachine Body pipeline component on a virtual camera.",
+            Description = "Swap the Body pipeline component on a Cinemachine virtual camera, or configure a writable public/serialized member on the current Body component. body may be omitted when property and value target the existing Body 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 = "切换 Body 组件", Input = new Request { Target = "PlayerCam", Body = "CinemachineFollow" } },
+                new ToolExample { Description = "配置现有 Body 属性", Input = new Request { Target = "PlayerCam", Property = "m_XDamping", Value = "0.5" } }
+            }
+        };
+
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            CinemachineToolSupport.EnsureEditorReady("cinemachine.body");
+            CinemachineToolSupport.EnsureCinemachineAvailable();
+
+            var gameObject = CinemachineToolSupport.ResolveRequiredTarget(request.Target, "cinemachine body requires --target <go>.");
+            var camera = CinemachineToolSupport.RequireCameraComponent(gameObject);
+            var effects = new List<CinemachinePlannedEffect>();
+            if (string.IsNullOrWhiteSpace(request.Body) && string.IsNullOrWhiteSpace(request.Property))
+                throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_BODY_INPUT_REQUIRED", "cinemachine.body requires body or property/value.", "Pass body to swap the stage component, or property and value to configure the existing Body component.");
+            if (string.IsNullOrWhiteSpace(request.Property) != string.IsNullOrWhiteSpace(request.Value))
+                throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_COMPONENT_PROPERTY_REQUIRED", "Configuring a Body component requires both property and value.", "Pass property and value together.");
+
+            var existing = CinemachineToolSupport.GetPipelineComponent(camera, "Body");
+            var bodyType = string.IsNullOrWhiteSpace(request.Body) ? existing?.GetType() : CinemachineToolSupport.RequireComponentType(request.Body, "Body");
+            if (bodyType == null)
+                throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_BODY_COMPONENT_NOT_FOUND", "No Body pipeline component is installed on target: " + GameObjectToolSupport.HierarchyPath(gameObject), "Provide body to install a Body component before configuring properties.");
+            CinemachineToolSupport.RequirePipelineComponentStage(bodyType, "Body");
+            var memberPlan = string.IsNullOrWhiteSpace(request.Property) ? null : CinemachineToolSupport.PrepareComponentMember(bodyType, request.Property, request.Value);
+
+            ctx.CommitEffect();
+            if (!string.IsNullOrWhiteSpace(request.Body))
+            {
+                CinemachineToolSupport.SwapPipelineComponent(gameObject, camera, "Body", bodyType);
+                effects.Add(new CinemachinePlannedEffect { Type = "cinemachine.body", Target = GameObjectToolSupport.HierarchyPath(gameObject), BodyType = bodyType.Name });
+            }
+            var applied = CinemachineToolSupport.GetPipelineComponent(camera, "Body");
+            if (memberPlan != null)
+            {
+                CinemachineToolSupport.ApplyComponentMember(applied, memberPlan);
+                effects.Add(new CinemachinePlannedEffect { Type = "cinemachine.body", Target = GameObjectToolSupport.HierarchyPath(gameObject), Field = request.Property, Value = request.Value, BodyType = bodyType.Name });
+            }
+
+            var observedObject = CinemachineToolSupport.ResolveRequiredTarget(gameObject.GetInstanceID().ToString(), "Cinemachine Body target could not be resolved after mutation.");
+            var observedCamera = CinemachineToolSupport.RequireCameraComponent(observedObject);
+            var observedBody = CinemachineToolSupport.GetPipelineComponent(observedCamera, "Body");
+            if (observedBody == null || observedBody.GetType() != bodyType)
+                throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_BODY_VERIFY_FAILED", "Cinemachine Body component did not retain the requested type.", "Inspect the virtual camera before retrying.");
+            if (memberPlan != null) CinemachineToolSupport.VerifyComponentMember(observedBody, memberPlan, "E_CINEMACHINE_BODY_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/brain-ensure.cs

@@ -0,0 +1,16 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+using UnityEditor;
+using UnityEngine;
+namespace UnityCli.Cinemachine
+{
+    public sealed class BrainEnsureTool : IUnityCliTool<BrainEnsureTool.Request, BrainEnsureTool.Result>
+    {
+        public sealed class Request { public string Target { get; set; } }
+        public sealed class Result { public CinemachinePackageStatus Cinemachine { get; set; } public CinemachineBrainInfo Brain { get; set; } public List<CinemachinePlannedEffect> PlannedEffects { get; set; } }
+        public ToolDescriptor Describe() => new() { Name = "cinemachine.brain.ensure", Summary = "Ensure a CinemachineBrain exists.", Description = "Adds a CinemachineBrain to the target, current brain owner, or Main Camera; creates an owner when needed.", Group = "cinemachine",RequiresPackages = new[] { "com.unity.cinemachine" }, SideEffects = new[] { "scene-modify", "undo-stack" }, Target = "editor", PlayModeSupport = "session-affecting", DefaultTimeoutMs = 30000, MaxTimeoutMs = 60000, Examples = new[] { new ToolExample { Description = "Ensure Main Camera has a brain", Input = new Request { Target = "Main Camera" } } } };
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default) { CinemachineToolSupport.EnsureEditorReady("cinemachine.brain.ensure"); CinemachineToolSupport.EnsureCinemachineAvailable(); var owner = !string.IsNullOrWhiteSpace(request.Target) ? CinemachineToolSupport.ResolveRequiredTarget(request.Target, "Pass a GameObject name, hierarchy path or instance id.") : CinemachineToolSupport.FindOrCreateBrainOwnerCandidate(); ctx.CommitEffect();
+            if (owner == null) { owner = new GameObject("CinemachineBrain"); UnityCliSceneMutation.RegisterCreatedObject(owner, "UnityCli Cinemachine Brain Ensure"); } var brain = owner.GetComponent(CinemachineToolSupport.BrainType) ?? UnityCliSceneMutation.AddComponent(owner, CinemachineToolSupport.BrainType); var observedOwner = CinemachineToolSupport.ResolveRequiredTarget(owner.GetInstanceID().ToString(), "CinemachineBrain could not be resolved after ensure."); var observedBrain = CinemachineToolSupport.RequireBrainComponent(observedOwner); CinemachineToolSupport.MarkDirty(observedOwner); return new(new Result { Cinemachine = CinemachineToolSupport.BuildPackageStatus(), Brain = CinemachineToolSupport.BuildBrainInfo(observedBrain), PlannedEffects = new List<CinemachinePlannedEffect> { new CinemachinePlannedEffect { Type = "cinemachine.brain.ensure", Target = GameObjectToolSupport.HierarchyPath(observedOwner) } } }); }
+    }
+}
+#endif

package/extensions/cinemachine/unitypkg/Editor/Cinemachine/brain-status.cs

@@ -0,0 +1,12 @@
+#if UNITY_EDITOR
+namespace UnityCli.Cinemachine
+{
+    public sealed class BrainStatusTool : IUnityCliTool<BrainStatusTool.Request, BrainStatusTool.Result>
+    {
+        public sealed class Request { public string Target { get; set; } }
+        public sealed class Result { public CinemachinePackageStatus Cinemachine { get; set; } public CinemachineBrainInfo Brain { get; set; } }
+        public ToolDescriptor Describe() => new() { Name = "cinemachine.brain.status", Summary = "Read CinemachineBrain status.", Description = "Reports the selected or current CinemachineBrain, active virtual camera, and blend state without modifying the scene.", Group = "cinemachine",RequiresPackages = new[] { "com.unity.cinemachine" }, SideEffects = new string[0], Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 60000, Examples = new[] { new ToolExample { Description = "Read Main Camera brain state", Input = new Request { Target = "Main Camera" } } } };
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default) { CinemachineToolSupport.EnsureEditorReady("cinemachine.brain.status"); CinemachineToolSupport.EnsureCinemachineAvailable(); var brain = CinemachineToolSupport.RequireBrainComponent(CinemachineToolSupport.ResolveBrainOwner(request.Target)); return new(new Result { Cinemachine = CinemachineToolSupport.BuildPackageStatus(), Brain = CinemachineToolSupport.BuildBrainInfo(brain) }); }
+    }
+}
+#endif

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

@@ -0,0 +1,147 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+using UnityEditor;
+using UnityEngine;
+
+namespace UnityCli.Cinemachine
+{
+    /// <summary>
+    /// cinemachine.create — 创建虚拟相机，并按 preset 安装 Body/Aim 管线组件。
+    /// </summary>
+    public class CreateTool : IUnityCliTool<CreateTool.Request, CreateTool.Result>
+    {
+        public sealed class Request
+        {
+            public string Preset { get; set; }
+            public string Name { get; set; }
+            public string Parent { get; set; }
+            public string Follow { get; set; }
+            public string LookAt { get; set; }
+            public double? X { get; set; }
+            public double? Y { get; set; }
+            public double? Z { get; set; }
+            public int? Priority { 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.create",
+            Summary = "Create a Cinemachine virtual camera with an optional preset that configures Body and Aim pipeline components.",
+            Description = "Create a Cinemachine virtual camera with an optional preset. preset supports follow, third_person, freelook, dolly, static, top_down, and side_scroller. The tool can also set parent, follow, lookAt, position, and priority during creation.",
+            Group = "cinemachine",
+            DestructiveHint = false,
+            RequiresPackages = new[] { "com.unity.cinemachine" },
+            SideEffects = new[] { "scene-modify", "undo-stack" },
+            Target = "editor",
+            PlayModeSupport = "session-affecting",
+            DefaultTimeoutMs = 30000,
+            MaxTimeoutMs = 600000,
+            Examples = new[]
+            {
+                new ToolExample { Description = "创建跟随相机", Input = new Request { Preset = "follow", Name = "MatrixCreatedCamera", Follow = "Player" } },
+                new ToolExample { Description = "创建 dolly 相机", Input = new Request { Preset = "dolly", Name = "DollyCam", LookAt = "Main Camera" } }
+            }
+        };
+
+        /// <summary>先校验 preset，再创建并配置虚拟相机，保证非法输入不会留下场景对象。</summary>
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            CinemachineToolSupport.EnsureEditorReady("cinemachine.create");
+            CinemachineToolSupport.EnsureCinemachineAvailable();
+
+            request = request ?? new Request();
+            var preset = string.IsNullOrWhiteSpace(request.Preset) ? "follow" : request.Preset.Trim();
+            string[] presetParts;
+            if (!CinemachineToolSupport.Presets.TryGetValue(preset, out presetParts))
+            {
+                throw new UnityCliBridge.BridgeCommandException(
+                    "E_CINEMACHINE_PRESET_INVALID",
+                    "Unsupported Cinemachine preset: " + preset,
+                    "Pass one of: follow, third_person, freelook, dolly, static, top_down, side_scroller.");
+            }
+
+            var cameraName = string.IsNullOrWhiteSpace(request.Name) ? "UnityCli_CM_" + preset : request.Name.Trim();
+            var parent = CinemachineToolSupport.ResolveOptionalTarget(request.Parent);
+            var follow = CinemachineToolSupport.ResolveOptionalTarget(request.Follow);
+            var lookAt = CinemachineToolSupport.ResolveOptionalTarget(request.LookAt);
+            if (request.X.HasValue) CinemachineToolSupport.RequireFinite(request.X.Value, "x");
+            if (request.Y.HasValue) CinemachineToolSupport.RequireFinite(request.Y.Value, "y");
+            if (request.Z.HasValue) CinemachineToolSupport.RequireFinite(request.Z.Value, "z");
+            var bodyType = string.IsNullOrWhiteSpace(presetParts[0]) ? null : CinemachineToolSupport.RequireComponentType(presetParts[0], "Body");
+            var aimType = string.IsNullOrWhiteSpace(presetParts[1]) ? null : CinemachineToolSupport.RequireComponentType(presetParts[1], "Aim");
+            if (bodyType != null) CinemachineToolSupport.RequirePipelineComponentStage(bodyType, "Body");
+            if (aimType != null) CinemachineToolSupport.RequirePipelineComponentStage(aimType, "Aim");
+            var followPlan = follow == null ? null : CinemachineToolSupport.PrepareFirstComponentObjectMember(CinemachineToolSupport.CameraType, follow.transform, "Follow", "m_Follow");
+            var lookAtPlan = lookAt == null ? null : CinemachineToolSupport.PrepareFirstComponentObjectMember(CinemachineToolSupport.CameraType, lookAt.transform, "LookAt", "m_LookAt");
+            if (request.Priority.HasValue) CinemachineToolSupport.RequirePriorityWritable(CinemachineToolSupport.CameraType);
+            ctx.CommitEffect();
+            var gameObject = new GameObject(cameraName);
+            var camera = gameObject.AddComponent(CinemachineToolSupport.CameraType);
+            UnityCliSceneMutation.RegisterCreatedObject(gameObject, "UnityCli Cinemachine Create");
+
+            if (parent != null) gameObject.transform.SetParent(parent.transform, false);
+            var expectedPosition = new Vector3((float)(request.X ?? 0d), (float)(request.Y ?? 0d), (float)(request.Z ?? 0d));
+            gameObject.transform.position = expectedPosition;
+
+            if (followPlan != null) CinemachineToolSupport.ApplyComponentMember(camera, followPlan);
+            if (lookAtPlan != null) CinemachineToolSupport.ApplyComponentMember(camera, lookAtPlan);
+
+            if (request.Priority.HasValue)
+            {
+                CinemachineToolSupport.SetPriority(camera, request.Priority.Value);
+            }
+
+            if (!string.IsNullOrWhiteSpace(presetParts[0]))
+            {
+                CinemachineToolSupport.SwapPipelineComponent(gameObject, camera, "Body", bodyType);
+            }
+            if (!string.IsNullOrWhiteSpace(presetParts[1]))
+            {
+                CinemachineToolSupport.SwapPipelineComponent(gameObject, camera, "Aim", aimType);
+            }
+
+            // 从场景重新解析并读取组件，避免以刚写入的引用作为完成证明。
+            var observedObject = CinemachineToolSupport.ResolveRequiredTarget(gameObject.GetInstanceID().ToString(System.Globalization.CultureInfo.InvariantCulture), "Created Cinemachine camera could not be resolved.");
+            var observedCamera = CinemachineToolSupport.RequireCameraComponent(observedObject);
+            if (!string.Equals(observedObject.name, cameraName, System.StringComparison.Ordinal) || observedObject.transform.parent != (parent == null ? null : parent.transform) || (observedObject.transform.position - expectedPosition).sqrMagnitude > 0.0000001f) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_CREATE_VERIFY_FAILED", "Created camera identity, parent or position did not retain the request.", "Inspect the created object before retrying.");
+            if (followPlan != null) CinemachineToolSupport.VerifyComponentMember(observedCamera, followPlan, "E_CINEMACHINE_CREATE_VERIFY_FAILED");
+            if (lookAtPlan != null) CinemachineToolSupport.VerifyComponentMember(observedCamera, lookAtPlan, "E_CINEMACHINE_CREATE_VERIFY_FAILED");
+            if (bodyType != null && CinemachineToolSupport.GetPipelineComponent(observedCamera, "Body")?.GetType() != bodyType) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_CREATE_VERIFY_FAILED", "Created camera Body did not retain the preset.", "Check the preset and retry.");
+            if (aimType != null && CinemachineToolSupport.GetPipelineComponent(observedCamera, "Aim")?.GetType() != aimType) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_CREATE_VERIFY_FAILED", "Created camera Aim did not retain the preset.", "Check the preset and retry.");
+            if (request.Priority.HasValue)
+            {
+                using (var observedSerialized = new UnityEditor.SerializedObject(observedCamera))
+                {
+                    var priorityRoot = observedSerialized.FindProperty("Priority") ?? observedSerialized.FindProperty("m_Priority");
+                    var priorityValue = priorityRoot?.FindPropertyRelative("Value") ?? priorityRoot?.FindPropertyRelative("m_Value");
+                    var directPriority = observedCamera.GetType().GetProperty("Priority", System.Reflection.BindingFlags.Instance | System.Reflection.BindingFlags.Public);
+                    var actualPriority = priorityValue != null ? (int?)priorityValue.intValue : directPriority != null ? (int?)System.Convert.ToInt32(directPriority.GetValue(observedCamera, null)) : null;
+                    if (!actualPriority.HasValue || actualPriority.Value != request.Priority.Value) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_CREATE_VERIFY_FAILED", "Created camera priority did not retain the request.", "Inspect the created object before retrying.");
+                }
+            }
+            CinemachineToolSupport.MarkDirty(observedObject);
+            return new System.Threading.Tasks.ValueTask<Result>(new Result
+            {
+                Cinemachine = CinemachineToolSupport.BuildPackageStatus(),
+                Object = CinemachineToolSupport.BuildObjectInfo(observedObject, preset),
+                PlannedEffects = new List<CinemachinePlannedEffect>
+                {
+                    new CinemachinePlannedEffect
+                    {
+                        Type = "cinemachine.create",
+                        Preset = preset,
+                        Target = GameObjectToolSupport.HierarchyPath(observedObject)
+                    }
+                }
+            });
+        }
+    }
+}
+#endif

package/extensions/cinemachine/unitypkg/Editor/Cinemachine/extension-add.cs

@@ -0,0 +1,13 @@
+#if UNITY_EDITOR
+using UnityEditor;
+namespace UnityCli.Cinemachine
+{
+    public sealed class ExtensionAddTool : IUnityCliTool<ExtensionAddTool.Request, ExtensionAddTool.Result>
+    {
+        public sealed class Request { [UnityCliRequired] public string Target { get; set; } [UnityCliRequired] public string ExtensionType { get; set; } }
+        public sealed class Result { public bool Added { get; set; } }
+        public ToolDescriptor Describe() => new() { Name = "cinemachine.extension.add", Summary = "Add a CinemachineExtension component.", Description = "Adds one CinemachineExtension-derived component to a virtual camera, re-enumerates extensions to verify it exists, and marks the scene dirty without saving it.", Group = "cinemachine",RequiresPackages = new[] { "com.unity.cinemachine" }, SideEffects = new[] { "scene-modify", "undo-stack" }, Target = "editor", PlayModeSupport = "session-affecting", DefaultTimeoutMs = 30000, MaxTimeoutMs = 60000, Examples = new[] { new ToolExample { Description = "Add a collider extension", Input = new Request { Target = "PlayerCam", ExtensionType = "CinemachineCollider" } } } };
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default) { var target = CinemachineExtensionToolSupport.Target(request.Target, "cinemachine.extension.add"); var type = CinemachineExtensionToolSupport.Type(request.ExtensionType); if (target.GetComponent(type) != null) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_EXTENSION_EXISTS", "Extension already present: " + request.ExtensionType, "Use cinemachine.extension.remove before adding it again."); var targetId = target.GetInstanceID(); ctx.CommitEffect(); UnityCliSceneMutation.AddComponent(target, type); if (!CinemachineExtensionToolSupport.Contains(targetId, type, out var observedTarget)) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_EXTENSION_VERIFY_FAILED", "Extension was not present after adding: " + request.ExtensionType, "Check the target virtual camera and retry."); CinemachineToolSupport.MarkDirty(observedTarget); return new(new Result { Added = true }); }
+    }
+}
+#endif

package/extensions/cinemachine/unitypkg/Editor/Cinemachine/extension-list.cs

@@ -0,0 +1,13 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+namespace UnityCli.Cinemachine
+{
+    public sealed class ExtensionListTool : IUnityCliTool<ExtensionListTool.Request, ExtensionListTool.Result>
+    {
+        public sealed class Request { [UnityCliRequired] public string Target { get; set; } }
+        public sealed class Result { public List<string> Extensions { get; set; } public long Count { get; set; } }
+        public ToolDescriptor Describe() => new() { Name = "cinemachine.extension.list", Summary = "List CinemachineExtension components.", Description = "Lists CinemachineExtension-derived components on a virtual camera without modifying the scene.", Group = "cinemachine",RequiresPackages = new[] { "com.unity.cinemachine" }, SideEffects = new string[0], Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 60000, Examples = new[] { new ToolExample { Description = "List PlayerCam extensions", Input = new Request { Target = "PlayerCam" } } } };
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext context, System.Threading.CancellationToken ct = default) { var extensions = CinemachineExtensionToolSupport.List(CinemachineExtensionToolSupport.Target(request.Target, "cinemachine.extension.list")); return new(new Result { Extensions = extensions, Count = extensions.Count }); }
+    }
+}
+#endif

package/extensions/cinemachine/unitypkg/Editor/Cinemachine/extension-remove.cs

@@ -0,0 +1,13 @@
+#if UNITY_EDITOR
+using UnityEditor;
+namespace UnityCli.Cinemachine
+{
+    public sealed class ExtensionRemoveTool : IUnityCliTool<ExtensionRemoveTool.Request, ExtensionRemoveTool.Result>
+    {
+        public sealed class Request { [UnityCliRequired] public string Target { get; set; } [UnityCliRequired] public string ExtensionType { get; set; } }
+        public sealed class Result { public bool Removed { get; set; } }
+        public ToolDescriptor Describe() => new() { Name = "cinemachine.extension.remove", Summary = "Remove a CinemachineExtension component.", Description = "Removes one CinemachineExtension-derived component from scene memory, re-enumerates extensions to verify it is absent, records Undo, and marks the scene dirty without saving it.", Group = "cinemachine",RequiresPackages = new[] { "com.unity.cinemachine" }, SideEffects = new[] { "scene-modify", "undo-stack" }, Target = "editor", PlayModeSupport = "session-affecting", DefaultTimeoutMs = 30000, MaxTimeoutMs = 60000, Examples = new[] { new ToolExample { Description = "Remove a collider extension", Input = new Request { Target = "PlayerCam", ExtensionType = "CinemachineCollider" } } } };
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default) { var target = CinemachineExtensionToolSupport.Target(request.Target, "cinemachine.extension.remove"); var type = CinemachineExtensionToolSupport.Type(request.ExtensionType); var extension = target.GetComponent(type); if (extension == null) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_EXTENSION_NOT_FOUND", "Extension not found: " + request.ExtensionType, "Use cinemachine.extension.list to inspect installed extensions."); var targetId = target.GetInstanceID(); ctx.CommitEffect(); UnityCliSceneMutation.DestroyObject(extension); if (CinemachineExtensionToolSupport.Contains(targetId, type, out var observedTarget)) throw new UnityCliBridge.BridgeCommandException("E_CINEMACHINE_EXTENSION_VERIFY_FAILED", "Extension remained after removal: " + request.ExtensionType, "Check the target virtual camera and retry."); CinemachineToolSupport.MarkDirty(observedTarget); return new(new Result { Removed = true }); }
+    }
+}
+#endif