Things 3 深度命令行集成

由知名开发者 steipete 维护的 Things 3 命令行集成工具，通过开源 things3-cli 实现本地任务数据库读写与 URL Scheme 操作，为 macOS 用户提供高效的任务管理自动化能力。

基本信息

• 技能名称?things-mac
• 中文名称?Things 3 深度命令行集成
• 作者?steipete
• 分类?专业技能
• 版本?v1.0.0
• 标签?productivity, macos, cli, automation, project-program-management

使用方法

使用说明
核心用法
things-mac 是一个专为 macOS 设计的 Things 3 任务管理集成技能，通过调用 things3-cli 开源工具实现双向数据交互。该技能支持两大核心操作模式：一是 只读查询 ，直接访问本地 Things SQLite 数据库，可快速检索收件箱、今日任务、即将到期事项，以及按关键词搜索、列出项目/区域/标签等结构化数据；二是 写入操作 ，通过 Things URL Scheme ( ( things:// ) 安全地添加新任务、更新现有任务属性（标题、备注、截止日期、标签、完成状态等）。
安装配置需通过 Go 工具链获取二进制文件，并授予调用应用（Terminal 或 Clawdbot.app） Full Disk Access 权限以读取 Things 数据库。高级用户可配置 THINGSDB 环境变量指定自定义数据库路径，或设置 THINGS_AUTH_TOKEN 简化更新操作的认证流程。技能特别提供 --dry-run 预览模式，在执行实际写入前展示即将生成的 URL，降低误操作风险。
显著优点

1. 原生集成深度 ：直接操作 Things 3 本地数据库，响应速度远超 AppleScript 或 GUI 自动化方案，查询结果包含完整的 UUID、项目层级、标签元数据等结构化信息。
2. 双向工作流支持 ：既满足快速录入场景（通过 STDIN 管道批量创建任务、支持多层级清单项），也支持复杂的任务迁移与属性批量更新，填补了 Things 3 官方 API 缺失的空白。
3. 安全设计意识 ：写入操作强制要求认证令牌，配合预览模式形成双重保险；只读操作与写入操作在架构上分离，最小权限原则清晰。
4. 维护者权威性 ：由 PSPDFKit 创始人 Peter Steinberger（steipete）维护，其在 iOS/macOS 生态的深厚积累确保了技能与系统特性的最佳适配。
   潜在缺点与局限性
   平台锁定 ：严格限定 macOS/Darwin 系统，Windows/Linux 用户无法使用，且 Things 3 本身无跨平台版本，生态封闭性强。
   功能边界 ：当前版本 不支持删除/移至废纸篓操作 ，仅能标记完成或取消；对于需要彻底清理任务库的用户需返回 Things 原生界面。
   权限门槛 ：Full Disk Access 属于 macOS 最高级别文件权限之一，企业环境或高安全需求用户可能面临 IT 策略限制。
   依赖维护风险 ：核心功能依赖第三方开源项目 things3-cli ，若上游停止维护或 Things 3 更新导致数据库 Schema 变更，可能出现兼容性问题。
   适合的目标群体
   GTD 重度实践者 ：已将 Things 3 作为核心任务系统，需要高频、批量操作任务的知识工作者
   自动化工作流构建者 ：希望将 Things 与 Alfred、Raycast、Hammerspoon 或自定义脚本联动的效率工具用户
   开发者与技术写作者 ：习惯命令行交互，需要将任务管理嵌入开发工作流（如代码提交时自动创建关联任务）
   macOS 生态深度用户 ：已配置完善的本地开发环境，愿意授予必要系统权限以换取操作效率
   使用风险
   数据持久性风险 ： things update 操作会直接修改生产数据，虽支持 --dry-run ，但认证令牌泄露可能导致未授权任务篡改
   性能瓶颈 ：大数据库查询（如 things search 无限制返回）可能产生显著 I/O 负载，建议始终配合 --limit 参数
   版本耦合 ：Things 3 应用更新可能静默更改数据库位置或 Schema，需关注 things3-cli 上游兼容性公告
   权限扩散 ：授予 Clawdbot.app Full Disk Access 后，该应用获得超出 Things 数据范围的系统文件访问能力，需信任整个应用供应链