Aller au contenu
Hagicode Docs
Blog

Installer HagiTask

Modifier cette page

Public concerné : personnes souhaitant installer des tâches communautaires pour les utiliser dans HagiCode.

Prérequis :

  • Vous avez accès à l’application HagiCode utilisée et à son service backend.
  • Votre version de l’application prend en charge la gestion des tâches communautaires HagiTask et la Community Gallery.
  • Les agents, skills ou dépendances CLI nécessaires à la tâche sont prêts ; leurs exigences figurent dans les détails de la tâche.

La procédure actuellement prise en charge consiste à récupérer les détails et l’archive ZIP d’une tâche dans la Community Gallery de HagiTask Site, puis à utiliser la fonction d’installation des tâches communautaires de l’application :

  1. Recherchez une tâche dans la Gallery par nom, catégorie ou étiquette.
  2. Ouvrez ses détails et vérifiez la version, l’éditeur, la compatibilité et la taille de l’installation.
  3. Choisissez l’option d’installation. L’application récupère le ZIP via packageUrl et vérifie l’identifiant de tâche, la version et l’empreinte SHA-256.
  4. Une fois la vérification réussie, l’application écrit le paquet dans le répertoire de données HagiTask local et actualise le catalogue des tâches.

Les points d’accès au catalogue, aux détails et aux archives sont respectivement /index.json, /tasks/<taskId>.json et /packages/<taskId>.zip. L’installation utilise l’archive ; elle ne nécessite pas d’analyser le contenu des pages du site.

Utiliser une archive

Si vous avez déjà obtenu un ZIP par une procédure Gallery prise en charge, vous pouvez choisir l’installation d’une archive locale dans l’interface de gestion des tâches communautaires. L’archive doit contenir le répertoire complet du paquet ; son identifiant, sa version et son empreinte de contenu doivent correspondre à la demande d’installation.

Le téléversement d’un dossier local depuis le navigateur ne fait actuellement pas partie du parcours d’installation de la Community Gallery. La configuration de sources sous forme de répertoires côté serveur a un autre usage : consultez Utiliser HagiTask.

Vérifier l’installation

Après l’installation, vérifiez dans l’interface de gestion des tâches communautaires que :

  • La tâche affiche le bon taskId, la bonne version et le bon éditeur.
  • La tâche est activée ou peut être activée manuellement.
  • Les indications sur les dépendances et la compatibilité ne signalent aucun prérequis manquant.
  • La tâche reste présente après l’actualisation du catalogue et son panneau peut être ouvert.

L’enregistrement de l’installation conserve l’origine, la version, l’empreinte de l’archive et l’état d’activation. Les tâches intégrées sont affichées en lecture seule et ne peuvent pas être désinstallées comme des paquets communautaires.

Problèmes courants

Vérifiez que l’adresse de la Gallery configurée dans l’application est accessible et utilise HTTPS. Vérifiez également le réseau, les délais d’attente et l’état du site. Si la première récupération du catalogue échoue, l’application ne fabrique pas un catalogue vide ; si un cache valide existe, elle peut afficher temporairement un ancien catalogue.

Tâche introuvable ou détails invalides

Utilisez le taskId canonique indiqué dans les détails, pas un autre nom affiché. agentsmd et portytail ne sont que des alias courants de claude-md-update et ponytail, et non des identifiants de tâche installables.

Échec de la vérification d’intégrité ou de version

Récupérez à nouveau l’archive dans la Gallery. Ne modifiez pas manuellement le ZIP ni les fichiers de catalogue générés. Si le problème persiste, contactez les responsables du paquet pour qu’ils vérifient les données sources et le numéro de version dans Community Packages.

Tâche indisponible après installation

Vérifiez les exigences relatives aux agents, aux skills et à la CLI dans les détails de la tâche. Assurez-vous que la tâche est activée dans l’application et actualisez le catalogue. Si le contenu du paquet est invalide, consultez le guide de contribution communautaire pour comprendre le schéma et la validation.

Étape suivante : Utiliser HagiTask.