Μετάβαση στο περιεχόμενο
Πρόχειρο

Δημοσίευση στο marketplace

[object Object]

Η μεταφορά του κώδικα ενός πρόσθετου στον δίσκο, η εγκατάστασή του σε ένα έργο και η παρουσίασή του σε άλλους είναι τρεις ξεχωριστές ενέργειες, καθεμία πίσω από τη δική της μέθοδο. Καμία δεν εκτελείται αυτόματα για τις άλλες.

Μεταφόρτωση

Το upload_plugin αποθηκεύει το έγγραφο καταλόγου του πρόσθετου: το manifest του (που υπολογίζεται σαρώνοντας το πακέτο όπως περιγράφει η σελίδα του manifest), το plugin_type, την ετικέτα, την περιγραφή, τα tags και το version. Εδώ δημιουργείτε την εγγραφή ενός πρόσθετου ή ωθείτε μια νέα έκδοση ενός υπάρχοντος. Από τον πίνακα ελέγχου αυτό γίνεται από το Sheet επεξεργασίας της καρτέλας Πρόσθετα (Tab_plugins.vue), που προσεγγίζεται από την ενότητα Πρόσθετα ενός έργου.

Εγκατάσταση

Το install_plugin βάζει το πακέτο του πρόσθετου σε ένα έργο: το εγκαθιστά με npm στο δικό του node_modules του έργου, και το καταγράφει στον χάρτη app_plugins_purchased του έργου. Ένα πρόσθετο μπορεί να εγκατασταθεί σε ένα έργο χωρίς να γίνει ποτέ δημόσιο: έτσι αναπτύσσετε πάνω στη δική σας μεταφόρτωση πριν τη δει κάποιος άλλος.

Δημοσίευση

Το publish_plugin είναι ο ρητός, ξεχωριστός διακόπτης που κάνει ένα ήδη μεταφορτωμένο πρόσθετο ορατό στον κατάλογο του marketplace (visibility: 'public') ή το τραβά πίσω σε κατάσταση μόνο για τον ιδιοκτήτη (visibility: 'private'). Στον πίνακα ελέγχου αυτός είναι ο διακόπτης Marketplace Visibility σε ένα πρόσθετο που κατέχετε. Η μεταφόρτωση ή η ενημέρωση του κώδικα ενός πρόσθετου δεν το δημοσιεύει ποτέ από μόνη της.

Η πύλη ελέγχου

Η μετάβαση σε δημόσιο περνά το publish_plugin από έναν έλεγχο έγκρισης (marketplace_module.review_and_notify_external), εκτός αν ο λογαριασμός που μεταφορτώνει είναι αξιόπιστος εκδότης (ο παλαιός λογαριασμός συστήματος του Xuda, ή ένας ρυθμισμένος επόπτης πλατφόρμας). Το αποτέλεσμα φέρνει το έγγραφο του πρόσθετου σε μία από τρεις καταστάσεις, αντικατοπτριζόμενες τόσο στο publish_stat όσο και στο παλαιό πεδίο stat: 3 εγκεκριμένο και ζωντανό, 6 απορριφθέν (με ορισμένο το publish_reason, και έναν σύνδεσμο ένστασης που χτίζεται από το approval.appeal_token), ή 1 ακόμη υπό έλεγχο. Ένα απορριφθέν ή υπό έλεγχο πρόσθετο επιστρέφεται υποχρεωτικά σε visibility: 'private'.

Απαιτείται λογαριασμός πωλητή

Το publish_plugin αρνείται να γίνει δημόσιο (code: -403) εκτός αν ο λογαριασμός έχει ενεργό λογαριασμό πωλητή Stripe Connect, την ίδια πύλη που χρησιμοποιούν οι καταχωρίσεις έργων του marketplace. Ένας αξιόπιστος εκδότης (τα δικά του πρόσθετα πρώτου μέρους της πλατφόρμας) παρακάμπτει κι αυτό.

Συναίνεση, από την πλευρά της εγκατάστασης

Πριν γράψει οτιδήποτε το install_plugin, καλεί το install_consent.build_plugin_consent() και απαιτεί μια αντίστοιχη αποδεκτή consent (με ένα content_hash που ο διακομιστής υπολογίζει ξανά και ελέγχει) στο αίτημα. Αυτή η οθόνη χτίζεται απευθείας από το manifest του πρόσθετου, δείτε τη σελίδα του manifest για το τι ακριβώς προσθέτει σε αυτήν κάθε αρχείο που υπάρχει, συν το αναγνωριστικό πακέτου npm και την έκδοση που εγκαθίσταται, και το αν το πρόσθετο εξαρτάται από άλλο.

Η συμφωνία μεταφόρτωσης πρόσθετου

Το dist/xuda_plugin_upload_user_agreement.html είναι ένα μόνιμο νομικό έγγραφο: η μεταφόρτωση ενός πρόσθετου παραχωρεί στο Xuda παγκόσμια άδεια χωρίς δικαιώματα για χρήση, αναπαραγωγή, διανομή και προβολή του, και ο μεταφορτωτής δηλώνει ότι το πρόσθετο είναι δικό του έργο, χωρίς κακόβουλο λογισμικό, και εγγυάται ότι θα αποζημιώσει το Xuda γι' αυτό. Βρίσκεται δίπλα σε δύο συναφείς συμφωνίες στον ίδιο φάκελο dist/, μια συμφωνία μεταφόρτωσης εφαρμογής και επιμερισμού εσόδων και μια δειγματική συμφωνία ιδιοταγούς άδειας, όλες σερβιρισμένες ως στατικά αρχεία από τη διαδρομή dist/ της πλατφόρμας, όπως το xuda-runtime-slim.js και άλλα στοιχεία του runtime.

Η επιφάνεια του API

Από τις μεθόδους πρόσθετων, μόνο τα get_plugins και get_plugins_categories έχουν clearance public: η περιήγηση στον κατάλογο δεν χρειάζεται λογαριασμό. Τα upload_plugin, install_plugin, uninstall_plugin και get_app_plugins έχουν clearance admin, με πεδίο ένα έργο. Τα publish_plugin και archive_plugin είναι ενέργειες μόνο του πίνακα ελέγχου και δεν αποτελούν μέρος του δημόσιου API.

POST/cpi/get_install_consent
user

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.