Alle Anleitungen

Ein Plugin aus einer ZIP installieren

Ein von der KI erstelltes Plugin manuell installieren und in smabar prüfen.

Als Markdown lesen
Auf dieser Seite

Mit ChatGPT oder Claude bauen erklärt, wie deine KI die ZIP erstellt. Lokaler Plugin-Code läuft mit deinen Nutzerrechten. Lies die Dateien vor der Installation.

Aufbau der ZIP

my-plugin/
  smabar.json
  plugin.py
  views.py             (falls importiert)
  locales/
    en.json
    de.json
  README.md
  LICENSE              (falls wiederverwendeter Code dies erfordert)
  ...weitere importierte Module und benötigte Assets

Die id im Manifest muss hier my-plugin lauten. Das dort angegebene Einstiegsskript muss vorhanden sein. Ein neues Plugin braucht eine eigene ID; nur den Ordner eines mitgelieferten Beispiels umzubenennen ändert weder Manifest noch Kachel-IDs.

Installation

  1. Entpacke die ZIP zunächst in einen temporären Ordner außerhalb von .smabar. Prüfe den vollständigen Plugin-Ordner und seine README auf fehlende Dateien, Zugangsdaten, unerwartete Programme oder Verknüpfungen nach außerhalb.
  2. Beende smabar, damit die App keinen teilweise kopierten Ordner liest. Öffne das Plugin-Verzeichnis: unter Linux/macOS ~/.smabar/plugins/, unter Windows %USERPROFILE%\.smabar\plugins\ im Explorer. Lege plugins an, falls es noch fehlt.
  3. Prüfe, ob bereits ein Ordner mit derselben ID existiert. Falls ja, stoppe und lass eine neue ID vergeben oder führe bewusst ein Update mit Sicherung durch. Vermische keine entpackten Dateien mit einem bestehenden Plugin.
  4. Verschiebe den vollständigen Ordner my-plugin ins Plugin-Verzeichnis. Das Manifest muss unter plugins/my-plugin/smabar.json liegen, ohne zusätzliche Ebene my-plugin/my-plugin.
  5. Starte smabar und prüfe das Plugin in den Einstellungen. Warte gegebenenfalls auf die Vorbereitung der Python-Abhängigkeiten. Laufzeit und SDK liefert smabar; zusätzliche lokale Einstellungen stehen in der README des Plugins.

In der App prüfen

  • Kachel und alle vorhandenen Flyouts, Hover-Ansichten oder Popups öffnen: keine abgeschnittenen Texte, rohen Übersetzungsschlüssel, fehlenden Icons oder unbenannten Bedienelemente.
  • Aktionen und Einstellungen ausprobieren; Lade-, Leer- und Fehlerzustände prüfen. Provider und externe Dienste müssen auf deinem Betriebssystem funktionieren.
  • smabar neu starten und prüfen, ob Einstellungen und vorgesehene Daten erhalten bleiben.
  • ~/.smabar/logs/plugin-my-plugin.log prüfen; unter Windows %USERPROFILE%\.smabar\logs\plugin-my-plugin.log. Die Debugging-Referenz erklärt Fehler und Markup-Warnungen. Entferne Zugangsdaten und persönliche Informationen vor dem Teilen von Auszügen.

Datei- und Syntaxprüfungen der ZIP belegen noch keine korrekte Darstellung oder Funktion in smabar. Gib deiner KI bei Problemen den tatsächlichen Fehler oder einen Screenshot. Sicherungen gehören außerhalb von .smabar/plugins/, damit sie nicht selbst als Plugins entdeckt werden.