@ray-js/robot-data-stream 0.0.15-beta.16 → 0.0.15-beta.18

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

@@ -55,6 +55,7 @@ export declare const ProtocolSchemas: {
             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>;
@@ -87,10 +88,12 @@ 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>>;
@@ -134,6 +137,7 @@ export declare const ProtocolSchemas: {
         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>;
@@ -146,10 +150,12 @@ export declare const ProtocolSchemas: {
     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<{

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

@@ -12,6 +12,7 @@ export declare const RoomPreferenceFieldsSchema: import("../../../myLib/zod/src/
     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

@@ -23,7 +23,9 @@ export const RoomPreferenceFieldsSchema = z.object({
   // 房间id集合
   ids: z.optional(z.array(z.int())),
   // 路线偏好（四种清洁偏好）: "standard"-标准, "fast"-快速, "deep"-深度, "custom"-自定义，默认值为'standard'
-  routePreferences: z.optional(z.array(z.string()))
+  routePreferences: z.optional(z.array(z.string())),
+  // 房间名称标签
+  nameLabels: z.optional(z.array(z.int()))
 });
 
 // BaseResponse Schema（用于响应类型）

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

@@ -8,6 +8,7 @@ export declare const ScheduleItemSchema: import("../../../myLib/zod/src/v4/mini/
     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>;
@@ -22,6 +23,7 @@ export declare const setScheduleSchema: import("../../../myLib/zod/src/v4/mini/s
         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>;
@@ -53,6 +55,7 @@ declare const ScheduleResponseSchema: import("../../../myLib/zod/src/v4/mini/sch
         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>;

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

@@ -58,6 +58,7 @@ export function validateSetSchedule(data) {
 
   // 验证每个定时任务项
   list.forEach((item, index) => {
+    var _item$ids;
     // 验证 time 数组的有效性
     if (item.time.length !== 2) {
       throw new MqttError(`list[${index}].time 必须包含 2 个元素 [小时, 分钟]`, {
@@ -86,6 +87,22 @@ export function validateSetSchedule(data) {
         reqType: 'set_schedule'
       });
     }
+    const expectedLength = ((_item$ids = item.ids) === null || _item$ids === void 0 ? void 0 : _item$ids.length) || 1;
+    const validateLength = (field, value) => {
+      if (value && value.length !== expectedLength) {
+        throw new MqttError(`list[${index}].${field} 长度必须为 ${expectedLength}，实际为 ${value.length}`, {
+          errCode: VALIDATION_ERROR_CODE,
+          reqType: 'set_schedule'
+        });
+      }
+    };
+    validateLength('suctions', item.suctions);
+    validateLength('cisterns', item.cisterns);
+    validateLength('waterValues', item.waterValues);
+    validateLength('cleanCounts', item.cleanCounts);
+    validateLength('yMops', item.yMops);
+    validateLength('sweepMopModes', item.sweepMopModes);
+    validateLength('routePreferences', item.routePreferences);
   });
 }
 

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

@@ -2,10 +2,12 @@ import * as z from '../../../myLib/zod/mini';
 export declare const setSelectRoomCleanSchema: 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>>;
 declare const selectRoomCleanResponseSchema: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniObject<{
     success: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniBoolean<boolean>;
@@ -15,10 +17,12 @@ declare const selectRoomCleanResponseSchema: import("../../../myLib/zod/src/v4/m
     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").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>>;
+    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>;
 export type SetSelectRoomCleanData = z.infer<typeof setSelectRoomCleanSchema>;
 export type SelectRoomCleanResponse = z.infer<typeof selectRoomCleanResponseSchema>;

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

@@ -7,13 +7,17 @@ const roomInfoSchema = z.object({
   // 房间id
   suction: z.optional(z.string()),
   // 吸力， closed - 关闭 gentle - 安静 normal - 正常 strong - 强劲 max - 超强 ，默认值为''
-  cistern: z.string(),
+  cistern: z.optional(z.union([z.string(), z.number()])),
   // 拖地水量 "closed"- 关闭,"low"-低,"middle"-中,"high"-高,默认值为''
+  waterValue: z.optional(z.union([z.string(), z.number()])),
+  // 自定义拖地水量
   cleanTimes: z.optional(z.int()),
   // 清扫次数 默认值1
   yMop: z.optional(z.int()),
   // 拖地模式 1:开启Y型拖地 0:关闭Y型拖地  -1 未设置 默认值-1
-  sweepMopMode: z.optional(z.string()) // 扫拖模式 "only_sweep":仅扫,"only_mop"：仅拖,"both_work"：扫拖同时,"clean_before_mop"：先扫后拖，默认值为'only_sweep'
+  sweepMopMode: z.optional(z.string()),
+  // 扫拖模式 "only_sweep":仅扫,"only_mop"：仅拖,"both_work"：扫拖同时,"clean_before_mop"：先扫后拖，默认值为'only_sweep'
+  routePreference: z.optional(z.string()) // 路线偏好 "standard"-标准, "fast"-快速, "deep"-深度, "custom"-自定义
 });
 
 // 设置选区清扫参数 Schema
@@ -26,13 +30,17 @@ const selectRoomCleanResponseSchema = z.extend(BaseResponseSchema, {
   // 吸力， closed - 关闭 gentle - 安静 normal - 正常 strong - 强劲 max - 超强 ，默认值为''
   suctions: z.optional(z.array(z.string())),
   // 拖地水量 "closed"- 关闭,"low"-低,"middle"-中,"high"-高,默认值为''
-  cisterns: z.optional(z.array(z.string())),
+  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
   yMops: z.optional(z.array(z.int())),
   // 扫拖模式 "only_sweep":仅扫,"only_mop"：仅拖,"both_work"：扫拖同时,"clean_before_mop"：先扫后拖，默认值为'only_sweep'
-  sweepMopModes: z.optional(z.array(z.string()))
+  sweepMopModes: z.optional(z.array(z.string())),
+  // 路线偏好
+  routePreferences: z.optional(z.array(z.string()))
 });
 
 // 类型导出

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

@@ -8,6 +8,7 @@ export declare const setSpotCleanSchema: import("../../../myLib/zod/src/v4/mini/
     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>;
@@ -24,10 +25,12 @@ declare const spotCleanResponseSchema: import("../../../myLib/zod/src/v4/mini/sc
     version: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>;
     taskId: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>;
     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>>>;
     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>>;
     polygons: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>;
     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>>>;

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

@@ -19,10 +19,12 @@ export const setSpotCleanSchema = z.extend(RoomPreferenceFieldsSchema, {
 const spotCleanResponseSchema = z.extend(BaseResponseSchema, {
   // RoomPreferenceFieldsSchema 的字段
   suctions: z.optional(z.array(z.string())),
-  cisterns: z.optional(z.array(z.string())),
+  cisterns: z.optional(z.array(z.union([z.string(), z.number()]))),
+  waterValues: z.optional(z.array(z.union([z.string(), z.number()]))),
   cleanCounts: z.optional(z.array(z.int())),
   yMops: z.optional(z.array(z.int())),
   sweepMopModes: z.optional(z.array(z.string())),
+  routePreferences: z.optional(z.array(z.string())),
   ids: z.optional(z.array(z.int())),
   // 多边形数组（字符串格式）
   polygons: z.array(z.string()),
@@ -49,6 +51,12 @@ export function validateSetSpotClean(data) {
       reqType: 'set_spot_clean'
     });
   }
+  if (data.waterValues && data.waterValues.length !== num) {
+    throw new MqttError(`waterValues 数组长度 (${data.waterValues.length}) 与 spots 数组长度 (${num}) 不一致`, {
+      errCode: VALIDATION_ERROR_CODE,
+      reqType: 'set_spot_clean'
+    });
+  }
   if (data.cleanCounts && data.cleanCounts.length !== num) {
     throw new MqttError(`cleanCounts 数组长度 (${data.cleanCounts.length}) 与 spots 数组长度 (${num}) 不一致`, {
       errCode: VALIDATION_ERROR_CODE,
@@ -67,6 +75,12 @@ export function validateSetSpotClean(data) {
       reqType: 'set_spot_clean'
     });
   }
+  if (data.routePreferences && data.routePreferences.length !== num) {
+    throw new MqttError(`routePreferences 数组长度 (${data.routePreferences.length}) 与 spots 数组长度 (${num}) 不一致`, {
+      errCode: VALIDATION_ERROR_CODE,
+      reqType: 'set_spot_clean'
+    });
+  }
 }
 
 // 函数类型定义

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

@@ -21,10 +21,12 @@ export declare const setZoneCleanSchema: import("../../../myLib/zod/src/v4/mini/
         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>;
 declare const setZoneCleanResponseSchema: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniObject<{
     success: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniBoolean<boolean>;
@@ -35,13 +37,16 @@ declare const setZoneCleanResponseSchema: import("../../../myLib/zod/src/v4/mini
     polygons: import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniArray<import("../../../myLib/zod/src/v4/mini/schemas").ZodMiniString<string>>;
     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>>>;
     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>;
 export type SetZoneCleanData = z.infer<typeof setZoneCleanSchema>;
 export type ZoneCleanResponse = z.infer<typeof setZoneCleanResponseSchema>;
+export declare function validateSetZoneClean(data: SetZoneCleanData): void;
 export type TSetZoneClean = (data: SetZoneCleanData) => Promise<ZoneCleanResponse>;
 export type TRequestZoneClean = () => Promise<ZoneCleanResponse>;
 export {};

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

@@ -1,5 +1,7 @@
 import * as z from '../../../myLib/zod/mini';
+import { MqttError } from '../../promise';
 import { BaseResponseSchema, Point } from './base';
+const VALIDATION_ERROR_CODE = -2;
 const zoneSchema = z.object({
   // 区域点集
   points: z.array(Point),
@@ -20,10 +22,12 @@ export const setZoneCleanSchema = z.object({
   zones: z.array(zoneSchema),
   origin: Point,
   suctions: z.optional(z.array(z.string())),
-  cisterns: z.optional(z.array(z.string())),
+  cisterns: z.optional(z.array(z.union([z.string(), z.number()]))),
+  waterValues: z.optional(z.array(z.union([z.string(), z.number()]))),
   cleanCounts: z.optional(z.array(z.int())),
   yMops: z.optional(z.array(z.int())),
-  sweepMopModes: z.optional(z.array(z.string()))
+  sweepMopModes: z.optional(z.array(z.string())),
+  routePreferences: z.optional(z.array(z.string()))
 });
 
 // 划区清扫响应 Schema
@@ -35,15 +39,38 @@ const setZoneCleanResponseSchema = z.extend(BaseResponseSchema, {
   // 吸力， closed - 关闭 gentle - 安静 normal - 正常 strong - 强劲 max - 超强 ，默认值为''
   suctions: z.optional(z.array(z.string())),
   // 拖地水量 "closed"- 关闭,"low"-低,"middle"-中,"high"-高,默认值为''
-  cisterns: z.optional(z.array(z.string())),
+  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
   yMops: z.optional(z.array(z.int())),
   // 扫拖模式 "only_sweep":仅扫,"only_mop"：仅拖,"both_work"：扫拖同时,"clean_before_mop"：先扫后拖，默认值为'only_sweep'
-  sweepMopModes: z.optional(z.array(z.string()))
+  sweepMopModes: z.optional(z.array(z.string())),
+  // 路线偏好
+  routePreferences: z.optional(z.array(z.string()))
 });
 
 // 类型导出
 
+export function validateSetZoneClean(data) {
+  const num = data.zones.length;
+  const validateLength = (name, value) => {
+    if (value && value.length !== num) {
+      throw new MqttError(`${name} length must be ${num}, actual is ${value.length}`, {
+        errCode: VALIDATION_ERROR_CODE,
+        reqType: 'set_zone_clean'
+      });
+    }
+  };
+  validateLength('suctions', data.suctions);
+  validateLength('cisterns', data.cisterns);
+  validateLength('waterValues', data.waterValues);
+  validateLength('cleanCounts', data.cleanCounts);
+  validateLength('yMops', data.yMops);
+  validateLength('sweepMopModes', data.sweepMopModes);
+  validateLength('routePreferences', data.routePreferences);
+}
+
 // 函数类型定义

package/lib/mqtt/useRoomProperty.js

@@ -1,8 +1,10 @@
+import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
 import { useContext } from 'react';
 import { handleMqttError, useStructuredMessage } from './hooks/useStructuredMessage';
 import { SingletonContext } from './mqttProvider';
 import { RoomPropertyEnum } from './type';
 import { validator } from './type/fun';
+import { normalizeWaterPreferencePayload } from './waterPreference';
 /**
  * 自定义 Hook，用于房间属性管理
  * @param devId 设备ID（可选，如果不提供则从 MqttProvider Context 获取）
@@ -56,7 +58,7 @@ export const useRoomProperty = () => {
             ids
           } = data;
           const len = ids.length;
-          const sendData = {
+          const sendData = _objectSpread({
             num: (_data$num = data.num) !== null && _data$num !== void 0 ? _data$num : len,
             ids,
             suctions: (_data$suctions = data.suctions) !== null && _data$suctions !== void 0 ? _data$suctions : new Array(len).fill('closed'),
@@ -68,13 +70,7 @@ export const useRoomProperty = () => {
             floorTypes: data.floorTypes,
             orders: data.orders,
             routePreferences: (_data$routePreference = data.routePreferences) !== null && _data$routePreference !== void 0 ? _data$routePreference : new Array(len).fill('standard')
-          };
-          // 自定义水量：有传则带上，与 cisterns 并存以兼容旧端
-          if (data.waterValues) {
-            sendData.waterValues = data.waterValues;
-          } else {
-            sendData.waterValues = new Array(len).fill('');
-          }
+          }, normalizeWaterPreferencePayload(data.cisterns, data.waterValues));
 
           // 使用 TypeBox Schema 进行参数验证（包含自定义验证逻辑）
           const validatedData = validator.validate('set_room_property', sendData);

package/lib/mqtt/useSchedule.js

@@ -1,8 +1,10 @@
+import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
 import "core-js/modules/esnext.iterator.map.js";
 // 定时
 import { encodeDeviceTimer0x30 } from '@ray-js/robot-protocol';
 import { useContext } from 'react';
-import { CISTERN_MAP, CLEAN_MODE_MAP, SUCTION_MAP, ROUTE_PREFERENCE_MAP } from '../constant';
+import { CLEAN_MODE_MAP, SUCTION_MAP, ROUTE_PREFERENCE_MAP } from '../constant';
+import { normalizeWaterPreferencePayload, resolveWaterLevel } from './waterPreference';
 import { handleMqttError, useStructuredMessage } from './hooks/useStructuredMessage';
 import { SingletonContext } from './mqttProvider';
 import { ScheduleEnum } from './type';
@@ -53,8 +55,16 @@ export const useSchedule = () => {
         try {
           // 使用 TypeBox Schema 进行参数验证
           const validatedData = validator.validate('set_schedule', message);
+          const list = validatedData.list.map(item => {
+            var _item$routePreference, _item$ids;
+            return _objectSpread(_objectSpread(_objectSpread({}, item), normalizeWaterPreferencePayload(item.cisterns, item.waterValues)), {}, {
+              routePreferences: (_item$routePreference = item.routePreferences) !== null && _item$routePreference !== void 0 ? _item$routePreference : new Array(((_item$ids = item.ids) === null || _item$ids === void 0 ? void 0 : _item$ids.length) || 1).fill('standard')
+            });
+          });
           if (useMqtt) {
-            sendStructuredMessage(ScheduleEnum.set, validatedData, resolve, error => reject(handleMqttError(error, 'Failed to set schedule')), ScheduleEnum.query // 响应类型是 query，不是 set
+            sendStructuredMessage(ScheduleEnum.set, _objectSpread(_objectSpread({}, validatedData), {}, {
+              list
+            }), resolve, error => reject(handleMqttError(error, 'Failed to set schedule')), ScheduleEnum.query // 响应类型是 query，不是 set
             );
             return;
           }
@@ -63,7 +73,7 @@ export const useSchedule = () => {
           const command = encodeDeviceTimer0x30({
             version: commandVersion,
             number: validatedData.num,
-            list: validatedData.list.map(_ref => {
+            list: list.map(_ref => {
               let {
                 active,
                 suctions,
@@ -72,6 +82,7 @@ export const useSchedule = () => {
                 cleanCounts,
                 cycle,
                 cisterns,
+                waterValues,
                 time,
                 routePreferences
               } = _ref;
@@ -79,7 +90,7 @@ export const useSchedule = () => {
                 effectiveness: active,
                 cleanMode: CLEAN_MODE_MAP[(sweepMopModes === null || sweepMopModes === void 0 ? void 0 : sweepMopModes[0]) || ''],
                 fanLevel: SUCTION_MAP[(suctions === null || suctions === void 0 ? void 0 : suctions[0]) || ''],
-                waterLevel: typeof (cisterns === null || cisterns === void 0 ? void 0 : cisterns[0]) === 'number' ? cisterns[0] : CISTERN_MAP[(cisterns === null || cisterns === void 0 ? void 0 : cisterns[0]) || ''],
+                waterLevel: resolveWaterLevel(waterValues === null || waterValues === void 0 ? void 0 : waterValues[0], cisterns === null || cisterns === void 0 ? void 0 : cisterns[0]),
                 time: {
                   hour: time[0],
                   minute: time[1]
@@ -99,7 +110,7 @@ export const useSchedule = () => {
             reqType: ScheduleEnum.query,
             version: commandVersion,
             taskId: `${Date.now()}`,
-            list: validatedData.list,
+            list,
             num: validatedData.num
           });
         } catch (error) {

package/lib/mqtt/useSelectRoomClean.js

@@ -1,3 +1,4 @@
+import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
 import "core-js/modules/esnext.iterator.constructor.js";
 import "core-js/modules/esnext.iterator.for-each.js";
 import "core-js/modules/esnext.iterator.map.js";
@@ -8,6 +9,7 @@ import { handleMqttError, useStructuredMessage } from './hooks/useStructuredMess
 import { SingletonContext } from './mqttProvider';
 import { RoomCleanSetEnum } from './type';
 import { validator } from './type/fun';
+import { normalizeWaterPreferencePayload } from './waterPreference';
 /**
  * 自定义 Hook，用于选区清扫
  * @returns 包含 requestSelectRoomClean 和 setRoomClean 函数的对象
@@ -59,9 +61,11 @@ export const useSelectRoomClean = () => {
             ids: [],
             suctions: [],
             cisterns: [],
+            waterValues: [],
             cleanCounts: [],
             yMops: [],
-            sweepMopModes: []
+            sweepMopModes: [],
+            routePreferences: []
           });
         } catch (error) {
           reject(handleMqttError(error, 'Failed to request select room clean'));
@@ -77,28 +81,36 @@ export const useSelectRoomClean = () => {
           if (useMqtt) {
             const ids = [];
             const suctions = [];
-            const cisterns = [];
             const cleanCounts = [];
             const yMops = [];
             const sweepMopModes = [];
+            const routePreferences = [];
             rooms.forEach(room => {
-              var _room$suction, _room$cleanTimes, _room$yMop, _room$sweepMopMode;
+              var _room$suction, _room$cleanTimes, _room$yMop, _room$sweepMopMode, _room$routePreference;
               ids.push(room.roomId);
               suctions.push((_room$suction = room.suction) !== null && _room$suction !== void 0 ? _room$suction : '');
-              cisterns.push(room.cistern);
               cleanCounts.push((_room$cleanTimes = room.cleanTimes) !== null && _room$cleanTimes !== void 0 ? _room$cleanTimes : 1);
               yMops.push((_room$yMop = room.yMop) !== null && _room$yMop !== void 0 ? _room$yMop : -1);
               sweepMopModes.push((_room$sweepMopMode = room.sweepMopMode) !== null && _room$sweepMopMode !== void 0 ? _room$sweepMopMode : 'only_sweep');
+              routePreferences.push((_room$routePreference = room.routePreference) !== null && _room$routePreference !== void 0 ? _room$routePreference : 'standard');
             });
-            sendStructuredMessage(RoomCleanSetEnum.set, {
+            const waterPayload = normalizeWaterPreferencePayload(rooms.map(room => {
+              var _room$cistern;
+              return (_room$cistern = room.cistern) !== null && _room$cistern !== void 0 ? _room$cistern : '';
+            }), rooms.map(room => {
+              var _room$waterValue;
+              return (_room$waterValue = room.waterValue) !== null && _room$waterValue !== void 0 ? _room$waterValue : '';
+            }));
+            sendStructuredMessage(RoomCleanSetEnum.set, _objectSpread(_objectSpread({
               ids,
-              suctions,
-              cisterns,
+              suctions
+            }, waterPayload), {}, {
               cleanCounts,
               yMops,
               sweepMopModes,
+              routePreferences,
               num: rooms.length
-            }, resolve, error => reject(handleMqttError(error, 'Failed to set room clean')), RoomCleanSetEnum.query // 响应类型是 query，不是 set
+            }), resolve, error => reject(handleMqttError(error, 'Failed to set room clean')), RoomCleanSetEnum.query // 响应类型是 query，不是 set
             );
             return;
           }
@@ -115,7 +127,13 @@ export const useSelectRoomClean = () => {
             var _room$suction2;
             return (_room$suction2 = room.suction) !== null && _room$suction2 !== void 0 ? _room$suction2 : '';
           });
-          const cisterns = rooms.map(room => room.cistern);
+          const waterPayload = normalizeWaterPreferencePayload(rooms.map(room => {
+            var _room$cistern2;
+            return (_room$cistern2 = room.cistern) !== null && _room$cistern2 !== void 0 ? _room$cistern2 : '';
+          }), rooms.map(room => {
+            var _room$waterValue2;
+            return (_room$waterValue2 = room.waterValue) !== null && _room$waterValue2 !== void 0 ? _room$waterValue2 : '';
+          }));
           const cleanCounts = rooms.map(room => {
             var _room$cleanTimes2;
             return (_room$cleanTimes2 = room.cleanTimes) !== null && _room$cleanTimes2 !== void 0 ? _room$cleanTimes2 : 1;
@@ -128,19 +146,24 @@ export const useSelectRoomClean = () => {
             var _room$sweepMopMode2;
             return (_room$sweepMopMode2 = room.sweepMopMode) !== null && _room$sweepMopMode2 !== void 0 ? _room$sweepMopMode2 : 'only_sweep';
           });
-          resolve({
+          const routePreferences = rooms.map(room => {
+            var _room$routePreference2;
+            return (_room$routePreference2 = room.routePreference) !== null && _room$routePreference2 !== void 0 ? _room$routePreference2 : 'standard';
+          });
+          resolve(_objectSpread(_objectSpread({
             success: true,
             errCode: 0,
             reqType: RoomCleanSetEnum.query,
             version: commandVersion,
             taskId: `${Date.now()}`,
             ids,
-            suctions,
-            cisterns,
+            suctions
+          }, waterPayload), {}, {
             cleanCounts,
             yMops,
-            sweepMopModes
-          });
+            sweepMopModes,
+            routePreferences
+          }));
         } catch (error) {
           reject(handleMqttError(error, 'Failed to set room clean'));
         }

package/lib/mqtt/useSpotClean.js

@@ -1,3 +1,4 @@
+import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
 import "core-js/modules/esnext.iterator.map.js";
 // 定点清扫
 
@@ -8,6 +9,7 @@ import { encodeSpotClean0x16 } from '@ray-js/robot-protocol';
 import { pointsToString } from '../utils';
 import { useStructuredMessage, handleMqttError } from './hooks/useStructuredMessage';
 import { validator } from './type/fun';
+import { normalizeWaterPreferencePayload } from './waterPreference';
 /**
  * 自定义 Hook，用于定点清扫
  * @returns 包含 requestSpotClean 和 setSpotClean 函数的对象
@@ -57,25 +59,27 @@ export const useSpotClean = () => {
             origin
           } = validatedData;
           const num = spots.length;
+          const waterPayload = normalizeWaterPreferencePayload(validatedData.cisterns, validatedData.waterValues);
 
           // 为可选字段设置默认值
           const {
             suctions = new Array(num).fill(''),
-            cisterns = new Array(num).fill(''),
             cleanCounts = new Array(num).fill(1),
             yMops = new Array(num).fill(-1),
-            sweepMopModes = new Array(num).fill('only_sweep')
+            sweepMopModes = new Array(num).fill('only_sweep'),
+            routePreferences = new Array(num).fill('standard')
           } = validatedData;
           if (useMqtt) {
-            sendStructuredMessage(SpotCleanEnum.set, {
+            sendStructuredMessage(SpotCleanEnum.set, _objectSpread(_objectSpread({
               num,
               polygons: spots.map(spot => pointsToString([spot], origin)),
-              suctions,
-              cisterns,
+              suctions
+            }, waterPayload), {}, {
               cleanCounts,
               yMops,
-              sweepMopModes
-            }, resolve, error => reject(handleMqttError(error, 'Failed to set spot clean')), SpotCleanEnum.query // 响应类型是 query，不是 set
+              sweepMopModes,
+              routePreferences
+            }), resolve, error => reject(handleMqttError(error, 'Failed to set spot clean')), SpotCleanEnum.query // 响应类型是 query，不是 set
             );
             return;
           }
@@ -87,19 +91,20 @@ export const useSpotClean = () => {
             point: spots[0]
           });
           devices.common.model.actions.command_trans.set(command);
-          resolve({
+          resolve(_objectSpread(_objectSpread({
             success: true,
             errCode: 0,
             reqType: SpotCleanEnum.query,
             version: commandVersion,
             taskId: `${Date.now()}`,
             polygons: spots.map(spot => pointsToString([spot], origin)),
-            suctions,
-            cisterns,
+            suctions
+          }, waterPayload), {}, {
             cleanCounts,
             yMops,
-            sweepMopModes
-          });
+            sweepMopModes,
+            routePreferences
+          }));
         } catch (error) {
           reject(handleMqttError(error, 'Failed to set spot clean'));
         }

package/lib/mqtt/useZoneClean.js

@@ -1,3 +1,4 @@
+import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
 import "core-js/modules/esnext.iterator.map.js";
 // 划区清扫
 import { encodeZoneClean0x3a, requestZoneClean0x3b } from '@ray-js/robot-protocol';
@@ -7,6 +8,7 @@ import { handleMqttError, useStructuredMessage } from './hooks/useStructuredMess
 import { SingletonContext } from './mqttProvider';
 import { ZoneCleanEnum } from './type';
 import { validator } from './type/fun';
+import { normalizeWaterPreferencePayload } from './waterPreference';
 /**
  * 自定义 Hook，用于划区清扫
  * @returns 包含 requestZoneClean 和 setZoneClean 函数的对象
@@ -73,16 +75,15 @@ export const useZoneClean = () => {
 
           // 将业务参数转换为协议数据格式
           const num = zones.length;
+          const waterPayload = normalizeWaterPreferencePayload(params.cisterns, params.waterValues);
           const {
             suctions = new Array(num).fill(''),
-            cisterns = new Array(num).fill(''),
             cleanCounts = new Array(num).fill(1),
             yMops = new Array(num).fill(-1),
-            sweepMopModes = new Array(num).fill('only_sweep')
+            sweepMopModes = new Array(num).fill('only_sweep'),
+            routePreferences = new Array(num).fill('standard')
           } = params;
-
-          // 构建符合 SetZoneCleanData 格式的数据
-          const zoneCleanData = {
+          const zoneCleanData = _objectSpread(_objectSpread({
             zones: zones.map(_ref => {
               let {
                 points,
@@ -96,41 +97,44 @@ export const useZoneClean = () => {
               };
             }),
             origin,
-            suctions,
-            cisterns,
+            suctions
+          }, waterPayload), {}, {
             cleanCounts,
             yMops,
-            sweepMopModes
-          };
+            sweepMopModes,
+            routePreferences
+          });
 
           // 使用 TypeBox Schema 进行参数验证
           const validatedData = validator.validate('set_zone_clean', zoneCleanData);
+          const polygons = zones.map(_ref2 => {
+            let {
+              points
+            } = _ref2;
+            return pointsToString(points, origin);
+          });
+          const names = zones.map(_ref3 => {
+            let {
+              name
+            } = _ref3;
+            return name || '';
+          });
+          const commonFields = _objectSpread(_objectSpread({
+            suctions: validatedData.suctions
+          }, waterPayload), {}, {
+            cleanCounts: validatedData.cleanCounts,
+            yMops: validatedData.yMops,
+            sweepMopModes: validatedData.sweepMopModes,
+            routePreferences: validatedData.routePreferences
+          });
           if (useMqtt) {
-            // 将 zones 转换为 polygons 字符串格式（用于 MQTT 消息）
-            const polygons = zones.map(_ref2 => {
-              let {
-                points
-              } = _ref2;
-              return pointsToString(points, origin);
-            });
-            const names = zones.map(_ref3 => {
-              let {
-                name
-              } = _ref3;
-              return name || '';
-            });
-            sendStructuredMessage(ZoneCleanEnum.set, {
-              num: zones.length,
+            sendStructuredMessage(ZoneCleanEnum.set, _objectSpread(_objectSpread({
+              num,
               switchGo: true,
-              polygons,
-              suctions: validatedData.suctions,
-              cisterns: validatedData.cisterns,
-              cleanCounts: validatedData.cleanCounts,
-              yMops: validatedData.yMops,
-              sweepMopModes: validatedData.sweepMopModes,
+              polygons
+            }, commonFields), {}, {
               names
-            }, resolve, error => reject(handleMqttError(error, 'Failed to set zone clean')), ZoneCleanEnum.query // 响应类型是 query，不是 set
-            );
+            }), resolve, error => reject(handleMqttError(error, 'Failed to set zone clean')), ZoneCleanEnum.query);
             return;
           }
 
@@ -146,19 +150,7 @@ export const useZoneClean = () => {
             }))
           });
           devices.common.model.actions.command_trans.set(command);
-          const polygons = zones.map(_ref4 => {
-            let {
-              points
-            } = _ref4;
-            return pointsToString(points, origin);
-          });
-          const names = zones.map(_ref5 => {
-            let {
-              name
-            } = _ref5;
-            return name || '';
-          });
-          resolve({
+          resolve(_objectSpread({
             success: true,
             errCode: 0,
             reqType: ZoneCleanEnum.query,
@@ -166,7 +158,7 @@ export const useZoneClean = () => {
             taskId: `${Date.now()}`,
             polygons,
             names
-          });
+          }, commonFields));
         } catch (error) {
           reject(handleMqttError(error, 'Failed to set zone clean'));
         }

package/lib/mqtt/waterPreference.d.ts

@@ -0,0 +1,20 @@
+export type WaterPreferenceValue = string | number;
+/**
+ * 将自定义水量 / 标准水量统一归一化为设备命令需要的数值。
+ * 优先使用 waterValue，其次回退到 cistern。
+ */
+export declare const resolveWaterLevel: (waterValue?: WaterPreferenceValue, cistern?: WaterPreferenceValue, fallback?: number) => number;
+export declare const hasPreferenceValue: (value?: WaterPreferenceValue | null) => boolean;
+/**
+ * MQTT 水量相关字段是可选的。
+ * 当数组里全是空字符串时，认为该字段未设置，避免把空 cisterns/waterValues 发给设备。
+ */
+export declare const normalizeOptionalPreferenceArray: <T extends WaterPreferenceValue>(values?: T[] | undefined) => T[] | undefined;
+/**
+ * 自定义水量优先于旧 cistern 水量。
+ * 当某一项存在自定义水量时，同位置的 cistern 会被清空；最终空数组字段会被省略。
+ */
+export declare const normalizeWaterPreferencePayload: (cisterns?: WaterPreferenceValue[], waterValues?: WaterPreferenceValue[]) => {
+    cisterns?: WaterPreferenceValue[] | undefined;
+    waterValues?: WaterPreferenceValue[] | undefined;
+};

package/lib/mqtt/waterPreference.js

@@ -0,0 +1,70 @@
+import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
+import "core-js/modules/esnext.iterator.constructor.js";
+import "core-js/modules/esnext.iterator.some.js";
+import { CISTERN_MAP } from '../constant';
+/**
+ * 将自定义水量 / 标准水量统一归一化为设备命令需要的数值。
+ * 优先使用 waterValue，其次回退到 cistern。
+ */
+export const resolveWaterLevel = function (waterValue, cistern) {
+  var _ref, _resolveValue;
+  let fallback = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : CISTERN_MAP.closed;
+  const resolveValue = value => {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+      return value;
+    }
+    if (typeof value !== 'string') {
+      return undefined;
+    }
+    if (value in CISTERN_MAP) {
+      return CISTERN_MAP[value];
+    }
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+  };
+  return (_ref = (_resolveValue = resolveValue(waterValue)) !== null && _resolveValue !== void 0 ? _resolveValue : resolveValue(cistern)) !== null && _ref !== void 0 ? _ref : fallback;
+};
+export const hasPreferenceValue = value => value !== '' && value !== null && value !== undefined;
+
+/**
+ * MQTT 水量相关字段是可选的。
+ * 当数组里全是空字符串时，认为该字段未设置，避免把空 cisterns/waterValues 发给设备。
+ */
+export const normalizeOptionalPreferenceArray = values => {
+  if (!values) {
+    return undefined;
+  }
+  return values.some(hasPreferenceValue) ? values : undefined;
+};
+
+/**
+ * 自定义水量优先于旧 cistern 水量。
+ * 当某一项存在自定义水量时，同位置的 cistern 会被清空；最终空数组字段会被省略。
+ */
+export const normalizeWaterPreferencePayload = (cisterns, waterValues) => {
+  var _cisterns$length, _waterValues$length;
+  const maxLength = Math.max((_cisterns$length = cisterns === null || cisterns === void 0 ? void 0 : cisterns.length) !== null && _cisterns$length !== void 0 ? _cisterns$length : 0, (_waterValues$length = waterValues === null || waterValues === void 0 ? void 0 : waterValues.length) !== null && _waterValues$length !== void 0 ? _waterValues$length : 0);
+  if (maxLength === 0) {
+    return {};
+  }
+  const normalizedCisterns = normalizeOptionalPreferenceArray(Array.from({
+    length: maxLength
+  }, (_, index) => {
+    var _cisterns$index;
+    if (hasPreferenceValue(waterValues === null || waterValues === void 0 ? void 0 : waterValues[index])) {
+      return '';
+    }
+    return (_cisterns$index = cisterns === null || cisterns === void 0 ? void 0 : cisterns[index]) !== null && _cisterns$index !== void 0 ? _cisterns$index : '';
+  }));
+  const normalizedWaterValues = normalizeOptionalPreferenceArray(Array.from({
+    length: maxLength
+  }, (_, index) => {
+    var _waterValues$index;
+    return (_waterValues$index = waterValues === null || waterValues === void 0 ? void 0 : waterValues[index]) !== null && _waterValues$index !== void 0 ? _waterValues$index : '';
+  }));
+  return _objectSpread(_objectSpread({}, normalizedCisterns ? {
+    cisterns: normalizedCisterns
+  } : {}), normalizedWaterValues ? {
+    waterValues: normalizedWaterValues
+  } : {});
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ray-js/robot-data-stream",
-  "version": "0.0.15-beta.16",
+  "version": "0.0.15-beta.18",
   "description": "扫地机P2P数据流标准化组件",
   "main": "lib/index",
   "files": [
@@ -28,7 +28,9 @@
     "start:wechat": "ray start ./example -t wechat --verbose",
     "start:web": "ray start ./example -t web",
     "prepublishOnly": "yarn build",
-    "release-it": "standard-version"
+    "release-it": "standard-version",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs"
   },
   "peerDependencies": {
     "@ray-js/log4js": "^0.0.4",
@@ -53,14 +55,15 @@
     "@ray-js/log4js": "^0.0.4",
     "@ray-js/ray": "1.8.0-beta.14",
     "@ray-js/robot-protocol": "^1.0.1",
+    "@types/lodash-es": "^4.17.12",
     "core-js": "^3.19.1",
     "eslint-config-tuya-panel": "^0.4.2",
     "husky": "^1.2.0",
     "lint-staged": "^10.2.11",
     "patch-package": "^8.0.0",
-    "@types/lodash-es": "^4.17.12",
     "prettier": "^3.8.0",
-    "standard-version": "9.3.2"
+    "standard-version": "9.3.2",
+    "vitepress": "^1.6.4"
   },
   "husky": {
     "hooks": {