脚本库

使用 Shelly 脚本自动化您的世界

欢迎来到 Shelly Scripts 知识库，这里是您获取智能家居自动化脚本的首选平台。无论您是 DIY 爱好者、安装人员还是专业人士，我们的即用型脚本合集都将帮助您为您的 Shelly 设备解锁更多新功能。

探索脚本编程的力量

Shelly 设备凭借内置脚本功能，提供无与伦比的灵活性。借助我们简单易懂的教程和示例，您可以增强自动化、集成第三方服务，并为智能家居、业务与企业以及工业自动化优化创建自定义触发器。

通过6 个简单步骤开始使用 Shelly 脚本

embedded web interface

Step 1: 创建一个空脚本

打开您的 Shelly 设备的 Web 界面，并导航至Scripts菜单。您的设备 Web 界面可通过其 IP 地址访问——只需在 Shelly Cloud App 中点击它，或在浏览器中输入该地址。
点击Add Script。

Shelly Cloud 应用

第 1 步: 创建一个空脚本

在网页中打开 Shelly Cloud 应用 -> 选择你的 Shelly 设备，并进入脚本菜单（大括号图标）。
点击添加脚本。

SHELLY 云应用

第2步：上传并运行您的脚本

在嵌入式 Shelly 代码编辑器中编写或复制您的自动化脚本，将其命名为（例如，my_idle_alert_script），然后点击保存。
保存后，您将可以选择运行该脚本。

Shelly Gen2 BLE Gateway 脚本用于集成 BLU Button1

通过此 Gen2 脚本，实现 Shelly BLU Button1 与其他 Shelly 设备之间的无缝交互，根据按键事件发起本地 API 请求。用户可以将特定的 URL 映射到单击、双击和三击等按键操作。脚本高效地队列并处理 URL 请求，但同时最多只能有五个并发的 RPC 调用。在部署前，请为您的 BLU Button1 配置 MAC 地址，并为每个按键事件定义所需的操作。该脚本非常适合在不同 Shelly 生态系统中自动化响应，让您轻松管理不同代设备的控制。 *...

动态负载切换脚本用于能源管理

这个先进的负载削减脚本旨在通过动态控制设备，将能耗维持在指定的最小和最大阈值之间。脚本根据预设的计划优先控制设备，在确保关键设备持续运行的同时，最大限度地减少电力消耗。它提供多种优化性能的策略，例如在最小和最大功率限制之间设置较大的间隔，以及调整轮询时间以减少不必要的切换。该脚本支持Shelly设备和通过 webhook 接入的外部设备。用户可配置通知功能，在设备切换时收到提醒。此方案适用于对能源管理要求较高的环境，如太阳能系统或用电高峰管理。负载削减脚本将通过控制其他设备的电源，使测量的用电量始终保持在最低（min）和最高（max）总功率（瓦特）之间。主要注意事项：1. 请确保设置的最大值大于最小值（10% 应视为最小间隔，20% 是更理想的最小间隔）2. 最小值与最大值之间的间隔越大，切换频率（“churn”）就越低。为这两个值设置足够的间隔将提升负载削减的效率。3. poll_time 的最小值应为 60——在“开启”周期时，应留出足够时间让浪涌电流稳定下来。4. 优先级顺序为最重要（尽量保持开启）到最不重要。5. 任何未被列出的设备，或未包含在任何计划中的设备都不会被管理——永远不会参与负载削减。6. 最佳做法是在每个计划中，将所有包含的设备命名在“priority”、“on”或“off”其中一个集合中。poll_time：执行常规开/关操作的最小时间间隔short_poll：在添加设备时，最高优先级的设备会被开启，即使它们已被认为是开启状态，这个更短的时间可以加快流程

Shelly Gen1激活开关配置文件复制脚本

此脚本利用Shelly 的脚本功能，复现了 Shelly Gen1 设备中的 activation_switch 配置行为。它将开关设置为“分离”模式，并添加事件处理程序以管理按钮按下事件。脚本会忽略单击和双击事件，在检测到“btn_up”事件时，根据用户自定义的超时时间激活开关。该脚本非常适合希望在 Shelly 设备上模拟 Gen1 行为的用户，并支持自定义切换超时时间以及开关/输入 ID。

将能量数据发送到Thingspeak云

将能耗计量数据（瓦特）发送到Thingspeak云端此Shelly GEN2脚本可自动通过HTTP POST请求将能耗数据（以瓦特为单位）发送到Thingspeak云平台。脚本会从Shelly开关收集有功功率（瓦特），将其格式化为JSON对象，并以可自定义的时间间隔发送到Thingspeak。通过简单的API密钥配置，并支持发送温度等其他数据，此脚本为能耗监测及与外部平台集成提供了简便的解决方案。