Skip to content

松鼠笔记的剪藏、同步与周期回顾 ​

松鼠笔记从随手记和收藏网页开始。最费工夫的地方是把一次「收藏」从浏览器可靠地送进笔记库,再在手机和桌面读到同一份内容。后来加上 AI 周回顾、月回顾,另一个边界变得清晰:记录会跨设备同步,回顾成稿暂时由生成它的设备保存。

一次收藏怎样跨过浏览器和 App ​

早期浏览器剪藏要和桌面 App 配对。它在 App 开着时很方便,App 关闭或网络不通时,用户的选择和修改也要先保存下来。后来浏览器扩展增加直接写 WebDAV 的模式,各设备在下次同步时接收。另有独立的 Markdown 导出,适合只想留一个文件。自动提取拿到多少就保存多少:有正文就带正文和原链接,只有链接就只保留标题、备注和原链接。

交付使用稳定 ID。比如服务端已经写入、浏览器还没收到确认,浏览器会重送同一件剪藏;App 应识别旧 ID,保留后来编辑过的记录。用户若已删除那条收藏,迟到的重试也不能把它恢复。验收特地模拟丢回执、反复重送、跨设备读取和删除后重试。

为什么改掉共享清单 ​

最早的云端同步需要服务器支持强 ETag 和条件写入,实际有些 WebDAV 服务满足基本读写,却过不了这些前置检查。继续放宽写入检查又会引入竞争:两台设备同时修改,晚到的一方可能覆盖整份清单。

处理方式是每次修改生成独立的变更文件,里面记录已知父版本。两边可各自提交,读取时按版本关系合并;真正冲突的编辑保留冲突副本,永久删除有删除标记。目录列表若不完整、缺父节点或内容校验失败,本轮不仓促替换本地状态。这条规则比成功动画更关键,因为用户信任的是能找回改过的内容。

AI 回顾为什么单独存 ​

回顾按上一完整周或上一自然月读取记录与收藏。长文本分批处理,批次完成后把进度写进 SQLite,遇到后台中断可以续做。前台和后台共用租约,避免同一周期同时生成两份。没有原文的收藏按实际已有信息总结,空周期保存空回顾,不调用模型。iOS 的后台时机由系统决定,应用也会在恢复前台时补查。

已保存的成稿可编辑、复制、重做和打开来源。现有 WebDAV 同步不含这些成稿。要发博客,下一步是在报告详情导出用户选中的标题、周期和编辑后正文,再由网站接成草稿。这也为以后接其他用户留下清晰的接口,网站只需要收到成稿。

验证到哪一步 ​

剪藏已用隔离测试库验证本地 Markdown、WebDAV 交付、重试和跨设备导入保护。周期回顾检查过时间边界、长文分批、续跑、并发取消与空报告。定时是否在真实 iOS 设备准点运行取决于系统调度,真正的后台时机和模型调用仍需要持续观察。

笔记 App 的 Flutter 基础来自 Kelivo。

最近更新