Установить плагин
Установка проходит в три этапа: выбрать источник, проверить подготовленный пакет и подтвердить установку. После этого новый плагин нужно включить.
Из каталога
- Откройте «Настройки → Плагины → Каталог».
- Выберите пакет, прочитайте описание и выберите версию.
- Запустите установку из карточки. GrigDesk подготовит пакет и покажет сведения для проверки.
- Проверьте репозиторий, тег, SHA коммита, список изменений и сообщения операции. До подтверждения подготовленный пакет не заменяет установленный.
- Нажмите «Установить» в окне проверки и дождитесь результата.
- Во вкладке «Установленные» выберите плагин, включите его, задайте необходимые параметры и нажмите «Применить».
Если плагин объявляет панель, она появится в указанной автором группе навигации. Аккаунты, ключи и внешние программы настраиваются по руководству самого плагина.
Из Git-репозитория
Этот путь подходит для собственного плагина или пакета, которого нет в каталоге.
- В разделе «Настройки → Плагины» нажмите «Установить из Git…».
- Укажите адрес репозитория и нажмите «Найти версии».
- Выберите стабильную версию и нажмите «Скачать и проверить».
- Проверьте подготовленный пакет, подтвердите установку и включите плагин, как описано выше.
Установщик ищет теги вида vX.Y.Z, например v1.0.0. Поле version в корневом plugin.json должно совпадать с тегом без v. Ветки main, произвольные имена и предварительные версии не входят в этот список. Устанавливается конкретный коммит выбранного тега.
Поддерживаются HTTPS, SSH, форма git@хост:путь и file:///путь. Доступ к приватному репозиторию должен быть настроен на машине сервера GrigDesk. Для SSH нужен ключ без интерактивного запроса пароля и заранее доверенный ключ хоста.
Обновление и откат
В карточке установленного пакета откройте «Источник и обновления» и нажмите «Проверить обновления». Доступную версию сначала готовят и проверяют, затем применяют отдельным подтверждением. Автоматической проверки обновлений нет.
Предыдущую сохранённую версию можно вернуть кнопкой «Вернуть v…», если откат доступен. Он восстанавливает пакет с зависимостями; рабочие данные плагина хранятся отдельно и не откатываются вместе с кодом.
Первое включение, обычное обновление и откат подключают совместимый пакет без перезапуска GrigDesk. Если операция сообщает, что версия ждёт перезапуска, следуйте этому сообщению: резервный путь применяется при следующем запуске.
Ручные правки установленной копии останавливают обычное обновление. Действие «Отложить правки в резерв и поставить версию начисто» сохраняет прежнюю копию перед заменой.
Если что-то пошло не так
| Ситуация | Что проверить |
|---|---|
| Список версий пуст | Есть ли в источнике стабильные теги vX.Y.Z и доступен ли он серверу. |
| Пакет несовместим | Причину в карточке, версию GrigDesk и формат манифеста. |
| Плагин включён, но пункта нет | Объявлена ли панель; не скрыто ли конкретное размещение. |
| Окно установки закрыли | Откройте «Задание установки»: закрытие окна не отменяет работу. |
| Связь оборвалась при применении | Уточните результат исходной операции; не считайте разрыв связи отменой. |
| Требуется восстановление | Сначала разберите сообщение текущей операции; новая установка поверх неё заблокирована. |
Удаление пользовательского плагина убирает установленный пакет и его предыдущую версию. Сохранённые данные и настройки остаются. Для временного отключения достаточно выключить плагин и применить изменение.
Далее: структура плагина · создать первый плагин.