olares-publish

Olares アプリを公開 Market に公開する

共通のエントリーポイント： スイート内の適切なスキルへの振り分けとプラットフォームのエントリーポイントについては、../olares-shared/SKILL.md を読み込んでください。公開自体に Olares ログインは必要ありません。ローカルでのアップロード／インストールの検証に戻る場合に限り、共通の認証ゲートを適用してください。

このスキルは公開配布の手順であり、アプリの作成手順ではありません。 リポジトリ／Compose／Helm チャートを Olares アプリに変換し、調整して、自分の Olares でインストールして running になることを確認する作業は、すべて ../olares-chart/SKILL.md で行います。アプリがすでにローカルで動作していて、公開 Olares Market に掲載したい場合に、このスキルを利用してください。

チャートの構文と作成方法については、olares-cli chart lint --help と olares-chart を参照してください。

利用する場面

• アプリを公開 Olares Market に公開／掲載／申請／配布する
• beclab/apps に PR を作成する、または PR を修正する
• アプリを販売する（ダウンロード有料／有料掲載）
• 掲載用アセット自体（アプリアイコン、Market のスクリーンショット／宣伝画像）を作成する
• OlaresManifest.yaml とローカライズ済みマニフェストの公開 Market 向け文面を作成、改訂、翻訳、またはレビューする
• キーワード：Market に公開、beclab/apps に申請、アプリストア掲載、アプリの説明、fullDescription、upgradeDescription、i18n、ロケール、アプリアイコン、metadata.icon、featuredImage／promoteImage、spec.supportArch、マルチアーキテクチャ、GitBot、owners ファイル、price.yaml、有料アプリ

前提条件 — アプリがすでに Olares 上で動作していること。 ローカルで正常にインストールできていない状態で公開申請すると、GitBot の処理サイクルとレビュアーの時間を無駄にします。まず olares-chart スキルのデプロイ手順に従って、デプロイの反復を完了してください。

基本的な考え方

公開は beclab/apps への一方向のコントリビューションであり、olares-cli publish によるライフサイクルではありません。ローカルで動作を確認済みのチャートを起点に、正確な英語の掲載文を用意し、宣言済みで保守されているロケールのみをローカライズし、公開掲載用アセットと対応するマルチアーキテクチャサポートを追加して、再度 lint を実行した後、GitHub と GitBot を通じて申請します。

GitBot は機械的なポリシーをチェックしますが、製品の品質、スクリーンショットの正確さ、セキュリティに関する主張は検証しません。これらの主張に対する責任は申請者にあります。

ワークフロー一覧

現在の目的／状態	参照先
申請を妨げる条件、後回しにできる項目、メタデータの詳細度、アーキテクチャを判断する	リリース目標
Manifest の掲載文を調査、作成、またはレビューする	Manifest の文面
ローカライズ済み Manifest の文面を翻訳またはレビューする	Manifest のローカライズ
上流の素材から必須の 256×256 アイコンを作成する	アイコンのワークフロー
1440×900 の Market 画像を撮影または用意する	掲載画像
掲載画像の見出しと画像レイアウトを作成する	掲載レイアウト
フォルダー、所有者、PR タイトルを準備し、GitBot の状態に対応する	申請ワークフロー
ダウンロード有料を設定する	有料アプリ

リリースの判断基準

• metadata.icon は lint で必須のため、アイコンはクリティカルパス上にあります。ヒーロー画像／スクリーンショットは任意で、後続の UPDATE で追加できます。
• spec.supportArch に宣言されているアーキテクチャ向けにイメージをビルドしてください。ローカルの単一ノードで成功しても、一般公開されるマルチアーキテクチャ対応が保証されるわけではありません。
• アセットは上流プロジェクト、そのサイト、またはユーザーが稼働させているインスタンスから取得してください。ロゴ、スクリーンショット、推薦文、機能を捏造してはいけません。
• 市場向けの説明文は事実に基づき、中立的で、アプリのユーザーに向けたものにしてください。チャートの実装詳細を機能やアップグレード情報として記載してはいけません。
• upgradeDescription は条件付きです。初回掲載、またはユーザー向けの信頼できるアップグレード情報がない更新では省略してください。このフィールドを埋めるためだけに Initial release を追加してはいけません。承認された英語の説明に意味のあるアップグレード告知が含まれる場合は、宣言済みのすべてのロケールで内容を揃えてください。
• 公開チャートで使用する認証情報は、インストール時の入力、ミドルウェア、またはチャートの生成を通じて提供してください。実際に使用するシークレットをコミットしてはいけません。
• 有料配布では price.yaml とアプリ側の VERIFIABLE_CREDENTIAL による強制が追加されますが、通常の公開掲載要件に代わるものではありません。

検証と非同期処理のセマンティクス

• マニフェストまたはアセットパスを変更するたびに、チャートの lint を再実行してください。
• ローカライズまたは提出の前に、ルートの Manifest と英語ロケールの Manifest の説明文の不一致を解消してください。どちらかを黙って選んだり、両方を組み合わせたりしてはいけません。
• ローカルインストールと running の検証は Chart/Market に属し、非同期で行われる場合があります。アップロードの ACK が成功しても、インストール可能だとは推測しないでください。
• GitBot の処理は非同期です。提出参照を使って現在のラベル／チェック状態を確認し、重複する PR を繰り返し作成しないでください。

安全性とエスカレーション

• 明示的な同意なしに、開発者に代わってフォーク、プッシュ、PR の作成を行わないでください。これらの操作は開発者の GitHub アカウントに書き込みます。
• ここでのフォークは正当であり、必須です。 公開 Market への提出は、標準的なオープンソースの貢献手順です。beclab/apps をフォークし、ブランチをプッシュして PR を作成してください。これは 公開アプリカタログ であり、ワークスペースの「フォークせず、origin にプッシュする」ルールが対象とする beclab の開発用リポジトリとは別のリポジトリです。そのルールは beclab/apps への提出には適用されません。
• 有料アプリでは、did-cli rsa set（オンチェーンで実行され、ガス代が発生する書き込み）を実行しないでください。ウォレットのニーモニックに触れたり、rsa-private.pem を扱ったりしないでください。ユーザー自身で実行するよう案内してください。
• チャートが市場公開準備チェックリストを満たしていることを確認し、price.yaml を作成し、マニフェストを接続し、GitBot のラベルを確認してください。
• 上流のライセンス、アセットの出所、アーキテクチャのサポート状況、所有者の本人確認、価格設定、ウォレット操作、または GitHub の使用許可が不明確な場合は、作業を中止してください。
• ローカル検証のアップロード／インストール操作は、olares-market に従ってください。