@jnrs/lingshu-smart 2.2.34 → 2.2.35

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
 }
@@ -707,6 +707,9 @@ type ILayerOperating =
 | `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

@@ -13,6 +13,7 @@
 | 设备模型   | 机床、机器人（单关节/双关节）、RGV、装载站、打标机、清洗机、轨道拖链、资源库等                        |
 | 设备运转   | 灯光、进度条、入口动画、工位槽资源增删、坐标/角度/货叉控制                                            |
 | 坐标转换   | `transRuntimeToPixel` / `transPercentToPixel` — 物理坐标与像素坐标互转                                |
+| WebSocket 代理器 | `WsProxy` — 声明式字段映射将后端 socket 数据桥接为 operating 驱动设备动画；`WsProxyPage` 独立路由页面支持单独标签页配置并通过 BroadcastChannel 广播给预览页 |
 
 ## 💻 技术栈
 

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/DebugPanel.vue.d.ts

@@ -1,2 +1,61 @@
-declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {
+    wsProxyRef: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{
+        autoApply?: boolean;
+        config?: import('./WsProxy/proxy').WsProxyConfig;
+        scene?: import('../..').IScene | null;
+        dictFn?: import('./WsProxy/proxy').DictFn;
+        standalone?: boolean;
+        remote?: boolean;
+    }> & Readonly<{
+        onOperating?: ((data: import('../..').ILayerOperating) => any) | undefined;
+        onRaw?: ((data: unknown) => any) | undefined;
+        "onStatus-change"?: ((connected: boolean) => any) | undefined;
+    }>, {
+        open: () => void;
+        feedMessage: (rawMessage: any) => void;
+        setConfig: (cfg: import('./WsProxy/proxy').WsProxyConfig) => void;
+        isConnected: import('vue').Ref<boolean, boolean>;
+        rules: import('vue').ComputedRef<import('./WsProxy/proxy').ProxyRule[]>;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+        operating: (data: import('../..').ILayerOperating) => any;
+        raw: (data: unknown) => any;
+        "status-change": (connected: boolean) => any;
+    }, import('vue').PublicProps, {
+        scene: import('../..').IScene | null;
+        config: import('./WsProxy/proxy').WsProxyConfig;
+        remote: boolean;
+        autoApply: boolean;
+        standalone: boolean;
+    }, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<{
+        autoApply?: boolean;
+        config?: import('./WsProxy/proxy').WsProxyConfig;
+        scene?: import('../..').IScene | null;
+        dictFn?: import('./WsProxy/proxy').DictFn;
+        standalone?: boolean;
+        remote?: boolean;
+    }> & Readonly<{
+        onOperating?: ((data: import('../..').ILayerOperating) => any) | undefined;
+        onRaw?: ((data: unknown) => any) | undefined;
+        "onStatus-change"?: ((connected: boolean) => any) | undefined;
+    }>, {
+        open: () => void;
+        feedMessage: (rawMessage: any) => void;
+        setConfig: (cfg: import('./WsProxy/proxy').WsProxyConfig) => void;
+        isConnected: import('vue').Ref<boolean, boolean>;
+        rules: import('vue').ComputedRef<import('./WsProxy/proxy').ProxyRule[]>;
+    }, {}, {}, {}, {
+        scene: import('../..').IScene | null;
+        config: import('./WsProxy/proxy').WsProxyConfig;
+        remote: boolean;
+        autoApply: boolean;
+        standalone: boolean;
+    }> | null;
+}, any>;
 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,24 @@
+type __VLS_Props = {
+    url: string;
+    isConnected: boolean;
+    isConnecting: boolean;
+    stateInfo: string;
+    /** 心跳检测间隔（秒）：0=关闭 */
+    heartbeatInterval: number;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:url": (value: string) => any;
+    "update:heartbeatInterval": (value: number) => any;
+    connect: () => any;
+    disconnect: () => any;
+    reconnect: () => any;
+    send: (data: string) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:url"?: ((value: string) => any) | undefined;
+    "onUpdate:heartbeatInterval"?: ((value: number) => any) | undefined;
+    onConnect?: (() => any) | undefined;
+    onDisconnect?: (() => any) | undefined;
+    onReconnect?: (() => any) | undefined;
+    onSend?: ((data: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

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

@@ -0,0 +1,14 @@
+import { IScene } from '../../../types';
+import { DictFn } from './proxy';
+type __VLS_Props = {
+    /** 场景信息：用于字段映射中像素换算（如 currentCase.scene） */
+    scene?: IScene | null;
+    /** 字典转换函数：用于「字典 Label / 字典 Color」特殊处理
+     *  入参 (name, value, type)，返回 string 赋给画布字段 */
+    dictFn?: DictFn;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    scene: IScene | null;
+    dictFn: DictFn;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

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

@@ -0,0 +1,31 @@
+/**
+ * @File   : broadcast.ts
+ * @Desc.  : WsProxy 跨标签页数据流转（BroadcastChannel）
+ *           独立标签页运行代理器（standalone）时，将转换后的 operating / raw / 状态
+ *           通过 BroadcastChannel 广播给同源的其他标签页（如数字孪生预览页），
+ *           实现「独立 tab 配置代理 → 预览页驱动图形运转」的数据流转。
+ */
+/** 广播频道名：同源多个标签页共享 */
+export declare const PROXY_CHANNEL = "jnrs-wsproxy-v1";
+/** 广播消息类型 */
+export type ProxyBroadcastMsg = {
+    type: 'operating';
+    data: unknown;
+} | {
+    type: 'raw';
+    data: unknown;
+} | {
+    type: 'status';
+    connected: boolean;
+};
+/**
+ * 创建广播通道
+ * @returns BroadcastChannel 实例（浏览器不支持时返回 null）
+ */
+export declare function createProxyChannel(): BroadcastChannel | null;
+/** 向广播通道发送消息（standalone 代理器广播用） */
+export declare function broadcastProxy(channel: BroadcastChannel | null, msg: ProxyBroadcastMsg): void;
+/** 订阅广播通道消息（预览页接收用），返回取消订阅函数 */
+export declare function subscribeProxy(channel: BroadcastChannel | null, handler: (msg: ProxyBroadcastMsg) => void): () => void;
+/** 关闭广播通道 */
+export declare function closeProxyChannel(channel: BroadcastChannel | null): void;

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

@@ -0,0 +1,39 @@
+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;
+    /** 独立标签页模式：全屏布局，自动打开，并将 operating/raw/状态 通过 BroadcastChannel 广播 */
+    standalone?: boolean;
+    /** 远程接收模式：监听 BroadcastChannel，将独立代理器广播的 operating/raw/状态 透传给父组件 */
+    remote?: boolean;
+};
+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;
+    remote: boolean;
+    autoApply: boolean;
+    standalone: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -0,0 +1,159 @@
+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;
+    /** 是否启用该映射（默认 true） */
+    enabled?: boolean;
+    /** 特殊处理：'percentToPixel' 百分比转像素 / 'runtimeToPixel' 运行时坐标转像素 / 'dictLabel' 字典Label / 'dictColor' 字典Color / 'condition' 条件判断；为空表示不处理 */
+    transform?: 'percentToPixel' | 'runtimeToPixel' | 'dictLabel' | 'dictColor' | '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;
+}
+/** WsProxy 代理配置（可导出为 JSON） */
+export interface WsProxyConfig {
+    /** 配置文件相对路径（不含 .json，支持嵌套如 lingshu-smart/wsProxyConfig） */
+    name: string;
+    /** 配置版本 */
+    version: number;
+    /** 默认 WebSocket 地址（可选） */
+    wsUrl?: string;
+    /** 业务数据字段名：源消息下该字段的数据作为画布运行 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>;