Verziószámozás
A bővítmény verziója egyszerű szövegösszehasonlítás a katalógusdokumentum és a projektben telepített változat között, szemver-tartományokat nem használ a rendszer.
A bővítmény verziója két helyen él: a katalógusdokumentum doc.version mezőjében (a legutóbb feltöltött verzió), valamint minden, a bővítményt telepítő projekt app_plugins_purchased[plugin_name].version mezőjében (az a verzió, amely a projektben ténylegesen megvan). Semmi nem tartja ezeket automatikusan szinkronban.
Honnan származik a verzió
Az upload_plugin a doc.version értékét attól függően állítja be, hogy hol található a csomag:
npmcsomagforrás: közvetlenül a registryből olvassa ki agetPackageManifest(plugin_name)hívással, vagyis az lesz, amit aznpm versionelőállított, amikor a szerző utoljára futtatta aznpm publishparancsot. Minden első féltől származó bővítménypackage.jsonfájljában van egypubszkript erre:npm version patch --force && npm publish --access public.xuda_hostedcsomagforrás (nincs npm-publikálás, a munkapéldányt becsomagolja és tárolja maga a platform): adoc.versionaz, amit a kérésben elküldtek, vagy0.1.0, ha semmit nem küldtek.
Az install_plugin a telepítés pillanatában átmásolja a doc.version értékét a projekt app_plugins_purchased bejegyzésébe. Egy későbbi upload_plugin, amely megemeli a katalógusdokumentum verzióját, nem érinti azokat a projekteket, amelyek már egy korábbit telepítettek: azok megtartják a telepített verziót, amíg valami az újat rá nem telepíti.
Hogyan jelenik meg az elavult telepítés
Nincs automatikus frissítés. Ami van, az egy vizuális összehasonlítás: a bővítménykártya verziójelvénye összeveti az app_plugins_purchased[plugin_name].version értékét (a telepítettet) a katalógusdokumentum version mezőjével (a legfrissebbel), és a telepített számot zölden jeleníti meg, ha egyeznek, borostyánsárgán, ha nem. Semmi nem kényszeríti az újratelepítést: az újabb verziót az hozza be, ha a tulajdonos (vagy egy telepítő) ugyanabban a projektben ismét lefuttatja az install_plugin hívást, ugyanazt, amelyet az első telepítéskor is használtak.
Saját bővítmény frissítése
A dashboard Frissítés AI-val gombja, amelyet a bővítmény kártyáján a tulajdonosa lát, maga nem emeli meg a verziót. Megnyitja a Kérdezze meg az AI-t asszisztenst előre kitöltve a metadata: { plugin_action: 'modify', plugin_name, widget_type: plugin.plugin_type } értékkel és a bővítményt megnevező üzenettel (updateWithAi() a Tab_plugins.vue fájlban). Ez az AI bővítményépítőt hajtja (ai_module.create_plugin_via_ai, ugyanaz a generátor, amelyet a utils/create_plugin_via_ai.mjs közvetlenül hív), hogy módosítsa a bővítmény kódját és újra feltöltse; a doc.version értékét ez a feltöltés lépteti.
Az upload_plugin minden olyan frissítést privát kódmódosításnak tekint, ahol a visibility már 'private', vagy a skip_publish_review be van állítva: a bővítmény meglévő visibility és publish_stat értékét érintetlenül viszi tovább, ahelyett, hogy újra beküldené piactéri felülvizsgálatra. A privátból nyilvánosba váltás kizárólag a publish_plugin, egy különálló, kifejezett művelet; lásd a közzétételt.