ticktick-cli

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

说明：以下调用方式均以当前

SKILL.md

文件所在文件夹为 workdir。

脚本调用方式示例（不要用

uv run python

或

python

）：

bash

cd skills/ticktick-cli && ./scripts/ticktick_cli.py --json project list

错误示例：

bash

uv run python skills/ticktick-cli/scripts/ticktick_cli.py --json project list
python skills/ticktick-cli/scripts/ticktick_cli.py --json project list

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

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
```
了解完整参数、字段与响应结构

Note: All the following invocation methods take the folder where the current

SKILL.md

file is located as the workdir.

Example of script invocation method (do not use

uv run python

python

bash

cd skills/ticktick-cli && ./scripts/ticktick_cli.py --json project list

Incorrect example:

bash

uv run python skills/ticktick-cli/scripts/ticktick_cli.py --json project list
python skills/ticktick-cli/scripts/ticktick_cli.py --json project list

Common Subcommands (Covering Daily Scenarios)

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
```
(Dangerous, please confirm carefully before deletion)

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
```
(Dangerous, please confirm carefully before deletion)

Output Format

Add
```
--json
```
uniformly after the script and before the subcommand for all invocations (example:
```
./scripts/ticktick_cli.py --json task get --project-id ...
```
)

How to Check Uncommon Parameters/Fields

Run

./scripts/ticktick_cli.py <command> --help

to view the parameters of the command

Check
```
references/dida365-openapi.md
```
for complete parameters, fields, and response structures

Dida365 概念模型

Dida365 Concept Model

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：项目详情聚合，包含项目本身、未完成任务与列信息。

Project: A container for tasks, supporting different view modes (list/kanban/timeline).
- Common fields:
  - ```
  name
```
  (Name)
- ```
color
```
    (Color)
  - ```
  viewMode
```
  (View Mode)
- ```
kind
```
    (Type)
  - ```
  groupId
```
  (Group ID)
- ```
closed
```
    (Is Closed)
  - ```
  permission
```
  (Permission)
- ```
sortOrder
```
    (Sort Order)
Task: Belongs to a certain Project, can include reminders, priorities, repeat rules, etc.
- Common fields:
  - ```
  title
```
  (Title)
- ```
content
```
    (Content)
  - ```
  desc
```
  (Description/Checklist Note)
- ```
tags
```
    (Tags)
  - ```
  priority
```
  (Priority)
- ```
status
```
    (Status)
  - ```
  startDate
```
  (Start Date)
- ```
dueDate
```
    (Due Date)
  - ```
  timeZone
```
  (Time Zone)
- ```
reminders
```
    (Reminders)
  - ```
  repeatFlag
```
  (Repeat Rule)
- ```
items
```
    (Subtask List)
ChecklistItem: Subtask (checklist item) under a task, used to split steps.
- Common fields:
  - ```
  title
```
  (Title)
- ```
status
```
    (Status)
  - ```
  startDate
```
  (Start Date)
- ```
completedTime
```
    (Completion Time)
  - ```
  timeZone
```
  (Time Zone)
- ```
sortOrder
```
    (Sort Order)
Column: Project kanban column, used for column information in kanban view.
- Common fields:
  - ```
  name
```
  (Column Name)
- ```
sortOrder
```
    (Sort Order)
ProjectData: Project detail aggregation, including the project itself, incomplete tasks, and column information.

资源

Resources

ticktick_cli.py：主 CLI 入口，负责读取配置并发起 API 调用。
dida365-openapi.md：官方 Open API 文档快照，便于离线检索参数与字段。

ticktick_cli.py: Main CLI entry point, responsible for reading configurations and initiating API calls.
dida365-openapi.md: Snapshot of the official Open API documentation, facilitating offline retrieval of parameters and fields.