royxue

dida365-cli

滴答清单 (Dida365) CLI 工具 - 原生支持中文滴答清单,查看任务、设置优先级、管理项目。专为 OpenClaw 优化。

royxue 4 Updated 2mo ago

Resources

6
GitHub

Install

npx skillscat add royxue/dida365-cli

Install via the SkillsCat registry.

SKILL.md

Dida365 CLI

滴答清单 (Dida365) 的命令行工具,原生支持中文滴答清单

特性

  • ✅ 原生支持 dida365.com(中文滴答清单)
  • ✅ 完整的 Node.js 支持(无需 Bun)
  • ✅ 查看/创建/完成任务
  • ✅ 设置优先级和截止日期
  • ✅ 项目管理

安装

# 安装依赖
cd skills/dida365-cli
npm install

# 认证(仅需一次)
npx tsx scripts/dida.ts auth --client-id YOUR_ID --client-secret YOUR_SECRET

快速开始

# 查看收集箱
npx tsx scripts/dida.ts inbox

# 查看项目列表
npx tsx scripts/dida.ts lists

# 查看指定项目的任务
npx tsx scripts/dida.ts tasks --list "生活杂事"

# 创建任务
npx tsx scripts/dida.ts task "新任务" --list "生活杂事" --priority high --due tomorrow

# 完成任务
npx tsx scripts/dida.ts complete "任务名称"

命令参考

inbox - 查看收集箱

npx tsx scripts/dida.ts inbox

lists - 查看项目列表

npx tsx scripts/dida.ts lists
npx tsx scripts/dida.ts lists --json

tasks - 查看任务

npx tsx scripts/dida.ts tasks                    # 所有任务
npx tsx scripts/dida.ts tasks --list "工作"      # 指定项目
npx tsx scripts/dida.ts tasks --status pending   # 待办
npx tsx scripts/dida.ts tasks --status completed # 已完成

task - 创建/更新任务

# 创建任务
npx tsx scripts/dida.ts task "任务标题" --list "项目名"

# 带详细信息的任务
npx tsx scripts/dida.ts task "任务标题" \
  --list "项目名" \
  --content "详细描述" \
  --priority high \
  --due "2024-12-25"

# 更新任务
npx tsx scripts/dida.ts task "任务ID" --update --priority high

complete - 完成任务

npx tsx scripts/dida.ts complete "任务名称"
npx tsx scripts/dida.ts complete 任务ID

move - 移动任务到其他项目 ⚠️

⚠️ 重要提示:滴答清单 Open API 不支持直接移动任务。此命令通过**"删除+重建"**模拟移动,会丢失部分数据。

# 移动任务到另一个项目
npx tsx scripts/dida.ts move "任务名称" "目标项目名"
npx tsx scripts/dida.ts move 任务ID "目标项目名"

会丢失的数据:

  • 原任务创建时间
  • 任务历史记录
  • 评论和附件(如有)

保留的数据:

  • 标题、内容、描述
  • 优先级
  • 截止日期
  • 标签
  • 完成状态

建议:如果任务有重要历史记录或附件,请在 App 中手动拖拽移动

auth - 认证管理

# 首次认证
npx tsx scripts/dida.ts auth --client-id ID --client-secret SECRET

# 查看认证状态
npx tsx scripts/dida.ts auth --status

# 登出
npx tsx scripts/dida.ts auth --logout

日期格式

  • today - 今天
  • tomorrow - 明天
  • in 3 days - 3天后
  • 2024-12-25 - 具体日期

优先级

  • none - 无(默认)
  • low - 低
  • medium - 中
  • high - 高

已知限制

任务移动限制

滴答清单 Open API 原生不支持移动任务到其他项目。本工具通过**"删除+重建"**模拟实现:

  • ✅ 可以通过 move 命令移动任务
  • ⚠️ 但会丢失:创建时间、历史记录、评论、附件
  • 💡 建议:有重要数据的任务请在 App 中手动拖拽移动

其他限制

  • 最多 500 个任务/项目
  • 部分高级功能(专注时间、习惯)API 不支持
  • 请求频率限制:100次/分钟,300次/5分钟

配置

认证信息存储在:

~/.clawdbot/credentials/dida365-cli/config.json

与 ticktick-cli 的区别

功能 ticktick-cli dida365-cli
支持平台 ticktick.com dida365.com
Node.js 需修改 原生支持
中文优化 一般 专为中文优化

License

MIT