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.

RegistrierungsoperationVerhalten 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

// Dateipfad: scratch-plugin/src/heartbeat.ts
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.

  • 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?

Weitere Erweiterungen