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 mitgetPackageManifest(plugin_name)gelesen, ist also das, wasnpm versionergeben hat, als der Autor zuletztnpm publishausgeführt hat. Diepackage.jsonjedes First-Party-Plugins hat dafür einpub-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.versionist das, was in der Anfrage gesendet wurde, oder0.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.
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.