Обзор
Inspect в SXL Studio: диагностика, восстановление, привязки токенов, Ghost Heal, Swap, Rebind, Composition Drift и cross-file sync переменных.
Что такое Inspect
Inspect — это рабочее пространство диагностики и восстановления для выбранных узлов Figma.
Используйте его, когда нужно:
- проверить привязки токенов/переменных/стилей в дереве узлов;
- восстановить broken или remote инстансы;
- очистить stale mode references (ghost modes/collections);
- сравнить компонент с Composition JSON и устранить drift;
- выполнить миграцию переменных/стилей между библиотеками.
Структура Inspect
1) Левое дерево
Левое дерево показывает иерархию текущего выделения и статусные бейджи:
- тип узла и имя;
- количество привязок на узел;
- состояние ссылки инстанса:
Linked,Remote,Broken; - счетчик ghost mode ссылок
!N; - маркер composition-связи.
Действия внизу дерева:
- Ghost Heal: открывает восстановление файла от ghost-артефактов.
- Swap libs & variables: открывает двухколоночный file/page swap.
2) Основная панель
Основная панель показывает детали выбранного узла.
В зависимости от типа узла и доступных фич доступны секции:
- Mode Diagnostics: explicit mode references и cleanup действия.
- Composition Tracking: статус
Linked/UnlinkedиRe-linkдля diff-id. - Out of Sync: summary drift +
Show DiffиRe-apply. - Instance Recovery: состояние инстанса +
Rebind/Rebind All. - Token Bindings: список привязок с
OverrideиUnlink.
3) Связанные действия вне панели
Часть inspect-сценариев находится рядом с Inspect:
- Header -> Rebind: быстрый вход в восстановление broken инстансов.
- Footer -> Sync modal -> Cross-file Sync: сравнение/применение переменных из другого файла.
Доступность по лицензии
Инструменты Inspect разделены по feature flags:
| Инструмент | Feature flag |
|---|---|
| Базовая вкладка Inspect | INSPECT |
| Swap / Swap libs & variables | TOKEN_SWAP |
| Rebind / Rebind All / Create Component | INSTANCE_REBIND |
| Composition Tracking / Drift / Re-apply | COMPOSITION |
Если фича недоступна в плане, действие отключается или возвращает уведомление о лицензии.
Рекомендованные сценарии
| Сценарий | Рекомендуемый путь |
|---|---|
| Нужно понять, что привязано на объекте | Выберите узел в дереве -> Token Bindings |
| Broken инстанс | Instance Recovery -> Rebind |
| Несколько broken дочерних инстансов | Выберите родителя -> Rebind All |
| В файле дубли/ghost modes | Левое дерево -> Ghost Heal |
| Миграция library/local переменных или стилей | Swap (инстансный поток) или Swap libs & variables (file/page поток) |
| Компонент расходится с Composition JSON | Out of Sync -> Show Diff -> Re-apply |
| Нужна синхронизация переменных из другого файла | Sync modal -> Cross-file Sync |
Ограничения Figma API
- При
dynamic-pageчасть ghost ссылок можно диагностировать, но не всегда полностью удалить через Plugin API. - Навигация к remote-компонентам зависит от доступа к библиотеке и состояния публикации.