From a5478ffcfe25d6bac87c8035bd6d8735234eecd0 Mon Sep 17 00:00:00 2001
From: YunaiV <zhijiantianya@gmail.com>
Date: Sat, 9 Aug 2025 16:05:48 +0800
Subject: [PATCH] =?UTF-8?q?review=EF=BC=9A=E3=80=90iot=20=E7=89=A9?=
 =?UTF-8?q?=E8=81=94=E7=BD=91=E3=80=91=E5=9C=BA=E6=99=AF=E8=81=94=E5=8A=A8?=
 =?UTF-8?q?=E7=9A=84=E9=80=BB=E8=BE=91?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/utils/cron.ts                             | 40 +++++--------------
 src/views/iot/rule/data/index.vue             |  2 +-
 .../iot/rule/scene/form/RuleSceneForm.vue     | 23 ++++-------
 .../scene/form/configs/ConditionConfig.vue    | 20 +++-------
 .../configs/CurrentTimeConditionConfig.vue    |  9 +----
 .../form/configs/DeviceControlConfig.vue      | 10 ++---
 .../form/configs/DeviceTriggerConfig.vue      |  8 +---
 .../form/configs/MainConditionInnerConfig.vue |  9 ++---
 .../form/configs/SubConditionGroupConfig.vue  |  4 +-
 .../scene/form/sections/ActionSection.vue     |  1 +
 .../scene/form/sections/TriggerSection.vue    | 10 ++---
 .../scene/form/selectors/DeviceSelector.vue   |  8 ++--
 .../scene/form/selectors/OperatorSelector.vue |  3 +-
 .../scene/form/selectors/ProductSelector.vue  | 14 +++----
 .../scene/form/selectors/PropertySelector.vue | 11 +++--
 src/views/iot/rule/scene/index.vue            | 18 +--------
 src/views/iot/utils/constants.ts              | 23 +++++++----
 17 files changed, 72 insertions(+), 141 deletions(-)

diff --git a/src/utils/cron.ts b/src/utils/cron.ts
index 886fc847..ee132f00 100644
--- a/src/utils/cron.ts
+++ b/src/utils/cron.ts
@@ -105,9 +105,7 @@ export const CRON_PRESETS = {
 
 /** CRON 表达式工具类 */
 export class CronUtils {
-  /**
-   * 验证 CRON 表达式格式
-   */
+  /** 验证 CRON 表达式格式 */
   static validate(cronExpression: string): boolean {
     if (!cronExpression || typeof cronExpression !== 'string') {
       return false
@@ -125,9 +123,7 @@ export class CronUtils {
     return parts.every((part) => cronRegex.test(part))
   }
 
-  /**
-   * 解析单个 CRON 字段
-   */
+  /** 解析单个 CRON 字段 */
   static parseField(
     fieldValue: string,
     fieldType: CronFieldType,
@@ -206,9 +202,7 @@ export class CronUtils {
     return field
   }
 
-  /**
-   * 解析完整的 CRON 表达式
-   */
+  /** 解析完整的 CRON 表达式 */
   static parse(cronExpression: string): ParsedCronExpression {
     const result: ParsedCronExpression = {
       second: { type: 'any', values: [], original: '*', description: '每秒' },
@@ -259,9 +253,7 @@ export class CronUtils {
     return result
   }
 
-  /**
-   * 生成 CRON 表达式的可读描述
-   */
+  /** 生成 CRON 表达式的可读描述 */
   static generateDescription(parsed: ParsedCronExpression): string {
     const parts: string[] = []
 
@@ -305,9 +297,7 @@ export class CronUtils {
     return parts.length > 0 ? parts.join(' ') : '自定义时间规则'
   }
 
-  /**
-   * 格式化 CRON 表达式为可读文本
-   */
+  /** 格式化 CRON 表达式为可读文本 */
   static format(cronExpression: string): string {
     if (!cronExpression) return ''
 
@@ -315,9 +305,7 @@ export class CronUtils {
     return parsed.isValid ? parsed.description : cronExpression
   }
 
-  /**
-   * 获取预设的 CRON 表达式列表
-   */
+  /** 获取预设的 CRON 表达式列表 */
   static getPresets() {
     return Object.entries(CRON_PRESETS).map(([key, value]) => ({
       label: this.format(value),
@@ -326,9 +314,7 @@ export class CronUtils {
     }))
   }
 
-  /**
-   * 计算 CRON 表达式的下次执行时间
-   */
+  /** 计算 CRON 表达式的下次执行时间 */
   static getNextExecutionTime(cronExpression: string, fromDate?: Date): Date | null {
     const parsed = this.parse(cronExpression)
     if (!parsed.isValid) {
@@ -402,9 +388,7 @@ export class CronUtils {
     return new Date(now.getTime() + 60000) // 1分钟后
   }
 
-  /**
-   * 获取 CRON 表达式的执行频率描述
-   */
+  /** 获取 CRON 表达式的执行频率描述 */
   static getFrequencyDescription(cronExpression: string): string {
     const parsed = this.parse(cronExpression)
     if (!parsed.isValid) {
@@ -435,9 +419,7 @@ export class CronUtils {
     return '按计划执行'
   }
 
-  /**
-   * 检查 CRON 表达式是否会在指定时间执行
-   */
+  /** 检查 CRON 表达式是否会在指定时间执行 */
   static willExecuteAt(cronExpression: string, targetDate: Date): boolean {
     const parsed = this.parse(cronExpression)
     if (!parsed.isValid) {
@@ -462,9 +444,7 @@ export class CronUtils {
     )
   }
 
-  /**
-   * 检查字段值是否匹配
-   */
+  /** 检查字段值是否匹配 */
   private static fieldMatches(field: ParsedCronField, value: number): boolean {
     if (field.type === 'any') {
       return true
diff --git a/src/views/iot/rule/data/index.vue b/src/views/iot/rule/data/index.vue
index 123397ee..8c887593 100644
--- a/src/views/iot/rule/data/index.vue
+++ b/src/views/iot/rule/data/index.vue
@@ -14,7 +14,7 @@ import RuleIndex from './rule/index.vue'
 import SinkIndex from './sink/index.vue'
 
 /** IoT 数据流转 */
-defineOptions({ name: 'IotData' })
+defineOptions({ name: 'IoTDataRule' })
 
 const activeTab = ref('rule')
 </script>
diff --git a/src/views/iot/rule/scene/form/RuleSceneForm.vue b/src/views/iot/rule/scene/form/RuleSceneForm.vue
index 09a31657..22ba268e 100644
--- a/src/views/iot/rule/scene/form/RuleSceneForm.vue
+++ b/src/views/iot/rule/scene/form/RuleSceneForm.vue
@@ -215,7 +215,6 @@ const validateActions = (_rule: any, value: any, callback: any) => {
 }
 
 const formRules = reactive({
-  // 表单校验规则
   name: [
     { required: true, message: '场景名称不能为空', trigger: 'blur' },
     { type: 'string', min: 1, max: 50, message: '场景名称长度应在1-50个字符之间', trigger: 'blur' }
@@ -234,17 +233,13 @@ const formRules = reactive({
   ],
   triggers: [{ required: true, validator: validateTriggers, trigger: 'change' }],
   actions: [{ required: true, validator: validateActions, trigger: 'change' }]
-})
+}) // 表单校验规则
 
 const submitLoading = ref(false) // 提交加载状态
 const isEdit = ref(false) // 是否为编辑模式
+const drawerTitle = computed(() => (isEdit.value ? '编辑场景联动规则' : '新增场景联动规则')) // 抽屉标题
 
-// 计算属性：抽屉标题
-const drawerTitle = computed(() => (isEdit.value ? '编辑场景联动规则' : '新增场景联动规则'))
-
-/**
- * 提交表单
- */
+/** 提交表单 */
 const handleSubmit = async () => {
   // 校验表单
   if (!formRef.value) return
@@ -275,16 +270,12 @@ const handleSubmit = async () => {
   }
 }
 
-/**
- * 处理抽屉关闭事件
- */
+/** 处理抽屉关闭事件 */
 const handleClose = () => {
   drawerVisible.value = false
 }
 
-/**
- * 初始化表单数据
- */
+/** 初始化表单数据 */
 const initFormData = () => {
   if (props.ruleScene) {
     // 编辑模式：数据结构已对齐，直接使用后端数据
@@ -316,7 +307,7 @@ const initFormData = () => {
   }
 }
 
-// 监听抽屉显示
+/** 监听抽屉显示 */
 watch(drawerVisible, async (visible) => {
   if (visible) {
     initFormData()
@@ -326,7 +317,7 @@ watch(drawerVisible, async (visible) => {
   }
 })
 
-// 监听编辑数据变化
+/** 监听编辑数据变化 */
 watch(
   () => props.ruleScene,
   () => {
diff --git a/src/views/iot/rule/scene/form/configs/ConditionConfig.vue b/src/views/iot/rule/scene/form/configs/ConditionConfig.vue
index f4d36d8f..36dc2f5a 100644
--- a/src/views/iot/rule/scene/form/configs/ConditionConfig.vue
+++ b/src/views/iot/rule/scene/form/configs/ConditionConfig.vue
@@ -183,14 +183,12 @@ const condition = useVModel(props, 'modelValue', emit)
 
 const propertyType = ref<string>('string') // 属性类型
 const propertyConfig = ref<any>(null) // 属性配置
-
-// 计算属性：判断是否为设备相关条件
 const isDeviceCondition = computed(() => {
   return (
     condition.value.type === IotRuleSceneTriggerConditionTypeEnum.DEVICE_STATUS ||
     condition.value.type === IotRuleSceneTriggerConditionTypeEnum.DEVICE_PROPERTY
   )
-})
+}) // 计算属性：判断是否为设备相关条件
 
 /**
  * 更新条件字段
@@ -240,20 +238,14 @@ const handleConditionTypeChange = (type: number) => {
   condition.value.param = ''
 }
 
-/**
- * 处理产品变化事件
- * @param _ 产品ID（未使用）
- */
+/** 处理产品变化事件 */
 const handleProductChange = (_: number) => {
   // 产品变化时清空设备和属性
   condition.value.deviceId = undefined
   condition.value.identifier = ''
 }
 
-/**
- * 处理设备变化事件
- * @param _ 设备ID（未使用）
- */
+/** 处理设备变化事件 */
 const handleDeviceChange = (_: number) => {
   // 设备变化时清空属性
   condition.value.identifier = ''
@@ -268,13 +260,11 @@ const handlePropertyChange = (propertyInfo: { type: string; config: any }) => {
   propertyConfig.value = propertyInfo.config
 
   // 重置操作符和值
-  condition.value.operator = '='
+  condition.value.operator = IotRuleSceneTriggerConditionParameterOperatorEnum.EQUALS.value
   condition.value.param = ''
 }
 
-/**
- * 处理操作符变化事件
- */
+/** 处理操作符变化事件 */
 const handleOperatorChange = () => {
   // 重置值
   condition.value.param = ''
diff --git a/src/views/iot/rule/scene/form/configs/CurrentTimeConditionConfig.vue b/src/views/iot/rule/scene/form/configs/CurrentTimeConditionConfig.vue
index b9f477d3..9d304b70 100644
--- a/src/views/iot/rule/scene/form/configs/CurrentTimeConditionConfig.vue
+++ b/src/views/iot/rule/scene/form/configs/CurrentTimeConditionConfig.vue
@@ -1,13 +1,6 @@
 <!-- 当前时间条件配置组件 -->
 <template>
   <div class="flex flex-col gap-16px">
-    <div
-      class="flex items-center gap-8px p-12px px-16px bg-orange-50 rounded-6px border border-orange-200"
-    >
-      <Icon icon="ep:timer" class="text-orange-500 text-18px" />
-      <span class="text-14px font-500 text-orange-700">当前时间条件配置</span>
-    </div>
-
     <el-row :gutter="16">
       <!-- 时间操作符选择 -->
       <el-col :span="8">
@@ -224,7 +217,7 @@ const handleTimeValue2Change = (value: string) => {
   condition.value.param = currentParams.slice(0, 2).join(',')
 }
 
-// 监听操作符变化，清理不相关的时间值
+/** 监听操作符变化，清理不相关的时间值 */
 watch(
   () => condition.value.operator,
   (newOperator) => {
diff --git a/src/views/iot/rule/scene/form/configs/DeviceControlConfig.vue b/src/views/iot/rule/scene/form/configs/DeviceControlConfig.vue
index 2d9c5f9e..2cc89c93 100644
--- a/src/views/iot/rule/scene/form/configs/DeviceControlConfig.vue
+++ b/src/views/iot/rule/scene/form/configs/DeviceControlConfig.vue
@@ -136,7 +136,7 @@ const isServiceInvokeAction = computed(() => {
 
 /**
  * 处理产品变化事件
- * @param productId 产品ID
+ * @param productId 产品 ID
  */
 const handleProductChange = (productId?: number) => {
   // 当产品变化时，清空设备选择和参数配置
@@ -160,7 +160,7 @@ const handleProductChange = (productId?: number) => {
 
 /**
  * 处理设备变化事件
- * @param deviceId 设备ID
+ * @param deviceId 设备 ID
  */
 const handleDeviceChange = (deviceId?: number) => {
   // 当设备变化时，清空参数配置
@@ -338,14 +338,12 @@ const initializeComponent = async () => {
   isInitialized.value = true
 }
 
-/**
- * 组件初始化
- */
+/** 组件初始化 */
 onMounted(() => {
   initializeComponent()
 })
 
-// 监听关键字段的变化，避免深度监听导致的性能问题
+/** 监听关键字段的变化，避免深度监听导致的性能问题 */
 watch(
   () => [action.value.productId, action.value.type, action.value.identifier],
   async ([newProductId, , newIdentifier], [oldProductId, , oldIdentifier]) => {
diff --git a/src/views/iot/rule/scene/form/configs/DeviceTriggerConfig.vue b/src/views/iot/rule/scene/form/configs/DeviceTriggerConfig.vue
index 1cba70e7..979eff89 100644
--- a/src/views/iot/rule/scene/form/configs/DeviceTriggerConfig.vue
+++ b/src/views/iot/rule/scene/form/configs/DeviceTriggerConfig.vue
@@ -205,9 +205,7 @@ const handleTriggerTypeChange = (type: number) => {
   emit('trigger-type-change', type)
 }
 
-/**
- * 添加子条件组
- */
+/** 添加子条件组 */
 const addSubGroup = async () => {
   if (!trigger.value.conditionGroups) {
     trigger.value.conditionGroups = []
@@ -246,9 +244,7 @@ const updateSubGroup = (index: number, subGroup: any) => {
   }
 }
 
-/**
- * 移除整个条件组
- */
+/** 移除整个条件组 */
 const removeConditionGroup = () => {
   trigger.value.conditionGroups = undefined
 }
diff --git a/src/views/iot/rule/scene/form/configs/MainConditionInnerConfig.vue b/src/views/iot/rule/scene/form/configs/MainConditionInnerConfig.vue
index 062507a8..f6eb65f9 100644
--- a/src/views/iot/rule/scene/form/configs/MainConditionInnerConfig.vue
+++ b/src/views/iot/rule/scene/form/configs/MainConditionInnerConfig.vue
@@ -295,18 +295,14 @@ const handleTriggerTypeChange = (type: number) => {
   emit('trigger-type-change', type)
 }
 
-/**
- * 处理产品变化事件
- */
+/** 处理产品变化事件 */
 const handleProductChange = () => {
   // 产品变化时清空设备和属性
   condition.value.deviceId = undefined
   condition.value.identifier = ''
 }
 
-/**
- * 处理设备变化事件
- */
+/** 处理设备变化事件 */
 const handleDeviceChange = () => {
   // 设备变化时清空属性
   condition.value.identifier = ''
@@ -331,6 +327,7 @@ const handlePropertyChange = (propertyInfo: any) => {
   }
 }
 
+// TODO @puhui999：这个貌似没用上
 /**
  * 处理操作符变化事件
  */
diff --git a/src/views/iot/rule/scene/form/configs/SubConditionGroupConfig.vue b/src/views/iot/rule/scene/form/configs/SubConditionGroupConfig.vue
index cb8f2762..3097fdc8 100644
--- a/src/views/iot/rule/scene/form/configs/SubConditionGroupConfig.vue
+++ b/src/views/iot/rule/scene/form/configs/SubConditionGroupConfig.vue
@@ -105,9 +105,7 @@ const subGroup = useVModel(props, 'modelValue', emit)
 
 const maxConditions = computed(() => props.maxConditions || 3) // 最大条件数量
 
-/**
- * 添加条件
- */
+/** 添加条件 */
 const addCondition = async () => {
   // 确保 subGroup.value 是一个数组
   if (!subGroup.value) {
diff --git a/src/views/iot/rule/scene/form/sections/ActionSection.vue b/src/views/iot/rule/scene/form/sections/ActionSection.vue
index d61d25da..7ff953b7 100644
--- a/src/views/iot/rule/scene/form/sections/ActionSection.vue
+++ b/src/views/iot/rule/scene/form/sections/ActionSection.vue
@@ -1,4 +1,5 @@
 <!-- 执行器配置组件 -->
+<!-- TODO @puhui999：每个执行器的 UI 风格，应该和【触发器配置】那，有点像 -->
 <template>
   <el-card class="border border-[var(--el-border-color-light)] rounded-8px" shadow="never">
     <template #header>
diff --git a/src/views/iot/rule/scene/form/sections/TriggerSection.vue b/src/views/iot/rule/scene/form/sections/TriggerSection.vue
index cbe334b1..ce5438c6 100644
--- a/src/views/iot/rule/scene/form/sections/TriggerSection.vue
+++ b/src/views/iot/rule/scene/form/sections/TriggerSection.vue
@@ -137,9 +137,7 @@ const emit = defineEmits<{
 
 const triggers = useVModel(props, 'triggers', emit)
 
-/**
- * 添加触发器
- */
+/** 添加触发器 */
 const addTrigger = () => {
   const newTrigger: Trigger = {
     type: TriggerTypeEnum.DEVICE_STATE_UPDATE,
@@ -184,9 +182,9 @@ const updateTriggerDeviceConfig = (index: number, newTrigger: Trigger) => {
 }
 
 /**
- * 更新触发器CRON配置
+ * 更新触发器 CRON 配置
  * @param index 触发器索引
- * @param cronExpression CRON表达式
+ * @param cronExpression CRON 表达式
  */
 const updateTriggerCronConfig = (index: number, cronExpression?: string) => {
   triggers.value[index].cronExpression = cronExpression
@@ -208,7 +206,7 @@ const onTriggerTypeChange = (index: number, _: number) => {
   triggerItem.conditionGroups = []
 }
 
-// 初始化：确保至少有一个触发器
+/** 初始化：确保至少有一个触发器 */
 onMounted(() => {
   if (triggers.value.length === 0) {
     addTrigger()
diff --git a/src/views/iot/rule/scene/form/selectors/DeviceSelector.vue b/src/views/iot/rule/scene/form/selectors/DeviceSelector.vue
index 0caf8e96..0f347acd 100644
--- a/src/views/iot/rule/scene/form/selectors/DeviceSelector.vue
+++ b/src/views/iot/rule/scene/form/selectors/DeviceSelector.vue
@@ -18,12 +18,12 @@
     >
       <div class="flex items-center justify-between w-full py-4px">
         <div class="flex-1">
-          <div class="text-14px font-500 text-[var(--el-text-color-primary)] mb-2px"
-            >{{ device.deviceName }}
+          <div class="text-14px font-500 text-[var(--el-text-color-primary)] mb-2px">
+            {{ device.deviceName }}
           </div>
           <div class="text-12px text-[var(--el-text-color-secondary)]">{{ device.deviceKey }}</div>
         </div>
-        <div class="flex items-center gap-4px">
+        <div class="flex items-center gap-4px" v-if="device.id > 0">
           <el-tag size="small" :type="getDeviceEnableStatusTagType(device.status)">
             {{ getDeviceEnableStatusText(device.status) }}
           </el-tag>
@@ -87,7 +87,7 @@ const getDeviceList = async () => {
     console.error('获取设备列表失败:', error)
     deviceList.value = []
   } finally {
-    deviceList.value.push(DEVICE_SELECTOR_OPTIONS.ALL_DEVICES)
+    deviceList.value.unshift(DEVICE_SELECTOR_OPTIONS.ALL_DEVICES)
     deviceLoading.value = false
   }
 }
diff --git a/src/views/iot/rule/scene/form/selectors/OperatorSelector.vue b/src/views/iot/rule/scene/form/selectors/OperatorSelector.vue
index 9624c775..0b70c524 100644
--- a/src/views/iot/rule/scene/form/selectors/OperatorSelector.vue
+++ b/src/views/iot/rule/scene/form/selectors/OperatorSelector.vue
@@ -222,7 +222,6 @@ const availableOperators = computed(() => {
   if (!props.propertyType) {
     return allOperators
   }
-
   return allOperators.filter((op) => op.supportedTypes.includes(props.propertyType!))
 })
 
@@ -239,7 +238,7 @@ const handleChange = (value: string) => {
   emit('change', value)
 }
 
-// 监听属性类型变化
+/** 监听属性类型变化 */
 watch(
   () => props.propertyType,
   () => {
diff --git a/src/views/iot/rule/scene/form/selectors/ProductSelector.vue b/src/views/iot/rule/scene/form/selectors/ProductSelector.vue
index 2f4209a9..9162dcb5 100644
--- a/src/views/iot/rule/scene/form/selectors/ProductSelector.vue
+++ b/src/views/iot/rule/scene/form/selectors/ProductSelector.vue
@@ -17,11 +17,11 @@
     >
       <div class="flex items-center justify-between w-full py-4px">
         <div class="flex-1">
-          <div class="text-14px font-500 text-[var(--el-text-color-primary)] mb-2px"
-            >{{ product.name }}
+          <div class="text-14px font-500 text-[var(--el-text-color-primary)] mb-2px">
+            {{ product.name }}
           </div>
-          <div class="text-12px text-[var(--el-text-color-secondary)]"
-            >{{ product.productKey }}
+          <div class="text-12px text-[var(--el-text-color-secondary)]">
+            {{ product.productKey }}
           </div>
         </div>
         <dict-tag :type="DICT_TYPE.COMMON_STATUS" :value="product.status" />
@@ -51,16 +51,14 @@ const productList = ref<any[]>([]) // 产品列表
 
 /**
  * 处理选择变化事件
- * @param value 选中的产品ID
+ * @param value 选中的产品 ID
  */
 const handleChange = (value?: number) => {
   emit('update:modelValue', value)
   emit('change', value)
 }
 
-/**
- * 获取产品列表
- */
+/** 获取产品列表 */
 const getProductList = async () => {
   try {
     productLoading.value = true
diff --git a/src/views/iot/rule/scene/form/selectors/PropertySelector.vue b/src/views/iot/rule/scene/form/selectors/PropertySelector.vue
index d0322f9c..99f05a63 100644
--- a/src/views/iot/rule/scene/form/selectors/PropertySelector.vue
+++ b/src/views/iot/rule/scene/form/selectors/PropertySelector.vue
@@ -1,5 +1,4 @@
 <!-- 属性选择器组件 -->
-<!-- TODO @yunai：可能要在 review 下 -->
 <template>
   <div class="flex items-center gap-8px">
     <el-select
@@ -263,6 +262,7 @@ const handleChange = (value: string) => {
   }
 }
 
+// TODO @puhui999：这里没用到哈；
 /**
  * 获取物模型TSL数据
  */
@@ -292,13 +292,12 @@ const getThingModelTSL = async () => {
   }
 }
 
-/**
- * 解析物模型TSL数据
- */
+/** 解析物模型 TSL 数据 */
 const parseThingModelData = () => {
   const tsl = thingModelTSL.value
   const properties: PropertySelectorItem[] = []
 
+  // TODO @puhui999：if return，减少下括号层级；
   if (tsl) {
     // 解析属性
     if (tsl.properties && Array.isArray(tsl.properties)) {
@@ -397,7 +396,7 @@ const getPropertyRange = (property: any) => {
   return undefined
 }
 
-// 监听产品变化
+/** 监听产品变化 *、
 watch(
   () => props.productId,
   () => {
@@ -406,7 +405,7 @@ watch(
   { immediate: true }
 )
 
-// 监听触发类型变化
+/** 监听触发类型变化 */
 watch(
   () => props.triggerType,
   () => {
diff --git a/src/views/iot/rule/scene/index.vue b/src/views/iot/rule/scene/index.vue
index cb2dc8c1..da4a7593 100644
--- a/src/views/iot/rule/scene/index.vue
+++ b/src/views/iot/rule/scene/index.vue
@@ -225,14 +225,7 @@
                 @click="handleToggleStatus(row)"
               >
                 <Icon :icon="row.status === 0 ? 'ep:video-pause' : 'ep:video-play'" />
-                {{
-                  getDictLabel(
-                    DICT_TYPE.COMMON_STATUS,
-                    row.status === CommonStatusEnum.ENABLE
-                      ? CommonStatusEnum.DISABLE
-                      : CommonStatusEnum.ENABLE
-                  )
-                }}
+                {{ getDictLabel(DICT_TYPE.COMMON_STATUS, row.status) }}
               </el-button>
               <el-button type="danger" class="!mr-10px" link @click="handleDelete(row.id)">
                 <Icon icon="ep:delete" />
@@ -300,7 +293,7 @@ const statistics = ref({
   total: 0,
   enabled: 0,
   disabled: 0,
-  triggered: 0,
+  triggered: 0, // 已触发的规则数量 (暂时使用启用状态的规则数量)
   timerRules: 0 // 定时规则数量
 })
 
@@ -326,14 +319,12 @@ const getRuleSceneSummary = (rule: IotSceneRule) => {
         default:
           description = getTriggerTypeLabel(trigger.type)
       }
-
       // 添加设备信息（如果有）
       if (trigger.deviceId) {
         description += ` [设备ID: ${trigger.deviceId}]`
       } else if (trigger.productId) {
         description += ` [产品ID: ${trigger.productId}]`
       }
-
       return description
     }) || []
 
@@ -341,19 +332,16 @@ const getRuleSceneSummary = (rule: IotSceneRule) => {
     rule.actions?.map((action: any) => {
       // 构建基础描述
       let description = getActionTypeLabel(action.type)
-
       // 添加设备信息（如果有）
       if (action.deviceId) {
         description += ` [设备ID: ${action.deviceId}]`
       } else if (action.productId) {
         description += ` [产品ID: ${action.productId}]`
       }
-
       // 添加告警配置信息（如果有）
       if (action.alertConfigId) {
         description += ` [告警配置ID: ${action.alertConfigId}]`
       }
-
       return description
     }) || []
 
@@ -383,9 +371,7 @@ const updateStatistics = () => {
     total: list.value.length,
     enabled: list.value.filter((item) => item.status === CommonStatusEnum.ENABLE).length,
     disabled: list.value.filter((item) => item.status === CommonStatusEnum.DISABLE).length,
-    // 已触发的规则数量 (暂时使用启用状态的规则数量)
     triggered: list.value.filter((item) => item.status === CommonStatusEnum.ENABLE).length,
-    // 定时规则数量
     timerRules: list.value.filter((item) => hasTimerTrigger(item)).length
   }
 }
diff --git a/src/views/iot/utils/constants.ts b/src/views/iot/utils/constants.ts
index 05871a04..f282d470 100644
--- a/src/views/iot/utils/constants.ts
+++ b/src/views/iot/utils/constants.ts
@@ -356,6 +356,7 @@ export const getActionTypeLabel = (type: number): string => {
 }
 
 /** 获取执行器标签类型（用于 el-tag 的 type 属性） */
+// TODO @puhui999：这种跟界面相关的，可以拿到对应组件里；
 export const getActionTypeTag = (
   type: number
 ): 'primary' | 'success' | 'info' | 'warning' | 'danger' => {
@@ -368,6 +369,7 @@ export const getActionTypeTag = (
   return actionTypeTags[type] || 'info'
 }
 
+// TODO @puhui999：建议不设置最大值哈。
 /** 场景联动规则配置常量 */
 export const SCENE_RULE_CONFIG = {
   MAX_ACTIONS: 5, // 最大执行器数量
@@ -375,6 +377,7 @@ export const SCENE_RULE_CONFIG = {
   MAX_CONDITIONS: 20 // 最大条件数量
 } as const
 
+// TODO @puhui999：下面这个要去掉么？
 /** IoT 设备消息类型枚举 */
 export const IotDeviceMessageTypeEnum = {
   PROPERTY: 'property', // 属性
@@ -434,6 +437,7 @@ export const IoTDeviceStatusEnum = {
 } as const
 
 /** 设备启用状态枚举 */
+// TODO @puhui999：这个是不是和 IoTDeviceStatusEnum 合并下；额外增加一个 value2
 export const IoTDeviceEnableStatusEnum = {
   ENABLED: {
     label: '正常',
@@ -448,6 +452,7 @@ export const IoTDeviceEnableStatusEnum = {
 } as const
 
 /** 设备激活状态枚举 */
+// TODO @puhui999：这个是不是搞到界面里。label 就是 IoTDeviceStatusEnum，然后 tag 界面里处理；；或者也可以在想想，= = 主要设备状态有 3 个枚举，嘿嘿~
 export const IoTDeviceActiveStatusEnum = {
   ACTIVATED: {
     label: '已激活',
@@ -505,11 +510,13 @@ export const deviceStatusChangeOptions = [
 
 /** 获取设备启用状态文本 */
 export const getDeviceEnableStatusText = (status: number): string => {
+  // TODO @puhui999：设备有 3 个状态，上线、离线，未激活；
   const statusItem = Object.values(IoTDeviceEnableStatusEnum).find((item) => item.value === status)
   return statusItem?.label || '未知'
 }
 
 /** 获取设备启用状态标签类型 */
+// TODO @puhui999：这个是不是可以直接在界面里处理；或者也可以在想想，= = 主要设备状态有 3 个枚举，嘿嘿~
 export const getDeviceEnableStatusTagType = (
   status: number
 ): 'primary' | 'success' | 'info' | 'warning' | 'danger' => {
@@ -518,6 +525,7 @@ export const getDeviceEnableStatusTagType = (
 }
 
 /** 获取设备激活状态文本和标签类型 */
+// TODO @puhui999：这个是不是可以直接在界面里处理；或者也可以在想想，= = 主要设备状态有 3 个枚举，嘿嘿~
 export const getDeviceActiveStatus = (activeTime?: string | null) => {
   const isActivated = !!activeTime
   return {
@@ -541,14 +549,13 @@ export const IotRuleSceneTriggerTimeOperatorEnum = {
   TODAY: { name: '在今日之间', value: 'today' } // 在今日之间
 } as const
 
-// ========== 辅助函数 ==========
-
 /** 获取触发器类型标签 */
 export const getTriggerTypeLabel = (type: number): string => {
   const option = triggerTypeOptions.find((item) => item.value === type)
   return option?.label || '未知类型'
 }
 
+// TODO @puhui999：这种跟界面相关的，可以拿到对应组件里；
 /** 获取触发器标签类型（用于 el-tag 的 type 属性） */
 export const getTriggerTagType = (
   type: number
@@ -559,9 +566,9 @@ export const getTriggerTagType = (
   return isDeviceTrigger(type) ? 'success' : 'info'
 }
 
-// ========== JSON参数输入组件相关常量 ==========
+// ========== JSON 参数输入组件相关常量 ==========
 
-/** JSON参数输入组件类型枚举 */
+/** JSON 参数输入组件类型枚举 */
 export const JsonParamsInputTypeEnum = {
   SERVICE: 'service',
   EVENT: 'event',
@@ -569,11 +576,11 @@ export const JsonParamsInputTypeEnum = {
   CUSTOM: 'custom'
 } as const
 
-/** JSON参数输入组件类型 */
+/** JSON 参数输入组件类型 */
 export type JsonParamsInputType =
   (typeof JsonParamsInputTypeEnum)[keyof typeof JsonParamsInputTypeEnum]
 
-/** JSON参数输入组件文本常量 */
+/** JSON 参数输入组件文本常量 */
 export const JSON_PARAMS_INPUT_CONSTANTS = {
   // 基础文本
   PLACEHOLDER: '请输入JSON格式的参数',
@@ -628,7 +635,7 @@ export const JSON_PARAMS_INPUT_CONSTANTS = {
   }
 } as const
 
-/** JSON参数输入组件图标常量 */
+/** JSON 参数输入组件图标常量 */
 export const JSON_PARAMS_INPUT_ICONS = {
   // 标题图标
   TITLE_ICONS: {
@@ -655,7 +662,7 @@ export const JSON_PARAMS_INPUT_ICONS = {
   }
 } as const
 
-/** JSON参数输入组件示例值常量 */
+/** JSON 参数输入组件示例值常量 */
 export const JSON_PARAMS_EXAMPLE_VALUES = {
   [IoTDataSpecsDataTypeEnum.INT]: { display: '25', value: 25 },
   [IoTDataSpecsDataTypeEnum.FLOAT]: { display: '25.5', value: 25.5 },