- name
- ticktick-official-cli
- description
- 使用官方 Dida365 OAuth 与 Open API 管理滴答清单（项目/任务查询、创建、更新、完成、删除）。当用户要求安全地直连 dida365.com（不经过第三方 OAuth 中转）时使用。
在本技能目录执行命令。
Onboarding（最少手动步骤）
- 在 Dida365 开发者中心创建应用：
https://developer.dida365.com/manage - 在应用里配置回调地址：
http://127.0.0.1:8765/callback - 一次性保存应用配置：
./scripts/ticktick_oauth.py setup \
--client-id "<client_id>" \
--client-secret "<client_secret>" \
--redirect-uri "http://127.0.0.1:8765/callback"- 一键登录（自动打开浏览器授权、自动换 token、自动保存 token）：
./scripts/ticktick_oauth.py login- 验证：
./scripts/ticktick_cli.py doctor
./scripts/ticktick_cli.py --json project listtoken 会自动保存到~/.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 "<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 <pid> --title "测试任务"
./scripts/ticktick_cli.py --json task complete --project-id <pid> --task-id <tid>说明
- 始终优先使用官方域名：
dida365.com/api.dida365.com - 删除操作（project/task delete）属于危险操作，执行前确认
- 参数与字段细节见
references/dida365-openapi.md