核心功能与定位
dida365-cli 是一款面向滴答清单(Dida365/TickTick)用户的命令行工具,基于非官方私有 API 实现任务管理自动化。其核心功能覆盖完整的 GTD 工作流:项目与任务 CRUD、已完成任务按日期查询、标签体系管理、批量操作及全量数据同步,特别适合开发者构建自动化工作流或与其他工具链集成。
显著优点
自动化能力突出:支持通过 npx 快速调用,无需持久化安装;批量操作命令(batch 系列)可高效处理跨项目任务迁移、子任务关系设置、项目文件夹整理等复杂场景,显著提升批量处理效率。
数据查询灵活:已完成任务支持按日/周/自定义日期范围查询,并可指定时区输出,便于生成工作日报或进行时间审计;sync all 提供完整数据快照,支持本地备份与数据分析。
标签体系完整:实现标签的创建、嵌套、合并、重命名、颜色管理等全生命周期操作,弥补了官方客户端在标签批量管理上的不足。
潜在缺点与局限性
API 稳定性风险:明确标注基于非官方私有 API(api.dida365.com/api/v2),接口可能随时变更导致功能失效,存在维护不确定性。
认证方式受限:仅支持手动提取 Cookie Token 认证,无法使用 OAuth 等标准授权流程,Token 过期需重新配置,且存在凭证泄露风险。
功能边界限制:依赖官方未公开的 API,部分高级功能(如自定义视图、智能清单规则)可能无法覆盖;错误处理与限流机制未在文档中明确说明。
适合人群
- 熟悉命令行操作的开发者与技术用户
- 需要将滴答清单与其他工具(如 Obsidian、Notion、自动化脚本)集成的效率工具爱好者
- 有批量数据处理需求的项目经理或团队管理员
常规风险提示
账号安全风险:Cookie Token 相当于账号凭证,泄露可能导致数据泄露或恶意操作;建议存储于环境变量或密钥管理工具,避免硬编码。
数据操作风险:task delete、batch delete-tasks 等操作为不可逆物理删除,虽有确认提示,但批量场景下误操作后果严重,建议操作前执行 sync all 备份。
合规性注意:使用非官方 API 可能违反平台服务条款,存在账号限制风险,建议仅用于个人数据管理,避免高频调用或商业用途。