Как редактировать скрытые файлы Home Assistant с помощью Visual Studio Code?

В Home Assistant часть важных файлов хранится в скрытой папке .storage, и через стандартный File editor их не видно. В статье разбирается, как установить аддон Visual Studio Code, открыть эти файлы и удобно работать с ними прямо из интерфейса HA.

Как редактировать скрытые файлы Home Assistant с помощью Visual Studio Code?

В Home Assistant дашборды можно хранить двумя способами:

  • YAML-режим — все конфигурации панелей находятся в файле ui-lovelace.yaml.
  • Storage-режим (используется по умолчанию) — каждый дашборд сохраняется во внутренней папке .storage в формате JSON.

Во втором случае привычный File editor не показывает эти скрытые файлы. Пользователь видит только визуальный редактор интерфейса, но не может напрямую открыть системные файлы. Например, дашборд по потребляемой и производимой энергии в таком режиме будет лежать в .storage как отдельный файл lovelace.dashboard_energy.

Проблема и решение

Когда возникает задача объединить конфигурации, скопировать дашборд или сделать резервную копию, отсутствие доступа к скрытым файлам становится серьёзным ограничением.
Решение простое: установить аддон Studio Code Server (Visual Studio Code). Он открывает полный доступ ко всем папкам Home Assistant, включая .storage, и предоставляет удобный редактор с подсветкой синтаксиса прямо в интерфейсе.

Установка Studio Code Server

  1. Перейдите в Настройки → Дополнения → Магазин дополнений
  2. Найдите и установите Studio Code Server
  3. После установки включите:
    • Start on boot (автозапуск),
    • Watchdog (перезапуск при сбое),
    • Show in sidebar (отображение в боковом меню).
  4. Запустите аддон

Теперь в левом меню появится полноценный VS Code, доступный прямо в браузере.

Работа со скрытыми файлами

В открывшемся VS Code можно зайти в каталог /config/.storage/. Именно здесь хранятся «невидимые» файлы Home Assistant:

  • lovelace — основной дашборд,
  • lovelace.dashboard_energy — дашборд по потребляемой и производимой энергии,
  • lovelace_resources, lovelace_dashboards — служебные конфиги.

Все они доступны для чтения и редактирования как обычные JSON-файлы.

Итог

Скрытые файлы Home Assistant — это не секретные данные, а системные настройки, которые по умолчанию не отображаются для безопасности. Установка VS Code аддона делает их доступными и позволяет работать с ними так же удобно, как с YAML-конфигурациями. Это открывает новые возможности для настройки дашбордов, бэкапов и кастомизации системы.

Если нужно работать только с привычными YAML-конфигурациями (configuration.yaml, automations.yaml, ui-lovelace.yaml), то достаточно встроенного File Editor. Он проще и подходит для быстрых правок.