things-mac

Things-mac 是一款专为 OpenClaw 个人 AI 助理设计的集成工具，为您的 Things 3 数据库提供功能完整的命令行控制。它专为 macOS 开发，填补了 AI 助理与您的主要任务管理系统之间的鸿沟。通过直接与本地 Things 3 数据库互动并利用 Things URL 架构，此技能让用户能完全通过自然语言或自动化触发来维持结构化的任务工作流程。无论您是要查询收件箱、排定今日优先级，或是将新项目加入特定项目与领域，此工具都能作为可靠的界面，确保任务同步顺畅。

• 执行完整的读取操作，包括检索收件箱、今日议程、即将到来的截止日期，以及搜索所有任务、项目、领域与标签。

• 执行写入操作，例如新增含有备注、截止日期、排程日期与项目指派等元数据的待办事项。

• 通过修改标题、备注、标签，或是在列表与标题之间移动任务来更新现有项目。

• 支持进阶任务结构，包括建立检查清单项目，以及通过标准输入 (STDIN) 处理多行备注。

• 整合 Things 3 URL 架构，可将应用程序切换至前景，并执行试运行 (dry-run) 以安全验证指令。

• 高度配置弹性，支持自订数据库路径与验证令牌 (auth token)，确保更新过程安全可靠。

• 请确保调用此工具的应用程序 (如 Terminal 或 OpenClaw) 已在 macOS 系统设置中取得“完全磁盘访问权限”，以便读取本地 Things 数据库。

• 虽然读取操作是通过访问本地数据库完成，但写入操作需使用 Things URL 架构，且建议设置验证令牌以进行安全修改。

• 请注意，此工具不支持直接删除等破坏性动作；用户应通过将项目标记为已完成或已取消来处理。

• 此工具仅限于安装有 Things 3 的 macOS 环境中使用。

• 在初始设置或测试期间，建议使用 --dry-run 标志来预览指令，而不会对您的实时任务数据库造成影响。