Dépendances déclarées de DeepSeek Harness : inject et services intégrés

Précédemment, nous avons découvert des plugins qui s'exécutent indépendamment, mais la plupart des plugins dépendent d'autres capacités : registre d'outils, LLM, Agent.

Dans cette section, nous présenterons comment déclarer des dépendances et comment le framework garantit que les dépendances sont prêtes avant l'exécution de apply.


Qu'est-ce qu'un service ?

Un service est une capacité nommée qu'un plugin expose aux autres plugins.

Dans Harness, parmi eux, tools, llm, agents sont tous des Services ; ils sont chargés dans ctx sur : ctx.tools, ctx.llm, ctx.agents.

Service intégréDe quoi s'agit-ilUtilisation typique
ctx.toolsRuntime des outilsEnregistrer / Appeler des outils
ctx.llmService de grand modèle de langage (LLM)Enregistrer les adaptateurs, initier les requêtes de modèle
ctx.agentsService d'agentGérer les sous-agents

Déclarer les dépendances avec inject

Si votre plugin a besoin d'un service, écrivez-le dans le tableau inject.

Le framework garantit que votre plugin n'est chargé qu'une fois ces services prêts.

Exemple

// Chemin du fichier : scratch-plugin/src/my-tool-plugin.ts
import type { Context } from '@deepseek-ai/cordis'

export const name = 'my-tool-plugin'
// Déclarer une dépendance : nécessite le service tools
export const inject = ['tools']

export function apply(ctx: Context) {
  // Au moment où nous arrivons ici, ctx.tools est garanti prêt.
  ctx.tools.register(/* ... */)
}

Lorsque apply est exécuté, tous les services déclarés dans inject sont déjà prêts.

Ceci est garanti par le framework, donc vous n'avez pas besoin d'attendre quoi que ce soit dans votre code.


Dépendance non prête : le plugin attend

Si un service n'est pas prêt, le plugin ne s'exécutera pas.

Sa Fiber restera dans l'état PENDING, en attendant que le service apparaisse.

Dans le cycle de vie, PENDING signifie "déclaré, mais les dépendances requises ne sont pas prêtes."

依赖就绪后再加载插件

Si le service n'arrive jamais, le plugin continue d'attendre ; il ne générera pas d'erreur, et apply ne s'exécutera pas.


Dépendances requises et dépendances optionnelles

inject déclare les dépendances requises : le plugin n'est pas chargé lorsque le service est absent.

Si un service est optionnel, utilisez une dépendance optionnelle : ne l'incluez pas dans inject, et interrogez-le avec ctx.get() au moment de l'utilisation.

Exemple

// Dépendance optionnelle : omettez inject, utilisez ctx.get() pour interroger
import type { Context } from '@deepseek-ai/cordis'

export function apply(ctx: Context) {
  // Le service metrics peut être présent ou non
  const metrics = ctx.get('metrics')
  // Chaînage optionnel : ignorer s'il n'existe pas, pas d'erreur
  metrics?.record('plugin_loaded', 1)
}

Que se passe-t-il lorsqu'un service disparaît ?

Si un service requis disparaît pendant l'exécution (par exemple, le fournisseur est désinstallé), deux choses se produiront.

Premièrement, les plugins qui en dépendent seront automatiquement libérés (libération des ressources).

Deuxièmement, lorsque le service réapparaît, le plugin se recharge automatiquement.

Cela empêche le plugin d'appeler un service qui n'existe plus.

Astuce : cette règle fonctionne avec le nettoyage automatique — le déchargement déclenche le disposeur décrit dans la partie 8.


Résumé et auto-test

Utilisez inject pour déclarer les services requis, et le framework garantit que apply n'est exécuté qu'une fois que les services sont prêts ; interrogez les services optionnels avec ctx.get().

1. Que déclare le tableau inject ?

2. Dans quel état se trouve le plugin lorsque les services ne sont pas prêts ?

3. Comment les dépendances optionnelles doivent-elles être déclarées ?

autres extensions