快捷栏

快捷栏 允许你快速查找实体或运行命令，而无需离开当前视图（类似于 VS Code、Chrome 开发者工具等中的“快速打开”功能）。

它可以通过 热键 在前端的任何地方启动。

用于访问实体和运行命令的快捷栏

热键

从应用程序的任何地方输入这些热键以启动对话框。

实体过滤器

热键: e

类似于 设置 -> 设备与服务 -> 实体，但更轻量级且可以在前端的任何地方访问。

快捷栏的实体过滤器模式

启动后，开始输入你的实体 ID（或 你的实体 ID 的“片段”）以获得过滤后的实体列表。点击某个实体（或在所需实体被高亮时按 enter）将打开该实体的“更多信息”对话框。

这在你正在编写自动化并需要快速了解某个实体的情况，而又不想切换到开发者工具时特别有用。

设备过滤器

热键: d

类似于 设置 -> 设备与服务 -> 设备，但可以在前端的任何地方访问。

启动后，开始输入你的设备名称以获得过滤后的设备列表。点击某个设备（或在所需设备被高亮时按 enter）将打开所选设备的详细页面。

这在你需要快速访问某个设备的详细页面而不想通过菜单浏览时特别有用。

命令调色板

热键: c

在任何地方运行各种命令，而无需切换到其他视图。

在快捷栏的“命令调色板”中运行命令

当前支持的命令

我的链接

热键: m

从用户界面中的任何支持页面创建 my 链接，当在支持页面上调用时，它将打开一个新标签页，允许你以不同格式分享链接。

助手

热键: a

打开助手对话框，通过语音或文本与 Home Assistant 进行交互。 此功能仅在你设置了语音助手时可用。

了解更多关于 语音助手 的信息。

禁用快捷键

你可以通过访问用户个人资料并点击“键盘快捷键”切换按钮来启用或禁用 Home Assistant 的所有键盘快捷键。

Home Assistant 添加的启用/禁用键盘快捷键的切换按钮。

提示

按“片段”搜索而不是精确子字符串

我们知道像“light.ch”应该匹配“light.chandelier”。类似地，“telev”应该匹配“media_player.television”。

但使用快捷栏时，“lich”也会匹配“light.chandelier”，而“plyrtv”也会匹配“media_player.television”。它检查的是字母 顺序 而不是精确子字符串。

这个用例的一个好处是，你可以只用几个字母和一个句点快速过滤出整个实体域。例如，“li.”将匹配任何“light.*” 实体。继续输入“li.ch”可以立即找到吊灯。

过滤器也适用于友好名称

如果“light.hue_ceiling_light”被命名为“吊灯”，你可以输入“hue_ceil”或“chand”来查找它。

随时使用回车键打开列表中的顶部结果

一旦你想要的项目出现在过滤结果的顶部，只需按“enter”来激活它——无需向下移动到该项目，或用鼠标点击。

使用箭头键在列表中移动

在文本字段中，使用向下箭头 ↓ 向下浏览项目列表。按 enter 来激活当前高亮的行。

在项目列表中，使用向上箭头 ↑ 向上浏览项目列表，并返回文本字段。

输入更多字母将始终添加到你的过滤字符串

假设你刚用箭头键导航到列表的中间，并想要向过滤器添加更多文本。你不需要点击回文本字段，只需开始输入新字母，它们将附加到你的过滤器中。

故障排除

使用热键无法启动对话框

快捷栏对话框无法启动的原因可能有几个：

1. 你的用户不是管理员。
2. 应用程序失去焦点。尝试点击应用程序的主内容区域，然后再次输入快捷键。
3. 你在用户个人资料设置中禁用了键盘快捷键。
4. 浏览器将快捷键标记为不可重写。例如，Firefox 对某些快捷键如此处理。但目前用于快捷栏的单键快捷键不应该有问题。
5. 其他应用程序或浏览器扩展正在使用或覆盖该快捷键。尝试禁用该扩展。

缺少命令

命令列表仅显示根据你的用户设置和加载的集成对你可用的命令。

例如，如果你的配置中没有 automations:，那么你将看不到“重新加载自动化”命令。

如果“高级模式”在用户设置中关闭，则与高级模式相关的任何命令将不会出现在列表中。

如果你认为有缺少的命令，请在 GitHub 上创建一个问题。

快捷键干扰辅助工具、浏览器扩展，或其他造成不便

你可以在用户设置中 禁用快捷键。

请考虑提交一个问题，解释为什么快捷键对你造成了干扰。键盘快捷键是 Home Assistant 的新特性，正确设置它们对于任何 Web 应用程序都是一个挑战。我们依靠用户反馈来确保体验尽可能不干扰。