Sari la conținut
Verificat

Versionare

Versiunea unui plugin este o comparație simplă de șiruri între documentul din catalog și ce are instalat un proiect, nu există potrivire de intervale semver.

Versiunea unui plugin se află în două locuri: doc.version din documentul de catalog (ultima versiune încărcată) și app_plugins_purchased[plugin_name].version din fiecare proiect care l-a instalat (versiunea pe care o are efectiv proiectul respectiv). Nimic nu le sincronizează automat.

De unde vine versiunea

upload_plugin setează doc.version diferit, în funcție de locul unde se află pachetul:

  • Sursa de pachet npm: citită direct din registru cu getPackageManifest(plugin_name), deci este ce a produs npm version când autorul a rulat ultima dată npm publish. Fiecare plugin propriu are în package.json un script pub pentru asta: npm version patch --force && npm publish --access public.
  • Sursa de pachet xuda_hosted (fără npm publish, copia de lucru este împachetată și găzduită chiar de platformă): doc.version este ce s-a trimis în cerere sau 0.1.0 dacă nu s-a trimis nimic.

install_plugin copiază doc.version în intrarea app_plugins_purchased a proiectului în momentul instalării. Un upload_plugin ulterior care mărește versiunea din documentul de catalog nu modifică proiectele care au instalat deja una mai veche, ele păstrează versiunea instalată până când ceva instalează peste ea versiunea nouă.

Cum se vede o instalare învechită

Nu există actualizare automată. Există o comparație vizuală: insigna de versiune de pe cardul pluginului compară app_plugins_purchased[plugin_name].version (ce este instalat) cu version din documentul de catalog (cea mai recentă), afișând numărul instalat în verde când coincid și în chihlimbar când nu. Nimic nu forțează reinstalarea, un proprietar (sau cel care instalează) care rulează din nou install_plugin pe același proiect aduce versiunea mai nouă, cu același apel folosit la prima instalare.

Actualizarea unui plugin al tău

Butonul Actualizați cu AI din tabloul de bord, afișat proprietarului pe cardul unui plugin, nu crește versiunea de la sine. Deschide asistentul Ask AI cu metadata: { plugin_action: 'modify', plugin_name, widget_type: plugin.plugin_type } completat în prealabil și cu un prompt care numește pluginul (updateWithAi() în Tab_plugins.vue), ceea ce pornește constructorul AI de pluginuri (ai_module.create_plugin_via_ai, același generator pe care îl apelează direct utils/create_plugin_via_ai.mjs) să editeze codul pluginului și să îl încarce din nou, iar această încărcare este cea care avansează doc.version.

O actualizare de cod/npm nu reintră niciodată în verificare

upload_plugin tratează orice actualizare în care visibility este deja 'private' sau skip_publish_review este setat ca o modificare privată de cod: păstrează neatinse visibility și publish_stat existente ale pluginului, în loc să îl retrimită la verificarea pentru marketplace. Trecerea de la privat la public se face doar prin publish_plugin, o acțiune separată și explicită; vezi publicarea.