LiveBridge如何识别"骑手已出发":词典引擎与正则智能规则完整源码解读

原创2026-10-14 16:00:421,704 阅读

LiveBridge如何识别"骑手已出发":词典引擎与正则智能规则完整源码解读

LiveBridge 是一款将普通 Android 通知转换成 Android 16+ Live Updates(动态药丸/灵动岛)的开源应用,其核心正是词典引擎 + 正则智能规则:通过可自定义的 JSON 词典(smart_rules)与正则表达式信号,LiveBridge 能从外卖 App 的通知里精准识别出"骑手已出发""已送达"等配送阶段,并驱动实时状态卡片。本文带你完整拆解这套识别机制的源码实现。

词典引擎是什么:一张"外卖状态地图"

LiveBridge 主界面:应用运行状态与最近转换的外卖订单通知

LiveBridge 的识别能力不写死在代码里,而是存放在可热加载的词典 JSON 中。仓库内为 5 种语言各内置了一份语言包:

每份词典的骨架是一个 smart_rules 数组,其中 food(外卖配送)规则就是一个完整的"状态地图":package_hints(美团、饿了么、waimai 等包名线索)+ text_triggers(骑手、订单、配送等触发词)+ 5 档正则信号 + 一组排除模式。

正则信号与阶段:从"骑手已取餐"到"已送达"的 5 级状态机

打开中文词典的 food 规则(liveupdate_dictionary_zh.json),signals 数组按 stage 0–4 定义了五个配送阶段,每个阶段就是一个大小写不敏感的正则:

stage 阶段 正则信号示例(节选)
4 已送达 已送达|订单已完成|祝您用餐愉快
3 配送中 配送中|骑手已取餐|骑手正在前往|距离您
2 待取餐 已出餐|打包完成|等待骑手
1 准备中 准备中|制作中|烹饪中
0 已付款 已付款|支付成功|商家已接单

当收到"骑手已取餐,预计 20 分钟送达"这条通知时,stage 3 的正则命中,规则引擎就把订单推进到"配送中"。命中后展示给用户的短文案并不来自通知原文,而是由词典里的 status_labels(liveupdate_dictionary_zh.json)按 locale 解析:food 规则 zh-CN 下 stage 3 固定显示"配送中",实现跨 App 的状态文案归一化。

LiveBridge 词典引擎驱动的 Android Live Updates 动态岛实时提醒效果

匹配流水线:一条通知的"三关"判定

真正的判定逻辑在 Kotlin 侧的 LiveUpdateNotifier.kt 中,每条通知要依次闯过三关:

  1. 相关性判定 isRelevant:包名包含 package_hints,或通知文本包含 text_triggers(如"骑手"),见 SmartRuleEntry;
  2. 排除模式 isExcluded:命中 exclude_patterns 直接放弃——中文词典里排除了"红包、满减、取件码、快递驿站"等促销/快递噪音(liveupdate_dictionary_zh.json),避免"满 30 减 5"被误识别成订单进度;
  3. 信号匹配:rule.signals.firstOrNull { it.pattern.containsMatchIn(combinedText) }(LiveUpdateNotifier.kt)——信号已按 stage 降序排列,第一个命中即定档,天然优先匹配"已送达"这类终态。

匹配成功后返回 SmartStageMatch,其中 aggregateKey = 包名:规则ID:订单号 用于聚合同一订单的多条通知;订单号则由 entity_token_patterns 正则(如 订单#A12345)从文本中抽取。状态文案最终经 smartShortStatusText 解析为本地化短文案。

LiveBridge 智能规则设置页:Taxi 与 Deliveries 智能转换开关

多语言合并与缓存:词典如何"合体"

词典不是静态的,LiveParserDictionaryLoader 会在启动时按用户勾选的语言逐个加载语言包,并用 mergedWith 逐级合并:

  • 规则合并:同 id 的规则做字段级融合,maxStage 取最大值,信号按 stage:正则 去重后排序(mergeSmartRules);
  • 正则合并:mergeRegex 会把两个正则拼成 (?:A)|(?:B) 的交替式,既保留各自能力又避免重复(mergeRegex);
  • 缓存策略:以"语言集合 + 自定义词条 + 覆盖内容"拼出 source key,内容不变就复用缓存(LiveParserDictionaryLoader.get),保证高频通知处理路径零解析开销。

这套机制也让词典支持在线自动更新——用户无需改代码,拉取新版 JSON 即可扩展识别能力。

动手扩展词典:给"骑手已出发"加关键词

LiveBridge 在 Rules 页提供了词典编辑器:rules_dictionary_screen.dart 负责语言选择与备份/恢复,dictionary_word_editor_screen.dart 支持为各分类追加自定义词。你在界面里添加的词会以 JSON 形式存入本地,加载时被注入到词典对应字段(LiveParserDictionaryLoader):

  • food_words 会并入 food 规则的 text_triggers,比如补充新叫法"骑士";
  • food_packages 会并入 package_hints,适配小众外卖 App 的包名;
  • progress_words、weather_words 等则合并进对应正则的上下文匹配。

LiveBridge 自定义词典与规则行为配置界面

配合 README.md 中的说明,整个项目采用 GPL-3.0-or-later 协议(见 LICENSE),欢迎提交新语言包或新场景规则参与共建。

小结

LiveBridge 识别"骑手已出发"并非玄学,而是一条清晰的可测试流水线:JSON 词典定义规则 → 包名/关键词三关判定 → 正则信号定档 → locale 标签输出短文案 → 动态岛实时更新。词典与代码解耦、多语言可合并、用户可增词,正是它能稳定覆盖打车、外卖、导航、天气、VPN 等多场景的核心设计。想深入细节,建议从 LiveParserDictionary.kt 与 liveupdate_dictionary_zh.json 这两个文件读起,它们就是整个智能规则的"大脑"。

登录后查看全文
livebridge