LiveBridge如何识别"骑手已出发":词典引擎与正则智能规则完整源码解读
LiveBridge如何识别"骑手已出发":词典引擎与正则智能规则完整源码解读
LiveBridge 是一款将普通 Android 通知转换成 Android 16+ Live Updates(动态药丸/灵动岛)的开源应用,其核心正是词典引擎 + 正则智能规则:通过可自定义的 JSON 词典(smart_rules)与正则表达式信号,LiveBridge 能从外卖 App 的通知里精准识别出"骑手已出发""已送达"等配送阶段,并驱动实时状态卡片。本文带你完整拆解这套识别机制的源码实现。
词典引擎是什么:一张"外卖状态地图"
LiveBridge 的识别能力不写死在代码里,而是存放在可热加载的词典 JSON 中。仓库内为 5 种语言各内置了一份语言包:
- 中文词典:liveupdate_dictionary_zh.json
- 英文词典:liveupdate_dictionary_en.json
- 另有
pt-BR、ru、ko语言包,语言清单定义在 dictionary_runtime.dart
每份词典的骨架是一个 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 的状态文案归一化。
匹配流水线:一条通知的"三关"判定
真正的判定逻辑在 Kotlin 侧的 LiveUpdateNotifier.kt 中,每条通知要依次闯过三关:
- 相关性判定
isRelevant:包名包含package_hints,或通知文本包含text_triggers(如"骑手"),见 SmartRuleEntry; - 排除模式
isExcluded:命中exclude_patterns直接放弃——中文词典里排除了"红包、满减、取件码、快递驿站"等促销/快递噪音(liveupdate_dictionary_zh.json),避免"满 30 减 5"被误识别成订单进度; - 信号匹配:
rule.signals.firstOrNull { it.pattern.containsMatchIn(combinedText) }(LiveUpdateNotifier.kt)——信号已按 stage 降序排列,第一个命中即定档,天然优先匹配"已送达"这类终态。
匹配成功后返回 SmartStageMatch,其中 aggregateKey = 包名:规则ID:订单号 用于聚合同一订单的多条通知;订单号则由 entity_token_patterns 正则(如 订单#A12345)从文本中抽取。状态文案最终经 smartShortStatusText 解析为本地化短文案。
多语言合并与缓存:词典如何"合体"
词典不是静态的,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等则合并进对应正则的上下文匹配。
配合 README.md 中的说明,整个项目采用 GPL-3.0-or-later 协议(见 LICENSE),欢迎提交新语言包或新场景规则参与共建。
小结
LiveBridge 识别"骑手已出发"并非玄学,而是一条清晰的可测试流水线:JSON 词典定义规则 → 包名/关键词三关判定 → 正则信号定档 → locale 标签输出短文案 → 动态岛实时更新。词典与代码解耦、多语言可合并、用户可增词,正是它能稳定覆盖打车、外卖、导航、天气、VPN 等多场景的核心设计。想深入细节,建议从 LiveParserDictionary.kt 与 liveupdate_dictionary_zh.json 这两个文件读起,它们就是整个智能规则的"大脑"。



