Marketplace'te yayınlama
[object Object]
Bir eklentinin kodunu diske almak, bir projeye kurmak ve başkalarının görebileceği hale getirmek üç ayrı işlemdir. Her birinin kendi yöntemi vardır. Hiçbiri diğerlerini otomatik olarak çalıştırmaz.
Yükleme
upload_plugin, eklentinin katalog belgesini kaydeder: manifestini (paketi manifest sayfasının anlattığı şekilde tarayarak hesaplanır), plugin_type, etiket,
açıklama, etiketler ve version alanlarını. Bir eklentinin kaydını burada oluşturur veya mevcut bir eklentinin yeni sürümünü burada gönderirsiniz. Panelde bu işlem, Eklentiler sekmesinin düzenleyici panelidir
(Tab_plugins.vue) ve bir projenin Eklentiler bölümünden açılır.
Kurulum
install_plugin, eklentinin paketini tek bir projeye koyar: paketi o projenin kendi
node_modules klasörüne npm ile kurar ve projenin app_plugins_purchased haritasına kaydeder. Bir eklenti, hiç herkese açık olmadan da bir projeye
kurulabilir. Kendi yüklemenizle, başkaları görmeden önce geliştirme yapmanın yolu budur.
Yayınlama
publish_plugin, zaten yüklenmiş bir eklentiyi marketplace kataloğunda görünür yapan (visibility: 'public') veya yalnızca sahibine geri çeken
(visibility: 'private') açık ve ayrı anahtardır. Panelde bu, sahibi olduğunuz bir eklentideki Marketplace Visibility anahtarıdır. Bir eklentinin kodunu yüklemek veya güncellemek onu hiçbir zaman
kendiliğinden yayınlamaz.
İnceleme kapısı
Herkese açık hale getirme, yükleyen hesap güvenilir bir yayıncı (eski Xuda sistem hesabı veya yapılandırılmış bir platform süpervizörü) değilse,
publish_plugin işlemini bir onay denetiminden (marketplace_module.review_and_notify_external) geçirir. Sonuç, eklenti belgesini üç durumdan birine yerleştirir
ve bu durum hem publish_stat hem de eski stat alanına yansıtılır: 3 onaylandı ve yayında, 6 reddedildi (publish_reason ayarlanır ve approval.appeal_token ile oluşturulmuş bir itiraz bağlantısı eklenir) veya 1 hâlâ incelemede. Reddedilen veya incelemedeki bir eklenti zorla
visibility: 'private' durumuna geri alınır.
Hesabın etkin bir Stripe Connect satıcı hesabı yoksa publish_plugin herkese açık yapmayı reddeder (code: -403). Proje marketplace ilanları da aynı kapıyı kullanır. Güvenilir bir yayıncı
(platformun kendi birinci taraf eklentileri) bunu da atlar.
Kurulum tarafında onay
install_plugin, herhangi bir şey yazmadan önce install_consent.build_plugin_consent() işlevini çağırır ve istekte, eşleşen ve kabul edilmiş bir consent (sunucunun yeniden hesapladığı ve denetlediği bir content_hash ile) bulunmasını
gerektirir. Bu ekran doğrudan eklentinin manifestinden oluşturulur. Mevcut her dosyanın ekrana tam olarak ne eklediği için manifest sayfasına bakın. Ayrıca kurulan
npm paket kimliği ve sürümü ile eklentinin başka bir eklentiye bağlı olup olmadığı da gösterilir.
Eklenti yükleme sözleşmesi
dist/xuda_plugin_upload_user_agreement.html kalıcı bir hukuki belgedir: bir eklenti yüklemek, Xuda'ya onu kullanma, çoğaltma, dağıtma ve görüntüleme için dünya çapında, telifsiz bir lisans verir.
Yükleyen, eklentinin kendi eseri ve kötü amaçlı yazılımdan arınmış olduğunu beyan eder ve bu konuda Xuda'yı tazmin edeceğini taahhüt eder. Aynı dist/ klasöründe iki ilgili sözleşme daha bulunur: bir uygulama
yükleme ve gelir paylaşımı sözleşmesi ile örnek bir mülkiyet lisansı sözleşmesi. Hepsi, xuda-runtime-slim.js ve diğer çalışma zamanı
varlıkları gibi, platformun dist/ yolundan statik dosya olarak sunulur.
API yüzeyi
Eklenti yöntemlerinden yalnızca get_plugins ve get_plugins_categories public yetki düzeyindedir:
kataloğa göz atmak için hesap gerekmez. upload_plugin, install_plugin, uninstall_plugin ve
get_app_plugins admin yetki düzeyindedir ve bir projeyle sınırlıdır. publish_plugin ve archive_plugin
yalnızca panelden yapılan eylemlerdir ve herkese açık API'nin parçası değildir.
Get Install Consent
Returns the install consent screen for one marketplace AI agent or plugin: what it does, who wrote it, the liability text, and the content hash the install has to echo back.