help.c.nf / Paquetes

Registro de paquetes

p.c.nf es el registro de paquetes de CNF: un espacio de nombres al estilo de GitHub para publicar paquetes con versiones. Cada artefacto tiene una URL estable, un contador de descargas y controles de acceso.

Contenido

Descripción general

p.c.nf aloja paquetes en un espacio de nombres <username>/<project>. Cada proyecto tiene una o más versiones y cada versión puede tener uno o más artefactos descargables.

Se parece a @scope/package de npm o a user/repo de GitHub, pero está pensado para artefactos binarios en vez de código fuente.

Estructura de las URL

p.c.nf/ Catálogo: explorar todos los paquetes públicos
p.c.nf/<user> Perfil del usuario: ver sus paquetes
p.c.nf/<user>/<pkg> Página del proyecto: versión más reciente e historial
p.c.nf/<user>/<pkg>/<version> Página de la versión: artefactos y registro de cambios
p.c.nf/<user>/<pkg>/download Descargar el artefacto más reciente
p.c.nf/<user>/<pkg>/<version>/download Descargar una versión concreta (permanente)
p.c.nf/<user>/<pkg>/<version>/<label> Descargar un artefacto con etiqueta (por ejemplo, una variante para una plataforma)

Descarga

Descargue un paquete con curl o wget:

# Versión más reciente curl -LO https://p.c.nf/c/cred-extension/download # Versión fijada curl -LO https://p.c.nf/c/cred-extension/2.0.1/download

Las descargas admiten solicitudes HTTP Range para reanudarlas y solicitudes GET condicionales que devuelven 304 Not Modified.

Límite de frecuencia: 30 descargas por dirección IP y por minuto. Cuando se supera el límite, se devuelve una cabecera 429 Retry-After.

Publicación

Publique una versión nueva mediante la consola o la API HTTP. Cualquiera de los métodos crea el proyecto al publicarlo por primera vez.

Mediante la API

curl -X POST https://p.c.nf/api/publish \ -H "Authorization: Bearer cnf_..." \ -F "slug=my-tool" \ -F "version=1.0.0" \ -F "file=@dist/my-tool.zip" \ -F "description=Short one-line summary" \ -F "category=Client tools" ✓ Publicado you/my-tool@1.0.0

Campos obligatorios:

  • slug: solo letras minúsculas y guiones (128 caracteres como máximo)
  • version: una cadena de formato libre; se recomienda usar versionado semántico
  • file: el artefacto que se va a subir

Campos opcionales: description, category, icon, visibility, changelog y label para versiones con varios artefactos.

Mediante la consola

Inicie sesión en console.c.nf y abra la administración de Descargas. La consola gestiona la subida de archivos, los metadatos y las actualizaciones de versiones.

Nota: Para publicar se requiere un usuario de CNF autenticado. Cada usuario publica en su propio espacio de nombres /<username>/. No puede publicar con el nombre de otro usuario.

Autenticación

Se admiten dos métodos de autenticación:

Clave de API (recomendada para automatización)

Genere una clave en console.c.nf/account/api y envíela como token Bearer:

Authorization: Bearer cnf_a1b2c3d4e5f6...

Las claves se muestran una sola vez al generarlas. Puede crear hasta 10 claves activas y revocarlas en cualquier momento.

Cookie de sesión

Cuando navega desde console.c.nf o id.c.nf, la cookie de sesión le autentica automáticamente. Resulta útil para la extensión del navegador y la consola.

Visibilidad

public Aparece en el catálogo y cualquiera puede descargarlo.
unlisted Está oculto en el catálogo, pero cualquiera que tenga la URL puede descargarlo.
private Solo pueden verlo o descargarlo el propietario y los administradores.

Versiones

Cada versión publicada se conserva en una URL estable. Las versiones anteriores siguen disponibles después de cada lanzamiento nuevo, por lo que quienes hayan fijado /1.0.0/download seguirán recibiendo exactamente esa compilación.

El endpoint sin versión /download siempre sirve la versión más reciente.

Las cadenas de versión son texto de formato libre. Se recomienda el versionado semántico (MAJOR.MINOR.PATCH) para aportar claridad, pero no es obligatorio.

FAQ

¿Cuál es la diferencia entre p.c.nf y d.c.nf?

p.c.nf es un registro de paquetes con versiones y un espacio de nombres para cada usuario (user/project). d.c.nf es un catálogo plano de descargas seleccionadas que administran los responsables de CNF.

¿Puedo eliminar una versión?

Sí, desde la consola. Eliminar una versión rompe las URL fijadas que puedan haber guardado los usuarios, por lo que suele ser preferible publicar una versión nueva.

¿Hay un límite de tamaño?

Los límites de los artefactos dependen de su nivel de permisos: 50 MB por cada nivel UPL, hasta aproximadamente 500 MB. Los archivos de mayor tamaño pueden subirse por partes desde la consola.

¿Cómo autentico la extensión?

La extensión CNF Cred admite cookies de sesión cuando ha iniciado sesión en console.c.nf, además de claves de API. Configure el método en la extensión.