核心用法
rtm 是 Remember The Milk 的官方/半官方命令行管理工具，封装了 RTM REST API 的全部核心能力。用户通过 scripts/rtm.py 脚本即可在终端完成任务的增删改查、优先级调整、标签管理、跨列表迁移及笔记注释。
关键特性：
- Smart Add 解析：
--parse参数支持自然语言快速创建任务，如"Buy milk ^tomorrow #shopping !1"自动识别日期、标签、优先级 - 完整任务字段操作：优先级（1-3/N）、截止日期（自然语言）、标签批量添加、任务移动、笔记附加
- RTM 高级过滤语法：支持
status:incomplete、dueBefore:tomorrow、addedWithin:"1 week"等复杂查询，可与AND/OR/NOT组合 - 零外部依赖：仅使用 Python 标准库，避免 pip 生态的供应链风险
- 交互式 OAuth 授权：
auth子命令引导用户完成一次性授权，token 持久化至~/.rtm_token
可靠性机制：
- 15 秒 API 超时 + 自动退避重试（最多 3 次）
- 写操作自动创建 timeline，避免重复提交
- 瞬时网络错误自动恢复，永久性 API 错误立即退出
显著优点
- 官方 API 直连：数据与 Remember The Milk 云端实时同步，可靠性高于第三方爬虫方案
- 脚本化友好：输出格式包含
list/series/task/note等 ID，便于管道化处理和自动化脚本 - 子代理兼容：明确处理环境变量继承问题，适合 agent 工作流中嵌套调用
潜在缺点与局限性
- 依赖 RTM 服务可用性：云端单点故障将完全阻断功能
- OAuth 授权门槛：需手动申请 API Key/Secret，对非技术用户不够友好
- 无离线模式：所有操作需联网，网络中断时无法缓存待同步任务
- Smart Add 语法学习成本：虽强大但需记忆
^ ! #等符号含义
适合人群
- 已使用 Remember The Milk 的重度 GTD 实践者
- 需要将任务管理集成至本地开发工作流的技术人员
- 偏好终端环境、追求自动化脚本效率的极简主义者
常规风险
- 凭证管理：
RTM_API_KEY/RTM_SHARED_SECRET需妥善保管，泄露可能导致账户数据被访问 - Token 文件权限：
~/.rtm_token需限制文件系统权限，避免多用户环境泄露 - 误操作不可逆：
delete操作无二次确认，脚本调用时需额外校验