01-规则清单管理

规则清单管理是规则中心的核心模块，用于定义和管理系统中的所有通用规则。通过可视化的方式，管理员可以创建复杂的逻辑判断，供各个业务模块（如任务推送、黑名单、Launcher广告等）调用。

1. 规则列表 (一级页面)

在规则清单管理的一级页面中，一级页面展示了系统中所有的规则定义。在这里，您可以查看规则的基本信息，如规则ID、名称、EL表达式数据等。

规则列表

1.1 新增规则

在规则清单管理的新增规则操作中，点击“新增”按钮，可以创建一个新的规则。

规则别名：用于标识规则的中文名称。
规则名称(Chain Name)：规则的唯一英文标识（LiteFlow Chain ID），在EL表达式中会用到，不允许重复。
是否启用：控制规则是否生效。

新增规则

1.2 编辑规则

在规则清单管理的编辑规则操作中，点击“编辑”按钮，可以修改规则的基本信息。

编辑规则

1.3 进入EL配置

在规则清单管理的EL配置入口中，在列表的操作栏中，点击 "EL表达式" 按钮，将进入强大的可视化规则编辑器（EL规则配置中心），这是配置规则具体逻辑的地方。

进入EL编辑

1.4 设备数量统计

在规则列表页中，您也可以直接查看每个规则当前覆盖的设备总数（去重后）。

列表展示：直接在列表列中展示设备数量。
交互操作：点击数字，同样可以打开详情弹窗，查看计算时间或执行 【重新计算】。这对于评估单条规则的影响范围非常有用。

规则列表设备数量

规则设备数量详情

统计逻辑说明

计算依据：仅统计 MAC配置 和 渠道配置。
- 如果同时配置了 MAC 和渠道，系统取两者的交集（即既在MAC名单中，又属于指定渠道）。
- 如果两者都未配置，系统默认视为全量设备（覆盖所有设备）。
忽略项：地区配置 和 EL表达式 中的复杂逻辑在统计时会被忽略。
- 因此，您看到的统计结果代表的是该规则的最大潜在影响范围，实际命中数可能会因为地区或EL条件的限制而更少。

2. 规则配置详情 (二级页面)

在规则清单管理的二级配置详情页面中，点击规则列表中的某一行（非操作按钮区域），可以进入该规则的二级配置页面。这里管理与该规则关联的具体数据资源。

2.1 业务配置管理

在规则二级配置的业务配置管理中，查看当前规则已经被哪些业务模块绑定。

字段	说明
业务ID	关联的业务记录ID
业务类型	任务推送/Launcher广告/黑名单/UOTA升级/域名分发之域名/域名分发之UOTA
生效状态	绑定是否生效

业务配置管理

2.2 渠道配置管理

在规则二级配置的渠道配置管理中，为当前规则绑定特定的渠道。

字段	说明
渠道ID	关联的渠道记录ID
渠道名称	渠道的显示名称
是否生效	该渠道配置是否生效

作用：作为"初筛"条件之一。如果设备所属渠道不在这个列表中，规则会直接匹配失败。

渠道配置管理

2.3 MAC配置管理

在规则二级配置的MAC配置管理中，直接为规则绑定特定的设备MAC地址。

字段	说明
MAC地址	设备的物理地址
是否有效	该MAC配置是否有效
分区索引	用于数据分区，避免全表扫描

支持批量导入功能，方便录入大量设备。
作用：作为"初筛"条件。如果您只想让这几十台设备命中该规则，直接在这里导入即可。

MAC配置管理

2.4 MAC资源配置管理

在规则二级配置的MAC资源配置管理中，引用已创建的MAC资源包，实现MAC地址的复用和统一管理。

字段	说明
MAC资源ID	引用的MAC资源包ID
资源名称	MAC资源包的名称
是否生效	该关联是否生效

核心概念：与其在每个规则里重复导入几千个MAC，不如建立一个MAC资源，然后在需要的地方引用它。

MAC资源配置管理

2.5 地区配置管理

在规则二级配置的地区配置管理中，为规则绑定适用的地区（国家/省份）。

字段	说明
地区ID	关联的地区记录ID
地区名称	地区的显示名称
是否生效	该地区配置是否生效

作用：作为"初筛"条件。仅当设备处于指定地区时，规则才生效。

地区配置管理

3. EL规则配置中心 (可视化编辑器)

EL规则配置中心（可视化编辑器）是规则引擎的大脑。我们提供了图形模式和树形模式两种视角，让您像搭积木一样配置复杂的业务逻辑。

3.1 界面预览

EL规则配置中心的界面预览如下：

图形模式：适合查看整体流程走向。

树形模式：适合查看层级包含关系。

3.2 核心功能

EL规则配置中心的核心功能包括：

逻辑组合：支持 AND (全满足) 和 OR (任一满足) 逻辑组。
丰富的数据类型：
- 渠道选择：支持下拉搜索。
- 时间范围：支持时间点和时间段的判断。
- 字符串列表：判断值是否在某一组数据中（如VIP等级列表）。
实时预览：配置过程中，右侧可以实时预览生成的 EL 表达式代码。

综合示例：下面是一个由可视化编辑器生成的 EL 表达式示例，用于描述“渠道名称包含 2024，且 (SDK 版本以 rk 开头，或者激活时间在 2026-01-01 到 2026-01-30 之间)”这一组合条件：

IF(
  AND(
    OR(
      startsWithCmp.tag("build").data("rk"),
      betweenLInclCmp.tag("activationTime").data("2026-01-01 00:00:00,2026-01-30 00:00:00")
    ),
    containsCmp.tag("channelName").data("2024")
  ),
  deviceTrueCmp,
  deviceFalseCmp
);

详细的操作说明和字段定义，请参考《EL编辑器操作手册》。

1. 规则列表 (一级页面)​

1.1 新增规则​

1.2 编辑规则​

1.3 进入EL配置​

1.4 设备数量统计​

统计逻辑说明​

2. 规则配置详情 (二级页面)​

2.1 业务配置管理​

2.2 渠道配置管理​

2.3 MAC配置管理​

2.4 MAC资源配置管理​

2.5 地区配置管理​

3. EL规则配置中心 (可视化编辑器)​

3.1 界面预览​

3.2 核心功能​