Task Sync

核心功能与用法

Task Sync 是一款开源的双向任务同步工具，专用于打通 TickTick（滴答清单）与 Google Tasks 两大生态。用户可通过 Python 脚本实现：

• 双向同步：Google Task Lists 与 TickTick Projects 按名称自动匹配，任务标题、完成状态、备注内容实时双向流转
• 优先级映射：将 TickTick 的高中低优先级转换为 Google Tasks 标题前缀（[★] 高优先级、[!] 中优先级），弥补 Google Tasks 无优先级字段的缺陷
• 智能列表推送：TickTick 的「今天」「接下来7天」「全部」三大智能列表单向同步至 Google Tasks，方便跨平台查看
• 防重复策略：通过日期字段转移机制避免 Google Calendar 重复事件——日期先同步至 TickTick 后再从 Google 清除，仅「全部」列表保留原始日期

技术架构

采用模块化设计：sync.py 作为主控，utils/ 目录封装双方 API，scripts/ 提供 OAuth 自动化配置，附赠 15 项端到端测试保障稳定性。

显著优点

1. 生态互补：解决 TickTick 国内友好但国外协作弱、Google Tasks 国外通用但功能简陋的痛点
2. 零代码自动化：支持 Cron 定时任务或 OpenClaw 内置调度，10 分钟级增量同步
3. 数据安全可控：本地运行， token 自主管理，无第三方云服务中转

潜在局限

• 手动配置门槛高：需分别申请 TickTick 开发者账号、配置 Google Cloud OAuth，对非技术用户不友好
• 冲突处理未披露：双向同步未说明任务修改时间戳冲突时的仲裁逻辑
• 字段损耗：TickTick 的子任务、标签、附件等高级特性无法映射至 Google Tasks
• 依赖个人开发者账号：TickTick 开放 API 权限可能受平台政策变动影响

适合人群

• 跨中美国际协作的远程工作者
• TickTick 重度用户需向 Google Workspace 生态妥协的场景
• 具备基础 Python/命令行能力的效率工具爱好者

常规风险提示

• OAuth token 需妥善保管，泄露可能导致任务数据被读取或篡改
• 自动化同步存在数据覆盖风险，建议首次使用前完整备份双方任务数据
• Google API 有配额限制，高频同步可能触发限流

核心用法

Task Sync 是一款开源的任务同步工具，旨在打通 TickTick（滴答清单）与 Google Tasks 两大主流任务管理平台。用户运行 python sync.py 即可启动双向同步流程：Google Task Lists 与 TickTick Projects 按名称自动匹配，任务标题、完成状态、备注内容实时双向同步。工具特别设计了优先级映射机制——TickTick 的高/中优先级分别转换为 Google 任务标题前缀 [★] 和 [!]，便于在 Google Tasks 中快速识别重要任务。

此外，该 Skill 支持将 TickTick 的智能清单（今日、未来7天、全部）单向推送至 Google Tasks，并采用智能日期策略避免 Google Calendar 重复：日期信息优先转发至 TickTick 后从 Google 清除，仅保留"全部"清单的日期信息。

显著优点

官方 API 驱动：完全基于 Google Tasks API 和 TickTick Open API 构建，数据传输全程 TLS 1.3 加密，无第三方中转，安全可控。

自动化友好：原生支持 Cron 定时任务（建议每10分钟），也可接入 OpenClaw 内置调度系统，实现真正的"设置即忘记"。

数据映射精准：不仅同步基础字段，还完整处理优先级、日期、清单层级关系，同步结果符合用户直觉。

代码质量优秀：通过 15 项端到端测试覆盖核心流程，1621 行代码结构清晰，模块化设计便于二次开发。

潜在缺点与局限性

网络强依赖：同步功能完全依赖两大平台的 API 可用性，任一方服务故障或网络中断均会导致同步失败。虽然代码已包含错误处理和重试逻辑，但暂无离线缓存机制。

Token 管理待优化：OAuth Token 以明文 JSON 存储于本地，虽为标准做法，但需用户自行确保目录权限正确（建议 chmod 600），且缺乏自动刷新机制。

权限范围偏广：Google OAuth 配置请求了 Tasks、Calendar、Gmail、Contacts、Drive 等多项权限，实际仅用 Tasks API，存在过度授权问题。

单向智能清单限制：今日/未来7天等智能清单仅支持 TickTick → Google 单向推送，无法回传状态变化。

适合的目标群体

• 跨平台任务管理者：同时使用 TickTick 移动端与 Google Workspace 生态的办公人群
• 自动化爱好者：希望搭建个人任务中台的效率工具玩家
• 隐私敏感用户：倾向本地运行、拒绝 SaaS 订阅的数据自主主义者
• 开发者/运维人员：需要可审计、可定制的任务同步方案，愿意投入初期配置时间

常规使用风险

性能层面：高频同步（如每分钟）可能触发 API 速率限制，建议保持 10 分钟以上间隔。

数据一致性：双向同步存在极短窗口的冲突可能，极端情况下可能出现任务重复或状态覆盖，建议重要任务操作后手动触发同步确认。

凭证安全：Token 文件若被他人获取，可能导致任务数据泄露，务必确保运行环境权限隔离。

服务变更风险：TickTick/Google 若调整 API 接口或认证策略，需等待社区维护者更新适配。