Local Workspace

Local Workspace делает источником токенов папку репозитория на вашем компьютере. Плагин читает и записывает файлы прямо на диск через SXL Bridge, а коммиты и push вы делаете привычным Git-клиентом или из IDE. Это режим для тех, кто правит токены и в Figma, и в коде на одной машине: изменения из редактора кода появляются в плагине сразу, без Pull.

Tokens при активном Local Workspace: в футере имя профиля с иконкой диска и состояние Watching.

#Что нужно

• SXL Bridge, запущенный на этом компьютере. Установка описана на странице Утилита Bridge.
• Клон репозитория с токенами на диске. Подойдёт и git worktree. Папка должна быть корнем репозитория: путь до неё указывается целиком.
• Плагин в Design Mode: в Dev Mode Local Workspace недоступен, там редактор кода работает только через Git.

#Создать профиль

Профиль описывает одну папку репозитория и относительные пути к токенам и данным внутри неё. Профилей может быть несколько, например по одному на каждый worktree.

1. Нажмите шестерёнку Sync settings в футере и откройте вкладку Local Workspace.
2. Нажмите New profile.

Вкладка Local Workspace без профилей: список пуст, ниже настройки Bridge.

3. Заполните форму и нажмите Create profile.

Заполненный профиль: имя, полный путь к корню репозитория и папка токенов относительно него.

Папки токенов и данных не должны вкладываться друг в друга.

Рядом с каждым полем пути есть кнопка с иконкой папки: она открывает системный диалог выбора папки через SXL Bridge (нужен Bridge версии 1.10.0 или новее). Кнопка у Exact Git root подставляет полный путь, кнопки у Tokens path и Data path — путь относительно корня; выбранные папки токенов и данных должны находиться внутри корня репозитория. Если Bridge не умеет открывать диалог, кнопок не будет — пути всегда можно вписать вручную.

Созданный профиль в списке: путь, папки токенов и данных, кнопка Activate. Ниже порт Bridge и необязательный токен.

#Проверить Bridge

Внизу вкладки нажмите Test connection →. При успехе появится надпись Connected to SXL Bridge с номером версии.

Проверка прошла: плагин видит Bridge на порту 37830.

Если Bridge не отвечает, проверьте, что он запущен, и что порт в разделе Bridge совпадает с портом Bridge. Поле Bridge Auth Token заполняйте только если Bridge запущен с переменной BRIDGE_AUTH_TOKEN. Настройки Bridge сохраняются сами, кнопки Save здесь нет.

#Активировать профиль

Нажмите Activate у профиля. Плагин прочитает файлы из папки, покажет их в дереве и начнёт следить за изменениями на диске. У активного профиля появляется бейдж Active, а в футере имя профиля и состояние.

Активный профиль: бейдж Active, настройки Bridge заблокированы на время работы.

Состояния в футере и на вкладке:

Активный профиль можно править на месте: нажмите карандаш, измените имя или папки и нажмите Save and reopen — плагин переоткроет рабочую область из новых папок и продолжит следить за диском. Сохранение не пройдёт, пока в редакторе есть несохранённый черновик: сначала сохраните или отмените его. Чтобы удалить активный профиль или изменить настройки Bridge, по-прежнему сначала нажмите Use Plugin Local.

#Как это работает в ежедневной работе

• Сохранение файла в редакторе плагина сразу записывает его на диск. Кнопки Pull и Push в этом режиме не нужны: коммит и push делайте из Git-клиента.
• Изменение файла на диске, например из IDE или после git pull, плагин подхватывает сам: состояние на секунду становится Refreshing from disk, дерево обновляется.
• Экспорт переменных и стилей работает как обычно и записывает служебный файл Diff-ID прямо в папку.
• Переключение ветки в Git-клиенте плагин тоже заметит и перечитает файлы.

#Конфликт с черновиком

Если файл изменился на диске, а в редакторе плагина открыт этот же файл с несохранёнными правками, плагин не станет ничего перезаписывать и покажет баннер Local Workspace conflict со списком изменённых путей. Варианты:

• Discard Draft & Use Disk — отбросить черновик и загрузить версию с диска.
• Keep Editor — в текущей версии недоступно; скопируйте нужное из редактора, затем возьмите версию с диска.

Пока конфликт не разрешён, автоматическое обновление приостановлено, а переключение источника заблокировано.

#Вернуться к Git или Plugin Local

Нажмите на чип профиля в футере. В меню есть Use Plugin Local и Use Git · имя подключения. Перед переключением на Git плагин проверяет подключение: если репозиторий недоступен из-за сети, переключение всё равно произойдёт, а если подключение настроено неверно, Local Workspace останется активным и плагин покажет причину. Тот же список профилей доступен из меню, когда активен Plugin Local или Git.

Меню источника при активном Local Workspace.

Переключение заблокировано, пока в редакторе есть несохранённый черновик: сохраните или отмените изменения.

#Если что-то не работает

#См. также

• Источники токенов и синхронизация
• Утилита Bridge
• Диагностика