核心用法
Task Sync 是一款开源 Python 工具,用于建立 TickTick(滴答清单)与 Google Tasks 之间的双向数据同步。核心功能包括:
1. 双向项目/列表同步:Google Tasks 的列表与 TickTick 的项目按名称自动匹配,实现双向同步
2. 任务全字段同步:任务标题、完成状态、备注内容双向流转
3. 优先级映射:TickTick 的高优先级映射为 Google Tasks 标题前缀 [★],中优先级为 [!]
4. 智能列表单向推送:TickTick 的智能列表(今天、未来7天、全部)单向推送至 Google Tasks
5. 防日历重复策略:日期字段通过 TickTick 中转后清除 Google 端日期,仅"全部"列表保留日期
显著优点
- 跨平台整合:解决 TickTick 与 Google 生态(Gmail、Calendar、Assistant)的割裂问题
- 自动化友好:原生支持 Cron 定时任务,可每 10 分钟自动执行
- 开源可控:Python 代码透明,支持自托管,无第三方云服务介入
- 智能列表原生支持:突破 Google Tasks 无智能列表的局限
- 防重复机制:独特的日期处理策略避免 Calendar 重复事件
潜在缺点与局限性
- 技术门槛较高:需自行配置 Google Cloud 项目、OAuth 2.0、TickTick 开发者账号
- Token 管理复杂:需手动维护
config.json和 OAuth token 文件 - 单向智能列表:智能列表只能从 TickTick→Google,不可逆
- 字段映射有限:不支持子任务、附件、标签等高级字段
- 依赖外部 API:受限于 TickTick Open API 和 Google Tasks API 的稳定性与配额
- 无图形界面:纯命令行操作,非技术用户配置困难
适合人群
- 技术型用户:熟悉 Python、OAuth、API 配置的开发者或高级用户
- 跨平台重度用户:同时使用 TickTick(移动端体验好)和 Google Workspace(办公协同)
- 自动化爱好者:需要定时任务同步、追求工作流整合的用户
- 隐私敏感用户:倾向自托管方案,不愿使用第三方同步服务
常规风险
- OAuth Token 泄露:
config.json和 token 文件若未妥善保管,可能导致 Google/TickTick 账号被非法访问 - 数据冲突与丢失:双向同步存在冲突解决策略(未明确文档),极端情况下可能导致任务覆盖
- API 限流与封禁:高频同步(如 10 分钟间隔)可能触发 API 配额限制
- 服务终止风险:TickTick Open API 为官方未公开稳定服务,存在变更或下线可能
- Cron 环境差异:不同系统的 Cron 环境变量、Python 路径配置易导致执行失败