Skip to Content

Каталог плагинов

Каталог плагинов — здесь находите, устанавливаете и запускаете маленькие инструменты. Плагин — это фрагмент с окном, хранится вместе с остальными фрагментами. Можно открыть и со вкладки Каталог окна поиска.

@codeexpander/plugin-timestamp
Install
Timestamp
ts
JSON format
json
QR code
qr

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 (рекомендуется)

Самый быстрый способ:

  1. Откройте Каталог плагинов из главного окна или окна поиска
  2. В разделе Установка введите имя пакета npm (например @codeexpander/plugin-timestamp)
  3. Нажмите Установить

Официальные плагины используют префикс @codeexpander/plugin-* и курируются командой.

Требования: на системе должны быть установлены Node.js и npm.

Из локальной папки

Если папка плагина уже на машине:

  1. Нажмите Импорт из папки
  2. Выберите папку с plugin.json и входным файлом
  3. Плагин сразу появляется в списке

Из ИИ (MCP)

Пусть ИИ создаёт плагины за вас:

  1. Включите сервер MCP в Настройки → MCP
  2. Подключите ИИ-помощника (Cursor, Claude Desktop и др.)
  3. Опишите, что нужно — например «Создай плагин, который конвертирует CSV в таблицу Markdown»
  4. ИИ генерирует плагин и устанавливает автоматически

Управление плагинами

Просмотр и поиск

Каталог плагинов показывает все установленные плагины карточками. Поле поиска фильтрует по:

  • Имени — например «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

Ежедневно:

  1. Окно поиска → ts + вставка timestamp → мгновенная конвертация
  2. Окно поиска → json + вставка JSON → формат и проверка
  3. Окно поиска → color + вставка HEX → RGB/HSL

Автор контента

Установите: @codeexpander/plugin-qr, @codeexpander/plugin-base64

  1. Окно поиска → qr + вставка URL → картинка QR-кода
  2. Окно поиска → b64 + вставка текста → кодирование/декодирование Base64

Внутренние плагины команды

Команда делает внутренние плагины для:

  • генерации подписи корпоративного API
  • внутренних шаблонов документов
  • запуска команд деплоя

Делитесь через приватный реестр npm или синхронизацию локальной папки.

Бэкенд плагинов

Одни плагины заканчиваются одним кликом. Другим нужно немного поработать. Откройте Настройки → Расширения → Бэкенд плагинов, чтобы ограничить таймауты и сколько могут работать одновременно. Это остаётся на этом компьютере. Окна плагинов намеренно трогают меньше файлов, чем главное окно. При разработке в Настройках выберите разрешённые локальные папки.


Разработка плагинов

Нужен крошечный инструмент «выбрать дату, затем вставить». Второй продукт ставить не нужно. Плагин — фрагмент с режимом плагина, он может открыть своё маленькое окно.

Develop snippet plugin
Create from a template, import a folder, or use Cursor + CodeExpander MCP.
1Create a plugin
Use Cursor (MCP)Recommended

Enable the MCP server in Settings, then ask the AI to generate a snippet.

codeexpander-plugins

Public repo: spec and examples.

2Import into CodeExpander
Import from folder

Pick a folder with plugin.json and an entry file.

Choose folder
Import as dev linkLocal dev

Stores the manifest only; files are read live. Limited by dev_plugin_base_dirs.

Choose folder

Plugin 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

Обновлено