Floccus 项目中 JavaScript 书签工具重复同步问题分析

问题背景

Floccus 是一款浏览器书签同步工具，支持与 Nextcloud 等服务进行数据同步。在 5.3.0 版本中，用户报告了一个关于 JavaScript 书签工具（bookmarklet）在同步过程中出现重复创建的问题。

问题现象

当用户执行以下操作时会出现异常行为：

1. 从 Nextcloud 书签中创建一个 JavaScript 书签工具并保存到浏览器书签列表
2. 使用 Floccus 扩展执行"推送"操作将书签工具同步到云端
3. 在另一浏览器中执行"拉取"操作
4. 关闭并重新打开浏览器后再次执行"拉取"操作，会导致书签工具被重复创建

值得注意的是，这个问题仅在浏览器新会话中首次执行拉取操作时出现，同一会话内的多次拉取不会导致重复。

技术分析

JavaScript 书签工具是一种特殊的书签，其 URL 以"javascript:"开头，包含可执行的 JavaScript 代码。Floccus 在处理这类特殊书签时，同步逻辑存在不足：

1. 会话识别问题：Floccus 未能正确识别浏览器会话边界，导致每次新会话都被视为首次同步
2. 重复检测机制失效：对于 JavaScript 书签工具，同步前的重复检查逻辑存在缺陷
3. 同步策略不一致：手动同步和自动同步在处理这类书签时行为不一致

解决方案

开发者在 5.3.1 版本中修复了这个问题，主要改进包括：

1. 增强了对 JavaScript 书签工具的特殊处理逻辑
2. 改进了会话识别机制
3. 优化了重复检测算法

验证结果

多位用户验证确认修复有效：

• 跨平台验证（Windows/Linux 上的 Firefox 和 Chrome）
• 解决了书签工具被错误删除到回收站的问题
• 同步行为在不同浏览器会话间保持一致

最佳实践建议

对于使用 Floccus 同步 JavaScript 书签工具的用户，建议：

1. 确保使用最新版本的 Floccus 扩展
2. 对于重要的书签工具，定期检查同步状态
3. 考虑为关键书签工具添加特殊标记，便于识别和管理

总结

这个案例展示了书签同步工具在处理特殊类型书签时可能遇到的边缘情况。Floccus 开发团队通过用户反馈快速定位并修复了问题，体现了开源社区协作的优势。对于开发者而言，这也提醒我们在设计同步系统时需要特别考虑各种特殊数据类型和边界条件。