如何快速配置Home Assistant Mini Graph Card：终极使用指南

如何快速配置Home Assistant Mini Graph Card：终极使用指南

【免费下载链接】mini-graph-cardMinimalistic graph card for Home Assistant Lovelace UI项目地址: https://gitcode.com/gh_mirrors/mi/mini-graph-card

Home Assistant Mini Graph Card是一款专为Home Assistant Lovelace界面设计的极简风格图表卡片，能够将传感器数据以优雅的折线图形式直观展示。这款卡片支持传感器和二进制传感器实体，既能显示当前状态，又能呈现历史数据变化趋势。

📋 安装方法详解

推荐方式：通过HACS安装

HACS（Home Assistant Community Store）是社区第三方商店，安装最为便捷：

1. 在HACS中搜索"Mini Graph Card"
2. 点击安装并重启Home Assistant
3. 在Lovelace界面添加资源引用

手动安装步骤

1. 下载最新版本的mini-graph-card-bundle.js文件
2. 将文件复制到config/www目录
3. 在Lovelace配置中添加资源引用

资源引用配置

在您的ui-lovelace.yaml文件中添加以下配置：

resources: - url: /local/mini-graph-card-bundle.js?v=0.13.0 type: module

🎯 基础配置快速上手

单实体卡片配置

最简单的配置方式，仅需指定实体ID：

type: custom:mini-graph-card entities: - sensor.illumination

多实体卡片配置

同时展示多个传感器的数据：

type: custom:mini-graph-card name: 服务器监控 icon: mdi:server entities: - entity: sensor.server_total name: 总流量 - sensor.server_sent - sensor.server_received

⚙️ 核心配置选项解析

必填选项

• type: 必须设置为custom:mini-graph-card
• entities: 传感器实体列表，支持单个或多个实体

常用可选配置

• name: 自定义卡片名称
• icon: 设置图标（使用MDI图标）
• hours_to_show: 显示历史数据的小时数，默认24小时
• show: 控制UI元素的显示/隐藏

🎨 高级定制技巧

图表样式定制

通过show选项可以精确控制卡片显示内容：

show: name: true # 显示名称 icon: true # 显示图标 state: true # 显示当前状态 graph: line # 图表类型：line/bar fill: true # 填充区域 legend: true # 图例（多实体时显示）

颜色动态变化

根据数值范围动态改变线条颜色：

color_thresholds: - value: 20 color: "#f39c12" - value: 21 color: "#d35400" - value: 21.5 color: "#c0392b"

柱状图展示

将图表类型切换为柱状图：

show: graph: bar

🔧 实用配置案例

温度监控卡片

type: custom:mini-graph-card entities: - sensor.living_room_temp name: 客厅温度 hours_to_show: 24 line_color: "#e74c3c" line_width: 3

能耗统计卡片

type: custom:mini-graph-card entities: - entity: sensor.energy_daily name: 日能耗统计 hours_to_show: 168 aggregate_func: max group_by: date show: graph: bar labels: true

💡 使用技巧与注意事项

性能优化建议

• 合理设置hours_to_show参数，避免加载过多历史数据
• 使用update_interval控制数据更新频率
• 启用cache选项提高加载速度

常见问题解决

如果卡片无法正常显示：

1. 检查资源引用是否正确
2. 确认实体ID是否存在
3. 清除浏览器缓存
4. 重启Home Assistant服务

🚀 进阶功能探索

双Y轴显示

为不同量级的传感器数据分别设置坐标轴：

entities: - entity: sensor.temperature y_axis: primary - entity: sensor.humidity y_axis: secondary

自定义聚合函数

根据需求选择不同的数据聚合方式：

• avg: 平均值
• min: 最小值
• max: 最大值
• sum: 求和值

📈 最佳实践总结

Mini Graph Card以其简洁的设计和强大的定制能力，成为Home Assistant用户首选的图表展示工具。通过合理配置各项参数，您可以创建出既美观又实用的监控界面。

记住关键配置要点：

• 先确保资源引用正确
• 从简单配置开始逐步完善
• 充分利用颜色和样式定制功能
• 根据实际需求选择合适的数据聚合方式

现在就开始使用Mini Graph Card，让您的Home Assistant仪表盘更加专业和直观！

【免费下载链接】mini-graph-cardMinimalistic graph card for Home Assistant Lovelace UI项目地址: https://gitcode.com/gh_mirrors/mi/mini-graph-card