Task Sync

🔄 滴答清单与谷歌任务双向同步

TickTick 与 Google Tasks 双向同步,支持列表映射、优先级前缀标记及智能列表导出,解决日历重复事件问题。

收藏
8.7k
安装
2.3k
版本
2.0.2
CLS 安全性认证2026-08-10
点击查看完整报告 >

使用说明

核心用法

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-authrequests 等库版本,对非技术用户门槛较高。

适合人群

  • 同时使用 TickTick 移动端与 Google Workspace(日历/任务)的跨平台用户
  • 需要本地自动化服务器(NAS/Raspberry Pi)常驻同步的进阶用户
  • 受困于 Google Calendar 任务重复事件、寻求根治方案的效率工具爱好者

常规风险

  • OAuth 令牌泄露config.json 及 token 文件需严格限制文件权限(建议 600),避免同步至公共代码仓库。
  • 数据丢失风险:初始化配置错误或 API 变更可能导致任务重复、误删或元数据丢失,建议首次运行前备份两端数据。
  • API 服务中断:Google 或 TickTick 接口变更可能导致同步失效,需关注上游依赖更新。

安全解读

核心用法

Task Sync 是一款专注于 TickTick(滴答清单)与 Google Tasks 双向同步的自动化工具。用户需先完成环境准备(Python 3.10+)和 OAuth 授权配置,通过运行 sync.py 即可启动同步流程。核心功能包括:按名称自动映射任务列表与项目、双向同步任务标题/完成状态/备注内容、将 TickTick 优先级转换为 Google Tasks 标题前缀([★] 高优先级、[!] 中优先级)、以及将 TickTick 智能列表(今日、未来7天、全部)单向导出至 Google Tasks。

特别设计了防日历重复机制:仅在"全部"智能列表保留截止日期,其他同步列表会将日期转发至 TickTick 后清除 Google 端的截止日期,避免 Google Calendar 出现重复项。支持通过 Cron 定时任务实现自动化运行,建议每 10 分钟执行一次。

显著优点

1. 跨平台无缝衔接:打破 TickTick 与 Google Tasks 的数据孤岛,让用户无需切换应用即可统一管理任务
2. 智能优先级映射:通过可视化前缀标记,在 Google Tasks 中也能快速识别任务紧急程度

3. 防重复日历机制:针对 Google 生态特性优化,避免截止日期同步导致的日历重复问题

4. 轻量可扩展:基于 Python 标准库和官方 SDK,代码结构清晰,便于二次开发

5. 自动化友好:原生支持 Cron 定时调度,可结合 OpenClaw 等工具实现完全无人值守

潜在缺点与局限性

1. 手动配置门槛:需用户自行申请 TickTick 开发者应用、启用 Google Tasks API、配置 config.json,对非技术用户不够友好
2. 同步粒度限制:不支持附件、子任务层级、标签颜色等高级特性的双向同步

3. API 依赖风险:完全依赖第三方服务可用性,任一方 API 变更或限流都可能导致同步中断

4. 无实时推送:基于轮询机制(建议 10 分钟间隔),存在数据延迟窗口

5. 冲突解决策略简单:文档未明确说明双向冲突时的优先级规则,复杂场景可能需要人工介入

适合的目标群体

  • 同时使用 TickTick 和 Google Workspace 的跨生态用户
  • 需要本地自动化任务流的技术从业者
  • 对数据主权敏感、偏好自托管方案的用户
  • 小型团队希望低成本打通任务系统的场景

使用风险

1. OAuth Token 安全:Token 文件存储在本地路径,需确保文件权限设置正确,避免多用户环境泄露
2. 数据一致性风险:网络中断或 API 异常可能导致同步状态不一致,建议定期核查 sync_db.json

3. 日志敏感信息:默认日志可能包含任务标题,建议在共享环境中启用脱敏选项

4. 频率限制:高频同步可能触发 API 速率限制,需合理设置 Cron 间隔

5. 配置单点故障config.json 错误会导致服务完全不可用,建议实施配置验证和备份机制

Task Sync 内容

scripts文件夹
utils文件夹
手动下载zip · 21.7 kB
setup_google_tasks.pytext/plain
请选择文件