ticktick-cli

说明：以下调用方式均以当前 SKILL.md 文件所在文件夹为 workdir。

• 常用子命令（覆盖日常场景）

• project

list

• get --project-id

• data --project-id

• create --name [--color --sort-order --view-mode --kind]

• update --project-id [--name --color --sort-order --view-mode --kind]

• delete --project-id（危险，删除前需谨慎确认）

• task

get --project-id --task-id

• create --project-id --title [--content --desc --all-day --start-date --due-date --time-zone --reminder --repeat --priority --sort-order --item]

• update --task-id --project-id [--title --content --desc --all-day --start-date --due-date --time-zone --reminder --repeat --priority --sort-order --item]

• complete --project-id --task-id

• delete --project-id --task-id（危险，删除前需谨慎确认）

• 输出格式

• 所有调用统一在脚本后、子命令前加 --json（示例：./scripts/ticktick_cli.py --json task get --project-id ...）

• 冷门参数/字段怎么查

• 运行 ./scripts/ticktick_cli.py <command> --help 查看该命令的参数

• 查看 references/dida365-openapi.md 了解完整参数、字段与响应结构

Dida365 概念模型

• Project：项目，任务的容器，支持不同视图模式（list/kanban/timeline）。

常用字段：

name（名称）

• color（颜色）

• viewMode（视图模式）

• kind（类型）

• groupId（分组）

• closed（是否关闭）

• permission（权限）

• sortOrder（排序）

• Task：任务，隶属于某个 Project，可包含提醒、优先级、重复规则等。

常用字段：

title（标题）

• content（内容）

• desc（描述/清单说明）

• tags（标签）

• priority（优先级）

• status（状态）

• startDate（开始时间）

• dueDate（截止时间）

• timeZone（时区）

• reminders（提醒）

• repeatFlag（重复规则）

• items（子任务列表）

• ChecklistItem：任务下的子任务（清单项），用于拆分步骤。

常用字段：

title（标题）

• status（状态）

• startDate（开始时间）

• completedTime（完成时间）

• timeZone（时区）

• sortOrder（排序）

• Column：项目看板列，用于 kanban 视图的列信息。

常用字段：

name（列名）

• sortOrder（排序）

• ProjectData：项目详情聚合，包含项目本身、未完成任务与列信息。

资源

• ticktick_cli.py：主 CLI 入口，负责读取配置并发起 API 调用。

• dida365-openapi.md：官方 Open API 文档快照，便于离线检索参数与字段。