用途:以编程方式构建 Home Assistant Lovelace 仪表盘卡片,提供可复用的 Python 工具函数,配合 Python 仪表盘构建器与 YAML 配置使用。
主要能力:add_static_title_to_mini_graph 通过 card_mod CSS 的 ::after 伪元素固定 mini-graph-card 标题,避免多实体悬停时标题变为实体名;add_color_gradient_to_mini_graph 按阈值添加颜色渐变(会移除实体固定颜色);create_bubble_separator 生成分区标题,enhanced=True 时带渐变背景;create_info_card 生成带彩色边框的说明卡片;COLOR_SCHEMES 提供温度、湿度、空气质量等预设阈值。
使用方式:from ha_card_utils import add_static_title_to_mini_graph, add_color_gradient_to_mini_graph, create_bubble_separator, COLOR_SCHEMES;将卡片 dict 传入函数,函数原地修改;再通过 WebSocket API 或手动 YAML 保存仪表盘。常见模式包括 1 小时/24 小时/1 周的三图横排布局,以及“增强分隔符→子分区→传感器卡片→子分区→图表行”的分区结构。
适用场景:多实体时间范围对比图、温度/湿度/空气质量等带阈值反馈的传感器历史图、仪表盘分区组织与说明卡片。
限制与要求:需通过 HACS 安装 card-mod、mini-graph-card、bubble-card,mushroom 为可选;Python 3.10+,依赖 websocket-client;建议 Home Assistant 2023.5+ 并启用 Lovelace、配置长期访问令牌。使用渐变时需移除实体颜色,否则渐变不生效;标题仍变化通常因 card-mod 未安装或 CSS 语法错误。资料未提供收费、价格与效果保证信息。