Track and release preview scene resources

This commit is contained in:
eust-w 2026-06-25 01:22:32 +08:00
parent b6a4b505a0
commit c8052012b4
5 changed files with 138 additions and 20 deletions

View File

@ -136,6 +136,9 @@ The product acceptance gate must pass with zero failures. It checks:
passing as real collision physics.
- Runtime diagnostics panel with manifest, state, control, latency, binding, and
asset health evidence.
- Runtime resource-lifecycle diagnostics, proving scene switches release old
geometries, materials, and textures instead of accumulating stale GPU
resources.
- Nonblank WebGL rendering.
- Expected object, mesh, and body binding counts.
- Product-owned acceptance telemetry in the diagnostics panel.
@ -196,7 +199,7 @@ evidence to a code state:
Representative product gate baseline for the current thresholds:
- Result: `42 passed / 0 warned / 0 failed`
- Result: `43 passed / 0 warned / 0 failed`
- Frontend mode: `preview` for release handoff through
`npm run product:release-check`.
- Fail on warning: `true` for release handoff.
@ -307,31 +310,33 @@ Scene evidence:
Bundle evidence:
- JavaScript chunks: `4`
- App entry chunk: `173.17 kB raw / 45.26 KiB gzip`
- App entry chunk: `174.93 kB raw / 45.75 KiB gzip`
- Largest JavaScript gzip chunk: `141.04 KiB / 170.00 KiB`
- Total JavaScript gzip: `209.10 KiB / 230.00 KiB`
- Total JavaScript gzip: `209.58 KiB / 230.00 KiB`
- Large-scene performance mode: `large-scene`, target `45 fps`,
actual idle render rate `0.8 fps`, DPR cap observed at `1.00` in release
gate, shadows `off`, hover picking throttled to `32ms`, `304` empty frames
gate, shadows `off`, hover picking throttled to `32ms`, `301` empty frames
skipped, `1839` static visual nodes frozen, and `7` primitive geometry shapes
cached.
- Resource lifecycle on a real Scene Builder compose switch: released `52`
geometries, `27` materials, and `17` textures from the replaced scene graph.
Control evidence:
- Compose endpoint: `273ms`, `4/4` composed object bodies synced.
- Scene Builder UI compose: representative run `4067ms` end to end with real
- Compose endpoint: `269ms`, `4/4` composed object bodies synced.
- Scene Builder UI compose: representative run `4206ms` end to end with real
backend diagnostics.
- Composed object body edit: `59ms`.
- Fixed inventory edit rejection: `62ms`.
- Composed object body edit: `53ms`.
- Fixed inventory edit rejection: `57ms`.
- Dynamic composed object drop: `0.48012m`.
- Static shelf anchor stability: `max drift 0.00000m` after a 2500 ms resume
window.
- Resume backend state: `226ms paused=false`
- Resume visible UI state: `58ms`
- Pause backend state: `49ms paused=true`
- Pause visible UI state: `40ms`
- Desktop acceptance wait: `5ms` total, product telemetry `0ms`
- Mobile acceptance wait: `358ms` total, product telemetry `0ms`
- Resume backend state: `59ms paused=false`
- Resume visible UI state: `46ms`
- Pause backend state: `235ms paused=true`
- Pause visible UI state: `52ms`
- Desktop acceptance wait: `2ms` total, product telemetry `0ms`
- Mobile acceptance wait: `429ms` total, product telemetry `2ms`
- Runtime diagnostics panel:
`state=http://127.0.0.1:18090/state`,
`control=http://127.0.0.1:18090/control`,
@ -339,7 +344,7 @@ Control evidence:
`acceptanceLatency=0 ms / 11-0-0`,
`binding=635/636; 4/568`,
`builderPhysics=已添加物体 4: 后端动态 4 / 仅视觉 0`,
`renderPerformance=large-scene; target 45 fps; actual 0.8 fps; dpr 1.00; shadows off; skipped 304; hover 32ms; frozen 1839; primitive geometries 7`.
`renderPerformance=large-scene; target 45 fps; actual 0.8 fps; dpr 1.00; shadows off; skipped 301; hover 32ms; frozen 1839; primitive geometries 7; released 0g/0m/0t`.
- Evidence screenshot artifacts:
`builder page; share page; import page; visual-only boundary canvas; desktop canvas; mobile canvas`
- Evidence export artifacts:

View File

@ -629,6 +629,9 @@ async function readBrowserStats(page) {
hoverPickIntervalMs: numberData("hoverPickIntervalMs"),
frozenStaticObjectCount: numberData("frozenStaticObjectCount"),
primitiveGeometryCount: numberData("primitiveGeometryCount"),
releasedGeometryCount: numberData("releasedGeometryCount"),
releasedMaterialCount: numberData("releasedMaterialCount"),
releasedTextureCount: numberData("releasedTextureCount"),
},
diagnostics: {
manifestUrl: text("#diag-manifest-url"),
@ -1004,6 +1007,7 @@ async function runBuilderPhysicalCompose(page) {
builderStatus: stats.builderStatus,
summaryProps: stats.summaryProps,
physics: stats.physics,
renderPerformance: stats.renderPerformance,
diagnostics: stats.diagnostics,
viewport: stats.canvas
? {
@ -1515,7 +1519,16 @@ async function verifyBrowser() {
&& (renderPerformance.frozenStaticObjectCount ?? 0) >= 500
&& (renderPerformance.primitiveGeometryCount ?? 0) > 0
&& desktopStats.diagnostics.renderPerformance.includes("large-scene"),
`mode=${renderPerformance.largeSceneMode} fps=${renderPerformance.targetRenderFps ?? "-"} dpr=${renderPerformance.renderPixelRatio ?? "-"} shadows=${renderPerformance.shadowsEnabled} hover=${renderPerformance.hoverPickIntervalMs ?? "-"} skipped=${renderPerformance.renderSkipCount ?? "-"} frozen=${renderPerformance.frozenStaticObjectCount ?? "-"} primitiveGeometries=${renderPerformance.primitiveGeometryCount ?? "-"}; ${desktopStats.diagnostics.renderPerformance}`,
`mode=${renderPerformance.largeSceneMode} fps=${renderPerformance.targetRenderFps ?? "-"} dpr=${renderPerformance.renderPixelRatio ?? "-"} shadows=${renderPerformance.shadowsEnabled} hover=${renderPerformance.hoverPickIntervalMs ?? "-"} skipped=${renderPerformance.renderSkipCount ?? "-"} frozen=${renderPerformance.frozenStaticObjectCount ?? "-"} primitiveGeometries=${renderPerformance.primitiveGeometryCount ?? "-"} released=${renderPerformance.releasedGeometryCount ?? "-"}g/${renderPerformance.releasedMaterialCount ?? "-"}m/${renderPerformance.releasedTextureCount ?? "-"}t; ${desktopStats.diagnostics.renderPerformance}`,
);
const builderRelease = builderCompose.renderPerformance ?? {};
check(
"browser-resource-lifecycle",
(builderRelease.releasedGeometryCount ?? 0) > 0
&& (builderRelease.releasedMaterialCount ?? 0) > 0
&& (builderRelease.releasedTextureCount ?? 0) > 0
&& builderCompose.diagnostics.renderPerformance.includes("released"),
`released=${builderRelease.releasedGeometryCount ?? "-"}g/${builderRelease.releasedMaterialCount ?? "-"}m/${builderRelease.releasedTextureCount ?? "-"}t; ${builderCompose.diagnostics.renderPerformance}`,
);
check(
"browser-builder-compose-ui",

View File

@ -169,6 +169,9 @@ interface RuntimeDiagnostics {
hoverPickIntervalMs: number;
frozenStaticObjectCount: number;
primitiveGeometryCount: number;
releasedGeometryCount: number;
releasedMaterialCount: number;
releasedTextureCount: number;
editableGroups: number;
groupedObjects: number;
meshes: number;
@ -2412,6 +2415,9 @@ function currentRuntimeDiagnostics(): RuntimeDiagnostics {
hoverPickIntervalMs: stats.hoverPickIntervalMs,
frozenStaticObjectCount: stats.frozenStaticObjectCount,
primitiveGeometryCount: stats.primitiveGeometryCount,
releasedGeometryCount: stats.releasedGeometryCount,
releasedMaterialCount: stats.releasedMaterialCount,
releasedTextureCount: stats.releasedTextureCount,
editableGroups: stats.editableGroupCount,
groupedObjects: stats.groupedObjectCount,
meshes: stats.loadedMeshCount,
@ -2470,7 +2476,7 @@ function currentDiagnosticsReport(): string {
function renderPerformanceLabel(stats: RuntimeDiagnostics["stats"]): string {
const mode = stats.largeSceneMode ? "large-scene" : "standard";
const shadows = stats.shadowsEnabled ? "shadows on" : "shadows off";
return `${mode}; target ${stats.targetRenderFps} fps; actual ${stats.actualRenderFps.toFixed(1)} fps; dpr ${stats.renderPixelRatio.toFixed(2)}; ${shadows}; skipped ${stats.renderSkipCount}; hover ${stats.hoverPickIntervalMs}ms; frozen ${stats.frozenStaticObjectCount}; primitive geometries ${stats.primitiveGeometryCount}`;
return `${mode}; target ${stats.targetRenderFps} fps; actual ${stats.actualRenderFps.toFixed(1)} fps; dpr ${stats.renderPixelRatio.toFixed(2)}; ${shadows}; skipped ${stats.renderSkipCount}; hover ${stats.hoverPickIntervalMs}ms; frozen ${stats.frozenStaticObjectCount}; primitive geometries ${stats.primitiveGeometryCount}; released ${stats.releasedGeometryCount}g/${stats.releasedMaterialCount}m/${stats.releasedTextureCount}t`;
}
function renderDiagnosticsPanel(): void {
@ -2495,6 +2501,9 @@ function renderDiagnosticsPanel(): void {
data.hoverPickIntervalMs = String(diagnostics.stats.hoverPickIntervalMs);
data.frozenStaticObjectCount = String(diagnostics.stats.frozenStaticObjectCount);
data.primitiveGeometryCount = String(diagnostics.stats.primitiveGeometryCount);
data.releasedGeometryCount = String(diagnostics.stats.releasedGeometryCount);
data.releasedMaterialCount = String(diagnostics.stats.releasedMaterialCount);
data.releasedTextureCount = String(diagnostics.stats.releasedTextureCount);
setText("#diag-manifest-url", diagnostics.manifestUrl);
setText("#diag-state-url", endpointLabel(diagnostics.stateUrl));
setText("#diag-control-url", endpointLabel(diagnostics.controlUrl));

View File

@ -128,6 +128,9 @@ export class UniversalPreviewer {
private renderWindowFrameCount = 0;
private measuredRenderFps = 0;
private frozenStaticObjectCount = 0;
private releasedGeometryCount = 0;
private releasedMaterialCount = 0;
private releasedTextureCount = 0;
private loadedMeshCount = 0;
private fallbackCount = 0;
private lastPixelSampleAt = 0;
@ -330,6 +333,9 @@ export class UniversalPreviewer {
hoverPickIntervalMs: this.hoverPickIntervalMs,
frozenStaticObjectCount: this.frozenStaticObjectCount,
primitiveGeometryCount: this.primitiveGeometryCache.size,
releasedGeometryCount: this.releasedGeometryCount,
releasedMaterialCount: this.releasedMaterialCount,
releasedTextureCount: this.releasedTextureCount,
loadedMeshCount: this.loadedMeshCount,
fallbackCount: this.fallbackCount,
editableGroupCount: this.editableGroups.size,
@ -789,6 +795,7 @@ export class UniversalPreviewer {
}
private clearScene(): void {
this.disposeSceneGraphResources(this.root);
this.root.clear();
this.disposeMaterials();
this.meshCache.clear();
@ -820,15 +827,96 @@ export class UniversalPreviewer {
this.markRenderDirty();
}
private disposeSceneGraphResources(root: THREE.Object3D): void {
const cachedPrimitiveGeometries = new Set(this.primitiveGeometryCache.values());
const ownedMaterials = new Set(this.materials.values());
const disposedGeometries = new Set<THREE.BufferGeometry>();
const disposedMaterials = new Set<THREE.Material>();
const disposedTextures = new Set<THREE.Texture>();
root.traverse((child) => {
const renderable = child as THREE.Object3D & {
geometry?: THREE.BufferGeometry;
material?: THREE.Material | THREE.Material[];
};
const geometry = renderable.geometry;
if (geometry instanceof THREE.BufferGeometry && !cachedPrimitiveGeometries.has(geometry) && !disposedGeometries.has(geometry)) {
geometry.dispose();
disposedGeometries.add(geometry);
this.releasedGeometryCount += 1;
}
if (!renderable.material) {
return;
}
for (const material of this.materialList(renderable.material)) {
if (!ownedMaterials.has(material) && !disposedMaterials.has(material)) {
this.disposeMaterial(material, disposedTextures);
disposedMaterials.add(material);
}
}
});
}
private disposeMaterials(): void {
const disposedTextures = new Set<THREE.Texture>();
for (const material of this.materials.values()) {
const mapped = material as THREE.MeshStandardMaterial;
mapped.map?.dispose();
material.dispose();
this.disposeMaterial(material, disposedTextures);
}
this.materials.clear();
}
private disposeMaterial(material: THREE.Material, disposedTextures: Set<THREE.Texture>): void {
for (const texture of this.materialTextures(material)) {
if (!disposedTextures.has(texture)) {
texture.dispose();
disposedTextures.add(texture);
this.releasedTextureCount += 1;
}
}
material.dispose();
this.releasedMaterialCount += 1;
}
private materialList(material: THREE.Material | THREE.Material[]): THREE.Material[] {
return Array.isArray(material) ? material : [material];
}
private materialTextures(material: THREE.Material): THREE.Texture[] {
const textureKeys = [
"alphaMap",
"aoMap",
"bumpMap",
"clearcoatMap",
"clearcoatNormalMap",
"clearcoatRoughnessMap",
"displacementMap",
"emissiveMap",
"envMap",
"iridescenceMap",
"iridescenceThicknessMap",
"lightMap",
"map",
"metalnessMap",
"normalMap",
"roughnessMap",
"sheenColorMap",
"sheenRoughnessMap",
"specularColorMap",
"specularIntensityMap",
"specularMap",
"thicknessMap",
"transmissionMap",
] as const;
const textures: THREE.Texture[] = [];
const fields = material as unknown as Record<string, unknown>;
for (const key of textureKeys) {
const value = fields[key];
if (value instanceof THREE.Texture) {
textures.push(value);
}
}
return textures;
}
private isRobotManifestObject(id: string): boolean {
if (!this.dragOptions.robotPrefix) {
return false;

View File

@ -197,6 +197,9 @@ export interface RendererStats {
hoverPickIntervalMs: number;
frozenStaticObjectCount: number;
primitiveGeometryCount: number;
releasedGeometryCount: number;
releasedMaterialCount: number;
releasedTextureCount: number;
loadedMeshCount: number;
fallbackCount: number;
editableGroupCount: number;