TickTick API

核心用法

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 操作不可逆，批量脚本需增加确认机制
• 授权过期：长期未使用需重新授权，自动化任务可能因此中断

核心用法

TickTick Integration 是一款面向 TickTick 任务管理器的纯文档型 API 集成 Skill，提供完整的任务管理命令集。用户可通过 ticktick-setup 完成 OAuth 授权后，执行项目查询（ticktick projects）、任务列表获取（ticktick tasks）、任务创建（ticktick add）、完成标记（ticktick complete）及删除（ticktick delete）等操作。支持指定项目、截止日期、优先级（0-5）和标签等元数据，满足个人任务管理的精细化需求。

显著优点

1. 零执行风险：纯 Markdown 文档型 Skill，无实际可执行代码，彻底规避代码注入或恶意行为风险
2. 官方 API 直连：所有接口均调用 TickTick 官方服务（api.ticktick.com），HTTPS 加密传输，数据源权威可信
3. 标准 OAuth 流程：采用业界通行的授权协议，用户需显式授权，无静默数据收集，符合 GDPR/CCPA 合规要求
4. 功能完整覆盖：支持项目-任务双层结构、CRUD 全生命周期管理，以及优先级、截止日期等核心属性
5. 轻量无依赖：单文件文档结构，无第三方依赖包，部署和维护成本极低

潜在缺点与局限性

1. 需手动配置 OAuth：首次使用需在 TickTick 开发者平台注册应用并配置回调地址，对非技术用户存在门槛
2. T3 来源可信度：维护者为个人开发者（kaiofreitas），非企业级或官方背书项目，长期维护稳定性需观察
3. 功能边界清晰：仅提供 API 调用规范，实际 HTTP 请求需用户或客户端自行实现，非开箱即用的完整工具
4. 地域服务限制：TickTick 服务可用性受网络环境影响，部分地区可能存在访问延迟

适合人群

• 效率工具爱好者及 TickTick 重度用户
• 具备基础 OAuth 配置能力的开发者或技术型用户
• 需要在 CLI/自动化脚本中集成任务管理的效率优化者
• 对第三方代码执行持谨慎态度、偏好文档型集成的安全敏感用户

常规风险

• 授权凭证管理：OAuth token 需妥善保管，避免硬编码或泄露至版本控制
• API 限流与稳定性：受 TickTick 官方服务 SLA 约束，高频调用可能触发限流
• 账号安全风险：若授权后被恶意利用，可能导致任务数据篡改或删除，建议定期审查授权应用列表