Каталог плагинов
Каталог плагинов — здесь находите, устанавливаете и запускаете маленькие инструменты. Плагин — это фрагмент с окном, хранится вместе с остальными фрагментами. Можно открыть и со вкладки Каталог окна поиска.
Plugin Hub: install by npm package name. A plugin is a snippet with plugin_mode, not a separate table.
Что умеют плагины?
Плагины — мини-приложения внутри CodeExpander. Они могут:
- Добавлять свои инструменты — конвертеры timestamp, форматтеры JSON, пипетки, калькуляторы
- Обрабатывать файлы — перетащите файл в окно поиска, плагин разберёт и преобразует
- Встраиваться в процессы — QR-коды, кодирование/декодирование Base64, форматирование SQL
- Давать возможности с ИИ — ревью кода, автокомментарии, генерация тестов
Установка плагинов
Из npm (рекомендуется)
Самый быстрый способ:
- Откройте Каталог плагинов из главного окна или окна поиска
- В разделе Установка введите имя пакета npm (например
@codeexpander/plugin-timestamp) - Нажмите Установить
Официальные плагины используют префикс @codeexpander/plugin-* и курируются командой.
Требования: на системе должны быть установлены Node.js и npm.
Из локальной папки
Если папка плагина уже на машине:
- Нажмите Импорт из папки
- Выберите папку с
plugin.jsonи входным файлом - Плагин сразу появляется в списке
Из ИИ (MCP)
Пусть ИИ создаёт плагины за вас:
- Включите сервер MCP в Настройки → MCP
- Подключите ИИ-помощника (Cursor, Claude Desktop и др.)
- Опишите, что нужно — например «Создай плагин, который конвертирует CSV в таблицу Markdown»
- ИИ генерирует плагин и устанавливает автоматически
Управление плагинами
Просмотр и поиск
Каталог плагинов показывает все установленные плагины карточками. Поле поиска фильтрует по:
- Имени — например «timestamp»
- Категории — например «Инструменты разработчика», «Конвертеры»
- Описанию — поиск по ключевым словам
Запуск плагина
- Из каталога — клик по карточке открывает UI
- Из окна поиска — введите имя плагина или его команды
- С файлами — перетащите файлы в окно поиска; плагины, умеющие файлы, активируются сами
Закрепить и организовать
- Закрепить часто используемые плагины — они появятся в пустом состоянии окна поиска
- Скрыть редко используемые, чтобы меньше шума
- Удалить — убрать полностью
Анатомия плагина
Плагин по сути особый фрагмент с:
plugin.json— метаданные (имя, описание, иконка, категория, входной файл)- Входной файл — UI плагина (HTML/JS)
- Команды — опциональные ключевые слова для окна поиска
Пример: плагин «Конвертер timestamp» может задать:
- Команду:
ts— введитеts 1714392000в поиске для мгновенной конвертации - UI: визуальный выбор календаря при открытии из каталога
Создать свой плагин
Вариант 1: вручную (для разработчиков)
Создайте папку:
my-plugin/
plugin.json ← манифест
index.html ← UIПример plugin.json:
{
"main": "index.html",
"title": "My Plugin",
"description": "Does something useful",
"category": "Tools",
"features": [
{
"code": "myCmd",
"explain": "Run my command",
"cmds": ["my", "mp"]
}
]
}Импорт через Каталог плагинов → Импорт из папки.
Вариант 2: с помощью ИИ (для всех)
Опишите идею ИИ-помощнику, подключённому через MCP. ИИ:
- пишет HTML/JS
- создаёт манифест
- устанавливает автоматически
Пример промпта: «Создай плагин, который считает слова в выделенном тексте. Добавь команду wc для окна поиска.»
Безопасность
Плагины работают в маленьком окне с меньшими правами, чем главное приложение:
- они не могут напрямую листать вашу библиотеку фрагментов
- буфер обмена и toast ждут вашего разрешения
- список плагинов объявляет, какие возможности окна нужны; приложение это соблюдает
Типовые процессы
Набор разработчика
Установите: @codeexpander/plugin-timestamp, @codeexpander/plugin-json, @codeexpander/plugin-color
Ежедневно:
- Окно поиска →
ts+ вставка timestamp → мгновенная конвертация - Окно поиска →
json+ вставка JSON → формат и проверка - Окно поиска →
color+ вставка HEX → RGB/HSL
Автор контента
Установите: @codeexpander/plugin-qr, @codeexpander/plugin-base64
- Окно поиска →
qr+ вставка URL → картинка QR-кода - Окно поиска →
b64+ вставка текста → кодирование/декодирование Base64
Внутренние плагины команды
Команда делает внутренние плагины для:
- генерации подписи корпоративного API
- внутренних шаблонов документов
- запуска команд деплоя
Делитесь через приватный реестр npm или синхронизацию локальной папки.
Бэкенд плагинов
Одни плагины заканчиваются одним кликом. Другим нужно немного поработать. Откройте Настройки → Расширения → Бэкенд плагинов, чтобы ограничить таймауты и сколько могут работать одновременно. Это остаётся на этом компьютере. Окна плагинов намеренно трогают меньше файлов, чем главное окно. При разработке в Настройках выберите разрешённые локальные папки.
Разработка плагинов
Нужен крошечный инструмент «выбрать дату, затем вставить». Второй продукт ставить не нужно. Плагин — фрагмент с режимом плагина, он может открыть своё маленькое окно.
Enable the MCP server in Settings, then ask the AI to generate a snippet.
Public repo: spec and examples.
Pick a folder with plugin.json and an entry file.
Choose folderStores the manifest only; files are read live. Limited by dev_plugin_base_dirs.
Choose folderPlugin Dev window: step 1 create via Cursor MCP; step 2 import folder or soft-link. A plugin is a plugin_mode snippet, not another table.
| Путь | Когда |
|---|---|
| Окно разработки плагинов | Шаги из шаблона или импорт папки |
| Локальная папка | Манифест и входная страница уже в разрешённой папке |
| Каталог плагинов | Установка с рынка; становится фрагментом |
| MCP в Настройках | Попросите ИИ в редакторе сгенерировать фрагмент по спецификации |
Письменная спецификация — на карточке Настройки → MCP.
См. также: MCP