在本技能目录执行命令。
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 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 "<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