Things 3 CLI

Things 3 CLI 是什么

Things 3 CLI 可读取收件箱、今日、即将到来、项目、领域和标签，并通过 URL scheme 添加或更新待办。

适用场景

适合 Mac 上的个人任务查询与管理。

核心能力与工作机制

支持搜索、列表、添加备注/日期/清单/标签、移动列表、完成和取消；无直接删除能力。

执行流程

安装 CLI 并授权完全磁盘访问，先用查询找到目标 UUID；写入先 dry-run，确认 URL 后执行并回读。

输入与输出

需要 macOS、任务内容或 UUID、日期、项目/标签和可选认证令牌。输出任务列表、搜索结果、预览 URL 或更新后的待办。

依赖、账号与权限

仅 macOS，需 things CLI、Things 3、完全磁盘访问；更新可用 THINGS_AUTH_TOKEN。

副作用、限制与风险

本地数据库含私人安排，错误 UUID 会修改别的任务；完成和取消也会改变真实状态。会读取本地 Things 数据并通过 URL scheme 创建或修改任务。

不适用边界

不支持真正删除或移入废纸篓，也不能跨平台运行。

失败处理与验收

数据库读取失败检查完全磁盘访问与 THINGSDB；写入不明先搜索 UUID，避免重复添加。检查任务标题、项目、日期、标签、清单和状态，优先使用 dry-run 与回读。

适合谁使用

适合使用 Things 3 的 Mac 用户。

来源、版本与许可

本条目依据 SkillHub 热门榜、发布者详情和版本 1.0.0 的完整 SKILL.md 整理，核验日期为 2026 年 9 月 26 日。完整 SKILL.md 未声明许可证，公开可下载不代表可以任意复制、修改或再分发。 SkillHub 当前两套安全扫描状态为 benign、benign；该状态只是平台信号，不能替代对脚本、凭据、网络请求、数据外送与后续版本的人工审查。

常见问题

1. Things 3 CLI 主要解决什么问题？

Things 3 CLI 可读取收件箱、今日、即将到来、项目、领域和标签，并通过 URL scheme 添加或更新待办。适合 Mac 上的个人任务查询与管理。是否采用它，应以实际任务边界和可核验材料为准，不要因为榜单热度而跳过来源审查。

2. 开始前需要准备什么？

需要 macOS、任务内容或 UUID、日期、项目/标签和可选认证令牌。准备阶段不要代替用户猜测关键事实；缺少会改变路线、费用或权限的输入时，应先补齐再执行。

3. 它怎样完成任务并交付结果？

安装 CLI 并授权完全磁盘访问，先用查询找到目标 UUID；写入先 dry-run，确认 URL 后执行并回读。每个阶段都要保留输入、决策、输出和检查点，不能把计划、预览或排队状态描述成最终交付。

4. 需要哪些工具、账号或权限？

仅 macOS，需 things CLI、Things 3、完全磁盘访问；更新可用 THINGS_AUTH_TOKEN。凭据应放在安全环境中，并按最小权限授权；账号、网络或本地依赖不满足时应明确停止条件。

5. 它会产生哪些外部操作或副作用？

会读取本地 Things 数据并通过 URL scheme 创建或修改任务。涉及外部写入、上传、发送、付费或持久配置时，应在实际动作前说明影响范围并取得相应确认。

6. 哪些情况不适合使用？

不支持真正删除或移入废纸篓，也不能跨平台运行。超出来源明确能力、专业资质或授权范围时，应切换到更合适的工具或交给专业人员处理。

7. 失败或结果异常时怎样恢复？

数据库读取失败检查完全磁盘访问与 THINGSDB；写入不明先搜索 UUID，避免重复添加。恢复时优先查询已有任务、日志或备份，避免无上限重试、重复扣费、重复发送或覆盖唯一原件。

8. 如何验收结果并控制风险？

检查任务标题、项目、日期、标签、清单和状态，优先使用 dry-run 与回读。验收应基于真实文件、页面、任务终态或权威来源，并把未能实际检查的部分明确标记出来。