核心用法
TickTick skill 通过 Maton 代理服务提供 TickTick Open API 的托管 OAuth 集成,允许 AI 助手对用户任务和项目进行完整生命周期管理(CRUD)。用户需先在 Maton 平台获取 API Key,并建立 TickTick OAuth 连接,之后所有 API 请求通过 https://api.maton.ai/ticktick/{path} 路由,由 Maton 自动注入 OAuth Token。
关键操作流程:
1. 认证准备:设置 MATON_API_KEY 环境变量,通过 Maton 连接管理端点创建 TickTick 连接,用户浏览器完成 OAuth 授权
2. 项目管理:支持列表、看板、时间轴三种视图模式,可创建、获取详情(含任务列表)、删除项目
3. 任务操作:完整支持任务创建、更新、完成、删除,支持优先级(0/1/3/5)、截止日期、标签、跨时区等字段
4. 多账户管理:通过 Maton-Connection 请求头指定特定连接,支持同一 API Key 管理多个 TickTick 账户
显著优点
- 零 OAuth 实现成本:开发者无需处理 TickTick OAuth 2.0 流程,Maton 托管令牌刷新与存储
- 标准 REST 接口:完全兼容 TickTick Open API 语义,支持 Python、JavaScript 等任意 HTTP 客户端
- 多租户就绪:原生支持多连接切换,适合团队协作或代理服务场景
潜在缺点与局限性
- 功能范围受限:Open API 不包含习惯追踪(Habits)、番茄钟/专注模式、全局标签管理
- 第三方依赖风险:Maton 代理层为单点故障点,若服务中断则 API 不可用;官方未承诺 SLA
- 数据隐私考量:任务内容需流经 Maton 服务器,尽管文档声称仅代理请求,敏感任务存在额外暴露面
- 速率限制不透明:错误码包含 429,但未文档化具体限制阈值
适合人群
- 个人效率工具开发者、自动化工作流构建者(如将邮件/Slack 消息自动转为 TickTick 任务)
- 需快速集成 TickTick 而不愿投入 OAuth 工程成本的小型团队
- 已使用 Maton 生态连接多服务的用户
常规风险
- 写操作需二次确认:文档明确要求 AI 在执行创建/更新/删除前向用户确认目标资源及预期效果,防止误操作
- Token 安全:API Key 泄露将导致连接账户完全暴露,需按环境变量规范妥善保管
- OAuth 授权撤销:用户在 TickTick 端撤销授权后,Maton 连接将失效,需重新走授权流程