Publicar en el marketplace
Sube un plugin, instálalo en un proyecto y luego publícalo, tres pasos separados tras tres métodos distintos y una puerta de revisión.
Poner el código de un plugin en disco, instalarlo en un proyecto y presentarlo a otras personas son tres acciones separadas, cada una tras su propio método. Ninguna se ejecuta automáticamente por las otras.
Subir
upload_plugin guarda el documento de catálogo del plugin: su manifiesto (calculado escaneando el paquete como describe la página del manifiesto), su plugin_type, etiqueta, descripción, etiquetas y version. Aquí es donde creas el registro de un plugin o publicas una versión nueva de uno existente. Desde el dashboard es la hoja del editor de la pestaña Plugins (Tab_plugins.vue), a la que se llega desde la sección Plugins de un proyecto.
Instalar
install_plugin pone el paquete del plugin en un proyecto: lo instala con npm en el node_modules propio de ese proyecto y lo registra en el mapa app_plugins_purchased del proyecto. Un plugin puede instalarse en un proyecto sin ser nunca público, así es como desarrollas contra tu propia subida antes de que nadie más pueda verla.
Publicar
publish_plugin es el interruptor explícito y aparte que hace visible un plugin ya subido en el catálogo del marketplace (visibility: 'public') o lo devuelve a solo propietario (visibility: 'private'). En el dashboard es el interruptor Marketplace Visibility de un plugin que posees. Subir o actualizar el código de un plugin nunca lo publica por sí mismo.
La puerta de revisión
Hacer público un plugin pasa publish_plugin por una comprobación de aprobación (marketplace_module.review_and_notify_external), salvo que la cuenta que sube sea un publicador de confianza (la antigua cuenta de sistema de Xuda, o un supervisor de plataforma configurado). El resultado deja el documento del plugin en uno de tres estados, reflejados tanto en publish_stat como en el antiguo campo stat: 3 aprobado y en vivo, 6 rechazado (con publish_reason establecido y un enlace de apelación construido a partir de approval.appeal_token), o 1 aún en revisión. Un plugin rechazado o en revisión vuelve forzosamente a visibility: 'private'.
publish_plugin se niega a hacerlo público (code: -403) a menos que la cuenta tenga una cuenta de vendedor activa de Stripe Connect, la misma puerta que usan las fichas del marketplace de proyectos. Un publicador de confianza (los plugins propios de la plataforma) también se la salta.
Consentimiento, en el lado de quien instala
Antes de que install_plugin escriba nada, llama a install_consent.build_plugin_consent() y exige en la petición un consent aceptado que coincida (con un content_hash que el servidor recalcula y comprueba). Esa pantalla se construye directamente a partir del manifiesto del plugin, consulta la página del manifiesto para ver exactamente qué añade cada archivo presente, además del id del paquete npm y la versión que se instalan, y si el plugin depende de otro.
El acuerdo de subida de plugins
dist/xuda_plugin_upload_user_agreement.html es un documento legal permanente: subir un plugin concede a Xuda una licencia mundial y libre de regalías para usarlo, reproducirlo, distribuirlo y mostrarlo, y quien sube declara que el plugin es de su autoría, está libre de malware, y garantiza que indemnizará a Xuda por ello. Está junto a otros dos acuerdos relacionados en la misma carpeta dist/, un acuerdo de subida de aplicaciones y reparto de ingresos y un modelo de acuerdo de licencia propietaria, todos servidos como archivos estáticos desde la ruta dist/ de la plataforma, igual que xuda-runtime-slim.js y otros recursos del runtime.
La superficie de la API
De los métodos de plugins, solo get_plugins y get_plugins_categories tienen clearance public, explorar el catálogo no necesita cuenta. upload_plugin, install_plugin, uninstall_plugin y get_app_plugins tienen clearance admin, limitado a un proyecto. publish_plugin y archive_plugin son acciones solo del dashboard y no forman parte de la API pública.
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.