casa

Casa 是一款專為進階使用者、自動化工程師與開發人員設計的 macOS 工具，旨在提供對 HomeKit 配件的直接程式化存取。透過提供本機專用的 REST API 與強大的 CLI，它彌合了 Apple Home 生態系統與自訂自動化工作流程之間的鴻溝。無論您是要編寫本機指令碼以根據系統事件切換智慧照明、記錄裝置狀態，還是將 HomeKit 整合至更大型的家庭自動化框架中，Casa 都能提供所需的底層存取權限，且無需複雜的雲端服務或第三方橋接器。

本應用程式作為一個本機伺服器運行，僅綁定於本機環回介面 (127.0.0.1:14663)，確保您的家庭自動化數據完全保留在您的機器上。一旦安裝並授予必要的 HomeKit 權限，它即允許對裝置特性、房間分類與配件進行精細的控制。

• 支援 REST API 以讀取/寫入特性、列出配件並查詢裝置架構。

• 整合式命令列介面，便於快速撰寫指令碼與進行終端自動化。

• 相容於標準 macOS HomeKit 權限與使用者定義的家庭設定。

• 僅限本機回送的網路架構，確保數據隱私與安全性。

• 支援 JSON 輸出，可輕鬆整合至如 jq 等資料處理工具中。

• 請確保 Casa 應用程式在背景執行，以維持 API 伺服器運作。

• 使用健康檢查端點或 'casa health' 指令來驗證連接狀態。

• 透過應用程式設定配置驗證權杖，以保護您的本機 API。

• 將配件特性 ID 視為穩定值，僅在硬體物理新增或移除時才需重新快取。

• 請注意，API 不支援透過 HomeKit 進行攝影機串流；若需監視器畫面，建議直接使用 RTSP 或 HTTP 串流。

• 進行開發時，請使用提供的環境變數 CASA_URL 與 CASA_TOKEN 來驗證並從外部指令碼連結本機 API。