@jnrs/lingshu-smart 2.2.38 → 2.2.39

package/AGENTS.md

@@ -489,19 +489,19 @@ type ILayerOperating =
 
 ### 子类型一览
 
-| 类型                         | className            | 特有属性                                                           | 子组件能力                                         | 典型 payload.type  |
-| ---------------------------- | -------------------- | ------------------------------------------------------------------ | -------------------------------------------------- | ------------------ |
-| `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` |
-| `IDoubleJointRobotOperating` | `DOUBLE_JOINT_ROBOT` | `light?`, `x?`, `y?`, `j1?`, `j2?`, `currentFixture?`, `resource?` | 双状态灯、轨道位移、双关节旋转、夹具切换、双工位槽 | `DoubleJointRobot` |
-| `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?`, `resource?`                                  | 状态灯、X/Y 位移、托盘/刀具工位槽                  | `Pallet`           |
+| 类型                         | className            | 特有属性                                                             | 子组件能力                                         | 典型 payload.type  |
+| ---------------------------- | -------------------- | -------------------------------------------------------------------- | -------------------------------------------------- | ------------------ |
+| `IMachineToolOperating`      | `MACHINE_TOOL`       | `light?`, `progress?`, `entrance?`, `stationRotatable?`              | 状态灯（含旋转）、进度条、出入口、工位槽           | `MachineTool`      |
+| `ILoadingStationOperating`   | `LOADING_STATION`    | `light?`, `progress?`, `entrance?`, `stationRotatable?`              | 状态灯（无旋转）、进度条、出入口、工位槽           | `LoadingStation`   |
+| `IShuttleStationOperating`   | `SHUTTLE_STATION`    | `light?`, `layerLightColor?`, `layerLightBlinking?`, `layerVisible?` | 状态灯、多工位层状态灯/显隐                        | `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` |
+| `IDoubleJointRobotOperating` | `DOUBLE_JOINT_ROBOT` | `light?`, `x?`, `y?`, `j1?`, `j2?`, `currentFixture?`, `resource?`   | 双状态灯、轨道位移、双关节旋转、夹具切换、双工位槽 | `DoubleJointRobot` |
+| `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?`, `resource?`                                    | 状态灯、X/Y 位移、托盘/刀具工位槽                  | `Pallet`           |
 
 ### 子类型字段详情
 
@@ -527,12 +527,14 @@ type ILayerOperating =
 
 #### IShuttleStationOperating
 
-| 属性          | 类型                                | 说明                                                            |
-| ------------- | ----------------------------------- | --------------------------------------------------------------- |
-| `light`       | `Omit<ILightOperating, 'rotating'>` | 状态灯（不支持旋转灯效）                                        |
-| `layerStatus` | `Record<number, number \| string>`  | 各层工位组状态灯：键为层索引（1-based），值为状态码或颜色字符串 |
+| 属性                 | 类型                                | 说明                                                                |
+| -------------------- | ----------------------------------- | ------------------------------------------------------------------- |
+| `light`              | `Omit<ILightOperating, 'rotating'>` | 状态灯（不支持旋转灯效）                                            |
+| `layerLightColor`    | `Record<number, number \| string>`  | 各层工位组状态灯颜色：键为层索引（1-based），值为状态码或颜色字符串 |
+| `layerLightBlinking` | `Record<number, boolean>`           | 各层工位组状态灯闪烁：键为层索引（1-based），值为是否闪烁           |
+| `layerVisible`       | `Record<number, boolean>`           | 各层工位组显示状态：键为层索引（1-based），值为是否可见             |
 
-> `layerStatus` 在代理器中通过 `dictColorMap` 转换后值为颜色字符串；未转换时值为状态数字码。
+> `layerLightColor` 在代理器中通过 `dictColorMap` / `objDict` 转换后值为颜色字符串；未转换时值为状态数字码。
 
 #### IMarkingMachineOperating
 
@@ -633,12 +635,12 @@ type ILayerOperating =
 
 ## 📦 模块总览
 
-| 模块路径                         | 说明                           |
-| -------------------------------- | ------------------------------ |
-| `@jnrs/lingshu-smart`            | 主模块，包含类型定义和工具函数 |
-| `@jnrs/lingshu-smart/components` | Vue 组件库（编辑器、预览器）   |
+| 模块路径                         | 说明                                  |
+| -------------------------------- | ------------------------------------- |
+| `@jnrs/lingshu-smart`            | 主模块，包含类型定义和工具函数        |
+| `@jnrs/lingshu-smart/components` | Vue 组件库（编辑器、预览器）          |
 | `@jnrs/lingshu-smart/stores`     | Pinia stores（data/editor/app/debug） |
-| `@jnrs/lingshu-smart/locales`    | 国际化配置                     |
+| `@jnrs/lingshu-smart/locales`    | 国际化配置                            |
 
 ---
 
@@ -727,9 +729,9 @@ type ILayerOperating =
 | `utils/logger.ts`                          | 统一日志工具，支持 tag 着色、LogLevel 过滤、`operating` 追踪级别                                                                                                                                                                                                    |
 | `utils/debug-flags.ts`                     | 模块级动画标志位，供 UI 组件直接导入控制循环动画                                                                                                                                                                                                                    |
 | `utils/performance-stats.ts`               | 性能统计工具，记录运行时长和 WebSocket 数据接收量                                                                                                                                                                                                                   |
-| `stores/useDebugStore.ts`                  | 全局调试配置 Pinia store，localStorage 持久化                                                                                                                                                                                                                       |
+| `stores/useDebugStore.ts`                  | 全局设置 Pinia store（facade）：响应式读写 `useDataStore.globalSetting` / `scriptRunner`，持久化统一在 `@jnrs/lingshu-smart`                                                                                                                                        |
 | `composables/useDebugEasterEgg.ts`         | 调试触发检测：500ms 内 10 次点击打开面板                                                                                                                                                                                                                            |
-| `components/debug/DebugPanel.vue`          | 调试配置对话框 UI                                                                                                                                                                                                                                                   |
+| `components/debug/GlobalSetting.vue`       | 全局设置对话框 UI（原 DebugPanel，含语言/日志等级/FPS/阴影/动画等开关）                                                                                                                                                                                             |
 | `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/状态广播给预览页驱动图形运转                                                                                                                                                          |

package/README.md

@@ -6,14 +6,14 @@
 
 ### 核心功能
 
-| 功能             | 说明                                                                                                                                                                                   |
-| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 编辑器模式       | `LingshuSmartEditor` — 方案可视化编辑，支持拖拽布局、设备配置、图层管理、方案保存/预览                                                                                                 |
-| 运行看板         | `LingshuSmartPreview` — 方案运行看板，支持 WebSocket 实时驱动设备动画、交互事件（点击/拖拽/右键菜单）                                                                                  |
-| 设备模型         | 机床、机器人（单关节/双关节）、RGV、装载站、打标机、清洗机、轨道拖链、资源库、托盘等                                                                                                   |
-| 设备运转         | 灯光、进度条、入口动画、工位槽资源增删、坐标/角度/货叉控制                                                                                                                             |
-| 坐标转换         | `transRuntimeToPixel` / `transPercentToPixel` — 物理坐标与像素坐标互转                                                                                                                 |
-| WebSocket 代理器 | `WsProxy` — 声明式字段映射将后端 socket 数据桥接为 operating 驱动设备动画；支持内置请求器/外接注入两种数据源、direct/proxy 请求模式、自动连接开关、按 type 分类代理配置及配置导出/导入 |
+| 功能             | 说明                                                                                                                                                                                                                                                                                                   |
+| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| 编辑器模式       | `LingshuSmartEditor` — 方案可视化编辑，支持拖拽布局、设备配置、图层管理、方案保存/预览                                                                                                                                                                                                                 |
+| 运行看板         | `LingshuSmartPreview` — 方案运行看板，支持 WebSocket 实时驱动设备动画、交互事件（点击/拖拽/右键菜单）                                                                                                                                                                                                  |
+| 设备模型         | 机床、机器人（单关节/双关节）、RGV、装载站、打标机、清洗机、轨道拖链、资源库、托盘等                                                                                                                                                                                                                   |
+| 设备运转         | 灯光、进度条、入口动画、工位槽资源增删、坐标/角度/货叉控制                                                                                                                                                                                                                                             |
+| 坐标转换         | `transRuntimeToPixel` / `transPercentToPixel` — 物理坐标与像素坐标互转                                                                                                                                                                                                                                 |
+| WebSocket 代理器 | `WsProxy` — 声明式字段映射将后端 socket 数据桥接为 operating 驱动设备动画；支持内置请求器/外接注入两种数据源、direct/proxy 请求模式、自动连接开关、按 type 分类代理配置及配置导出/导入；特殊处理支持固定值、像素转换、字典转换、对象值映射、模型映射表、条件判断，「始终记录」可关闭显示仍持续收集日志 |
 
 ## 💻 技术栈
 
@@ -112,7 +112,7 @@ ws.onmessage = (event) => {
 
 ### 配置持久化
 
-所有调试配置通过 `localStorage` 持久化存储，key 为 `@jnrs/lingshu-smart/debug`：
+所有配置通过 `localStorage` 统一持久化到单一 key `@jnrs/lingshu-smart`（`cases` / `wsProxyConfig` / `globalSetting` / `scriptRunner` 四个字段平级），旧版独立 key（`@jnrs/lingshu-smart/debug`、`@jnrs/lingshu-smart/script-steps`、`@jnrs/lingshu-smart/ws-proxy-config`）首次访问时自动迁移合并后删除。全局设置存放于 `globalSetting` 字段：
 
 ```json
 {
@@ -125,7 +125,7 @@ ws.onmessage = (event) => {
 }
 ```
 
-页面刷新后自动恢复上次配置。如需重置，点击调试面板中的"恢复默认"按钮。
+页面刷新后自动恢复上次配置。如需重置，点击全局设置面板中的"恢复默认"按钮。
 
 ## 🌐 国际化
 

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

@@ -0,0 +1,63 @@
+/** 设备下拉选项（与 index.vue 的 DeviceOption 同构） */
+interface StressDeviceOption {
+    label: string;
+    value: string;
+    className: string;
+    nameplate: string;
+}
+type __VLS_Props = {
+    /** 测试模式：move 位移压测 / resource 资源流转 */
+    mode: 'move' | 'resource';
+    deviceOptions: StressDeviceOption[];
+    deviceValue: StressDeviceOption | null;
+    frequency: number;
+    amplitude: number;
+    period: number;
+    /** 资源流转：搬运设备（机器人/RGV） */
+    carrierOptions: StressDeviceOption[];
+    carrierValue: StressDeviceOption | null;
+    /** 资源流转：库设备（资源库/托盘） */
+    storeOptions: StressDeviceOption[];
+    storeValue: StressDeviceOption | null;
+    /** 资源流转：资源类型 Pallet/Tool */
+    resourceType: string;
+    /** 资源流转：同时搬运的资源数量 */
+    resourceCount: number;
+    /** 资源流转：每步间隔（ms） */
+    resourceInterval: number;
+    running: boolean;
+    sentCount: number;
+    actualHz: number;
+    elapsed: number;
+    sampleLog: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    start: () => any;
+    stop: () => any;
+    "update:mode": (value: "resource" | "move") => any;
+    "update:deviceValue": (value: "" | StressDeviceOption) => any;
+    "update:frequency": (value: number) => any;
+    "update:amplitude": (value: number) => any;
+    "update:period": (value: number) => any;
+    "update:carrierValue": (value: "" | StressDeviceOption) => any;
+    "update:storeValue": (value: "" | StressDeviceOption) => any;
+    "update:resourceType": (value: string) => any;
+    "update:resourceCount": (value: number) => any;
+    "update:resourceInterval": (value: number) => any;
+    "update:sampleLog": (value: boolean) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onStart?: (() => any) | undefined;
+    onStop?: (() => any) | undefined;
+    "onUpdate:mode"?: ((value: "resource" | "move") => any) | undefined;
+    "onUpdate:deviceValue"?: ((value: "" | StressDeviceOption) => any) | undefined;
+    "onUpdate:frequency"?: ((value: number) => any) | undefined;
+    "onUpdate:amplitude"?: ((value: number) => any) | undefined;
+    "onUpdate:period"?: ((value: number) => any) | undefined;
+    "onUpdate:carrierValue"?: ((value: "" | StressDeviceOption) => any) | undefined;
+    "onUpdate:storeValue"?: ((value: "" | StressDeviceOption) => any) | undefined;
+    "onUpdate:resourceType"?: ((value: string) => any) | undefined;
+    "onUpdate:resourceCount"?: ((value: number) => any) | undefined;
+    "onUpdate:resourceInterval"?: ((value: number) => any) | undefined;
+    "onUpdate:sampleLog"?: ((value: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

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

@@ -1,4 +1,4 @@
-import { WsProxyConfig } from './proxy';
+import { WsProxyConfig, WsProxyCaseConfig } from './proxy';
 type __VLS_Props = {
     config: WsProxyConfig;
     /** 配置来源：localFile 本地文件 / store 持久化配置（含用户手动修改场景） */
@@ -9,10 +9,12 @@ type __VLS_Props = {
     hasDictFn?: boolean;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    reset: (value: WsProxyConfig) => any;
+    reset: (value: WsProxyCaseConfig[]) => any;
     "update:config": (value: WsProxyConfig) => any;
+    "exported-all": () => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onReset?: ((value: WsProxyConfig) => any) | undefined;
+    onReset?: ((value: WsProxyCaseConfig[]) => any) | undefined;
     "onUpdate:config"?: ((value: WsProxyConfig) => any) | undefined;
+    "onExported-all"?: (() => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
 export default _default;

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

@@ -10,6 +10,12 @@ type __VLS_Props = {
     stateInfo: string;
     /** 心跳检测间隔（秒）：0=关闭 */
     heartbeatInterval: number;
+    /** 是否在请求时携带 Token */
+    carryToken: boolean;
+    /** 认证 Token 值（输入框自动回填） */
+    token: string;
+    /** 父组件是否传入了 token（未传入时输入框下方显示红色提示） */
+    tokenProvided: boolean;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     disconnect: () => any;
@@ -18,6 +24,8 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     "update:requestMode": (value: WsProxyRequestMode) => any;
     "update:autoConnect": (value: boolean) => any;
     "update:heartbeatInterval": (value: number) => any;
+    "update:carryToken": (value: boolean) => any;
+    "update:token": (value: string) => any;
     connect: () => any;
     reconnect: () => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
@@ -27,6 +35,8 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     "onUpdate:requestMode"?: ((value: WsProxyRequestMode) => any) | undefined;
     "onUpdate:autoConnect"?: ((value: boolean) => any) | undefined;
     "onUpdate:heartbeatInterval"?: ((value: number) => any) | undefined;
+    "onUpdate:carryToken"?: ((value: boolean) => any) | undefined;
+    "onUpdate:token"?: ((value: string) => any) | undefined;
     onConnect?: (() => any) | undefined;
     onReconnect?: (() => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;

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

@@ -17,12 +17,14 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     update: () => any;
     "update:targetFieldEditable": (value: boolean) => any;
     "open-condition": (mapper: FieldMapper) => any;
+    "open-valuemap": (mapper: FieldMapper) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     onAdd?: (() => any) | undefined;
     onRemove?: ((idx: number) => any) | undefined;
     onUpdate?: (() => any) | undefined;
     "onUpdate:targetFieldEditable"?: ((value: boolean) => any) | undefined;
     "onOpen-condition"?: ((mapper: FieldMapper) => any) | undefined;
+    "onOpen-valuemap"?: ((mapper: FieldMapper) => any) | undefined;
 }>, {
     targetFieldEditable: boolean;
     hasDictFn: boolean;

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

@@ -3,10 +3,27 @@ import { WsProxyConfig, ProxyRule, DictFn } from './proxy';
 type __VLS_Props = {
     /** 是否自动应用注入的消息（父组件调用 expose 的 feedMessage 时） */
     autoApply?: boolean;
-    /** 初始配置 */
+    /** 初始配置（单套，可省略；多方案模式下由当前方案自动匹配/新建） */
     config?: WsProxyConfig;
-    /** 场景信息：用于字段映射中 percentToPixel 换算（如 currentCase.scene） */
+    /** 场景信息：用于字段映射中 percentToPixel 换算（如 currentCase.scene）
+     *  兼容旧用法：new 用法下由 currentCase.scene 派生，仅当 currentCase 缺失时回退此 prop */
     scene?: IScene | null;
+    /** 当前方案 uuid：按方案自动匹配代理配置，未匹配则新建并绑定
+     *  兼容旧用法：new 用法下由 currentCase.uuid 派生，仅当 currentCase 缺失时回退此 prop */
+    currentCaseId?: string;
+    /** 当前方案（含 uuid/scene/title/layers）：作为唯一权威来源，
+     *  内部派生 caseId 与 scene，并据此动态生成「画布模型类」列表 */
+    currentCase?: {
+        uuid?: string;
+        title?: string;
+        scene?: IScene | null;
+        layers?: Array<{
+            className?: string;
+            children?: Array<{
+                className?: string;
+            }>;
+        }>;
+    } | null;
     /** 字典转换函数：用于「字典 Label / 字典 Color」特殊处理
      *  入参 (name: string, value?: string|number, type: 'label'|'color')，返回 string 赋给画布字段 */
     dictFn?: DictFn;
@@ -28,9 +45,21 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
     onRaw?: ((data: unknown) => any) | undefined;
     "onStatus-change"?: ((connected: boolean) => any) | undefined;
 }>, {
-    scene: IScene | null;
     config: WsProxyConfig;
-    autoApply: boolean;
+    scene: IScene | null;
+    currentCase: {
+        uuid?: string;
+        title?: string;
+        scene?: IScene | null;
+        layers?: Array<{
+            className?: string;
+            children?: Array<{
+                className?: string;
+            }>;
+        }>;
+    } | null;
     token: string;
+    autoApply: boolean;
+    currentCaseId: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

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

@@ -14,7 +14,7 @@ export interface FieldMapper {
     target: string;
     /** payload 源字段路径（支持点号嵌套，如 displayColor） */
     source?: string;
-    /** 常量值（与 source 互斥，优先级最高） */
+    /** 常量值（与 source 互斥，优先级最高；「固定值」特殊处理时由输入框写入，直接赋给画布字段） */
     constant?: boolean | number | string;
     /** 值映射：把源字段的取值映射为指定值（键为源值字符串，如 { '1': true }） */
     valueMap?: Record<string, boolean | number | string>;
@@ -22,15 +22,17 @@ export interface FieldMapper {
     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';
+    /** 特殊处理：'constant' 固定值 / 'percentToPixel' 百分比转像素 / 'runtimeToPixel' 运行时坐标转像素 / 'dictLabel' 字典Label / 'dictColor' 字典Color / 'dictColorMap' 对象值批量字典Color / 'objDict' 对象值批量映射 / 'modelMap' 模型映射表 / 'condition' 条件判断；为空表示不处理 */
+    transform?: 'constant' | 'percentToPixel' | 'runtimeToPixel' | 'dictLabel' | 'dictColor' | 'dictColorMap' | 'objDict' | 'modelMap' | 'condition';
     /** 换算维度（transform 为 percentToPixel / runtimeToPixel 时必填）：'width' 横向 / 'height' 纵向 */
     transformType?: 'width' | 'height';
     /** 换算精度（transform 为 percentToPixel 时生效，默认 2） */
     transformPrecision?: number;
-    /** 字典名称（transform 为 dictLabel / dictColor 时生效，传给 dictFn 的 name 入参） */
+    /** 字典名称（transform 为 dictLabel / dictColor / dictColorMap / objDict 时生效，传给 dictFn 的 name 入参） */
     dictName?: string;
-    /** 条件判断列表（transform 为 'condition' 时生效，按顺序匹配首个为 true 的条件，赋其 value 给画布字段；无匹配时保持源值） */
+    /** 输出目标类型（transform 为 'objDict' 时生效）：'string' 默认 / 'number' 转数字 / 'boolean' 布尔标准化；未命中映射保持原值 */
+    transformTargetType?: 'string' | 'number' | 'boolean';
+    /** 条件判断列表（transform 为 'condition' 时生效，按顺序匹配首个为 true 的条件，赋其 value 给画布字段；无匹配时回退 defaultValue，未配置则保持源值） */
     conditions?: ConditionRule[];
 }
 /** 字典转换函数：将「源业务数据」字段值按字典名称转换为「画布字段」值
@@ -71,6 +73,8 @@ export interface ProxyRule {
     resourceMappings?: ResourceFieldMap;
     /** 全局操作字段映射（operate: 'global' 时生效） */
     globalFields?: GlobalFieldConfig;
+    /** 手动新增标记：「+ 新增」手动添加的规则不随方案设备类型自动移除 */
+    custom?: boolean;
 }
 /** 请求模式：direct 直接请求（完整 ws/wss 地址）；proxy 代理请求（仅 path，通过 vite/nginx 代理转发） */
 export type WsProxyRequestMode = 'direct' | 'proxy';
@@ -78,10 +82,10 @@ export type WsProxyRequestMode = 'direct' | 'proxy';
 export type WsProxyDataSource = 'builtin' | 'external';
 /** WsProxy 代理配置（可导出为 JSON） */
 export interface WsProxyConfig {
-    /** 配置文件相对路径（不含 .json，支持嵌套如 lingshu-smart/wsProxyConfig） */
-    name: string;
-    /** 配置版本 */
-    version: number;
+    /** 配置文件完整路径（public 起始，含 .json），用于定位与加载本地配置文件 */
+    fileUrl?: string;
+    /** 配置版本（字符串，如 '1' / '1.0.0'） */
+    version: string;
     /** 数据源：builtin 内置模式（组件内置 WebSocket 请求器）；external 外接模式（feedMessage 注入）；默认 builtin */
     dataSource?: WsProxyDataSource;
     /** 默认 WebSocket 地址（可选）
@@ -98,22 +102,40 @@ export interface WsProxyConfig {
     sourceTypeField?: string;
     /** 心跳检测间隔（秒）：0=关闭；>0=开启，定期发送心跳消息检测连接活性 */
     heartbeatInterval?: number;
+    /** 是否在连接请求时携带 Token（作为 WebSocket 子协议）；默认 false */
+    carryToken?: boolean;
+    /** 模型映射表：源业务数据值 → 画布模型 className（如 { '1': 'MachineTool' }）
+     *  供字段映射的「模型映射表」特殊处理引用，将源值转换为对应模型的 className */
+    modelMap?: Record<string, string>;
     /** 各消息类型的代理规则 */
     rules: ProxyRule[];
 }
+/** 绑定到某一方案的代理器配置：在 WsProxyConfig 基础上增加方案绑定标识 */
+export interface WsProxyCaseConfig extends WsProxyConfig {
+    /** 绑定的方案 uuid（currentCase.uuid），用于按方案自动匹配 */
+    caseId: string;
+    /** 方案名称（currentCase.title），用于方案切换下拉左侧展示；可缺省，缺省时回退 uuid */
+    caseName?: string;
+}
+/** 默认本地配置文件完整路径（public 起始，含 .json，用于定位/加载/导出的固定 fileUrl） */
+export declare const DEFAULT_CONFIG_FILE_URL = "public/lingshu-smart/wsProxyConfig.json";
+/** 由 fileUrl 推导实际 fetch 路径：去掉开头多余 / 与 public/ 前缀，补全 .json 扩展名，
+ *  并追加时间戳参数以禁用浏览器缓存（保证「重新应用此配置」始终读取最新文件内容） */
+export declare function resolveConfigFetchPath(fileUrl?: string): string;
 /** 按点号路径从对象取值 */
 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;
+ *  @param dictFn 字典转换函数（可选，未传入时按默认规则：label 原样返回 value，color 返回 '#fff'）
+ *  @param modelMap 模型映射表（可选，transform 为 'modelMap' 时引用，将源值转换为画布模型 className） */
+export declare function resolveMapper(payload: Record<string, unknown>, mapper: FieldMapper, scene?: IScene | null, dictFn?: DictFn, modelMap?: Record<string, string>): unknown;
 /** 根据单条规则构建 operating 对象（operate: 'single'） */
-export declare function buildOperating(payload: Record<string, unknown>, rule: ProxyRule, scene?: IScene | null, dictFn?: DictFn): ILayerOperating | null;
+export declare function buildOperating(payload: Record<string, unknown>, rule: ProxyRule, scene?: IScene | null, dictFn?: DictFn, modelMap?: Record<string, string>): ILayerOperating | null;
 /** 根据 Resource 规则构建资源增删 operating 列表（operate: 'resource'）
  *  字段来源由 rule.resourceMappings.add / remove 动态映射配置，未配置时使用内置默认映射。
  *  target 支持点号嵌套：className / id 为目标设备匹配字段，resource.* 为资源对象字段。 */
-export declare function buildResourceOperating(payload: Record<string, unknown>, rule: ProxyRule, scene?: IScene | null, dictFn?: DictFn): ILayerOperating[];
+export declare function buildResourceOperating(payload: Record<string, unknown>, rule: ProxyRule, scene?: IScene | null, dictFn?: DictFn, modelMap?: Record<string, string>): ILayerOperating[];
 /** 根据全局操作规则构建 operating（operate: 'global'）
  *  resourceIds 从源消息中按 globalFields.resourceIds 路径提取，为空时使用 payloadKey */
 export declare function buildGlobalOperating(msg: Record<string, unknown>, rule: ProxyRule, payloadKey: string): ILayerOperating[];
@@ -126,19 +148,40 @@ export declare function buildGlobalOperating(msg: Record<string, unknown>, rule:
  * @param payloadKey 业务数据字段名：源消息下该字段的数据作为画布运行 payload（默认 data，回退到 payload）
  * @param sourceTypeField 源类型字段名：从源消息中提取设备类型的字段路径（默认 type）
  * @param dictFn 字典转换函数（可选，用于 dictLabel / dictColor 特殊处理）
+ * @param modelMap 模型映射表（可选，用于 modelMap 特殊处理：源业务数据值 → 画布模型 className）
  * @returns operating 列表（可能为空数组；非标准数组数据返回空数组由 @raw 处理）
  */
-export declare function applyProxy(rawMessage: unknown, rules: ProxyRule[], scene?: IScene | null, payloadKey?: string, sourceTypeField?: string, dictFn?: DictFn): ILayerOperating[];
+export declare function applyProxy(rawMessage: unknown, rules: ProxyRule[], scene?: IScene | null, payloadKey?: string, sourceTypeField?: string, dictFn?: DictFn, modelMap?: Record<string, string>): ILayerOperating[];
 /** 资源新增字段默认映射（target 取自 IModelOperating + IResourceOperating，源字段名取自 ViewPageDemo.vue 中 Resource 操作的标准 payload 字段） */
 export declare const DEFAULT_RESOURCE_ADD_MAPPERS: FieldMapper[];
 /** 资源移除字段默认映射 */
 export declare const DEFAULT_RESOURCE_REMOVE_MAPPERS: FieldMapper[];
-/** 默认代理配置 */
+/** 默认代理配置（含全部已知设备类型） */
 export declare function createDefaultConfig(): WsProxyConfig;
-/** 校验导入的配置结构是否合法 */
+/** 返回某设备类型的默认代理规则；未知类型返回 null（供「画布模型类」按 currentCase 缺型兜底） */
+export declare function getDefaultDeviceRule(className: string): ProxyRule | null;
+/**
+ * 为指定方案构建代理配置：仅包含该方案当前存在的设备类型（deviceClassNames）的默认映射，
+ * 外加始终保留的 Resource / BatchRemove 操作规则。供「画布模型类」按 currentCase 动态生成使用。
+ * @param caseId 绑定的方案 uuid
+ * @param deviceClassNames 方案中实际存在的设备类型 className 列表（去重后）
+ */
+export declare function createDefaultConfigForCase(caseId: string, deviceClassNames: string[]): WsProxyCaseConfig;
+/** 校验导入的配置结构是否合法（单个配置对象）
+ *  兼容旧配置：仅有 name（相对路径，如 lingshu-smart/wsProxyConfig）时，自动推导为 fileUrl 并删除 name */
 export declare function validateConfig(raw: unknown): WsProxyConfig | null;
-/** 将配置序列化为 JSON 字符串 */
+/** 校验代理器配置数组是否合法 */
+export declare function validateCaseConfigArray(raw: unknown): WsProxyCaseConfig[] | null;
+/** 将配置序列化为 JSON 字符串
+ *  字段顺序：caseId / caseName（方案绑定，置于最前）→ fileUrl → 其余配置 */
 export declare function serializeConfig(config: WsProxyConfig): string;
+/** 将代理器配置数组序列化为 JSON 字符串 */
+export declare function serializeCaseConfigArray(configs: WsProxyCaseConfig[]): string;
+/**
+ * 兼容旧版单配置：若读取到的数据是单个配置对象（含 name + rules 数组），
+ * 则包装为数组并赋予空 caseId（由调用方按需绑定方案）。
+ */
+export declare function normalizeToCaseConfigArray(raw: unknown): WsProxyCaseConfig[];
 /** 触发浏览器下载 JSON 配置文件（文件名：wsProxyConfig_ + 年月日时分秒） */
 export declare function downloadConfig(config: WsProxyConfig): void;
 /** 生成导出文件名：wsProxyConfig_yyyy_MM_dd_HH_mm_ss */
@@ -147,6 +190,7 @@ export declare function timestampName(): string;
 export type LocalFileConfigResult = {
     status: 'ok';
     config: WsProxyConfig;
+    configs: WsProxyCaseConfig[];
 } | {
     status: 'missing';
     reason: string;
@@ -157,5 +201,7 @@ export type LocalFileConfigResult = {
     status: 'unknown';
     reason: string;
 };
-/** 从业务工程 public 目录读取配置文件（name 为相对路径，如 lingshu-smart/wsProxyConfig） */
-export declare function loadLocalFileConfig(name: string): Promise<LocalFileConfigResult>;
+/** 从业务工程 public 目录读取配置文件（fileUrl 为完整路径，如 public/lingshu-smart/wsProxyConfig.json）
+ *  支持数组格式（每套配置绑定一个方案 caseId）；非数组为旧版单配置（无 uuid 匹配概念，直接返回）。
+ *  传入 caseId 且为数组格式时，必须匹配到该 uuid 才算加载成功，否则返回 invalid（未匹配到 uuid）。 */
+export declare function loadLocalFileConfig(fileUrl: string, caseId?: string): Promise<LocalFileConfigResult>;

package/dist/components/editor/ControlBar/CaseTitleEdit.vue.d.ts

@@ -27,8 +27,8 @@ declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import
             readonly name?: string | undefined;
             readonly disabled?: boolean | undefined;
             readonly id?: string | undefined;
-            readonly placeholder?: string | undefined;
             readonly form?: string | undefined;
+            readonly placeholder?: string | undefined;
             readonly size?: import('element-plus').ComponentSize | undefined;
             readonly resize?: "none" | "both" | "horizontal" | "vertical" | undefined;
             readonly ariaLabel?: string | undefined;
@@ -37,7 +37,7 @@ declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import
             readonly suffixIcon?: import('element-plus/es/utils/index.mjs').IconPropType | undefined;
             readonly autofocus?: boolean | undefined;
             readonly readonly?: boolean | undefined;
-            readonly inputmode?: "none" | "search" | "url" | "text" | "email" | "tel" | "numeric" | "decimal" | undefined;
+            readonly inputmode?: "none" | "text" | "search" | "url" | "email" | "tel" | "numeric" | "decimal" | undefined;
             readonly maxlength?: string | number | undefined;
             readonly minlength?: string | number | undefined;
             readonly autosize?: import('element-plus').InputAutoSize | undefined;
@@ -72,7 +72,7 @@ declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import
         $root: import('vue').ComponentPublicInstance | null;
         $parent: import('vue').ComponentPublicInstance | null;
         $host: Element | null;
-        $emit: ((event: "blur", evt: FocusEvent) => void) & ((event: "focus", evt: FocusEvent) => void) & ((event: "clear") => void) & ((event: "input", value: string) => void) & ((event: "change", value: string, evt?: Event | undefined) => void) & ((event: "compositionend", evt: CompositionEvent) => void) & ((event: "compositionstart", evt: CompositionEvent) => void) & ((event: "compositionupdate", evt: CompositionEvent) => void) & ((event: "keydown", evt: Event | KeyboardEvent) => void) & ((event: "mouseenter", evt: MouseEvent) => void) & ((event: "mouseleave", evt: MouseEvent) => void) & ((event: "update:modelValue", value: string) => void);
+        $emit: ((event: "blur", evt: FocusEvent) => void) & ((event: "input", value: string) => void) & ((event: "focus", evt: FocusEvent) => void) & ((event: "clear") => void) & ((event: "change", value: string, evt?: Event | undefined) => void) & ((event: "compositionend", evt: CompositionEvent) => void) & ((event: "compositionstart", evt: CompositionEvent) => void) & ((event: "compositionupdate", evt: CompositionEvent) => void) & ((event: "keydown", evt: Event | KeyboardEvent) => void) & ((event: "mouseenter", evt: MouseEvent) => void) & ((event: "mouseleave", evt: MouseEvent) => void) & ((event: "update:modelValue", value: string) => void);
         $el: any;
         $options: import('vue').ComponentOptionsBase<Readonly<import('vue').ExtractPropTypes<{
             name: {
@@ -82,21 +82,21 @@ declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import
                 type: import('vue').PropType<boolean>;
                 default: undefined;
             };
+            id: {
+                type: import('vue').PropType<string>;
+            };
             type: {
                 type: import('vue').PropType<import('element-plus').InputType>;
                 default: import('element-plus').InputType;
             };
-            id: {
+            form: {
                 type: import('vue').PropType<string>;
             };
             placeholder: {
                 type: import('vue').PropType<string>;
             };
-            form: {
-                type: import('vue').PropType<string>;
-            };
             size: {
-                type: import('vue').PropType<"" | "small" | "default" | "large">;
+                type: import('vue').PropType<"" | "default" | "small" | "large">;
             };
             resize: {
                 type: import('vue').PropType<"horizontal" | "vertical" | "none" | "both">;
@@ -141,7 +141,7 @@ declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import
                 type: import('vue').PropType<boolean>;
             };
             inputmode: {
-                type: import('vue').PropType<"none" | "search" | "url" | "text" | "email" | "tel" | "numeric" | "decimal">;
+                type: import('vue').PropType<"none" | "text" | "search" | "url" | "email" | "tel" | "numeric" | "decimal">;
             };
             modelModifiers: {
                 type: import('vue').PropType<import('element-plus').InputModelModifiers>;
@@ -272,21 +272,21 @@ declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import
             type: import('vue').PropType<boolean>;
             default: undefined;
         };
+        id: {
+            type: import('vue').PropType<string>;
+        };
         type: {
             type: import('vue').PropType<import('element-plus').InputType>;
             default: import('element-plus').InputType;
         };
-        id: {
+        form: {
             type: import('vue').PropType<string>;
         };
         placeholder: {
             type: import('vue').PropType<string>;
         };
-        form: {
-            type: import('vue').PropType<string>;
-        };
         size: {
-            type: import('vue').PropType<"" | "small" | "default" | "large">;
+            type: import('vue').PropType<"" | "default" | "small" | "large">;
         };
         resize: {
             type: import('vue').PropType<"horizontal" | "vertical" | "none" | "both">;
@@ -331,7 +331,7 @@ declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import
             type: import('vue').PropType<boolean>;
         };
         inputmode: {
-            type: import('vue').PropType<"none" | "search" | "url" | "text" | "email" | "tel" | "numeric" | "decimal">;
+            type: import('vue').PropType<"none" | "text" | "search" | "url" | "email" | "tel" | "numeric" | "decimal">;
         };
         modelModifiers: {
             type: import('vue').PropType<import('element-plus').InputModelModifiers>;
@@ -385,7 +385,7 @@ declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import
         onMouseenter?: ((evt: MouseEvent) => any) | undefined;
         onMouseleave?: ((evt: MouseEvent) => any) | undefined;
         onClear?: (() => any) | undefined;
-    }, "disabled" | "type" | "blur" | "focus" | "clear" | "input" | "select" | "textarea" | "modelValue" | "autocomplete" | "clearIcon" | "validateEvent" | "tabindex" | "inputStyle" | "ref" | "modelModifiers" | "autosize" | "wordLimitPosition" | "rows" | "textareaStyle" | "isComposing" | "resizeTextarea"> & import('vue').ShallowUnwrapRef<{
+    }, "disabled" | "blur" | "type" | "input" | "select" | "textarea" | "focus" | "clear" | "modelValue" | "autocomplete" | "clearIcon" | "validateEvent" | "tabindex" | "inputStyle" | "ref" | "modelModifiers" | "autosize" | "wordLimitPosition" | "rows" | "textareaStyle" | "isComposing" | "resizeTextarea"> & import('vue').ShallowUnwrapRef<{
         input: import('vue').ShallowRef<HTMLInputElement | undefined>;
         textarea: import('vue').ShallowRef<HTMLTextAreaElement | undefined>;
         ref: import('vue').ComputedRef<HTMLInputElement | HTMLTextAreaElement | undefined>;

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

@@ -27,9 +27,9 @@ declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, imp
         visible: boolean | 0;
     }) => any) | undefined;
 }>, {
-    hideBounds: boolean;
     stationSlots: IStationSlotConfig[];
     flowOptions: IFlowConfig;
+    hideBounds: boolean;
     visible: boolean | 0;
     containerWidth: number;
     containerHeight: number;