Ghost Heal
Как Ghost Heal чинит файл после удалённых режимов и коллекций: когда его запускать, что делает каждый переключатель в окне, какие настройки безопасны по умолчанию и как читать отчёт.
Ghost Heal приводит в порядок переменные файла, когда ссылки на них устарели: режимы и коллекции удалены, но макет всё ещё на них ссылается, появились дубли локальных коллекций, а привязки перестали разрешаться.
Типичные симптомы:
- в меню режимов на вкладке Tokens видны удалённые режимы или коллекции;
- привязка на слое есть, но переменная не находится;
- в файле две локальные коллекции с одним именем;
- после вставки из другого файла остались чужие ссылки.
Как запустить
- Откройте файл и вкладку Inspect.
- Внизу левой панели нажмите Ghost Heal.
- Проверьте переключатели в окне Ghost Heal и нажмите Run Ghost Heal.
- Прочитайте итог в уведомлении плагина.
Окно Ghost Heal: переключатели безопасного ремонта, пояснения и кнопка Run Ghost Heal.
Переключатели
По умолчанию включён безопасный набор: всё, кроме объединения коллекций.
| Переключатель | По умолчанию | Что делает | Риск |
|---|---|---|---|
| Clean explicit mode overrides | Вкл. | Убирает явные режимы на слоях и страницах, которые указывают на удалённые режимы или уже не нужны | Низкий |
| Rebind exact variable matches | Вкл. | Перепривязывает переменные из осиротевших коллекций на переменные с теми же именем, коллекцией и типом | Низкий: замена только при точном совпадении |
| Remove orphan local collections | Вкл. | Удаляет осиротевшие локальные коллекции после перепривязки | Средний: коллекции удаляются |
| Merge visible duplicate collections | Выкл. | Объединяет локальные коллекции с одинаковыми именами в одну | Средний или высокий: меняет структуру переменных |
| Force-clean unresolved ghosts | Вкл. | Отвязывает привязки, для которых источник так и не нашёлся, и при необходимости пересоздаёт текстовые слои | Средний: слои теряют такие привязки |
Под переключателями окно напоминает: Force-clean отвязывает неразрешимые привязки на затронутых слоях и может изменить их связь с токенами.
Область лечения
Если включены и Remove orphan local collections, и Rebind exact variable matches, Ghost Heal проходит весь документ. В остальных случаях он работает с текущей страницей. Диагностика оставшихся ссылок выполняется всегда в конце.
Как читать отчёт
В уведомлении после запуска перечислены счётчики: сколько явных режимов очищено, сколько привязок перепривязано, сколько коллекций удалено, сколько слоёв очищено принудительно и сколько текстовых слоёв пересоздано. Если часть ссылок осталась, плагин сообщает их число, а не меняет что-то наугад.
Рекомендуемый порядок
- Запустите Ghost Heal с настройками по умолчанию.
- Если остались неразрешённые ссылки, проверьте, есть ли в файле переменные с теми же именами и типами, подключите нужные библиотеки и установите шрифты, затем запустите снова.
- Включайте Merge visible duplicate collections только если действительно хотите объединить коллекции.
- Для переезда на другую библиотеку после лечения используйте Swap.
Ограничения Figma
Часть ссылок на удалённые режимы Figma позволяет только увидеть, но не удалить средствами плагина. Такие случаи попадают в отчёт как неразрешённые.