task-sync

🔄 滴答与谷歌任务双向同步助手

社区开源方案实现 TickTick 与 Google Tasks 双向同步,解决跨平台任务管理割裂,确保数据一致性与自动化流转。

收藏
3.5k
安装
781
版本
v2.0.3
CLS 安全性认证2026-05-21
点击查看完整报告 >

使用说明

Task Sync 是一款专注于解决跨平台任务管理痛点的自动化同步工具,通过 Python 脚本实现 TickTick(滴答清单)与 Google Tasks 的双向实时数据同步。该技能支持任务列表映射、内容双向同步、完成状态同步以及智能列表(今日、未来7天、全部)的单向导出,有效打通两大主流任务管理平台的数据壁垒。

核心用法围绕 OAuth 授权与自动化同步展开。用户需分别配置 Google Tasks API 和 TickTick 开发者应用的 OAuth 凭证,通过交互式脚本完成授权流程,并在 config.json 中配置本地 Token 存储路径。主同步脚本支持手动执行或配置 Cron 定时任务(建议每10分钟),实现后台自动化运行。技能采用同名映射机制自动关联 Google Task Lists 与 TickTick Projects,并将 TickTick 的优先级智能转换为 Google Tasks 的标题前缀标记([★] 高优先级、[!] 中优先级),同时支持将滴答清单的智能筛选列表单向同步至 Google Tasks。

显著优点包括完全开源透明、双向实时同步确保数据一致性、灵活的自动化支持(Cron/OpenClaw)以及完善的故障排查机制。技能通过本地文件存储 OAuth Token 和同步日志,避免敏感数据云端传输;详细的日志记录(sync_log.json)和数据库(sync_db.json)便于用户追踪同步历史和排查异常。

潜在局限性主要体现在配置门槛和技术依赖方面。作为 T3 级社区项目,虽代码规范但缺乏官方背书;依赖版本未完全锁定可能带来兼容性风险;用户需具备基础的 Python 环境和命令行操作能力;OAuth 配置流程对非技术用户存在一定学习成本。此外,Google Calendar 重复项问题需要用户理解特殊的截止日期处理规则(仅在"全部"列表保留日期)。

适合的目标群体包括:同时使用 TickTick 和 Google Tasks 的跨平台效率工具用户、具备基础技术背景的自动化爱好者、需要企业级任务管理备份方案的个人用户,以及使用 OpenClaw 平台进行工作流自动化的开发者。

使用风险主要涉及 Token 安全管理、API 限流和日历同步异常。用户需确保 config.json 配置的 Token 文件路径安全,避免将凭证提交至版本控制;Google 和 TickTick API 均存在调用频率限制,高频同步可能触发限流;由于 Google Calendar 与 Tasks 的深度集成,不当的日期同步策略可能导致日历视图出现重复提醒,需严格按照"仅在 All 列表保留日期"的规则配置。

安全解读

核心用法

Task Sync 是一款面向效率工具深度用户的双向同步工具,打通滴答清单(TickTick)与 Google Tasks 的数据孤岛。用户完成 OAuth 授权后,可实现:

  • 列表/项目映射:同名 Google Task List 与 TickTick Project 自动双向同步
  • 任务内容同步:标题、完成状态、备注内容实时对齐
  • 优先级可视化:TickTick 高优先级映射为 [★]、中优先级为 [!] 前缀
  • 智能列表导出:将「今天」「未来7天」「全部」三个智能列表单向推送至 Google Tasks

关键设计在于日期处理规则——为避免 Google Calendar 重复创建提醒,仅在「All」列表保留截止日期,其余列表同步后清空 Google 端日期,此规则是排查日历重复问题的核心依据。

显著优点

1. 协议合规:采用标准 OAuth 2.0,token 本地加密存储,无硬编码凭证
2. API 可控:仅访问 Google 与 TickTick 官方端点,TLS 1.3 全链路加密

3. 自动化友好:内置 Cron 配置示例,支持 OpenClaw 定时任务

4. 调试透明:结构化日志(sync_log.json)与本地数据库(sync_db.json)便于追溯

潜在局限

  • 速率限制未内置:高频同步可能触发 API 限流,需用户自行控制频率
  • 权限管理依赖用户:token 文件需手动设置 600 权限,缺乏自动校验
  • 冲突解决单向:未提供任务冲突时的手动合并界面,依赖时间戳覆盖
  • 平台局限:仅支持 Python 3.10+,无图形化配置界面

适合人群

  • 跨平台任务管理的重度滴答/Google Tasks 用户
  • 熟悉命令行、能自主排查 OAuth/日志的技术人员
  • 需要定时自动化、接受 cron 配置的学习成本

常规风险

| 风险类型 | 说明 | 缓释措施 |
|---------|------|---------|
| Token 泄露 | 本地 JSON 文件权限不当 | 手动 chmod 600,避免提交至版本控制 |
| 数据覆盖 | 双向同步逻辑冲突 | 定期备份 sync_db.json,异常时回滚 |
| API 失效 | 官方接口变更 | 关注维护者 openclaw 仓库更新 |
| 日历重复 | 日期规则误配 | 严格遵循「All 列表保留日期」规则 |

安全认证结论

CLS-Certify v2.1.0 全扫描通过,得分 95/100,评级 S。静态分析无危险函数,网络行为仅限于官方 API,隐私合规满足 GDPR/CCPA。两项低风险发现均为权限提示类,无代码级漏洞。

task-sync 内容

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