Home Assistant界面定制教程:Lovelace仪表盘8个技巧,打造极简又强大的智能家居面板
【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core
Home Assistant 的 Lovelace 仪表盘是一款开源、本地优先的智能家居面板定制工具,无需写代码就能把灯光、能源、地图等卡片自由排布成你心仪的主界面。本文将用 8 个实用技巧,带你快速把默认面板打造成既极简又强大的智能家居控制中心。
1. 先搞懂:三种仪表盘模式怎么选?
Lovelace 在源码中定义了三种配置模式,位于 homeassistant/components/lovelace/const.py:
| 模式 | 值 | 适合谁 |
|---|---|---|
| 存储模式(推荐) | storage | 新手,全程用图形界面编辑 |
| YAML 模式 | yaml | 喜欢用配置文件管理的高级用户 |
| 自动生成模式 | auto-gen | 过渡方案,自动生成基础视图 |
👉新手建议:保持默认的存储模式,所有改动都在浏览器里完成,改错了也能一键回退。
2. 技巧一:用 UI 编辑器,告别 YAML 报错
存储模式下,面板数据保存在本地.storage目录中。点击仪表盘右上角的"编辑"按钮,即可拖拽卡片、调整大小——这一切由 homeassistant/components/lovelace/websocket.py 中的 WebSocket 接口实时保存,无需重启服务。
💡 极简秘诀:把常用卡片放在第一屏,其余按"房间"分视图,用底部标签页切换。
3. 技巧二:创建多个仪表盘,各管一摊
你可以在"设置 → 仪表盘"中创建多个独立面板,每个面板有自己的 url_path(如energy、floor-2)、标题和图标。
- URL 路径需要包含连字符(
-),这是init.py 中的硬性校验规则 - 每个仪表盘可独立设置"是否在侧边栏显示"
把"总览""地图""能耗"拆成三个面板,主面板立刻清爽一半。
4. 技巧三:自定义侧边栏图标,打造专属导航
每个仪表盘的侧边栏图标可自由选择 Material Design 图标,默认图标是mdi:view-dashboard(见 const.py)。例如:
- 总览面板 →
mdi:home-variant - 地图面板 →
mdi:map - 能耗面板 →
mdi:bolt
一个合适的图标,是极简面板的第一印象。
5. 技巧四:资源管理,按需加载 JS / CSS 卡片
想在仪表盘中使用自定义卡片?通过"设置 → 仪表盘 → 资源"添加即可,支持js、css、module、html四种类型(定义于 const.py)。本地文件放在配置目录的www文件夹,通过/local/xxx.js引用;若文件缺失,系统会主动警告文件名大小写不匹配的问题(逻辑见init.py)。
修改资源后,可调用reload_resources服务热加载,服务定义见 services.yaml——不用重启 Home Assistant。
6. 技巧五:进阶用户迁移到 ui-lovelace.yaml
如果你希望仪表盘配置可以版本管理、方便备份,可在configuration.yaml中为面板指定 YAML 文件,默认文件名是ui-lovelace.yaml(常量定义见 const.py)。配置解析逻辑在 homeassistant/components/lovelace/init.py,每个 YAML 仪表盘都要求mode: yaml和filename两个字段。
📌 官方文档地址可在 manifest.json 的
documentation字段中找到,方便查阅完整语法。
7. 技巧六:一键生成位置地图面板
Lovelace 内置了"地图面板"能力:完成新手引导时会自动创建一个map面板,其配置仅为一个地图策略(见init.py)。在"设置 → 仪表盘"中手动新建时选择"地图"类型,即可把家庭成员、宠物、车辆等位置实体直接投射到地图上,极简又直观。
8. 技巧七:用 require_admin 保护敏感面板
涉及车库门、摄像头、报警系统的面板,建议开启"仅管理员可访问"。该字段 require_admin 在面板注册时会生效(见 _register_panel),普通家庭成员账号打开会看到 403 而非空白页,既极简又安全。
9. 技巧八:用 auto-gen 模式做平滑过渡
刚把一堆设备接入 Home Assistant(如 Matter、MQTT、Zigbee 等集成),还没有整理视图?先把模式设为auto-gen,系统会自动按设备生成基础仪表盘。等熟悉后,再逐步切换到storage模式手工美化——这是社区公认最顺滑的上手路径。
常见问题
Q:改错界面能恢复吗?存储模式的每次保存都有版本历史,可在编辑器的版本面板中回退。
Q:面板在侧边栏消失了?检查该仪表盘的show_in_sidebar是否被设为关闭,相关逻辑见 dashboard.py。
Q:旧版全局mode: yaml配置还会用吗?该写法已被标记弃用(见init.py),建议按修复提示改为逐面板定义,迁移指引见 strings.json。
总结
Lovelace 仪表盘的定制核心就八个字:多面板拆分、卡片做减法。配合存储模式的可视化编辑、资源热加载与管理员权限控制,即使是新手,也能在半天内打造出一个极简、稳定、可扩展的智能家居主面板。祝定制愉快 🏠
【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考