高效管理你的待办事项

基于 things3-cli 的 Things 3 任务管理指南，可读写本地数据库与 URL Scheme，助你快速添加、搜索、更新待办事项。

基本信息

• 技能名称?Things Mac
• 中文名称?高效管理你的待办事项
• 作者?steipete
• 分类?专业技能
• 版本?1.0.0
• 标签?productivity, automation, macOS

使用方法

使用说明
核心用法
things-mac 是一个指导型技能，为 macOS 上的 Things 3 任务管理应用提供完整的命令行操作手册。它围绕个人开发者 ossianhempel 开源的 things3-cli 工具展开，涵盖从安装配置到日常任务管理的全流程操作。
在只读能力方面，用户可以通过 things inbox 、 things today 、 things upcoming 等命令查看收件箱、今日任务和即将到来的待办事项，也能使用 things search 进行全局搜索，或以 things projects / areas / tags 浏览项目、区域和标签结构。写入能力则通过 Things URL Scheme 实现，支持添加带备注、截止日期、标签或检查项的新任务，并可放入特定项目或区域。借助 --dry-run 标志，所有写入操作均可安全预览，避免误操作。修改已有任务（如更新标题、备注、标签或标记完成）需要先获取 UUID 并配置 THINGS_AUTH_TOKEN 认证令牌。
显著优点
零代码风险 ：技能本身为纯 Markdown 指令手册，不含任何可执行脚本、二进制或隐藏逻辑，安全性极高。
完整的 CLI 能力映射 ：将 things3-cli 的只读数据库查询和 URL Scheme 写入两大核心能力系统化呈现，覆盖创建、搜索、更新、归档等全生命周期操作。
安全操作引导 ：内置 --dry-run 预览机制，确保用户在 Things 自动执行前确认操作意图，有效防止误写入。
潜在缺点或局限性
上游依赖风险 ： things3-cli 由个人开发者维护，缺乏企业级供应链保障，工具的长期维护和兼容性存在不确定性。
macOS 独占 ：技能仅适用于 Apple 生态，且要求 Things 3 已购买并安装，无法跨平台使用。
删除功能缺失 ： things3-cli 不支持真正的删除或移至废纸篓，只能通过 --completed 或 --canceled 进行软归档，对于需要彻底清理旧任务的用户不够友好。
Full Disk Access 授权要求 ：读取本地数据库需授予系统最高文件权限，虽属必要但增加了安全攻击面。
适合的目标群体
重度 Things 3 用户，希望将任务管理融入自动化工作流或通过命令行快速操作任务。
开发者或技术爱好者，习惯在终端环境中管理待办事项，追求效率和控制力。
使用 Clawdbot 等 Agent 框架的自动化场景，希望通过自然语言交互来创建和管理 Things 任务。
使用风险提示

1. 供应链信任风险 ：底层 things3-cli 源于个人 GitHub 仓库，安装前应审查源码，企业可考虑 Fork 到内部仓库后安装以控制风险。
2. 凭证泄露风险 ： THINGS_AUTH_TOKEN 若明文存储在 .bashrc 或共享配置文件中可能被泄露，建议使用 macOS Keychain 进行加密存储。
3. 权限过度风险 ：Full Disk Access 授权后，调用应用可读取整个文件系统，建议仅对可信应用授权并定期审查授权列表。