Task Sync

核心用法

Task Sync 是一款开源的双向任务同步工具，专门解决 TickTick（滴答清单）与 Google Tasks 之间的数据互通问题。用户通过 Python 脚本实现两个平台的任务列表、任务标题、完成状态及备注内容的实时或定时同步。

主要功能模块：

• 双向列表同步：Google Task Lists 与 TickTick Projects 按名称自动匹配
• 任务内容同步：支持标题、完成状态、备注/内容的跨平台同步
• 优先级映射：TickTick 的高/中优先级自动转换为 Google Tasks 标题前缀 [★] 和 [!]
• 智能列表推送：将 TickTick 的「今天」「未来7天」「全部」三大智能列表单向同步至 Google Tasks
• 防重复策略：日期字段通过 TickTick 中转后从 Google Tasks 清除，避免 Google Calendar 重复事件；仅「全部」列表保留日期

运行方式：执行 python sync.py 即可触发同步。支持 Crontab 每10分钟定时任务或 OpenClaw 内置调度系统。

显著优点

1. 生态桥接：填补 TickTick 与 Google 原生任务管理之间的生态鸿沟，适合同时使用 Android/Gmail 与 TickTick 的跨平台用户
2. 零成本开源：完全免费，代码透明，支持本地部署
3. 智能列表原生支持：独特支持 TickTick 智能列表的导出，这是官方 API 未直接暴露的能力
4. 防重复设计：日期处理策略避免 Google Calendar 重复，体现实际使用场景的深度优化

潜在缺点与局限性

• 技术门槛高：需 Python 3.10+ 环境，手动配置 Google Cloud OAuth 与 TickTick 开发者应用，不适合非技术用户
• 令牌管理负担：双平台 OAuth 令牌需手动维护，存在过期风险
• 单向智能列表：Today/Next 7 Days 智能列表仅能从 TickTick 推送到 Google，无法反向同步
• 字段限制：不支持子任务、附件、标签等复杂字段的同步
• 依赖第三方 API：受 TickTick Open API 稳定性与速率限制约束

适合人群

• 技术背景的效率工具爱好者
• 同时使用 Google Workspace 与 TickTick 的跨平台重度用户
• 需要定时自动化任务同步的开发者/运维人员
• 对数据主权敏感、倾向本地部署的用户

常规风险

| 风险类型 | 说明 |

|---------|------|

| **OAuth 泄露** | `config.json` 存储的令牌若泄露，可导致双平台任务数据被访问或篡改 |

| **数据冲突** | 双向同步存在时间差，极端情况下可能出现任务重复或覆盖 |

| **API 变更** | TickTick 非官方 API 可能随时调整，导致同步失效 |

| **定时任务失控** | Crontab 配置错误可能导致频繁 API 调用，触发限流或封禁 |

| **日期误处理** | 自动清除 Google 端日期的策略可能造成预期外的时间信息丢失 |

核心用法

Task Sync 是一款实现 TickTick（滴答清单）与 Google Tasks 双向同步的自动化工具。用户通过 Python 脚本运行主程序 sync.py，首次使用需分别配置 Google Cloud 和 TickTick 开发者账号的 OAuth 认证。配置完成后，工具会自动匹配两边的任务列表（按名称对应），同步任务标题、完成状态、备注内容及优先级信息。其中 TickTick 的高/中优先级会转换为 Google Tasks 标题前缀 [★] 和 [!] 进行标识。此外，工具支持将 TickTick 的智能列表（今日、未来7天、全部）单向推送至 Google Tasks，并通过特定的日期策略避免 Google Calendar 重复创建事件。

显著优点

1. 真正的双向同步：不同于单向导入导出，该工具实现了任务状态的双向实时更新，无论在 TickTick 还是 Google Tasks 中修改任务，都会同步到另一端。

2. 智能列表映射：独特支持 TickTick 的智能列表（Today/Next 7 Days/All）同步，这对于依赖智能筛选的用户极具价值。

3. 标准化 OAuth 安全认证：采用业界标准的 OAuth 2.0 授权流程，Token 本地化存储，无硬编码密钥风险。

4. 自动化友好：原生支持 Cron 定时任务配置，可设置每10分钟自动同步，也可集成 OpenClaw 内置定时系统。

5. 代码结构清晰：模块化设计，API 封装独立在 utils/ 目录，配置与逻辑分离，便于二次开发和维护。

潜在缺点或局限性

1. Python 环境依赖：要求 Python 3.10+ 及多个第三方库，对非技术用户门槛较高。

2. 手动配置繁琐：需要分别在 Google Cloud 和 TickTick 开发者平台创建应用、启用 API、获取凭证，配置流程较为复杂。

3. 名称匹配限制：任务列表通过名称字符串匹配，若两边列表名称不一致则无法正确关联。

4. 日期处理策略特殊：为避免 Google Calendar 重复，日期数据会被转发到 TickTick 后从 Google 清除，仅"全部"列表保留日期，这可能不符合部分用户预期。

5. 社区维护性质：作为个人开发者项目，长期维护稳定性和功能更新存在不确定性。

适合的目标群体

• 跨平台任务管理用户：同时依赖 TickTick 的丰富功能和 Google 生态集成的用户
• 效率工具极客：熟悉 Python 和 API 配置的技术型用户
• 团队协作场景：需要统一 TickTick 个人任务与 Google Workspace 团队日程的用户
• 自动化工作流构建者：希望将任务同步集成到更复杂的自动化流程中的开发者

使用风险

1. Token 安全存储：虽然使用标准 OAuth，但 Token 文件存储在本地 ~/.openclaw/ 目录，若设备被入侵存在泄露风险，建议按报告建议设置 0600 文件权限。

2. 数据一致性风险：双向同步在极端情况下（如网络中断、API 限流）可能出现冲突，虽无数据丢失报告，但建议首次使用前备份重要任务。

3. API 依赖稳定性：依赖 Google Tasks API 和 TickTick Open API，若任一端 API 变更或限流，同步功能将受影响。

4. 输入验证不足：当前版本对任务标题和内容缺乏严格的输入验证，极端情况下可能存在注入风险，建议关注后续版本更新。

5. 隐私合规：任务内容通过 HTTPS 传输至两个平台服务器，虽符合 OAuth 授权流程，但用户需自行评估是否符合其组织的 GDPR/数据合规要求。