feat(web): finish RE 5000PBR lesson video and fix non-ASCII GLB import
Some checks failed
M6 deployable RC / quick (push) Has been cancelled
M6 deployable RC / chromium (push) Has been cancelled
M6 deployable RC / release (push) Has been cancelled

- Add 11:07 Chinese-narrated lesson video, VTT, poster and 13 chapter screenshots.
- Regenerate 20-render WebGL2 matrix and 15 operation captures on RTX 4060.
- Fix WASM staging for non-ASCII import filenames (猴头.glb); rebuild web_engine.
- Harden lesson video recording pipeline; fix stale lesson-link E2E selector.
- Add RE PBR derived libraries, lesson page, evidence and status report.

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
mes123456
2026-11-12 21:49:24 +08:00
parent a078648297
commit d5dd647881
276 changed files with 9632 additions and 314 deletions

View File

@@ -233,7 +233,7 @@ export interface MeshSummaryIR {
export interface MaterialNodeIR {
id: string;
type: "RGB" | "VALUE" | "MATH" | "MIX" | "MAPPING" | "TEX_COORD" | "UV_MAP" | "BUMP" | "SEPARATE_COLOR" | "OBJECT_INFO" | "PRINCIPLED" | "IMAGE_TEXTURE" | "NORMAL_MAP" | "OUTPUT" | "UNSUPPORTED";
type: "RGB" | "VALUE" | "MATH" | "MIX" | "MAPPING" | "TEX_COORD" | "UV_MAP" | "BUMP" | "SEPARATE_COLOR" | "OBJECT_INFO" | "PRINCIPLED" | "IMAGE_TEXTURE" | "NORMAL_MAP" | "OUTPUT" | "REROUTE" | "FRAME" | "DISPLACEMENT" | "UNSUPPORTED";
name: string;
location?: [number, number];
sockets?: Array<{id:string;name:string;direction:'INPUT'|'OUTPUT';dataType:'VALUE'|'VECTOR'|'COLOR'|'BOOLEAN'|'SHADER'|'UNSUPPORTED';value?:number|boolean|number[];linked:boolean;integer?:boolean;available?:boolean;hidden?:boolean}>;
@@ -263,10 +263,12 @@ export interface MaterialLinkIR {
export interface MaterialTextureBindingIR {
imageId: string;
usage: "BASE_COLOR" | "METALLIC" | "ROUGHNESS" | "EMISSION" | "ALPHA" | "NORMAL" | "BUMP";
usage: "BASE_COLOR" | "METALLIC" | "ROUGHNESS" | "EMISSION" | "ALPHA" | "NORMAL" | "BUMP" | "HEIGHT";
socket?: string;
evaluated?: boolean;
strength?: number;
midlevel?: number;
scale?: number;
uvMap?: string;
}
@@ -286,6 +288,9 @@ export interface MaterialIR {
coatRoughness?: number;
emissionStrength?: number;
normalImageId?: string | null;
displacementImageId?: string | null;
displacementMidlevel?: number;
displacementScale?: number;
imageIds?: string[];
textureBindings?: MaterialTextureBindingIR[];
warnings?: string[];
@@ -1712,6 +1717,9 @@ export function parseSceneSnapshotIR(value: unknown): SceneSnapshotIR {
throw new Error(`SceneIR.materials[${index}].emissionStrength is outside the supported range`);
}
if (material.normalImageId !== undefined && material.normalImageId !== null) requireString(material.normalImageId, `materials[${index}].normalImageId`);
if (material.displacementImageId !== undefined && material.displacementImageId !== null) requireString(material.displacementImageId, `materials[${index}].displacementImageId`);
if (material.displacementMidlevel !== undefined) requireNumber(material.displacementMidlevel, `materials[${index}].displacementMidlevel`);
if (material.displacementScale !== undefined) requireNumber(material.displacementScale, `materials[${index}].displacementScale`);
if (material.imageIds !== undefined && (!Array.isArray(material.imageIds) || material.imageIds.some((item) => typeof item !== "string"))) {
throw new Error(`SceneIR.materials[${index}].imageIds must contain strings`);
}
@@ -1720,11 +1728,13 @@ export function parseSceneSnapshotIR(value: unknown): SceneSnapshotIR {
for (const [bindingIndex, binding] of material.textureBindings.entries()) {
if (!isRecord(binding)) throw new Error(`SceneIR.materials[${index}].textureBindings[${bindingIndex}] must be an object`);
requireString(binding.imageId, `materials[${index}].textureBindings[${bindingIndex}].imageId`);
if (!["BASE_COLOR", "METALLIC", "ROUGHNESS", "EMISSION", "ALPHA", "NORMAL", "BUMP"].includes(binding.usage as string)) throw new Error(`SceneIR.materials[${index}].textureBindings[${bindingIndex}].usage is invalid`);
if (!["BASE_COLOR", "METALLIC", "ROUGHNESS", "EMISSION", "ALPHA", "NORMAL", "BUMP", "HEIGHT"].includes(binding.usage as string)) throw new Error(`SceneIR.materials[${index}].textureBindings[${bindingIndex}].usage is invalid`);
if (binding.socket !== undefined) requireString(binding.socket, `materials[${index}].textureBindings[${bindingIndex}].socket`);
if (binding.uvMap !== undefined) requireString(binding.uvMap, `materials[${index}].textureBindings[${bindingIndex}].uvMap`);
if (binding.evaluated !== undefined && typeof binding.evaluated !== "boolean") throw new Error(`SceneIR.materials[${index}].textureBindings[${bindingIndex}].evaluated is invalid`);
if (binding.strength !== undefined) requireNumber(binding.strength, `materials[${index}].textureBindings[${bindingIndex}].strength`);
if (binding.midlevel !== undefined) requireNumber(binding.midlevel, `materials[${index}].textureBindings[${bindingIndex}].midlevel`);
if (binding.scale !== undefined) requireNumber(binding.scale, `materials[${index}].textureBindings[${bindingIndex}].scale`);
}
}
if (material.warnings !== undefined && (!Array.isArray(material.warnings) || material.warnings.some((item) => typeof item !== "string"))) {
@@ -1736,7 +1746,7 @@ export function parseSceneSnapshotIR(value: unknown): SceneSnapshotIR {
if (!isRecord(node)) throw new Error(`SceneIR.materials[${index}].nodes[${nodeIndex}] must be an object`);
requireString(node.id, `SceneIR.materials[${index}].nodes[${nodeIndex}].id`);
requireString(node.name, `SceneIR.materials[${index}].nodes[${nodeIndex}].name`);
if (!["RGB", "VALUE", "MATH", "MIX", "MAPPING", "TEX_COORD", "UV_MAP", "BUMP", "SEPARATE_COLOR", "OBJECT_INFO", "PRINCIPLED", "IMAGE_TEXTURE", "NORMAL_MAP", "OUTPUT", "UNSUPPORTED"].includes(node.type as string)) throw new Error(`SceneIR.materials[${index}].nodes[${nodeIndex}].type is invalid`);
if (!["RGB", "VALUE", "MATH", "MIX", "MAPPING", "TEX_COORD", "UV_MAP", "BUMP", "SEPARATE_COLOR", "OBJECT_INFO", "PRINCIPLED", "IMAGE_TEXTURE", "NORMAL_MAP", "OUTPUT", "REROUTE", "FRAME", "DISPLACEMENT", "UNSUPPORTED"].includes(node.type as string)) throw new Error(`SceneIR.materials[${index}].nodes[${nodeIndex}].type is invalid`);
if (node.imageId !== undefined && node.imageId !== null) requireString(node.imageId, `SceneIR.materials[${index}].nodes[${nodeIndex}].imageId`);
if (node.defaultValue !== undefined && (!Array.isArray(node.defaultValue) || node.defaultValue.length === 0 || node.defaultValue.length > 4 || node.defaultValue.some((value) => typeof value !== "number" || !Number.isFinite(value)))) throw new Error(`SceneIR.materials[${index}].nodes[${nodeIndex}].defaultValue is invalid`);
if (node.properties !== undefined) {