YZL-AIoT

⚙️ 运行时要求

• Python 3.6+ （需要 json, os, sys, http.client, time, collections 等标准库）
• 环境变量 YZLIOT_API_KEY - 必需，请从云智联小程序获取

🌱 YZL-AIoT 云智联 AIoT 设备管理

一句话就能获取设备数据和发送控制指令！ 本技能继承自 yzl-iot-api，功能相同，持续更新维护。

💡 如果你之前使用的是 yzl-iot-api，请迁移至此技能获取后续更新支持。

⚡ 快速使用

用户只需说：

• "获取传感器数据" → 自动获取所有土壤温湿度云传感器的温湿度
• "获取液位" / "液位数据" → 自动获取液位传感器的液位数据
• "打开电磁阀" / "开启水阀" → 开启远程电磁阀
• "关闭电磁阀" / "关闭水阀" → 关闭远程电磁阀

📋 支持的设备

土壤温湿度云传感器

获取数据： 温度(wd)、湿度(sf)

远程电磁阀

控制指令： 通过 kk1 设施控制开(1)/关(0)

低功耗液位传感器

获取数据： 液位(yw)

📖 自然语言示例

用户: "帮我看看传感器数据"
→ 返回所有土壤温湿度云传感器的温湿度

用户: "获取液位"
→ 返回液位传感器的液位数据

用户: "打开电磁阀"
→ 开启远程电磁阀

用户: "关闭水阀"
→ 关闭远程电磁阀

🔧 手动命令（可选）

如果需要更精细控制：

# 获取所有设备
python3 tool.py all

# 查看设备详情
python3 tool.py device 设备ID

# 开启电磁阀
python3 tool.py send WA1CB1-0000000007 SetFac '["WA1CB1-0000000007","kk1","1"]'

# 关闭电磁阀
python3 tool.py send WA1CB1-0000000007 SetFac '["WA1CB1-0000000007","kk1","0"]'

🔄 自动版本更新检测 (v1.0.0+)

本技能内置自动版本更新检测功能。

工作方式

1. 自动检测: 每次运行工具时，静默向 ClawHub 查询最新版本
2. 缓存机制: 每 12 小时只检测一次，减少网络请求
3. 智能提醒: 检测到有新版本时，在命令输出结果末尾追加更新提醒
4. 离线容错: 网络不可用时使用上次缓存结果，不阻塞操作

手动检查更新

python3 tool.py check-update

更新方法

# 更新到最新稳定版
clawhub update yzl-aiot

# 或指定版本
clawhub update yzl-aiot --version 1.0.0

⚡ 请求频率限制

工具已内置请求频率控制，自动处理以下限制：

版本历史

v1.0.0 (2026-06-03) — 初始版本

• 🎉 从 yzl-iot-api 迁移，全新发布
• ✨ 自动版本更新检测
• ✨ 缓存机制：12 小时内不重复请求
• ✨ 离线容错：网络不可用时使用缓存结果
• 🔧 完整支持：设备列表、详情、历史数据、控制指令
• 🗣️ 自然语言命令（智能识别设备型号和执行意图）