@d5techs/3dgs-lib 1.3.0 → 1.4.1

package/dist/App.d.ts

@@ -19,7 +19,7 @@ import { GSSplatRenderer } from "./gs/GSSplatRenderer";
 import { GSSplatRendererMobile } from "./gs/GSSplatRendererMobile";
 import type { BoundingBox, SimpleBoundingBox } from "./types";
 import { HotspotManager } from "./interaction/HotspotManager";
-import type { HotspotInfo } from "./interaction/HotspotManager";
+import type { HotspotInfo, HotspotLabelPosition, HotspotLabelConfig } from "./interaction/HotspotManager";
 import { SplatTransformProxy, MeshGroupProxy, SplatBoundingBoxProvider } from "./scene/proxies";
 import { TransformableObject, GizmoMode } from "./core/gizmo/TransformGizmo";
 import type { BoundingBoxProvider } from "./types";
@@ -49,6 +49,7 @@ export declare class App {
     private isRunning;
     private animationId;
     private useMobileRenderer;
+    private lastCompactData;
     private boundOnResize;
     constructor(canvas: HTMLCanvasElement);
     /**
@@ -73,12 +74,14 @@ export declare class App {
     addPLY(urlOrBuffer: string | ArrayBuffer, onProgress?: ProgressCallback, isLocalFile?: boolean, coordinateSystem?: CoordinateSystem): Promise<number>;
     /**
      * 加载 Splat 文件
+     * @param coordinateSystem 源数据坐标系，默认 'blender'（Z-up → Y-up 自动转换）
      */
-    addSplat(urlOrBuffer: string | ArrayBuffer, onProgress?: ProgressCallback, isLocalFile?: boolean): Promise<number>;
+    addSplat(urlOrBuffer: string | ArrayBuffer, onProgress?: ProgressCallback, isLocalFile?: boolean, coordinateSystem?: CoordinateSystem): Promise<number>;
     /**
      * 加载 SOG 文件 (Spatially Ordered Gaussians)
+     * @param coordinateSystem 源数据坐标系，默认 'blender'（Z-up → Y-up 自动转换）
      */
-    addSOG(urlOrBuffer: string | ArrayBuffer, onProgress?: ProgressCallback, isLocalFile?: boolean): Promise<number>;
+    addSOG(urlOrBuffer: string | ArrayBuffer, onProgress?: ProgressCallback, isLocalFile?: boolean, coordinateSystem?: CoordinateSystem): Promise<number>;
     /**
      * 添加测试立方体
      */
@@ -128,6 +131,7 @@ export declare class App {
     getViewportGizmo(): import(".").ViewportGizmo;
     getBoundingBoxRenderer(): import(".").BoundingBoxRenderer;
     setGizmoMode(mode: GizmoMode): void;
+    setUniformScaleOnly(enabled: boolean): void;
     setGizmoTarget(object: TransformableObject | null): void;
     setSelectionBoundingBox(box: SimpleBoundingBox | null): void;
     setSelectionBoundingBoxProvider(provider: BoundingBoxProvider | null): void;
@@ -151,6 +155,8 @@ export declare class App {
     getGSRenderer(): GSSplatRenderer | undefined;
     getGSRendererMobile(): GSSplatRendererMobile | undefined;
     isUsingMobileRenderer(): boolean;
+    getLastCompactData(): import('./gs/PLYLoaderMobile').CompactSplatData | null;
+    setLastCompactData(data: import('./gs/PLYLoaderMobile').CompactSplatData): void;
     getHotspotManager(): HotspotManager;
     enterHotspotMode(objUrl: string): void;
     exitHotspotMode(): void;
@@ -160,7 +166,33 @@ export declare class App {
     getHotspotBillboard(hotspotIndex: number): boolean;
     getHotspotCount(): number;
     findHotspotIndexByMeshStart(overlayMeshStartIndex: number): number;
+    placeHotspotAt(objUrl: string, position: [number, number, number], normal: [number, number, number], visualDiameter?: number, normalOffset?: number, overrideScale?: number): Promise<HotspotInfo | null>;
     getOverlayMeshByIndex(index: number): import("./mesh/Mesh").Mesh | null;
+    /**
+     * 检测给定屏幕坐标命中了哪个热点
+     * @returns 热点索引，-1 表示未命中
+     */
+    hitTestHotspot(clientX: number, clientY: number): number;
+    /**
+     * 设置热点点击回调（非放置模式下生效）
+     */
+    setOnHotspotClicked(cb: ((hotspotIndex: number, info: HotspotInfo) => void) | null): void;
+    /**
+     * 设置热点点击命中半径（NDC 空间，默认 0.05）
+     */
+    setHotspotHitRadius(radius: number): void;
+    /**
+     * 设置热点文字标签
+     */
+    setHotspotLabel(hotspotIndex: number, text: string, position?: HotspotLabelPosition, fontSize?: number, visible?: boolean): boolean;
+    /**
+     * 设置热点标签可见性
+     */
+    setHotspotLabelVisible(hotspotIndex: number, visible: boolean): boolean;
+    /**
+     * 获取热点标签配置
+     */
+    getHotspotLabel(hotspotIndex: number): HotspotLabelConfig | null;
     private fetchWithProgress;
     private parsePLYBuffer;
     setGridVisible(visible: boolean): void;

package/dist/core/gizmo/TransformGizmo.d.ts

@@ -81,6 +81,8 @@ export declare class TransformGizmo {
     snapIncrement: number;
     dragMode: GizmoDragMode;
     flipPlanes: boolean;
+    /** 强制等比缩放：开启后无论拖哪个轴，缩放都作用于 xyz */
+    uniformScaleOnly: boolean;
     private _target;
     private _shapes;
     private _hoverAxis;

package/dist/editor/EditHistory.d.ts

@@ -0,0 +1,13 @@
+import type { EditOp } from './EditOps';
+export declare class EditHistory {
+    private history;
+    private cursor;
+    private onChange?;
+    constructor(onChange?: () => void);
+    add(op: EditOp): void;
+    canUndo(): boolean;
+    canRedo(): boolean;
+    undo(): void;
+    redo(): void;
+    clear(): void;
+}

package/dist/editor/EditOps.d.ts

@@ -0,0 +1,56 @@
+import { SplatState } from './SplatState';
+export interface EditOp {
+    name: string;
+    do(): void;
+    undo(): void;
+    destroy?(): void;
+}
+export declare class SelectOp implements EditOp {
+    name: string;
+    private inner;
+    constructor(state: SplatState, op: 'add' | 'remove' | 'set', predicate: (i: number) => boolean);
+    do(): void;
+    undo(): void;
+}
+export declare class SelectAllOp implements EditOp {
+    name: string;
+    private inner;
+    constructor(state: SplatState);
+    do(): void;
+    undo(): void;
+}
+export declare class SelectNoneOp implements EditOp {
+    name: string;
+    private inner;
+    constructor(state: SplatState);
+    do(): void;
+    undo(): void;
+}
+export declare class SelectInvertOp implements EditOp {
+    name: string;
+    private inner;
+    constructor(state: SplatState);
+    do(): void;
+    undo(): void;
+}
+export declare class DeleteSelectionOp implements EditOp {
+    name: string;
+    private inner;
+    constructor(state: SplatState);
+    do(): void;
+    undo(): void;
+}
+export declare class HideSelectionOp implements EditOp {
+    name: string;
+    private inner;
+    constructor(state: SplatState);
+    do(): void;
+    undo(): void;
+}
+export declare class UnhideAllOp implements EditOp {
+    name: string;
+    private inner;
+    constructor(state: SplatState);
+    do(): void;
+    undo(): void;
+}

package/dist/editor/Events.d.ts

@@ -0,0 +1,13 @@
+type Listener = (...args: any[]) => void;
+type AsyncListener = (...args: any[]) => Promise<any>;
+export declare class Events {
+    private listeners;
+    private asyncHandlers;
+    on(event: string, fn: Listener): () => void;
+    off(event: string, fn: Listener): void;
+    fire(event: string, ...args: any[]): void;
+    handler(event: string, fn: AsyncListener): void;
+    invoke(event: string, ...args: any[]): Promise<any>;
+    destroy(): void;
+}
+export {};

package/dist/editor/SplatEditor.d.ts

@@ -0,0 +1,80 @@
+/**
+ * SplatEditor - 3DGS 模型编辑器核心类
+ *
+ * 协调选择工具、编辑历史、状态管理和渲染器集成。
+ * 将 splat 中心投影到屏幕空间来判断哪些 splat 在选区内。
+ */
+import type { Camera } from '../core/Camera';
+import type { GSSplatRenderer } from '../gs/GSSplatRenderer';
+import type { CompactSplatData } from '../gs/PLYLoaderMobile';
+import { SplatState } from './SplatState';
+import { EditHistory } from './EditHistory';
+import { ToolManager } from './tools/ToolManager';
+export interface SplatEditorCallbacks {
+    onStateChanged?: () => void;
+    onToolChanged?: (tool: string | null) => void;
+    onHistoryChanged?: (canUndo: boolean, canRedo: boolean) => void;
+    /** 退出编辑模式时调用，传回精简后的 CompactSplatData（已剔除删除的 splat） */
+    onApplyEdits?: (newData: CompactSplatData) => void;
+}
+export declare class SplatEditor {
+    private camera;
+    private gsRenderer;
+    private container;
+    private splatState;
+    private editHistory;
+    private toolManager;
+    private compactData;
+    private callbacks;
+    private maskCanvas;
+    private maskCtx;
+    private toolOverlay;
+    private projectedPositions;
+    private projDirty;
+    private _active;
+    private overlayCleanup;
+    constructor(camera: Camera, gsRenderer: GSSplatRenderer, container: HTMLElement, callbacks?: SplatEditorCallbacks);
+    get active(): boolean;
+    get state(): SplatState;
+    get history(): EditHistory;
+    get tools(): ToolManager;
+    /**
+     * 设置 compact 数据引用（用于导出和颜色匹配）
+     */
+    setCompactData(data: CompactSplatData): void;
+    /**
+     * 进入编辑模式
+     */
+    enter(): void;
+    /**
+     * 退出编辑模式，将编辑结果永久写入渲染数据
+     */
+    exit(): void;
+    /**
+     * 将编辑结果写回渲染器：从 CompactSplatData 中剔除被标记为 deleted 的 splat，
+     * 用精简数据重建 GPU 缓冲区。
+     */
+    private applyEditsToRenderer;
+    selectAll(): void;
+    selectNone(): void;
+    selectInvert(): void;
+    deleteSelection(): void;
+    hideSelection(): void;
+    unhideAll(): void;
+    undo(): void;
+    redo(): void;
+    exportPLY(): ArrayBuffer | null;
+    downloadPLY(filename?: string): void;
+    private selectByRect;
+    private selectByMask;
+    private selectByColor;
+    /**
+     * 每帧调用，标记投影需要更新
+     */
+    markProjectionDirty(): void;
+    private ensureProjection;
+    private onStateChanged;
+    private setupOverlayEventForwarding;
+    private _keyHandler;
+    private _onKeyDown;
+}

package/dist/editor/SplatExporter.d.ts

@@ -0,0 +1,6 @@
+import { SplatState } from './SplatState';
+/**
+ * 将编辑后的 splat 数据导出为 PLY 文件
+ * 仅包含未删除的 splats
+ */
+export declare function exportEditedPLY(positions: Float32Array, scales: Float32Array, rotations: Float32Array, colors: Float32Array, opacities: Float32Array, shCoeffs: Float32Array | null, state: SplatState): ArrayBuffer;

package/dist/editor/SplatState.d.ts

@@ -0,0 +1,18 @@
+export declare enum State {
+    selected = 1,
+    hidden = 2,
+    deleted = 4
+}
+export declare class SplatState {
+    readonly count: number;
+    readonly data: Uint8Array;
+    private _numSelected;
+    private _numHidden;
+    private _numDeleted;
+    constructor(count: number);
+    get numSelected(): number;
+    get numHidden(): number;
+    get numDeleted(): number;
+    recalcCounts(): void;
+    clear(): void;
+}

package/dist/editor/index.d.ts

@@ -0,0 +1,7 @@
+export { SplatEditor } from './SplatEditor';
+export type { SplatEditorCallbacks } from './SplatEditor';
+export { SplatState, State } from './SplatState';
+export { EditHistory } from './EditHistory';
+export { ToolManager } from './tools/ToolManager';
+export type { Tool } from './tools/ToolManager';
+export { exportEditedPLY } from './SplatExporter';

package/dist/editor/tools/BrushSelection.d.ts

@@ -0,0 +1,21 @@
+import type { Tool } from './ToolManager';
+export declare class BrushSelection implements Tool {
+    private parent;
+    private svg;
+    private circle;
+    private maskCanvas;
+    private maskCtx;
+    private onMaskSelect;
+    private radius;
+    private prev;
+    private dragId;
+    constructor(parent: HTMLElement, maskCanvas: HTMLCanvasElement, maskCtx: CanvasRenderingContext2D, onMaskSelect: (op: 'add' | 'remove' | 'set', canvas: HTMLCanvasElement, ctx: CanvasRenderingContext2D) => void);
+    activate(): void;
+    deactivate(): void;
+    private update;
+    private pointerdown;
+    private pointermove;
+    private dragEnd;
+    private pointerup;
+    private wheel;
+}

package/dist/editor/tools/EyedropperSelection.d.ts

@@ -0,0 +1,21 @@
+import type { Tool } from './ToolManager';
+/**
+ * EyedropperSelection - 吸管/颜色匹配选择工具
+ * 点击拾取一个 splat 的颜色，然后选择所有颜色相似的 splats
+ */
+export declare class EyedropperSelection implements Tool {
+    private parent;
+    private onColorMatch;
+    private thresholdEl;
+    private threshold;
+    private pointerId;
+    constructor(parent: HTMLElement, onColorMatch: (op: 'add' | 'remove' | 'set', normalizedPoint: {
+        x: number;
+        y: number;
+    }, threshold: number) => void);
+    activate(): void;
+    deactivate(): void;
+    private pointerdown;
+    private pointermove;
+    private pointerup;
+}

package/dist/editor/tools/FloodSelection.d.ts

@@ -0,0 +1,22 @@
+import type { Tool } from './ToolManager';
+/**
+ * FloodSelection - 基于不透明度的洪水填充选择工具
+ * 从点击位置开始，向相邻像素扩展，选择不透明度相近的区域
+ */
+export declare class FloodSelection implements Tool {
+    private parent;
+    private maskCanvas;
+    private maskCtx;
+    private onMaskSelect;
+    private getOffscreenImage;
+    private thresholdEl;
+    private threshold;
+    private clicked;
+    private imageData;
+    constructor(parent: HTMLElement, maskCanvas: HTMLCanvasElement, maskCtx: CanvasRenderingContext2D, onMaskSelect: (op: 'add' | 'remove' | 'set', canvas: HTMLCanvasElement, ctx: CanvasRenderingContext2D) => void, getOffscreenImage: (width: number, height: number) => Uint8Array | null);
+    activate(): void;
+    deactivate(): void;
+    private pointerdown;
+    private pointermove;
+    private pointerup;
+}

package/dist/editor/tools/LassoSelection.d.ts

@@ -0,0 +1,24 @@
+import type { Tool } from './ToolManager';
+export declare class LassoSelection implements Tool {
+    private parent;
+    private svg;
+    private polygon;
+    private maskCanvas;
+    private maskCtx;
+    private onMaskSelect;
+    private points;
+    private currentPoint;
+    private lastPointTime;
+    private dragId;
+    constructor(parent: HTMLElement, maskCanvas: HTMLCanvasElement, maskCtx: CanvasRenderingContext2D, onMaskSelect: (op: 'add' | 'remove' | 'set', canvas: HTMLCanvasElement, ctx: CanvasRenderingContext2D) => void);
+    activate(): void;
+    deactivate(): void;
+    private dist;
+    private paint;
+    private update;
+    private commitSelection;
+    private pointerdown;
+    private pointermove;
+    private dragEnd;
+    private pointerup;
+}

package/dist/editor/tools/PolygonSelection.d.ts

@@ -0,0 +1,22 @@
+import type { Tool } from './ToolManager';
+export declare class PolygonSelection implements Tool {
+    private parent;
+    private svg;
+    private polyline;
+    private maskCanvas;
+    private maskCtx;
+    private onMaskSelect;
+    private points;
+    private currentPoint;
+    constructor(parent: HTMLElement, maskCanvas: HTMLCanvasElement, maskCtx: CanvasRenderingContext2D, onMaskSelect: (op: 'add' | 'remove' | 'set', canvas: HTMLCanvasElement, ctx: CanvasRenderingContext2D) => void);
+    activate(): void;
+    deactivate(): void;
+    private dist;
+    private isClosed;
+    private paint;
+    private commitSelection;
+    private pointerdown;
+    private pointermove;
+    private pointerup;
+    private dblclick;
+}

package/dist/editor/tools/RectSelection.d.ts

@@ -0,0 +1,24 @@
+import type { Tool } from './ToolManager';
+export declare class RectSelection implements Tool {
+    private parent;
+    private svg;
+    private rect;
+    private onSelect;
+    private start;
+    private end;
+    private dragId;
+    private dragMoved;
+    constructor(parent: HTMLElement, onSelect: (op: 'add' | 'remove' | 'set', rect: {
+        startX: number;
+        startY: number;
+        endX: number;
+        endY: number;
+    }) => void);
+    activate(): void;
+    deactivate(): void;
+    private updateRect;
+    private pointerdown;
+    private pointermove;
+    private dragEnd;
+    private pointerup;
+}

package/dist/editor/tools/ToolManager.d.ts

@@ -0,0 +1,14 @@
+export interface Tool {
+    activate(): void;
+    deactivate(): void;
+}
+export declare class ToolManager {
+    private tools;
+    private _active;
+    private onToolChanged?;
+    constructor(onToolChanged?: (name: string | null) => void);
+    get active(): string | null;
+    register(name: string, tool: Tool): void;
+    activate(name: string | null): void;
+    deactivateAll(): void;
+}

package/dist/gs/GSSplatRenderer.d.ts

@@ -48,6 +48,11 @@ export declare class GSSplatRenderer implements IGSSplatRendererWithCapabilities
     private sortStateInitialized;
     private sortFrequency;
     private frameCounter;
+    private editorStateBuffer;
+    private editorPipeline;
+    private editorBindGroupLayout;
+    private editorBindGroup;
+    private editorEnabled;
     private depthNormalPipeline;
     private depthRT;
     private depthRTView;
@@ -109,5 +114,21 @@ export declare class GSSplatRenderer implements IGSSplatRendererWithCapabilities
     } | null;
     supportsSHMode(mode: SHMode): boolean;
     getCapabilities(): RendererCapabilities;
+    /**
+     * 启用编辑器模式，传入每个 splat 的状态数据
+     */
+    setEditorState(stateData: Uint8Array): void;
+    /**
+     * 更新编辑器状态数据
+     */
+    updateEditorState(stateData: Uint8Array): void;
+    private alignStateData;
+    /**
+     * 禁用编辑器模式
+     */
+    clearEditorState(): void;
+    private createEditorPipeline;
+    private rebuildEditorBindGroup;
+    private buildEditorShader;
     destroy(): void;
 }

package/dist/index.d.ts

@@ -41,9 +41,16 @@ export type { SceneObjectType, SceneObjectInfo } from './scene/SceneManager';
 export { SplatTransformProxy, MeshGroupProxy, SplatBoundingBoxProvider, } from './scene/proxies';
 export { GizmoManager } from './interaction/GizmoManager';
 export { HotspotManager } from './interaction/HotspotManager';
-export type { HotspotInfo } from './interaction/HotspotManager';
+export type { HotspotInfo, HotspotLabelConfig, HotspotLabelPosition } from './interaction/HotspotManager';
 export type { TransformableObject } from './core/gizmo/TransformGizmo';
 export { TransformGizmo, GizmoMode } from './core/gizmo/TransformGizmo';
 export type { GizmoTheme, TransformGizmoConfig, GizmoSpace } from './core/gizmo/TransformGizmo';
+export { SplatEditor } from './editor/SplatEditor';
+export type { SplatEditorCallbacks } from './editor/SplatEditor';
+export { SplatState, State } from './editor/SplatState';
+export { EditHistory } from './editor/EditHistory';
+export { ToolManager } from './editor/tools/ToolManager';
+export type { Tool } from './editor/tools/ToolManager';
+export { exportEditedPLY } from './editor/SplatExporter';
 export { App } from './App';
 export type { ProgressCallback } from './App';

package/dist/interaction/GizmoManager.d.ts

@@ -52,6 +52,7 @@ export declare class GizmoManager {
      * 设置 Gizmo 模式
      */
     setGizmoMode(mode: GizmoMode): void;
+    setUniformScaleOnly(enabled: boolean): void;
     /**
      * 设置 Gizmo 目标对象
      */

package/dist/interaction/HotspotManager.d.ts

@@ -10,6 +10,15 @@ import { OrbitControls } from "../core/OrbitControls";
 import { MeshRenderer } from "../mesh/MeshRenderer";
 import type { IGSSplatRenderer } from "../gs/IGSSplatRenderer";
 import type { Vec3Tuple } from "../types";
+/** 热点标签位置 */
+export type HotspotLabelPosition = 'top' | 'left' | 'right';
+/** 热点标签配置 */
+export interface HotspotLabelConfig {
+    text: string;
+    position: HotspotLabelPosition;
+    fontSize: number;
+    visible: boolean;
+}
 /** 热点信息 */
 export interface HotspotInfo {
     position: Vec3Tuple;
@@ -24,6 +33,10 @@ export interface HotspotInfo {
     placedNormalOffset: number;
     /** 放置时的本地中心偏移 (本地空间) */
     placedLocalCenter: Vec3Tuple;
+    /** 文字标签配置 */
+    label?: HotspotLabelConfig;
+    /** 标签 DOM 元素（内部使用） */
+    _labelElement?: HTMLDivElement;
 }
 /**
  * HotspotManager
@@ -58,6 +71,9 @@ export declare class HotspotManager {
     private lastNormal;
     private indicatorBaseRadius;
     private pickRadiusPx;
+    private labelContainer;
+    private onHotspotClicked;
+    private hotspotHitRadius;
     private onHotspotPlaced;
     private onModeChanged;
     constructor(renderer: Renderer, camera: Camera, canvas: HTMLCanvasElement, controls: OrbitControls, meshRenderer: MeshRenderer);
@@ -69,6 +85,41 @@ export declare class HotspotManager {
     getHotspots(): HotspotInfo[];
     setOnHotspotPlaced(cb: ((info: HotspotInfo) => void) | null): void;
     setOnModeChanged(cb: ((active: boolean) => void) | null): void;
+    private initLabelContainer;
+    /**
+     * 设置热点标签
+     */
+    setHotspotLabel(hotspotIndex: number, text: string, position?: HotspotLabelPosition, fontSize?: number, visible?: boolean): boolean;
+    /**
+     * 设置热点标签可见性
+     */
+    setHotspotLabelVisible(hotspotIndex: number, visible: boolean): boolean;
+    /**
+     * 获取热点标签配置
+     */
+    getHotspotLabel(hotspotIndex: number): HotspotLabelConfig | null;
+    private ensureLabelElement;
+    private applyLabelStyle;
+    /**
+     * 每帧更新所有标签的屏幕位置
+     */
+    updateLabels(): void;
+    /**
+     * 设置热点点击回调
+     */
+    setOnHotspotClicked(cb: ((hotspotIndex: number, info: HotspotInfo) => void) | null): void;
+    private _clickListenerBound;
+    private _boundOnCanvasClick;
+    private _onCanvasClick;
+    /**
+     * 检测给定屏幕坐标命中了哪个热点
+     * @returns 热点索引，-1 表示未命中
+     */
+    hitTestHotspot(clientX: number, clientY: number): number;
+    /**
+     * 设置热点点击命中半径（NDC 空间，默认 0.05）
+     */
+    setHotspotHitRadius(radius: number): void;
     private pickPixelX;
     private pickPixelY;
     private lastClientX;
@@ -130,6 +181,12 @@ export declare class HotspotManager {
      * 通过 overlay mesh 起始索引找到对应的热点索引
      */
     findHotspotIndexByMeshStart(overlayMeshStartIndex: number): number;
+    /**
+     * 在指定位置和法线方向程序化放置一个热点（用于从保存数据恢复）。
+     * 逻辑与交互放置一致：加载 OBJ → 计算朝向矩阵 → addOverlayMesh → 注册到内部列表。
+     * @returns 放置后的 HotspotInfo，失败返回 null
+     */
+    placeHotspotAt(objUrl: string, position: Vec3Tuple, normal: Vec3Tuple, visualDiameter?: number, normalOffset?: number, overrideScale?: number): Promise<HotspotInfo | null>;
     /**
      * 每帧调用：更新所有 billboard 热点朝向相机
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d5techs/3dgs-lib",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "可扩展的 WebGPU 3D 渲染引擎",
   "type": "module",
   "main": "./dist/3dgs-lib.cjs",