Zum Inhalt springen
Hagicode Docs
Blog

HagiTask installieren

Seite bearbeiten

Für wen: Personen, die Community-Aufgaben installieren und in HagiCode nutzen möchten.

Voraussetzungen:

  • Sie können auf die verwendete HagiCode-Anwendung und ihren Backend-Dienst zugreifen.
  • Ihre Anwendungsversion unterstützt die Verwaltung von HagiTask-Community-Aufgaben und die Community Gallery.
  • Die für die Aufgabe benötigten Agents, Skills oder CLI-Abhängigkeiten sind vorhanden; die Anforderungen stehen in den Aufgabendetails.

Der derzeit unterstützte Ablauf besteht darin, Aufgabendetails und ZIP-Archive über die Community Gallery der HagiTask Site abzurufen und sie mit der Installationsfunktion der Anwendung für Community-Aufgaben zu installieren:

  1. Suchen Sie in der Gallery nach Aufgabenname, Kategorie oder Tags.
  2. Öffnen Sie die Aufgabendetails und prüfen Sie Version, Herausgeber, Kompatibilität und Installationsgröße.
  3. Wählen Sie „Installieren“. Die Anwendung lädt das ZIP-Archiv über packageUrl und überprüft Aufgaben-ID, Version und SHA-256-Prüfsumme.
  4. Nach erfolgreicher Prüfung schreibt die Anwendung das Paket in das lokale HagiTask-Datenverzeichnis und aktualisiert den Aufgabenkatalog.

Die Endpunkte für Katalog, Details und Archive lauten /index.json, /tasks/<taskId>.json und /packages/<taskId>.zip. Bei der Installation wird das Archiv verwendet; die Inhalte der Website müssen nicht ausgelesen werden.

Ein Archiv verwenden

Wenn Sie bereits über einen unterstützten Gallery-Ablauf ein ZIP-Archiv bezogen haben, können Sie es in der Community-Aufgabenverwaltung der Anwendung als lokales Archiv installieren. Das Archiv muss das vollständige Aufgabenpaketverzeichnis enthalten; ID, Version und Inhaltsprüfsumme müssen mit der Installationsanfrage übereinstimmen.

Das Hochladen eines lokalen Browserordners gehört derzeit nicht zum Installationsweg über die Community Gallery. Die Konfiguration serverseitiger Verzeichnisquellen dient einem anderen Zweck; siehe HagiTask verwenden.

Installation überprüfen

Prüfen Sie nach der Installation in der Community-Aufgabenverwaltung:

  • Die Aufgabe zeigt die richtige taskId, Version und den richtigen Herausgeber an.
  • Die Aufgabe ist aktiviert oder lässt sich manuell aktivieren.
  • Bei Abhängigkeiten und Kompatibilität werden keine unerfüllten Anforderungen angezeigt.
  • Die Aufgabe bleibt nach dem Aktualisieren des Katalogs vorhanden und ihr Panel lässt sich öffnen.

Der Installationseintrag speichert Herkunft, Version, Archivprüfsumme und Aktivierungsstatus. Integrierte Aufgaben werden nur angezeigt und können nicht wie Community-Pakete deinstalliert werden.

Häufige Probleme

Prüfen Sie, ob die in der Anwendung konfigurierte Gallery-Adresse erreichbar ist und HTTPS verwendet. Prüfen Sie außerdem Netzwerkverbindung, Zeitüberschreitungen und Website-Status. Schlägt der erste Abruf des Katalogs fehl, erzeugt die Anwendung keinen vorgetäuschten leeren Katalog; bei einem bereits vorhandenen gültigen Cache kann vorübergehend ein älterer Katalog angezeigt werden.

Aufgabe nicht gefunden oder Details ungültig

Verwenden Sie die kanonische taskId aus den Details und keinen Anzeigenamen. agentsmd und portytail sind lediglich geläufige Aliasnamen für claude-md-update und ponytail, keine installierbaren Aufgaben-IDs.

Integritäts- oder Versionsprüfung fehlgeschlagen

Laden Sie das Archiv erneut aus der Gallery herunter. Ändern Sie weder die ZIP-Datei noch generierte Katalogdateien von Hand. Bleibt der Fehler bestehen, bitten Sie die Paketverantwortlichen, Quelldaten und Versionsnummer in Community Packages zu prüfen.

Aufgabe nach der Installation nicht verfügbar

Prüfen Sie die Anforderungen an Agents, Skills und CLI in den Aufgabendetails. Stellen Sie sicher, dass die Aufgabe in der Anwendung aktiviert ist, und aktualisieren Sie den Katalog. Falls das Paket selbst ungültig ist, finden Sie Informationen zu Schema und Validierung unter Zur Community beitragen.

Nächster Schritt: HagiTask verwenden.