Marketplace

Der Marktplatz ist die Seite „Marktplatz“ in der Konsole: Von der Community und offiziell veröffentlichte Vorlagen und Module finden sich alle hier. Sie können von anderen veröffentlichte Einträge in Ihre eigene Vorlagen- oder Modulbibliothek herunterladen und ebenso Ihre fertigen Workflows dort veröffentlichen und versioniert weiterentwickeln. Eine heruntergeladene Vorlage wird zu Ihrem eigenen Workflow instanziiert; ein heruntergeladenes Modul kann direkt von einem sub_workflow-Schritt referenziert werden.

Durchsuchen und Kategorien

Die Liste lässt sich nach Typ (Vorlage / Modul), Kategorie und Tag filtern sowie nach Name, Beschreibung und Tag durchsuchen. Oben gibt es drei Ansichten: Alle, Von mir hochgeladen, Von mir heruntergeladen. Jede Karte zeigt Autor, neueste Versionsnummer und Downloadzahl; plattformeigene Einträge tragen die Kennzeichnung „Offiziell“.

• Die Optionen des Kategorie-Dropdowns stammen aus den tatsächlichen Kategorien der aktuell gelisteten Einträge, nicht aus einer festen Liste; Kategorien und Tags werden in Ihrer Oberflächensprache angezeigt.
• Der Marktplatz zeigt nur gelistete und für Sie sichtbare Einträge an. Der Veröffentlichende kann einen Eintrag öffentlich, nur für Teammitglieder sichtbar oder nur für bestimmte Nutzer sichtbar setzen; nicht sichtbare Einträge erscheinen nicht in Ihrer Liste.
• Bereits heruntergeladene Einträge sind auf der Karte direkt mit „Heruntergeladen“ gekennzeichnet; liegt eine neue Version vor, wird die Schaltfläche zu „Aktualisieren“.

Ihre Vorlage oder Ihr Modul veröffentlichen

Der Einstieg zur Veröffentlichung liegt im Workflow-Editor. Nur der Eigentümer eines Workflows kann ihn im Marktplatz veröffentlichen — auch ein Administrator kann die erste Version nicht an Ihrer Stelle veröffentlichen.

• Typ: Ein Workflow mit Modulvertrag kann als „Modul“ veröffentlicht werden, andernfalls nur als „Vorlage“. Um ihn als Modul zu veröffentlichen, „stufen Sie ihn zuerst im Editor zum Modul hoch“ und speichern den Vertrag.
• Auszufüllen sind Titel (Pflicht, max. 200 Zeichen), Beschreibung (max. 5000 Zeichen), Kategorie, Tags (max. 20), Symbol, Versionsnummer und Änderungshinweise.
• Die Versionsnummer muss dem semver-Format entsprechen, z. B. 1.0.0 oder 1.0.0-beta.
• Drei Sichtbarkeitsstufen: für alle Nutzer sichtbar, nur für Mitglieder der von mir beigetretenen Teams sichtbar (Team-ID angeben), nur für bestimmte Nutzer sichtbar (Nutzer-ID angeben). Bei Team-Sichtbarkeit müssen Sie Mitglied jedes aufgeführten Teams sein.
• Preis: Derzeit wird nur die kostenlose Veröffentlichung unterstützt (0 USD); die Bezahlfunktion ist noch nicht freigeschaltet.
• Die serialisierte Workflow-Definition ist auf 2 MB begrenzt; darüber hinaus wird sie abgelehnt.

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
  }'

Versionsverwaltung

Derselbe Workflow kann nicht erneut als neuer Eintrag veröffentlicht werden — der Editor erkennt automatisch, dass „dieser Workflow bereits veröffentlicht wurde“, und schaltet den Dialog auf „Neue Version hochladen“ um.

• Nur der ursprüngliche Autor eines Eintrags kann neue Versionen veröffentlichen; ein Plattform-Administrator kann stellvertretend veröffentlichen, doch die Autorenzuordnung des Eintrags bleibt unverändert. Bei systemeigenen Einträgen können nur Administratoren neue Versionen veröffentlichen.
• Die neue Versionsnummer muss ein gültiges semver sein und darf nicht niedriger als die aktuell neueste Version sein. Dieselbe Versionsnummer kann nicht erneut hochgeladen werden.
• Auch die neue Version geht in die ausstehende Genehmigung über; während der Genehmigung bleibt der Eintrag selbst gelistet, und andere Nutzer laden weiterhin die neueste gelistete Version herunter.
• Nutzer, die diesen Eintrag bereits heruntergeladen haben, sehen auf der Marktplatzkarte und unter „Von mir heruntergeladen“ einen Aktualisierungshinweis; ein erneuter Download aktualisiert auf die neueste Version.
• Die Detailseite des Eintrags listet den vollständigen Versionsverlauf und die Änderungshinweise jeder Version auf.

Installation: automatische Abhängigkeitsauflösung

Ein Klick auf „Herunterladen“ speichert den Eintrag in Ihrer Vorlagen- oder Modulbibliothek. Referenziert diese Vorlage oder dieses Modul weitere Module (sub_workflow-Schritte), löst die Plattform vor dem Download zunächst den vollständigen Abhängigkeitsgraphen auf und kennzeichnet den Status jeder Abhängigkeit einzeln:

Nach Bestätigung von „zusammen mit Abhängigkeiten herunterladen“ erfolgt die Installation in Abhängigkeitsreihenfolge: zuerst das unterste referenzierte Modul, dann Ebene für Ebene aufwärts und zuletzt der von Ihnen angeklickte Eintrag selbst. Während des Downloads wird die von einem sub_workflow referenzierte workflow_id in der Kopie automatisch auf die ID der entsprechenden Kopie in Ihrer Bibliothek umgeschrieben — nach der Installation müssen Sie keine Referenz von Hand ändern; die Vorlage lässt sich direkt instanziieren und ausführen, das Modul direkt referenzieren.

# 下载最新版，连同依赖一起（返回本次创建的全部下载记录）
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>"

• Die Abhängigkeitsauflösung erfolgt nur beim Download der neuesten Version; beim Download einer angegebenen historischen Version wird nur der Eintrag selbst heruntergeladen.
• Zirkuläre Referenzen (A referenziert B, B wiederum A) werden erkannt und korrekt behandelt und blockieren die Installation nicht.
• Der Download selbst verbraucht kein Workflow-Kontingent; erst die spätere Instanziierung tut dies.

Nach dem Download: Instanziierung

Der Download legt den Eintrag lediglich in Ihre Bibliothek; die Kopie ist standardmäßig als schreibgeschützt gesperrt. Für den tatsächlichen Einsatz gibt es zwei Wege:

• Vorlage: Klicken Sie in der Vorlagenbibliothek beim heruntergeladenen Eintrag auf „Verwenden“, um einen bearbeitbaren Workflow zu instanziieren, standardmäßig benannt als „Originalname (aus Vorlage erstellt)“. Erst dieser Schritt zählt auf das Workflow-Anzahlkontingent an.
• Modul: Nach dem Download kann es von Ihren Workflows über einen sub_workflow-Schritt namentlich referenziert werden; alternativ können Sie in der Modulbibliothek eine bearbeitbare Kopie instanziieren und diese anpassen.

Der instanziierte Workflow und der Marktplatzeintrag sind voneinander unabhängig: Veröffentlicht der Autor eine neue Version, ändert das Ihre Instanz nicht; deinstallieren Sie einen Eintrag unter „Von mir heruntergeladen“, betrifft das die bereits von Ihnen instanziierten Workflows nicht.

Gängige Endpunkte

Verwandte Seiten

• Instanziieren Sie aus der Vorlage
• Integrierte Modulbibliothek
• Modularisierung und Wiederverwendung