SXL Studio
Inspect

Cross-file Sync

Сравнение и синхронизация переменных из другого Figma-файла через Sync modal: требования, scope и текущее поведение.

Где находится инструмент

Cross-file Sync открывается из:

  • Footer -> Sync -> Cross-file Sync.

Он связан с inspect-сценариями, но расположен не внутри основной node-панели Inspect.

Что делает Cross-file Sync

Cross-file Sync сравнивает переменные из удаленного Figma-файла с локальными переменными текущего файла и применяет выбранные изменения.

Текущая реализация ориентирована на:

  • создание отсутствующих переменных;
  • обновление измененных значений переменных.

Автоматическое удаление локальных переменных не выполняется.

Что требуется

  • Figma File Key удаленного файла;
  • Personal Access Token с доступом к этому файлу;
  • тариф/доступ Figma API для GET /v1/files/:key/variables/local.

Если REST-доступ ограничен, плагин возвращает явное сообщение об ограничении enterprise/permissions.

Пошагово

  1. Откройте Sync -> Cross-file Sync.
  2. Введите File Key и Personal Access Token.
  3. Нажмите Compare Variables.
  4. Изучите результат по коллекциям.
  5. Отметьте записи для применения.
  6. Нажмите Sync N variables.
  7. Проверьте счетчики created/updated/errors.

Как сейчас работает сравнение

Ключ сопоставления remote/local:

  • collectionName + variableName

Сравнение значения сейчас выполняется по первому mode value: remote first mode vs local first mode.

Статусы в текущем compare/apply-потоке:

  • New (added)
  • Changed
  • Same

Removed существует как технический тип статуса, но сейчас не используется как apply-действие.

По умолчанию выбираются actionable записи added + changed.

Поведение применения

При применении выбранных записей:

  • отсутствующие коллекции создаются по имени;
  • переменные added создаются с типом и first-mode значением;
  • переменные changed обновляются в first mode локальной коллекции;
  • неподдерживаемые типы/ошибки записи попадают в errors.

Практические ограничения

  • Сравнение/применение ориентировано на значения, а не на полную parity метаданных.
  • Текущий apply-поток только add/update (без автоматических deletions).
  • Результат зависит от доступности Figma API, прав доступа и валидности токена.

Связанные разделы