name: yoooclaw-light description: 设备显示与灯效：使用 yoooclaw CLI 把内容显示到硬件屏幕、立即播放一次灯效，或管理“通知→灯效”持久规则。用户要求在硬件屏幕显示文字或结果、现在或任务完成后亮灯、或让通知触发灯效时使用。 metadata: version: "1.0.0"

YoooClaw 设备显示与灯效

通过本机 yoooclaw CLI 向硬件屏幕展示内容、控制一次性灯效和管理通知触发的持久灯效规则。

选择分支

根据用户希望灯效发生的时机选择一个分支，并在执行前完整读取对应 reference：

屏幕展示和一次性播放都是立即下发到在线硬件的单次操作；持久规则保存在云端，由后续通知触发。用户同时要求即时下发和持久规则时依次执行两个分支，分别核验结果。

共同边界

• 两个分支都使用已配置的 API key 并需要网络；屏幕展示和一次性播放还要求硬件在线。规则管理不需要 daemon 常驻。
• 本次第一条灯效业务命令前运行一次 yoooclaw --version。命令不可用或版本号无效时报告 CLI 不可用，不猜测命令替代品。
• 用户选择非默认 profile 时，在 light 或 lightrule 前加入全局参数 --profile <name>。
• 支持 JSON 输出的命令追加 --format json，同时检查退出状态和顶层 ok；ok=false 按失败处理。
• API key 只从现有凭据读取。需要重新配置时使用 yoooclaw auth set-api-key - 从 stdin 输入，不把 key 写进命令行或回复。
• 对 AUTH_REQUIRED、设备离线、网络失败和其他业务错误，保留脱敏后的 code/message，并只给一个与当前分支对应的下一步。网络写操作最多重试一次；结果不确定时先用只读命令核验，避免重复下发或重复创建。

最终回复区分“展示请求已下发”“灯效请求已下发”和“持久规则已保存”，只报告用户需要的标题、正文/原因、预设/规则、状态及必要 warning。