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.
Le chemin principal estPENDING → LOADING → ACTIVE → UNLOADING → DISPOSED。
Si apply lève une exception pendant l'étape LOADING, il entre dansFAILED。
| State | Signification | Quand cela se produit |
|---|---|---|
| PENDING | Déclaré, mais les dépendances requises ne sont pas prêtes | Le plugin a été ajouté au contexte, et les services injectés ne sont pas encore prêts. |
| LOADING | Les 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). |
| ACTIVE | Plugin en cours d'exécution | apply retourne normalement, l'enregistrement prend effet |
| FAILED | apply lève une exception | Une erreur est levée pendant l'exécution d'apply, et le chargement échoue. |
| UNLOADING | Le plugin se décharge et libère des ressources | Les dépendances disparaissent, sont libérées, ou HMR déclenche le déchargement. |
| DISPOSED | Entiè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
// 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'enregistrement | Nettoyage 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
// 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 :
- Quels sont les six états de Fiber ? Dans quel état entre-t-il lorsque apply lève une exception ?
- Pourquoi les écouteurs enregistrés via ctx.on ne nécessitent-ils pas d'appeler manuellement removeListener ?
- Si deux étapes de nettoyage ont des dépendances d'ordre, comment doivent-elles être écrites pour être sûres ?