Ein Plugin über das persönliche Benutzerkonto einreichen

Der Gemeinschaftsmarktplatz lässt jeden registrierten Kunden ein Plugin veröffentlichen, das jeder installieren kann – auf die gleiche Weise, wie man eine App in einem App-Store veröffentlicht. Sie füllen die Metadaten der Store-Seite aus, geben an, welche Berechtigungen Ihr Plugin benötigt, laden das Build hoch und senden es zur Überprüfung ein. Diese Seite führt Schritt für Schritt durch den gesamten Prozess.

[!NOTE] Dieser Ablauf ist für Community (Drittanbieter) Plugins, die über Ihre eingereicht wurden persönliches Schrank bei my.aihummer.ru. Erste Partei AiHummer-Plugins werden auf ihrer eigenen Pipeline geliefert. Community-Plugins sind kostenlos; du kann einen optionalen Spendenlink hinzufügen.

Bevor du anfängst

A registriertes persönliches Schrankkonto — anmelden und bestätigen (siehe Registrierung). Jeder Kunde kann einreichen.
A eingebautes Plugin — ein signiertes Release-Tarball, erstellt mit dem Plugin-SDK (aihummer plugin package). Wenn Sie haben Noch keine gebaut, fangen Sie zuerst dort an.
An Symbol und mindestens ein Screenshot, und Ihre Beschreibungen bereit in beide Russisch und Englisch.

Wie Veröffentlichung funktioniert (das große Ganze)

Ihre Einreichung durchläuft eine feste Pipeline. Sie können ihren Status in jedem Schritt im Schrank beobachten.

Bühne	Was passiert	Wer handelt
Entwurf	Du erstellst den Eintrag und füllst die Metadaten aus; noch ist nichts öffentlich.	Du
Eingereicht	Du schickst es zur Überprüfung.	Du
KI-Bewertung	Ein automatisierter Agent überprüft das Plugin gegen die Überprüfungspolitik — Sicherheit, Richtigkeit des Manifests, Vollständigkeit, Inhalt.	Automatisierung
Moderation	Ein menschlicher Moderator liest den KI-Bericht sowie Ihr Artefakt und die Metadaten und entscheidet.	AiHummer-Team
Veröffentlicht	Nach der Genehmigung wird das Artefakt signiert und dem Gemeinschaftskatalog sowie dem öffentlichen Marktplatz-Feed hinzugefügt.	AiHummer-Team
Abgelehnt	Wenn etwas fehlschlägt, erhalten Sie die Gründe; beheben Sie sie und reichen Sie es erneut ein.	Du → zurück zum Entwurf

[!IMPORTANT] Die KI niemals veröffentlicht eigenständig. Ein Mensch trifft immer die endgültige Entscheidung, und nichts erreicht den Katalog ohne ihre Genehmigung.

Schritt 1 — Öffnen Sie «Meine Plugins»

Anmelden bei my.aihummer.ru, öffne das «Meine Plugins» Abschnitt und klicken «Veröffentlichen» (oder «Neues Plugin»). Dies erzeugt eine Entwurf Sie können frei bearbeiten, bis Sie es einreichen.

Schritt 2 — Füllen Sie die Store-Metadaten aus

Füllen Sie jedes Feld aus. Unvollständige Metadaten sind einer der häufigsten Gründe, warum eine Einsendung zurückgewiesen wird.

Feld	Erforderliche Eingabe
Name (RU + EN)	Der Anzeigename des Plugins in beiden Sprachen.
Kurze Beschreibung (RU + EN)	Eine Zeile für die Katalogkarte.
Vollständige Beschreibung (RU + EN)	Was das Plugin tut, wie man es benutzt, was es benötigt. Sinnvoll — kein Platzhalter.
Kategorie	Wähle eines aus der erlaubten Menge (z. B. Kanäle, Produktivität, Integrationen, Sprache, Dienstprogramme).
Version	A semver Zeichenkette, z. B. `1.0.0`. Jede neue Einreichung muss sie erhöhen.
Symbol	Ein gültiges quadratisches Bild.
Bildschirmfotos	Mindestens eins; das Plugin in Aktion zeigen.
Lizenz	Die Lizenz des Plugins (z. B. MIT, Apache-2.0).
Startseite / Repository	Optional `https://` Link zu Ihrem Projekt.
Spendenlink	Optional. Gültig `https://` Link zu einem bekannter Spendenanbieter — zum Beispiel Boosty, Patreon, PayPal oder YooMoney. Phishing oder willkürliche Hosts werden abgelehnt.
Änderungsprotokoll (RU + EN)	Was sich in dieser Version geändert hat.

[!TIP] Schreiben Sie die Beschreibungen für einen echten Benutzer, der Ihr Plugin noch nie gesehen hat. “Dummies” ist genau richtig: sage, was es tut, wann man es verwendet und was es braucht.

Schritt 3 — Das Fähigkeitsmanifest deklarieren

Der Fähigkeitsmanifest ist das Herz des Sicherheitsmodells. Es ist eine kurze, strukturierte Erklärung von jede Berechtigung, die dein Plugin benötigt — mit welchen Hosts es kommuniziert, welche Dateien es berührt, ob es externe Befehle ausführt, welche Kanäle und Anmeldedaten es verwendet.

Warum es deklarieren

Kunden sehen die angeforderten Berechtigungen bevor sie installieren und zustimmen zu ihnen, genau wie die Berechtigungsabfrage einer mobilen App.
Die Instanz verwendet das Manifest, um einschränken das Plugin zu dem, was es deklariert hat.
Gutachter überprüfen, dass Ihr erklärt Fähigkeiten Spiel was der Code tatsächlich tut. Ein Plugin, das auf eine Berechtigung zugreift, die es nicht angegeben hat, ist abgelehnt.

Prinzip der minimalen Berechtigung

Erklären nur was Ihr Plugin wirklich verwendet und nichts darüber hinaus. Weniger Berechtigungen bedeuten schnellere Überprüfung, einfachere Zustimmung der Kunden und mehr Installationen. Wenn Sie das Dateisystem nicht berühren, geben Sie eine leere Liste an. Wenn Sie niemals einen Prozess starten, setzen Sie exec zu false.

Das Format

Das Capability-Manifest ist ein JSON-Objekt mit diesen Feldern:

Feld	Typ	Bedeutung
`network`	string[]	Hostnamen, zu denen das Plugin eine Verbindung herstellt (seine Egress-Whitelist).
`filesystem`	string[]	Pfade, die es liest oder schreibt, relativ zu seinem eigenen Plugin-Verzeichnis.
`exec`	boolesch	Ob es externe Prozesse startet / Befehle ausführt.
`channels`	string[]	Messaging-Kanäle, mit denen es sich integriert (z. B. `telegram`).
`credentials`	string[]	Benannte Geheimnisse/Konfigurationsschlüssel, die es verwendet (niemals die geheimen Werte).
`description`	Zeichenkette	Eine kurze, für Menschen lesbare Zusammenfassung dessen, was es benötigt und warum.

Beispiel:

{
  "network": ["api.example.com", "cdn.example.com"],
  "filesystem": ["./cache"],
  "exec": false,
  "channels": ["telegram"],
  "credentials": ["api_token"],
  "description": "Calls the Example API to sync tasks and posts replies to Telegram. Caches responses under its own ./cache directory. No process spawning, no other hosts."
}

[!WARNING] Tun nicht Setze keine echten Geheimnisse, Tokens oder Schlüssel irgendwohin – weder ins Manifest, noch In den Metadaten, nicht im Artefakt. Anmeldeinformationen angeben nur dem Namen nach (z. B. api_token); der Kunde liefert den tatsächlichen Wert zur Installationszeit. Fest codiert Geheimnisse sind eine automatische Ablehnung.

Schritt 4 — Lade das Artefakt hoch

Lade deinen Plugin-Build hoch:

Format: ein .tar.gz Veröffentlichungstarball erstellt von aihummer plugin package.
Es muss das Plugin enthalten manifest.json (das SDK-Manifest — Art, Version, Einstiegspunkt, deklariert capabilities, Konfigurationsfelder).
Das Fähigkeitsmanifest, das Sie in Schritt 3 ausgefüllt haben, muss konsequent mit was der Code und manifest.json tatsächlich tun.

Du fügst auch die Symbol und Bildschirmfotos Hier, falls du es noch nicht getan hast.

[!TIP] Laufen aihummer plugin validate lokal vor dem Hochladen. Der Validierungsvertrag ist derselbe, den der Marktplatz verwendet, sodass ein Manifest, das lokal besteht, hier auch akzeptiert.

Schritt 5 — Zur Überprüfung senden

Wenn jedes Feld ausgefüllt ist und das Artefakt hochgeladen wurde, klicken Sie «Zur Überprüfung einreichen». Das Kabinett führt zuerst eine Vollständigkeitsprüfung durch; wenn etwas fehlt, teilt es Ihnen genau mit, was. Sobald es akzeptiert wird, wechselt der Status zu Eingereicht und dann KI-Bewertung — Sie müssen nichts weiter tun.

Schritt 6 — Den Status verfolgen und ein Urteil lesen

Öffnen Sie das Plugin in «Meine Plugins» um seinen Status zu verfolgen. Wenn die Überprüfung beendet ist, werden Sie eines der Folgenden sehen:

In Maßen — die automatisierte Überprüfung hat bestanden oder nur kleine Dinge markiert; a Der Mensch schaut es jetzt an. Warte einfach.
Abgelehnt — etwas ist fehlgeschlagen. Sie werden eine sehen Urteil, eine Zusammenfassung und das spezifische Artikel, die nicht bestanden haben (mit dem Grund für jeden). Das ist dein Fehlerliste.
Veröffentlicht — genehmigt, unterschrieben und aktiv. Ihr Plugin erscheint nun auf der AiHummer-Marktplatz und installiert sich in jede Instanz, die hat den Community-Katalog aktiviert.

Wie man eine Ablehnung liest und erneut einreicht

Öffne das Plugin; lies das fehlgeschlagene Gegenstände und ihre Gründe.
Behebe sie — die meisten sind eines von: eine fehlende/schwache Beschreibung, eine nicht übereinstimmende Fähigkeit Manifest, ein fest codiertes Geheimnis, ein schlechter Spendelink oder eine Version, die Sie nicht hatten erhöhen.
Bearbeiten Sie die Metadaten und/oder laden Sie eine hoch neues Artefakt mit einer erhöhten Version.
Klicken «Zur Überprüfung einreichen» noch einmal. Es geht durch die gleiche Pipeline zurück.

[!NOTE] Eine Ablehnung ist keine Strafe — sie ist eine Checkliste. Die Überprüfungspolitik ist öffentlich genau damit du kann jede Anforderung erfüllen vor du reichst ein.

Wo als Nächstes

Richtlinie und Checkliste überprüfen — das genaue Kriterien, anhand derer Ihr Plugin geprüft wird.
Plugin-SDK — das Plugin und seine bauen manifest.json.
Ein Plugin veröffentlichen — private Side-Load und die anderen Veröffentlichungsmodi.
Installation & Updates — wie Kunden installieren und wie das Vertrauensmodell funktioniert.