@ray-js/robot-data-stream 0.0.15-beta.8 → 0.0.16-beta.1

package/lib/constant.d.ts

@@ -1,6 +1,7 @@
 export declare const SUCTION_MAP: Record<string, number>;
 export declare const CISTERN_MAP: Record<string, number>;
 export declare const CLEAN_MODE_MAP: Record<string, number>;
+export declare const ROUTE_PREFERENCE_MAP: Record<string, number>;
 export declare enum FileNameEnum {
     map = "map.bin",
     mapStructured = "map_structured.bin",

package/lib/constant.js

@@ -28,6 +28,17 @@ export const CLEAN_MODE_MAP = {
   clean_before_mop: 3,
   sweep_after_mop: 3
 };
+
+// 路线偏好（四种清洁偏好）
+export const ROUTE_PREFERENCE_MAP = {
+  standard: 0,
+  // 标准
+  fast: 1,
+  // 快速
+  deep: 2,
+  // 深度
+  custom: 3 // 自定义
+};
 export let FileNameEnum = /*#__PURE__*/function (FileNameEnum) {
   FileNameEnum["map"] = "map.bin";
   FileNameEnum["mapStructured"] = "map_structured.bin";

package/lib/mqtt/hooks/useStructuredMessage.d.ts

@@ -13,8 +13,5 @@ export declare const useStructuredMessage: () => {
 };
 /**
  * 错误处理工具函数
- * @param error 错误对象
- * @param defaultMessage 默认错误消息
- * @returns Error 对象
  */
 export declare const handleMqttError: (error: unknown, defaultMessage: string) => Error;

package/lib/mqtt/hooks/useStructuredMessage.js

@@ -1,11 +1,29 @@
 import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
-import { getDeviceOnlineType, onDeviceOnlineStatusUpdate } from '@ray-js/ray';
+import { getDeviceOnlineType, offDeviceOnlineStatusUpdate, onDeviceOnlineStatusUpdate } from '@ray-js/ray';
 import { isFunction } from 'lodash-es';
 import { useCallback, useEffect, useRef } from 'react';
 import { getBitValue, logger } from '../../utils';
 import { createSetCommonParams } from '../createCommonOptions';
 import { useMqtt } from '../mqttProvider';
 import { normalResolve } from '../promise';
+// 常量定义
+const COMMUNICATION_CHANNELS = {
+  MQTT: 'mqtt',
+  LAN: 'lan'
+};
+const DEVICE_ONLINE_BITS = {
+  WIFI: 0,
+  LOCAL: 1
+};
+const LOG_LEVEL = {
+  INFO: 'info',
+  ERROR: 'error'
+};
+
+// 类型定义
+
+// 通信方法接口
+
 /**
  * 统一的 MQTT 消息发送 Hook
  * 提供统一的 sendMqttMessage 方法，自动从 Context 获取 devId 和配置
@@ -15,103 +33,160 @@ export const useStructuredMessage = () => {
   const {
     devId
   } = context.devices.common.getDevInfo();
-  const isLocalOnLineRef = useRef(false);
-  const isWifiOnLineRef = useRef(true);
-  const _onDeviceOnlineStatusChange = useCallback(_ref => {
+  const isLocalOnlineRef = useRef(false);
+  const isWifiOnlineRef = useRef(true);
+
+  // 设备在线状态处理器
+  const handleDeviceOnlineStatusChange = useCallback(_ref => {
     let {
       onlineType
     } = _ref;
-    // bit 0: WiFi在线
-    const wifiOnline = !!getBitValue(onlineType, 0);
-    // bit 1: 局域网在线
-    const localOnline = !!getBitValue(onlineType, 1);
-    logger('info', {
-      msg: `onDeviceOnlineStatusChange00000: onlineType ==>${onlineType}===>wifiOnline:${wifiOnline}===>localOnline:${localOnline}`
-    });
-    isLocalOnLineRef.current = localOnline;
-    isWifiOnLineRef.current = wifiOnline;
+    const wifiOnline = Boolean(getBitValue(onlineType, DEVICE_ONLINE_BITS.WIFI));
+    const localOnline = Boolean(getBitValue(onlineType, DEVICE_ONLINE_BITS.LOCAL));
+    isLocalOnlineRef.current = localOnline;
+    isWifiOnlineRef.current = wifiOnline;
   }, []);
+
+  // 订阅设备在线状态更新
   useEffect(() => {
     if (!devId) return;
-    getDeviceOnlineType({
+    (() => {
+      getDeviceOnlineType({
+        deviceId: devId,
+        success: handleDeviceOnlineStatusChange
+      });
+    })();
+    onDeviceOnlineStatusUpdate(handleDeviceOnlineStatusChange);
+    return offDeviceOnlineStatusUpdate(handleDeviceOnlineStatusChange);
+  }, [devId, handleDeviceOnlineStatusChange]);
+
+  // MQTT 通信方法
+  const mqttCommunication = {
+    isAvailable: () => {
+      var _ty;
+      return isWifiOnlineRef.current && ((_ty = ty) === null || _ty === void 0 ? void 0 : _ty.device) && isFunction(ty.device.sendMqttMessage);
+    },
+    send: (params, successCallback, failCallback) => {
+      const messageParams = _objectSpread(_objectSpread({}, params), {}, {
+        success: successCallback,
+        fail: failCallback
+      });
+      ty.device.sendMqttMessage(messageParams);
+    }
+  };
+
+  // LAN 通信方法
+  const lanCommunication = {
+    isAvailable: () => {
+      var _ty2;
+      return isLocalOnlineRef.current && ((_ty2 = ty) === null || _ty2 === void 0 ? void 0 : _ty2.device) && isFunction(ty.device.publishLanMessage);
+    },
+    send: (params, successCallback, failCallback) => {
+      const messageParams = _objectSpread(_objectSpread({}, params), {}, {
+        success: successCallback,
+        fail: failCallback
+      });
+      ty.device.publishLanMessage(messageParams);
+    }
+  };
+
+  // 创建消息参数
+  const createMessageParams = (reqType, message, useLocal) => {
+    return createSetCommonParams({
       deviceId: devId,
-      success: _onDeviceOnlineStatusChange
+      reqType,
+      message,
+      isLocalOnLine: useLocal
+    });
+  };
+
+  // 记录通信日志
+  const logCommunication = (level, reqType, message, params) => {
+    const baseMessage = `${reqType} ${message}`;
+    const fullMessage = params ? `${baseMessage}: ${JSON.stringify(params)}` : baseMessage;
+    logger(level, {
+      msg: fullMessage
     });
-    onDeviceOnlineStatusUpdate(_onDeviceOnlineStatusChange);
-  }, [_onDeviceOnlineStatusChange, devId]);
+  };
+
+  // 通信策略选择器
+  const selectCommunicationMethod = preferredChannel => {
+    const isPreferredMqtt = preferredChannel === COMMUNICATION_CHANNELS.MQTT;
+    const primaryMethod = isPreferredMqtt ? mqttCommunication : lanCommunication;
+    const fallbackMethod = isPreferredMqtt ? lanCommunication : mqttCommunication;
+    const useLocal = isPreferredMqtt ? false : true;
+    if (primaryMethod.isAvailable()) {
+      return {
+        method: primaryMethod,
+        useLocal
+      };
+    }
+    if (fallbackMethod.isAvailable()) {
+      return {
+        method: fallbackMethod,
+        useLocal: !useLocal
+      };
+    }
+    return null;
+  };
+
+  // 处理通信失败
+  const handleCommunicationError = (preferredChannel, reject) => {
+    const errorMessage = preferredChannel === COMMUNICATION_CHANNELS.MQTT ? `操作需要 MQTT 模式，请在 MqttProvider 中启用 useMqtt` : `没有可用的通信方式。局域网在线: ${isLocalOnlineRef.current}, WiFi在线: ${isWifiOnlineRef.current}`;
+    reject(new Error(errorMessage));
+  };
 
   /**
-   * 发送 MQTT 消息
-   * @param reqType 请求类型
-   * @param message 消息体（可选）
-   * @param responseType 响应类型（可选，如果不提供则使用 reqType）
-   * @param resolve Promise 的 resolve 回调
-   * @param reject Promise 的 reject 回调
+   * 发送结构化消息
    */
   const sendStructuredMessage = useCallback((reqType, message, resolve, reject, responseType) => {
+    // 参数验证
     if (!devId) {
-      reject(new Error('devId is required'));
+      reject(new Error('设备ID (devId) 为必填项'));
       return;
     }
-    // 检查是否使用 MQTT 模式
     if (!context.useMqtt) {
-      reject(new Error(`Operation ${reqType} requires MQTT mode. Please enable useMqtt in MqttProvider.`));
+      reject(new Error(`操作 ${reqType} 需要 MQTT 模式。请在 MqttProvider 中启用 useMqtt。`));
       return;
     }
     try {
-      var _ty, _ty2;
-      const params = createSetCommonParams({
-        deviceId: devId,
-        reqType,
-        message,
-        isLocalOnLine: isLocalOnLineRef.current
-      });
-
-      // 优先使用局域网通信（LAN）
-      if (isLocalOnLineRef.current && (_ty = ty) !== null && _ty !== void 0 && _ty.device && isFunction(ty.device.publishLanMessage)) {
-        // @ts-ignore - publishLanMessage 可能不存在于类型定义中
-        ty.device.publishLanMessage(_objectSpread(_objectSpread({}, params), {}, {
-          success: () => {
-            logger('info', {
-              msg: `${reqType} LAN message publish success: ${JSON.stringify(params)}`
-            });
-            // 局域网通信成功回调
-          },
-          fail: e => {
-            logger('error', {
-              msg: `${reqType} LAN message publish failed: ${JSON.stringify(e)}`
-            });
-          }
-        }));
-      }
-      // 如果局域网不可用，使用 WiFi MQTT 通信
-      else if (isWifiOnLineRef.current && (_ty2 = ty) !== null && _ty2 !== void 0 && _ty2.device && isFunction(ty.device.sendMqttMessage)) {
-        ty.device.sendMqttMessage(_objectSpread(_objectSpread({}, params), {}, {
-          success: () => {
-            // WiFi MQTT 通信成功回调
-            logger('info', {
-              msg: `${reqType} WiFi MQTT message send success: ${JSON.stringify(params)}`
-            });
-          },
-          fail: e => {
-            logger('error', {
-              msg: `${reqType} MQTT message send failed: ${JSON.stringify(e)}`
-            });
-          }
-        }));
-      }
-      // 如果两种通信方式都不可用，抛出错误
-      else {
-        reject(new Error(`No available communication method. LAN online: ${isLocalOnLineRef.current}, WiFi online: ${isWifiOnLineRef.current}`));
+      const {
+        preferredChannel
+      } = context;
+      const selectedMethod = selectCommunicationMethod(preferredChannel);
+      if (!selectedMethod) {
+        handleCommunicationError(preferredChannel, reject);
         return;
       }
-      // 如果指定了响应类型，使用响应类型；否则使用请求类型
+      const {
+        method,
+        useLocal
+      } = selectedMethod;
+      const messageParams = createMessageParams(reqType, message, useLocal);
+
+      // 成功回调
+
+      // 失败回调
+
+      // 发送消息
+      method.send(messageParams, () => {
+        const channelName = useLocal ? '局域网' : 'WiFi MQTT';
+        const fallbackSuffix = method === mqttCommunication && preferredChannel === COMMUNICATION_CHANNELS.LAN ? ' (备用)' : '';
+        logCommunication(LOG_LEVEL.INFO, reqType, `${channelName} 消息发送成功${fallbackSuffix}`, messageParams);
+      }, error => {
+        logCommunication(LOG_LEVEL.ERROR, reqType, '消息发送失败', _objectSpread(_objectSpread({}, messageParams), {}, {
+          error: JSON.stringify(error)
+        }));
+      });
+
+      // 处理响应
 
       normalResolve(responseType || reqType, resolve, reject);
     } catch (error) {
+      logCommunication(LOG_LEVEL.ERROR, reqType, `发送消息时发生异常: ${error}`);
       reject(error);
     }
-  }, [devId, context.useMqtt]);
+  }, [devId, context.useMqtt, context.preferredChannel]);
   return {
     sendStructuredMessage
   };
@@ -119,13 +194,13 @@ export const useStructuredMessage = () => {
 
 /**
  * 错误处理工具函数
- * @param error 错误对象
- * @param defaultMessage 默认错误消息
- * @returns Error 对象
  */
 export const handleMqttError = (error, defaultMessage) => {
   if (error instanceof Error) {
     return error;
   }
+  if (typeof error === 'string') {
+    return new Error(error);
+  }
   return new Error(defaultMessage);
 };

package/lib/mqtt/mqttProvider.d.ts

@@ -1,8 +1,10 @@
 import React from 'react';
 import { MqttError } from './promise';
+export type CommunicationChannel = 'mqtt' | 'lan';
 export interface MqttContextValue {
     useMqtt: boolean;
     commandVersion: '0' | '1';
+    preferredChannel: CommunicationChannel;
     devices: {
         common: {
             getDevInfo: () => {
@@ -26,6 +28,13 @@ export interface MqttProviderProps {
     useMqtt: boolean;
     commandVersion: '0' | '1';
     devices: MqttContextValue['devices'];
+    /**
+     * 优先选择的通信通道
+     * - 'mqtt': 优先使用 MQTT 通道（WiFi MQTT）
+     * - 'lan': 优先使用局域网通道（LAN）
+     * @default 'mqtt'
+     */
+    preferredChannel?: CommunicationChannel;
     onMqttReady?: () => void;
     /**
      * 可选的错误处理回调
@@ -45,7 +54,7 @@ export interface MqttProviderProps {
     onError?: MqttErrorHandler;
 }
 export declare function useMqtt(): MqttContextValue;
-export declare function MqttProvider({ children, useMqtt, commandVersion, devices, onError, onMqttReady, }: MqttProviderProps): React.JSX.Element;
+export declare function MqttProvider({ children, useMqtt, commandVersion, devices, preferredChannel, onError, onMqttReady, }: MqttProviderProps): React.JSX.Element;
 export declare namespace MqttProvider {
     var defaultProps: {
         onMqttReady: undefined;

package/lib/mqtt/mqttProvider.js

@@ -7,6 +7,8 @@ import { setUnhandledRejectionHandler } from './promise';
 import { ProtocolEnum } from './type';
 import log4js from '@ray-js/log4js';
 
+// 通信通道类型
+
 // Context 类型定义
 
 // 创建一个Context
@@ -32,6 +34,7 @@ export function MqttProvider(_ref) {
     useMqtt,
     commandVersion,
     devices,
+    preferredChannel = 'mqtt',
     onError,
     onMqttReady
   } = _ref;
@@ -42,10 +45,9 @@ export function MqttProvider(_ref) {
   const instance = useMemo(() => ({
     useMqtt,
     commandVersion,
+    preferredChannel,
     devices
-    // isLocalOnLine,
-    // isWifiOnLine,
-  }), [useMqtt, commandVersion, devices]);
+  }), [useMqtt, commandVersion, preferredChannel, devices]);
 
   // 使用 ref 存储设备 ID 和初始化状态，避免重复初始化
   const devIdRef = useRef(null);

package/lib/mqtt/type/fun.d.ts

@@ -16,7 +16,7 @@ export declare const ProtocolSchemas: {
         sideBrushRotating: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumber<number>>>;
     }, z.core.$strip>;
     update_carpet: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniObject<{
-        ids: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumber<number>>;
+        ids: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<any>;
         shape: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<any>>;
         type: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumber<number>>>;
         cleanMode: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumber<number>>>;
@@ -29,7 +29,7 @@ export declare const ProtocolSchemas: {
         }, z.core.$strip>>>>;
     }, z.core.$strip>;
     delete_carpet: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniObject<{
-        ids: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumber<number>>;
+        ids: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<any>;
     }, z.core.$strip>;
     set_carpet: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniObject<{
         num: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat;
@@ -39,7 +39,7 @@ export declare const ProtocolSchemas: {
         }, z.core.$strip>>>;
         cleanMode: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>;
         shape: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<any>;
-        ids: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>;
+        ids: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<any>;
         type: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
         autoBoost: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
         fineCleaning: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
@@ -48,11 +48,14 @@ export declare const ProtocolSchemas: {
     set_schedule: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniObject<{
         list: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniObject<{
             suctions: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
-            cisterns: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
+            cisterns: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<any>>;
+            waterValues: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<any>>;
             cleanCounts: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
             yMops: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
             sweepMopModes: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
             ids: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
+            routePreferences: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
+            nameLabels: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
             active: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat;
             cycle: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>;
             time: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>;
@@ -85,13 +88,16 @@ export declare const ProtocolSchemas: {
             y: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumber<number>;
         }, z.core.$strip>;
         suctions: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
-        cisterns: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
+        cisterns: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<any>>;
+        waterValues: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<any>>;
         cleanCounts: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
         yMops: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
         sweepMopModes: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
+        routePreferences: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
     }, z.core.$strip>;
     set_wifi_map: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniObject<{
         taskId: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>;
+        switch: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniBoolean<boolean>>;
     }, z.core.$strip>;
     set_voice: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniObject<{
         id: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat;
@@ -124,11 +130,14 @@ export declare const ProtocolSchemas: {
     }, z.core.$strip>;
     set_spot_clean: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniObject<{
         suctions: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
-        cisterns: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
+        cisterns: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<any>>;
+        waterValues: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<any>>;
         cleanCounts: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
         yMops: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
         sweepMopModes: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
         ids: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
+        routePreferences: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
+        nameLabels: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
         spots: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniObject<{
             x: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumber<number>;
             y: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumber<number>;
@@ -137,14 +146,17 @@ export declare const ProtocolSchemas: {
             x: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumber<number>;
             y: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumber<number>;
         }, z.core.$strip>>;
+        names: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
     }, z.core.$strip>;
     set_select_room_clean: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniObject<{
         roomId: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat;
         suction: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>;
-        cistern: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>;
+        cistern: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<any>;
+        waterValue: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<any>;
         cleanTimes: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>;
         yMop: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>;
         sweepMopMode: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>;
+        routePreference: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>;
     }, z.core.$strip>>;
     set_quiet_hours: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniObject<{
         startTime: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniObject<{
@@ -198,18 +210,21 @@ export declare const ProtocolSchemas: {
         position: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumber<number>>;
         subDevId: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>;
     }, z.core.$strip>>;
-    set_carpet_clean: any;
+    set_carpet_clean: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<any>;
     set_room_property: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniObject<{
         num: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>;
         ids: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>;
         suctions: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
-        cisterns: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
+        cisterns: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<any>>;
         cleanCounts: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
         yMops: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
         sweepMopModes: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
         floorTypes: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
         names: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
+        nameLabels: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
         orders: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
+        routePreferences: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
+        waterValues: import("../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<any>>;
     }, z.core.$strip>;
 };
 export type ProtocolTypes = {

package/lib/mqtt/type/fun.js

@@ -21,7 +21,7 @@ import { setVirtualAreaSchema } from './protocols/virtualAreaProtocol';
 import { setVirtualWallSchema } from './protocols/virtualWallProtocol';
 import { setVoiceSchema } from './protocols/voiceProtocol';
 import { setWifiMapSchema } from './protocols/wifiMapProtocol';
-import { setZoneCleanSchema } from './protocols/zoneCleanProtocol';
+import { setZoneCleanSchema, validateSetZoneClean } from './protocols/zoneCleanProtocol';
 
 /**
  * 验证失败错误代码
@@ -68,6 +68,7 @@ const protocolValidators = {
   set_carpet: validateSetCarpet,
   set_schedule: validateSetSchedule,
   set_spot_clean: validateSetSpotClean,
+  set_zone_clean: validateSetZoneClean,
   set_room_property: validateSetRoomProperty
   // query_carpet 没有自定义验证逻辑，不需要注册
   // delete_carpet 没有自定义验证逻辑，不需要注册

package/lib/mqtt/type/index.d.ts

@@ -22,12 +22,15 @@ export declare enum WifiMapEnum {
 }
 export type RoomPreference = {
     suctions?: string[];
-    cisterns?: string[];
+    cisterns?: Array<string | number>;
+    waterValues?: Array<string | number>;
     cleanCounts?: number[];
     yMops?: number[];
     sweepMopModes?: string[];
+    routePreferences?: string[];
     floorTypes?: number[];
     names?: string[];
+    nameLabels?: number[];
     ids?: number[];
     orders?: number[];
 };

package/lib/mqtt/type/protocols/base.d.ts

@@ -5,11 +5,14 @@ export declare const Point: import("../../../myLib/zod/src/v4/mini/schemas").Zod
 }, z.core.$strip>;
 export declare const RoomPreferenceFieldsSchema: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniObject<{
     suctions: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
-    cisterns: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
+    cisterns: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<any>>;
+    waterValues: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<any>>;
     cleanCounts: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
     yMops: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
     sweepMopModes: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
     ids: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
+    routePreferences: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>>;
+    nameLabels: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniOptional<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniNumberFormat>>;
 }, z.core.$strip>;
 export declare const BaseResponseSchema: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniObject<{
     success: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniBoolean<boolean>;

package/lib/mqtt/type/protocols/base.js

@@ -10,8 +10,10 @@ export const Point = z.object({
 export const RoomPreferenceFieldsSchema = z.object({
   // 吸力， closed - 关闭 gentle - 安静 normal - 正常 strong - 强劲 max - 超强 ，默认值为''
   suctions: z.optional(z.array(z.string())),
-  // 拖地水量 "closed"- 关闭,"low"-低,"middle"-中,"high"-高,默认值为''
-  cisterns: z.optional(z.array(z.string())),
+  // 拖地水量 "closed"- 关闭,"low"-低,"middle"-中,"high"-高,默认值为''，兼容number类型
+  cisterns: z.optional(z.array(z.union([z.string(), z.number()]))),
+  // 自定义水量的值
+  waterValues: z.optional(z.array(z.union([z.string(), z.number()]))),
   // 清扫次数 默认值1
   cleanCounts: z.optional(z.array(z.int())),
   // 拖地模式 1:开启Y型拖地 0:关闭Y型拖地  -1 未设置 默认值-1
@@ -19,7 +21,11 @@ export const RoomPreferenceFieldsSchema = z.object({
   // 扫拖模式 "only_sweep":仅扫,"only_mop"：仅拖,"both_work"：扫拖同时,"clean_before_mop"：先扫后拖，默认值为'only_sweep'
   sweepMopModes: z.optional(z.array(z.string())),
   // 房间id集合
-  ids: z.optional(z.array(z.int()))
+  ids: z.optional(z.array(z.int())),
+  // 路线偏好（四种清洁偏好）: "standard"-标准, "fast"-快速, "deep"-深度, "custom"-自定义，默认值为'standard'
+  routePreferences: z.optional(z.array(z.string())),
+  // 房间名称标签
+  nameLabels: z.optional(z.array(z.int()))
 });
 
 // BaseResponse Schema（用于响应类型）

package/lib/mqtt/type/protocols/carpetCleanProtocol.d.ts

@@ -1,12 +1,12 @@
 import * as z from '../../../myLib/zod/mini';
-declare const setCarpetCleanSchema: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniNumber<number>>;
+export declare const setCarpetCleanSchema: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<any>;
 declare const carpetCleanResponseSchema: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniObject<{
     success: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniBoolean<boolean>;
     errCode: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniNumber<number>;
     reqType: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>;
     version: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>;
     taskId: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>;
-    ids: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniNumber<number>>;
+    ids: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<any>;
 }, z.core.$strip>;
 export type CarpetCleanResponse = z.infer<typeof carpetCleanResponseSchema>;
 export type TRequestCarpetClean = () => Promise<CarpetCleanResponse>;

package/lib/mqtt/type/protocols/carpetCleanProtocol.js

@@ -2,11 +2,11 @@ import * as z from '../../../myLib/zod/mini';
 import { BaseResponseSchema } from './base';
 
 // 设置地毯清扫参数 Schema
-const setCarpetCleanSchema = z.array(z.number()); // 地毯ID数组，注意: .min()放在数组元素上
+export const setCarpetCleanSchema = z.array(z.union([z.number(), z.string()]));
 
 // 地毯清扫响应 Schema
 const carpetCleanResponseSchema = z.extend(BaseResponseSchema, {
-  ids: z.array(z.number())
+  ids: z.array(z.union([z.number(), z.string()]))
 });
 
 // 类型导出