核心用法
Dida CLI (@suibiji/dida-cli) 是滴答清单的官方命令行工具，面向需要将任务管理集成到终端工作流的开发者与高级用户。核心能力覆盖安装配置、OAuth PKCE 认证、项目与任务的完整生命周期管理。
安装与认证
- 安装：通过
npm install -g @suibiji/dida-cli全局安装，需 Node.js LTS 环境 - 登录：执行
dida auth login触发浏览器 OAuth 流程，支持dida auth status校验状态 - 安全设计：采用 OAuth PKCE 标准，令牌本地存储，无密码暴露风险
核心工作流
| 场景 | 关键命令 |
|------|---------|
| 项目列表 | `dida project list --json` |
| 创建任务 | `dida task create --title "..." --project <id>` |
| 更新任务 | `dida task update <taskId> ...` |
| 完成任务 | `dida task complete <projectId> <taskId>` |
| 移动任务 | `dida task move --from ... --to ... --task ...` |
显著优点
1. 官方生态：直接对接滴答清单 API，数据同步可靠
2. JSON 输出：所有列表操作支持 --json，便于脚本化与自动化
3. 安全认证：OAuth PKCE 流程，无需硬编码凭据
4. ID 严谨性：强制要求通过 project list --json 解析真实 ID，禁止猜测
潜在局限
- Node.js 依赖：非 Node 环境需额外配置
- 浏览器依赖：登录必须唤起浏览器，无纯终端认证方案
- 功能边界：不包含批量导入/导出、标签管理等高级功能
- 网络敏感：OAuth 回调与 API 调用均需稳定网络
适合人群
- 习惯终端操作的开发者与技术用户
- 需要自动化任务创建（如 CI/CD 集成、定时脚本）的场景
- 追求滴答清单数据本地脚本化管理的效率用户
常规风险
- Token 过期：需重新执行
dida auth login - 误删风险：
task delete为不可逆操作，建议先预览再执行 - 项目同名：多个同名项目时需人工确认目标