@dreamerbird/camera-studio 0.0.0-stage → 0.2.0

package/dist/assetLibrary/seedAssetsManifest.js

@@ -0,0 +1,347 @@
+export const seedAssetsManifest = {
+    models: [
+        {
+            key: 'y-bot',
+            file: 'Y Bot.glb',
+            contentHash: 'fc55d96ed9b27445',
+            name: 'Y Bot',
+            rig: 'rig-16a71e249f45355b',
+            boneCount: 117,
+            vertexCount: 165960,
+        },
+    ],
+    poseThumbs: [
+        { key: 'qbx-hands-01-base-base-l', file: 'qbx-hands-01-base-base-l.png' },
+        { key: 'qbx-hands-01-base-base-r', file: 'qbx-hands-01-base-base-r.png' },
+        {
+            key: 'qbx-hands-01-base-point-relaxed-l',
+            file: 'qbx-hands-01-base-point-relaxed-l.png',
+        },
+        {
+            key: 'qbx-hands-01-base-point-relaxed-r',
+            file: 'qbx-hands-01-base-point-relaxed-r.png',
+        },
+        {
+            key: 'qbx-hands-01-base-point-straight-l',
+            file: 'qbx-hands-01-base-point-straight-l.png',
+        },
+        {
+            key: 'qbx-hands-01-base-point-straight-r',
+            file: 'qbx-hands-01-base-point-straight-r.png',
+        },
+        {
+            key: 'qbx-hands-01-base-relaxed-01-l',
+            file: 'qbx-hands-01-base-relaxed-01-l.png',
+        },
+        {
+            key: 'qbx-hands-01-base-relaxed-01-r',
+            file: 'qbx-hands-01-base-relaxed-01-r.png',
+        },
+        {
+            key: 'qbx-hands-01-base-relaxed-02-l',
+            file: 'qbx-hands-01-base-relaxed-02-l.png',
+        },
+        {
+            key: 'qbx-hands-01-base-relaxed-02-r',
+            file: 'qbx-hands-01-base-relaxed-02-r.png',
+        },
+        {
+            key: 'qbx-hands-01-base-relaxed-03-l',
+            file: 'qbx-hands-01-base-relaxed-03-l.png',
+        },
+        {
+            key: 'qbx-hands-01-base-relaxed-03-r',
+            file: 'qbx-hands-01-base-relaxed-03-r.png',
+        },
+        {
+            key: 'qbx-hands-01-base-relaxed-04-l',
+            file: 'qbx-hands-01-base-relaxed-04-l.png',
+        },
+        {
+            key: 'qbx-hands-01-base-relaxed-04-r',
+            file: 'qbx-hands-01-base-relaxed-04-r.png',
+        },
+        {
+            key: 'qbx-hands-01-base-relaxed-05-l',
+            file: 'qbx-hands-01-base-relaxed-05-l.png',
+        },
+        {
+            key: 'qbx-hands-01-base-relaxed-05-r',
+            file: 'qbx-hands-01-base-relaxed-05-r.png',
+        },
+        {
+            key: 'qbx-hands-01-base-relaxed-06-l',
+            file: 'qbx-hands-01-base-relaxed-06-l.png',
+        },
+        {
+            key: 'qbx-hands-01-base-relaxed-06-r',
+            file: 'qbx-hands-01-base-relaxed-06-r.png',
+        },
+        { key: 'qbx-hands-02-other-bowl-l', file: 'qbx-hands-02-other-bowl-l.png' },
+        { key: 'qbx-hands-02-other-bowl-r', file: 'qbx-hands-02-other-bowl-r.png' },
+        { key: 'qbx-hands-02-other-card-l', file: 'qbx-hands-02-other-card-l.png' },
+        { key: 'qbx-hands-02-other-card-r', file: 'qbx-hands-02-other-card-r.png' },
+        { key: 'qbx-hands-02-other-claw-l', file: 'qbx-hands-02-other-claw-l.png' },
+        { key: 'qbx-hands-02-other-claw-r', file: 'qbx-hands-02-other-claw-r.png' },
+        { key: 'qbx-hands-02-other-fist-l', file: 'qbx-hands-02-other-fist-l.png' },
+        { key: 'qbx-hands-02-other-fist-r', file: 'qbx-hands-02-other-fist-r.png' },
+        { key: 'qbx-hands-02-other-grip-l', file: 'qbx-hands-02-other-grip-l.png' },
+        { key: 'qbx-hands-02-other-grip-r', file: 'qbx-hands-02-other-grip-r.png' },
+        { key: 'qbx-hands-02-other-ko-l', file: 'qbx-hands-02-other-ko-l.png' },
+        { key: 'qbx-hands-02-other-ko-r', file: 'qbx-hands-02-other-ko-r.png' },
+        {
+            key: 'qbx-hands-02-other-nail-check-01-l',
+            file: 'qbx-hands-02-other-nail-check-01-l.png',
+        },
+        {
+            key: 'qbx-hands-02-other-nail-check-01-r',
+            file: 'qbx-hands-02-other-nail-check-01-r.png',
+        },
+        {
+            key: 'qbx-hands-02-other-nail-check-02-l',
+            file: 'qbx-hands-02-other-nail-check-02-l.png',
+        },
+        {
+            key: 'qbx-hands-02-other-nail-check-02-r',
+            file: 'qbx-hands-02-other-nail-check-02-r.png',
+        },
+        { key: 'qbx-hands-02-other-offer-l', file: 'qbx-hands-02-other-offer-l.png' },
+        { key: 'qbx-hands-02-other-offer-r', file: 'qbx-hands-02-other-offer-r.png' },
+        { key: 'qbx-hands-02-other-push-l', file: 'qbx-hands-02-other-push-l.png' },
+        { key: 'qbx-hands-02-other-push-r', file: 'qbx-hands-02-other-push-r.png' },
+        {
+            key: 'qbx-hands-02-other-push-the-button-l',
+            file: 'qbx-hands-02-other-push-the-button-l.png',
+        },
+        {
+            key: 'qbx-hands-02-other-push-the-button-r',
+            file: 'qbx-hands-02-other-push-the-button-r.png',
+        },
+        {
+            key: 'qbx-hands-02-other-scratch-l',
+            file: 'qbx-hands-02-other-scratch-l.png',
+        },
+        {
+            key: 'qbx-hands-02-other-scratch-r',
+            file: 'qbx-hands-02-other-scratch-r.png',
+        },
+        {
+            key: 'qbx-hands-02-other-spread-l',
+            file: 'qbx-hands-02-other-spread-l.png',
+        },
+        {
+            key: 'qbx-hands-02-other-spread-r',
+            file: 'qbx-hands-02-other-spread-r.png',
+        },
+        { key: 'qbx-hands-02-other-write-l', file: 'qbx-hands-02-other-write-l.png' },
+        { key: 'qbx-hands-02-other-write-r', file: 'qbx-hands-02-other-write-r.png' },
+        {
+            key: 'qbx-hands-03-signs-cobblepot-l',
+            file: 'qbx-hands-03-signs-cobblepot-l.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-cobblepot-r',
+            file: 'qbx-hands-03-signs-cobblepot-r.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-fingers-crossed-l',
+            file: 'qbx-hands-03-signs-fingers-crossed-l.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-fingers-crossed-r',
+            file: 'qbx-hands-03-signs-fingers-crossed-r.png',
+        },
+        { key: 'qbx-hands-03-signs-five-l', file: 'qbx-hands-03-signs-five-l.png' },
+        { key: 'qbx-hands-03-signs-five-r', file: 'qbx-hands-03-signs-five-r.png' },
+        { key: 'qbx-hands-03-signs-four-l', file: 'qbx-hands-03-signs-four-l.png' },
+        { key: 'qbx-hands-03-signs-four-r', file: 'qbx-hands-03-signs-four-r.png' },
+        {
+            key: 'qbx-hands-03-signs-four-ring-l',
+            file: 'qbx-hands-03-signs-four-ring-l.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-four-ring-r',
+            file: 'qbx-hands-03-signs-four-ring-r.png',
+        },
+        { key: 'qbx-hands-03-signs-fu-l', file: 'qbx-hands-03-signs-fu-l.png' },
+        { key: 'qbx-hands-03-signs-fu-r', file: 'qbx-hands-03-signs-fu-r.png' },
+        { key: 'qbx-hands-03-signs-index-l', file: 'qbx-hands-03-signs-index-l.png' },
+        { key: 'qbx-hands-03-signs-index-r', file: 'qbx-hands-03-signs-index-r.png' },
+        {
+            key: 'qbx-hands-03-signs-martian-reactor-switch-l',
+            file: 'qbx-hands-03-signs-martian-reactor-switch-l.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-martian-reactor-switch-r',
+            file: 'qbx-hands-03-signs-martian-reactor-switch-r.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-one-does-not-simply-l',
+            file: 'qbx-hands-03-signs-one-does-not-simply-l.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-one-does-not-simply-r',
+            file: 'qbx-hands-03-signs-one-does-not-simply-r.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-peace-flipped-r',
+            file: 'qbx-hands-03-signs-peace-flipped-r.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-peace-flipped',
+            file: 'qbx-hands-03-signs-peace-flipped.png',
+        },
+        { key: 'qbx-hands-03-signs-peace-l', file: 'qbx-hands-03-signs-peace-l.png' },
+        { key: 'qbx-hands-03-signs-peace-r', file: 'qbx-hands-03-signs-peace-r.png' },
+        {
+            key: 'qbx-hands-03-signs-perfect-l',
+            file: 'qbx-hands-03-signs-perfect-l.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-perfect-r',
+            file: 'qbx-hands-03-signs-perfect-r.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-pinky-swear-l',
+            file: 'qbx-hands-03-signs-pinky-swear-l.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-pinky-swear-r',
+            file: 'qbx-hands-03-signs-pinky-swear-r.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-rock-out-l',
+            file: 'qbx-hands-03-signs-rock-out-l.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-rock-out-r',
+            file: 'qbx-hands-03-signs-rock-out-r.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-scout-salute-l',
+            file: 'qbx-hands-03-signs-scout-salute-l.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-scout-salute-r',
+            file: 'qbx-hands-03-signs-scout-salute-r.png',
+        },
+        { key: 'qbx-hands-03-signs-spock-l', file: 'qbx-hands-03-signs-spock-l.png' },
+        { key: 'qbx-hands-03-signs-spock-r', file: 'qbx-hands-03-signs-spock-r.png' },
+        { key: 'qbx-hands-03-signs-stop-l', file: 'qbx-hands-03-signs-stop-l.png' },
+        { key: 'qbx-hands-03-signs-stop-r', file: 'qbx-hands-03-signs-stop-r.png' },
+        {
+            key: 'qbx-hands-03-signs-surf-s-up-flipped-l',
+            file: 'qbx-hands-03-signs-surf-s-up-flipped-l.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-surf-s-up-flipped-r',
+            file: 'qbx-hands-03-signs-surf-s-up-flipped-r.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-surf-s-up-l',
+            file: 'qbx-hands-03-signs-surf-s-up-l.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-surf-s-up-r',
+            file: 'qbx-hands-03-signs-surf-s-up-r.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-three-hicox-l',
+            file: 'qbx-hands-03-signs-three-hicox-l.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-three-hicox-r',
+            file: 'qbx-hands-03-signs-three-hicox-r.png',
+        },
+        { key: 'qbx-hands-03-signs-three-l', file: 'qbx-hands-03-signs-three-l.png' },
+        { key: 'qbx-hands-03-signs-three-r', file: 'qbx-hands-03-signs-three-r.png' },
+        {
+            key: 'qbx-hands-03-signs-three-ring-l',
+            file: 'qbx-hands-03-signs-three-ring-l.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-three-ring-r',
+            file: 'qbx-hands-03-signs-three-ring-r.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-thumbs-up-l',
+            file: 'qbx-hands-03-signs-thumbs-up-l.png',
+        },
+        {
+            key: 'qbx-hands-03-signs-thumbs-up-r',
+            file: 'qbx-hands-03-signs-thumbs-up-r.png',
+        },
+        {
+            key: 'qbx-hands-04-weapons-detonator-l',
+            file: 'qbx-hands-04-weapons-detonator-l.png',
+        },
+        {
+            key: 'qbx-hands-04-weapons-detonator-r',
+            file: 'qbx-hands-04-weapons-detonator-r.png',
+        },
+        {
+            key: 'qbx-hands-04-weapons-grip-sword-l',
+            file: 'qbx-hands-04-weapons-grip-sword-l.png',
+        },
+        {
+            key: 'qbx-hands-04-weapons-grip-sword-r',
+            file: 'qbx-hands-04-weapons-grip-sword-r.png',
+        },
+        {
+            key: 'qbx-hands-04-weapons-gun-01-l',
+            file: 'qbx-hands-04-weapons-gun-01-l.png',
+        },
+        {
+            key: 'qbx-hands-04-weapons-gun-01-r',
+            file: 'qbx-hands-04-weapons-gun-01-r.png',
+        },
+        {
+            key: 'qbx-hands-04-weapons-gun-02-l',
+            file: 'qbx-hands-04-weapons-gun-02-l.png',
+        },
+        {
+            key: 'qbx-hands-04-weapons-gun-02-r',
+            file: 'qbx-hands-04-weapons-gun-02-r.png',
+        },
+        {
+            key: 'qbx-hands-04-weapons-gun-03-l-cock-the-hammer',
+            file: 'qbx-hands-04-weapons-gun-03-l-cock-the-hammer.png',
+        },
+        {
+            key: 'qbx-hands-04-weapons-gun-03-r-cock-the-hammer',
+            file: 'qbx-hands-04-weapons-gun-03-r-cock-the-hammer.png',
+        },
+        {
+            key: 'qbx-hands-04-weapons-hadoken-l',
+            file: 'qbx-hands-04-weapons-hadoken-l.png',
+        },
+        {
+            key: 'qbx-hands-04-weapons-hadoken-r',
+            file: 'qbx-hands-04-weapons-hadoken-r.png',
+        },
+        {
+            key: 'qbx-hands-04-weapons-pistol-double-l',
+            file: 'qbx-hands-04-weapons-pistol-double-l.png',
+        },
+        {
+            key: 'qbx-hands-04-weapons-pistol-double-r',
+            file: 'qbx-hands-04-weapons-pistol-double-r.png',
+        },
+        {
+            key: 'qbx-hands-04-weapons-pistol-l',
+            file: 'qbx-hands-04-weapons-pistol-l.png',
+        },
+        {
+            key: 'qbx-hands-04-weapons-pistol-r',
+            file: 'qbx-hands-04-weapons-pistol-r.png',
+        },
+        {
+            key: 'qbx-hands-04-weapons-throw-l',
+            file: 'qbx-hands-04-weapons-throw-l.png',
+        },
+        {
+            key: 'qbx-hands-04-weapons-throw-r',
+            file: 'qbx-hands-04-weapons-throw-r.png',
+        },
+    ],
+};

package/dist/assetLibrary/seedBuiltinPoses.d.ts

@@ -0,0 +1,29 @@
+import type { SeedAssetsManifest } from './seedAssetsManifest';
+import type { Library } from './library';
+import type { PoseEntry } from './types';
+/** 内置姿势所属骨架族:清单里族代表模型(Y Bot)的 rig */
+export declare function builtinPoseRig(manifest?: SeedAssetsManifest): string;
+/**
+ * 内置姿势条目清单(不带缩略图):id 稳定(seed-pose-<key>),rig 缺省取
+ * 清单族代表模型的 rig。StaticCatalogSource 与 seedBuiltinPosesInto 共用;
+ * 缩略图由各自调用方按自己的存储语义挂(catalog 静态文件/运行时渲染,
+ * 或播种时拉取入 blob)。
+ */
+export declare function buildBuiltinPoseEntries(rig?: string): PoseEntry[];
+type Lib = Pick<Library, 'listEntries' | 'listBlobIds' | 'putBlob' | 'putEntry'>;
+/**
+ * 播种核心(测试夹具,可注入):返回播种条数,0=未找到族代表模型。
+ * 条目 id 稳定(seed-pose-<key>),putEntry upsert 语义,重复播种安全。
+ *
+ * opts.thumbs:QBX 手势预览图 URL 表(key → url)。条目尚无 thumbnailId
+ * 时拉取 PNG 存 blob 并挂到条目上;已有 thumbnailId 的跳过(内容哈希
+ * 去重,重复播种不会翻倍存储)。拉取/存 blob 失败只告警,姿势本体照播。
+ */
+export declare function seedBuiltinPosesInto(lib: Lib, opts?: {
+    retryMs?: number;
+    maxWaitMs?: number;
+    sleep?: (ms: number) => Promise<void>;
+    thumbs?: Record<string, string>;
+}): Promise<number>;
+export {};
+//# sourceMappingURL=seedBuiltinPoses.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seedBuiltinPoses.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/seedBuiltinPoses.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AACtC,OAAO,KAAK,EAAa,SAAS,EAAC,MAAM,SAAS,CAAA;AAMlD,qCAAqC;AACrC,wBAAgB,cAAc,CAC5B,QAAQ,GAAE,kBAAuC,GAChD,MAAM,CAQR;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,GAAE,MAAyB,GAC7B,SAAS,EAAE,CAYb;AAED,KAAK,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC,CAAA;AAEhF;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,GAAG,EACR,IAAI,GAAE;IACJ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC3B,GACL,OAAO,CAAC,MAAM,CAAC,CAoDjB"}

package/dist/assetLibrary/seedBuiltinPoses.js

@@ -0,0 +1,114 @@
+// packages/camera-studio/src/assetLibrary/seedBuiltinPoses.ts
+/**
+ * 内置姿势条目构建(2026-10-10 内置资产目录化后):三批来源的数据模块
+ *   - seedPoses:12 个程序化基础姿势(blender_dump.py 按方向摆 metarig)
+ *   - seedPosesDpl:58 个 Dynamic Pose Library 姿势(blender_dump_dpl.py
+ *     读 BlendAtlas 免费姿势包 .blend,含手指映射)
+ *   - seedPosesQbx:110 个 QBX 手势(blender_dump_qbx.py 读 QBX 免费姿势包
+ *     的 03_Hands 目录,仅手指骨的叠加片段:基础/其他/手势/持握 × 左右手)
+ *
+ * 去播种后,这些条目不再写入用户库,而是由 StaticCatalogSource 以
+ * 只读目录形式提供;条目 id 保持 seed-pose-<key> 不变(旧场景按 id 引用,
+ * 硬约束)。姿势的 rig 绑清单里族代表模型(Y Bot)的 rig——该值由生成
+ * 脚本用运行时同一 rigIdOf(FBX 解析)算出,用户导入同款 Mixamo 模型
+ * 得到的 rig 与之相等,姿势族匹配不断。
+ *
+ * seedBuiltinPosesInto 保留为测试夹具:把内置姿势写进传入的库(含
+ * 预览图拉取入库逻辑),生产代码不再调用。
+ */
+import { seedPoses } from './seedPoses';
+import { seedPosesDpl } from './seedPosesDpl';
+import { seedPosesQbx } from './seedPosesQbx';
+import { seedAssetsManifest } from './seedAssetsManifest';
+const SEED_RIG_MODEL_NAME = 'Y Bot';
+const MAX_WAIT_MS = 15000;
+const RETRY_MS = 500;
+/** 内置姿势所属骨架族:清单里族代表模型(Y Bot)的 rig */
+export function builtinPoseRig(manifest = seedAssetsManifest) {
+    const rep = manifest.models.find((m) => m.name === SEED_RIG_MODEL_NAME);
+    if (!rep) {
+        throw new Error(`[assetLibrary] 资产清单缺族代表模型:${SEED_RIG_MODEL_NAME}`);
+    }
+    return rep.rig;
+}
+/**
+ * 内置姿势条目清单(不带缩略图):id 稳定(seed-pose-<key>),rig 缺省取
+ * 清单族代表模型的 rig。StaticCatalogSource 与 seedBuiltinPosesInto 共用;
+ * 缩略图由各自调用方按自己的存储语义挂(catalog 静态文件/运行时渲染,
+ * 或播种时拉取入 blob)。
+ */
+export function buildBuiltinPoseEntries(rig = builtinPoseRig()) {
+    const all = [...seedPoses, ...seedPosesDpl, ...seedPosesQbx];
+    return all.map((p) => ({
+        id: 'seed-pose-' + p.key,
+        kind: 'pose',
+        name: p.name,
+        rig,
+        bones: p.bones,
+        // 内置条目 createdAt 恒 0:目录内容静态,时间戳无意义;固定值保证
+        // 清单稳定(每次构建字节一致),排序语义上沉底为「最旧」
+        createdAt: 0,
+    }));
+}
+/**
+ * 播种核心(测试夹具,可注入):返回播种条数,0=未找到族代表模型。
+ * 条目 id 稳定(seed-pose-<key>),putEntry upsert 语义,重复播种安全。
+ *
+ * opts.thumbs:QBX 手势预览图 URL 表(key → url)。条目尚无 thumbnailId
+ * 时拉取 PNG 存 blob 并挂到条目上;已有 thumbnailId 的跳过(内容哈希
+ * 去重,重复播种不会翻倍存储)。拉取/存 blob 失败只告警,姿势本体照播。
+ */
+export async function seedBuiltinPosesInto(lib, opts = {}) {
+    const { retryMs = RETRY_MS, maxWaitMs = MAX_WAIT_MS, thumbs } = opts;
+    const sleep = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+    const deadline = Date.now() + maxWaitMs;
+    let rig;
+    while (Date.now() <= deadline) {
+        const models = (await lib.listEntries('model'));
+        rig = models.find((m) => m.name === SEED_RIG_MODEL_NAME)?.rig;
+        if (rig)
+            break;
+        await sleep(retryMs);
+    }
+    if (!rig) {
+        console.warn(`[assetLibrary] 未找到 ${SEED_RIG_MODEL_NAME} 模型条目,内置姿势跳过播种`);
+        return 0;
+    }
+    // 已播条目的 thumbnailId 先查一轮:补挂只发生在缺失时
+    const existingThumbById = new Map();
+    let existingBlobIds;
+    if (thumbs) {
+        for (const e of (await lib.listEntries('pose'))) {
+            if (e.thumbnailId)
+                existingThumbById.set(e.id, e.thumbnailId);
+        }
+        // 引用了不存在 blob 的条目视为无图(曾被孤儿清扫误删等),触发重补
+        existingBlobIds = new Set(await lib.listBlobIds());
+    }
+    const entries = buildBuiltinPoseEntries(rig);
+    for (const entry of entries) {
+        const key = entry.id.slice('seed-pose-'.length);
+        let thumbnailId = existingThumbById.get(entry.id);
+        if (thumbnailId && existingBlobIds && !existingBlobIds.has(thumbnailId)) {
+            thumbnailId = undefined;
+        }
+        const thumbUrl = thumbs?.[key];
+        if (thumbUrl && !thumbnailId) {
+            try {
+                const res = await fetch(thumbUrl);
+                if (!res.ok)
+                    throw new Error(`HTTP ${res.status}`);
+                thumbnailId = await lib.putBlob(await res.blob());
+            }
+            catch (err) {
+                console.warn(`[assetLibrary] 姿势预览图入库失败: ${key}`, err);
+            }
+        }
+        await lib.putEntry({
+            ...entry,
+            createdAt: Date.now(),
+            ...(thumbnailId ? { thumbnailId } : {}),
+        });
+    }
+    return entries.length;
+}

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

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

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

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

package/dist/assetLibrary/seedBuiltinPoses.test.js

@@ -0,0 +1,176 @@
+// packages/camera-studio/src/assetLibrary/seedBuiltinPoses.test.ts
+import { seedBuiltinPosesInto } from './seedBuiltinPoses';
+import { seedPoses } from './seedPoses';
+import { seedPosesDpl } from './seedPosesDpl';
+import { seedPosesQbx } from './seedPosesQbx';
+const TOTAL = seedPoses.length + seedPosesDpl.length + seedPosesQbx.length;
+function fakeLib(models, existingPoses = [], existingBlobIds = []) {
+    const put = [];
+    const blobs = [];
+    let call = 0;
+    const lib = {
+        listEntries: async (kind) => {
+            if (kind === 'pose')
+                return existingPoses;
+            expect(kind).toBe('model');
+            return models[Math.min(call++, models.length - 1)];
+        },
+        putBlob: async (data) => {
+            const id = 'blob-' + blobs.length;
+            blobs.push(id);
+            return id;
+        },
+        listBlobIds: async () => [...existingBlobIds, ...blobs],
+        putEntry: async (e) => {
+            put.push(e);
+        },
+    };
+    return { lib, put, blobs };
+}
+// sleep 是空操作,真实耗时在事件循环调度上;maxWaitMs 给宽些,避免
+// 全套件并行时 worker 卡顿超过窗口导致轮询测试偶发判 0(2026-10-05 遇到)
+const noSleep = { sleep: async () => { }, retryMs: 1, maxWaitMs: 5000 };
+/** 只给第一个 QBX 手势配图,缩小断言面 */
+const oneThumb = () => ({ [seedPosesQbx[0].key]: '/thumbs/one.png' });
+function stubFetch(ok = true) {
+    const calls = [];
+    const orig = globalThis.fetch;
+    globalThis.fetch = (async (url) => {
+        calls.push(String(url));
+        if (!ok)
+            return { ok: false, status: 404 };
+        return { ok: true, blob: async () => new Blob(['png']) };
+    });
+    return {
+        calls,
+        restore: () => {
+            globalThis.fetch = orig;
+        },
+    };
+}
+describe('seedBuiltinPosesInto', () => {
+    it('Y Bot 在库:按稳定 id 播种全部内置姿势(程序化+DPL+QBX 手势),rig 绑 Y Bot 骨架族', async () => {
+        const { lib, put } = fakeLib([[{ name: 'Y Bot', rig: 'rig-ybot' }]]);
+        const count = await seedBuiltinPosesInto(lib, noSleep);
+        expect(count).toBe(TOTAL);
+        expect(put).toHaveLength(TOTAL);
+        expect(put[0]).toMatchObject({
+            id: 'seed-pose-' + seedPoses[0].key,
+            kind: 'pose',
+            name: seedPoses[0].name,
+            rig: 'rig-ybot',
+        });
+        expect(Object.keys(put[0].kind === 'pose' ? put[0].bones : {})).toContain('mixamorigHips');
+        // QBX 批(末批):最后一个条目是 seedPosesQbx 末位,id/rig 正确且手指骨在覆盖内
+        const last = put[put.length - 1];
+        expect(last).toMatchObject({
+            id: 'seed-pose-' + seedPosesQbx[seedPosesQbx.length - 1].key,
+            kind: 'pose',
+            rig: 'rig-ybot',
+        });
+        expect(Object.keys(last.kind === 'pose' ? last.bones : {})).toContain('mixamorigRightHandThumb1');
+        // QBX 是纯手势片段:只含 30 根手指骨,不含躯干骨
+        expect(Object.keys(last.kind === 'pose' ? last.bones : {})).not.toContain('mixamorigHips');
+        // 重复播种(同 id upsert)不产生异常
+        const again = await seedBuiltinPosesInto(lib, noSleep);
+        expect(again).toBe(TOTAL);
+    });
+    it('Y Bot 迟迟未播种:轮询等到出现后播种', async () => {
+        const { lib, put } = fakeLib([[], [], [{ name: 'Y Bot', rig: 'rig-ybot' }]]);
+        const count = await seedBuiltinPosesInto(lib, noSleep);
+        expect(count).toBe(TOTAL);
+        expect(put.length).toBe(TOTAL);
+    });
+    it('Y Bot 始终不在:返回 0 不写库', async () => {
+        const { lib, put } = fakeLib([[{ name: 'X Bot', rig: 'rig-x' }]]);
+        const count = await seedBuiltinPosesInto(lib, noSleep);
+        expect(count).toBe(0);
+        expect(put).toHaveLength(0);
+    });
+    it('thumbs 传入且条目无图:拉取 PNG 存 blob 并挂 thumbnailId', async () => {
+        const { lib, put, blobs } = fakeLib([[{ name: 'Y Bot', rig: 'rig-ybot' }]]);
+        const fetchStub = stubFetch();
+        try {
+            const count = await seedBuiltinPosesInto(lib, {
+                ...noSleep,
+                thumbs: oneThumb(),
+            });
+            expect(count).toBe(TOTAL);
+            expect(fetchStub.calls).toEqual(['/thumbs/one.png']);
+            expect(blobs).toEqual(['blob-0']);
+            const qbx0 = put.find((e) => e.id === 'seed-pose-' + seedPosesQbx[0].key);
+            expect(qbx0).toMatchObject({ thumbnailId: 'blob-0' });
+            // 无图的条目不带 thumbnailId 字段
+            const dpl0 = put.find((e) => e.id === 'seed-pose-' + seedPosesDpl[0].key);
+            expect(dpl0 && 'thumbnailId' in dpl0).toBe(false);
+        }
+        finally {
+            fetchStub.restore();
+        }
+    });
+    it('条目已有 thumbnailId:不重复拉取,保留原图 id', async () => {
+        const existing = {
+            id: 'seed-pose-' + seedPosesQbx[0].key,
+            kind: 'pose',
+            name: seedPosesQbx[0].name,
+            rig: 'rig-ybot',
+            thumbnailId: 'blob-old',
+            bones: {},
+            createdAt: 1,
+        };
+        const { lib, put, blobs } = fakeLib([[{ name: 'Y Bot', rig: 'rig-ybot' }]], [existing], ['blob-old']);
+        const fetchStub = stubFetch();
+        try {
+            await seedBuiltinPosesInto(lib, { ...noSleep, thumbs: oneThumb() });
+            expect(fetchStub.calls).toHaveLength(0);
+            expect(blobs).toHaveLength(0);
+            const qbx0 = put.find((e) => e.id === existing.id);
+            expect(qbx0).toMatchObject({ thumbnailId: 'blob-old' });
+        }
+        finally {
+            fetchStub.restore();
+        }
+    });
+    it('条目 thumbnailId 是死引用(blob 已被误删):重新拉取补挂', async () => {
+        const existing = {
+            id: 'seed-pose-' + seedPosesQbx[0].key,
+            kind: 'pose',
+            name: seedPosesQbx[0].name,
+            rig: 'rig-ybot',
+            thumbnailId: 'blob-gone',
+            bones: {},
+            createdAt: 1,
+        };
+        const { lib, put, blobs } = fakeLib([[{ name: 'Y Bot', rig: 'rig-ybot' }]], [existing], []);
+        const fetchStub = stubFetch();
+        try {
+            await seedBuiltinPosesInto(lib, { ...noSleep, thumbs: oneThumb() });
+            expect(fetchStub.calls).toEqual(['/thumbs/one.png']);
+            const qbx0 = put.find((e) => e.id === existing.id);
+            expect(qbx0).toMatchObject({ thumbnailId: 'blob-0' });
+            expect(blobs).toEqual(['blob-0']);
+        }
+        finally {
+            fetchStub.restore();
+        }
+    });
+    it('预览图拉取失败:只告警,姿势本体照播不带 thumbnailId', async () => {
+        const { lib, put, blobs } = fakeLib([[{ name: 'Y Bot', rig: 'rig-ybot' }]]);
+        const fetchStub = stubFetch(false);
+        const warn = jest.spyOn(console, 'warn').mockImplementation(() => { });
+        try {
+            const count = await seedBuiltinPosesInto(lib, {
+                ...noSleep,
+                thumbs: oneThumb(),
+            });
+            expect(count).toBe(TOTAL);
+            expect(blobs).toHaveLength(0);
+            const qbx0 = put.find((e) => e.id === 'seed-pose-' + seedPosesQbx[0].key);
+            expect(qbx0 && 'thumbnailId' in qbx0).toBe(false);
+        }
+        finally {
+            fetchStub.restore();
+            warn.mockRestore();
+        }
+    });
+});