Cycle de vie des plugins DeepSeek Harness : machine à états Fiber

Dans les chapitres précédents, nous avons déjà enregistré des écouteurs, enregistré, etctx.effect()。

Vous êtes-vous déjà demandé : à quel moment exact un plugin commence-t-il à « s'exécuter », et à quel moment exact commence-t-il à « se décharger » ?

Cette section présente le modèle de plugin Cordis et la machine à états du cycle de vie, c'est-à-direla machine à états Fiber。


Qu'est-ce que Fiber ?

Chaque plugin chargé possède uneFiberportée.

Fiber peut être compris comme l'unité d'exécution d'une instance de plugin ; il porte tout l'état du plugin depuis la déclaration, le chargement et l'exécution jusqu'au déchargement.

Grâce à Fiber, le framework sait à quelle étape un plugin se trouve actuellement et ce qui peut être fait ensuite.

Fiber: un conteneur d'état pour une instance de plugin dans le runtime Cordis.

Il enregistre l'état du cycle de vie du plugin et constitue également la base pour nettoyer les enregistrements lors du déchargement.


Machine à états Fiber

Les états de Fiber évoluent dans l'ordre suivant, décrivant le cycle de vie complet d'un plugin depuis le chargement jusqu'au déchargement.

Fiber 状态机

Le chemin principal estPENDING → LOADING → ACTIVE → UNLOADING → DISPOSED。

Si apply lève une exception pendant l'étape LOADING, il entre dansFAILED。

StateSignificationQuand cela se produit
PENDINGDéclaré, mais les dépendances requises ne sont pas prêtesLe plugin a été ajouté au contexte, et les services injectés ne sont pas encore prêts.
LOADINGLes dépendances sont prêtes, et apply est en cours d'exécution.Tous les services requis sont prêts, et le framework appelle apply(ctx).
ACTIVEPlugin en cours d'exécutionapply retourne normalement, l'enregistrement prend effet
FAILEDapply lève une exceptionUne erreur est levée pendant l'exécution d'apply, et le chargement échoue.
UNLOADINGLe plugin se décharge et libère des ressourcesLes dépendances disparaissent, sont libérées, ou HMR déclenche le déchargement.
DISPOSEDEntièrement désinstalléToutes les fonctions de nettoyage ont été exécutées

Terminologie : inject est un champ dans lequel le plugin déclare ses dépendances de service requises. Le framework attend que tous ces services soient prêts avant d'exécuter apply.


Chargement piloté par les dépendances

Un plugin qui déclare inject attend que tous les services requis soient prêts avant d'entrer dans LOADING.

Si un service dépendant n'apparaît jamais, le plugin reste en PENDING et n'exécutera pas apply.

Exemple

// Chemin du fichier : scratch-plugin/src/my-plugin.ts
// Déclare que ce plugin requiert les services tools et llm ; apply ne s'exécutera pas tant que les deux ne sont pas prêts.
export const inject = ['tools', 'llm']

export function apply(ctx: Context) {
  // Lorsque l'exécution atteint ce point, ctx.tools et ctx.llm doivent déjà être prêts.
  // Vous pouvez enregistrer des outils en toute sécurité et lire la configuration du modèle.
}

C'est ainsi que Cordis utilise les dépendances de service pour exprimer l'ordre de chargement, plutôt que d'orchestrer manuellement une séquence de démarrage.


Mécanisme de nettoyage automatique

Tout enregistrement effectué via ctx sera automatiquement révoqué lorsque le plugin est déchargé.

C'est la raison fondamentale pour laquelle dsh peut « nettoyer derrière lui », et aussi la condition préalable pour que le remplacement à chaud prenne effet en toute sécurité.

Opération d'enregistrementNettoyage au déchargement
ctx.on(event, handler)Les écouteurs d'événements sont automatiquement supprimés
ctx.tools.register(tool)Suppression automatique de l'enregistrement des outils
ctx.llm.registerAdapter(names, adapter)Suppression automatique de l'enregistrement de l'adaptateur LLM
ctx.effect(() => cleanup)Le disposer retourné est exécuté lors du déchargement

Parmi eux, ctx.effect sert à gérer des ressources personnalisées qui n'ont pas de "registry" prêt à l'emploi pour les suivre, comme les connexions réseau.


L'ordre d'invocation des disposers

Lorsqu'un plugin se décharge, les disposers sont invoqués dans l'ordre inverse d'enregistrement.

Plusieurs disposers asynchrones s'exécutent simultanément ; rien ne garantit qu'ils se terminent un par un.

Les étapes de nettoyage ayant des dépendances d'ordre doivent être placées dans le même disposer renvoyé par ctx.effect(), et ce disposer est chargé de l'attente séquentielle.

Par exemple, si vous enregistrez les effects A et B dans l'ordre, lors du déchargement, le disposer de B est appelé en premier, puis celui de A.

Si le nettoyage de B doit attendre que celui de A soit terminé, les deux étapes doivent être écrites dans le même effect.


Exemple pratique : observer les transitions d'état

La documentation officielle utilise le plugin minimal suivant pour illustrer les journaux de chargement et de déchargement.

Exemple

// Chemin du fichier : scratch-plugin/src/lifecycle-log.ts
// Utilisez console.log pour afficher les événements du cycle de vie, observez l'ordre de apply et effect
export function apply(ctx: Context) {
  // apply est appelé : le plugin passe de LOADING à ACTIVE
  console.log('example plugin loading')

  // Enregistrer un effet : la fonction de nettoyage renvoyée est exécutée lors du démontage
  ctx.effect(() => {
    // Enregistrement de l'effet terminé (apply toujours en cours)
    console.log('example effect registered')
    // Renvoyer le disposer : appelé lorsque le plugin est déchargé
    return () => console.log('example effect cleaned up')
  })
}

Sortie au chargement :

example plugin loading
example effect registered

Sortie au déchargement :

example effect cleaned up

On peut voir que apply s'exécute d'abord, puis que l'enregistrement de l'effet est exécuté, et que le disposer renvoyé est appelé pendant la phase de déchargement.


Auto-test du résumé

La machine à états de Fiber décrit les six états d'un plugin, de la déclaration au déchargement complet ; les disposers nettoient les enregistrements de manière asynchrone et concurrente dans l'ordre inverse d'enregistrement.

Testez-vous :

  1. Quels sont les six états de Fiber ? Dans quel état entre-t-il lorsque apply lève une exception ?
  2. Pourquoi les écouteurs enregistrés via ctx.on ne nécessitent-ils pas d'appeler manuellement removeListener ?
  3. Si deux étapes de nettoyage ont des dépendances d'ordre, comment doivent-elles être écrites pour être sûres ?
autres extensions