核心用法
Task Sync 是一款面向生产力用户的开源自动化工具,实现 TickTick(滴答清单)与 Google Tasks 之间的双向数据同步。用户需完成三步初始化:配置 Google Tasks API OAuth、创建 TickTick 开发者应用获取令牌,并编辑 config.json 指定数据路径。运行时执行 sync.py 即可将两个平台的任务列表按同名映射、同步任务标题、完成状态及备注内容。
显著优点
- 双向实时同步:任务在两端任意修改均可自动合并,避免手动迁移。
- 智能列表导出:支持将 TickTick 的「今天」「未来7天」「全部」智能列表单向导出至 Google Tasks,便于跨平台查看。
- 优先级可视化:通过
[★](高优先级)和[!](中优先级)前缀,将 TickTick 优先级映射至 Google Tasks 标题,弥补后者无优先级字段的缺陷。 - 日历重复问题根治:针对 Google Calendar 因截止日期同步产生的重复事件,提供「仅保留『全部』列表截止日期」的规则,明确数据源归属。
- 自动化友好:内置 Cron 示例,支持每 10 分钟自动执行,适合服务器常驻或 NAS 部署。
潜在缺点与局限性
- 依赖个人开发者令牌:TickTick 未开放官方 OAuth,需申请开发者权限,流程繁琐且存在权限变更风险。
- 无冲突解决 UI:复杂冲突(如同步间隔内两端均修改)依赖脚本逻辑,缺乏可视化干预手段。
- Google Tasks API 限制:单日配额有限,高频同步或大量任务用户可能触发速率限制。
- 单向智能列表:「今天」「未来7天」仅支持 TickTick → Google 单向导出,反向修改不会同步回 TickTick。
- Python 环境依赖:需手动管理
google-auth、requests等库版本,对非技术用户门槛较高。
适合人群
- 同时使用 TickTick 移动端与 Google Workspace(日历/任务)的跨平台用户
- 需要本地自动化服务器(NAS/Raspberry Pi)常驻同步的进阶用户
- 受困于 Google Calendar 任务重复事件、寻求根治方案的效率工具爱好者
常规风险
- OAuth 令牌泄露:
config.json及 token 文件需严格限制文件权限(建议 600),避免同步至公共代码仓库。 - 数据丢失风险:初始化配置错误或 API 变更可能导致任务重复、误删或元数据丢失,建议首次运行前备份两端数据。
- API 服务中断:Google 或 TickTick 接口变更可能导致同步失效,需关注上游依赖更新。