TickTick CLI

核心功能

TickTick CLI Skill 是一款面向开发者的命令行任务管理工具，基于官方 Open API v1 构建，提供完整的 TickTick 账号操作能力。

核心用法

认证体系：采用标准 OAuth2 授权码模式，支持浏览器自动回调与无头服务器手动模式。令牌自动刷新机制确保长期可用性，凭证以明文形式存储于 ~/.clawdbot/credentials/ticktick-cli/config.json（权限尝试设置为 700/600）。

任务管理：覆盖任务全生命周期——创建（支持自然语言日期如 "in 7 days"、优先级标记、标签）、查询（按项目/状态过滤、JSON 输出）、更新、完成及废弃（won't do）。特别提供 batch-abandon 批量废弃接口，单次 API 调用可处理多任务。

项目管理：项目列表获取、创建（支持自定义颜色）、重命名与颜色修改，推荐使用项目 ID 而非名称以确保可靠性。

显著优点

• 开发者友好：--json 全局选项支持结构化输出，便于脚本化与 AI Agent 集成
• 智能解析：内置自然语言日期解析器（today/tomorrow/in N days/next monday）
• 批量效率：利用 TickTick 批处理端点减少 API 调用次数
• 自动恢复：令牌过期自动刷新，降低人工干预

潜在局限

• 凭证安全：OAuth 凭证以明文存储，依赖文件系统权限保护
• 速率限制：100 req/min 与 300 req/5min 的严格限流，批量操作易触发
• 功能边界：不支持专注计时、习惯追踪等高级功能；单项目任务上限 500
• ID 依赖：批量废弃等操作要求 24 位十六进制任务 ID，无法直接通过名称操作

适合人群

开发者、自动化工程师、AI Agent 集成场景，以及偏好终端工作流的重度 TickTick 用户。

常规风险

凭证文件若权限配置失败或备份不当可能导致令牌泄露；批量操作前建议通过 lists --json 确认项目存在，避免 "Project not found" 错误。

核心用法

TickTick CLI Skill 是一款面向 TickTick 任务管理服务的命令行工具，基于官方 Open API v1 实现完整任务生命周期管理。核心功能包括：OAuth2 认证流程（支持自动浏览器唤起和手动无头模式）、任务增删改查（支持自然语言日期如"tomorrow"、"in 7 days"）、项目列表管理、批量操作（batch-abandon）以及 JSON 结构化输出。

显著优点

1. 官方 API 保障：直接调用 api.ticktick.com 官方端点，非逆向工程或爬虫方案，稳定性和兼容性有保障
2. 完整 OAuth2 实现：标准授权码流程，支持自动 token 刷新，headless 服务器可通过 --manual 模式完成认证
3. 智能日期解析：支持 "next monday"、"in N days" 等自然语言，降低使用门槛
4. 批量操作优化：内置 batch 端点支持，减少 API 调用次数（官方限制 100/分钟）
5. Agent 友好设计：全局 --json 标志、明确的 ID/名称双模式、项目预检建议，适合自动化脚本集成

潜在缺点与局限性

1. 功能边界：不支持 TickTick 高级功能如专注时间、习惯追踪，仅覆盖基础任务管理
2. 凭证存储：OAuth token 以明文 JSON 存储于 ~/.clawdbot/credentials/，虽设 700/600 权限但非系统密钥库
3. API 限制：单项目 500 任务上限，高频批量操作易触发限流
4. 依赖运行时：需 Bun/Node.js 环境，非独立二进制
5. 无代理配置：企业代理环境需额外配置支持

适合人群

• 开发者/工程师：偏好 CLI 工作流，需与 shell 脚本、Git hooks 集成
• AI Agent 场景：结构化 JSON 输出便于自动化解析
• TickTick 重度用户：需批量任务处理、跨项目快速操作
• 无头服务器部署：支持手动 OAuth 模式完成服务端授权

常规风险

• 凭证泄露风险：明文存储的 token 文件若被系统入侵可读取（CVSS 2.5，Low）
• OAuth 授权范围：用户需确认授权页面权限范围，避免过度授权
• 限流导致失败：批量操作需控制频率，建议配合 --json 检查返回状态