Plugin-Entwicklung & Implementierung

Plugin mit einem KI-Agenten erstellen

Ersetzen Sie den unten stehenden Platzhalter für die Anforderung und geben Sie Ihrem Codierungs-Agenten die vollständige Anweisung:

Lesen und befolgen Sie die Seer-Plugin-Entwicklungsanleitung unter https://raw.githubusercontent.com/ccseer/Seer-Plugins/refs/heads/master/plugin_development_guide.md. Betrachten Sie sie als die maßgebliche Quelle (Source of Truth) für Architektur, plugin.json, Implementierung, Validierung und Paketierung. Wenn die Anleitung nicht verfügbar ist, stoppen Sie und melden Sie dies, bevor Sie fortfahren.

Überprüfen Sie vor jeder Arbeit die folgende Requirement (Anforderung). Wenn sie fehlt, unveränderter Platzhaltertext ist oder zu ungenau für eine Implementierung ist, stellen Sie eine klärende Frage und warten Sie. Versuchen Sie nicht, die fehlende Anforderung zu erraten.

Sobald dies geklärt ist, wählen Sie Convert oder DLL und begründen Sie die Wahl kurz. Implementieren Sie dann ein vollständiges, installierbares Plugin im aktuellen Arbeitsbereich. Nehmen Sie keine Änderungen an Seer selbst vor und bleiben Sie nicht bei Plänen oder Code-Snippets stehen.

Befolgen Sie jeden anwendbaren Validierungsschritt in der Anleitung und melden Sie die tatsächlichen Ergebnisse. Führen Sie nach Möglichkeit einen In-App-Vorschautest in Seer durch; andernfalls geben Sie explizit an, dass keine Laufzeitüberprüfung durchgeführt wurde.

Requirement: [ERSETZEN SIE DIESEN PLATZHALTER durch die Plugin-Anforderung.]

Konvertierungs-Plugins

Seer behandelt Konvertierungs-Plugins als externe Programme. Wenn eine Datei ausgelöst wird, führt Seer das konfigurierte Programm aus und übergibt Dateipfade über Platzhalter.

Platzhalter-Variablen

• ${input_file}: Absoluter Pfad der Quelldatei.
• ${output_file}: Basispfad der Ausgabedatei, unter dem das Plugin die verarbeitete Ausgabe speichern soll (erforderliche Dateiendung anhängen, z. B. ${output_file}.json).
• ${use_backslash}: Optionale Kennzeichnung zur Formatierung von Pfadtrennzeichen als native Windows-Backslashes (\).
• ${seer_dir}: Verzeichnispfad, in dem sich Seer.exe befindet.
• ${seer_exe}: Absoluter Pfad zu Seer.exe.
• ${7z}: Absoluter Pfad zu 7z.exe, die mit Seer bereitgestellt wird.

Ausführungsablauf

1. Auslösen: Der Benutzer drückt die LEERTASTE auf einer Datei.
2. Auflösung: Seer identifiziert das der Dateierweiterung zugeordnete Plugin.
3. Ausführung: Seer führt die ausführbare Datei aus (z. B. ApkMetaInfo2Json.exe "${input_file}" "${output_file}.json").
4. Anzeige: Sobald der Prozess beendet ist, liest Seer die generierte Datei, die mit ${output_file}.* übereinstimmt, und rendert sie mit dem entsprechenden internen Betrachter für diese Dateiendung.

Unterstützte Ausführungs- & Skripttypen

Ein Konvertierungs-Plugin kann jede ausführbare Datei sein, die Ein-/Ausgabe über die CLI verarbeiten kann:

• Skripte:
  • CMD-Skript: cmd_rename
  • BAT-Skript: bat_epub
  • PowerShell-Skript: .ps1 (direkt unterstützt über powershell.exe)
• Drittanbieter-Tools:
  • dll_lib_exports: Windows-Systemdienstprogramm
  • ImageMagick
  • exiftool
• Benutzerdefinierte Binärdateien:
  • Torrent2Json
  • ApkMetaInfo2Json

Temporäre Dateiverwaltung

Plugins erzeugen oft Zwischendateien.

• Automatische Bereinigung: Seer löscht standardmäßig automatisch temporäre Dateien, die älter als 21 Tage sind.
• Erzwungenes Entfernen: Fügen Sie ${no_cache} zu Ihren Befehlsparametern hinzu, um Seer anzuweisen, den Konvertierungscache zu umgehen und die temporäre Ausgabe im automatischen Löschverzeichnis (autodel/) zu speichern, das beim Beenden von Seer automatisch geleert wird.

DLL-Plugins

Für leistungsstarke oder tiefe Integration unterstützt Seer DLL-basierte Plugins, die in C++/Qt geschrieben und zu dynamischen Bibliotheken kompiliert wurden.

Referenzprojekte

Siehe diese offiziellen Repositorys für die Plugin-Schnittstellenimplementierung: