SuperAPI AI 工具集

dancing-lights

通用与其它

查看项目

更新于 10-20 20:16

技能介绍

Dancing Lights 是一个轻量级状态指示器技能。其定位是在系统中悬挂小型、可移动的信号,让人能够判断系统正在做什么。它适用于状态小点、进度标记、心跳组件和环境可观测性提示,帮助人类快速定位。该技能不是完整的仪表盘策略,而是一个小型视觉线索,提示下一步该看哪里。

主要能力:

  • 设计轻量级状态或进度显示,而非构建完整的可观测性体系。
  • 提供小型环境指示器,让人们一眼看出健康、运动或阻塞状态。
  • 目标是定位与安心,而非在重型仪表盘中进行深度分析。
  • 若 Home Assistant 中有 Philips Hue 或其他智能灯,可将其用作环境状态指示器。

使用方式:

  • 前置条件:Hermes 可用的环境变量 HA_URL、HA_TOKEN;主凭据为 HA_TOKEN;PATH 中存在 curl。
  • 设置:确认所需环境变量在活动的 Hermes 运行时内可用,而不仅是 shell 配置文件中;在依赖所需二进制前验证其可在 PATH 中解析;若技能可能触发告警或接触实时集成,先选择非生产或低风险目标。
  • 流程:在行动前重申目标、成功条件和不可触碰的边界;选择真正需要一眼看到的最小信号集;将这些信号映射为简单视觉、放置位置和刷新行为,确保在压力下仍清晰可读;返回指示器规格,包含数据源、过期状态处理和错误状态;若 Home Assistant 可用,使用 HA REST API 直接设置灯状态——向 /api/services/light/turn_on 发送 POST 请求,包含 entity_id、brightness 和 rgb_color;将结果打包为交付物,并明确标注置信度、假设和未解决风险。

交付物:

  • 紧凑的状态显示概念或实现简报。
  • 健康、过期和失败状态的信号到视觉映射。
  • 关于刷新节奏、放置位置以及该指示器不声称内容的说明。

适用场景:需要轻量级状态或进度显示而非完整可观测性建设时;小型环境指示器有助于人们一眼看到健康、运动或阻塞时;目标为定位与安心而非重型仪表盘深度分析时;Home Assistant 环境中有可用作环境状态指示的智能灯时。

限制与注意事项:

  • 保留戏剧化框架,但需点明使技能当前有用的具体机制。
  • 不得暗示底层数据无法支持的精度或新鲜度。
  • 使过期、未知或断开状态与健康状态在视觉上明显不同。
  • 在验证凭据、目标范围和回滚预期之前,不得依赖实时集成。

验证:检查结果是否包含上述所有交付物;检查已确认事实、假设和推断是否清晰分离;检查哪些部分是具体行动、哪些是框架,以便用户分辨当前真实可用的内容;在信任针对实时目标的过程前,检查活动 Hermes 运行时中所需环境变量和二进制。

示例调用:/dancing-lights design a small status display for this workflow and make the signal states unambiguous