ticktick-official-cli

---

name: ticktick-official-cli description: 使用官方 Dida365 OAuth 与 Open API 管理滴答清单（项目/任务查询、创建、更新、完成、删除）。当用户要求安全地直连 dida365.com（不经过第三方 OAuth 中转）时使用。

---

在本技能目录执行命令。

Onboarding（最少手动步骤）

1. 在 Dida365 开发者中心创建应用：https://developer.dida365.com/manage 2. 在应用里配置回调地址：http://127.0.0.1:8765/callback 3. 一次性保存应用配置：

./scripts/ticktick_oauth.py setup \
  --client-id "" \
  --client-secret "" \
  --redirect-uri "http://127.0.0.1:8765/callback"

4. 一键登录（自动打开浏览器授权、自动换 token、自动保存 token）：

./scripts/ticktick_oauth.py login

5. 验证：

./scripts/ticktick_cli.py doctor
./scripts/ticktick_cli.py --json project list

> token 会自动保存到 ~/.config/ticktick-official/token.env，后续一般不需要再手动 export。

备用流程（手动）

./scripts/ticktick_oauth.py auth-url --client-id "$TICKTICK_CLIENT_ID" --redirect-uri "$TICKTICK_REDIRECT_URI"
./scripts/ticktick_oauth.py exchange --code ""

常用命令

# 项目
./scripts/ticktick_cli.py --json project list
./scripts/ticktick_cli.py --json project create --name "收件箱"
任务
./scripts/ticktick_cli.py --json task create --project-id  --title "测试任务"
./scripts/ticktick_cli.py --json task complete --project-id  --task-id 

说明

始终优先使用官方域名：dida365.com / api.dida365.com

删除操作（project/task delete）属于危险操作，执行前确认

参数与字段细节见 references/dida365-openapi.md