编号没变,消息还是来了:Mac 端通知读取漏第二条的原因

13 阅读5分钟

编号没变,消息还是来了:Mac 端通知读取漏第二条的原因

增量同步只认「比上次的号更大」,会漏一类新东西:原地被改过的那一条。它不产生新号,却真的是新的。昨天我在 Andee 的 Mac 端通知读取上补的就是这个洞。表现是同一个人发来第二条消息,他一声不吭。

Andee 是一个开源的设备 agent:Android 上他靠无障碍服务读屏幕、自己点,不用 App 开接口;Mac 上他不监听通知,而是读系统自己写的那本账。

为什么会漏

macOS 不给第三方 App 通知回调。系统里有个进程把每条送出的通知写进一个 SQLite 库,横幅弹没弹都写。所以 Mac 端的读法是轮询:每隔一会儿查一次,比我上次见过的记录号更大的,都给我。条件就一个,rec_id > lastId,排序按 rec_id,一次最多 50 行。

飞书不配合这个假设。同一个人连着发消息,它把新的内容折进上一条通知:同一行,同一个 rec_id,只有 delivered_date 被刷新。

于是第二个消息在账本里是「旧号 + 新时间」。我们的条件只问号,号没变大,这一行永远不会被交回来。

症状是静默的。没有异常,没有日志,时间线上不写行。而时间线只在判断完成之后才写,所以「没读到」和「没发生」在用户眼里完全一样。

怎么改

加第二个边界,和第一个并列。

原生侧多了一个 andee_notif_latest_delivered(),取 max(delivered_date),用来播种。查询改成两个条件:

where r.rec_id > ? or r.delivered_date > ?
order by r.rec_id limit 50

每行多返回一个原始 d,调用方拿它推进边界。这里有个小细节:边界值不要拿换算后的毫秒去反推,直接存库里的原值。换算是 (d + 978_307_200) * 1000,来回转一次就有精度损失,边界往前挪一点点,就会把那一条永远跳过。插进 SQL 用的是 String(format: "%.17g", afterDelivered),双精度进来就得原样出去。

播种点有两个:start() 和 recheck()。两处都要从 max(delivered_date) 现取。只播种 rec_id 的话,另一个边界从 0 开始,第一次读会把整个账本倒一遍,50 行的上限都挡不住。

recheck() 那条还要多看一句:它原本是为了「权限后来才给」这种情况,判断完状态就 return。边界必须在那之前推进,否则重启前拿到的一批记录会再走一遍。

还有一个容易被忽略的返回值:读不到库的时候,新边界返回 0。0 不等于「从 1970 年开始查」,因为第一个边界在那种情况下是 -1,读函数开头就 return 了,第二个边界根本没机会被用。两条边界互相兜底,别单独拿一个去判断能不能读。

顺序仍然按 rec_id 排,不按更新时间。原地改的那些行 rec_id 偏小,会排在前面,但它们本来就是旧记录,早处理晚处理都不影响结论;换成按时间排,突发来的时候顺序会跳,反而难追。

读的节奏

文件一变就排一次读,延迟 300 毫秒。这一次没读到东西,就每秒再试一次,最多十二次。原因在原生侧注释里:文件是瞬间变的,那一行要等系统自己提交才可读,实测大约五秒。这是等一个已知的延迟,不是靠运气多试几次。

每分钟还有一次兜底读,只在 notify 设成聊天或全部时开着。文件监听会被系统掐掉,掐掉时消息不是迟到,是彻底看不见,所以不能只留监听一条路。

签名变了,名字没变

这次桥接接口从 andee_notif_since(afterId) 变成 andee_notif_since(afterId, afterDelivered)。JNA 按名字绑定,不看签名,所以一边换了一边没重编的话,拿到的第二个参数是垃圾值,而且不会报错。本地构建是整套一起出,问题不大;但发出去的 Mac 包里,JNA 库和 Swift 动态库必须同批,别单独热替换其中一个。

代价

同一条通知被反复改,就会走反复判断。我手里没有一本「这个 rec_id 判过了」的账,只记了边界。所以一个 App 如果持续原地刷新同一条通知,可能会提醒你两次以上。这是读代码得出的,我没在真机上数过次数。

启动时边界设在最新一行,关着的时候发生的事不补读。这是有意的,不做回填。

十秒合并窗口还在,也没有要改。同一个 App 十秒内的连续消息只留最后一条,那是有意设计:群聊刷屏时最后一句才带全量信息。这次修的是窗口之外的漏,窗口之内的合并照旧。

还有一处小的:这个类的注释里写着「加上它自己 3 秒的合并」,而常量是 10 秒。注释落后于代码,写文档时别抄它。

正文只取前 160 个字,标题 80 个字。长群聊的后半段读不到。

最后是底层依赖。要读这本账得给完全磁盘访问权限;库的位置苹果没给过约定,代码里写死两个已知路径。两个都打不开时返回找不到,而不是没权限。这两种情况修法不同,混成一个提示,用户会去拨一个没用的开关。

也没有单元测试。这段要真 Mac、真通知库、还得有一个 App 恰好把第二条折进第一条,写不出可重复的桩。验证方式是我开着它等,等飞书那条真的来了,再看时间线上有没有那一行。

现在飞书第二条消息会进时间线了。同一条被改多次会不会重复响,我只在代码上看到了可能,真机上还得跑几天。