@fps-games/editor 0.1.5-beta.5 → 0.1.7-beta.1

package/node_modules/@fps-games/editor-browser/dist/local-editor-ui.js

@@ -8,10 +8,10 @@ import { LOCAL_EDITOR_BROWSER_INSPECTOR_VEC3_AXES, resolveLocalEditorBrowserInsp
 import { DEFAULT_EDITOR_TRANSFORM_OPERATION_SETTINGS, DEFAULT_EDITOR_TRANSFORM_TOOL_DESCRIPTORS, } from '@fps-games/editor-core';
 export { createLocalEditorViewportRevealController, isLocalEditorElementVisibleInViewport, resolveLocalEditorViewportRevealScrollTop, revealLocalEditorElementInViewport, } from './local-editor-ui-dock-panel.js';
 export { createLocalEditorHierarchyBlankMenu, createLocalEditorHierarchyCopyShortcutAction, createLocalEditorHierarchyDeleteShortcutAction, createLocalEditorHierarchyDuplicateShortcutAction, createLocalEditorHierarchyNodeMenu, createLocalEditorHierarchyPasteShortcutAction, createLocalEditorHierarchySelectAllShortcutAction, } from './local-editor-ui-hierarchy-actions.js';
-export { createLocalEditorHierarchyController, } from './local-editor-ui-hierarchy-controller.js';
+export { createLocalEditorHierarchyController, resolveLocalEditorHierarchyCreateMarkerParentId, } from './local-editor-ui-hierarchy-controller.js';
 export { resolveLocalEditorHierarchySearchRows, } from './local-editor-ui-hierarchy-view.js';
 export { createLocalEditorHierarchyAttachDialog, resolveLocalEditorHierarchyAttachTargets, } from './local-editor-ui-hierarchy-attach-dialog.js';
-export { canLocalEditorHierarchyNodeHaveChildren, createLocalEditorHierarchyTreeModel, isLocalEditorHierarchyNodeSelectable, isLocalEditorHierarchyNodeMovable, } from './local-editor-ui-hierarchy-tree.js';
+export { canLocalEditorHierarchyNodeHaveChildren, canLocalEditorHierarchyNodeDelete, canLocalEditorHierarchyNodeRename, canLocalEditorHierarchyNodeToggleEnabled, createLocalEditorHierarchyTreeModel, isLocalEditorHierarchyNodeSelectable, isLocalEditorHierarchyNodeMovable, } from './local-editor-ui-hierarchy-tree.js';
 export { createLocalEditorContextMenuController, } from './local-editor-ui-context-menu.js';
 export { createLocalEditorTooltipController, } from './local-editor-ui-tooltip.js';
 import { createLocalEditorWorkbenchInputRouter } from './local-editor-ui-input-router.js';
@@ -22,6 +22,8 @@ import { createShortcutHelpPanel as createLocalEditorShortcutHelpPanel } from '.
 import { applyLocalEditorTheme, ensureLocalEditorTheme, LOCAL_EDITOR_THEME_CLASS, normalizeLocalEditorThemeName, } from './local-editor-ui-theme.js';
 import { createDefaultLocalEditorWorkbenchLayout, createLocalEditorWorkbenchLayoutController, createLocalEditorWorkbench, createSceneHeaderToolbar, createWorkbenchPanelContent, } from './local-editor-ui-workbench.js';
 import { createLocalEditorIcon, isLocalEditorIconName } from './local-editor-ui-icons.js';
+import { resolveLocalEditorBrowserAssetKind, } from './local-editor-ui-asset-kind.js';
+import { createLocalEditorPrefabStageTitle, findLocalEditorPrefabStageStructureItem, formatLocalEditorPrefabStageComparisonPreviewStatus, LOCAL_EDITOR_PREFAB_COMPARISON_COLUMN_WIDTH_PX, resolveLocalEditorRightDockVisibility, resolveLocalEditorPrefabStageComparisonPreviewTone, resolveLocalEditorPrefabStageWorkbenchLayout, resolveLocalEditorPreviewToolSupport, shouldLocalEditorClosePerformanceMonitor, shouldLocalEditorPrefabStageBlockHierarchyShortcut, shouldShowLocalEditorPrefabComparisonColumn, shouldToggleLocalEditorPrefabComparisonShortcut, } from './local-editor-ui-prefab-stage.js';
 export { applyLocalEditorBrowserInspectorControlBinding, createLocalEditorBrowserInspectorControlRegistry, formatLocalEditorBrowserInspectorNumberValue, formatLocalEditorBrowserInspectorValue, parseLocalEditorBrowserInspectorNumberValue, resolveLocalEditorBrowserInspectorSectionStatus, resolveLocalEditorBrowserInspectorControlRegistration, } from './local-editor-ui-panels.js';
 export { createLocalEditorBrowserInspectorGroupValueClipboardPayload, createLocalEditorBrowserInspectorVectorCopyPayload, parseLocalEditorBrowserInspectorGroupValueClipboardPayload, } from './local-editor-inspector-clipboard.js';
 export { LOCAL_EDITOR_BROWSER_INSPECTOR_VEC3_AXES, isLocalEditorBrowserInspectorTransformVectorGroupPath, resolveLocalEditorBrowserInspectorVectorGroupAxisFromPropertyPath, resolveLocalEditorBrowserInspectorVectorGroupPathFromPropertyPath, resolveLocalEditorBrowserInspectorVectorGroupPathFromProperties, } from './local-editor-inspector-groups.js';
@@ -66,8 +68,24 @@ function readInspectorInputValue(input, source) {
             b: (numeric & 255) / 255,
         };
     }
+    if (input.dataset.serializedJsonValue === 'true') {
+        try {
+            const parsed = JSON.parse(input.value);
+            return isInspectorSerializedInputValue(parsed) ? parsed : null;
+        }
+        catch {
+            return null;
+        }
+    }
     return input.value;
 }
+function isInspectorSerializedInputValue(value) {
+    return value == null
+        || typeof value === 'number'
+        || typeof value === 'string'
+        || typeof value === 'boolean'
+        || (!!value && typeof value === 'object' && !Array.isArray(value));
+}
 const TRANSFORM_TOOL_ICONS = {
     select: 'select',
     move: 'move',
@@ -91,14 +109,24 @@ const PLACEMENT_MODE_DESCRIPTIONS = {
 const VIEW_PRESET_ICONS = {
     perspective: 'view-perspective',
     top: 'view-top',
+    bottom: 'view-top',
     front: 'view-front',
+    back: 'view-front',
+    left: 'view-right',
     right: 'view-right',
+    iso: 'view-perspective',
+    threeQuarterTop: 'view-perspective',
 };
 const VIEW_PRESET_TOOLTIPS = {
     perspective: '透视视图',
     top: '顶视图 · 自动切换正交',
+    bottom: '底视图 · 自动切换正交',
     front: '前视图 · 自动切换正交',
+    back: '后视图 · 自动切换正交',
+    left: '左视图 · 自动切换正交',
     right: '右视图 · 自动切换正交',
+    iso: '等距视图 · 自动切换正交',
+    threeQuarterTop: '斜 45° 俯视图',
 };
 const VIEWPORT_OVERLAY_TOGGLE_LABELS = {
     bounds: '包围盒',
@@ -152,6 +180,50 @@ function setToolbarButtonTooltip(button, tooltip) {
     button.dataset.editorTooltip = tooltip;
     button.setAttribute('aria-label', tooltip);
 }
+function createAgentBridgeStatusTooltip(status) {
+    const label = formatAgentBridgeStatusLabel(status?.status);
+    const details = [
+        `Agent Bridge：${label}`,
+        status?.url ? `URL ${status.url}` : '',
+        status?.sessionId ? `Session ${status.sessionId}` : '',
+        status ? `Capabilities ${status.capabilityCount}` : '',
+        status?.lastError ? `Error ${status.lastError}` : '',
+        status?.connectedAt ? `Connected ${status.connectedAt}` : '',
+        status?.lastChangedAt ? `Updated ${status.lastChangedAt}` : '',
+    ].filter(Boolean);
+    return details.join(' · ');
+}
+function formatAgentBridgeStatusLabel(status) {
+    switch (status) {
+        case 'disabled':
+            return '未启用';
+        case 'connecting':
+            return '连接中';
+        case 'connected':
+            return '已连接';
+        case 'disconnected':
+            return '已断开';
+        case 'error':
+            return '错误';
+        default:
+            return '未知';
+    }
+}
+function resolveAgentBridgeStatusToneColor(status) {
+    switch (status?.status) {
+        case 'connected':
+            return 'var(--fps-editor-success)';
+        case 'connecting':
+            return 'var(--fps-editor-accent-strong)';
+        case 'disconnected':
+            return 'var(--fps-editor-warn)';
+        case 'error':
+            return 'var(--fps-editor-danger-strong)';
+        case 'disabled':
+        default:
+            return 'var(--fps-editor-muted)';
+    }
+}
 function setToolbarButtonIcon(doc, button, icon) {
     const currentIcon = button.querySelector('[data-editor-icon]');
     if (currentIcon?.dataset.editorIcon === icon)
@@ -206,7 +278,8 @@ function createInspectorPropertyInputs(input, source, lockedVectorGroups) {
     if (!propertyInput)
         return null;
     const groupPath = resolveLocalEditorBrowserInspectorVectorGroupPathFromPropertyPath(propertyInput.path);
-    if (!groupPath || !lockedVectorGroups.has(groupPath))
+    const forceVectorLock = input.dataset.serializedForceVectorLock === 'true';
+    if (!groupPath || (!forceVectorLock && !lockedVectorGroups.has(groupPath)))
         return [propertyInput];
     if (propertyInput.control !== 'number' || propertyInput.valueType !== 'number')
         return [propertyInput];
@@ -352,6 +425,33 @@ function createRenderingActionInput(button) {
         ...(params ? { params } : {}),
     };
 }
+function createInspectorActionInput(button) {
+    const actionId = button.dataset.editorInspectorAction;
+    if (!actionId)
+        return null;
+    const params = parseRenderingActionParams(button.dataset.editorInspectorActionParams);
+    const targetIds = parseInspectorActionTargetIds(button.dataset.editorInspectorActionTargetIds);
+    return {
+        actionId,
+        targetId: button.dataset.editorInspectorActionTargetId || null,
+        targetIds,
+        path: button.dataset.editorInspectorActionPath,
+        ...(params ? { params } : {}),
+    };
+}
+function parseInspectorActionTargetIds(value) {
+    if (!value)
+        return undefined;
+    try {
+        const parsed = JSON.parse(value);
+        return Array.isArray(parsed) && parsed.every(item => typeof item === 'string')
+            ? parsed
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
 function parseRenderingActionParams(value) {
     if (!value)
         return null;
@@ -371,7 +471,40 @@ function readInspectorCommitMode(input) {
 function readRenderingCommitMode(input) {
     return input.dataset.renderingCommitMode ?? 'live';
 }
+function isLocalEditorRightDockTab(value) {
+    return value === 'inspector' || value === 'rendering' || value === 'markers';
+}
 function resolveLocalEditorRightDockContentKey(state, tab, inspectorFilter) {
+    if (tab === 'markers') {
+        const markerPanel = state.markerPanel;
+        if (!markerPanel)
+            return 'markers:none';
+        return [
+            'markers',
+            markerPanel.activeMarkerId ?? '',
+            markerPanel.markersVisible === false ? 'markers-hidden' : 'markers-visible',
+            markerPanel.status ?? '',
+            markerPanel.markerTypes.map(markerType => [
+                markerType.type,
+                markerType.label,
+                markerType.kind ?? '',
+                markerType.description ?? '',
+                markerType.usedByCount ?? 0,
+            ].join('=')).join(';'),
+            (markerPanel.relations ?? []).map(relation => [
+                relation.id,
+                relation.type,
+                relation.from.kind,
+                relation.from.id,
+                relation.from.visibility ?? '',
+                relation.to.kind,
+                relation.to.id,
+                relation.to.visibility ?? '',
+                relation.selected ? 'selected' : '',
+                relation.status ?? '',
+            ].join('=')).join(';'),
+        ].join(':');
+    }
     if (tab === 'rendering') {
         const rendering = state.renderingPanel;
         if (!rendering)
@@ -396,20 +529,22 @@ function resolveLocalEditorRightDockContentKey(state, tab, inspectorFilter) {
         inspectorFilter,
     ].join(':');
 }
-function findLocalEditorRightDockScrollViewport(tab, inspectorPanel, renderingPanel) {
-    const panel = tab === 'inspector' ? inspectorPanel : renderingPanel;
+function findLocalEditorRightDockScrollViewport(tab, inspectorPanel, renderingPanel, markersPanel) {
+    const panel = tab === 'inspector' ? inspectorPanel : tab === 'rendering' ? renderingPanel : markersPanel;
     const selector = tab === 'inspector'
         ? '[data-editor-inspector-scroll-viewport]'
-        : '[data-editor-rendering-scroll-viewport]';
+        : tab === 'rendering'
+            ? '[data-editor-rendering-scroll-viewport]'
+            : '[data-editor-markers-scroll-viewport]';
     return panel.querySelector(selector) ?? panel;
 }
-function captureLocalEditorRightDockScrollSnapshot(state, tab, inspectorFilter, inspectorPanel, renderingPanel) {
+function captureLocalEditorRightDockScrollSnapshot(state, tab, inspectorFilter, inspectorPanel, renderingPanel, markersPanel) {
     if (!state || state.mode !== 'editor')
         return null;
-    const viewport = findLocalEditorRightDockScrollViewport(tab, inspectorPanel, renderingPanel);
+    const viewport = findLocalEditorRightDockScrollViewport(tab, inspectorPanel, renderingPanel, markersPanel);
     if (!viewport)
         return null;
-    const panel = tab === 'inspector' ? inspectorPanel : renderingPanel;
+    const panel = tab === 'inspector' ? inspectorPanel : tab === 'rendering' ? renderingPanel : markersPanel;
     return {
         tab,
         contentKey: resolveLocalEditorRightDockContentKey(state, tab, inspectorFilter),
@@ -418,15 +553,15 @@ function captureLocalEditorRightDockScrollSnapshot(state, tab, inspectorFilter,
         scrollTop: viewport.scrollTop,
     };
 }
-function restoreLocalEditorRightDockScrollSnapshot(snapshot, state, tab, inspectorFilter, inspectorPanel, renderingPanel) {
+function restoreLocalEditorRightDockScrollSnapshot(snapshot, state, tab, inspectorFilter, inspectorPanel, renderingPanel, markersPanel) {
     if (!snapshot || snapshot.tab !== tab || state.mode !== 'editor')
         return;
-    const panel = tab === 'inspector' ? inspectorPanel : renderingPanel;
+    const panel = tab === 'inspector' ? inspectorPanel : tab === 'rendering' ? renderingPanel : markersPanel;
     if ((panel.dataset.editorPanelId ?? tab) !== snapshot.panelId)
         return;
     if (resolveLocalEditorRightDockContentKey(state, tab, inspectorFilter) !== snapshot.contentKey)
         return;
-    const viewport = findLocalEditorRightDockScrollViewport(tab, inspectorPanel, renderingPanel);
+    const viewport = findLocalEditorRightDockScrollViewport(tab, inspectorPanel, renderingPanel, markersPanel);
     if (!viewport)
         return;
     viewport.scrollLeft = snapshot.scrollLeft;
@@ -455,6 +590,132 @@ function readRenderingImmediateSource(input) {
         return 'list';
     return 'input';
 }
+function createMarkerTypeActionInput(button) {
+    const action = button.dataset.editorMarkerTypeAction;
+    if (action === 'create') {
+        const block = button.closest('[data-editor-marker-type-create]');
+        if (!block)
+            return null;
+        const type = readMarkerTypeFieldValue(block, 'type');
+        if (!type)
+            return null;
+        const label = readMarkerTypeFieldValue(block, 'label') || type;
+        return {
+            action: 'create',
+            type,
+            label,
+            kind: readMarkerTypeFieldValue(block, 'kind') || undefined,
+            description: readMarkerTypeFieldValue(block, 'description') || undefined,
+        };
+    }
+    const row = button.closest('[data-editor-marker-type-row]');
+    const type = row?.dataset.editorMarkerTypeRow?.trim() ?? '';
+    if (!row || !type)
+        return null;
+    if (action === 'delete')
+        return { action: 'delete', type };
+    if (action !== 'update')
+        return null;
+    return {
+        action: 'update',
+        type,
+        label: readMarkerTypeFieldValue(row, 'label') || type,
+        kind: readMarkerTypeFieldValue(row, 'kind') || undefined,
+        description: readMarkerTypeFieldValue(row, 'description'),
+    };
+}
+function createMarkerRelationActionInput(target) {
+    const action = target.dataset.editorMarkerRelationAction;
+    if (action === 'delete') {
+        const row = target.closest('[data-editor-marker-relation-row]');
+        const relationId = row?.dataset.editorMarkerRelationRow?.trim() ?? '';
+        return relationId ? { action: 'delete', relationId } : null;
+    }
+    if (action === 'reverse') {
+        const row = target.closest('[data-editor-marker-relation-row]');
+        const relationId = row?.dataset.editorMarkerRelationRow?.trim() ?? '';
+        return relationId ? { action: 'reverse', relationId } : null;
+    }
+    if (action === 'delete-connected') {
+        const markerId = target.dataset.editorMarkerRelationMarkerId?.trim() ?? '';
+        return { action: 'delete-connected', ...(markerId ? { markerId } : {}) };
+    }
+    if (action === 'select') {
+        const row = target.closest('[data-editor-marker-relation-row]');
+        const relationId = row?.dataset.editorMarkerRelationRow?.trim() ?? '';
+        return relationId ? { action: 'select', relationId } : null;
+    }
+    if (action === 'pick-cancel')
+        return { action: 'pick-cancel' };
+    if (action !== 'create' && action !== 'pick-start')
+        return null;
+    const block = target.closest('[data-editor-marker-relation-create]');
+    if (!block)
+        return null;
+    const type = readMarkerRelationTypeFieldValue(block);
+    const from = readMarkerRelationEndpointFieldValue(block, 'from');
+    const to = readMarkerRelationEndpointFieldValue(block, 'to');
+    if (!type || !from || (action === 'create' && !to))
+        return null;
+    const directed = readMarkerRelationDirectionFieldValue(block);
+    if (action === 'pick-start') {
+        return {
+            action: 'pick-start',
+            type,
+            fromKind: from.kind,
+            fromId: from.id,
+            ...(directed === null ? {} : { directed }),
+        };
+    }
+    return {
+        action: 'create',
+        type,
+        fromKind: from.kind,
+        fromId: from.id,
+        toKind: to.kind,
+        toId: to.id,
+        ...(directed === null ? {} : { directed }),
+    };
+}
+function readMarkerTypeFieldValue(parent, field) {
+    const input = parent.querySelector(`[data-editor-marker-type-field="${field}"]`);
+    return input?.value.trim() ?? '';
+}
+function readMarkerRelationTypeFieldValue(parent) {
+    const select = parent.querySelector('[data-editor-marker-relation-field="type"]');
+    return select?.value.trim() ?? '';
+}
+function readMarkerRelationDirectionFieldValue(parent) {
+    const select = parent.querySelector('[data-editor-marker-relation-field="directed"]');
+    if (!select || select.value === 'default')
+        return null;
+    return select.value === 'true';
+}
+function readMarkerRelationEndpointFieldValue(parent, field) {
+    const select = parent.querySelector(`[data-editor-marker-relation-field="${field}"]`);
+    const option = select?.selectedOptions.item(0) ?? null;
+    const kind = option?.dataset.editorMarkerRelationEndpointKind?.trim();
+    const id = option?.dataset.editorMarkerRelationEndpointId?.trim();
+    if (kind && id)
+        return { kind, id };
+    return decodeMarkerRelationEndpointValue(select?.value);
+}
+function decodeMarkerRelationEndpointValue(value) {
+    const raw = value?.trim();
+    if (!raw)
+        return null;
+    const separator = raw.indexOf(':');
+    if (separator <= 0)
+        return null;
+    const kind = raw.slice(0, separator);
+    const encodedId = raw.slice(separator + 1);
+    try {
+        return { kind, id: decodeURIComponent(encodedId) };
+    }
+    catch {
+        return { kind, id: encodedId };
+    }
+}
 function markLocalEditorKeyboardCommittedValue(input) {
     input.dataset.editorKeyboardCommittedValue = input.value;
 }
@@ -764,6 +1025,50 @@ const PERFORMANCE_MONITOR_METRIC_GROUPS = [
         ],
     },
 ];
+const PREFAB_IMPORT_STATS_METRICS = [
+    {
+        key: 'source',
+        label: 'Source',
+        description: '当前 prefab preview 使用的 source model 或 source url。',
+        format: stats => stats?.sourceId ?? stats?.assetId ?? '--',
+    },
+    {
+        key: 'nodes',
+        label: 'Nodes',
+        description: 'Babylon 导入后 runtime snapshot 中的节点总数，包含虚拟 root。',
+        format: stats => formatPerformanceInteger(stats?.nodeCount ?? null),
+    },
+    {
+        key: 'transforms',
+        label: 'Transforms',
+        description: 'runtime snapshot 中 root/transform 节点数量。',
+        format: stats => formatPerformanceInteger(stats?.transformCount ?? null),
+    },
+    {
+        key: 'meshes',
+        label: 'Meshes',
+        description: 'runtime snapshot 中可渲染 mesh 节点数量。',
+        format: stats => formatPerformanceInteger(stats?.meshCount ?? null),
+    },
+    {
+        key: 'materials',
+        label: 'Materials',
+        description: 'runtime snapshot 关联到的材质数量。',
+        format: stats => formatPerformanceInteger(stats?.materialCount ?? null),
+    },
+    {
+        key: 'textures',
+        label: 'Textures',
+        description: 'runtime snapshot 关联到的贴图数量。',
+        format: stats => formatPerformanceInteger(stats?.textureCount ?? null),
+    },
+    {
+        key: 'animations',
+        label: 'Animations',
+        description: 'runtime snapshot 关联到的 animation group 数量。',
+        format: stats => formatPerformanceInteger(stats?.animationCount ?? null),
+    },
+];
 function createSceneFrameRateOverlay(doc) {
     const root = doc.createElement('div');
     root.classList.add(LOCAL_EDITOR_THEME_CLASS);
@@ -982,6 +1287,359 @@ function renderPerformanceMonitorOverlay(overlay, stats, open) {
         stats?.activeReasons.length ? `active: ${stats.activeReasons.join(', ')}` : '',
     ].filter(Boolean).join(' | ');
 }
+function createPrefabImportStatsOverlay(doc) {
+    const root = doc.createElement('section');
+    root.classList.add(LOCAL_EDITOR_THEME_CLASS);
+    root.dataset.editorPrefabImportStatsOverlay = 'true';
+    root.setAttribute('aria-label', 'Prefab import diagnostics');
+    root.style.cssText = [
+        'display:none',
+        'width:236px',
+        'max-width:100%',
+        'box-sizing:border-box',
+        'padding:10px',
+        'border:1px solid color-mix(in srgb, var(--fps-editor-border) 78%, transparent)',
+        'border-radius:6px',
+        'background:color-mix(in srgb, var(--fps-editor-chrome) 88%, transparent)',
+        'box-shadow:var(--fps-editor-shadow-panel)',
+        'backdrop-filter:blur(6px)',
+        'font-family:var(--fps-editor-font)',
+        'font-size:11px',
+        'font-weight:800',
+        'color:var(--fps-editor-text)',
+        'pointer-events:auto',
+    ].join(';');
+    const header = doc.createElement('div');
+    header.style.cssText = 'display:flex;align-items:center;justify-content:space-between;gap:8px;margin-bottom:8px;';
+    const title = doc.createElement('div');
+    title.textContent = 'Prefab Import';
+    title.style.cssText = 'min-width:0;color:var(--fps-editor-text-strong);font-size:12px;font-weight:900;line-height:1.2;';
+    const modeLabel = doc.createElement('span');
+    modeLabel.textContent = 'MISSING';
+    modeLabel.style.cssText = [
+        'flex:0 0 auto',
+        'padding:2px 5px',
+        'border:1px solid var(--fps-editor-border-soft)',
+        'border-radius:4px',
+        'background:color-mix(in srgb, var(--fps-editor-field) 72%, transparent)',
+        'color:var(--fps-editor-muted)',
+        'font-size:9px',
+        'line-height:1',
+        'font-weight:900',
+    ].join(';');
+    header.append(title, modeLabel);
+    const grid = doc.createElement('div');
+    grid.style.cssText = [
+        'display:grid',
+        'grid-template-columns:minmax(0,1fr) minmax(76px,108px)',
+        'gap:5px 10px',
+        'align-items:center',
+    ].join(';');
+    const values = {};
+    for (const metric of PREFAB_IMPORT_STATS_METRICS) {
+        const rowLabel = doc.createElement('span');
+        rowLabel.textContent = metric.label;
+        rowLabel.title = metric.description;
+        rowLabel.setAttribute('aria-label', `${metric.label}: ${metric.description}`);
+        rowLabel.style.cssText = [
+            'min-width:0',
+            'overflow:hidden',
+            'text-overflow:ellipsis',
+            'white-space:nowrap',
+            'color:var(--fps-editor-muted-strong)',
+            'cursor:help',
+        ].join(';');
+        const value = doc.createElement('span');
+        value.textContent = '--';
+        value.title = metric.description;
+        value.setAttribute('aria-label', `${metric.label}: --。${metric.description}`);
+        value.style.cssText = [
+            'min-width:0',
+            'justify-self:end',
+            'max-width:108px',
+            'overflow:hidden',
+            'text-overflow:ellipsis',
+            'white-space:nowrap',
+            'font-variant-numeric:tabular-nums',
+            'color:var(--fps-editor-text-strong)',
+            'text-align:right',
+            'cursor:help',
+        ].join(';');
+        values[metric.key] = value;
+        grid.append(rowLabel, value);
+    }
+    root.append(header, grid);
+    return { root, modeLabel, values };
+}
+function renderPrefabImportStatsOverlay(overlay, stage) {
+    if (!stage) {
+        overlay.root.style.display = 'none';
+        return;
+    }
+    overlay.root.style.display = 'block';
+    const stats = stage.importStats ?? null;
+    const status = stats?.status ?? (stage.importStructureReady === false ? 'loading' : 'missing');
+    overlay.modeLabel.textContent = formatPrefabImportStatsStatusLabel(status);
+    overlay.modeLabel.style.color = status === 'ready'
+        ? 'var(--fps-editor-success)'
+        : status === 'loading'
+            ? 'var(--fps-editor-warn)'
+            : 'var(--fps-editor-danger-strong)';
+    for (const metric of PREFAB_IMPORT_STATS_METRICS) {
+        const value = metric.format(stats);
+        overlay.values[metric.key].textContent = value;
+        overlay.values[metric.key].title = `${metric.description}\n${value}`;
+        overlay.values[metric.key].setAttribute('aria-label', `${metric.label}: ${value}。${metric.description}`);
+    }
+    overlay.root.title = [
+        `status: ${status}`,
+        stats?.projectionNodeId ? `preview: ${stats.projectionNodeId}` : stage.previewNodeId ? `preview: ${stage.previewNodeId}` : '',
+        stats?.assetId ? `asset: ${stats.assetId}` : '',
+        stats?.sourceId ? `source: ${stats.sourceId}` : '',
+    ].filter(Boolean).join(' | ');
+}
+function createPrefabStagePreviewLayout(doc) {
+    const root = doc.createElement('section');
+    root.classList.add(LOCAL_EDITOR_THEME_CLASS);
+    root.dataset.editorPrefabStagePreviewLayout = 'true';
+    root.setAttribute('aria-label', 'Prefab stage preview layout');
+    root.style.cssText = [
+        'position:absolute',
+        'left:0',
+        'right:0',
+        'top:38px',
+        'bottom:0',
+        'z-index:4',
+        'display:none',
+        'pointer-events:none',
+        'overflow:hidden',
+        'font-family:var(--fps-editor-font)',
+    ].join(';');
+    const mainRegion = doc.createElement('div');
+    mainRegion.dataset.editorPrefabStageMainPreview = 'true';
+    mainRegion.style.cssText = [
+        'position:absolute',
+        'left:0',
+        'top:0',
+        'bottom:0',
+        'right:0',
+        'min-width:0',
+        'overflow:hidden',
+        'pointer-events:none',
+    ].join(';');
+    const comparisonColumn = doc.createElement('aside');
+    comparisonColumn.dataset.editorPrefabStageComparisonColumn = 'true';
+    comparisonColumn.setAttribute('aria-label', 'Prefab comparison previews');
+    comparisonColumn.style.cssText = [
+        'position:absolute',
+        'top:0',
+        'right:0',
+        'bottom:0',
+        `width:${LOCAL_EDITOR_PREFAB_COMPARISON_COLUMN_WIDTH_PX}px`,
+        'display:none',
+        'flex-direction:column',
+        'box-sizing:border-box',
+        'gap:10px',
+        'padding:10px',
+        'border-left:1px solid color-mix(in srgb, var(--fps-editor-divider) 82%, transparent)',
+        'background:transparent',
+        'box-shadow:none',
+        'pointer-events:auto',
+        'overflow:hidden',
+    ].join(';');
+    root.append(mainRegion, comparisonColumn);
+    return { root, mainRegion, comparisonColumn };
+}
+function createPrefabComparisonPreviewOverlay(doc) {
+    const root = doc.createElement('section');
+    root.classList.add(LOCAL_EDITOR_THEME_CLASS);
+    root.dataset.editorPrefabComparisonPreviewOverlay = 'true';
+    root.setAttribute('aria-label', 'Prefab clone and InstanceMesh comparison previews');
+    root.style.cssText = [
+        'display:none',
+        'flex:1 1 auto',
+        'min-height:0',
+        'width:100%',
+        'box-sizing:border-box',
+        'grid-template-rows:minmax(0,1fr) minmax(0,1fr)',
+        'gap:10px',
+        'overflow:hidden',
+        'font-family:var(--fps-editor-font)',
+        'pointer-events:auto',
+    ].join(';');
+    return { root, cards: new Map() };
+}
+function renderPrefabComparisonPreviewOverlay(overlay, stage) {
+    const previews = stage?.comparisonPreviews ?? [];
+    if (!stage || previews.length === 0) {
+        overlay.root.style.display = 'none';
+        return;
+    }
+    overlay.root.style.display = 'grid';
+    const visibleIds = new Set();
+    for (const preview of previews) {
+        const card = getOrCreatePrefabComparisonPreviewCard(overlay, preview);
+        visibleIds.add(preview.id);
+        card.root.style.display = 'flex';
+        card.title.textContent = preview.label;
+        card.statusLabel.textContent = formatLocalEditorPrefabStageComparisonPreviewStatus(preview.status);
+        card.statusLabel.style.color = getPrefabComparisonPreviewStatusColor(preview.status);
+        card.surface.dataset.editorPrefabComparisonPreviewId = preview.id;
+        card.surface.dataset.editorPrefabComparisonPreviewSurface = preview.projectionNodeId;
+        card.surface.dataset.editorPrefabComparisonPreviewStatus = preview.status;
+        card.surface.style.background = preview.status === 'ready'
+            ? 'transparent'
+            : 'color-mix(in srgb, var(--fps-editor-field) 74%, transparent)';
+        card.surface.textContent = preview.status === 'ready'
+            ? ''
+            : preview.status === 'loading'
+                ? 'Preview loading'
+                : 'Preview unavailable';
+        card.root.title = [
+            `${preview.label}: ${preview.status}`,
+            `mode: ${preview.mode}`,
+            `projection: ${preview.projectionNodeId}`,
+        ].join(' | ');
+    }
+    for (const [id, card] of overlay.cards) {
+        if (!visibleIds.has(id))
+            card.root.style.display = 'none';
+    }
+}
+function readPrefabComparisonPreviewSurfaces(overlay) {
+    if (overlay.root.style.display === 'none')
+        return [];
+    const surfaces = [];
+    for (const [previewId, card] of overlay.cards) {
+        if (card.root.style.display === 'none')
+            continue;
+        const projectionNodeId = card.surface.dataset.editorPrefabComparisonPreviewSurface;
+        if (!projectionNodeId)
+            continue;
+        const rect = card.surface.getBoundingClientRect();
+        if (rect.width < 1 || rect.height < 1)
+            continue;
+        surfaces.push({
+            previewId,
+            projectionNodeId,
+            element: card.surface,
+            rect,
+        });
+    }
+    return surfaces;
+}
+function findPrefabComparisonPreviewSurface(target) {
+    return target instanceof HTMLElement
+        ? target.closest('[data-editor-prefab-comparison-preview-surface]')
+        : null;
+}
+function readPrefabComparisonPreviewSurfaceId(surface) {
+    return surface.dataset.editorPrefabComparisonPreviewId
+        ?? surface.closest('[data-editor-prefab-comparison-preview]')?.dataset.editorPrefabComparisonPreview
+        ?? null;
+}
+function isPrefabComparisonPreviewSurfaceReady(surface) {
+    return surface.dataset.editorPrefabComparisonPreviewStatus === 'ready';
+}
+function getOrCreatePrefabComparisonPreviewCard(overlay, preview) {
+    const existing = overlay.cards.get(preview.id);
+    if (existing)
+        return existing;
+    const doc = overlay.root.ownerDocument;
+    const root = doc.createElement('article');
+    root.dataset.editorPrefabComparisonPreview = preview.id;
+    root.style.cssText = [
+        'display:flex',
+        'flex-direction:column',
+        'min-width:0',
+        'min-height:0',
+        'flex:1 1 0',
+        'box-sizing:border-box',
+        'padding:8px',
+        'border:1px solid color-mix(in srgb, var(--fps-editor-border) 78%, transparent)',
+        'border-radius:6px',
+        'background:transparent',
+        'box-shadow:none',
+        'color:var(--fps-editor-text)',
+        'pointer-events:auto',
+        'overflow:hidden',
+    ].join(';');
+    const header = doc.createElement('div');
+    header.style.cssText = [
+        'display:flex',
+        'align-items:center',
+        'justify-content:space-between',
+        'gap:8px',
+        'margin-bottom:7px',
+        'padding:6px 8px',
+        'border:1px solid color-mix(in srgb, var(--fps-editor-border) 74%, transparent)',
+        'border-radius:5px',
+        'background:color-mix(in srgb, var(--fps-editor-chrome) 86%, transparent)',
+        'box-shadow:0 6px 14px color-mix(in srgb, #000 18%, transparent)',
+    ].join(';');
+    const title = doc.createElement('div');
+    title.textContent = preview.label;
+    title.style.cssText = [
+        'min-width:0',
+        'overflow:hidden',
+        'text-overflow:ellipsis',
+        'white-space:nowrap',
+        'color:var(--fps-editor-text-strong)',
+        'font-size:12px',
+        'line-height:1.2',
+        'font-weight:900',
+    ].join(';');
+    const statusLabel = doc.createElement('span');
+    statusLabel.textContent = 'UNAVAILABLE';
+    statusLabel.style.cssText = [
+        'flex:0 0 auto',
+        'padding:2px 5px',
+        'border:1px solid var(--fps-editor-border-soft)',
+        'border-radius:4px',
+        'background:color-mix(in srgb, var(--fps-editor-field) 72%, transparent)',
+        'font-size:9px',
+        'line-height:1',
+        'font-weight:900',
+    ].join(';');
+    header.append(title, statusLabel);
+    const surface = doc.createElement('div');
+    surface.style.cssText = [
+        'display:flex',
+        'flex:1 1 auto',
+        'align-items:center',
+        'justify-content:center',
+        'width:100%',
+        'min-height:0',
+        'box-sizing:border-box',
+        'border:1px solid color-mix(in srgb, var(--fps-editor-border-soft) 84%, transparent)',
+        'border-radius:4px',
+        'background:transparent',
+        'overflow:hidden',
+        'color:var(--fps-editor-muted)',
+        'font-size:10px',
+        'font-weight:800',
+        'text-align:center',
+        'touch-action:none',
+        'user-select:none',
+        'cursor:grab',
+    ].join(';');
+    root.append(header, surface);
+    overlay.root.appendChild(root);
+    const card = { root, title, statusLabel, surface };
+    overlay.cards.set(preview.id, card);
+    return card;
+}
+function getPrefabComparisonPreviewStatusColor(status) {
+    const tone = resolveLocalEditorPrefabStageComparisonPreviewTone(status);
+    return tone === 'success'
+        ? 'var(--fps-editor-success)'
+        : tone === 'warning'
+            ? 'var(--fps-editor-warn)'
+            : 'var(--fps-editor-danger-strong)';
+}
+function formatPrefabImportStatsStatusLabel(status) {
+    return status === 'ready' ? 'READY' : status === 'loading' ? 'LOADING' : 'MISSING';
+}
 function formatPerformanceInteger(value) {
     return typeof value === 'number' && Number.isFinite(value) ? String(Math.round(value)) : '--';
 }
@@ -1413,12 +2071,13 @@ function formatSvgNumber(value) {
     return Number.isFinite(value) ? value.toFixed(2) : '0';
 }
 function isLocalEditorAssetBrowserTab(value) {
-    return value === 'all' || value === 'models' || value === 'materials' || value === 'textures';
+    return value === 'all' || value === 'models' || value === 'prefabs' || value === 'materials' || value === 'textures';
 }
-function createAssetBrowserMenuItems(state, asset) {
-    const assetKind = resolveBrowserAssetKind(asset);
+export function createAssetBrowserMenuItems(state, asset) {
+    const assetKind = resolveLocalEditorBrowserAssetKind(asset);
     const placeable = asset.placeable !== false && asset.disabled !== true;
     const activeId = state.activeId;
+    const inPrefabStage = !!state.prefabStage;
     const items = [];
     if (assetKind === 'material') {
         const deleteDisabledReason = getMaterialAssetDeleteDisabledReason(asset);
@@ -1449,6 +2108,35 @@ function createAssetBrowserMenuItems(state, asset) {
             label: '查看贴图预览',
         });
     }
+    else if (assetKind === 'prefab') {
+        if (inPrefabStage) {
+            items.push({
+                id: 'asset.add-to-current-prefab',
+                label: '添加到当前 Prefab',
+                disabled: !placeable,
+                disabledReason: '该 Prefab 当前不可添加到当前 Prefab。',
+            });
+        }
+        items.push({
+            id: 'asset.rename',
+            label: '重命名 Prefab',
+            disabled: !asset.assetId && !asset.id,
+            disabledReason: '该预制体资产缺少可重命名的资产 ID。',
+        });
+        items.push({
+            id: 'asset.edit-prefab',
+            label: inPrefabStage ? '打开 Prefab Stage' : '编辑 Prefab',
+            separatorBefore: inPrefabStage ? true : undefined,
+            disabled: !asset.prefab,
+            disabledReason: '该预制体资产缺少可编辑参数。',
+        });
+        items.push({
+            id: 'asset.duplicate-prefab',
+            label: '复制 Prefab',
+            disabled: !asset.assetId && !asset.id,
+            disabledReason: '该预制体资产缺少可复制的 Prefab ID。',
+        });
+    }
     if (assetKind === 'material') {
         items.push({
             id: 'asset.apply-material',
@@ -1459,19 +2147,21 @@ function createAssetBrowserMenuItems(state, asset) {
         });
     }
     else if (assetKind === 'texture') {
-        items.push({
-            id: 'asset.add-to-scene',
-            label: '作为地贴添加到场景',
-            separatorBefore: asset.preview ? true : undefined,
-            disabled: !placeable,
-            disabledReason: '该贴图当前不可放置。',
-        });
-        items.push({
-            id: 'asset.place',
-            label: '进入地面放置模式',
-            disabled: !placeable,
-            disabledReason: '该贴图当前不可放置。',
-        });
+        if (!inPrefabStage) {
+            items.push({
+                id: 'asset.add-to-scene',
+                label: '作为地贴添加到场景',
+                separatorBefore: asset.preview ? true : undefined,
+                disabled: !placeable,
+                disabledReason: '该贴图当前不可放置。',
+            });
+            items.push({
+                id: 'asset.place',
+                label: '进入地面放置模式',
+                disabled: !placeable,
+                disabledReason: '该贴图当前不可放置。',
+            });
+        }
         items.push({
             id: 'asset.use-base-texture',
             label: '用作当前材质 Base 图',
@@ -1486,32 +2176,65 @@ function createAssetBrowserMenuItems(state, asset) {
             disabledReason: '自发光遮罩绑定将在下一步接入。',
         });
     }
+    else if (assetKind === 'prefab') {
+        if (!inPrefabStage) {
+            items.push({
+                id: 'asset.add-to-scene',
+                label: '添加 Prefab 到场景',
+                separatorBefore: true,
+                disabled: !placeable,
+                disabledReason: '该 Prefab 当前不可放置。',
+            });
+            items.push({
+                id: 'asset.place',
+                label: '进入 Prefab 放置模式',
+                disabled: !placeable,
+                disabledReason: '该 Prefab 当前不可放置。',
+            });
+        }
+    }
     else {
-        items.push({
-            id: 'asset.add-to-scene',
-            label: '添加到场景',
-            disabled: !placeable,
-            disabledReason: '该模型当前不可放置。',
-        });
-        items.push({
-            id: 'asset.place',
-            label: '进入放置模式',
-            disabled: !placeable,
-            disabledReason: '该模型当前不可放置。',
-        });
-        items.push({
-            id: 'asset.add-as-child',
-            label: '添加为当前节点子对象',
-            disabled: true,
-            disabledReason: '子对象添加动作将在资产 patch 中接入。',
-            separatorBefore: true,
-        });
-        items.push({
-            id: 'asset.replace-selected-model',
-            label: '替换当前模型',
-            disabled: true,
-            disabledReason: '模型替换动作将在资产 patch 中接入。',
-        });
+        if (inPrefabStage) {
+            items.push({
+                id: 'asset.add-to-current-prefab',
+                label: '添加到当前 Prefab',
+                disabled: !placeable,
+                disabledReason: '该模型当前不可添加到当前 Prefab。',
+            });
+        }
+        if (!inPrefabStage) {
+            items.push({
+                id: 'asset.add-to-scene',
+                label: '添加到场景',
+                disabled: !placeable,
+                disabledReason: '该模型当前不可放置。',
+            });
+            items.push({
+                id: 'asset.place',
+                label: '进入放置模式',
+                disabled: !placeable,
+                disabledReason: '该模型当前不可放置。',
+            });
+            items.push({
+                id: 'asset.create-prefab',
+                label: '创建 Prefab',
+                disabled: !asset.assetId && !asset.id,
+                disabledReason: '该模型缺少可创建 Prefab 的 Asset ID。',
+                separatorBefore: true,
+            });
+            items.push({
+                id: 'asset.add-as-child',
+                label: '添加为当前节点子对象',
+                disabled: true,
+                disabledReason: '子对象添加动作将在资产 patch 中接入。',
+            });
+            items.push({
+                id: 'asset.replace-selected-model',
+                label: '替换当前模型',
+                disabled: true,
+                disabledReason: '模型替换动作将在资产 patch 中接入。',
+            });
+        }
     }
     items.push({
         id: 'asset.copy-id',
@@ -1532,24 +2255,24 @@ function getMaterialAssetDeleteDisabledReason(asset) {
         return `该材质正在被 ${usageCount} 处使用，请先替换或解绑。`;
     return undefined;
 }
-function resolveBrowserAssetKind(asset) {
-    const kind = `${asset.kind ?? ''}`.trim().toLowerCase();
-    const id = `${asset.id ?? ''}`.trim().toLowerCase();
-    const assetId = `${asset.assetId ?? ''}`.trim().toLowerCase();
-    if (kind === 'material' || id.startsWith('material:') || assetId.startsWith('mat_'))
-        return 'material';
-    if (kind === 'texture' || kind === 'image' || id.startsWith('texture:') || assetId.startsWith('texture_'))
-        return 'texture';
-    return 'model';
-}
-function createAssetBrowserActionInput(actionId, asset) {
+function createAssetBrowserActionInput(actionId, asset, context) {
     return {
         actionId,
         assetId: asset.assetId ?? asset.id,
         browserAssetId: asset.id,
-        assetKind: asset.kind,
+        assetKind: asset.kind ?? resolveLocalEditorBrowserAssetKind(asset),
+        ...(context?.targetPrefabAssetId ? { targetPrefabAssetId: context.targetPrefabAssetId } : {}),
+        ...(context?.parentNodeId ? { parentNodeId: context.parentNodeId } : {}),
     };
 }
+export function resolveAssetBrowserDoubleClickAction(state, asset) {
+    const assetKind = resolveLocalEditorBrowserAssetKind(asset);
+    if (state.prefabStage && (assetKind === 'model' || assetKind === 'prefab'))
+        return 'asset.add-to-current-prefab';
+    if (!state.prefabStage && assetKind === 'prefab')
+        return 'asset.edit-prefab';
+    return null;
+}
 function copyTextToClipboard(win, text) {
     void win?.navigator?.clipboard?.writeText?.(text);
 }
@@ -1755,6 +2478,7 @@ export function createLocalEditorBrowserUi(options = {}) {
     const redoButton = createToolbarIconButton(doc, '重做', 'redo', '重做');
     let helpOpen = false;
     let performanceMonitorOpen = false;
+    let prefabComparisonPreviewOpen = true;
     let assetPreviewOpen = false;
     let previewedAsset = null;
     let assetPreviewMode = 'preview';
@@ -1762,9 +2486,14 @@ export function createLocalEditorBrowserUi(options = {}) {
     let assetPickerFilter = '';
     let assetPickerInput = null;
     let assetPickerProperty = null;
+    let prefabComparisonPreviewDrag = null;
+    let prefabStageMainWorkbenchLayoutSnapshot = null;
     const editorStatusButton = createToolbarIconButton(doc, '编辑器状态', 'status', '编辑器状态');
     editorStatusButton.dataset.editorStatusButton = 'true';
     editorStatusButton.style.cursor = 'help';
+    const agentBridgeStatusButton = createToolbarIconButton(doc, 'Agent Bridge 状态', 'status', 'Agent Bridge 状态');
+    agentBridgeStatusButton.dataset.editorAgentBridgeStatusButton = 'true';
+    agentBridgeStatusButton.style.cursor = 'help';
     const workbench = createLocalEditorWorkbench(doc);
     const leftDockTabs = doc.createElement('div');
     const hierarchyPanel = createWorkbenchPanelContent(doc);
@@ -1772,14 +2501,22 @@ export function createLocalEditorBrowserUi(options = {}) {
     const rightDockTabs = doc.createElement('div');
     const inspectorPanel = createWorkbenchPanelContent(doc);
     const renderingPanel = createWorkbenchPanelContent(doc);
+    const markersPanel = createWorkbenchPanelContent(doc);
     workbench.leftDock.appendChild(leftDockTabs);
     workbench.leftDock.appendChild(hierarchyPanel);
     workbench.rightDock.appendChild(rightDockTabs);
     workbench.rightDock.appendChild(inspectorPanel);
     workbench.rightDock.appendChild(renderingPanel);
+    workbench.rightDock.appendChild(markersPanel);
     root.appendChild(workbench.root);
     tooltipSurfaces.add(workbench.root);
-    const workbenchLayoutController = createLocalEditorWorkbenchLayoutController(doc, workbench);
+    const workbenchLayoutController = createLocalEditorWorkbenchLayoutController(doc, workbench, {
+        onAfterApply(layout) {
+            if (currentState?.mode === 'editor' && currentState.prefabStage) {
+                applyPrefabStageWorkbenchLayoutOverride(layout);
+            }
+        },
+    });
     const findAssetBrowserScrollViewport = () => (assetPanel.querySelector('[data-editor-asset-browser-scroll-viewport]'));
     const assetBrowserViewportReveal = createLocalEditorViewportRevealController({
         getViewport: findAssetBrowserScrollViewport,
@@ -2152,13 +2889,20 @@ export function createLocalEditorBrowserUi(options = {}) {
     performanceMonitorButton.dataset.performanceMonitorToggle = 'true';
     const gridToggleButton = createToolbarIconButton(doc, '网格', 'grid', '显示 / 隐藏 Scene View 网格');
     gridToggleButton.dataset.editorGridToggle = 'true';
+    const prefabComparisonPreviewButton = createToolbarIconButton(doc, '对比预览', 'eye', 'Compare Previews (Shift+P)', 'toggle');
+    prefabComparisonPreviewButton.dataset.prefabComparisonPreviewToggle = 'true';
     const sceneHelpButton = createToolbarIconButton(doc, '快捷键', 'help', '快捷键与操作说明');
     sceneQuickActions.appendChild(localTestGroup);
+    const prefabStageBackButton = createToolbarIconButton(doc, '返回场景', 'chevron-right', '返回主场景');
+    prefabStageBackButton.dataset.editorPrefabStageBack = 'true';
+    prefabStageBackButton.style.display = 'none';
+    sceneQuickActions.appendChild(prefabStageBackButton);
     sceneQuickActions.appendChild(undoButton);
     sceneQuickActions.appendChild(redoButton);
     sceneQuickActions.appendChild(dirtyBadge);
     sceneUtilityActions.appendChild(performanceMonitorButton);
     sceneUtilityActions.appendChild(gridToggleButton);
+    sceneUtilityActions.appendChild(prefabComparisonPreviewButton);
     sceneUtilityActions.appendChild(themeToggleButton);
     sceneUtilityActions.appendChild(sceneHelpButton);
     const cameraPreviewGroup = doc.createElement('div');
@@ -2190,6 +2934,9 @@ export function createLocalEditorBrowserUi(options = {}) {
     const projectionToggleButton = createToolbarIconButton(doc, '投影模式', 'projection-perspective', '切换投影模式');
     projectionToggleButton.dataset.viewportProjectionToggle = 'true';
     viewportToolsGroup.appendChild(projectionToggleButton);
+    const markerVisibilityButton = createToolbarIconButton(doc, '标记视图', 'view-overlay', '隐藏标记与关系线', 'toggle');
+    markerVisibilityButton.dataset.viewportMarkerVisibilityToggle = 'true';
+    viewportToolsGroup.appendChild(markerVisibilityButton);
     const overlaySettingsButton = createToolbarIconButton(doc, '视口信息层设置', 'view-overlay', '视口信息层设置', 'settings');
     overlaySettingsButton.dataset.viewportOverlaySettingsToggle = 'true';
     viewportToolsGroup.appendChild(overlaySettingsButton);
@@ -2266,6 +3013,112 @@ export function createLocalEditorBrowserUi(options = {}) {
     const coordinateAxesOverlay = createCoordinateAxesOverlay(doc);
     const sceneFrameRateOverlay = createSceneFrameRateOverlay(doc);
     const performanceMonitorOverlay = createPerformanceMonitorOverlay(doc);
+    const prefabImportStatsOverlay = createPrefabImportStatsOverlay(doc);
+    const prefabComparisonPreviewOverlay = createPrefabComparisonPreviewOverlay(doc);
+    const prefabStagePreviewLayout = createPrefabStagePreviewLayout(doc);
+    prefabImportStatsOverlay.root.style.position = 'absolute';
+    prefabImportStatsOverlay.root.style.top = '10px';
+    prefabImportStatsOverlay.root.style.right = '14px';
+    prefabComparisonPreviewOverlay.root.style.height = '100%';
+    prefabStagePreviewLayout.mainRegion.appendChild(prefabImportStatsOverlay.root);
+    prefabStagePreviewLayout.comparisonColumn.appendChild(prefabComparisonPreviewOverlay.root);
+    const emitPrefabComparisonPreviewInteraction = (input) => {
+        if (currentState?.mode !== 'editor' || !currentState.prefabStage)
+            return;
+        callbacks.onPrefabComparisonPreviewInteraction?.(input);
+    };
+    const endPrefabComparisonPreviewDrag = (pointerId) => {
+        const drag = prefabComparisonPreviewDrag;
+        if (!drag || (pointerId != null && drag.pointerId !== pointerId))
+            return;
+        try {
+            if (!drag.surface.hasPointerCapture || drag.surface.hasPointerCapture(drag.pointerId)) {
+                drag.surface.releasePointerCapture?.(drag.pointerId);
+            }
+        }
+        catch {
+            // Pointer capture may already be released by the browser when this cleanup runs.
+        }
+        drag.surface.style.cursor = 'grab';
+        prefabComparisonPreviewDrag = null;
+    };
+    const onPrefabComparisonPreviewPointerDown = (event) => {
+        if (event.button !== 0 || currentState?.mode !== 'editor' || !currentState.prefabStage)
+            return;
+        const surface = findPrefabComparisonPreviewSurface(event.target);
+        if (!surface || !isPrefabComparisonPreviewSurfaceReady(surface))
+            return;
+        const previewId = readPrefabComparisonPreviewSurfaceId(surface);
+        if (!previewId)
+            return;
+        event.preventDefault();
+        event.stopPropagation();
+        endPrefabComparisonPreviewDrag();
+        try {
+            surface.setPointerCapture?.(event.pointerId);
+        }
+        catch {
+            // Pointer capture is an input nicety; drag state still works through the overlay listener.
+        }
+        surface.style.cursor = 'grabbing';
+        prefabComparisonPreviewDrag = {
+            pointerId: event.pointerId,
+            previewId,
+            surface,
+            lastClientX: event.clientX,
+            lastClientY: event.clientY,
+        };
+    };
+    const onPrefabComparisonPreviewPointerMove = (event) => {
+        const drag = prefabComparisonPreviewDrag;
+        if (!drag || drag.pointerId !== event.pointerId)
+            return;
+        event.preventDefault();
+        event.stopPropagation();
+        const deltaX = event.clientX - drag.lastClientX;
+        const deltaY = event.clientY - drag.lastClientY;
+        drag.lastClientX = event.clientX;
+        drag.lastClientY = event.clientY;
+        if (Math.abs(deltaX) < 0.001 && Math.abs(deltaY) < 0.001)
+            return;
+        emitPrefabComparisonPreviewInteraction({
+            kind: 'orbit',
+            previewId: drag.previewId,
+            deltaX,
+            deltaY,
+        });
+    };
+    const onPrefabComparisonPreviewPointerEnd = (event) => {
+        const drag = prefabComparisonPreviewDrag;
+        if (!drag || drag.pointerId !== event.pointerId)
+            return;
+        event.preventDefault();
+        event.stopPropagation();
+        endPrefabComparisonPreviewDrag(event.pointerId);
+    };
+    const onPrefabComparisonPreviewWheel = (event) => {
+        if (currentState?.mode !== 'editor' || !currentState.prefabStage)
+            return;
+        const surface = findPrefabComparisonPreviewSurface(event.target);
+        if (!surface || !isPrefabComparisonPreviewSurfaceReady(surface))
+            return;
+        const previewId = readPrefabComparisonPreviewSurfaceId(surface);
+        if (!previewId)
+            return;
+        event.preventDefault();
+        event.stopPropagation();
+        emitPrefabComparisonPreviewInteraction({
+            kind: 'zoom',
+            previewId,
+            deltaY: event.deltaY,
+        });
+    };
+    prefabComparisonPreviewOverlay.root.addEventListener('pointerdown', onPrefabComparisonPreviewPointerDown);
+    prefabComparisonPreviewOverlay.root.addEventListener('pointermove', onPrefabComparisonPreviewPointerMove);
+    prefabComparisonPreviewOverlay.root.addEventListener('pointerup', onPrefabComparisonPreviewPointerEnd);
+    prefabComparisonPreviewOverlay.root.addEventListener('pointercancel', onPrefabComparisonPreviewPointerEnd);
+    prefabComparisonPreviewOverlay.root.addEventListener('lostpointercapture', onPrefabComparisonPreviewPointerEnd);
+    prefabComparisonPreviewOverlay.root.addEventListener('wheel', onPrefabComparisonPreviewWheel, { passive: false });
     const spatialOverlay = createSpatialOverlay(doc);
     const measurementOverlay = createMeasurementOverlay(doc);
     sceneToolOverlay.appendChild(sceneTitle);
@@ -2279,6 +3132,7 @@ export function createLocalEditorBrowserUi(options = {}) {
     sceneToolOverlay.appendChild(viewportToolsGroup);
     sceneToolOverlay.appendChild(sceneUtilityActions);
     sceneToolOverlay.appendChild(cameraPreviewGroup);
+    sceneToolOverlay.appendChild(agentBridgeStatusButton);
     sceneToolOverlay.appendChild(editorStatusButton);
     sceneToolOverlay.appendChild(toolbarOverflowButton);
     workbench.sceneHeader.appendChild(sceneToolOverlay);
@@ -2286,6 +3140,7 @@ export function createLocalEditorBrowserUi(options = {}) {
     workbench.sceneFrame.appendChild(measurementOverlay.root);
     workbench.sceneFrame.appendChild(sceneFrameRateOverlay.root);
     workbench.sceneFrame.appendChild(performanceMonitorOverlay.root);
+    workbench.sceneFrame.appendChild(prefabStagePreviewLayout.root);
     workbench.sceneFrame.appendChild(coordinateAxesOverlay.root);
     root.appendChild(localTestMenu);
     root.appendChild(toolbarOverflowMenu);
@@ -2483,6 +3338,9 @@ export function createLocalEditorBrowserUi(options = {}) {
         applyLocalEditorTheme(measurementOverlay.root, activeTheme);
         applyLocalEditorTheme(sceneFrameRateOverlay.root, activeTheme);
         applyLocalEditorTheme(performanceMonitorOverlay.root, activeTheme);
+        applyLocalEditorTheme(prefabStagePreviewLayout.root, activeTheme);
+        applyLocalEditorTheme(prefabImportStatsOverlay.root, activeTheme);
+        applyLocalEditorTheme(prefabComparisonPreviewOverlay.root, activeTheme);
         applyLocalEditorTheme(shortcutHelpPanel, activeTheme);
         applyLocalEditorTheme(assetPreviewModal, activeTheme);
         applyLocalEditorTheme(assetPickerModal, activeTheme);
@@ -2700,6 +3558,7 @@ export function createLocalEditorBrowserUi(options = {}) {
         viewportToolsGroup,
         sceneUtilityActions,
         cameraPreviewGroup,
+        agentBridgeStatusButton,
         editorStatusButton,
         toolbarOverflowButton,
     ];
@@ -2713,6 +3572,7 @@ export function createLocalEditorBrowserUi(options = {}) {
         { id: 'snap', element: snapGroup, kind: 'group' },
         { id: 'space', element: spaceGroup, kind: 'group' },
         { id: 'static-shadow-bake', element: staticShadowBakeGroup, kind: 'group' },
+        { id: 'agent-bridge-status', element: agentBridgeStatusButton, kind: 'group' },
     ];
     let toolbarOverflowOpen = false;
     let toolbarOverflowRaf = null;
@@ -3002,6 +3862,9 @@ export function createLocalEditorBrowserUi(options = {}) {
     performanceMonitorButton.addEventListener('click', () => {
         setPerformanceMonitorOpen(!performanceMonitorOpen);
     });
+    prefabComparisonPreviewButton.addEventListener('click', () => {
+        setPrefabComparisonPreviewOpen(!prefabComparisonPreviewOpen);
+    });
     gridToggleButton.addEventListener('click', () => {
         const visible = currentState?.grid?.visible ?? true;
         callbacks.onGridVisibleChange?.(!visible);
@@ -3055,6 +3918,12 @@ export function createLocalEditorBrowserUi(options = {}) {
             callbacks.onViewportProjectionModeChange?.(nextMode);
             return;
         }
+        const markerVisibilityToggle = target?.closest('[data-viewport-marker-visibility-toggle]');
+        if (markerVisibilityToggle) {
+            const markersVisible = currentState?.viewportTools?.markersVisible ?? true;
+            callbacks.onMarkerViewportVisibilityChange?.(!markersVisible);
+            return;
+        }
         const overlayToggle = target?.closest('[data-viewport-overlay-settings-toggle]');
         if (overlayToggle) {
             event.stopPropagation();
@@ -3088,10 +3957,21 @@ export function createLocalEditorBrowserUi(options = {}) {
             contextMenu.close();
         performanceMonitorOpen = open;
         LocalEditorShared.applyButtonActiveState(performanceMonitorButton, performanceMonitorOpen);
-        renderPerformanceMonitorOverlay(performanceMonitorOverlay, currentState?.mode === 'editor' ? currentState.performanceStats ?? null : null, currentState?.mode === 'editor' && performanceMonitorOpen);
+        renderPerformanceMonitorOverlay(performanceMonitorOverlay, currentState?.mode === 'editor' && !currentState.prefabStage ? currentState.performanceStats ?? null : null, currentState?.mode === 'editor' && !currentState.prefabStage && performanceMonitorOpen);
         if (notify)
             callbacks.onPerformanceMonitorOpenChange?.(performanceMonitorOpen);
     };
+    const setPrefabComparisonPreviewOpen = (open) => {
+        if (prefabComparisonPreviewOpen === open)
+            return;
+        if (!open)
+            endPrefabComparisonPreviewDrag();
+        prefabComparisonPreviewOpen = open;
+        if (currentState)
+            renderPreviewState(currentState);
+        LocalEditorShared.applyButtonActiveState(prefabComparisonPreviewButton, prefabComparisonPreviewOpen);
+        callbacks.onPrefabComparisonPreviewLayoutChange?.();
+    };
     const openAssetPreviewModal = (asset) => {
         if (!asset.preview)
             return;
@@ -3116,6 +3996,20 @@ export function createLocalEditorBrowserUi(options = {}) {
         syncInputModalOpen();
         assetPreviewCloseButton.focus({ preventScroll: true });
     };
+    const openAssetRenameModal = (asset) => {
+        contextMenu.close();
+        previewedAsset = asset;
+        assetPreviewMode = 'rename';
+        assetPreviewDialog.setAttribute('aria-label', '重命名资产');
+        assetPreviewOpen = true;
+        renderAssetPreviewModal();
+        syncInputModalOpen();
+        setTimeout(() => {
+            const input = assetPreviewBody.querySelector('[data-editor-asset-rename-input]');
+            input?.focus({ preventScroll: true });
+            input?.select();
+        }, 0);
+    };
     const closeAssetPreviewModal = () => {
         if (!assetPreviewOpen)
             return;
@@ -3164,7 +4058,10 @@ export function createLocalEditorBrowserUi(options = {}) {
     }
     function renderAssetPreviewModal() {
         const asset = resolvePreviewedAssetFromState();
-        if (!assetPreviewOpen || !asset || (assetPreviewMode === 'preview' && !asset.preview) || (assetPreviewMode === 'material-editor' && !asset.material)) {
+        if (!assetPreviewOpen
+            || !asset
+            || (assetPreviewMode === 'preview' && !asset.preview)
+            || (assetPreviewMode === 'material-editor' && !asset.material)) {
             assetPreviewModal.style.display = 'none';
             assetPreviewTitle.textContent = '';
             assetPreviewMeta.textContent = '';
@@ -3177,6 +4074,11 @@ export function createLocalEditorBrowserUi(options = {}) {
             assetPreviewModal.style.display = 'flex';
             return;
         }
+        if (assetPreviewMode === 'rename') {
+            renderAssetRenameModal(asset);
+            assetPreviewModal.style.display = 'flex';
+            return;
+        }
         assetPreviewDialog.style.width = 'min(420px,calc(100vw - 64px))';
         assetPreviewBody.style.cssText = [
             'display:flex',
@@ -3197,6 +4099,49 @@ export function createLocalEditorBrowserUi(options = {}) {
         assetPreviewBody.appendChild(LocalEditorPanels.createAssetPreviewElement(doc, asset, 'modal'));
         assetPreviewModal.style.display = 'flex';
     }
+    function renderAssetRenameModal(asset) {
+        assetPreviewDialog.style.width = 'min(420px,calc(100vw - 64px))';
+        assetPreviewTitle.textContent = '重命名 Prefab';
+        assetPreviewMeta.textContent = asset.assetId ?? asset.id;
+        while (assetPreviewBody.firstChild)
+            assetPreviewBody.removeChild(assetPreviewBody.firstChild);
+        assetPreviewBody.style.cssText = [
+            'display:flex',
+            'align-items:stretch',
+            'justify-content:stretch',
+            'min-height:0',
+            'border:1px solid var(--fps-editor-divider)',
+            'border-radius:4px',
+            'background:var(--fps-editor-panel-soft)',
+            'padding:12px',
+        ].join(';');
+        const form = doc.createElement('form');
+        form.dataset.editorAssetRenameForm = 'true';
+        form.style.cssText = 'display:grid;grid-template-columns:minmax(0,1fr) auto;gap:8px;width:100%;align-items:center';
+        const input = doc.createElement('input');
+        input.type = 'text';
+        input.dataset.editorAssetRenameInput = 'true';
+        input.value = asset.label;
+        input.maxLength = 80;
+        input.required = true;
+        input.style.cssText = [
+            'height:30px',
+            'min-width:0',
+            'box-sizing:border-box',
+            'border:1px solid var(--fps-editor-border)',
+            'border-radius:3px',
+            'background:var(--fps-editor-field)',
+            'color:var(--fps-editor-text)',
+            'font-size:12px',
+            'padding:0 8px',
+            'outline:none',
+        ].join(';');
+        const submit = LocalEditorShared.createButton(doc, '确认');
+        submit.type = 'submit';
+        form.appendChild(input);
+        form.appendChild(submit);
+        assetPreviewBody.appendChild(form);
+    }
     function renderAssetMaterialEditorModal(asset) {
         const material = asset.material;
         const profile = material.profile ?? {};
@@ -3404,7 +4349,7 @@ export function createLocalEditorBrowserUi(options = {}) {
         const options = [{ label: '继承 / 无', value: '', meta: '清空贴图引用' }];
         const seen = new Set(['']);
         for (const asset of currentState?.assets ?? []) {
-            if (resolveBrowserAssetKind(asset) !== 'texture')
+            if (resolveLocalEditorBrowserAssetKind(asset) !== 'texture')
                 continue;
             const value = asset.preview?.kind === 'image'
                 ? asset.preview.url
@@ -3564,6 +4509,9 @@ export function createLocalEditorBrowserUi(options = {}) {
     sceneHelpButton.addEventListener('click', () => {
         setShortcutHelpOpen(!helpOpen);
     });
+    prefabStageBackButton.addEventListener('click', () => {
+        callbacks.onExitPrefabStage?.();
+    });
     themeToggleButton.addEventListener('click', () => {
         setActiveTheme(activeTheme === 'dark' ? 'light' : 'dark');
     });
@@ -3583,14 +4531,32 @@ export function createLocalEditorBrowserUi(options = {}) {
             closeAssetPreviewModal();
     });
     assetPreviewBody.addEventListener('change', (event) => {
+        const target = event.target instanceof HTMLElement ? event.target : null;
         if (assetPreviewMode !== 'material-editor')
             return;
-        const target = event.target instanceof HTMLElement ? event.target : null;
         const input = target?.closest('[data-editor-asset-material-field]');
         if (!input)
             return;
         dispatchMaterialEditorFieldChange(input);
     });
+    assetPreviewBody.addEventListener('submit', (event) => {
+        if (assetPreviewMode !== 'rename')
+            return;
+        event.preventDefault();
+        const asset = resolvePreviewedAssetFromState();
+        const form = event.target instanceof HTMLFormElement
+            ? event.target.closest('[data-editor-asset-rename-form]')
+            : null;
+        const input = form?.querySelector('[data-editor-asset-rename-input]');
+        const name = input?.value.trim() ?? '';
+        if (!asset || !name)
+            return;
+        callbacks.onAssetAction?.({
+            ...createAssetBrowserActionInput('asset.rename', asset),
+            value: name,
+        });
+        closeAssetPreviewModal();
+    });
     assetPickerModal.addEventListener('click', (event) => {
         const target = event.target instanceof HTMLElement ? event.target : null;
         if (target?.closest('[data-editor-asset-picker-close]')) {
@@ -3705,6 +4671,18 @@ export function createLocalEditorBrowserUi(options = {}) {
             return;
         }
     }
+    function createCurrentAssetBrowserActionContext() {
+        const stage = currentState?.prefabStage;
+        if (!stage)
+            return undefined;
+        const selectedItem = findLocalEditorPrefabStageStructureItem(stage, stage.selectedItemId);
+        return {
+            targetPrefabAssetId: stage.assetId,
+            ...(selectedItem?.itemType === 'prefab-node' && selectedItem.nodeId
+                ? { parentNodeId: selectedItem.nodeId }
+                : {}),
+        };
+    }
     assetPanel.addEventListener('click', (event) => {
         const target = event.target instanceof HTMLElement ? event.target : null;
         const tabButton = target?.closest('[data-editor-dock-tab]');
@@ -3738,6 +4716,22 @@ export function createLocalEditorBrowserUi(options = {}) {
             return;
         }
     });
+    assetPanel.addEventListener('dblclick', (event) => {
+        const target = event.target instanceof HTMLElement ? event.target : null;
+        const assetButton = target?.closest('[data-editor-asset-id]');
+        const browserAssetId = assetButton?.dataset.editorAssetId;
+        if (!browserAssetId || !currentState)
+            return;
+        const asset = currentState.assets.find(candidate => candidate.id === browserAssetId);
+        const actionId = asset ? resolveAssetBrowserDoubleClickAction(currentState, asset) : null;
+        if (!asset || !actionId)
+            return;
+        event.preventDefault();
+        event.stopPropagation();
+        suppressAssetBrowserRevealIfVisible(assetButton);
+        callbacks.onSelectAsset?.(browserAssetId);
+        callbacks.onAssetAction?.(createAssetBrowserActionInput(actionId, asset, createCurrentAssetBrowserActionContext()));
+    });
     assetPanel.addEventListener('contextmenu', (event) => {
         const target = event.target instanceof HTMLElement ? event.target : null;
         const assetButton = target?.closest('[data-editor-asset-id]');
@@ -3764,11 +4758,19 @@ export function createLocalEditorBrowserUi(options = {}) {
                     openAssetMaterialEditorModal(asset);
                     return;
                 }
+                if (item.id === 'asset.rename') {
+                    openAssetRenameModal(asset);
+                    return;
+                }
+                if (item.id === 'asset.edit-prefab' || item.id === 'asset.add-to-current-prefab') {
+                    callbacks.onAssetAction?.(createAssetBrowserActionInput(item.id, asset, createCurrentAssetBrowserActionContext()));
+                    return;
+                }
                 if (item.id === 'asset.copy-id') {
                     copyTextToClipboard(doc.defaultView, asset.assetId ?? asset.id);
                     return;
                 }
-                callbacks.onAssetAction?.(createAssetBrowserActionInput(item.id, asset));
+                callbacks.onAssetAction?.(createAssetBrowserActionInput(item.id, asset, createCurrentAssetBrowserActionContext()));
             },
         });
     });
@@ -3776,7 +4778,7 @@ export function createLocalEditorBrowserUi(options = {}) {
         const target = event.target instanceof HTMLElement ? event.target : null;
         const openTabButton = target?.closest('[data-editor-open-right-dock-tab]');
         const openTab = openTabButton?.dataset.editorOpenRightDockTab;
-        if (openTab === 'inspector' || openTab === 'rendering') {
+        if (isLocalEditorRightDockTab(openTab)) {
             panelRegistry.setRightDockTab(openTab);
             if (currentState)
                 render(currentState);
@@ -3784,7 +4786,7 @@ export function createLocalEditorBrowserUi(options = {}) {
         }
         const tabButton = target?.closest('[data-editor-right-dock-tab]');
         const tab = tabButton?.dataset.editorRightDockTab;
-        if (tab === 'inspector' || tab === 'rendering') {
+        if (isLocalEditorRightDockTab(tab)) {
             panelRegistry.setRightDockTab(tab);
             if (currentState)
                 render(currentState);
@@ -3882,6 +4884,28 @@ export function createLocalEditorBrowserUi(options = {}) {
             callbacks.onRenderingAction?.(actionInput);
             return;
         }
+        const inspectorActionButton = target?.closest('[data-editor-inspector-action]');
+        if (inspectorActionButton) {
+            if (inspectorActionButton.disabled)
+                return;
+            const actionInput = createInspectorActionInput(inspectorActionButton);
+            if (!actionInput)
+                return;
+            event.preventDefault();
+            event.stopPropagation();
+            callbacks.onInspectorAction?.(actionInput);
+            return;
+        }
+        const relationTarget = target?.closest('[data-editor-marker-relation-action]');
+        if (relationTarget && !(relationTarget instanceof HTMLButtonElement && relationTarget.disabled)) {
+            const relationInput = createMarkerRelationActionInput(relationTarget);
+            if (!relationInput)
+                return;
+            event.preventDefault();
+            event.stopPropagation();
+            callbacks.onMarkerRelationAction?.(relationInput);
+            return;
+        }
         const vectorLockButton = target?.closest('[data-editor-inspector-vector-lock]');
         if (vectorLockButton) {
             const groupPath = vectorLockButton.dataset.editorInspectorVectorLock;
@@ -4084,6 +5108,28 @@ export function createLocalEditorBrowserUi(options = {}) {
             openStaticShadowBakePopover();
         callbacks.onRenderingAction?.(actionInput);
     });
+    markersPanel.addEventListener('click', (event) => {
+        const eventTarget = event.target instanceof HTMLElement ? event.target : null;
+        const relationTarget = eventTarget?.closest('[data-editor-marker-relation-action]');
+        if (relationTarget && !(relationTarget instanceof HTMLButtonElement && relationTarget.disabled)) {
+            const relationInput = createMarkerRelationActionInput(relationTarget);
+            if (!relationInput)
+                return;
+            event.preventDefault();
+            event.stopPropagation();
+            callbacks.onMarkerRelationAction?.(relationInput);
+            return;
+        }
+        const actionButton = eventTarget?.closest('[data-editor-marker-type-action]');
+        if (!actionButton || actionButton.disabled)
+            return;
+        const actionInput = createMarkerTypeActionInput(actionButton);
+        if (!actionInput)
+            return;
+        event.preventDefault();
+        event.stopPropagation();
+        callbacks.onMarkerTypeAction?.(actionInput);
+    });
     const onKeyDown = (event) => {
         if (event.defaultPrevented)
             return;
@@ -4128,7 +5174,24 @@ export function createLocalEditorBrowserUi(options = {}) {
         const primaryModifier = event.metaKey || event.ctrlKey;
         const handleDocumentShortcut = inputRouter.shouldHandleDocumentShortcut(event);
         const handleGlobalShortcut = inputRouter.shouldHandleGlobalShortcut(event);
-        if (handleDocumentShortcut && localTestActionsEnabled && primaryModifier && key === 's') {
+        if (shouldToggleLocalEditorPrefabComparisonShortcut({
+            inPrefabStage: currentState.prefabStage != null,
+            handleGlobalShortcut,
+            key,
+            shiftKey: event.shiftKey,
+            metaKey: event.metaKey,
+            ctrlKey: event.ctrlKey,
+            altKey: event.altKey,
+        })) {
+            event.preventDefault();
+            setPrefabComparisonPreviewOpen(!prefabComparisonPreviewOpen);
+            return;
+        }
+        if (handleDocumentShortcut
+            && localTestActionsEnabled
+            && isPreviewToolEnabled('local-test')
+            && primaryModifier
+            && key === 's') {
             event.preventDefault();
             callbacks.onSaveScene?.();
             return;
@@ -4146,7 +5209,18 @@ export function createLocalEditorBrowserUi(options = {}) {
             callbacks.onRedo?.();
             return;
         }
-        if (handleGlobalShortcut && hierarchyController.handleEditShortcut(event)) {
+        if (shouldLocalEditorPrefabStageBlockHierarchyShortcut({
+            inPrefabStage: currentState.prefabStage != null,
+            handleGlobalShortcut,
+            key,
+            metaKey: event.metaKey,
+            ctrlKey: event.ctrlKey,
+            altKey: event.altKey,
+        })) {
+            event.preventDefault();
+            return;
+        }
+        if (!currentState.prefabStage && handleGlobalShortcut && hierarchyController.handleEditShortcut(event)) {
             return;
         }
         if (!handleGlobalShortcut || event.metaKey || event.ctrlKey || event.altKey)
@@ -4160,20 +5234,24 @@ export function createLocalEditorBrowserUi(options = {}) {
         const tool = toolByKey[key];
         if (tool) {
             event.preventDefault();
-            callbacks.onTransformToolChange?.(tool);
+            if (isPreviewToolEnabled(tool))
+                callbacks.onTransformToolChange?.(tool);
             return;
         }
         if (key === 'f') {
             event.preventDefault();
-            callbacks.onFocusSelection?.();
+            if (isPreviewToolEnabled('focus-selection'))
+                callbacks.onFocusSelection?.();
             return;
         }
         if (key === 'escape') {
             event.preventDefault();
-            if (callbacks.onCancelEditorIntent)
-                callbacks.onCancelEditorIntent();
-            else
-                callbacks.onCancelActiveOperation?.();
+            if (isPreviewToolEnabled('cancel-selection')) {
+                if (callbacks.onCancelEditorIntent)
+                    callbacks.onCancelEditorIntent();
+                else
+                    callbacks.onCancelActiveOperation?.();
+            }
         }
     };
     doc.addEventListener('keydown', onKeyDown);
@@ -4190,8 +5268,193 @@ export function createLocalEditorBrowserUi(options = {}) {
             ? operationState.canAlign
             : operationState.canDistribute;
     }
+    function getPreviewToolSupport(tool) {
+        const inPrefabStage = currentState?.mode === 'editor' && !!currentState.prefabStage;
+        return resolveLocalEditorPreviewToolSupport({ inPrefabStage, tool });
+    }
+    function isPreviewToolVisible(tool) {
+        return currentState?.mode === 'editor' && getPreviewToolSupport(tool).support !== 'hidden';
+    }
+    function isPreviewToolEnabled(tool) {
+        return currentState?.mode === 'editor'
+            && currentState.busy !== true
+            && getPreviewToolSupport(tool).support === 'enabled';
+    }
+    function applyPrefabStageWorkbenchLayoutOverride(layout = workbenchLayoutController.getLayout()) {
+        const { leftWidth, rightWidth, bottomEdge, bottomVisible } = resolveLocalEditorPrefabStageWorkbenchLayout(layout, readLocalEditorWorkbenchViewport(doc));
+        workbench.leftDock.style.display = 'flex';
+        workbench.leftDock.style.width = `${leftWidth}px`;
+        workbench.leftDock.style.bottom = `${bottomEdge}px`;
+        workbench.leftDock.style.zIndex = '';
+        workbench.leftDock.style.boxShadow = '';
+        workbench.rightDock.style.display = 'flex';
+        workbench.rightDock.style.width = `${rightWidth}px`;
+        workbench.rightDock.style.zIndex = '';
+        workbench.rightDock.style.boxShadow = '';
+        workbench.sceneFrame.style.left = `${leftWidth}px`;
+        workbench.sceneFrame.style.right = `${rightWidth}px`;
+        workbench.sceneFrame.style.bottom = `${bottomEdge}px`;
+        if (bottomVisible) {
+            workbench.bottomDock.style.right = `${rightWidth}px`;
+            workbench.bottomResizer.style.right = `${rightWidth}px`;
+        }
+        workbench.leftToggle.style.display = 'none';
+        workbench.rightToggle.style.display = 'none';
+        workbench.leftResizer.style.bottom = `${bottomEdge}px`;
+        workbench.rightResizer.style.bottom = '0';
+    }
+    function readLocalEditorWorkbenchViewport(docRef) {
+        const win = docRef.defaultView;
+        return {
+            width: Math.max(320, win?.innerWidth ?? docRef.documentElement.clientWidth ?? 1280),
+            height: Math.max(320, win?.innerHeight ?? docRef.documentElement.clientHeight ?? 720),
+        };
+    }
+    function renderPrefabStagePropertiesPanel(stage) {
+        inspectorPanel.dataset.editorPanelId = 'prefab-properties';
+        inspectorPanel.style.display = '';
+        renderingPanel.style.display = 'none';
+        if (stage.inspectorObject) {
+            LocalEditorPanels.renderInspectorPanel(doc, inspectorPanel, {
+                ...currentState,
+                selectedIds: stage.inspectorObject.targetIds,
+                activeId: stage.inspectorObject.activeId,
+                selectionSummary: {
+                    count: stage.inspectorObject.targetIds.length,
+                    activeId: stage.inspectorObject.activeId,
+                },
+                serializedObject: null,
+                serializedMultiObject: null,
+                inspectorObject: stage.inspectorObject,
+                inspectorMultiObject: null,
+            }, inspectorFilter, {
+                ...options.inspector,
+                title: 'Prefab Properties',
+                emptyText: 'Select an item in Prefab Explorer.',
+                summaryTitle: 'Prefab',
+                lockedVectorGroups: lockedInspectorVectorGroups,
+            });
+            return;
+        }
+        LocalEditorShared.clearElement(inspectorPanel);
+        inspectorPanel.appendChild(createPrefabStagePanelHeader('Prefab Properties', 'inspector'));
+        const selectedItem = findLocalEditorPrefabStageStructureItem(stage, stage.selectedItemId);
+        const grid = doc.createElement('div');
+        grid.style.cssText = 'display:flex;flex-direction:column;gap:7px;min-width:0';
+        appendPrefabStageReadonlyRow(grid, '名称', stage.label);
+        appendPrefabStageReadonlyRow(grid, 'Prefab ID', stage.assetId);
+        appendPrefabStageReadonlyRow(grid, 'Source', stage.sourceAssetId ?? '未设置');
+        appendPrefabStageReadonlyRow(grid, 'Preview', stage.previewNodeId ?? '未生成');
+        appendPrefabStageReadonlyRow(grid, 'Selected', selectedItem?.label ?? stage.selectedItemId ?? 'Prefab Root');
+        appendPrefabStageReadonlyRow(grid, 'Mode', stage.readonly ? '只读' : '可编辑');
+        appendPrefabStageSelectedItemDetails(grid, selectedItem);
+        inspectorPanel.appendChild(grid);
+    }
+    function appendPrefabStageSelectedItemDetails(container, item) {
+        if (!item)
+            return;
+        appendPrefabStageReadonlyRow(container, 'Kind', item.kind);
+        if (item.sourceAssetId)
+            appendPrefabStageReadonlyRow(container, 'Source Asset', item.sourceAssetId);
+        if (item.slotId)
+            appendPrefabStageReadonlyRow(container, 'Slot ID', item.slotId);
+        if (item.ownerNodePath)
+            appendPrefabStageReadonlyRow(container, 'Owner Path', item.ownerNodePath);
+        if (item.meshIndex != null)
+            appendPrefabStageReadonlyRow(container, 'Mesh Index', String(item.meshIndex));
+        if (item.primitiveIndex != null)
+            appendPrefabStageReadonlyRow(container, 'Primitive', String(item.primitiveIndex));
+        if (item.sourceMaterialIndex != null) {
+            appendPrefabStageReadonlyRow(container, 'Material Index', String(item.sourceMaterialIndex));
+        }
+        if (item.sourceMaterialIndices?.length) {
+            appendPrefabStageReadonlyRow(container, 'Material Indices', item.sourceMaterialIndices.join(', '));
+        }
+        if (item.sourceMaterialName)
+            appendPrefabStageReadonlyRow(container, 'Material Name', item.sourceMaterialName);
+        if (item.sourceMaterialNames?.length) {
+            appendPrefabStageReadonlyRow(container, 'Material Names', item.sourceMaterialNames.join(', '));
+        }
+        if (item.meta)
+            appendPrefabStageReadonlyRow(container, 'Meta', item.meta);
+    }
+    function resolvePrefabStageAssetFromState(stage) {
+        return currentState?.assets.find(asset => (asset.id === stage.browserAssetId
+            || asset.id === `prefab:${stage.assetId}`
+            || asset.assetId === stage.assetId
+            || asset.prefab?.id === stage.assetId)) ?? null;
+    }
+    function createPrefabStagePanelHeader(title, icon) {
+        const header = doc.createElement('div');
+        header.style.cssText = [
+            'display:flex',
+            'align-items:center',
+            'gap:8px',
+            'min-height:30px',
+            'margin:-8px -8px 8px',
+            'padding:0 8px',
+            'border-bottom:1px solid var(--fps-editor-divider)',
+            'background:var(--fps-editor-chrome-dark)',
+        ].join(';');
+        header.appendChild(createLocalEditorIcon(doc, icon, { size: 14 }));
+        const label = doc.createElement('h2');
+        label.textContent = title;
+        label.style.cssText = [
+            'min-width:0',
+            'margin:0',
+            'overflow:hidden',
+            'text-overflow:ellipsis',
+            'white-space:nowrap',
+            'font-size:13px',
+            'font-weight:800',
+            'color:var(--fps-editor-text-strong)',
+        ].join(';');
+        header.appendChild(label);
+        return header;
+    }
+    function appendPrefabStageReadonlyRow(container, label, value) {
+        const row = doc.createElement('div');
+        row.style.cssText = [
+            'display:grid',
+            'grid-template-columns:92px minmax(0,1fr)',
+            'gap:8px',
+            'align-items:center',
+            'min-height:26px',
+        ].join(';');
+        const rowLabel = doc.createElement('div');
+        rowLabel.textContent = label;
+        rowLabel.style.cssText = [
+            'min-width:0',
+            'overflow:hidden',
+            'text-overflow:ellipsis',
+            'white-space:nowrap',
+            'color:var(--fps-editor-muted)',
+            'font-size:11px',
+            'font-weight:800',
+        ].join(';');
+        const output = doc.createElement('div');
+        output.textContent = value;
+        output.title = value;
+        output.style.cssText = [
+            'min-width:0',
+            'overflow:hidden',
+            'text-overflow:ellipsis',
+            'white-space:nowrap',
+            'padding:4px 7px',
+            'border:1px solid var(--fps-editor-border)',
+            'border-radius:3px',
+            'background:var(--fps-editor-field)',
+            'color:var(--fps-editor-text-strong)',
+            'font-size:12px',
+            'font-weight:800',
+        ].join(';');
+        row.appendChild(rowLabel);
+        row.appendChild(output);
+        container.appendChild(row);
+    }
     const renderPreviewState = (state) => {
         const inEditor = state.mode === 'editor';
+        const inPrefabStage = !!state.prefabStage;
         const disabled = state.busy;
         const transformTool = state.transformTool ?? null;
         const transformOperations = state.transformOperations ?? {
@@ -4234,9 +5497,30 @@ export function createLocalEditorBrowserUi(options = {}) {
         editorStatusButton.style.borderColor = state.statusTone == null || state.statusTone === 'default'
             ? 'var(--fps-editor-border)'
             : statusToneColor;
+        const agentBridgeStatusColor = resolveAgentBridgeStatusToneColor(state.agentBridge);
+        agentBridgeStatusButton.style.display = inEditor ? 'inline-flex' : 'none';
+        agentBridgeStatusButton.style.color = agentBridgeStatusColor;
+        agentBridgeStatusButton.style.borderColor = state.agentBridge?.status === 'disabled'
+            ? 'var(--fps-editor-border)'
+            : agentBridgeStatusColor;
+        setToolbarButtonTooltip(agentBridgeStatusButton, createAgentBridgeStatusTooltip(state.agentBridge));
         renderCoordinateAxesOverlay(coordinateAxesOverlay, inEditor ? state.coordinateAxes ?? null : null);
-        renderSceneFrameRateOverlay(sceneFrameRateOverlay, inEditor ? state.sceneFrameStats ?? null : null);
-        renderPerformanceMonitorOverlay(performanceMonitorOverlay, inEditor ? state.performanceStats ?? null : null, inEditor && performanceMonitorOpen);
+        renderSceneFrameRateOverlay(sceneFrameRateOverlay, inEditor && !inPrefabStage ? state.sceneFrameStats ?? null : null);
+        renderPerformanceMonitorOverlay(performanceMonitorOverlay, inEditor && !inPrefabStage ? state.performanceStats ?? null : null, inEditor && !inPrefabStage && performanceMonitorOpen);
+        const comparisonColumnVisible = shouldShowLocalEditorPrefabComparisonColumn({
+            inPrefabStage: inEditor && inPrefabStage,
+            userOpen: prefabComparisonPreviewOpen,
+            sceneWidth: workbench.sceneFrame.clientWidth,
+        });
+        if (!comparisonColumnVisible)
+            endPrefabComparisonPreviewDrag();
+        prefabStagePreviewLayout.root.style.display = inEditor && inPrefabStage ? 'block' : 'none';
+        prefabStagePreviewLayout.mainRegion.style.right = comparisonColumnVisible
+            ? `${LOCAL_EDITOR_PREFAB_COMPARISON_COLUMN_WIDTH_PX}px`
+            : '0';
+        prefabStagePreviewLayout.comparisonColumn.style.display = comparisonColumnVisible ? 'flex' : 'none';
+        renderPrefabImportStatsOverlay(prefabImportStatsOverlay, inEditor && inPrefabStage ? state.prefabStage ?? null : null);
+        renderPrefabComparisonPreviewOverlay(prefabComparisonPreviewOverlay, inEditor && inPrefabStage && comparisonColumnVisible ? state.prefabStage ?? null : null);
         renderSpatialOverlay(spatialOverlay, inEditor ? state.viewportSpatialOverlay ?? null : null);
         renderMeasurementOverlay(measurementOverlay, inEditor ? state.viewportMeasurement ?? null : null);
         const boxSelection = state.boxSelection;
@@ -4263,38 +5547,42 @@ export function createLocalEditorBrowserUi(options = {}) {
         };
         renderPreviewState(currentState);
         if (shouldRenderInspectorPreview && panelRegistry.getRightDockTab() === 'inspector') {
-            const rightDockScrollSnapshot = captureLocalEditorRightDockScrollSnapshot(currentState, 'inspector', inspectorFilter, inspectorPanel, renderingPanel);
+            const rightDockScrollSnapshot = captureLocalEditorRightDockScrollSnapshot(currentState, 'inspector', inspectorFilter, inspectorPanel, renderingPanel, markersPanel);
             LocalEditorPanels.renderInspectorPanel(doc, inspectorPanel, currentState, inspectorFilter, {
                 ...options.inspector,
                 lockedVectorGroups: lockedInspectorVectorGroups,
             });
-            restoreLocalEditorRightDockScrollSnapshot(rightDockScrollSnapshot, currentState, 'inspector', inspectorFilter, inspectorPanel, renderingPanel);
+            restoreLocalEditorRightDockScrollSnapshot(rightDockScrollSnapshot, currentState, 'inspector', inspectorFilter, inspectorPanel, renderingPanel, markersPanel);
         }
     };
     const render = (state) => {
         const previousState = currentState;
         const previousRightTab = panelRegistry.getRightDockTab();
-        const rightDockScrollSnapshot = captureLocalEditorRightDockScrollSnapshot(previousState, previousRightTab, inspectorFilter, inspectorPanel, renderingPanel);
+        const rightDockScrollSnapshot = captureLocalEditorRightDockScrollSnapshot(previousState, previousRightTab, inspectorFilter, inspectorPanel, renderingPanel, markersPanel);
         currentState = state;
         const focusSnapshot = captureLocalEditorEditableFocus(doc);
         const inEditor = state.mode === 'editor';
         const disabled = state.busy;
+        const prefabStage = inEditor ? state.prefabStage ?? null : null;
+        const inPrefabStage = !!prefabStage;
+        const previousInPrefabStage = previousState?.mode === 'editor' && !!previousState.prefabStage;
         if (!inEditor || disabled)
             contextMenu.close();
         hostChrome.style.display = !inEditor && localTestActionsEnabled ? 'flex' : 'none';
         enterEditorButton.disabled = disabled;
-        for (const button of [saveButton, saveAndRunButton, discardRunButton, undoButton, redoButton, sceneHelpButton, sceneCameraButton, performanceMonitorButton, gridToggleButton]) {
+        for (const button of [saveButton, saveAndRunButton, discardRunButton, undoButton, redoButton, sceneHelpButton, sceneCameraButton, performanceMonitorButton, gridToggleButton, prefabComparisonPreviewButton]) {
             button.style.display = 'inline-flex';
             button.disabled = disabled;
         }
-        localTestGroup.style.display = inEditor && localTestActionsEnabled ? 'flex' : 'none';
-        localTestButton.disabled = disabled;
-        if (!inEditor || !localTestActionsEnabled)
+        localTestGroup.style.display = isPreviewToolVisible('local-test') && localTestActionsEnabled ? 'flex' : 'none';
+        localTestButton.disabled = !isPreviewToolEnabled('local-test') || !localTestActionsEnabled;
+        if (!inEditor || !localTestActionsEnabled || localTestGroup.style.display === 'none')
             closeLocalTestMenu();
         if (!inEditor)
             helpOpen = false;
-        if (!inEditor && performanceMonitorOpen)
+        if (shouldLocalEditorClosePerformanceMonitor({ inEditor, inPrefabStage, performanceMonitorOpen })) {
             setPerformanceMonitorOpen(false);
+        }
         if (!inEditor || disabled) {
             assetPreviewOpen = false;
             previewedAsset = null;
@@ -4306,7 +5594,24 @@ export function createLocalEditorBrowserUi(options = {}) {
         syncInputModalOpen();
         const transformTool = state.transformTool ?? null;
         workbench.root.style.display = inEditor ? '' : 'none';
+        workbench.root.dataset.editorPrefabStage = String(inPrefabStage);
+        sceneTitle.textContent = createLocalEditorPrefabStageTitle(prefabStage);
         sceneToolOverlay.style.display = inEditor ? 'flex' : 'none';
+        prefabStageBackButton.style.display = inPrefabStage ? 'inline-flex' : 'none';
+        if (inPrefabStage && !previousInPrefabStage) {
+            prefabStageMainWorkbenchLayoutSnapshot = workbenchLayoutController.getLayout();
+            workbenchLayoutController.setBottomCollapsed(false);
+        }
+        else if (!inPrefabStage && previousInPrefabStage && prefabStageMainWorkbenchLayoutSnapshot) {
+            workbenchLayoutController.setLayout(prefabStageMainWorkbenchLayoutSnapshot, true);
+            prefabStageMainWorkbenchLayoutSnapshot = null;
+        }
+        workbench.leftToggle.style.display = '';
+        workbench.rightToggle.style.display = '';
+        workbench.bottomToggle.style.display = '';
+        workbenchLayoutController.refresh();
+        if (inPrefabStage)
+            applyPrefabStageWorkbenchLayoutOverride();
         if (!inEditor)
             closeSnapSettingsPopover();
         if (!inEditor)
@@ -4318,34 +5623,40 @@ export function createLocalEditorBrowserUi(options = {}) {
         if (!inEditor)
             closeStaticShadowBakePopover();
         const staticShadowBakeAction = findLocalEditorRenderingAction(state.renderingPanel, STATIC_SHADOW_BAKE_ACTION_ID);
-        const staticShadowBakeVisible = inEditor && !!staticShadowBakeAction;
+        const staticShadowBakeVisible = isPreviewToolVisible('static-shadow-bake') && !!staticShadowBakeAction;
         staticShadowBakeGroup.style.display = staticShadowBakeVisible ? 'flex' : 'none';
-        const staticShadowBakeDisabled = disabled || !staticShadowBakeAction || staticShadowBakeAction.action.disabled === true;
+        const staticShadowBakeSupport = getPreviewToolSupport('static-shadow-bake');
+        const staticShadowBakeDisabled = !isPreviewToolEnabled('static-shadow-bake') || !staticShadowBakeAction || staticShadowBakeAction.action.disabled === true;
         staticShadowBakeButton.disabled = staticShadowBakeDisabled;
         staticShadowBakeButton.style.opacity = staticShadowBakeDisabled ? '0.62' : '1';
         staticShadowBakeButton.style.cursor = staticShadowBakeDisabled ? 'not-allowed' : 'pointer';
         const staticShadowBakeIcon = staticShadowBakeAction?.action.icon;
         setToolbarButtonIcon(doc, staticShadowBakeButton, isLocalEditorIconName(staticShadowBakeIcon) ? staticShadowBakeIcon : 'save');
-        setToolbarButtonTooltip(staticShadowBakeButton, staticShadowBakeAction?.action.tooltip ?? staticShadowBakeAction?.action.label ?? '烘焙静态阴影');
+        setToolbarButtonTooltip(staticShadowBakeButton, staticShadowBakeSupport.support === 'enabled'
+            ? staticShadowBakeAction?.action.tooltip ?? staticShadowBakeAction?.action.label ?? '烘焙静态阴影'
+            : staticShadowBakeSupport.reason);
         LocalEditorShared.applyButtonActiveState(staticShadowBakeButton, !!staticShadowBakeAction?.system?.progress);
         renderStaticShadowBakePopover(state);
         const sceneCameraPreview = state.sceneCameraPreview ?? { enabled: false, available: false };
-        cameraPreviewGroup.style.display = inEditor ? 'flex' : 'none';
-        sceneCameraButton.disabled = disabled || !sceneCameraPreview.available;
+        cameraPreviewGroup.style.display = isPreviewToolVisible('scene-camera-preview') ? 'flex' : 'none';
+        const sceneCameraPreviewSupport = getPreviewToolSupport('scene-camera-preview');
+        sceneCameraButton.disabled = !isPreviewToolEnabled('scene-camera-preview') || !sceneCameraPreview.available;
         const sceneCameraTooltip = sceneCameraPreview.available
             ? '从 Main Camera 查看当前场景'
             : '当前场景没有可预览的 Main Camera';
-        setToolbarButtonTooltip(sceneCameraButton, sceneCameraTooltip);
+        setToolbarButtonTooltip(sceneCameraButton, sceneCameraPreviewSupport.support === 'enabled'
+            ? sceneCameraTooltip
+            : sceneCameraPreviewSupport.reason);
         LocalEditorShared.applyButtonActiveState(sceneCameraButton, sceneCameraPreview.enabled);
         const viewportTools = state.viewportTools ?? null;
-        const viewportControlsDisabled = disabled || sceneCameraPreview.enabled;
+        const viewportControlsDisabled = !isPreviewToolEnabled('viewport-camera') || sceneCameraPreview.enabled;
         const viewportControlsTooltip = sceneCameraPreview.enabled
             ? '当前为 Main Camera 预览，请关闭后再使用视口工具'
             : '';
         const viewportProjectionTooltip = sceneCameraPreview.enabled
             ? '当前为 Main Camera 预览，投影由 Main Camera 决定；关闭预览后可切换编辑视口投影'
             : '';
-        viewportToolsGroup.style.display = inEditor ? 'flex' : 'none';
+        viewportToolsGroup.style.display = isPreviewToolVisible('viewport-camera') ? 'flex' : 'none';
         for (const [preset, button] of viewportPresetButtons) {
             button.disabled = viewportControlsDisabled;
             setToolbarButtonTooltip(button, viewportControlsTooltip || VIEW_PRESET_TOOLTIPS[preset]);
@@ -4357,12 +5668,16 @@ export function createLocalEditorBrowserUi(options = {}) {
         setToolbarButtonIcon(doc, projectionToggleButton, projectionMode === 'orthographic' ? 'projection-ortho' : 'projection-perspective');
         setToolbarButtonTooltip(projectionToggleButton, viewportProjectionTooltip || `投影模式：${VIEWPORT_PROJECTION_LABELS[projectionMode]}。切换为${VIEWPORT_PROJECTION_LABELS[nextProjectionMode]}`);
         LocalEditorShared.applyButtonActiveState(projectionToggleButton, projectionMode === 'orthographic');
-        overlaySettingsButton.disabled = disabled;
+        const markersVisible = viewportTools?.markersVisible ?? true;
+        markerVisibilityButton.disabled = disabled;
+        setToolbarButtonTooltip(markerVisibilityButton, markersVisible ? '隐藏标记与关系线' : '显示标记与关系线');
+        LocalEditorShared.applyButtonActiveState(markerVisibilityButton, markersVisible);
+        overlaySettingsButton.disabled = !isPreviewToolEnabled('spatial-overlay');
         setToolbarButtonTooltip(overlaySettingsButton, '视口信息层设置');
         LocalEditorShared.applyButtonActiveState(overlaySettingsButton, overlaySettingsOpen);
         const overlaySettings = viewportTools?.overlay;
         for (const [key, input] of overlayInputs) {
-            input.disabled = disabled;
+            input.disabled = !isPreviewToolEnabled('spatial-overlay');
             input.checked = overlaySettings?.[key] ?? false;
         }
         measureButton.disabled = viewportControlsDisabled;
@@ -4378,18 +5693,33 @@ export function createLocalEditorBrowserUi(options = {}) {
         if (!inEditor || disabled || viewportToolsGroup.style.display === 'none')
             closeOverlaySettingsPopover();
         const gridState = state.grid ?? { visible: false, available: false };
-        performanceMonitorButton.disabled = disabled;
-        setToolbarButtonTooltip(performanceMonitorButton, performanceMonitorOpen ? '隐藏性能监控' : '显示性能监控');
+        performanceMonitorButton.style.display = isPreviewToolVisible('performance-monitor') ? 'inline-flex' : 'none';
+        performanceMonitorButton.disabled = !isPreviewToolEnabled('performance-monitor');
+        const performanceMonitorSupport = getPreviewToolSupport('performance-monitor');
+        setToolbarButtonTooltip(performanceMonitorButton, performanceMonitorSupport.support === 'enabled'
+            ? performanceMonitorOpen ? '隐藏性能监控' : '显示性能监控'
+            : performanceMonitorSupport.reason);
         LocalEditorShared.applyButtonActiveState(performanceMonitorButton, performanceMonitorOpen);
+        prefabComparisonPreviewButton.style.display = isPreviewToolVisible('prefab-comparison') ? 'inline-flex' : 'none';
+        prefabComparisonPreviewButton.disabled = !isPreviewToolEnabled('prefab-comparison');
+        const prefabComparisonSupport = getPreviewToolSupport('prefab-comparison');
+        setToolbarButtonTooltip(prefabComparisonPreviewButton, prefabComparisonSupport.support === 'enabled'
+            ? prefabComparisonPreviewOpen
+                ? '隐藏对比预览 (Shift+P)'
+                : '显示对比预览 (Shift+P)'
+            : prefabComparisonSupport.reason);
+        LocalEditorShared.applyButtonActiveState(prefabComparisonPreviewButton, inPrefabStage && prefabComparisonPreviewOpen);
         gridToggleButton.disabled = disabled || !gridState.available;
         setToolbarButtonTooltip(gridToggleButton, gridState.visible ? '隐藏 Scene View 网格' : '显示 Scene View 网格');
         LocalEditorShared.applyButtonActiveState(gridToggleButton, gridState.visible);
+        toolGroup.style.display = isPreviewToolVisible('select') ? 'flex' : 'none';
+        spaceGroup.style.display = isPreviewToolVisible('transform-space') ? 'flex' : 'none';
         for (const [tool, button] of toolButtons) {
-            button.disabled = disabled;
+            button.disabled = !isPreviewToolEnabled(tool);
             LocalEditorShared.applyButtonActiveState(button, transformTool?.activeTool === tool);
         }
         for (const [space, button] of Object.entries(spaceButtons)) {
-            button.disabled = disabled;
+            button.disabled = !isPreviewToolEnabled('transform-space');
             LocalEditorShared.applyButtonActiveState(button, transformTool?.activeSpace === space);
         }
         sceneHelpButton.disabled = disabled;
@@ -4401,38 +5731,38 @@ export function createLocalEditorBrowserUi(options = {}) {
             canDistribute: false,
         };
         const operationSettings = transformOperations.settings;
-        snapGroup.style.display = inEditor ? 'flex' : 'none';
-        snapButton.disabled = disabled;
-        snapEnabledInput.disabled = disabled;
+        snapGroup.style.display = isPreviewToolVisible('snap') ? 'flex' : 'none';
+        snapButton.disabled = !isPreviewToolEnabled('snap');
+        snapEnabledInput.disabled = !isPreviewToolEnabled('snap');
         snapEnabledInput.checked = operationSettings.snap.enabled;
         LocalEditorShared.applyButtonActiveState(snapButton, operationSettings.snap.enabled || snapSettingsOpen);
         setToolbarButtonTooltip(snapButton, `吸附设置 · 位移 ${formatSnapStepInputValue(operationSettings.snap, 'move')} · 旋转 ${formatSnapStepInputValue(operationSettings.snap, 'rotate')}° · 缩放 ${formatSnapStepInputValue(operationSettings.snap, 'scale')}`);
         for (const [kind, input] of snapStepInputs) {
-            input.disabled = disabled;
+            input.disabled = !isPreviewToolEnabled('snap');
             if (doc.activeElement !== input)
                 input.value = formatSnapStepInputValue(operationSettings.snap, kind);
         }
         if (!inEditor || disabled || snapGroup.style.display === 'none')
             closeSnapSettingsPopover();
-        placementGroup.style.display = inEditor ? 'flex' : 'none';
-        placementButton.disabled = disabled;
+        placementGroup.style.display = isPreviewToolVisible('placement') ? 'flex' : 'none';
+        placementButton.disabled = !isPreviewToolEnabled('placement');
         setToolbarButtonIcon(doc, placementButton, PLACEMENT_MODE_ICONS[operationSettings.placementMode]);
         setToolbarButtonTooltip(placementButton, `放置模式 · ${PLACEMENT_MODE_DESCRIPTIONS[operationSettings.placementMode]}`);
         LocalEditorShared.applyButtonActiveState(placementButton, operationSettings.placementMode !== 'off' || placementSettingsOpen);
         for (const [mode, button] of Object.entries(placementButtons)) {
-            button.disabled = disabled;
+            button.disabled = !isPreviewToolEnabled('placement');
             LocalEditorShared.applyButtonActiveState(button, operationSettings.placementMode === mode);
         }
         if (!inEditor || disabled || placementGroup.style.display === 'none')
             closePlacementSettingsPopover();
-        actionGroup.style.display = inEditor ? 'flex' : 'none';
+        actionGroup.style.display = isPreviewToolVisible('transform-actions') ? 'flex' : 'none';
         const hasTransformAction = transformOperations.canAlign || transformOperations.canDistribute;
-        transformActionButton.disabled = disabled || !hasTransformAction;
+        transformActionButton.disabled = !isPreviewToolEnabled('transform-actions') || !hasTransformAction;
         setToolbarButtonTooltip(transformActionButton, hasTransformAction ? '对齐与分布' : '选择至少 2 个对象后可用');
         LocalEditorShared.applyButtonActiveState(transformActionButton, transformActionOpen);
         for (const [action, button] of transformActionButtons) {
             const enabled = isTransformActionEnabled(action, transformOperations);
-            button.disabled = disabled || !enabled;
+            button.disabled = !isPreviewToolEnabled('transform-actions') || !enabled;
             button.style.opacity = button.disabled ? '0.45' : '1';
             button.style.cursor = button.disabled ? 'not-allowed' : 'pointer';
         }
@@ -4449,9 +5779,49 @@ export function createLocalEditorBrowserUi(options = {}) {
         scheduleToolbarOverflowLayout();
         if (!inEditor)
             return;
+        const activeRightTab = panelRegistry.getRightDockTab();
+        if (inPrefabStage && prefabStage) {
+            const rightDockVisibility = resolveLocalEditorRightDockVisibility({
+                inPrefabStage: true,
+                activeRightTab,
+            });
+            const activeBottomTab = panelRegistry.getBottomDockTab();
+            const assetBrowserTabChanged = assetBrowserTab !== lastRenderedAssetBrowserTab;
+            const bottomDockTabChanged = activeBottomTab !== lastRenderedBottomDockTab;
+            const selectedAssetChanged = state.selectedAssetId !== lastRenderedSelectedAssetId;
+            const assetBrowserScrollSnapshot = activeBottomTab === 'assets'
+                ? assetBrowserViewportReveal.captureScrollSnapshot()
+                : { scrollTop: null };
+            leftDockTabs.style.display = 'none';
+            rightDockTabs.style.display = rightDockVisibility.tabsDisplay;
+            inspectorPanel.style.display = rightDockVisibility.inspectorDisplay;
+            renderingPanel.style.display = rightDockVisibility.renderingDisplay;
+            hierarchyController.render(state);
+            renderPrefabStagePropertiesPanel(prefabStage);
+            LocalEditorPanels.renderWorkbenchBottomDockPanel(doc, assetPanel, state, activeBottomTab, panelRegistry.getPanels('bottom'), assetBrowserTab);
+            if (activeBottomTab === 'assets' && !assetBrowserTabChanged && !bottomDockTabChanged) {
+                assetBrowserViewportReveal.restoreScrollSnapshot(assetBrowserScrollSnapshot);
+            }
+            const suppressAssetScroll = state.selectedAssetId
+                ? assetBrowserViewportReveal.consumeRevealSuppression(state.selectedAssetId, { clearWhenDifferent: selectedAssetChanged })
+                : false;
+            if (activeBottomTab === 'assets' && selectedAssetChanged && state.selectedAssetId && !suppressAssetScroll) {
+                revealSelectedAssetBrowserItem(state.selectedAssetId);
+            }
+            lastRenderedAssetBrowserTab = assetBrowserTab;
+            lastRenderedBottomDockTab = activeBottomTab;
+            lastRenderedSelectedAssetId = state.selectedAssetId ?? null;
+            restoreLocalEditorEditableFocus(doc, focusSnapshot);
+            return;
+        }
+        leftDockTabs.style.display = '';
         const hierarchyDescriptor = panelRegistry.getActivePanel('left');
         const rightDescriptor = panelRegistry.getActivePanel('right');
-        const activeRightTab = panelRegistry.getRightDockTab();
+        const rightDockVisibility = resolveLocalEditorRightDockVisibility({
+            inPrefabStage: false,
+            activeRightTab,
+        });
+        rightDockTabs.style.display = rightDockVisibility.tabsDisplay;
         const activeBottomTab = panelRegistry.getBottomDockTab();
         const assetBrowserTabChanged = assetBrowserTab !== lastRenderedAssetBrowserTab;
         const bottomDockTabChanged = activeBottomTab !== lastRenderedBottomDockTab;
@@ -4462,8 +5832,10 @@ export function createLocalEditorBrowserUi(options = {}) {
         hierarchyPanel.dataset.editorPanelId = hierarchyDescriptor?.id ?? 'hierarchy';
         inspectorPanel.dataset.editorPanelId = activeRightTab === 'inspector' ? rightDescriptor?.id ?? 'inspector' : 'inspector';
         renderingPanel.dataset.editorPanelId = activeRightTab === 'rendering' ? rightDescriptor?.id ?? 'rendering' : 'rendering';
-        inspectorPanel.style.display = activeRightTab === 'inspector' ? '' : 'none';
-        renderingPanel.style.display = activeRightTab === 'rendering' ? '' : 'none';
+        markersPanel.dataset.editorPanelId = activeRightTab === 'markers' ? rightDescriptor?.id ?? 'markers' : 'markers';
+        inspectorPanel.style.display = rightDockVisibility.inspectorDisplay;
+        renderingPanel.style.display = rightDockVisibility.renderingDisplay;
+        markersPanel.style.display = activeRightTab === 'markers' ? '' : 'none';
         LocalEditorPanels.renderWorkbenchLeftDockTabs(doc, leftDockTabs, 'hierarchy', panelRegistry.getPanels('left'));
         hierarchyController.render(state);
         LocalEditorPanels.renderWorkbenchBottomDockPanel(doc, assetPanel, state, activeBottomTab, panelRegistry.getPanels('bottom'), assetBrowserTab);
@@ -4486,11 +5858,14 @@ export function createLocalEditorBrowserUi(options = {}) {
                 lockedVectorGroups: lockedInspectorVectorGroups,
             });
         }
-        else {
+        else if (activeRightTab === 'rendering') {
             LocalEditorPanels.renderRenderingPanel(doc, renderingPanel, state);
         }
+        else {
+            LocalEditorPanels.renderMarkerPanel(doc, markersPanel, state);
+        }
         restoreLocalEditorEditableFocus(doc, focusSnapshot);
-        restoreLocalEditorRightDockScrollSnapshot(rightDockScrollSnapshot, state, activeRightTab, inspectorFilter, inspectorPanel, renderingPanel);
+        restoreLocalEditorRightDockScrollSnapshot(rightDockScrollSnapshot, state, activeRightTab, inspectorFilter, inspectorPanel, renderingPanel, markersPanel);
     };
     return {
         update(state) {
@@ -4500,12 +5875,15 @@ export function createLocalEditorBrowserUi(options = {}) {
         updateSceneFrameStats(stats) {
             if (currentState)
                 currentState = { ...currentState, sceneFrameStats: stats };
-            renderSceneFrameRateOverlay(sceneFrameRateOverlay, currentState?.mode === 'editor' ? stats : null);
+            renderSceneFrameRateOverlay(sceneFrameRateOverlay, currentState?.mode === 'editor' && !currentState.prefabStage ? stats : null);
         },
         updatePerformanceStats(stats) {
             if (currentState)
                 currentState = { ...currentState, performanceStats: stats };
-            renderPerformanceMonitorOverlay(performanceMonitorOverlay, currentState?.mode === 'editor' ? stats : null, currentState?.mode === 'editor' && performanceMonitorOpen);
+            renderPerformanceMonitorOverlay(performanceMonitorOverlay, currentState?.mode === 'editor' && !currentState.prefabStage ? stats : null, currentState?.mode === 'editor' && !currentState.prefabStage && performanceMonitorOpen);
+        },
+        getPrefabComparisonPreviewSurfaces() {
+            return readPrefabComparisonPreviewSurfaces(prefabComparisonPreviewOverlay);
         },
         setTheme(theme) {
             setActiveTheme(theme);
@@ -4535,6 +5913,7 @@ export function createLocalEditorBrowserUi(options = {}) {
             measurementOverlay.root.remove();
             sceneFrameRateOverlay.root.remove();
             performanceMonitorOverlay.root.remove();
+            prefabStagePreviewLayout.root.remove();
             boxSelectionOverlay.remove();
             shortcutHelpPanel.remove();
             assetPreviewModal.remove();