用途:面向 Yeelight 智能家居,提供控制、整理、诊断、灯光设计、个性化与产品知识问答。适用于家庭、房间、区域、设备、分组、场景与自动化。
主要能力:查询设备状态与能力、临时控制灯光(开关、亮度、色温、颜色)、管理家庭/房间/区域、分组、场景与自动化;支持灯光设计导入、产品选型、场景与自动化配方转换、诊断、记忆与个性化、推荐及操作经验记录。
使用方式:统一通过本地命令 yeelight-home invoke --stdin 经 scripts/invoke 调用,构建含 contractVersion、requestId、locale、utterance、intent、parameters 的 SkillRequest。普通查询与控制一次调用完成,不要用 entity.list 等预检找 ID。按运行时状态处理:success/partial 说明实际结果;clarification_required 只问返回的最小问题;auth_required 提示运行 yeelight-home auth login --qr,商业照明用 --biz-type 1,无法扫码时自行在终端导入令牌(yeelight-home auth token set --stdin --region <region>);runtime_missing 提示安装或设置 YEELIGHT_HOME_BIN。删除、解绑、转移、权限、批量等高风险操作需用户明确同意后传 parameters.confirmed=true。
限制:运行时验证与策略决定为最终结果;不得索要或打印密码、令牌;不得暴露内部 ID(除非运行时要求);不将主机侧记忆当作已保存,偏好记忆须经 Runtime memory.remember;操作经验记录仅限确认可复用的运行时边界或变通路径;不得仅凭隐式习惯创建持久规则。