things-mac

• 您在 macOS 上使用 Things 3，並希望您的 AI 代理能直接將任務擷取至您的收件匣、今天清單或特定專案中。
• 您想要查詢 Things 資料庫——例如「今天有哪些到期事項？」或「搜尋標記為 health 的任務」——而無需開啟應用程式。
• 您需要更新現有的待辦事項：變更標題、附加備註、移至其他專案、新增標籤，或標記為已完成／已取消。
• 您希望在任何寫入操作實際影響 Things 資料之前，先預覽乾跑（dry-run）結果。

• 您不在 macOS 上——此技能僅支援 Darwin 系統，無法在 Linux 或 Windows 上運作。
• 您需要永久刪除或將待辦事項移至垃圾桶；底層 CLI 工具不支援刪除功能。
• 您尚未安裝 Things 3，因為此技能需要依賴磁碟上正在運作的 Things 3 資料庫。

直接從 Things SQLite 資料庫查詢您的收件匣、今天、即將到來及記錄簿檢視，無需開啟 Things 3。支援 --limit 篩選，並回傳包含 UUID 的結構化資料，以供後續操作使用。

透過單一指令建立新任務，可附加備註、截止日期（--when、--deadline）、專案／領域指派（--list）、標題、標籤及檢查清單項目。同時支援 STDIN 管道輸入，可用於多行標題與備註的輸入。

透過 UUID 修改任何任務：重新命名、取代或附加/前置備註、在專案間移動、更新標籤，或將其標記為已完成或已取消。寫入操作需要 things-mac 驗證權杖。

傳入 --dry-run 參數，可在不實際開啟 things-mac 或提交任何變更的情況下，將 Things URL scheme 的內容印出來——適合在執行前驗證由代理程式產生的操作是否正確。

對您的 things-mac 資料庫執行全文搜尋，透過關鍵字找出相關任務，並回傳後續更新指令所需的 UUID 及元資料。

列出您 Things 3 中所有的專案、領域與標籤，讓代理程式能夠智慧地將新任務路由至正確的目的地，無需猜測。

在與您的助理討論會議或想法時，只需說「將這個加入我的 things-mac 收件匣」，該技能便會立即建立任務，並附上對話中提及的任何備註或截止日期——無需複製貼上。

請你的代理人從 Things 3 中提取「今天」和「即將到來」的清單，讓你可以檢視優先事項、獲得摘要，或讓代理人協助你重新安排時程或為任務添加備註。

依關鍵字搜尋任務、取得其 UUID，然後附加新備註或將其移至不同專案——當您記得某項任務存在，但需要為其補充新資訊時，此功能非常實用。

在規劃旅行或專案時，可以在一次對話中請代理人建立多個附有清單的待辦事項，並將它們指派到 things-mac 中的特定專案與標題底下。