技能介绍

解决什么问题

不少 IoT 数据查询流程要手工拼接 client_id、client_secret、productKey 与 deviceName，还要处理 Token 过期、分页、属性数据、子设备、图片 URL 失效等问题。JJR IoT Skill 面向捷佳润物联平台，把这些接口包装成可被 Agent 调用的技能：从查设备列表、拉温湿度/CO2/光照历史数据，到生成图表报告并推送到钉钉，形成一条相对完整的数据巡检链路。

技能如何工作

认证与缓存：使用 https://gateway.jjr.vip/iot/ 作为 API 基础地址，通过 POST /iot/oauth2/token 获取 Bearer Token；Token 有效期约 30 分钟，建议写入本地缓存复用。
设备与产品查询：支持设备列表、设备详情、产品列表、子产品/子设备列表，以及按 productKey 和 deviceName 查询属性数据。
配置下发与服务执行：可获取设备配置、编辑配置、批量下发配置，并调用设备服务接口。
图表报告：通过 generate_report_generic.py 生成 HTML 与 PNG 报告，支持温度、湿度、CO2、光照等多 Y 轴展示；客户参数放在配置文件中，避免脚本硬编码敏感信息。
消息推送：可将图片/Markdown 通过钉钉发送，也支持定时任务场景下周期性采集与推送。

适用边界与注意点

该技能依赖捷佳润物联平台账号与 API 凭证，不适用于没有对应平台权限的通用 IoT 环境。查询结果受 productKey、deviceName、时间范围和设备在线状态影响；图片下载可能遇到 OSS 权限或 URL 过期问题。使用时应妥善保管 client_secret，不同客户使用独立配置，不把密钥提交到版本库。