用途:为 AI Host 提供 Yeelight WiFi 灯具的本地优先工作流,通过官方 Wi‑Fi 互操作规范在局域网内通信。用户只需谈灯具、房间、分组、场景和计划,协议细节(UDP、TCP、CRLF 等)由 Host 处理。
主要能力:发现设备并展示友好名称、型号、在线状态与能力;日常控制涵盖开关、亮度、RGB、HSV、色温、相对调节、flow、前景/背景光、定时器、默认值、命名、组合切换和音乐模式(需设备声明支持);本地家庭组织包括命名的 home、房间、别名、稳定设备记录、兼容灯具分组、自定义场景、快照、计划与有限恢复记录。
使用方式:Host 执行 invoke.sh(或 PowerShell 的 invoke.ps1),通过 stdin/stdout 传递单个 JSON 请求。例如:printf '%s' '{"operation":"discover"}' | sh scripts/invoke.sh。物理写入请求须包含 executionRequested: true 与 preview: false;命名、定时器、音乐模式、恢复、端点重绑定和重置等需用户明确确认。先解析别名/房间/分组/场景,刷新过期目标后再写。
限制:灯具须已上电、配网到路由器、处于同一 LAN,并在官方应用/固件提供该设置时启用局域网控制。写前需展开选择器为全局设备计划,去重相同幂等动作,拒绝冲突操作。离线、待重绑定或缺能力数据的成员默认不写入,需用户确认是否仅控制在线成员。场景多设备应用非事务性,恢复需明确确认且只在状态未漂移时执行。计划若 Host 未提供调度器则只能保留非活跃草稿,禁止安装 cron、launchd、systemd 等。测试使用隔离的 UDP/TCP/音乐模拟,非真实设备。部分事实(如具体支持型号、收费、平台范围)暂未提供。