核心用法
dida365-cli 是一款面向滴答清单(Dida365/TickTick)用户的 Node.js 命令行工具,通过调用私有 REST API 实现任务管理自动化。使用前需通过 dida365 auth cookie <token> 设置 Cookie 认证,支持完整的 CRUD 操作:创建任务时可指定项目、优先级(0/1/3/5)、截止日期;通过 completed 子命令可按日期范围查询已完成任务并支持时区指定;sync all 可一次性拉取全量数据包括项目、标签、文件夹结构;标签系统支持嵌套、合并、批量删除等高级操作。
显著优点
1. 功能覆盖全面:相比官方 Open API,私有 API 支持更多字段(如子任务、看板视图、项目颜色等),无需注册开发者账号
2. 自动化友好:JSON 输出模式便于管道化处理,批量操作命令(batch move-task、batch delete-tasks)适合脚本集成
3. 跨平台运行:基于 Node.js,支持 Windows/macOS/Linux,npx 即开即用
4. 时区感知:已完成任务查询支持显式时区参数,避免跨时区统计误差
潜在缺点与局限性
1. 私有 API 风险:依赖非官方端点(api.dida365.com/api/v2),可能因服务端变更突然失效,无 SLA 保障
2. 认证方式脆弱:Cookie 认证需要手动从浏览器提取,存在过期风险,且可能因账号安全策略被重置
3. 删除操作不可逆:task delete 和 batch delete-projects 等操作无回收站机制,确认后数据永久丢失
4. 无冲突处理:全量同步为单向拉取,未提供本地缓存与服务器状态的合并策略
适合人群
- 开发者/工程师:需要将任务管理集成到 CI/CD 或日常脚本工作流
- 数据分析师:需要批量导出任务数据进行自定义统计
- 高级滴答用户:官方客户端功能不足,需要批量整理标签、归档历史项目
常规风险
- 账号安全:Cookie 泄露可能导致账号被恶意访问,建议仅使用只读权限的 Cookie 或在测试账号运行
- 数据完整性:批量操作缺乏预览机制,误操作可能造成大规模数据丢失
- 合规性:使用私有 API 可能违反服务条款,存在账号限制风险
- 依赖维护:开源项目(GitHub: oymy/dida365-ai-tools)更新频率不确定,需关注上游变更