things-mac¶

Skill 简介¶

things-mac 是一个基于 macOS 的 OpenClaw Skill，旨在通过命令行界面（CLI）工具 things 来管理和操作 Things 3 应用。Things 3 是一款广受欢迎的 macOS 任务管理工具，但其在自动化和集成方面存在一定的局限性。things-mac 通过调用 things CLI 的 URL 方案，实现了任务和项目的添加、更新、读取等功能，为开发者提供了更便捷的自动化操作方式。

这个 Skill 的核心目标是帮助用户在使用 OpenClaw 进行语音或文本交互时，能够无缝地将任务管理操作集成到工作流程中。例如，用户可以通过语音命令将任务添加到 Things 3 的收件箱、查看今日任务、搜索特定任务等。things-mac 的出现填补了 Things 3 在自动化和语音交互方面的空白，为用户提供了更高效的任务管理体验。

主要功能¶

1. 任务和项目的添加与更新

things-mac 支持通过命令行将任务和项目添加到 Things 3 中，并支持多种参数配置，例如设置截止日期、分配到特定项目或标签等。例如，用户可以轻松地将“购买牛奶”添加到“购物”项目中，并设置截止日期为明天。

2. 读取本地 Things 数据库

该 Skill 能够读取本地 Things 3 数据库中的数据，包括收件箱、今日任务、即将到来的任务、项目、区域和标签等。用户可以通过简单的命令查看当前的任务状态，例如：

things inbox --limit 50
things today
things upcoming

3. 搜索任务

things-mac 提供了强大的搜索功能，允许用户根据关键词搜索特定任务。例如，用户可以输入以下命令来查找包含“会议”关键词的任务：

things search "会议"

4. 项目、区域和标签的管理

用户可以通过命令行查看和管理 Things 3 中的项目、区域和标签。例如，列出所有项目：

things projects

或者查看特定标签下的任务：

things tags "工作"

5. 任务更新与状态更改

things-mac 支持对现有任务进行更新，例如修改任务标题、添加或替换备注、移动到不同的项目或区域，以及标记任务为完成或取消。例如，将任务 ID 为 <UUID> 的任务标记为完成：

things update --id <UUID> --completed

6. 集成 Things URL 方案

该 Skill 利用 Things 3 的 URL 方案，实现了与应用的深度集成。用户可以通过命令行直接调用 Things 3 的功能，例如将任务添加到特定列表中：

things add "编写报告" --list "工作" --deadline 2023-12-31

使用场景¶

1. 语音助手集成

开发者可以将 things-mac 集成到语音助手中，例如 Siri 或 Alexa，实现通过语音命令管理任务。例如，用户可以说“嘿 Siri，添加一个任务到 Things 3：明天下午 3 点开会”。

2. 自动化工作流程

在开发过程中，开发者可以将 things-mac 集成到自动化工具中，例如 AppleScript、Automator 或其他脚本语言，实现任务管理的自动化。例如，在代码提交后自动将“代码审查”任务添加到“开发”项目中。

3. 日程管理应用

开发者可以开发基于 things-mac 的日程管理应用，将任务管理与其他日程管理工具集成。例如，将日历事件自动转换为 Things 3 中的任务。

4. 数据分析与报告

things-mac 可以用于导出 Things 3 中的数据，进行分析和生成报告。例如，定期导出任务数据进行分析，了解任务完成情况和效率。

5. 跨平台集成

虽然 things-mac 只能在 macOS 上运行，但开发者可以将其与其他平台的工具集成，实现跨平台的任务管理。例如，通过云服务将任务同步到其他设备或平台。

如何使用¶

安装¶

things-mac 的安装过程相对简单，但需要一些前置条件：

安装 Go 语言环境：确保你的 macOS 系统已安装 Go 语言环境。可以通过以下命令安装：

bash brew install go
安装 things3-cli：

bash GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest
授予完全磁盘访问权限：为了使 things CLI 能够读取本地 Things 3 数据库，需要在“系统偏好设置”->“安全性与隐私”->“隐私”中，为终端或 OpenClaw 应用授予“完全磁盘访问权限”。

配置¶

设置数据库路径（可选）：

bash export THINGSDB=/路径/到/你的/ThingsData-*/Library/Application Support/Cultured Code/Things/Things.sqlite
设置认证令牌（可选）：

bash export THINGS_AUTH_TOKEN=你的认证令牌

示例¶

示例 1：添加任务¶

things add "购买牛奶" --notes "2% + 香蕉" --list "购物" --deadline 2023-12-01

这个命令将“购买牛奶”任务添加到“购物”项目中，并附上备注“2% + 香蕉”，截止日期为 2023 年 12 月 1 日。

示例 2：更新任务¶

things update --id <UUID> --notes "新的备注内容" --list "工作" --heading "项目名称"

这个命令将任务 ID 为 <UUID> 的任务的备注更新为“新的备注内容”，并将其移动到“工作”项目中的“项目名称”子项目下。

总结¶

things-mac 是一个功能强大的 OpenClaw Skill，为开发者提供了丰富的接口来管理和操作 Things 3 应用。通过命令行和 URL 方案的结合，things-mac 实现了与 Things 3 的深度集成，使得任务管理更加高效和便捷。无论是语音助手集成、自动化工作流程，还是跨平台集成，things-mac 都能满足开发者的多样化需求。对于那些希望将任务管理集成到更广泛的应用场景中的开发者来说，things-mac 是一个不可或缺的工具。