核心用法
Dida CLI 是滴答清单的官方命令行工具,基于 Node.js 开发,允许用户通过终端直接管理任务、项目和日程。
安装与认证
- 全局安装:
npm install -g @suibiji/dida-cli - 首次使用需 OAuth PKCE 浏览器登录:
dida auth login - 支持 API Token 模式用于无头环境:
dida auth token <token>
典型工作流
| 场景 | 命令 |
|------|------|
| 列出项目 | `dida project list --json` |
| 创建任务 | `dida task create --title "..." --project <id>` |
| 完成任务 | `dida task complete <projectId> <taskId>` |
| 跨项目移动 | `dida task move --from <src> --to <dst> --task <id>` |
所有 list/get 操作支持 --json 输出,便于脚本解析和程序化筛选。
显著优点
1. 自动化友好:JSON 模式、标准 CLI 接口,易于集成到 CI/CD 或脚本工作流
2. 功能完整:覆盖任务生命全周期(创建、更新、完成、删除、移动)
3. 灵活认证:同时支持浏览器 OAuth 和 API Token,兼顾交互与自动化场景
4. 安全设计:PKCE 流程、Token 本地存储,无密码明文传输
潜在局限
- 依赖 Node 生态:需维护 npm/Node 环境,对非技术用户有门槛
- 无离线模式:所有操作依赖滴答清单云服务,网络中断即不可用
- 权限粒度粗:API Token 拥有完整读写权限,无法细粒度授权
- 第三方封装:
@suibiji/dida-cli为社区封装,非滴答官方直接维护
适合人群
- 开发者与效率极客,习惯终端操作
- 需要将滴答清单集成到自动化脚本或工作流的用户
- 多项目管理场景下需要批量操作的高级用户
常规风险
- Token 泄露风险:API Token 需妥善保管,避免硬编码提交至代码仓库
- 误操作不可逆:删除操作无回收站二次确认,建议操作前使用
--json预览 - OAuth 会话过期:长期无人值守脚本需监控
auth status并配置重登机制