01-规则清单管理

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

典型使用场景

场景	配置方式	说明
白名单测试	MAC配置	只让指定的几十台设备收到推送
渠道差异化	渠道配置	不同渠道的设备收到不同内容
地区差异化	地区配置	海外和国内设备分别配置
多条件筛选	EL表达式	按SDK版本+设备型号组合筛选
设备组复用	MAC资源	同一批设备在多个业务中复用

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
生效状态	绑定是否生效

业务配置管理

业务配置的业务意义

当您在业务配置中绑定一条规则后：

设备请求时：系统会自动判断设备是否符合这条规则的条件
匹配成功：设备将收到该业务对应的配置内容
匹配失败：设备不会收到该业务的配置

审批状态说明

对于需要审批的业务类型（任务推送、Launcher广告、黑名单），绑定关系会有以下状态：

状态	含义	设备是否生效
未生效	刚绑定，等待审批	否
已生效	审批通过，正式生效	是
待修改	已生效但有新的修改待审批	是（旧配置）
待删除	已生效但申请解绑待审批	是（旧配置）

2.2 渠道配置管理

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

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

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

渠道配置管理

渠道配置的业务意义

场景示例：您想让"App Store"渠道的设备收到某个推送。

在渠道配置中添加"App Store"渠道
当设备请求时，系统会检查设备的渠道
只有渠道为"App Store"的设备才会继续匹配后续条件

注意：如果渠道配置为空，则表示"不限制渠道"，所有渠道的设备都可以匹配。

2.3 MAC配置管理

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

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

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

MAC配置管理

MAC配置的业务意义

场景示例：您有50台测试设备，想让它们先收到新版本推送。

准备好这50台设备的MAC地址列表
使用"导入"功能批量添加
这50台设备将优先匹配到这条规则

注意：MAC配置是"精确匹配"，只有列表中的设备才会匹配成功。如果MAC配置为空，则表示"不限制设备"。

2.3.1 异步导出MAC

当MAC数据量较大时，建议使用异步导出功能：

点击"异步导出"按钮
确认发起导出任务
前往任务中心查看导出进度
导出完成后，在任务中心下载文件

提示：异步导出适用于大量数据的场景，不会阻塞当前页面操作。

2.3.2 导入删除MAC

当需要批量删除大量MAC时，可使用导入删除功能：

点击"导入删除"按钮
下载导入模板
按模板格式填入需要删除的MAC地址
上传文件确认删除

注意：管理员导入删除操作会立即生效，请谨慎操作。

2.4 MAC资源配置管理

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

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

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

MAC资源配置管理

MAC资源配置的业务意义

场景示例：您有一个"VIP客户组"包含1万台设备，需要在"任务推送"和"Launcher广告"两个业务中使用。

不使用MAC资源：

在任务推送的规则中导入1万个MAC
在Launcher广告的规则中又导入1万个MAC
当VIP客户组有变动时，需要修改两处

使用MAC资源：

创建一个"VIP客户组"MAC资源，导入1万个MAC
在任务推送规则中引用这个资源
在Launcher广告规则中也引用这个资源
当VIP客户组有变动时，只需修改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配置管理​

MAC配置的业务意义​

2.3.1 异步导出MAC​

2.3.2 导入删除MAC​

2.4 MAC资源配置管理​

MAC资源配置的业务意义​

2.5 地区配置管理​

地区配置的业务意义​

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

3.1 界面预览​

3.2 核心功能​