Local Storage
Когда внутреннего хранилища плагина не хватает: как включить Local Storage в Git-подключении, что для этого нужно от SXL Bridge, где лежит кэш и зачем нужен Bridge Auth Token.
Figma выделяет каждому плагину около 5 МБ внутреннего хранилища. Для большого набора токенов и данных Database этого мало: Pull может остановиться с сообщением о переполнении, а плагин будет работать медленно. Local Storage решает это: тяжёлые файлы хранятся на диске вашего компьютера через SXL Bridge, а плагин продолжает работать как обычно.
Local Storage — это настройка конкретного Git-подключения. В режимах Plugin Local и Local Workspace она не используется: Local Workspace и так работает с файлами на диске.
Когда включать
- Плагин показал сообщение Storage quota exceeded.
- В репозитории сотни файлов токенов или большие наборы данных и изображения для Database.
- Pull и переключение файлов стали заметно медленнее.
Для небольших проектов Local Storage не нужен, Git Sync работает и без Bridge.
Что нужно
Запущенный SXL Bridge на этом компьютере, порт по умолчанию 37830. Как установить и запустить Bridge, описано на странице Утилита Bridge. Проверить, что Bridge отвечает, можно на вкладке Diagnostics командой bridge.
Как включить
- Откройте Sync settings → Git Sync и нажмите на нужное подключение.
- В форме найдите карточку Local Storage и включите переключатель.
- Нажмите Save.
Карточка Local Storage в форме подключения: переключатель, ссылка на документацию и настройки Bridge.
Если Bridge не запущен, плагин не даст включить переключатель и покажет сообщение Local Storage requires SXL Bridge on http://127.0.0.1:37830 — start Bridge, then enable again. Запустите Bridge и повторите.
После включения сделайте Pull: файлы будут заново загружены из репозитория уже на диск.
Настройки в карточке
| Элемент | Для чего |
|---|---|
| Bridge Auth Token | Появляется, когда переключатель включён. Заполняйте, только если Bridge запущен с переменной окружения BRIDGE_AUTH_TOKEN; впишите то же значение. В обычной установке поле остаётся пустым. Это не токен GitHub и не токен Figma |
| Cache folder | Показывается у сохранённого подключения: точный путь к папке, где Bridge хранит файлы этого подключения. У каждого подключения своя папка, они не пересекаются |
| Open | Открывает папку кэша в Finder или Проводнике. Если Bridge не запущен, вместо пути будет подсказка Start SXL Bridge to locate the folder, а кнопка недоступна |
Файлы кэша хранятся только на вашем компьютере и никуда не отправляются.
Что меняется в работе
- Pull и Push работают как раньше, но перед операцией плагин проверяет, что Bridge доступен. Если Bridge выключен, операция остановится до того, как что-то изменится, с сообщением Local Storage requires SXL Bridge at http://127.0.0.1:37830 — start it, then retry Pull. Запустите Bridge и повторите.
- При следующем открытии плагина известное состояние показывается сразу, а из репозитория докачиваются только изменившиеся файлы.
- Remote Connect для Local Storage не нужен: достаточно запущенного Bridge.
Если что-то не работает
| Что видите | Что делать |
|---|---|
| Переключатель не включается | Bridge не запущен или слушает другой порт. Выполните bridge на вкладке Diagnostics |
| Pull останавливается с упоминанием Bridge | Запустите Bridge, проверьте порт и Bridge Auth Token, повторите Pull. Если Bridge нужен не сейчас, временно выключите Local Storage в подключении |
| Нужно очистить кэш | Нажмите Open и удалите содержимое папки. Следующий Pull загрузит файлы заново |