CommunitySchreiben & Editierengithub.com

Publisher Fähigkeit

Veröffentlichen Sie HTML-Frontend-Spiele auf der AI Game MCP-Plattform und erstellen Sie optional Android-APKs.

Was ist Publisher Fähigkeit?

Die „Publisher“-Fähigkeit ermöglicht es KI-Agenten, HTML-Frontend-Projekte auf der Plattform unter „https://pushwebly.com“ zu veröffentlichen. Sie unterstützt das Hochladen von Projekten als ZIP-Dateien mit einer `index.html`, das Ändern der Sichtbarkeit (öffentlich/privat mit Passwort) sowie das Erstellen von Android-APKs – entweder separat für bereits veröffentlichte Projekte oder direkt beim Veröffentlichen. Die Fähigkeit arbeitet mit einem endlichen Automaten: Sie prüft zunächst optional die Version, erfasst dann die Anmeldeinformationen (Anmeldung/Registrierung über einen gemeinsamen Endpunkt), fragt nach der gewünschten Sichtbarkeit und dem optionalen Zugangspasswort und führt schließlich die Veröffentlichung durch. Sie bevorzugt gemountete MCP-Tools, kann aber andernfalls direkt `curl`-Aufrufe gegen die REST-API der Plattform ausführen. Benutzerdaten werden sicher in der lokalen Konfigurationsdatei `~/.publisher/config.json` gespeichert. Diese Fähigkeit ist in Entwicklungsumgebungen wie Codex nützlich und automatisiert den gesamten Workflow vom Projekt-Upload bis zur Auslieferung einer mobilen App.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add publisher-skill/publisher

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Publisher-Fähigkeit

Veröffentlichen Sie HTML-Frontend-Projekte auf der Veröffentlichungsplattform und packen Sie sie optional als Android-APKs.

Plattform-URL:

https://pushwebly.com

Verwenden Sie "Projekt" in Benutzernachrichten. Die kanonischen API-Pfade sind /api/projects und kanonische Toolnamen sind project_*. Veraltete game_*- Aliase und gameId-Antwortfelder können noch auftauchen; behandeln Sie gameId als die Projekt-ID.

Codex-Ausführungsregeln

  • Bevorzugen Sie gemountete project_*-MCP-Tools, falls diese in der aktuellen Umgebung vorhanden sind.
  • Wenn keine entfernten MCP-Tools gemountet sind, verwenden Sie die HTTP-APIs mit curl.
  • Erfordern Sie kein Python. Optionale Skripte sind, falls vorhanden, nur für CLI/CI-Benutzer gedacht.
  • Fragen Sie nur nach tatsächlich fehlenden Informationen: Anmeldedaten, ZIP-Pfad, Projektname, öffentliche/private Sichtbarkeit oder Einstellung für privates Zugangspasswort.
  • Schreiben Sie niemals Anmeldedaten in eine Projekt-ZIP- oder Repository-Datei. Speichern Sie sie nur in der lokalen Datei ~/.publisher/config.json des Benutzers nach Zustimmung.
  • Unter Windows/PowerShell verwenden Sie eine temporäre JSON-Datei für Anfragekörper anstelle von Shell-Escaping von Inline-JSON.

Intent-Mapping

BenutzerabsichtAktionFehlende Informationen zum Nachfragen
Veröffentlichen, ausliefern, hochladen, online stellenProjekt veröffentlichenZIP-Pfad, Projektname
Eine installierbare Telefon-App, APK, Android-Paket erstellenVeröffentlichen und APK bauenZIP-Pfad, Projektname
APK für ein bereits veröffentlichtes Projekt bauenAPK bauenProjekt-ID; bei Bedarf Projektliste verwenden
Eine App privat/öffentlich machen, Zugangspasswort hinzufügen/entfernenSichtbarkeit ändernApp-URL, Ziel-Sichtbarkeit (optionales Passwort bei privat)
Meine Projekte anzeigen, veröffentlichte Projekte auflistenProjekte auflistenkeine, wenn Token verfügbar
Anmelden, registrieren, Konto einrichtenAnmelden/RegistrierenBenutzername und Passwort

Wenn die Absicht mehrdeutig ist, stellen Sie eine kurze Frage: "Nur veröffentlichen, oder veröffentlichen und auch eine Android-APK bauen?"

Veröffentlichungs-Gesprächsablauf

Wenn Benutzer Absichten wie Veröffentlichen, Bereitstellen, Starten, Teilen von Anwendungen, Erstellen von Zugangslinks usw. äußern, MÜSSEN sie diesen Prozess durchlaufen.

Allgemeine Prinzipien des endlichen Automaten

  • Beim Betreten des Ablaufs führen Sie zuerst S-1 aus (Versionsprüfung, nicht blockierend), dann fahren Sie in der Reihenfolge S0 -> S1 -> S2 -> S3 -> S4 fort.
  • Das Überspringen von Schritten ist nicht erlaubt (außer S-1).
  • Mehrere Felder können nicht in einer einzigen Anfrage abgefragt werden. Informationen, die der Benutzer eindeutig angegeben hat, können aufgezeichnet werden, und es besteht keine Notwendigkeit, wiederholt nachzufragen. Wenn die Antwort des Benutzers mehrdeutig ist, folgen Sie nur einmal für das aktuelle Feld nach.
  • Erst nach Abschluss des aktuellen Schritts können wir zum nächsten Schritt übergehen.
  • Wenn auf eine Benutzereingabe gewartet werden muss, fügen Sie am Ende der Antwort keine Erklärungen, Vorschläge oder Vorschauen auf den nächsten Schritt an.

S-1: Versionsprüfung (erster Knoten des Veröffentlichungsablaufs, nicht blockierend)

Führen Sie beim Betreten des Veröffentlichungsablaufs eine Versionsselbstprüfung vor S0 durch. Dieser Schritt ist NICHT Teil der <HARD-GATE>-Blockierungsregeln: Unabhängig vom Ergebnis – selbst wenn der Endpunkt nicht erreichbar ist – fahren Sie immer fort. Unterbrechen Sie niemals die Veröffentlichung aufgrund eines Versionsproblems.

Schritte:

  1. Lesen Sie die lokale Fähigkeitsversion: das Feld version im Frontmatter dieser Datei.

  2. Fragen Sie die neueste Plattformversion ab (keine Anmeldung erforderlich):

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

    Die Antwort data enthält: version (neueste), downloadUrl (plattformübergreifendes Dokumentationspaket, entpacken und verwenden), downloadUrlWindows (Windows-Installer .exe), und downloadUrlMac (macOS-Installer .zip).

  3. Vergleichen Sie die lokale version mit der zurückgegebenen version.

    Vergleichsregel: Eine Version ist major.minor.patch. Vergleichen Sie Segment für Segment als Ganzzahlen von links nach rechts – zuerst Major, dann Minor, dann Patch; füllen Sie fehlende Segmente mit 0 auf (1.1 bedeutet 1.1.0). Vergleichen Sie als Ganzzahlen, NICHT als Zeichenketten: 1.10.0 ist größer als 1.9.0 (zweites Segment 10 > 9); ein Zeichenkettenvergleich würde dies falsch machen. Aufsteigendes Beispiel: 1.0.0 < 1.0.9 < 1.1.0 < 1.2.0 < 1.10.0 < 2.0.0.

    • Lokal ist älter (die ganzzahlige Segment-Sequenz der lokalen ist kleiner als die zurückgegebene): Sie MÜSSEN dem Benutzer vor dem Fortfahren einen Update-Hinweis ausgeben, und der Hinweis MUSS die tatsächliche Download-URL enthalten (dies blockiert die Veröffentlichung nicht, aber der Hinweis darf nicht weggelassen werden). Wählen Sie die Download-URL basierend auf dem Betriebssystem des Benutzers aus:

      • Windows → verwenden Sie downloadUrlWindows
      • macOS → verwenden Sie downloadUrlMac
      • Betriebssystem unbekannt, oder das passende Feld ist leer → greifen Sie auf die generische downloadUrl zurück

      Hinweistext (geben Sie ihn in DERSELBEN Sprache aus, in der der Benutzer spricht – Chinesisch, wenn er Chinesisch schreibt, Englisch, wenn Englisch; codieren Sie nicht eine Sprache fest; das folgende Beispiel ist nur als englische Vorlage; ersetzen Sie die URL mit der tatsächlich ausgewählten; schreiben Sie die Download-URL als klickbaren Markdown-Link [URL](URL) – umschließen Sie sie NICHT mit Backticks als Inline-Code, sonst kann der Benutzer nicht darauf klicken; lassen Sie niemals einen Platzhalter stehen, sagen Sie niemals "eine neue Version existiert", ohne den Link zu geben):

      Hinweis: Eine neuere Publisher-Fähigkeitsversion <version> ist verfügbar (Sie haben <lokale Version>). Download: https://ai-pub.pushwebly.com/downloads/AI_Publisher_skill.exe (Das Update beeinträchtigt die aktuelle Veröffentlichung nicht).

    • Lokal ist gleich oder neuer: bleiben Sie still und fahren Sie fort.

    • Anfrage fehlgeschlagen/Zeitüberschreitung/kann nicht analysiert werden: stillschweigend überspringen, gehen Sie direkt zu S0, zeigen Sie keinen Fehler an.

  4. Gehen Sie in allen Fällen als nächstes zu S0. Da dieser Schritt nur benachrichtigt (keine Eingabe, keine Blockierung), gilt die Regel "höchstens eine benutzerorientierte Frage pro Antwort" nicht für ihn – der Versionshinweis darf dieselbe Antwort wie die erste S0-Frage teilen.


S0: Kontostatus prüfen

Prüfen Sie zuerst, ob bereits ein verfügbarer Token/lokale Anmeldedaten vorhanden sind.

  • Wenn Sie bereits Kontodaten haben: gehen Sie zu S2.
  • Wenn keine Kontodaten vorhanden sind: Gehen Sie zu S1_USERNAME.
  • Wenn der Kontostatus nicht überprüft werden kann: Fragen Sie den Benutzer, ob er bereits ein Veröffentlichungskonto hat.

Stellen Sie dem Benutzer eine Frage:

Ich muss zuerst das Veröffentlichungskonto bestätigen: Haben Sie bereits ein verfügbares Konto oder einen Token?

Antwort des Benutzers:

  • Ja: Fordern Sie den Benutzer auf, den Token/die Anmeldedaten bereitzustellen oder zu bestätigen, dann fahren Sie mit S2 fort.
  • Nein: Gehen Sie zu S1_USERNAME.

S1: Registrierungs- und Anmeldeprozess

S1_USERNAME: Registrierten Benutzernamen erfassen

Wenn kein Benutzername vorhanden ist, fragen Sie nur:

Bitte geben Sie den zu registrierenden Benutzernamen an.

Nach Erhalt des Benutzernamens zeichnen Sie ihn als username auf und gehen Sie zu S1_PASSWORD.

S1_PASSWORD: Registrierungspasswort erfassen

Wenn kein Passwort vorhanden ist, fragen Sie nur:

Bitte geben Sie das Registrierungspasswort an.

Nach Erhalt des Passworts zeichnen Sie es als password auf und gehen Sie zu S1_VALIDATE.

S1_VALIDATE: Gemeinsame Validierung

Erst wenn sowohl username als auch password vorhanden sind, kann die Backend-Schnittstelle zur gemeinsamen Überprüfung aufgerufen werden.

Validierung bestanden:

  • Konto erstellen
  • Anmeldung abschließen
  • Hinweis: Registrierung und Anmeldung erfolgreich
  • Gehen Sie zu S2

Validierung fehlgeschlagen:

  • Zeigen Sie den spezifischen Fehlergrund an, den das Backend zurückgegeben hat
  • Fragen Sie nur nach dem Element, das korrigiert werden muss
  • Beenden Sie den Registrierungsprozess nicht

S2: Sichtbarkeit der Anwendung erfragen

Wenn der öffentliche oder private Status nicht klar definiert ist, fragen Sie nur:

Ist diese Anwendung öffentlich? Öffentlich bedeutet, dass jeder über einen Link darauf zugreifen kann; privat erfordert ein 6-stelliges Zugangspasswort.

Antwort des Benutzers:

  • Öffentlich / Ja / öffentlich: Zeichnen Sie visibility=public auf, gehen Sie zu S4
  • Privat / Nein / privat: Zeichnen Sie visibility=private auf, gehen Sie zu S3
  • Unklar: Fragen Sie nur zu diesem Element weiter

S3: Privates Zugangspasswort

Wenn visibility=private ist, muss gefragt werden, ob das Passwort angepasst werden soll. Fragen Sie nur:

Möchten Sie ein 6-stelliges Zugangspasswort selbst festlegen? Sie können auch "systemgeneriert" antworten.

Antwort des Benutzers:

  • Passwort angeben: Überprüfung muss 6 Ziffern oder Buchstaben sein; nach Bestehen zeichnen Sie accessPassword=<Benutzerpasswort> auf und gehen zu S4
  • Antwort systemgeneriert / Nicht erforderlich / Zufällig: Übergeben Sie accessPassword nicht, lassen Sie es vom Backend generieren, und gehen Sie zu S4
  • Passwortformatfehler: Weisen Sie nur auf die Formatanforderungen hin und fragen Sie erneut nach dem Passwort

S4: Veröffentlichung ausführen

Das Aufrufen der Veröffentlichungsschnittstelle ist nur erlaubt, wenn eine der folgenden Bedingungen erfüllt ist:

  • visibility=public
  • visibility=private und der Benutzer hat ein benutzerdefiniertes Passwort oder ein systemgeneriertes Passwort ausgewählt

Veröffentlichungsparameter:

Öffentliche Anwendung:

{
  "visibility": "public"
}

Private Anwendung, benutzerdefiniertes Passwort:

{
  "visibility": "private",
  "accessPassword": "<Benutzerpasswort>"
}

Private Anwendung, systemgeneriertes Passwort (accessPassword nicht übergeben):

{
  "visibility": "private"
}

Nach erfolgreicher Veröffentlichung leiten Sie die URL immer an den Benutzer weiter (z. B. playUrl aus der Antwort). Wenn es sich um eine private Anwendung handelt, geben Sie die URL und das Zugangspasswort getrennt weiter, niemals mit ?pwd= im Link.

Standardmäßig public, wenn der Benutzer keine Sichtbarkeit angibt. Ein privates Zugangspasswort muss ^[A-Za-z0-9]{6}$ entsprechen; andernfalls fragen Sie nach einem gültigen Passwort oder lassen Sie das Backend eines generieren.

Token-Behandlung

Für alle Veröffentlichungs-APIs ist ein Bearer-Token erforderlich.

Verwenden Sie diese Reihenfolge:

  1. Wenn der Benutzer einen Token im Gespräch bereitgestellt hat, verwenden Sie ihn direkt.
  2. Wenn ~/.publisher/config.json existiert, lesen Sie den gespeicherten Benutzernamen/das gespeicherte Passwort und melden Sie sich erneut an, um den Token zu aktualisieren.
  3. Andernfalls fragen Sie nach Benutzername und Passwort. Der Anmeldeendpunkt registriert neue Konten automatisch.

Anmelde-/Registrierungsendpunkt:

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

Schreiben Sie login.json als:

{"username":"alice","password":"plain-text-password"}

Verwenden Sie data.token aus der Antwort als:

Authorization: Bearer <TOKEN>

Löschen Sie die temporäre Anmeldedatei nach der Verwendung.

Optionale lokale Anmeldedatendatei:

{
  "baseUrl": "https://ai-pub.pushwebly.com",
  "username": "alice",
  "password": "plain-text-password",
  "authorization": "Bearer <TOKEN>",
  "userId": 1
}

Setzen Sie unter Linux/macOS den Modus 600 nach dem Schreiben. Bei 401 aktualisieren Sie den Token einmal, indem Sie sich erneut anmelden, und wiederholen Sie die fehlgeschlagene Operation einmal.

Token verifizieren:

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

Vor der Veröffentlichung Prüfungen

Vor der Veröffentlichung:

  1. Bestätigen Sie, dass die Datei existiert und eine .zip-Erweiterung hat.
  2. Bestätigen Sie, dass das ZIP index.html oder index.htm enthält.
  3. Wenn das ZIP verschachtelte Verzeichnisse hat, bestätigen Sie, dass die Einstiegsdatei gefunden werden kann.
  4. Bestätigen Sie, dass der Projektname nicht leer ist.
  5. Bestätigen Sie, dass ein gültiger Token verfügbar ist.

HTTP-Operationen

Projekt veröffentlichen

Öffentlich:

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

Privat mit optionalem benutzerdefiniertem Passwort:

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

Lassen Sie bei privaten Apps access_password weg, damit das Backend ein Passwort generiert. Leiten Sie immer das endgültige accessPassword aus der Antwort an den Benutzer weiter.

Projekte auflisten

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

Sichtbarkeit ändern (öffentlich <-> privat)

Schalten Sie eine bereits veröffentlichte App zwischen öffentlich und privat um. Die Eingabe ist die App-URL; das Backend parst die App-Kennung daraus und überprüft, ob die App dem aktuellen Benutzer gehört – Sie können nur Ihre eigenen Apps ändern, nicht die anderer.

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

Schreiben Sie visibility.json (auf privat):

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

Oder auf öffentlich (kein Passwort erforderlich; das alte Passwort wird gelöscht):

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

accessPassword ist optional und wird nur beim Umschalten auf privat verwendet (6 Ziffern oder Buchstaben; bei Weglassen automatisch generiert). Die Antwort data enthält die endgültige visibility, url und – bei privat – das accessPassword. Leiten Sie die URL und das Passwort einer privaten App getrennt weiter, niemals mit ?pwd=. Wenn die App nicht gefunden, bereits gelöscht oder im Besitz eines anderen Benutzers ist, geben Sie den konkreten Grund an und dass nur Ihre eigenen Apps geändert werden können.

APK für ein bestehendes Projekt bauen

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

Schreiben Sie build-apk.json als:

{"projectId":12}

Verwenden Sie data.apkUrl aus der Antwort als APK-Download-URL.

Veröffentlichen und APK bauen

Dies ist die empfohlene Operation, wenn der Benutzer eine installierbare Android-App wünscht.

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

Für eine private App fügen Sie hinzu:

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

Lassen Sie access_password zur automatischen Generierung weg.

Erwartete Antwortfelder können enthalten:

{
  "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",
  "apkFileName": "airplane-war.apk",
  "accessPassword": null
}

Aus der Antwort benachrichtigen Sie den Benutzer: "Ihre App ist live unter <playUrl>" und, wenn apkUrl vorhanden ist: "APK-Download: <apkUrl>". Leiten Sie bei privaten Apps auch das accessPassword aus der Antwort weiter; wenn es null oder nicht gesetzt ist, lassen Sie es weg.

APK-Status abfragen

curl -s https://ai-pub.pushwebly.com/api/apk/status/12 \
  -H "Authorization: Bearer <TOKEN>"

Erwartete Antwortfelder:

FeldTypBeschreibung
projectIdZahlEindeutige ID des veröffentlichten Projekts
projectNameZeichenketteProjektname
gameIdZahlVeraltet – identisch mit projectId
playUrlZeichenketteURL zum Spielen/Ansehen der App
apkUrlZeichenkette oder nullDirekter APK-Download-Link; null bedeutet: noch nicht gebaut oder noch nicht fertig
apkStatusZeichenketteEiner von: not_started, building, completed, failed
visibilityZeichenkettepublic oder private

Wenn apkStatus nicht in der Antwort enthalten ist, behandeln Sie es als not_started.

APK-Build-Fortschritt

Führen Sie nach dem Aufruf des APK-Build-Endpunkts eine maximal 60 Sekunden dauernde Abfrageschleife aus. Fragen Sie den Build-Status alle 5 Sekunden ab. Es gibt drei Beendigungszustände:

  1. completed – geben Sie die apkUrl an den Benutzer weiter.
  2. failed – geben Sie dem Benutzer einen Fehlerhinweis (z. B. Fehler bei der APK-Erstellung). Schlagen Sie nicht vor, es mit einem einfacheren Projekt erneut zu versuchen – APK-Fehler sind normalerweise plattformseitig und nicht projektspezifisch.
  3. 60 Sekunden erreicht (keiner der obigen Zustände) – weisen Sie den Benutzer an, den Build-Status später mit dem APK-Status-Endpunkt zu überprüfen.

Verwandte Skills