Zum Inhalt springen
Geprüft

Versionierung

Die Version eines Plugins ist ein einfacher String-Vergleich zwischen dem Katalogdokument und dem, was ein Projekt installiert hat, es gibt kein Semver-Range-Matching.

Die Version eines Plugins steht an zwei Orten: doc.version im Katalogdokument (die zuletzt hochgeladene Version) und app_plugins_purchased[plugin_name].version in jedem Projekt, das es installiert hat (die Version, die dieses Projekt tatsächlich hat). Nichts hält diese beiden automatisch synchron.

Woher die Version kommt

upload_plugin setzt doc.version je nachdem, wo das Paket liegt, unterschiedlich:

  • npm-Paketquelle: wird direkt aus der Registry mit getPackageManifest(plugin_name) gelesen, ist also das, was npm version ergeben hat, als der Autor zuletzt npm publish ausgeführt hat. Die package.json jedes First-Party-Plugins hat dafür ein pub-Skript: npm version patch --force && npm publish --access public.
  • xuda_hosted-Paketquelle (kein npm-Publish beteiligt, die Arbeitskopie wird von der Plattform selbst gepackt und gehostet): doc.version ist das, was in der Anfrage gesendet wurde, oder 0.1.0, wenn nichts gesendet wurde.

install_plugin kopiert doc.version im Moment der Installation in den app_plugins_purchased-Eintrag des Projekts. Ein späteres upload_plugin, das die Version des Katalogdokuments erhöht, fasst Projekte, die bereits eine frühere installiert haben, nicht an. Sie behalten die Version, die sie installiert haben, bis etwas die neue darüber installiert.

Wie eine veraltete Installation angezeigt wird

Es gibt kein automatisches Update. Es gibt einen visuellen Vergleich: Das Versions-Badge der Plugin-Karte vergleicht app_plugins_purchased[plugin_name].version (was installiert ist) mit der version des Katalogdokuments (der neuesten) und stellt die installierte Nummer grün dar, wenn sie übereinstimmen, und bernsteinfarben, wenn nicht. Nichts erzwingt die Neuinstallation: Ein Eigentümer (oder Installierender), der install_plugin erneut auf demselben Projekt ausführt, holt die neuere Version herein, derselbe Aufruf, der bei einer Erstinstallation verwendet wird.

Ein eigenes Plugin aktualisieren

Die Dashboard-Schaltfläche Mit KI aktualisieren, die ihrem Eigentümer auf der Karte eines Plugins angezeigt wird, erhöht die Version nicht selbst. Sie öffnet den KI-Assistenten (KI fragen), vorbelegt mit metadata: { plugin_action: 'modify', plugin_name, widget_type: plugin.plugin_type } und einem Prompt, der das Plugin nennt (updateWithAi() in Tab_plugins.vue). Das steuert den KI-Plugin-Builder (ai_module.create_plugin_via_ai, derselbe Generator, den utils/create_plugin_via_ai.mjs direkt aufruft), der den Code des Plugins bearbeitet und neu hochlädt, und dieser Upload erhöht doc.version.

Ein Code-/npm-Update durchläuft die Prüfung nie erneut

upload_plugin behandelt jedes Update, bei dem visibility bereits 'private' ist oder skip_publish_review gesetzt ist, als private Codeänderung: Es übernimmt die bestehenden visibility und publish_stat des Plugins unverändert, statt es erneut zur Marketplace-Prüfung einzureichen. Der Wechsel von privat zu öffentlich ist immer nur publish_plugin, eine separate, ausdrückliche Aktion, siehe Veröffentlichen.