Marketplace ticktick-cli

使用 Python CLI 与 Dida365 Open API 交互以管理滴答清单任务/项目，适用于需要通过脚本或命令行调用滴答清单接口的场景（如项目/任务的查询、创建、更新、完成、删除）。

install

source · Clone the upstream repo

git clone https://github.com/aiskillstore/marketplace

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/aiskillstore/marketplace "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/dcjanus/ticktick-cli" ~/.claude/skills/aiskillstore-marketplace-ticktick-cli && rm -rf "$T"

manifest: skills/dcjanus/ticktick-cli/SKILL.md

source content

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

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 文档快照，便于离线检索参数与字段。