TickTick 官方 API 集成的任务管理工具,支持项目/任务列表查询、增删改查及完成标记,需 OAuth 授权。
说明:
## 核心用法
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` 操作不可逆,批量脚本需增加确认机制
– **授权过期**:长期未使用需重新授权,自动化任务可能因此中断









