Hopp til innholdet
Bekreftet

Versjonering

En plugins versjon er en ren strengsammenligning mellom katalogdokumentet og det et prosjekt har installert. Det finnes ingen semver-områdematching.

En plugins versjon finnes to steder: doc.version på katalogdokumentet (den siste opplastede versjonen) og app_plugins_purchased[plugin_name].version på hvert prosjekt som installerte den (versjonen prosjektet faktisk har). Ingenting holder disse synkronisert automatisk.

Hvor versjonen kommer fra

upload_plugin setter doc.version ulikt avhengig av hvor pakken ligger:

  • npm-pakkekilde: leses rett fra registeret med getPackageManifest(plugin_name), så den er det npm version ga da forfatteren sist kjørte npm publish. Hver førstepartsplugins package.json har et pub-skript for dette: npm version patch --force && npm publish --access public.
  • xuda_hosted-pakkekilde (ingen npm-publisering involvert, arbeidskopien pakkes og hostes av selve plattformen): doc.version er det som ble sendt i forespørselen, eller 0.1.0 hvis ingenting ble sendt.

install_plugin kopierer doc.version til prosjektets app_plugins_purchased-oppføring i det øyeblikket installasjonen skjer. En senere upload_plugin som øker katalogdokumentets versjon rører ikke prosjekter som allerede har installert en tidligere versjon. De beholder versjonen de installerte helt til noe installerer den nye over den.

Hvordan en utdatert installasjon vises

Det finnes ingen automatisk oppdatering. Det som finnes er en visuell sammenligning: versjonsmerket på plugin-kortet sammenligner app_plugins_purchased[plugin_name].version (det som er installert) med katalogdokumentets version (den siste), og viser det installerte nummeret i grønt når de stemmer og i gult når de ikke gjør det. Ingenting tvinger fram ominstallering. Det er en eier (eller en installatør) som kjører install_plugin på nytt på det samme prosjektet som henter inn den nyere versjonen, med det samme kallet som ved første installasjon.

Oppdatere en plugin du eier

Dashbordets Oppdater med AI-knapp, som vises på en plugins kort for eieren, øker ikke versjonen selv. Den åpner Spør AI-assistenten ferdig fylt ut med metadata: { plugin_action: 'modify', plugin_name, widget_type: plugin.plugin_type } og en prompt som nevner pluginen (updateWithAi() i Tab_plugins.vue). Det styrer AI-pluginbyggeren (ai_module.create_plugin_via_ai, den samme generatoren som utils/create_plugin_via_ai.mjs kaller direkte) til å redigere pluginens kode og laste den opp på nytt, og det er den opplastingen som øker doc.version.

En kode-/npm-oppdatering går aldri inn i gjennomgang på nytt

upload_plugin behandler enhver oppdatering der visibility allerede er 'private', eller der skip_publish_review er satt, som en privat kodeendring: den fører pluginens eksisterende visibility og publish_stat videre uberørt i stedet for å sende den inn til markedsplassens gjennomgang på nytt. Å gå fra privat til offentlig er alltid publish_plugin, en separat, eksplisitt handling. Se publisering.