CasaRay

支持

CasaRay 支持

获取 Home Assistant 设置、实验性助手、设备控制、通知、订阅、隐私和故障排查方面的帮助。

集成兼容性

了解我们亲自测试过的内容、预计能通过标准 Home Assistant 控制工作的内容，以及支持可能存在差异的地方。

查看兼容性

公开支持与反馈

搜索报告、公开提问、报告问题或提出改进建议。该仓库用于支持和反馈，不提供应用源代码。

打开 GitHub 支持

分享日志之前

请从屏幕截图或诊断文本中移除 Home Assistant 和 ChatGPT 令牌、密码、内部 URL、公开 IP 地址，以及私人摄像头或房间详情。

社区交流

如果想轻松交流设置或版本相关话题，请加入 Evotec Discord，并提供您的平台、CasaRay 版本和 Home Assistant 版本。

打开 Discord

联系支持之前

  1. 确认运行 CasaRay 的 Apple 设备可以访问您的 Home Assistant URL。
  2. 确认受影响的实体可用，并能在 Home Assistant 中响应同一操作。
  3. 重新打开 CasaRay，稍等片刻，让实时状态重新连接。
  4. 对于解锁或开门等有风险的操作，确认批准提示会出现，且实体提供预期服务。

有帮助的信息

  • CasaRay 版本和 Apple 操作系统版本。
  • 设备型号：iPhone、iPad、Apple Watch 或 Mac。对于 CarPlay，请提供 iPhone 型号、车辆或主机型号，以及问题影响语音、手动控制还是两者。
  • Home Assistant 版本和连接类型：本地 URL、远程 URL 或 Home Assistant Cloud。
  • 对于设备或集成问题，请提供 Home Assistant 集成名称、设备厂商和型号、实体域，以及同一操作在 Home Assistant 中是否有效。
  • 房间、设备类别、您期望的操作，以及实际发生的情况。
  • 已移除私人详情的屏幕截图或简短诊断摘录。

助手支持报告

助手出现问题后，请打开助手设置 → 助手支持诊断。请先复现问题，再准备报告，并在分享前检查文件。报告分别记录语音连接、语音检测、转写、模型响应、工具选择、确认、Home Assistant 执行与状态核对，以及音频播放的耗时。与仅有截图相比，这更有助于调查长时间停顿或错误操作。

报告不会有意添加录制的音频、图像字节、已存储的 Home Assistant 凭据、已存储的 ChatGPT 令牌、授权标头或完整的私人 URL。不过，它会包含准确的对话文本和规范化工具参数，以及模型与语音设置、家庭、房间、设备和实体名称。因此，您说出或输入的内容以及文本控制值，可能包含您提到的密码、令牌或其他秘密。CasaRay 只包含当前 ChatGPT 账户和家庭所记录的诊断；缺少这类范围信息的旧记录会被排除。不会自动上传任何内容。分享前请检查并移除敏感文本。

助手可用性

CasaRay 助手是实验性功能，需要 CasaRay Plus 和另一个符合条件的 ChatGPT 账户。在 Apple Watch 和 CarPlay 上，助手语音使用配对 iPhone 的运行环境和账户；两者都不会存储独立的 ChatGPT 凭据。可用模型、语音、账户限额、工作区权限和服务可用性由 OpenAI 控制。如果助手停止工作，请在配对 iPhone 的助手设置中检查账户与用量，按提示重新授权，并确认 CasaRay 手动控制仍能访问 Home Assistant。

公开网页搜索是助手的一项独立实验性设置。只有在需要 Home Assistant 中已配置的天气等来源之外的最新信息时，才应开启。CasaRay 会按收到的原文使用您最后一次请求进行搜索，不会暗中加入家庭位置或状态。准确性重要时，请打开返回的来源链接。

实时活动、后台任务更新和小组件

CasaRay 打开时，实时状态直接来自 Home Assistant。关闭 CasaRay 后继续显示割草机、吸尘器或灌溉活动，需要单独的后台投递路径：Home Assistant → CasaRay 中继 → Apple Push → 这台 Apple 设备。

  1. 在主页点按连接圆点，然后打开后台与小组件 → 检查与修复。
  2. 允许通知并完成通知投递。发送投递测试，让 CasaRay 显示这台设备实际收到通知的证据，而不只是报告设置已存在。
  3. 完成后台任务更新，并在 Home Assistant 中批准由 CasaRay 管理的自动化。每个 CasaRay 安装使用自己的自动化，因此一台 iPhone 或 iPad 不会取代另一台设备的接收端。
  4. 在同一状态面板中检查最近的任务更新、实时活动权限和最新验证的小组件快照。

如果在初始设置时跳过了此步骤，请打开更多 → 设置指南或设置 → 设置指南。重新查看指南不会清除 Home Assistant 连接或布局。

小组件按平台独立工作。iPhone、iPad 和 Mac 应用各自发布和打开自己的快照与路径。如果某个平台报告状态过时，请在该平台打开 CasaRay 并检查连接圆点。iPhone 小组件正常，不代表 Mac 扩展已经更新。

购买与退款

Apple 负责 CasaRay Plus 的账单、续订、取消、退款和购买记录。如果 Plus 未显示为有效，请在 CasaRay 中使用“恢复购买”；如果应用仍无法识别，再联系支持。

预览模式

预览模式不需要提供方连接。要进行实时控制，请连接 Home Assistant，或在 iPhone、iPad 和 Mac 上授权您选择的 Apple Home 配件。

要求

CasaRay 需要 iOS 或 iPadOS 17 及以上、搭配配对 iPhone 的 watchOS 10 及以上，或 macOS 14 及以上。实时控制需要配置提供方：Home Assistant、iPhone、iPad 和 Mac 上选定的 Apple Home 配件，或两者。CarPlay 需要兼容车辆或主机，以及配对 iPhone；它提供语音和范围受限的手动控制，不是完整应用或摄像头浏览界面。功能因各设备和提供方开放的能力而异。助手还依赖 CasaRay Plus、符合条件的 ChatGPT 账户和受支持的 App Store 地区。