パブリッシャースキル は何をしますか?
HTMLフロントエンドプロジェクトを公開プラットフォームに公開し、オプションでAndroid APKとしてパッケージ化します。
プラットフォームURL:
https://pushwebly.com
ユーザー向けメッセージでは「プロジェクト」を使用してください。正規のAPIパスは/api/projects、正規のツール名はproject_*です。非推奨のgame_*エイリアスやgameIdレスポンスフィールドが表示される場合がありますが、gameIdはプロジェクトIDとして扱ってください。
Codex実行ルール
- マウント済みの
project_*MCPツールが現在の環境に存在する場合は、それらを優先して使用します。 - リモートMCPツールがマウントされていない場合は、
curlでHTTP APIを使用します。 - Pythonは必要ありません。オプションのスクリプトは、CLI/CIユーザーのみを対象としています。
- 本当に不足している情報のみを尋ねてください。認証情報、ZIPパス、プロジェクト名、公開/非公開の可視性、非公開アクセスパスワードの設定などです。
- 認証情報をプロジェクトZIPやリポジトリファイルに書き込まないでください。ユーザーのローカル
~/.publisher/config.jsonにのみ、同意を得た上で保存します。 - Windows/PowerShellでは、インラインJSONのシェルエスケープの代わりに、リクエストボディ用の一時JSONファイルを使用します。
インテントマッピング
| ユーザーの意図 | アクション | 尋ねるべき不足情報 |
|---|---|---|
| 公開、出荷、アップロード、オンラインにする | プロジェクトの公開 | ZIPパス、プロジェクト名 |
| インストール可能な電話アプリ、APK、Androidパッケージを作成する | 公開とAPKビルド | ZIPパス、プロジェクト名 |
| 既に公開されているプロジェクトのAPKをビルドする | APKのビルド | プロジェクトID。必要に応じてプロジェクト一覧を使用 |
| アプリを非公開/公開にする、アクセスパスワードを追加/削除する | 可視性の変更 | アプリURL、対象の可視性(非公開時はオプションでパスワード) |
| 自分のプロジェクトを表示する、公開済みプロジェクトを一覧表示する | プロジェクト一覧 | トークンが利用可能な場合はなし |
| ログイン、登録、アカウント設定 | ログイン/登録 | ユーザー名とパスワード |
インテントが曖昧な場合は、短い質問を1つしてください:「公開するだけですか、それとも公開してAndroid APKもビルドしますか?」
公開会話プロセス
ユーザーがアプリケーションの公開、デプロイ、起動、共有、アクセスリンクの生成などの意図を表明した場合、このプロセスに入る必要があります。
有限状態機械の一般原則
- フローに入ったら、最初に
S-1(バージョンチェック、非ブロッキング)を実行し、その後S0 -> S1 -> S2 -> S3 -> S4の順に進みます。 - ステップのスキップはできません(
S-1を除く)。 - 1回のリクエストで複数のフィールドを問い合わせることはできません。 ユーザーが明確に提供した情報は記録でき、繰り返し尋ねる必要はありません。 ユーザーの応答が曖昧な場合、現在のフィールドについて1回だけフォローアップします。
- 現在のステップが完了した後にのみ、次のステップに進むことができます。
- ユーザー入力を待つ必要がある場合、応答の最後に説明、提案、次のステップのプレビューを追加しないでください。
S-1: バージョンチェック(公開フローの最初のノード、非ブロッキング)
公開フローに入ったら、S0の前にバージョンセルフチェックを実行します。このステップは**<HARD-GATE>ブロッキングルールの一部ではありません**。エンドポイントに到達できない場合でも、結果に関わらず常に続行します。バージョン問題のために公開を中断しないでください。
手順:
-
ローカルのスキルバージョンを読み取ります。このファイルのフロントマターの
versionフィールドです。 -
最新のプラットフォームバージョンを照会します(ログイン不要):
curl -s https://ai-pub.pushwebly.com/api/skill/latest-versionレスポンス
dataには、version(最新)、downloadUrl(クロスプラットフォームドキュメントパッケージ、解凍して使用)、downloadUrlWindows(Windowsインストーラ.exe)、downloadUrlMac(macOSインストーラ.zip)が含まれます。 -
ローカルの
versionと返されたversionを比較します。比較ルール: バージョンは
major.minor.patchです。左から右に整数としてセグメントごとに比較します。最初にメジャー、次にマイナー、次にパッチ。不足しているセグメントは0で埋めます(1.1は1.1.0を意味します)。整数として比較し、文字列としては比較しないでください。1.10.0は1.9.0より大きいです(2番目のセグメント10 > 9)。文字列比較ではこれが間違ってしまいます。昇順の例:1.0.0 < 1.0.9 < 1.1.0 < 1.2.0 < 1.10.0 < 2.0.0。-
ローカルが古い場合(ローカルの整数セグメントシーケンスが返されたものより小さい場合):続行する前にユーザーに更新通知を必ず出力する必要があります。そして通知には実際のダウンロードURLを含める必要があります(これは公開をブロックしませんが、通知は省略してはなりません)。ユーザーのOSに応じてダウンロードURLを選択します:
- Windows →
downloadUrlWindowsを使用 - macOS →
downloadUrlMacを使用 - OSが不明、または一致するフィールドが空の場合 → 汎用の
downloadUrlにフォールバック
通知テキスト(ユーザーが会話しているのと同じ言語で出力します — ユーザーが中国語で書けば中国語、英語で書けば英語。言語をハードコーディングしないでください。以下の例はテンプレートとしての英語のみです。URLを実際に選択したものに置き換えてください。ダウンロードURLはクリック可能なMarkdownリンク
[URL](URL)として記述してください — インラインコードとしてバッククォートで囲まないでください。そうしないとユーザーがクリックできません。プレースホルダーを残したり、「新しいバージョンが存在します」と言うだけでリンクを提供しないことは絶対に避けてください):注意: 新しいバージョンのPublisherスキル
<version>が利用可能です(現在のバージョンは<local version>です)。ダウンロード: https://ai-pub.pushwebly.com/downloads/AI_Publisher_skill.exe(アップデートは現在の公開に影響しません)。 - Windows →
-
ローカルが同一または新しい場合:何も言わずに続行します。
-
リクエストが失敗/タイムアウト/解析不能の場合:静かにスキップし、直接
S0に進み、エラーを表示しないでください。
-
-
すべての場合において、次に
S0に進みます。このステップは通知のみで(入力なし、ブロッキングなし)、「1回の応答につき1つのユーザー向け質問」ルールは適用されません。バージョン通知は最初のS0質問と同じ応答に含めることができます。
S0: アカウントステータスの確認
まず、利用可能なトークン/ローカル認証情報が既にあるかどうかを確認します。
- 既にアカウント認証情報がある場合:
S2に進みます。 - アカウント認証情報がない場合:
S1_USERNAMEに入ります。 - アカウントステータスを確認できない場合:ユーザーに公開アカウントを持っているかどうかを尋ねます。
ユーザーに質問します:
まず公開アカウントを確認する必要があります:利用可能なアカウントまたはトークンは既にありますか?
ユーザーの回答:
- はい:ユーザーにトークン/ログイン認証情報を提供または確認するよう要求し、
S2に進みます。 - いいえ:
S1_USERNAMEに入ります。
S1: 登録とログインプロセス
S1_USERNAME: 登録ユーザー名の収集
ユーザー名がない場合、次のみを尋ねます:
登録するユーザー名を入力してください。
ユーザー名を受け取ったら、usernameとして記録し、S1_PASSWORDに入ります。
S1_PASSWORD: 登録パスワードの収集
パスワードがない場合、次のみを尋ねます:
登録パスワードを入力してください。
パスワードを受け取ったら、passwordとして記録し、S1_VALIDATEに入ります。
S1_VALIDATE: 統合検証
usernameとpasswordの両方がある場合のみ、バックエンドインターフェースを呼び出して統合検証を実行できます。
検証成功:
- アカウント作成
- ログイン完了
- プロンプト:「登録とログインが成功しました」
S2に入る
検証失敗:
- バックエンドから返された具体的なエラー理由を表示
- 修正が必要な項目についてのみ問い合わせ
- 登録プロセスを終了しない
S2: アプリケーションの可視性について問い合わせ
公開または非公開の状態が明確に定義されていない場合、次のみを尋ねます:
このアプリケーションは公開ですか? 公開の場合、誰でもリンクからアクセスできます。非公開の場合は、6桁のアクセスパスワードが必要です。
ユーザーの回答:
- 公開 / はい / public:
visibility=publicを記録し、S4に入る - 非公開 / いいえ / private:
visibility=privateを記録し、S3に入る - 不明確:この項目についてのみ引き続き尋ねる
S3: 非公開アクセスパスワード
visibility=privateの場合、パスワードをカスタマイズするかどうかを尋ねる必要があります。次のみを尋ねます:
6桁のアクセスパスワードをカスタマイズしますか? 「システム生成」と返信することもできます。
ユーザーの回答:
- パスワードを提供:検証は6桁の数字または文字でなければなりません。検証に合格したら、
accessPassword=<ユーザーパスワード>を記録し、S4に入る - システム生成 / 不要 / ランダムと返信:
accessPasswordを渡さず、バックエンドに生成させ、S4に入る - パスワード形式エラー:形式要件のみを促し、パスワードを再度尋ねる
S4: 公開の実行
以下の条件のいずれかが満たされた場合のみ、公開インターフェースの呼び出しが許可されます:
visibility=publicvisibility=privateで、ユーザーがカスタムパスワードまたはシステム生成パスワードを選択した
公開パラメータ:
公開アプリケーション:
{
"visibility": "public"
}
非公開アプリケーション、カスタムパスワード:
{
ユーザーが可視性を指定しない場合、デフォルトでpublicになります。非公開アクセスパスワードは^[A-Za-z0-9]{6}$に一致する必要があります。そうでない場合は、有効なパスワードを尋ねるか、バックエンドに生成させます。
トークン処理
すべての公開APIにはBearerトークンが必要です。
この順序を使用します:
- ユーザーが会話でトークンを提供した場合は、それを直接使用します。
~/.publisher/config.jsonが存在する場合は、保存されているユーザー名/パスワードを読み取り、再度ログインしてトークンを更新します。- それ以外の場合は、ユーザー名とパスワードを尋ねます。ログインエンドポイントは新しいアカウントを自動的に登録します。
ログイン/登録エンドポイント:
curl -s -X POST https://ai-pub.pushwebly.com/api/auth/login-or-register \
-H "Content-Type: application/json" \
-d @login.json
login.jsonを次のように記述します:
{"username":"alice","password":"プレーンテキストパスワード"}
レスポンスのdata.tokenを次のように使用します:
Authorization: Bearer <TOKEN>
使用後は一時ログインファイルを削除します。
オプションのローカル認証情報ファイル:
{
"baseUrl": "https://ai-pub.pushwebly.com",
"username": "alice",
"password": "プレーンテキストパスワード",
"authorization": "Bearer <TOKEN>",
"userId": 1
}
Linux/macOSでは、書き込み後にモード600を設定します。401の場合は、再度ログインしてトークンを1回更新し、失敗した操作を1回再試行します。
トークンの検証:
curl -s https://ai-pub.pushwebly.com/api/auth/verify-token \
-H "Authorization: Bearer <TOKEN>"
公開前チェック
公開前に:
- ファイルが存在し、拡張子が
.zipであることを確認します。 - ZIPに
index.htmlまたはindex.htmが含まれていることを確認します。 - ZIPにネストされたディレクトリがある場合、エントリファイルが見つかることを確認します。
- プロジェクト名が空でないことを確認します。
- 有効なトークンが利用可能であることを確認します。
HTTP操作
プロジェクトの公開
公開:
curl -s -X POST https://ai-pub.pushwebly.com/api/projects/publish \
-H "Authorization: Bearer <TOKEN>" \
-F "project_name=demo" \
-F "[email protected]"
非公開(オプションのカスタムパスワード付き):
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"
非公開アプリの場合、access_passwordを省略すると、バックエンドがパスワードを生成します。レスポンスから最終的なaccessPasswordを常にユーザーに伝えます。
プロジェクト一覧
curl -s https://ai-pub.pushwebly.com/api/projects/my \
-H "Authorization: Bearer <TOKEN>"
可視性の変更(公開 <-> 非公開)
既に公開されているアプリを公開と非公開の間で切り替えます。入力はアプリURLです。バックエンドはそれからアプリ識別子を解析し、アプリが現在のユーザーに属していることを確認します。自分自身のアプリのみを変更でき、他のユーザーのものは変更できません。
curl -s -X PATCH https://ai-pub.pushwebly.com/api/projects/visibility \
-H "Authorization: Bearer <TOKEN>" \
-H "Content-Type: application/json" \
-d @visibility.json
visibility.jsonを次のように記述します(非公開にする場合):
{"url":"https://ai-pub.pushwebly.com/play/aB3xYz/","visibility":"private","accessPassword":"a1b2c3"}
または公開にする場合(パスワード不要。古いパスワードはクリアされます):
{"url":"https://ai-pub.pushwebly.com/play/aB3xYz/","visibility":"public"}
accessPasswordはオプションで、非公開に切り替える場合にのみ使用されます(6桁の数字または文字。省略時は自動生成)。レスポンスdataには、最終的なvisibility、url、および非公開の場合はaccessPasswordが含まれます。非公開アプリのURLとパスワードは別々に伝え、決して?pwd=と一緒に伝えないでください。アプリが見つからない、既に削除されている、または別のユーザーに属している場合は、具体的な理由と、自分のアプリのみを変更できることを伝えます。
既存プロジェクトのAPKビルド
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
build-apk.jsonを次のように記述します:
{"projectId":12}
レスポンスのdata.apkUrlをAPKダウンロードURLとして使用します。
公開とAPKビルド
これは、ユーザーがインストール可能なAndroidアプリを希望する場合の推奨操作です。
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 "visibility=private" -F "access_password=a1b2c3"
access_passwordを省略すると自動生成されます。
予想されるレスポンスフィールドには以下が含まれる場合があります:
{
"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..."
}