Диагностика
Вкладка Diagnostics: как проверить подключение, Bridge и состояние токенов, что показывают команды status, diag и test, как собрать отчёт для поддержки.
Вкладка Diagnostics в окне Synchronization settings отвечает на вопрос «почему не работает» без переписки с поддержкой. Команды выполняются внутри плагина, ничего не отправляют наружу и никогда не печатают токены доступа.
Вкладка Diagnostics сразу после открытия: приветственная строка, поле команды с подсказками и кнопки Run, Copy log и Clear.
Как открыть
- Нажмите шестерёнку Sync settings в правой части футера плагина.
- Перейдите на вкладку Diagnostics.
- Введите команду в поле внизу и нажмите Enter. Стрелки ↑ и ↓ листают историю команд.
Кнопка Run выполняет полную проверку, то же, что команда diag. Copy log копирует весь вывод в буфер обмена, Clear очищает панель. Надпись read-only mode означает, что доступны только безопасные команды; режим с расширенными командами включает поддержка по коду.
Команды
| Команда | Что показывает |
|---|---|
help | Список команд |
status | Активный источник и подключение, ключ файла Figma, состояние служебного файла Diff-ID, число файлов токенов, состояние Local Workspace, очередь операций документа и последние сохранения |
diag | Полная проверка: каждое сохранённое подключение, Bridge, Diff-ID. Результат уже очищен от секретов и годится для отправки в поддержку |
test [имя] | Проверка одного подключения, та же, что кнопка Test connection в форме. Без имени проверяется активное |
bridge | Доступен ли SXL Bridge на настроенном порту и какие профили Local Workspace он знает |
diffid [имя] | Какой файл Diff-ID использует этот файл Figma и какие кандидаты есть в репозитории |
log | Последние операции Pull, Push, Refresh и переключения источника в этой сессии с их исходом |
storage | Сколько места занято во внутреннем хранилище плагина и есть ли файлы без содержимого |
ids | Сколько переменных, коллекций и стилей плагин видит в документе |
varshape [имя] | Как Figma хранит значения переменной. Нужна редко, по просьбе поддержки |
varprobe, composetest, apiscan, varscopes | Проверки Plugin API для поддержки: работают на временных переменных, которые сразу удаляются, и требуют режима unlock |
token [имя] | Тип и длина токена доступа подключения. Само значение не показывается |
pull, hard-pull | Запускают Pull или Hard Pull для активного подключения, как кнопки в футере |
switch git <имя>, switch local | Переключают источник на Git-подключение или на Plugin Local |
clear, copy | Очистить панель, скопировать лог |
Вывод команды status: источник, подключение, ключ файла, Diff-ID, токены, очередь операций и последние сохранения.
Что означают строки status
- source — активный источник:
git,plugin-localилиlocal-workspace. - active connection — имя подключения, провайдер, репозиторий и ветка, время последней проверки.
- identity — ключ файла Figma определён или нет. От него зависит имя служебного файла Diff-ID.
- ledger — есть ли локальный Diff-ID и связан ли он с этим файлом.
- tokens — сколько файлов токенов загружено и есть ли
config.json. - hydration / watch — состояние Local Workspace, если он активен.
- document operations — что сейчас делает плагин с документом Figma и сколько запросов ждёт очереди. Если здесь долго висит одна операция, именно она мешает сохранению.
- last token saves — последние сохранения файлов токенов с исходом и причиной ошибки.
Как отправить отчёт в поддержку
- Выполните
diagили нажмите Run. - Нажмите Copy log и вставьте текст в письмо или чат.
Второй способ, только для Git-источника: нажмите на чип ветки в футере и выберите Copy diagnostics. Отчёт тот же, токены доступа в него не попадают.
Типовые ситуации
| Что случилось | Что выполнить |
|---|---|
| Кнопка Save в редакторе не сохраняет файл | status: посмотрите строки document operations и last token saves. Там будет причина отказа или операция, которая держит очередь |
| Pull или Push завершаются ошибкой | test для активного подключения, затем log |
| Не открывается Local Workspace или не включается Local Storage | bridge: Bridge должен отвечать на порту 37830 |
| После экспорта переменные создались заново вместо обновления | diffid: проверьте, что у этого файла Figma есть свой Diff-ID и нет конфликтующих кандидатов |
| Плагин сообщает, что хранилище переполнено | storage, затем включите Local Storage в подключении |