homebridge-http-motion-sensor
通过HTTP请求触发HomeKit动作传感器的Homebridge插件。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:homebridge-http-motion-sensor。 它的用途是:通过HTTP请求触发HomeKit动作传感器的Homebridge插件。 完整的 Skill 内容见:https://321skill.com/skills/homebridge-http-motion-sensor/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我写一段Python代码,当我的树莓派摄像头通过OpenCV检测到移动时,向我的Homebridge服务器发送一个HTTP请求。”,它会生成一段使用`requests`库的代码,包含目标URL和错误处理。或者
对AI说:“解释一下如何用Node-RED配置一个流,在收到特定邮件时触发我客厅的灯。”,它会指导你如何在Node-RED中使用HTTP Request节点,并配置正确的端点地址。
介绍
这个Homebridge插件提供了一个可以通过发送HTTP请求来触发动作的虚拟传感器,将任何支持HTTP请求的设备(如ESP8266、Arduino)或软件服务轻松集成到苹果HomeKit生态系统中。
使用时,您需要在Homebridge的配置文件中添加此平台插件,并为每个传感器配置一个唯一的名称和端口。配置完成后,插件会启动一个HTTP服务器监听指定端口。当您向该端口发送一个简单的HTTP GET请求(如 http://你的服务器IP:端口/motion)时,插件就会模拟传感器检测到动作,并在HomeKit中触发相应的自动化。
它非常适合那些喜欢DIY智能家居、拥有一些不支持HomeKit但能联网的硬件设备(如旧款摄像头、红外传感器),或者希望通过脚本或自动化工具(如IFTTT、Node-RED)来触发HomeKit场景的用户。
需要注意的是,从v2.0.0版本开始,插件已从配件(accessory)类型转换为平台(platform)类型,配置方式有重大变化,升级时务必阅读迁移指南。此外,v4.0.0版本后,传感器的唯一标识符(UUID)生成规则改变,可能导致HomeKit中出现重复设备,需要手动清理并重新配置自动化。
核心特点
核心区别在于其极简的触发方式——仅需一个HTTP请求,无需复杂的协议转换或专用硬件,使得任何能发送网络请求的设备或服务都能成为HomeKit的动作触发器。此外,它支持在同一实例中配置多个传感器,并提供了可选的HTTP身份验证(Bearer Token、Basic Auth等),增强了安全性。
注意事项
不适合需要原生、低延迟、高可靠性的物理传感器场景,其触发完全依赖于外部网络请求的稳定性和及时性。
常见问题
如何从旧版本(v1.x)升级?
必须将配置从 `accessories` 数组移动到 `platforms` 数组,并按照新格式填写,具体请查看GitHub仓库中的迁移指南。
升级到v4.0.0后Home App出现重复传感器怎么办?
这是由于UUID生成规则改变导致的,需要删除Homebridge缓存中的旧配件文件(通常在 `persist` 和 `accessories` 目录),重启Homebridge后,在Home App中移除旧设备并重新添加新传感器。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/homebridge-http-motion-sensor/raw/index.md 读取 homebridge-http-motion-sensor 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/homebridge-http-motion-sensor/raw/index.md(查看排版版本)