核心用法
task-sync 是一款专为跨平台任务管理设计的自动化同步工具,实现 TickTick(滴答清单)与 Google Tasks 的双向实时同步。用户通过配置 OAuth 认证后,可执行以下核心操作:
同步机制:工具将 Google Task Lists 与 TickTick Projects 按同名映射,双向同步任务标题、完成状态及备注内容。TickTick 优先级自动转换为 Google Tasks 标题前缀——[★] 表示高优先级,[!] 表示中等优先级。
智能列表导出:支持将 TickTick 智能列表(今日/未来7天/全部)单向导出至 Google Tasks,其中"全部"列表保留截止日期,其他列表则清除 Google 端日期以避免 Calendar 重复项。
自动化部署:可通过 cron 定时任务每10分钟自动执行同步,配合 OpenClaw cron 实现无人值守运维。
显著优点
官方 API 原生支持:基于 Google Tasks API 与 TickTick Open API 构建,数据传输采用 TLS 1.3 加密,安全可靠。
智能化冲突处理:内置 Due-Date Rule 解决 Google Calendar 重复项问题,自动识别并清理非必要日期字段。
低门槛部署:仅需 Python 3.10+ 环境及四个 pip 依赖包,通过自动化脚本完成 OAuth 配置,无需复杂运维经验。
透明可审计:生成 sync_log.json 与 sync_db.json 双日志体系,便于追踪同步历史与排查异常。
潜在缺点与局限性
令牌存储风险:OAuth 令牌以明文 JSON 存储于本地文件系统,若设备被物理访问或存在恶意软件,存在泄露风险。建议用户自行启用系统密钥管理服务。
输入验证待强化:配置路径与任务内容缺少严格校验,极端场景下存在路径遍历风险。
依赖版本未锁定:未提供 requirements.txt,不同环境可能因依赖版本差异导致兼容性问题。
单向智能列表限制:Today/Next 7 Days 列表导出后会丢失截止日期信息,需用户理解此设计权衡。
适合的目标群体
- 多平台任务管理者:同时使用 TickTick 移动端与 Google Workspace 生态的用户
- 自动化效率追求者:希望减少手动同步、实现定时自动备份的进阶用户
- 隐私敏感型用户:倾向数据本地存储、不愿使用第三方云同步服务的人群
- 技术爱好者:具备基础 Python 环境配置能力,能接受命令行操作的开发者或运维人员
使用风险
性能与稳定性:网络波动可能导致 API 调用超时,建议配置重试机制;高频同步(如10分钟间隔)可能触发 API 速率限制。
依赖可用性:Google Tasks API 或 TickTick API 策略变更可能影响功能可用性,需关注官方公告。
数据一致性:极端并发场景下(双端同时编辑同一任务)可能出现冲突,工具采用"最后写入优先"策略,重要任务建议避免并行修改。
日志隐私泄露:当前日志可能记录任务标题与内容,共享日志前需手动脱敏处理。