用途：通过命令行管理 TickTick 的任务与项目，基于 TickTick Open API v1，适合脚本自动化和 AI 智能体调用。
授权：先在 TickTick 开发者中心注册应用，回调地址设为 http://localhost:8080，获取 Client ID 与 Client Secret。执行 bun run scripts/ticktick.ts auth --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET 开始 OAuth 流程；无头服务器可加 --manual，手动粘贴回调 URL。用 auth --status 查状态，auth --logout 清除令牌。令牌存于 ~/.clawdbot/credentials/ticktick-cli/config.json，明文保存，权限设为 700/600，应视为敏感文件，过期会自动刷新。
常用能力：tasks 列出任务（支持 --list 指定项目、--status pending/completed、--json）；task 创建或更新任务，可带 --content、--priority（none/low/medium/high）、--due（today、tomorrow、in N days、next monday、ISO 日期）、--tag、--list；complete 标记完成；abandon 标记不做；batch-abandon 一次放弃多个任务（须用 24 位十六进制任务 ID）；lists 列出项目；list 创建或更新项目（支持 --name、--color）。全局选项 --json 输出机器可读结果，--help 查看帮助。
适用场景：AI 智能体或脚本批量建任务、查任务、完成任务；建议先 lists --json 取项目 ID，尽量用 ID 而非名称，操作前先确认任务状态。
限制：速率限制为每分钟 100 次、每 5 分钟 300 次，单次操作可能发多次请求，批量易触限；每个项目最多 500 个任务；专注时长、习惯等高级功能 API 不支持；任务名匹配不区分大小写但需完全一致，找不到时改用任务 ID 或加 --list 缩小范围；报“Not authenticated”需重新授权。