@jnrs/lingshu-smart 2.2.34 → 2.2.36

package/AGENTS.md

@@ -29,7 +29,7 @@ import type { ICase } from '@/types'
 import LingshuSmartEditor from '@/components/editor/index.vue'
 
 const loadCases = async (requestId?: string): Promise<ICase[]> => {
-  const res = await fetch(`/json/cases.json?requestId=${requestId}`)
+  const res = await fetch(`/lingshu-smart/cases.json?requestId=${requestId}`)
   const data = await res.json()
   return data.data
 }
@@ -476,6 +476,7 @@ onMounted(() => {
 type ILayerOperating =
   | IMachineToolOperating
   | ILoadingStationOperating
+  | IShuttleStationOperating
   | IMarkingMachineOperating
   | ICleaningMachineOperating
   | ISingleJointRobotOperating
@@ -483,6 +484,7 @@ type ILayerOperating =
   | IRGVOperating
   | IRailOperating
   | IResourceStoreOperating
+  | IPalletOperating
 ```
 
 ### 子类型一览
@@ -491,6 +493,7 @@ type ILayerOperating =
 | ---------------------------- | -------------------- | ------------------------------------------------------------------ | -------------------------------------------------- | ------------------ |
 | `IMachineToolOperating`      | `MACHINE_TOOL`       | `light?`, `progress?`, `entrance?`, `stationRotatable?`            | 状态灯（含旋转）、进度条、出入口、工位槽           | `MachineTool`      |
 | `ILoadingStationOperating`   | `LOADING_STATION`    | `light?`, `progress?`, `entrance?`, `stationRotatable?`            | 状态灯（无旋转）、进度条、出入口、工位槽           | `LoadingStation`   |
+| `IShuttleStationOperating`   | `SHUTTLE_STATION`    | `light?`, `layerStatus?`                                           | 状态灯、多工位层状态灯                             | `ShuttleStation`   |
 | `IMarkingMachineOperating`   | `MARKING_MACHINE`    | `light?`, `progress?`, `entrance?`, `laserSiteNumberArray?`        | 状态灯、进度条、出入口、工位槽、激光工位指示       | `MarkingMachine`   |
 | `ICleaningMachineOperating`  | `CLEANING_MACHINE`   | `light?`, `progress?`, `entrance?`                                 | 状态灯、进度条、出入口、工位槽                     | `CleaningMachine`  |
 | `ISingleJointRobotOperating` | `SINGLE_JOINT_ROBOT` | `light?`, `x?`, `y?`, `j1?`, `currentFixture?`, `resource?`        | 双状态灯、轨道位移、关节旋转、夹具切换、双工位槽   | `SingleJointRobot` |
@@ -498,6 +501,7 @@ type ILayerOperating =
 | `IRGVOperating`              | `RGV`                | `light?`, `x?`, `j1?`, `forkXY?`, `forkZ?`, `resource?`            | 双状态灯、轨道位移、旋转、货叉 XY/Z、双工位槽      | `Rgv`              |
 | `IRailOperating`             | `RAIL`               | `x?`, `botId?`                                                     | 拖链动画（关联 botId 的设备移动时拖链跟随）        | `Rail`             |
 | `IResourceStoreOperating`    | `RESOURCE_STORE`     | `light?`, `x?`, `resource?`                                        | 状态灯、轨道位移、托盘/刀具工位槽                  | `ResourceStore`    |
+| `IPalletOperating`           | `PALLET`             | `light?`, `x?`, `y?`                                               | 状态灯、X/Y 位移                                   | `Pallet`           |
 
 ### 子类型字段详情
 
@@ -521,6 +525,15 @@ type ILayerOperating =
 | `stationRotatable` | `boolean`                           | 工位容器方向   |
 | `resource`         | `IResourceOperating`                | 工位槽资源     |
 
+#### IShuttleStationOperating
+
+| 属性          | 类型                                | 说明                                                            |
+| ------------- | ----------------------------------- | --------------------------------------------------------------- |
+| `light`       | `Omit<ILightOperating, 'rotating'>` | 状态灯（不支持旋转灯效）                                        |
+| `layerStatus` | `Record<number, number \| string>`  | 各层工位组状态灯：键为层索引（1-based），值为状态码或颜色字符串 |
+
+> `layerStatus` 在代理器中通过 `dictColorMap` 转换后值为颜色字符串；未转换时值为状态数字码。
+
 #### IMarkingMachineOperating
 
 | 属性                   | 类型                                | 说明               |
@@ -596,6 +609,14 @@ type ILayerOperating =
 | `x`        | `number`             | 沿轨道位移（像素，随行托场景） |
 | `resource` | `IResourceOperating` | 托盘/刀具工位槽增删            |
 
+#### IPalletOperating
+
+| 属性    | 类型              | 说明                    |
+| ------- | ----------------- | ----------------------- |
+| `light` | `ILightOperating` | 状态灯                  |
+| `x`     | `number`          | 沿 X 轴移动位置（像素） |
+| `y`     | `number`          | 沿 Y 轴移动位置（像素） |
+
 ### 子组件运转类型（IComponentOperating）
 
 被 `ILayerOperating` 各字段引用的子组件操作类型，定义于 `src/types/components/operating.types.ts`：
@@ -699,15 +720,18 @@ type ILayerOperating =
 
 ### 架构
 
-| 模块                               | 职责                                                             |
-| ---------------------------------- | ---------------------------------------------------------------- |
-| `utils/logger.ts`                  | 统一日志工具，支持 tag 着色、LogLevel 过滤、`operating` 追踪级别 |
-| `utils/debug-flags.ts`             | 模块级动画标志位，供 UI 组件直接导入控制循环动画                 |
-| `utils/performance-stats.ts`       | 性能统计工具，记录运行时长和 WebSocket 数据接收量                |
-| `stores/useDebugStore.ts`          | 全局调试配置 Pinia store，localStorage 持久化                    |
-| `composables/useDebugEasterEgg.ts` | 调试触发检测：500ms 内 10 次点击打开面板                         |
-| `components/debug/DebugPanel.vue`  | 调试配置对话框 UI                                                |
-| `controller/AppController.ts`      | 提供 `toggleShadows` / `toggleAnimations` / `setFps` 方法        |
+| 模块                                       | 职责                                                                                                                                                                                                                                                                |
+| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `utils/logger.ts`                          | 统一日志工具，支持 tag 着色、LogLevel 过滤、`operating` 追踪级别                                                                                                                                                                                                    |
+| `utils/debug-flags.ts`                     | 模块级动画标志位，供 UI 组件直接导入控制循环动画                                                                                                                                                                                                                    |
+| `utils/performance-stats.ts`               | 性能统计工具，记录运行时长和 WebSocket 数据接收量                                                                                                                                                                                                                   |
+| `stores/useDebugStore.ts`                  | 全局调试配置 Pinia store，localStorage 持久化                                                                                                                                                                                                                       |
+| `composables/useDebugEasterEgg.ts`         | 调试触发检测：500ms 内 10 次点击打开面板                                                                                                                                                                                                                            |
+| `components/debug/DebugPanel.vue`          | 调试配置对话框 UI                                                                                                                                                                                                                                                   |
+| `components/debug/ScriptRunner/`           | Socket 脚本模拟器：脚本步骤编排、断点调试、消息结构配置（code/msg、payload 字段名、type）、日志查看                                                                                                                                                                 |
+| `components/debug/WsProxy/`                | WebSocket 代理器：声明式字段映射将后端 socket 结构桥接为 operating，支持连接/断开/重连、日志、配置导出/导入、场景像素换算（percentToPixel 百分比/ runtimeToPixel 运行时坐标）、standalone 独立标签页模式 / remote 远程接收模式（BroadcastChannel 跨标签页流转数据） |
+| `components/debug/WsProxy/WsProxyPage.vue` | `WsProxy` 独立路由页面组件：以独立 URL/标签页运行代理器配置，将 operating/raw/状态广播给预览页驱动图形运转                                                                                                                                                          |
+| `controller/AppController.ts`              | 提供 `toggleShadows` / `toggleAnimations` / `setFps` 方法                                                                                                                                                                                                           |
 
 ### 日志系统
 

package/README.md

@@ -6,13 +6,14 @@
 
 ### 核心功能
 
-| 功能       | 说明                                                                                                  |
-| ---------- | ----------------------------------------------------------------------------------------------------- |
-| 编辑器模式 | `LingshuSmartEditor` — 方案可视化编辑，支持拖拽布局、设备配置、图层管理、方案保存/预览                |
-| 运行看板   | `LingshuSmartPreview` — 方案运行看板，支持 WebSocket 实时驱动设备动画、交互事件（点击/拖拽/右键菜单） |
-| 设备模型   | 机床、机器人（单关节/双关节）、RGV、装载站、打标机、清洗机、轨道拖链、资源库等                        |
-| 设备运转   | 灯光、进度条、入口动画、工位槽资源增删、坐标/角度/货叉控制                                            |
-| 坐标转换   | `transRuntimeToPixel` / `transPercentToPixel` — 物理坐标与像素坐标互转                                |
+| 功能             | 说明                                                                                                                                                                                   |
+| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 编辑器模式       | `LingshuSmartEditor` — 方案可视化编辑，支持拖拽布局、设备配置、图层管理、方案保存/预览                                                                                                 |
+| 运行看板         | `LingshuSmartPreview` — 方案运行看板，支持 WebSocket 实时驱动设备动画、交互事件（点击/拖拽/右键菜单）                                                                                  |
+| 设备模型         | 机床、机器人（单关节/双关节）、RGV、装载站、打标机、清洗机、轨道拖链、资源库、托盘等                                                                                                   |
+| 设备运转         | 灯光、进度条、入口动画、工位槽资源增删、坐标/角度/货叉控制                                                                                                                             |
+| 坐标转换         | `transRuntimeToPixel` / `transPercentToPixel` — 物理坐标与像素坐标互转                                                                                                                 |
+| WebSocket 代理器 | `WsProxy` — 声明式字段映射将后端 socket 数据桥接为 operating 驱动设备动画；支持内置请求器/外接注入两种数据源、direct/proxy 请求模式、自动连接开关、按 type 分类代理配置及配置导出/导入 |
 
 ## 💻 技术栈
 

package/dist/components/debug/DataLogPanel.vue.d.ts

@@ -0,0 +1,44 @@
+import { ILayerOperating } from '../../types';
+export interface LogEntry {
+    datetime: string;
+    type: string;
+    traceId: string;
+    payload: any;
+}
+export type LogDirection = 'send' | 'receive';
+export interface WsProxyLogEntry {
+    datetime: string;
+    direction: LogDirection;
+    data: any;
+}
+export type RunLogEntry = ILayerOperating;
+type __VLS_Props = {
+    logs: any[];
+    maxLogCount: number;
+    snapshot: boolean;
+    /** 边框左上角区域名称（如 模拟消息日志 / 消息日志 / 运行日志） */
+    title?: string;
+    /** 数据列表头名称 */
+    dataLabel?: string;
+    /** 数据单元格渲染函数 */
+    textFn?: (row: any) => string;
+    /** 是否展示方向/类型列（WsProxy 消息日志专用） */
+    showDirectionType?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    copy: () => any;
+    clear: () => any;
+    "update:maxLogCount": (value: number) => any;
+    "toggle-snapshot": () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onCopy?: (() => any) | undefined;
+    onClear?: (() => any) | undefined;
+    "onUpdate:maxLogCount"?: ((value: number) => any) | undefined;
+    "onToggle-snapshot"?: (() => any) | undefined;
+}>, {
+    title: string;
+    dataLabel: string;
+    textFn: (row: any) => string;
+    showDirectionType: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/components/debug/ScriptRunner/ConfigPanel.vue.d.ts

@@ -12,24 +12,27 @@ type __VLS_Props = {
     deviceOptions: DeviceOption[];
     resourceDeviceOptions: DeviceOption[];
     statusDisplayColor: string;
-    selectedDeviceValue: string;
-    addDeviceValue: string;
-    removeDeviceValue: string;
+    selectedDeviceValue: DeviceOption | null;
+    addDeviceValue: DeviceOption | null;
+    removeDeviceValue: DeviceOption | null;
+    customData: string;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    copy: (uid: string) => any;
     delete: (uid: string) => any;
-    "update:selectedDeviceValue": (value: string) => any;
-    "update:addDeviceValue": (value: string) => any;
-    "update:removeDeviceValue": (value: string) => any;
+    copy: (uid: string) => any;
+    "update:selectedDeviceValue": (value: DeviceOption | null) => any;
+    "update:addDeviceValue": (value: "" | DeviceOption) => any;
+    "update:removeDeviceValue": (value: "" | DeviceOption) => any;
+    "update:customData": (value: string) => any;
     "move-up": (uid: string) => any;
     "move-down": (uid: string) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onCopy?: ((uid: string) => any) | undefined;
     onDelete?: ((uid: string) => any) | undefined;
-    "onUpdate:selectedDeviceValue"?: ((value: string) => any) | undefined;
-    "onUpdate:addDeviceValue"?: ((value: string) => any) | undefined;
-    "onUpdate:removeDeviceValue"?: ((value: string) => any) | undefined;
+    onCopy?: ((uid: string) => any) | undefined;
+    "onUpdate:selectedDeviceValue"?: ((value: DeviceOption | null) => any) | undefined;
+    "onUpdate:addDeviceValue"?: ((value: "" | DeviceOption) => any) | undefined;
+    "onUpdate:removeDeviceValue"?: ((value: "" | DeviceOption) => any) | undefined;
+    "onUpdate:customData"?: ((value: string) => any) | undefined;
     "onMove-up"?: ((uid: string) => any) | undefined;
     "onMove-down"?: ((uid: string) => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;

package/dist/components/debug/ScriptRunner/StepsPanel.vue.d.ts

@@ -1,4 +1,11 @@
 import { ScriptStep, ScriptTemplate } from './script';
+/** 设备/资源下拉选项 */
+interface DeviceOption {
+    label: string;
+    value: string;
+    className: string;
+    nameplate: string;
+}
 type __VLS_Props = {
     scriptSteps: ScriptStep[];
     selectedStepUid: string;
@@ -13,6 +20,7 @@ type __VLS_Props = {
     allChecked: boolean;
     isIndeterminate: boolean;
     scriptTemplates: ScriptTemplate[];
+    deviceOptions: DeviceOption[];
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     add: () => any;

package/dist/components/debug/ScriptRunner/script.d.ts

@@ -1,6 +1,6 @@
 /**
  * @File   : script.ts
- * @Desc.  : 模拟运行脚本的设备字段配置与预设模板
+ * @Desc.  : 脚本模拟器的设备字段配置与预设模板
  */
 /** 字段配置 */
 export interface ScriptFieldConfig {
@@ -24,6 +24,18 @@ export interface ScriptStep {
     delay: number;
     enabled: boolean;
     params: Record<string, any>;
+    /** 返回码（0 操作成功 / 400 客户端参数错误 / 500 服务端处理异常） */
+    code: number;
+    /** 返回消息说明（可选 code 自动带入后可修改） */
+    msg: string;
+    /** 消息体字段名：'data' 或 'payload' */
+    payloadKey: 'data' | 'payload';
+    /** 顶层 type 值（可自由配置，默认 'update'） */
+    msgType: string;
+    /** 自定义业务数据 JSON 文本（设备/资源选择「自定义」时启用，作为业务数据） */
+    customData?: string;
+    /** type 字段覆盖值：设置后业务数据中的 type 使用此值而非 deviceType */
+    typeOverride?: string;
 }
 /** 脚本模板 */
 export interface ScriptTemplate {
@@ -36,6 +48,8 @@ export declare const deviceTypeOptions: {
     label: string;
     value: string;
 }[];
+/** 设备/资源下拉「自定义」选项的标识值（选中后编辑自定义业务数据 JSON） */
+export declare const CUSTOM_DEVICE_TYPE = "__custom__";
 /** 资源类型选项 */
 export declare const resourceTypeOptions: {
     label: string;
@@ -50,6 +64,20 @@ export interface CommonStatusOption {
 export declare const commonDict: CommonStatusOption[];
 /** 资源状态字典：资源增删专用，状态值/文本/颜色三要素 */
 export declare const resourceDict: CommonStatusOption[];
+/** 返回码字典：code / 说明，供「返回码」下拉与 msg 自动带入使用 */
+export interface CodeOption {
+    label: string;
+    value: number;
+}
+export declare const codeDict: CodeOption[];
+/** 默认消息体字段名 */
+export declare const defaultPayloadKey: 'data' | 'payload';
+/** 默认顶层 type 值 */
+export declare const defaultMsgType = "update";
+/** 默认返回码 */
+export declare const defaultCode = 0;
+/** 默认返回说明 */
+export declare const defaultMsg = "\u64CD\u4F5C\u6210\u529F";
 /** 可作为资源容器的设备类型 */
 export declare const containerDeviceOptions: {
     label: string;

package/dist/components/debug/WsProxy/ConfigEditor.vue.d.ts

@@ -0,0 +1,18 @@
+import { WsProxyConfig } from './proxy';
+type __VLS_Props = {
+    config: WsProxyConfig;
+    /** 配置来源：localFile 本地文件 / store 持久化配置（含用户手动修改场景） */
+    configSource: 'localFile' | 'store';
+    /** 用户是否已手动修改配置（configSource 为 store 时区分「本地文件异常」与「已手动修改配置」） */
+    manualModified?: boolean;
+    /** 是否已配置 dictFn（用于「字典 Label / 字典 Color」选项右侧 tag 显示） */
+    hasDictFn?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    reset: (value: WsProxyConfig) => any;
+    "update:config": (value: WsProxyConfig) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onReset?: ((value: WsProxyConfig) => any) | undefined;
+    "onUpdate:config"?: ((value: WsProxyConfig) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/components/debug/WsProxy/ConnPanel.vue.d.ts

@@ -0,0 +1,33 @@
+import { WsProxyRequestMode } from './proxy';
+type __VLS_Props = {
+    url: string;
+    /** 请求模式：direct 直接请求 / proxy 代理请求 */
+    requestMode: WsProxyRequestMode;
+    /** 是否自动连接：组件挂载且 wsUrl 有效时自动建立 WebSocket 连接 */
+    autoConnect: boolean;
+    isConnected: boolean;
+    isConnecting: boolean;
+    stateInfo: string;
+    /** 心跳检测间隔（秒）：0=关闭 */
+    heartbeatInterval: number;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    disconnect: () => any;
+    send: (data: string) => any;
+    "update:url": (value: string) => any;
+    "update:requestMode": (value: WsProxyRequestMode) => any;
+    "update:autoConnect": (value: boolean) => any;
+    "update:heartbeatInterval": (value: number) => any;
+    connect: () => any;
+    reconnect: () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onDisconnect?: (() => any) | undefined;
+    onSend?: ((data: string) => any) | undefined;
+    "onUpdate:url"?: ((value: string) => any) | undefined;
+    "onUpdate:requestMode"?: ((value: WsProxyRequestMode) => any) | undefined;
+    "onUpdate:autoConnect"?: ((value: boolean) => any) | undefined;
+    "onUpdate:heartbeatInterval"?: ((value: number) => any) | undefined;
+    onConnect?: (() => any) | undefined;
+    onReconnect?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/components/debug/WsProxy/index.vue.d.ts

@@ -0,0 +1,36 @@
+import { ILayerOperating, IScene } from '../../../types';
+import { WsProxyConfig, ProxyRule, DictFn } from './proxy';
+type __VLS_Props = {
+    /** 是否自动应用注入的消息（父组件调用 expose 的 feedMessage 时） */
+    autoApply?: boolean;
+    /** 初始配置 */
+    config?: WsProxyConfig;
+    /** 场景信息：用于字段映射中 percentToPixel 换算（如 currentCase.scene） */
+    scene?: IScene | null;
+    /** 字典转换函数：用于「字典 Label / 字典 Color」特殊处理
+     *  入参 (name: string, value?: string|number, type: 'label'|'color')，返回 string 赋给画布字段 */
+    dictFn?: DictFn;
+    /** 认证 token：作为 WebSocket 子协议（subprotocol）附带在连接请求中（参考 useWebSocket 的 token 用法） */
+    token?: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {
+    open: () => void;
+    feedMessage: (rawMessage: any) => void;
+    setConfig: (cfg: WsProxyConfig) => void;
+    isConnected: import('vue').Ref<boolean, boolean>;
+    rules: import('vue').ComputedRef<ProxyRule[]>;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    operating: (data: ILayerOperating) => any;
+    raw: (data: unknown) => any;
+    "status-change": (connected: boolean) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onOperating?: ((data: ILayerOperating) => any) | undefined;
+    onRaw?: ((data: unknown) => any) | undefined;
+    "onStatus-change"?: ((connected: boolean) => any) | undefined;
+}>, {
+    scene: IScene | null;
+    config: WsProxyConfig;
+    autoApply: boolean;
+    token: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/debug/WsProxy/proxy.d.ts

@@ -0,0 +1,171 @@
+import { ILayerOperating, IScene } from '../../../types';
+/** 条件判断项：当源值满足 operator + operand 条件时，将 value 赋给画布字段 */
+export interface ConditionRule {
+    /** 比较运算符 */
+    operator: 'eq' | 'ne' | 'gt' | 'lt' | 'gte' | 'lte' | 'includes' | 'in';
+    /** 比较目标值（'in' 运算符时为逗号分隔的列表，如 '1,2,3'） */
+    operand: string;
+    /** 条件为 true 时赋给画布字段的值 */
+    value: string | number | boolean;
+}
+/** 字段映射项：将一个 operating 目标字段映射到 payload 源字段/常量/值映射 */
+export interface FieldMapper {
+    /** operating 目标路径（支持点号嵌套，如 light.color） */
+    target: string;
+    /** payload 源字段路径（支持点号嵌套，如 displayColor） */
+    source?: string;
+    /** 常量值（与 source 互斥，优先级最高） */
+    constant?: boolean | number | string;
+    /** 值映射：把源字段的取值映射为指定值（键为源值字符串，如 { '1': true }） */
+    valueMap?: Record<string, boolean | number | string>;
+    /** 源字段为空或未命中 valueMap 时的兜底值 */
+    defaultValue?: boolean | number | string | Record<string, unknown>;
+    /** 是否启用该映射（默认 true） */
+    enabled?: boolean;
+    /** 特殊处理：'percentToPixel' 百分比转像素 / 'runtimeToPixel' 运行时坐标转像素 / 'dictLabel' 字典Label / 'dictColor' 字典Color / 'dictColorMap' 对象值批量字典Color / 'condition' 条件判断；为空表示不处理 */
+    transform?: 'percentToPixel' | 'runtimeToPixel' | 'dictLabel' | 'dictColor' | 'dictColorMap' | 'condition';
+    /** 换算维度（transform 为 percentToPixel / runtimeToPixel 时必填）：'width' 横向 / 'height' 纵向 */
+    transformType?: 'width' | 'height';
+    /** 换算精度（transform 为 percentToPixel 时生效，默认 2） */
+    transformPrecision?: number;
+    /** 字典名称（transform 为 dictLabel / dictColor 时生效，传给 dictFn 的 name 入参） */
+    dictName?: string;
+    /** 条件判断列表（transform 为 'condition' 时生效，按顺序匹配首个为 true 的条件，赋其 value 给画布字段；无匹配时保持源值） */
+    conditions?: ConditionRule[];
+}
+/** 字典转换函数：将「源业务数据」字段值按字典名称转换为「画布字段」值
+ *  @param name  特殊处理配置下的字典名称（dictName）
+ *  @param value 源业务数据字段所对应的值
+ *  @param type  'label' 字典Label / 'color' 字典Color
+ *  @returns 转换后的字符串值，赋值给画布字段 */
+export type DictFn = (name: string, value: string | number | undefined, type: 'label' | 'color') => string;
+/** 资源操作字段配置：定义 payload 中各字段的来源路径 */
+export interface ResourceFieldConfig {
+    /** 资源 className 的源字段路径（如 addType / removeType） */
+    className: string;
+    /** 资源 ID 的源字段路径（如 addId / removeId） */
+    id: string;
+    /** 资源类型的源字段路径（如 resourceType） */
+    resourceType: string;
+    /** 资源 ID 的源字段路径（用于全局查找匹配，如 resourceId） */
+    resourceId?: string;
+    /** 工位索引的源字段路径（如 addSiteNumber / removeSiteNumber） */
+    index: string;
+    /** 资源名称的源字段路径（仅 add 需要，如 name） */
+    name?: string;
+    /** 资源颜色的源字段路径（仅 add 需要，如 displayColor） */
+    color?: string;
+}
+/** 资源增删字段映射：分别配置 add / remove 两组字段来源 */
+export interface ResourceFieldMap {
+    /** 新增资源字段映射（不需要新增时可不配置） */
+    add?: ResourceFieldConfig;
+    /** 移除资源字段映射（不需要移除时可不配置） */
+    remove?: ResourceFieldConfig;
+}
+/** 全局操作字段配置（operate: 'global' 时生效） */
+export interface GlobalFieldConfig {
+    /** resourceIds 的源字段路径（从源消息中提取资源 ID 数组；为空时使用 payloadKey，如 'data'） */
+    resourceIds: string;
+}
+/** 单条类型代理规则 */
+export interface ProxyRule {
+    /** 源 type：后端消息头的 type 原始值（如 '7'），配置后优先用于匹配，匹配该规则的 operating */
+    sourceType?: string;
+    /** 前端 operating 的 className（EnumModel 值），同时作为类型列表的唯一标识 */
+    className: string;
+    /** 设备名称（画布模型类对应的 equipmentName，用于类型列表上行展示） */
+    equipmentName?: string;
+    /** 是否启用该规则 */
+    enabled: boolean;
+    /** 操作模式：single 单条 operating；resource 资源增删（生成 add/remove 两条）；global 全局操作（如批量移除） */
+    operate: 'single' | 'resource' | 'global';
+    /** 字段映射列表（operate: 'single' 时生效） */
+    mappings: FieldMapper[];
+    /** 资源增删字段映射（operate: 'resource' 时生效，未配置时使用内置默认字段名） */
+    resourceFields?: ResourceFieldMap;
+    /** 全局操作字段映射（operate: 'global' 时生效） */
+    globalFields?: GlobalFieldConfig;
+}
+/** 请求模式：direct 直接请求（完整 ws/wss 地址）；proxy 代理请求（仅 path，通过 vite/nginx 代理转发） */
+export type WsProxyRequestMode = 'direct' | 'proxy';
+/** 数据源：builtin 内置模式（组件内置 WebSocket 请求器）；external 外接模式（feedMessage 注入） */
+export type WsProxyDataSource = 'builtin' | 'external';
+/** WsProxy 代理配置（可导出为 JSON） */
+export interface WsProxyConfig {
+    /** 配置文件相对路径（不含 .json，支持嵌套如 lingshu-smart/wsProxyConfig） */
+    name: string;
+    /** 配置版本 */
+    version: number;
+    /** 数据源：builtin 内置模式（组件内置 WebSocket 请求器）；external 外接模式（feedMessage 注入）；默认 builtin */
+    dataSource?: WsProxyDataSource;
+    /** 默认 WebSocket 地址（可选）
+     *  direct 模式：完整 ws/wss 地址（如 ws://host:port/path）
+     *  proxy 模式：仅路径（如 ws/monitor?page=ctsMonitor），运行时拼接当前页面协议+主机 */
+    wsUrl?: string;
+    /** 请求模式：direct 直接请求 / proxy 代理请求（仅填 path，通过 vite/nginx 代理）；默认 direct */
+    requestMode?: WsProxyRequestMode;
+    /** 是否在组件挂载且 wsUrl 有效时自动连接 WebSocket（默认 true） */
+    autoConnect?: boolean;
+    /** 业务数据字段名：源消息下该字段的数据作为画布运行 payload（默认 data） */
+    payloadKey?: string;
+    /** 源类型字段名：从源消息中提取设备类型的字段路径（默认 type，可设为 data.type 等） */
+    sourceTypeField?: string;
+    /** 心跳检测间隔（秒）：0=关闭；>0=开启，定期发送心跳消息检测连接活性 */
+    heartbeatInterval?: number;
+    /** 各消息类型的代理规则 */
+    rules: ProxyRule[];
+}
+/** 按点号路径从对象取值 */
+export declare function getPath(obj: unknown, path: string): unknown;
+/** 按点号路径在对象上设值（自动创建中间对象） */
+export declare function setPath(obj: Record<string, unknown>, path: string, value: unknown): void;
+/** 解析单个字段映射：常量 > 值映射 > 源字段 > 默认值
+ *  @param dictFn 字典转换函数（可选，未传入时按默认规则：label 原样返回 value，color 返回 '#fff'） */
+export declare function resolveMapper(payload: Record<string, unknown>, mapper: FieldMapper, scene?: IScene | null, dictFn?: DictFn): unknown;
+/** 根据单条规则构建 operating 对象（operate: 'single'） */
+export declare function buildOperating(payload: Record<string, unknown>, rule: ProxyRule, scene?: IScene | null, dictFn?: DictFn): ILayerOperating | null;
+/** 根据 Resource 规则构建资源增删 operating 列表（operate: 'resource'）
+ *  字段来源由 rule.resourceFields 配置，未配置时使用内置默认字段名 */
+export declare function buildResourceOperating(payload: Record<string, unknown>, rule: ProxyRule): ILayerOperating[];
+/** 根据全局操作规则构建 operating（operate: 'global'）
+ *  resourceIds 从源消息中按 globalFields.resourceIds 路径提取，为空时使用 payloadKey */
+export declare function buildGlobalOperating(msg: Record<string, unknown>, rule: ProxyRule, payloadKey: string): ILayerOperating[];
+/**
+ * 将原始 WebSocket 消息转换为 operating 列表
+ * 标准化数据（payload 为对象）走 @operating；非标准化数据（payload 为数组）返回空数组，由 @raw 事件透出供父组件处理。
+ * @param rawMessage 原始消息
+ * @param rules 规则列表
+ * @param scene 场景信息（用于 percentToPixel 换算）
+ * @param payloadKey 业务数据字段名：源消息下该字段的数据作为画布运行 payload（默认 data，回退到 payload）
+ * @param sourceTypeField 源类型字段名：从源消息中提取设备类型的字段路径（默认 type）
+ * @param dictFn 字典转换函数（可选，用于 dictLabel / dictColor 特殊处理）
+ * @returns operating 列表（可能为空数组；非标准数组数据返回空数组由 @raw 处理）
+ */
+export declare function applyProxy(rawMessage: unknown, rules: ProxyRule[], scene?: IScene | null, payloadKey?: string, sourceTypeField?: string, dictFn?: DictFn): ILayerOperating[];
+/** 默认代理配置 */
+export declare function createDefaultConfig(): WsProxyConfig;
+/** 校验导入的配置结构是否合法 */
+export declare function validateConfig(raw: unknown): WsProxyConfig | null;
+/** 将配置序列化为 JSON 字符串 */
+export declare function serializeConfig(config: WsProxyConfig): string;
+/** 触发浏览器下载 JSON 配置文件（文件名：wsProxyConfig_ + 年月日时分秒） */
+export declare function downloadConfig(config: WsProxyConfig): void;
+/** 生成导出文件名：wsProxyConfig_yyyy_MM_dd_HH_mm_ss */
+export declare function timestampName(): string;
+/** 本地文件配置加载结果 */
+export type LocalFileConfigResult = {
+    status: 'ok';
+    config: WsProxyConfig;
+} | {
+    status: 'missing';
+    reason: string;
+} | {
+    status: 'invalid';
+    reason: string;
+} | {
+    status: 'unknown';
+    reason: string;
+};
+/** 从业务工程 public 目录读取配置文件（name 为相对路径，如 lingshu-smart/wsProxyConfig） */
+export declare function loadLocalFileConfig(name: string): Promise<LocalFileConfigResult>;

package/dist/components/editor/OptionCard/Equipment/models/Pallet.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/editor/OptionCard/Equipment/stationSlot/StationSlotGroupDialog.vue.d.ts

@@ -5,6 +5,7 @@ interface Props {
     resourceType: EnumResourceType;
     flowOptions?: IFlowConfig;
     stationSlots?: IStationSlotConfig[];
+    hideBounds?: boolean;
     containerWidth?: number;
     containerHeight?: number;
 }
@@ -13,14 +14,17 @@ declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, imp
     save: (data: {
         flowOptions: IFlowConfig;
         stationSlots: IStationSlotConfig[];
+        hideBounds: boolean;
     }) => any;
 }, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
     onSave?: ((data: {
         flowOptions: IFlowConfig;
         stationSlots: IStationSlotConfig[];
+        hideBounds: boolean;
     }) => any) | undefined;
 }>, {
+    hideBounds: boolean;
     stationSlots: IStationSlotConfig[];
     flowOptions: IFlowConfig;
     containerWidth: number;

package/dist/components/editor/OptionCard/Equipment/stationSlot/StationSlotGroupLayers.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/index.d.ts

@@ -2,4 +2,5 @@ import { default as LingshuSmartEditor } from './editor/index.vue';
 import { default as LingshuSmartPreview } from './preview/index.vue';
 import { default as PerformanceStats } from './debug/PerformanceStats.vue';
 import { default as ScriptRunner } from './debug/ScriptRunner/index.vue';
-export { LingshuSmartEditor, LingshuSmartPreview, PerformanceStats, ScriptRunner };
+import { default as WsProxy } from './debug/WsProxy/index.vue';
+export { LingshuSmartEditor, LingshuSmartPreview, PerformanceStats, ScriptRunner, WsProxy };