@jnrs/lingshu-smart 2.2.46 → 3.0.0

package/dist/types/socket.types.d.ts

@@ -0,0 +1,275 @@
+import { EnumDeviceType, EnumResourceType } from './enums';
+/** 消息类型（envelope.type 固定值） */
+export declare enum EnvelopeType {
+    DeviceInit = "device_init",
+    DeviceCommand = "device_command",
+    ResourceCommand = "resource_command",
+    AlarmPush = "alarm_push",
+    RuntimeStatusPush = "runtime_status_push",
+    SceneReset = "scene_reset",
+    CommandAck = "command_ack"
+}
+/** 消息信封 */
+export interface MessageEnvelope {
+    /** 消息唯一 ID，画布按此去重 */
+    id: string;
+    /** 消息类型，必填、无缺省值 */
+    type: EnvelopeType;
+    /** ISO 8601 时间戳，用于排序与防乱序 */
+    timestamp: string;
+    /** 场景 ID：区分不同场地下的孪生场景 */
+    case_id?: string;
+}
+/** 业务消息 = 信封 + 数据体 */
+export interface SocketMessage<T extends object = object> {
+    envelope: MessageEnvelope;
+    payload: T;
+}
+/** 状态灯 */
+export interface SocketLight {
+    /** 颜色字符串或字典值（见文档第十五章）；缺失时沿用当前颜色 */
+    color?: string;
+    /** 闪烁；仅 === true 视为开启 */
+    blinking?: boolean;
+    /** 旋转；仅机器人 / RGV / 资源库 / 托盘支持 */
+    rotating?: boolean;
+}
+/** 进度条 */
+export interface SocketProgress {
+    /** 进度比例 0 ~ 1（非百分数） */
+    percent?: number;
+    /** 进度文本 */
+    text?: string;
+}
+/** 出入口通道 */
+export interface SocketPassage {
+    in?: boolean;
+    out?: boolean;
+}
+/** 设备空间状态（位移 + 关节 + 货叉统一收敛，均可独立下发）
+ *  位移字段为比例值 [0,1]，角度字段单位为度（°） */
+export interface Position {
+    /** X 轴位移比例 [0, 1] */
+    x?: number;
+    /** Y 轴位移比例 [0, 1] */
+    y?: number;
+    /** Z 轴位移比例 [0, 1]（按设备类型可选支持） */
+    z?: number;
+    /** 一级关节 / 车体旋转角度（度）：机器人 / RGV */
+    j1?: number;
+    /** 二级关节角度（度）：双关节机器人 */
+    j2?: number;
+    /** 货叉横向移动比例 [0, 1]：RGV */
+    fork_xy?: number;
+    /** 货叉上下移动比例 [0, 1]：RGV */
+    fork_z?: number;
+}
+/** 资源类型（resource_type） */
+export { EnumResourceType as ResourceType };
+/** 资源位置（三级坐标：设备 → 层 → 工位） */
+export interface ResourceLocation {
+    /** 设备类型（校验用） */
+    device_type?: EnumDeviceType;
+    /** 所在设备 ID */
+    device_id: string;
+    /** 设备层索引（1-based），多层设备定位层；缺省第 1 层 */
+    device_layer?: number;
+    /** 设备工位序号（1-based），缺省该设备第一个可用工位 */
+    device_station?: number;
+}
+/** 资源实体（画布侧由对象资源池统一管理） */
+export interface ResourceEntity {
+    resource_id: string;
+    resource_type: EnumResourceType;
+    resource_name?: string;
+    resource_state?: number;
+    /** 显示颜色：服务端可显式下发时使用；未下发时不预设（前端不做 resource_state → 颜色映射，如需映射请在代理器手动配置） */
+    resource_color?: string;
+    location: ResourceLocation | null;
+}
+/** 资源生命周期操作 */
+export declare enum ResourceOperation {
+    Add = "add",
+    BatchAdd = "batch_add",
+    Transfer = "transfer",
+    Remove = "remove",
+    BatchRemove = "batch_remove"
+}
+/** batch_add 的资源项 */
+export interface ResourceAddItem {
+    resource_id: string;
+    resource_type: EnumResourceType;
+    resource_name?: string;
+    resource_state?: number;
+    /** 显示颜色（可选）：显式下发时优先；未下发时按 resource_state 字典映射 */
+    resource_color?: string;
+    to: ResourceLocation;
+}
+/** 机床业务字段 */
+export interface MachineToolFields {
+    /** 工位旋转增量（度）：叠加在机床配置的工位容器方向角之上 */
+    station_rotation?: number;
+    /** 工作中（工位玻璃背景呼吸闪动） */
+    is_working?: boolean;
+}
+/** 接驳站业务字段 */
+export interface ShuttleStationFields {
+    /** 各层状态灯颜色，键为层索引（1-based），值为颜色字符串或字典值 */
+    layer_light_colors?: Record<number, string>;
+    /** 各层状态灯闪烁，键为层索引（1-based） */
+    layer_light_blinking?: Record<number, boolean>;
+    /** 各层显隐，键为层索引（1-based） */
+    layer_visible?: Record<number, boolean>;
+}
+/** 打标机业务字段 */
+export interface MarkingMachineFields {
+    /** 各激光工位是否打标中，键为工位序号（1-based） */
+    marking_sites?: Record<number, boolean>;
+}
+/** device_command payload 公共字段 */
+export interface DeviceCommandPayload {
+    device_type: EnumDeviceType;
+    device_id: string;
+    /** 同设备多实例（多工位 UI）时指定目标实例；缺省广播至全部实例 */
+    device_station?: number;
+    /** 原始业务数据（透传，供点击回调读取） */
+    raw_data?: object;
+    /** 设备状态（状态码）；画布默认不做处理，由使用方按需在代理器自行配置映射 */
+    device_state?: number;
+    light?: SocketLight;
+    progress?: SocketProgress;
+    passage?: SocketPassage;
+    position?: Position;
+    /** 机床：工位旋转增量（度），叠加在机床配置的工位容器方向角之上 */
+    station_rotation?: number;
+    /** 机床 / 清洗机：工作中 */
+    is_working?: boolean;
+    /** 接驳站：层状态 */
+    layer_light_colors?: Record<number, string>;
+    layer_light_blinking?: Record<number, boolean>;
+    layer_visible?: Record<number, boolean>;
+    /** 料道：层显隐 */
+    /** 打标机：激光工位 */
+    marking_sites?: Record<number, boolean>;
+    /** 机器人：当前夹持资源类型（none = 空夹具） */
+    current_fixture?: EnumResourceType | 'none';
+}
+/** resource_command payload（按 operation 判别联合） */
+export type ResourceCommandPayload = {
+    operation: ResourceOperation.Add;
+    resource_id: string;
+    resource_type: EnumResourceType;
+    to: ResourceLocation;
+    resource_name?: string;
+    resource_state?: number;
+    /** 显示颜色（可选）：显式下发时优先；未下发时按 resource_state 字典映射 */
+    resource_color?: string;
+} | {
+    operation: ResourceOperation.BatchAdd;
+    resources: ResourceAddItem[];
+} | {
+    operation: ResourceOperation.Transfer;
+    resource_id: string;
+    resource_type: EnumResourceType;
+    from?: ResourceLocation;
+    to: ResourceLocation;
+    /** 资源名称/状态：资源池实体缺登记时作为前端兜底来源（可选，见文档 8.2） */
+    resource_name?: string;
+    resource_state?: number;
+    /** 显示颜色（可选）：显式下发时优先；未下发时按 resource_state 字典映射 */
+    resource_color?: string;
+} | {
+    operation: ResourceOperation.Remove;
+    resource_id: string;
+    resource_type?: EnumResourceType;
+} | {
+    operation: ResourceOperation.BatchRemove;
+    resource_ids: string[];
+    resource_type?: EnumResourceType;
+};
+/** 初始化资源项（隐含 add 语义） */
+export interface ResourceInitItem {
+    resource_type: EnumResourceType;
+    resource_id: string;
+    /** 设备层索引（1-based），缺省第 1 层 */
+    device_layer?: number;
+    /** 设备工位序号（1-based），缺省该设备第一个可用工位 */
+    device_station?: number;
+    resource_name?: string;
+    resource_state?: number;
+    /** 显示颜色（可选）：显式下发时优先；未下发时按 resource_state 字典映射 */
+    resource_color?: string;
+}
+/** 初始化设备项：结构同 device_command 各设备 payload + resources */
+export interface DeviceInitItem {
+    device_type: EnumDeviceType;
+    device_id: string;
+    /** 同设备多实例时指定目标实例；缺省初始化该设备全部实例 */
+    device_station?: number;
+    /** 设备状态（状态码）；画布默认不做处理，由使用方按需在代理器自行配置映射 */
+    device_state?: number;
+    light?: SocketLight;
+    progress?: SocketProgress;
+    passage?: SocketPassage;
+    position?: Position;
+    /** 机床：工位旋转增量（度），叠加在机床配置的工位容器方向角之上 */
+    station_rotation?: number;
+    is_working?: boolean;
+    layer_light_colors?: Record<number, string>;
+    layer_light_blinking?: Record<number, boolean>;
+    layer_visible?: Record<number, boolean>;
+    marking_sites?: Record<number, boolean>;
+    current_fixture?: EnumResourceType | 'none';
+    /** 初始资源实体列表 */
+    resources?: ResourceInitItem[];
+}
+/** device_init payload */
+export interface DeviceInitPayload {
+    devices: DeviceInitItem[];
+}
+/** 告警推送 */
+export interface AlarmPushPayload {
+    alarm_id: string;
+    device_type?: EnumDeviceType;
+    device_id?: string;
+    device_name?: string;
+    alarm_level: 'critical' | 'warning' | 'info';
+    alarm_type: string;
+    alarm_message: string;
+    current_value?: number;
+    threshold_value?: number;
+    status?: 'pending' | 'acknowledged' | 'resolved';
+    create_time: number;
+    ack_time?: number | null;
+    resolve_time?: number | null;
+}
+/**
+ * 运行状态推送
+ * 说明：本 payload 的字段**全部由后端自定**——确定推送哪些字段、何时推送（状态变化时推送或后端自定周期）由后端决定；
+ * 画布不做强校验、不轮询，也**不直接消费**：经 WsProxy「全局操作类 → 全局运行状态推送」规则手动映射后
+ * （映射产物不进入画布）交给页面全局状态信息 bar 消费。
+ * 下列字段仅为示例：`current_task` 演示普通（标量）字段传递，`device_stats` 演示嵌套（对象）字段传递
+ */
+export interface RuntimeStatusPushPayload {
+    /** 当前任务播报（面向人的一句话描述，如「单抓机器人 搬运 工件2 至 机床1 中…」）——普通字段传递示例 */
+    current_task?: string;
+    /** 设备统计（对象）——嵌套字段传递示例，层级与字段名由后端自定 */
+    device_stats?: Record<string, unknown>;
+    /** 其余业务字段原样透传（后端可自由增减） */
+    [key: string]: unknown;
+}
+/** 场景复位 payload（空） */
+export interface SceneResetPayload {
+}
+/** 指令处理回执（画布 → 后端） */
+export interface CommandAckPayload {
+    /** 被回执的原消息 envelope.id */
+    envelope_id: string;
+    /** 处理结果码：0 成功 / 400 参数错误 / 404 未匹配 / 409 类型不匹配 / 500 异常 */
+    code: number;
+    message?: string;
+}
+/** device_type (snake_case) → 内部画布模型 className（EnumModel PascalCase） */
+export declare const DEVICE_TYPE_TO_MODEL: Record<EnumDeviceType, string>;
+/** 内部画布模型 className（EnumModel PascalCase）→ device_type（snake_case） */
+export declare const MODEL_TO_DEVICE_TYPE: Record<string, EnumDeviceType>;

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

@@ -1,9 +1,20 @@
-import { ILayer, IEventHandler, ILayerOperating } from '../../types';
+import { ILayer, InteractiveUi, IEventHandler, ILayerOperating, EnumResourceType } from '../../types';
 import { StationSlotGroup } from '../components/StationSlotGroup';
+import { AppController } from '../../controller/AppController';
 import { BaseAbs } from './BaseAbs';
 export declare abstract class ModelAbs<T extends ILayer = ILayer> extends BaseAbs<T> {
-    private eventHandler;
+    protected eventHandler: IEventHandler | null;
+    /**
+     * 画布控制器引用（AppController.addModel 时注入，早于 init）
+     * 供子类反查画布全局信息（如扩展工位宿主设备），模型间不直接互相引用
+     */
+    appController: AppController | null;
     protected abstract operating(data: ILayerOperating): void;
+    /**
+     * 设备沿 x 移动的动画时长（秒）
+     * 托盘跟随等联动使用该值保持动画同步；子类可覆盖（如双关节机器人 0.5s）
+     */
+    get moveDuration(): number;
     handleOperation: (data: ILayerOperating) => void;
     /**
      * 将最近一次 operating 接收到的原始数据写入模型 config 及整棵 UI 树的 data 属性，
@@ -12,6 +23,11 @@ export declare abstract class ModelAbs<T extends ILayer = ILayer> extends BaseAb
     private writeOperatingData;
     private shouldHandleInteraction;
     private tapCallback;
+    /**
+     * 点击回调分发（子类可覆盖以改写 layer / data，如扩展工位绑定模式下托盘点击需替换为宿主设备）
+     * 默认：layer 为模型自身 config，data 为实际命中元素的 data 属性
+     */
+    protected emitTap(data: InteractiveUi): void;
     private menuTapCallback;
     private dragCallback;
     setEventHandler(handler: IEventHandler): void;
@@ -24,6 +40,30 @@ export declare abstract class ModelAbs<T extends ILayer = ILayer> extends BaseAb
      * 收集模型下所有工位槽组实例（子类覆盖；默认无）
      */
     protected collectStationSlotGroups(): StationSlotGroup[];
+    /**
+     * 判断模型是否存在指定序号的工位（任一工位组；多层设备按 device_layer 定位层，覆盖于子类）
+     */
+    hasStationIndex(stationIndex: number, _deviceLayer?: number): boolean;
+    /**
+     * 判断指定工位是否可放置该资源类型（运行期资源类型强校验，见 socket-operating-api.md 4.3）
+     * 多工位组设备（如资源库的托盘组/刀具组）存在同序号工位时，任一组声明可放置即通过（与模型资源路由一致）
+     */
+    acceptsResourceType(stationIndex: number, resourceType: EnumResourceType, _deviceLayer?: number): boolean;
+    /**
+     * 查找第一个可放置指定资源类型的工位序号（device_station 缺省时定位「第一个可用工位」，见文档 3.3）
+     */
+    findFirstStationIndex(resourceType: EnumResourceType): number | undefined;
+    /**
+     * 获取模型工位总数（扩展工位合并编号的偏移量计算用）
+     */
+    getStationSlotCount(): number;
+    /**
+     * 获取指定工位槽中心的场景坐标（treeBox 本地坐标系，供 transfer 搬运动画规划路径）
+     */
+    getStationSlotPoint(stationIndex: number, _deviceLayer?: number): {
+        x: number;
+        y: number;
+    } | undefined;
     /**
      * 按 resourceId 移除模型下匹配的资源（供全局批量移除调用）
      * @returns 是否至少移除了一个资源

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

@@ -4,5 +4,4 @@ import { ComponentAbs } from '../abstract/ComponentAbs';
 export declare class Resource extends ComponentAbs<IResourceConfig> {
     constructor(options: IResourceConfig);
     protected createUi(): Box;
-    private get autoCornerRadius();
 }

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

@@ -22,12 +22,18 @@ export declare class StationSlot extends ComponentAbs<IStationSlotConfig> {
     private syncResources;
     protected createUi(): Box;
     private get autoFixRotation();
-    private get autoCornerRadius();
     /**
-     * 添加托盘
+     * 添加工位资源
      * @param d
      */
     addPallet(d: IResourceOperating): void;
+    /**
+     * 资源数量门控：children 超过 maxResources（默认 5）时，
+     * 按放置顺序移除最早的资源（先进先出淘汰，保留最近 N 个），移除时播放退场动画
+     */
+    private enforceMaxResources;
+    /** 播放资源退场动画，动画结束后销毁资源对象（供移除/裁剪共用） */
+    private animateOut;
     /**
      * 移除托盘：先播放退场动画，动画结束后再销毁资源对象
      */

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

@@ -1,5 +1,5 @@
 import { Flow } from 'leafer';
-import { IResourceOperating, IStationSlotGroupConfig } from '../../types';
+import { IResourceOperating, IStationSlotGroupConfig, EnumResourceType } from '../../types';
 import { ComponentAbs } from '../abstract/ComponentAbs';
 /**
  * 工位槽位组容器
@@ -32,11 +32,36 @@ 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;
     /**
      * 判断本组是否包含指定工位序号
      */
     hasStationIndex(index: number): boolean;
+    /**
+     * 获取本组工位总数（扩展工位合并编号的偏移量计算用）
+     */
+    getStationCount(): number;
+    /**
+     * 查询指定工位声明的可放置资源类型（强校验用，见 socket-operating-api.md 4.3）
+     * @returns 工位存在时返回其 resourceType；工位不存在返回 undefined
+     */
+    getStationResourceType(index: number): EnumResourceType | undefined;
+    /**
+     * 判断指定工位是否可放置该资源类型（强校验用，见 socket-operating-api.md 4.3）
+     * 多工位组设备（如资源库的托盘组/刀具组）存在同序号工位时，任一组声明可放置即通过
+     */
+    acceptsResourceType(index: number, resourceType: EnumResourceType): boolean;
+    /**
+     * 查找第一个可放置指定资源类型的工位序号（device_station 缺省时定位「第一个可用工位」，见文档 3.3）
+     */
+    findFirstStationIndex(resourceType: EnumResourceType): number | undefined;
+    /**
+     * 获取指定工位槽中心的场景坐标（treeBox 本地坐标系，供 transfer 搬运动画规划路径）
+     */
+    getStationSlotPoint(index: number): {
+        x: number;
+        y: number;
+    } | undefined;
 }

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

@@ -12,16 +12,28 @@ export declare class DoubleJointRobot extends ModelAbs<IDoubleJointRobotConfig>
     private light1;
     private light2;
     private defaultLightColor;
-    private stationSlotGroupPallet;
-    private stationSlotGroupTool;
-    get currentFixture(): EnumResourceType;
-    set currentFixture(type: EnumResourceType);
+    /** 全部工位层工位组（一层=一组），挂载于唯一容器 #slotLayers，与夹具无关 */
+    private slotGroups;
+    /** 与 slotGroups 平行的层 index（1-based），用于夹具绑定层的显隐与资源层索引映射 */
+    private slotLayerIndexes;
+    get currentFixture(): EnumResourceType | 'none';
+    set currentFixture(type: EnumResourceType | 'none');
+    /** 移动动画时长：与 moveX 默认 0.5s 一致，供托盘跟随等联动同步 */
+    get moveDuration(): number;
     protected createUi(): Box;
     protected operating(data: IDoubleJointRobotOperating): void;
+    /** 资源路由（与夹具装饰无关）：device_layer 层号优先（当前夹具绑定了层时以绑定层为索引基准），其次工位号（优先类型匹配），最后首个工位组 */
+    private findGroupForResource;
+    /** 层索引解析：当前夹具绑定了工位层时，以绑定层（按层号升序）为索引基准（device_layer=1 → 第一个绑定层）；未绑定或越界时回退原始层号 */
+    private resolveBoundLayerIndex;
+    /** 应用夹具绑定的工位层显隐：绑定了层的夹具仅显示绑定层（保留各组 Display 配置），未绑定时显示全部层 */
+    private applyFixtureBindingVisibility;
     protected collectStationSlotGroups(): StationSlotGroup[];
     private handleRotateR1;
     private handleRotateR2;
     private moveX;
     private switchFork;
+    /** 设置托盘夹具状态：辅料夹具沿用工件夹具造型，压扁 + 直角 + 描边补偿，并补偿 y 使垂直中心对齐手抓关节 */
+    private setPalletFixture;
     handleLoadResource(handleType: 'add' | 'remove'): void;
 }

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

@@ -15,11 +15,15 @@ export declare class MachineTool extends ModelAbs<IMachineToolConfig> {
     /** 工位容器玻璃背景（isWorking 时呼吸闪动） */
     private glass;
     private stationContainerBaseRotation;
-    private animating;
+    /** 工位旋转增量（度）：叠加在机床配置的工位容器方向角之上 */
+    private stationRotation;
     protected createUi(): Box;
     protected operating(data: IMachineToolOperating): void;
+    /**
+     * 工位旋转 = 机床配置的工位容器方向角 + station_rotation 增量（带 0.2s 过渡动画；动画关闭时直接赋值）
+     */
+    private applyStationRotation;
     /** 玻璃背景呼吸效果：工作中开启动画（明暗往复），结束恢复常亮 */
     private setWorking;
     protected collectStationSlotGroups(): StationSlotGroup[];
-    private rotateStationContainerWithAnimation;
 }

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

@@ -1,6 +1,7 @@
-import { IMaterialTrackConfig, IMaterialTrackOperating } from '../../types';
+import { IMaterialTrackConfig, IMaterialTrackOperating, EnumResourceType } from '../../types';
 import { Box } from 'leafer';
 import { ModelAbs } from '../abstract/ModelAbs';
+import { StationSlotGroup } from '../components/StationSlotGroup';
 /**
  * 料道（MaterialTrack）
  * 参考接驳站的 U 型多层结构，主体为淡蓝色；
@@ -26,6 +27,17 @@ export declare class MaterialTrack extends ModelAbs<IMaterialTrackConfig> {
     private buildLayers;
     protected createUi(): Box;
     protected operating(data: IMaterialTrackOperating): void;
-    /** 资源增删：data.resource 提供 layer(>0) 时定位到该层；缺省时仅当唯一一层包含该工位序号才操作 */
+    /** 资源增删：data.resource 提供 device_layer(>0) 时定位到该层；缺省时仅当唯一一层包含该工位序号才操作 */
     private handleResourceOperating;
+    /** 收集全部层工位槽组（供全局资源移除 / 工位查询遍历） */
+    protected collectStationSlotGroups(): StationSlotGroup[];
+    /** 层感知工位存在性判断（覆盖通用实现：按 device_layer 定位层，缺省取第一层） */
+    hasStationIndex(stationIndex: number, deviceLayer?: number): boolean;
+    /** 层感知工位类型强校验（覆盖通用实现：按 device_layer 定位层，缺省取第一层） */
+    acceptsResourceType(stationIndex: number, resourceType: EnumResourceType, deviceLayer?: number): boolean;
+    /** 层感知工位坐标查询（覆盖通用实现：按 device_layer 定位层，缺省取第一层） */
+    getStationSlotPoint(stationIndex: number, deviceLayer?: number): {
+        x: number;
+        y: number;
+    } | undefined;
 }

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

@@ -1,28 +1,48 @@
-import { IPalletConfig, IPalletOperating } from '../../types';
+import { IPalletConfig, IPalletOperating, InteractiveUi, EnumResourceType } from '../../types';
 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 / position / resource（按层定位，layer 缺省默认识别为第一层）
  */
 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;
-    /** 按工位序号修改工位背景颜色：在托盘/刀具工位组中查找包含该序号的工位槽并改色 */
-    private applyStationColor;
+    /** 资源增删：data.resource 提供 device_layer(>0) 时定位到该层；缺省时默认识别为第一层 */
+    private handleResourceOperating;
     /**
      * 判断本托盘是否包含指定工位号
      * 用于同一 id 的 Pallet 被拆分为多个 UI 时的三级匹配
      */
     containsStationIndex(index: number): boolean;
     protected collectStationSlotGroups(): StationSlotGroup[];
+    /** 层感知工位存在性判断（覆盖通用实现：按 device_layer 定位层，缺省取第一层） */
+    hasStationIndex(stationIndex: number, deviceLayer?: number): boolean;
+    /** 层感知工位类型强校验（覆盖通用实现：按 device_layer 定位层，缺省取第一层） */
+    acceptsResourceType(stationIndex: number, resourceType: EnumResourceType, deviceLayer?: number): boolean;
+    /** 层感知工位坐标查询（覆盖通用实现：按 device_layer 定位层，缺省取第一层） */
+    getStationSlotPoint(stationIndex: number, deviceLayer?: number): {
+        x: number;
+        y: number;
+    } | undefined;
+    /**
+     * 扩展工位点击视图改写（覆盖 emitTap）：
+     * 本托盘绑定 extendHostId 且点击的是工位槽时，layer 替换为宿主设备 config（该工位逻辑上属于宿主工位编号空间），
+     * data 克隆并改写 index 为合并编号（宿主工位总数 + 前序扩展托盘工位总数 + 本托盘局部序号），
+     * 同时保留 extensionOf（宿主业务 id）/ localIndex（托盘局部序号）两个溯源字段；
+     * 未绑定宿主或点击非工位区域时保持默认行为（layer 为托盘自身 config）
+     */
+    protected emitTap(data: InteractiveUi): void;
 }

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;
     /** 环状矩形外壁填充色 */
@@ -28,7 +30,6 @@ export declare class ResourceOperationWindow extends ModelAbs<IResourceOperation
     private buildOutlinePath;
     protected createUi(): Box;
     protected operating(data: IResourceOperationWindowOperating): void;
-    private applyStationColor;
     /**
      * 判断本窗口是否包含指定工位号
      */

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

@@ -4,22 +4,24 @@ import { ModelAbs } from '../abstract/ModelAbs';
 import { StationSlotGroup } from '../components/StationSlotGroup';
 /**
  * 资源库
- * operating 支持：light / x / resource（托盘、刀具增删）/ stationColor（按工位序号修改工位背景颜色）
+ * operating 支持：light / position / resource（工件、刀具、辅料增删）
+ * 统一「工位配置（层级）」模型：stationSlotGroups[] 每层一个工位组，
+ * 外层容器按设备级 flowOptions 对全部工位层整体排布（方向/换行/间距/宽高），hideBounds 控制容器边界显示。
  */
 export declare class ResourceStore extends ModelAbs<IResourceStoreConfig> {
     private static readonly CORNER_RADIUS;
     private light;
-    private stationSlotGroupPallet;
-    private stationSlotGroupTool;
+    /** 按层顺序保存的工位组实例（下标对应层序） */
+    private stationSlotGroups;
     protected createUi(): Box;
     /**
      * 判断本资源库是否包含指定工位号
      * 用于同一 id 的 ResourceStore 被拆分为多个 UI 时的三级匹配
      */
     containsStationIndex(index: number): boolean;
+    /** 定位资源所在的工位组：优先按 device_layer 层号，其次按工位序号在工作位组中匹配，缺省回退资源类型 */
+    private findGroupForResource;
     private moveX;
     protected operating(data: IResourceStoreOperating): void;
-    /** 按工位序号修改工位背景颜色：在托盘/刀具工位组中查找包含该序号的工位槽并改色 */
-    private applyStationColor;
     protected collectStationSlotGroups(): StationSlotGroup[];
 }

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

@@ -12,23 +12,23 @@ export declare class Rgv extends ModelAbs<IRGVConfig> {
     private light1;
     private light2;
     private defaultLightColor;
-    private stationSlotGroupPallet;
-    private stationSlotGroupTool;
+    /** 全部工位层工位组（一层=一组），挂载于唯一容器 #slotLayers，不区分托盘/刀具工位组 */
+    private slotGroups;
     protected createUi(): Box;
     protected operating(data: IRGVOperating): void;
+    /** 资源路由：device_layer 层号优先，其次工位号（优先类型匹配），最后首个工位组 */
+    private findGroupForResource;
     protected collectStationSlotGroups(): StationSlotGroup[];
     private handleRotate;
     private moveX;
     /**
-     * forks 前后移动
+     * forks 前后移动（直接赋值，高频移动不走动画）
      * @param percent 移动比例，[-1,1]
-     * @param duration 动画持续时间
      */
     private handleForkMove;
     /**
-     * forks 上下移动
+     * forks 上下移动（直接赋值，高频移动不走动画）
      * @param percent 移动比例，[0,1]
-     * @param duration 动画持续时间
      */
     private handleForkMoveUpDown;
 }