@fps-games/editor 0.2.1-beta.1 → 0.2.1-beta.2

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

@@ -8,15 +8,22 @@ import { createLocalEditorViewportRevealController } from './local-editor-ui-doc
 import { createLocalEditorModalDialog } from './local-editor-ui-modal-dialog.js';
 import { parseLocalEditorBrowserInspectorGroupValueClipboardPayload, } from './local-editor-inspector-clipboard.js';
 import { writeLocalEditorClipboardText } from './local-editor-clipboard.js';
+import { captureLocalEditorAssetBrowserReturnFocus, createLocalEditorAssetBrowserContinuityController, resolveLocalEditorAssetBrowserContentKey, restoreLocalEditorAssetBrowserReturnFocus, } from './local-editor-asset-browser-continuity.js';
+import { canSkipLocalEditorPreviewCleanupPass, createLocalEditorPreviewCleanupRegistry, } from './local-editor-preview-cleanup-registry.js';
 import { LOCAL_EDITOR_BROWSER_INSPECTOR_VEC3_AXES, resolveLocalEditorBrowserInspectorProportionalScaleValues, resolveLocalEditorBrowserInspectorVectorGroupAxisFromPropertyPath, resolveLocalEditorBrowserInspectorVectorGroupPathFromPropertyPath, } from './local-editor-inspector-groups.js';
 import { DEFAULT_EDITOR_TRANSFORM_OPERATION_SETTINGS, } from '@fps-games/editor-core';
 import { createEditorUiLayerHost } from '@fps-games/editor-ui';
+import { isEditorProjectFilePreviewable, isEditorProjectMediaPreviewable, } from '@fps-games/editor-playable-sdk';
+import { findLocalEditorProjectFileSearchMatches, toLocalEditorProjectRelativePath, } from './local-editor-project-file-preview.js';
+import { resolveLocalEditorProjectFileOpenAction } from './local-editor-project-file-open.js';
 export { createLocalEditorViewportRevealController, isLocalEditorElementVisibleInViewport, resolveLocalEditorViewportRevealScrollTop, revealLocalEditorElementInViewport, } from './local-editor-ui-dock-panel.js';
 export { canUseHierarchyProviderReparent, createHierarchyEnabledOperationRequest, createLocalEditorHierarchyController, createHierarchyOperationMenuItems, createHierarchyToolbarCreateMenuItems, matchesHierarchyOperationShortcut, } from './local-editor-ui-hierarchy-controller.js';
 export { createLocalEditorHierarchyViewAdapter, } from './local-editor-ui-hierarchy-view-adapter.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';
+import { createLocalEditorConsoleController } from './local-editor-ui-console.js';
+import { synchronizeLocalEditorToolButtons } from './local-editor-tool-presentation.js';
 import { createLocalEditorPanelRegistry } from './local-editor-ui-panel-registry.js';
 import { createLocalEditorFormalSurfaceVisibilityController, disposeLocalEditorFormalSurfaces, shouldRenderLocalEditorInspectorPreview, } from './local-editor-ui-formal-surface-visibility.js';
 import * as LocalEditorShared from './local-editor-ui-shared.js';
@@ -28,13 +35,22 @@ import { createLocalEditorIcon, isLocalEditorIconName } from './local-editor-ui-
 import { createLocalEditorStatusCenterViewModel, resolveLocalEditorStatusDiagnosticLocatePlan, settleLocalEditorStatusDiagnosticRequest, resolveLocalEditorStatusDiagnostics, shouldCloseLocalEditorStatusCenter, } from './local-editor-ui-status-diagnostics.js';
 import { formatLocalEditorStatusDiagnosticDetails } from './local-editor-ui-status-format.js';
 import { resolveLocalEditorBrowserAssetKind, } from './local-editor-ui-asset-kind.js';
+import { createLocalEditorAssetFilesystemSnapshot, resolveLocalEditorAssetFilesystemFolderPath, } from './local-editor-asset-filesystem.js';
+import { createLocalEditorProjectModelThumbnailCache, } from './local-editor-project-media-thumbnail-cache.js';
 import { createLocalEditorPrefabStageTitle, findLocalEditorPrefabStageStructureItem, resolveLocalEditorRightDockVisibility, resolveLocalEditorPrefabStageWorkbenchLayout, resolveLocalEditorPreviewToolSupport, shouldLocalEditorClosePerformanceMonitor, } from './local-editor-ui-prefab-stage.js';
+import { resolveLocalEditorCoordinateAxisActiveDirection, resolveLocalEditorCoordinateAxisDirection, } from './local-editor-viewport-orientation.js';
 export { applyLocalEditorBrowserInspectorControlBinding, createLocalEditorBrowserInspectorControlRegistry, formatLocalEditorBrowserInspectorNumberValue, formatLocalEditorBrowserInspectorValue, parseLocalEditorBrowserInspectorNumberValue, resolveLocalEditorBrowserInspectorSectionStatus, resolveLocalEditorBrowserInspectorControlRegistration, shouldShowPrefabModelAddAction, } 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';
+export { findLocalEditorProjectFileSearchMatches, toLocalEditorProjectRelativePath, } from './local-editor-project-file-preview.js';
 export { DEFAULT_LOCAL_EDITOR_THEME, LOCAL_EDITOR_THEME_CLASS, applyLocalEditorTheme, normalizeLocalEditorThemeName, } from './local-editor-ui-theme.js';
 export { LOCAL_EDITOR_ICON_NAMES, createLocalEditorIcon, isLocalEditorIconName, resolveLocalEditorIconName, } from './local-editor-ui-icons.js';
 const PENDING_NUMERIC_PROPERTY_INPUT = Symbol('pending-numeric-property-input');
+function syncLocalEditorInspectorPendingState(panel, pending) {
+    panel.dataset.editorInspectorPending = String(pending);
+    panel.setAttribute('aria-busy', String(pending));
+    panel.toggleAttribute('inert', pending);
+}
 function readInspectorInputValue(input, source) {
     const control = input.dataset.serializedControl;
     const valueType = input.dataset.serializedValueType;
@@ -105,28 +121,6 @@ const PLACEMENT_MODE_DESCRIPTIONS = {
     ground: '放置到 XZ 地面',
     surface: '放置到场景表面',
 };
-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: '包围盒',
     dimensions: '尺寸摘要',
@@ -137,6 +131,17 @@ const VIEWPORT_PROJECTION_LABELS = {
     perspective: '透视',
     orthographic: '正交',
 };
+const VIEWPORT_VIEW_LABELS = {
+    perspective: '透视',
+    top: '顶视图',
+    bottom: '底视图',
+    front: '前视图',
+    back: '后视图',
+    left: '左视图',
+    right: '右视图',
+    iso: '等距正交',
+    threeQuarterTop: '斜 45° 俯视',
+};
 const STATIC_SHADOW_BAKE_ACTION_ID = 'bake-static-shadows';
 const TRANSFORM_ACTION_GROUPS = [
     {
@@ -1223,96 +1228,6 @@ const PREFAB_IMPORT_STATS_METRICS = [
         format: stats => formatPerformanceInteger(stats?.animationCount ?? null),
     },
 ];
-function createSceneFrameRateOverlay(doc) {
-    const root = doc.createElement('div');
-    root.classList.add(LOCAL_EDITOR_THEME_CLASS, 'fps-editor-ui-overlay-card');
-    root.dataset.editorSceneFrameRateOverlay = 'true';
-    root.style.cssText = [
-        'position:absolute',
-        'right:14px',
-        'bottom:134px',
-        'z-index:3',
-        'display:none',
-        'align-items:center',
-        'gap:6px',
-        'width:112px',
-        'height:30px',
-        'padding:0 8px',
-        'box-sizing:border-box',
-        '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) 76%, transparent)',
-        'box-shadow:var(--fps-editor-shadow-panel)',
-        'font-family:var(--fps-editor-font)',
-        'font-size:11px',
-        'font-weight:900',
-        'letter-spacing:0',
-        'color:var(--fps-editor-text-strong)',
-        'pointer-events:none',
-        'backdrop-filter:blur(5px)',
-        'overflow:hidden',
-    ].join(';');
-    const label = doc.createElement('span');
-    label.textContent = 'FPS';
-    label.style.cssText = [
-        'color:var(--fps-editor-muted-strong)',
-        'font-size:10px',
-        'line-height:1',
-    ].join(';');
-    const fpsValue = doc.createElement('span');
-    fpsValue.textContent = '--';
-    fpsValue.style.cssText = [
-        'width:26px',
-        'flex:0 0 26px',
-        'font-variant-numeric:tabular-nums',
-        'font-size:13px',
-        'line-height:1',
-    ].join(';');
-    const modeLabel = doc.createElement('span');
-    modeLabel.textContent = 'IDLE';
-    modeLabel.style.cssText = [
-        'margin-left:auto',
-        'padding:2px 4px',
-        'flex:0 0 auto',
-        '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',
-    ].join(';');
-    root.appendChild(label);
-    root.appendChild(fpsValue);
-    root.appendChild(modeLabel);
-    return { root, fpsValue, modeLabel };
-}
-function renderSceneFrameRateOverlay(overlay, stats) {
-    if (!stats) {
-        overlay.root.style.display = 'none';
-        return;
-    }
-    overlay.root.style.display = 'flex';
-    const fps = Number.isFinite(stats.fps) ? Math.round(stats.fps) : null;
-    const displayFps = stats.mode === 'idle' ? 0 : fps;
-    overlay.fpsValue.textContent = displayFps == null ? '--' : String(displayFps);
-    overlay.modeLabel.textContent = stats.mode === 'continuous' ? 'LIVE' : 'IDLE';
-    overlay.modeLabel.style.color = stats.mode === 'continuous'
-        ? 'var(--fps-editor-success)'
-        : 'var(--fps-editor-muted)';
-    overlay.fpsValue.style.color = displayFps == null || stats.mode === 'idle'
-        ? 'var(--fps-editor-muted)'
-        : displayFps >= 50
-            ? 'var(--fps-editor-success)'
-            : displayFps >= 30
-                ? 'var(--fps-editor-warn)'
-                : 'var(--fps-editor-danger-strong)';
-    overlay.root.title = [
-        `Scene FPS: ${displayFps == null ? '--' : displayFps}`,
-        `mode: ${stats.mode}`,
-        stats.lastFrameMs == null ? '' : `frame: ${stats.lastFrameMs.toFixed(1)}ms`,
-        stats.activeReasons.length ? `active: ${stats.activeReasons.join(', ')}` : '',
-    ].filter(Boolean).join(' | ');
-}
 function createPerformanceMonitorOverlay(doc) {
     const root = doc.createElement('section');
     root.classList.add(LOCAL_EDITOR_THEME_CLASS, 'fps-editor-ui-overlay-card');
@@ -1612,154 +1527,211 @@ function isFinitePerformanceNumber(value) {
 }
 function createCoordinateAxesOverlay(doc) {
     const root = doc.createElement('div');
+    root.classList.add(LOCAL_EDITOR_THEME_CLASS);
     root.dataset.editorCoordinateAxesOverlay = 'true';
     root.style.cssText = [
         'position:absolute',
         'right:14px',
         'bottom:14px',
-        'width:112px',
-        'height:112px',
+        'width:124px',
+        'height:124px',
         'display:none',
         'z-index:2',
         'box-sizing:border-box',
-        'border:1px solid color-mix(in srgb, var(--fps-editor-border) 78%, transparent)',
-        'border-radius:8px',
-        'background:color-mix(in srgb, var(--fps-editor-chrome) 58%, transparent)',
-        'box-shadow:var(--fps-editor-shadow-panel)',
+        'background:transparent',
         'pointer-events:none',
-        'overflow:hidden',
+        'overflow:visible',
     ].join(';');
     const svg = doc.createElementNS('http://www.w3.org/2000/svg', 'svg');
-    svg.setAttribute('viewBox', '0 0 112 112');
-    svg.setAttribute('aria-hidden', 'true');
+    svg.setAttribute('viewBox', '0 0 124 124');
+    svg.setAttribute('role', 'group');
+    svg.setAttribute('aria-label', '视口方向控制');
     svg.style.cssText = 'display:block;width:100%;height:100%';
     root.appendChild(svg);
     const lineLayer = doc.createElementNS('http://www.w3.org/2000/svg', 'g');
     const labelLayer = doc.createElementNS('http://www.w3.org/2000/svg', 'g');
     svg.appendChild(lineLayer);
     svg.appendChild(labelLayer);
-    const axisGroups = new Map();
+    const axisDirectionGroups = new Map();
+    const axisDirectionVisuals = new Map();
     const axisLines = new Map();
-    const axisLabels = new Map();
-    const axisDiscs = new Map();
     for (const axis of ['x', 'y', 'z']) {
-        const group = doc.createElementNS('http://www.w3.org/2000/svg', 'g');
         const line = doc.createElementNS('http://www.w3.org/2000/svg', 'line');
         line.setAttribute('stroke-width', '3.2');
         line.setAttribute('stroke-linecap', 'round');
-        line.setAttribute('x1', '56');
-        line.setAttribute('y1', '56');
-        const disc = doc.createElementNS('http://www.w3.org/2000/svg', 'circle');
-        disc.setAttribute('r', '7');
-        const label = doc.createElementNS('http://www.w3.org/2000/svg', 'text');
-        label.setAttribute('text-anchor', 'middle');
-        label.setAttribute('dominant-baseline', 'middle');
-        label.setAttribute('dy', '0.04em');
-        label.style.cssText = [
-            'fill:#172033',
-            'font-size:10px',
-            'font-weight:900',
-            'font-family:Arial, Helvetica, sans-serif',
-            'letter-spacing:0',
-        ].join(';');
-        group.appendChild(disc);
-        group.appendChild(label);
+        line.setAttribute('x1', '62');
+        line.setAttribute('y1', '62');
+        line.style.filter = 'drop-shadow(0 1px 1.5px rgba(0,0,0,0.88))';
         lineLayer.appendChild(line);
-        labelLayer.appendChild(group);
-        axisGroups.set(axis, group);
         axisLines.set(axis, line);
-        axisLabels.set(axis, label);
-        axisDiscs.set(axis, disc);
+        for (const sign of ['positive', 'negative']) {
+            const directionId = `${axis}-${sign}`;
+            const direction = resolveLocalEditorCoordinateAxisDirection(directionId);
+            const group = doc.createElementNS('http://www.w3.org/2000/svg', 'g');
+            group.setAttribute('role', 'button');
+            group.setAttribute('tabindex', '0');
+            group.dataset.coordinateAxisDirection = directionId;
+            group.dataset.viewportViewPreset = direction.preset;
+            group.style.cssText = 'pointer-events:auto;cursor:pointer;outline:none';
+            const title = doc.createElementNS('http://www.w3.org/2000/svg', 'title');
+            title.textContent = `${direction.label} · 点击切换正交视图`;
+            const hit = doc.createElementNS('http://www.w3.org/2000/svg', 'circle');
+            hit.setAttribute('r', '14');
+            hit.setAttribute('fill', 'transparent');
+            const visual = doc.createElementNS('http://www.w3.org/2000/svg', 'circle');
+            visual.setAttribute('r', sign === 'positive' ? '9' : '8.5');
+            visual.style.cssText = 'transition:filter 120ms ease,opacity 120ms ease;filter:drop-shadow(0 1px 2.5px rgba(0,0,0,0.78))';
+            group.append(title, hit, visual);
+            if (sign === 'positive') {
+                const label = doc.createElementNS('http://www.w3.org/2000/svg', 'text');
+                label.setAttribute('text-anchor', 'middle');
+                label.setAttribute('dominant-baseline', 'middle');
+                label.setAttribute('dy', '0.04em');
+                label.style.cssText = [
+                    'fill:#172033',
+                    'font-size:11px',
+                    'font-weight:900',
+                    'font-family:Arial, Helvetica, sans-serif',
+                    'letter-spacing:0',
+                    'pointer-events:none',
+                ].join(';');
+                label.textContent = axis.toUpperCase();
+                group.appendChild(label);
+            }
+            const emphasize = () => {
+                visual.style.filter = 'drop-shadow(0 0 4px rgba(255,255,255,0.78))';
+            };
+            const restore = () => {
+                visual.style.filter = 'drop-shadow(0 1px 2.5px rgba(0,0,0,0.78))';
+            };
+            group.addEventListener('pointerenter', emphasize);
+            group.addEventListener('pointerleave', restore);
+            group.addEventListener('focus', emphasize);
+            group.addEventListener('blur', restore);
+            labelLayer.appendChild(group);
+            axisDirectionGroups.set(directionId, group);
+            axisDirectionVisuals.set(directionId, visual);
+        }
     }
     const centerDot = doc.createElementNS('http://www.w3.org/2000/svg', 'circle');
-    centerDot.setAttribute('cx', '56');
-    centerDot.setAttribute('cy', '56');
+    centerDot.setAttribute('cx', '62');
+    centerDot.setAttribute('cy', '62');
     centerDot.setAttribute('r', '3.2');
-    centerDot.setAttribute('fill', 'color-mix(in srgb, var(--fps-editor-text) 82%, transparent)');
+    centerDot.setAttribute('fill', '#f4f7fb');
+    centerDot.setAttribute('stroke', 'rgba(16,20,26,0.82)');
+    centerDot.setAttribute('stroke-width', '1.5');
     labelLayer.appendChild(centerDot);
-    const projectionIcon = doc.createElementNS('http://www.w3.org/2000/svg', 'g');
-    projectionIcon.setAttribute('transform', 'translate(8 8)');
-    projectionIcon.setAttribute('role', 'button');
-    projectionIcon.setAttribute('tabindex', '0');
-    projectionIcon.dataset.coordinateAxesProjectionToggle = 'true';
-    projectionIcon.style.cssText = 'opacity:0.92;pointer-events:auto;cursor:pointer;outline:none';
-    const projectionIconFrame = doc.createElementNS('http://www.w3.org/2000/svg', 'rect');
-    projectionIconFrame.setAttribute('x', '0');
-    projectionIconFrame.setAttribute('y', '0');
-    projectionIconFrame.setAttribute('width', '18');
-    projectionIconFrame.setAttribute('height', '18');
-    projectionIconFrame.setAttribute('rx', '4');
-    projectionIconFrame.setAttribute('fill', 'color-mix(in srgb, var(--fps-editor-chrome) 78%, transparent)');
-    projectionIconFrame.setAttribute('stroke', 'color-mix(in srgb, var(--fps-editor-border) 82%, transparent)');
-    projectionIconFrame.setAttribute('stroke-width', '1');
-    const projectionIconShape = doc.createElementNS('http://www.w3.org/2000/svg', 'path');
-    projectionIconShape.setAttribute('fill', 'none');
-    projectionIconShape.setAttribute('stroke', 'color-mix(in srgb, var(--fps-editor-accent) 82%, #ffffff)');
-    projectionIconShape.setAttribute('stroke-width', '1.6');
-    projectionIconShape.setAttribute('stroke-linejoin', 'round');
-    projectionIconShape.setAttribute('stroke-linecap', 'round');
-    projectionIcon.appendChild(projectionIconFrame);
-    projectionIcon.appendChild(projectionIconShape);
-    svg.appendChild(projectionIcon);
+    const floatingButtonStyle = [
+        'position:absolute',
+        'top:4px',
+        'width:26px',
+        'height:26px',
+        'min-width:26px',
+        'padding:0',
+        'border-color:color-mix(in srgb, var(--fps-editor-border) 72%, transparent)',
+        'background:color-mix(in srgb, var(--fps-editor-chrome) 72%, transparent)',
+        'box-shadow:0 2px 6px rgba(0,0,0,0.34)',
+        'backdrop-filter:blur(5px)',
+        'pointer-events:auto',
+    ].join(';');
+    const projectionButton = createToolbarIconButton(doc, '投影模式', 'projection-perspective', '投影模式：透视', 'toggle');
+    projectionButton.dataset.coordinateAxesProjectionToggle = 'true';
+    projectionButton.style.cssText = `${floatingButtonStyle};left:4px`;
+    root.appendChild(projectionButton);
+    const viewMenuButton = createToolbarIconButton(doc, '更多视角', 'chevron-down', '更多视角');
+    viewMenuButton.dataset.coordinateAxesViewMenu = 'true';
+    viewMenuButton.setAttribute('aria-haspopup', 'menu');
+    viewMenuButton.style.cssText = `${floatingButtonStyle};right:4px`;
+    root.appendChild(viewMenuButton);
     return {
         root,
         lineLayer,
         labelLayer,
-        axisGroups,
+        axisDirectionGroups,
+        axisDirectionVisuals,
         axisLines,
-        axisLabels,
-        axisDiscs,
         centerDot,
-        projectionIcon,
-        projectionIconShape,
+        projectionButton,
+        viewMenuButton,
     };
 }
-function renderCoordinateAxesOverlay(overlay, state) {
+function renderCoordinateAxesOverlay(overlay, state, viewPreset, busy) {
     if (!state?.axes?.length) {
         overlay.root.style.display = 'none';
         return;
     }
     overlay.root.style.display = '';
-    renderCoordinateAxesProjectionIcon(overlay, state.projectionMode, state.projectionToggleDisabled === true);
-    const center = 56;
-    const lineLength = 38;
+    const controlsDisabled = state.projectionToggleDisabled === true || busy;
+    renderCoordinateAxesProjectionButton(overlay, state.projectionMode, controlsDisabled);
+    overlay.viewMenuButton.disabled = controlsDisabled;
+    overlay.viewMenuButton.setAttribute('aria-disabled', controlsDisabled ? 'true' : 'false');
+    setToolbarButtonTooltip(overlay.viewMenuButton, controlsDisabled
+        ? `视角预设：${VIEWPORT_VIEW_LABELS[viewPreset]} · 当前不可切换`
+        : `视角预设：${VIEWPORT_VIEW_LABELS[viewPreset]}`);
+    const center = 62;
+    const lineLength = 40;
+    const activeDirectionId = resolveLocalEditorCoordinateAxisActiveDirection(viewPreset);
     const sortedAxes = [...state.axes].sort((left, right) => right.depth - left.depth);
     for (const axis of sortedAxes) {
-        const group = overlay.axisGroups.get(axis.id);
         const line = overlay.axisLines.get(axis.id);
-        const disc = overlay.axisDiscs.get(axis.id);
-        const label = overlay.axisLabels.get(axis.id);
-        if (!group || !line || !disc || !label)
+        if (!line)
             continue;
         const length = lineLength * axis.scale;
         const endX = center + axis.x * length;
         const endY = center + axis.y * length;
+        const oppositeX = center - axis.x * length;
+        const oppositeY = center - axis.y * length;
         line.setAttribute('x2', formatSvgNumber(endX));
         line.setAttribute('y2', formatSvgNumber(endY));
         line.setAttribute('stroke', axis.color);
-        disc.setAttribute('cx', formatSvgNumber(endX));
-        disc.setAttribute('cy', formatSvgNumber(endY));
-        disc.setAttribute('fill', axis.color);
-        label.setAttribute('x', formatSvgNumber(endX));
-        label.setAttribute('y', formatSvgNumber(endY));
-        label.textContent = axis.label;
-        group.style.opacity = String(0.72 + axis.scale * 0.28);
+        const positiveId = `${axis.id}-positive`;
+        const negativeId = `${axis.id}-negative`;
+        const positiveDirection = resolveLocalEditorCoordinateAxisDirection(positiveId);
+        const negativeDirection = resolveLocalEditorCoordinateAxisDirection(negativeId);
+        const positiveGroup = overlay.axisDirectionGroups.get(positiveId);
+        const negativeGroup = overlay.axisDirectionGroups.get(negativeId);
+        const positiveVisual = overlay.axisDirectionVisuals.get(positiveId);
+        const negativeVisual = overlay.axisDirectionVisuals.get(negativeId);
+        if (!positiveGroup || !negativeGroup || !positiveVisual || !negativeVisual)
+            continue;
+        positiveGroup.setAttribute('transform', `translate(${formatSvgNumber(endX)} ${formatSvgNumber(endY)})`);
+        negativeGroup.setAttribute('transform', `translate(${formatSvgNumber(oppositeX)} ${formatSvgNumber(oppositeY)})`);
+        positiveGroup.setAttribute('aria-label', `${positiveDirection.label} · 点击切换正交视图`);
+        negativeGroup.setAttribute('aria-label', `${negativeDirection.label} · 点击切换正交视图`);
+        positiveGroup.setAttribute('aria-disabled', controlsDisabled ? 'true' : 'false');
+        negativeGroup.setAttribute('aria-disabled', controlsDisabled ? 'true' : 'false');
+        positiveGroup.style.cursor = controlsDisabled ? 'not-allowed' : 'pointer';
+        negativeGroup.style.cursor = controlsDisabled ? 'not-allowed' : 'pointer';
+        positiveGroup.style.opacity = String((controlsDisabled ? 0.42 : 0.72) + axis.scale * (controlsDisabled ? 0.12 : 0.28));
+        negativeGroup.style.opacity = controlsDisabled ? '0.3' : String(0.5 + axis.scale * 0.18);
+        const positiveActive = positiveId === activeDirectionId;
+        const negativeActive = negativeId === activeDirectionId;
+        positiveGroup.setAttribute('aria-pressed', String(positiveActive));
+        negativeGroup.setAttribute('aria-pressed', String(negativeActive));
+        positiveVisual.setAttribute('fill', axis.color);
+        positiveVisual.setAttribute('stroke', positiveActive ? '#ffffff' : 'color-mix(in srgb, var(--fps-editor-chrome) 72%, transparent)');
+        positiveVisual.setAttribute('stroke-width', positiveActive ? '2.4' : '1.2');
+        negativeVisual.setAttribute('fill', negativeActive ? `color-mix(in srgb, ${axis.color} 26%, transparent)` : 'color-mix(in srgb, var(--fps-editor-chrome) 62%, transparent)');
+        negativeVisual.setAttribute('stroke', axis.color);
+        negativeVisual.setAttribute('stroke-width', negativeActive ? '3.8' : '3');
         overlay.lineLayer.appendChild(line);
-        overlay.labelLayer.appendChild(group);
+        const farGroup = axis.depth >= 0 ? negativeGroup : positiveGroup;
+        const nearGroup = axis.depth >= 0 ? positiveGroup : negativeGroup;
+        overlay.labelLayer.appendChild(farGroup);
+        overlay.labelLayer.appendChild(nearGroup);
     }
     overlay.labelLayer.appendChild(overlay.centerDot);
 }
-function renderCoordinateAxesProjectionIcon(overlay, mode, disabled) {
-    overlay.projectionIcon.dataset.viewportProjectionMode = mode;
-    overlay.projectionIcon.setAttribute('aria-label', disabled
-        ? `编辑视口投影：${VIEWPORT_PROJECTION_LABELS[mode]}，Main Camera 预览中不可切换`
-        : `编辑视口投影：${VIEWPORT_PROJECTION_LABELS[mode]}，点击切换`);
-    overlay.projectionIcon.setAttribute('aria-disabled', disabled ? 'true' : 'false');
-    overlay.projectionIcon.style.opacity = disabled ? '0.46' : '0.92';
-    overlay.projectionIcon.style.cursor = disabled ? 'not-allowed' : 'pointer';
-    overlay.projectionIconShape.setAttribute('d', mode === 'orthographic'
-        ? 'M5 6.5H12.5V14H5ZM7.5 4H15V11.5'
-        : 'M4.5 14H13.5L10.5 4H7.5ZM7 10.5H11');
+function renderCoordinateAxesProjectionButton(overlay, mode, disabled) {
+    const nextMode = mode === 'orthographic' ? 'perspective' : 'orthographic';
+    overlay.projectionButton.dataset.viewportProjectionMode = mode;
+    overlay.projectionButton.disabled = disabled;
+    overlay.projectionButton.setAttribute('aria-pressed', mode === 'orthographic' ? 'true' : 'false');
+    setToolbarButtonIcon(overlay.projectionButton.ownerDocument, overlay.projectionButton, mode === 'orthographic' ? 'projection-ortho' : 'projection-perspective');
+    setToolbarButtonTooltip(overlay.projectionButton, disabled
+        ? `投影模式：${VIEWPORT_PROJECTION_LABELS[mode]} · 当前不可切换`
+        : `投影模式：${VIEWPORT_PROJECTION_LABELS[mode]} · 点击切换为${VIEWPORT_PROJECTION_LABELS[nextMode]}`);
+    LocalEditorShared.applyButtonActiveState(overlay.projectionButton, mode === 'orthographic');
 }
 function createSpatialOverlay(doc) {
     const root = doc.createElement('div');
@@ -1876,8 +1848,8 @@ function ensureSpatialOverlayLine(overlay, id) {
     if (existing)
         return existing;
     const line = overlay.root.ownerDocument.createElementNS('http://www.w3.org/2000/svg', 'line');
-    line.setAttribute('stroke', 'color-mix(in srgb, var(--fps-editor-drop-target) 82%, white)');
-    line.setAttribute('stroke-width', '1.4');
+    line.setAttribute('stroke', 'color-mix(in srgb, var(--fps-editor-text) 82%, white)');
+    line.setAttribute('stroke-width', '1.15');
     line.setAttribute('stroke-linecap', 'round');
     line.setAttribute('vector-effect', 'non-scaling-stroke');
     line.style.filter = 'drop-shadow(0 1px 2px rgba(0,0,0,0.45))';
@@ -2021,7 +1993,7 @@ function formatSvgNumber(value) {
     return Number.isFinite(value) ? value.toFixed(2) : '0';
 }
 function isLocalEditorAssetBrowserTab(value) {
-    return value === 'all' || value === 'models' || value === 'prefabs' || value === 'materials' || value === 'textures';
+    return value === 'all' || value === 'models' || value === 'prefabs' || value === 'materials' || value === 'textures' || value === 'audio';
 }
 export function createAssetBrowserMenuItems(state, asset) {
     const assetKind = resolveLocalEditorBrowserAssetKind(asset);
@@ -2031,6 +2003,12 @@ export function createAssetBrowserMenuItems(state, asset) {
     const items = [];
     if (assetKind === 'material') {
         const deleteDisabledReason = getMaterialAssetDeleteDisabledReason(asset);
+        if (asset.preview) {
+            items.push({
+                id: 'asset.preview',
+                label: '预览材质',
+            });
+        }
         items.push({
             id: 'asset.edit-material',
             label: '编辑材质球',
@@ -2226,6 +2204,13 @@ export function resolveAssetBrowserDoubleClickAction(state, asset) {
 function copyTextToClipboard(win, text, onResult) {
     void writeLocalEditorClipboardText(win, text).then(onResult ?? (() => undefined));
 }
+function formatProjectFileByteSize(size) {
+    if (size < 1024)
+        return `${size} B`;
+    if (size < 1024 * 1024)
+        return `${(size / 1024).toFixed(size < 10 * 1024 ? 1 : 0)} KiB`;
+    return `${(size / (1024 * 1024)).toFixed(1)} MiB`;
+}
 function copyEditorStatusText(button, win, text) {
     const idleLabel = button.getAttribute('aria-label') ?? '复制诊断';
     copyTextToClipboard(win, text, copied => {
@@ -2420,8 +2405,21 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
     let currentState = null;
     let pendingStatusDiagnosticRequest = null;
     let inspectorFilter = '';
+    let lastRenderedInspectorContentKey = null;
     const lockedInspectorVectorGroups = new Set();
     let assetBrowserTab = 'all';
+    let assetBrowserFolderPath = '/';
+    const assetBrowserExpandedFolderPaths = new Set(['/']);
+    let assetBrowserViewMode = 'grid';
+    let selectedProjectEntryPath = null;
+    const expandAssetBrowserFolderPath = (folderPath) => {
+        assetBrowserExpandedFolderPaths.add('/');
+        let currentPath = '';
+        for (const segment of folderPath.split('/').filter(Boolean)) {
+            currentPath = `${currentPath}/${segment}`;
+            assetBrowserExpandedFolderPaths.add(currentPath);
+        }
+    };
     const hierarchySurface = options.hierarchy?.surface;
     if (!hierarchySurface)
         throw new Error('Hierarchy surface is required by the Local Editor workbench.');
@@ -2501,8 +2499,42 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
     let editorStatusCenterOpen = false;
     let performanceMonitorOpen = false;
     let assetPreviewOpen = false;
+    let assetPreviewReturnFocus = null;
     let previewedAsset = null;
     let assetPreviewMode = 'preview';
+    let projectMediaPreviewSource = null;
+    let projectMediaPreviewRequestedPath = '';
+    let projectMediaPreviewError = '';
+    let projectMediaPreviewRequestId = 0;
+    let uiDisposed = false;
+    let projectModelPreviewCleanup = null;
+    let projectModelPreviewAbortController = null;
+    const projectModelPreviewCleanupRegistry = createLocalEditorPreviewCleanupRegistry({
+        onTerminalFailure(error) {
+            console.error('[fps-editor:model-preview] cleanup failed after bounded retries', error);
+        },
+    });
+    const projectMediaThumbnailCache = new Map();
+    const projectMediaThumbnailAbortControllers = new Set();
+    const projectModelThumbnailCache = createLocalEditorProjectModelThumbnailCache(doc.defaultView);
+    let projectMediaThumbnailGeneration = 0;
+    let projectMediaThumbnailObserver = null;
+    let materialPreviewRequestId = 0;
+    let materialPreviewCleanup = null;
+    const materialPreviewCleanupRegistry = createLocalEditorPreviewCleanupRegistry({
+        onTerminalFailure(error) {
+            console.error('[fps-editor:material-preview] cleanup failed after bounded retries', error);
+        },
+    });
+    let projectFilePreviewOpen = false;
+    let projectFilePreviewReturnFocus = null;
+    let projectFilePreviewRequestId = 0;
+    let projectFilePreviewContent = null;
+    let projectFilePreviewRequestedPath = '';
+    let projectFilePreviewError = '';
+    let projectFilePreviewMatches = [];
+    let projectFilePreviewActiveMatch = -1;
+    let projectFilePreviewSearchRaf = null;
     let assetPickerOpen = false;
     let assetPickerFilter = '';
     let assetPickerInput = null;
@@ -2593,6 +2625,7 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
     const rightDockFormalSurfaceVisibility = createLocalEditorFormalSurfaceVisibilityController({
         disposeHidden() {
             disposeRightDockFormalSurfaces();
+            lastRenderedInspectorContentKey = null;
         },
         rehydrateVisible() {
             disposeRightDockFormalSurfaces();
@@ -2605,6 +2638,7 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
                     layerHost: editorUiLayerHost,
                     lockedVectorGroups: lockedInspectorVectorGroups,
                 });
+                lastRenderedInspectorContentKey = resolveLocalEditorRightDockContentKey(currentState, 'inspector', inspectorFilter);
             }
             else if (activeRightTab === 'rendering') {
                 LocalEditorPanels.renderRenderingPanel(doc, renderingPanel, currentState, { layerHost: editorUiLayerHost });
@@ -2630,13 +2664,18 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         },
     });
     construction.addCleanup('workbench-layout-controller', () => workbenchLayoutController.dispose());
+    const editorConsole = createLocalEditorConsoleController(doc, workbench.consoleDock, {
+        isCollapsed: () => workbenchLayoutController.getLayout().consoleCollapsed,
+        onCollapsedChange: collapsed => workbenchLayoutController.setConsoleCollapsed(collapsed, true),
+    });
+    construction.addCleanup('editor-console', () => editorConsole.dispose());
     const findAssetBrowserScrollViewport = () => (assetPanel.querySelector('[data-editor-asset-browser-scroll-viewport]'));
     const assetBrowserViewportReveal = createLocalEditorViewportRevealController({
         getViewport: findAssetBrowserScrollViewport,
         margin: 4,
     });
-    let lastRenderedAssetBrowserTab;
-    let lastRenderedBottomDockTab;
+    const assetBrowserContinuity = createLocalEditorAssetBrowserContinuityController(() => assetPanel);
+    let lastRenderedAssetBrowserContentKey = null;
     let lastRenderedSelectedAssetId;
     const sceneToolOverlay = createSceneHeaderToolbar(doc);
     const sceneTitle = doc.createElement('div');
@@ -2677,37 +2716,17 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         'border-left:1px solid var(--fps-editor-divider)',
     ].join(';');
     const toolButtons = new Map();
-    const synchronizeToolButtons = (presentations) => {
-        const primaryTools = presentations.filter(tool => tool.kind === 'primary');
-        const nextIds = new Set(primaryTools.map(tool => tool.id));
-        for (const [toolId, button] of toolButtons) {
-            if (nextIds.has(toolId))
-                continue;
-            button.remove();
-            toolButtons.delete(toolId);
-        }
-        for (const tool of primaryTools) {
-            let button = toolButtons.get(tool.id);
-            const tooltip = tool.shortcut ? `${tool.label}工具 (${tool.shortcut})` : `${tool.label}工具`;
-            if (!button) {
-                button = LocalEditorShared.createButton(doc, tool.label, {
-                    icon: tool.icon && isLocalEditorIconName(tool.icon) ? tool.icon : 'object',
-                    labelMode: 'icon-only',
-                    variant: 'toolbar-icon',
-                    tooltip,
-                    ariaLabel: tooltip,
-                });
-                button.dataset.editorToolId = tool.id;
-                toolButtons.set(tool.id, button);
-            }
-            setToolbarButtonTooltip(button, tool.availability.state === 'enabled'
-                ? tooltip
-                : `${tooltip} · ${tool.availability.reason}`);
-            button.style.display = tool.availability.state === 'hidden' ? 'none' : 'inline-flex';
-            button.disabled = tool.availability.state !== 'enabled';
-            LocalEditorShared.applyButtonActiveState(button, tool.active);
-            toolGroup.appendChild(button);
-        }
+    const renderToolPresentationState = (state) => {
+        synchronizeLocalEditorToolButtons({
+            document: doc,
+            group: toolGroup,
+            buttons: toolButtons,
+            presentations: state.tools ?? [],
+        });
+        toolGroup.style.display = state.mode === 'editor'
+            && (state.tools ?? []).some(tool => tool.kind === 'primary' && tool.availability.state !== 'hidden')
+            ? 'flex'
+            : 'none';
     };
     const spaceGroup = doc.createElement('div');
     spaceGroup.className = 'fps-editor-ui-toolbar-group';
@@ -3065,16 +3084,6 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         'padding-left:8px',
         'border-left:1px solid var(--fps-editor-divider)',
     ].join(';');
-    const viewportPresetButtons = new Map();
-    for (const preset of ['perspective', 'top', 'front', 'right']) {
-        const button = createToolbarIconButton(doc, VIEW_PRESET_TOOLTIPS[preset], VIEW_PRESET_ICONS[preset], VIEW_PRESET_TOOLTIPS[preset]);
-        button.dataset.viewportViewPreset = preset;
-        viewportPresetButtons.set(preset, button);
-        viewportToolsGroup.appendChild(button);
-    }
-    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);
@@ -3155,7 +3164,6 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         'pointer-events:auto',
     ].join(';');
     const coordinateAxesOverlay = createCoordinateAxesOverlay(doc);
-    const sceneFrameRateOverlay = createSceneFrameRateOverlay(doc);
     const performanceMonitorOverlay = createPerformanceMonitorOverlay(doc);
     const prefabImportStatsOverlay = createPrefabImportStatsOverlay(doc);
     const prefabStagePreviewLayout = createPrefabStagePreviewLayout(doc);
@@ -3182,7 +3190,6 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
     workbench.sceneHeader.appendChild(sceneToolOverlay);
     workbench.sceneFrame.appendChild(spatialOverlay.root);
     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);
@@ -3299,6 +3306,112 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
     assetPreviewModal.appendChild(assetPreviewDialog);
     construction.appendRootChild(assetPreviewModal);
     tooltipSurfaces.add(assetPreviewModal);
+    const projectFilePreviewModal = doc.createElement('div');
+    projectFilePreviewModal.classList.add(LOCAL_EDITOR_THEME_CLASS, 'fps-editor-ui-modal-root');
+    projectFilePreviewModal.dataset.editorProjectFilePreviewModal = 'true';
+    projectFilePreviewModal.dataset.editorWorkbenchRegion = 'modal';
+    projectFilePreviewModal.style.cssText = [
+        'position:fixed',
+        'inset:0',
+        'z-index:2147483642',
+        'display:none',
+        'align-items:center',
+        'justify-content:center',
+        'padding:24px',
+        'background:rgba(0,0,0,0.5)',
+        'font-family:var(--fps-editor-font)',
+        'color:var(--fps-editor-text)',
+        'pointer-events:auto',
+    ].join(';');
+    const projectFilePreviewDialog = doc.createElement('div');
+    projectFilePreviewDialog.className = 'fps-editor-ui-modal';
+    projectFilePreviewDialog.setAttribute('role', 'dialog');
+    projectFilePreviewDialog.setAttribute('aria-modal', 'true');
+    projectFilePreviewDialog.setAttribute('aria-label', '只读文件预览');
+    projectFilePreviewDialog.style.cssText = [
+        'width:min(980px,calc(100vw - 48px))',
+        'height:min(720px,calc(100vh - 48px))',
+        'min-height:320px',
+        'display:grid',
+        'grid-template-rows:auto auto minmax(0,1fr) auto',
+        'gap:8px',
+        'padding:12px',
+        'border:1px solid var(--fps-editor-border)',
+        'border-radius:4px',
+        'background:var(--fps-editor-panel)',
+        'box-shadow:var(--fps-editor-shadow-modal)',
+        'overflow:hidden',
+    ].join(';');
+    const projectFilePreviewHeader = doc.createElement('div');
+    projectFilePreviewHeader.className = 'fps-editor-ui-modal-header';
+    projectFilePreviewHeader.style.cssText = 'display:flex;align-items:center;justify-content:space-between;gap:12px;min-width:0';
+    const projectFilePreviewHeading = doc.createElement('div');
+    projectFilePreviewHeading.style.cssText = 'display:flex;flex-direction:column;gap:2px;min-width:0';
+    const projectFilePreviewTitle = doc.createElement('h2');
+    projectFilePreviewTitle.className = 'fps-editor-ui-modal-title fps-editor-ui-ellipsis';
+    projectFilePreviewTitle.style.cssText = 'margin:0;font-size:13px;font-weight:800;color:var(--fps-editor-text-strong)';
+    const projectFilePreviewPath = doc.createElement('div');
+    projectFilePreviewPath.className = 'fps-editor-ui-ellipsis';
+    projectFilePreviewPath.style.cssText = 'font-size:11px;color:var(--fps-editor-muted)';
+    projectFilePreviewHeading.append(projectFilePreviewTitle, projectFilePreviewPath);
+    const projectFilePreviewCloseButton = createToolbarIconButton(doc, '关闭', 'close', '关闭文件预览');
+    projectFilePreviewCloseButton.dataset.editorProjectFilePreviewClose = 'true';
+    projectFilePreviewHeader.append(projectFilePreviewHeading, projectFilePreviewCloseButton);
+    const projectFilePreviewSearchBar = doc.createElement('div');
+    projectFilePreviewSearchBar.style.cssText = 'display:grid;grid-template-columns:minmax(160px,1fr) auto auto auto;align-items:center;gap:5px';
+    const projectFilePreviewSearchShell = doc.createElement('div');
+    projectFilePreviewSearchShell.className = 'fps-editor-ui-asset-search';
+    const projectFilePreviewSearchIcon = createLocalEditorIcon(doc, 'search', { size: 15 });
+    projectFilePreviewSearchIcon.classList.add('fps-editor-ui-asset-search-icon');
+    const projectFilePreviewSearch = doc.createElement('input');
+    projectFilePreviewSearch.className = 'fps-editor-ui-search';
+    projectFilePreviewSearch.type = 'search';
+    projectFilePreviewSearch.placeholder = '在文件中搜索';
+    projectFilePreviewSearch.dataset.editorProjectFileSearch = 'true';
+    projectFilePreviewSearch.style.paddingLeft = '28px';
+    projectFilePreviewSearchShell.append(projectFilePreviewSearchIcon, projectFilePreviewSearch);
+    const projectFilePreviewMatchCount = doc.createElement('span');
+    projectFilePreviewMatchCount.dataset.editorProjectFileMatchCount = 'true';
+    projectFilePreviewMatchCount.style.cssText = 'min-width:58px;text-align:center;font-size:11px;color:var(--fps-editor-muted-strong);font-variant-numeric:tabular-nums';
+    const projectFilePreviewPrevious = createToolbarIconButton(doc, '上一个匹配项', 'arrow-up', '上一个匹配项');
+    projectFilePreviewPrevious.dataset.editorProjectFileSearchPrevious = 'true';
+    const projectFilePreviewNext = createToolbarIconButton(doc, '下一个匹配项', 'chevron-down', '下一个匹配项');
+    projectFilePreviewNext.dataset.editorProjectFileSearchNext = 'true';
+    projectFilePreviewSearchBar.append(projectFilePreviewSearchShell, projectFilePreviewMatchCount, projectFilePreviewPrevious, projectFilePreviewNext);
+    const projectFilePreviewViewport = doc.createElement('div');
+    projectFilePreviewViewport.dataset.editorProjectFilePreviewViewport = 'true';
+    projectFilePreviewViewport.style.cssText = [
+        'min-width:0',
+        'min-height:0',
+        'overflow:auto',
+        'border:1px solid var(--fps-editor-divider)',
+        'border-radius:3px',
+        'background:var(--fps-editor-field)',
+    ].join(';');
+    const projectFilePreviewCode = doc.createElement('pre');
+    projectFilePreviewCode.dataset.editorProjectFilePreviewCode = 'true';
+    projectFilePreviewCode.setAttribute('aria-label', '只读文件内容');
+    projectFilePreviewCode.style.cssText = [
+        'min-width:max-content',
+        'min-height:100%',
+        'margin:0',
+        'padding:12px 14px',
+        'box-sizing:border-box',
+        'white-space:pre',
+        'font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace',
+        'font-size:12px',
+        'line-height:1.55',
+        'tab-size:2',
+        'color:var(--fps-editor-text)',
+    ].join(';');
+    projectFilePreviewViewport.appendChild(projectFilePreviewCode);
+    const projectFilePreviewMeta = doc.createElement('div');
+    projectFilePreviewMeta.dataset.editorProjectFilePreviewMeta = 'true';
+    projectFilePreviewMeta.style.cssText = 'min-height:16px;font-size:10px;color:var(--fps-editor-muted);overflow:hidden;text-overflow:ellipsis;white-space:nowrap';
+    projectFilePreviewDialog.append(projectFilePreviewHeader, projectFilePreviewSearchBar, projectFilePreviewViewport, projectFilePreviewMeta);
+    projectFilePreviewModal.appendChild(projectFilePreviewDialog);
+    construction.appendRootChild(projectFilePreviewModal);
+    tooltipSurfaces.add(projectFilePreviewModal);
     const assetPickerModal = doc.createElement('div');
     assetPickerModal.classList.add(LOCAL_EDITOR_THEME_CLASS, 'fps-editor-ui-modal-root', 'fps-editor-ui-asset-modal');
     assetPickerModal.dataset.editorAssetPickerModal = 'true';
@@ -3390,12 +3503,12 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         applyLocalEditorTheme(workbench.root, activeTheme);
         applyLocalEditorTheme(spatialOverlay.root, activeTheme);
         applyLocalEditorTheme(measurementOverlay.root, activeTheme);
-        applyLocalEditorTheme(sceneFrameRateOverlay.root, activeTheme);
         applyLocalEditorTheme(performanceMonitorOverlay.root, activeTheme);
         applyLocalEditorTheme(prefabStagePreviewLayout.root, activeTheme);
         applyLocalEditorTheme(prefabImportStatsOverlay.root, activeTheme);
         applyLocalEditorTheme(shortcutHelpPanel, activeTheme);
         applyLocalEditorTheme(assetPreviewModal, activeTheme);
+        applyLocalEditorTheme(projectFilePreviewModal, activeTheme);
         applyLocalEditorTheme(assetPickerModal, activeTheme);
         applyLocalEditorTheme(boxSelectionOverlay, activeTheme);
         applyLocalEditorTheme(localTestMenu, activeTheme);
@@ -3504,6 +3617,11 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
                 pendingStatusDiagnosticRequest = navigationRequest;
                 if (locator.assetId) {
                     assetBrowserTab = 'all';
+                    const asset = currentState?.assets.find(candidate => (candidate.id === locator.assetId || candidate.assetId === locator.assetId));
+                    if (asset && currentState) {
+                        assetBrowserFolderPath = resolveLocalEditorAssetFilesystemFolderPath(createLocalEditorAssetFilesystemSnapshot(currentState.assets, currentState.projectFiles), asset.id);
+                        expandAssetBrowserFolderPath(assetBrowserFolderPath);
+                    }
                     panelRegistry.setBottomDockTab('assets');
                     workbenchLayoutController.setBottomCollapsed(false);
                     callbacks.onAssetFilterChange?.('');
@@ -4151,18 +4269,24 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
     enterEditorButton.addEventListener('click', () => callbacks.onEnterEditor?.());
     saveButton.addEventListener('click', () => {
         closeLocalTestMenu();
-        if (localTestActionsEnabled)
+        if (localTestActionsEnabled) {
+            editorConsole.append({ severity: 'info', source: 'save', message: '请求保存场景' });
             callbacks.onSaveScene?.();
+        }
     });
     saveAndRunButton.addEventListener('click', () => {
         closeLocalTestMenu();
-        if (localTestActionsEnabled)
+        if (localTestActionsEnabled) {
+            editorConsole.append({ severity: 'info', source: 'run', message: '请求保存并运行' });
             callbacks.onSaveAndRunGame?.();
+        }
     });
     discardRunButton.addEventListener('click', () => {
         closeLocalTestMenu();
-        if (localTestActionsEnabled)
+        if (localTestActionsEnabled) {
+            editorConsole.append({ severity: 'warning', source: 'run', message: '请求放弃更改并运行' });
             callbacks.onDiscardAndRunGame?.();
+        }
     });
     undoButton.addEventListener('click', () => callbacks.onUndo?.());
     redoButton.addEventListener('click', () => callbacks.onRedo?.());
@@ -4197,31 +4321,99 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         const nextMode = currentMode === 'orthographic' ? 'perspective' : 'orthographic';
         callbacks.onViewportProjectionModeChange?.(nextMode);
         if (event.type === 'click')
-            coordinateAxesOverlay.projectionIcon.blur();
+            coordinateAxesOverlay.projectionButton.blur();
     };
-    coordinateAxesOverlay.projectionIcon.addEventListener('pointerdown', (event) => {
+    coordinateAxesOverlay.projectionButton.addEventListener('pointerdown', (event) => {
         event.preventDefault();
     });
-    coordinateAxesOverlay.projectionIcon.addEventListener('click', toggleCoordinateAxesProjection);
-    coordinateAxesOverlay.projectionIcon.addEventListener('keydown', (event) => {
+    coordinateAxesOverlay.projectionButton.addEventListener('click', toggleCoordinateAxesProjection);
+    coordinateAxesOverlay.projectionButton.addEventListener('keydown', (event) => {
         if (event.key !== 'Enter' && event.key !== ' ')
             return;
         toggleCoordinateAxesProjection(event);
     });
-    viewportToolsGroup.addEventListener('click', (event) => {
-        const target = event.target instanceof HTMLElement ? event.target : null;
-        const preset = target?.closest('[data-viewport-view-preset]')?.dataset.viewportViewPreset;
-        if (preset) {
-            callbacks.onViewportViewPresetChange?.(preset);
+    const activateCoordinateAxesViewPreset = (preset) => {
+        const axesState = currentState?.coordinateAxes ?? null;
+        if (!axesState || axesState.projectionToggleDisabled || currentState?.busy)
             return;
-        }
-        const projectionToggle = target?.closest('[data-viewport-projection-toggle]');
-        if (projectionToggle) {
-            const currentMode = currentState?.viewportTools?.projectionMode ?? 'perspective';
-            const nextMode = currentMode === 'orthographic' ? 'perspective' : 'orthographic';
-            callbacks.onViewportProjectionModeChange?.(nextMode);
+        callbacks.onViewportViewPresetChange?.(preset);
+    };
+    coordinateAxesOverlay.root.addEventListener('pointerdown', (event) => {
+        if (!(event.target instanceof Element))
             return;
-        }
+        if (!event.target.closest('[data-coordinate-axis-direction],[data-coordinate-axes-projection-toggle],[data-coordinate-axes-view-menu]'))
+            return;
+        event.preventDefault();
+        event.stopPropagation();
+    });
+    coordinateAxesOverlay.root.addEventListener('click', (event) => {
+        const target = event.target instanceof Element ? event.target : null;
+        const direction = target?.closest('[data-coordinate-axis-direction]');
+        const preset = direction?.dataset.viewportViewPreset;
+        if (!preset)
+            return;
+        event.preventDefault();
+        event.stopPropagation();
+        activateCoordinateAxesViewPreset(preset);
+    });
+    coordinateAxesOverlay.root.addEventListener('keydown', (event) => {
+        if (event.key !== 'Enter' && event.key !== ' ')
+            return;
+        const target = event.target instanceof Element ? event.target : null;
+        const direction = target?.closest('[data-coordinate-axis-direction]');
+        const preset = direction?.dataset.viewportViewPreset;
+        if (!preset)
+            return;
+        event.preventDefault();
+        event.stopPropagation();
+        activateCoordinateAxesViewPreset(preset);
+    });
+    coordinateAxesOverlay.viewMenuButton.addEventListener('click', (event) => {
+        event.preventDefault();
+        event.stopPropagation();
+        const axesState = currentState?.coordinateAxes ?? null;
+        if (!axesState || axesState.projectionToggleDisabled || currentState?.busy)
+            return;
+        const rect = coordinateAxesOverlay.viewMenuButton.getBoundingClientRect();
+        const activePreset = currentState?.viewportTools?.viewPreset ?? 'perspective';
+        const viewItem = (preset, label) => ({
+            id: `viewport-view:${preset}`,
+            label,
+            ...(preset === activePreset ? { shortcut: '当前' } : {}),
+        });
+        contextMenu.open({
+            x: rect.right,
+            y: rect.bottom + 4,
+            items: [
+                viewItem('perspective', '透视视图'),
+                viewItem('threeQuarterTop', '斜 45° 俯视'),
+                viewItem('iso', '等距正交'),
+                {
+                    id: 'viewport-view:fixed',
+                    label: '固定正交视图',
+                    separatorBefore: true,
+                    children: [
+                        viewItem('top', '顶视图 (+Y)'),
+                        viewItem('bottom', '底视图 (-Y)'),
+                        viewItem('front', '前视图 (-Z)'),
+                        viewItem('back', '后视图 (+Z)'),
+                        viewItem('left', '左视图 (-X)'),
+                        viewItem('right', '右视图 (+X)'),
+                    ],
+                },
+            ],
+            onAction(item) {
+                const presetId = item.id.startsWith('viewport-view:')
+                    ? item.id.slice('viewport-view:'.length)
+                    : null;
+                if (presetId && presetId !== 'fixed') {
+                    activateCoordinateAxesViewPreset(presetId);
+                }
+            },
+        });
+    });
+    viewportToolsGroup.addEventListener('click', (event) => {
+        const target = event.target instanceof HTMLElement ? event.target : null;
         const markerVisibilityToggle = target?.closest('[data-viewport-marker-visibility-toggle]');
         if (markerVisibilityToggle) {
             const markersVisible = currentState?.viewportTools?.markersVisible ?? true;
@@ -4271,10 +4463,15 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         if (notify)
             callbacks.onPerformanceMonitorOpenChange?.(performanceMonitorOpen);
     };
-    const openAssetPreviewModal = (asset) => {
+    const captureAssetBrowserReturnFocus = (trigger) => {
+        const active = doc.activeElement instanceof HTMLElement ? doc.activeElement : null;
+        return captureLocalEditorAssetBrowserReturnFocus(assetPanel, trigger ?? active);
+    };
+    const openAssetPreviewModal = (asset, trigger) => {
         if (!asset.preview)
             return;
         contextMenu.close();
+        assetPreviewReturnFocus = captureAssetBrowserReturnFocus(trigger);
         previewedAsset = asset;
         assetPreviewMode = 'preview';
         assetPreviewDialog.setAttribute('aria-label', '资产预览');
@@ -4283,10 +4480,11 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         syncInputModalOpen();
         assetPreviewCloseButton.focus({ preventScroll: true });
     };
-    const openAssetMaterialEditorModal = (asset) => {
+    const openAssetMaterialEditorModal = (asset, trigger) => {
         if (!asset.material)
             return;
         contextMenu.close();
+        assetPreviewReturnFocus = captureAssetBrowserReturnFocus(trigger);
         previewedAsset = asset;
         assetPreviewMode = 'material-editor';
         assetPreviewDialog.setAttribute('aria-label', '编辑材质球');
@@ -4295,8 +4493,9 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         syncInputModalOpen();
         assetPreviewCloseButton.focus({ preventScroll: true });
     };
-    const openAssetRenameModal = (asset) => {
+    const openAssetRenameModal = (asset, trigger) => {
         contextMenu.close();
+        assetPreviewReturnFocus = captureAssetBrowserReturnFocus(trigger);
         previewedAsset = asset;
         assetPreviewMode = 'rename';
         assetPreviewDialog.setAttribute('aria-label', '重命名资产');
@@ -4309,14 +4508,451 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             input?.select();
         }, 0);
     };
+    const disposeProjectModelPreview = () => {
+        projectModelPreviewAbortController?.abort();
+        projectModelPreviewAbortController = null;
+        const cleanup = projectModelPreviewCleanup;
+        projectModelPreviewCleanup = null;
+        projectModelPreviewCleanupRegistry.disposeOwned(cleanup);
+        const failures = projectModelPreviewCleanupRegistry.takeFailures();
+        if (failures.length > 0) {
+            const error = new Error('Project model preview cleanup failed after bounded retries.');
+            error.errors = failures;
+            throw error;
+        }
+    };
+    const resetProjectMediaThumbnailCache = () => {
+        projectMediaThumbnailGeneration += 1;
+        for (const controller of projectMediaThumbnailAbortControllers)
+            controller.abort();
+        projectMediaThumbnailAbortControllers.clear();
+        projectMediaThumbnailCache.clear();
+        projectMediaThumbnailObserver?.disconnect();
+        projectMediaThumbnailObserver = null;
+    };
+    const resolveProjectMediaThumbnail = (browserPath, cacheKey) => {
+        const requestGeneration = projectMediaThumbnailGeneration;
+        const relativePath = toLocalEditorProjectRelativePath(browserPath);
+        const memoryKey = cacheKey || relativePath;
+        const cached = projectMediaThumbnailCache.get(memoryKey);
+        if (cached)
+            return cached;
+        const pending = Promise.resolve(callbacks.onProjectMediaResolve?.(relativePath) ?? null)
+            .then(async (source) => {
+            if (!source)
+                return null;
+            if (source.kind === 'image') {
+                return { alt: source.name, kind: 'image', url: source.url };
+            }
+            if (source.kind !== 'model' || !callbacks.onProjectModelThumbnailResolve)
+                return null;
+            if (requestGeneration !== projectMediaThumbnailGeneration)
+                return null;
+            if (cacheKey) {
+                const cachedUrl = await projectModelThumbnailCache.get(cacheKey);
+                if (cachedUrl) {
+                    return { alt: `${source.name} 模型缩略图`, kind: 'model', url: cachedUrl };
+                }
+            }
+            const controller = new AbortController();
+            projectMediaThumbnailAbortControllers.add(controller);
+            let url;
+            try {
+                url = await callbacks.onProjectModelThumbnailResolve(source, controller.signal);
+            }
+            finally {
+                projectMediaThumbnailAbortControllers.delete(controller);
+            }
+            if (controller.signal.aborted || requestGeneration !== projectMediaThumbnailGeneration)
+                return null;
+            if (url && cacheKey)
+                void projectModelThumbnailCache.put(cacheKey, url);
+            return url ? { alt: `${source.name} 模型缩略图`, kind: 'model', url } : null;
+        })
+            .catch(() => null);
+        projectMediaThumbnailCache.set(memoryKey, pending);
+        return pending;
+    };
+    const hydrateProjectMediaThumbnails = () => {
+        if (!callbacks.onProjectMediaResolve)
+            return;
+        const generation = projectMediaThumbnailGeneration;
+        projectMediaThumbnailObserver?.disconnect();
+        projectMediaThumbnailObserver = null;
+        const hydrate = (frame) => {
+            const path = frame.dataset.editorProjectMediaThumbnailPath;
+            if (!path || frame.dataset.thumbnailRequested === 'true')
+                return;
+            const cacheKey = frame.dataset.editorProjectMediaThumbnailCacheKey;
+            frame.dataset.thumbnailRequested = 'true';
+            void resolveProjectMediaThumbnail(path, cacheKey).then((result) => {
+                if (!frame.isConnected || generation !== projectMediaThumbnailGeneration)
+                    return;
+                if (!result) {
+                    frame.dataset.thumbnailState = 'failed';
+                    return;
+                }
+                const image = doc.createElement('img');
+                image.alt = result.alt;
+                image.decoding = 'async';
+                image.draggable = false;
+                if (result.kind === 'image')
+                    image.loading = 'lazy';
+                image.addEventListener('load', () => {
+                    if (frame.isConnected)
+                        frame.dataset.thumbnailState = 'ready';
+                }, { once: true });
+                image.addEventListener('error', () => {
+                    image.remove();
+                    if (frame.isConnected)
+                        frame.dataset.thumbnailState = 'failed';
+                }, { once: true });
+                image.src = result.url;
+                frame.appendChild(image);
+            });
+        };
+        const frames = assetPanel.querySelectorAll('[data-editor-project-media-thumbnail-path]');
+        const Observer = doc.defaultView?.IntersectionObserver;
+        if (!Observer) {
+            for (const frame of frames)
+                hydrate(frame);
+            return;
+        }
+        const viewport = assetPanel.querySelector('[data-editor-asset-browser-scroll-viewport]');
+        projectMediaThumbnailObserver = new Observer((entries, observer) => {
+            for (const entry of entries) {
+                if (!entry.isIntersecting || !(entry.target instanceof HTMLElement))
+                    continue;
+                observer.unobserve(entry.target);
+                hydrate(entry.target);
+            }
+        }, { root: viewport, rootMargin: '120px 0px' });
+        for (const frame of frames)
+            projectMediaThumbnailObserver.observe(frame);
+    };
+    const disposeMaterialPreview = () => {
+        materialPreviewRequestId += 1;
+        const cleanup = materialPreviewCleanup;
+        materialPreviewCleanup = null;
+        materialPreviewCleanupRegistry.disposeOwned(cleanup);
+        const failures = materialPreviewCleanupRegistry.takeFailures();
+        if (failures.length > 0) {
+            const error = new Error('Material preview cleanup failed after bounded retries.');
+            error.errors = failures;
+            throw error;
+        }
+    };
+    const createMaterialPreviewStage = (asset) => {
+        const preview = asset.preview;
+        if (preview?.kind !== 'material-sphere' || !callbacks.onMaterialPreviewMount) {
+            return LocalEditorPanels.createAssetPreviewElement(doc, asset, 'modal');
+        }
+        disposeMaterialPreview();
+        const requestId = materialPreviewRequestId;
+        const stage = doc.createElement('div');
+        stage.dataset.editorMaterialPreviewStage = 'true';
+        stage.dataset.previewState = 'loading';
+        stage.style.cssText = [
+            'position:relative',
+            'width:100%',
+            'aspect-ratio:16 / 10',
+            'min-height:180px',
+            'overflow:hidden',
+            'border:1px solid var(--fps-editor-border)',
+            'border-radius:4px',
+            'background:var(--fps-editor-field)',
+            'box-sizing:border-box',
+        ].join(';');
+        const fallback = LocalEditorPanels.createAssetPreviewElement(doc, asset, 'modal');
+        fallback.dataset.editorMaterialPreviewFallback = 'true';
+        fallback.style.position = 'absolute';
+        fallback.style.left = '50%';
+        fallback.style.top = '50%';
+        fallback.style.transform = 'translate(-50%,-50%)';
+        fallback.style.border = '0';
+        fallback.style.background = 'transparent';
+        const canvas = doc.createElement('canvas');
+        canvas.dataset.editorMaterialPreviewCanvas = 'true';
+        canvas.setAttribute('aria-label', `${asset.label} 材质球三维预览`);
+        canvas.title = '材质球预览';
+        canvas.style.cssText = [
+            'position:absolute',
+            'inset:0',
+            'display:block',
+            'width:100%',
+            'height:100%',
+            'opacity:0',
+            'cursor:grab',
+            'touch-action:none',
+            'outline:none',
+        ].join(';');
+        stage.append(fallback, canvas);
+        const source = {
+            id: asset.material?.id ?? asset.assetId ?? asset.id,
+            name: asset.material?.name || asset.label,
+            materialKind: asset.material?.materialKind,
+            preview,
+        };
+        void Promise.resolve().then(() => callbacks.onMaterialPreviewMount(source, canvas)).then((cleanup) => {
+            if (!assetPreviewOpen || requestId !== materialPreviewRequestId || !stage.isConnected) {
+                materialPreviewCleanupRegistry.disposeOwned(cleanup);
+                return undefined;
+            }
+            materialPreviewCleanupRegistry.own(cleanup);
+            materialPreviewCleanup = cleanup;
+            stage.dataset.previewState = 'ready';
+            fallback.style.display = 'none';
+            canvas.style.opacity = '1';
+            return undefined;
+        }).catch(() => {
+            if (requestId !== materialPreviewRequestId || !stage.isConnected)
+                return;
+            stage.dataset.previewState = 'fallback';
+            canvas.style.display = 'none';
+            fallback.style.display = 'flex';
+        });
+        return stage;
+    };
+    const openProjectMediaPreview = async (browserPath, trigger) => {
+        const relativePath = toLocalEditorProjectRelativePath(browserPath);
+        if (!callbacks.onProjectMediaResolve || !isEditorProjectMediaPreviewable(relativePath))
+            return;
+        contextMenu.close();
+        closeProjectFilePreview();
+        disposeProjectModelPreview();
+        assetPreviewReturnFocus = captureAssetBrowserReturnFocus(trigger);
+        const requestId = ++projectMediaPreviewRequestId;
+        projectMediaPreviewSource = null;
+        projectMediaPreviewRequestedPath = relativePath;
+        projectMediaPreviewError = '';
+        previewedAsset = null;
+        assetPreviewMode = 'project-media';
+        assetPreviewDialog.setAttribute('aria-label', '媒体文件预览');
+        assetPreviewOpen = true;
+        renderAssetPreviewModal();
+        syncInputModalOpen();
+        try {
+            const source = await callbacks.onProjectMediaResolve(relativePath);
+            if (!assetPreviewOpen || assetPreviewMode !== 'project-media' || requestId !== projectMediaPreviewRequestId)
+                return;
+            if (!source)
+                throw new Error('project_file_media_unsupported');
+            projectMediaPreviewSource = source;
+            renderAssetPreviewModal();
+            if (source.kind === 'model') {
+                const canvas = assetPreviewBody.querySelector('[data-editor-project-model-preview]');
+                if (!canvas || !callbacks.onProjectModelPreviewMount)
+                    throw new Error('project_model_preview_unavailable');
+                const controller = new AbortController();
+                projectModelPreviewAbortController = controller;
+                const cleanup = await callbacks.onProjectModelPreviewMount(source, canvas, controller.signal);
+                if (uiDisposed
+                    || !assetPreviewDialog.isConnected
+                    || !assetPreviewOpen
+                    || assetPreviewMode !== 'project-media'
+                    || requestId !== projectMediaPreviewRequestId) {
+                    controller.abort();
+                    if (projectModelPreviewAbortController === controller)
+                        projectModelPreviewAbortController = null;
+                    projectModelPreviewCleanupRegistry.disposeOwned(cleanup);
+                    return;
+                }
+                projectModelPreviewCleanupRegistry.own(cleanup);
+                projectModelPreviewCleanup = cleanup;
+            }
+            assetPreviewCloseButton.focus({ preventScroll: true });
+        }
+        catch (error) {
+            if (uiDisposed
+                || !assetPreviewDialog.isConnected
+                || !assetPreviewOpen
+                || assetPreviewMode !== 'project-media'
+                || requestId !== projectMediaPreviewRequestId)
+                return;
+            disposeProjectModelPreview();
+            projectMediaPreviewError = error instanceof Error ? error.message : String(error);
+            renderAssetPreviewModal();
+            assetPreviewCloseButton.focus({ preventScroll: true });
+        }
+    };
     const closeAssetPreviewModal = () => {
         if (!assetPreviewOpen)
             return;
+        const returnFocus = assetPreviewReturnFocus;
+        assetPreviewReturnFocus = null;
+        projectMediaPreviewRequestId += 1;
+        disposeProjectModelPreview();
+        disposeMaterialPreview();
         assetPreviewOpen = false;
         previewedAsset = null;
+        projectMediaPreviewSource = null;
+        projectMediaPreviewRequestedPath = '';
+        projectMediaPreviewError = '';
         assetPreviewMode = 'preview';
         renderAssetPreviewModal();
         syncInputModalOpen();
+        restoreLocalEditorAssetBrowserReturnFocus(assetPanel, returnFocus);
+    };
+    const renderProjectFilePreview = () => {
+        if (projectFilePreviewSearchRaf != null) {
+            doc.defaultView?.cancelAnimationFrame(projectFilePreviewSearchRaf);
+            projectFilePreviewSearchRaf = null;
+        }
+        projectFilePreviewModal.style.display = projectFilePreviewOpen ? 'flex' : 'none';
+        if (!projectFilePreviewOpen)
+            return;
+        const content = projectFilePreviewContent;
+        const displayPath = content?.path ?? projectFilePreviewRequestedPath;
+        const displayPathSegments = displayPath.split('/');
+        projectFilePreviewTitle.textContent = content?.name
+            ?? displayPathSegments[displayPathSegments.length - 1]
+            ?? '文件预览';
+        projectFilePreviewPath.textContent = displayPath;
+        projectFilePreviewPath.title = displayPath;
+        projectFilePreviewSearch.disabled = !content;
+        projectFilePreviewPrevious.disabled = projectFilePreviewMatches.length === 0;
+        projectFilePreviewNext.disabled = projectFilePreviewMatches.length === 0;
+        projectFilePreviewMatchCount.textContent = projectFilePreviewMatches.length > 0
+            ? `${projectFilePreviewActiveMatch + 1} / ${projectFilePreviewMatches.length}`
+            : projectFilePreviewSearch.value.trim() ? '0 / 0' : '0';
+        projectFilePreviewMeta.textContent = projectFilePreviewError
+            ? projectFilePreviewError
+            : content
+                ? [
+                    content.language,
+                    formatProjectFileByteSize(content.size),
+                    content.truncated ? '文件内容已截断' : '',
+                    '只读',
+                ].filter(Boolean).join(' · ')
+                : '正在读取文件...';
+        while (projectFilePreviewCode.firstChild)
+            projectFilePreviewCode.removeChild(projectFilePreviewCode.firstChild);
+        if (projectFilePreviewError) {
+            projectFilePreviewCode.textContent = `无法查看文件：${projectFilePreviewError}`;
+            return;
+        }
+        if (!content) {
+            projectFilePreviewCode.textContent = '正在读取文件...';
+            return;
+        }
+        if (projectFilePreviewMatches.length === 0) {
+            projectFilePreviewCode.textContent = content.text;
+            return;
+        }
+        let cursor = 0;
+        for (const [index, match] of projectFilePreviewMatches.entries()) {
+            if (match.start > cursor) {
+                projectFilePreviewCode.appendChild(doc.createTextNode(content.text.slice(cursor, match.start)));
+            }
+            const mark = doc.createElement('mark');
+            mark.dataset.editorProjectFileSearchMatch = String(index);
+            mark.dataset.active = index === projectFilePreviewActiveMatch ? 'true' : 'false';
+            mark.textContent = content.text.slice(match.start, match.end);
+            mark.style.cssText = index === projectFilePreviewActiveMatch
+                ? 'background:var(--fps-editor-accent);color:var(--fps-editor-panel);outline:1px solid var(--fps-editor-accent-strong)'
+                : 'background:var(--fps-editor-warn-soft);color:var(--fps-editor-text-strong);outline:1px solid var(--fps-editor-warn-border)';
+            projectFilePreviewCode.appendChild(mark);
+            cursor = match.end;
+        }
+        if (cursor < content.text.length) {
+            projectFilePreviewCode.appendChild(doc.createTextNode(content.text.slice(cursor)));
+        }
+        const active = projectFilePreviewCode.querySelector('[data-editor-project-file-search-match][data-active="true"]');
+        projectFilePreviewSearchRaf = doc.defaultView?.requestAnimationFrame(() => {
+            projectFilePreviewSearchRaf = null;
+            if (projectFilePreviewOpen && active?.isConnected) {
+                active.scrollIntoView({ block: 'center', inline: 'nearest' });
+            }
+        }) ?? null;
+    };
+    const updateProjectFilePreviewSearch = (resetActive) => {
+        projectFilePreviewMatches = projectFilePreviewContent
+            ? findLocalEditorProjectFileSearchMatches(projectFilePreviewContent.text, projectFilePreviewSearch.value)
+            : [];
+        if (resetActive)
+            projectFilePreviewActiveMatch = projectFilePreviewMatches.length > 0 ? 0 : -1;
+        else if (projectFilePreviewMatches.length === 0)
+            projectFilePreviewActiveMatch = -1;
+        else
+            projectFilePreviewActiveMatch = Math.min(Math.max(0, projectFilePreviewActiveMatch), projectFilePreviewMatches.length - 1);
+        renderProjectFilePreview();
+    };
+    const moveProjectFilePreviewMatch = (delta) => {
+        if (projectFilePreviewMatches.length === 0)
+            return;
+        projectFilePreviewActiveMatch = (projectFilePreviewActiveMatch + delta + projectFilePreviewMatches.length) % projectFilePreviewMatches.length;
+        renderProjectFilePreview();
+    };
+    const closeProjectFilePreview = () => {
+        if (!projectFilePreviewOpen)
+            return;
+        if (projectFilePreviewSearchRaf != null) {
+            doc.defaultView?.cancelAnimationFrame(projectFilePreviewSearchRaf);
+            projectFilePreviewSearchRaf = null;
+        }
+        const returnFocus = projectFilePreviewReturnFocus;
+        projectFilePreviewReturnFocus = null;
+        projectFilePreviewRequestId += 1;
+        projectFilePreviewOpen = false;
+        projectFilePreviewContent = null;
+        projectFilePreviewRequestedPath = '';
+        projectFilePreviewError = '';
+        projectFilePreviewMatches = [];
+        projectFilePreviewActiveMatch = -1;
+        projectFilePreviewSearch.value = '';
+        renderProjectFilePreview();
+        syncInputModalOpen();
+        restoreLocalEditorAssetBrowserReturnFocus(assetPanel, returnFocus);
+    };
+    const openProjectFilePreview = async (browserPath, trigger) => {
+        const relativePath = toLocalEditorProjectRelativePath(browserPath);
+        if (!callbacks.onProjectFileRead || !isEditorProjectFilePreviewable(relativePath))
+            return;
+        contextMenu.close();
+        if (assetPreviewOpen)
+            closeAssetPreviewModal();
+        projectFilePreviewReturnFocus = captureAssetBrowserReturnFocus(trigger);
+        const requestId = ++projectFilePreviewRequestId;
+        projectFilePreviewOpen = true;
+        projectFilePreviewContent = null;
+        projectFilePreviewRequestedPath = relativePath;
+        projectFilePreviewError = '';
+        projectFilePreviewMatches = [];
+        projectFilePreviewActiveMatch = -1;
+        projectFilePreviewSearch.value = '';
+        renderProjectFilePreview();
+        syncInputModalOpen();
+        try {
+            const content = await callbacks.onProjectFileRead(relativePath);
+            if (!projectFilePreviewOpen || requestId !== projectFilePreviewRequestId)
+                return;
+            projectFilePreviewContent = content;
+            updateProjectFilePreviewSearch(true);
+            projectFilePreviewSearch.focus({ preventScroll: true });
+        }
+        catch (error) {
+            if (!projectFilePreviewOpen || requestId !== projectFilePreviewRequestId)
+                return;
+            projectFilePreviewError = error instanceof Error ? error.message : String(error);
+            renderProjectFilePreview();
+            projectFilePreviewCloseButton.focus({ preventScroll: true });
+        }
+    };
+    const openProjectBrowserFile = (browserPath, trigger) => {
+        const relativePath = toLocalEditorProjectRelativePath(browserPath);
+        const action = resolveLocalEditorProjectFileOpenAction(relativePath, {
+            mediaPreview: !!callbacks.onProjectMediaResolve,
+            textPreview: !!callbacks.onProjectFileRead,
+        });
+        if (action === 'media-preview') {
+            void openProjectMediaPreview(browserPath, trigger);
+            return true;
+        }
+        if (action === 'text-preview') {
+            void openProjectFilePreview(browserPath, trigger);
+            return true;
+        }
+        return false;
     };
     const openInspectorAssetPicker = (input, property) => {
         contextMenu.close();
@@ -4328,6 +4964,7 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         assetPickerFilter = '';
         assetPickerOpen = true;
         closeAssetPreviewModal();
+        closeProjectFilePreview();
         renderAssetPickerModal();
         syncInputModalOpen();
         assetPickerSearch.focus({ preventScroll: true });
@@ -4372,7 +5009,7 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         syncInputModalOpen();
     };
     function syncInputModalOpen() {
-        inputRouter.setModalOpen(currentState?.mode === 'editor' && (helpOpen || assetPreviewOpen || assetPickerOpen));
+        inputRouter.setModalOpen(currentState?.mode === 'editor' && (helpOpen || assetPreviewOpen || projectFilePreviewOpen || assetPickerOpen));
     }
     function resolvePreviewedAssetFromState() {
         if (!previewedAsset)
@@ -4385,11 +5022,17 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         return previewedAsset;
     }
     function renderAssetPreviewModal() {
+        if (assetPreviewMode === 'project-media') {
+            disposeMaterialPreview();
+            renderProjectMediaPreviewModal();
+            return;
+        }
         const asset = resolvePreviewedAssetFromState();
         if (!assetPreviewOpen
             || !asset
             || (assetPreviewMode === 'preview' && !asset.preview)
             || (assetPreviewMode === 'material-editor' && !asset.material)) {
+            disposeMaterialPreview();
             assetPreviewModal.style.display = 'none';
             assetPreviewTitle.textContent = '';
             assetPreviewMeta.textContent = '';
@@ -4403,6 +5046,7 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             return;
         }
         if (assetPreviewMode === 'rename') {
+            disposeMaterialPreview();
             renderAssetRenameModal(asset);
             assetPreviewModal.style.display = 'flex';
             return;
@@ -4424,8 +5068,81 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         ].filter(Boolean).join(' · ');
         while (assetPreviewBody.firstChild)
             assetPreviewBody.removeChild(assetPreviewBody.firstChild);
-        assetPreviewBody.appendChild(LocalEditorPanels.createAssetPreviewElement(doc, asset, 'modal'));
+        assetPreviewBody.appendChild(createMaterialPreviewStage(asset));
+        assetPreviewModal.style.display = 'flex';
+    }
+    function renderProjectMediaPreviewModal() {
+        if (!assetPreviewOpen) {
+            assetPreviewModal.style.display = 'none';
+            while (assetPreviewBody.firstChild)
+                assetPreviewBody.removeChild(assetPreviewBody.firstChild);
+            delete assetPreviewBody.dataset.editorProjectMediaPath;
+            return;
+        }
+        const source = projectMediaPreviewSource;
+        const path = source?.path ?? projectMediaPreviewRequestedPath;
+        assetPreviewDialog.style.width = 'min(760px,calc(100vw - 64px))';
+        const pathSegments = path.split('/');
+        assetPreviewTitle.textContent = source?.name ?? pathSegments[pathSegments.length - 1] ?? '媒体预览';
+        assetPreviewMeta.textContent = projectMediaPreviewError
+            ? `无法预览：${projectMediaPreviewError}`
+            : source
+                ? [source.kind, source.extension.toUpperCase(), source.path, '只读'].join(' · ')
+                : '正在准备预览...';
+        assetPreviewBody.style.cssText = [
+            'display:flex',
+            'align-items:center',
+            'justify-content:center',
+            'min-height:360px',
+            'max-height:min(620px,calc(100vh - 170px))',
+            'overflow:hidden',
+            'border:1px solid var(--fps-editor-divider)',
+            'border-radius:4px',
+            'background:var(--fps-editor-field)',
+        ].join(';');
         assetPreviewModal.style.display = 'flex';
+        const previewKey = projectMediaPreviewError ? `error:${path}:${projectMediaPreviewError}` : source?.url ?? `loading:${path}`;
+        if (assetPreviewBody.dataset.editorProjectMediaPath === previewKey && assetPreviewBody.firstChild)
+            return;
+        while (assetPreviewBody.firstChild)
+            assetPreviewBody.removeChild(assetPreviewBody.firstChild);
+        assetPreviewBody.dataset.editorProjectMediaPath = previewKey;
+        if (projectMediaPreviewError) {
+            const error = doc.createElement('div');
+            error.style.cssText = 'padding:24px;color:var(--fps-editor-danger);font-size:12px;text-align:center';
+            error.textContent = projectMediaPreviewError;
+            assetPreviewBody.appendChild(error);
+            return;
+        }
+        if (!source) {
+            const loading = doc.createElement('div');
+            loading.style.cssText = 'color:var(--fps-editor-muted);font-size:12px';
+            loading.textContent = '正在准备预览...';
+            assetPreviewBody.appendChild(loading);
+            return;
+        }
+        if (source.kind === 'image') {
+            const image = doc.createElement('img');
+            image.src = source.url;
+            image.alt = source.name;
+            image.style.cssText = 'display:block;width:100%;height:100%;max-height:min(620px,calc(100vh - 170px));object-fit:contain';
+            assetPreviewBody.appendChild(image);
+            return;
+        }
+        if (source.kind === 'audio') {
+            const audio = doc.createElement('audio');
+            audio.controls = true;
+            audio.preload = 'metadata';
+            audio.src = source.url;
+            audio.style.cssText = 'width:min(560px,calc(100% - 32px))';
+            assetPreviewBody.appendChild(audio);
+            return;
+        }
+        const canvas = doc.createElement('canvas');
+        canvas.dataset.editorProjectModelPreview = 'true';
+        canvas.setAttribute('aria-label', `${source.name} 三维模型预览`);
+        canvas.style.cssText = 'display:block;width:100%;height:min(560px,calc(100vh - 190px));min-height:360px;touch-action:none;outline:none';
+        assetPreviewBody.appendChild(canvas);
     }
     function renderAssetRenameModal(asset) {
         assetPreviewDialog.style.width = 'min(420px,calc(100vw - 64px))';
@@ -4477,7 +5194,7 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         const emission = profile.emission ?? {};
         const readonly = material.readonly === true;
         const materialKind = material.materialKind === 'standard' ? 'standard' : 'pbr';
-        assetPreviewDialog.style.width = 'min(780px,calc(100vw - 64px))';
+        assetPreviewDialog.style.width = 'min(840px,calc(100vw - 64px))';
         assetPreviewTitle.textContent = '编辑材质球';
         assetPreviewMeta.textContent = [
             material.name || asset.label,
@@ -4490,7 +5207,7 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             assetPreviewBody.removeChild(assetPreviewBody.firstChild);
         assetPreviewBody.style.cssText = [
             'display:grid',
-            'grid-template-columns:minmax(180px,250px) minmax(0,1fr)',
+            'grid-template-columns:repeat(auto-fit,minmax(min(280px,100%),1fr))',
             'gap:14px',
             'align-items:start',
             'min-height:360px',
@@ -4502,7 +5219,7 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         ].join(';');
         const previewColumn = doc.createElement('div');
         previewColumn.style.cssText = 'display:flex;flex-direction:column;gap:10px;min-width:0';
-        previewColumn.appendChild(LocalEditorPanels.createAssetPreviewElement(doc, asset, 'modal'));
+        previewColumn.appendChild(createMaterialPreviewStage(asset));
         const previewMeta = doc.createElement('div');
         previewMeta.textContent = readonly
             ? '系统默认材质不可编辑。'
@@ -4881,6 +5598,32 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         if (target === assetPreviewModal)
             closeAssetPreviewModal();
     });
+    projectFilePreviewModal.addEventListener('click', (event) => {
+        const target = event.target instanceof HTMLElement ? event.target : null;
+        if (target?.closest('[data-editor-project-file-preview-close]')) {
+            closeProjectFilePreview();
+            return;
+        }
+        if (target?.closest('[data-editor-project-file-search-previous]')) {
+            moveProjectFilePreviewMatch(-1);
+            return;
+        }
+        if (target?.closest('[data-editor-project-file-search-next]')) {
+            moveProjectFilePreviewMatch(1);
+            return;
+        }
+        if (target === projectFilePreviewModal)
+            closeProjectFilePreview();
+    });
+    projectFilePreviewSearch.addEventListener('input', () => {
+        updateProjectFilePreviewSearch(true);
+    });
+    projectFilePreviewSearch.addEventListener('keydown', (event) => {
+        if (event.key !== 'Enter')
+            return;
+        event.preventDefault();
+        moveProjectFilePreviewMatch(event.shiftKey ? -1 : 1);
+    });
     assetPreviewBody.addEventListener('change', (event) => {
         const target = event.target instanceof HTMLElement ? event.target : null;
         if (assetPreviewMode !== 'material-editor')
@@ -5085,8 +5828,21 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
                 : {}),
         };
     }
+    function navigateAssetBrowserFolder(folderPath) {
+        assetBrowserFolderPath = folderPath;
+        expandAssetBrowserFolderPath(folderPath);
+        selectedProjectEntryPath = null;
+        if (currentState)
+            render(currentState);
+    }
+    function selectProjectBrowserEntry(path, button) {
+        selectedProjectEntryPath = path;
+        for (const candidate of assetPanel.querySelectorAll('[data-editor-project-directory-path],[data-editor-project-file-path]')) {
+            candidate.setAttribute('aria-selected', candidate === button ? 'true' : 'false');
+        }
+    }
     assetPanel.addEventListener('click', (event) => {
-        const target = event.target instanceof HTMLElement ? event.target : null;
+        const target = event.target instanceof Element ? event.target : null;
         const tabButton = target?.closest('[data-editor-dock-tab]');
         const tab = tabButton?.dataset.editorDockTab;
         if (tab === 'assets' || tab === 'history') {
@@ -5095,6 +5851,61 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
                 render(currentState);
             return;
         }
+        const clearAssetFilterButton = target?.closest('[data-editor-asset-filter-clear]');
+        if (clearAssetFilterButton) {
+            callbacks.onAssetFilterChange?.('');
+            return;
+        }
+        const refreshAssetBrowserButton = target?.closest('[data-editor-asset-browser-refresh]');
+        if (refreshAssetBrowserButton) {
+            resetProjectMediaThumbnailCache();
+            void projectModelThumbnailCache.clearPathEntries()
+                .catch((error) => {
+                console.error('[fps-editor:asset-browser] thumbnail cache refresh cleanup failed', error);
+            })
+                .finally(() => callbacks.onAssetBrowserRefresh?.());
+            return;
+        }
+        const assetFolderToggle = target?.closest('[data-editor-asset-folder-toggle]');
+        const toggledFolderPath = assetFolderToggle?.dataset.editorAssetFolderToggle;
+        if (toggledFolderPath) {
+            if (assetBrowserExpandedFolderPaths.has(toggledFolderPath)) {
+                assetBrowserExpandedFolderPaths.delete(toggledFolderPath);
+            }
+            else {
+                assetBrowserExpandedFolderPaths.add(toggledFolderPath);
+            }
+            if (currentState)
+                render(currentState);
+            return;
+        }
+        const assetFolderButton = target?.closest('[data-editor-asset-folder-path]');
+        if (assetFolderButton?.dataset.editorAssetFolderPath) {
+            const treeFolderPath = assetFolderButton.dataset.editorAssetFolderTreePath;
+            if (treeFolderPath) {
+                assetBrowserFolderPath = treeFolderPath;
+                selectedProjectEntryPath = null;
+                if (assetBrowserExpandedFolderPaths.has(treeFolderPath)) {
+                    assetBrowserExpandedFolderPaths.delete(treeFolderPath);
+                }
+                else {
+                    assetBrowserExpandedFolderPaths.add(treeFolderPath);
+                }
+                if (currentState)
+                    render(currentState);
+                return;
+            }
+            navigateAssetBrowserFolder(assetFolderButton.dataset.editorAssetFolderPath);
+            return;
+        }
+        const assetViewButton = target?.closest('[data-editor-asset-view-mode]');
+        const nextAssetViewMode = assetViewButton?.dataset.editorAssetViewMode;
+        if (nextAssetViewMode === 'grid' || nextAssetViewMode === 'list') {
+            assetBrowserViewMode = nextAssetViewMode;
+            if (currentState)
+                render(currentState);
+            return;
+        }
         const assetBrowserTabButton = target?.closest('[data-editor-asset-browser-tab]');
         const nextAssetBrowserTab = assetBrowserTabButton?.dataset.editorAssetBrowserTab;
         if (isLocalEditorAssetBrowserTab(nextAssetBrowserTab)) {
@@ -5125,26 +5936,93 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         }
         const assetButton = target?.closest('[data-editor-asset-id]');
         if (assetButton?.dataset.editorAssetId) {
+            selectedProjectEntryPath = null;
             suppressAssetBrowserRevealIfVisible(assetButton);
             callbacks.onSelectAsset?.(assetButton.dataset.editorAssetId);
             return;
         }
+        const projectDirectoryButton = target?.closest('[data-editor-project-directory-path]');
+        if (projectDirectoryButton?.dataset.editorProjectDirectoryPath) {
+            selectProjectBrowserEntry(projectDirectoryButton.dataset.editorProjectDirectoryPath, projectDirectoryButton);
+            return;
+        }
+        const projectFileButton = target?.closest('[data-editor-project-file-path]');
+        if (projectFileButton?.dataset.editorProjectFilePath) {
+            selectProjectBrowserEntry(projectFileButton.dataset.editorProjectFilePath, projectFileButton);
+            return;
+        }
     });
     assetPanel.addEventListener('dblclick', (event) => {
-        const target = event.target instanceof HTMLElement ? event.target : null;
+        const target = event.target instanceof Element ? event.target : null;
+        const projectDirectoryButton = target?.closest('[data-editor-project-directory-path]');
+        const projectDirectoryPath = projectDirectoryButton?.dataset.editorProjectDirectoryPath;
+        if (projectDirectoryPath) {
+            event.preventDefault();
+            event.stopPropagation();
+            navigateAssetBrowserFolder(projectDirectoryPath);
+            return;
+        }
         const assetButton = target?.closest('[data-editor-asset-id]');
         const browserAssetId = assetButton?.dataset.editorAssetId;
-        if (!browserAssetId || !currentState)
+        const projectFileButton = target?.closest('[data-editor-project-file-path]');
+        const browserProjectFilePath = projectFileButton?.dataset.editorProjectFilePath;
+        if (!currentState)
             return;
-        const asset = currentState.assets.find(candidate => candidate.id === browserAssetId);
+        const asset = browserAssetId
+            ? currentState.assets.find(candidate => candidate.id === browserAssetId)
+            : undefined;
         const actionId = asset ? resolveAssetBrowserDoubleClickAction(currentState, asset) : null;
-        if (!asset || !actionId)
+        if (asset && actionId && browserAssetId) {
+            event.preventDefault();
+            event.stopPropagation();
+            suppressAssetBrowserRevealIfVisible(assetButton);
+            callbacks.onSelectAsset?.(browserAssetId);
+            callbacks.onAssetAction?.(createAssetBrowserActionInput(actionId, asset, createCurrentAssetBrowserActionContext()));
+            return;
+        }
+        if (browserProjectFilePath && openProjectBrowserFile(browserProjectFilePath, projectFileButton)) {
+            event.preventDefault();
+            event.stopPropagation();
+        }
+    });
+    assetPanel.addEventListener('keydown', (event) => {
+        if (event.key !== 'Enter')
+            return;
+        const target = event.target instanceof Element ? event.target : null;
+        const projectDirectoryButton = target?.closest('[data-editor-project-directory-path]');
+        const projectDirectoryPath = projectDirectoryButton?.dataset.editorProjectDirectoryPath;
+        if (projectDirectoryPath) {
+            event.preventDefault();
+            navigateAssetBrowserFolder(projectDirectoryPath);
+            return;
+        }
+        const assetButton = target?.closest('[data-editor-asset-id]');
+        const browserAssetId = assetButton?.dataset.editorAssetId;
+        const asset = browserAssetId
+            ? currentState?.assets.find(candidate => candidate.id === browserAssetId)
+            : undefined;
+        const assetActionId = asset && currentState
+            ? resolveAssetBrowserDoubleClickAction(currentState, asset)
+            : null;
+        if (asset && browserAssetId && assetActionId) {
+            event.preventDefault();
+            suppressAssetBrowserRevealIfVisible(assetButton);
+            callbacks.onSelectAsset?.(browserAssetId);
+            callbacks.onAssetAction?.(createAssetBrowserActionInput(assetActionId, asset, createCurrentAssetBrowserActionContext()));
+            return;
+        }
+        const projectFileButton = target?.closest('[data-editor-project-file-path]');
+        const projectFilePath = projectFileButton?.dataset.editorProjectFilePath;
+        if (projectFilePath && openProjectBrowserFile(projectFilePath, projectFileButton)) {
+            event.preventDefault();
+            return;
+        }
+        const treeFolderButton = target?.closest('[data-editor-asset-folder-tree-path]');
+        const treeFolderPath = treeFolderButton?.dataset.editorAssetFolderTreePath;
+        if (!treeFolderPath)
             return;
         event.preventDefault();
-        event.stopPropagation();
-        suppressAssetBrowserRevealIfVisible(assetButton);
-        callbacks.onSelectAsset?.(browserAssetId);
-        callbacks.onAssetAction?.(createAssetBrowserActionInput(actionId, asset, createCurrentAssetBrowserActionContext()));
+        treeFolderButton.click();
     });
     assetPanel.addEventListener('contextmenu', (event) => {
         if (!inputRouter.shouldPreventBrowserContextMenu(event))
@@ -5152,31 +6030,119 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         const target = inputRouter.getEventTarget(event);
         if (!target)
             return;
-        const assetButton = target?.closest('[data-editor-asset-id]');
+        const projectFileButton = target.closest('[data-editor-project-file-path]');
+        const browserProjectFilePath = projectFileButton?.dataset.editorProjectFilePath;
+        const projectDirectoryButton = target.closest('[data-editor-project-directory-path],[data-editor-asset-folder-tree-path]');
+        const browserProjectDirectoryPath = projectDirectoryButton?.dataset.editorProjectDirectoryPath
+            ?? projectDirectoryButton?.dataset.editorAssetFolderTreePath;
+        const assetButton = target.closest('[data-editor-asset-id]');
         const browserAssetId = assetButton?.dataset.editorAssetId;
-        if (!browserAssetId || !currentState)
+        if ((!browserProjectFilePath && browserProjectDirectoryPath == null && !browserAssetId) || !currentState)
             return;
-        const asset = currentState.assets.find(candidate => candidate.id === browserAssetId);
-        if (!asset)
+        const asset = browserAssetId
+            ? currentState.assets.find(candidate => candidate.id === browserAssetId) ?? null
+            : null;
+        if (browserAssetId && !asset)
             return;
         inputRouter.claimContextMenu(event);
-        suppressAssetBrowserRevealIfVisible(assetButton);
-        callbacks.onSelectAsset?.(browserAssetId);
-        contextMenu.open({
+        if (asset && assetButton) {
+            suppressAssetBrowserRevealIfVisible(assetButton);
+            callbacks.onSelectAsset?.(asset.id);
+        }
+        else if (browserProjectFilePath && projectFileButton) {
+            selectProjectBrowserEntry(browserProjectFilePath, projectFileButton);
+        }
+        else if (browserProjectDirectoryPath != null && projectDirectoryButton) {
+            selectProjectBrowserEntry(browserProjectDirectoryPath, projectDirectoryButton);
+        }
+        const relativeProjectFilePath = browserProjectFilePath
+            ? toLocalEditorProjectRelativePath(browserProjectFilePath)
+            : null;
+        const relativeProjectDirectoryPath = browserProjectDirectoryPath != null
+            ? toLocalEditorProjectRelativePath(browserProjectDirectoryPath) || '.'
+            : null;
+        const snapshot = createLocalEditorAssetFilesystemSnapshot(currentState.assets, currentState.projectFiles);
+        const fileEntry = browserProjectFilePath
+            ? snapshot.entries.find(entry => entry.path === browserProjectFilePath) ?? null
+            : null;
+        const directoryEntry = browserProjectDirectoryPath != null
+            ? snapshot.entries.find(entry => entry.path === browserProjectDirectoryPath) ?? null
+            : null;
+        const directoryFolder = browserProjectDirectoryPath != null
+            ? snapshot.folders.find(folder => folder.path === browserProjectDirectoryPath) ?? null
+            : null;
+        const projectItems = relativeProjectFilePath
+            ? [
+                ...(callbacks.onProjectFileRead && isEditorProjectFilePreviewable(relativeProjectFilePath)
+                    ? [{ id: 'project-file.preview', label: '查看文件' }]
+                    : []),
+                ...(callbacks.onProjectMediaResolve && isEditorProjectMediaPreviewable(relativeProjectFilePath)
+                    ? [{ id: 'project-file.preview-media', label: '预览媒体' }]
+                    : []),
+                ...(callbacks.onProjectEntrySendToAgent
+                    ? [{ id: 'project-entry.send-to-agent', label: '发送给 Agent' }]
+                    : []),
+                { id: 'project-file.copy-path', label: '复制路径' },
+            ]
+            : relativeProjectDirectoryPath
+                ? [
+                    ...(callbacks.onProjectEntrySendToAgent
+                        ? [{ id: 'project-entry.send-to-agent', label: '发送给 Agent' }]
+                        : []),
+                    { id: 'project-file.copy-path', label: '复制路径' },
+                ]
+                : [];
+        const assetItems = asset ? createAssetBrowserMenuItems(currentState, asset) : [];
+        if (projectItems.length > 0 && assetItems.length > 0)
+            assetItems[0] = { ...assetItems[0], separatorBefore: true };
+        const openContextMenu = () => contextMenu.open({
             x: event.clientX,
             y: event.clientY,
-            items: createAssetBrowserMenuItems(currentState, asset),
+            items: [...projectItems, ...assetItems],
             onAction(item) {
+                if (item.id === 'project-file.preview' && browserProjectFilePath) {
+                    void openProjectFilePreview(browserProjectFilePath, projectFileButton);
+                    return;
+                }
+                if (item.id === 'project-file.preview-media' && browserProjectFilePath) {
+                    void openProjectMediaPreview(browserProjectFilePath, projectFileButton);
+                    return;
+                }
+                if (item.id === 'project-entry.send-to-agent' && callbacks.onProjectEntrySendToAgent) {
+                    const path = relativeProjectFilePath ?? relativeProjectDirectoryPath;
+                    if (!path)
+                        return;
+                    const entryKind = relativeProjectFilePath ? 'file' : 'directory';
+                    const name = entryKind === 'file'
+                        ? fileEntry?.label ?? path.split('/').slice(-1)[0] ?? path
+                        : directoryEntry?.label ?? directoryFolder?.label ?? currentState?.projectFiles?.rootName ?? path;
+                    void Promise.resolve(callbacks.onProjectEntrySendToAgent({
+                        path,
+                        name,
+                        entryKind,
+                        ...(entryKind === 'file' && fileEntry?.extension ? { extension: fileEntry.extension } : {}),
+                        ...(asset ? { assetId: asset.assetId ?? asset.id, assetKind: asset.kind } : {}),
+                    })).catch(() => undefined);
+                    return;
+                }
+                if (item.id === 'project-file.copy-path') {
+                    const path = relativeProjectFilePath ?? relativeProjectDirectoryPath;
+                    if (path)
+                        copyTextToClipboard(doc.defaultView, path);
+                    return;
+                }
+                if (!asset)
+                    return;
                 if (item.id === 'asset.preview') {
-                    openAssetPreviewModal(asset);
+                    openAssetPreviewModal(asset, assetButton);
                     return;
                 }
                 if (item.id === 'asset.edit-material') {
-                    openAssetMaterialEditorModal(asset);
+                    openAssetMaterialEditorModal(asset, assetButton);
                     return;
                 }
                 if (item.id === 'asset.rename') {
-                    openAssetRenameModal(asset);
+                    openAssetRenameModal(asset, assetButton);
                     return;
                 }
                 if (item.id === 'asset.edit-prefab' || item.id === 'asset.add-to-current-prefab') {
@@ -5190,6 +6156,15 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
                 callbacks.onAssetAction?.(createAssetBrowserActionInput(item.id, asset, createCurrentAssetBrowserActionContext()));
             },
         });
+        // Selecting a catalog asset rerenders the asset browser synchronously. Open
+        // its menu on the next frame so the first right-click is not cleared by that
+        // selection refresh.
+        if (asset && assetButton && doc.defaultView?.requestAnimationFrame) {
+            doc.defaultView.requestAnimationFrame(openContextMenu);
+        }
+        else {
+            openContextMenu();
+        }
     });
     workbench.rightDock.addEventListener('click', (event) => {
         const target = event.target instanceof HTMLElement ? event.target : null;
@@ -5236,6 +6211,8 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
                 setShortcutHelpOpen(false);
             if (assetPreviewOpen)
                 closeAssetPreviewModal();
+            if (projectFilePreviewOpen)
+                closeProjectFilePreview();
         },
         requestOperationInput: requestHierarchyOperationInput,
     });
@@ -5246,6 +6223,15 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             return;
         callbacks.onAssetFilterChange?.(input.value);
     });
+    assetPanel.addEventListener('change', (event) => {
+        const select = event.target instanceof HTMLSelectElement ? event.target : null;
+        const nextAssetBrowserTab = select?.dataset.editorAssetBrowserTypeFilter ? select.value : null;
+        if (!isLocalEditorAssetBrowserTab(nextAssetBrowserTab))
+            return;
+        assetBrowserTab = nextAssetBrowserTab;
+        if (currentState)
+            render(currentState);
+    });
     inspectorPanel.addEventListener('input', (event) => {
         const input = event.target instanceof HTMLInputElement ? event.target : null;
         if (input?.dataset.editorInspectorSearch != null) {
@@ -5254,6 +6240,8 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
                 render(currentState);
             return;
         }
+        if (currentState?.inspectorPending === true)
+            return;
         if (input?.type === 'checkbox' || input?.type === 'color')
             return;
         if (!input?.dataset.serializedPath || !input.dataset.serializedTargetId)
@@ -5268,6 +6256,11 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             callbacks.onPropertyInput?.(propertyInput);
     });
     inspectorPanel.addEventListener('paste', (event) => {
+        if (currentState?.inspectorPending === true) {
+            event.preventDefault();
+            event.stopPropagation();
+            return;
+        }
         const input = event.target instanceof HTMLInputElement ? event.target : null;
         const text = event.clipboardData?.getData('text/plain') ?? event.clipboardData?.getData('text') ?? '';
         if (!input || !text)
@@ -5285,6 +6278,11 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             callbacks.onPropertyInput?.(propertyInput);
     });
     inspectorPanel.addEventListener('click', (event) => {
+        if (currentState?.inspectorPending === true) {
+            event.preventDefault();
+            event.stopPropagation();
+            return;
+        }
         const target = event.target instanceof HTMLElement ? event.target : null;
         const renderingActionButton = target?.closest('[data-editor-rendering-action]');
         if (renderingActionButton) {
@@ -5397,6 +6395,8 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         openInspectorAssetPicker(input, property);
     });
     inspectorPanel.addEventListener('change', (event) => {
+        if (currentState?.inspectorPending === true)
+            return;
         const input = event.target instanceof HTMLInputElement || event.target instanceof HTMLSelectElement
             ? event.target
             : null;
@@ -5418,6 +6418,11 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             callbacks.onPropertyInput?.(propertyInput);
     });
     inspectorPanel.addEventListener('keydown', (event) => {
+        if (currentState?.inspectorPending === true) {
+            event.preventDefault();
+            event.stopPropagation();
+            return;
+        }
         const input = event.target instanceof HTMLInputElement ? event.target : null;
         if (!input || !isLocalEditorKeyboardCommitEvent(event, input))
             return;
@@ -5427,6 +6432,8 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         event.stopPropagation();
     });
     inspectorPanel.addEventListener('focusout', (event) => {
+        if (currentState?.inspectorPending === true)
+            return;
         const input = event.target instanceof HTMLInputElement ? event.target : null;
         if (!input?.dataset.serializedPath || !input.dataset.serializedTargetId)
             return;
@@ -5568,6 +6575,11 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             closeAssetPreviewModal();
             return;
         }
+        if (key === 'escape' && projectFilePreviewOpen) {
+            event.preventDefault();
+            closeProjectFilePreview();
+            return;
+        }
         if (key === 'escape' && assetPickerOpen) {
             event.preventDefault();
             closeInspectorAssetPicker();
@@ -5621,6 +6633,7 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             && primaryModifier
             && key === 's') {
             event.preventDefault();
+            editorConsole.append({ severity: 'info', source: 'save', message: '请求保存场景' });
             callbacks.onSaveScene?.();
             return;
         }
@@ -5646,6 +6659,17 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             && candidate.shortcut?.toLowerCase() === key));
         if (tool) {
             event.preventDefault();
+            if (/(?:^|[?&])debugGizmo=(?:1|true)(?:&|$)/.test(doc.defaultView?.location?.search ?? '')) {
+                console.info('[fps-editor:gizmo]', 'shortcut.dispatched', {
+                    timestamp: typeof performance !== 'undefined' ? Number(performance.now().toFixed(2)) : Date.now(),
+                    key,
+                    toolId: tool.id,
+                    availability: tool.availability.state,
+                    active: tool.active,
+                    eventTarget: event.target instanceof Element ? event.target.tagName : null,
+                    defaultPrevented: event.defaultPrevented,
+                });
+            }
             if (tool.availability.state === 'enabled')
                 callbacks.onToolActivate?.(tool.id);
             return;
@@ -5693,27 +6717,31 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             && getPreviewToolSupport(tool).support === 'enabled';
     }
     function applyPrefabStageWorkbenchLayoutOverride(layout = workbenchLayoutController.getLayout()) {
-        const { leftWidth, rightWidth, bottomEdge, bottomVisible } = resolveLocalEditorPrefabStageWorkbenchLayout(layout, readLocalEditorWorkbenchViewport(doc));
+        const { leftWidth, rightWidth, consoleEdge, sceneBottomEdge, 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.bottom = `${consoleEdge}px`;
         workbench.leftDock.style.zIndex = '';
         workbench.leftDock.style.boxShadow = '';
         workbench.rightDock.style.display = 'flex';
         workbench.rightDock.style.width = `${rightWidth}px`;
+        workbench.rightDock.style.bottom = `${consoleEdge}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`;
+        workbench.sceneFrame.style.bottom = `${sceneBottomEdge}px`;
         if (bottomVisible) {
+            workbench.bottomDock.style.left = `${leftWidth}px`;
             workbench.bottomDock.style.right = `${rightWidth}px`;
+            workbench.bottomDock.style.bottom = `${consoleEdge}px`;
+            workbench.bottomResizer.style.left = `${leftWidth}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';
+        workbench.leftResizer.style.bottom = `${consoleEdge}px`;
+        workbench.rightResizer.style.bottom = `${consoleEdge}px`;
     }
     function readLocalEditorWorkbenchViewport(docRef) {
         const win = docRef.defaultView;
@@ -5734,6 +6762,7 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
                 emptyText: 'Select an item in Prefab Explorer.',
                 lockedVectorGroups: lockedInspectorVectorGroups,
             });
+            lastRenderedInspectorContentKey = resolveLocalEditorRightDockContentKey(currentState, 'inspector', inspectorFilter);
             return;
         }
         LocalEditorPanels.disposeInspectorPanelUi(inspectorPanel);
@@ -5750,6 +6779,9 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         appendPrefabStageReadonlyRow(grid, 'Mode', stage.readonly ? '只读' : '可编辑');
         appendPrefabStageSelectedItemDetails(grid, selectedItem);
         inspectorPanel.appendChild(grid);
+        lastRenderedInspectorContentKey = currentState
+            ? resolveLocalEditorRightDockContentKey(currentState, 'inspector', inspectorFilter)
+            : null;
     }
     function appendPrefabStageSelectedItemDetails(container, item) {
         if (!item)
@@ -5914,8 +6946,7 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             ? 'var(--fps-editor-border)'
             : agentBridgeStatusColor;
         setToolbarButtonTooltip(agentBridgeStatusButton, createAgentBridgeStatusTooltip(state.agentBridge));
-        renderCoordinateAxesOverlay(coordinateAxesOverlay, inEditor ? state.coordinateAxes ?? null : null);
-        renderSceneFrameRateOverlay(sceneFrameRateOverlay, inEditor && !inPrefabStage ? state.sceneFrameStats ?? null : null);
+        renderCoordinateAxesOverlay(coordinateAxesOverlay, inEditor ? state.coordinateAxes ?? null : null, state.viewportTools?.viewPreset ?? 'perspective', state.busy);
         renderPerformanceMonitorOverlay(performanceMonitorOverlay, inEditor && !inPrefabStage ? state.performanceStats ?? null : null, inEditor && !inPrefabStage && performanceMonitorOpen);
         prefabStagePreviewLayout.root.style.display = inEditor && inPrefabStage ? 'block' : 'none';
         renderPrefabImportStatsOverlay(prefabImportStatsOverlay, inEditor && inPrefabStage ? state.prefabStage ?? null : null);
@@ -5938,12 +6969,48 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
     const updatePreview = (preview) => {
         if (!currentState)
             return;
+        const toolPresentationStartedAt = typeof performance !== 'undefined' ? performance.now() : Date.now();
+        const shouldRenderToolPresentation = 'tools' in preview || 'activeToolId' in preview;
+        const previousActiveToolId = currentState.activeToolId ?? null;
         const shouldRenderInspectorPreview = 'inspectorObject' in preview || 'inspectorMultiObject' in preview;
-        currentState = {
+        const shouldRenderSelectionPresentation = 'selectedIds' in preview
+            || 'activeId' in preview
+            || 'selectionSummary' in preview;
+        const nextState = {
             ...currentState,
             ...preview,
         };
+        const nextInspectorContentKey = resolveLocalEditorRightDockContentKey(nextState, 'inspector', inspectorFilter);
+        const inspectorPreviewScrollSnapshot = shouldRenderInspectorPreview
+            && lastRenderedInspectorContentKey === nextInspectorContentKey
+            ? captureLocalEditorRightDockScrollSnapshot(currentState, 'inspector', inspectorFilter, inspectorPanel, renderingPanel, markersPanel, pluginsPanel)
+            : null;
+        currentState = nextState;
+        if ('inspectorPending' in preview) {
+            syncLocalEditorInspectorPendingState(inspectorPanel, currentState.inspectorPending === true);
+        }
+        if (shouldRenderToolPresentation) {
+            renderToolPresentationState(currentState);
+            scheduleToolbarOverflowLayout();
+            if (/(?:^|[?&])debugGizmo=(?:1|true)(?:&|$)/.test(doc.defaultView?.location?.search ?? '')) {
+                console.info('[fps-editor:gizmo]', 'ui.tool-presentation.updated', {
+                    timestamp: typeof performance !== 'undefined' ? Number(performance.now().toFixed(2)) : Date.now(),
+                    durationMs: Number(((typeof performance !== 'undefined' ? performance.now() : Date.now()) - toolPresentationStartedAt).toFixed(2)),
+                    previousActiveToolId,
+                    activeToolId: currentState.activeToolId ?? null,
+                    toolCount: currentState.tools?.length ?? 0,
+                });
+            }
+        }
+        if (shouldRenderSelectionPresentation)
+            hierarchyController.render(currentState);
         renderPreviewState(currentState);
+        if (shouldRenderInspectorPreview
+            && currentState.mode === 'editor'
+            && !!currentState.prefabStage
+            && rightDockFormalSurfaceVisibility.isVisible()) {
+            renderPrefabStagePropertiesPanel(currentState.prefabStage);
+        }
         if (shouldRenderLocalEditorInspectorPreview({
             hasInspectorPreview: shouldRenderInspectorPreview,
             mode: currentState.mode,
@@ -5951,20 +7018,33 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             rightDockVisible: rightDockFormalSurfaceVisibility.isVisible(),
             activeRightTab: panelRegistry.getRightDockTab(),
         })) {
-            const rightDockScrollSnapshot = captureLocalEditorRightDockScrollSnapshot(currentState, 'inspector', inspectorFilter, inspectorPanel, renderingPanel, markersPanel, pluginsPanel);
             LocalEditorPanels.renderInspectorPanel(doc, inspectorPanel, currentState, inspectorFilter, {
                 ...options.inspector,
                 layerHost: editorUiLayerHost,
                 lockedVectorGroups: lockedInspectorVectorGroups,
             });
-            restoreLocalEditorRightDockScrollSnapshot(rightDockScrollSnapshot, currentState, 'inspector', inspectorFilter, inspectorPanel, renderingPanel, markersPanel, pluginsPanel);
+            lastRenderedInspectorContentKey = nextInspectorContentKey;
+            restoreLocalEditorRightDockScrollSnapshot(inspectorPreviewScrollSnapshot, currentState, 'inspector', inspectorFilter, inspectorPanel, renderingPanel, markersPanel, pluginsPanel);
+        }
+        if ((shouldRenderSelectionPresentation || shouldRenderInspectorPreview)
+            && /(?:^|[?&])debug(?:Gizmo|Selection)=(?:1|true)(?:&|$)/.test(doc.defaultView?.location?.search ?? '')) {
+            console.info('[fps-editor:selection]', 'ui.selection-preview.updated', {
+                timestamp: typeof performance !== 'undefined' ? Number(performance.now().toFixed(2)) : Date.now(),
+                durationMs: Number(((typeof performance !== 'undefined' ? performance.now() : Date.now()) - toolPresentationStartedAt).toFixed(2)),
+                phase: shouldRenderSelectionPresentation ? 'presentation' : 'inspector',
+                activeId: currentState.activeId,
+                selectedCount: currentState.selectedIds.length,
+            });
         }
     };
     const render = (state) => {
         const previousState = currentState;
+        const assetBrowserContinuitySnapshot = assetBrowserContinuity.capture(lastRenderedAssetBrowserContentKey);
         const previousRightTab = panelRegistry.getRightDockTab();
         const rightDockScrollSnapshot = captureLocalEditorRightDockScrollSnapshot(previousState, previousRightTab, inspectorFilter, inspectorPanel, renderingPanel, markersPanel, pluginsPanel);
         currentState = state;
+        syncLocalEditorInspectorPendingState(inspectorPanel, state.inspectorPending === true);
+        editorConsole.syncState(state, previousState);
         const focusSnapshot = captureLocalEditorEditableFocus(doc);
         const inEditor = state.mode === 'editor';
         const disabled = state.busy;
@@ -5993,14 +7073,29 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             setPerformanceMonitorOpen(false);
         }
         if (!inEditor || disabled) {
+            projectMediaPreviewRequestId += 1;
+            disposeProjectModelPreview();
             assetPreviewOpen = false;
+            assetPreviewReturnFocus = null;
             previewedAsset = null;
             assetPreviewMode = 'preview';
+            projectMediaPreviewSource = null;
+            projectMediaPreviewRequestedPath = '';
+            projectMediaPreviewError = '';
+            projectFilePreviewOpen = false;
+            projectFilePreviewReturnFocus = null;
+            projectFilePreviewRequestId += 1;
+            projectFilePreviewContent = null;
+            projectFilePreviewRequestedPath = '';
+            projectFilePreviewError = '';
+            projectFilePreviewMatches = [];
+            projectFilePreviewActiveMatch = -1;
             assetPickerOpen = false;
             assetPickerInput = null;
             assetPickerProperty = null;
             settleHierarchyOperationInputRequest(null);
         }
+        renderProjectFilePreview();
         syncInputModalOpen();
         const transformTool = state.transformTool ?? null;
         workbench.root.style.display = inEditor ? '' : 'none';
@@ -6066,21 +7161,7 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         const viewportControlsTooltip = sceneCameraPreview.enabled
             ? '当前为 Main Camera 预览，请关闭后再使用视口工具'
             : '';
-        const viewportProjectionTooltip = sceneCameraPreview.enabled
-            ? '当前为 Main Camera 预览，投影由 Main Camera 决定；关闭预览后可切换编辑视口投影'
-            : '';
         viewportToolsGroup.style.display = isPreviewToolVisible('viewport-camera') ? 'flex' : 'none';
-        for (const [preset, button] of viewportPresetButtons) {
-            button.disabled = viewportControlsDisabled;
-            setToolbarButtonTooltip(button, viewportControlsTooltip || VIEW_PRESET_TOOLTIPS[preset]);
-            LocalEditorShared.applyButtonActiveState(button, viewportTools?.viewPreset === preset);
-        }
-        projectionToggleButton.disabled = viewportControlsDisabled;
-        const projectionMode = viewportTools?.projectionMode ?? 'perspective';
-        const nextProjectionMode = projectionMode === 'orthographic' ? 'perspective' : 'orthographic';
-        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');
         const markersVisible = viewportTools?.markersVisible ?? true;
         markerVisibilityButton.disabled = disabled;
         setToolbarButtonTooltip(markerVisibilityButton, markersVisible ? '隐藏标记与关系线' : '显示标记与关系线');
@@ -6120,11 +7201,7 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         gridToggleButton.disabled = disabled || !gridState.available;
         setToolbarButtonTooltip(gridToggleButton, gridState.visible ? '隐藏 Scene View 网格' : '显示 Scene View 网格');
         LocalEditorShared.applyButtonActiveState(gridToggleButton, gridState.visible);
-        synchronizeToolButtons(state.tools ?? []);
-        toolGroup.style.display = inEditor
-            && (state.tools ?? []).some(tool => tool.kind === 'primary' && tool.availability.state !== 'hidden')
-            ? 'flex'
-            : 'none';
+        renderToolPresentationState(state);
         spaceGroup.style.display = isPreviewToolVisible('transform-space') ? 'flex' : 'none';
         for (const [space, button] of Object.entries(spaceButtons)) {
             button.disabled = !isPreviewToolEnabled('transform-space');
@@ -6199,12 +7276,7 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
                 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;
@@ -6213,10 +7285,18 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             pluginsPanel.style.display = rightDockVisibility.pluginsDisplay;
             hierarchyController.render(state);
             renderPrefabStagePropertiesPanel(prefabStage);
-            LocalEditorPanels.renderWorkbenchBottomDockPanel(doc, assetPanel, state, activeBottomTab, panelRegistry.getPanels('bottom'), assetBrowserTab);
-            if (activeBottomTab === 'assets' && !assetBrowserTabChanged && !bottomDockTabChanged) {
-                assetBrowserViewportReveal.restoreScrollSnapshot(assetBrowserScrollSnapshot);
+            LocalEditorPanels.renderWorkbenchBottomDockPanel(doc, assetPanel, state, activeBottomTab, panelRegistry.getPanels('bottom'), assetBrowserTab, { expandedFolderPaths: assetBrowserExpandedFolderPaths, folderPath: assetBrowserFolderPath, viewMode: assetBrowserViewMode, selectedEntryPath: selectedProjectEntryPath });
+            if (activeBottomTab === 'assets') {
+                assetBrowserFolderPath = assetPanel.dataset.editorAssetBrowserFolderPath ?? assetBrowserFolderPath;
             }
+            const assetBrowserContentKey = resolveLocalEditorAssetBrowserContentKey({
+                assetFilter: state.assetFilter,
+                folderPath: assetBrowserFolderPath,
+                tab: assetBrowserTab,
+                viewMode: assetBrowserViewMode,
+            });
+            hydrateProjectMediaThumbnails();
+            assetBrowserContinuity.restore(assetBrowserContinuitySnapshot, assetBrowserContentKey, activeBottomTab === 'assets');
             const suppressAssetScroll = state.selectedAssetId
                 ? assetBrowserViewportReveal.consumeRevealSuppression(state.selectedAssetId, { clearWhenDifferent: selectedAssetChanged })
                 : false;
@@ -6224,8 +7304,7 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
                 revealSelectedAssetBrowserItem(state.selectedAssetId);
             }
             revealPendingStatusDiagnosticAsset(state);
-            lastRenderedAssetBrowserTab = assetBrowserTab;
-            lastRenderedBottomDockTab = activeBottomTab;
+            lastRenderedAssetBrowserContentKey = activeBottomTab === 'assets' ? assetBrowserContentKey : null;
             lastRenderedSelectedAssetId = state.selectedAssetId ?? null;
             restoreLocalEditorEditableFocus(doc, focusSnapshot);
             revealPendingStatusDiagnosticPath(state);
@@ -6240,12 +7319,7 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         });
         rightDockTabs.style.display = rightDockVisibility.tabsDisplay;
         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 };
         hierarchyPanel.dataset.editorPanelId = hierarchyDescriptor?.id ?? 'hierarchy';
         inspectorPanel.dataset.editorPanelId = activeRightTab === 'inspector' ? rightDescriptor?.id ?? 'inspector' : 'inspector';
         renderingPanel.dataset.editorPanelId = activeRightTab === 'rendering' ? rightDescriptor?.id ?? 'rendering' : 'rendering';
@@ -6257,10 +7331,18 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         pluginsPanel.style.display = rightDockVisibility.pluginsDisplay;
         LocalEditorPanels.renderWorkbenchLeftDockTabs(doc, leftDockTabs, 'hierarchy', panelRegistry.getPanels('left'));
         hierarchyController.render(state);
-        LocalEditorPanels.renderWorkbenchBottomDockPanel(doc, assetPanel, state, activeBottomTab, panelRegistry.getPanels('bottom'), assetBrowserTab);
-        if (activeBottomTab === 'assets' && !assetBrowserTabChanged && !bottomDockTabChanged) {
-            assetBrowserViewportReveal.restoreScrollSnapshot(assetBrowserScrollSnapshot);
-        }
+        LocalEditorPanels.renderWorkbenchBottomDockPanel(doc, assetPanel, state, activeBottomTab, panelRegistry.getPanels('bottom'), assetBrowserTab, { expandedFolderPaths: assetBrowserExpandedFolderPaths, folderPath: assetBrowserFolderPath, viewMode: assetBrowserViewMode, selectedEntryPath: selectedProjectEntryPath });
+        if (activeBottomTab === 'assets') {
+            assetBrowserFolderPath = assetPanel.dataset.editorAssetBrowserFolderPath ?? assetBrowserFolderPath;
+        }
+        const assetBrowserContentKey = resolveLocalEditorAssetBrowserContentKey({
+            assetFilter: state.assetFilter,
+            folderPath: assetBrowserFolderPath,
+            tab: assetBrowserTab,
+            viewMode: assetBrowserViewMode,
+        });
+        hydrateProjectMediaThumbnails();
+        assetBrowserContinuity.restore(assetBrowserContinuitySnapshot, assetBrowserContentKey, activeBottomTab === 'assets');
         const suppressAssetScroll = state.selectedAssetId
             ? assetBrowserViewportReveal.consumeRevealSuppression(state.selectedAssetId, { clearWhenDifferent: selectedAssetChanged })
             : false;
@@ -6268,14 +7350,14 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             revealSelectedAssetBrowserItem(state.selectedAssetId);
         }
         revealPendingStatusDiagnosticAsset(state);
-        lastRenderedAssetBrowserTab = assetBrowserTab;
-        lastRenderedBottomDockTab = activeBottomTab;
+        lastRenderedAssetBrowserContentKey = activeBottomTab === 'assets' ? assetBrowserContentKey : null;
         lastRenderedSelectedAssetId = state.selectedAssetId;
         LocalEditorPanels.renderWorkbenchRightDockTabs(doc, rightDockTabs, activeRightTab, panelRegistry.getPanels('right'));
         const rightDockVisible = rightDockFormalSurfaceVisibility.isVisible();
         if (!rightDockVisible) {
             LocalEditorPanels.disposeInspectorPanelUi(inspectorPanel);
             LocalEditorPanels.disposeInspectorPanelUi(renderingPanel);
+            lastRenderedInspectorContentKey = null;
         }
         else if (activeRightTab === 'inspector') {
             LocalEditorPanels.renderInspectorPanel(doc, inspectorPanel, state, inspectorFilter, {
@@ -6283,6 +7365,7 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
                 layerHost: editorUiLayerHost,
                 lockedVectorGroups: lockedInspectorVectorGroups,
             });
+            lastRenderedInspectorContentKey = resolveLocalEditorRightDockContentKey(state, 'inspector', inspectorFilter);
         }
         else if (activeRightTab === 'rendering') {
             LocalEditorPanels.renderRenderingPanel(doc, renderingPanel, state, { layerHost: editorUiLayerHost });
@@ -6298,7 +7381,6 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         revealPendingStatusDiagnosticPath(state);
     };
     const completedCleanup = new Set();
-    let uiDisposed = false;
     return {
         update(state) {
             render(state);
@@ -6307,7 +7389,6 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
         updateSceneFrameStats(stats) {
             if (currentState)
                 currentState = { ...currentState, sceneFrameStats: stats };
-            renderSceneFrameRateOverlay(sceneFrameRateOverlay, currentState?.mode === 'editor' && !currentState.prefabStage ? stats : null);
         },
         updatePerformanceStats(stats) {
             if (currentState)
@@ -6330,7 +7411,10 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             return activeTheme;
         },
         dispose() {
-            if (uiDisposed)
+            if (canSkipLocalEditorPreviewCleanupPass(uiDisposed, [
+                projectModelPreviewCleanupRegistry,
+                materialPreviewCleanupRegistry,
+            ]))
                 return;
             const errors = [];
             const run = (key, operation) => {
@@ -6363,6 +7447,10 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             run('toolbar-overflow-resize', () => {
                 doc.defaultView?.removeEventListener('resize', scheduleToolbarOverflowLayout);
             });
+            run('project-media-preview-request', () => {
+                projectMediaPreviewRequestId += 1;
+                assetPreviewOpen = false;
+            });
             run('host-chrome', () => hostChrome.remove());
             run('inspector-ui', () => LocalEditorPanels.disposeInspectorPanelUi(inspectorPanel));
             run('rendering-ui', () => LocalEditorPanels.disposeInspectorPanelUi(renderingPanel));
@@ -6378,14 +7466,25 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             run('overlay-settings-popover', () => overlaySettingsPopover.remove());
             run('spatial-overlay', () => spatialOverlay.root.remove());
             run('measurement-overlay', () => measurementOverlay.root.remove());
-            run('scene-frame-rate-overlay', () => sceneFrameRateOverlay.root.remove());
             run('performance-monitor-overlay', () => performanceMonitorOverlay.root.remove());
             run('prefab-stage-preview-layout', () => prefabStagePreviewLayout.root.remove());
             run('box-selection-overlay', () => boxSelectionOverlay.remove());
             run('shortcut-help-panel', () => shortcutHelpPanel.remove());
+            run('project-model-preview', () => disposeProjectModelPreview());
+            run('project-media-thumbnails', () => resetProjectMediaThumbnailCache());
+            run('project-model-thumbnail-cache', () => projectModelThumbnailCache.dispose());
+            run('material-preview', () => disposeMaterialPreview());
             run('asset-preview-modal', () => assetPreviewModal.remove());
+            run('project-file-preview-modal', () => projectFilePreviewModal.remove());
+            run('project-file-preview-search-frame', () => {
+                if (projectFilePreviewSearchRaf != null) {
+                    doc.defaultView?.cancelAnimationFrame(projectFilePreviewSearchRaf);
+                    projectFilePreviewSearchRaf = null;
+                }
+            });
             run('asset-picker-modal', () => assetPickerModal.remove());
             run('hierarchy-controller', () => hierarchyController.dispose());
+            run('editor-console', () => editorConsole.dispose());
             run('workbench-layout-controller', () => workbenchLayoutController.dispose());
             run('tooltip-controller', () => tooltipController.dispose());
             run('context-menu', () => contextMenu.dispose());
@@ -6393,12 +7492,20 @@ function createLocalEditorBrowserUiImplementation(options, construction) {
             run('input-router', () => inputRouter.dispose());
             run('document-keydown', () => doc.removeEventListener('keydown', onKeyDown));
             run('owned-root-children', () => construction.removeMountedRootChildren());
+            projectModelPreviewCleanupRegistry.disposeOwned();
+            materialPreviewCleanupRegistry.disposeOwned();
+            const retainedPreviewCleanups = [
+                ...projectModelPreviewCleanupRegistry.takeFailures(),
+                ...materialPreviewCleanupRegistry.takeFailures(),
+            ];
+            errors.push(...retainedPreviewCleanups);
             if (errors.length > 0) {
                 const error = new Error('Local Editor browser UI cleanup failed.');
                 error.errors = errors;
                 throw error;
             }
-            uiDisposed = true;
+            uiDisposed = !projectModelPreviewCleanupRegistry.hasOwned()
+                && !materialPreviewCleanupRegistry.hasOwned();
         },
     };
 }