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 cugetPackageManifest(plugin_name), deci este ce a produsnpm versioncând autorul a rulat ultima datănpm publish. Fiecare plugin propriu are înpackage.jsonun scriptpubpentru 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.versioneste ce s-a trimis în cerere sau0.1.0dacă 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.
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.