Плагины
Плагины добавляют в GrigDesk свои панели, серверные функции и данные исполнителей. Можно установить готовый пакет или собрать инструмент под свой рабочий процесс.
Начните с установки плагина. Готовые пакеты можно посмотреть в каталоге сайта и в «Настройки → Плагины → Каталог» приложения. Сайт помогает выбрать источник; установка выполняется в GrigDesk.
Что может добавить плагин
| Возможность | Как это работает |
|---|---|
| Своя панель | Компонент Vue внутри окна GrigDesk с общими кнопками, полями и диалогами. |
| Серверная функция | Обработчики под /api/ext/<id>/, работа с данными и сервисами ядра. |
| Данные исполнителя | Объявленный блок provider-usage во всплывающей панели исполнителя. |
| Настройки | Поля в общей странице настроек плагина, доступные его коду. |
| Документация для агента | Оглавление docs/README.md внутри установленного пакета. |
Сервер и панель независимы: для простого инструмента достаточно одной панели. Плагин без объявления панели не получает отдельного пункта навигации.
Встраивание в интерфейс GrigDesk
Плагин может стать частью рабочего окна: добавить свой пункт навигации, открыть панель рядом с разговором или показать блок в предусмотренном месте существующего экрана. Панели используют общую тему, язык и библиотеку компонентов @grigdesk/ui — кнопки, поля, вкладки и диалоги.
Для своей панели автор выбирает группу навигации: rail, tools или dock. В широком окне она может работать в боковой панели; в узком открывается как отдельная страница внутри GrigDesk.
Для встраивания в существующий экран служат слоты — точки расширения, которые предоставляет ядро. Сейчас пользовательский пакет может добавить данные исполнителя под полосами его лимитов во всплывающем окне верхней панели. Этот слот принимает данные JSON; их отображает сам GrigDesk. Панель и такой блок могут входить в один плагин.
Объявления и пример описаны в структуре плагина.
Системные и пользовательские
Системные возможности поставляются вместе с GrigDesk. Их параметры находятся на соответствующих страницах настроек. Например, «Код», SSH и Docker уже входят в приложение.
Пользовательский плагин — отдельный пакет с plugin.json, собственными файлами и версиями. Его можно установить из Git, обновить, откатить или удалить. Вкладка «Установленные» в настройках плагинов показывает такие пакеты.
Метки «Официальный» и «Сообщество» указывают происхождение пакета. Код плагина выполняется с правами GrigDesk; выбирайте источник, которому доверяете.
Если хотите создать свой
- Разберите структуру пакета: что объявляется в манифесте и где лежат файлы.
- Соберите первый плагин: небольшую панель со счётчиком, без сервера и npm-зависимостей.
- Добавляйте сервер, настройки и события по мере необходимости.
Актуальный формат
Руководство описывает единый манифест v1: api: 1, entrypoints и contributes. Прежние пакеты с api: 2, webModule или nav требуют переноса; одной замены номера API недостаточно. Перед установкой обновите сервер и используемые клиенты GrigDesk.