Dida365 Cli

Name: Dida365 Cli
Author: oymy

功能描述

使用 Node.js CLI 管理滴答清单（Dida365）的任务、项目、标签等，支持已完成任务按日期查询、全量同步、标签管理、批量操作等，适用于日常任务管理与自动化场景。

使用说明 (SKILL.md)

说明：以下调用方式均以 dida365 为 CLI 入口。

安装后直接使用：

# npx（推荐）
npx dida365 \x3Ccommand> [options]

# 或全局安装后
npm install -g dida365-ai-tools
dida365 \x3Ccommand> [options]

1. 认证

使用前必须先设置 Cookie 认证。

dida365 auth cookie \x3Ctoken>     # 设置 Cookie token 完成认证
dida365 auth status             # 检查当前认证状态

2. 项目管理

dida365 project list                    # 列出所有项目
dida365 project list --json             # JSON 格式输出
dida365 project show \x3CprojectId>        # 查看项目详情和任务列表
dida365 project show \x3CprojectId> --json

3. 任务管理

# 创建任务
dida365 task create \x3Ctitle> -p \x3CprojectId>
dida365 task create \x3Ctitle> -p \x3CprojectId> -c \x3Ccontent> --priority \x3C0|1|3|5> -d \x3CdueDate>

# 查看任务
dida365 task show \x3CtaskId>
dida365 task show \x3CtaskId> --json

# 更新任务
dida365 task update \x3CtaskId> -p \x3CprojectId> -t \x3CnewTitle>
dida365 task update \x3CtaskId> -p \x3CprojectId> -c \x3Ccontent> --priority \x3C0|1|3|5> -d \x3CdueDate>

# 完成任务
dida365 task complete \x3CprojectId> \x3CtaskId>

# 删除任务（危险操作，删除前需确认）
dida365 task delete \x3CprojectId> \x3CtaskId>

参数说明：

-p, --project \x3CprojectId> — 项目 ID（必填）
-t, --title \x3Ctitle> — 任务标题（update 时可选）
-c, --content \x3Ccontent> — 任务内容
-d, --due \x3Cdate> — 截止日期（ISO 8601）
--priority \x3Cn> — 优先级：0=无, 1=低, 3=中, 5=高
-j, --json — JSON 格式输出

4. 已完成任务查询

dida365 completed today                              # 今天完成的
dida365 completed yesterday                          # 昨天完成的
dida365 completed week                               # 本周完成的
dida365 completed date \x3CYYYY-MM-DD>                  # 指定日期
dida365 completed range \x3CstartDate> \x3CendDate>        # 日期范围
dida365 completed today --timezone "Asia/Shanghai"   # 指定时区
dida365 completed today --json                       # JSON 输出

5. 全量同步与用户设置

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. 标签管理

dida365 tag list                            # 列出所有标签
dida365 tag list --json
dida365 tag create \x3Cname>                   # 创建标签
dida365 tag create \x3Cname> --color "#ff0000" --parent \x3CparentTag>
dida365 tag rename \x3ColdName> \x3CnewName>      # 重命名
dida365 tag color \x3Cname> \x3Ccolor>            # 修改颜色
dida365 tag nest \x3Cname> \x3CparentTag>         # 设置父标签（层级关系）
dida365 tag merge \x3CfromTag> \x3CtoTag>         # 合并标签（fromTag 任务归入 toTag）
dida365 tag delete \x3Cname1> [name2...]       # 删除（支持多个）

7. 批量操作

任务批量操作

# 移动任务到其他项目
dida365 batch move-task \x3CtaskId> \x3CfromProjectId> \x3CtoProjectId>

# 设置子任务关系
dida365 batch set-subtask \x3CtaskId> \x3CparentId> \x3CprojectId>

# 批量删除任务（格式：taskId:projectId）
dida365 batch delete-tasks \x3CtaskId1:projectId1> [taskId2:projectId2 ...]

项目批量操作

dida365 batch create-project \x3Cname>                 # 创建项目
dida365 batch create-project \x3Cname> --color "#ff0000" --group \x3CgroupId> --view kanban
dida365 batch delete-projects \x3CprojectId1> [projectId2 ...]  # 危险，需确认

项目文件夹操作

dida365 batch create-folder \x3Cname>                  # 创建文件夹
dida365 batch delete-folders \x3CgroupId1> [groupId2 ...]

Dida365 概念模型

Project：项目，任务的容器。
- 常用字段：id, name, color, viewMode(list/kanban/timeline), kind(TASK/NOTE), groupId, closed, permission, sortOrder
Task：任务，隶属于某个 Project。
- 常用字段：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
Tag：标签，可嵌套。
- 常用字段：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 认证，覆盖更全面、配置更简单。

资源

项目源码：GitHub
私有 API 实现参考：ticktick-py

安全使用建议

This skill's instructions are consistent with a CLI that talks to Dida365 via private APIs, but it asks you to download and run code from npm (via npx/npm) and to supply your session Cookie. Before installing or running it: 1) Inspect the npm package and the linked GitHub repo (https://github.com/oymy/dida365-ai-tools) to confirm the code is legitimate and review how it stores/transmits your cookie; 2) Prefer using a scoped API token or a throwaway account if possible—do not paste your primary session cookie unless you trust the package and maintainer; 3) Verify the package version and publisher on the npm registry; 4) Be cautious with destructive commands (delete, batch delete) and back up important data; 5) If you need higher assurance, request an explicit install spec or a packaged binary from a verified source, or use the official Open API and developer app flow instead. Additional information that would raise confidence: a registry homepage/source field, a pinned package version in the skill metadata, and explicit guidance on how the CLI stores and transmits authentication tokens.

功能分析

Type: OpenClaw Skill Name: dida365-cli Version: 3.0.3 The skill describes a CLI tool for managing Dida365 tasks, projects, and tags. All operations detailed in SKILL.md are consistent with a legitimate task management utility, including authentication via a cookie token and interaction with the official Dida365 API endpoints (api.dida365.com). There is no evidence of prompt injection attempts against the AI agent, data exfiltration to unauthorized domains, malicious execution, persistence mechanisms, or obfuscation. The external links provided are for the project's GitHub repository and a reference implementation, indicating transparency.

能力评估

ℹ Purpose & Capability

The name/description match the runtime instructions: the document describes a Node.js CLI for Dida365 and lists commands and private API endpoints consistent with that purpose. However, registry metadata lists no homepage/source while SKILL.md includes a GitHub link and an npm package name (dida365-ai-tools) — the lack of an authoritative source entry in the registry is a minor inconsistency.

⚠ Instruction Scope

The SKILL.md tells users/agents to run npx or npm to fetch and run a remote CLI, and to provide a Cookie token via 'dida365 auth cookie <token>'. Asking for a session cookie (a sensitive authentication artifact) and instructing to run remote code increase the risk of credential exposure or unexpected behavior. The instructions also include destructive operations (delete task/project) which are expected but dangerous if run without confirmation. The skill does not explicitly state where the cookie comes from, how it is stored, or what the CLI does with it.

ℹ Install Mechanism

There is no explicit install spec in the skill bundle; instead SKILL.md recommends 'npx dida365' or 'npm install -g dida365-ai-tools'. Using npx/npm is common and traceable to the npm registry/GitHub, but it still causes remote code to be downloaded and executed at runtime. Because the skill does not pin or verify a specific package source/version in the registry metadata, this is a moderate risk and requires the user to verify the npm package and repository before executing.

ℹ Credentials

The skill declares no required environment variables or config paths (coherent), but it depends on a session Cookie for authentication. Requiring the user's session cookie is proportionate to a private-API-based CLI, but cookies are highly sensitive and can grant full account access; the skill does not provide guidance for scoping or safely obtaining a limited credential (e.g., using an API token or a throwaway account).

✓ Persistence & Privilege

The skill is not always-enabled and is user-invocable (normal). It does not request system-wide config access or other skills' credentials. There is no indication it requires elevated or persistent platform privileges.

版本历史

v3.0.3

MCP 与 CLI 功能对齐：新增 task update CLI、completed yesterday MCP、get timezone MCP

v3.0.2

代码质量加固：安全性、输入校验、MCP 工具重构、时区转换、清理无用文件

v3.0.0

v3.0.0: Unified to Private API + Cookie auth

元数据

Slug dida365-cli

版本 3.0.3

许可证 —

累计安装 5

当前安装数 5

历史版本数 3

常见问题

Dida365 Cli 是什么？

使用 Node.js CLI 管理滴答清单（Dida365）的任务、项目、标签等，支持已完成任务按日期查询、全量同步、标签管理、批量操作等，适用于日常任务管理与自动化场景。它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 1020 次。

如何安装 Dida365 Cli？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install dida365-cli」即可一键安装，无需额外配置。

Dida365 Cli 是免费的吗？

是的，Dida365 Cli 完全免费（开源免费），可自由下载、安装和使用。

Dida365 Cli 支持哪些平台？

Dida365 Cli 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Dida365 Cli？

由 oymy（@oymy）开发并维护，当前版本 v3.0.3。