@alpsckr/unitycli 0.4.0

package/unitypkg/Editor/Tools/project/ProjectTagLayerToolSupport.cs

@@ -0,0 +1,23 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+namespace UnityCli
+{
+    public sealed class ProjectTagLayerResult { public bool Changed { get; set; } public string NoOpReason { get; set; } public long? LayerIndex { get; set; } public List<EditorPlannedEffect> PlannedEffects { get; set; } }
+    public static class ProjectTagLayerToolSupport
+    {
+        public static System.Threading.Tasks.ValueTask<ProjectTagLayerResult> Apply(bool layer, bool add, string name, int? index, string toolName, UnityCliProjectToolContext ctx)
+        {
+            EditorToolSupport.EnsureEditorNotBusy(toolName);
+            var plan = EditorActionToolSupport.PrepareTagLayerChange(layer, add, name, index);
+            if (!plan.Changed)
+            {
+                var (_, existingLayerIndex) = EditorActionToolSupport.ApplyTagLayerChange(plan);
+                return new(new ProjectTagLayerResult { Changed = false, NoOpReason = add ? "already-present" : "already-absent", LayerIndex = layer && existingLayerIndex >= 0 ? existingLayerIndex : (long?)null, PlannedEffects = new List<EditorPlannedEffect>() });
+            }
+            ctx.CommitEffect();
+            var (changed, layerIndex) = EditorActionToolSupport.ApplyTagLayerChange(plan);
+            return new(new ProjectTagLayerResult { Changed = changed, LayerIndex = layer && layerIndex >= 0 ? layerIndex : (long?)null, PlannedEffects = new List<EditorPlannedEffect> { new EditorPlannedEffect { Type = toolName, Action = add ? "add" : "remove", Name = name } } });
+        }
+    }
+}
+#endif

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

@@ -0,0 +1,35 @@
+#if UNITY_EDITOR
+namespace UnityCli
+{
+    /// <summary>修改AudioManager批准字段并证明精确文件持久化。</summary>
+    public sealed class ProjectAudioSettingsSetTool : IUnityCliTool<ProjectAudioSettingsSetRequest, ProjectAudioSettingsSetResult>
+    {
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "project.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",
+            DestructiveHint = true,
+            SupportsDryRun = true,
+            SideEffects = new[] { "project-settings-write" },
+            Target = "editor",
+            PlayModeSupport = "editor-only",
+            DefaultTimeoutMs = 30000,
+            MaxTimeoutMs = 120000,
+            Examples = new[]
+            {
+                new ToolExample { Description = "Preview an Audio volume change.", Input = new ProjectAudioSettingsSetRequest { Volume = 0.8 }, Execution = new ToolExampleExecution { DryRun = true } },
+                new ToolExample { Description = "Apply Audio rolloff and doppler settings.", Input = new ProjectAudioSettingsSetRequest { RolloffScale = 1.25, DopplerFactor = 1.0 } }
+            }
+        };
+
+        /// <summary>一次barrier后只保存AudioManager.asset并fresh读回。</summary>
+        public System.Threading.Tasks.ValueTask<ProjectAudioSettingsSetResult> ExecuteAsync(ProjectAudioSettingsSetRequest request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            ct.ThrowIfCancellationRequested();
+            return new System.Threading.Tasks.ValueTask<ProjectAudioSettingsSetResult>(ProjectSettingsToolSupport.SetAudio(request, ctx));
+        }
+    }
+}
+#endif

package/unitypkg/Editor/Tools/project/audio-settings.cs

@@ -0,0 +1,31 @@
+#if UNITY_EDITOR
+namespace UnityCli
+{
+    /// <summary>读取AudioManager批准字段和磁盘身份。</summary>
+    public sealed class ProjectAudioSettingsTool : IUnityCliTool<ProjectSettingsReadRequest, ProjectAudioSettingsSnapshot>
+    {
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "project.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",
+            DestructiveHint = false,
+            SupportsDryRun = false,
+            SideEffects = System.Array.Empty<string>(),
+            Target = "editor",
+            PlayModeSupport = "editor-only",
+            DefaultTimeoutMs = 30000,
+            MaxTimeoutMs = 120000,
+            Examples = new[] { new ToolExample { Description = "Read current project Audio settings.", Input = new ProjectSettingsReadRequest() } }
+        };
+
+        /// <summary>返回当前Unity版本已验证的AudioManager字段。</summary>
+        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"));
+        }
+    }
+}
+#endif

package/unitypkg/Editor/Tools/project/info.cs

@@ -0,0 +1,52 @@
+#if UNITY_EDITOR
+using System.IO;
+using UnityEngine;
+
+namespace UnityCli.Tools.Project
+{
+    /// <summary>
+    /// project.info 只读 Tool：读取 Unity 项目基础元数据。
+    /// </summary>
+    public class ProjectInfoTool : IUnityCliTool<ProjectInfoTool.Request, ProjectInfoTool.Result>
+    {
+        public sealed class Request { }
+
+        public sealed class Result
+        {
+            public string ProjectRoot { get; set; }
+            public string ProjectName { get; set; }
+            public string UnityVersion { get; set; }
+            public string Platform { get; set; }
+            public string AssetsPath { get; set; }
+        }
+
+        // ── desc:只声明人工字段,source=built-in 表示进入只读 Tool 表 ──
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "project.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",
+            Target = "editor",
+            PlayModeSupport = "supported",
+            Examples = new[] { new ToolExample { Description = "Read project metadata", Input = new Request { } } }
+        };
+
+        /// <summary>
+        /// 读取项目路径、项目名、Unity 版本、运行平台和 Assets 路径；只读，不触发 import/refresh。
+    /// </summary>
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            var projectRoot = Path.GetDirectoryName(Application.dataPath);
+            return new System.Threading.Tasks.ValueTask<Result>(new Result
+            {
+                ProjectRoot = projectRoot,
+                ProjectName = Path.GetFileName(projectRoot),
+                UnityVersion = Application.unityVersion,
+                Platform = Application.platform.ToString(),
+                AssetsPath = Application.dataPath
+            });
+        }
+    }
+}
+#endif

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

@@ -0,0 +1,35 @@
+#if UNITY_EDITOR
+namespace UnityCli
+{
+    /// <summary>按唯一axis名称修改legacy Input Manager批准字段。</summary>
+    public sealed class ProjectInputSettingsSetTool : IUnityCliTool<ProjectInputSettingsSetRequest, ProjectInputSettingsSetResult>
+    {
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "project.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",
+            DestructiveHint = true,
+            SupportsDryRun = true,
+            SideEffects = new[] { "project-settings-write" },
+            Target = "editor",
+            PlayModeSupport = "editor-only",
+            DefaultTimeoutMs = 30000,
+            MaxTimeoutMs = 120000,
+            Examples = new[]
+            {
+                new ToolExample { Description = "Preview a Horizontal sensitivity change.", Input = new ProjectInputSettingsSetRequest { Axis = "Horizontal", Sensitivity = 3.0 }, Execution = new ToolExampleExecution { DryRun = true } },
+                new ToolExample { Description = "Apply gravity and dead values to one exact axis.", Input = new ProjectInputSettingsSetRequest { Axis = "Horizontal", Gravity = 3.0, Dead = 0.001 } }
+            }
+        };
+
+        /// <summary>冻结唯一axis index/name，单次barrier写入并按同一identity读回。</summary>
+        public System.Threading.Tasks.ValueTask<ProjectInputSettingsSetResult> ExecuteAsync(ProjectInputSettingsSetRequest request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            ct.ThrowIfCancellationRequested();
+            return new System.Threading.Tasks.ValueTask<ProjectInputSettingsSetResult>(ProjectSettingsToolSupport.SetInput(request, ctx));
+        }
+    }
+}
+#endif

package/unitypkg/Editor/Tools/project/input-settings.cs

@@ -0,0 +1,35 @@
+#if UNITY_EDITOR
+namespace UnityCli
+{
+    /// <summary>分页读取legacy Input Manager批准字段。</summary>
+    public sealed class ProjectInputSettingsTool : IUnityCliTool<ProjectInputSettingsRequest, ProjectInputSettingsResult>
+    {
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "project.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",
+            DestructiveHint = false,
+            SupportsDryRun = false,
+            SideEffects = System.Array.Empty<string>(),
+            Target = "editor",
+            PlayModeSupport = "editor-only",
+            DefaultTimeoutMs = 30000,
+            MaxTimeoutMs = 120000,
+            Examples = new[]
+            {
+                new ToolExample { Description = "Read the first bounded axis page.", Input = new ProjectInputSettingsRequest() },
+                new ToolExample { Description = "Read exact Horizontal axis entries.", Input = new ProjectInputSettingsRequest { Axis = "Horizontal", Limit = 20 } }
+            }
+        };
+
+        /// <summary>读取有界axis集合，不触发asset写入或import。</summary>
+        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"));
+        }
+    }
+}
+#endif

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

@@ -0,0 +1,3 @@
+#if UNITY_EDITOR
+namespace UnityCli { public class ProjectLayerAddTool : IUnityCliTool<ProjectLayerAddTool.Request, ProjectTagLayerResult> { public sealed class Request { [UnityCliRequired] public string Name { get; set; } public int? Index { get; set; } } public ToolDescriptor Describe() => new() { Name = "project.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",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.layer.add", ctx); } }
+#endif

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

@@ -0,0 +1,3 @@
+#if UNITY_EDITOR
+namespace UnityCli { public class ProjectLayerRemoveTool : IUnityCliTool<ProjectLayerRemoveTool.Request, ProjectTagLayerResult> { public sealed class Request { [UnityCliRequired] public string Name { get; set; } public int? Index { get; set; } } public ToolDescriptor Describe() => new() { Name = "project.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",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.layer.remove", ctx); } }
+#endif

package/unitypkg/Editor/Tools/project/layers.cs

@@ -0,0 +1,61 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+using UnityEngine;
+
+namespace UnityCli.Tools.Project
+{
+    /// <summary>
+    /// project.layers 只读 Tool：读取 TagManager 中定义的 Layer 索引和名称。
+    /// </summary>
+    public class ProjectLayersTool : IUnityCliTool<ProjectLayersTool.Request, ProjectLayersTool.Result>
+    {
+        public sealed class Request { }
+
+        public sealed class LayerEntry
+        {
+            public int Index { get; set; }
+            public string Name { get; set; }
+        }
+
+        public sealed class Result
+        {
+            public LayerEntry[] Layers { get; set; }
+            public int Count { get; set; }
+        }
+
+        // ── desc:只声明人工字段,source=built-in 表示进入只读 Tool 表 ──
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "project.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",
+            Target = "editor",
+            PlayModeSupport = "supported",
+            Examples = new[] { new ToolExample { Description = "List configured project layers", Input = new Request { } } }
+        };
+
+        /// <summary>
+        /// 读取非空 Layer 槽位；只读，不修改 TagManager 或项目设置。
+    /// </summary>
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            var layers = new List<LayerEntry>();
+            for (var i = 0; i < 32; i++)
+            {
+                var name = LayerMask.LayerToName(i);
+                if (!string.IsNullOrEmpty(name))
+                {
+                    layers.Add(new LayerEntry { Index = i, Name = name });
+                }
+            }
+
+            return new System.Threading.Tasks.ValueTask<Result>(new Result
+            {
+                Layers = layers.ToArray(),
+                Count = layers.Count
+            });
+        }
+    }
+}
+#endif

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

@@ -0,0 +1,35 @@
+#if UNITY_EDITOR
+namespace UnityCli
+{
+    /// <summary>修改active build target的PlayerSettings批准字段。</summary>
+    public sealed class ProjectPlayerSettingsSetTool : IUnityCliTool<ProjectPlayerSettingsSetRequest, ProjectPlayerSettingsSetResult>
+    {
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "project.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",
+            DestructiveHint = true,
+            SupportsDryRun = true,
+            SideEffects = new[] { "project-settings-write", "domain-reload" },
+            Target = "editor",
+            PlayModeSupport = "editor-only",
+            DefaultTimeoutMs = 60000,
+            MaxTimeoutMs = 600000,
+            Examples = new[]
+            {
+                new ToolExample { Description = "Preview changing project identity fields.", Input = new ProjectPlayerSettingsSetRequest { CompanyName = "Example", ProductName = "Game", BundleVersion = "1.0.0" }, Execution = new ToolExampleExecution { DryRun = true } },
+                new ToolExample { Description = "Set the bundle version.", Input = new ProjectPlayerSettingsSetRequest { BundleVersion = "1.0.1" } }
+            }
+        };
+
+        /// <summary>写入前冻结active NamedBuildTarget，写入后从同一target fresh读回。</summary>
+        public System.Threading.Tasks.ValueTask<ProjectPlayerSettingsSetResult> ExecuteAsync(ProjectPlayerSettingsSetRequest request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            ct.ThrowIfCancellationRequested();
+            return new System.Threading.Tasks.ValueTask<ProjectPlayerSettingsSetResult>(ProjectSettingsToolSupport.SetPlayer(request, ctx));
+        }
+    }
+}
+#endif

package/unitypkg/Editor/Tools/project/player-settings.cs

@@ -0,0 +1,31 @@
+#if UNITY_EDITOR
+namespace UnityCli
+{
+    /// <summary>读取active build target的PlayerSettings批准字段。</summary>
+    public sealed class ProjectPlayerSettingsTool : IUnityCliTool<ProjectSettingsReadRequest, ProjectPlayerSettingsSnapshot>
+    {
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "project.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",
+            DestructiveHint = false,
+            SupportsDryRun = false,
+            SideEffects = System.Array.Empty<string>(),
+            Target = "editor",
+            PlayModeSupport = "editor-only",
+            DefaultTimeoutMs = 30000,
+            MaxTimeoutMs = 120000,
+            Examples = new[] { new ToolExample { Description = "Read active-target PlayerSettings.", Input = new ProjectSettingsReadRequest() } }
+        };
+
+        /// <summary>通过NamedBuildTarget读取当前PlayerSettings。</summary>
+        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"));
+        }
+    }
+}
+#endif

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

@@ -0,0 +1,3 @@
+#if UNITY_EDITOR
+namespace UnityCli { public class ProjectTagAddTool : IUnityCliTool<ProjectTagAddTool.Request, ProjectTagLayerResult> { public sealed class Request { [UnityCliRequired] public string Name { get; set; } } public ToolDescriptor Describe() => new() { Name = "project.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",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.tag.add", ctx); } }
+#endif

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

@@ -0,0 +1,3 @@
+#if UNITY_EDITOR
+namespace UnityCli { public class ProjectTagRemoveTool : IUnityCliTool<ProjectTagRemoveTool.Request, ProjectTagLayerResult> { public sealed class Request { [UnityCliRequired] public string Name { get; set; } } public ToolDescriptor Describe() => new() { Name = "project.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",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.tag.remove", ctx); } }
+#endif

package/unitypkg/Editor/Tools/project/tags.cs

@@ -0,0 +1,45 @@
+#if UNITY_EDITOR
+using UnityEditorInternal;
+
+namespace UnityCli.Tools.Project
+{
+    /// <summary>
+    /// project.tags 只读 Tool：读取 TagManager 中定义的标签列表。
+    /// </summary>
+    public class ProjectTagsTool : IUnityCliTool<ProjectTagsTool.Request, ProjectTagsTool.Result>
+    {
+        public sealed class Request { }
+
+        public sealed class Result
+        {
+            public string[] Tags { get; set; }
+            public int Count { get; set; }
+        }
+
+        // ── desc:只声明人工字段,source=built-in 表示进入只读 Tool 表 ──
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "project.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",
+            Target = "editor",
+            PlayModeSupport = "supported",
+            Examples = new[] { new ToolExample { Description = "List configured project tags", Input = new Request { } } }
+        };
+
+        /// <summary>
+        /// 读取 TagManager 标签；只读，不创建、删除或重命名标签。
+    /// </summary>
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            var tags = InternalEditorUtility.tags;
+            return new System.Threading.Tasks.ValueTask<Result>(new Result
+            {
+                Tags = tags,
+                Count = tags.Length
+            });
+        }
+    }
+}
+#endif

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

@@ -0,0 +1,35 @@
+#if UNITY_EDITOR
+namespace UnityCli
+{
+    /// <summary>修改TimeManager批准字段并证明持久化。</summary>
+    public sealed class ProjectTimeSettingsSetTool : IUnityCliTool<ProjectTimeSettingsSetRequest, ProjectTimeSettingsSetResult>
+    {
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "project.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",
+            DestructiveHint = true,
+            SupportsDryRun = true,
+            SideEffects = new[] { "project-settings-write" },
+            Target = "editor",
+            PlayModeSupport = "editor-only",
+            DefaultTimeoutMs = 30000,
+            MaxTimeoutMs = 120000,
+            Examples = new[]
+            {
+                new ToolExample { Description = "Preview changing the fixed timestep.", Input = new ProjectTimeSettingsSetRequest { FixedDeltaTime = 0.016666667 }, Execution = new ToolExampleExecution { DryRun = true } },
+                new ToolExample { Description = "Set maximum timestep and time scale.", Input = new ProjectTimeSettingsSetRequest { MaximumDeltaTime = 0.25, TimeScale = 1.0 } }
+            }
+        };
+
+        /// <summary>一次barrier后只保存TimeManager.asset并验证float终态。</summary>
+        public System.Threading.Tasks.ValueTask<ProjectTimeSettingsSetResult> ExecuteAsync(ProjectTimeSettingsSetRequest request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            ct.ThrowIfCancellationRequested();
+            return new System.Threading.Tasks.ValueTask<ProjectTimeSettingsSetResult>(ProjectSettingsToolSupport.SetTime(request, ctx));
+        }
+    }
+}
+#endif

package/unitypkg/Editor/Tools/project/time-settings.cs

@@ -0,0 +1,31 @@
+#if UNITY_EDITOR
+namespace UnityCli
+{
+    /// <summary>读取TimeManager批准的持久化字段。</summary>
+    public sealed class ProjectTimeSettingsTool : IUnityCliTool<ProjectSettingsReadRequest, ProjectTimeSettingsSnapshot>
+    {
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "project.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",
+            DestructiveHint = false,
+            SupportsDryRun = false,
+            SideEffects = System.Array.Empty<string>(),
+            Target = "editor",
+            PlayModeSupport = "editor-only",
+            DefaultTimeoutMs = 30000,
+            MaxTimeoutMs = 120000,
+            Examples = new[] { new ToolExample { Description = "Read persisted Time settings.", Input = new ProjectSettingsReadRequest() } }
+        };
+
+        /// <summary>读取TimeManager asset，不读取PlayMode瞬时Time值。</summary>
+        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"));
+        }
+    }
+}
+#endif

package/unitypkg/Editor/Tools/reflection/method/call.cs

@@ -0,0 +1,114 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+using System.Reflection;
+
+namespace UnityCli
+{
+    /// <summary>
+    /// <summary>通过反射调用任意 C# 方法。</summary>
+    /// </summary>
+    public class ReflectionMethodCallTool : IUnityCliTool<ReflectionMethodCallTool.Request, ReflectionMethodCallTool.Result>
+    {
+        public sealed class Request
+        {
+            [UnityCliRequired]
+            public string TypeName { get; set; }
+            [UnityCliRequired]
+            public string MethodName { get; set; }
+            [UnityCliAnyJson] public object Args { get; set; }
+            public List<string> ParameterTypes { get; set; }
+            [UnityCliAnyJson] public Dictionary<string, object> InstanceRef { get; set; }
+            [UnityCliRequired] public UnityCliCompletionProbe CompletionProbe { get; set; }
+        }
+
+        public sealed class Result
+        {
+            [UnityCliAnyJson] public object Data { get; set; }
+            public List<PlannedEffect> PlannedEffects { get; set; }
+            public UnityCliCompletionProbeReadback Completion { get; set; }
+        }
+
+        public sealed class PlannedEffect
+        {
+            public string Type { get; set; }
+            public string Target { get; set; }
+            public string SideEffects { get; set; }
+        }
+
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "reflection.method.call",
+            Summary = "Call one synchronous C# method in the live Editor and prove declared state through a read Tool.",
+            Description = "Resolve the exact type, overload, arguments, and optional instance before invoking one synchronous method. completionProbe is mandatory and proves declared before/after state through an eligible read Tool in the same Editor turn. Task/ValueTask, iterator, yield, and AsyncOperation methods are rejected; a method return value is never accepted as completion proof.",
+            Group = "reflection",
+            DestructiveHint = true,
+            SideEffects = new[] { "arbitrary-method-invocation" },
+            Target = "editor",
+            PlayModeSupport = "session-affecting",
+            SupportsDryRun = true,
+            DefaultTimeoutMs = 30000,
+            MaxTimeoutMs = 600000,
+            Examples = new[]
+            {
+                new ToolExample
+                {
+                    Description = "Preview a synchronous overload without invoking it",
+                    Input = new Request
+                    {
+                        TypeName = "UnityEngine.Mathf", MethodName = "Abs", Args = new object[] { -2.5f }, ParameterTypes = new List<string> { "System.Single" },
+                        CompletionProbe = new UnityCliCompletionProbe
+                        {
+                            ReadTool = "scene.gameobject", Input = new Dictionary<string, object> { { "target", "Main Camera" } },
+                            Assertions = new List<UnityCliCompletionAssertion>
+                            {
+                                new UnityCliCompletionAssertion { Path = "/gameObject/transform/position/x", Operator = "approx", Before = 0.0, After = 1.0, Tolerance = 0.0001 }
+                            }
+                        }
+                    },
+                    Execution = new ToolExampleExecution { DryRun = true }
+                }
+            }
+        };
+
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            if (string.IsNullOrEmpty(request.TypeName) || string.IsNullOrEmpty(request.MethodName))
+            {
+                throw new UnityCliBridge.BridgeCommandException("E_METHOD_TARGET_REQUIRED",
+                    "reflection.method.call requires typeName and methodName.",
+                    "Run tools run reflection.method.find to discover methods, then retry with the required target fields.");
+            }
+
+            var bindings = BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static;
+            // overload、参数与 instance 都是可预见校验，必须在 effect barrier 前完成。
+            var prepared = UnityCliBridge.ReflectionInvoker.PrepareCall(
+                request.TypeName, request.MethodName,
+                request.Args, request.ParameterTypes, request.InstanceRef, bindings);
+
+            // dry-run 必须在任何反射调用前返回，任意方法即使看似只读也不能在预览阶段执行。
+            if (ctx.DryRun)
+            {
+                return new System.Threading.Tasks.ValueTask<Result>(new Result
+                {
+                    PlannedEffects = new List<PlannedEffect>
+                    {
+                        new PlannedEffect { Type = "reflection.method.call", Target = request.TypeName + "." + request.MethodName, SideEffects = "arbitrary-method-invocation" }
+                    }
+                });
+            }
+
+            Dictionary<string, object> data = null;
+            var completion = ctx.RunCompletionProbe(request.CompletionProbe, () => data = UnityCliBridge.ReflectionInvoker.InvokePrepared(prepared));
+            return new System.Threading.Tasks.ValueTask<Result>(new Result
+            {
+                Data = data,
+                Completion = completion,
+                PlannedEffects = new List<PlannedEffect>
+                {
+                    new PlannedEffect { Type = "reflection.method.call", Target = request.TypeName + "." + request.MethodName, SideEffects = "arbitrary-method-invocation" }
+                }
+            });
+        }
+    }
+}
+#endif