help.c.nf / Pakete

Paket-Registry

p.c.nf ist die CNF-Paket-Registry – ein Namespace nach dem Vorbild von GitHub zum Veröffentlichen versionierter Pakete. Jedes Artefakt hat eine stabile URL, einen Downloadzähler und Zugriffskontrollen.

Inhalt

Übersicht

p.c.nf hostet Pakete unter einem Namespace nach dem Schema <username>/<project>. Jedes Projekt hat mindestens eine Version, und jede Version kann mindestens ein herunterladbares Artefakt enthalten.

Das Prinzip ähnelt @scope/package bei npm oder user/repo bei GitHub – allerdings für binäre Artefakte statt Quellcode.

URL-Struktur

p.c.nf/ Katalog – alle öffentlichen Pakete durchsuchen
p.c.nf/<user> Benutzerprofil – dessen Pakete auflisten
p.c.nf/<user>/<pkg> Projektseite – neueste Version und Verlauf
p.c.nf/<user>/<pkg>/<version> Versionsseite – Artefakte und Änderungsprotokoll
p.c.nf/<user>/<pkg>/download Neuestes Artefakt herunterladen
p.c.nf/<user>/<pkg>/<version>/download Bestimmte Version herunterladen (dauerhaft)
p.c.nf/<user>/<pkg>/<version>/<label> Artefakt mit Bezeichnung herunterladen (zum Beispiel eine Plattformvariante)

Herunterladen

Laden Sie ein Paket mit curl oder wget herunter:

# Neueste Version curl -LO https://p.c.nf/c/cred-extension/download # Festgelegte Version curl -LO https://p.c.nf/c/cred-extension/2.0.1/download

Downloads unterstützen HTTP-Range-Anfragen zum Fortsetzen sowie bedingte GET-Anfragen, die 304 Not Modified zurückgeben.

Ratenlimit: 30 Downloads pro IP-Adresse und Minute. Bei Überschreitung wird ein 429 Retry-After-Header zurückgegeben.

Veröffentlichen

Veröffentlichen Sie eine neue Version über die Konsole oder die HTTP-API. Bei beiden Verfahren wird das Projekt bei der ersten Veröffentlichung erstellt.

Über die 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" ✓ Veröffentlicht you/my-tool@1.0.0

Erforderliche Felder:

  • slug – nur Kleinbuchstaben und Bindestriche (höchstens 128 Zeichen)
  • version – frei wählbare Zeichenfolge; semantische Versionierung wird empfohlen
  • file – hochzuladendes Artefakt

Optionale Felder: description, category, icon, visibility, changelog und label für Versionen mit mehreren Artefakten.

Über die Konsole

Melden Sie sich unter console.c.nf an und öffnen Sie die Download-Verwaltung. In der Konsole verwalten Sie Datei-Uploads, Metadaten und Versionsaktualisierungen.

Hinweis: Zum Veröffentlichen ist ein authentifizierter CNF-Benutzer erforderlich. Jeder Benutzer veröffentlicht unter seinem eigenen Namespace /<username>/. Sie können nicht unter dem Namen eines anderen Benutzers veröffentlichen.

Authentifizierung

Zwei Authentifizierungsmethoden werden unterstützt:

API-Schlüssel (für Automatisierung empfohlen)

Erstellen Sie unter console.c.nf/account/api einen Schlüssel und senden Sie ihn anschließend als Bearer-Token:

Authorization: Bearer cnf_a1b2c3d4e5f6...

Schlüssel werden beim Erstellen einmalig angezeigt. Sie können bis zu 10 aktive Schlüssel erstellen und jederzeit widerrufen.

Sitzungs-Cookie

Beim Aufruf über console.c.nf oder id.c.nf authentifiziert Ihr Sitzungs-Cookie Sie automatisch. Dies ist für die Browsererweiterung und die Konsole nützlich.

Sichtbarkeit

public Im Katalog aufgeführt; jeder kann es herunterladen.
unlisted Im Katalog ausgeblendet; jeder mit der URL kann es herunterladen.
private Nur der Eigentümer und Administratoren können es anzeigen oder herunterladen.

Versionen

Jede veröffentlichte Version bleibt unter einer stabilen URL erhalten. Ältere Versionen sind auch nach neuen Veröffentlichungen verfügbar, sodass Verbraucher mit einer festen Version unter /1.0.0/download weiterhin genau diesen Build erhalten.

Der unversionierte Endpunkt /download liefert immer die neueste Version.

Versionszeichenfolgen sind frei wählbarer Text. Semantische Versionierung (MAJOR.MINOR.PATCH) wird zur besseren Übersicht empfohlen, aber nicht erzwungen.

FAQ

Was ist der Unterschied zwischen p.c.nf und d.c.nf?

p.c.nf ist eine versionierte Paket-Registry mit einem Namespace pro Benutzer (user/project). d.c.nf ist ein flacher Katalog ausgewählter Downloads, den CNF-Administratoren verwalten.

Kann ich eine Version löschen?

Ja, über die Konsole. Beim Löschen einer Version funktionieren möglicherweise von Verbrauchern gespeicherte feste URLs nicht mehr. Daher ist die Veröffentlichung einer neuen Version meist vorzuziehen.

Gibt es ein Größenlimit?

Artefaktlimits hängen von Ihrer Benutzerberechtigungsstufe ab: 50 MB pro UPL-Stufe, bis zu etwa 500 MB. Größere Dateien können über die Konsole in Blöcken hochgeladen werden.

Wie authentifiziere ich die Erweiterung?

Die Erweiterung CNF Cred unterstützt Sitzungs-Cookies, wenn Sie bei console.c.nf angemeldet sind, sowie API-Schlüssel. Konfigurieren Sie die Methode in den Erweiterungseinstellungen.