DeepSeek-Harness: Automatische Bereinigung und ctx.effect()
Vorheriges KapitelDeepSeek Harness Laden lokaler PluginsEine Zeile Log auszugeben ist alles, was es tut, aber echte Plugins registrieren Listener, Tools und Timer.
Dieser Abschnitt löst ein Problem: Wenn das Plugin entladen wird, wer räumt diese Ressourcen auf?
Die Registrierung wird an ctx delegiert, und die Bereinigung wird ebenfalls an ctx delegiert.
Automatischer Bereinigungsmechanismus
Alles, was über ctx registriert wird – Event-Listener, Tools, Timer –, wird automatisch bereinigt, wenn das Plugin entladen wird.
removeListener oder clearInterval müssen nicht manuell aufgerufen werden.
Das Framework kann automatisch bereinigen, weil alle Registrierungen über ctx im Fiber-Scope des Plugins erfasst werden.
Beim Entladen entfernt das Framework sie in umgekehrter Reihenfolge der Registrierung.
Welche Operationen werden automatisch nachverfolgt
Die folgenden Operationen werden automatisch nachverfolgt und bereinigt.
| Registrierungsoperation | Verhalten bei der Deinstallation |
|---|---|
| ctx.on(event, handler) | Event-Listener werden automatisch entfernt |
| ctx.tools.register(tool) | Automatisches Aufheben der Tool-Registrierung |
| ctx.llm.registerAdapter(names, adapter) | Automatisches Aufheben der LLM-Adapter-Registrierung |
| ctx.effect(() => cleanup) | Führe die zurückgegebene Disposer-Bereinigungsfunktion aus. |
ctx.effect(): manuell verwaltete Ressourcen an das Framework übergeben.
Einige Ressourcen sind nicht in der obigen Liste enthalten, wie z. B. eine Netzwerkverbindung.
Verwende ctx.effect(), um dem Framework mitzuteilen, wie es bereinigt wird.
ctx.effect akzeptiert einen Callback. Erstelle im Callback Ressourcen und gib eine Bereinigungsfunktion (Disposer) zurück.
Dieser Disposer wird ausgeführt, wenn das Plugin entladen wird.
disposer(Die Bereinigungsfunktion) ist der Rückgabewert des ctx.effect-Callbacks.
Es beschreibt, "wie die diesmal erstellten Ressourcen zerstört werden".
Wenn das Plugin entladen wird, ruft das Framework es auf.
Hier ist ein Beispiel für einen Heartbeat-Timer:
Beispiel
import type { Context } from '@deepseek-ai/cordis'
export function apply(ctx: Context) {
ctx.effect(() => {
// Timer erstellen: alle 5 Sekunden Heartbeat ausgeben
const timer = setInterval(() => {
console.log('heartbeat')
}, 5000)
// Die zurückgegebene Aufräumfunktion wird ausgeführt, wenn das Plugin entladen wird
// Entspricht: Du musst clearInterval nicht manuell in der Entlade-Logik aufrufen
return () => clearInterval(timer)
})
}
Wenn beim Entladen nichts getan werden muss, kann der Disposer weggelassen werden.
Aber sobald Ressourcen wie Timer und Verbindungen erstellt wurden, stellen Sie sicher, dass die entsprechende Aufräumfunktion zurückgegeben wird.

Details der Ausführungsreihenfolge
Wenn das Plugin entladen wird, werden Aufräumfunktionen in umgekehrter Reihenfolge der Registrierung aufgerufen.
Mehrere asynchrone Aufräumfunktionen laufen gleichzeitig; es gibt keine Garantie, dass sie nacheinander abgeschlossen werden.
Aufräumschritte, die Reihenfolgeabhängigkeiten haben, müssen in derselben Aufräumfunktion platziert werden, die von einem einzelnen ctx.effect() zurückgegeben wird, und diese Aufräumfunktion ist für serialisiertes Warten verantwortlich.
Hinweis: Diese Regel bedeutet: zuerst registrieren, später aufräumen – später registrierte Ressourcen werden zuerst aufgeräumt.
Zusammenfassung und Selbsttest
Über ctx registrierte Ressourcen werden beim Entladen automatisch aufgeräumt; verwenden Sie für manuelle Ressourcen ctx.effect(), um eine Aufräumfunktion bereitzustellen.
Weitere Erweiterungen
1. Müssen über ctx registrierte Timer manuell mit clearInterval beendet werden?
2. Wann wird die Aufräumfunktion von ctx.effect(() => disposer) ausgeführt?
3. Warum sollte reihenfolgeabhängiges Aufräumen im selben Effekt platziert werden?