@dreamerbird/camera-studio 0.2.0 → 0.3.0

package/dist/CameraScene.d.ts

@@ -25,7 +25,7 @@ export declare function captureAnchorSeed(mainCam: ISheetObject<any> | undefined
  * UI 装配可配见 ./uiConfig:停靠框 portal 容器 / z-index 基准 / 语言
  * (宿主已包 I18nProvider 时语言以宿主为准,ui.locale 仅自包时生效)。
  */
-export declare function CameraScene({ project, onFlows, onError }: CameraSceneProps): React.JSX.Element;
+export declare function CameraScene({ project, onFlows, onError, includeDemoModel, }: CameraSceneProps): React.JSX.Element;
 /**
  * i18n 嵌套判定(spec §7):宿主树已包 studio 的 I18nProvider →
  * 原样渲染,语言以宿主为准(ui.locale 不生效);否则自包一层,

package/dist/CameraScene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CameraScene.d.ts","sourceRoot":"","sources":["../src/CameraScene.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAiB,YAAY,EAAC,MAAM,mBAAmB,CAAA;AACnE,OAAO,KASN,MAAM,OAAO,CAAA;AAsDd,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAA;AAiBjD,OAAO,KAAK,EAAc,UAAU,EAAC,MAAM,kBAAkB,CAAA;AAyD7D,OAAO,KAAK,EAAC,WAAW,EAAe,MAAM,aAAa,CAAA;AAG1D,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,UAAU,CAAA;AAwmB9C;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,SAAS,GACrC,UAAU,GAAG,SAAS,CAMxB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,SAAS,GACrC,UAAU,CAcZ;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,EAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAC,EAAE,gBAAgB,qBAijDxE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,EAAC,QAAQ,EAAC,EAAE;IAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAC,qBAIpE;AAuFD,8BAA8B;AAC9B,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,OAAO,GACR,EAAE;IACD,KAAK,EAAE,WAAW,CAAA;IAClB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,CAAA;CACnC,QAOA"}
+{"version":3,"file":"CameraScene.d.ts","sourceRoot":"","sources":["../src/CameraScene.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAiB,YAAY,EAAC,MAAM,mBAAmB,CAAA;AACnE,OAAO,KASN,MAAM,OAAO,CAAA;AAsDd,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAA;AAiBjD,OAAO,KAAK,EAAc,UAAU,EAAC,MAAM,kBAAkB,CAAA;AA4D7D,OAAO,KAAK,EAAC,WAAW,EAAe,MAAM,aAAa,CAAA;AAG1D,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,UAAU,CAAA;AAwmB9C;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,SAAS,GACrC,UAAU,GAAG,SAAS,CAMxB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,SAAS,GACrC,UAAU,CAcZ;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,OAAO,EACP,OAAO,EACP,gBAAuB,GACxB,EAAE,gBAAgB,qBAolDlB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,EAAC,QAAQ,EAAC,EAAE;IAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAC,qBAIpE;AAuFD,8BAA8B;AAC9B,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,OAAO,GACR,EAAE;IACD,KAAK,EAAE,WAAW,CAAA;IAClB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,CAAA;CACnC,QAOA"}

package/dist/CameraScene.js

@@ -46,7 +46,7 @@ import { createSceneExportController, registerSceneExportController, } from './a
 import { rigIdOf, collectBoneNames } from './assetLibrary/rig';
 import { cameraOutlineMenuExtensionId, cameraOutlineObjectMenu, setCameraOutlineMenuCtx, } from './outlineObjectMenu';
 import { pruneObjectFromOutlineCollections } from '@dreamerbird/studio/panels/OutlinePanel/outlineOps/stateOps';
-import { createHostFlows, setDropPointContext, setHostFlowsHandle, setPlacingSnapshot, } from './hostFlows';
+import { createHostFlows, dropPointFromClient, isDropPointInsideCanvas, setDropPointContext, setHostFlowsHandle, setPlacingSnapshot, } from './hostFlows';
 import { importModelFile } from './assetLibrary/importModelFile';
 import { resolveControlSpec } from './poseMode/controlSpec';
 import { getUiConfig } from './uiConfig';
@@ -554,7 +554,7 @@ export function captureAnchorSeed(mainCam) {
  * UI 装配可配见 ./uiConfig:停靠框 portal 容器 / z-index 基准 / 语言
  * (宿主已包 I18nProvider 时语言以宿主为准,ui.locale 仅自包时生效)。
  */
-export function CameraScene({ project, onFlows, onError }) {
+export function CameraScene({ project, onFlows, onError, includeDemoModel = true, }) {
     const t = useT();
     const cameraTargetRef = useRef(null);
     const cameraObjRef = useRef(undefined);
@@ -795,7 +795,7 @@ export function CameraScene({ project, onFlows, onError }) {
         const s = getStudio();
         return s?._store?._saaz ?? s?._saaz ?? 'no saaz';
     };
-    const { placing, pendingEntry, startPlacingFromLibrary, placeLibraryEntryAt, cancelPlacing, confirmPlacing, clearPending, } = usePlacementController(project, sheet);
+    const { placing, pendingEntry, startPlacingFromLibrary, placeLibraryEntryAt, placePrimitiveAt, cancelPlacing, confirmPlacing, clearPending, } = usePlacementController(project, sheet);
     const [gizmoMode, setGizmoMode] = useGizmoMode();
     // 正在摆姿势的 placementKey(无会话为 null):Esc/双击空白/播放自动退出都靠它
     const poseSessionKey = usePoseSessionKey();
@@ -822,6 +822,33 @@ export function CameraScene({ project, onFlows, onError }) {
             setModelDragging(false);
         });
     }, [startPlacingFromLibrary]);
+    useEffect(() => {
+        if (!modelDragging)
+            return;
+        const onDragOver = (ev) => {
+            if (isDropPointInsideCanvas(ev.clientX, ev.clientY))
+                ev.preventDefault();
+        };
+        const onDrop = (ev) => {
+            ev.preventDefault();
+            if (isDropPointInsideCanvas(ev.clientX, ev.clientY)) {
+                const point = dropPointFromClient(ev.clientX, ev.clientY);
+                if (point) {
+                    confirmPlacing(point);
+                    setModelDragging(false);
+                    return;
+                }
+            }
+            cancelPlacing();
+            setModelDragging(false);
+        };
+        window.addEventListener('dragover', onDragOver);
+        window.addEventListener('drop', onDrop);
+        return () => {
+            window.removeEventListener('dragover', onDragOver);
+            window.removeEventListener('drop', onDrop);
+        };
+    }, [modelDragging, confirmPlacing, cancelPlacing]);
     // 右键已放置模型弹出的操作菜单:记录目标条目和光标位置
     const [objectMenu, setObjectMenu] = useState(null);
     // 菜单关闭回调:稳定的引用,避免 CanvasContextMenu 不必要的重渲染
@@ -1363,6 +1390,7 @@ export function CameraScene({ project, onFlows, onError }) {
         gizmoMode,
         selectedPathPoint,
         placeLibraryEntryAt,
+        placePrimitiveAt,
         enterPathEdit,
         exitPathEditOnBlur,
         afterSceneObjectDeleted,
@@ -1373,6 +1401,7 @@ export function CameraScene({ project, onFlows, onError }) {
             // 模型:转发 placeLibraryEntryAt(Task 8 已返回 {key, persisted},
             // 与 UI 点击放置同一条落地管线)
             createModel: ({ entry, position }) => deps().placeLibraryEntryAt(entry, position),
+            createPrimitive: ({ kind, position }) => deps().placePrimitiveAt(kind, position),
             // 相机:Task 15 决策——生产绑定不自动 setActiveCameraKey。
             // create/setActive 是 spec §9 的两条显式命令,Agent 调用
             // cameras.create 不得隐性改变会话态;自动激活是 UI 顶栏
@@ -1441,7 +1470,8 @@ export function CameraScene({ project, onFlows, onError }) {
     const [coverGone, setCoverGone] = useState(false);
     const [firstScreenGate] = useState(() => {
         const gate = createFirstScreenGate(() => setFirstScreenReady(true));
-        gate.expect(SCENE_MODEL_GATE_KEY);
+        if (includeDemoModel)
+            gate.expect(SCENE_MODEL_GATE_KEY);
         installFirstScreenGate(gate);
         return gate;
     });
@@ -1633,9 +1663,9 @@ export function CameraScene({ project, onFlows, onError }) {
                     React.createElement(e.mesh, { ref: cameraTargetRef, theatreKey: "Camera / Target", objRef: targetObjRef, hideFromOutline: true, position: DIRECTOR_HOME_TARGET_POSITION, visible: "editor" },
                         React.createElement("boxGeometry", { attach: "geometry" }),
                         React.createElement("meshPhongMaterial", { attach: "material", color: "red" })),
-                    React.createElement(Suspense, { fallback: null },
+                    includeDemoModel && (React.createElement(Suspense, { fallback: null },
                         React.createElement(InitialLoadProbe, { gateKey: SCENE_MODEL_GATE_KEY },
-                            React.createElement(Model, { url: sceneGLB, selectLocked: !!placing }))),
+                            React.createElement(Model, { url: sceneGLB, selectLocked: !!placing })))),
                     placing && (React.createElement(Suspense, { fallback: null },
                         React.createElement(PlacementRigErrorBoundary, { onCancel: () => {
                                 cancelPlacing();

package/dist/PlacementManager.d.ts

@@ -1,8 +1,10 @@
 import type { IProject, ISheet, ISheetObject } from '@dreamerbird/core';
 import React from 'react';
-import type { Group, Object3D, AnimationClip } from 'three';
+import { Group } from 'three';
+import type { Object3D, AnimationClip } from 'three';
 import type { Library } from './assetLibrary/library';
 import type { ModelEntry } from './assetLibrary/types';
+import type { PrimitiveKind } from './primitives';
 /**
  * FBX 模型放置:页面顶部按钮选文件进入放置模式,半透明 ghost 跟随光标
  * (落点取物体表面优先,y=0 地面兜底),左键确认、Esc/右键取消。
@@ -33,6 +35,8 @@ export type PlacementEntry = {
     assetId?: string;
     /** 库来源条目的 id;存在时优先从资产库加载 GLB */
     libraryEntryId?: string;
+    primitive?: PrimitiveKind;
+    loadAttempt?: number;
     position: {
         x: number;
         y: number;
@@ -159,6 +163,14 @@ export declare function usePlacementController(project: IProject, sheet: ISheet)
         key: string;
         persisted: Promise<void>;
     };
+    placePrimitiveAt: (kind: PrimitiveKind, point: {
+        x: number;
+        y: number;
+        z: number;
+    }) => {
+        key: string;
+        persisted: Promise<void>;
+    };
     clearPending: () => void;
 };
 /**
@@ -214,6 +226,7 @@ export declare function loadLibraryModel(entryId: string, lib?: Library): Promis
     group: Group;
     animations: AnimationClip[];
 }>;
+export declare function createFailedModelPlaceholder(key: string): Group;
 /** gizmo 的操作模式(标签文案在 menuModel 里经 t() 取);select = 只点选不挂手柄 */
 export type GizmoMode = 'select' | 'translate' | 'rotate' | 'scale';
 /**
@@ -232,6 +245,7 @@ export declare function useGizmoMode(): [GizmoMode, (mode: GizmoMode) => void];
  * 空壳在大纲里,刷新后消失——和撤销放置的已知行为一样。FBX 文件本体
  * 留在 IndexedDB。
  */
+export declare function retryPlacement(sheet: ISheet, key: string, replacementEntryId?: string): boolean;
 export declare function deletePlacement(sheet: ISheet, key: string): void;
 /**
  * 选中对象的操作手柄:studio 选中状态里出现登记过的对象时,

package/dist/PlacementManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlacementManager.d.ts","sourceRoot":"","sources":["../src/PlacementManager.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"PlacementManager.d.ts","sourceRoot":"","sources":["../src/PlacementManager.tsx"],"names":[],"mappings":"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"}

package/dist/PlacementManager.js

@@ -9,7 +9,7 @@ import getStudio from '@dreamerbird/studio/getStudio';
 import { TransformControls, useFBX } from '@react-three/drei';
 import { useFrame, useThree } from '@react-three/fiber';
 import React, { Suspense, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState, } from 'react';
-import { AnimationMixer, Box3, BoxGeometry, Mesh, MeshBasicMaterial, Raycaster, Vector3, } from 'three';
+import { AnimationMixer, Box3, BoxGeometry, Group, Mesh, MeshBasicMaterial, Raycaster, Vector3, } from 'three';
 import { SkeletonUtils } from 'three-stdlib';
 import { registerBoneAnchors, unregisterBoneAnchors } from './boneAnchors';
 import { notifyTargetRegistryChange, sheetObjectExists } from './aimTargets';
@@ -35,6 +35,9 @@ import { collectLibPoseIdsForProps, getPoseTrackId, getTrackIdForProp, } from '.
 import { gesturePropConfigShape, resolveGestureBones } from './gestureProps';
 import { computeLegacyPoseMigration } from './poseMode/poseMigration';
 import { parsePoseValue } from './poseMode/poseValue';
+import { createPrimitive } from './primitives';
+import { cloneModelMaterials, collectMaterialSlots, createMaterialOverridesConfig, } from './materials/modelMaterials';
+import { useModelMaterials } from './materials/useModelMaterials';
 import { formatSceneObjectId } from './agent/objectIds';
 import { registerSceneSheetObject, unregisterSceneSheetObject, } from './agent/runtime/objectRuntime';
 import { createPlacementWaiter, rejectPlacement, resolvePlacementPersisted, } from './agent/runtime/placementLifecycle';
@@ -466,6 +469,13 @@ export function usePlacementController(project, sheet) {
         });
         return { key, persisted };
     }, [sheet]);
+    const placePrimitiveAt = useCallback((kind, point) => {
+        const key = uniquePlacedModelKey(sheet, kind);
+        const persisted = createPlacementWaiter(key);
+        persisted.catch(() => { });
+        setPendingEntry({ key, primitive: kind, position: point, pending: true });
+        return { key, persisted };
+    }, [sheet]);
     const clearPending = useCallback(() => setPendingEntry(null), []);
     return {
         placing,
@@ -475,6 +485,7 @@ export function usePlacementController(project, sheet) {
         cancelPlacing,
         confirmPlacing,
         placeLibraryEntryAt,
+        placePrimitiveAt,
         clearPending,
     };
 }
@@ -620,8 +631,9 @@ function PlacementRigCore({ model, onConfirm, onCancel, confirmOnPointerUp, }) {
         if (!confirmOnPointerUp)
             return;
         const el = gl.domElement;
+        let nativeDragOverCanvas = false;
         const onUp = (ev) => {
-            if (ev.button !== 0)
+            if (ev.button !== 0 || nativeDragOverCanvas)
                 return;
             // 画布铺满全窗口、垫在面板之下:松手在面板/工具栏等 DOM 上时 target 不是画布,
             // 必须取消(spec:松手在面板区域 = 静默取消)。提示条 pointerEvents:none 不挡
@@ -636,9 +648,45 @@ function PlacementRigCore({ model, onConfirm, onCancel, confirmOnPointerUp, }) {
             }
             onConfirm({ x: p.x, y: p.y, z: p.z });
         };
+        const onDragOver = (ev) => {
+            ev.preventDefault();
+            nativeDragOverCanvas = true;
+            pendingMoveRef.current = { x: ev.clientX, y: ev.clientY };
+            invalidate();
+        };
+        const onDragLeave = () => {
+            nativeDragOverCanvas = false;
+        };
+        const onDrop = (ev) => {
+            ev.preventDefault();
+            ev.stopPropagation();
+            nativeDragOverCanvas = false;
+            const p = computePoint(ev.clientX, ev.clientY);
+            if (p.distanceTo(camera.position) > 300) {
+                onCancel();
+                return;
+            }
+            onConfirm({ x: p.x, y: p.y, z: p.z });
+        };
         window.addEventListener('pointerup', onUp);
-        return () => window.removeEventListener('pointerup', onUp);
-    }, [confirmOnPointerUp, gl, camera, computePoint, onConfirm, onCancel]);
+        el.addEventListener('dragover', onDragOver);
+        el.addEventListener('dragleave', onDragLeave);
+        el.addEventListener('drop', onDrop);
+        return () => {
+            window.removeEventListener('pointerup', onUp);
+            el.removeEventListener('dragover', onDragOver);
+            el.removeEventListener('dragleave', onDragLeave);
+            el.removeEventListener('drop', onDrop);
+        };
+    }, [
+        confirmOnPointerUp,
+        gl,
+        camera,
+        computePoint,
+        invalidate,
+        onConfirm,
+        onCancel,
+    ]);
     return (
     // 首次 pointermove 之前不显示,避免在原地闪一下
     React.createElement("group", { ref: ghostRef, scale: scale, visible: false },
@@ -685,15 +733,26 @@ export function PlacedModels({ sheet, project, pendingEntry, onPersisted, select
     }, [ready, entriesKey]);
     if (!ready)
         return null;
-    return (React.createElement(React.Fragment, null, entries.map((entry) => (React.createElement(Suspense, { key: entry.key, fallback: null },
+    return (React.createElement(React.Fragment, null, entries.map((entry) => (React.createElement(Suspense, { key: `${entry.key}:${entry.loadAttempt ?? 0}`, fallback: null },
         React.createElement(PlacedModelErrorBoundary, { entry: entry, project: project, sheet: sheet, onPersisted: onPersisted, selectLocked: selectLocked, onObjectMenu: onObjectMenu }))))));
 }
 function PlacedModel({ entry, project, sheet, onPersisted, selectLocked, onObjectMenu, }) {
+    if (entry.primitive) {
+        return (React.createElement(PrimitivePlacedModel, { entry: entry, sheet: sheet, onPersisted: onPersisted, selectLocked: selectLocked, onObjectMenu: onObjectMenu }));
+    }
     if (entry.libraryEntryId) {
         return (React.createElement(LibraryPlacedModel, { entry: entry, project: project, sheet: sheet, onPersisted: onPersisted, selectLocked: selectLocked, onObjectMenu: onObjectMenu }));
     }
     return (React.createElement(FBXPlacedModel, { entry: entry, project: project, sheet: sheet, onPersisted: onPersisted, selectLocked: selectLocked, onObjectMenu: onObjectMenu }));
 }
+function PrimitivePlacedModel({ entry, sheet, onPersisted, selectLocked, onObjectMenu, }) {
+    const group = useMemo(() => {
+        const primitiveGroup = new Group();
+        primitiveGroup.add(createPrimitive(entry.primitive));
+        return primitiveGroup;
+    }, [entry.primitive]);
+    return (React.createElement(PlacedModelCore, { entry: entry, sheet: sheet, group: group, animations: [], sourceType: "primitive", onPersisted: onPersisted, selectLocked: selectLocked, onObjectMenu: onObjectMenu }));
+}
 /** 旧本地 FBX 路径:通过 theatre assetStorage 取 URL,再用 useFBX 加载 */
 function FBXPlacedModel({ entry, project, sheet, onPersisted, selectLocked, onObjectMenu, }) {
     const url = useMemo(() => {
@@ -764,12 +823,19 @@ function LibraryPlacedModel({ entry, project, sheet, onPersisted, selectLocked,
 }
 /** 已加载 Group 之后的公共逻辑:克隆、归一化、动画 mixer、点选菜单、持久化 */
 function PlacedModelCore({ entry, sheet, group, animations, sourceType, onPersisted, selectLocked, onObjectMenu, }) {
-    // 两条加载路径(库 GLB / 本地 FBX)都在这里汇合:挂载即「这个模型
+    // 三条来源路径(库 GLB / 本地 FBX / 基础几何体)都在这里汇合:挂载即「这个模型
     // 落定了」,上报首屏闸门(失败路径由 PlacedModelErrorBoundary 上报)
     useEffect(() => {
         getFirstScreenGate().settle(entry.key);
         // entry.key 挂载期内不变
     }, []);
+    const instance = useMemo(() => {
+        const cloned = SkeletonUtils.clone(group);
+        cloneModelMaterials(cloned);
+        return cloned;
+    }, [group]);
+    const materialSlots = useMemo(() => collectMaterialSlots(instance), [instance]);
+    const materialOverrides = useMemo(() => createMaterialOverridesConfig(materialSlots), [materialSlots]);
     const additionalProps = useMemo(() => {
         const modelEntryId = sourceType === 'library' ? entry.libraryEntryId : undefined;
         const props = {
@@ -787,12 +853,13 @@ function PlacedModelCore({ entry, sheet, group, animations, sourceType, onPersis
                 label: () => translate('pg.props.poseOverride'),
                 hidden: true,
             }),
+            materialOverrides,
         };
         if (sourceType === 'local' && entry.assetId) {
             props.source = fileConfigFor(entry.assetId);
         }
         return props;
-    }, [sourceType, entry.assetId, entry.libraryEntryId]);
+    }, [sourceType, entry.assetId, entry.libraryEntryId, materialOverrides]);
     const { scale, lift } = useNormalizedModel(group);
     const objRef = useRef(undefined);
     const [sheetObject, setSheetObject] = useState(undefined);
@@ -819,6 +886,7 @@ function PlacedModelCore({ entry, sheet, group, animations, sourceType, onPersis
     // 登记为选中 gizmo 的附着目标:被选中时身上挂三轴移动箭头
     useSelectionGizmoTarget(objRef, groupRef);
     const invalidate = useThree((s) => s.invalidate);
+    useModelMaterials({ instance, sheetObject, slots: materialSlots, invalidate });
     // 主画面点选:和 App 里 Model 的 selectThingy 同款。放置模式下点击是
     // 确认落点,不选中、不拦截;点 gizmo 箭头穿透过来的误点也要吞掉。
     const selectSelf = (event) => {
@@ -866,10 +934,6 @@ function PlacedModelCore({ entry, sheet, group, animations, sourceType, onPersis
         event.stopPropagation();
         enterPoseSession(entry.key);
     };
-    // 骨架动画:加载结果按 URL 缓存,同一文件放多个会共享同一份骨架,
-    // 互相打架(多个 <primitive> 挂同一个 Object3D 也只有最后一个能显示)。
-    // 所以每个实例克隆一份(SkinnedMesh 安全),配独立的 AnimationMixer。
-    const instance = useMemo(() => SkeletonUtils.clone(group), [group]);
     const mixer = useMemo(() => new AnimationMixer(instance), [instance]);
     // 登记进 placedInstances 表:锚点父级绑定的 model: 解析用
     usePlacedInstance(entry.key, instance);
@@ -1065,7 +1129,7 @@ function PlacedModelCore({ entry, sheet, group, animations, sourceType, onPersis
             pendingUncachesRef.current = [];
             mixer.stopAllAction();
             mixer.uncacheRoot(instance);
-            disposeObjectTree(instance);
+            disposeObjectTree(instance, { disposeTextures: false });
         };
     }, [mixer, instance]);
     // 只在 theatre 序列播放时驱动动画:编辑/摆姿势时模型保持静止。
@@ -1190,7 +1254,20 @@ function PlacedModelCore({ entry, sheet, group, animations, sourceType, onPersis
             React.createElement(PoseModeRig, { instance: instance, sheetObject: sheetObject, placementKey: entry.key, sheet: sheet }),
             React.createElement(PoseModeBar, { instance: instance })))));
 }
-/** 本地缺资产(另一个客户端同步来的清单)或 FBX 解析失败时,跳过该模型而不是崩掉画布 */
+export function createFailedModelPlaceholder(key) {
+    const group = new Group();
+    group.name = `Failed/${key}`;
+    const marker = new Mesh(new BoxGeometry(1, 1, 1), new MeshBasicMaterial({ color: 0xcc4444, wireframe: true }));
+    marker.name = `Failed/${key}/Placeholder`;
+    group.add(marker);
+    return group;
+}
+function FailedPlacedModel({ entry }) {
+    const group = useMemo(() => createFailedModelPlaceholder(entry.key), [entry.key]);
+    useEffect(() => () => disposeObjectTree(group), [group]);
+    return (React.createElement("group", { position: [entry.position.x, entry.position.y, entry.position.z] },
+        React.createElement("primitive", { object: group })));
+}
 class PlacedModelErrorBoundary extends React.Component {
     constructor() {
         super(...arguments);
@@ -1208,7 +1285,11 @@ class PlacedModelErrorBoundary extends React.Component {
         rejectPlacement(this.props.entry.key, err);
     }
     render() {
-        return this.state.failed ? null : React.createElement(PlacedModel, { ...this.props });
+        if (!this.state.failed)
+            return React.createElement(PlacedModel, { ...this.props });
+        if ('pending' in this.props.entry && this.props.entry.pending)
+            return null;
+        return React.createElement(FailedPlacedModel, { entry: this.props.entry });
     }
 }
 /**
@@ -1258,6 +1339,34 @@ export function useGizmoMode() {
  * 空壳在大纲里,刷新后消失——和撤销放置的已知行为一样。FBX 文件本体
  * 留在 IndexedDB。
  */
+export function retryPlacement(sheet, key, replacementEntryId) {
+    const studio = getStudio();
+    if (!studio)
+        return false;
+    const registry = getRegistry(sheet);
+    const list = readRegistry(registry);
+    const current = list.find((entry) => entry.key === key);
+    if (!current)
+        return false;
+    const next = {
+        key: current.key,
+        position: current.position,
+        loadAttempt: (current.loadAttempt ?? 0) + 1,
+        ...(replacementEntryId === undefined
+            ? current.libraryEntryId
+                ? { libraryEntryId: current.libraryEntryId }
+                : current.assetId
+                    ? { assetId: current.assetId }
+                    : current.primitive
+                        ? { primitive: current.primitive }
+                        : {}
+            : { libraryEntryId: replacementEntryId }),
+    };
+    studio.transaction(({ set }) => {
+        set(registry.props.list, JSON.stringify(list.map((entry) => (entry.key === key ? next : entry))));
+    });
+    return true;
+}
 export function deletePlacement(sheet, key) {
     const studio = getStudio();
     if (!studio)

package/dist/agent/api.d.ts

@@ -4,6 +4,8 @@ import type { AgentRuntime, AgentSceneRuntimeHandlers } from './runtime';
 import type { SceneApi, ObjectsApi } from './commands/scene';
 import type { SelectionApi } from './commands/selection';
 import type { ModelsApi } from './commands/models';
+import type { PrimitivesApi } from './commands/primitives';
+import type { MaterialsApi } from './commands/materials';
 import type { AssetsApi } from './commands/assets';
 import type { PosesApi, PosesSessionApi } from './commands/poses';
 import type { AnimationsApi } from './commands/animations';
@@ -28,10 +30,13 @@ export type CameraStudioApi = {
     readonly ready: Promise<void>;
     /** 当前会话的命令清单与元数据(spec 8.1);未激活 API_NOT_READY,已拆解 API_DISPOSED */
     describe(): RegistryDescription;
+    subscribe(listener: () => void): () => void;
     readonly scene: SceneApi;
     readonly selection: SelectionApi;
     readonly objects: ObjectsApi;
     readonly models: ModelsApi;
+    readonly primitives: PrimitivesApi;
+    readonly materials: MaterialsApi;
     readonly assets: AssetsApi;
     readonly poses: PosesApi & {
         readonly session: PosesSessionApi;

package/dist/agent/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/agent/api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/agent/api.ts"],"names":[],"mappings":"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"}

package/dist/agent/api.js

@@ -23,6 +23,7 @@
 import { AgentApiError } from './errors';
 import { AgentCommandRegistry } from './registry';
 import { isGenerationSupersededError } from './runtime';
+import { subscribeSceneSheetObjects } from './runtime/objectRuntime';
 import { registerAllAgentCommands } from './registerCommands';
 const defaultRegistryFactory = (runtime) => {
     const registry = new AgentCommandRegistry();
@@ -120,6 +121,20 @@ export function createCameraStudioApi(options) {
             }
             throw new AgentApiError('API_NOT_READY', 'Camera Studio API 尚未激活(场景未挂载)');
         },
+        subscribe(listener) {
+            const captured = session;
+            if (!captured)
+                return () => { };
+            const studio = captured.runtime.getStudio();
+            const offSelection = studio?.onSelectionChange(() => listener()) ?? (() => { });
+            const offHistoric = captured.runtime.subscribeHistoric(listener);
+            const offSceneObjects = subscribeSceneSheetObjects(listener);
+            return () => {
+                offSelection();
+                offHistoric();
+                offSceneObjects();
+            };
+        },
         scene: {
             getSnapshot: () => invoke('scene.getSnapshot', undefined),
         },
@@ -136,11 +151,21 @@ export function createCameraStudioApi(options) {
         },
         models: {
             create: (args) => invoke('models.create', args),
+            retry: (args) => invoke('models.retry', args),
+            replace: (args) => invoke('models.replace', args),
+        },
+        primitives: {
+            create: (args) => invoke('primitives.create', args),
+        },
+        materials: {
+            list: (args) => invoke('materials.list', args),
+            update: (args) => invoke('materials.update', args),
         },
         assets: {
             list: (args) => invoke('assets.list', args),
             get: (args) => invoke('assets.get', args),
             importModel: (args) => invoke('assets.importModel', args),
+            importModels: (args) => invoke('assets.importModels', args),
             rename: (args) => invoke('assets.rename', args),
             delete: (args) => invoke('assets.delete', args),
         },