CommunityRédaction et éditiongithub.com

Éditeur/Publication

Publier des projets HTML front-end sur la plateforme AI Game MCP et éventuellement les empaqueter en APK Android.

Qu'est-ce que Publication ?

Cette compétence permet aux agents IA de publier des applications web HTML (front-end) sur la plateforme Pushwebly, avec la possibilité de les empaqueter en tant qu'applications Android APK. Elle simplifie le processus de déploiement : l'agent collecte les informations nécessaires (fichier zip, nom du projet, visibilité, mot de passe) étape par étape grâce à une machine à états finis, sans deviner ni sauter d'étapes. La compétence gère également l'enregistrement et la connexion des utilisateurs, les changements de visibilité et la construction d'APK pour des projets déjà publiés. Elle s'appuie sur des outils MCP montés (project_*) ou, à défaut, sur des appels HTTP curl directs.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add publisher-skill/publisher

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Compétence de publication

Publier des projets HTML front-end sur la plateforme de publication et éventuellement les empaqueter en APK Android.

URL de la plateforme :

https://pushwebly.com

Utilisez "projet" dans les messages destinés à l'utilisateur. Les chemins d'API canoniques sont /api/projects et les noms d'outils canoniques sont project_*. Les alias obsolètes game_* et les champs de réponse gameId peuvent encore apparaître ; traitez gameId comme l'identifiant du projet.

Règles d'exécution Codex

  • Préférez les outils MCP project_* montés s'ils existent dans l'environnement actuel.
  • Si les outils MCP distants ne sont pas montés, utilisez les API HTTP avec curl.
  • N'exigez pas Python. Les scripts optionnels, s'ils sont présents, sont réservés aux utilisateurs CLI/CI.
  • Ne demandez que les informations réellement manquantes : identifiants, chemin du zip, nom du projet, visibilité publique/privée, ou préférence de mot de passe d'accès privé.
  • N'écrivez jamais d'identifiants dans un fichier zip ou un fichier du dépôt. Stockez-les uniquement dans le fichier ~/.publisher/config.json de l'utilisateur après son consentement.
  • Sous Windows/PowerShell, utilisez un fichier JSON temporaire pour les corps de requête au lieu d'échapper le JSON en ligne dans le shell.

Mappage des intentions

Intention de l'utilisateurActionInformations manquantes à demander
Publier, expédier, télécharger, mettre en lignePublier le projetchemin du zip, nom du projet
Créer une application téléphonique installable, APK, paquet AndroidPublier et construire l'APKchemin du zip, nom du projet
Construire un APK pour un projet déjà publiéConstruire l'APKidentifiant du projet ; utiliser la liste des projets si nécessaire
Rendre une application privée/publique, ajouter/supprimer un mot de passe d'accèsChanger la visibilitéURL de l'application, visibilité cible (mot de passe optionnel lorsqu'elle est privée)
Afficher mes projets, lister les projets publiésLister les projetsaucun si le jeton est disponible
Se connecter, s'inscrire, configurer le compteConnexion/inscriptionnom d'utilisateur et mot de passe

Si l'intention est ambiguë, posez une question courte : "Juste la publier, ou la publier et construire un APK Android aussi ?"

Processus de conversation de publication

Lorsque les utilisateurs expriment des intentions telles que publier, déployer, lancer, partager des applications, générer des liens d'accès, etc., ils doivent entrer dans ce processus.

Principes généraux de la machine à états finis

  • En entrant dans le flux, exécutez d'abord S-1 (vérification de version, non bloquante), puis procédez dans l'ordre S0 -> S1 -> S2 -> S3 -> S4.
  • Il n'est pas autorisé de sauter des étapes (sauf S-1).
  • Il n'est pas possible d'interroger plusieurs champs en une seule requête. Les informations que l'utilisateur a clairement fournies peuvent être enregistrées, et il n'est pas nécessaire de les redemander. Lorsque la réponse de l'utilisateur est ambiguë, ne relancez qu'une seule fois pour le champ actuel.
  • Ce n'est qu'une fois l'étape actuelle terminée que nous pouvons passer à l'étape suivante.
  • Si l'attente d'une saisie utilisateur est nécessaire, n'ajoutez pas d'explications, de suggestions ou d'aperçus de l'étape suivante à la fin de la réponse.

S-1 : Vérification de version (premier nœud du flux de publication, non bloquant)

En entrant dans le flux de publication, exécutez une auto-vérification de version avant S0. Cette étape n'est PAS soumise aux règles de blocage de <HARD-GATE> : quel que soit le résultat — même si le point d'accès est inaccessible — continuez toujours. N'interrompez jamais la publication à cause d'un problème de version.

Étapes :

  1. Lisez la version locale de la compétence : le champ version dans l'en-tête de ce fichier.

  2. Interrogez la dernière version de la plateforme (aucune connexion requise) :

    curl -s https://ai-pub.pushwebly.com/api/skill/latest-version
    

    La réponse data contient : version (dernière), downloadUrl (paquet de documentation multiplateforme, décompressez et utilisez), downloadUrlWindows (installeur Windows .exe), et downloadUrlMac (installeur macOS .zip).

  3. Comparez la version locale avec la version retournée.

    Règle de comparaison : une version est majeur.mineur.patch. Comparez segment par segment en tant qu'entiers, de gauche à droite — d'abord majeur, puis mineur, puis patch ; complétez les segments manquants avec 0 (1.1 signifie 1.1.0). Comparez en tant qu'entiers, PAS en tant que chaînes : 1.10.0 est supérieur à 1.9.0 (deuxième segment 10 > 9) ; une comparaison de chaînes serait erronée. Exemple croissant : 1.0.0 < 1.0.9 < 1.1.0 < 1.2.0 < 1.10.0 < 2.0.0.

    • La version locale est plus ancienne (la séquence de segments entiers locale est inférieure à celle retournée) : vous DEVEZ afficher un avis de mise à jour à l'utilisateur avant de continuer, et l'avis DOIT inclure l'URL de téléchargement réelle (cela ne bloque pas la publication, mais l'avis ne doit pas être omis). Choisissez l'URL de téléchargement en fonction du système d'exploitation de l'utilisateur :

      • Windows → utilisez downloadUrlWindows
      • macOS → utilisez downloadUrlMac
      • Système d'exploitation inconnu, ou le champ correspondant est vide → utilisez le downloadUrl générique

      Texte de l'avis (affichez-le dans la MÊME langue que celle utilisée par l'utilisateur — chinois s'il écrit en chinois, anglais s'il écrit en anglais ; ne codez pas en dur une seule langue ; l'exemple ci-dessous est en anglais uniquement comme modèle ; remplacez l'URL par celle réellement sélectionnée ; écrivez l'URL de téléchargement sous forme de lien Markdown cliquable [URL](URL) — ne l'entourez PAS de backticks comme du code en ligne, sinon l'utilisateur ne peut pas cliquer dessus ; ne laissez jamais d'espace réservé, ne dites jamais "une nouvelle version existe" sans donner le lien) :

      Remarque : une version plus récente de la compétence de publication <version> est disponible (vous êtes sur <version locale>). Téléchargement : https://ai-pub.pushwebly.com/downloads/AI_Publisher_skill.exe (la mise à jour n'affecte pas la publication en cours).

    • La version locale est égale ou plus récente : restez silencieux et continuez.

    • La requête échoue/dépasse le délai/ne peut pas être analysée : ignorez silencieusement, passez directement à S0, ne faites pas apparaître d'erreur.

  4. Dans tous les cas, passez ensuite à S0. Comme cette étape ne fait que notifier (pas de saisie, pas de blocage), la règle "au plus une question destinée à l'utilisateur par réponse" ne s'y applique pas — la note de version peut partager la même réponse que la première question S0.


S0 : Vérification de l'état du compte

Tout d'abord, vérifiez s'il existe déjà un jeton/informations d'identification locaux disponibles.

  • Si vous avez déjà des identifiants de compte : passez à S2.
  • S'il n'y a pas d'identifiants de compte : entrez S1_USERNAME.
  • Si impossible de vérifier l'état du compte : demandez à l'utilisateur s'il a déjà un compte de publication.

Posez une question à l'utilisateur :

Je dois d'abord confirmer le compte de publication : Avez-vous déjà un compte ou un jeton disponible ?

Réponse de l'utilisateur :

  • Oui : Demandez à l'utilisateur de fournir ou de confirmer le jeton/les identifiants de connexion, puis passez à S2.
  • Non : Entrez S1_USERNAME.

S1 : Processus d'inscription et de connexion

S1_USERNAME : Collecte du nom d'utilisateur enregistré

S'il n'y a pas de nom d'utilisateur, demandez uniquement :

Veuillez fournir le nom d'utilisateur à enregistrer.

Après avoir reçu le nom d'utilisateur, enregistrez-le comme username et entrez S1_PASSWORD.

S1_PASSWORD : Collecte du mot de passe d'enregistrement

S'il n'y a pas de mot de passe, demandez uniquement :

Veuillez fournir le mot de passe d'enregistrement.

Après avoir reçu le mot de passe, enregistrez-le comme password et entrez S1_VALIDATE.

S1_VALIDATE : Validation conjointe

Ce n'est qu'après avoir à la fois username et password que l'interface backend peut être appelée pour une validation conjointe.

Validation réussie :

  • Créer le compte
  • Terminer la connexion
  • Message : Inscription et connexion réussies
  • Entrez S2

Validation échouée :

  • Afficher la raison spécifique de l'erreur renvoyée par le backend
  • Ne demander que l'élément qui doit être corrigé
  • Ne pas interrompre le processus d'inscription

S2 : Demander la visibilité de l'application

Si le statut public ou privé n'a pas été clairement défini, demandez uniquement :

Cette application est-elle publique ? Publique signifie que tout le monde peut y accéder via un lien ; privée nécessite un mot de passe d'accès à 6 chiffres.

Réponse de l'utilisateur :

  • Public / Oui / public : Enregistrez visibility=public, entrez S4
  • Privé / Non / private : Enregistrez visibility=private, entrez S3
  • Pas clair : Continuez à demander uniquement cet élément

S3 : Mot de passe d'accès privé

Si visibility=private, il est nécessaire de demander si l'utilisateur souhaite personnaliser le mot de passe, en demandant uniquement :

Voulez-vous personnaliser un mot de passe d'accès à 6 chiffres ? Vous pouvez également répondre "généré par le système".

Réponse de l'utilisateur :

  • Fournir un mot de passe : la vérification doit être de 6 chiffres ou lettres ; après validation, enregistrez accessPassword=<mot de passe utilisateur> et entrez S4
  • Réponse généré par le système / Pas nécessaire / Aléatoire : Ne passez pas accessPassword, laissez le backend le générer, et entrez S4
  • Format du mot de passe incorrect : Indiquez uniquement les exigences de format et redemandez le mot de passe

S4 : Exécution de la publication

L'appel de l'interface de publication n'est autorisé que si l'une des conditions suivantes est remplie :

  • visibility=public
  • visibility=private et l'utilisateur a sélectionné un mot de passe personnalisé ou un mot de passe généré par le système

Paramètres de publication :

Application publique :

{
  "visibility": "public"
}

Application privée, mot de passe personnalisé :

{
  "visibility": "private",
  "accessPassword": "a1b2c3"
}

Valeur par défaut à public si l'utilisateur ne spécifie pas la visibilité. Un mot de passe d'accès privé doit correspondre à ^[A-Za-z0-9]{6}$ ; sinon, demandez un mot de passe valide ou laissez le backend en générer un.

Gestion des jetons

Un jeton Bearer est requis pour toutes les API de publication.

Utilisez cet ordre :

  1. Si l'utilisateur a fourni un jeton dans la conversation, utilisez-le directement.
  2. Si ~/.publisher/config.json existe, lisez le nom d'utilisateur/mot de passe stocké et reconnectez-vous pour actualiser le jeton.
  3. Sinon, demandez le nom d'utilisateur et le mot de passe. Le point d'accès de connexion enregistre automatiquement les nouveaux comptes.

Point d'accès de connexion/inscription :

curl -s -X POST https://ai-pub.pushwebly.com/api/auth/login-or-register \
  -H "Content-Type: application/json" \
  -d @login.json

Écrivez login.json comme :

{"username":"alice","password":"mot-de-passe-en-clair"}

Utilisez data.token de la réponse comme :

Authorization: Bearer <JETON>

Supprimez le fichier de connexion temporaire après utilisation.

Fichier d'identification local optionnel :

{
  "baseUrl": "https://ai-pub.pushwebly.com",
  "username": "alice",
  "password": "mot-de-passe-en-clair",
  "authorization": "Bearer <JETON>",
  "userId": 1
}

Sous Linux/macOS, définissez le mode 600 après l'écriture. En cas d'erreur 401, actualisez le jeton une fois en vous reconnectant, puis réessayez l'opération échouée une fois.

Vérifier le jeton :

curl -s https://ai-pub.pushwebly.com/api/auth/verify-token \
  -H "Authorization: Bearer <JETON>"

Vérifications avant publication

Avant de publier :

  1. Confirmez que le fichier existe et a une extension .zip.
  2. Confirmez que le zip contient index.html ou index.htm.
  3. Si le zip a des répertoires imbriqués, confirmez que le fichier d'entrée peut être localisé.
  4. Confirmez que le nom du projet n'est pas vide.
  5. Confirmez qu'un jeton valide est disponible.

Opérations HTTP

Publier un projet

Public :

curl -s -X POST https://ai-pub.pushwebly.com/api/projects/publish \
  -H "Authorization: Bearer <JETON>" \
  -F "project_name=demo" \
  -F "[email protected]"

Privé avec mot de passe personnalisé optionnel :

curl -s -X POST https://ai-pub.pushwebly.com/api/projects/publish \
  -H "Authorization: Bearer <JETON>" \
  -F "project_name=demo" \
  -F "[email protected]" \
  -F "visibility=private" \
  -F "access_password=a1b2c3"

Pour les applications privées, omettez access_password pour laisser le backend générer un mot de passe. Transmettez toujours le accessPassword final de la réponse à l'utilisateur.

Lister les projets

curl -s https://ai-pub.pushwebly.com/api/projects/my \
  -H "Authorization: Bearer <JETON>"

Changer la visibilité (public <-> privé)

Basculer une application déjà publiée entre public et privé. L'entrée est l'URL de l'application ; le backend analyse l'identifiant de l'application à partir de celle-ci et vérifie que l'application appartient à l'utilisateur actuel — vous ne pouvez modifier que vos propres applications, pas celles des autres.

curl -s -X PATCH https://ai-pub.pushwebly.com/api/projects/visibility \
  -H "Authorization: Bearer <JETON>" \
  -H "Content-Type: application/json" \
  -d @visibility.json

Écrivez visibility.json (pour passer en privé) :

{"url":"https://ai-pub.pushwebly.com/play/aB3xYz/","visibility":"private","accessPassword":"a1b2c3"}

Ou pour passer en public (aucun mot de passe nécessaire ; l'ancien mot de passe est effacé) :

{"url":"https://ai-pub.pushwebly.com/play/aB3xYz/","visibility":"public"}

accessPassword est optionnel et utilisé uniquement lors du passage en privé (6 chiffres ou lettres ; généré automatiquement s'il est omis). La réponse data inclut la visibility finale, url, et — lorsqu'elle est privée — le accessPassword. Transmettez l'URL et le mot de passe d'une application privée séparément, jamais avec ?pwd=. Si l'application n'est pas trouvée, déjà supprimée ou appartient à un autre utilisateur, indiquez la raison concrète et que seules vos propres applications peuvent être modifiées.

Construire un APK pour un projet existant

curl -s -X POST https://ai-pub.pushwebly.com/api/apk/build \
  -H "Authorization: Bearer <JETON>" \
  -H "Content-Type: application/json" \
  -d @build-apk.json

Écrivez build-apk.json comme :

{"projectId":12}

Utilisez data.apkUrl de la réponse comme URL de téléchargement de l'APK.

Publier et construire un APK

C'est l'opération recommandée lorsque l'utilisateur souhaite une application Android installable.

curl -s -X POST https://ai-pub.pushwebly.com/api/apk/publish-and-build \
  -H "Authorization: Bearer <JETON>" \
  -F "project_name=airplane-war" \
  -F "[email protected]"

Pour une application privée, ajoutez :

-F "visibility=private" -F "access_password=a1b2c3"

Omettez access_password pour le générer automatiquement.

Les champs de réponse attendus peuvent inclure :

{
  "gameId": 12,
  "projectName": "airplane-war",
  "playUrl": "https://ai-pub.pushwebly.com/play/aB3xYz/",
  "status": "enabled",
  "apkUrl": "https://ai-pub.pushwebly.com/api/apk/download/airplane-war_aB3xYz.apk",
  "apkFileNa": "..."
}

Transmettez un message de confirmation structuré à l'utilisateur contenant playUrl, apkUrl et accessPassword (si privé).

Skills associés