Enviar un complemento a través del gabinete personal

la mercado comunitario permite a cualquier cliente registrado publicar un plugin para que todos lo instalen, de la misma manera que publicas una aplicación en una tienda de aplicaciones. Rellenas los metadatos de la página de la tienda, declaras qué permisos necesita tu plugin, subes la versión y la envías para revisión. Esta página guía todo el proceso paso a paso.

[!NOTE] Este flujo es para comunidad (de terceros) complementos enviados a través de su gabinete personal en my.aihummer.ru. De primera mano Los plugins de AiHummer se envían en su propia canalización. Los plugins de la comunidad son gratis; tú puede añadir un enlace de donación opcional.

Antes de empezar

A cuenta personal de gabinete registrada — regístrate y confírmalo (ver Registro). Cualquier cliente puede enviar.
A plugin construido — un paquete de lanzamiento firmado producido con el SDK de complementos (aihummer plugin package). Si tienes aún no construida, empieza por allí primero.
Un icono y al menos una captura de pantalla, y tus descripciones listas en ambas Ruso e inglés.

Cómo funciona la publicación (la imagen general)

Su envío se mueve a través de un flujo de trabajo fijo. Puede ver su estado en el gabinete en cada paso.

Escenario	Qué pasa	Quién actúa
Borrador	Tú creas la entrada y llenas los metadatos; nada es público aún.	Tú
Enviado	Lo envías para revisión.	Tú
Revisión de IA	Un agente automatizado verifica el complemento contra el política de revisión — seguridad, corrección manifiesta, integridad, contenido.	Automatización
Moderación	Un moderador humano lee el informe de la IA junto con tu artefacto y metadatos y decide.	Equipo AiHummer
publicada	Tras la aprobación, el artefacto se firma y se añade al catálogo de la comunidad y al feed del mercado público.	Equipo AiHummer
rechazada	Si algo falla, obtienes las razones; corrige y vuelve a enviar.	Tú → volver al Borrador

[!IMPORTANT] La IA nunca publica por sí solo. Un humano siempre toma la decisión final, y nada llega al catálogo sin su aprobación.

Paso 1 — Abrir «Mis complementos»

Iniciar sesión en my.aihummer.ru, abra el «Mis complementos» sección, y hacer clic «Publicar» (o «Nuevo complemento»). Esto crea una borrador puedes editar libremente hasta que lo envíes.

Paso 2 — Rellenar los metadatos de la tienda

Rellena todos los campos. Los metadatos incompletos son una de las razones más comunes por las que una presentación es devuelta.

Campo	Qué ingresar
Nombre (RU + EN)	El nombre para mostrar del complemento en ambos idiomas.
Descripción breve (RU + EN)	Una línea para la tarjeta del catálogo.
Descripción completa (RU + EN)	Qué hace el complemento, cómo usarlo, qué necesita. Significativo, no un marcador de posición.
Categoría	Elige uno del conjunto permitido (por ejemplo, Canales, Productividad, Integraciones, Voz, Utilidades).
Versión	A semver cadena, p. ej. `1.0.0`. Cada nueva presentación debe incrementarlo.
Ícono	Una imagen cuadrada válida.
Capturas de pantalla	Al menos uno; mostrando el plugin en acción.
Licencia	La licencia del complemento (por ejemplo, MIT, Apache-2.0).
Página principal / repositorio	Opcional `https://` enlace a tu proyecto.
Enlace de donación	Opcional. Válido `https://` enlace a un anfitrión de donaciones bien conocido — por ejemplo Boosty, Patreon, PayPal o YooMoney. Se rechazan el phishing o los hosts arbitrarios.
Registro de cambios (RU + EN)	Qué cambió en esta versión.

[!TIP] Escribe las descripciones para un usuario real que nunca ha visto tu complemento. “dummies” es exactamente correcto: dice lo que hace, cuándo usarlo y lo que necesita.

Paso 3 — Declarar el manifiesto de capacidades

la manifiesto de capacidad es el corazón del modelo de seguridad. Es una declaración breve y estructurada de todos los permisos que tu plugin necesita — con qué hosts se comunica, qué archivos toca, si ejecuta comandos externos, qué canales y credenciales utiliza.

Por qué declararlo

Los clientes ven los permisos solicitados antes de que instalen y consentir ellos, al igual que el aviso de permisos de una aplicación móvil.
La instancia utiliza el manifiesto para restringir el complemento a lo que declaró.
Los revisores verifican que su declarada capacidades partido cuál es el código en realidad hace. Un complemento que solicita un permiso que no declaró es rechazado.

Principio de menor privilegio

Declarar solamente lo que tu complemento realmente utiliza, y nada más. Menos permisos significa revisión más rápida, consentimiento del cliente más fácil y más instalaciones. Si no tocas el sistema de archivos, declara una lista vacía. Si nunca inicias un proceso, establece exec a false.

El formato

El manifiesto de capacidades es un objeto JSON con estos campos:

Campo	Tipo	Significado
`network`	cadena[]	Nombres de host a los que el complemento se conecta (su lista de permitidos de salida).
`filesystem`	cadena[]	Rutas que lee o escribe, relativas a su propio directorio de complemento.
`exec`	booleana	Si genera procesos externos / ejecuta comandos.
`channels`	cadena[]	Canales de mensajería con los que se integra (por ejemplo `telegram`).
`credentials`	cadena[]	Nombres de secretos/claves de configuración que utiliza (nunca los valores secretos).
`description`	cadena	Un resumen breve y comprensible de lo que necesita y por qué.

Ejemplo:

{
  "network": ["api.example.com", "cdn.example.com"],
  "filesystem": ["./cache"],
  "exec": false,
  "channels": ["telegram"],
  "credentials": ["api_token"],
  "description": "Calls the Example API to sync tasks and posts replies to Telegram. Caches responses under its own ./cache directory. No process spawning, no other hosts."
}

[!WARNING] Hacer no poner secretos reales, tokens o llaves en cualquier lugar — no en el manifiesto, no en los metadatos, no en el artefacto. Declarar credenciales solo de nombre (p.e. api_token); el cliente proporciona el valor real en el momento de la instalación. Codificado de forma fija los secretos son un rechazo automático.

Paso 4 — Cargar el artefacto

Sube la compilación de tu complemento:

Formato: un .tar.gz paquete comprimido de lanzamiento producido por aihummer plugin package.
Debe contener el del complemento manifest.json (el manifiesto del SDK — tipo, versión, punto de entrada, declarado capabilities, campos de configuración).
El manifiesto de capacidades que completaste en el Paso 3 debe ser consistente con qué el código y manifest.json realmente hacer.

También adjuntas el icono y capturas de pantalla aquí si no lo hiciste ya.

[!TIP] Correr aihummer plugin validate localmente antes de subir. El contrato de validación es el mismo que usa el mercado, por lo que un manifiesto que pasa localmente será aceptado aquí también.

Paso 5 — Enviar para revisión

Cuando todos los campos estén llenos y el artefacto esté subido, haz clic «Enviar para revisión». El gabinete realiza primero una verificación de completitud; si falta algo, te indica exactamente qué. Una vez aceptado, el estado pasa a Enviado y luego Revisión de IA — no necesitas hacer nada más.

Paso 6 — Rastrea el estado y lee un veredicto

Abrir el complemento en «Mis complementos» para seguir su estado. Cuando la revisión termine, verás uno de:

Con moderación — la revisión automatizada pasó o solo señaló cosas menores; a El humano ahora lo está mirando. Solo espera.
rechazada — algo falló. Verás un veredicto, un resumen, y el artículos específicos que no pasaron (con la razón de cada uno). Esto es tu lista de reparaciones.
publicada — aprobado, firmado y activo. Tu plugin ahora aparece en la Mercado AiHummer e instala en cualquier instancia que tiene habilitado el catálogo de la comunidad.

Cómo leer un rechazo y volver a enviar

Abre el complemento; lee el artículos fallidos y sus razones.
Arréglalos: la mayoría son uno de los siguientes: una descripción faltante/débil, una capacidad no coincidente manifiesto, un secreto codificado, un enlace de donación incorrecto o una versión que no incremento.
Editar los metadatos y/o subir un nuevo artefacto con una versión incrementada.
Hacer clic «Enviar para revisión» de nuevo. Vuelve a pasar por la misma canalización.

[!NOTE] Un rechazo no es un castigo — es una lista de verificación. El política de revisión es público precisamente para que tú puede cumplir con todos los requisitos antes tú te sometes.

¿A dónde vamos después?

Política de revisión y lista de verificación — el exacto criterios contra los cuales se verifica tu complemento.
SDK de complementos — construir el complemento y su manifest.json.
Publicando un complemento — carga lateral privada y los otros modos de publicación.
Instalar y actualizar — cómo los clientes instalar y cómo funciona el modelo de confianza.