DeepSeek Harness: загрузка на основе зависимостей, автоматическая перезагрузка и вложенные контексты
Ранее мы уже изучили конечный автомат Fiber. В этой статье рассматривается, как конечный автомат управляется зависимостями сервисов.
Почему плагин автоматически выгружается, когда зависимый сервис исчезает? И почему он может автоматически перезагрузиться после восстановления сервиса?
Загрузка, управляемая зависимостями
Плагин, который объявляет inject, будет ждать, пока все необходимые сервисы будут готовы, прежде чем перейти в состояние LOADING и выполнить apply.
Этот механизм выражает порядок загрузки через зависимости сервисов, устраняя необходимость вручную управлять порядком запуска.
Пример
// Объявляем, что этот плагин зависит от двух сервисов: tools и llm
export const inject = ['tools', 'llm']
export function apply(ctx: Context) {
// На данный момент ctx.tools и ctx.llm готовы и безопасны для использования.
}
Если зависимый сервис исчезает (например, когда провайдер заменяется), плагин будет автоматически выгружен, переходя напрямую из ACTIVE в DISPOSED.
Когда сервис восстанавливается, плагин будет перезагружен, снова проходя через PENDING → LOADING → ACTIVE.
Точная формулировка из официальной документации: если зависимый сервис исчезает (например, когда провайдер заменяется), плагин будет автоматически выгружен (ACTIVE → DISPOSED) и перезагружен после восстановления сервиса.
Гарантия автоматической перезагрузки
Автоматическая перезагрузка безопасна, потому что все регистрации, сделанные через ctx, отзываются при выгрузке.
Слушатели, инструменты и адаптеры старого экземпляра не останутся; новый экземпляр зарегистрирует их заново.
Это предотвращает вызовы плагинами сервисов, которые больше не существуют, а также предотвращает дублирование слушателей или регистраций.
Вложенный контекст: ctx.plugin()
ctx.plugin() используется для регистрации подплагина внутри текущего плагина.
Дочерний плагин создаёт дочерний Fiber, который наследует родительский контекст, но имеет независимый жизненный цикл.
Дочерний Fiber будет выгружен вместе с родительским плагином.
Пример
export function apply(ctx: Context) {
// Регистрация дочернего плагина; childPlugin может быть функцией, объектом или подклассом Service
ctx.plugin(childPlugin)
// У подплагинов есть собственный Fiber, и они выгружаются вместе с родительским плагином.
}
Вложенные контексты очень распространены при композиции плагинов: плагин-«агрегатор» объединяет несколько небольших плагинов и единообразно управляет их жизненными циклами.
Ручное досрочное завершение: fiber.dispose()
В большинстве случаев плагины выгружаются при уничтожении контекста, но иногда требуется досрочно завершить экземпляр плагина во время выполнения.
Объект Fiber, возвращаемый ctx.plugin(), предоставляет методdispose().
Пример
import type { Context } from '@deepseek-ai/cordis'
// Объявления типов: функции контекста и плагина (для иллюстрации)
declare const ctx: Context
declare function myPlugin(ctx: Context): void
// Создайте экземпляр плагина и получите его Fiber
const fiber = ctx.plugin(myPlugin)
// Вызовите dispose позже, когда потребуется ручное завершение
// Примечание: dispose возвращает Promise, поэтому дождитесь завершения асинхронной очистки
await fiber.dispose()
dispose гарантирует три вещи:
| Гарантия | Описание |
|---|---|
| Все регистрации удалены | Все регистрации, принадлежащие плагину — слушатели, инструменты, адаптеры и т. д. — отозваны. |
| Рекурсивная выгрузка подплагинов | Дочерние Fiber, созданные через ctx.plugin(), также будут очищены вместе. |
| Дождитесь завершения асинхронной очистки. | Возвращаемый Promise разрешается только после завершения всех асинхронных disposer-ов. |
Иными словами, когда await fiber.dispose() возвращает управление, этот плагин вместе со всем своим поддеревом полностью остановлен.
Итоговая самопроверка
Загрузка, управляемая зависимостями, заставляет плагины запускаться только тогда, когда сервисы готовы, автоматически выгружаться, когда сервисы исчезают, и автоматически перезагружаться, когда сервисы восстанавливаются; ctx.plugin() создаёт дочерние Fiber, которые можно рекурсивно выгружать.
Проверьте себя:
- Когда сервис, объявленный в inject, не готов, в каком состоянии остаётся плагин?
- Какова связь между дочерним Fiber, созданным ctx.plugin(), и родительским Fiber?
- Когда await fiber.dispose() возвращает управление, что гарантированно завершено?