@galacean/cli 2.0.0-alpha.24 → 2.0.0-alpha.26

package/dist/cli.bundle.cjs

@@ -5723,11 +5723,11 @@ var require_valid = __commonJS({
   "../../node_modules/semver/functions/valid.js"(exports2, module2) {
     "use strict";
     var parse4 = require_parse();
-    var valid = (version4, options) => {
+    var valid2 = (version4, options) => {
       const v6 = parse4(version4, options);
       return v6 ? v6.version : null;
     };
-    module2.exports = valid;
+    module2.exports = valid2;
   }
 });
 
@@ -5934,8 +5934,8 @@ var require_lt = __commonJS({
   "../../node_modules/semver/functions/lt.js"(exports2, module2) {
     "use strict";
     var compare = require_compare();
-    var lt2 = (a6, b6, loose) => compare(a6, b6, loose) < 0;
-    module2.exports = lt2;
+    var lt3 = (a6, b6, loose) => compare(a6, b6, loose) < 0;
+    module2.exports = lt3;
   }
 });
 
@@ -5987,7 +5987,7 @@ var require_cmp = __commonJS({
     var neq = require_neq();
     var gt2 = require_gt();
     var gte2 = require_gte();
-    var lt2 = require_lt();
+    var lt3 = require_lt();
     var lte2 = require_lte();
     var cmp = (a6, op, b6, loose) => {
       switch (op) {
@@ -6018,7 +6018,7 @@ var require_cmp = __commonJS({
         case ">=":
           return gte2(a6, b6, loose);
         case "<":
-          return lt2(a6, b6, loose);
+          return lt3(a6, b6, loose);
         case "<=":
           return lte2(a6, b6, loose);
         default:
@@ -6771,7 +6771,7 @@ var require_outside = __commonJS({
     var Range4 = require_range();
     var satisfies = require_satisfies();
     var gt2 = require_gt();
-    var lt2 = require_lt();
+    var lt3 = require_lt();
     var lte2 = require_lte();
     var gte2 = require_gte();
     var outside = (version4, range3, hilo, options) => {
@@ -6782,12 +6782,12 @@ var require_outside = __commonJS({
         case ">":
           gtfn = gt2;
           ltefn = lte2;
-          ltfn = lt2;
+          ltfn = lt3;
           comp = ">";
           ecomp = ">=";
           break;
         case "<":
-          gtfn = lt2;
+          gtfn = lt3;
           ltefn = gte2;
           ltfn = gt2;
           comp = "<";
@@ -6968,12 +6968,12 @@ var require_subset = __commonJS({
         }
       }
       const eqSet = /* @__PURE__ */ new Set();
-      let gt2, lt2;
+      let gt2, lt3;
       for (const c6 of sub2) {
         if (c6.operator === ">" || c6.operator === ">=") {
           gt2 = higherGT(gt2, c6, options);
         } else if (c6.operator === "<" || c6.operator === "<=") {
-          lt2 = lowerLT(lt2, c6, options);
+          lt3 = lowerLT(lt3, c6, options);
         } else {
           eqSet.add(c6.semver);
         }
@@ -6982,11 +6982,11 @@ var require_subset = __commonJS({
         return null;
       }
       let gtltComp;
-      if (gt2 && lt2) {
-        gtltComp = compare(gt2.semver, lt2.semver, options);
+      if (gt2 && lt3) {
+        gtltComp = compare(gt2.semver, lt3.semver, options);
         if (gtltComp > 0) {
           return null;
-        } else if (gtltComp === 0 && (gt2.operator !== ">=" || lt2.operator !== "<=")) {
+        } else if (gtltComp === 0 && (gt2.operator !== ">=" || lt3.operator !== "<=")) {
           return null;
         }
       }
@@ -6994,7 +6994,7 @@ var require_subset = __commonJS({
         if (gt2 && !satisfies(eq4, String(gt2), options)) {
           return null;
         }
-        if (lt2 && !satisfies(eq4, String(lt2), options)) {
+        if (lt3 && !satisfies(eq4, String(lt3), options)) {
           return null;
         }
         for (const c6 of dom) {
@@ -7006,9 +7006,9 @@ var require_subset = __commonJS({
       }
       let higher, lower;
       let hasDomLT, hasDomGT;
-      let needDomLTPre = lt2 && !options.includePrerelease && lt2.semver.prerelease.length ? lt2.semver : false;
+      let needDomLTPre = lt3 && !options.includePrerelease && lt3.semver.prerelease.length ? lt3.semver : false;
       let needDomGTPre = gt2 && !options.includePrerelease && gt2.semver.prerelease.length ? gt2.semver : false;
-      if (needDomLTPre && needDomLTPre.prerelease.length === 1 && lt2.operator === "<" && needDomLTPre.prerelease[0] === 0) {
+      if (needDomLTPre && needDomLTPre.prerelease.length === 1 && lt3.operator === "<" && needDomLTPre.prerelease[0] === 0) {
         needDomLTPre = false;
       }
       for (const c6 of dom) {
@@ -7029,29 +7029,29 @@ var require_subset = __commonJS({
             return false;
           }
         }
-        if (lt2) {
+        if (lt3) {
           if (needDomLTPre) {
             if (c6.semver.prerelease && c6.semver.prerelease.length && c6.semver.major === needDomLTPre.major && c6.semver.minor === needDomLTPre.minor && c6.semver.patch === needDomLTPre.patch) {
               needDomLTPre = false;
             }
           }
           if (c6.operator === "<" || c6.operator === "<=") {
-            lower = lowerLT(lt2, c6, options);
-            if (lower === c6 && lower !== lt2) {
+            lower = lowerLT(lt3, c6, options);
+            if (lower === c6 && lower !== lt3) {
               return false;
             }
-          } else if (lt2.operator === "<=" && !satisfies(lt2.semver, String(c6), options)) {
+          } else if (lt3.operator === "<=" && !satisfies(lt3.semver, String(c6), options)) {
             return false;
           }
         }
-        if (!c6.operator && (lt2 || gt2) && gtltComp !== 0) {
+        if (!c6.operator && (lt3 || gt2) && gtltComp !== 0) {
           return false;
         }
       }
-      if (gt2 && hasDomLT && !lt2 && gtltComp !== 0) {
+      if (gt2 && hasDomLT && !lt3 && gtltComp !== 0) {
         return false;
       }
-      if (lt2 && hasDomGT && !gt2 && gtltComp !== 0) {
+      if (lt3 && hasDomGT && !gt2 && gtltComp !== 0) {
         return false;
       }
       if (needDomGTPre || needDomLTPre) {
@@ -7086,7 +7086,7 @@ var require_semver2 = __commonJS({
     var SemVer = require_semver();
     var identifiers = require_identifiers();
     var parse4 = require_parse();
-    var valid = require_valid();
+    var valid2 = require_valid();
     var clean2 = require_clean();
     var inc = require_inc();
     var diff = require_diff();
@@ -7101,7 +7101,7 @@ var require_semver2 = __commonJS({
     var sort = require_sort();
     var rsort = require_rsort();
     var gt2 = require_gt();
-    var lt2 = require_lt();
+    var lt3 = require_lt();
     var eq4 = require_eq();
     var neq = require_neq();
     var gte2 = require_gte();
@@ -7124,7 +7124,7 @@ var require_semver2 = __commonJS({
     var subset = require_subset();
     module2.exports = {
       parse: parse4,
-      valid,
+      valid: valid2,
       clean: clean2,
       inc,
       diff,
@@ -7139,7 +7139,7 @@ var require_semver2 = __commonJS({
       sort,
       rsort,
       gt: gt2,
-      lt: lt2,
+      lt: lt3,
       eq: eq4,
       neq,
       gte: gte2,
@@ -7173,6 +7173,19 @@ var require_semver2 = __commonJS({
 });
 
 // ../constants/src/builder.ts
+function getEnginePrereleaseTag(engineVersion) {
+  if (engineVersion.includes("alpha"))
+    return "alpha";
+  if (engineVersion.includes("beta"))
+    return "beta";
+  return void 0;
+}
+function resolveShaderCompilerDependencyVersion(engineVersion) {
+  if (getEnginePrereleaseTag(engineVersion) === "alpha" && (0, import_semver.valid)(engineVersion) && (0, import_semver.lt)(engineVersion, "2.0.0-alpha.31")) {
+    return "alpha";
+  }
+  return engineVersion;
+}
 function shouldEnableShaderCompiler(engineVersion) {
   return (0, import_semver.major)(engineVersion) >= 2;
 }
@@ -7223,7 +7236,7 @@ function resolveFeatureDependencies(features, engineVersion, projectDependencies
     deps["@galacean/engine-spine"] = compatibleVersion;
   }
   if (features["shaderCompiler" /* ShaderCompiler */]) {
-    deps["@galacean/engine-shader-compiler"] = engineVersion;
+    deps["@galacean/engine-shader-compiler"] = resolveShaderCompilerDependencyVersion(engineVersion);
     deps["@galacean/engine-shader"] = engineVersion;
   }
   if (features["physicsLite" /* PhysicsLite */]) {
@@ -7342,7 +7355,7 @@ function getBuiltinAssetSourceVirtualPath(assetId) {
   BUILTIN_SOURCE_VIRTUAL_PATH_CACHE.set(assetId, virtualPath);
   return virtualPath;
 }
-var BUILTIN_FOLDER_ASSETS, BUILTIN_REMOTE_ASSETS, BUILTIN_REMOTE_ASSET_BY_ID, BUILTIN_SOURCE_VIRTUAL_PATH_CACHE;
+var BUILTIN_FOLDER_ASSETS, BUILTIN_REMOTE_ASSETS, BUILTIN_REMOTE_ASSET_BY_ID, BUILTIN_SOURCE_VIRTUAL_PATH_CACHE, BUILTIN_REMOTE_ASSET_UUIDS;
 var init_builtin_assets = __esm({
   "../constants/src/builtin-assets.ts"() {
     "use strict";
@@ -7684,6 +7697,7 @@ var init_builtin_assets = __esm({
     ];
     BUILTIN_REMOTE_ASSET_BY_ID = new Map(BUILTIN_REMOTE_ASSETS.map((asset3) => [asset3.uuid, asset3]));
     BUILTIN_SOURCE_VIRTUAL_PATH_CACHE = /* @__PURE__ */ new Map();
+    BUILTIN_REMOTE_ASSET_UUIDS = new Set(BUILTIN_REMOTE_ASSETS.map((a6) => a6.uuid));
   }
 });
 
@@ -7896,12 +7910,6 @@ function isFileNotFoundError(err2) {
     return true;
   return typeof record2.message === "string" && /file not found|no such file/i.test(record2.message);
 }
-function isAbortError(err2) {
-  if (!err2 || typeof err2 !== "object")
-    return false;
-  const e6 = err2;
-  return e6.name === "AbortError";
-}
 function throwIfAborted2(signal) {
   if (signal?.aborted) {
     const error49 = new Error("The operation was aborted");
@@ -8203,6 +8211,26 @@ function isSceneUploadPath(assetPath) {
 function sortSceneUploadsLast(items, isScene) {
   return items.map((item, index2) => ({ item, index: index2, scene: isScene(item) })).sort((a6, b6) => Number(a6.scene) - Number(b6.scene) || a6.index - b6.index).map(({ item }) => item);
 }
+async function uploadSceneSeals(opts) {
+  const { apiClient, fs: fs5, projectDir, scenes, pushed, signal } = opts;
+  for (const [assetId, entry] of scenes) {
+    throwIfAborted2(signal);
+    if (!entry.serverId || entry.serverId.startsWith("local-"))
+      continue;
+    const filePath = import_node_path6.default.resolve(projectDir, entry.path);
+    const content = await fs5.readFile(filePath);
+    const currentHash = md52(content);
+    const upload = await apiClient.uploadAsset(entry.serverId, content, getServerFileName(entry.path, entry.type), {
+      signal
+    });
+    entry.contentHash = currentHash;
+    entry.url = upload.url;
+    const pushedEntry = pushed.find((item) => item.assetId === assetId);
+    if (pushedEntry) {
+      pushedEntry.url = upload.url;
+    }
+  }
+}
 async function pushProject(opts) {
   const { projectDir, apiClient, fs: fs5, signal } = opts;
   const pruneRemote = opts.pruneRemote !== false;
@@ -8214,12 +8242,13 @@ async function pushProject(opts) {
   const deleted = [];
   const warnings = [];
   const warnedInternalUserAssets = /* @__PURE__ */ new Set();
-  const warnInternalUserAssetSkip = (assetId, assetPath) => {
+  let remoteAssetMetadataChanged = false;
+  const warnInternalUserAssetSkip = (assetId, assetPath, operation = "remote sync") => {
     if (!isBuiltinAssetPath(assetPath) || isBuiltinAssetId(assetId) || warnedInternalUserAssets.has(assetId))
       return;
     warnedInternalUserAssets.add(assetId);
     warnings.push(
-      `Skipped remote sync for non-builtin asset under assets/Internal/: ${assetPath}. Path-only builtin protection treats this path as internal.`
+      `Skipped ${operation} for non-builtin asset under assets/Internal/: ${assetPath}. Path-only builtin protection treats this path as internal.`
     );
   };
   let primaryError;
@@ -8564,10 +8593,6 @@ async function pushProject(opts) {
         continue;
       if (locallyDeletedIds.has(assetId))
         continue;
-      if (isBuiltinAssetPath(entry.path)) {
-        warnInternalUserAssetSkip(assetId, entry.path);
-        continue;
-      }
       const filePath = import_node_path6.default.resolve(projectDir, entry.path);
       let content;
       try {
@@ -8582,6 +8607,10 @@ async function pushProject(opts) {
       const isLocalOnly = !entry.serverId || entry.serverId.startsWith("local-");
       if (!isLocalOnly && currentHash === entry.contentHash)
         continue;
+      if (isBuiltinAssetPath(entry.path)) {
+        warnInternalUserAssetSkip(assetId, entry.path, "remote content upload");
+        continue;
+      }
       const serverName = getServerFileName(entry.path, entry.type);
       if (isLocalOnly) {
         const existingId = existingServerAssets.get(assetId);
@@ -8629,10 +8658,6 @@ async function pushProject(opts) {
       const localEntry = manifest.entries[serverAsset.uuid];
       if (!localEntry?.serverId || localEntry.serverId.startsWith("local-"))
         continue;
-      if (localEntry && isBuiltinAssetPath(localEntry.path)) {
-        warnInternalUserAssetSkip(serverAsset.uuid, localEntry.path);
-        continue;
-      }
       const localName = getServerFileName(localEntry.path, localEntry.type);
       const localParentId = folderIdByPath.get(import_node_path6.default.posix.dirname(localEntry.path));
       const nameChanged = serverAsset.name !== localName;
@@ -8640,20 +8665,17 @@ async function pushProject(opts) {
       const effectiveLocalParentId = localParentId || void 0;
       const parentChanged = serverParentId !== effectiveLocalParentId;
       if (nameChanged || parentChanged) {
-        try {
-          const params = { serverId: localEntry.serverId };
-          if (nameChanged)
-            params.name = localName;
-          if (parentChanged)
-            params.parentId = localParentId;
-          await apiClient.updateAssetMeta(params, { signal });
-        } catch (err2) {
-          if (isAbortError(err2))
-            throw err2;
-          warnings.push(
-            `Failed to rename/move asset '${localEntry.path}': ${err2 instanceof Error ? err2.message : String(err2)}`
-          );
+        if (isBuiltinAssetPath(localEntry.path)) {
+          warnInternalUserAssetSkip(serverAsset.uuid, localEntry.path, "remote rename/move sync");
+          continue;
         }
+        const params = { serverId: localEntry.serverId };
+        if (nameChanged)
+          params.name = localName;
+        if (parentChanged)
+          params.parentId = localParentId;
+        await apiClient.updateAssetMeta(params, { signal });
+        remoteAssetMetadataChanged = true;
       }
     }
     if (remote) {
@@ -8688,6 +8710,17 @@ async function pushProject(opts) {
         delete manifest.entries[assetId];
       }
     }
+    if (remoteAssetMetadataChanged) {
+      const sceneSealCandidates = /* @__PURE__ */ new Map();
+      for (const { assetId } of pushed) {
+        const entry = manifest.entries[assetId];
+        if (entry && isSceneUploadEntry(entry))
+          sceneSealCandidates.set(assetId, entry);
+      }
+      if (sceneSealCandidates.size > 0) {
+        await uploadSceneSeals({ apiClient, fs: fs5, projectDir, scenes: sceneSealCandidates, pushed, signal });
+      }
+    }
     if (remote) {
       await syncProjectMetadata(apiClient, remote.projectId, manifest, projectConfig, project2, signal);
     }
@@ -8740,7 +8773,7 @@ async function syncProjectMetadata(apiClient, projectId, manifest, projectConfig
     await apiClient.updateProjectSchema(projectId, { scene: resolvedSceneId }, { signal });
   }
 }
-var import_node_crypto3, import_node_path6, BUILTIN_REMOTE_ASSET_UUIDS, AUTOCREATE_BUILTIN_BOOTSTRAP_PENDING_PATH;
+var import_node_crypto3, import_node_path6, AUTOCREATE_BUILTIN_BOOTSTRAP_PENDING_PATH;
 var init_push = __esm({
   "src/commands/push.ts"() {
     "use strict";
@@ -8750,7 +8783,6 @@ var init_push = __esm({
     init_ignore_rules();
     init_asset_path();
     init_meta_file();
-    BUILTIN_REMOTE_ASSET_UUIDS = new Set(BUILTIN_REMOTE_ASSETS.map((asset3) => asset3.uuid));
     AUTOCREATE_BUILTIN_BOOTSTRAP_PENDING_PATH = ".galacean/autocreate-builtin-bootstrap-pending.json";
   }
 });
@@ -12569,7 +12601,7 @@ var require_mobx_cjs_production_min = __commonJS({
         jt(n8[i7], t9);
       t9.C = di.I;
     }
-    function lt2(t9) {
+    function lt3(t9) {
       var n8 = dt();
       try {
         return t9();
@@ -13751,7 +13783,7 @@ var require_mobx_cjs_production_min = __commonJS({
       }, i7.clear = function() {
         var t9 = this;
         Jt(function() {
-          lt2(function() {
+          lt3(function() {
             for (var n9, i8 = O3(t9.keys()); !(n9 = i8()).done; )
               t9.delete(n9.value);
           });
@@ -13832,7 +13864,7 @@ var require_mobx_cjs_production_min = __commonJS({
       }, i7.clear = function() {
         var t9 = this;
         Jt(function() {
-          lt2(function() {
+          lt3(function() {
             for (var n9, i8 = O3(t9.lt.values()); !(n9 = i8()).done; )
               t9.delete(n9.value);
           });
@@ -14299,7 +14331,7 @@ var require_mobx_cjs_production_min = __commonJS({
         }), o7;
       }(t9, /* @__PURE__ */ new Map());
     }, exports2.trace = function() {
-    }, exports2.transaction = Jt, exports2.untracked = lt2, exports2.values = function(n8) {
+    }, exports2.transaction = Jt, exports2.untracked = lt3, exports2.values = function(n8) {
       return bn(n8) ? Xt(n8).map(function(t9) {
         return n8[t9];
       }) : $i(n8) ? Xt(n8).map(function(t9) {
@@ -41855,11 +41887,53 @@ function findBindingForSerializableInstance(state, entity) {
 }
 function domainStateToSceneFileV2(state, optionsOrResolveAssetRef = {}) {
   const resolveRef3 = createAssetRefResolver(optionsOrResolveAssetRef);
-  const sceneSettings = state.scene.settings ? editorSceneSettingsToSourceSettings(state.scene.settings, resolveRef3) : void 0;
+  let sceneSettings;
+  if (state.scene.settings) {
+    try {
+      sceneSettings = editorSceneSettingsToSourceSettings(
+        state.scene.settings,
+        resolveRef3
+      );
+    } catch (err2) {
+      if (err2 instanceof SceneV2DanglingAssetRefError) {
+        console.warn(`[SceneV2] scene settings dangling ref, settings \u6574\u4F53\u8DF3\u8FC7: ${err2.message}`);
+        sceneSettings = void 0;
+      } else {
+        throw err2;
+      }
+    }
+  }
   const ordered = orderSceneEntities(state);
-  const entityIds = ordered.map((entity) => entity.id);
   const components = [];
+  const candidateEntityIds = ordered.map((entity) => entity.id);
   const entities = ordered.map((entity) => {
+    const entityComponentsBuffer = [];
+    try {
+      const result3 = serializeOneEntity(entity, entityComponentsBuffer, candidateEntityIds);
+      components.push(...entityComponentsBuffer);
+      return result3;
+    } catch (err2) {
+      if (err2 instanceof SceneV2DanglingAssetRefError) {
+        console.warn(`[SceneV2] skip entity "${entity.id}" (name="${entity.name}") from save: ${err2.message}`);
+        return null;
+      }
+      throw err2;
+    }
+  }).filter((e6) => e6 !== null);
+  const validEntityIds = new Set(entities.map((e6) => e6.id));
+  for (const entity of entities) {
+    if (!entity.children)
+      continue;
+    const pruned = entity.children.filter((id) => validEntityIds.has(id));
+    if (pruned.length !== entity.children.length) {
+      if (pruned.length) {
+        entity.children = pruned;
+      } else {
+        delete entity.children;
+      }
+    }
+  }
+  function serializeOneEntity(entity, componentsBuffer, candidateIds) {
     const entityBinding = findBindingForSerializableInstance(state, entity);
     const bindingOverrides = entity.instance?.assetId && entity.instance.role !== "added" ? prefabBindingsToV2OverridesForEntity(state, entityBinding, resolveRef3) : void 0;
     const rootOverrideTarget = resolveSerializableInstanceRootOverrideTarget(entity, entityBinding);
@@ -41905,7 +41979,7 @@ function domainStateToSceneFileV2(state, optionsOrResolveAssetRef = {}) {
         instanceResult.instance.overrides = inlineOverrides;
       return instanceResult;
     }
-    const childIds = entity.children.filter((id) => entityIds.includes(id));
+    const childIds = entity.children.filter((id) => candidateIds.includes(id));
     if (childIds.length)
       result3.children = childIds;
     const componentEntries = Object.entries(entity.components);
@@ -41916,13 +41990,13 @@ function domainStateToSceneFileV2(state, optionsOrResolveAssetRef = {}) {
       if (component2.instance?.role === "added")
         continue;
       sourceComponentIds3.push(componentId);
-      components.push(componentStateToSourceComponent(componentId, component2, resolveRef3));
+      componentsBuffer.push(componentStateToSourceComponent(componentId, component2, resolveRef3));
     }
     if (sourceComponentIds3.length)
       result3.components = sourceComponentIds3;
     return result3;
-  });
-  const rootEntityIds = state.scene.rootEntityIds.filter((id) => entityIds.includes(id));
+  }
+  const rootEntityIds = state.scene.rootEntityIds.filter((id) => validEntityIds.has(id));
   const result2 = {
     asset: { version: "2.0", generator: "Galacean Editor" },
     scene: {
@@ -42017,7 +42091,7 @@ function createAssetRefResolver(optionsOrResolveAssetRef) {
   return (assetId) => {
     const sourceRef = resolveAssetRef2?.(assetId);
     if (typeof sourceRef !== "string" || sourceRef.length === 0) {
-      throw new Error(`[SceneV2] Unable to serialize asset ref "${assetId}": missing virtualPath`);
+      throw new SceneV2DanglingAssetRefError(assetId);
     }
     return sourceRef;
   };
@@ -42156,6 +42230,7 @@ function orderSceneEntities(state) {
   }
   return ordered;
 }
+var SCENE_V2_DANGLING_REF_SENTINEL, SceneV2DanglingAssetRefError;
 var init_domain_codec = __esm({
   "../model/src/scene-file-v2/domain-codec.ts"() {
     "use strict";
@@ -42169,6 +42244,14 @@ var init_domain_codec = __esm({
     init_source_value();
     init_prefab_overrides();
     init_prefab_override_utils();
+    SCENE_V2_DANGLING_REF_SENTINEL = Symbol("SceneV2DanglingAssetRef");
+    SceneV2DanglingAssetRefError = class extends Error {
+      constructor(assetId) {
+        super(`[SceneV2] dangling asset ref "${assetId}" \u2014 entity/binding skipped from save`);
+        this.assetId = assetId;
+        this.name = "SceneV2DanglingAssetRefError";
+      }
+    };
   }
 });
 
@@ -125404,7 +125487,8 @@ function createDomainAssetSourceRefResolver(assets2) {
       cache.set(assetId, void 0);
       return void 0;
     }
-    const virtualPath = parentPath ? `${parentPath}/${asset3.name}` : asset3.name;
+    const assetName = asset3.type === "Folder" ? asset3.name : assetNameFromPath(asset3.name, asset3.type);
+    const virtualPath = parentPath ? `${parentPath}/${assetName}` : assetName;
     cache.set(assetId, virtualPath);
     return virtualPath;
   };
@@ -141210,7 +141294,6 @@ __export(constants_exports, {
   SKILL_TOOL_NAMES: () => SKILL_TOOL_NAMES,
   isAssetTool: () => isAssetTool,
   isClientSideTool: () => isClientSideTool,
-  isServerSideTool: () => isServerSideTool,
   isSkillTool: () => isSkillTool,
   suggestToolName: () => suggestToolName
 });
@@ -141229,15 +141312,6 @@ function isAssetTool(name16) {
     return false;
   return ASSET_TOOL_NAMES.has(name16);
 }
-function isServerSideTool(name16) {
-  if (!name16)
-    return false;
-  if (SERVER_SIDE_TOOLS.has(name16))
-    return true;
-  if (name16.startsWith("workflow-"))
-    return true;
-  return false;
-}
 function suggestToolName(toolId, allToolIds) {
   const [domain2, action39] = toolId.split(".");
   const domainMatches = allToolIds.filter((id) => {
@@ -141262,7 +141336,7 @@ function suggestToolName(toolId, allToolIds) {
   }
   return void 0;
 }
-var SEARCH_TOOL_NAME, EXECUTE_TOOL_NAME, MODEL_GENERATE_FROM_IMAGE_TOOL_NAME, CLIENT_SIDE_TOOLS, SKILL_TOOL_NAMES, ASSET_TOOL_NAMES, SERVER_SIDE_TOOLS;
+var SEARCH_TOOL_NAME, EXECUTE_TOOL_NAME, MODEL_GENERATE_FROM_IMAGE_TOOL_NAME, CLIENT_SIDE_TOOLS, SKILL_TOOL_NAMES, ASSET_TOOL_NAMES;
 var init_constants = __esm({
   "../ai/src/tool-runner/constants.ts"() {
     "use strict";
@@ -141283,41 +141357,6 @@ var init_constants = __esm({
       "sceneEditTool"
     ]);
     ASSET_TOOL_NAMES = /* @__PURE__ */ new Set(["sandbox_findFiles", "sandbox_cat"]);
-    SERVER_SIDE_TOOLS = /* @__PURE__ */ new Set([
-      // Mastra 内置工具
-      "list_skills",
-      "read_file",
-      "list_files",
-      "grep_files",
-      "glob_files",
-      "skill",
-      "skill_read",
-      // 编辑器服务端工具
-      "operationQueue",
-      "todo_write",
-      "verify",
-      "runtime_probe",
-      "particleTool",
-      "generate-particle-effect",
-      "validate_config",
-      "editorRouterAgent",
-      "sceneEditTool",
-      // 服务端场景编辑工具（直接修改 scene.json）
-      // 沙箱工具
-      "exec",
-      "search",
-      "upload",
-      "upload_batch",
-      "read",
-      "write",
-      "edit",
-      "grep",
-      // 旧沙箱工具名，兼容历史消息与灰度后端
-      "sandbox_findFiles",
-      "sandbox_cat",
-      "sandbox_writeFile",
-      "sandbox_getPublicUrl"
-    ]);
   }
 });
 
@@ -141341,6 +141380,7 @@ var init_errors3 = __esm({
       ENTITY_NOT_INITIALIZED: "\u5B9E\u4F53\u5F15\u64CE\u5BF9\u8C61\u672A\u521D\u59CB\u5316",
       COMPONENT_NOT_FOUND: "\u7EC4\u4EF6\u4E0D\u5B58\u5728",
       ASSET_NOT_FOUND: "\u8D44\u4EA7\u4E0D\u5B58\u5728",
+      ASSET_ALREADY_EXISTS: "\u8D44\u4EA7\u5DF2\u5B58\u5728",
       FOLDER_NOT_FOUND: "\u6587\u4EF6\u5939\u4E0D\u5B58\u5728",
       NOT_SUPPORTED: "\u4E0D\u652F\u6301\u7684\u64CD\u4F5C",
       OPERATION_FAILED: "\u64CD\u4F5C\u5931\u8D25",
@@ -141469,10 +141509,13 @@ var init_common = __esm({
     layerMaskSchema = external_exports.union([
       external_exports.literal("Everything"),
       external_exports.literal("Nothing"),
+      // 单 Layer 字符串(如 "Layer1")— 容忍 LLM 直觉传 string,handler 自动包装成数组语义
+      external_exports.enum(layerNames),
+      // 多 Layer 数组
       external_exports.array(external_exports.enum(layerNames)),
-      external_exports.number().int().min(0).describe("\u5F15\u64CE\u4F4D\u503C(\u9AD8\u7EA7\u7528\u6CD5,LLM \u901A\u5E38\u7528\u4E0A\u9762 3 \u79CD\u5F62\u5F0F)")
+      external_exports.number().int().min(0).describe("\u5F15\u64CE\u4F4D\u503C(\u9AD8\u7EA7\u7528\u6CD5,LLM \u901A\u5E38\u7528\u4E0A\u9762\u51E0\u79CD\u5F62\u5F0F)")
     ]).describe(
-      `Layer \u63A9\u7801\u3002\u53EF\u4EE5\u4F20 'Everything'(\u6240\u6709 Layer) / 'Nothing'(\u65E0) / ["Layer0","Layer3"](\u6307\u5B9A Layer \u6570\u7EC4) / \u6570\u5B57\u4F4D\u503C`
+      "Layer \u63A9\u7801\u3002\u53EF\u4EE5\u4F20:'Everything'(\u6240\u6709 Layer) / 'Nothing'(\u65E0) / \u5355 Layer \u5B57\u7B26\u4E32\u5982 'Layer1' / \u591A Layer \u6570\u7EC4\u5982 ['Layer0','Layer3'] / \u6570\u5B57\u4F4D\u503C\u3002"
     );
     assetInfoSchema = external_exports.object({
       path: external_exports.string().nullable().describe("\u8D44\u4EA7 vfs \u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u53EF\u76F4\u63A5\u7528\u4F5C\u4E0B\u4E00\u6B65 API \u8C03\u7528\u7684\u8F93\u5165\uFF1B\u4E0D\u5728 vfs \u65F6\u4E3A null"),
@@ -141567,6 +141610,155 @@ var init_create = __esm({
   }
 });
 
+// ../editor-api/src/tools/asset/helpers.ts
+async function resolveAssetSnapshot(assetId, ctx, options) {
+  const { assetStore } = ctx;
+  const asset3 = assetStore.getAsset(assetId);
+  if (!asset3) {
+    throw new EditorAPIError("ASSET_NOT_FOUND", assetId);
+  }
+  const metaConfig = asset3.getMetaConfig();
+  let props = {};
+  if (typeof asset3.getMainData === "function") {
+    try {
+      const mainData = asset3.getMainData();
+      const assetType = metaConfig.type;
+      if (assetType === "script") {
+        if (typeof mainData === "string") {
+          props.code = mainData;
+        }
+      } else if (typeof mainData === "string") {
+        props = JSON.parse(mainData);
+      } else if (mainData && typeof mainData === "object") {
+        props = JSON.parse(JSON.stringify(mainData));
+      }
+    } catch {
+    }
+  }
+  if (options?.fallbackProps && Object.keys(options.fallbackProps).length > 0) {
+    props = { ...props, ...options.fallbackProps };
+  }
+  return {
+    path: getAssetPath(asset3.id, ctx),
+    name: asset3.name,
+    type: metaConfig.type,
+    props
+  };
+}
+function getAssetPath(assetId, ctx) {
+  if (!assetId)
+    return null;
+  const vfs = ctx.vfs;
+  const file2 = vfs?.getFileById?.(assetId);
+  return file2?.path ?? null;
+}
+function assertAssetNameAvailable(name16, parentFolderId, assetType, ctx) {
+  const children = ctx.query?.listChildren?.(parentFolderId);
+  if (children !== void 0) {
+    for (const child of children) {
+      if (child.name === name16) {
+        throwAssetAlreadyExists(assetType, name16);
+      }
+    }
+    return;
+  }
+  const assets2 = ctx.rootStore?.domainStore?.state?.assets;
+  if (!assets2)
+    return;
+  const parentKey = parentFolderId ?? null;
+  for (const asset3 of Object.values(assets2)) {
+    if ((asset3.parentFolderId ?? null) === parentKey && asset3.name === name16) {
+      throwAssetAlreadyExists(assetType, name16);
+    }
+  }
+}
+function throwAssetAlreadyExists(assetType, name16) {
+  throw new EditorAPIError(
+    "ASSET_ALREADY_EXISTS",
+    `${assetType} "${name16}" \u5DF2\u5B58\u5728\u4E8E\u6B64 folder\u3002\u5982\u8981\u590D\u7528,\u76F4\u63A5\u5F15\u7528\u73B0\u6709\u8D44\u4EA7(\u5982 scene.setActive / asset.read);\u5982\u8981\u91CD\u5EFA,\u5148\u8C03 asset.delete \u5220\u9664\u5DF2\u6709\u518D\u521B\u5EFA;\u5982\u8981\u5E76\u5B58,\u8BF7\u7528\u4E0D\u540C name(\u672C\u5DE5\u5177\u4E0D\u4F1A auto-rename,\u907F\u514D LLM \u5FC3\u667A\u8DDF vfs \u72B6\u6001\u8131\u8282)\u3002`
+  );
+}
+function resolveAssetRef(ref, ctx, paramName = "ref") {
+  if (typeof ref !== "string") {
+    throw new EditorAPIError("INVALID_PARAMETER", `${paramName} \u5FC5\u987B\u662F\u5B57\u7B26\u4E32`);
+  }
+  if (!ref) {
+    throw new EditorAPIError("INVALID_PARAMETER", `${paramName} \u4E0D\u80FD\u4E3A\u7A7A`);
+  }
+  if (!ref.startsWith("/")) {
+    throw new EditorAPIError(
+      "INVALID_PARAMETER",
+      `${paramName} \u5FC5\u987B\u662F vfs \u7EDD\u5BF9\u8DEF\u5F84\uFF08\u4EE5 / \u5F00\u5934\uFF0C\u4E14**\u5FC5\u5E26 extname**\uFF09\uFF0C\u4F8B\u5982 "/Materials/ground.mat"\u3002\u6536\u5230: "${ref}"`
+    );
+  }
+  const vfs = ctx.vfs;
+  const file2 = vfs.getFileByPath?.(ref);
+  if (!file2) {
+    throw new EditorAPIError("ASSET_NOT_FOUND", `${paramName}: ${ref}`);
+  }
+  return file2.id;
+}
+function validateFolderIdParam(folderId, ctx) {
+  if (folderId === void 0)
+    return void 0;
+  if (folderId === "") {
+    throw new EditorAPIError(
+      "INVALID_PARAMETER",
+      "folder \u4E0D\u80FD\u662F\u7A7A\u5B57\u7B26\u4E32\u3002\u5982\u9700\u521B\u5EFA\u5728\u6839\u76EE\u5F55,\u8BF7\u7701\u7565 folder \u53C2\u6570(\u4F20 undefined)\u3002"
+    );
+  }
+  if (!folderId.startsWith("/")) {
+    throw new EditorAPIError(
+      "INVALID_PARAMETER",
+      `folder \u5FC5\u987B\u662F vfs \u7EDD\u5BF9\u8DEF\u5F84(\u4EE5 / \u5F00\u5934),\u4F8B\u5982 "/Textures"\u3002\u6536\u5230: "${folderId}"`
+    );
+  }
+  const vfs = ctx.vfs;
+  const file2 = vfs.getFileByPath?.(folderId);
+  if (!file2) {
+    throw new EditorAPIError(
+      "FOLDER_NOT_FOUND",
+      `folder "${folderId}" \u4E0D\u5B58\u5728\u3002\u5728\u5F53\u524D\u5DE5\u5177\u4E4B\u524D\u8BF7\u5148\u8C03\u7528 folder.create({ path: "${folderId}", recursive: true }),folder.create \u662F\u5E42\u7B49\u7684(\u5DF2\u5B58\u5728\u7684 folder \u76F4\u63A5 reuse \u4E0D\u62A5\u9519),\u53EF\u653E\u5FC3\u9632\u5FA1\u6027\u8C03\u7528\u3002`
+    );
+  }
+  const folder = ctx.assetStore.getAsset(file2.id);
+  if (!folder) {
+    throw new EditorAPIError(
+      "FOLDER_NOT_FOUND",
+      `folder "${folderId}" \u5728 vfs \u91CC\u6709 entry \u4F46\u5BF9\u5E94 asset \u4E0D\u5B58\u5728(\u5185\u90E8\u72B6\u6001\u4E0D\u4E00\u81F4)\u3002\u8BF7\u91CD\u8BD5\u6216\u5237\u65B0\u9875\u9762\u3002`
+    );
+  }
+  const metaConfig = folder.getMetaConfig();
+  if (metaConfig.type !== "Folder") {
+    throw new EditorAPIError(
+      "INVALID_PARAMETER",
+      `\u8DEF\u5F84 "${folderId}" \u5DF2\u88AB ${metaConfig.type} \u8D44\u4EA7\u5360\u7528,\u65E0\u6CD5\u7528\u4F5C folder\u3002\u8BF7\u6539\u7528\u5176\u4ED6\u8DEF\u5F84\u540D(\u4F8B\u5982\u52A0\u590D\u6570 "/${folderId.replace(/^\//, "")}s" \u6216 "/${metaConfig.type}s/...")\u3002`
+    );
+  }
+  return file2.id;
+}
+function normalizeColor2(color) {
+  if (!color || typeof color !== "object")
+    return void 0;
+  const c6 = color;
+  if (typeof c6.r === "number" && typeof c6.g === "number" && typeof c6.b === "number") {
+    const a6 = typeof c6.a === "number" ? c6.a : 1;
+    return [c6.r, c6.g, c6.b, a6];
+  }
+  if (Array.isArray(c6) && c6.length >= 3) {
+    return [c6[0], c6[1], c6[2], c6[3] ?? 1];
+  }
+  return void 0;
+}
+var FOLDER_PARAM_DESCRIPTION;
+var init_helpers = __esm({
+  "../editor-api/src/tools/asset/helpers.ts"() {
+    "use strict";
+    init_errors3();
+    FOLDER_PARAM_DESCRIPTION = "\u76EE\u6807\u6587\u4EF6\u5939 vfs \u7EDD\u5BF9\u8DEF\u5F84(\u4EE5 / \u5F00\u5934,\u5982 '/Textures')\u3002\u7701\u7565\u5219\u521B\u5EFA\u5728\u6839\u76EE\u5F55\u3002**\u524D\u7F6E\u6761\u4EF6**:folder \u5FC5\u987B\u5148\u5B58\u5728 \u2014 \u63A8\u8350\u5728\u8C03\u7528\u672C\u5DE5\u5177\u524D\u5148\u8C03 folder.create({ path, recursive: true }) (\u5E42\u7B49,\u5DF2\u5B58\u5728\u4E0D\u62A5\u9519),\u907F\u514D FOLDER_NOT_FOUND\u3002";
+  }
+});
+
 // ../editor-api/src/tools/asset/material/schema.ts
 var TEXTURE_REF_DESC, materialPropsSchema, materialCreateInputSchema, materialReadInputSchema, materialUpdateInputSchema, materialDetailSchema, materialCreateOutputSchema, materialReadOutputSchema, materialUpdateOutputSchema;
 var init_schema = __esm({
@@ -141574,7 +141766,8 @@ var init_schema = __esm({
     "use strict";
     init_zod();
     init_common();
-    TEXTURE_REF_DESC = (kind) => `${kind}\u7EB9\u7406\u5F15\u7528:vfs \u7EDD\u5BF9\u8DEF\u5F84,\u5982 /Textures/diffuse\u3002output \u4E2D\u82E5\u5F15\u7528 builtin \u8D44\u4EA7\u6216\u4E0D\u5728 vfs,\u8FD4\u56DE null\u3002input \u4E2D\u76EE\u524D\u4E0D\u63A5\u53D7 null(\u6E05\u9664\u5F15\u7528\u7684\u8BED\u4E49\u672A\u5B9E\u73B0) \u2014 \u60F3\u4FDD\u6301\u539F\u5F15\u7528\u5C31\u7701\u7565\u8BE5\u5B57\u6BB5\u3002`;
+    init_helpers();
+    TEXTURE_REF_DESC = (kind) => `${kind}\u7EB9\u7406\u5F15\u7528:vfs \u7EDD\u5BF9\u8DEF\u5F84,**\u5FC5\u5E26\u7269\u7406\u6587\u4EF6\u540E\u7F00**(\u5982 .png/.jpg/.hdr),\u5982 /Textures/diffuse.png\u3002output \u4E2D\u82E5\u5F15\u7528 builtin \u8D44\u4EA7\u6216\u4E0D\u5728 vfs,\u8FD4\u56DE null\u3002input \u4E2D\u76EE\u524D\u4E0D\u63A5\u53D7 null(\u6E05\u9664\u5F15\u7528\u7684\u8BED\u4E49\u672A\u5B9E\u73B0) \u2014 \u60F3\u4FDD\u6301\u539F\u5F15\u7528\u5C31\u7701\u7565\u8BE5\u5B57\u6BB5\u3002`;
     materialPropsSchema = external_exports.object({
       // 颜色属性
       baseColor: colorSchema.optional().describe("\u57FA\u7840\u989C\u8272\uFF0C\u5982 {r:1, g:0, b:0, a:1} \u8868\u793A\u7EA2\u8272"),
@@ -141605,7 +141798,7 @@ var init_schema = __esm({
     }).describe("PBR \u6750\u8D28\u5C5E\u6027");
     materialCreateInputSchema = external_exports.object({
       name: external_exports.string().min(1).max(128).describe("\u6750\u8D28\u540D\u79F0"),
-      folder: external_exports.string().optional().describe("\u76EE\u6807\u6587\u4EF6\u5939 vfs \u8DEF\u5F84\uFF0C\u7701\u7565\u5219\u521B\u5EFA\u5728\u6839\u76EE\u5F55"),
+      folder: external_exports.string().optional().describe(FOLDER_PARAM_DESCRIPTION),
       // 颜色
       baseColor: colorSchema.optional().default({ r: 1, g: 1, b: 1, a: 1 }).describe("\u57FA\u7840\u989C\u8272\uFF0C\u9ED8\u8BA4\u767D\u8272"),
       emissiveColor: colorSchema.optional().describe("\u81EA\u53D1\u5149\u989C\u8272"),
@@ -141631,10 +141824,10 @@ var init_schema = __esm({
       materials: external_exports.never({ message: "material.create \u662F\u5355\u4E2A\u64CD\u4F5C\uFF0C\u4E0D\u63A5\u53D7 materials \u6570\u7EC4\u3002\u6279\u91CF\u521B\u5EFA\u8BF7\u591A\u6B21\u8C03\u7528\u3002" }).optional()
     }).describe("\u521B\u5EFA\u6750\u8D28\u7684\u53C2\u6570");
     materialReadInputSchema = external_exports.object({
-      path: external_exports.string().describe("\u6750\u8D28\u8D44\u4EA7 vfs \u8DEF\u5F84\uFF0C\u5982 /Materials/foo")
+      path: external_exports.string().describe("\u6750\u8D28\u8D44\u4EA7 vfs \u8DEF\u5F84,**\u5FC5\u5E26 .mat \u540E\u7F00**,\u5982 /Materials/foo.mat")
     }).describe("\u8BFB\u53D6\u6750\u8D28\u7684\u53C2\u6570");
     materialUpdateInputSchema = external_exports.object({
-      path: external_exports.string().describe("\u6750\u8D28\u8D44\u4EA7 vfs \u8DEF\u5F84\uFF0C\u5982 /Materials/foo"),
+      path: external_exports.string().describe("\u6750\u8D28\u8D44\u4EA7 vfs \u8DEF\u5F84,**\u5FC5\u5E26 .mat \u540E\u7F00**,\u5982 /Materials/foo.mat"),
       // 颜色
       baseColor: colorSchema.optional().describe("\u57FA\u7840\u989C\u8272"),
       emissiveColor: colorSchema.optional().describe("\u81EA\u53D1\u5149\u989C\u8272"),
@@ -141674,109 +141867,6 @@ var init_schema = __esm({
   }
 });
 
-// ../editor-api/src/tools/asset/helpers.ts
-async function resolveAssetSnapshot(assetId, ctx, options) {
-  const { assetStore } = ctx;
-  const asset3 = assetStore.getAsset(assetId);
-  if (!asset3) {
-    throw new EditorAPIError("ASSET_NOT_FOUND", assetId);
-  }
-  const metaConfig = asset3.getMetaConfig();
-  let props = {};
-  if (typeof asset3.getMainData === "function") {
-    try {
-      const mainData = asset3.getMainData();
-      const assetType = metaConfig.type;
-      if (assetType === "script") {
-        if (typeof mainData === "string") {
-          props.code = mainData;
-        }
-      } else if (typeof mainData === "string") {
-        props = JSON.parse(mainData);
-      } else if (mainData && typeof mainData === "object") {
-        props = JSON.parse(JSON.stringify(mainData));
-      }
-    } catch {
-    }
-  }
-  if (options?.fallbackProps && Object.keys(options.fallbackProps).length > 0) {
-    props = { ...props, ...options.fallbackProps };
-  }
-  return {
-    path: getAssetPath(asset3.id, ctx),
-    name: asset3.name,
-    type: metaConfig.type,
-    props
-  };
-}
-function getAssetPath(assetId, ctx) {
-  if (!assetId)
-    return null;
-  const vfs = ctx.vfs;
-  const file2 = vfs?.getFileById?.(assetId);
-  return file2?.path ?? null;
-}
-function resolveAssetRef(ref, ctx, paramName = "ref") {
-  if (typeof ref !== "string") {
-    throw new EditorAPIError("INVALID_PARAMETER", `${paramName} \u5FC5\u987B\u662F\u5B57\u7B26\u4E32`);
-  }
-  if (!ref) {
-    throw new EditorAPIError("INVALID_PARAMETER", `${paramName} \u4E0D\u80FD\u4E3A\u7A7A`);
-  }
-  if (!ref.startsWith("/")) {
-    throw new EditorAPIError(
-      "INVALID_PARAMETER",
-      `${paramName} \u5FC5\u987B\u662F vfs \u7EDD\u5BF9\u8DEF\u5F84\uFF08\u4EE5 / \u5F00\u5934\uFF09\uFF0C\u4F8B\u5982 "/Materials/ground"\u3002\u6536\u5230: "${ref}"`
-    );
-  }
-  const vfs = ctx.vfs;
-  const file2 = vfs.getFileByPath?.(ref);
-  if (!file2) {
-    throw new EditorAPIError("ASSET_NOT_FOUND", `${paramName}: ${ref}`);
-  }
-  return file2.id;
-}
-function validateFolderExists(folderId, ctx) {
-  const { assetStore } = ctx;
-  const folder = assetStore.getAsset(folderId);
-  if (!folder) {
-    throw new EditorAPIError("FOLDER_NOT_FOUND", folderId);
-  }
-  const metaConfig = folder.getMetaConfig();
-  if (metaConfig.type !== "Folder") {
-    throw new EditorAPIError("INVALID_PARAMETER", `${folderId} is not a folder (type: ${metaConfig.type})`);
-  }
-}
-function validateFolderIdParam(folderId, ctx) {
-  if (folderId === void 0)
-    return void 0;
-  if (folderId === "") {
-    throw new EditorAPIError("INVALID_PARAMETER", "folder cannot be empty string, use undefined for root");
-  }
-  const folderUuid = resolveAssetRef(folderId, ctx, "folder");
-  validateFolderExists(folderUuid, ctx);
-  return folderUuid;
-}
-function normalizeColor2(color) {
-  if (!color || typeof color !== "object")
-    return void 0;
-  const c6 = color;
-  if (typeof c6.r === "number" && typeof c6.g === "number" && typeof c6.b === "number") {
-    const a6 = typeof c6.a === "number" ? c6.a : 1;
-    return [c6.r, c6.g, c6.b, a6];
-  }
-  if (Array.isArray(c6) && c6.length >= 3) {
-    return [c6[0], c6[1], c6[2], c6[3] ?? 1];
-  }
-  return void 0;
-}
-var init_helpers = __esm({
-  "../editor-api/src/tools/asset/helpers.ts"() {
-    "use strict";
-    init_errors3();
-  }
-});
-
 // ../editor-api/src/tools/asset/material/extract.ts
 function extractMaterialProperties(asset3, ctx) {
   const props = {};
@@ -142202,7 +142292,7 @@ var init_create_geometry = __esm({
       mesh: primitiveMeshEnum.describe("\u57FA\u7840\u7F51\u683C\u7C7B\u578B"),
       parentEntityId: external_exports.string().nullable().optional().describe("\u7236\u5B9E\u4F53 ID,\u4E0D\u4F20\u6216 null \u5219\u521B\u5EFA\u5728\u6839\u7EA7"),
       transform: transformSchema.optional().describe("\u521D\u59CB\u53D8\u6362\uFF08\u4F4D\u7F6E/\u65CB\u8F6C/\u7F29\u653E\uFF09"),
-      material: external_exports.string().optional().describe("\u6750\u8D28\u8D44\u4EA7\u5F15\u7528\uFF1Avfs \u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u5982 /Materials/ground"),
+      material: external_exports.string().optional().describe("\u6750\u8D28\u8D44\u4EA7\u5F15\u7528:vfs \u7EDD\u5BF9\u8DEF\u5F84,**\u5FC5\u5E26 .mat \u540E\u7F00**,\u5982 /Materials/ground.mat"),
       inlineMaterial: inlineMaterialSchema.optional().describe("\u5185\u8054\u6750\u8D28\u5B9A\u4E49\uFF08\u521B\u5EFA\u65B0\u6750\u8D28\uFF09")
     }).describe("\u521B\u5EFA\u5E26\u51E0\u4F55\u4F53\u7684\u5B9E\u4F53\u53C2\u6570");
     createGeometryOutputSchema = entityInfoSchema.extend({
@@ -142955,7 +143045,9 @@ var init_schemas3 = __esm({
         "\u7EC4\u4EF6\u7C7B\u578B\u540D,\u5982 'DirectLight'\u3001'Camera'\u3001'ParticleRenderer'\u3002\u6CE8:editor API \u4E2D\u7684 `ParticleRenderer` \u5BF9\u5E94 Galacean Engine 2.0 \u4E2D\u7684 `ParticleGenerator` \u7C7B(\u8FD0\u884C\u65F6\u5B9E\u9645\u7C7B\u540D)\u3002\u7F16\u8F91\u5668/\u84DD\u56FE\u5C42\u7528 `ParticleRenderer` \u547D\u540D,realizer \u5B9E\u9645\u64CD\u4F5C\u7684\u662F ParticleGenerator \u5B9E\u4F8B\u3002"
       ),
       props: external_exports.record(external_exports.string(), external_exports.unknown()).optional().describe("\u7EC4\u4EF6\u5C5E\u6027\uFF0C\u7ED3\u6784\u4E0E\u573A\u666F JSON \u4E00\u81F4"),
-      ref: external_exports.string().optional().describe("\u7EC4\u4EF6\u5F15\u7528\u8D44\u6E90\uFF1Avfs \u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u5982 /Scripts/dice\u3002\u5982 Script \u7EC4\u4EF6\u7684\u811A\u672C\u8D44\u4EA7\u5F15\u7528"),
+      ref: external_exports.string().optional().describe(
+        "\u7EC4\u4EF6\u5F15\u7528\u8D44\u6E90:vfs \u7EDD\u5BF9\u8DEF\u5F84,**\u5FC5\u5E26 extname**(Script \u5FC5\u5E26 .ts),\u5982 /Scripts/dice.ts\u3002\u5982 Script \u7EC4\u4EF6\u7684\u811A\u672C\u8D44\u4EA7\u5F15\u7528"
+      ),
       methods: external_exports.record(external_exports.string(), external_exports.unknown()).optional().describe(
         "\u7EC4\u4EF6\u65B9\u6CD5\u8C03\u7528\u5E8F\u5217(\u5982 ParticleRenderer.setMaterial\u3001Collider.addShape);\u7ED3\u6784\u4E0E\u573A\u666F JSON methods \u5B57\u6BB5\u4E00\u81F4\u3002\u6CE8:ParticleRenderer \u5728 Engine 2.0 \u4E2D\u5B9E\u9645\u662F ParticleGenerator \u7C7B(editor API \u5C42\u4FDD\u7559 ParticleRenderer \u547D\u540D)\u3002"
       )
@@ -143797,7 +143889,7 @@ var init_schema4 = __esm({
     "use strict";
     init_zod();
     MESH_REF_DESC = "\u7F51\u683C\u8D44\u4EA7\u5F15\u7528:vfs \u7EDD\u5BF9\u8DEF\u5F84,\u5FC5\u987B\u6307\u5411\u5355\u72EC Mesh \u8D44\u4EA7(\u5982 /Models/dice-mesh)\u3002\u26A0\uFE0F \u6574\u4F53 glTF \u6A21\u578B(\u542B\u5C42\u7EA7 + \u591A\u6750\u8D28)\u8BF7\u7528 gltf.instantiate \u800C\u4E0D\u662F\u624B\u6302 MeshRenderer;\u5185\u7F6E\u57FA\u7840\u7F51\u683C(Cube/Sphere \u7B49)\u8BF7\u7528 primitiveMesh \u5B57\u6BB5\u3002(output \u4E2D\u82E5\u5F15\u7528 builtin \u8D44\u4EA7\u6216\u4E0D\u5728 vfs,\u8FD4\u56DE null)";
-    MATERIAL_REF_DESC = "\u6750\u8D28\u8D44\u4EA7\u5F15\u7528\uFF1Avfs \u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u5982 /Materials/ground\uFF08output \u4E2D\u82E5\u5F15\u7528 builtin \u8D44\u4EA7\u6216\u4E0D\u5728 vfs\uFF0C\u8FD4\u56DE null\uFF09";
+    MATERIAL_REF_DESC = "\u6750\u8D28\u8D44\u4EA7\u5F15\u7528:vfs \u7EDD\u5BF9\u8DEF\u5F84,**\u5FC5\u5E26 .mat \u540E\u7F00**,\u5982 /Materials/ground.mat(output \u4E2D\u82E5\u5F15\u7528 builtin \u8D44\u4EA7\u6216\u4E0D\u5728 vfs,\u8FD4\u56DE null)";
     primitiveMeshTypeEnum = external_exports.enum(["Cube", "Sphere", "Plane", "Cylinder", "Capsule", "Cone", "Torus"]).describe("\u57FA\u7840\u7F51\u683C\u7C7B\u578B");
     meshRendererPropsSchema = external_exports.object({
       mesh: external_exports.string().nullable().optional().describe(MESH_REF_DESC),
@@ -145324,13 +145416,13 @@ var init_schema6 = __esm({
     init_zod();
     animatorAddInputSchema = external_exports.object({
       entityId: external_exports.string().describe("\u76EE\u6807\u5B9E\u4F53 ID"),
-      controller: external_exports.string().optional().describe("\u52A8\u753B\u63A7\u5236\u5668\u8D44\u4EA7\u5F15\u7528\uFF1Avfs \u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u5982 /Animators/dice"),
+      controller: external_exports.string().optional().describe("\u52A8\u753B\u63A7\u5236\u5668\u8D44\u4EA7\u5F15\u7528:vfs \u7EDD\u5BF9\u8DEF\u5F84,**\u5FC5\u5E26 .animCtrl \u540E\u7F00**,\u5982 /Animators/dice.animCtrl"),
       enabled: external_exports.boolean().optional().default(true).describe("\u662F\u5426\u542F\u7528\uFF0C\u9ED8\u8BA4 true"),
       speed: external_exports.number().optional().default(1).describe("\u52A8\u753B\u64AD\u653E\u901F\u5EA6\uFF0C\u9ED8\u8BA4 1")
     }).describe("\u6DFB\u52A0 Animator \u7EC4\u4EF6\u7684\u53C2\u6570");
     animatorUpdateInputSchema = external_exports.object({
       entityId: external_exports.string().describe("\u76EE\u6807\u5B9E\u4F53 ID"),
-      controller: external_exports.string().optional().describe("\u52A8\u753B\u63A7\u5236\u5668\u8D44\u4EA7\u5F15\u7528:vfs \u7EDD\u5BF9\u8DEF\u5F84,\u5982 /Animators/dice"),
+      controller: external_exports.string().optional().describe("\u52A8\u753B\u63A7\u5236\u5668\u8D44\u4EA7\u5F15\u7528:vfs \u7EDD\u5BF9\u8DEF\u5F84,**\u5FC5\u5E26 .animCtrl \u540E\u7F00**,\u5982 /Animators/dice.animCtrl"),
       enabled: external_exports.boolean().optional().describe("\u662F\u5426\u542F\u7528\u7EC4\u4EF6"),
       speed: external_exports.number().optional().describe("\u52A8\u753B\u64AD\u653E\u901F\u5EA6")
     }).describe(
@@ -145338,7 +145430,7 @@ var init_schema6 = __esm({
     );
     animatorPropsSchema = external_exports.object({
       controller: external_exports.string().nullable().optional().describe(
-        "\u52A8\u753B\u63A7\u5236\u5668\u8D44\u4EA7\u5F15\u7528\uFF1Avfs \u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u5982 /Animators/dice\uFF08output \u4E2D\u82E5\u5F15\u7528 builtin \u8D44\u4EA7\u6216\u4E0D\u5728 vfs\uFF0C\u8FD4\u56DE null\uFF09"
+        "\u52A8\u753B\u63A7\u5236\u5668\u8D44\u4EA7\u5F15\u7528:vfs \u7EDD\u5BF9\u8DEF\u5F84,**\u5FC5\u5E26 .animCtrl \u540E\u7F00**,\u5982 /Animators/dice.animCtrl(output \u4E2D\u82E5\u5F15\u7528 builtin \u8D44\u4EA7\u6216\u4E0D\u5728 vfs,\u8FD4\u56DE null)"
       ),
       speed: external_exports.number().optional().describe("\u52A8\u753B\u64AD\u653E\u901F\u5EA6"),
       enabled: external_exports.boolean().optional().describe("\u662F\u5426\u542F\u7528")
@@ -145670,7 +145762,7 @@ var init_schema8 = __esm({
       entityId: external_exports.string().describe("\u76EE\u6807\u5B9E\u4F53 ID"),
       color: colorSchema.optional().default({ r: 1, g: 1, b: 1, a: 1 }).describe("\u56FE\u7247\u989C\u8272"),
       sprite: external_exports.string().optional().describe(
-        "Sprite \u8D44\u4EA7 vfs \u7EDD\u5BF9\u8DEF\u5F84,\u5982 /Sprites/icon\u3002\u26A0\uFE0F \u4E0D\u80FD\u76F4\u63A5\u4F20 Texture \u8DEF\u5F84(\u5982 /Textures/icon.png \u4F1A\u663E\u793A\u7A7A\u767D)\u3002Sprite \u662F Texture \u7684\u5305\u88C5(\u52A0 region/pivot/border \u914D\u7F6E),\u9700\u5148 `sprite.create({ name, texture: '/Textures/icon.png' })` \u521B\u5EFA,\u518D\u4F20 Sprite \u7684 path\u3002\u5B8C\u6574\u5DE5\u4F5C\u6D41:texture.create \u2192 sprite.create \u2192 uiImage.add"
+        "Sprite \u8D44\u4EA7 vfs \u7EDD\u5BF9\u8DEF\u5F84,**\u5FC5\u5E26 .sprite \u540E\u7F00**,\u5982 /Sprites/icon.sprite\u3002\u26A0\uFE0F \u4E0D\u80FD\u76F4\u63A5\u4F20 Texture \u8DEF\u5F84(\u5982 /Textures/icon.png \u4F1A\u663E\u793A\u7A7A\u767D)\u3002Sprite \u662F Texture \u7684\u5305\u88C5(\u52A0 region/pivot/border \u914D\u7F6E),\u9700\u5148 `sprite.create({ name, texture: '/Textures/icon.png' })` \u521B\u5EFA,\u518D\u4F20 Sprite \u7684 path\u3002\u5B8C\u6574\u5DE5\u4F5C\u6D41:texture.create \u2192 sprite.create \u2192 uiImage.add"
       ),
       raycastEnabled: external_exports.boolean().optional().default(true).describe("\u662F\u5426\u63A5\u6536\u5C04\u7EBF\u68C0\u6D4B")
     }).describe("\u6DFB\u52A0 UIImage \u7EC4\u4EF6\u7684\u53C2\u6570");
@@ -145687,7 +145779,7 @@ var init_schema8 = __esm({
       horizontalAlignment: textHorizontalAlignmentEnum.optional().default("Center").describe("\u6C34\u5E73\u5BF9\u9F50"),
       verticalAlignment: textVerticalAlignmentEnum.optional().default("Center").describe("\u5782\u76F4\u5BF9\u9F50"),
       fontStyle: fontStyleEnum.optional().describe("\u5B57\u4F53\u6837\u5F0F"),
-      font: external_exports.string().optional().describe("\u5B57\u4F53\u8D44\u4EA7\u5F15\u7528\uFF1Avfs \u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u5982 /Fonts/main"),
+      font: external_exports.string().optional().describe("\u5B57\u4F53\u8D44\u4EA7\u5F15\u7528:vfs \u7EDD\u5BF9\u8DEF\u5F84,**\u5FC5\u5E26\u7269\u7406\u6587\u4EF6\u540E\u7F00**(.ttf/.otf/.woff),\u5982 /Fonts/main.ttf"),
       enableWrapping: external_exports.boolean().optional().default(true).describe("\u662F\u5426\u542F\u7528\u81EA\u52A8\u6362\u884C"),
       overflowMode: external_exports.enum(["Overflow", "Truncate"]).optional().describe("\u6EA2\u51FA\u6A21\u5F0F")
     }).describe("\u6DFB\u52A0 UIText \u7EC4\u4EF6\u7684\u53C2\u6570");
@@ -147506,6 +147598,7 @@ var init_create2 = __esm({
       handler: async (params, ctx) => {
         const { assetFacade } = ctx;
         const folderUuid = validateFolderIdParam(params.folder, ctx);
+        assertAssetNameAvailable(params.name, folderUuid ?? null, "Material", ctx);
         const props = {};
         if (params.baseColor)
           props.baseColor = params.baseColor;
@@ -147552,6 +147645,7 @@ var init_schema10 = __esm({
     "use strict";
     init_zod();
     init_common();
+    init_helpers();
     scriptTemplateEnum = external_exports.enum(["default", "stateMachine", "unlitUIScript", "pbrUIScript", "defaultUIScript"]);
     scriptSubTypeEnum = external_exports.enum(["Default", "StateMachine", "ShaderUI"]);
     scriptPropsSchema = external_exports.object({
@@ -147560,7 +147654,7 @@ var init_schema10 = __esm({
     }).describe("\u811A\u672C\u5C5E\u6027");
     scriptCreateInputSchema = external_exports.object({
       name: external_exports.string().min(1).max(128).describe("\u811A\u672C\u540D\u79F0\uFF0C\u5982 'MyScript.ts'"),
-      folder: external_exports.string().optional().describe("\u76EE\u6807\u6587\u4EF6\u5939 vfs \u8DEF\u5F84\uFF0C\u7701\u7565\u5219\u521B\u5EFA\u5728\u6839\u76EE\u5F55"),
+      folder: external_exports.string().optional().describe(FOLDER_PARAM_DESCRIPTION),
       template: scriptTemplateEnum.optional().default("default").describe(
         "\u811A\u672C\u6A21\u677F\u7C7B\u578B,\u51B3\u5B9A\u521D\u59CB code \u5185\u5BB9:(1) 'default' \u2014 \u6807\u51C6 Script(onAwake/onStart/onUpdate),\u6700\u5E38\u7528,\u6302\u5230\u666E\u901A entity\u3002(2) 'stateMachine' \u2014 StateMachineScript,\u6302\u5728 AnimatorController \u7684 state \u4E0A,onStateEnter/Exit \u94A9\u5B50\u3002(3) 'defaultUIScript' / 'unlitUIScript' / 'pbrUIScript' \u2014 UI \u4E13\u7528 Script,Inspector \u8868\u5355\u542B UI/Material \u5B57\u6BB5\u3002"
       ),
@@ -147752,6 +147846,7 @@ var init_create3 = __esm({
       handler: async (params, ctx) => {
         const { assetFacade, assetStore } = ctx;
         const folderUuid = validateFolderIdParam(params.folder, ctx);
+        assertAssetNameAvailable(normalizeScriptName(params.name), folderUuid ?? null, "Script", ctx);
         const result2 = await createScriptAssetInternal(
           {
             name: params.name,
@@ -148022,7 +148117,9 @@ var init_create4 = __esm({
       id: "asset.create",
       description: "\u521B\u5EFA\u8D44\u4EA7\u3002\u4F18\u5148\u7528\u4E13\u7528\u5DE5\u5177(material.create / texture.create / script.create / prefab.create / folder.create / animationClip.create / animatorController.create / audio.create / font.create / gltf.create / spine.create) \u2014 \u5B83\u4EEC\u6709\u66F4\u7CBE\u786E\u7684\u5B57\u6BB5\u3002\u672C\u5DE5\u5177\u7528\u4E8E\u4E13\u7528\u5DE5\u5177\u672A\u8986\u76D6\u7684\u7C7B\u578B(PhysicsMaterial / Markdown / Shader / ShaderChunk / SpriteAtlas / PrimitiveMesh / AmbientLight / XRReferenceImage \u7B49)\u3002",
       input: external_exports.object({
-        path: external_exports.string().describe("\u8D44\u4EA7\u7684\u76EE\u6807 vfs \u8DEF\u5F84,\u5982 /Materials/Steel \u6216 /Folder/SubFolder/Asset\u3002\u7236\u6587\u4EF6\u5939\u5FC5\u987B\u5B58\u5728"),
+        path: external_exports.string().describe(
+          "\u8D44\u4EA7\u7684\u76EE\u6807 vfs \u8DEF\u5F84,**\u5FC5\u5E26\u5BF9\u5E94\u7C7B\u578B\u7684 extname**(\u7531 type \u51B3\u5B9A)\u3002\u7236\u6587\u4EF6\u5939\u5FC5\u987B\u5B58\u5728\u3002extname \u901F\u67E5:Material\u2192.mat / Scene\u2192.scene / Prefab\u2192.prefab / Sprite\u2192.sprite / AnimationClip\u2192.anim / AnimatorController\u2192.animCtrl / Script\u2192.ts / Folder\u2192(\u65E0)\u3002\u4F8B:`/Materials/Steel.mat`\u3001`/Scenes/Main.scene`\u3001`/Folders/SubFolder`(Folder \u65E0 extname)\u3002"
+        ),
         type: external_exports.string().describe(
           "\u8D44\u4EA7\u7C7B\u578B\u3002\u7ED3\u6784\u5316\u521B\u5EFA(props \u76F4\u63A5\u7ED9\u5C5E\u6027): Material / Script / Folder / Scene / Prefab / AnimationClip / AnimatorController / Sprite / SpriteAtlas / PrimitiveMesh / PhysicsMaterial / Markdown / Shader / ShaderChunk\u3002\u4E0A\u4F20\u521B\u5EFA(props.source \u5FC5\u586B,URL/\u672C\u5730\u8DEF\u5F84/data URI): Texture / Audio / glTF / Font / SpineSkeletonData / AmbientLight / XRReferenceImage"
         ),
@@ -148119,6 +148216,7 @@ var init_schema11 = __esm({
   "../editor-api/src/tools/asset/texture/schema.ts"() {
     "use strict";
     init_zod();
+    init_helpers();
     init_common();
     textureTypeEnum = external_exports.enum(["Texture"]).describe("\u7EB9\u7406\u7C7B\u578B(2D \u7EB9\u7406)");
     textureFilterModeEnum = external_exports.enum(["Point", "Bilinear", "Trilinear"]).describe("\u7EB9\u7406\u8FC7\u6EE4\u6A21\u5F0F");
@@ -148142,15 +148240,15 @@ var init_schema11 = __esm({
     textureCreateInputSchema = textureCreateMetaSchema.extend({
       name: external_exports.string().min(1).max(128).describe("\u7EB9\u7406\u540D\u79F0"),
       textureType: textureTypeEnum.optional().default("Texture").describe("\u7EB9\u7406\u7C7B\u578B,\u9ED8\u8BA4 Texture(2D \u7EB9\u7406)"),
-      folder: external_exports.string().optional().describe("\u76EE\u6807\u6587\u4EF6\u5939 vfs \u8DEF\u5F84\uFF0C\u7701\u7565\u5219\u521B\u5EFA\u5728\u6839\u76EE\u5F55"),
+      folder: external_exports.string().optional().describe(FOLDER_PARAM_DESCRIPTION),
       // 纹理来源（三选一）
       source: external_exports.string().min(1).optional().describe("\u7EB9\u7406\u6765\u6E90\uFF1AURL\u3001\u672C\u5730\u6587\u4EF6\u8DEF\u5F84\u6216 data URI\uFF08\u5982 data:image/png;base64,...\uFF09")
     }).describe("\u521B\u5EFA\u7EB9\u7406\u7684\u53C2\u6570");
     textureReadInputSchema = external_exports.object({
-      path: external_exports.string().describe("\u7EB9\u7406\u8D44\u4EA7 vfs \u8DEF\u5F84\uFF0C\u5982 /Textures/foo")
+      path: external_exports.string().describe("\u7EB9\u7406\u8D44\u4EA7 vfs \u8DEF\u5F84,**\u5FC5\u5E26\u7269\u7406\u6587\u4EF6\u540E\u7F00**(\u7531\u6E90\u6587\u4EF6\u51B3\u5B9A,\u5982 .png/.jpg/.webp/.hdr),\u5982 /Textures/foo.png")
     }).describe("\u8BFB\u53D6\u7EB9\u7406\u7684\u53C2\u6570");
     textureUpdateInputSchema = external_exports.object({
-      path: external_exports.string().describe("\u7EB9\u7406\u8D44\u4EA7 vfs \u8DEF\u5F84\uFF0C\u5982 /Textures/foo"),
+      path: external_exports.string().describe("\u7EB9\u7406\u8D44\u4EA7 vfs \u8DEF\u5F84,**\u5FC5\u5E26\u7269\u7406\u6587\u4EF6\u540E\u7F00**(\u7531\u6E90\u6587\u4EF6\u51B3\u5B9A,\u5982 .png/.jpg/.webp/.hdr),\u5982 /Textures/foo.png"),
       filterMode: textureFilterModeEnum.optional().describe("\u8FC7\u6EE4\u6A21\u5F0F"),
       wrapModeU: textureWrapModeEnum.optional().describe("U \u8F74\u73AF\u7ED5\u6A21\u5F0F"),
       wrapModeV: textureWrapModeEnum.optional().describe("V \u8F74\u73AF\u7ED5\u6A21\u5F0F"),
@@ -148158,7 +148256,7 @@ var init_schema11 = __esm({
       mipmap: external_exports.boolean().optional().describe("\u662F\u5426\u751F\u6210 mipmap")
     }).describe("\u66F4\u65B0\u7EB9\u7406\u7684\u53C2\u6570");
     textureDeleteInputSchema = external_exports.object({
-      path: external_exports.string().describe("\u7EB9\u7406\u8D44\u4EA7 vfs \u8DEF\u5F84\uFF0C\u5982 /Textures/foo")
+      path: external_exports.string().describe("\u7EB9\u7406\u8D44\u4EA7 vfs \u8DEF\u5F84,**\u5FC5\u5E26\u7269\u7406\u6587\u4EF6\u540E\u7F00**(\u7531\u6E90\u6587\u4EF6\u51B3\u5B9A,\u5982 .png/.jpg/.webp/.hdr),\u5982 /Textures/foo.png")
     }).describe("\u5220\u9664\u7EB9\u7406\u7684\u53C2\u6570");
     textureDetailSchema = assetInfoSchema.extend({
       props: texturePropsSchema.optional().describe("\u7EB9\u7406\u5C5E\u6027")
@@ -148381,7 +148479,7 @@ var init_write = __esm({
       id: "asset.update",
       description: "\u66F4\u65B0\u8D44\u4EA7\u5C5E\u6027\u3002Material(PBR \u53C2\u6570)\u3001Texture(\u8FC7\u6EE4/\u73AF\u7ED5\u6A21\u5F0F)\u3001Script(\u6E90\u4EE3\u7801)\u3001Markdown(\u6587\u672C)\u3002Prefab/Scene \u7684\u5B9E\u4F53\u6570\u636E\u8BF7\u7528 entity.* / component.* \u5DE5\u5177\u3002",
       input: external_exports.object({
-        path: external_exports.string().describe("\u8D44\u4EA7 vfs \u8DEF\u5F84,\u5982 /Materials/Steel"),
+        path: external_exports.string().describe("\u8D44\u4EA7 vfs \u8DEF\u5F84,**\u5FC5\u5E26 extname**,\u5982 /Materials/Steel.mat"),
         props: external_exports.record(external_exports.string(), external_exports.unknown()).describe("\u8981\u66F4\u65B0\u7684\u5C5E\u6027,\u5B57\u6BB5\u540D\u4E0E asset.read \u8F93\u51FA\u5BF9\u79F0")
       }),
       output: external_exports.object({
@@ -148423,8 +148521,10 @@ var init_move = __esm({
       id: "asset.move",
       description: "\u79FB\u52A8\u6216\u91CD\u547D\u540D\u8D44\u4EA7\u3002src \u662F\u539F\u8DEF\u5F84,dest \u662F\u65B0\u8DEF\u5F84(\u53EF\u6539\u7236\u76EE\u5F55\u3001\u6539\u6587\u4EF6\u540D\u3001\u6216\u540C\u65F6\u6539) \u2014 \u4E00\u4E2A\u5DE5\u5177\u8986\u76D6 move + rename\u3002\u76EE\u6807\u8DEF\u5F84\u5DF2\u5B58\u5728\u540C\u540D\u8D44\u4EA7(\u4E14\u4E0D\u662F src \u81EA\u8EAB)\u65F6\u629B INVALID_PARAMETER,\u907F\u514D\u5236\u9020 ambiguous path\u3002",
       input: external_exports.object({
-        src: external_exports.string().describe("\u6E90\u8D44\u4EA7 vfs \u8DEF\u5F84,\u5982 /Materials/Steel"),
-        dest: external_exports.string().describe("\u76EE\u6807 vfs \u8DEF\u5F84,\u5982 /Materials/Sub/Steel(\u79FB\u52A8)\u6216 /Materials/Iron(\u91CD\u547D\u540D)")
+        src: external_exports.string().describe("\u6E90\u8D44\u4EA7 vfs \u8DEF\u5F84,**\u5FC5\u5E26 extname**,\u5982 /Materials/Steel.mat"),
+        dest: external_exports.string().describe(
+          "\u76EE\u6807 vfs \u8DEF\u5F84,**\u5FC5\u5E26 extname**,\u5982 /Materials/Sub/Steel.mat(\u79FB\u52A8)\u6216 /Materials/Iron.mat(\u91CD\u547D\u540D)\u3002extname \u5FC5\u987B\u8DDF src \u7684 type \u4E00\u81F4(asset.move \u4E0D\u6539 type)\u3002"
+        )
       }),
       output: external_exports.object({
         name: external_exports.string(),
@@ -292052,7 +292152,8 @@ function assetIdToVirtualPath(state, assetId) {
     folders.unshift(folder.name);
     parentId = folder.parentFolderId;
   }
-  return `${folders.length ? `${folders.join("/")}/` : ""}${asset3.name}`;
+  const assetName = asset3.type === "Folder" ? asset3.name : assetNameFromPath(asset3.name, asset3.type);
+  return `${folders.length ? `${folders.join("/")}/` : ""}${assetName}`;
 }
 function virtualPathToAssetId(state, virtualPath) {
   if (state.assets[virtualPath])
@@ -292081,6 +292182,7 @@ function createSourceAssetKindResolver2(state) {
 var init_sceneSwap = __esm({
   "../model/src/headless/sceneSwap.ts"() {
     "use strict";
+    init_sync_adapter();
     init_scene_file_v2();
     init_hydrateSourceV2SceneToDomain();
   }
@@ -292516,8 +292618,10 @@ var init_copy = __esm({
       id: "asset.copy",
       description: "\u590D\u5236\u8D44\u4EA7\u5230\u65B0\u8DEF\u5F84\u3002\u6587\u4EF6\u5939\u4F1A\u9012\u5F52\u590D\u5236\u6240\u6709\u5B50\u9879,\u5355\u6B21\u539F\u5B50\u64CD\u4F5C + \u5355\u6B21 undo \u5373\u53EF\u64A4\u9500\u6574\u6B21\u590D\u5236\u3002",
       input: external_exports.object({
-        src: external_exports.string().describe("\u6E90\u8D44\u4EA7 vfs \u8DEF\u5F84"),
-        dest: external_exports.string().describe("\u76EE\u6807 vfs \u8DEF\u5F84(\u542B\u65B0\u540D\u5B57),\u5982 /Materials/Steel_copy")
+        src: external_exports.string().describe("\u6E90\u8D44\u4EA7 vfs \u8DEF\u5F84,**\u5FC5\u5E26 extname**,\u5982 /Materials/Steel.mat"),
+        dest: external_exports.string().describe(
+          "\u76EE\u6807 vfs \u8DEF\u5F84(\u542B\u65B0\u540D\u5B57),**\u5FC5\u5E26 extname**,\u5982 /Materials/Steel_copy.mat\u3002extname \u5FC5\u987B\u8DDF src \u7684 type \u4E00\u81F4(asset.copy \u4E0D\u6539 type)\u3002"
+        )
       }),
       output: external_exports.object({
         name: external_exports.string(),
@@ -292663,6 +292767,7 @@ async function handleUploadAssetCreate(params, ctx, config2) {
   const { blob, ext } = await fetchBlobFromUrlOrPath(params.source, mimeMap, { urlValidator });
   await onBlobFetched?.(blob);
   const fileName = params.name.endsWith(ext) ? params.name : `${params.name}${ext}`;
+  assertAssetNameAvailable(fileName, folderUuid ?? null, assetType, ctx);
   const file2 = new File([blob], fileName, { type: blob.type });
   const asset3 = await ctx.assetFacade.createAssetByUpload({
     uploadAssetFile: { main: file2 },
@@ -292766,9 +292871,10 @@ var init_schema12 = __esm({
     init_zod();
     init_src();
     init_common();
+    init_helpers();
     audioCreateInputSchema = external_exports.object({
       name: external_exports.string().min(1).max(128).describe("\u97F3\u9891\u540D\u79F0"),
-      folder: external_exports.string().optional().describe("\u76EE\u6807\u6587\u4EF6\u5939 vfs \u8DEF\u5F84\uFF0C\u7701\u7565\u5219\u521B\u5EFA\u5728\u6839\u76EE\u5F55"),
+      folder: external_exports.string().optional().describe(FOLDER_PARAM_DESCRIPTION),
       source: external_exports.string().min(1).optional().describe(`\u97F3\u9891\u6765\u6E90\uFF1AURL\u3001\u672C\u5730\u6587\u4EF6\u8DEF\u5F84\u6216 data URI\uFF08\u652F\u6301 ${AUDIO_EXT_LIST.join(" / ")}\uFF09`)
     }).describe("\u521B\u5EFA\u97F3\u9891\u8D44\u4EA7\u7684\u53C2\u6570");
     audioCreateOutputSchema = assetInfoSchema.describe("\u521B\u5EFA\u540E\u7684\u97F3\u9891\u8D44\u4EA7\u4FE1\u606F");
@@ -292817,9 +292923,10 @@ var init_schema13 = __esm({
     "use strict";
     init_zod();
     init_common();
+    init_helpers();
     gltfCreateInputSchema = external_exports.object({
       name: external_exports.string().min(1).max(128).describe("glTF \u8D44\u4EA7\u540D\u79F0"),
-      folder: external_exports.string().optional().describe("\u76EE\u6807\u6587\u4EF6\u5939 vfs \u8DEF\u5F84\uFF0C\u7701\u7565\u5219\u521B\u5EFA\u5728\u6839\u76EE\u5F55"),
+      folder: external_exports.string().optional().describe(FOLDER_PARAM_DESCRIPTION),
       source: external_exports.string().min(1).optional().describe(
         "glTF \u6765\u6E90\uFF1AURL\u3001\u672C\u5730\u6587\u4EF6\u8DEF\u5F84\u6216 data URI\u3002\u5F53\u524D\u4EC5\u652F\u6301 .glb \u5355\u6587\u4EF6\u683C\u5F0F\uFF08\u591A\u6587\u4EF6 .gltf+.bin+textures \u9700\u7528 zip \u65B9\u5F0F\u5BFC\u5165\uFF0CPhase 2\uFF09"
       )
@@ -292855,7 +292962,7 @@ var init_schema13 = __esm({
     }).describe("\u521B\u5EFA\u540E\u7684 glTF \u8D44\u4EA7\u4FE1\u606F");
     gltfImportZipInputSchema = external_exports.object({
       source: external_exports.string().min(1).describe("zip \u5305\u6765\u6E90\uFF1AURL / \u672C\u5730\u6587\u4EF6\u8DEF\u5F84 / data URI"),
-      folder: external_exports.string().optional().describe("\u76EE\u6807\u6587\u4EF6\u5939 vfs \u8DEF\u5F84\uFF0C\u7701\u7565\u5219\u521B\u5EFA\u5728\u6839\u76EE\u5F55"),
+      folder: external_exports.string().optional().describe(FOLDER_PARAM_DESCRIPTION),
       name: external_exports.string().min(1).max(128).optional().describe("\u8D44\u4EA7\u540D\uFF08\u4E0D\u542B\u6269\u5C55\u540D\uFF09\uFF0C\u7701\u7565\u65F6\u4ECE zip \u5185\u4E3B\u6587\u4EF6\u540D\u63A8\u65AD")
     }).describe("\u4ECE zip \u5305\u5BFC\u5165\u591A\u6587\u4EF6 glTF \u7684\u53C2\u6570");
     gltfImportZipOutputSchema = assetInfoSchema.describe(
@@ -293513,7 +293620,7 @@ var require_stream_writable = __commonJS({
       pna.nextTick(cb, er);
     }
     function validChunk(stream, state, chunk2, cb) {
-      var valid = true;
+      var valid2 = true;
       var er = false;
       if (chunk2 === null) {
         er = new TypeError("May not write null values to stream");
@@ -293523,9 +293630,9 @@ var require_stream_writable = __commonJS({
       if (er) {
         stream.emit("error", er);
         pna.nextTick(cb, er);
-        valid = false;
+        valid2 = false;
       }
-      return valid;
+      return valid2;
     }
     Writable.prototype.write = function(chunk2, encoding, cb) {
       var state = this._writableState;
@@ -302939,9 +303046,10 @@ var init_schema14 = __esm({
     "use strict";
     init_zod();
     init_common();
+    init_helpers();
     fontCreateInputSchema = external_exports.object({
       name: external_exports.string().min(1).max(128).describe("\u5B57\u4F53\u540D\u79F0"),
-      folder: external_exports.string().optional().describe("\u76EE\u6807\u6587\u4EF6\u5939 vfs \u8DEF\u5F84\uFF0C\u7701\u7565\u5219\u521B\u5EFA\u5728\u6839\u76EE\u5F55"),
+      folder: external_exports.string().optional().describe(FOLDER_PARAM_DESCRIPTION),
       source: external_exports.string().min(1).optional().describe("\u5B57\u4F53\u6765\u6E90\uFF1AURL\u3001\u672C\u5730\u6587\u4EF6\u8DEF\u5F84\u6216 data URI\uFF08\u652F\u6301 .ttf / .otf / .woff\uFF09")
     }).describe("\u521B\u5EFA\u5B57\u4F53\u8D44\u4EA7\u7684\u53C2\u6570");
     fontCreateOutputSchema = assetInfoSchema.describe("\u521B\u5EFA\u540E\u7684\u5B57\u4F53\u8D44\u4EA7\u4FE1\u606F");
@@ -302993,6 +303101,7 @@ var init_schema15 = __esm({
   "../editor-api/src/tools/asset/spine/schema.ts"() {
     "use strict";
     init_zod();
+    init_helpers();
     init_common();
     sourceSchema = external_exports.object({
       source: external_exports.string().min(1).optional().describe("\u6765\u6E90\uFF1AURL\u3001\u672C\u5730\u6587\u4EF6\u8DEF\u5F84\u6216 data URI")
@@ -303002,7 +303111,7 @@ var init_schema15 = __esm({
     });
     spineCreateInputSchema = external_exports.object({
       name: external_exports.string().min(1).max(128).describe("Spine \u8D44\u4EA7\u57FA\u7840\u540D\uFF08\u4E0D\u542B\u6269\u5C55\u540D\uFF0C\u4F8B\u5982 'hero'\uFF09"),
-      folder: external_exports.string().optional().describe("\u76EE\u6807\u6587\u4EF6\u5939 vfs \u8DEF\u5F84\uFF0C\u7701\u7565\u5219\u521B\u5EFA\u5728\u6839\u76EE\u5F55"),
+      folder: external_exports.string().optional().describe(FOLDER_PARAM_DESCRIPTION),
       skeleton: sourceSchema.describe("\u9AA8\u9ABC\u6570\u636E\u6587\u4EF6\uFF1A.json\uFF08\u6587\u672C\uFF09\u6216 .skel\uFF08\u4E8C\u8FDB\u5236\uFF09"),
       atlas: sourceSchema.describe("\u56FE\u96C6\u6587\u4EF6\uFF1A.atlas \u7EAF\u6587\u672C"),
       textures: external_exports.array(textureSourceSchema).min(1).describe("\u7EB9\u7406\u6587\u4EF6\u5217\u8868\uFF1A.png / .jpg / .jpeg / .webp\uFF0C\u81F3\u5C11 1 \u4E2A")
@@ -303130,6 +303239,7 @@ var init_create9 = __esm({
         assertSourcePresent(params.skeleton, "skeleton");
         assertSourcePresent(params.atlas, "atlas");
         params.textures.forEach((t8, i6) => assertSourcePresent(t8, `textures[${i6}]`));
+        assertAssetNameAvailable(`${params.name}.atlas`, folderUuid ?? null, "SpineAtlas", ctx);
         const { rootStore: rootStore2 } = ctx;
         ensureAssetTypeRegistered(rootStore2.assetRegistry, "Texture");
         ensureAssetTypeRegistered(rootStore2.assetRegistry, "SpineAtlas");
@@ -303178,6 +303288,7 @@ var init_schema16 = __esm({
   "../editor-api/src/tools/asset/sprite/schema.ts"() {
     "use strict";
     init_zod();
+    init_helpers();
     init_common();
     spriteRegionSchema = external_exports.object({
       x: external_exports.number().min(0).max(1).describe("\u533A\u57DF\u8D77\u70B9 x(0-1,texture \u5F52\u4E00\u5316\u5750\u6807)"),
@@ -303197,7 +303308,7 @@ var init_schema16 = __esm({
     }).describe("\u4E5D\u5BAB\u683C Sliced/Tiled \u6A21\u5F0F\u7684 border,\u9ED8\u8BA4\u5168 0(\u666E\u901A Simple \u6A21\u5F0F\u4E0D\u7528)");
     spriteCreateInputSchema = external_exports.object({
       name: external_exports.string().min(1).max(128).describe("Sprite \u8D44\u4EA7\u540D\u79F0(\u4E0D\u542B\u6269\u5C55\u540D)"),
-      folder: external_exports.string().optional().describe("\u76EE\u6807\u6587\u4EF6\u5939 vfs \u8DEF\u5F84,\u7701\u7565\u5219\u521B\u5EFA\u5728\u6839\u76EE\u5F55"),
+      folder: external_exports.string().optional().describe(FOLDER_PARAM_DESCRIPTION),
       texture: external_exports.string().describe(
         "\u5FC5\u586B,Texture \u8D44\u4EA7 vfs \u7EDD\u5BF9\u8DEF\u5F84,\u5982 /Textures/logo.png\u3002Sprite \u662F Texture \u7684**\u5305\u88C5**,\u5FC5\u987B\u5148 texture.create({ source:... }) \u6216 asset.create({ type:'Texture', props:{ source:... }}) \u521B\u5EFA Texture,\u518D\u7528 sprite.create \u5305\u88C5\u3002uiImage.add / spriteRenderer.add \u5F15\u7528\u7684\u4E0D\u662F Texture,\u662F Sprite,\u6240\u4EE5\u8FD9\u4E00\u6B65\u4E0D\u80FD\u7701\u3002"
       ),
@@ -303227,6 +303338,7 @@ var init_create10 = __esm({
       output: spriteCreateOutputSchema,
       handler: async (params, ctx) => {
         const folderUuid = validateFolderIdParam(params.folder, ctx);
+        assertAssetNameAvailable(params.name, folderUuid ?? null, "Sprite", ctx);
         const textureUuid = resolveAssetRef(params.texture, ctx, "texture");
         const textureAsset = ctx.assetStore.getAsset(textureUuid);
         if (!textureAsset) {
@@ -303279,6 +303391,7 @@ var init_schema17 = __esm({
     "use strict";
     init_zod();
     init_common();
+    init_helpers();
     animationClipInterpolationEnum = external_exports.enum(["Linear", "CubicSpine", "Step", "Hermite"]).describe("\u63D2\u503C\u65B9\u5F0F;Linear=\u7EBF\u6027(\u9ED8\u8BA4),Step=\u9636\u68AF,CubicSpine=\u4E09\u6B21\u6837\u6761,Hermite=Hermite \u66F2\u7EBF");
     keyframeValueTypeEnum = external_exports.enum(["Number", "Boolean", "Vector2", "Vector3", "Vector4", "Color"]).describe(
       "\u5173\u952E\u5E27\u503C\u7C7B\u578B;Number=\u6807\u91CF\u3001Boolean=\u5E03\u5C14\u3001Vector2={x,y}\u3001Vector3={x,y,z}\u3001Vector4={x,y,z,w}\u3001Color={r,g,b,a}\u3002Transform.position \u7528 Vector3,rotation \u7528 Vector3 (\u6B27\u62C9) \u6216 Vector4 (\u56DB\u5143\u6570)"
@@ -303316,7 +303429,7 @@ var init_schema17 = __esm({
     }).describe("\u52A8\u753B\u4E8B\u4EF6;\u5230\u8FBE time \u65F6\u8C03\u7528 entity \u4E0A\u811A\u672C\u7684 functionName(parameter)");
     animationClipCreateInputSchema = external_exports.object({
       name: external_exports.string().min(1).max(128).describe("\u52A8\u753B\u7247\u6BB5\u540D\u79F0"),
-      folder: external_exports.string().optional().describe("\u76EE\u6807\u6587\u4EF6\u5939 vfs \u8DEF\u5F84,\u7701\u7565\u5219\u521B\u5EFA\u5728\u6839\u76EE\u5F55"),
+      folder: external_exports.string().optional().describe(FOLDER_PARAM_DESCRIPTION),
       tracks: external_exports.array(animationClipTrackSchema).optional().describe(
         "\u52A8\u753B tracks \u5217\u8868;\u6BCF\u6761 track \u7ED1\u5B9A entity \u4E0A\u4E00\u4E2A\u7EC4\u4EF6\u5C5E\u6027 + \u5173\u952E\u5E27\u5E8F\u5217\u3002\u3010\u793A\u4F8B 1:Transform.position 1 \u79D2\u5185\u5411\u4E0A\u8DF3\u8DC3 2 \u7C73\u3011[{ targetPath: '', componentType: 'Transform', property: 'position', valueType: 'Vector3', keys: [{ time: 0, value: {x:0,y:0,z:0} }, { time: 0.5, value: {x:0,y:2,z:0} }, { time: 1, value: {x:0,y:0,z:0} }] }]\u3010\u793A\u4F8B 2:\u5B50\u5B9E\u4F53\u7684\u65CB\u8F6C (Y \u8F74 360\xB0)\u3011[{ targetPath: 'spine/leftArm', componentType: 'Transform', property: 'rotation', valueType: 'Vector3', keys: [{ time: 0, value: {x:0,y:0,z:0} }, { time: 1, value: {x:0,y:360,z:0} }] }]\u3010\u793A\u4F8B 3:MeshRenderer \u6750\u8D28\u989C\u8272\u6E10\u53D8 (\u7EA2 \u2192 \u84DD)\u3011[{ targetPath: '', componentType: 'MeshRenderer', property: 'material.baseColor', valueType: 'Color', keys: [{ time: 0, value: {r:1,g:0,b:0,a:1} }, { time: 1, value: {r:0,g:0,b:1,a:1} }] }]\u3010\u793A\u4F8B 4:\u591A track \u540C\u6B65 (\u4F4D\u7F6E + \u7F29\u653E \u4E00\u5E76\u6539)\u3011[{ targetPath: '', componentType: 'Transform', property: 'position', valueType: 'Vector3', keys: [{time:0,value:{x:0,y:0,z:0}},{time:1,value:{x:5,y:0,z:0}}] }, { targetPath: '', componentType: 'Transform', property: 'scale', valueType: 'Vector3', keys: [{time:0,value:{x:1,y:1,z:1}},{time:1,value:{x:2,y:2,z:2}}] }]\u5E38\u89C1\u9519\u8BEF:Vector3 \u6F0F\u5199 z \u5B57\u6BB5 \u2192 \u88AB Zod 2D union \u62A2\u5339\u914D\u9759\u9ED8\u4E22\u5B57\u6BB5\u3002\u5EFA\u8BAE\u663E\u5F0F\u58F0\u660E valueType \u8BA9 handler \u5F3A\u6821\u9A8C\u3002"
       ),
@@ -303413,6 +303526,7 @@ var init_create11 = __esm({
       output: animationClipCreateOutputSchema,
       handler: async (params, ctx) => {
         const folderUuid = validateFolderIdParam(params.folder, ctx);
+        assertAssetNameAvailable(params.name, folderUuid ?? null, "AnimationClip", ctx);
         const asset3 = await ctx.assetFacade.createAssetByAdd({
           assetType: "AnimationClip",
           name: params.name,
@@ -303454,6 +303568,7 @@ var init_schema18 = __esm({
     "use strict";
     init_zod();
     init_common();
+    init_helpers();
     animatorLayerBlendingModeEnum = external_exports.enum(["Override", "Additive"]).describe("\u5C42\u6DF7\u5408\u6A21\u5F0F;Override=\u8986\u76D6\u6DF7\u5408(\u9ED8\u8BA4),Additive=\u52A0\u6CD5\u6DF7\u5408(\u5206\u5C42\u52A8\u753B\u53E0\u52A0)");
     animatorWrapModeEnum = external_exports.enum(["Loop", "Once"]).describe("\u52A8\u753B wrap \u884C\u4E3A;Loop=\u5FAA\u73AF(\u9ED8\u8BA4),Once=\u64AD\u653E\u4E00\u6B21\u540E\u505C\u5728\u672B\u5E27");
     animatorConditionModeEnum = external_exports.enum(["Equals", "NotEquals", "Greater", "Less", "If", "IfNot"]).describe("Transition \u6761\u4EF6\u6BD4\u8F83\u6A21\u5F0F");
@@ -303502,7 +303617,7 @@ var init_schema18 = __esm({
     }).describe("AnimatorController \u53C2\u6570\u5B9A\u4E49");
     animatorControllerCreateInputSchema = external_exports.object({
       name: external_exports.string().min(1).max(128).describe("AnimatorController \u8D44\u4EA7\u540D(\u4E0D\u542B\u6269\u5C55\u540D)"),
-      folder: external_exports.string().optional().describe("\u76EE\u6807\u6587\u4EF6\u5939 vfs \u8DEF\u5F84,\u7701\u7565\u5219\u521B\u5EFA\u5728\u6839\u76EE\u5F55"),
+      folder: external_exports.string().optional().describe(FOLDER_PARAM_DESCRIPTION),
       layers: external_exports.array(animatorLayerSchema).optional().describe(
         "\u5C42\u5217\u8868(\u53EF\u9009);\u7701\u7565\u5219\u521B\u5EFA\u4E00\u4E2A\u7A7A\u7684 'Base' \u5C42(weight=1, blendingMode=Override, \u65E0 state)\u3002\u3010\u793A\u4F8B 1:\u5355\u5C42 idle \u2194 run \u5207\u6362\u3011[{ name: 'Base', stateMachine: { defaultStateName: 'idle', states: [{ name: 'idle', clip: '/Animations/idle.anim', wrapMode: 'Loop' }, { name: 'run', clip: '/Animations/run.anim', wrapMode: 'Loop',   transitions: [{ destinationStateName: 'idle', conditions: [{ parameterName: 'speed', mode: 'Less', threshold: 0.1 }] }] }] } }]\u3010\u793A\u4F8B 2:\u53CC\u5C42 blending (\u4E0B\u534A\u8EAB walk + \u4E0A\u534A\u8EAB attack)\u3011[{ name: 'LowerBody', weight: 1, blendingMode: 'Override', stateMachine: { defaultStateName: 'walk', states: [{ name: 'walk', clip: '/Animations/walk.anim', wrapMode: 'Loop' }] } }, { name: 'UpperBody', weight: 1, blendingMode: 'Additive', stateMachine: { defaultStateName: 'idleUpper', states: [  { name: 'idleUpper', clip: '/Animations/idle_upper.anim', wrapMode: 'Loop' },   { name: 'attack', clip: '/Animations/attack.anim', wrapMode: 'Once', transitions: [{ destinationStateName: 'idleUpper', hasExitTime: true, exitTime: 1.0 }] }] } }]\u3010\u793A\u4F8B 3:Trigger \u9A71\u52A8\u8DF3\u8F6C (\u6309\u4E00\u6B21\u8DF3\u8DC3)\u3011[{ name: 'Base', stateMachine: { defaultStateName: 'idle', states: [{ name: 'idle', clip: '/Animations/idle.anim', transitions: [{ destinationStateName: 'jump', conditions: [{ parameterName: 'jumpTrigger' }] }] }, { name: 'jump', clip: '/Animations/jump.anim', wrapMode: 'Once', transitions: [{ destinationStateName: 'idle', hasExitTime: true, exitTime: 1.0 }] }] } }] (\u914D\u5957 parameters: [{ name: 'jumpTrigger', type: 'Trigger' }])"
       ),
@@ -303728,6 +303843,7 @@ var init_create12 = __esm({
       output: animatorControllerCreateOutputSchema,
       handler: async (params, ctx) => {
         const folderUuid = validateFolderIdParam(params.folder, ctx);
+        assertAssetNameAvailable(params.name, folderUuid ?? null, "AnimatorController", ctx);
         const content = buildContent(params, ctx);
         const asset3 = await ctx.assetFacade.createAssetByAdd({
           assetType: "AnimatorController",
@@ -303757,7 +303873,7 @@ var init_read10 = __esm({
     init_schema18();
     init_storage();
     animatorControllerReadInputSchema = external_exports.object({
-      path: external_exports.string().describe("AnimatorController \u8D44\u4EA7 vfs \u8DEF\u5F84,\u5982 /Animators/dice")
+      path: external_exports.string().describe("AnimatorController \u8D44\u4EA7 vfs \u8DEF\u5F84,**\u5FC5\u5E26 .animCtrl \u540E\u7F00**,\u5982 /Animators/dice.animCtrl")
     }).describe("\u8BFB\u53D6 AnimatorController \u8D44\u4EA7\u7684\u53C2\u6570");
     animatorControllerReadOutputSchema = animatorControllerCreateOutputSchema.extend({
       // 返回结构跟 create input 一致,LLM 可以直接吃进去给 asset.update
@@ -304097,7 +304213,7 @@ var init_create13 = __esm({
     init_headless();
     folderCreate = defineTool({
       id: "folder.create",
-      description: "\u521B\u5EFA\u6587\u4EF6\u5939\u3002recursive=true(\u9ED8\u8BA4)\u65F6\u7C7B\u4F3C Unix mkdir -p,\u9012\u5F52\u521B\u5EFA\u4E2D\u95F4\u76EE\u5F55\u3002recursive=false \u65F6\u7236\u76EE\u5F55\u5FC5\u987B\u5DF2\u5B58\u5728\u3002",
+      description: "\u521B\u5EFA\u6587\u4EF6\u5939\u3002**\u5E42\u7B49** \u2014 \u5DF2\u5B58\u5728\u7684 folder \u76F4\u63A5 reuse \u4E0D\u62A5\u9519,\u53EF\u653E\u5FC3\u9632\u5FA1\u6027\u8C03\u7528\u3002recursive=true(\u9ED8\u8BA4)\u65F6\u7C7B\u4F3C Unix mkdir -p,\u9012\u5F52\u521B\u5EFA\u4E2D\u95F4\u76EE\u5F55\u3002recursive=false \u65F6\u7236\u76EE\u5F55\u5FC5\u987B\u5DF2\u5B58\u5728\u3002**\u4F7F\u7528\u5EFA\u8BAE**:\u5728 texture.create / sprite.create / material.create / scene.create \u7B49\u4EFB\u4F55\u63A5\u53D7 folder \u53C2\u6570\u7684\u5DE5\u5177\u4E4B\u524D,\u90FD\u5E94\u8BE5\u5148\u8C03\u4E00\u6B21 folder.create({ path, recursive: true }) \u786E\u4FDD folder \u5B58\u5728\u3002**\u8DEF\u5F84\u51B2\u7A81**:\u67D0\u4E9B\u8DEF\u5F84\u5DF2\u88AB\u9879\u76EE\u9ED8\u8BA4\u8D44\u4EA7\u5360\u7528(\u5982\u6839 Scene \u8D44\u4EA7\u5360\u7528 /Scene),\u4F1A\u629B INVALID_PARAMETER,\u6B64\u65F6\u5E94\u6539\u7528\u5176\u4ED6\u8DEF\u5F84\u540D(\u4F8B\u5982 /Scenes \u590D\u6570\u5F62\u5F0F)\u3002",
       input: folderCreateInputSchema,
       output: folderCreateOutputSchema,
       handler: async (params, ctx) => {
@@ -304258,18 +304374,21 @@ var init_schema20 = __esm({
     "use strict";
     init_zod();
     init_common();
+    init_helpers();
     prefabCreateInputSchema = external_exports.object({
       entityId: external_exports.string().describe("\u6E90\u5B9E\u4F53 ID\uFF0C\u5C06\u6B64\u5B9E\u4F53\u53CA\u5176\u5B50\u5B9E\u4F53\u4FDD\u5B58\u4E3A\u9884\u5236\u4EF6"),
       name: external_exports.string().optional().describe("\u9884\u5236\u4EF6\u540D\u79F0\uFF0C\u9ED8\u8BA4\u4F7F\u7528\u5B9E\u4F53\u540D\u79F0"),
-      folder: external_exports.string().optional().describe("\u76EE\u6807\u6587\u4EF6\u5939 vfs \u8DEF\u5F84\uFF0C\u7701\u7565\u5219\u521B\u5EFA\u5728\u6839\u76EE\u5F55")
+      folder: external_exports.string().optional().describe(FOLDER_PARAM_DESCRIPTION)
     }).describe(
       "\u4ECE\u573A\u666F\u5185\u5B9E\u4F53\u521B\u5EFA Prefab \u8D44\u4EA7\u7684\u53C2\u6570\u3002\u9002\u7528:\u5DF2\u7ECF\u5728\u573A\u666F\u91CC\u624B\u6302\u597D\u5C42\u7EA7\u548C\u7EC4\u4EF6\u7684\u5B9E\u4F53,\u60F3\u4FDD\u5B58\u4E3A\u9884\u5236\u4EF6\u590D\u7528\u3002\u5BF9\u6BD4 asset.create({ type: 'Prefab', props: <source v2 prefab file> }):\u540E\u8005\u4ECE\u539F\u59CB prefab \u6587\u4EF6\u7ED3\u6784(JSON)\u76F4\u63A5\u521B\u5EFA,\u9002\u7528\u4EE3\u7801\u751F\u6210\u3002"
     );
     prefabReadInputSchema = external_exports.object({
-      prefab: external_exports.string().describe("\u9884\u5236\u4EF6\u8D44\u4EA7 vfs \u8DEF\u5F84\uFF0C\u5982 /Prefabs/foo\u3002glTF \u8D44\u4EA7\u901A\u7528\u5143\u4FE1\u606F\u8BF7\u7528 asset.info\u3002")
+      prefab: external_exports.string().describe(
+        "\u9884\u5236\u4EF6\u8D44\u4EA7 vfs \u8DEF\u5F84,**\u5FC5\u5E26 .prefab \u540E\u7F00**,\u5982 /Prefabs/foo.prefab\u3002glTF \u8D44\u4EA7\u901A\u7528\u5143\u4FE1\u606F\u8BF7\u7528 asset.info\u3002"
+      )
     }).describe("\u8BFB\u53D6\u9884\u5236\u4EF6\u8D44\u4EA7\u4FE1\u606F\u7684\u53C2\u6570");
     prefabInstantiateInputSchema = external_exports.object({
-      prefab: external_exports.string().describe("\u9884\u5236\u4EF6\u8D44\u4EA7 vfs \u8DEF\u5F84,\u5982 /Prefabs/foo\u3002glTF \u6A21\u578B\u8BF7\u7528 gltf.instantiate\u3002"),
+      prefab: external_exports.string().describe("\u9884\u5236\u4EF6\u8D44\u4EA7 vfs \u8DEF\u5F84,**\u5FC5\u5E26 .prefab \u540E\u7F00**,\u5982 /Prefabs/foo.prefab\u3002glTF \u6A21\u578B\u8BF7\u7528 gltf.instantiate\u3002"),
       parentEntityId: external_exports.string().optional().describe("\u7236\u5B9E\u4F53 ID,\u9ED8\u8BA4\u4E3A\u573A\u666F\u6839\u8282\u70B9"),
       position: vector3Schema.optional().describe("\u5B9E\u4F8B\u5316\u4F4D\u7F6E\uFF0C\u9ED8\u8BA4\u4E3A\u539F\u70B9"),
       rotation: vector3Schema.optional().describe("\u5B9E\u4F8B\u5316\u65CB\u8F6C\uFF08\u6B27\u62C9\u89D2\uFF09\uFF0C\u9ED8\u8BA4\u4E3A\u96F6\u65CB\u8F6C"),
@@ -304359,6 +304478,7 @@ var init_create14 = __esm({
         }
         const folderUuid = validateFolderIdParam(params.folder, ctx);
         const prefabName = params.name ?? entityModel?.name ?? domainEntity?.name ?? "Prefab";
+        assertAssetNameAvailable(prefabName, folderUuid ?? null, "Prefab", ctx);
         const entitySource = entityModel ?? domainEntity;
         const prefabAsset = await assetFacade.createAssetByAdd({
           assetType: "Prefab",
@@ -304590,7 +304710,7 @@ var init_schema21 = __esm({
     audioSourceAddInputSchema = external_exports.object({
       entityId: external_exports.string().describe("\u76EE\u6807\u5B9E\u4F53 ID"),
       clip: external_exports.string().optional().describe(
-        "AudioClip \u8D44\u4EA7\u5F15\u7528:vfs \u7EDD\u5BF9\u8DEF\u5F84,\u5982 /Audio/click\u3002\u5DE5\u4F5C\u6D41:asset.create({ type: 'Audio', props: { source: <url|path|dataURI> } }) \u6216 audio.create \u4E0A\u4F20\u97F3\u9891 \u2192 audioSource.add \u5F15\u7528\u5B83\u3002"
+        "AudioClip \u8D44\u4EA7\u5F15\u7528:vfs \u7EDD\u5BF9\u8DEF\u5F84,**\u5FC5\u5E26\u7269\u7406\u6587\u4EF6\u540E\u7F00**(.mp3/.wav/.ogg),\u5982 /Audio/click.mp3\u3002\u5DE5\u4F5C\u6D41:asset.create({ type: 'Audio', props: { source: <url|path|dataURI> } }) \u6216 audio.create \u4E0A\u4F20\u97F3\u9891 \u2192 audioSource.add \u5F15\u7528\u5B83\u3002"
       ),
       volume: external_exports.number().min(0).max(1).optional().describe("\u97F3\u91CF(0-1),\u9ED8\u8BA4 1"),
       loop: external_exports.boolean().optional().describe("\u662F\u5426\u5FAA\u73AF\u64AD\u653E,\u9ED8\u8BA4 false"),
@@ -304602,7 +304722,7 @@ var init_schema21 = __esm({
     audioSourceUpdateInputSchema = external_exports.object({
       entityId: external_exports.string().describe("\u76EE\u6807\u5B9E\u4F53 ID"),
       componentId: external_exports.string().optional().describe("\u7EC4\u4EF6 ID\uFF08\u7CBE\u786E\u5B9A\u4F4D\uFF09"),
-      clip: external_exports.string().optional().describe("AudioClip \u8D44\u4EA7\u5F15\u7528\uFF1Avfs \u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u5982 /Audio/click"),
+      clip: external_exports.string().optional().describe("AudioClip \u8D44\u4EA7\u5F15\u7528:vfs \u7EDD\u5BF9\u8DEF\u5F84,**\u5FC5\u5E26\u7269\u7406\u6587\u4EF6\u540E\u7F00**(.mp3/.wav/.ogg),\u5982 /Audio/click.mp3"),
       volume: external_exports.number().min(0).max(1).optional().describe("\u97F3\u91CF (0-1)"),
       loop: external_exports.boolean().optional().describe("\u662F\u5426\u5FAA\u73AF\u64AD\u653E"),
       playOnEnabled: external_exports.boolean().optional().describe("\u7EC4\u4EF6\u542F\u7528\u65F6\u81EA\u52A8\u64AD\u653E"),
@@ -304612,7 +304732,7 @@ var init_schema21 = __esm({
     }).describe("\u66F4\u65B0 AudioSource \u7EC4\u4EF6\u7684\u53C2\u6570");
     audioSourcePropsSchema = external_exports.object({
       clip: external_exports.string().nullable().optional().describe(
-        "AudioClip \u8D44\u4EA7\u5F15\u7528\uFF1Avfs \u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u5982 /Audio/click\uFF08output \u4E2D\u82E5\u5F15\u7528 builtin \u8D44\u4EA7\u6216\u4E0D\u5728 vfs\uFF0C\u8FD4\u56DE null\uFF09"
+        "AudioClip \u8D44\u4EA7\u5F15\u7528:vfs \u7EDD\u5BF9\u8DEF\u5F84,**\u5FC5\u5E26\u7269\u7406\u6587\u4EF6\u540E\u7F00**(.mp3/.wav/.ogg),\u5982 /Audio/click.mp3(output \u4E2D\u82E5\u5F15\u7528 builtin \u8D44\u4EA7\u6216\u4E0D\u5728 vfs,\u8FD4\u56DE null)"
       ),
       volume: external_exports.number().optional(),
       loop: external_exports.boolean().optional(),
@@ -305072,7 +305192,9 @@ var init_schema23 = __esm({
     particleRendererAddInputSchema = external_exports.object({
       entityId: external_exports.string().describe("\u76EE\u6807\u5B9E\u4F53 ID"),
       renderMode: particleRenderModeEnum.optional().describe("\u6E32\u67D3\u6A21\u5F0F,\u9ED8\u8BA4 Billboard"),
-      material: external_exports.string().optional().describe("\u7C92\u5B50\u6750\u8D28\u8D44\u4EA7 vfs \u7EDD\u5BF9\u8DEF\u5F84,\u5982 /Materials/fire_particle\u3002\u7701\u7565\u5219\u7528\u5F15\u64CE\u5185\u7F6E\u9ED8\u8BA4\u6750\u8D28\u3002"),
+      material: external_exports.string().optional().describe(
+        "\u7C92\u5B50\u6750\u8D28\u8D44\u4EA7 vfs \u7EDD\u5BF9\u8DEF\u5F84,**\u5FC5\u5E26 .mat \u540E\u7F00**,\u5982 /Materials/fire_particle.mat\u3002\u7701\u7565\u5219\u7528\u5F15\u64CE\u5185\u7F6E\u9ED8\u8BA4\u6750\u8D28\u3002"
+      ),
       mesh: external_exports.string().optional().describe("\u7C92\u5B50\u7F51\u683C\u8D44\u4EA7 vfs \u7EDD\u5BF9\u8DEF\u5F84(\u4EC5 renderMode=Mesh \u65F6\u751F\u6548);\u7701\u7565\u5219\u7528\u9ED8\u8BA4 quad"),
       main: particleMainModuleSchema.optional().describe("\u4E3B\u6A21\u5757(duration/lifetime/speed/size/color/maxParticles)"),
       emission: particleEmissionModuleSchema.optional().describe("\u53D1\u5C04\u6A21\u5757(rate/shape)"),
@@ -305289,7 +305411,7 @@ var init_schema24 = __esm({
     init_enum_maps();
     spriteDrawModeEnum = external_exports.enum(["Simple", "Sliced", "Tiled"]).describe("\u7ED8\u5236\u6A21\u5F0F;Simple=\u6574\u4F53\u7F29\u653E(\u9ED8\u8BA4),Sliced=\u4E5D\u5BAB\u683C,Tiled=\u6309 border \u5E73\u94FA");
     spriteTileModeEnum = external_exports.enum(["Continuous", "Adaptive"]).describe("\u5E73\u94FA\u6A21\u5F0F(drawMode=Tiled \u65F6\u751F\u6548);Continuous=\u8FDE\u7EED(\u9ED8\u8BA4),Adaptive=\u6574\u6570\u5E73\u94FA");
-    SPRITE_REF_DESC = "Sprite \u8D44\u4EA7 vfs \u7EDD\u5BF9\u8DEF\u5F84,\u5982 /Sprites/player_idle\u3002\u26A0\uFE0F \u4E0D\u80FD\u76F4\u63A5\u4F20 Texture \u8DEF\u5F84(\u5982 /Textures/player.png \u4F1A\u663E\u793A\u7A7A\u767D)\u3002Sprite \u662F Texture \u7684\u5305\u88C5,\u9700\u5148 `sprite.create({ name, texture: '/Textures/player.png' })` \u521B\u5EFA,\u518D\u4F20 Sprite path\u3002\u5B8C\u6574\u5DE5\u4F5C\u6D41:texture.create \u2192 sprite.create \u2192 spriteRenderer.add";
+    SPRITE_REF_DESC = "Sprite \u8D44\u4EA7 vfs \u7EDD\u5BF9\u8DEF\u5F84,**\u5FC5\u5E26 .sprite \u540E\u7F00**,\u5982 /Sprites/player_idle.sprite\u3002\u26A0\uFE0F \u4E0D\u80FD\u76F4\u63A5\u4F20 Texture \u8DEF\u5F84(\u5982 /Textures/player.png \u4F1A\u663E\u793A\u7A7A\u767D)\u3002Sprite \u662F Texture \u7684\u5305\u88C5,\u9700\u5148 `sprite.create({ name, texture: '/Textures/player.png' })` \u521B\u5EFA,\u518D\u4F20 Sprite path\u3002\u5B8C\u6574\u5DE5\u4F5C\u6D41:texture.create \u2192 sprite.create \u2192 spriteRenderer.add";
     spriteRendererPropsSchema = external_exports.object({
       sprite: external_exports.string().nullable().optional().describe(SPRITE_REF_DESC),
       color: colorSchema.optional().describe("\u53E0\u52A0\u989C\u8272,\u9ED8\u8BA4\u767D\u8272"),
@@ -305513,7 +305635,7 @@ var init_schema25 = __esm({
     textVerticalAlignmentEnum2 = external_exports.enum(["Top", "Center", "Bottom"]).describe("\u5782\u76F4\u5BF9\u9F50");
     fontStyleEnum2 = external_exports.enum(["None", "Bold", "Italic"]).describe("\u5B57\u4F53\u6837\u5F0F");
     overflowModeEnum = external_exports.enum(["Overflow", "Truncate"]).describe("\u6EA2\u51FA\u5904\u7406;Overflow=\u6EA2\u51FA(\u9ED8\u8BA4),Truncate=\u88C1\u526A");
-    FONT_REF_DESC = "\u5B57\u4F53\u8D44\u4EA7\u5F15\u7528:vfs \u7EDD\u5BF9\u8DEF\u5F84,\u5982 /Fonts/Main\u3002\u7701\u7565\u5219\u7528\u5F15\u64CE\u9ED8\u8BA4\u5B57\u4F53\u3002";
+    FONT_REF_DESC = "\u5B57\u4F53\u8D44\u4EA7\u5F15\u7528:vfs \u7EDD\u5BF9\u8DEF\u5F84,**\u5FC5\u5E26\u7269\u7406\u6587\u4EF6\u540E\u7F00**(.ttf/.otf/.woff),\u5982 /Fonts/Main.ttf\u3002\u7701\u7565\u5219\u7528\u5F15\u64CE\u9ED8\u8BA4\u5B57\u4F53\u3002";
     textRendererPropsSchema = external_exports.object({
       text: external_exports.string().optional().describe("\u6587\u672C\u5185\u5BB9"),
       color: colorSchema.optional().describe("\u6587\u5B57\u989C\u8272"),
@@ -305855,7 +305977,39 @@ var init_project = __esm({
 });
 
 // ../editor-api/src/tools/scene/create.ts
-var sceneCreateInputSchema, sceneCreate;
+function collectSceneEntities(asset3) {
+  let raw;
+  try {
+    raw = asset3.getMainData?.();
+  } catch (err2) {
+    console.warn(`[scene.create] getMainData failed, entities=[]:`, err2);
+    return [];
+  }
+  if (typeof raw !== "string")
+    return [];
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (err2) {
+    console.warn(`[scene.create] scene file JSON.parse failed, entities=[]:`, err2);
+    return [];
+  }
+  const entitiesArr = parsed.entities ?? [];
+  const childIdToParentId = /* @__PURE__ */ new Map();
+  for (const e6 of entitiesArr) {
+    for (const childId of e6.children ?? []) {
+      childIdToParentId.set(childId, e6.id);
+    }
+  }
+  return entitiesArr.map((e6) => ({
+    id: e6.id,
+    name: e6.name ?? "",
+    parentId: childIdToParentId.get(e6.id) ?? null,
+    isActive: e6.isActive ?? true,
+    layer: e6.layer
+  }));
+}
+var sceneCreateInputSchema, sceneCreateOutputSchema, sceneCreate;
 var init_create15 = __esm({
   "../editor-api/src/tools/scene/create.ts"() {
     "use strict";
@@ -305866,15 +306020,21 @@ var init_create15 = __esm({
     init_helpers();
     sceneCreateInputSchema = external_exports.object({
       name: external_exports.string().min(1).max(128).describe("\u573A\u666F\u540D\u79F0"),
-      folder: external_exports.string().optional().describe("\u76EE\u6807\u6587\u4EF6\u5939 vfs \u8DEF\u5F84\uFF0C\u7701\u7565\u5219\u521B\u5EFA\u5728\u6839\u76EE\u5F55")
+      folder: external_exports.string().optional().describe(FOLDER_PARAM_DESCRIPTION)
+    });
+    sceneCreateOutputSchema = assetInfoSchema.extend({
+      entities: external_exports.array(entityInfoSchema).optional().describe(
+        "\u65B0\u5EFA\u573A\u666F\u91CC\u7684 entity \u5217\u8868(\u7ED3\u6784\u8DDF entity.find \u8F93\u51FA\u4E00\u81F4)\u3002\u5F15\u64CE\u521D\u59CB\u5316\u65B0\u573A\u666F\u65F6\u901A\u5E38\u4F1A\u6CE8\u5165 \u82E5\u5E72\u9ED8\u8BA4 entity(\u5982 Camera / DirectLight)\u2014 \u8FD9\u4E9B\u5C31\u662F\u573A\u666F\u7684\u73B0\u6709 entity,\u4E0D\u662F\u4E34\u65F6\u6A21\u677F\u3002"
+      )
     });
     sceneCreate = defineTool({
       id: "scene.create",
-      description: "\u521B\u5EFA\u573A\u666F\u8D44\u4EA7\u3002\u9ED8\u8BA4\u573A\u666F\u5185\u5BB9\uFF08Camera + DirectLight\uFF09\u7531\u5F15\u64CE\u81EA\u52A8\u751F\u6210\u3002",
+      description: "\u521B\u5EFA\u573A\u666F\u8D44\u4EA7\u6587\u4EF6\u3002\u4E0D\u4F1A\u5207\u6362\u5F53\u524D\u7F16\u8F91\u573A\u666F \u2014 \u540E\u7EED entity.create / component.add \u9ED8\u8BA4\u8FDB\u5165 active scene\u3002\u8981\u5728\u65B0\u573A\u666F\u5185\u642D\u5EFA,\u63A5\u7740\u8C03 scene.setActive(<\u8FD4\u56DE\u7684 path>)\u3002\u53EF\u8C03 scene.getActive \u67E5\u8BE2\u5F53\u524D\u6FC0\u6D3B\u573A\u666F\u3002\u65B0\u573A\u666F**\u901A\u5E38\u5DF2\u542B\u82E5\u5E72\u9ED8\u8BA4 entity**(\u5982 Camera / DirectLight),\u901A\u8FC7 output.entities \u67E5\u770B \u2014 \u5982\u4F55\u5904\u7406(\u590D\u7528 / \u5220\u9664 / \u5FFD\u7565)\u7531\u4F60\u6839\u636E\u4EFB\u52A1\u4E0A\u4E0B\u6587\u81EA\u884C\u51B3\u5B9A\u3002",
       input: sceneCreateInputSchema,
-      output: assetInfoSchema,
+      output: sceneCreateOutputSchema,
       handler: async (params, ctx) => {
         const folderUuid = validateFolderIdParam(params.folder, ctx);
+        assertAssetNameAvailable(params.name, folderUuid ?? null, "Scene", ctx);
         const asset3 = await ctx.assetFacade.createAssetByAdd({
           assetType: "Scene",
           name: params.name,
@@ -305884,7 +306044,42 @@ var init_create15 = __esm({
           throw new EditorAPIError("OPERATION_FAILED", "\u521B\u5EFA\u573A\u666F\u5931\u8D25");
         }
         await asset3.ensureReady();
-        return resolveAssetSnapshot(asset3.id, ctx);
+        const snapshot = await resolveAssetSnapshot(asset3.id, ctx);
+        return {
+          path: snapshot.path,
+          name: snapshot.name,
+          type: snapshot.type,
+          entities: collectSceneEntities(asset3)
+        };
+      }
+    });
+  }
+});
+
+// ../editor-api/src/tools/scene/get-active.ts
+var sceneGetActiveInputSchema, sceneGetActiveOutputSchema, sceneGetActive;
+var init_get_active = __esm({
+  "../editor-api/src/tools/scene/get-active.ts"() {
+    "use strict";
+    init_zod();
+    init_define();
+    init_helpers();
+    sceneGetActiveInputSchema = external_exports.object({});
+    sceneGetActiveOutputSchema = external_exports.object({
+      activeScenePath: external_exports.string().nullable().describe(
+        "\u5F53\u524D\u6FC0\u6D3B\u7684\u7F16\u8F91\u573A\u666F vfs \u7EDD\u5BF9\u8DEF\u5F84\u3002null \u8868\u793A\u65E0\u6FC0\u6D3B\u573A\u666F\u3002entity.create / component.add \u7B49\u64CD\u4F5C\u9ED8\u8BA4\u8FDB\u5165\u6B64\u573A\u666F\u3002"
+      )
+    });
+    sceneGetActive = defineTool({
+      id: "scene.getActive",
+      description: "\u67E5\u8BE2\u5F53\u524D\u6FC0\u6D3B\u7684\u7F16\u8F91\u573A\u666F\u8DEF\u5F84\u3002",
+      input: sceneGetActiveInputSchema,
+      output: sceneGetActiveOutputSchema,
+      handler: async (_26, ctx) => {
+        const sceneId = ctx.rootStore.currentSceneId;
+        return {
+          activeScenePath: sceneId ? getAssetPath(sceneId, ctx) : null
+        };
       }
     });
   }
@@ -305900,15 +306095,14 @@ var init_set_active = __esm({
     init_errors3();
     init_helpers();
     sceneSetActiveInputSchema = external_exports.object({
-      scene: external_exports.string().min(1).describe("\u76EE\u6807 Scene \u8D44\u4EA7 vfs \u8DEF\u5F84,\u5982 /Scenes/main")
+      scene: external_exports.string().min(1).describe("\u76EE\u6807 Scene \u8D44\u4EA7 vfs \u8DEF\u5F84,**\u5FC5\u5E26 .scene \u540E\u7F00**,\u5982 /Scenes/main.scene")
     });
     sceneSetActiveOutputSchema = external_exports.object({
-      activeScenePath: external_exports.string().nullable().describe("\u5F53\u524D\u6FC0\u6D3B\u7684\u573A\u666F vfs \u7EDD\u5BF9\u8DEF\u5F84"),
-      entityCount: external_exports.number().int()
+      activeScenePath: external_exports.string().nullable().describe("\u5207\u6362\u540E\u5F53\u524D\u6FC0\u6D3B\u7684\u573A\u666F vfs \u7EDD\u5BF9\u8DEF\u5F84")
     });
     sceneSetActive = defineTool({
       id: "scene.setActive",
-      description: "\u5207\u6362\u5F53\u524D\u7F16\u8F91\u573A\u666F\u3002Headless \u901A\u8FC7 asset.content \u5E8F\u5217\u5316/\u53CD\u5E8F\u5217\u5316\u505A scene swap;Browser \u901A\u8FC7 EditorScene \u91CD\u5EFA + EngineProjection.setScene \u505A\u5207\u6362\u3002\u4E24\u6761\u8DEF\u5F84\u7531 root \u81EA\u5DF1\u5B9E\u73B0,handler \u5E73\u53F0\u65E0\u5173\u3002",
+      description: "\u5207\u6362\u5F53\u524D\u7F16\u8F91\u573A\u666F\u3002\u540E\u7EED entity.create / component.add \u7B49\u64CD\u4F5C\u9ED8\u8BA4\u8FDB\u5165\u6B64\u573A\u666F\u3002\u5178\u578B\u4F7F\u7528:scene.create \u521B\u5EFA\u65B0\u573A\u666F\u6587\u4EF6\u540E\u8C03\u7528\u6B64\u5DE5\u5177\u5207\u6362\u8FC7\u53BB,\u518D\u5F00\u59CB\u642D\u5EFA\u573A\u666F\u5185\u5BB9\u3002",
       input: sceneSetActiveInputSchema,
       output: sceneSetActiveOutputSchema,
       handler: async (params, ctx) => {
@@ -305938,8 +306132,7 @@ var init_set_active = __esm({
           );
         }
         return {
-          activeScenePath: getAssetPath(sceneUuid, ctx),
-          entityCount: Object.keys(root3.domainStore.state.entities ?? {}).length
+          activeScenePath: getAssetPath(sceneUuid, ctx)
         };
       }
     });
@@ -305995,8 +306188,8 @@ var init_background = __esm({
     sceneSetBackgroundInputSchema = external_exports.object({
       mode: backgroundModeSchema.optional().describe("\u80CC\u666F\u6A21\u5F0F\uFF1ASolidColor\uFF08\u7EAF\u8272\uFF09\u3001Sky\uFF08\u5929\u7A7A\u76D2\uFF09\u3001Texture\uFF08\u7EB9\u7406\uFF09"),
       color: colorSchema.optional().describe("\u80CC\u666F\u989C\u8272\uFF08\u4EC5 SolidColor \u6A21\u5F0F\u6709\u6548\uFF09"),
-      texture: external_exports.string().optional().describe("\u80CC\u666F\u7EB9\u7406\u8D44\u4EA7 vfs \u8DEF\u5F84\uFF08\u4EC5 Texture \u6A21\u5F0F\u6709\u6548\uFF09\uFF0C\u5982 /Textures/bg"),
-      skyMaterial: external_exports.string().optional().describe("\u5929\u7A7A\u6750\u8D28\u8D44\u4EA7 vfs \u8DEF\u5F84\uFF08\u4EC5 Sky \u6A21\u5F0F\u6709\u6548\uFF09\uFF0C\u5982 /Materials/sky")
+      texture: external_exports.string().optional().describe("\u80CC\u666F\u7EB9\u7406\u8D44\u4EA7 vfs \u8DEF\u5F84(\u4EC5 Texture \u6A21\u5F0F\u6709\u6548),**\u5FC5\u5E26\u7269\u7406\u6587\u4EF6\u540E\u7F00**(.png/.jpg/.hdr),\u5982 /Textures/bg.png"),
+      skyMaterial: external_exports.string().optional().describe("\u5929\u7A7A\u6750\u8D28\u8D44\u4EA7 vfs \u8DEF\u5F84(\u4EC5 Sky \u6A21\u5F0F\u6709\u6548),**\u5FC5\u5E26 .mat \u540E\u7F00**,\u5982 /Materials/sky.mat")
     }).refine((val) => !(val.skyMaterial !== void 0 && val.mode !== "Sky"), {
       message: "skyMaterial \u4EC5\u5728 mode='Sky' \u65F6\u5141\u8BB8\u4F20\u5165",
       path: ["skyMaterial"]
@@ -306354,9 +306547,11 @@ var init_scene = __esm({
   "../editor-api/src/tools/scene/index.ts"() {
     "use strict";
     init_create15();
+    init_get_active();
     init_set_active();
     init_update14();
     init_create15();
+    init_get_active();
     init_set_active();
     init_update14();
     init_background();
@@ -306364,7 +306559,7 @@ var init_scene = __esm({
     init_shadow();
     init_fog();
     init_ambient_occlusion();
-    sceneTools = [sceneCreate, sceneSetActive, sceneUpdate];
+    sceneTools = [sceneCreate, sceneGetActive, sceneSetActive, sceneUpdate];
   }
 });
 
@@ -310118,7 +310313,20 @@ __export(execute_code_exports, {
   EXECUTE_TOOL_NAME: () => EXECUTE_TOOL_NAME,
   executeCode: () => executeCode
 });
-async function executeCode(code, invoke2, formatRuntimeError) {
+function defaultFormatRuntimeError(raw, ops2) {
+  const okOps = ops2.filter((op) => op.ok);
+  if (okOps.length === 0)
+    return raw;
+  const sample2 = okOps.slice(0, 5).map((op) => `  \u2713 ${op.toolId}`).join("\n");
+  const more = okOps.length > 5 ? `
+  ... \u5171 ${okOps.length} \u4E2A\u6210\u529F\u64CD\u4F5C` : "";
+  return `${raw}
+
+\u26A0 \u672C\u6B21 execute \u5931\u8D25\u524D\u5DF2\u6210\u529F\u6267\u884C ${okOps.length} \u4E2A\u64CD\u4F5C(\u8BE6\u89C1 partialSuccessOps):
+${sample2}${more}
+\u91CD\u65B0 execute \u65F6\u8BF7**\u53EA\u8865\u5931\u8D25\u7684\u6B65\u9AA4,\u4E0D\u8981\u91CD\u590D\u5DF2\u6210\u529F\u7684\u64CD\u4F5C** \u2014 \u591A\u6570 *.create \u5DE5\u5177\u4E0D\u5E42\u7B49,\u91CD\u590D\u8C03\u7528\u4F1A\u521B\u5EFA\u540C\u540D\u5B64\u513F\u8D44\u4EA7\u3002`;
+}
+async function executeCode(code, invoke2, formatRuntimeError = defaultFormatRuntimeError) {
   const ops2 = [];
   const api3 = {
     async invoke(toolId, payload) {
@@ -310153,7 +310361,7 @@ ${code}`);
     const partialSuccessOps = ops2.filter((op) => op.ok);
     return {
       success: false,
-      error: formatRuntimeError ? formatRuntimeError(raw, ops2) : raw,
+      error: formatRuntimeError(raw, ops2),
       phase: "runtime",
       ops: ops2,
       partialSuccessOps: partialSuccessOps.length > 0 ? partialSuccessOps : void 0
@@ -310197,7 +310405,7 @@ var init_cli_helpers = __esm({
 
 // src/push-output.ts
 function printPushResult(result2, options = {}) {
-  const { log: log10 = console.log, showNoChanges = true } = options;
+  const { log: log10 = console.log, warn: warn2 = console.warn, showNoChanges = true } = options;
   let hasOutput = false;
   if (result2.pushed.length > 0) {
     hasOutput = true;
@@ -310211,6 +310419,8 @@ function printPushResult(result2, options = {}) {
   }
   if (result2.warnings.length > 0) {
     hasOutput = true;
+    for (const warning of result2.warnings)
+      warn2(warning);
     log10(`Completed with ${result2.warnings.length} warning(s). Check stderr for details.`);
   }
   if (!hasOutput && showNoChanges) {
@@ -446247,6 +446457,82 @@ var init_collectAssetReferenceIds = __esm({
   }
 });
 
+// ../model/src/modules/assets/viewer/ThumbnailRegistry.ts
+function getRegisteredThumbnail(type) {
+  return thumbnailItems[type];
+}
+function getRegisteredThumbnails() {
+  return thumbnailItems;
+}
+function registerThumbnail(type, item) {
+  thumbnailItems[type] = item;
+}
+var thumbnailItems;
+var init_ThumbnailRegistry = __esm({
+  "../model/src/modules/assets/viewer/ThumbnailRegistry.ts"() {
+    "use strict";
+    thumbnailItems = {};
+  }
+});
+
+// ../model/src/modules/assets/viewer/ViewerRegistry.ts
+function getRegisteredViewer(type) {
+  return assetViewers.get(type);
+}
+function registerViewer(type, viewer) {
+  assetViewers.set(type, viewer);
+}
+var assetViewers;
+var init_ViewerRegistry = __esm({
+  "../model/src/modules/assets/viewer/ViewerRegistry.ts"() {
+    "use strict";
+    assetViewers = /* @__PURE__ */ new Map();
+  }
+});
+
+// ../model/src/modules/assets/decorators/PluginAsset.ts
+function ensureUploadMainFile(main3, fallbackName = "upload.bin") {
+  if (main3 instanceof File) {
+    return main3;
+  }
+  return new File([main3], fallbackName, {
+    type: main3.type || "application/octet-stream"
+  });
+}
+function asset(options) {
+  return (target) => {
+    assetLogger.info("register", options.type, "verbose");
+    let iconFallback = "icon-file-unknown";
+    if (typeof options.icon === "string") {
+      iconFallback = options.icon;
+      options.icon = void 0;
+    } else if (options?.icon?.fallback) {
+      iconFallback = options.icon.fallback;
+    }
+    EditorAsset.registerAssetMeta(target, { ...options, targetConstructor: target });
+    if (options.viewer) {
+      registerViewer(options.type, new options.viewer());
+    }
+    if (options.thumbnail) {
+      registerThumbnail(options.type, options.thumbnail);
+    }
+    if (options.dragLayer) {
+      target.dragLayer = options.dragLayer;
+    }
+  };
+}
+var assetLogger;
+var init_PluginAsset = __esm({
+  "../model/src/modules/assets/decorators/PluginAsset.ts"() {
+    "use strict";
+    init_src4();
+    init_EditorAsset();
+    init_ThumbnailRegistry();
+    init_ViewerRegistry();
+    assetLogger = logger("Plugin Asset");
+  }
+});
+
 // ../model/src/modules/assets/DragDropMixin.ts
 var DEFAULT_SCENE_ID2, DragDropMixin;
 var init_DragDropMixin = __esm({
@@ -513985,21 +514271,6 @@ var init_OrbitControl = __esm({
   }
 });
 
-// ../model/src/modules/assets/viewer/ViewerRegistry.ts
-function getRegisteredViewer(type) {
-  return assetViewers.get(type);
-}
-function registerViewer(type, viewer) {
-  assetViewers.set(type, viewer);
-}
-var assetViewers;
-var init_ViewerRegistry = __esm({
-  "../model/src/modules/assets/viewer/ViewerRegistry.ts"() {
-    "use strict";
-    assetViewers = /* @__PURE__ */ new Map();
-  }
-});
-
 // ../model/src/modules/assets/viewer/ViewerManager.ts
 var import_mobx3, ViewerManager;
 var init_ViewerManager = __esm({
@@ -514317,24 +514588,6 @@ var init_CanvasRenderer = __esm({
   }
 });
 
-// ../model/src/modules/assets/viewer/ThumbnailRegistry.ts
-function getRegisteredThumbnail(type) {
-  return thumbnailItems[type];
-}
-function getRegisteredThumbnails() {
-  return thumbnailItems;
-}
-function registerThumbnail(type, item) {
-  thumbnailItems[type] = item;
-}
-var thumbnailItems;
-var init_ThumbnailRegistry = __esm({
-  "../model/src/modules/assets/viewer/ThumbnailRegistry.ts"() {
-    "use strict";
-    thumbnailItems = {};
-  }
-});
-
 // ../model/src/modules/assets/viewer/ThumbnailMixin.ts
 var import_mobx4, pixelRatio, pixelWidth, pixelHeight, assetIconMap, _ThumbnailMixin, ThumbnailMixin;
 var init_ThumbnailMixin = __esm({
@@ -515343,16 +515596,18 @@ var init_EngineObjectProxy = __esm({
 });
 
 // ../model/src/modules/assets/EditorAsset.ts
-var import_mobx7, assetLogger, assetIconMap2, _EditorAsset, EditorAsset;
+var import_mobx7, assetLogger2, assetIconMap2, _EditorAsset, EditorAsset;
 var init_EditorAsset = __esm({
   "../model/src/modules/assets/EditorAsset.ts"() {
     "use strict";
     import_mobx7 = __toESM(require_dist());
+    init_src();
     init_src3();
     init_src4();
     init_Main();
     init_Meta();
     init_collectAssetReferenceIds();
+    init_PluginAsset();
     init_DragDropMixin();
     init_ThumbnailMixin();
     init_ViewerRegistry();
@@ -515361,7 +515616,7 @@ var init_EditorAsset = __esm({
     init_trace2();
     init_decorators();
     init_EngineObjectProxy();
-    assetLogger = logger("EditorAsset", "Asset", true);
+    assetLogger2 = logger("EditorAsset", "Asset", true);
     assetIconMap2 = {
       Scene: "https://mdn.alipayobjects.com/huamei_dc3kgb/afts/img/A*Z36ZQ4DCa58AAAAAAAAAAAAADuiaAQ/original",
       script: "https://mdn.alipayobjects.com/huamei_dc3kgb/afts/img/A*rMekSIWSS4oAAAAAAAAAAAAADuiaAQ/original",
@@ -515688,7 +515943,7 @@ var init_EditorAsset = __esm({
           try {
             await this.collectDependencies();
           } catch (error49) {
-            assetLogger.warn(`Failed to collect dependencies for asset ${this.name}:`, error49);
+            assetLogger2.warn(`Failed to collect dependencies for asset ${this.name}:`, error49);
           }
         } else {
           await this._gate.hydrate(async () => {
@@ -515968,15 +516223,38 @@ var init_EditorAsset = __esm({
         return temp;
       }
       /**
-       * @param withFileName false if you want the directory path
+       * @param withFileName false → 返回目录路径
+       *
+       * 拼接 extname 规则(第一性:判定"是否已经带正确的类型 ext",不是"是否含 dot"):
+       *   - builtin 资产(BUILTIN_REMOTE_ASSET_UUIDS)→ 永不加 ext(跨版本数据契约)
+       *   - 类型未注册 extname(自由扩展类型如 .ts/.md)→ 原样返回(name 自带后缀如 `foo.ts`)
+       *   - **upload-based 类型**(Font/Texture/Audio/glTF/Spine 等 importMenuConfig.type 含 Upload)→
+       *     原样返回 fileName。upload-based 资产 vfs 落地形态本身就带物理后缀(`MyFont.ttf` / `tex.png`),
+       *     再追加 typed extname 会产生双重后缀(`MyFont.ttf.font`)→ 破坏 vfs lookup + textRenderer.font 引用。
+       *   - name 已以 `.{extname}` 结尾 → 原样返回(避免 `foo.mat` → `foo.mat.mat`)
+       *   - 否则 → 拼 `.{extname}`(`start` → `start.scene`、`ground.v1` → `ground.v1.mat`)
        */
       getRouteString(withFileName = true) {
         const routes = this.getTempRoutes();
         const filepath = routes.length > 0 ? "/" + routes.join("/") + "/" : "/";
-        if (withFileName) {
-          return filepath + this._name;
+        if (!withFileName)
+          return filepath;
+        const fileName = this._name;
+        if (BUILTIN_REMOTE_ASSET_UUIDS.has(this.id)) {
+          return filepath + fileName;
+        }
+        const config2 = this.getMetaConfig();
+        const extname5 = config2?.extname;
+        if (!extname5)
+          return filepath + fileName;
+        const importType = config2?.importMenuConfig?.type;
+        if (typeof importType === "number" && (importType & 2 /* Upload */) !== 0) {
+          return filepath + fileName;
         }
-        return filepath;
+        if (fileName.endsWith(`.${extname5}`)) {
+          return filepath + fileName;
+        }
+        return filepath + `${fileName}.${extname5}`;
       }
       /**
        * 获取当前资产的 Ref 对象
@@ -516093,14 +516371,14 @@ var init_EditorAsset = __esm({
             try {
               parsedContent = JSON.parse(fileContent);
             } catch (error49) {
-              assetLogger.warn(
+              assetLogger2.warn(
                 `Asset ${this.name} main file is not JSON, skipping content dependency collection`,
                 "verbose"
               );
             }
             collectRefs(parsedContent).forEach((refId) => this._dependsOnAssetIds.add(refId));
           } catch (error49) {
-            assetLogger.error(`Failed to collect dependencies from main file for asset ${this.name}:`, error49, "verbose");
+            assetLogger2.error(`Failed to collect dependencies from main file for asset ${this.name}:`, error49, "verbose");
           }
         }
         this._updateDependedByRelations();
@@ -516206,7 +516484,7 @@ var init_EditorAsset = __esm({
        */
       setupDependencyListeners() {
         this.onDependencyChanged((event) => {
-          assetLogger.info(`Asset ${this.name} received dependency change from ${event.sourceAsset.name}:`, {
+          assetLogger2.info(`Asset ${this.name} received dependency change from ${event.sourceAsset.name}:`, {
             property: event.propertyName,
             oldValue: event.oldValue,
             newValue: event.newValue
@@ -516654,49 +516932,6 @@ var init_ObservableVirtualFileSystem = __esm({
   }
 });
 
-// ../model/src/modules/assets/decorators/PluginAsset.ts
-function ensureUploadMainFile(main3, fallbackName = "upload.bin") {
-  if (main3 instanceof File) {
-    return main3;
-  }
-  return new File([main3], fallbackName, {
-    type: main3.type || "application/octet-stream"
-  });
-}
-function asset(options) {
-  return (target) => {
-    assetLogger2.info("register", options.type, "verbose");
-    let iconFallback = "icon-file-unknown";
-    if (typeof options.icon === "string") {
-      iconFallback = options.icon;
-      options.icon = void 0;
-    } else if (options?.icon?.fallback) {
-      iconFallback = options.icon.fallback;
-    }
-    EditorAsset.registerAssetMeta(target, { ...options, targetConstructor: target });
-    if (options.viewer) {
-      registerViewer(options.type, new options.viewer());
-    }
-    if (options.thumbnail) {
-      registerThumbnail(options.type, options.thumbnail);
-    }
-    if (options.dragLayer) {
-      target.dragLayer = options.dragLayer;
-    }
-  };
-}
-var assetLogger2;
-var init_PluginAsset = __esm({
-  "../model/src/modules/assets/decorators/PluginAsset.ts"() {
-    "use strict";
-    init_src4();
-    init_EditorAsset();
-    init_ThumbnailRegistry();
-    init_ViewerRegistry();
-    assetLogger2 = logger("Plugin Asset");
-  }
-});
-
 // ../model/src/modules/assets/createByAddUploadSource.ts
 function createMainBlob(assetName, mainData) {
   if (mainData === null)
@@ -517201,6 +517436,7 @@ var init_AssetManager = __esm({
     init_esm_node();
     init_src();
     init_src3();
+    init_sync_adapter();
     init_src4();
     init_EditorAsset();
     init_ObservableVirtualFileSystem();
@@ -517847,6 +518083,10 @@ var init_AssetManager = __esm({
         }
         return routeNames;
       }
+      /**
+       * Script 在 name 里保留 `.ts`(影响 compiler/loader/IDE)。其他类型 name 是人话,
+       * extname 由 `EditorAsset.getRouteString` 在拼 path 时主动加。
+       */
       normalizeAssetNameByType(assetType, name16) {
         if (assetType !== "script")
           return name16;
@@ -518101,7 +518341,7 @@ var init_AssetManager = __esm({
         this.ensureAssetPathIndexFresh();
         return this._virtualPathByAssetId.get(assetId);
       }
-      /** 通过 virtualPath（如 "assets/mat.mat"）查找资产 */
+      /** 严格匹配 source-v2 virtualPath; typed VFS 扩展名不是合法 source ref。 */
       getAssetByVirtualPath(virtualPath) {
         this.ensureAssetPathIndexFresh();
         const assetId = this._assetIdByVirtualPath.get(this.normalizeVirtualPathKey(virtualPath));
@@ -518110,24 +518350,51 @@ var init_AssetManager = __esm({
       rebuildAssetPathIndex() {
         this._assetIdByVirtualPath.clear();
         this._virtualPathByAssetId.clear();
-        for (const asset3 of BUILTIN_REMOTE_ASSETS) {
-          const virtualPath = getBuiltinAssetSourceVirtualPath(asset3.uuid);
-          if (virtualPath) {
-            this._virtualPathByAssetId.set(asset3.uuid, virtualPath);
+        const tryRegisterAlias = (key2, assetId) => {
+          if (!key2)
+            return;
+          const normalized = this.normalizeVirtualPathKey(key2);
+          if (!normalized)
+            return;
+          if (!this._assetIdByVirtualPath.has(normalized)) {
+            this._assetIdByVirtualPath.set(normalized, assetId);
           }
-        }
+        };
         for (const asset3 of Object.values(this.assets)) {
-          const route = asset3.getRouteString?.(true);
-          if (!route)
-            continue;
-          const virtualPath = this.normalizeVirtualPathKey(route);
+          const virtualPath = this.getAssetSourceVirtualPath(asset3);
           if (!virtualPath)
             continue;
           this._assetIdByVirtualPath.set(virtualPath, asset3.id);
           this._virtualPathByAssetId.set(asset3.id, virtualPath);
         }
+        for (const asset3 of BUILTIN_REMOTE_ASSETS) {
+          const virtualPath = getBuiltinAssetSourceVirtualPath(asset3.uuid);
+          if (virtualPath) {
+            if (!this._virtualPathByAssetId.has(asset3.uuid)) {
+              this._virtualPathByAssetId.set(asset3.uuid, virtualPath);
+            }
+            tryRegisterAlias(virtualPath, asset3.uuid);
+          }
+          if (asset3.name) {
+            tryRegisterAlias(asset3.name, asset3.uuid);
+          }
+        }
         this._assetPathIndexDirty = false;
       }
+      getAssetSourceVirtualPath(asset3) {
+        const route = asset3.getRouteString?.(true);
+        if (!route)
+          return void 0;
+        const virtualPath = this.normalizeVirtualPathKey(route);
+        if (!virtualPath || BUILTIN_REMOTE_ASSET_UUIDS.has(asset3.id))
+          return virtualPath;
+        const assetType = asset3.getMetaConfig?.()?.type;
+        if (!assetType)
+          return virtualPath;
+        const parts = virtualPath.split("/");
+        parts[parts.length - 1] = assetNameFromPath(virtualPath, assetType);
+        return parts.join("/");
+      }
       invalidateAssetPathIndex() {
         this._assetPathIndexDirty = true;
       }
@@ -529478,13 +529745,13 @@ var init_baseLt = __esm({
 });
 
 // ../../node_modules/lodash-es/lt.js
-var lt, lt_default2;
+var lt2, lt_default2;
 var init_lt2 = __esm({
   "../../node_modules/lodash-es/lt.js"() {
     init_baseLt();
     init_createRelationalOperation();
-    lt = createRelationalOperation_default(baseLt_default);
-    lt_default2 = lt;
+    lt2 = createRelationalOperation_default(baseLt_default);
+    lt_default2 = lt2;
   }
 });
 
@@ -563340,7 +563607,7 @@ var require_edge3 = __commonJS({
         const edge = edgeView ? edgeView.cell : null;
         const terminalView = terminalType === "target" ? targetView : sourceView;
         const terminalMagnet = terminalType === "target" ? targetMagnet : sourceMagnet;
-        let valid = true;
+        let valid2 = true;
         const doValidate = (validate3) => {
           const sourcePort = terminalType === "source" ? candidateTerminal ? candidateTerminal.port : null : edge ? edge.getSourcePortId() : null;
           const targetPort = terminalType === "target" ? candidateTerminal ? candidateTerminal.port : null : edge ? edge.getTargetPortId() : null;
@@ -563361,47 +563628,47 @@ var require_edge3 = __commonJS({
         if (allowLoop != null) {
           if (typeof allowLoop === "boolean") {
             if (!allowLoop && sourceView === targetView) {
-              valid = false;
+              valid2 = false;
             }
           } else {
-            valid = doValidate(allowLoop);
+            valid2 = doValidate(allowLoop);
           }
         }
-        if (valid && allowPort != null) {
+        if (valid2 && allowPort != null) {
           if (typeof allowPort === "boolean") {
             if (!allowPort && terminalMagnet) {
-              valid = false;
+              valid2 = false;
             }
           } else {
-            valid = doValidate(allowPort);
+            valid2 = doValidate(allowPort);
           }
         }
-        if (valid && allowEdge != null) {
+        if (valid2 && allowEdge != null) {
           if (typeof allowEdge === "boolean") {
             if (!allowEdge && _EdgeView.isEdgeView(terminalView)) {
-              valid = false;
+              valid2 = false;
             }
           } else {
-            valid = doValidate(allowEdge);
+            valid2 = doValidate(allowEdge);
           }
         }
-        if (valid && allowNode != null && terminalMagnet == null) {
+        if (valid2 && allowNode != null && terminalMagnet == null) {
           if (typeof allowNode === "boolean") {
             if (!allowNode && node_1.NodeView.isNodeView(terminalView)) {
-              valid = false;
+              valid2 = false;
             }
           } else {
-            valid = doValidate(allowNode);
+            valid2 = doValidate(allowNode);
           }
         }
-        if (valid && allowMulti != null && edgeView) {
+        if (valid2 && allowMulti != null && edgeView) {
           const edge2 = edgeView.cell;
           const source = terminalType === "source" ? candidateTerminal : edge2.getSource();
           const target = terminalType === "target" ? candidateTerminal : edge2.getTarget();
           const terminalCell = candidateTerminal ? this.graph.getCellById(candidateTerminal.cell) : null;
           if (source && target && source.cell && target.cell && terminalCell) {
             if (typeof allowMulti === "function") {
-              valid = doValidate(allowMulti);
+              valid2 = doValidate(allowMulti);
             } else {
               const connectedEdges = this.graph.model.getConnectedEdges(terminalCell, {
                 outgoing: terminalType === "source",
@@ -563415,7 +563682,7 @@ var require_edge3 = __commonJS({
                     return s5 && t8 && s5.cell === source.cell && t8.cell === target.cell && s5.port != null && s5.port === source.port && t8.port != null && t8.port === target.port;
                   });
                   if (exist) {
-                    valid = false;
+                    valid2 = false;
                   }
                 } else if (!allowMulti) {
                   const exist = connectedEdges.some((link) => {
@@ -563424,17 +563691,17 @@ var require_edge3 = __commonJS({
                     return s5 && t8 && s5.cell === source.cell && t8.cell === target.cell;
                   });
                   if (exist) {
-                    valid = false;
+                    valid2 = false;
                   }
                 }
               }
             }
           }
         }
-        if (valid && validate2 != null) {
-          valid = doValidate(validate2);
+        if (valid2 && validate2 != null) {
+          valid2 = doValidate(validate2);
         }
-        return valid;
+        return valid2;
       }
       allowConnectToBlank(edge) {
         const graph = this.graph;
@@ -563727,8 +563994,8 @@ var require_edge3 = __commonJS({
         } else {
           this.arrowheadDragged(data, x3, y5);
         }
-        const valid = this.validateEdge(this.cell, data.terminalType, data.initialTerminal);
-        if (valid) {
+        const valid2 = this.validateEdge(this.cell, data.terminalType, data.initialTerminal);
+        if (valid2) {
           this.finishEmbedding(data);
           this.notifyConnectionEvent(data, e6);
         } else {
@@ -571557,11 +571824,11 @@ var require_parse2 = __commonJS({
 var require_valid3 = __commonJS({
   "../model/node_modules/semver/functions/valid.js"(exports2, module2) {
     var parse4 = require_parse2();
-    var valid = (version4, options) => {
+    var valid2 = (version4, options) => {
       const v6 = parse4(version4, options);
       return v6 ? v6.version : null;
     };
-    module2.exports = valid;
+    module2.exports = valid2;
   }
 });
 
@@ -571743,8 +572010,8 @@ var require_gt2 = __commonJS({
 var require_lt2 = __commonJS({
   "../model/node_modules/semver/functions/lt.js"(exports2, module2) {
     var compare = require_compare2();
-    var lt2 = (a6, b6, loose) => compare(a6, b6, loose) < 0;
-    module2.exports = lt2;
+    var lt3 = (a6, b6, loose) => compare(a6, b6, loose) < 0;
+    module2.exports = lt3;
   }
 });
 
@@ -571782,7 +572049,7 @@ var require_cmp2 = __commonJS({
     var neq = require_neq2();
     var gt2 = require_gt2();
     var gte2 = require_gte2();
-    var lt2 = require_lt2();
+    var lt3 = require_lt2();
     var lte2 = require_lte2();
     var cmp = (a6, op, b6, loose) => {
       switch (op) {
@@ -571809,7 +572076,7 @@ var require_cmp2 = __commonJS({
         case ">=":
           return gte2(a6, b6, loose);
         case "<":
-          return lt2(a6, b6, loose);
+          return lt3(a6, b6, loose);
         case "<=":
           return lte2(a6, b6, loose);
         default:
@@ -573122,7 +573389,7 @@ var require_outside2 = __commonJS({
     var Range4 = require_range2();
     var satisfies = require_satisfies2();
     var gt2 = require_gt2();
-    var lt2 = require_lt2();
+    var lt3 = require_lt2();
     var lte2 = require_lte2();
     var gte2 = require_gte2();
     var outside = (version4, range3, hilo, options) => {
@@ -573133,12 +573400,12 @@ var require_outside2 = __commonJS({
         case ">":
           gtfn = gt2;
           ltefn = lte2;
-          ltfn = lt2;
+          ltfn = lt3;
           comp = ">";
           ecomp = ">=";
           break;
         case "<":
-          gtfn = lt2;
+          gtfn = lt3;
           ltefn = gte2;
           ltfn = gt2;
           comp = "<";
@@ -573290,29 +573557,29 @@ var require_subset2 = __commonJS({
       if (sub2.length === 1 && sub2[0].semver === ANY)
         return dom.length === 1 && dom[0].semver === ANY;
       const eqSet = /* @__PURE__ */ new Set();
-      let gt2, lt2;
+      let gt2, lt3;
       for (const c6 of sub2) {
         if (c6.operator === ">" || c6.operator === ">=")
           gt2 = higherGT(gt2, c6, options);
         else if (c6.operator === "<" || c6.operator === "<=")
-          lt2 = lowerLT(lt2, c6, options);
+          lt3 = lowerLT(lt3, c6, options);
         else
           eqSet.add(c6.semver);
       }
       if (eqSet.size > 1)
         return null;
       let gtltComp;
-      if (gt2 && lt2) {
-        gtltComp = compare(gt2.semver, lt2.semver, options);
+      if (gt2 && lt3) {
+        gtltComp = compare(gt2.semver, lt3.semver, options);
         if (gtltComp > 0)
           return null;
-        else if (gtltComp === 0 && (gt2.operator !== ">=" || lt2.operator !== "<="))
+        else if (gtltComp === 0 && (gt2.operator !== ">=" || lt3.operator !== "<="))
           return null;
       }
       for (const eq4 of eqSet) {
         if (gt2 && !satisfies(eq4, String(gt2), options))
           return null;
-        if (lt2 && !satisfies(eq4, String(lt2), options))
+        if (lt3 && !satisfies(eq4, String(lt3), options))
           return null;
         for (const c6 of dom) {
           if (!satisfies(eq4, String(c6), options))
@@ -573333,20 +573600,20 @@ var require_subset2 = __commonJS({
           } else if (gt2.operator === ">=" && !satisfies(gt2.semver, String(c6), options))
             return false;
         }
-        if (lt2) {
+        if (lt3) {
           if (c6.operator === "<" || c6.operator === "<=") {
-            lower = lowerLT(lt2, c6, options);
-            if (lower === c6 && lower !== lt2)
+            lower = lowerLT(lt3, c6, options);
+            if (lower === c6 && lower !== lt3)
               return false;
-          } else if (lt2.operator === "<=" && !satisfies(lt2.semver, String(c6), options))
+          } else if (lt3.operator === "<=" && !satisfies(lt3.semver, String(c6), options))
             return false;
         }
-        if (!c6.operator && (lt2 || gt2) && gtltComp !== 0)
+        if (!c6.operator && (lt3 || gt2) && gtltComp !== 0)
           return false;
       }
-      if (gt2 && hasDomLT && !lt2 && gtltComp !== 0)
+      if (gt2 && hasDomLT && !lt3 && gtltComp !== 0)
         return false;
-      if (lt2 && hasDomGT && !gt2 && gtltComp !== 0)
+      if (lt3 && hasDomGT && !gt2 && gtltComp !== 0)
         return false;
       return true;
     };
@@ -612375,7 +612642,7 @@ var init_project3 = __esm({
         }
         if (sceneId === this.currentScene.refId)
           return;
-        await this.flushCurrentScenePersistenceOrThrow();
+        await this.flushCurrentScenePersistence();
         const sceneAsset = await this.root.assetStore.getAssetByRef({ refId: sceneId });
         const oldScene = this.currentScene;
         const oldEngineScene = oldScene.engineSceneObject;
@@ -612423,7 +612690,7 @@ var init_project3 = __esm({
        *
        * @throws 当 flush 触发的 save 失败(`syncStatus === "error"`)或 savingPromise reject 时
        */
-      async flushCurrentScenePersistenceOrThrow() {
+      async flushCurrentScenePersistence() {
         await this.debouncedUpdateSceneAsset.flush();
         if (this.syncStatus === "error") {
           throw new Error("current scene failed to save, refusing to switch to avoid data loss");
@@ -612432,9 +612699,6 @@ var init_project3 = __esm({
           await this.savingPromise;
         }
       }
-      async flushCurrentScenePersistenceForAgent() {
-        await this.flushCurrentScenePersistenceOrThrow();
-      }
       async saveCurrentSceneForPreview() {
         const sceneId = this.currentScene?.refId;
         if (!sceneId)
@@ -620279,10 +620543,6 @@ var init_EntityModelProjection = __esm({
         }
       }
       _addComponentToModel(model, componentId, componentState) {
-        const stale = model.getComponentByTypeName?.(componentState.type);
-        if (stale && stale.id !== componentId) {
-          model.removeComponentFromDomain?.(stale.id);
-        }
         model.addComponentFromDomain?.(componentId, componentState);
       }
       _removeComponentFromModel(model, componentId) {
@@ -622569,14 +622829,6 @@ var init_refreshAssetReferences = __esm({
 });
 
 // ../model/src/modules/scene/reloadSceneStateFromAsset.ts
-async function reloadSceneStateFromAsset(opts) {
-  const nextState = createEmptyDomainState();
-  nextState.version = opts.preserveVersion;
-  nextState.assets = opts.preserveAssets;
-  opts.domainStore.reset(nextState);
-  await opts.sceneStore.init(opts.sceneAsset);
-  opts.sceneFacade.initSettingsSystem(collectSceneSettings(opts.sceneStore));
-}
 var init_reloadSceneStateFromAsset = __esm({
   "../model/src/modules/scene/reloadSceneStateFromAsset.ts"() {
     "use strict";
@@ -622664,6 +622916,10 @@ var init_FolderAsset = __esm({
       }
       async initByMain(blob) {
       }
+      /**
+       * Folder 无主文件 — 必须显式 return `null`(`undefined` 会被 `createMainBlob` 当
+       * "子类忘 return" 抛错,见 `createByAddUploadSource`)。
+       */
       initByCreation(routes, name16, params) {
         return Promise.resolve(null);
       }
@@ -622768,9 +623024,13 @@ var init_InstanceEditorAsset = __esm({
       static _tempBoundingBox = new import_engine78.BoundingBox();
       isTemplate = true;
       _clonedEntities = [];
-      _instances = /* @__PURE__ */ new Map();
       _rootKey = "";
       _tempSize = 0;
+      /**
+       * DomainStore.entities[*].instance.assetId 是 asset→instance 关系的唯一来源。
+       * 本类不维护 mirror cache:hydrate 时 cache 不重建会产生 dangling assetId 残留
+       * (save 时 codec 序列化失败)。query 走 O(N),只在删除/UI dialog 非热路径调用。
+       */
       _buildInstanceLink() {
         const assetType = this.getMetaConfig().type;
         if (assetType !== "Prefab" && assetType !== "glTF")
@@ -622817,10 +623077,6 @@ var init_InstanceEditorAsset = __esm({
         } else if (instanceLink) {
           entity.pendingInstance = instanceLink;
         }
-        this._instances.set(entity.id, entity.entityManager);
-        entity.on("delete", () => {
-          this.removeInstance(entity);
-        });
       }
       removeInstance(entity) {
         const domainInstance = entity.root.domainStore.getNormalizedState().entities[entity.id]?.instance;
@@ -622829,10 +623085,20 @@ var init_InstanceEditorAsset = __esm({
         } else {
           entity.pendingInstance = null;
         }
-        this._instances.delete(entity.id);
+      }
+      /** 所有引用该 asset 的 entityId(子类 PrefabAsset batch 操作用)。 */
+      _queryInstanceEntityIdsFromDomain() {
+        const entities = this.root.domainStore.state.entities;
+        const ids = [];
+        for (const eid of Object.keys(entities)) {
+          if (entities[eid]?.instance?.assetId === this.id) {
+            ids.push(eid);
+          }
+        }
+        return ids;
       }
       get instanceCount() {
-        return this._instances.size;
+        return this._queryInstanceEntityIdsFromDomain().length;
       }
       static resolveInstanceEntityIds(trackedIds, entities) {
         const ids = /* @__PURE__ */ new Set();
@@ -622847,24 +623113,28 @@ var init_InstanceEditorAsset = __esm({
       }
       getInstanceEntityIds() {
         return _InstanceEditorAsset.resolveInstanceEntityIds(
-          Array.from(this._instances.keys()),
+          this._queryInstanceEntityIdsFromDomain(),
           this.root.domainStore.state.entities
         );
       }
-      /** 解除所有实例的资产引用（不销毁实体）。子类可 override 做 unpack 等操作。 */
+      /**
+       * 解除所有实例的资产引用(不销毁实体)+ cascade 清掉 prefab.bindings 中对该 asset 的 binding,
+       * 否则 binding 残留为 dangling ref,save 时 codec throw。
+       * 走 prefabFacade.unpackByAsset 保持 byAssetId 反向索引同步。
+       */
       unpackAllInstances() {
-        this._instances.forEach((entityManager, id) => {
-          const entityModel = entityManager.entities.get(id);
-          if (entityModel) {
-            const domainInstance = entityModel.root.domainStore.getNormalizedState().entities[entityModel.id]?.instance;
-            if (domainInstance !== void 0) {
-              entityModel.root.entityFacade.updateEntity(entityModel.id, { instance: null });
-            } else {
-              entityModel.pendingInstance = null;
-            }
+        const bindings = this.root.domainStore.state.prefab?.bindings;
+        const hasBinding = bindings && Object.values(bindings).some((b6) => b6?.assetId === this.id);
+        if (hasBinding) {
+          this.root.prefabFacade.unpackByAsset(this.id);
+        }
+        const entityIds = this._queryInstanceEntityIdsFromDomain();
+        for (const eid of entityIds) {
+          const entity = this.root.domainStore.state.entities?.[eid];
+          if (entity?.instance?.assetId === this.id) {
+            this.root.entityFacade.updateEntity(eid, { instance: null });
           }
-        });
-        this._instances.clear();
+        }
       }
       afterDelete() {
         this.unpackAllInstances();
@@ -622885,13 +623155,6 @@ var init_InstanceEditorAsset = __esm({
           console.warn(`[InstanceEditorAsset] Failed to create drag temp entity for asset ${this.id}:`, e6);
         }
       }
-      _destroyInstances() {
-        this._instances.forEach((entityManager, id) => {
-          const entityModel = entityManager.entities.get(id);
-          entityModel?.destroy();
-        });
-        this._instances.clear();
-      }
       async updateThumbnail() {
         if (this._tempSize) {
           super.updateThumbnail();
@@ -623059,11 +623322,10 @@ var init_modules = __esm({
 });
 
 // ../model/src/postmen.ts
-var PostmenClient, postmenLogger, publisher, TEXT_ASSET_TYPES2, PostmenWS, remoteAssetIngest;
+var PostmenClient, postmenLogger, publisher;
 var init_postmen = __esm({
   "../model/src/postmen.ts"() {
     "use strict";
-    init_src8();
     init_src4();
     init_request();
     init_src();
@@ -623074,406 +623336,6 @@ var init_postmen = __esm({
     PostmenClient = window.PostmenClient;
     postmenLogger = logger("postmen");
     publisher = EventBus.createPublisher();
-    TEXT_ASSET_TYPES2 = /* @__PURE__ */ new Set(["Scene", "Prefab", "script", "Shader", "ShaderChunk", "StateMachineScript"]);
-    PostmenWS = class _PostmenWS {
-      static APP_NAME = "GALACEAN";
-      static BIZ_TYPE = "P-galacean-msg";
-      static pendingRefreshes = [];
-      static pendingDedup = /* @__PURE__ */ new Set();
-      static rafScheduled = false;
-      static pendingSceneRef = null;
-      static collectAssetPickerReferences(target, assetId) {
-        const matches2 = [];
-        const properties = getPropertyConfigs(target);
-        for (const key2 in properties) {
-          const config2 = properties[key2];
-          if (!config2 || config2.type !== "AssetPicker" /* AssetPicker */)
-            continue;
-          const value = target[key2];
-          if (value && typeof value === "object" && "refId" in value && value.refId === assetId) {
-            matches2.push({ target, key: key2 });
-          }
-        }
-        return matches2;
-      }
-      static enqueuePendingRefresh(match) {
-        const targetId = match.target?.id ?? "";
-        const dedupKey = `${targetId}::${match.key}`;
-        if (this.pendingDedup.has(dedupKey))
-          return;
-        this.pendingDedup.add(dedupKey);
-        this.pendingRefreshes.push(match);
-      }
-      static flushPendingSceneReferenceRefreshes() {
-        this.rafScheduled = false;
-        if (rootStore.sceneStore !== this.pendingSceneRef) {
-          this.pendingRefreshes.length = 0;
-          this.pendingDedup.clear();
-          this.pendingSceneRef = null;
-          return;
-        }
-        const pending = this.pendingRefreshes;
-        this.pendingRefreshes = [];
-        this.pendingDedup.clear();
-        this.pendingSceneRef = null;
-        for (const { target, key: key2 } of pending) {
-          try {
-            target.triggerPropertyChange(key2, false);
-          } catch (error49) {
-            console.warn("[postmen] Failed to refresh asset reference:", error49, { key: key2 });
-          }
-        }
-      }
-      static refreshSceneEntityComponentReferences(assetId) {
-        const sceneStore = rootStore.sceneStore;
-        if (!sceneStore)
-          return;
-        if (sceneStore !== this.pendingSceneRef) {
-          this.pendingRefreshes.length = 0;
-          this.pendingDedup.clear();
-          this.pendingSceneRef = sceneStore;
-        }
-        for (const match of this.collectAssetPickerReferences(sceneStore, assetId)) {
-          this.enqueuePendingRefresh(match);
-        }
-        for (const [, entity] of sceneStore.iterateEntityModels()) {
-          for (const component2 of entity.components) {
-            for (const match of this.collectAssetPickerReferences(component2, assetId)) {
-              this.enqueuePendingRefresh(match);
-            }
-          }
-        }
-        for (const entity of sceneStore.strippedEntities.values()) {
-          for (const component2 of entity.components) {
-            for (const match of this.collectAssetPickerReferences(component2, assetId)) {
-              this.enqueuePendingRefresh(match);
-            }
-          }
-        }
-        if (!this.rafScheduled && this.pendingRefreshes.length > 0) {
-          this.rafScheduled = true;
-          requestAnimationFrame(() => {
-            this.flushPendingSceneReferenceRefreshes();
-          });
-        }
-      }
-      static create(projectId) {
-        PostmenClient.initialize(
-          _PostmenWS.getOpts(projectId.toString()),
-          _PostmenWS.stateListener,
-          () => _PostmenWS.getAuthToken(projectId.toString())
-        );
-        PostmenClient.register(_PostmenWS.BIZ_TYPE, (data) => {
-          const messageList = data.msgs;
-          for (const message of messageList) {
-            postmenLogger.info(message);
-            let payload;
-            try {
-              payload = JSON.parse(message.payload);
-            } catch (error49) {
-              console.warn("[postmen] Ignore malformed payload:", error49, message);
-              continue;
-            }
-            switch (message.bizId) {
-              case "AssetCreate" /* AssetCreate */:
-                this.applyAssetCreate(payload);
-                break;
-              case "AssetUpdate" /* AssetUpdate */:
-                this.applyAssetUpdate(payload);
-                break;
-              case "AssetDelete" /* AssetDelete */:
-                this.applyAssetDelete(payload);
-                break;
-            }
-          }
-        });
-      }
-      static getOpts(projectId) {
-        let env = "prod";
-        switch (getEnv()) {
-          case "local" /* local */:
-          case "dev" /* dev */:
-            env = "stable";
-            break;
-          case "test" /* test */:
-            env = "test";
-            break;
-          case "pre" /* pre */:
-          case "prod" /* prod */:
-            env = "prod";
-            break;
-        }
-        return {
-          env,
-          appName: _PostmenWS.APP_NAME,
-          userId: `${projectId}-web-editor`
-        };
-      }
-      static async getAuthToken(projectId) {
-        const res = await request("/api/postmen/createAuthToken", {
-          method: "POST",
-          data: { projectId }
-        });
-        return res.data;
-      }
-      static stateListener(stateInfo) {
-        postmenLogger.info("[state]", stateInfo);
-      }
-      static safeParseJsonObject(value) {
-        if (value && typeof value === "object") {
-          return value;
-        }
-        if (typeof value !== "string")
-          return {};
-        try {
-          const parsed = JSON.parse(value);
-          if (parsed && typeof parsed === "object") {
-            return parsed;
-          }
-        } catch {
-        }
-        return {};
-      }
-      static async applyAssetCreate(info) {
-        const assetId = info.uuid;
-        const assetStore = rootStore.assetStore;
-        const name16 = typeof info.name === "string" ? info.name : assetStore.assets[assetId]?.name ?? "Unknown";
-        const parentId = info.parentId ? String(info.parentId) : null;
-        const url2 = info.url ? String(info.url) : void 0;
-        const metaString = typeof info.meta === "string" ? info.meta : JSON.stringify(info.meta ?? {});
-        const meta4 = this.safeParseJsonObject(metaString);
-        const assetType = typeof meta4.type === "string" ? meta4.type : "Unknown";
-        const projectAssetType = typeof info.type === "number" ? info.type === 1 ? 1 : 0 : typeof info.type === "string" && info.type.length > 0 ? parseInt(info.type, 10) === 1 ? 1 : 0 : 0;
-        let main3;
-        if (url2 && assetType !== "Folder") {
-          if (!TEXT_ASSET_TYPES2.has(assetType)) {
-            main3 = "";
-          } else {
-            try {
-              const res = await fetch(url2);
-              if (res.ok) {
-                main3 = await res.text();
-              } else {
-                main3 = "";
-              }
-            } catch (error49) {
-              main3 = "";
-              console.warn("[postmen] Failed to preload created asset content:", error49, info);
-            }
-          }
-        }
-        try {
-          const state = {
-            id: assetId,
-            name: name16,
-            type: assetType,
-            parentFolderId: parentId,
-            meta: meta4,
-            status: "ready",
-            serverId: String(info.id)
-          };
-          if (url2)
-            state.url = url2;
-          const op = rootStore.domainStore.state.assets[assetId] ? { op: "replace", path: `/assets/${assetId}`, value: state } : { op: "add", path: `/assets/${assetId}`, value: state };
-          rootStore.domainStore.applyRemote([op]);
-        } catch (error49) {
-          console.error("[postmen] failed to apply asset create to DomainStore:", error49, info);
-        }
-        if (url2 && assetType !== "Folder") {
-          const assetToLoad = assetStore.assets[assetId];
-          if (assetToLoad && !assetToLoad.isInitCompleted) {
-            const preloaded = TEXT_ASSET_TYPES2.has(assetType) && typeof main3 === "string" && main3.length > 0 ? {
-              blob: new Blob([main3], {
-                type: assetType === "Scene" || assetType === "Prefab" ? "application/json" : "text/plain"
-              }),
-              url: url2
-            } : void 0;
-            assetToLoad.loadMainFile(preloaded).catch((error49) => {
-              console.warn("[postmen] Failed to load created asset main file:", error49, info);
-            });
-          }
-        }
-        publisher.publish("asset-change", {
-          type: "add",
-          assetId,
-          name: name16,
-          parentId,
-          meta: meta4,
-          main: main3,
-          url: url2
-        });
-        n6(`Asset ${name16} created by ${info.operator}`, { icon: "\u26A0" });
-      }
-      static async applyAssetUpdate(info) {
-        const assetId = info.uuid;
-        const asset3 = rootStore.assetStore.assets[assetId];
-        if (!asset3) {
-          console.warn("[postmen] AssetUpdate for missing asset:", info);
-          return;
-        }
-        n6(`Asset ${asset3.name} updated by ${info.operator}`, { icon: "\u26A0" });
-        await EditorAsset.runWithGlobalAutoSaveSuspended(async () => {
-          await rootStore.domainStore.runAsRemote(async () => {
-            const url2 = info.url ? String(info.url) : void 0;
-            const isCurrentSceneUpdate = asset3.meta.type === "Scene" && rootStore.sceneStore?.refId === assetId;
-            const previousCurrentSceneMain = isCurrentSceneUpdate ? JSON.stringify(rootStore.sceneStore.toJSON()) : void 0;
-            const previousCurrentSceneAssets = isCurrentSceneUpdate ? rootStore.domainStore.state.assets : void 0;
-            const previousCurrentSceneVersion = isCurrentSceneUpdate ? rootStore.domainStore.state.version : void 0;
-            const previousCurrentSceneUrl = isCurrentSceneUpdate ? asset3.url : void 0;
-            let fetchedBlob;
-            let fetchedText;
-            if (url2) {
-              try {
-                const res = await fetch(url2);
-                if (res.ok) {
-                  fetchedBlob = await res.blob();
-                  if (TEXT_ASSET_TYPES2.has(asset3.meta.type)) {
-                    fetchedText = await fetchedBlob.text();
-                  }
-                } else {
-                  console.warn("[postmen] Failed to fetch updated asset:", res.statusText, info);
-                }
-              } catch (error49) {
-                console.warn("[postmen] Failed to fetch updated asset:", error49, info);
-              }
-              if (fetchedBlob) {
-                asset3.setUrl(url2);
-                try {
-                  await asset3.reloadMainFileFromRemote({ blob: fetchedBlob, url: url2 });
-                  if (asset3.meta.type === "ShaderChunk" && typeof fetchedText === "string" && typeof asset3.updateCode === "function") {
-                    ;
-                    asset3.updateCode(fetchedText);
-                  }
-                } catch (error49) {
-                  console.warn("[postmen] Failed to apply updated asset main file:", error49, info);
-                }
-                try {
-                  const assetState = rootStore.domainStore.state.assets[assetId];
-                  if (assetState) {
-                    const op = {
-                      op: "url" in assetState ? "replace" : "add",
-                      path: `/assets/${assetId}/url`,
-                      value: url2
-                    };
-                    rootStore.domainStore.applyRemote([op]);
-                  }
-                } catch (error49) {
-                  console.error("[postmen] failed to apply asset update to DomainStore:", error49, info);
-                }
-                const main3 = TEXT_ASSET_TYPES2.has(asset3.meta.type) ? fetchedText : fetchedBlob;
-                if (asset3.meta.type === "Scene" && rootStore.sceneStore?.refId === assetId && typeof fetchedText === "string" && isCurrentSceneUpdate) {
-                  try {
-                    await reloadSceneStateFromAsset({
-                      sceneStore: rootStore.sceneStore,
-                      sceneFacade: rootStore.sceneFacade,
-                      domainStore: rootStore.domainStore,
-                      sceneAsset: asset3,
-                      preserveAssets: rootStore.domainStore.state.assets,
-                      preserveVersion: rootStore.domainStore.state.version
-                    });
-                    publisher.publish("asset-change", {
-                      type: "modify",
-                      assetId,
-                      main: main3
-                    });
-                  } catch (error49) {
-                    console.error("[postmen] Failed to reload current scene from updated Scene asset:", error49, info);
-                    if (typeof previousCurrentSceneMain === "string" && previousCurrentSceneAssets && typeof previousCurrentSceneVersion === "number" && typeof previousCurrentSceneUrl === "string") {
-                      try {
-                        asset3.setUrl(previousCurrentSceneUrl);
-                        await asset3.reloadMainFileFromRemote({
-                          blob: new Blob([previousCurrentSceneMain], { type: "application/json" }),
-                          url: previousCurrentSceneUrl
-                        });
-                        await reloadSceneStateFromAsset({
-                          sceneStore: rootStore.sceneStore,
-                          sceneFacade: rootStore.sceneFacade,
-                          domainStore: rootStore.domainStore,
-                          sceneAsset: asset3,
-                          preserveAssets: previousCurrentSceneAssets,
-                          preserveVersion: previousCurrentSceneVersion
-                        });
-                      } catch (rollbackError) {
-                        console.error(
-                          "[postmen] Failed to rollback current scene after Scene init failure:",
-                          rollbackError,
-                          info
-                        );
-                      }
-                    }
-                  }
-                } else {
-                  if (main3 !== void 0) {
-                    publisher.publish("asset-change", {
-                      type: "modify",
-                      assetId,
-                      main: main3
-                    });
-                  }
-                }
-              }
-            }
-            if (info.name && asset3.name !== info.name) {
-              try {
-                rootStore.domainStore.applyRemote([
-                  { op: "replace", path: `/assets/${assetId}/name`, value: String(info.name) }
-                ]);
-              } catch (error49) {
-                console.error("[postmen] failed to apply asset rename to DomainStore:", error49, info);
-              }
-              publisher.publish("asset-change", {
-                type: "rename",
-                assetId,
-                newName: String(info.name)
-              });
-            }
-            if (info.parentId !== void 0) {
-              const parentFolderId = info.parentId ? String(info.parentId) : null;
-              if (asset3.parentFolderId !== parentFolderId) {
-                try {
-                  rootStore.domainStore.applyRemote([
-                    { op: "replace", path: `/assets/${assetId}/parentFolderId`, value: parentFolderId }
-                  ]);
-                } catch (error49) {
-                  console.error("[postmen] failed to apply asset move to DomainStore:", error49, info);
-                }
-                publisher.publish("asset-change", {
-                  type: "move",
-                  assetIds: [assetId],
-                  targeParentId: parentFolderId
-                });
-              }
-            }
-          });
-        });
-      }
-      static async applyAssetDelete(info) {
-        for (const assetInfo2 of info.list) {
-          const asset3 = rootStore.assetStore.assets[assetInfo2.uuid];
-          const existsInDomain = Boolean(rootStore.domainStore.state.assets[assetInfo2.uuid]);
-          if (!asset3 && !existsInDomain) {
-            console.warn("[postmen] AssetDelete for missing asset:", assetInfo2);
-            continue;
-          }
-          try {
-            rootStore.domainStore.applyRemote([{ op: "remove", path: `/assets/${assetInfo2.uuid}` }]);
-          } catch (error49) {
-            console.error("[postmen] failed to apply asset delete to DomainStore:", error49, assetInfo2);
-          }
-          publisher.publish("asset-change", {
-            type: "delete",
-            assetIds: [assetInfo2.uuid]
-          });
-          const assetName = asset3?.name ?? assetInfo2.uuid;
-          n6(`Asset ${assetName} deleted by ${info.operator}`, { icon: "\u26A0", style: { color: "red" } });
-        }
-      }
-    };
-    remoteAssetIngest = {
-      applyAssetCreate: PostmenWS.applyAssetCreate.bind(PostmenWS),
-      applyAssetUpdate: PostmenWS.applyAssetUpdate.bind(PostmenWS),
-      applyAssetDelete: PostmenWS.applyAssetDelete.bind(PostmenWS)
-    };
   }
 });
 
@@ -690149,15 +690011,6 @@ var init_GlTFAsset = __esm({
       _instantiateEngineObject() {
         return this.engineObject.instantiateSceneRoot();
       }
-      _destroyInstances() {
-        this._instances.forEach((entityManager, id) => {
-          const entityModel = entityManager.entities.get(id);
-          if (entityModel) {
-            entityModel.destroy();
-          }
-        });
-        this._instances.clear();
-      }
       _internalReplaceMaterial(index2, material) {
         const materialTargets = this._findComponentsByMaterialPathIndex(index2);
         materialTargets.forEach(({ component: component2, materialIndex }) => {
@@ -719936,10 +719789,12 @@ var init_PrefabAsset = __esm({
         }
       }
       unpackAllInstances() {
-        this._instances.forEach((entityManager, id) => {
-          const entityModel = entityManager.entities.get(id);
+        const sceneStore = this.root.sceneStore;
+        const entityIds = this._queryInstanceEntityIdsFromDomain();
+        for (const id of entityIds) {
+          const entityModel = sceneStore.getEntityModel?.(id);
           entityModel?.unpackPrefab();
-        });
+        }
         super.unpackAllInstances();
       }
       async instantiate(entityManager, rootTransform, options) {
@@ -720291,7 +720146,6 @@ var init_PrefabAsset = __esm({
       async replaceInstance(targetEntityId, entityManager, options) {
         const targetEntity = entityManager.entities.get(targetEntityId);
         if (!targetEntity) {
-          this._instances.delete(targetEntityId);
           return null;
         }
         const engineTransform = targetEntity?.engineObject?.transform;
@@ -720318,12 +720172,12 @@ var init_PrefabAsset = __esm({
         return newEntityModel;
       }
       _refreshTrackedInstanceBindings(options) {
-        for (const [id, entityManager] of Array.from(this._instances)) {
-          const entityModel = entityManager.entities.get(id);
-          if (!entityModel) {
-            this._instances.delete(id);
+        const sceneStore = this.root.sceneStore;
+        const entityIds = this._queryInstanceEntityIdsFromDomain();
+        for (const id of entityIds) {
+          const entityModel = sceneStore.getEntityModel?.(id);
+          if (!entityModel)
             continue;
-          }
           this._bindInstantiatedEntity(entityModel, options);
         }
       }
@@ -720475,10 +720329,12 @@ var init_PrefabAsset = __esm({
         if (options?.replaceInstances !== false) {
           const resetRootTransformBindingIds = new Set(options?.resetRootTransformBindingIds ?? []);
           const instanceOptions = options?.undoable ? { undoable: true } : void 0;
+          const sceneStore = this.root.sceneStore;
+          const entityIds = this._queryInstanceEntityIdsFromDomain();
           await Promise.all(
-            Array.from(this._instances, ([id, entityManager]) => {
-              const bindingId = entityManager.root.domainStore.getNormalizedState().entities[id]?.instance?.bindingId;
-              return this.replaceInstance(id, entityManager, {
+            entityIds.map((id) => {
+              const bindingId = this.root.domainStore.getNormalizedState().entities[id]?.instance?.bindingId;
+              return this.replaceInstance(id, sceneStore, {
                 ...instanceOptions ?? {},
                 resetRootTransform: bindingId !== void 0 && resetRootTransformBindingIds.has(bindingId),
                 ...options?.structuralDeltaMode ? { structuralDeltaMode: options.structuralDeltaMode } : {}
@@ -727671,6 +727527,11 @@ var init_ParticleRendererComponent = __esm({
         object3.enabled = false;
         this._applyEditorRuntimeState();
       }
+      /**
+       * generator 子模块全部按 optional 处理:`source?.field ?? this.field`,缺失保留 instance 默认。
+       * Agent 路径(`particleRenderer.add` schema 允许罕用模块省略)下,worker 可能不传整个
+       * textureSheetAnimation,deserialize 必须容错。
+       */
       deserialize(data) {
         const props = data.props;
         this._enabled = props?.enabled ?? true;
@@ -727693,31 +727554,30 @@ var init_ParticleRendererComponent = __esm({
             forceOverLifetime,
             noise
           } = props.generator;
-          this.duration = main3.duration;
-          this.isLoop = main3.isLoop;
-          this.startDelay = main3.startDelay;
-          this.startLifetime = main3.startLifetime;
-          this.startSpeed = main3.startSpeed;
-          this.startSize.enabled = main3.startSize3D;
-          this.startSize.x = main3.startSizeX;
-          this.startSize.y = main3.startSizeY;
-          this.startSize.z = main3.startSizeZ;
-          this.startRotation.enabled = main3.startRotation3D;
-          this.startRotation.x = main3.startRotationX;
-          this.startRotation.y = main3.startRotationY;
-          this.startRotation.z = main3.startRotationZ;
-          this.flipRotation = main3.flipRotation;
-          this.startColor = main3.startColor;
-          this.gravityModifier = main3.gravityModifier;
-          this.simulationSpace = main3.simulationSpace;
-          this.simulationSpeed = main3.simulationSpeed;
-          this.scalingMode = main3.scalingMode;
-          this.playOnEnabled = main3.playOnEnabled;
-          this.maxParticles = main3.maxParticles;
-          this._emissionModuleEnabled = emission.enabled;
-          this.rateOverTime = emission.rateOverTime;
-          this.shape = emission.shape;
-          if (emission.shape?.class === "Null" || emission.shape === null) {
+          this.duration = main3?.duration ?? this.duration;
+          this.isLoop = main3?.isLoop ?? this.isLoop;
+          this.startDelay = main3?.startDelay ?? this.startDelay;
+          this.startLifetime = main3?.startLifetime ?? this.startLifetime;
+          this.startSpeed = main3?.startSpeed ?? this.startSpeed;
+          this.startSize.enabled = main3?.startSize3D ?? this.startSize.enabled;
+          this.startSize.x = main3?.startSizeX ?? this.startSize.x;
+          this.startSize.y = main3?.startSizeY ?? this.startSize.y;
+          this.startSize.z = main3?.startSizeZ ?? this.startSize.z;
+          this.startRotation.enabled = main3?.startRotation3D ?? this.startRotation.enabled;
+          this.startRotation.x = main3?.startRotationX ?? this.startRotation.x;
+          this.startRotation.y = main3?.startRotationY ?? this.startRotation.y;
+          this.startRotation.z = main3?.startRotationZ ?? this.startRotation.z;
+          this.flipRotation = main3?.flipRotation ?? this.flipRotation;
+          this.startColor = main3?.startColor ?? this.startColor;
+          this.gravityModifier = main3?.gravityModifier ?? this.gravityModifier;
+          this.simulationSpace = main3?.simulationSpace ?? this.simulationSpace;
+          this.simulationSpeed = main3?.simulationSpeed ?? this.simulationSpeed;
+          this.scalingMode = main3?.scalingMode ?? this.scalingMode;
+          this.playOnEnabled = main3?.playOnEnabled ?? this.playOnEnabled;
+          this.maxParticles = main3?.maxParticles ?? this.maxParticles;
+          this._emissionModuleEnabled = emission?.enabled ?? this._emissionModuleEnabled;
+          this.rateOverTime = emission?.rateOverTime ?? this.rateOverTime;
+          if (emission?.shape === null || emission?.shape?.class === "Null") {
             this.shape = {
               class: "ConeShape" /* ConeShape */,
               props: {
@@ -727728,66 +727588,69 @@ var init_ParticleRendererComponent = __esm({
                 enabled: false
               }
             };
+            this._emissionShapeModuleEnabled = false;
+          } else {
+            this.shape = emission?.shape ?? this.shape;
+            this._emissionShapeModuleEnabled = emission?.shape?.props?.enabled ?? this._emissionShapeModuleEnabled;
           }
-          this._emissionShapeModuleEnabled = emission?.shape?.props?.enabled ?? true;
           this.bursts = Array.isArray(emission?.bursts) ? emission.bursts.map((burst) => {
             normalizeDeserializedBurstCycles(burst);
             return burst;
           }) : [];
-          this._sizeOverLifetimeModuleEnabled = sizeOverLifetime?.enabled ?? false;
-          this.size.enabled = sizeOverLifetime?.separateAxes ?? false;
+          this._sizeOverLifetimeModuleEnabled = sizeOverLifetime?.enabled ?? this._sizeOverLifetimeModuleEnabled;
+          this.size.enabled = sizeOverLifetime?.separateAxes ?? this.size.enabled;
           this.size.x = sizeOverLifetime?.sizeX ? { ...sizeOverLifetime.sizeX, module: "sizeOverLifetime" } : { ...cloneDeep(this.size.x), module: "sizeOverLifetime" };
           this.size.y = sizeOverLifetime?.sizeY ? { ...sizeOverLifetime.sizeY, module: "sizeOverLifetime" } : { ...cloneDeep(this.size.y), module: "sizeOverLifetime" };
           this.size.z = sizeOverLifetime?.sizeZ ? { ...sizeOverLifetime.sizeZ, module: "sizeOverLifetime" } : { ...cloneDeep(this.size.z), module: "sizeOverLifetime" };
-          this._rotationOverLifetimeModuleEnabled = rotationOverLifetime?.enabled ?? false;
-          this.rotation.enabled = rotationOverLifetime?.separateAxes ?? false;
+          this._rotationOverLifetimeModuleEnabled = rotationOverLifetime?.enabled ?? this._rotationOverLifetimeModuleEnabled;
+          this.rotation.enabled = rotationOverLifetime?.separateAxes ?? this.rotation.enabled;
           this.rotation.x = rotationOverLifetime?.rotationX ? { ...rotationOverLifetime.rotationX, module: "rotationOverLifetime" } : { ...cloneDeep(this.rotation.x), module: "rotationOverLifetime" };
           this.rotation.y = rotationOverLifetime?.rotationY ? { ...rotationOverLifetime.rotationY, module: "rotationOverLifetime" } : { ...cloneDeep(this.rotation.y), module: "rotationOverLifetime" };
           this.rotation.z = rotationOverLifetime?.rotationZ ? { ...rotationOverLifetime.rotationZ, module: "rotationOverLifetime" } : { ...cloneDeep(this.rotation.z), module: "rotationOverLifetime" };
-          this._velocityOverLifetimeModuleEnabled = velocityOverLifetime?.enabled ?? false;
+          this._velocityOverLifetimeModuleEnabled = velocityOverLifetime?.enabled ?? this._velocityOverLifetimeModuleEnabled;
           this.velocityX = velocityOverLifetime?.velocityX ?? cloneDeep(this.velocityX);
           this.velocityY = velocityOverLifetime?.velocityY ?? cloneDeep(this.velocityY);
           this.velocityZ = velocityOverLifetime?.velocityZ ?? cloneDeep(this.velocityZ);
-          this.spaceMode = velocityOverLifetime?.space ?? import_engine161.ParticleSimulationSpace.Local;
-          this._limitVelocityOverLifetimeModuleEnabled = limitVelocityOverLifetime?.enabled ?? false;
-          this.speed.enabled = limitVelocityOverLifetime?.separateAxes ?? false;
+          this.spaceMode = velocityOverLifetime?.space ?? this.spaceMode;
+          this._limitVelocityOverLifetimeModuleEnabled = limitVelocityOverLifetime?.enabled ?? this._limitVelocityOverLifetimeModuleEnabled;
+          this.speed.enabled = limitVelocityOverLifetime?.separateAxes ?? this.speed.enabled;
           const speedXData = limitVelocityOverLifetime?.speedX ?? limitVelocityOverLifetime?.speed;
           this.speed.x = speedXData ? { ...speedXData, module: "limitVelocityOverLifetime" } : { ...cloneDeep(this.speed.x), module: "limitVelocityOverLifetime" };
           this.speed.y = limitVelocityOverLifetime?.speedY ? { ...limitVelocityOverLifetime.speedY, module: "limitVelocityOverLifetime" } : { ...cloneDeep(this.speed.y), module: "limitVelocityOverLifetime" };
           this.speed.z = limitVelocityOverLifetime?.speedZ ? { ...limitVelocityOverLifetime.speedZ, module: "limitVelocityOverLifetime" } : { ...cloneDeep(this.speed.z), module: "limitVelocityOverLifetime" };
-          this.dampen = limitVelocityOverLifetime?.dampen ?? 0;
+          this.dampen = limitVelocityOverLifetime?.dampen ?? this.dampen;
           this.drag = limitVelocityOverLifetime?.drag ? { ...limitVelocityOverLifetime.drag, module: "limitVelocityOverLifetime" } : createCurveOptions("limitVelocityOverLifetime");
-          this.multiplyDragByParticleSize = limitVelocityOverLifetime?.multiplyDragByParticleSize ?? false;
-          this.multiplyDragByParticleVelocity = limitVelocityOverLifetime?.multiplyDragByParticleVelocity ?? false;
-          this.limitVelocitySpaceMode = limitVelocityOverLifetime?.space ?? import_engine161.ParticleSimulationSpace.Local;
-          this._forceOverLifetimeModuleEnabled = forceOverLifetime?.enabled ?? false;
+          this.multiplyDragByParticleSize = limitVelocityOverLifetime?.multiplyDragByParticleSize ?? this.multiplyDragByParticleSize;
+          this.multiplyDragByParticleVelocity = limitVelocityOverLifetime?.multiplyDragByParticleVelocity ?? this.multiplyDragByParticleVelocity;
+          this.limitVelocitySpaceMode = limitVelocityOverLifetime?.space ?? this.limitVelocitySpaceMode;
+          this._forceOverLifetimeModuleEnabled = forceOverLifetime?.enabled ?? this._forceOverLifetimeModuleEnabled;
           this.forceX = forceOverLifetime?.forceX ?? createCurveOptions("forceOverLifetime");
           this.forceY = forceOverLifetime?.forceY ?? createCurveOptions("forceOverLifetime");
           this.forceZ = forceOverLifetime?.forceZ ?? createCurveOptions("forceOverLifetime");
-          this.forceSpaceMode = forceOverLifetime?.space ?? import_engine161.ParticleSimulationSpace.Local;
+          this.forceSpaceMode = forceOverLifetime?.space ?? this.forceSpaceMode;
           if (colorOverLifetime) {
-            this._colorOverLifetimeModuleEnabled = colorOverLifetime.enabled;
-            this.color = colorOverLifetime.color;
+            this._colorOverLifetimeModuleEnabled = colorOverLifetime.enabled ?? this._colorOverLifetimeModuleEnabled;
+            this.color = colorOverLifetime.color ?? this.color;
           } else {
             this._colorOverLifetimeModuleEnabled = true;
             this.color = createDefaultGradientOptions();
           }
-          this._textureSheetAnimationModuleEnabled = textureSheetAnimation.enabled;
-          this.textureSheetAnimationType = textureSheetAnimation.type;
-          this.cycleCount = textureSheetAnimation.cycleCount;
-          this.tiling = textureSheetAnimation.tiling;
-          this.frameOverTime = textureSheetAnimation.frameOverTime;
-          this._noiseModuleEnabled = noise?.enabled ?? false;
-          this.noiseStrength.enabled = noise?.separateAxes ?? false;
+          this._textureSheetAnimationModuleEnabled = textureSheetAnimation?.enabled ?? this._textureSheetAnimationModuleEnabled;
+          this.textureSheetAnimationType = textureSheetAnimation?.type ?? this.textureSheetAnimationType;
+          this.cycleCount = textureSheetAnimation?.cycleCount ?? this.cycleCount;
+          this.tiling = textureSheetAnimation?.tiling ?? this.tiling;
+          this.frameOverTime = textureSheetAnimation?.frameOverTime ?? this.frameOverTime;
+          this._noiseModuleEnabled = noise?.enabled ?? this._noiseModuleEnabled;
+          this.noiseStrength.enabled = noise?.separateAxes ?? this.noiseStrength.enabled;
           const strengthXData = noise?.strengthX;
           this.noiseStrength.x = strengthXData ? { ...strengthXData, module: "noise" } : { ...cloneDeep(this.noiseStrength.x), module: "noise" };
           this.noiseStrength.y = noise?.strengthY ? { ...noise.strengthY, module: "noise" } : { ...cloneDeep(this.noiseStrength.y), module: "noise" };
           this.noiseStrength.z = noise?.strengthZ ? { ...noise.strengthZ, module: "noise" } : { ...cloneDeep(this.noiseStrength.z), module: "noise" };
-          this.noiseFrequency = noise?.frequency ?? 0.5;
-          this.noiseScrollSpeed = noise?.scrollSpeed ?? 0;
-          this.noiseOctaveCount = noise?.octaveCount ?? 1;
-          this.noiseOctaveIntensityMultiplier = noise?.octaveIntensityMultiplier ?? 0.5;
-          this.noiseOctaveFrequencyMultiplier = noise?.octaveFrequencyMultiplier ?? 2;
+          this.noiseFrequency = noise?.frequency ?? this.noiseFrequency;
+          this.noiseScrollSpeed = noise?.scrollSpeed ?? this.noiseScrollSpeed;
+          this.noiseOctaveCount = noise?.octaveCount ?? this.noiseOctaveCount;
+          this.noiseOctaveIntensityMultiplier = noise?.octaveIntensityMultiplier ?? this.noiseOctaveIntensityMultiplier;
+          this.noiseOctaveFrequencyMultiplier = noise?.octaveFrequencyMultiplier ?? this.noiseOctaveFrequencyMultiplier;
         }
         super.deserialize(data);
       }
@@ -730748,8 +730611,8 @@ var require_core_cjs_production_min = __commonJS({
             b8();
         }, [n8, C3, i8, b8, s7, l8, JSON.stringify(x5), JSON.stringify(p8), h9, u8, E4, f9, JSON.stringify(g7)]);
       }({ ...fe3, delta: X3, draggingRect: et2, pointerCoordinates: _e2, scrollableAncestors: Ye2, scrollableAncestorRects: Ve2 });
-      const lt2 = t8.useMemo(() => ({ active: G6, activeNode: de3, activeNodeRect: pe3, activatorEvent: ee4, collisions: tt2, containerNodeRect: ye3, dragOverlay: Ae3, draggableNodes: H5, droppableContainers: V5, droppableRects: se3, over: rt, measureDroppableContainers: le3, scrollableAncestors: Ye2, scrollableAncestorRects: Ve2, measuringConfiguration: ie2, measuringScheduled: ce2, windowRect: Xe2 }), [G6, de3, pe3, ee4, tt2, ye3, Ae3, H5, V5, se3, rt, le3, Ye2, Ve2, ie2, ce2, Xe2]), ct = t8.useMemo(() => ({ activatorEvent: ee4, activators: st, active: G6, activeNodeRect: pe3, ariaDescribedById: { draggable: re4 }, dispatch: N4, draggableNodes: H5, over: rt, measureDroppableContainers: le3 }), [ee4, st, G6, pe3, N4, re4, H5, rt, le3]);
-      return n7.createElement(a6.Provider, { value: K3 }, n7.createElement(ke2.Provider, { value: ct }, n7.createElement(Te2.Provider, { value: lt2 }, n7.createElement(ze.Provider, { value: it }, h8)), n7.createElement(Be, { disabled: false === (null == g6 ? void 0 : g6.restoreFocus) })), n7.createElement(d5, { ...g6, hiddenTextDescribedById: re4 }));
+      const lt3 = t8.useMemo(() => ({ active: G6, activeNode: de3, activeNodeRect: pe3, activatorEvent: ee4, collisions: tt2, containerNodeRect: ye3, dragOverlay: Ae3, draggableNodes: H5, droppableContainers: V5, droppableRects: se3, over: rt, measureDroppableContainers: le3, scrollableAncestors: Ye2, scrollableAncestorRects: Ve2, measuringConfiguration: ie2, measuringScheduled: ce2, windowRect: Xe2 }), [G6, de3, pe3, ee4, tt2, ye3, Ae3, H5, V5, se3, rt, le3, Ye2, Ve2, ie2, ce2, Xe2]), ct = t8.useMemo(() => ({ activatorEvent: ee4, activators: st, active: G6, activeNodeRect: pe3, ariaDescribedById: { draggable: re4 }, dispatch: N4, draggableNodes: H5, over: rt, measureDroppableContainers: le3 }), [ee4, st, G6, pe3, N4, re4, H5, rt, le3]);
+      return n7.createElement(a6.Provider, { value: K3 }, n7.createElement(ke2.Provider, { value: ct }, n7.createElement(Te2.Provider, { value: lt3 }, n7.createElement(ze.Provider, { value: it }, h8)), n7.createElement(Be, { disabled: false === (null == g6 ? void 0 : g6.restoreFocus) })), n7.createElement(d5, { ...g6, hiddenTextDescribedById: re4 }));
     });
     var Ue = t8.createContext(null);
     var je = "button";
@@ -741900,7 +741763,7 @@ var FileWatcher = class {
 };
 
 // src/utils/is-abort-error.ts
-function isAbortError2(err2) {
+function isAbortError(err2) {
   if (!err2 || typeof err2 !== "object")
     return false;
   const { name: name16, message } = err2;
@@ -741957,7 +741820,7 @@ function isRetryableFetchNetworkError(err2) {
   return /fetch failed/i.test(err2.message);
 }
 function shouldAutoRetryWatchError(err2) {
-  if (isAbortError2(err2))
+  if (isAbortError(err2))
     return false;
   if (!(err2 instanceof Error))
     return false;
@@ -742020,7 +741883,7 @@ function watchProject(opts) {
           if (!closed2)
             onPush?.(result2);
         } catch (err2) {
-          if (isAbortError2(err2)) {
+          if (isAbortError(err2)) {
             continue;
           }
           consecutiveFailures++;
@@ -750638,7 +750501,7 @@ function buildDefaultScene(platform2) {
   return platform2 === "2d" ? buildDefaultScene2D() : buildDefaultScene3D();
 }
 async function createProject(opts) {
-  const { name: name16, platform: platform2 = "3d", engineVersion = "2.0.0-alpha.30", force = false } = opts;
+  const { name: name16, platform: platform2 = "3d", engineVersion = "2.0.0-alpha.33", force = false } = opts;
   const outputDir = opts.outputDir ?? `./${slugify2(name16)}`;
   const absDir = import_node_path14.default.resolve(outputDir);
   await (0, import_promises12.mkdir)(absDir, { recursive: true });
@@ -752406,7 +752269,7 @@ function readCliVersionFromPackageJson() {
   const parsed = JSON.parse(raw);
   return typeof parsed.version === "string" && parsed.version.length > 0 ? parsed.version : "0.0.0";
 }
-var CLI_VERSION = "2.0.0-alpha.24".length > 0 ? "2.0.0-alpha.24" : readCliVersionFromPackageJson();
+var CLI_VERSION = "2.0.0-alpha.26".length > 0 ? "2.0.0-alpha.26" : readCliVersionFromPackageJson();
 
 // src/cli.ts
 init_config();