@alpsckr/unitycli 0.4.2 → 0.4.4

package/unitypkg/Editor/Infrastructure/UnityCliLiveRefreshCoordinator.cs

@@ -1,10 +1,7 @@
 #if UNITY_EDITOR
 using System;
 using System.Collections.Generic;
-using System.Globalization;
 using System.IO;
-using System.Linq;
-using System.Text;
 using System.Threading;
 using System.Threading.Tasks;
 using UnityEditor;
@@ -14,7 +11,7 @@ namespace UnityCli
 {
     public static partial class UnityCliBridge
     {
-        /// <summary>editor.refresh 的单 scope 进行中操作协调器（统一骨架收编）。</summary>
+        /// <summary>editor.refresh 的单 scope durable operation；proof 只使用 Unity-owned artifact generations。</summary>
         internal static class UnityCliLiveRefreshCoordinator
         {
             private static readonly Coordinator Instance = new Coordinator();
@@ -24,7 +21,7 @@ namespace UnityCli
             internal static Task<string> Execute(BridgeRequest request, byte[] raw, Func<bool> accept, CancellationToken ct) { return Instance.Execute(request, raw, accept, ct); }
             internal static void Initialize() { }
             internal static void Shutdown() { }
-            internal static void BeforeReload() { Instance.Update(x => x["reloadObserved"] = true); }
+            internal static void BeforeReload() { Instance.Update(root => root["reloadObserved"] = true); }
             internal static void Tick() { Instance.Tick(); }
 
             private sealed class Coordinator : UnityCliReloadOperation
@@ -34,9 +31,10 @@ namespace UnityCli
                 protected override string StatusCommand { get { return "internal.editor.refresh.status"; } }
                 protected override string OperationDisplayName { get { return "Refresh"; } }
                 protected override bool IncludeAcceptedInStatus { get { return true; } }
-                protected override string SessionChangedMessage { get { return "Refresh result cannot be confirmed after the Editor session changed; check the business state."; } }
-                protected override string DeadlineMessage { get { return "Refresh did not reach a confirmed terminal state before the deadline; check the business state."; } }
+                protected override string SessionChangedMessage { get { return "Refresh result cannot be confirmed after the Editor session changed; inspect editor.state and asset state."; } }
+                protected override string DeadlineMessage { get { return "Refresh did not reach a confirmed terminal state before the shared deadline; inspect editor.state and asset state."; } }
                 protected override object DeserializeStartArgs(BridgeRequest request) { return request.DeserializeArgs<Args>(); }
+
                 protected override void ValidateStart(object value)
                 {
                     var args = (Args)value;
@@ -44,37 +42,39 @@ namespace UnityCli
                     if (!string.Equals(args.ExpectedEditorSessionId, EditorSessionId(), StringComparison.Ordinal)) throw new BridgeCommandException("E_EDITOR_SESSION_REPLACED", "The selected Editor session changed before refresh execution.");
                     if (EditorApplication.isPlaying || IsPlayModeChanging()) throw new BridgeCommandException("E_TOOL_PLAYMODE_UNAVAILABLE", "editor.refresh is editor-only and requires stable Edit Mode.");
                 }
+
                 protected override void ValidateLoadedRoot(Dictionary<string, object> root)
                 {
-                    ValidateRootContract(root, new[] { "compile", "compilationRequested", "compilationObserved", "compilePhase", "compileDispatchSequence", "compileStartedSequence", "compileFinishedSequence", "compileStartedCycle", "compileDiagnostics", "compileErrorCount", "compileWarningCount", "compileInfoCount", "compileDiagnosticsTruncated", "stableFrames", "beforeSourceFingerprint", "beforeDependencyVersion", "reloadObserved", "rootContractDigest" },
-                        "queued", "prepared", "dispatching", "refresh_returned", "waiting_stable");
+                    ValidateRootContract(root, new[]
+                    {
+                        "compile", "compilationRequested", "compilationObserved", "compilePhase", "compileDispatchSequence", "compileStartedSequence", "compileFinishedSequence", "compileStartedCycle",
+                        "compileDiagnostics", "compileErrorCount", "compileWarningCount", "compileInfoCount", "compileDiagnosticsTruncated", "stableFrames",
+                        "beforeDependencyGeneration", "beforeProcessedGeneration", "importObserved", "reloadObserved", "rootContractDigest"
+                    }, "queued", "prepared", "dispatching", "refresh_returned", "waiting_stable");
                     object compile; object requested; object observed; object diagnostics; object errorCount; object warningCount; object infoCount; object truncated; object stableFrames;
                     if (!root.TryGetValue("compile", out compile) || !(compile is bool)
                         || !root.TryGetValue("compilationRequested", out requested) || !(requested is bool)
                         || !root.TryGetValue("compilationObserved", out observed) || !(observed is bool)
                         || !root.TryGetValue("compileDiagnostics", out diagnostics) || !(diagnostics is List<object>)
-                        || !root.TryGetValue("compileErrorCount", out errorCount) || !(errorCount is long) || (long)errorCount < 0 || (long)errorCount > 1000000
-                        || !root.TryGetValue("compileWarningCount", out warningCount) || !(warningCount is long) || (long)warningCount < 0 || (long)warningCount > 1000000
-                        || !root.TryGetValue("compileInfoCount", out infoCount) || !(infoCount is long) || (long)infoCount < 0 || (long)infoCount > 1000000
-                        || !root.TryGetValue("compileDiagnosticsTruncated", out truncated) || !(truncated is long) || (long)truncated < 0 || (long)truncated > 1000000
-                        || !root.TryGetValue("stableFrames", out stableFrames) || !(stableFrames is long) || (long)stableFrames < 0
-                        || !IsSha256(Text(root, "beforeSourceFingerprint")) || !IsSha256(Text(root, "beforeDependencyVersion")))
+                        || !root.TryGetValue("compileErrorCount", out errorCount) || !(errorCount is long) || (long)errorCount < 0L || (long)errorCount > 1000000L
+                        || !root.TryGetValue("compileWarningCount", out warningCount) || !(warningCount is long) || (long)warningCount < 0L || (long)warningCount > 1000000L
+                        || !root.TryGetValue("compileInfoCount", out infoCount) || !(infoCount is long) || (long)infoCount < 0L || (long)infoCount > 1000000L
+                        || !root.TryGetValue("compileDiagnosticsTruncated", out truncated) || !(truncated is long) || (long)truncated < 0L || (long)truncated > 1000000L
+                        || !root.TryGetValue("stableFrames", out stableFrames) || !(stableFrames is long) || (long)stableFrames < 0L
+                        || !(root["beforeDependencyGeneration"] is long) || (long)root["beforeDependencyGeneration"] < 0L
+                        || !(root["beforeProcessedGeneration"] is long) || (long)root["beforeProcessedGeneration"] < 0L
+                        || !(root["importObserved"] is bool))
                         throw new InvalidDataException("Refresh active root fields are invalid.");
-                    if (!string.Equals(Text(root, "rootContractDigest"), RefreshRootContractDigest(root), StringComparison.Ordinal))
-                        throw new InvalidDataException("Refresh immutable root contract changed.");
+                    if (!string.Equals(Text(root, "rootContractDigest"), RefreshRootContractDigest(root), StringComparison.Ordinal)) throw new InvalidDataException("Refresh immutable root contract changed.");
                     UnityCliCompileCoordinator.ValidateBoundedDiagnostics(root, "compileDiagnostics", "compileErrorCount", "compileWarningCount", "compileInfoCount", "compileDiagnosticsTruncated", true);
                     var compilePhase = Text(root, "compilePhase");
-                    if (Array.IndexOf(new[] { "idle", "dispatching", "awaiting_started", "compiling", "cycle_finished" }, compilePhase) < 0)
-                        throw new InvalidDataException("Refresh compile phase is invalid.");
+                    if (Array.IndexOf(new[] { "idle", "dispatching", "awaiting_started", "compiling", "cycle_finished" }, compilePhase) < 0) throw new InvalidDataException("Refresh compile phase is invalid.");
                     var refreshFenced = HasExactEffectFence("refresh", root, "refresh-dispatch");
                     var phase = Text(root, "phase");
-                    if ((phase == "queued" || phase == "prepared") == refreshFenced)
-                        throw new InvalidDataException("Refresh effect fence is inconsistent with phase.");
+                    if ((phase == "queued" || phase == "prepared") == refreshFenced) throw new InvalidDataException("Refresh effect fence is inconsistent with phase.");
                     var compileFenced = HasExactEffectFence("refresh", root, "compile-dispatch");
-                    if ((compilePhase == "idle") == compileFenced)
-                        throw new InvalidDataException("Refresh compile fence is inconsistent with phase.");
-                    if (Bool(root, "compilationObserved")
-                        && (Long(root, "compileStartedCycle") <= 0 || Long(root, "compileStartedSequence") <= Long(root, "compileDispatchSequence")))
+                    if ((compilePhase == "idle") == compileFenced) throw new InvalidDataException("Refresh compile fence is inconsistent with phase.");
+                    if (Bool(root, "compilationObserved") && (Long(root, "compileStartedCycle") <= 0L || Long(root, "compileStartedSequence") <= Long(root, "compileDispatchSequence")))
                         throw new InvalidDataException("Refresh compile attribution is invalid.");
                 }
 
@@ -82,7 +82,7 @@ namespace UnityCli
                 {
                     return UnityCliSerializer.Sha256Canonical(new Dictionary<string, object>
                     {
-                        { "compile", root["compile"] }, { "beforeSourceFingerprint", root["beforeSourceFingerprint"] }, { "beforeDependencyVersion", root["beforeDependencyVersion"] }
+                        { "compile", root["compile"] }, { "beforeDependencyGeneration", root["beforeDependencyGeneration"] }, { "beforeProcessedGeneration", root["beforeProcessedGeneration"] }
                     });
                 }
 
@@ -93,69 +93,103 @@ namespace UnityCli
                     if (args.Compile) effects.Add(new Dictionary<string, object> { { "type", "script-compile" } });
                     return new Dictionary<string, object> { { "dryRun", true }, { "plannedEffects", effects } };
                 }
+
                 protected override Dictionary<string, object> CreateRoot(BridgeRequest request, string digest, object value)
                 {
                     var args = (Args)value;
                     var before = CaptureProof();
-                    var root = new Dictionary<string, object> { { "requestId", request.RequestId }, { "editorSessionId", EditorSessionId() }, { "requestDigest", digest }, { "deadline", request.Execution.AbsoluteDeadlineUtc }, { "phase", "queued" }, { "compile", args.Compile }, { "compilationRequested", false }, { "compilationObserved", false }, { "compilePhase", "idle" }, { "compileDispatchSequence", 0L }, { "compileStartedSequence", 0L }, { "compileFinishedSequence", 0L }, { "compileStartedCycle", 0L }, { "compileDiagnostics", new List<object>() }, { "compileErrorCount", 0L }, { "compileWarningCount", 0L }, { "compileInfoCount", 0L }, { "compileDiagnosticsTruncated", 0L }, { "stableFrames", 0L }, { "beforeSourceFingerprint", before.SourceFingerprint }, { "beforeDependencyVersion", before.DependencyVersion } };
+                    var root = new Dictionary<string, object>
+                    {
+                        { "requestId", request.RequestId }, { "editorSessionId", EditorSessionId() }, { "requestDigest", digest }, { "deadline", request.Execution.AbsoluteDeadlineUtc },
+                        { "phase", "queued" }, { "compile", args.Compile }, { "compilationRequested", false }, { "compilationObserved", false }, { "compilePhase", "idle" },
+                        { "compileDispatchSequence", 0L }, { "compileStartedSequence", 0L }, { "compileFinishedSequence", 0L }, { "compileStartedCycle", 0L },
+                        { "compileDiagnostics", new List<object>() }, { "compileErrorCount", 0L }, { "compileWarningCount", 0L }, { "compileInfoCount", 0L }, { "compileDiagnosticsTruncated", 0L },
+                        { "stableFrames", 0L }, { "beforeDependencyGeneration", before.DependencyGeneration }, { "beforeProcessedGeneration", before.ProcessedGeneration },
+                        { "importObserved", false }, { "reloadObserved", false }
+                    };
                     root["rootContractDigest"] = RefreshRootContractDigest(root);
                     return root;
                 }
+
                 protected override void OnTick(Dictionary<string, object> root)
                 {
                     if (UnityCliCompilationEventBroker.SequenceCorrupt && Bool(root, "compile")) { Fail(root, "E_EXECUTION_TIMEOUT", "Refresh compilation event sequence is corrupt; attributed outcome is unknown."); return; }
                     var phase = Text(root, "phase");
-                    if (phase == "queued") { if (BusyEditor()) return; Update(x => x["phase"] = "prepared"); return; }
-                    if (phase == "prepared") { root = CrossEffectFence(root, "refresh-dispatch", "dispatching"); try { AssetDatabase.Refresh(); Update(x => x["phase"] = "refresh_returned"); } catch (Exception e) { Fail(root, "E_EXECUTION_TIMEOUT", "Refresh result cannot be confirmed: " + e.Message + "; check the business state."); } return; }
+                    if (phase != "queued" && phase != "prepared") ObserveImport(root);
+                    if (phase == "queued") { if (BusyEditor()) return; Update(value => value["phase"] = "prepared"); return; }
+                    if (phase == "prepared")
+                    {
+                        root = CrossEffectFence(root, "refresh-dispatch", "dispatching");
+                        try { AssetDatabase.Refresh(); Update(value => value["phase"] = "refresh_returned"); }
+                        catch (Exception exception) { Fail(root, "E_EXECUTION_TIMEOUT", "Refresh result cannot be confirmed: " + exception.Message + "; inspect asset state."); }
+                        return;
+                    }
                     if (phase == "refresh_returned")
                     {
-                        if (Bool(root, "compile") && !Bool(root, "compilationObserved") && !Bool(root, "compilationRequested")) { if (BusyEditor()) return; UnityCliCompileCoordinator.RequestRefreshCompilation(Text(root, "requestId"), Text(root, "requestDigest")); return; }
-                        Update(x => x["phase"] = "waiting_stable"); return;
+                        if (Bool(root, "compile") && !Bool(root, "compilationObserved") && !Bool(root, "compilationRequested"))
+                        {
+                            if (BusyEditor()) return;
+                            UnityCliCompileCoordinator.RequestRefreshCompilation(Text(root, "requestId"), Text(root, "requestDigest"));
+                            return;
+                        }
+                        Update(value => value["phase"] = "waiting_stable");
+                        return;
                     }
                     if (phase != "waiting_stable" || BusyEditor()) return;
-                    if (Bool(root, "compile") && (!Bool(root, "compilationObserved") || Text(root, "compilePhase") != "cycle_finished")) { Fail(root, "E_EXECUTION_TIMEOUT", "Refresh compilation result cannot be confirmed; check the business state."); return; }
-                    if (Long(root, "compileErrorCount") > 0)
+                    if (Bool(root, "compile") && (!Bool(root, "compilationObserved") || Text(root, "compilePhase") != "cycle_finished"))
+                    {
+                        Fail(root, "E_EXECUTION_TIMEOUT", "Refresh compilation result cannot be confirmed; inspect editor.state and compile diagnostics.");
+                        return;
+                    }
+                    if (Long(root, "compileErrorCount") > 0L)
                     {
                         var details = new Dictionary<string, object>
                         {
                             { "compile", new Dictionary<string, object> { { "completed", true }, { "errorCount", Long(root, "compileErrorCount") }, { "warningCount", Long(root, "compileWarningCount") }, { "status", "errors" }, { "diagnosticsTruncated", Long(root, "compileDiagnosticsTruncated") } } },
                             { "diagnostics", root["compileDiagnostics"] }
                         };
-                        Fail(root, "E_UNITY_COMPILE_FAILED", "Refresh compilation reported compiler errors.", details, new[] { "Fix the listed compiler diagnostics before retrying refresh." }); return;
+                        Fail(root, "E_UNITY_COMPILE_FAILED", "Refresh compilation reported compiler errors.", details, new[] { "Fix the listed compiler diagnostics before retrying refresh." });
+                        return;
                     }
-                    var frames = Long(root, "stableFrames") + 1; Update(x => x["stableFrames"] = frames); if (frames >= 3) Succeed(root);
+                    var frames = Long(root, "stableFrames") + 1L;
+                    Update(value => value["stableFrames"] = frames);
+                    if (frames >= 3L) Succeed(root);
                 }
+
                 protected override object BuildSuccessData(Dictionary<string, object> root)
                 {
                     var after = CaptureProof();
-                    var changed = !Same(Text(root, "beforeSourceFingerprint"), after.SourceFingerprint) || !Same(Text(root, "beforeDependencyVersion"), after.DependencyVersion);
+                    var changed = Long(root, "beforeDependencyGeneration") != after.DependencyGeneration || Long(root, "beforeProcessedGeneration") != after.ProcessedGeneration;
                     return new Dictionary<string, object>
                     {
-                        { "changed", changed }, { "compilationTriggered", Bool(root, "compilationObserved") },
-                        { "sourceFileCount", (long)after.Paths.Count }, { "sourceFingerprint", after.SourceFingerprint }, { "dependencyVersion", after.DependencyVersion },
+                        { "changed", changed }, { "importObserved", Bool(root, "importObserved") || changed }, { "compilationTriggered", Bool(root, "compilationObserved") },
+                        { "generation", new Dictionary<string, object> { { "dependencyBefore", Long(root, "beforeDependencyGeneration") }, { "dependencyAfter", after.DependencyGeneration }, { "processedBefore", Long(root, "beforeProcessedGeneration") }, { "processedAfter", after.ProcessedGeneration } } },
                         { "editorState", new Dictionary<string, object> { { "status", "ready" }, { "compile", false }, { "import", false } } }
                     };
                 }
-                private sealed class Proof { internal List<string> Paths; internal string SourceFingerprint; internal string DependencyVersion; }
-                /// <summary>Refresh 的业务证明：Assets 全量文件指纹 + AssetDatabase 依赖哈希版本。</summary>
+
+                private void ObserveImport(Dictionary<string, object> root)
+                {
+                    if (Bool(root, "importObserved")) return;
+                    var current = CaptureProof();
+                    if (!EditorApplication.isUpdating && Long(root, "beforeDependencyGeneration") == current.DependencyGeneration && Long(root, "beforeProcessedGeneration") == current.ProcessedGeneration) return;
+                    root["importObserved"] = true;
+                    Update(value => value["importObserved"] = true);
+                }
+
+                private sealed class Proof { internal long DependencyGeneration; internal long ProcessedGeneration; }
+
+                /// <summary>O(1) Unity-owned generation proof；不读取 Assets 文件，不计算 per-file dependency hash。</summary>
                 private static Proof CaptureProof()
                 {
-                    var rootPath = Path.Combine(ProjectRoot(), "Assets");
-                    var files = Directory.Exists(rootPath) ? Directory.GetFiles(rootPath, "*", SearchOption.AllDirectories).OrderBy(path => path, StringComparer.Ordinal).ToArray() : new string[0];
-                    var lines = new List<string>(); var paths = new List<string>(); var dependencies = new List<string>();
-                    foreach (var file in files)
+                    return new Proof
                     {
-                        var relative = "Assets/" + Path.GetRelativePath(rootPath, file).Replace('\\', '/');
-                        var info = new FileInfo(file);
-                        paths.Add(relative);
-                        lines.Add(relative + "\0" + info.Length.ToString(CultureInfo.InvariantCulture) + "\0" + info.LastWriteTimeUtc.Ticks.ToString(CultureInfo.InvariantCulture) + "\0" + HashFile(file));
-                        if (!relative.EndsWith(".meta", StringComparison.OrdinalIgnoreCase)) dependencies.Add(relative + "\0" + AssetDatabase.GetAssetDependencyHash(relative).ToString());
-                    }
-                    return new Proof { Paths = paths, SourceFingerprint = Sha256Hex(Encoding.UTF8.GetBytes(string.Join("\n", lines))), DependencyVersion = Sha256Hex(Encoding.UTF8.GetBytes(string.Join("\n", dependencies))) };
+                        DependencyGeneration = Math.Max(0L, (long)AssetDatabase.GlobalArtifactDependencyVersion),
+                        ProcessedGeneration = Math.Max(0L, (long)AssetDatabase.GlobalArtifactProcessedVersion)
+                    };
                 }
-                private static string HashFile(string path) { using (var sha = System.Security.Cryptography.SHA256.Create()) using (var stream = File.OpenRead(path)) return BitConverter.ToString(sha.ComputeHash(stream)).Replace("-", "").ToLowerInvariant(); }
+
                 private static bool BusyEditor() { return EditorApplication.isUpdating || EditorApplication.isCompiling || BuildPipeline.isBuildingPlayer || IsPlayModeChanging(); }
-                private static bool Same(string left, string right) { return !string.IsNullOrEmpty(left) && string.Equals(left, right, StringComparison.Ordinal); }
                 private sealed class Args { public bool Compile { get; set; } public string ExpectedEditorSessionId { get; set; } }
             }
         }

package/unitypkg/Editor/Infrastructure/UnityCliNavMeshBakeCoordinator.cs

@@ -77,13 +77,13 @@ namespace UnityCli
                 protected override string OperationDisplayName { get { return "NavMesh bake"; } }
                 protected override int CommandTimeoutMs { get { return 600000; } }
                 protected override bool IncludeAcceptedInStatus { get { return true; } }
-                protected override IEnumerable<(string name, bool destructive)> AdditionalCommands
+                protected override IEnumerable<(string name, bool destructive, UnityCliBridgeQueuePolicy.WorkClass queueClass)> AdditionalCommands
                 {
                     get
                     {
-                        yield return (PlanCommand, false);
-                        yield return (SnapshotCommand, false);
-                        yield return (CancelCommand, true);
+                        yield return (PlanCommand, false, UnityCliBridgeQueuePolicy.WorkClass.Mutation);
+                        yield return (SnapshotCommand, false, UnityCliBridgeQueuePolicy.WorkClass.OrdinaryRead);
+                        yield return (CancelCommand, true, UnityCliBridgeQueuePolicy.WorkClass.Control);
                     }
                 }
 

package/unitypkg/Editor/Infrastructure/UnityCliObjectRef.cs

@@ -2,8 +2,6 @@
 using System;
 using System.Collections.Generic;
 using System.Globalization;
-using System.Linq;
-using System.Reflection;
 using UnityEditor;
 using UnityEngine;
 using UnityEngine.SceneManagement;
@@ -34,6 +32,7 @@ namespace UnityCli
         List<string> Paths { get; }
         object ViewQuery { get; }
         string NamePattern { get; }
+        UnityCliReadBudgetInput Budget { get; }
     }
 
     public static partial class UnityCliBridge
@@ -45,13 +44,21 @@ namespace UnityCli
         /// </summary>
         internal static class ObjectRefResolver
         {
+            internal const int AbsoluteMaxBatchItems = 4096;
+            private const int MaximumRootSnapshotItems = AbsoluteMaxBatchItems;
+            private const int MaximumComponentSnapshotItems = AbsoluteMaxBatchItems;
+            private const int MaximumRootSnapshotGenerations = 64;
+            private static readonly Dictionary<string, GameObject[]> RootSnapshots = new Dictionary<string, GameObject[]>(StringComparer.Ordinal);
+
             /// <summary>解析任意 UnityEngine.Object 引用。</summary>
-            public static UnityEngine.Object ResolveObject(IUnityCliObjectReferenceInput request)
+            public static UnityEngine.Object ResolveObject(IUnityCliObjectReferenceInput request, UnityCliRequestBudget budget)
             {
-                // 优先级：instanceId > assetPath/guid > name(path)
+                if (budget == null) throw new ArgumentNullException("budget");
+                // 优先级：instanceId > assetPath/guid > exact hierarchy path/name
                 var instanceId = request.InstanceId;
                 if (instanceId.HasValue && instanceId.Value != 0)
                 {
+                    if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
                     var obj = EditorUtility.InstanceIDToObject(instanceId.Value);
                     if (obj == null)
                     {
@@ -66,11 +73,13 @@ namespace UnityCli
                 var guid = request.Guid;
                 if (!string.IsNullOrEmpty(guid))
                 {
+                    if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
                     var pathByGuid = AssetDatabase.GUIDToAssetPath(guid);
                     if (!string.IsNullOrEmpty(pathByGuid)) assetPath = pathByGuid;
                 }
                 if (!string.IsNullOrEmpty(assetPath))
                 {
+                    if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
                     var asset = AssetDatabase.LoadMainAssetAtPath(assetPath);
                     if (asset == null)
                     {
@@ -81,19 +90,11 @@ namespace UnityCli
                     return asset;
                 }
 
-                // 名称/路径解析：优先在活动场景中找 GameObject，再回退资产
                 var path = request.Path ?? request.Name ?? request.Target;
                 if (!string.IsNullOrEmpty(path))
                 {
-                    var go = FindGameObjectByPath(path);
-                    if (go != null) return go;
-
-                    var assetByName = AssetDatabase.FindAssets(path);
-                    if (assetByName != null && assetByName.Length > 0)
-                    {
-                        var resolved = AssetDatabase.LoadMainAssetAtPath(AssetDatabase.GUIDToAssetPath(assetByName[0]));
-                        if (resolved != null) return resolved;
-                    }
+                    var gameObject = FindGameObjectByExactPath(path, budget);
+                    if (gameObject != null) return gameObject;
                 }
 
                 throw new BridgeCommandException("E_OBJECTREF_REQUIRED",
@@ -102,11 +103,13 @@ namespace UnityCli
             }
 
             /// <summary>解析 GameObject 引用。</summary>
-            public static GameObject ResolveGameObject(IUnityCliObjectReferenceInput request)
+            public static GameObject ResolveGameObject(IUnityCliObjectReferenceInput request, UnityCliRequestBudget budget)
             {
+                if (budget == null) throw new ArgumentNullException("budget");
                 var instanceId = request.InstanceId;
                 if (instanceId.HasValue && instanceId.Value != 0)
                 {
+                    if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
                     var obj = EditorUtility.InstanceIDToObject(instanceId.Value) as GameObject;
                     if (obj == null)
                     {
@@ -120,7 +123,7 @@ namespace UnityCli
                 var path = request.Path ?? request.Target ?? request.Name;
                 if (!string.IsNullOrEmpty(path))
                 {
-                    var go = FindGameObjectByPath(path);
+                    var go = FindGameObjectByExactPath(path, budget);
                     if (go != null) return go;
                     throw new BridgeCommandException("E_OBJECTREF_GAMEOBJECT_REQUIRED",
                         "No GameObject matched path/name '" + path + "' in any loaded scene.",
@@ -138,11 +141,13 @@ namespace UnityCli
             /// 2) GameObject + component index
             /// 3) GameObject + component typeName
             /// </summary>
-            public static Component ResolveComponent(IUnityCliObjectReferenceInput request)
+            public static Component ResolveComponent(IUnityCliObjectReferenceInput request, UnityCliRequestBudget budget)
             {
+                if (budget == null) throw new ArgumentNullException("budget");
                 var componentInstanceId = request.ComponentInstanceId;
                 if (componentInstanceId.HasValue && componentInstanceId.Value != 0)
                 {
+                    if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
                     var obj = EditorUtility.InstanceIDToObject(componentInstanceId.Value) as Component;
                     if (obj == null)
                     {
@@ -153,11 +158,11 @@ namespace UnityCli
                     return obj;
                 }
 
-                var gameObject = ResolveGameObject(request);
+                var gameObject = ResolveGameObject(request, budget);
                 var componentIndex = request.ComponentIndex;
                 if (componentIndex.HasValue)
                 {
-                    var components = gameObject.GetComponents<Component>();
+                    var components = BoundedComponents(gameObject, budget);
                     if (componentIndex.Value < 0 || componentIndex.Value >= components.Length)
                     {
                         throw new BridgeCommandException("E_OBJECTREF_COMPONENT_INDEX_OUT_OF_RANGE",
@@ -170,7 +175,8 @@ namespace UnityCli
                 var componentType = request.Component ?? request.ComponentType;
                 if (!string.IsNullOrEmpty(componentType))
                 {
-                    var type = ResolveComponentType(componentType);
+                    var type = GameObjectToolSupport.ResolveComponentType(componentType, budget);
+                    if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
                     var component = gameObject.GetComponent(type);
                     if (component == null)
                     {
@@ -186,6 +192,99 @@ namespace UnityCli
                     "Run component.get --input '{\"instanceId\":123,\"component\":\"Transform\"}'.");
             }
 
+            /// <summary>按完整大小写敏感路径直接逐段解析；不会在失败时扫描整棵层级树。</summary>
+            public static GameObject FindGameObjectByExactPath(string path, UnityCliRequestBudget budget)
+            {
+                if (string.IsNullOrEmpty(path)) return null;
+                if (budget == null) throw new ArgumentNullException("budget");
+                if (path.Length > 8192) throw new BridgeCommandException("E_OBJECTREF_PATH_INVALID", "Exact hierarchy paths are limited to 8192 characters.", "Pass a shorter full case-sensitive hierarchy path or an instance id.");
+                var segments = path.Split(new[] { '/' }, StringSplitOptions.RemoveEmptyEntries);
+                if (segments.Length == 0) return null;
+                if (segments.Length > 256) throw new BridgeCommandException("E_OBJECTREF_PATH_INVALID", "Exact hierarchy paths are limited to 256 segments.", "Pass an instance id for deeper objects.");
+                GameObject match = null;
+                if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+                var sceneCount = SceneManager.sceneCount;
+                for (var sceneIndex = 0; sceneIndex < sceneCount; sceneIndex++)
+                {
+                    if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+                    var scene = SceneManager.GetSceneAt(sceneIndex);
+                    if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+                    if (!scene.isLoaded) continue;
+                    foreach (var root in BoundedSceneRoots(scene, budget))
+                    {
+                        if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+                        if (!string.Equals(root.name, segments[0], StringComparison.Ordinal)) continue;
+                        var current = root.transform;
+                        var resolved = true;
+                        for (var segmentIndex = 1; segmentIndex < segments.Length; segmentIndex++)
+                        {
+                            Transform childMatch = null;
+                            if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+                            var childCount = current.childCount;
+                            for (var childIndex = 0; childIndex < childCount; childIndex++)
+                            {
+                                if (!budget.TryConsumeScannedRecord() || !budget.TryConsumeGetter() || !budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+                                var child = current.GetChild(childIndex);
+                                if (!string.Equals(child.name, segments[segmentIndex], StringComparison.Ordinal)) continue;
+                                if (childMatch != null) ThrowExactAmbiguousPath(path, childMatch.gameObject, child.gameObject, budget);
+                                childMatch = child;
+                            }
+                            if (childMatch == null) { resolved = false; break; }
+                            current = childMatch;
+                        }
+                        if (!resolved) continue;
+                        if (match != null) ThrowExactAmbiguousPath(path, match, current.gameObject, budget);
+                        match = current.gameObject;
+                    }
+                }
+                return match;
+            }
+
+            /// <summary>批量根对象 getter 只在已验证 cardinality 后调用，并在同一层级 generation 复用有限快照。</summary>
+            internal static GameObject[] BoundedSceneRoots(Scene scene, UnityCliRequestBudget budget)
+            {
+                if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+                var rootCount = scene.rootCount;
+                if (rootCount < 0 || rootCount > MaximumRootSnapshotItems || !budget.TryConsumeScannedRecords(rootCount))
+                    throw new UnityCliRequestBudgetExceededException(rootCount > MaximumRootSnapshotItems ? "rootSnapshotItems" : budget.ExhaustedDimension);
+                if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+                var generation = UnityCliReadGeneration.Hierarchy(scene);
+                GameObject[] cached;
+                if (RootSnapshots.TryGetValue(generation, out cached))
+                {
+                    if (cached.Length != rootCount) throw new BridgeCommandException("E_READ_GENERATION_CHANGED", "Scene roots changed while resolving the exact path.", "Retry the read from the beginning.");
+                    return cached;
+                }
+                if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+                var roots = scene.GetRootGameObjects();
+                if (roots.Length != rootCount) throw new BridgeCommandException("E_READ_GENERATION_CHANGED", "Scene roots changed while building the bounded snapshot.", "Retry the read from the beginning.");
+                if (RootSnapshots.Count >= MaximumRootSnapshotGenerations) RootSnapshots.Clear();
+                RootSnapshots[generation] = roots;
+                return roots;
+            }
+
+            /// <summary>组件数组在 materialize 前验证数量并一次性占用扫描预算。</summary>
+            internal static Component[] BoundedComponents(GameObject gameObject, UnityCliRequestBudget budget)
+            {
+                if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+                var componentCount = gameObject.GetComponentCount();
+                if (componentCount < 0 || componentCount > MaximumComponentSnapshotItems || !budget.TryConsumeScannedRecords(componentCount))
+                    throw new UnityCliRequestBudgetExceededException(componentCount > MaximumComponentSnapshotItems ? "componentSnapshotItems" : budget.ExhaustedDimension);
+                if (!budget.TryConsumeGetter()) throw new UnityCliRequestBudgetExceededException(budget.ExhaustedDimension);
+                var components = gameObject.GetComponents<Component>();
+                if (components.Length != componentCount) throw new BridgeCommandException("E_READ_GENERATION_CHANGED", "GameObject components changed while building the bounded snapshot.", "Retry the read from the beginning.");
+                return components;
+            }
+
+            private static void ThrowExactAmbiguousPath(string path, GameObject first, GameObject second, UnityCliRequestBudget budget)
+            {
+                var firstPath = UnityCliHierarchyPager.Path(first, budget);
+                var secondPath = UnityCliHierarchyPager.Path(second, budget);
+                throw new BridgeCommandException("E_OBJECTREF_AMBIGUOUS",
+                    "Path '" + path + "' matches multiple GameObjects: " + firstPath + ", " + secondPath,
+                    "Pass the instanceId from go.find to disambiguate objects in different loaded scenes.");
+            }
+
             /// <summary>
             /// 按路径或名称查找 GameObject，分层匹配：
             /// 层1 精确匹配（从场景顶层起、大小写敏感）→ 层2 放宽匹配（任意层级起点、路径后缀、忽略大小写）。
@@ -263,11 +362,15 @@ namespace UnityCli
             // 多命中时抛歧义错误，列候选完整路径（从顶层起），不静默取错。
             private static void ThrowAmbiguousPath(string path, List<GameObject> matches)
             {
-                var candidates = matches
-                    .Select(m => FullPath(m.transform))
-                    .Distinct()
-                    .Take(10)
-                    .ToList();
+                var candidates = new List<string>();
+                var seen = new HashSet<string>(StringComparer.Ordinal);
+                foreach (var match in matches)
+                {
+                    var candidate = FullPath(match.transform);
+                    if (!seen.Add(candidate)) continue;
+                    candidates.Add(candidate);
+                    if (candidates.Count == 10) break;
+                }
                 throw new BridgeCommandException("E_OBJECTREF_AMBIGUOUS",
                     "Path '" + path + "' matches " + matches.Count + " GameObjects: " + string.Join(", ", candidates),
                     "Pass the full hierarchy path from a scene root, or use go.find to obtain the instanceId.");