@jnrs/lingshu-smart 2.2.46 → 3.0.0

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

@@ -1,4 +1,4 @@
-import { ILayerOperating } from '../../types';
+import { SocketMessage } from '../../types';
 export interface LogEntry {
     datetime: string;
     type: string;
@@ -11,7 +11,8 @@ export interface WsProxyLogEntry {
     direction: LogDirection;
     data: any;
 }
-export type RunLogEntry = ILayerOperating;
+/** 运行日志条目：WsProxy 代理生成的标准信封协议消息（envelope + payload） */
+export type RunLogEntry = SocketMessage<Record<string, unknown>>;
 type __VLS_Props = {
     logs: any[];
     maxLogCount: number;
@@ -24,8 +25,23 @@ type __VLS_Props = {
     textFn?: (row: any) => string;
     /** 是否展示方向/类型列（WsProxy 消息日志专用） */
     showDirectionType?: boolean;
+    /** 运行日志专用：envelope.id → command_ack 结果映射。消费端回执关联，
+     *  用于展示"跳过 N 项类型不匹配"等消费端语义（代理器本身无资源池状态） */
+    ackMap?: Map<string, {
+        code: number;
+        message: string;
+    }>;
 };
-declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        'filter-extra'?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     copy: () => any;
     clear: () => any;
     "update:maxLogCount": (value: number) => any;
@@ -40,5 +56,15 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     dataLabel: string;
     textFn: (row: any) => string;
     showDirectionType: boolean;
+    ackMap: Map<string, {
+        code: number;
+        message: string;
+    }>;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -34,9 +34,9 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
     right: string;
     top: string;
     bottom: string;
+    position: "static" | "fixed" | "absolute";
     layout: Layout;
     collapsible: boolean;
     showHeader: boolean;
-    position: "static" | "fixed" | "absolute";
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

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

@@ -11,7 +11,6 @@ type __VLS_Props = {
     selectedFieldConfigs: ScriptFieldConfig[];
     deviceOptions: DeviceOption[];
     resourceDeviceOptions: DeviceOption[];
-    statusDisplayColor: string;
     selectedDeviceValue: DeviceOption | null;
     addDeviceValue: DeviceOption | null;
     removeDeviceValue: DeviceOption | null;
@@ -35,5 +34,5 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     "onUpdate:customData"?: ((value: string) => any) | undefined;
     "onMove-up"?: ((uid: string) => any) | undefined;
     "onMove-down"?: ((uid: string) => any) | undefined;
-}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

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

@@ -21,9 +21,11 @@ type __VLS_Props = {
     isIndeterminate: boolean;
     scriptTemplates: ScriptTemplate[];
     deviceOptions: DeviceOption[];
+    /** 各步骤缺失的必填字段映射（uid → 字段 key 列表）：为有问题的步骤在 info 底部加红色虚线标记 */
+    stepErrors: Record<string, string[]>;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    add: () => any;
+    add: (kind: "single" | "continuous") => any;
     select: (uid: string) => any;
     stop: () => any;
     "update:allChecked": (value: boolean) => any;
@@ -35,7 +37,7 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     "step-next": () => any;
     "load-template": (name: string) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onAdd?: (() => any) | undefined;
+    onAdd?: ((kind: "single" | "continuous") => any) | undefined;
     onSelect?: ((uid: string) => any) | undefined;
     onStop?: (() => any) | undefined;
     "onUpdate:allChecked"?: ((value: boolean) => any) | undefined;

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

@@ -2,15 +2,26 @@ import { ILayer } from '../../../types';
 type __VLS_Props = {
     /** 当前方案的设备图层列表 */
     layers?: ILayer[];
+    /** 当前方案（脚本按方案分组持久化 / 烧录，需据此确定归属；未传时回退 store 中的激活方案） */
+    currentCase?: {
+        id?: string;
+        title?: string;
+    } | null;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {
     open: () => void;
     isRunning: import('vue').Ref<boolean, boolean>;
+    /** 快捷执行：运行脚本（供外部右键等快捷入口调用，等效点击弹窗内「运行」按钮） */
+    run: () => void;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     message: (message: any) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     onMessage?: ((message: any) => any) | undefined;
 }>, {
     layers: ILayer[];
+    currentCase: {
+        id?: string;
+        title?: string;
+    } | null;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

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

@@ -1,21 +1,34 @@
 /**
  * @File   : script.ts
  * @Desc.  : 脚本模拟器的设备字段配置与预设模板
+ *           严格对齐《socket-operating-api.md》(v3.5)：
+ *           - 每个步骤生成「信封 + 数据体」标准消息（envelope + payload）
+ *           - envelope.type 固定值分发，msgType 记录该步骤的信封类型（缺省按模式推导）
+ *           - 业务数据字段 key 即 payload 点路径（如 light.color / position.x），
+ *             生成消息时由 buildDevicePayload 展开为嵌套结构
  */
+/** 画布模型 className → socket 协议 device_type（snake_case，见 socket-operating-api.md 6.0） */
+export declare const toDeviceType: (className: string) => string;
 /** 字段配置 */
 export interface ScriptFieldConfig {
     key: string;
     label: string;
     /**
-     * 字段类型。json：对象/数组类型业务字段（如 stationColor、layerStationStatus、laserSiteNumberArray），
-     * 以 JSON 文本字符串形式编辑与存储，生成消息/预览时经 parseJsonFieldValues 解析为对象/数组
+     * 字段类型。key 为 payload 点路径（如 light.color / position.x），生成/预览时展开为嵌套对象。
+     * json：对象/数组类型业务字段（如 layer_visible、marking_sites），以 JSON 文本字符串形式编辑与存储，
+     * 生成消息/预览时经 buildDevicePayload 解析为对象/数组。
+     * device：设备下拉选择（持续运行步骤的「驱动设备」字段）
      */
-    type: 'input' | 'select' | 'switch' | 'number' | 'color' | 'json';
+    type: 'input' | 'select' | 'switch' | 'number' | 'color' | 'json' | 'device';
     options?: {
         label: string;
         value: string | number;
     }[];
+    /** 是否必填：label 加红色 * 标记（无合理默认值、缺省会导致消息无效的字段） */
+    required?: boolean;
     default?: any;
+    /** 输入提示占位文本（json 等类型可按字段语义定制，如数组/对象示例） */
+    placeholder?: string;
     step?: number;
     min?: number;
     max?: number;
@@ -27,19 +40,32 @@ export interface ScriptStep {
     deviceId: string;
     delay: number;
     enabled: boolean;
+    /** 业务数据（payload），key 为点路径；生成消息时展开为嵌套结构 */
     params: Record<string, any>;
-    /** 返回码（0 操作成功 / 400 客户端参数错误 / 500 服务端处理异常） */
-    code: number;
-    /** 返回消息说明（可选 code 自动带入后可修改） */
-    msg: string;
-    /** 消息体字段名：'data' 或 'payload' */
-    payloadKey: 'data' | 'payload';
-    /** 顶层 type 值（可自由配置，默认 'update'） */
+    /**
+     * 用户显式配置过的字段 key 列表：
+     * 生成消息时仅发送这些字段，避免设备字段默认值（如 position.x=0）把模型瞬间移回原点，
+     * 与「持续运行」等高频位置驱动冲突造成抖动。undefined 表示兼容旧数据（全部发送）
+     */
+    configuredKeys?: string[];
+    /** 信封类型（envelope.type 固定值，见 socket-operating-api.md 2.2）；缺失时按模式推导 */
     msgType: string;
-    /** 自定义业务数据 JSON 文本（设备/资源选择「自定义」时启用，作为业务数据） */
+    /** 自定义业务数据 JSON 文本（设备/资源选择「自定义」时启用，作为完整消息体或 payload） */
     customData?: string;
-    /** type 字段覆盖值：设置后业务数据中的 type 使用此值而非 deviceType */
-    typeOverride?: string;
+}
+/**
+ * 单个方案的脚本数据（与 WsProxy 的 `WsProxyCaseConfig` 对称，按方案分组持久化/烧录）。
+ * 脚本的设备下拉来自所属方案的图层，故脚本天然绑定方案，不做跨方案共享。
+ */
+export interface ScriptCaseData {
+    /** 绑定的方案 id（currentCase.id）；空串表示未绑定方案（宿主未提供方案上下文时的兜底） */
+    caseId: string;
+    /** 方案名称（currentCase.title），用于文件可读性与列表展示；可缺省，缺省时回退 id */
+    caseName?: string;
+    /** 脚本步骤列表 */
+    steps: ScriptStep[];
+    /** 「循环脚本」开关（按方案保存，属该方案的运行配置） */
+    looping: boolean;
 }
 /** 脚本模板 */
 export interface ScriptTemplate {
@@ -54,61 +80,134 @@ export declare const deviceTypeOptions: {
 }[];
 /** 设备/资源下拉「自定义」选项的标识值（选中后编辑自定义业务数据 JSON） */
 export declare const CUSTOM_DEVICE_TYPE = "__custom__";
-/** 设备/资源下拉「全部复位」选项的标识值（选中后业务数据 type 预置 resetAll，经代理器触发画布全部复位） */
+/** 设备/资源下拉「全部复位」选项的标识值（选中后消息为 scene_reset，画布全部复位） */
 export declare const RESET_ALL_TYPE = "__resetAll__";
-/** 「全部复位」业务数据的 type 预设值（与代理器全局操作类 ResetAll 规则的源类型值一致） */
-export declare const RESET_ALL_MSG_TYPE = "resetAll";
-/** 资源类型选项 */
+/** 「全部复位」的信封类型（envelope.type：scene_reset） */
+export declare const RESET_ALL_MSG_TYPE = "scene_reset";
+/** 设备/资源下拉「持续运行」选项的标识值（选中后按设定频率持续发送设备高频消息，模拟生产环境持续运行） */
+export declare const CONTINUOUS_TYPE = "__continuous__";
+/** 资源类型选项（resource_type：workpiece / tool / auxiliary） */
 export declare const resourceTypeOptions: {
     label: string;
     value: string;
 }[];
-/** 通用状态字典：状态值/文本/颜色三要素，供「状态」下拉选择与状态灯颜色展示使用 */
+/** 机器人夹具选项（current_fixture：三类资源 + none 空夹具，见 socket-operating-api.md 6.7） */
+export declare const fixtureOptions: {
+    label: string;
+    value: string;
+}[];
+/** 通用状态字典：状态值/文本/颜色三要素（供状态灯颜色快速选择） */
 export interface CommonStatusOption {
     label: string;
     value: number;
     displayColor: string;
 }
 export declare const commonDict: CommonStatusOption[];
-/** 资源状态字典：资源增删专用，状态值/文本/颜色三要素 */
-export declare const resourceDict: CommonStatusOption[];
-/** 返回码字典：code / 说明，供「返回码」下拉与 msg 自动带入使用 */
-export interface CodeOption {
+/** 资源操作类型选项（resource_command 的 payload.operation），对应 socket-operating-api.md 第 8 章 */
+export declare const resourceOperationOptions: {
     label: string;
-    value: number;
-}
-export declare const codeDict: CodeOption[];
-/** 默认消息体字段名 */
-export declare const defaultPayloadKey: 'data' | 'payload';
-/** 默认顶层 type 值 */
-export declare const defaultMsgType = "update";
-/** 顶层消息 type 预置选项（消息配置 type 下拉，filterable + allow-create 可自由输入其他值） */
-export declare const msgTypeOptions: string[];
-/** 默认返回码 */
-export declare const defaultCode = 0;
-/** 默认返回说明 */
-export declare const defaultMsg = "\u64CD\u4F5C\u6210\u529F";
+    value: string;
+}[];
+/** 各资源操作下展示的字段（按 key 排列）：切换操作类型时面板据此显隐字段（见 resourceOperationFields 对应注释） */
+export declare const resourceOperationFields: Record<string, string[]>;
+/** 各资源操作必填字段（界面据此动态标记红色 *）：与 resourceOperationFields 联用。
+ *  严格对齐文档：ResourceLocation 中仅 device_id 必填，layer / device_station 均为可选（见 socket-operating-api-backend.md 3.2），
+ *  故 add/transfer 仅标记 to_id（目标 device_id）为必填，to_type / to_device_station / to_device_layer 一律可选；
+ *  transfer 的 from 整体可选；remove 的 resource_type 可选。 */
+export declare const resourceOperationRequired: Record<string, string[]>;
+/** 校验资源步骤缺失的必填字段（按当前 operation 对齐文档）。返回缺失字段 key 列表；非资源步骤 / 无缺失返回空数组 */
+export declare function missingResourceFields(step: Pick<ScriptStep, 'deviceType' | 'params' | 'msgType'>): string[];
+/** 消息信封类型预置选项（envelope.type，见 socket-operating-api.md 2.2）。
+ *  下拉框：左侧显示 type 值，右侧显示对应操作中文名；resource_command 置于首位。
+ *  末尾「自定义」为信封级自定义（编辑 envelope + payload 完整 JSON）。 */
+export declare const CUSTOM_MSG_TYPE = "__custom__";
+export declare const msgTypeOptions: {
+    value: string;
+    label: string;
+}[];
+/** 按设备/模式推导默认信封类型（envelope.type） */
+export declare function defaultEnvelopeType(deviceType: string): string;
+/**
+ * 解析步骤实际生效的信封类型（envelope.type）：
+ * - 已显式设置且非旧协议遗留值（'update'）时采用 msgType
+ * - 否则按设备/模式推导（defaultEnvelopeType）
+ */
+export declare const resolveEnvelopeType: (step: {
+    deviceType: string;
+    msgType: string;
+}) => string;
+/**
+ * 业务区形态：由信封类型（envelope.type）联动决定「设备选择 / 业务参数」需要显示的内容。
+ * - device → 目标设备选择 + 设备业务参数（device_command）
+ * - resource → 资源操作参数（to/from 设备，无目标设备）（resource_command）
+ * - custom → 无结构化表单，编辑自定义 JSON【alarm_push / runtime_status_push / device_init / 自定义步骤】
+ * - none → 无业务参数，仅提示【scene_reset / 全部复位】
+ * - continuous → 持续运行驱动参数（模拟器步骤物种，与协议信封类型正交）
+ */
+export type PayloadMode = 'device' | 'resource' | 'custom' | 'none' | 'continuous';
+/** 由信封类型（envelope.type）推导业务区形态；模拟器特殊步骤物种（自定义/持续/复位）优先按 deviceType 判断 */
+export declare function payloadModeOf(step: {
+    deviceType: string;
+    msgType: string;
+}): PayloadMode;
+/** 解析自定义业务数据 JSON 文本：目标 JSON 对象；解析失败时返回包含错误提示的对象 */
+export declare function parseCustomData(text: string | undefined): Record<string, any>;
+/** 无结构化表单的信封类型（选择后编辑完整 envelope + payload JSON） */
+export declare const CUSTOM_PAYLOAD_MSG_TYPES: string[];
+/** 组装某信封类型的默认「envelope + payload」完整 JSON 文本：选择该信封类型时自动带入编辑（envelope 仅含 type，id/timestamp 发送时再生成） */
+export declare function defaultEnvelopePayloadJson(type: string): string;
 /** 可作为资源容器的设备类型 */
 export declare const containerDeviceOptions: {
     label: string;
     value: string;
 }[];
-/** 各设备类型的字段配置 */
+/** 各设备类型的字段配置（key 即 payload 点路径，与 socket 协议 payload 结构一致，见 socket-operating-api.md 第 6 章） */
 export declare const deviceFieldConfigs: Record<string, ScriptFieldConfig[]>;
+/**
+ * 根据设备类型与（点路径）params 构建嵌套 payload。
+ * - 仅保留显式配置的字段（configuredKeys），避免默认 0 值复位设备
+ * - json 类型字段（layer_visible / marking_sites / layer_light_colors 等）由文本字符串解析为对象
+ * - 点路径（如 light.color / position.x）展开为嵌套对象
+ * - 兼容旧协议扁平键（x/lightColor/percent 等）映射为嵌套键，见 LEGACY_KEY_MAP
+ */
+export declare function buildDevicePayload(deviceType: string, params: Record<string, any>, configuredKeys?: string[]): Record<string, any>;
+/**
+ * 由脚本步骤生成完整协议消息（envelope + payload），严格对齐 socket-operating-api.md。
+ * payload 形态与 envelope.type 联动（与面板 payloadModeOf 一致）：
+ * - device_command → 设备嵌套 payload（点路径 params 经 buildDevicePayload 展开）
+ * - resource_command → 资源操作 payload（add / transfer / remove）
+ * - device_init / alarm_push / runtime_status_push → 无结构化表单，取自定义 JSON 作为 payload/完整消息
+ * - scene_reset（含全部复位）→ 空 payload
+ * - 自定义步骤 → 完整消息体原样透出（含 envelope 时保留其 type，重生成 id/timestamp 避免被分发器按 id 去重丢弃）
+ */
+export declare function buildMessage(step: ScriptStep): {
+    envelope: Record<string, any>;
+    payload: any;
+};
 /**
  * 模板说明：
  * - 每个步骤的 deviceId 留空，由 loadTemplate 根据当前方案自动回填
  * - 单设备模板总时长 ≤ 3 秒
  * - 完整生产流程展示资源跨设备搬运全流程
- * - 状态值：0=待机，1=运行，2=报警（见 commonDict）
- * - x 值每步增量 ≤ 0.03，整体移动幅度小（轻微移动）
+ * - 状态灯颜色：待机 #999999 / 运行 #66DC7A / 报警 #E83B30（见 commonDict）
+ * - 位置字段使用点路径 position.x，每步增量 ≤ 0.03，整体移动幅度小（轻微移动）
  */
 export declare const scriptTemplates: ScriptTemplate[];
 /** 获取设备类型中文标签 */
 export declare function getDeviceLabel(deviceType: string): string;
+/**
+ * 步骤显示名（缺必填等提示用）：
+ * - 绑定了目标设备：`设备名 (device_id)`
+ * - 旧形态特殊物种（Resource / __custom__ / __resetAll__ 等）：按 deviceType 取设备 label
+ * - 新形态步骤（deviceType 为空，物种由信封类型决定，如 resource_command 资源操作）：回退信封类型 label，
+ *   避免出现「步骤「」」空名提示
+ */
+export declare function stepLabel(step: {
+    deviceType: string;
+    deviceId: string;
+    msgType: string;
+}): string;
 /** 深拷贝字段默认值：对象/数组类型默认值不可跨步骤共享引用 */
 export declare function cloneDefault(value: any): any;
-/** 将 payload 中 json 类型字段的字符串值解析为对象/数组（供消息生成与预览使用；字段 key 参考 deviceFieldConfigs） */
-export declare function parseJsonFieldValues(deviceType: string, payload: Record<string, any>): void;
-/** 为指定设备类型创建默认参数 */
+/** 为指定设备类型创建默认参数（key 为点路径，与 deviceFieldConfigs 一致） */
 export declare function createDefaultParams(deviceType: string): Record<string, any>;

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

@@ -0,0 +1,92 @@
+import { ScriptStep, ScriptCaseData } from './script';
+/** 脚本文件路径（业务工程 public 目录下，与 cases.json 平级） */
+export declare const MOCK_SOCKET_FILE_URL = "public/lingshu-smart/mockSocket.json";
+/** 脚本烧录接口（开发服务器中间件，由 src/vite.ts 的 lingshuBurnCasesPlugin 提供） */
+export declare const BURN_SCRIPTS_ENDPOINT = "/lingshu-smart/__burn-mock-socket";
+/** 从文件加载脚本的结果 */
+export type ScriptFileResult = {
+    status: 'ok';
+    configs: ScriptCaseData[];
+    repaired: number;
+} | {
+    status: 'missing';
+    reason: string;
+} | {
+    status: 'invalid';
+    reason: string;
+} | {
+    status: 'unknown';
+    reason: string;
+};
+/** 烧录结果 */
+export type BurnScriptsResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/** 解析脚本数据的结果 */
+export type ParseScriptsResult = {
+    ok: true;
+    configs: ScriptCaseData[];
+    repaired: number;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * 校验单个脚本步骤的形状。
+ * 宽松策略（避免旧数据 / 手写 JSON 被误拒）：仅 `deviceType` 强制为字符串，
+ * 其余字段缺省时容忍（由 normalizeScriptSteps 补默认值），存在时才校验类型。
+ * `msgType` 不做值域白名单（兼容历史 `'update'` 与空串推导）。
+ */
+export declare function isScriptStep(value: unknown): value is ScriptStep;
+/** 校验脚本步骤数组形状 */
+export declare function isScriptStepArray(value: unknown): value is ScriptStep[];
+/**
+ * 规范化脚本步骤：补全缺省字段，并为缺失 / 重复的 uid 重新生成（保留首个出现者）。
+ * 不拒绝任何已通过 isScriptStepArray 的数据，仅做修复。
+ * @returns steps 规范化后的新数组（不改动入参）；repaired uid 被补全或重建的条数
+ */
+export declare function normalizeScriptSteps(steps: ScriptStep[]): {
+    steps: ScriptStep[];
+    repaired: number;
+};
+/** 校验单个方案的脚本数据（steps 逐项校验） */
+export declare function isScriptCaseData(value: unknown): value is ScriptCaseData;
+/** 校验脚本配置数组形状 */
+export declare function isScriptCaseDataArray(value: unknown): value is ScriptCaseData[];
+/**
+ * 规范化脚本配置数组：补全各方案缺省字段（steps 内的 uid 一并修复）
+ * @returns configs 规范化后的新数组；repaired uid 被补全或重建的条数
+ */
+export declare function normalizeScriptCases(configs: ScriptCaseData[]): {
+    configs: ScriptCaseData[];
+    repaired: number;
+};
+/** 解析脚本数据（对象形态直接判非法，仅接受按方案分组的数组） */
+export declare function parseScriptCasesData(data: unknown): ParseScriptsResult;
+/** 解析脚本文本（导入用）：JSON 解析失败或结构非法时返回失败原因 */
+export declare function parseScriptCasesJson(text: string): ParseScriptsResult;
+/**
+ * 从业务工程 public 目录加载脚本文件（默认 public/lingshu-smart/mockSocket.json）。
+ * 先取 text 再解析：开发服务器对 public 下缺失路径会 fallback 返回 index.html（HTTP 200），
+ * 直接 res.json() 会抛 `Unexpected token '<'`，此处统一按「文件不存在」处理。
+ */
+export declare function loadScriptCasesFromFile(fileUrl?: string): Promise<ScriptFileResult>;
+/**
+ * 烧录脚本到 public/lingshu-smart/mockSocket.json（开发服务器写盘，需宿主已注册 lingshuBurnCasesPlugin）
+ * @param configs 全部方案的脚本数据（完整文件覆盖语义，与 cases.json 烧录一致）
+ */
+export declare function burnScriptCases(configs: ScriptCaseData[]): Promise<BurnScriptsResult>;
+/** 导出脚本为本地 JSON 文件（文件名默认 mockSocket_<时间戳>.json） */
+export declare function exportScriptCases(configs: ScriptCaseData[], fileName?: string): void;
+/**
+ * 单个方案的脚本内容 hash（仅 steps + looping，不含 caseId / caseName，
+ * 避免方案重命名被误判为「有未烧录改动」；必须先深拷贝，响应式 Proxy 直接 hash 会异常）
+ */
+export declare function hashScriptCase(data: Pick<ScriptCaseData, 'steps' | 'looping'>): string;
+/** 读取指定方案的「已同步基线」hash（无基线时返回空串） */
+export declare function readBaselineHash(caseId: string): string;
+/** 写入指定方案的「已同步基线」hash（文件加载 / 烧录 / 导入成功后调用；用户手动编辑不更新） */
+export declare function writeBaselineHash(caseId: string, hash: string): void;

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

@@ -1,4 +1,4 @@
-import { ILayerOperating, IScene } from '../../../types';
+import { IScene, SocketMessage } from '../../../types';
 import { WsProxyConfig, ProxyRule, DictFn } from './proxy';
 type __VLS_Props = {
     /** 是否自动应用注入的消息（父组件调用 expose 的 feedMessage 时） */
@@ -8,13 +8,13 @@ type __VLS_Props = {
     /** 场景信息：用于字段映射中 percentToPixel 换算（如 currentCase.scene）
      *  兼容旧用法：new 用法下由 currentCase.scene 派生，仅当 currentCase 缺失时回退此 prop */
     scene?: IScene | null;
-    /** 当前方案 uuid：按方案自动匹配代理配置，未匹配则新建并绑定
-     *  兼容旧用法：new 用法下由 currentCase.uuid 派生，仅当 currentCase 缺失时回退此 prop */
+    /** 当前方案 id：按方案自动匹配代理配置，未匹配则新建并绑定
+     *  兼容旧用法：new 用法下由 currentCase.id 派生，仅当 currentCase 缺失时回退此 prop */
     currentCaseId?: string;
-    /** 当前方案（含 uuid/scene/title/layers）：作为唯一权威来源，
+    /** 当前方案（含 id/scene/title/layers）：作为唯一权威来源，
      *  内部派生 caseId 与 scene，并据此动态生成「画布模型类」列表 */
     currentCase?: {
-        uuid?: string;
+        id?: string;
         title?: string;
         scene?: IScene | null;
         layers?: Array<{
@@ -37,18 +37,20 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
     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;
+    "socket-message": (message: SocketMessage<Record<string, unknown>>) => any;
+    "runtime-status": (data: Record<string, 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;
+    "onSocket-message"?: ((message: SocketMessage<Record<string, unknown>>) => any) | undefined;
+    "onRuntime-status"?: ((data: Record<string, unknown>) => any) | undefined;
     "onStatus-change"?: ((connected: boolean) => any) | undefined;
 }>, {
     config: WsProxyConfig;
     scene: IScene | null;
     currentCase: {
-        uuid?: string;
+        id?: string;
         title?: string;
         scene?: IScene | null;
         layers?: Array<{