Плагинная архитектура JavaScript: как Cordis превращает каждый компонент в плагин

Обычно плагины расширяют инструмент снаружи: Webpack, Vite, Fastify предоставляют точки подключения, но внутри приложения компоненты по-прежнему связаны прямыми импортами и ручной инициализацией. Cordis предлагает следующий шаг: сделать плагинную систему не механизмом расширения, а основным способом композиции самого приложения. DeepSeek Harness (далее DSH) реализует этот принцип на практике, заявляя «Everything is a Plugin» для адаптеров моделей, инструментов, логов сессий и агентного цикла. Именно этот сдвиг делает тему актуальной для JS/TS-разработчиков, которые проектируют модульные продукты или подключают ИИ-компоненты динамически.

Чем композиция из плагинов отличается от расширяемого приложения?

В классической схеме есть привилегированное ядро и дополнения вокруг него. Ядро определяет поведение, плагины подключаются к заранее выделенным точкам. Это работает для CMS, редакторов, сборщиков, но сохраняет жёсткую границу между «настоящим приложением» и «надстройками».

Плагинная архитектура JavaScript в модели Cordis устроена иначе. Значительная часть того, что прежде считалось ядром, становится обычными компонентами, подчинёнными общей модели. Вместо большого функционального ядра появляется небольшой composition runtime (среда композиции, которая управляет правилами подключения, зависимостями и жизненным циклом). Бизнес-логика остаётся внутри плагинов. Runtime не знает, как работает поиск или как вызывается модель, он знает, как эти возможности входят в систему и что происходит при изменении композиции.

Каждый компонент в такой среде описывается набором свойств:

• Предоставляемые возможности и требования к окружению
• Конфигурация и принадлежащие компоненту эффекты (побочные действия при запуске или остановке)
• Жизненный цикл (lifecycle), определяющий порядок запуска, обновления и очистки

Что понадобится

• Node.js версии 18+ и менеджер пакетов npm или yarn
• TypeScript (Cordis типизирован, без TS теряется основная выгода проверок на этапе компиляции)
• Базовое понимание, что такое плагин: модуль, который регистрирует свои возможности в общей среде и получает доступ к возможностям других модулей
• Около 40 минут на первый рабочий пример

Пошаговая инструкция

1. Установите Cordis и создайте пустой проект

mkdir my-plugin-app && cd my-plugin-app
npm init -y
npm install cordis typescript
npx tsc --init

1. Создайте файл среды композиции

// src/app.ts
import { Context } from 'cordis'

const app = new Context()

Context здесь играет роль composition runtime: он управляет деревом плагинов, их зависимостями и жизненным циклом.

1. Опишите первый плагин как функцию, принимающую контекст

// src/plugins/greeter.ts
import { Context } from 'cordis'

export function greeter(ctx: Context) {
  ctx.on('ready', () => {
    console.log('Greeter plugin started')
  })
  ctx.on('dispose', () => {
    console.log('Greeter plugin stopped')
  })
}

Плагин не знает о других плагинах напрямую. Он объявляет, что делает при старте и при остановке, а среда решает, когда это произойдёт.

1. Подключите плагин к дереву и запустите приложение

// src/app.ts
import { Context } from 'cordis'
import { greeter } from './plugins/greeter'

const app = new Context()
app.plugin(greeter)
app.start()

1. Добавьте второй плагин, который зависит от первого

В Cordis зависимости выражаются через сервисы. Плагин объявляет, какой сервис он предоставляет, а другой плагин указывает, какой сервис ему нужен. Runtime запускает зависимый плагин только тогда, когда нужный сервис доступен.

// src/plugins/logger.ts
import { Context } from 'cordis'

export function logger(ctx: Context) {
  // этот плагин активируется, только когда сервис 'database' доступен
  ctx.inject(['database'], (ctx) => {
    ctx.on('ready', () => {
      console.log('Logger: database service is available')
    })
  })
}

1. Проверьте горячее подключение: удалите плагин без перезапуска

const fork = app.plugin(greeter)
// позже:
fork.dispose() // плагин корректно остановлен, эффекты очищены

Именно этот механизм делает плагинную архитектуру JavaScript в Cordis пригодной для динамической загрузки ИИ-компонентов: адаптер модели или инструмент агента можно подключить и отключить на лету.

Три способа доставки плагинов на клиент

Cordis работает одинаково на сервере и в браузере, но механизм загрузки кода различается. Источник описывает три подхода:

• Виртуальные модули в общем графе сборки. Плагины включаются в единый бандл на этапе сборки. Просто, но не позволяет подключать плагины после деплоя.
• Module Federation. Технология Webpack 5, позволяющая связывать независимые сборки во время выполнения. Каждый плагин собирается отдельно и загружается браузером по запросу.
• Собственная модульная система DSH. DeepSeek Harness использует специализированный механизм загрузки, при котором браузер запускает собственное Cordis-дерево. UI-возможности представлены динамически загружаемыми плагинами, как и серверные компоненты.

// Регистрация нового адаптера модели как плагина
app.plugin(deepseekAdapter, {
  model: 'deepseek-v3',
  endpoint: 'https://api.deepseek.com/v1'
})

Cordis и Kubernetes: похожая идея, другой масштаб

Источник проводит аналогию между Cordis и микросервисами. Kubernetes (система оркестрации контейнеров, управляющая тем, какие сервисы где запущены) решает похожую задачу на уровне инфраструктуры: декларативное описание, управление зависимостями, контроль жизненного цикла. Cordis делает то же самое, но внутри одного JS/TS-процесса и на уровне плагинов, а не контейнеров.

Для разработчика это означает: если вы привыкли думать о системе как о наборе независимо деплоящихся сервисов, Cordis даёт похожую модель мышления внутри приложения.

Что делать с этим прямо сейчас?

JS/TS-разработчику и архитектору. Попробуйте собрать один модуль существующего проекта как Cordis-плагин. Если у вас есть компонент, который инициализируется вручную и требует очистки при отключении, это первый кандидат. Выигрыш: явный жизненный цикл и автоматическая очистка эффектов.

Тем, кто работает с ИИ-агентами. Модель DSH, где адаптеры моделей и агентные циклы являются плагинами, решает конкретную проблему: переключение между моделями или добавление инструментов без перезапуска и без правки ядра. Из доступных в РФ моделей для экспериментов подойдут те, что предоставляют API-эндпоинт: GigaChat, YandexGPT.

Техлиду, управляющему несколькими командами. Cordis полезен там, где независимые команды (или ИИ-агенты) развивают разные части продукта. Каждая команда владеет своим набором плагинов, а composition runtime гарантирует, что подключение нового плагина не сломает чужие компоненты.

Если вы строите продукт, в котором состав возможностей меняется чаще, чем выходят релизы, стоит потратить час на эксперимент с Cordis: соберите один реальный модуль как плагин и убедитесь, что dispose работает чисто. Это минимальная проверка, которая покажет, подходит ли модель вашему проекту.