如何通过addon/WebExtension hook Thunderbird tasks同步Todoist

WebExtension接入Thunderbird Tasks的可行性 #

• 旧版本（78版本以前）的Thunderbird中，任务（Tasks）功能确实隶属于独立的Lightning附加组件，官方没有对外暴露标准化的WebExtension API，因此早期开发者文档没有覆盖任务相关的接口说明，只能通过hack内部组件的方式接入。
• 从Thunderbird 78版本开始，Lightning已经合并为Thunderbird内置核心模块，不再是独立附加组件；115 ESR版本开放了日历/任务相关的实验性API，128及之后的稳定版本已经将任务相关API纳入正式文档覆盖范围，完全可以像接入其他模块一样通过标准WebExtension能力操作任务，不需要额外hook内部逻辑。

接入所需的核心配置与接口 #

你只需要在扩展的manifest.json文件中声明calendar权限，即可直接调用任务相关的官方接口：

• browser.calendar.tasks.list()：拉取Thunderbird中存储的全量任务，支持按截止时间、所属日历等条件过滤，可直接筛选出无截止日期的任务条目
• browser.calendar.tasks.create()：新建任务，支持不传入dueDate字段创建无截止时间的任务
• browser.calendar.tasks.update()、browser.calendar.tasks.delete()：完成已有任务的修改、删除操作
• browser.calendar.onTaskChanged：监听Thunderbird侧任务的新增、修改、删除事件，用于实现双向同步的变更触发

Todoist无截止日期任务同步的实现方案 #

不需要参考闭源的Google Tasks扩展实现，核心同步逻辑可按以下流程搭建：

1. 首次运行时全量拉取两侧数据：分别拉取Todoist全量任务（包含无截止日期条目）、Thunderbird本地全量任务，为两边的任务建立唯一ID映射关系，避免重复创建条目
2. 做增量双向同步：Thunderbird侧通过上述的任务变更事件捕获本地改动，同步到Todoist；Todoist侧通过官方增量同步接口拉取云端改动，调用对应Thunderbird任务接口写入本地
3. 同步时直接调用任务相关接口写入数据，不要调用日历事件创建接口，即可避免原生同步逻辑把任务转为日历事件的问题。

内容的提问来源于stack exchange，提问作者shaedrich