@ray-js/lamp-schedule-core 1.0.5-beta.6 → 1.0.5-beta.8

package/lib/dpParser/wakeup/wakeupSigmesh.js

@@ -69,12 +69,11 @@ export class WakeUpSigmesh {
     var _data$nodes;
     scheduleLogger.debug('Sigmesh dpParser ===> WakeUpSigmesh formatter: data', data);
     // dataMode 可能是字符串 ('01'/'02'/'03') 或数字 (1/2/3)
-    const dataModeNum = typeof data.dataMode === 'string' ? parseInt(data.dataMode, 10) : data.dataMode;
-    // 使用 nodes.length 而非 data.length，因为调用方可能未更新 length 字段
+    typeof data.dataMode === 'string' ? parseInt(data.dataMode, 10) : data.dataMode; // 使用 nodes.length 而非 data.length，因为调用方可能未更新 length 字段
     const nodeCount = (_data$nodes = data.nodes) === null || _data$nodes === void 0 ? void 0 : _data$nodes.length;
     // 版本号固定为 1, 与文档不一致，文档有问题
 
-    const result = [numToHexString(1), numToHexString(dataModeNum), numToHexString(nodeCount)];
+    const result = [numToHexString(1), numToHexString(1), numToHexString(nodeCount)];
     data.nodes.forEach(node => {
       var _node$loops;
       result.push(numToHexString(node.onOff ? 1 : 0), numToHexString(parseInt(node === null || node === void 0 || (_node$loops = node.loops) === null || _node$loops === void 0 || (_node$loops = _node$loops.split('')) === null || _node$loops === void 0 || (_node$loops = _node$loops.reverse()) === null || _node$loops === void 0 ? void 0 : _node$loops.join(''), 2)), numToHexString(node.step), numToHexString(node.hour), numToHexString(node.minute), numToHexString(node.brightness), numToHexString(node.temperature), numToHexString(node.duration));

package/lib/hooks/__test__/useBaseLightDp.test.js

@@ -1,5 +1,5 @@
 import { act, renderHook } from '@testing-library/react-hooks';
-import { useBaseLightDp, getDpDataByMesh, fetchDpData, useFetchDpDataByMesh, useFetchDpData } from '../useBaseLightDp';
+import { useBaseLightDp, getDpDataByMesh, fetchDpData, useFetchDpDataByMesh, useFetchDpData, __clearFetchDpDataThrottleCacheForTest } from '../useBaseLightDp';
 import { DP_CHANGE_EVENT_KEY } from '../../constant';
 import { devIdOrGroupIdCache } from '../../utils/ScheduleCache';
 import { getDpIdByDpCode } from '../../utils/ScheduleUtils';
@@ -184,6 +184,7 @@ describe('getDpDataByMesh', () => {
 });
 describe('fetchDpData', () => {
   beforeEach(() => {
+    __clearFetchDpDataThrottleCacheForTest();
     jest.clearAllMocks();
     devIdOrGroupIdCache.get.mockReturnValue({
       devId: 'device-1',
@@ -210,9 +211,15 @@ describe('fetchDpData', () => {
       dpIds: ['2']
     }));
   });
+  it('skips duplicate fetch for same dpCodes within throttle window', () => {
+    fetchDpData(['bright_value']);
+    fetchDpData(['bright_value']);
+    expect(queryDps).toHaveBeenCalledTimes(1);
+  });
 });
 describe('useFetch hooks', () => {
   beforeEach(() => {
+    __clearFetchDpDataThrottleCacheForTest();
     jest.clearAllMocks();
     getDpIdByDpCode.mockReturnValue(3);
     devIdOrGroupIdCache.get.mockReturnValue({
@@ -232,7 +239,8 @@ describe('useFetch hooks', () => {
     act(() => {
       result.current.refresh();
     });
-    expect(queryDps).toHaveBeenCalledTimes(2);
+    // 同一组 dpCodes 在 3s 内被节流，refresh 不会触发第二次请求
+    expect(queryDps).toHaveBeenCalledTimes(1);
   });
   it('useFetchDpDataByMesh skips when not sigmesh', () => {
     useSupport.mockReturnValue({

package/lib/hooks/useBaseLightDp.d.ts

@@ -10,6 +10,8 @@ type TDpRes<T> = {
 };
 export declare function useBaseLightDp<T>(dpCode: string, defaultDpValue?: T): TDpRes<T>;
 export declare const getDpDataByMesh: (dpCodes?: string[]) => void;
+/** 仅用于测试：清空 fetchDpData 节流缓存，避免用例间相互影响 */
+export declare const __clearFetchDpDataThrottleCacheForTest: () => void;
 export declare const fetchDpData: (dpCodes?: string[]) => Promise<void>;
 /**
  * 主动拉取 dp 数据, 仅支持 sigmesh 设备
@@ -21,7 +23,10 @@ export declare const useFetchDpDataByMesh: (dpCodes: string[]) => {
 };
 /**
  * 主动拉取 dp 数据, 不限制协议
- * @param dpCodes dpCode 数组
+ * 同一组 dpCodes 在 3s 内只会实际拉取一次（模块级节流）。
+ * @param dpCodes dpCode 数组，建议使用 useMemo 稳定引用，避免因引用变化导致 effect 重复执行，例如：
+ *   const dpCodes = useMemo(() => [scheduleDpCodes.SLEEP_MODE, scheduleDpCodes.WAKE_UP_MODE], []);
+ *   useFetchDpData(dpCodes, { initFetch: true, offsetTime: 0 });
  * @param options 拉取配置
  * @param options.initFetch 是否初始化拉取
  * @param options.offsetTime 延迟时间 ms

package/lib/hooks/useBaseLightDp.js

@@ -1,5 +1,6 @@
 import "core-js/modules/esnext.iterator.constructor.js";
 import "core-js/modules/esnext.iterator.filter.js";
+import "core-js/modules/esnext.iterator.for-each.js";
 import "core-js/modules/esnext.iterator.map.js";
 /* eslint-disable no-console */
 import { useState, useEffect, useCallback, useRef, useMemo } from 'react';
@@ -140,8 +141,20 @@ export const getDpDataByMesh = function () {
   }
 };
 
+/** 模块级缓存：同一组 dpCodes 最近一次拉取时间，用于 3s 内去重 */
+const lastFetchTimeByKey = {};
+
+/** 相同 dpCodesKey 节流时间（毫秒） */
+const FETCH_DP_THROTTLE_MS = 3000;
+
+/** 仅用于测试：清空 fetchDpData 节流缓存，避免用例间相互影响 */
+export const __clearFetchDpDataThrottleCacheForTest = () => {
+  Object.keys(lastFetchTimeByKey).forEach(k => delete lastFetchTimeByKey[k]);
+};
+
 // 查询设备的 DP
 export const fetchDpData = function () {
+  var _lastFetchTimeByKey$k;
   let dpCodes = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
   if (!Array.isArray(dpCodes)) {
     scheduleLogger.error('fetchDpData: 参数dpCodes必须是数组');
@@ -162,6 +175,16 @@ export const fetchDpData = function () {
     scheduleLogger.warn('fetchDpData', dpCodes, '未匹配到 dp');
     return;
   }
+
+  // 模块级节流：同一组 dpCodes 在 3s 内只拉取一次
+  const key = dpCodes.slice().sort().join(',');
+  const now = Date.now();
+  const lastFetch = (_lastFetchTimeByKey$k = lastFetchTimeByKey[key]) !== null && _lastFetchTimeByKey$k !== void 0 ? _lastFetchTimeByKey$k : 0;
+  if (now - lastFetch < FETCH_DP_THROTTLE_MS) {
+    scheduleLogger.debug('fetchDpData: 相同 dpCodes 在 3s 内已拉取过，已跳过', dpCodes);
+    return;
+  }
+  lastFetchTimeByKey[key] = now;
   scheduleLogger.debug('fetchDpData 查询DP转换后参数 dpIds:', dpIds);
   try {
     queryDps({
@@ -210,7 +233,10 @@ export const useFetchDpDataByMesh = dpCodes => {
 
 /**
  * 主动拉取 dp 数据, 不限制协议
- * @param dpCodes dpCode 数组
+ * 同一组 dpCodes 在 3s 内只会实际拉取一次（模块级节流）。
+ * @param dpCodes dpCode 数组，建议使用 useMemo 稳定引用，避免因引用变化导致 effect 重复执行，例如：
+ *   const dpCodes = useMemo(() => [scheduleDpCodes.SLEEP_MODE, scheduleDpCodes.WAKE_UP_MODE], []);
+ *   useFetchDpData(dpCodes, { initFetch: true, offsetTime: 0 });
  * @param options 拉取配置
  * @param options.initFetch 是否初始化拉取
  * @param options.offsetTime 延迟时间 ms
@@ -221,34 +247,25 @@ export const useFetchDpData = function (dpCodes) {
     initFetch: true,
     offsetTime: 0
   };
-  // 使用 useMemo 稳定 dpCodes 的字符串表示，避免因数组引用变化导致重复执行
-  // 注意：这里依赖 dpCodes 数组本身，但由于调用方已使用 useMemo 稳定引用，所以是安全的
   const dpCodesKey = useMemo(() => dpCodes.join(','), [dpCodes]);
   const getDpDataFn = useCallback(() => {
-    scheduleLogger.debug('useFetchDpData getDpDataFn get1:', dpCodes);
+    scheduleLogger.debug('useFetchDpData getDpDataFn get:', dpCodes);
     fetchDpData(dpCodes);
   }, [dpCodes]);
-
-  // 使用 useRef 跟踪上一次的 dpCodesKey，避免重复执行
-  const prevDpCodesKeyRef = useRef(null);
+  const getDpDataFnRef = useRef(getDpDataFn);
+  getDpDataFnRef.current = getDpDataFn;
   useEffect(() => {
     if (!options.initFetch) {
       return () => null;
     }
-    // 只有当 dpCodesKey 真正变化时才执行
-    if (prevDpCodesKeyRef.current === dpCodesKey) {
-      scheduleLogger.debug('useFetchDpData useEffect: dpCodesKey unchanged', dpCodesKey);
-      return () => null;
-    }
-    prevDpCodesKeyRef.current = dpCodesKey;
     const timer = setTimeout(() => {
-      scheduleLogger.debug('useFetchDpData useEffect get:', dpCodes);
-      getDpDataFn();
+      scheduleLogger.debug('useFetchDpData useEffect get:', dpCodesKey);
+      getDpDataFnRef.current();
     }, options.offsetTime || 0);
     return () => {
       clearTimeout(timer);
     };
-  }, [dpCodesKey, getDpDataFn, dpCodes, options.initFetch, options.offsetTime]);
+  }, [dpCodesKey, options.initFetch, options.offsetTime]);
   return {
     refresh: getDpDataFn
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ray-js/lamp-schedule-core",
-  "version": "1.0.5-beta.6",
+  "version": "1.0.5-beta.8",
   "description": "照明计划模块核心能力",
   "main": "./lib/index.js",
   "files": [