JHenTai 屏蔽规则导入机制的技术分析与优化方案

问题背景

JHenTai 是一款功能强大的漫画阅读应用，其屏蔽规则功能允许用户自定义过滤不想看到的内容。然而，在实际使用中，用户反馈了一个重要问题：当导入屏蔽规则时，如果存在重复项，系统会将这些规则叠加而非覆盖，导致规则管理混乱。

技术现象分析

通过日志分析，我们可以清晰地看到问题发生的全过程：

1. 用户导出当前屏蔽规则配置
2. 尝试重新导入同一份配置
3. 系统执行了"Upsert"操作（更新或插入）
4. 最终导致相同规则被重复添加而非替换

核心问题在于导入逻辑没有对已有规则进行有效识别和去重处理。系统为每个导入的规则生成新的ID和组ID，即使规则内容完全相同，也会被视为新规则添加。

技术实现原理

JHenTai 的屏蔽规则系统采用分组管理机制，每个规则组包含若干具体规则。当前导入逻辑的工作流程如下：

1. 解析导入的JSON配置文件
2. 遍历所有规则组和规则
3. 对每条规则执行"Upsert"操作
4. 将新规则添加到数据库

问题根源在于"Upsert"操作没有基于规则内容进行匹配，而是简单地为每条导入规则创建新记录。

优化方案设计

方案一：基于内容的规则匹配

1. 在导入前，先加载现有规则
2. 对每条导入规则，检查是否存在内容相同的现有规则
3. 如果存在，则更新现有规则；否则添加新规则
4. 关键比较字段：target、attribute、pattern和expression

方案二：规则组合并策略

1. 识别相同目的的规则组（基于组内规则内容）
2. 合并相同组的规则，避免重复
3. 保留用户自定义的组名和排序

方案三：导入模式选择

为用户提供三种导入模式选择：

1. 严格模式：完全覆盖现有规则
2. 合并模式：智能合并，去重
3. 追加模式：当前行为，简单添加

技术实现细节

实现优化方案需要考虑以下技术点：

1. 规则内容哈希算法：为每条规则生成唯一哈希值，用于快速比较
2. 事务处理：确保导入过程的原子性
3. 冲突解决策略：当新旧规则存在差异时的处理逻辑
4. 性能优化：大数据量导入时的性能考虑

用户体验改进

除了技术实现，还应考虑以下用户体验优化：

1. 导入前预览功能：显示将会添加/更新/跳过的规则数量
2. 导入结果报告：详细展示导入操作的结果
3. 撤销功能：允许用户回滚最近的导入操作
4. 批量删除：提供快速清空现有规则的选项

总结

JHenTai 的屏蔽规则导入功能优化不仅解决了当前的重复项叠加问题，更为用户提供了更灵活、更强大的规则管理能力。通过基于内容的规则匹配和智能合并策略，用户可以更高效地管理和维护自己的屏蔽规则集。这一改进将显著提升用户在跨设备同步或备份恢复规则时的体验。