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.jsondes 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
| Benutzerabsicht | Aktion | Fehlende Informationen zum Nachfragen |
|---|---|---|
| Veröffentlichen, ausliefern, hochladen, online stellen | Projekt veröffentlichen | ZIP-Pfad, Projektname |
| Eine installierbare Telefon-App, APK, Android-Paket erstellen | Veröffentlichen und APK bauen | ZIP-Pfad, Projektname |
| APK für ein bereits veröffentlichtes Projekt bauen | APK bauen | Projekt-ID; bei Bedarf Projektliste verwenden |
| Eine App privat/öffentlich machen, Zugangspasswort hinzufügen/entfernen | Sichtbarkeit ändern | App-URL, Ziel-Sichtbarkeit (optionales Passwort bei privat) |
| Meine Projekte anzeigen, veröffentlichte Projekte auflisten | Projekte auflisten | keine, wenn Token verfügbar |
| Anmelden, registrieren, Konto einrichten | Anmelden/Registrieren | Benutzername 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-1aus (Versionsprüfung, nicht blockierend), dann fahren Sie in der ReihenfolgeS0 -> S1 -> S2 -> S3 -> S4fort. - 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:
-
Lesen Sie die lokale Fähigkeitsversion: das Feld
versionim Frontmatter dieser Datei. -
Fragen Sie die neueste Plattformversion ab (keine Anmeldung erforderlich):
curl -s https://ai-pub.pushwebly.com/api/skill/latest-versionDie Antwort
dataenthält:version(neueste),downloadUrl(plattformübergreifendes Dokumentationspaket, entpacken und verwenden),downloadUrlWindows(Windows-Installer .exe), unddownloadUrlMac(macOS-Installer .zip). -
Vergleichen Sie die lokale
versionmit der zurückgegebenenversion.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.1bedeutet1.1.0). Vergleichen Sie als Ganzzahlen, NICHT als Zeichenketten:1.10.0ist größer als1.9.0(zweites Segment10 > 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
downloadUrlzurü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). - Windows → verwenden Sie
-
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.
-
-
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 ersteS0-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
S2fort. - 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=publicauf, gehen Sie zuS4 - Privat / Nein / privat: Zeichnen Sie
visibility=privateauf, gehen Sie zuS3 - 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 zuS4 - Antwort systemgeneriert / Nicht erforderlich / Zufällig: Übergeben Sie
accessPasswordnicht, lassen Sie es vom Backend generieren, und gehen Sie zuS4 - 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=publicvisibility=privateund 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:
- Wenn der Benutzer einen Token im Gespräch bereitgestellt hat, verwenden Sie ihn direkt.
- Wenn
~/.publisher/config.jsonexistiert, lesen Sie den gespeicherten Benutzernamen/das gespeicherte Passwort und melden Sie sich erneut an, um den Token zu aktualisieren. - 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:
- Bestätigen Sie, dass die Datei existiert und eine
.zip-Erweiterung hat. - Bestätigen Sie, dass das ZIP
index.htmloderindex.htmenthält. - Wenn das ZIP verschachtelte Verzeichnisse hat, bestätigen Sie, dass die Einstiegsdatei gefunden werden kann.
- Bestätigen Sie, dass der Projektname nicht leer ist.
- 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:
| Feld | Typ | Beschreibung |
|---|---|---|
projectId | Zahl | Eindeutige ID des veröffentlichten Projekts |
projectName | Zeichenkette | Projektname |
gameId | Zahl | Veraltet – identisch mit projectId |
playUrl | Zeichenkette | URL zum Spielen/Ansehen der App |
apkUrl | Zeichenkette oder null | Direkter APK-Download-Link; null bedeutet: noch nicht gebaut oder noch nicht fertig |
apkStatus | Zeichenkette | Einer von: not_started, building, completed, failed |
visibility | Zeichenkette | public 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:
completed– geben Sie dieapkUrlan den Benutzer weiter.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.- 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.