Connect-Cookbook
Connect-Cookbook
Abschnitt betitelt „Connect-Cookbook“NextPDF Connect öffnet die NextPDF-Engine für entfernte Aufrufer und KI-Systeme über das Model Context Protocol, eine REST-API und einen gRPC-Service. Das Connect-Cookbook sammelt die Task-Recipes für diese Oberfläche; diese Seite dient als Index. Sie hält den Slug fest, den jedes Recipe belegt, sowie die Stufe und die Transportgrenze, in deren Kontext jedes Recipe gelesen wird. Da es sich um einen Index handelt, trifft er keine Verhaltensaussagen zu einzelnen Recipes. Jede Recipe-Seite wird im Repository nextpdf/server unter docs/public/ verfasst, enthält ihre eigenen Aussagen und wird vom Aggregator mit intakter Quellenherkunft in diese Site übernommen.
Den Vertrag, dem jedes Connect-Recipe folgt, finden Sie unter Recipe-Konventionen. Die ökosystemweite Integrationslandschaft beschreibt das Integrations-Cookbook.
Wie die Stufe beeinflusst, was Sie ausführen können
Abschnitt betitelt „Wie die Stufe beeinflusst, was Sie ausführen können“Der Toolsatz eines Connect-Deployments wird beim Booten berechnet und nicht im Voraus festgelegt. Die Tool-Registry des Servers registriert die Core-Tools bedingungslos. Anschließend prüft sie mit class_exists() auf die Pro- und Enterprise-Provider und registriert deren Tools nur dann, wenn nextpdf/premium neben dem Server installiert ist. Ein Recipe, das von einem Pro- oder Enterprise-Tool abhängt, läuft also nur auf einem Deployment, auf dem dieses Tool aufgelöst wurde. Auf einer reinen Open-Source-Installation ist das Tool nicht vorhanden, und der Aufruf gibt einen Unknown-Tool-Fehler zurück, statt stillschweigend auf einen geringeren Funktionsumfang zurückzufallen. Jedes Recipe nennt seine Stufe; dieser Index gruppiert die Recipes nach Stufe, damit Sie auf einen Blick erkennen, was ein bestimmtes Deployment unterstützt.
Die Gesamtzahl der Tools ist eine Laufzeiteigenschaft des Deployments. Weder ein Recipe noch eine Zeile in diesem Index behauptet eine feste Zahl. Maßgeblich ist der eigene Tool-Katalog des Servers, auf den jedes Recipe verlinkt.
Transport- und Fehlermodell
Abschnitt betitelt „Transport- und Fehlermodell“Sie rufen jedes Recipe über alle drei Transporte auf dieselbe Weise auf: über einen MCP-tools/call, den REST-Tool-Endpunkt oder den gRPC-Service. Der Grund ist, dass alle drei denselben Tool-Executor verwenden. Recipes, die einen entfernten Service über HTTP erreichen, behandeln einen Transportfehler und einen nicht erfolgreichen HTTP-Status als zwei getrennte Fälle. Ein PSR-18-Client wirft nur dann eine typisierte Client-Exception, wenn er die Anfrage überhaupt nicht senden kann, siehe PSR-18 §4. Eine 4xx- oder 5xx-Antwort ist dagegen ein normaler Rückgabewert, den der Aufrufer prüft, keine Exception; siehe PSR-18 §4.
Die Recipe-Slug-Karte
Abschnitt betitelt „Die Recipe-Slug-Karte“Jedes Recipe liegt unter /cookbook/connect/<recipe>/. Die Tabelle dokumentiert den Slug, die Stufe, unter der das Recipe gelesen wird, und einen einzeiligen Geltungsbereich. Die Recipe-Seiten werden in nextpdf/serverdocs/public/ verfasst und hier aggregiert. Bis eine Seite erscheint, ist ihr Link eine Vorwärtsreferenz.
| Recipe | Stufe | Geltungsbereich |
|---|---|---|
hello-world (Upstream geplant) | Core | Erster Connect-Aufruf: erstellen, Inhalt hinzufügen, ausgeben |
multi-page (Upstream geplant) | Core | Mehrseitiges Dokument über Connect |
image-embedding (Upstream geplant) | Core | Ein Bild über Connect einbetten |
html-table (Upstream geplant) | Core | Eine HTML-Tabelle über Connect rendern |
font-typography (Upstream geplant) | Core | Schriften und Typografie über Connect |
exception-aware (Upstream geplant) | Core | Exception-bewusste Tool-Aufrufe |
environment-diagnostics (Upstream geplant) | Core | Tools zur Umgebungsdiagnose |
layout-inspection (Upstream geplant) | Core | Layout ohne Rendering inspizieren |
worker-safe (Upstream geplant) | Core | Worker-sichere Batch-Nutzung |
output-approval (Upstream geplant) | Core | Das Output-Gate mit Mensch in der Schleife |
event-hooks (Upstream geplant) | Core | Lifecycle-Event-Hooks |
fill-pdf-form (Upstream geplant) | Pro | Ein PDF-Formular über Connect ausfüllen |
extract-text-content (Upstream geplant) | Pro | Textinhalt über Connect extrahieren |
digital-signature (Upstream geplant) | Pro | Ein PDF über Connect signieren (PAdES B-B und B-T) |
accessibility-check (Upstream geplant) | Pro | PDF/UA-Barrierefreiheitsprüfung |
pii-redaction (Upstream geplant) | Enterprise | Erkannte personenbezogene Daten aus der Textebene entfernen (destruktiv) |
aria-tagged-pdf (Upstream geplant) | Pro | ARIA-Landmark-Rollen auf getaggte Struktur abbilden |
figure-caption (Upstream geplant) | Pro | Barrierefreie Figure mit verschachtelter Caption |
aria-noteref-pattern (Upstream geplant) | Pro | Fußnotenreferenz- und Textkörper-Muster |
compliance-check (Upstream geplant) | Enterprise | Eine Prüfung nach benanntem Standard ausführen |
forensic-analysis (Upstream geplant) | Enterprise | Forensische Analyse eines signierten PDFs |
ltv-health-check (Upstream geplant) | Enterprise | LTV-Zustandsprüfung (B-LT/B-LTA, nur Enterprise) |
batch-compliance (Upstream geplant) | Enterprise | Batch-Standardprüfung |
ai-ready-certification (Upstream geplant) | Enterprise | KI-Bereitschaftsprüfung (keine Zertifizierung) |
page-artifacts (Upstream geplant) | Enterprise | Paginierungs-Chrome als Artefakte markieren |
conformance-mode (Upstream geplant) | Enterprise | Einen Konformitätsmodus auswählen (soll konform sein; ein Validator entscheidet) |
cjk-vertical-writing (Upstream geplant) | Enterprise | Metriken für vertikale CJK-Schreibrichtung |
opentelemetry (Upstream geplant) | Core | Connect mit OpenTelemetry beobachten |
tagged-pdf-tutorial (Upstream geplant) | Core | Tutorial für getaggtes PDF (soll konform sein; veraPDF entscheidet) |
Der Slug bildet die Absicht des Recipes in Kebab-Case mit einem einzigen abschließenden Schrägstrich ab: kein numerisches Präfix, keine Versionsnummer, keine Dateiendung. Ein Recipe-Slug ändert sich nach der Veröffentlichung nicht, und ein verschobener Slug erhält einen Redirect.
Konformitäts- und Zertifizierungsgrenze
Abschnitt betitelt „Konformitäts- und Zertifizierungsgrenze“Mehrere Recipes berühren Standards (PDF/UA-2, PDF/A-4, PAdES). Das Connect-Cookbook versteht die Unterstützung eines Standards als Unterstützung, niemals als Konformität oder Zertifizierung. Die Engine erzeugt Ausgaben, die konform sein sollen, und ein unabhängiger Validator (zum Beispiel veraPDF) bestimmt die Konformität. Das KI-Bereitschafts-Recipe ist eine Bereitschaftsprüfung, keine Zertifizierung. Das Long-Term-Validation-Material des LTV-Recipes ist eine reine Enterprise-Fähigkeit. Wenn es in einem Dokument vorhanden ist, trägt das Dokument diese Fähigkeit; es ist keine Garantie für unbegrenzte Signaturgültigkeit. Jedes betroffene Recipe wiederholt diese Grenzen vollständig. Dieser Index merkt nur an, dass sie existieren, und verweist darauf, woraus sie hergeleitet werden, statt sie hier erneut herzuleiten.
Siehe auch
Abschnitt betitelt „Siehe auch“- Recipe-Konventionen — der Vertrag, dem jedes Connect-Recipe folgt.
- Integrations-Cookbook — die ökosystemweite Paket- und Integrationsreferenz, deren Netzwerkdienst Connect ist.