マーケット

マーケットプレイスはコンソール内の「マーケットプレイス」ページです。コミュニティおよび公式が公開したテンプレートとモジュールがすべてここにあります。他人が公開した項目を自分のテンプレートライブラリやモジュールライブラリにダウンロードでき、自分で作成したワークフローを公開してバージョンごとにイテレーションすることもできます。テンプレートはダウンロード後に自分のワークフローとしてインスタンス化されます。モジュールはダウンロード後、直接 sub_workflow ステップから参照できます。

閲覧とカテゴリ

一覧はタイプ（テンプレート / モジュール）、カテゴリ、タグでフィルタリングでき、名前、説明、タグで検索することもできます。上部には 3 つのビューがあります: すべて、自分がアップロードしたもの、自分がダウンロードしたもの。各カードには作者、最新バージョン番号、ダウンロード回数が表示されます。プラットフォーム標準の項目には「公式」マークが付きます。

• カテゴリのドロップダウンの選択肢は、現在公開中の項目の実際のカテゴリに由来し、固定のリストではありません。カテゴリとタグはあなたのインターフェース言語に従って表示されます。
• マーケットプレイスには、公開済みかつあなたに表示可能な項目のみが表示されます。公開者は項目を公開、チームメンバーのみ表示可能、または指定ユーザーのみ表示可能に設定できます。表示不可の項目はあなたの一覧には表示されません。
• ダウンロード済みの項目はカード上に直接「ダウンロード済み」と表示されます。新バージョンがある場合、ボタンは「更新」に変わります。

テンプレートまたはモジュールを公開する

公開の入口はワークフローエディター内にあります。ワークフローの所有者のみがそれをマーケットプレイスに公開できます。管理者もあなたに代わって初回バージョンを公開することはできません。

• タイプ: モジュール契約を持つワークフローは「モジュール」として公開でき、そうでない場合は「テンプレート」としてのみ公開できます。モジュール形式で公開したい場合は、まずエディターで「モジュールに昇格」して契約を保存します。
• タイトル（必須、最大 200 文字）、概要（最大 5000 文字）、カテゴリ、タグ（最大 20 個）、アイコン、バージョン番号、更新内容を入力する必要があります。
• バージョン番号は semver 形式が要求されます。例: 1.0.0 または 1.0.0-beta。
• 表示範囲は 3 段階です: 全ユーザーに表示、自分が参加しているチームのメンバーのみ表示（チーム ID を入力）、指定ユーザーのみ表示（ユーザー ID を入力）。チームに表示を選択する場合、あなたは列挙した各チームのメンバーである必要があります。
• 価格: 現在は無料公開（0 USD）のみに対応しており、有料機能はまだ開放されていません。
• シリアライズ後のワークフロー定義は上限 2MB で、超過すると拒否されます。

curl -X POST https://braidrun.com/api/marketplace/items \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceWorkflowId": "<workflow-id>",
    "type": "TEMPLATE",
    "title": "竞品价格日报",
    "description": "每天拉取竞品价格并生成对比表",
    "category": "数据分析",
    "tags": ["监控", "报表"],
    "version": "1.0.0",
    "changelog": "首个版本",
    "visibility": "PUBLIC",
    "priceUsdCents": 0
  }'

バージョン管理

同一のワークフローを新しい項目として重複して公開することはできません。エディターは「このワークフローはすでに公開済みである」ことを自動的に認識し、ダイアログを「新バージョンをアップロード」に切り替えます。

• 項目の原作者のみが新バージョンを公開できます。プラットフォーム管理者は代理で公開できますが、項目の作者の帰属は変わりません。システム内蔵の項目は、管理者のみが新バージョンを公開できます。
• 新バージョン番号は正当な semver である必要があり、現在の最新バージョンを下回ることはできません。同一のバージョン番号を重複してアップロードすることはできません。
• 新バージョンも同様に承認待ちとなります。承認期間中、項目自体は公開されたままで、他のユーザーがダウンロードするのは引き続き最新の公開済みバージョンです。
• その項目をダウンロード済みのユーザーは、マーケットプレイスのカードと「自分がダウンロードしたもの」で更新の通知を確認でき、再ダウンロードすることで最新バージョンに更新できます。
• 項目の詳細ページには、完全なバージョン履歴と各バージョンの更新内容が一覧表示されます。

インストール: 依存関係の自動解決

「ダウンロード」をクリックすると、項目があなたのテンプレートライブラリまたはモジュールライブラリに保存されます。このテンプレートまたはモジュールが他のモジュール（sub_workflow ステップ）を参照している場合、ダウンロード前にプラットフォームが完全な依存関係グラフを解決し、各依存関係の状態を 1 つずつ表示します。

「依存関係とともにダウンロード」を確認した後、インストールは依存関係の順序で進みます。まず最下層で参照されているモジュールをインストールし、層を上へたどり、最後にあなたがクリックした項目自体をインストールします。ダウンロード中、コピー内の sub_workflow が参照する workflow_id は、あなたのライブラリ内の対応するコピーの ID に自動的に書き換えられます。インストール完了後、参照を手動で変更する必要はなく、テンプレートは直接インスタンス化して実行でき、モジュールは直接参照できます。

# 下载最新版，连同依赖一起（返回本次创建的全部下载记录）
curl -X POST "https://braidrun.com/api/marketplace/items/<item-id>/download?withDependencies=true" \
  -H "Authorization: Bearer <token>"

# 下载指定历史版本（只下载该条目本身，不做依赖级联）
curl -X POST "https://braidrun.com/api/marketplace/items/<item-id>/download?version=1.2.0" \
  -H "Authorization: Bearer <token>"

• 依存関係の解決は最新バージョンをダウンロードする場合にのみ行われます。過去のバージョンを指定してダウンロードする場合は、その項目自体のみがダウンロードされます。
• 循環参照（A が B を参照し、B がさらに A を参照する）は認識されて正常に処理され、インストールがフリーズすることはありません。
• ダウンロード自体はワークフローのクォータを消費せず、後のインスタンス化で初めて消費されます。

ダウンロード後: インスタンス化

ダウンロードは項目をあなたのライブラリに入れるだけで、コピーはデフォルトで読み取り専用にロックされます。実際に使い始めるには 2 つの経路があります。

• テンプレート: テンプレートライブラリでダウンロードした項目に対して「使用」をクリックすると、編集可能なワークフローがインスタンス化され、デフォルトで「元の名前 (テンプレートから作成)」と命名されます。このステップで初めてワークフロー数のクォータにカウントされます。
• モジュール: ダウンロード後、あなたのワークフローから sub_workflow ステップとして名前で参照できます。モジュールライブラリで編集可能なコピーをインスタンス化してから変更することもできます。

インスタンス化されたワークフローとマーケットプレイスの項目は互いに独立しています。作者が新バージョンを公開してもあなたのインスタンスは変更されません。「自分がダウンロードしたもの」である項目をアンインストールしても、既にインスタンス化したワークフローには影響しません。

よく使うエンドポイント

関連ページ

• テンプレートからインスタンス化する
• 内蔵モジュールライブラリ
• モジュール化と再利用