@jnrs/lingshu-smart 2.2.46 → 2.2.47

package/dist/stores/useDebugStore.d.ts

@@ -13,6 +13,7 @@ export declare const useDebugStore: import('pinia').StoreDefinition<"@jnrs/lings
     debugPanelVisible: import('vue').Ref<boolean, boolean>;
     scriptSteps: import('vue').WritableComputedRef<ScriptStep[], ScriptStep[]>;
     setScriptSteps: (list: ScriptStep[]) => void;
+    scriptLooping: import('vue').WritableComputedRef<boolean, boolean>;
     activeCaseId: import('vue').WritableComputedRef<string, string>;
     setWsProxyActiveCaseId: (caseId: string) => void;
     wsProxyManualModified: import('vue').WritableComputedRef<boolean, boolean>;
@@ -40,6 +41,7 @@ export declare const useDebugStore: import('pinia').StoreDefinition<"@jnrs/lings
     debugPanelVisible: import('vue').Ref<boolean, boolean>;
     scriptSteps: import('vue').WritableComputedRef<ScriptStep[], ScriptStep[]>;
     setScriptSteps: (list: ScriptStep[]) => void;
+    scriptLooping: import('vue').WritableComputedRef<boolean, boolean>;
     activeCaseId: import('vue').WritableComputedRef<string, string>;
     setWsProxyActiveCaseId: (caseId: string) => void;
     wsProxyManualModified: import('vue').WritableComputedRef<boolean, boolean>;
@@ -56,7 +58,7 @@ export declare const useDebugStore: import('pinia').StoreDefinition<"@jnrs/lings
     toggleTheme: () => void;
     showDebugPanel: () => void;
     hideDebugPanel: () => void;
-}, "logLevel" | "shadowsEnabled" | "animationsEnabled" | "fpsMode" | "interactionsDisabled" | "locale" | "theme" | "wsProxyManualModified" | "perfStatsCollapsed" | "scriptSteps" | "activeCaseId">, Pick<{
+}, "logLevel" | "shadowsEnabled" | "animationsEnabled" | "fpsMode" | "interactionsDisabled" | "locale" | "theme" | "wsProxyManualModified" | "perfStatsCollapsed" | "scriptLooping" | "scriptSteps" | "activeCaseId">, Pick<{
     logLevel: import('vue').WritableComputedRef<LogLevel, LogLevel>;
     shadowsEnabled: import('vue').WritableComputedRef<boolean, boolean>;
     animationsEnabled: import('vue').WritableComputedRef<boolean, boolean>;
@@ -67,6 +69,7 @@ export declare const useDebugStore: import('pinia').StoreDefinition<"@jnrs/lings
     debugPanelVisible: import('vue').Ref<boolean, boolean>;
     scriptSteps: import('vue').WritableComputedRef<ScriptStep[], ScriptStep[]>;
     setScriptSteps: (list: ScriptStep[]) => void;
+    scriptLooping: import('vue').WritableComputedRef<boolean, boolean>;
     activeCaseId: import('vue').WritableComputedRef<string, string>;
     setWsProxyActiveCaseId: (caseId: string) => void;
     wsProxyManualModified: import('vue').WritableComputedRef<boolean, boolean>;

package/dist/types/components/operating.types.d.ts

@@ -16,26 +16,26 @@ export interface IResourceOperating {
     rawData: IRowData;
 }
 /**
- * 状态灯操作
+ * 状态灯操作（字段缺失即跳过，保持当前状态）
  */
 export interface ILightOperating {
-    color: string;
+    color?: string;
     blinking?: boolean;
     rotating?: boolean;
 }
 /**
- * 进度条操作
+ * 进度条操作（字段缺失即跳过，保持当前状态）
  */
 export interface IProgressOperating {
-    percent: number;
-    textContent: string;
+    percent?: number;
+    textContent?: string;
 }
 /**
- * 出入口操作
+ * 出入口操作（字段缺失即跳过，保持当前状态）
  */
 export interface IEntranceOperating {
-    isIn: boolean;
-    isOut: boolean;
+    isIn?: boolean;
+    isOut?: boolean;
 }
 /**
  * 子组件运转状态的联合类型

package/dist/types/guards.d.ts

@@ -3,9 +3,11 @@ export declare function isMachineTool(layer: ILayer | null): layer is import('./
 export declare function hasStationSlotGroup(layer: ILayer | null): layer is Extract<ILayer, {
     stationSlotGroup?: any;
 }>;
-export declare function isStationSlotGroupBoth(layer: ILayer | null): layer is Extract<ILayer, {
+export declare function isStationSlotGroupBoth(layer: ILayer | null): layer is Exclude<Extract<ILayer, {
     stationSlotGroupPallet?: any;
     stationSlotGroupTool?: any;
+}>, {
+    className: EnumModel.PALLET;
 }>;
 export declare function hasStationSlotLayers(layer: ILayer | null): layer is Extract<ILayer, {
     stationSlotGroups?: any[];

package/dist/types/models/config.types.d.ts

@@ -11,6 +11,7 @@ export interface IModel extends IBaseConfig, IEventState {
     nameplate?: string;
     lightEnabled?: boolean;
     nameplateEnabled?: boolean;
+    progressEnabled?: boolean;
     model?: string;
     manufacturer?: string;
     group?: string;
@@ -150,16 +151,29 @@ export interface IResourceStoreConfig extends IModel {
     stationSlotGroupTool?: IStationSlotGroupConfig;
 }
 /**
- * 托盘（独立设备）
- * 参考 ResourceStore：带铭牌、状态灯；主体背景色可配置（默认 #3C3C3C）
- * 支持托盘/刀具两个独立工位组
+ * 通用托盘工位层配置
+ */
+export interface IPalletLayerConfig {
+    /** 层索引（从 1 开始） */
+    index: number;
+    /** 工位组配置（层内工位 resourceType 可任意配置，托盘或刀具） */
+    stationSlotGroup: IStationSlotGroupConfig;
+}
+/**
+ * 通用托盘（独立设备）
+ * 参考接驳站：支持多层工位组（每层一个工位组，可任意放置若干层）；
+ * 层内工位 resourceType 可任意配置（托盘/刀具），替代原刀盘功能；
+ * 主体背景色可配置（默认 #3C3C3C），带铭牌、状态灯。
  */
 export interface IPalletConfig extends IModel {
     className: EnumModel.PALLET;
     /** 主体背景色（默认 '#3C3C3C'） */
     backgroundColor?: string;
-    flowOptions?: IFlowConfig;
+    /** 多工位层配置数组（一层=一个工位组） */
+    stationSlotGroups?: IPalletLayerConfig[];
+    /** 兼容旧配置：托盘工位组（无 stationSlotGroups 时迁移为第 1 层） */
     stationSlotGroupPallet?: IStationSlotGroupConfig;
+    /** 兼容旧配置：刀具工位组（无 stationSlotGroups 时迁移为第 2 层） */
     stationSlotGroupTool?: IStationSlotGroupConfig;
     linkEquipId?: string;
 }

package/dist/types/models/operating.types.d.ts

@@ -4,12 +4,14 @@ import { ILightOperating, IProgressOperating, IEntranceOperating, IResourceOpera
 /** 操作类型：model 画布模型操作；resource 全局资源操作；resetAll 全部复位操作 */
 export type EnumOperatingType = 'model' | 'resource' | 'resetAll';
 /**
- * 设备运转基类
+ * 设备运转基类（业务字段均为「缺失即跳过」语义：未携带的字段不设置，保持模型当前状态）
  */
 export interface IModelOperating {
     operatingType?: 'model';
     id: string;
     className: EnumModel;
+    /** 工位序号：同 id 多实例（同设备多工位 UI）时的目标实例消歧；缺省时回退 resource.index */
+    stationIndex?: number;
     rawData: IRowData;
     resource?: IResourceOperating;
 }
@@ -58,11 +60,11 @@ export interface ILoadingStationOperating extends IModelOperating {
 export interface IShuttleStationOperating extends IModelOperating {
     className: EnumModel.SHUTTLE_STATION;
     light?: Omit<ILightOperating, 'rotating'>;
-    /** 各层工位组状态灯颜色，键为层索引（1-based），值为状态码或颜色字符串
-     *  代理器 dictColorMap / objDict 转换后值为颜色字符串；未转换时值为状态数字码
-     * 如 { 1: 'red', 2: 100, 3: 'green' }
+    /**
+     *  各层工位组状态灯颜色，键为层索引（1-based），值为颜色字符串（由消息侧完成状态码→颜色转换）
+     *  如 { 1: '#FF4444', 2: '#00FF7F' }
      */
-    layerLightColor?: Record<number, number | string>;
+    layerLightColor?: Record<number, string>;
     /**
      * 各层工位组状态灯闪烁，键为层索引（1-based），值为是否闪烁（配合 layerLightColor 状态灯使用）
      * 如 { 1: false, 2: true, 3: true }
@@ -83,13 +85,6 @@ export interface IMaterialTrackOperating extends IModelOperating {
     /** 各层工位组显示状态，键为层索引（1-based），值为是否可见（通过工位组 visible 属性显隐） */
     layerVisible?: Record<number, boolean>;
 }
-/**
- * 打标机站点状态
- */
-export interface ILaserSiteState {
-    site: number;
-    active: boolean;
-}
 /**
  * 打标机运转状态
  */
@@ -98,7 +93,9 @@ export interface IMarkingMachineOperating extends IModelOperating {
     light?: Omit<ILightOperating, 'rotating'>;
     progress?: IProgressOperating;
     entrance?: IEntranceOperating;
-    laserSiteNumberArray?: ILaserSiteState[];
+    /** 各激光工位是否打标中，键为工位序号（1-based），值为是否激活
+     *  如 { 1: true, 2: false }（与 layerVisible 等「序号→状态」字段结构统一） */
+    laserSites?: Record<number, boolean>;
 }
 /**
  * 清洗机运转状态
@@ -146,13 +143,9 @@ export interface IRGVOperating extends IModelOperating {
     forkZ?: number;
 }
 /**
- * 轨道运转状态
+ * 轨道运转状态（已移除：拖链定位由画布内部联动驱动——设备移动时逐帧跟随，
+ * 不再提供 socket 消息驱动的入口，避免消息侧携带其他设备 id（botId）实现联动）
  */
-export interface IRailOperating extends IModelOperating {
-    className: EnumModel.RAIL;
-    x?: number;
-    botId?: string;
-}
 /**
  * 资源库运转状态
  */
@@ -161,13 +154,14 @@ export interface IResourceStoreOperating extends IModelOperating {
     light?: ILightOperating;
     x?: number;
     resource?: IResourceOperating;
-    /** 各工位背景颜色，键为工位序号 index（1-based），值为状态码或颜色字符串
-     *  代理器转换后值为颜色字符串；未转换时值为状态数字码（内部映射为颜色）
-     *  如 { 1: 'red', 2: 100, 3: '#66DC7A' } */
-    stationColor?: Record<number, number | string>;
+    /** 各工位背景颜色，键为工位序号 index（1-based），值为颜色字符串（由消息侧完成状态码→颜色转换）
+     *  如 { 1: '#FF4444', 2: '#00FF7F' } */
+    stationColor?: Record<number, string>;
 }
 /**
- * 托盘运转状态
+ * 通用托盘运转状态
+ * resource 支持多层工位组：通过 resource.layer（1-based）定位到指定层；
+ * 未传入 layer 时默认识别为第一层。
  */
 export interface IPalletOperating extends IModelOperating {
     className: EnumModel.PALLET;
@@ -175,10 +169,8 @@ export interface IPalletOperating extends IModelOperating {
     x?: number;
     y?: number;
     resource?: IResourceOperating;
-    /** 各工位背景颜色，键为工位序号 index（1-based），值为状态码或颜色字符串
-     *  代理器转换后值为颜色字符串；未转换时值为状态数字码（内部映射为颜色）
-     *  如 { 1: 'red', 2: 100, 3: '#66DC7A' } */
-    stationColor?: Record<number, number | string>;
+    /** 各工位背景颜色，键为工位序号 index（1-based），值为颜色字符串（由消息侧完成状态码→颜色转换） */
+    stationColor?: Record<number, string>;
 }
 /**
  * 资源操作窗口运转状态
@@ -187,12 +179,10 @@ export interface IResourceOperationWindowOperating extends IModelOperating {
     className: EnumModel.RESOURCE_OPERATION_WINDOW;
     light?: Omit<ILightOperating, 'rotating'>;
     resource?: IResourceOperating;
-    /** 各工位背景颜色，键为工位序号 index（1-based），值为状态码或颜色字符串
-     *  代理器转换后值为颜色字符串；未转换时值为状态数字码（内部映射为颜色）
-     *  如 { 1: 'red', 2: 100, 3: '#66DC7A' } */
-    stationColor?: Record<number, number | string>;
+    /** 各工位背景颜色，键为工位序号 index（1-based），值为颜色字符串（由消息侧完成状态码→颜色转换） */
+    stationColor?: Record<number, string>;
 }
 /**
  * 设备层运转状态的联合类型
  */
-export type ILayerOperating = IMachineToolOperating | ILoadingStationOperating | IShuttleStationOperating | IMaterialTrackOperating | IMarkingMachineOperating | ICleaningMachineOperating | ISingleJointRobotOperating | IDoubleJointRobotOperating | IRGVOperating | IRailOperating | IResourceStoreOperating | IPalletOperating | IResourceOperationWindowOperating | IGlobalResourceOperating | IResetAllOperating;
+export type ILayerOperating = IMachineToolOperating | ILoadingStationOperating | IShuttleStationOperating | IMaterialTrackOperating | IMarkingMachineOperating | ICleaningMachineOperating | ISingleJointRobotOperating | IDoubleJointRobotOperating | IRGVOperating | IResourceStoreOperating | IPalletOperating | IResourceOperationWindowOperating | IGlobalResourceOperating | IResetAllOperating;

package/dist/ui/abstract/ModelAbs.d.ts

@@ -4,6 +4,11 @@ import { BaseAbs } from './BaseAbs';
 export declare abstract class ModelAbs<T extends ILayer = ILayer> extends BaseAbs<T> {
     private eventHandler;
     protected abstract operating(data: ILayerOperating): void;
+    /**
+     * 设备沿 x 移动的动画时长（秒）
+     * 托盘跟随等联动使用该值保持动画同步；子类可覆盖（如双关节机器人 0.5s）
+     */
+    get moveDuration(): number;
     handleOperation: (data: ILayerOperating) => void;
     /**
      * 将最近一次 operating 接收到的原始数据写入模型 config 及整棵 UI 树的 data 属性，

package/dist/ui/components/StationSlotGroup.d.ts

@@ -32,9 +32,9 @@ export declare class StationSlotGroup extends ComponentAbs<IStationSlotGroupConf
     /**
      * 按工位序号修改工位填充颜色
      * @param index 工位序号（IStationSlotConfig.index）
-     * @param color 目标颜色：颜色字符串直接使用，数字状态码内部映射为颜色；缺省时使用工位默认背景色
+     * @param color 目标颜色字符串（状态码→颜色由消息侧完成）；缺省时使用工位默认背景色
      */
-    setSiteWorkingColor(index: number, color?: string | number): void;
+    setSiteWorkingColor(index: number, color?: string): void;
     /**
      * 判断本组是否包含指定工位序号
      */

package/dist/ui/models/DoubleJointRobot.d.ts

@@ -16,6 +16,8 @@ export declare class DoubleJointRobot extends ModelAbs<IDoubleJointRobotConfig>
     private stationSlotGroupTool;
     get currentFixture(): EnumResourceType;
     set currentFixture(type: EnumResourceType);
+    /** 移动动画时长：与 moveX 默认 0.5s 一致，供托盘跟随等联动同步 */
+    get moveDuration(): number;
     protected createUi(): Box;
     protected operating(data: IDoubleJointRobotOperating): void;
     protected collectStationSlotGroups(): StationSlotGroup[];

package/dist/ui/models/MachineTool.d.ts

@@ -15,7 +15,6 @@ export declare class MachineTool extends ModelAbs<IMachineToolConfig> {
     /** 工位容器玻璃背景（isWorking 时呼吸闪动） */
     private glass;
     private stationContainerBaseRotation;
-    private animating;
     protected createUi(): Box;
     protected operating(data: IMachineToolOperating): void;
     /** 玻璃背景呼吸效果：工作中开启动画（明暗往复），结束恢复常亮 */

package/dist/ui/models/Pallet.d.ts

@@ -3,21 +3,26 @@ import { Box } from 'leafer';
 import { ModelAbs } from '../abstract/ModelAbs';
 import { StationSlotGroup } from '../components/StationSlotGroup';
 /**
- * 托盘（独立设备）
- * 参考 ResourceStore：带铭牌、状态灯、托盘/刀具双工位组；
- * 主体样式参考 ShuttleStation 的 layerContainer（内嵌纹理、溢出隐藏），支持修改背景色。
- * operating 支持：light / x / y / resource / stationColor（按工位序号修改工位背景颜色）
+ * 通用托盘（独立设备）
+ * 参考接驳站的多层工位组结构：可任意放置若干层，每层 = 一个工位组容器（层内工位 resourceType 可托盘或刀具），
+ * 替代原刀盘功能；主体样式保留原托盘（内嵌纹理、溢出隐藏），支持修改背景色，带铭牌、状态灯。
+ * operating 支持：light / x / y / resource（按层定位，layer 缺省默认识别为第一层）/ stationColor（按工位序号修改工位背景颜色）
  */
 export declare class Pallet extends ModelAbs<IPalletConfig> {
     private static readonly CORNER_RADIUS;
+    private static readonly LAYER_PADDING;
+    private static readonly LAYER_GAP;
     private light;
-    private stationSlotGroupPallet;
-    private stationSlotGroupTool;
+    private layerGroups;
+    private resolveLayers;
+    private buildLayers;
     protected createUi(): Box;
     private moveX;
     private moveY;
     protected operating(data: IPalletOperating): void;
-    /** 按工位序号修改工位背景颜色：在托盘/刀具工位组中查找包含该序号的工位槽并改色 */
+    /** 资源增删：data.resource 提供 layer(>0) 时定位到该层；缺省时默认识别为第一层 */
+    private handleResourceOperating;
+    /** 按工位序号修改工位背景颜色：在所有层工位组中查找包含该序号的工位槽并改色 */
     private applyStationColor;
     /**
      * 判断本托盘是否包含指定工位号

package/dist/ui/models/Rail.d.ts

@@ -1,4 +1,4 @@
-import { IRailConfig, IRailOperating } from '../../types';
+import { IRailConfig, ILayerOperating } from '../../types';
 import { Box } from 'leafer';
 import { ModelAbs } from '../abstract/ModelAbs';
 /**
@@ -8,7 +8,14 @@ export declare class Rail extends ModelAbs<IRailConfig> {
     private static readonly DEFAULT_HEIGHT;
     private chains;
     protected createUi(): Box;
-    protected operating(data: IRailOperating): void;
+    /** 拖链不消费 socket operating：定位由画布内部联动驱动
+     *  （设备移动时 AppController 逐帧调用 followChain，保证拖链与设备相对静止） */
+    protected operating(_data: ILayerOperating): void;
+    /**
+     * 逐帧跟随（AppController 托盘/拖链联动调用）：
+     * 以设备实时位置直接驱动拖链，保证拖链与设备移动时相对静止
+     */
+    followChain(botId: string, x: number): void;
     private initChains;
     private createChain;
     private moveChain;

package/dist/ui/models/ResourceOperationWindow.d.ts

@@ -14,6 +14,8 @@ import { StationSlotGroup } from '../components/StationSlotGroup';
 export declare class ResourceOperationWindow extends ModelAbs<IResourceOperationWindowConfig> {
     private static readonly DEFAULT_RING_THICKNESS;
     private static readonly LIGHT_Y_OFFSET;
+    /** 状态灯固定宽度（与资源库状态灯一致） */
+    private static readonly LIGHT_WIDTH;
     private static readonly NAME_PLATE_Y_OFFSET;
     private static readonly LIGHT_CORNER_RADIUS;
     /** 环状矩形外壁填充色 */

package/dist/ui/models/Rgv.d.ts

@@ -20,15 +20,13 @@ export declare class Rgv extends ModelAbs<IRGVConfig> {
     private handleRotate;
     private moveX;
     /**
-     * forks 前后移动
+     * forks 前后移动（直接赋值，高频移动不走动画）
      * @param percent 移动比例，[-1,1]
-     * @param duration 动画持续时间
      */
     private handleForkMove;
     /**
-     * forks 上下移动
+     * forks 上下移动（直接赋值，高频移动不走动画）
      * @param percent 移动比例，[0,1]
-     * @param duration 动画持续时间
      */
     private handleForkMoveUpDown;
 }

package/dist/ui/models/ShuttleStation.d.ts

@@ -32,6 +32,4 @@ export declare class ShuttleStation extends ModelAbs<IShuttleStationConfig> {
     /** 资源增删：data.resource 提供 layer(>0) 时定位到该层；缺省时仅当唯一一层包含该工位序号才操作 */
     private handleResourceOperating;
     private applyLayerLightColor;
-    private resolveStatusColor;
-    private statusToColor;
 }