说明:以下调用方式均以 dida365 为 CLI 入口。
安装后直接使用:
CODEBLOCK0
1. 认证
使用前必须先设置 Cookie 认证。
CODEBLOCK1
2. 项目管理
CODEBLOCK2
3. 任务管理
CODEBLOCK3
参数说明:
- -
-p, --project <projectId> — 项目 ID(必填) - INLINECODE2 — 任务标题(update 时可选)
- INLINECODE3 — 任务内容
- INLINECODE4 — 截止日期(ISO 8601)
- INLINECODE5 — 优先级:0=无, 1=低, 3=中, 5=高
- INLINECODE6 — JSON 格式输出
4. 已完成任务查询
CODEBLOCK4
5. 全量同步与用户设置
CODEBLOCK5
INLINECODE7 返回的数据结构:
- -
projects — 项目列表 - INLINECODE9 — 所有未完成任务
- INLINECODE10 — 标签列表
- INLINECODE11 — 项目文件夹
- INLINECODE12 — 收件箱项目 ID
6. 标签管理
CODEBLOCK6
7. 批量操作
任务批量操作
CODEBLOCK7
项目批量操作
CODEBLOCK8
项目文件夹操作
CODEBLOCK9
Dida365 概念模型
- 常用字段:
id,
name,
color,
viewMode(list/kanban/timeline),
kind(TASK/NOTE),
groupId,
closed,
permission,
sortOrder
- 常用字段:
id,
projectId,
title,
content,
desc,
tags,
priority(0/1/3/5),
status(0=未完成,2=已完成),
startDate,
dueDate,
timeZone,
reminders,
repeatFlag,
items(子任务),
completedTime,
parentId
- - SubTask / ChecklistItem:子任务。
- 常用字段:
id,
title,
status(0/1),
completedTime,
sortOrder
- 常用字段:
name,
color,
parent,
sortOrder,
sortType
- - ProjectGroup:项目文件夹,用于组织项目。
- 常用字段:
id,
name,
sortOrder
- - Column:看板列,用于 kanban 视图。
- 常用字段:
id,
projectId,
name, INLINECODE54
私有 API 端点参考
以下端点基于 https://api.dida365.com/api/v2,非官方,可能随时变更:
| HTTP | Endpoint | 功能 |
|---|
| GET | INLINECODE56 | 用户设置 |
| GET |
/batch/check/0 | 全量同步 |
| GET |
/project/all/completed?from=&to=&limit= | 按日期查询已完成任务 |
| POST |
/batch/task | 批量任务操作 |
| POST |
/batch/taskParent | 设置子任务关系 |
| POST |
/batch/taskProject | 移动任务 |
| POST |
/batch/project | 批量项目操作 |
| POST |
/batch/projectGroup | 项目文件夹操作 |
| POST |
/batch/tag | 批量标签操作 |
| PUT |
/tag/rename | 重命名标签 |
| PUT |
/tag/merge | 合并标签 |
| DELETE |
/tag?name= | 删除标签 |
为什么不用 Open API
Dida365 提供了 Open API,但其功能是私有 API 的子集,且需要注册开发者应用。本项目选择使用私有 API + Cookie 认证,覆盖更全面、配置更简单。
资源
技能名称: dida365-cli
详细描述:
说明:以下调用方式均以 dida365 为 CLI 入口。
安装后直接使用:
bash
npx(推荐)
npx dida365
[options]
或全局安装后
npm install -g dida365-ai-tools
dida365 [options]
1. 认证
使用前必须先设置 Cookie 认证。
bash
dida365 auth cookie # 设置 Cookie token 完成认证
dida365 auth status # 检查当前认证状态
2. 项目管理
bash
dida365 project list # 列出所有项目
dida365 project list --json # JSON 格式输出
dida365 project show # 查看项目详情和任务列表
dida365 project show --json
3. 任务管理
bash
创建任务
dida365 task create -p
dida365 task create -p -c --priority <0|1|3|5> -d
查看任务
dida365 task show
dida365 task show --json
更新任务
dida365 task update -p -t
dida365 task update -p -c --priority <0|1|3|5> -d
完成任务
dida365 task complete
删除任务(危险操作,删除前需确认)
dida365 task delete
参数说明:
- - -p, --project — 项目 ID(必填)
- -t, --title — 任务标题(update 时可选)
- -c, --content — 任务内容
- -d, --due — 截止日期(ISO 8601)
- --priority — 优先级:0=无, 1=低, 3=中, 5=高
- -j, --json — JSON 格式输出
4. 已完成任务查询
bash
dida365 completed today # 今天完成的
dida365 completed yesterday # 昨天完成的
dida365 completed week # 本周完成的
dida365 completed date # 指定日期
dida365 completed range # 日期范围
dida365 completed today --timezone Asia/Shanghai # 指定时区
dida365 completed today --json # JSON 输出
5. 全量同步与用户设置
bash
dida365 sync all # 一次拉取所有项目、任务、标签、文件夹
dida365 sync all --json
dida365 sync settings # 查看用户设置(时区、日期格式等)
dida365 sync settings --json
dida365 sync timezone # 快速获取用户时区
sync all 返回的数据结构:
- - projects — 项目列表
- tasks — 所有未完成任务
- tags — 标签列表
- projectGroups — 项目文件夹
- inboxId — 收件箱项目 ID
6. 标签管理
bash
dida365 tag list # 列出所有标签
dida365 tag list --json
dida365 tag create # 创建标签
dida365 tag create --color #ff0000 --parent
dida365 tag rename # 重命名
dida365 tag color # 修改颜色
dida365 tag nest # 设置父标签(层级关系)
dida365 tag merge # 合并标签(fromTag 任务归入 toTag)
dida365 tag delete [name2...] # 删除(支持多个)
7. 批量操作
任务批量操作
bash
移动任务到其他项目
dida365 batch move-task
设置子任务关系
dida365 batch set-subtask
批量删除任务(格式:taskId:projectId)
dida365 batch delete-tasks [taskId2:projectId2 ...]
项目批量操作
bash
dida365 batch create-project # 创建项目
dida365 batch create-project --color #ff0000 --group --view kanban
dida365 batch delete-projects [projectId2 ...] # 危险,需确认
项目文件夹操作
bash
dida365 batch create-folder # 创建文件夹
dida365 batch delete-folders [groupId2 ...]
Dida365 概念模型
- 常用字段:id, name, color, viewMode(list/kanban/timeline), kind(TASK/NOTE), groupId, closed, permission, sortOrder
- 常用字段:id, projectId, title, content, desc, tags, priority(0/1/3/5), status(0=未完成,2=已完成), startDate, dueDate, timeZone, reminders, repeatFlag, items(子任务), completedTime, parentId
- - SubTask / ChecklistItem:子任务。
- 常用字段:id, title, status(0/1), completedTime, sortOrder
- 常用字段:name, color, parent, sortOrder, sortType
- - ProjectGroup:项目文件夹,用于组织项目。
- 常用字段:id, name, sortOrder
- - Column:看板列,用于 kanban 视图。
- 常用字段:id, projectId, name, sortOrder
私有 API 端点参考
以下端点基于 https://api.dida365.com/api/v2,非官方,可能随时变更:
| HTTP | Endpoint | 功能 |
|---|
| GET | /user/preferences/settings | 用户设置 |
| GET |
/batch/check/0 | 全量同步 |
| GET | /project/all/completed?from=&to=&limit= | 按日期查询已完成任务 |
| POST | /batch/task | 批量任务操作 |
| POST | /batch/taskParent | 设置子任务关系 |
| POST | /batch/taskProject | 移动任务 |
| POST | /batch/project | 批量项目操作 |
| POST | /batch/projectGroup | 项目文件夹操作 |
| POST | /batch/tag | 批量标签操作 |
| PUT | /tag/rename | 重命名标签 |
| PUT | /tag/merge | 合并标签 |
| DELETE | /tag?name= | 删除标签 |
为什么不用 Open API
Dida365 提供了 Open API,但其功能是私有 API 的子集,且需要注册开发者应用。本项目选择使用私有 API + Cookie 认证,覆盖更全面、配置更简单。
资源