SuperAPI AI 工具集

yeelight-interactive-light-experiences

通用与其它

查看项目

更新于 10-16 08:24

技能介绍

Yeelight Interactive Light Experiences 是一套通过本地回环服务运行的 Yeelight 灯光互动展览技能,面向两组 Yeelight 灯组,提供 AI 引导的互动灯光游戏与场景。

用途 该技能用于在展览电脑上运行一套仅限回环访问的体验集合,向访客呈现十二个专属体验,并通过本地浏览器应用展示。访客首页有意只呈现两项简单能力:互动灯光体验技能(Fortune Light、Light Game Arena、Cinema Director)以及智能家居技能(Relax、Focus、Movie、Party 四个一键房间意图)。其余体验仍可通过各自的直接 hash 路由供工作人员和演示使用,但不属于高吞吐的 IFA 首页。

主要能力

  • 十二个完整体验路由:Fortune Light、Light DNA、Shared Breath、Sensory Translator、Close the Day、Light Game Arena、Luma / Light Spirit、Memory Capsule、Intention Garden、Common Ground、No Shared Prompt、Impossible Light。顺序型体验使用同一屏幕和显式的私有交接,不使用手机或局域网参与者端点。
  • 智能家居技能:四个一键房间意图(Relax、Focus、Movie、Party),每个预设本地编译为同一套规范的 18 槽位计划,并复用现有执行器,使四灯开发代理与完整 IFA 安装共享同一控制路径。
  • 本地规范计划策略:在拓扑聚合前,将每个访客亮度提升至固定展览下限(36),同时保留提供方的色相、饱和度、相位时序和上限(85);该策略同样适用于确定性和回退计划。恢复写入绕过此策略,恢复精确的可信先前亮度。
  • 提供方紧凑相位使用四个独立 q 值,按 L-upper、L-lower、R-upper、R-lower 顺序排列;本地编译器保留非均匀提供方颜色不变,仅对相等或近似相等的象限颜色施加小幅确定性色相/饱和度(以及在有亮度余量时的亮度)变化,再进行规范 18 槽位扩展。

使用方式 该技能是可执行技能体验,而非访客手动启动的页面。当技能被调用以运行集合时,AI Host 必须执行本地包装脚本并打开返回的 URL:

sh scripts/invoke.sh start

包装脚本返回一行 JSON。读取 openUrl 并在展览电脑的浏览器中打开;使用 healthUrl 进行就绪检查。start 会复用健康的匹配服务,因此重复调用技能不会创建第二个执行器,也不会要求访客启动任何内容。status 仅用于显式健康检查,stop 仅在 Host 有意关闭集合时使用。PowerShell Host 使用 scripts/invoke.ps1 并支持相同操作。

不要要求用户运行 node scripts/launch.mjs、粘贴 localhost URL 或配置模式。如果启动返回错误,报告结构化错误并保持现有服务不变。下方的直接 launch.mjs 命令仅为开发者调试回退,不属于访客工作流。

启动细节 服务默认使用固定回环端点 http://127.0.0.1:8787/。如果不存在受保护的 IFA 绑定,则启动确定性离线 mock-18;它从不调用提供方或真实设备。如果存在受保护绑定,则启动 live-auto,在监听前验证固定的 ifa-eu EU 上下文和绑定设备,并解析为 live-proxy-4 或 live-18。无效绑定或实时验证失败会停止启动;它从不静默降级为 mock 模式。

工作人员可在展览电脑上打开未链接的 http://127.0.0.1:<port>/staff 路由。设置页面接受 OpenAI 兼容的 Base URL、API Key、Model 以及 Responses/Chat Completions 模式。它先测试候选配置,然后仅持久化受保护的本地 ProviderConfig 文件。可信本地展览配置中刻意没有设置代码、操作员代码或访客批准步骤。访客页面永远不会看到密钥或提供方来源。

对于实时硬件,操作员使用 scripts/live-bind.mjs 一次性创建受保护绑定,可为四个命名象限代理(live-proxy-4)或固定 EU 展览家庭中的全部十八个命名槽位(live-18)。然后 Host 正常启动包装脚本;它会自动使用 live-auto。自动模式仅是启动解析器:它重新验证持久化绑定并使用其具体拓扑。它不按设备数量扫描、不选择未绑定设备、不重新绑定其他家庭,也不静默降级为 mock 模式。绑定不匹配或设备检查失败会在任何访客写入之前停止启动。规范完整布局为 L1..L9 和 R1..R9。四灯代理将 L-upper/L-lower 映射到 L1..L5/L6..L9,右灯组同理。先前的 live-16 绑定会被视为过期而拒绝,必须使用全部十八个别名显式重新绑定;它绝不会被重新解释为 18 灯绑定。

使用 node scripts/validate.mjs 进行包和封闭计划检查,使用 node scripts/mock-demo.mjs 进行完整的十二路由 mock-18 / proxy-4 和失败矩阵冒烟测试。

访客边界 访客页面仅调用同源公开 /api 路由。它接受有界体验选择,并显示经过净化的计划、执行、拓扑、模式和证据结果。它从不接受或显示凭据、设备标识符、Runtime 意图、shell 命令或模型提示。禁止浏览器存储、cookie 和 URL 嵌入的访客数据。Finish、Home、重新加载、超时、错误和工作人员重置会清除活动的内存访客会话。

支持的序列为:浏览器 -> 回环服务器 -> 验证计划 -> 本地执行器 -> yeelight-home invoke --stdin。在实时访客模式下,服务器选择固定的命令确认快速路径:成功控制会跳过额外的执行器前状态和最终状态读取,并标记为已确认,而非物理读回验证。对于支持原生操作批处理的 Runtime,适配器提交完整的 lighting.design.apply 操作列表,并采用内部确认验证模式,因此 Runtime 执行所有写入而无需逐属性读回。较旧的一次性 Runtime 版本使用有界直接属性回退(light.power.set、light.brightness.set、light.color.set 或有界色温变体)。每个写入回执仍绑定到其生成的请求、目标、属性、期望值、来源和意图特定跟踪;通用 node.properties.set 确认被刻意不使用,因为它可能在不改变灯光的情况下被接受。调度后的写入失败、超时或取消仍会触发一次独立对账读取;不提供恢复,因为快速路径没有可信的前状态快照。浏览器、提供方和模型无法选择此策略。No Shared Prompt 服务器端状态检查仍是单独的 MCP 输入步骤。在实时模式下,它仅使用服务器选择的左灯组代表(象限代理使用 L-upper/L-lower,十八灯使用 L1/L6)以及固定的 Runtime 亮度和颜色读取。它仅投射亮度、颜色、响应带和显式样本覆盖;它绝不是对完整安装的声明。如果该封闭观察 API 不可用,体验会在提供方或灯光执行之前停止,并且不会回退到完整快照。Mock 证据必须保持标记为 18-light deterministic mock parity validated;它不是实时安装验证。适配器还可以仅在响应是完整的 write_verification_mismatch 回执时,将 Runtime lighting.design.apply 响应视为 dispatched_unverified:每个展开操作都有匹配的目标/属性/期望值行,persistentWrites 为 true,且 Runtime 已返回其写入后查询行。verified/compatibility 适配器路径使用此快捷方式;访客快速路径在可用时使用显式原生确认契约,在兼容回退上使用直接灯光属性回执契约。通用或混合部分、超时、取消和 Flow 失败仍走正常对账路径。

适用场景 适用于展览、演示和智能家居场景,在本地回环环境中向访客提供互动灯光游戏、场景和一键房间意图。适合需要 AI Host 自动启动服务、访客无需配置的展览电脑环境。

限制

  • 服务仅限回环访问,默认端点固定为 http://127.0.0.1:8787/。
  • 无受保护绑定时仅运行确定性离线 mock-18,不调用提供方或真实设备。
  • 无效绑定或实时验证失败会停止启动,不会静默降级为 mock 模式。
  • 访客页面不接触凭据、设备标识符、Runtime 意图、shell 命令或模型提示。
  • 四灯代理或 mock 结果不得表示为十八灯实时验证。
  • 实时访客模式使用命令确认快速路径,标记为已确认而非物理读回验证。
  • 不提供恢复,因为快速路径没有可信的前状态快照。
  • 先前的 live-16 绑定会被拒绝,必须使用全部十八个别名显式重新绑定。
  • 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。