核心用法
TickTick Integration 是基于滴答清单官方 Open API 的命令行工具,提供完整的任务管理功能。首次使用需通过 ticktick-setup 完成 OAuth 2.0 授权流程,获取访问令牌后可持续使用。
主要功能:
- 项目查看:
ticktick projects列出所有项目(清单) - 任务管理:支持按项目筛选、添加任务(可指定截止日期和优先级)、完成任务、删除任务
- 批量操作:可快速处理多任务状态变更
API 覆盖:完整对接滴答清单 v1 开放接口,包括项目数据获取、任务 CRUD、完成状态切换等核心端点。
显著优点
1. 官方 API 背书:基于 TickTick 官方开放平台,数据同步稳定可靠
2. 功能闭环:涵盖任务管理全生命周期,从创建到归档
3. 日期支持:支持 ISO 8601 格式截止日期,便于自动化提醒
4. 优先级体系:0/1/3/5 四级优先级,适配 GTD 工作流
潜在局限
- OAuth 门槛:首次配置需开发者账号注册、回调 URI 设置,对普通用户有一定技术门槛
- 本地回调:依赖
127.0.0.1:8765本地端口,容器/远程环境需额外网络配置 - 功能边界:不支持重复任务规则设置、子任务层级管理、附件上传等高级功能
- 速率限制:官方 API 存在调用频率限制,高频自动化场景可能受限
适合人群
- 已将 TickTick 作为主力 GTD 工具的开发者/技术用户
- 需要 CLI/脚本化任务管理的自动化工作流搭建者
- 希望通过 API 将任务系统与其他工具(如日历、IM)集成的进阶用户
常规风险
- 令牌安全:OAuth token 存储于本地,多用户环境需关注文件权限
- 数据误操作:
delete操作不可逆,批量脚本需增加确认机制 - 授权过期:长期未使用需重新授权,自动化任务可能因此中断