DeepSeek Harness Plugin-Lebenszyklus: Fiber-Zustandsmaschine
In den vorherigen Kapiteln haben wir bereits Listener registriert, Tools registriert undctx.effect() geschrieben。
Hast du dich jemals gefragt: Zu welchem genauen Zeitpunkt beginnt ein Plugin zu "laufen", und zu welchem genauen Zeitpunkt beginnt es zu "entladen"?
Dieser Abschnitt stellt das Cordis-Plugin-Modell und die Lebenszyklus-Zustandsmaschine vor, d. h.Fiber-Zustandsmaschine。
Was ist Fiber
Jedes geladene Plugin hat einenFiberScope.
Fiber kann als Ausführungseinheit einer Plugin-Instanz verstanden werden; sie trägt den gesamten Zustand des Plugins von der Deklaration über das Laden und Ausführen bis zum Entladen.
Durch Fiber weiß das Framework, in welcher Phase sich ein Plugin gerade befindet und was als Nächstes getan werden kann.
Fiber: ein Zustandscontainer für eine Plugin-Instanz in der Cordis-Laufzeit.
Es zeichnet den Lebenszyklus-Zustand des Plugins auf und ist außerdem die Grundlage für das Aufräumen von Registrierungen beim Entladen.
Fiber-Zustandsmaschine
Die Fiber-Zustände wechseln in der folgenden Reihenfolge und beschreiben die vollständige Lebensdauer eines Plugins vom Laden bis zum Entladen.
Der Hauptpfad istPENDING → LOADING → ACTIVE → UNLOADING → DISPOSED。
Wenn apply während der LOADING-Phase eine Ausnahme auslöst, wechselt es zuFAILED。
| State | Bedeutung | Wann er auftritt |
|---|---|---|
| PENDING | Deklariert, aber erforderliche Abhängigkeiten sind nicht bereit | Das Plugin wurde dem Kontext hinzugefügt, und die Inject-Services sind noch nicht bereit. |
| LOADING | Abhängigkeiten sind bereit, und apply wird ausgeführt. | Alle erforderlichen Services sind bereit, und das Framework ruft apply(ctx) auf. |
| ACTIVE | Plugin läuft | apply gibt normal zurück, die Registrierung wird wirksam |
| FAILED | apply löst eine Ausnahme aus | Während der Ausführung von apply wird ein Fehler ausgelöst, und das Laden schlägt fehl. |
| UNLOADING | Plugin wird entladen und gibt Ressourcen frei | Abhängigkeiten verschwinden, werden freigegeben oder HMR löst das Entladen aus. |
| DISPOSED | Vollständig deinstalliert | Alle Disposer wurden ausgeführt |
Terminologie: inject ist ein Feld, in dem das Plugin seine erforderlichen Service-Abhängigkeiten deklariert. Das Framework wartet, bis alle diese Dienste bereit sind, bevor apply ausgeführt wird.
Abhängigkeitsgesteuertes Laden
Ein Plugin, das inject deklariert, wartet, bis alle erforderlichen Dienste bereit sind, bevor es in LOADING eintritt.
Wenn ein abhängiger Dienst niemals erscheint, bleibt das Plugin in PENDING und führt apply nicht aus.
Beispiel
// Deklarieren, dass dieses Plugin die Dienste tools und llm benötigt; apply wird nicht ausgeführt, bis beide bereit sind.
export const inject = ['tools', 'llm']
export function apply(ctx: Context) {
// Wenn die Ausführung diesen Punkt erreicht, müssen ctx.tools und ctx.llm bereits bereit sein.
// Du kannst Tools bedenkenlos registrieren und die Modellkonfiguration lesen.
}
So verwendet Cordis Dienstabhängigkeiten, um die Ladereihenfolge auszudrücken, anstatt manuell eine Startsequenz zu orchestrieren.
Automatischer Bereinigungsmechanismus
Jede über ctx vorgenommene Registrierung wird automatisch zurückgenommen, wenn das Plugin entladen wird.
Dies ist der grundlegende Grund, warum dsh "selbst aufräumen" kann, und auch die Voraussetzung dafür, dass Hot Replacement sicher wirksam wird.
| Registrierungsoperation | Bereinigung beim Entladen |
|---|---|
| ctx.on(event, handler) | Event-Listener werden automatisch entfernt |
| ctx.tools.register(tool) | Automatische Entfernung der Tool-Registrierung |
| ctx.llm.registerAdapter(names, adapter) | Automatische Entfernung der LLM-Adapter-Registrierung |
| ctx.effect(() => cleanup) | Der zurückgegebene Disposer wird beim Entladen ausgeführt |
Darunter wird ctx.effect verwendet, um benutzerdefinierte Ressourcen zu verwalten, für die es keine fertige "Registry" zum Nachverfolgen gibt, wie etwa Netzwerkverbindungen.
Die Aufrufreihenfolge der Disposer
Wenn ein Plugin entladen wird, werden Disposer in umgekehrter Reihenfolge ihrer Registrierung aufgerufen.
Mehrere asynchrone Disposer werden gleichzeitig ausgeführt; es gibt keine Garantie, dass sie nacheinander fertig werden.
Bereinigungsschritte mit Reihenfolgeabhängigkeiten müssen in denselben von ctx.effect() zurückgegebenen Disposer gelegt werden, und dieser Disposer ist für das serielle Warten verantwortlich.
Wenn Sie zum Beispiel Effects A und B nacheinander registrieren, wird beim Entladen zuerst der Disposer von B aufgerufen, dann der Disposer von A.
Wenn die Bereinigung von B warten muss, bis die Bereinigung von A abgeschlossen ist, müssen beide Schritte in denselben Effect geschrieben werden.
Praxisbeispiel: Zustandsübergänge beobachten
Die offizielle Dokumentation verwendet das folgende minimale Plugin, um die Lade- und Entlade-Logs zu demonstrieren.
Beispiel
// Verwenden Sie console.log, um Lebenszyklusereignisse auszugeben, und beobachten Sie die Reihenfolge von apply und effect
export function apply(ctx: Context) {
// apply wird aufgerufen: Das Plugin wechselt von LOADING zu ACTIVE
console.log('Beispiel-Plugin wird geladen')
// Einen Effekt registrieren: Die zurückgegebene Cleanup-Funktion wird beim Unmount ausgeführt
ctx.effect(() => {
// Effektregistrierung abgeschlossen (apply läuft)
console.log('Beispiel-Effekt registriert')
// Disposer zurückgeben: Wird aufgerufen, wenn das Plugin entladen wird
return () => console.log('Beispiel-Effekt bereinigt')
})
}
Ausgabe beim Laden:
example plugin loading example effect registered
Ausgabe beim Entladen:
example effect cleaned up
Man erkennt, dass zuerst apply ausgeführt wird, dann die Effektregistrierung ausgeführt wird und der zurückgegebene Disposer während der Entladephase aufgerufen wird.
Zusammenfassung Selbsttest
Die Fiber-Zustandsmaschine beschreibt die sechs Zustände eines Plugins von der Deklaration bis zur vollständigen Entladung; Disposer bereinigen Registrierungen asynchron und nebenläufig in umgekehrter Registrierungsreihenfolge.
Testen Sie sich selbst:
- Was sind die sechs Zustände von Fiber? In welchen Zustand tritt es ein, wenn apply eine Ausnahme auslöst?
- Warum erfordern über ctx.on registrierte Listener kein manuelles removeListener?
- Wenn zwei Cleanup-Schritte Reihenfolgeabhängigkeiten aufweisen, wie sollten sie geschrieben werden, um sicher zu sein?