核心用法
Todoist 集成通过 td CLI 工具实现，采用读写分离的同步策略：写入操作（add、done、edit、delete）直接调用 API 实时同步，读取操作（list、today、show）使用本地缓存保证速度，可通过 --sync 或 td sync 手动刷新。
主要功能覆盖任务全生命周期管理：
- 快速捕获：
td quick支持自然语言解析（如 "Buy milk tomorrow @errands #Personal"） - 结构化添加：
td add提供完整的优先级、截止日期、标签、项目、描述、子任务等参数 - 智能过滤：支持布尔逻辑（&、|、!）、优先级（p1-p4）、日期范围、标签、项目等多维组合筛选
- 批量操作：支持多 ID 完成、标签增减、跨项目移动等
显著优点
1. 零延迟写入：任务状态变更即时同步至云端，避免数据丢失
2. 缓存加速读取：本地缓存使查询响应极快，适合高频查看今日任务场景
3. 自然语言支持：快速添加无需记忆复杂参数
4. 高级过滤语法：媲美官方应用的过滤能力，支持复杂布尔表达式
5. 轻量依赖：单二进制文件，Homebrew 一键安装
潜在缺点与局限性
- 非官方工具：由社区开发者维护，存在 API 变更导致功能中断的风险
- 认证依赖：需配置 Todoist API Token，权限范围较宽（读写全部任务数据）
- 缓存一致性：读取 stale 数据的可能性，需手动
--sync或理解同步时机 - 功能边界：不支持附件上传、评论完整管理、团队协作高级功能
- 平台限制：目前仅支持 macOS/Linux（Homebrew/Cargo），Windows 需自行编译
适合人群
- 终端常驻开发者、Vim/Emacs 用户
- 追求键盘效率、反感 GUI 切换成本的效率工具爱好者
- 已有 Todoist 账户，希望将任务管理融入 Shell 工作流的用户
- 熟悉 GTD 方法论，需要快速捕获和上下文切换的进阶用户
常规风险
- Token 安全：API Token 存储于本地配置文件，需确保
~/.config/td/config.toml权限正确（建议 600） - 误操作不可逆：
delete和done --all-occurrences无二次确认，脚本调用需谨慎 - 网络依赖：写入操作需联网，离线场景下会失败而非队列化