核心用法
dida365-cli 是一款基于 Node.js 的命令行工具,通过逆向 Dida365(滴答清单)私有 API 实现完整的任务管理功能。用户需先通过 Cookie Token 完成认证,即可在终端执行项目、任务、标签的全生命周期管理,涵盖创建、查询、修改、删除、批量操作等场景。核心功能模块包括:
- 认证管理:Cookie Token 一键登录,状态实时检查
- 项目操作:列表查看、详情展示,支持 JSON 格式输出便于管道处理
- 任务管理:创建任务时可指定项目、内容、优先级(0/1/3/5)、截止日期;支持单任务完成/删除及危险操作二次确认
- 已完成任务查询:按今天、昨天、本周、指定日期或日期范围筛选,支持时区自定义与 JSON 导出
- 全量同步:一次性拉取所有项目、任务、标签、文件夹及用户设置,适合数据备份与离线分析
- 标签系统:完整支持创建、重命名、改色、嵌套层级、合并、批量删除等高级操作
- 批量操作:任务跨项目移动、子任务关系设置、任务批量删除;项目及文件夹的批量创建与删除
显著优点
1. 功能覆盖全面:相比官方 Open API 的受限能力,私有 API 实现几乎全量功能,无需注册开发者账号
2. 自动化友好:CLI 设计天然适配 Shell 脚本、CI/CD 流水线、定时任务等自动化场景
3. 数据可移植:JSON 输出格式便于与 jq、Python、数据库等工具链集成,实现自定义报表与数据分析
4. 批量效率:标签合并、任务批量迁移等高级操作在 GUI 中耗时费力,CLI 可秒级完成
5. 配置极简:单条 Cookie 认证即可使用,免去 OAuth 2.0 等复杂授权流程
潜在缺点与局限性
- 稳定性风险:依赖非官方私有 API,Dida365 服务端变更可能导致功能中断,无 SLA 保障
- 安全合规隐患:Cookie 认证方式需抓取浏览器请求,存在 Token 泄露风险;不符合 OAuth 安全最佳实践
- 功能边界模糊:API 端点随时可能调整,部分高级功能(如看板列操作)文档标注不完整
- 无官方支持:出现问题无法联系滴答清单官方客服,社区维护依赖度高
- 平台限制:仅支持 Node.js 环境,Windows 用户需额外配置终端工具
适合人群
- 开发者与工程师:习惯终端工作流,需要将任务管理集成到开发工具链
- 自动化需求用户:希望基于任务完成状态触发 CI/CD、生成日报、同步至 Notion 等第三方系统
- 数据敏感型用户:需要定期全量备份任务数据,避免云端单点故障
- 高级效率工具用户:标签体系复杂、项目层级深,GUI 操作效率成为瓶颈的重度用户
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| Token 泄露 | Cookie 明文存储于本地配置文件 | 使用系统密钥管理服务,定期轮换 Token |
| 误操作数据丢失 | `delete` 与 `batch delete` 为不可逆操作 | 操作前执行 `sync all` 备份,启用二次确认 |
| API 变更导致失效 | 私有 API 无版本控制 | 关注项目 GitHub Release,锁定工具版本 |
| 速率限制 | 高频调用可能触发服务端限流 | 批量操作添加延迟,避免并发高峰 |
| 账号安全 | 异常登录模式可能触发风控 | 控制调用频率,避免多 IP 高频请求 |