@alpsckr/unitycli 0.4.2 → 0.4.4

package/unitypkg/Editor/Tools/component/get.cs

@@ -18,17 +18,18 @@ namespace UnityCli
             public string AssetPath { get; set; }
             public string Guid { get; set; }
             public int? ComponentInstanceId { get; set; }
-            public int? ComponentIndex { get; set; }
+            [UnityCliRange(0L, int.MaxValue)] public int? ComponentIndex { get; set; }
             public string Component { get; set; }
             public string ComponentType { get; set; }
-            public int? MaxDepth { get; set; }
-            public int? MaxArrayItems { get; set; }
+            [UnityCliRange(0L, 16L)] public int? MaxDepth { get; set; }
+            [UnityCliRange(1L, 1000L)] public int? MaxArrayItems { get; set; }
             public bool? IncludeFields { get; set; }
             public bool? IncludeProperties { get; set; }
             public bool? DeepSerialization { get; set; }
-            public List<string> Paths { get; set; }
+            [UnityCliItemsRange(0, 128)] public List<string> Paths { get; set; }
             [UnityCliAnyJson] public object ViewQuery { get; set; }
             public string NamePattern { get; set; }
+            public UnityCliReadBudgetInput Budget { get; set; }
         }
 
         public sealed class Result
@@ -42,7 +43,7 @@ namespace UnityCli
         {
             Name = "component.get",
             Summary = "Deep-read one Component by GameObject and component selector; use paths/viewQuery for token-safe fields.",
-            Description = "Deep-read one Component after selecting a GameObject with go.find/go.inspect or tools run scene.gameobject.components. For token safety, pass exact paths or one viewQuery; they are mutually exclusive and skip full fields/props expansion. Use componentIndex/componentInstanceId when duplicate components exist. Keep maxDepth low before expanding MonoBehaviours.",
+            Description = "Deep-read one Component after selecting a GameObject with go.find, scene.hierarchy, scene.gameobject, or scene.gameobject.components. For token safety, pass exact paths or one viewQuery; they are mutually exclusive and skip full fields/props expansion. Use componentIndex/componentInstanceId when duplicate components exist. maxDepth is 0..16, maxArrayItems is 1..1000, and paths accepts at most 128 ordered exact reads. All reads share budget scan/node/getter/reflection/time/UTF-8 ceilings; truncated nodes return nextPath. Defaults are 10000 scans, 4096 nodes, 2048 getters, 4096 reflection calls, 250 main-thread ms, and 1 MiB; maxima are 100000/20000/10000/20000/2000 ms/8 MiB. Read-only in Edit and Play Mode.",
             Group = "component",
             DestructiveHint = false,
             Target = "editor",
@@ -58,13 +59,19 @@ namespace UnityCli
 
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
-            var component = UnityCliBridge.ObjectRefResolver.ResolveComponent(request);
+            var budget = ctx.UseReadBudget(request.Budget);
+            var component = UnityCliBridge.ObjectRefResolver.ResolveComponent(request, budget);
             var options = GameObjectToolSupport.BuildSerializerOptions(request);
-            var data = UnityCliBridge.ObjectSerializer.Serialize(component, options);
+            var data = UnityCliBridge.ObjectSerializer.Serialize(component, options, budget);
+            if (!budget.TryConsumeReflectionCall()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+            var typeName = component.GetType().FullName;
+            if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+            var gameObject = component.gameObject;
+            var gameObjectRef = GameObjectToolSupport.BuildGameObjectRef(gameObject, budget);
             return new System.Threading.Tasks.ValueTask<Result>(new Result
             {
-                TypeName = component.GetType().FullName,
-                GameObject = GameObjectToolSupport.BuildGameObjectRef(component.gameObject),
+                TypeName = typeName,
+                GameObject = gameObjectRef,
                 Data = data
             });
         }

package/unitypkg/Editor/Tools/component/modify.cs

@@ -21,11 +21,12 @@ namespace UnityCli
             public string AssetPath { get; set; }
             public string Guid { get; set; }
             public int? ComponentInstanceId { get; set; }
-            public int? ComponentIndex { get; set; }
+            [UnityCliRange(0L, int.MaxValue)] public int? ComponentIndex { get; set; }
             public string Component { get; set; }
             public string ComponentType { get; set; }
-            public int? MaxDepth { get; set; }
+            [UnityCliRange(0L, 16L)] public int? MaxDepth { get; set; }
             [UnityCliAnyJson] public List<object> PathPatches { get; set; }
+            public UnityCliReadBudgetInput Budget { get; set; }
         }
 
         public sealed class Result
@@ -59,7 +60,8 @@ namespace UnityCli
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             GameObjectToolSupport.EnsureEditorNotBusy("component.modify");
-            var component = UnityCliBridge.ObjectRefResolver.ResolveComponent(request);
+            var readBudget = ctx.UseReadBudget(request.Budget);
+            var component = UnityCliBridge.ObjectRefResolver.ResolveComponent(request, readBudget);
             if (request.PathPatches == null || request.PathPatches.Count == 0)
                 throw new UnityCliBridge.BridgeCommandException("E_COMPONENT_PATCH_REQUIRED", "component.modify requires non-empty pathPatches.", "Pass direct replace pathPatches for writable serialized properties.");
             UnityCliBridge.ObjectPatch.ValidateOnly(component, request.PathPatches, null);
@@ -90,7 +92,7 @@ namespace UnityCli
             observedSerializedObject.Update();
             UnityCliBridge.ObjectPatch.VerifyFreshSerializedProperties(observedComponent, request.PathPatches);
             var maxDepth = request.MaxDepth ?? 2;
-            var updatedData = UnityCliBridge.ObjectSerializer.Serialize(observedComponent, new UnityCliBridge.ObjectSerializer.Options { MaxDepth = maxDepth, IncludeFields = true, IncludeProperties = true, DeepSerialization = false });
+            var updatedData = UnityCliBridge.ObjectSerializer.Serialize(observedComponent, new UnityCliBridge.ObjectSerializer.Options { MaxDepth = maxDepth, IncludeFields = true, IncludeProperties = true, DeepSerialization = false }, readBudget);
             return new System.Threading.Tasks.ValueTask<Result>(new Result
             {
                 TypeName = component.GetType().FullName,

package/unitypkg/Editor/Tools/console/clear.cs

@@ -13,8 +13,8 @@ namespace UnityCli
     public class ConsoleClearTool : IUnityCliTool<ConsoleClearTool.Request, ConsoleClearTool.Result>
     {
         public sealed class Request { }
-        public sealed class Result { public bool DryRun { get; set; } public bool Cleared { get; set; } public List<EditorPlannedEffect> PlannedEffects { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "console.clear", Summary = "Clear the Unity Console log.", Description = "Clear all Console entries via LogEntries.Clear(). dryRun=true previews without clearing.", Group = "console",DestructiveHint = false, SupportsDryRun = true, SideEffects = new[] { "editor-console-state" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Clear console", Input = new Request { } } } };
+        public sealed class Result { public bool DryRun { get; set; } public bool Cleared { get; set; } public long PreviousCount { get; set; } public long RemainingCount { get; set; } public List<EditorPlannedEffect> PlannedEffects { get; set; } }
+        public ToolDescriptor Describe() => new() { Name = "console.clear", Summary = "Clear every Unity Console entry and return count readback.", Description = "Clear all Console entries in Edit or Play mode. dryRun previews without clearing. A real call reads the count before the effect, invokes LogEntries.Clear once, and succeeds only after fresh GetCount readback reaches zero.", Group = "console",DestructiveHint = false, SupportsDryRun = true, SideEffects = new[] { "editor-console-state" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Preview clearing the Console", Input = new Request { }, Execution = new ToolExampleExecution { DryRun = true } } } };
         public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
             var dryRun = ctx.DryRun;
@@ -26,12 +26,13 @@ namespace UnityCli
             var getCountMethod = logEntriesType.GetMethod("GetCount", BindingFlags.Static | BindingFlags.Public | BindingFlags.NonPublic);
             if (clearMethod == null || getCountMethod == null)
                 throw new UnityCliBridge.BridgeCommandException("E_CONSOLE_CLEAR_UNSUPPORTED", "UnityEditor.LogEntries.Clear or GetCount is unavailable.", "Use a Unity Editor version that exposes Console log entry controls.");
+            var previousCount = Convert.ToInt32(getCountMethod.Invoke(null, null));
             ctx.CommitEffect();
             clearMethod.Invoke(null, null);
-            var count = Convert.ToInt32(getCountMethod.Invoke(null, null));
-            if (count != 0)
-                throw new UnityCliBridge.BridgeCommandException("E_CONSOLE_CLEAR_STATE_MISMATCH", "Unity Console still contains " + count + " entries after clearing.", "Inspect the Unity Console and retry.");
-            return new System.Threading.Tasks.ValueTask<Result>(new Result { DryRun = false, Cleared = true, PlannedEffects = new List<EditorPlannedEffect> { new EditorPlannedEffect { Type = "console.clear" } } });
+            var remainingCount = Convert.ToInt32(getCountMethod.Invoke(null, null));
+            if (remainingCount != 0)
+                throw new UnityCliBridge.BridgeCommandException("E_CONSOLE_CLEAR_STATE_MISMATCH", "Unity Console still contains " + remainingCount + " entries after clearing.", "Inspect the Unity Console and retry.");
+            return new System.Threading.Tasks.ValueTask<Result>(new Result { DryRun = false, Cleared = true, PreviousCount = previousCount, RemainingCount = remainingCount, PlannedEffects = new List<EditorPlannedEffect> { new EditorPlannedEffect { Type = "console.clear" } } });
         }
     }
 }

package/unitypkg/Editor/Tools/console/get.cs

@@ -1,27 +1,59 @@
 #if UNITY_EDITOR
-using System;
 using System.Collections.Generic;
-using System.Linq;
-using System.Reflection;
-using UnityEditor;
-using UnityEditor.Compilation;
-using UnityEngine;
 
 namespace UnityCli
 {
-    /// <summary>console.get — 读取 Console 日志(支持过滤和分页)。</summary>
+    /// <summary>console.get — 按稳定 raw Console 位置执行有界过滤与续页。</summary>
     public class ConsoleGetTool : IUnityCliTool<ConsoleGetTool.Request, ConsoleGetTool.Result>
     {
-        public sealed class Request { public string Type { get; set; } public string Filter { get; set; } public int? Count { get; set; } public int? Cursor { get; set; } }
-        public sealed class Result { public List<ConsoleEntry> Items { get; set; } public PageInfo PageInfo { get; set; } }
-        public ToolDescriptor Describe() => new() { Name = "console.get", Summary = "Read Unity Console entries with type filter, text search, and cursor paging.", Description = "Read Console entries newest-first. type filters by error/warning/log. filter does case-insensitive text search. cursor for pagination.", Group = "console",DestructiveHint = false, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Read errors", Input = new Request { Type = "error", Count = 10 } } } };
-        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        public sealed class Request
         {
-            var count = Math.Max(1, Math.Min(r.Count ?? 50, 500));
-            var cursor = Math.Max(0, r.Cursor ?? 0);
-            var items = EditorToolSupport.ReadConsoleEntries(r.Type, r.Filter, count + cursor);
-            var paged = items.Skip(cursor).Take(count).ToList();
-            return new System.Threading.Tasks.ValueTask<Result>(new Result { Items = paged, PageInfo = new PageInfo { PageSize = count, Cursor = cursor, Total = items.Count, NextCursor = cursor + paged.Count < items.Count ? (long?)(cursor + paged.Count) : null } });
+            [UnityCliStringEnum("all", "error", "warning", "assert", "log")]
+            public string Type { get; set; }
+            public string Filter { get; set; }
+            [UnityCliRange(1L, 500L)] public int? Count { get; set; }
+            public UnityCliReadBudgetInput Budget { get; set; }
+        }
+
+        public sealed class Result
+        {
+            [UnityCliItemsRange(0, 500)] public List<ConsoleEntry> Items { get; set; }
+            public long RawEntryCount { get; set; }
+            public bool Truncated { get; set; }
+            public string Note { get; set; }
+            public UnityCliRequestBudgetUsage Budget { get; set; }
+        }
+
+        public ToolDescriptor Describe() => new()
+        {
+            Name = "console.get",
+            Summary = "Read one bounded, non-resumable Unity Console snapshot under request-wide limits.",
+            Description = "Read Console entries newest-first from one Unity snapshot window without materializing the Console. count defaults to 50 and is limited to 1..500. Filtering advances over raw positions and every entry uses the shared scan/reflection/getter/main-thread/UTF-8 budget. Unity exposes no reliable generation covering external Console clear/rebuild, so this tool intentionally has no cursor; truncated=true means start a fresh snapshot with a larger count or budget. rawEntryCount is Unity's raw count, not a filtered total. Read-only in Edit and Play Mode.",
+            Group = "console",
+            DestructiveHint = false,
+            Target = "editor",
+            PlayModeSupport = "supported",
+            DefaultTimeoutMs = 30000,
+            MaxTimeoutMs = 600000,
+            Examples = new[]
+            {
+                new ToolExample { Description = "Read a bounded error page", Input = new Request { Type = "error", Count = 50 } }
+            }
+        };
+
+        public System.Threading.Tasks.ValueTask<Result> ExecuteAsync(Request request, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
+        {
+            request = request ?? new Request();
+            var pageSize = request.Count ?? 50;
+            var page = EditorToolSupport.ReadConsolePage(request.Type, request.Filter, pageSize, ctx.UseReadBudget(request.Budget));
+            return new System.Threading.Tasks.ValueTask<Result>(new Result
+            {
+                Items = page.Items,
+                RawEntryCount = page.RawEntryCount,
+                Truncated = page.Truncated,
+                Note = page.Note,
+                Budget = page.Budget
+            });
         }
     }
 }

package/unitypkg/Editor/Tools/editor/EditorToolSupport.cs

@@ -45,48 +45,129 @@ namespace UnityCli
             };
         }
 
-        /// <summary>读取 Console 日志条目;Unity 2022 通过内部 LogEntries 反射读取。</summary>
-        public static List<ConsoleEntry> ReadConsoleEntries(string typeFilter, string textFilter, int count)
+        /// <summary>在 Unity 固定读取窗口中按 raw index 扫描；外部 clear 无可靠 generation，因此截断明确不可续页。</summary>
+        public static ConsoleReadPage ReadConsolePage(string typeFilter, string textFilter, int pageSize, UnityCliRequestBudget budget)
         {
-            var entries = new List<ConsoleEntry>();
-            var entryType = FindType("UnityEditor.LogEntry");
-            var logEntries = FindType("UnityEditor.LogEntries");
-            var getEntry = logEntries == null ? null : logEntries.GetMethod("GetEntryInternal", BindingFlags.Static | BindingFlags.Public | BindingFlags.NonPublic);
-            if (entryType == null || getEntry == null)
+            if (budget == null) throw new ArgumentNullException("budget");
+            budget.CheckpointOrThrow();
+            var entryType = FindConsoleType("UnityEditor.LogEntry", budget);
+            var logEntries = FindConsoleType("UnityEditor.LogEntries", budget);
+            if (entryType == null || logEntries == null)
             {
-                return entries;
+                if (budget.IsExhausted) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+                return ConsoleReadPage.Empty(budget.Usage());
             }
-
+            const BindingFlags flags = BindingFlags.Static | BindingFlags.Public | BindingFlags.NonPublic;
+            if (!budget.TryConsumeReflectionCall()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+            var getEntry = logEntries.GetMethod("GetEntryInternal", flags);
+            if (!budget.TryConsumeReflectionCall()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+            var start = logEntries.GetMethod("StartGettingEntries", flags);
+            if (!budget.TryConsumeReflectionCall()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+            var end = logEntries.GetMethod("EndGettingEntries", flags);
+            if (getEntry == null || start == null || end == null)
+                throw new UnityCliBridge.BridgeCommandException("E_CONSOLE_API_UNAVAILABLE", "Unity Console snapshot methods are unavailable in this Editor generation.", "Use a supported Unity Editor version.");
+            var fields = ConsoleFields.Create(entryType, budget);
             var entry = Activator.CreateInstance(entryType);
-            var total = ConsoleEntryCount(logEntries);
-            var max = Math.Max(1, Math.Min(count > 0 ? count : 50, 1000));
+            if (!budget.TryConsumeGetter() || !budget.TryConsumeReflectionCall()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+            var rawCount = Convert.ToInt32(start.Invoke(null, null), CultureInfo.InvariantCulture);
+            try
+            {
+                return ReadConsolePage(typeFilter, textFilter, pageSize, budget,
+                    new ReflectionConsoleSnapshotAdapter(rawCount, getEntry, entry, fields));
+            }
+            finally
+            {
+                try { end.Invoke(null, null); }
+                catch (Exception exception)
+                {
+                    throw new UnityCliBridge.BridgeCommandException("E_CONSOLE_SNAPSHOT_CLOSE_FAILED", "Unity Console snapshot could not be closed: " + exception.GetType().Name + ".", "Retry after the Editor Console becomes available.");
+                }
+            }
+        }
+
+        /// <summary>生产分页核心只按raw index读取当前项，不复制完整Console集合。</summary>
+        internal static ConsoleReadPage ReadConsolePage(
+            string typeFilter,
+            string textFilter,
+            int pageSize,
+            UnityCliRequestBudget budget,
+            IConsoleSnapshotAdapter snapshot)
+        {
+            if (budget == null) throw new ArgumentNullException("budget");
+            if (snapshot == null) throw new ArgumentNullException("snapshot");
+            if (pageSize <= 0) throw new ArgumentOutOfRangeException("pageSize");
+            var rawCount = snapshot.Count;
+            var scanIndex = rawCount - 1;
+            var items = new List<ConsoleEntry>(Math.Min(pageSize, rawCount));
             var includeAllTypes = string.IsNullOrEmpty(typeFilter) || string.Equals(typeFilter, "all", StringComparison.OrdinalIgnoreCase);
-            for (var i = total - 1; i >= 0 && entries.Count < max; i--)
+            while (scanIndex >= 0 && items.Count < pageSize)
             {
-                getEntry.Invoke(null, new object[] { i, entry });
-                var mode = Convert.ToInt32(entryType.GetField("mode", BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic).GetValue(entry), CultureInfo.InvariantCulture);
-                var logType = ConsoleLevel(mode);
-                if (!includeAllTypes && !string.Equals(logType, typeFilter, StringComparison.OrdinalIgnoreCase)) continue;
-                var message = Convert.ToString(entryType.GetField("message", BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic).GetValue(entry), CultureInfo.InvariantCulture) ?? "";
-                var file = Convert.ToString(entryType.GetField("file", BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic).GetValue(entry), CultureInfo.InvariantCulture) ?? "";
+                ConsoleEntry item;
+                if (!snapshot.TryRead(scanIndex, budget, out item)) break;
+                scanIndex--;
+                if (!includeAllTypes && !string.Equals(item.Type, typeFilter, StringComparison.OrdinalIgnoreCase)) continue;
                 if (!string.IsNullOrEmpty(textFilter)
-                    && message.IndexOf(textFilter, StringComparison.OrdinalIgnoreCase) < 0
-                    && file.IndexOf(textFilter, StringComparison.OrdinalIgnoreCase) < 0) continue;
-                entries.Add(new ConsoleEntry { Type = logType, Message = message, Count = 1 });
+                    && item.Message.IndexOf(textFilter, StringComparison.OrdinalIgnoreCase) < 0
+                    && item.File.IndexOf(textFilter, StringComparison.OrdinalIgnoreCase) < 0) continue;
+                if (!budget.TryReserveSerializedUtf8(item.Message) || !budget.TryReserveSerializedUtf8(item.File)) break;
+                items.Add(item);
             }
-            return entries;
+            if (items.Count == 0 && rawCount > 0 && budget.IsExhausted)
+                throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension ?? "scannedRecords");
+            var truncated = scanIndex >= 0;
+            return new ConsoleReadPage
+            {
+                Items = items,
+                RawEntryCount = rawCount,
+                Truncated = truncated,
+                Note = truncated ? "Snapshot truncated; Console entries are intentionally non-resumable because Unity exposes no observable external clear generation." : null,
+                Budget = budget.Usage()
+            };
+        }
+
+        internal interface IConsoleSnapshotAdapter
+        {
+            int Count { get; }
+            bool TryRead(int rawIndex, UnityCliRequestBudget budget, out ConsoleEntry result);
         }
 
-        private static int ConsoleEntryCount(Type logEntries)
+        private sealed class ReflectionConsoleSnapshotAdapter : IConsoleSnapshotAdapter
         {
-            var method = logEntries == null ? null : logEntries.GetMethod("GetCount", BindingFlags.Static | BindingFlags.Public | BindingFlags.NonPublic);
-            return method == null ? 0 : Convert.ToInt32(method.Invoke(null, null), CultureInfo.InvariantCulture);
+            private readonly MethodInfo getEntry;
+            private readonly object target;
+            private readonly ConsoleFields fields;
+
+            internal ReflectionConsoleSnapshotAdapter(int count, MethodInfo getEntry, object target, ConsoleFields fields)
+            {
+                Count = count;
+                this.getEntry = getEntry;
+                this.target = target;
+                this.fields = fields;
+            }
+
+            public int Count { get; private set; }
+
+            public bool TryRead(int rawIndex, UnityCliRequestBudget budget, out ConsoleEntry result)
+            {
+                result = null;
+                if (!budget.TryConsumeScannedRecord() || !budget.TryConsumeReflectionCall()) return false;
+                getEntry.Invoke(null, new object[] { rawIndex, target });
+                if (!budget.TryConsumeGetter() || !budget.TryConsumeReflectionCall()) return false;
+                var mode = Convert.ToInt32(fields.Mode.GetValue(target), CultureInfo.InvariantCulture);
+                if (!budget.TryConsumeGetter() || !budget.TryConsumeReflectionCall()) return false;
+                var message = Convert.ToString(fields.Message.GetValue(target), CultureInfo.InvariantCulture) ?? string.Empty;
+                if (!budget.TryConsumeGetter() || !budget.TryConsumeReflectionCall()) return false;
+                var file = Convert.ToString(fields.File.GetValue(target), CultureInfo.InvariantCulture) ?? string.Empty;
+                result = new ConsoleEntry { RawIndex = rawIndex, Type = ConsoleLevel(mode), Message = message, File = file, Count = 1L };
+                return true;
+            }
         }
 
-        private static Type FindType(string fullName)
+        private static Type FindConsoleType(string fullName, UnityCliRequestBudget budget)
         {
-            foreach (var assembly in AppDomain.CurrentDomain.GetAssemblies())
+            foreach (var assembly in UnityCliAssemblySnapshot.Get(budget))
             {
+                if (!budget.TryConsumeReflectionCall()) return null;
                 Type type = null;
                 try { type = assembly.GetType(fullName, false); } catch { }
                 if (type != null) return type;
@@ -94,6 +175,27 @@ namespace UnityCli
             return null;
         }
 
+        private sealed class ConsoleFields
+        {
+            internal FieldInfo Mode;
+            internal FieldInfo Message;
+            internal FieldInfo File;
+
+            internal static ConsoleFields Create(Type entryType, UnityCliRequestBudget budget)
+            {
+                const BindingFlags flags = BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic;
+                if (!budget.TryConsumeReflectionCall()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+                var mode = entryType.GetField("mode", flags);
+                if (!budget.TryConsumeReflectionCall()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+                var message = entryType.GetField("message", flags);
+                if (!budget.TryConsumeReflectionCall()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+                var file = entryType.GetField("file", flags);
+                if (mode == null || message == null || file == null) throw new UnityCliBridge.BridgeCommandException("E_CONSOLE_API_UNAVAILABLE", "Unity Console entry fields are unavailable in this Editor generation.", "Use a supported Unity Editor version.");
+                return new ConsoleFields { Mode = mode, Message = message, File = file };
+            }
+        }
+
+
         // Unity 2022 LogEntry.mode 位布局：kError=1, kAssert=2, kLog=4, kFatal=16, kAssetImportError=64,
         // kAssetImportWarning=128, kScriptingError=256, kScriptingWarning=512, kScriptingException=2048, kScriptingAssertion=4096。
         // 错误/警告/断言来自多个位（脚本与资源导入各有独立位），只查低 3 位会把全部条目误归为 log。
@@ -123,7 +225,20 @@ namespace UnityCli
     public sealed class PlayModeInfo { public bool IsPlaying { get; set; } public bool IsPaused { get; set; } public bool IsPlayingOrWillChangePlaymode { get; set; } }
     public sealed class BusyInfo { public bool IsBusy { get; set; } public bool Compiling { get; set; } public bool Updating { get; set; } public bool Building { get; set; } public bool PlayModeChanging { get; set; } }
     public sealed class ActiveSceneInfo { public string Name { get; set; } public string Path { get; set; } public bool IsLoaded { get; set; } public bool IsDirty { get; set; } }
-    public sealed class ConsoleEntry { public string Type { get; set; } public string Message { get; set; } public long Count { get; set; } }
+    public sealed class ConsoleEntry { public long RawIndex { get; set; } public string Type { get; set; } public string Message { get; set; } public string File { get; set; } public long Count { get; set; } }
+    public sealed class ConsoleReadPage
+    {
+        public List<ConsoleEntry> Items { get; set; }
+        public long RawEntryCount { get; set; }
+        public bool Truncated { get; set; }
+        public string Note { get; set; }
+        public UnityCliRequestBudgetUsage Budget { get; set; }
+
+        internal static ConsoleReadPage Empty(UnityCliRequestBudgetUsage usage)
+        {
+            return new ConsoleReadPage { Items = new List<ConsoleEntry>(), RawEntryCount = 0L, Truncated = false, Budget = usage };
+        }
+    }
     public sealed class EditorPlannedEffect { public string Type { get; set; } public string Path { get; set; } public string Action { get; set; } public string Name { get; set; } }
     public sealed class PlayModeResult { public bool Changed { get; set; } public bool IsPlaying { get; set; } public bool IsPaused { get; set; } }
     public sealed class MenuResult { public string Path { get; set; } public bool Executed { get; set; } public long ElapsedMs { get; set; } }

package/unitypkg/Editor/Tools/editor/menu-items.cs

@@ -26,7 +26,7 @@ namespace UnityCli.Tools.Editor
             Name = "editor.menu-items",
             Summary = "Report Editor menu enumeration availability without executing menus.",
             Description = "Attempt to enumerate Unity Editor menu items as read-only discovery. Unity has no stable public API for full menu enumeration, so this context may return an empty items array with diagnostics; executing a menu path remains the destructive Tool editor.menu.",
-            DestructiveHint = false,
+            DestructiveHint = false,
             Group = "editor",
             Target = "editor",
             PlayModeSupport = "supported",

package/unitypkg/Editor/Tools/editor/play.cs

@@ -15,17 +15,8 @@ namespace UnityCli
         public ToolDescriptor Describe() => new() { Name = "editor.play", Summary = "Enter Unity Play Mode and return only after the Editor reaches a stable playing state.", Description = "Set EditorApplication.isPlaying=true, absorb the PlayMode transition or same-session reload, and return the stable Editor state. Success proves isPlaying=true and the central PlayMode transition flag is false.", Group = "editor",DestructiveHint = false, SideEffects = new[] { "session-affecting" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Enter play mode", Input = new Request { } } } };
         public async System.Threading.Tasks.ValueTask<Response> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
-            // before 采集一次后按 requestId 存 SessionState：PlayMode 过渡触发 domain reload，
-            // 同一请求重跑时 before 必须仍是第一次 effect 前的值，Changed 语义才跨 reload 成立。
-            var beforeKey = "unity-cli.play.before." + ctx.RequestId;
-            var rawBefore = SessionState.GetString(beforeKey, null);
-            bool before;
-            if (string.IsNullOrEmpty(rawBefore))
-            {
-                before = EditorApplication.isPlaying;
-                SessionState.SetString(beforeKey, before ? "1" : "0");
-            }
-            else before = rawBefore == "1";
+            // 首次effect前状态由固定direct root持久化；Tool重入不再创建逐请求SessionState键。
+            var before = EditorApplication.isPlaying;
             EditorToolSupport.EnsureEditorNotBusy("editor.play");
             ctx.CommitEffect();
             EditorApplication.isPaused = false;

package/unitypkg/Editor/Tools/editor/selection.cs

@@ -54,7 +54,7 @@ namespace UnityCli
             {
                 Name = "editor.selection", Summary = "Read current Editor selection names and reusable object references without changing selection.",
                 Description = "Read the current Unity Editor selection in Hierarchy or Project Browser. Returns name arrays plus reusable object details: instanceId, type, asset path/GUID, hierarchy path, GameObject reference, transform, and component summaries. It does not select, focus, ping, or modify anything.",
-                DestructiveHint = false,
+                DestructiveHint = false,
                 Group = "editor", Target = "editor", PlayModeSupport = "supported",
                 Examples = new[] { new ToolExample { Description = "Read the current selection", Input = new Request { } } }
             };

package/unitypkg/Editor/Tools/editor/stop.cs

@@ -15,17 +15,8 @@ namespace UnityCli
         public ToolDescriptor Describe() => new() { Name = "editor.stop", Summary = "Exit Unity Play Mode and return only after the Editor reaches stable Edit Mode.", Description = "Set EditorApplication.isPlaying=false, absorb the PlayMode transition or same-session reload, and return the stable Editor state. Success proves isPlaying=false and the central PlayMode transition flag is false.", Group = "editor",DestructiveHint = false, SideEffects = new[] { "session-affecting" }, Target = "editor", PlayModeSupport = "supported", DefaultTimeoutMs = 30000, MaxTimeoutMs = 600000, Examples = new[] { new ToolExample { Description = "Exit play mode", Input = new Request { } } } };
         public async System.Threading.Tasks.ValueTask<Response> ExecuteAsync(Request r, UnityCliProjectToolContext ctx, System.Threading.CancellationToken ct = default)
         {
-            // before 采集一次后按 requestId 存 SessionState：PlayMode 过渡触发 domain reload，
-            // 同一请求重跑时 before 必须仍是第一次 effect 前的值，Changed 语义才跨 reload 成立。
-            var beforeKey = "unity-cli.stop.before." + ctx.RequestId;
-            var rawBefore = SessionState.GetString(beforeKey, null);
-            bool before;
-            if (string.IsNullOrEmpty(rawBefore))
-            {
-                before = EditorApplication.isPlaying;
-                SessionState.SetString(beforeKey, before ? "1" : "0");
-            }
-            else before = rawBefore == "1";
+            // 首次effect前状态由固定direct root持久化；Tool重入不再创建逐请求SessionState键。
+            var before = EditorApplication.isPlaying;
             EditorToolSupport.EnsureEditorNotBusy("editor.stop");
             ctx.CommitEffect();
             EditorApplication.isPaused = false;

package/unitypkg/Editor/Tools/editor/windows.cs

@@ -41,7 +41,7 @@ namespace UnityCli.Tools.Editor
         {
             Name = "editor.windows", Summary = "Read currently open Unity EditorWindow instances with title, type names, focused state, and instance IDs.",
             Description = "Read currently open Unity EditorWindow instances with title, type names, focused state, and instance IDs. This observes editor UI state without opening, closing, focusing, or moving windows.",
-            DestructiveHint = false,
+            DestructiveHint = false,
             Group = "editor",
             Target = "editor",
             PlayModeSupport = "supported",

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

@@ -34,8 +34,8 @@ namespace UnityCli
         {
             var options = new UnityCliBridge.ObjectSerializer.Options
             {
-                MaxDepth = request.MaxDepth ?? 4,
-                MaxArrayItems = Math.Max(0, Math.Min(request.MaxArrayItems ?? 50, 1000)),
+                MaxDepth = request.MaxDepth ?? UnityCliBridge.ObjectSerializer.DefaultMaxDepth,
+                MaxArrayItems = request.MaxArrayItems ?? UnityCliBridge.ObjectSerializer.DefaultMaxArrayItems,
                 IncludeFields = request.IncludeFields ?? true,
                 IncludeProperties = request.IncludeProperties ?? true,
                 DeepSerialization = request.DeepSerialization ?? true
@@ -46,7 +46,7 @@ namespace UnityCli
             }
             if (request.Paths != null)
             {
-                options.Paths = new HashSet<string>(request.Paths.Where(path => !string.IsNullOrWhiteSpace(path)).Select(path => path.Trim()));
+                options.Paths = request.Paths.Where(path => !string.IsNullOrWhiteSpace(path)).Select(path => path.Trim()).ToList();
             }
             var query = request.ViewQuery as Dictionary<string, object>;
             if (query != null)
@@ -55,7 +55,7 @@ namespace UnityCli
                 if (query.TryGetValue("path", out value)) options.ViewPath = value as string;
                 if (query.TryGetValue("namePattern", out value)) options.NamePattern = value as string;
                 if (query.TryGetValue("typeFilter", out value)) options.TypeFilter = value as string;
-                if (query.TryGetValue("maxDepth", out value) && value != null) options.MaxDepth = Math.Max(0, Convert.ToInt32(value, CultureInfo.InvariantCulture));
+                if (query.TryGetValue("maxDepth", out value) && value != null) options.MaxDepth = UnityCliBridge.ObjectSerializer.ParseMaxDepth(value);
             }
             if (!string.IsNullOrEmpty(request.NamePattern))
             {
@@ -117,6 +117,17 @@ namespace UnityCli
             return new GameObjectRef { Id = gameObject.GetInstanceID(), Name = gameObject.name, Path = HierarchyPath(gameObject) };
         }
 
+        /// <summary>在同一请求预算内构造 GameObject 引用，祖先每一步都在读取前计费。</summary>
+        public static GameObjectRef BuildGameObjectRef(GameObject gameObject, UnityCliRequestBudget budget)
+        {
+            if (budget == null) throw new ArgumentNullException("budget");
+            if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+            var id = gameObject.GetInstanceID();
+            if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+            var name = gameObject.name;
+            return new GameObjectRef { Id = id, Name = name, Path = HierarchyPath(gameObject, budget) };
+        }
+
         /// <summary>构造 Transform 摘要(position/rotation/scale)。</summary>
         public static TransformInfo BuildTransformInfo(Transform transform)
         {
@@ -145,6 +156,16 @@ namespace UnityCli
             return property == null || (bool)property.GetValue(component, null);
         }
 
+        /// <summary>在反射和 getter 前计费后读取 enabled；没有该属性的组件视为启用。</summary>
+        public static bool ComponentEnabled(Component component, UnityCliRequestBudget budget)
+        {
+            if (!budget.TryConsumeReflectionCall()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+            var property = component.GetType().GetProperty("enabled", BindingFlags.Instance | BindingFlags.Public);
+            if (property == null) return true;
+            if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+            return (bool)property.GetValue(component, null);
+        }
+
         /// <summary>构造 GameObject 详情(id/name/path/active/tag/layer/transform/components/children)。</summary>
         public static GameObjectDetail BuildGameObjectDetail(GameObject gameObject)
         {
@@ -222,6 +243,24 @@ namespace UnityCli
             return string.Join("/", names.ToArray());
         }
 
+        /// <summary>祖先链逐步读取并收取 scan/getter/UTF-8 预算。</summary>
+        public static string HierarchyPath(GameObject gameObject, UnityCliRequestBudget budget)
+        {
+            if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+            var names = new Stack<string>();
+            var current = gameObject.transform;
+            while (current != null)
+            {
+                if (!budget.TryConsumeScannedRecord() || !budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+                var name = current.name;
+                if (!budget.TryReserveSerializedUtf8(name)) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+                names.Push(name);
+                if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+                current = current.parent;
+            }
+            return string.Join("/", names.ToArray());
+        }
+
         // ─── 向量解析 ──────────────────────────────────────────────────────
 
         public static Vector3 ParseVector3(string value)
@@ -299,6 +338,17 @@ namespace UnityCli
             return null;
         }
 
+        /// <summary>读取型搜索只尝试 exact/full Unity namespaces，避免为短名调用 Assembly.GetTypes 全量扫描。</summary>
+        public static Type ResolveComponentType(string componentName, UnityCliRequestBudget budget)
+        {
+            var type = UnityCliBridge.TypeSchemaGenerator.ResolveType(componentName, budget)
+                ?? UnityCliBridge.TypeSchemaGenerator.ResolveType("UnityEngine." + componentName, budget)
+                ?? UnityCliBridge.TypeSchemaGenerator.ResolveType("UnityEngine.UI." + componentName, budget);
+            if (type == null || !typeof(Component).IsAssignableFrom(type))
+                throw new UnityCliBridge.BridgeCommandException("E_COMPONENT_TYPE_NOT_FOUND", "Component type not found within the bounded exact namespaces: " + componentName, "Pass a full component type name.");
+            return type;
+        }
+
         /// <summary>按短名、FullName 或 UnityEngine namespace 名解析 Component Type。</summary>
         public static Type ResolveComponentType(string componentName)
         {

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

@@ -72,7 +72,7 @@ namespace UnityCli
                         { "target", targetRef.Path },
                         { "instanceId", targetRef.Id }
                     },
-                    new[] { "Run tools run go.inspect for the target and inspect the Unity Console before retrying." });
+                    new[] { "Run tools run scene.gameobject for the target and inspect console.get before retrying." });
             }
             UnityCliSceneMutation.MarkSceneDirty(scene);
             return new System.Threading.Tasks.ValueTask<Result>(new Result