用途:驱动 Things 3(任务、项目、区域)。优先在有命令行访问时使用 things CLI,它直接读写本地数据库,速度快且无需网络往返。无 CLI 时依次回退到:已连接的 Things MCP(可跨设备完整读写)、things:/// URL scheme(任何装有 Things 的设备,只写)、邮件到 Things(无人值守,仅收件箱捕获)。
选择方式:有命令行访问(终端可访问本地 Things 数据库)用 CLI,可读取 Inbox、Today、搜索、项目、区域、标签并完成全部写入。无 CLI 但有 Things MCP 用 MCP,其 things_* 工具可跨设备完整读写,适合无头、远程或云端例程。无终端但用户能处理输出时构造 URL,由用户在设备上打开执行,适合移动端和有人员参与的远程写入。完全无人值守(远程或 NAS 例程无人查看)用邮件到 Things,仅落入收件箱,不能安排、放置或更新。
凭据:auth token 仅用于修改现有数据(update、update-project、带更新操作的 json),普通 add/add-project/add-area 不需要;邮件地址用于邮件捕获。使用时先查环境变量 THINGS_AUTH_TOKEN、THINGS_EMAIL,再查私有配置,最后询问;不要臆造,也不要输出到日志或提交中。
CLI:macOS 专用。安装可执行 brew install ossianhempel/tap/things3-cli。读取命令包括 things inbox、things today、things upcoming、things search "query"、things tasks --project、things show 等,多数支持 --json。写入如 things add "Buy milk" --notes "..." --when today --deadline 2026-07-01 --tags "health,phone",可用 --dry-run 预览。更新需 auth token。重复任务拒绝 --when、--deadline、--completed、--canceled,也没有真正的删除,只能完成或取消。
URL scheme:形式为 things:///command?param1=value1,值需百分号编码;add 无需 token,update、update-project 和带变更的 json 需要。该链接只有在装有 Things 的设备上打开才执行,无法读取状态。
邮件:主题为任务标题,正文为备注,仅落入收件箱。注意自然语言日期必须为英文;重命名或删除区域、删除项目需通过 AppleScript 完成,且删除会移入 Trash。