@dreamerbird/camera-studio 0.0.0-stage → 0.1.0

package/dist/assetLibrary/exportGLB.js

@@ -0,0 +1,83 @@
+import { Bone, Group } from 'three';
+import { GLTFExporter } from 'three-stdlib';
+import { compressGLBDraco } from './draco';
+/**
+ * 移除无法导出的贴图(image 数据缺失)。
+ * FBX 常引用本机不存在的外部贴图文件,加载失败后留下 image 为空的 Texture,
+ * GLTFExporter 遇到会直接抛错("No valid image data found")拖垮整个导入。
+ * 剥掉这些贴图后以灰模/部分贴图入库,不阻塞导入(P1 设计既定取舍)。
+ * 返回移除数量,供调用方告警。
+ */
+export function stripInvalidTextures(root) {
+    let stripped = 0;
+    root.traverse((obj) => {
+        if (!obj.isMesh)
+            return;
+        const { material } = obj;
+        const materials = Array.isArray(material) ? material : [material];
+        for (const mat of materials) {
+            if (!mat)
+                continue;
+            for (const [key, value] of Object.entries(mat)) {
+                const tex = value;
+                if (!tex?.isTexture)
+                    continue;
+                // 与 GLTFExporter.processImage 可处理的形态对齐:
+                // ImageData 类(带 data)或可绘制类(带宽高的 image/canvas/bitmap)
+                const img = tex.image;
+                const valid = img != null &&
+                    (img.data !== undefined ||
+                        ((img.width ?? 0) > 0 && (img.height ?? 0) > 0));
+                if (!valid) {
+                    ;
+                    mat[key] = null;
+                    stripped++;
+                }
+            }
+        }
+    });
+    return stripped;
+}
+/**
+ * 克隆纯骨骼层级(容器名 AnimationRig):动画轨道按骨骼名寻址,
+ * 纯动画 GLB 只需要这棵带名字的骨骼树,网格一律剔除。
+ */
+export function cloneBoneTree(root) {
+    const container = new Group();
+    container.name = 'AnimationRig';
+    const cloneBone = (bone) => {
+        const copy = new Bone();
+        copy.name = bone.name;
+        copy.position.copy(bone.position);
+        copy.quaternion.copy(bone.quaternion);
+        copy.scale.copy(bone.scale);
+        for (const child of bone.children) {
+            if (child.isBone)
+                copy.add(cloneBone(child));
+        }
+        return copy;
+    };
+    root.traverse((obj) => {
+        if (obj.isBone && !obj.parent?.isBone) {
+            container.add(cloneBone(obj));
+        }
+    });
+    return container;
+}
+function exportGLB(root, animations) {
+    return new Promise((resolve, reject) => {
+        new GLTFExporter().parse(root, (result) => resolve(result), (err) => reject(err), { binary: true, animations });
+    });
+}
+/** 模型入库:剥掉动画,只留网格+骨架+绑定姿势;几何走 Draco 压缩 */
+export function exportModelGLB(root) {
+    const stripped = stripInvalidTextures(root);
+    if (stripped > 0) {
+        console.warn(`[assetLibrary] ${stripped} 张贴图数据无效(源文件引用的贴图缺失或加载失败),已移除后继续导出,模型将以灰模/部分贴图入库`);
+    }
+    return exportGLB(root, []).then(compressGLBDraco);
+}
+/** 动作入库:骨骼树克隆 + 单条动画,不含网格 */
+export function exportAnimationGLB(root, clip) {
+    return exportGLB(cloneBoneTree(root), [clip]);
+}

package/dist/assetLibrary/exportGLB.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=exportGLB.test.d.ts.map

package/dist/assetLibrary/exportGLB.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportGLB.test.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/exportGLB.test.ts"],"names":[],"mappings":""}

package/dist/assetLibrary/exportGLB.test.js

@@ -0,0 +1,73 @@
+import { Bone, BoxGeometry, Group, Mesh, MeshBasicMaterial, MeshStandardMaterial, Texture, } from 'three';
+import { cloneBoneTree, exportModelGLB, stripInvalidTextures } from './exportGLB';
+describe('cloneBoneTree', () => {
+    it('只保留骨骼节点(名字/变换),剔除网格', () => {
+        const root = new Group();
+        const hips = new Bone();
+        hips.name = 'Hips';
+        hips.position.set(0, 1, 0);
+        const spine = new Bone();
+        spine.name = 'Spine';
+        hips.add(spine);
+        const prop = new Mesh(new BoxGeometry(), new MeshBasicMaterial());
+        prop.name = 'SwordMesh';
+        spine.add(prop); // 挂在骨骼上的网格不应进动画 GLB
+        root.add(hips);
+        root.add(new Mesh(new BoxGeometry(), new MeshBasicMaterial()));
+        const clone = cloneBoneTree(root);
+        const names = [];
+        clone.traverse((o) => names.push(`${o.name}:${o.type}`));
+        expect(names).toEqual(['AnimationRig:Group', 'Hips:Bone', 'Spine:Bone']);
+        const hipsClone = clone.children[0];
+        expect(hipsClone.position.y).toBe(1);
+        expect(hipsClone).not.toBe(hips); // 是克隆不是引用
+    });
+    it('多根骨骼并列保留', () => {
+        const root = new Group();
+        for (const name of ['L', 'R']) {
+            const b = new Bone();
+            b.name = name;
+            root.add(b);
+        }
+        expect(cloneBoneTree(root).children.map((c) => c.name)).toEqual(['L', 'R']);
+    });
+});
+describe('stripInvalidTextures', () => {
+    it('image 缺失的贴图被移除,有效贴图保留', () => {
+        const root = new Group();
+        const mat = new MeshStandardMaterial();
+        mat.map = new Texture(); // image === null:FBX 引用外部贴图加载失败后的状态
+        mat.normalMap = new Texture();
+        // ImageData 类(带 data + 宽高)是 GLTFExporter 可处理的有效形态
+        const validTex = new Texture({
+            data: new Uint8Array(4),
+            width: 1,
+            height: 1,
+        });
+        mat.emissiveMap = validTex;
+        root.add(new Mesh(new BoxGeometry(), mat));
+        expect(stripInvalidTextures(root)).toBe(2);
+        expect(mat.map).toBeNull();
+        expect(mat.normalMap).toBeNull();
+        expect(mat.emissiveMap).toBe(validTex);
+    });
+    it('多材质数组逐个检查', () => {
+        const root = new Group();
+        const bad = new MeshStandardMaterial({ map: new Texture() });
+        const good = new MeshBasicMaterial();
+        root.add(new Mesh(new BoxGeometry(), [bad, good]));
+        expect(stripInvalidTextures(root)).toBe(1);
+        expect(bad.map).toBeNull();
+    });
+});
+describe('exportModelGLB', () => {
+    it('贴图无效时剥掉后照常导出(不再抛错拖垮导入)', async () => {
+        const root = new Group();
+        const mat = new MeshStandardMaterial();
+        mat.map = new Texture(); // 修复前:GLTFExporter 抛 "No valid image data found"
+        root.add(new Mesh(new BoxGeometry(), mat));
+        const glb = await exportModelGLB(root);
+        expect(glb.byteLength).toBeGreaterThan(0);
+        expect(mat.map).toBeNull();
+    });
+});

package/dist/assetLibrary/gltfLoader.d.ts

@@ -0,0 +1,8 @@
+import { GLTFLoader } from 'three-stdlib';
+/**
+ * 统一创建 GLTFLoader:接 Draco 解码(解码器文件在 public/draco,
+ * 从 three 原样拷贝)。未压缩的 GLB 走原路径,不受影响;
+ * DRACOLoader 全局一个,解码 wasm 只加载一次。
+ */
+export declare function createGLTFLoader(): GLTFLoader;
+//# sourceMappingURL=gltfLoader.d.ts.map

package/dist/assetLibrary/gltfLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltfLoader.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/gltfLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,UAAU,EAAC,MAAM,cAAc,CAAA;AAIpD;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAG7C"}

package/dist/assetLibrary/gltfLoader.js

@@ -0,0 +1,11 @@
+import { DRACOLoader, GLTFLoader } from 'three-stdlib';
+let dracoLoader;
+/**
+ * 统一创建 GLTFLoader:接 Draco 解码(解码器文件在 public/draco,
+ * 从 three 原样拷贝)。未压缩的 GLB 走原路径,不受影响;
+ * DRACOLoader 全局一个,解码 wasm 只加载一次。
+ */
+export function createGLTFLoader() {
+    dracoLoader ?? (dracoLoader = new DRACOLoader().setDecoderPath('/draco/'));
+    return new GLTFLoader().setDRACOLoader(dracoLoader);
+}

package/dist/assetLibrary/hash.d.ts

@@ -0,0 +1,7 @@
+/**
+ * FNV-1a 64 位哈希:非加密,只用于内容去重和骨架族 id。
+ * 同步、无依赖,浏览器和 jest 都能跑。
+ */
+export declare function hashBytes(data: Uint8Array): string;
+export declare function hashString(s: string): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/assetLibrary/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/hash.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CASlD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C"}

package/dist/assetLibrary/hash.js

@@ -0,0 +1,17 @@
+/**
+ * FNV-1a 64 位哈希:非加密,只用于内容去重和骨架族 id。
+ * 同步、无依赖,浏览器和 jest 都能跑。
+ */
+export function hashBytes(data) {
+    let h = 0xcbf29ce484222325n;
+    const prime = 0x100000001b3n;
+    const mask = 0xffffffffffffffffn;
+    for (let i = 0; i < data.length; i++) {
+        h ^= BigInt(data[i]);
+        h = (h * prime) & mask;
+    }
+    return h.toString(16).padStart(16, '0');
+}
+export function hashString(s) {
+    return hashBytes(new TextEncoder().encode(s));
+}

package/dist/assetLibrary/importModelFile.d.ts

@@ -0,0 +1,5 @@
+import type { ImportDeps } from './importPipeline';
+import type { Library } from './library';
+import type { ModelEntry } from './types';
+export declare function importModelFile(file: File, library?: Library, deps?: ImportDeps): Promise<ModelEntry>;
+//# sourceMappingURL=importModelFile.d.ts.map

package/dist/assetLibrary/importModelFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importModelFile.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/importModelFile.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAA;AAEhD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AACtC,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,SAAS,CAAA;AAEvC,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,OAAsB,EAC/B,IAAI,GAAE,UAA6B,GAClC,OAAO,CAAC,UAAU,CAAC,CAerB"}

package/dist/assetLibrary/importModelFile.js

@@ -0,0 +1,19 @@
+/**
+ * 宿主外部模型入库:File → 既有导入管线(planImport/executeImport)。
+ * 放置管线只认库条目(按 id 解析 blob),外部模型必须真实入库,
+ * 姿势/骨架匹配/持久化全部照常。library/deps 可注入(测试用)。
+ */
+import { planImport, executeImport, realImportDeps } from './importPipeline';
+import { getLibrary } from './library';
+export async function importModelFile(file, library = getLibrary(), deps = realImportDeps()) {
+    const before = new Set((await library.listEntries('model')).map((e) => e.id));
+    const plan = await planImport([file], library, deps);
+    // 宿主场景无"相似条目"交互,一律保留为新条目
+    await executeImport(plan, plan.similar.map(() => 'keep'), library);
+    const models = await library.listEntries('model');
+    const created = models.find((m) => !before.has(m.id));
+    if (!created || created.kind !== 'model') {
+        throw new Error('[hostFlows] 模型导入失败:未找到新建条目');
+    }
+    return created;
+}

package/dist/assetLibrary/importModelFile.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=importModelFile.test.d.ts.map

package/dist/assetLibrary/importModelFile.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importModelFile.test.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/importModelFile.test.ts"],"names":[],"mappings":""}

package/dist/assetLibrary/importModelFile.test.js

@@ -0,0 +1,77 @@
+/**
+ * importModelFile:宿主外部模型入库——planImport + executeImport 复用
+ * 既有导入管线,按 id 差分找回新建条目返回。假 backend/deps 模式同
+ * importPipeline.test.ts。
+ */
+import { importModelFile } from './importModelFile';
+import { Library } from './library';
+import { Group, Bone, Mesh, BoxGeometry, MeshBasicMaterial } from 'three';
+function skinnedModel(...bones) {
+    const root = new Group();
+    for (const name of bones) {
+        const b = new Bone();
+        b.name = name;
+        root.add(b);
+    }
+    root.add(new Mesh(new BoxGeometry(), new MeshBasicMaterial()));
+    return root;
+}
+function depsFor(map) {
+    return {
+        load: async (f) => {
+            const hit = map[f.name];
+            if (!hit)
+                throw new Error('无法解析');
+            return { root: hit.root, animations: [] };
+        },
+        // 不同模型的导出字节必须不同,否则 planImport 的内容哈希去重会把
+        // 第二个模型误判为"已存在"而跳过(真实导出器天然满足)
+        exportModel: async (root) => {
+            const names = [];
+            root.traverse((o) => names.push(o.name));
+            return new TextEncoder().encode('glb:' + names.join('|')).buffer;
+        },
+        exportAnimation: async () => new TextEncoder().encode('anim').buffer,
+    };
+}
+function memoryBackend(existing = []) {
+    const entries = new Map(existing.map((e) => [e.id, e]));
+    return {
+        id: 'mock',
+        listEntries: async (kind) => [...entries.values()].filter((e) => !kind || e.kind === kind),
+        getEntry: async (id) => entries.get(id),
+        putEntry: async (e) => void entries.set(e.id, e),
+        deleteEntry: async (id) => void entries.delete(id),
+        putBlob: async () => 'blob-' + Math.random().toString(36).slice(2),
+        getBlobUrl: async () => 'blob:x',
+        deleteBlob: async () => { },
+        listBlobIds: async () => [],
+        getRigAliases: async () => [],
+        putRigAlias: async () => { },
+    };
+}
+describe('importModelFile', () => {
+    it('导入 FBX 后返回新建的 model 条目', async () => {
+        const backend = memoryBackend();
+        const library = new Library({ sources: [backend] });
+        const deps = depsFor({ 'robot.fbx': { root: skinnedModel('hips') } });
+        const file = new File(['x'], 'robot.fbx');
+        const entry = await importModelFile(file, library, deps);
+        expect(entry.kind).toBe('model');
+        // 条目真实入库:再列一次拿得到
+        const all = await backend.listEntries('model');
+        expect(all.some((e) => e.id === entry.id)).toBe(true);
+    });
+    it('连续导入两个模型,各自返回各自的新条目', async () => {
+        const backend = memoryBackend();
+        const library = new Library({ sources: [backend] });
+        const deps = depsFor({
+            'a.fbx': { root: skinnedModel('hips') },
+            'b.fbx': { root: skinnedModel('spine') },
+        });
+        const first = await importModelFile(new File(['x'], 'a.fbx'), library, deps);
+        const second = await importModelFile(new File(['x'], 'b.fbx'), library, deps);
+        expect(first.id).not.toBe(second.id);
+        expect((await backend.listEntries('model')).length).toBe(2);
+    });
+});

package/dist/assetLibrary/importPipeline.d.ts

@@ -0,0 +1,61 @@
+import type { AnimationClip, Group, Object3D } from 'three';
+import { type TFunction } from '@dreamerbird/studio/i18n';
+import type { Library } from './library';
+import type { PoseEntry } from './types';
+export type LoadedModel = {
+    root: Group;
+    animations: AnimationClip[];
+};
+/** 依赖注入:测试给假实现,UI 给 FBXLoader/GLTFLoader + GLTFExporter 真实现 */
+export type ImportDeps = {
+    load: (file: File) => Promise<LoadedModel>;
+    exportModel: (root: Object3D) => Promise<ArrayBuffer>;
+    exportAnimation: (root: Object3D, clip: AnimationClip) => Promise<ArrayBuffer>;
+};
+export declare const realImportDeps: () => ImportDeps;
+export type ImportItem = {
+    type: 'model';
+    name: string;
+    rig: string;
+    contentHash: string;
+    boneCount: number;
+    vertexCount: number;
+    glb: ArrayBuffer;
+} | {
+    type: 'animation';
+    name: string;
+    rig: string;
+    contentHash: string;
+    duration: number;
+    glb: ArrayBuffer;
+} | {
+    type: 'pose';
+    name: string;
+    rig: string;
+    bones: PoseEntry['bones'];
+} | {
+    type: 'skip';
+    name: string;
+    reason: string;
+};
+/** 哈希不同但同族同结构的模型,入库前要用户选 reuse/keep */
+export type SimilarMatch = {
+    index: number;
+    existingName: string;
+    newName: string;
+};
+export type ImportPlan = {
+    items: ImportItem[];
+    similar: SimilarMatch[];
+    summary: string;
+};
+export declare function baseName(fileName: string): string;
+/**
+ * 识别 + 两层去重,生成导入计划(不落库)。
+ * 第一层:剥动画 GLB 的内容哈希命中 → 跳过模型,仅收新动作;
+ * 第二层:哈希不同但同族 + 顶点/骨骼数相同 → 记入 similar 交给用户。
+ */
+export declare function planImport(files: File[], library: Pick<Library, 'listEntries'>, deps: ImportDeps, tr?: TFunction): Promise<ImportPlan>;
+/** 落库:choices 与 plan.similar 一一对应,'reuse' 丢弃对应 model 项 */
+export declare function executeImport(plan: ImportPlan, choices: Array<'reuse' | 'keep'>, library: Library): Promise<void>;
+//# sourceMappingURL=importPipeline.d.ts.map

package/dist/assetLibrary/importPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importPipeline.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/importPipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAC,MAAM,OAAO,CAAA;AACzD,OAAO,EAAY,KAAK,SAAS,EAAC,MAAM,0BAA0B,CAAA;AAKlE,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AAEtC,OAAO,KAAK,EAA6B,SAAS,EAAC,MAAM,SAAS,CAAA;AAElE,MAAM,MAAM,WAAW,GAAG;IAAC,IAAI,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,aAAa,EAAE,CAAA;CAAC,CAAA;AAEpE,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,WAAW,CAAC,CAAA;IAC1C,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,WAAW,CAAC,CAAA;IACrD,eAAe,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,WAAW,CAAC,CAAA;CAC/E,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,UAIjC,CAAA;AAmCF,MAAM,MAAM,UAAU,GAClB;IACE,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,WAAW,CAAA;CACjB,GACD;IACE,IAAI,EAAE,WAAW,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,EAAE,WAAW,CAAA;CACjB,GACD;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAA;CAAC,GACpE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAAA;AAEhD,uCAAuC;AACvC,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAuBD;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EACrC,IAAI,EAAE,UAAU,EAChB,EAAE,GAAE,SAAqB,GACxB,OAAO,CAAC,UAAU,CAAC,CAsJrB;AAED,0DAA0D;AAC1D,wBAAsB,aAAa,CACjC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,EAChC,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CAgDf"}

package/dist/assetLibrary/importPipeline.js

@@ -0,0 +1,253 @@
+import { translate } from '@dreamerbird/studio/i18n';
+import { classifyModel, validatePoseJson } from './classify';
+import { createGLTFLoader } from './gltfLoader';
+import { exportAnimationGLB, exportModelGLB } from './exportGLB';
+import { hashBytes } from './hash';
+import { collectBoneNames, meshStats, rigIdOf } from './rig';
+export const realImportDeps = () => ({
+    load: defaultLoad,
+    exportModel: exportModelGLB,
+    exportAnimation: exportAnimationGLB,
+});
+async function defaultLoad(file) {
+    const { FBXLoader } = await import('three-stdlib');
+    const { LoadingManager } = await import('three');
+    const url = URL.createObjectURL(file);
+    try {
+        if (/\.glb$|\.gltf$/i.test(file.name)) {
+            const gltf = await createGLTFLoader().loadAsync(url);
+            return { root: gltf.scene, animations: gltf.animations };
+        }
+        // FBX 内嵌贴图走 TextureLoader 异步解码:loadAsync 在解析完成时就返回,
+        // 此时 texture.image 还是空的,直接导出会被当无效贴图剥掉(灰模)。
+        // 用 LoadingManager.onLoad 等全部贴图解码完再交卷;贴图加载失败不
+        // 阻塞(manager 照样 onLoad),无效贴图由导出侧的 strip 兜底
+        return await new Promise((resolve, reject) => {
+            const manager = new LoadingManager();
+            let loaded;
+            manager.onLoad = () => {
+                if (loaded)
+                    resolve(loaded);
+            };
+            new FBXLoader(manager).load(url, (root) => {
+                loaded = { root: root, animations: root.animations };
+            }, undefined, reject);
+        });
+    }
+    finally {
+        URL.revokeObjectURL(url);
+    }
+}
+export function baseName(fileName) {
+    return fileName.replace(/\.[^.]+$/, '').replace(/\.pose$/, '');
+}
+function summarize(items, tr) {
+    const count = (t) => items.filter((i) => i.type === t).length;
+    const parts = [];
+    if (count('model'))
+        parts.push(tr('pg.import.summary.models', { count: count('model') }));
+    if (count('animation'))
+        parts.push(tr('pg.import.summary.animations', { count: count('animation') }));
+    if (count('pose'))
+        parts.push(tr('pg.import.summary.poses', { count: count('pose') }));
+    if (count('skip'))
+        parts.push(tr('pg.import.summary.skips', { count: count('skip') }));
+    return parts.length
+        ? tr('pg.import.summary.prefix') + parts.join(' + ')
+        : tr('pg.import.summary.empty');
+}
+function newId() {
+    return 'lib-' + Math.random().toString(36).slice(2, 10);
+}
+/**
+ * 识别 + 两层去重,生成导入计划(不落库)。
+ * 第一层:剥动画 GLB 的内容哈希命中 → 跳过模型,仅收新动作;
+ * 第二层:哈希不同但同族 + 顶点/骨骼数相同 → 记入 similar 交给用户。
+ */
+export async function planImport(files, library, deps, tr = translate) {
+    const existing = await library.listEntries();
+    const items = [];
+    const similar = [];
+    for (const file of files) {
+        if (file.name.endsWith('.pose.json')) {
+            let parsed = null;
+            try {
+                parsed = validatePoseJson(JSON.parse(await file.text()));
+            }
+            catch {
+                parsed = null;
+            }
+            if (!parsed) {
+                items.push({
+                    type: 'skip',
+                    name: file.name,
+                    reason: tr('pg.import.reason.badPoseJson'),
+                });
+            }
+            else {
+                items.push({
+                    type: 'pose',
+                    name: baseName(file.name),
+                    rig: parsed.rig,
+                    bones: parsed.bones,
+                });
+            }
+            continue;
+        }
+        let loaded;
+        try {
+            loaded = await deps.load(file);
+        }
+        catch {
+            items.push({
+                type: 'skip',
+                name: file.name,
+                reason: tr('pg.import.reason.parseFailed'),
+            });
+            continue;
+        }
+        const cls = classifyModel(loaded.root, loaded.animations);
+        if (cls === 'unusable') {
+            items.push({
+                type: 'skip',
+                name: file.name,
+                reason: tr('pg.import.reason.noContent'),
+            });
+            continue;
+        }
+        const rig = rigIdOf(loaded.root);
+        if (cls !== 'animations-only') {
+            let glb;
+            try {
+                glb = await deps.exportModel(loaded.root);
+            }
+            catch (err) {
+                // 导出失败(贴图无效等)只跳过模型,不拖垮整批导入;
+                // 下面的动作提取照常——Mixamo 类文件常常就是冲着动作来的
+                console.warn('[assetLibrary] 模型导出失败', err);
+                items.push({
+                    type: 'skip',
+                    name: baseName(file.name),
+                    reason: tr('pg.import.reason.modelExportFailed'),
+                });
+            }
+            if (glb) {
+                const contentHash = hashBytes(new Uint8Array(glb));
+                const dup = existing.find((e) => e.kind === 'model' && e.contentHash === contentHash);
+                if (!dup) {
+                    const stats = meshStats(loaded.root);
+                    const boneCount = collectBoneNames(loaded.root).length;
+                    const index = items.push({
+                        type: 'model',
+                        name: baseName(file.name),
+                        rig,
+                        contentHash,
+                        boneCount,
+                        vertexCount: stats.vertexCount,
+                        glb,
+                    }) - 1;
+                    const hit = existing.find((e) => e.kind === 'model' &&
+                        e.rig === rig &&
+                        e.vertexCount === stats.vertexCount &&
+                        e.boneCount === boneCount &&
+                        e.contentHash !== contentHash);
+                    if (hit) {
+                        similar.push({
+                            index,
+                            existingName: hit.name,
+                            newName: baseName(file.name),
+                        });
+                    }
+                }
+                else {
+                    items.push({
+                        type: 'skip',
+                        name: baseName(file.name),
+                        reason: tr('pg.import.reason.modelExists', { name: dup.name }),
+                    });
+                }
+                // dup 命中:模型跳过,下面的动作照常提取
+            }
+        }
+        for (const clip of loaded.animations) {
+            let glb;
+            try {
+                glb = await deps.exportAnimation(loaded.root, clip);
+            }
+            catch (err) {
+                // 单条动作导出失败不影响其它动作
+                console.warn('[assetLibrary] 动作导出失败', err);
+                items.push({
+                    type: 'skip',
+                    name: `${baseName(file.name)}/${clip.name}`,
+                    reason: tr('pg.import.reason.animationExportFailed'),
+                });
+                continue;
+            }
+            const contentHash = hashBytes(new Uint8Array(glb));
+            if (existing.some((e) => e.kind === 'animation' && e.contentHash === contentHash)) {
+                items.push({
+                    type: 'skip',
+                    name: `${baseName(file.name)}/${clip.name}`,
+                    reason: tr('pg.import.reason.animationExists'),
+                });
+                continue;
+            }
+            items.push({
+                type: 'animation',
+                name: clip.name || baseName(file.name),
+                rig,
+                contentHash,
+                duration: clip.duration,
+                glb,
+            });
+        }
+    }
+    return { items, similar, summary: summarize(items, tr) };
+}
+/** 落库:choices 与 plan.similar 一一对应,'reuse' 丢弃对应 model 项 */
+export async function executeImport(plan, choices, library) {
+    const drop = new Set(plan.similar.filter((_, i) => choices[i] === 'reuse').map((s) => s.index));
+    for (let i = 0; i < plan.items.length; i++) {
+        const item = plan.items[i];
+        if (item.type === 'skip')
+            continue;
+        if (item.type === 'model') {
+            if (drop.has(i))
+                continue;
+            await library.putBlobWithEntry(new Blob([item.glb]), (blobId) => ({
+                id: newId(),
+                kind: 'model',
+                name: item.name,
+                rig: item.rig,
+                blobId,
+                contentHash: item.contentHash,
+                boneCount: item.boneCount,
+                vertexCount: item.vertexCount,
+                createdAt: Date.now(),
+            }));
+        }
+        else if (item.type === 'animation') {
+            await library.putBlobWithEntry(new Blob([item.glb]), (blobId) => ({
+                id: newId(),
+                kind: 'animation',
+                name: item.name,
+                rig: item.rig,
+                blobId,
+                contentHash: item.contentHash,
+                duration: item.duration,
+                createdAt: Date.now(),
+            }));
+        }
+        else {
+            await library.putEntry({
+                id: newId(),
+                kind: 'pose',
+                name: item.name,
+                rig: item.rig,
+                bones: item.bones,
+                createdAt: Date.now(),
+            });
+        }
+    }
+}

package/dist/assetLibrary/importPipeline.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=importPipeline.test.d.ts.map

package/dist/assetLibrary/importPipeline.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importPipeline.test.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/importPipeline.test.ts"],"names":[],"mappings":""}