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.jsonde 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'utilisateur | Action | Informations manquantes à demander |
|---|---|---|
| Publier, expédier, télécharger, mettre en ligne | Publier le projet | chemin du zip, nom du projet |
| Créer une application téléphonique installable, APK, paquet Android | Publier et construire l'APK | chemin du zip, nom du projet |
| Construire un APK pour un projet déjà publié | Construire l'APK | identifiant du projet ; utiliser la liste des projets si nécessaire |
| Rendre une application privée/publique, ajouter/supprimer un mot de passe d'accès | Changer la visibilité | URL de l'application, visibilité cible (mot de passe optionnel lorsqu'elle est privée) |
| Afficher mes projets, lister les projets publiés | Lister les projets | aucun si le jeton est disponible |
| Se connecter, s'inscrire, configurer le compte | Connexion/inscription | nom 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'ordreS0 -> 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 :
-
Lisez la version locale de la compétence : le champ
versiondans l'en-tête de ce fichier. -
Interrogez la dernière version de la plateforme (aucune connexion requise) :
curl -s https://ai-pub.pushwebly.com/api/skill/latest-versionLa réponse
datacontient :version(dernière),downloadUrl(paquet de documentation multiplateforme, décompressez et utilisez),downloadUrlWindows(installeur Windows .exe), etdownloadUrlMac(installeur macOS .zip). -
Comparez la
versionlocale avec laversionretourné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.1signifie1.1.0). Comparez en tant qu'entiers, PAS en tant que chaînes :1.10.0est supérieur à1.9.0(deuxième segment10 > 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
downloadUrlgé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). - Windows → utilisez
-
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.
-
-
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 questionS0.
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, entrezS4 - Privé / Non / private : Enregistrez
visibility=private, entrezS3 - 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 entrezS4 - 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 entrezS4 - 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=publicvisibility=privateet 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 :
- Si l'utilisateur a fourni un jeton dans la conversation, utilisez-le directement.
- Si
~/.publisher/config.jsonexiste, lisez le nom d'utilisateur/mot de passe stocké et reconnectez-vous pour actualiser le jeton. - 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 :
- Confirmez que le fichier existe et a une extension
.zip. - Confirmez que le zip contient
index.htmlouindex.htm. - Si le zip a des répertoires imbriqués, confirmez que le fichier d'entrée peut être localisé.
- Confirmez que le nom du projet n'est pas vide.
- 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é).