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。