Task Sync

核心用法

Task Sync 提供滴答清单（TickTick/Dida）与 Google Tasks 之间的完整双向同步方案。用户需先配置 Python 3.10+ 环境，安装 Google 认证库，并分别运行 Google Tasks API 和 TickTick 开发者应用的 OAuth 授权脚本，最终在 config.json 中指定令牌与数据路径。同步逻辑支持：同名列表/项目自动映射；任务标题、完成状态、备注内容双向同步；滴答清单优先级转换为 Google Tasks 标题前缀（[★] 高优先级、[!] 中优先级）；智能列表（今日、未来7天、全部）单向导出至 Google Tasks。

显著优点

• 生态打通：填补滴答清单与 Google 原生任务体系的割裂，实现跨平台任务统一管理
• 智能优先级可视化：通过标题前缀标记优先级，弥补 Google Tasks 无优先级字段的缺陷
• 日历冲突规避：独创的日期处理规则——仅在"全部"列表保留截止日期，其他列表同步后清空 Google 侧日期，从源头消除 Google Calendar 重复条目问题
• 自动化就绪：原生支持 Cron 定时执行（建议 10 分钟间隔），可接入 OpenClaw 实现无感同步

潜在局限

• 依赖开发者账号：TickTick 需申请开发者应用，流程门槛较高
• OAuth 维护成本：双端令牌均需定期刷新，授权失效会导致同步中断
• 单向智能列表：今日/未来7天列表仅支持滴答→Google 单向导出，Google 侧修改不回传
• 无实时同步：基于轮询机制，最低 10 分钟延迟，不适合高频协作场景

适合人群

跨平台用户（滴答清单主力 + Google Workspace 办公环境）、需要规避日历重复提醒的日历重度用户、偏好本地脚本自动化的高级用户。

常规风险

• 数据冲突：双端同时编辑同一任务可能导致最后写入者覆盖，建议开启同步日志（sync_log.json）定期审计
• 令牌泄露：config.json 包含 OAuth 凭证，需严格限制文件权限（建议 600），避免提交至版本控制
• API 限流：Google Tasks API 存在配额限制，高频同步可能触发速率限制
• 日期误清：不熟悉"仅 All 列表保留日期"规则的用户，可能误操作导致其他列表截止日期丢失

核心用法

Task Sync 是一款面向效率管理用户的开源工具，专注于实现 TickTick（滴答清单）与 Google Tasks 两大主流任务管理平台的双向数据同步。用户通过配置 OAuth 2.0 授权凭证后，可执行以下核心操作：

• 列表/项目映射：自动将 Google Task Lists 与 TickTick Projects 按同名规则建立对应关系
• 任务内容双向同步：同步任务标题、完成状态、备注内容，并将 TickTick 优先级映射为 Google Tasks 标题前缀（[★] 高优先级、[!] 中优先级）
• 智能清单单向导出：将 TickTick 的「今天」「未来 7 天」「全部」智能清单导出至 Google Tasks
• 自动化调度：支持通过 Cron 定时任务（建议每 10 分钟）实现无人值守同步

特别值得注意的是其截止日期处理规则：为避免 Google Calendar 重复项问题，工具仅在「全部」清单保留截止日期，其他同步列表会将日期前向同步至 TickTick 后清除 Google 端的截止日期字段。

显著优点

1. 开源透明：MIT 协议开源，代码结构清晰，无黑盒操作，用户可审计全部同步逻辑
2. 官方 API 支撑：基于 TickTick Open API 和 Google Tasks API 官方接口，稳定性与兼容性有保障
3. 灵活配置：支持通过环境变量自定义凭证路径，适应多账户或多环境部署场景
4. 冲突处理机制：内置同步数据库（sync_db.json）和日志追踪（sync_log.json），便于排查数据不一致问题

潜在缺点与局限性

• 第三方服务依赖风险：核心功能完全依赖 TickTick 和 Google 的服务可用性，任一方 API 变更或限速均可能导致同步中断
• 配置门槛较高：需用户独立完成 Python 环境搭建、双平台 OAuth 应用创建、API 启用等流程，对非技术用户不够友好
• Token 安全管理责任：OAuth 令牌以本地文件形式存储，安全性完全依赖用户的文件权限管理和系统安全
• 功能边界明确：不支持附件同步、子任务层级同步、重复任务规则同步等高级特性
• 社区维护模式：T3 来源可信度标识表明此为个人开发者社区项目，长期维护承诺存在不确定性

适合的目标群体

• 跨平台效率用户：同时使用 TickTick 移动端与 Google Workspace 生态的商务人士
• 技术型个人用户：具备基础 Python 和命令行操作能力，追求数据自主可控的效率爱好者
• 小型团队管理员：需要统一团队成员任务视图，且技术栈允许定制化部署的场景
• 自动化工作流构建者：希望将任务同步集成到更复杂的居家服务器或 CI/CD 流程中的极客用户

使用风险说明

安全风险：OAuth 令牌文件若权限设置不当（建议 chmod 600）或被意外提交至版本控制，可能导致账户数据泄露。用户需承担 Token 保管的全责。

性能风险：首次全量同步或大数据量场景下，可能触发 Google/TickTick API 速率限制；Cron 高频调度（如每分钟）将加剧此风险。

数据一致性风险：双向同步天然存在冲突可能（如同一任务在两端同时修改），工具虽内置数据库追踪，但仍可能出现非预期的覆盖行为，建议关键任务保留备份。

合规风险：使用本工具需同时遵守 TickTick 和 Google 的服务条款，自动化操作可能被视为「非官方客户端」，存在账户受限的理论可能（实际风险较低）。