如何把Home Assistant变成全屋墙挂屏kiosk-mode新手完整入门指南【免费下载链接】kiosk-mode Hides the Home Assistant header and/or sidebar项目地址: https://gitcode.com/gh_mirrors/kio/kiosk-modekiosk-mode是 Home Assistant 的一款 Lovelace 插件核心功能是隐藏顶部标题栏header和/或侧边栏sidebar让你用一台平板、香橙派或闲置显示器把 Home Assistant 秒变成客厅的墙挂屏、卧室的信息屏或办公室的大屏仪表盘。整个过程无需改代码几分钟即可完成配置。kiosk-mode 能帮你做什么默认的 Home Assistant 界面带有顶栏和侧边菜单挂在墙上会显得不干净还可能让访客误触设置。kiosk-mode 可以帮你一键全屏kiosk选项同时隐藏标题栏 侧边栏只剩纯内容区域️细粒度控制只隐藏标题栏、只隐藏侧边栏或只隐藏搜索、通知、账户图标等单个元素⚙️弹窗瘦身点卡片弹出的 more-info 弹窗也能隐藏历史、日志、媒体/灯光/空调操作按钮等️防误触block_mouse完全锁定鼠标、block_context_menu屏蔽右键菜单适合真正的无人值守墙挂屏按用户/设备区分管理员可见完整界面访客或手机打开时自动进入全屏模式插件主逻辑位于 src/kiosk-mode.ts它会在每个 Lovelace 面板加载时读取配置并应用隐藏规则。kiosk-mode 安装步骤HACS 与手动两种方式⚠️ 安装前请先确认版本兼容Home Assistant 2026.6.0 及以上需 kiosk-mode v14.0.02025.10.0 以上需 v8.0.0。版本对应关系详见 README.md 开头的说明。方式一通过 HACS 安装推荐打开 HACS 面板搜索Kiosk Mode并点击进入点击右下角黄色Download按钮再确认下载如果你是 YAML 模式还需在configuration.yaml中手动添加资源frontend: extra_module_url: - /hacsfiles/kiosk-mode/kiosk-mode.js方式二手动安装从最新版本发布页下载kiosk-mode.js放入 Home Assistant 的www文件夹进入「设置 → 仪表盘」→ 右上角三个点 → 「资源」→ 「添加资源」URL 填写/local/kiosk-mode.js?v1.0.0版本号后缀很重要每次更新后改一下可避免浏览器加载缓存的旧版本如何配置 Home Assistant 隐藏 header 和 sidebar配置写在每个Lovelace 面板的根级别kiosk_mode:不要缩进且与views:平级。Storage 模式用户进入「编辑仪表盘」→ 右上角三个点 → 「Raw configuration editor」即可添加。最简示例一行开启完整 Kiosk 模式kiosk_mode: kiosk: true views:只想隐藏顶栏或侧边栏时分别使用hide_header: true和hide_sidebar: true还支持用模板动态控制例如通过一个开关实体控制侧边栏kiosk_mode: hide_header: true hide_sidebar: {{ is_state(input_boolean.hide_sidebar, on) }} views:看懂这张图kiosk-mode 所有可隐藏元素速查官方提供了一张标注图数字对应各配置项新手强烈建议收藏常用选项对照完整列表见 README.md选项作用kiosk同时隐藏标题栏和侧边栏hide_header/hide_sidebar只隐藏顶栏 / 侧边栏hide_settings/hide_account隐藏侧边栏设置项 / 账户图标hide_search/hide_assistant/hide_notifications隐藏搜索、语音助手、通知图标hide_overflow隐藏右上角溢出菜单block_mouse完全锁定鼠标仅可用?disable_km恢复hide_edit_dashboard隐藏编辑仪表盘入口more-info 弹窗也能瘦身隐藏弹窗按钮点击卡片弹出的详情弹窗默认带有一堆操作按钮墙挂屏场景下同样可以清理。例如媒体播放器弹窗对应选项如hide_dialog_media_actions、hide_dialog_history、hide_dialog_logbook等空调、灯光、计时器、更新等实体均有专属选项可按需组合。URL 参数快速启用 Kiosk 模式不用改配置不想动 YAML直接在地址栏加查询参数即可?kiosk—— 全屏模式?hide_header—— 只隐藏标题栏?hide_headerhide_sidebar—— 多参数用连接缓存技巧加cache后该设备的设置会被缓存所有视图和仪表盘都生效例如?hide_headercache。这是墙挂屏最省事的开启方式。配套的两个救命参数?disable_km—— 临时关闭 kiosk-mode方便自己调试?clear_km_cache—— 清除已缓存的设置进阶玩法模板与条件配置kiosk-mode 的选项支持JavaScript 模板[[[ ... ]]]客户端执行、更快和Jinja 模板{{ ... }}与 HA 模板语法一致返回布尔值即可。典型场景——不同用户看到不同界面kiosk_mode: hide_header: {{ user_name in (maykar, ryan meek) }} hide_sidebar: [[[ !user_is_admin ]]]如果需要更复杂的路由还可以使用条件配置块admin_settings、non_admin_settings、user_settings、mobile_settings默认 812px 以下视为手机可用custom_width调整断点。条件配置优先级最高适合管理员看全量、访客看全屏的家庭大屏方案。常见问题排查清单改完配置没生效刷新页面每个面板的配置是独立的其他仪表盘要重复添加默认仪表盘不生效HA 2023.12 之后的默认仪表盘由系统托管配置会被忽略需新建一个从零开始的仪表盘HACS 没自动加资源按上文 YAML 方式手动添加extra_module_url模板报错确认模板返回布尔值并可用debug: true让插件在浏览器控制台输出渲染详情方便定位❓想看选项实际效果截图项目内置了 Playwright 视觉回归测试全部快照在 tests/01 - main-options.spec.ts 对应的 test-snapshots 目录中每个配置项都有 1280×720 的实测截图写在最后kiosk-mode 的定位非常克制它只负责隐藏不改样式、不做主题。想要把标题栏移到底部、居中标签页这类美化需求可以搭配 Card Mod 等插件完成社区方案汇总在 KIOSK-MODE-COMPLEMENTS.md。一块闲置显示器 一台小主机 一段kiosk: true配置你的全屋墙挂屏就上线了 【免费下载链接】kiosk-mode Hides the Home Assistant header and/or sidebar项目地址: https://gitcode.com/gh_mirrors/kio/kiosk-mode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考