Το CLI pdfx: πρώτα τοπικά, στο νέφος όταν το χρειάζεστε

Το PDF123 είναι το όνομα του προϊόντος. Το pdfx είναι το σύντομο CLI που μιλά στις ίδιες λειτουργίες. Η προεπιλεγμένη διαδρομή είναι τοπική: διαβάζει ένα αρχείο, εκτελεί τη λειτουργία μέσω του pdf-core, γράφει ένα αποτέλεσμα. Χωρίς λογαριασμό, χωρίς κλειδί API, χωρίς μεταφόρτωση.

Πρώτα τοπικά σημαίνει ότι το αρχείο δεν φεύγει ποτέ

Μια τυπική κλήση μοιάζει με pdfx merge a.pdf b.pdf -o merged.pdf ή pdfx compress input.pdf. Η επεξεργασία τρέχει όπου τρέχει το εκτελέσιμο. Αυτό ταιριάζει σε εργασίες CI σε ιδιωτικό εκτελεστή, σε σενάρια δίπλα σε μια παρτίδα τιμολογίων και σε κάθε περίπτωση όπου η μεταφόρτωση σε τρίτο είναι η λάθος απάντηση.

Η τοπική λειτουργία δεν είναι λεπτό περιτύλιγμα που στέλνει κρυφά bytes αλλού. Το CLI μοιράζεται το ίδιο μητρώο λειτουργιών με τον διακομιστή (pdf_core::ops::run). Αν θέλετε τη διαδρομή μέσω δικτύου, την επιλέγετε ρητά με το --cloud.

Οι ενσωματωμένες υποεντολές καλύπτουν συνήθεις λειτουργίες: συγχώνευση, διαχωρισμό, συμπίεση, περιστροφή, εξαγωγή, OCR, μετατροπή, προστασία, ξεκλείδωμα, υδατογράφημα και συναφείς εργασίες. Η τοπική έξοδος γράφεται εξ ορισμού σε αρχείο μέσω -o / --output· το - γράφει στην τυπική έξοδο.

Το --cloud είναι ο ίδιος κατάλογος πάνω από HTTP

Όταν χρειάζεστε το φιλοξενούμενο API (ή τον δικό σας pdfx-server), περάστε --cloud μαζί με --api-base και --api-key (ή τη μεταβλητή PDFX_API_KEY). Η λειτουργία νέφους απαιτεί curl στο παρασκήνιο και αποτυγχάνει αν δεν έχει οριστεί κλειδί API. Παράδειγμα από τη δημοσιευμένη δεξιότητα:

pdfx --cloud --api-base "$PDFX_API_BASE" --api-key "$PDFX_API_KEY" \
  merge a.pdf b.pdf -o merged.pdf

Το --api-base έχει προεπιλογή το https://pdf123.xyz, το φιλοξενούμενο API. Για τοπική στοίβα Docker Compose, δείξτε το στο http://127.0.0.1:8080. Το CLI γίνεται πελάτης της επιφάνειας REST που τεκμηριώνεται στους Προγραμματιστές· τα ονόματα των λειτουργιών συμβαδίζουν με τα εργαλεία της πύλης και με το OpenAPI (/v1/openapi.json).

Η λειτουργία νέφους δεν αλλάζει το τι σημαίνει μια λειτουργία. Η συμπίεση παραμένει συμπίεση ροών με qpdf· το OCR επιστρέφει ακόμη κείμενο Markdown από τη διαδρομή Rust, όχι αναζητήσιμο στρώμα PDF. Υπολειμματικές παράμετροι του CLI που αντιστοιχούν σε αγνοημένες παραμέτρους OCR της εποχής Java (για παράδειγμα ένα πεδίο languages) δεν αλλάζουν αυτό το συμβόλαιο.

Γιατί υπάρχουν δύο λειτουργίες

Η τοπική λειτουργία καλύπτει την εμπιστοσύνη χωρίς σύνδεση και το μηδενικό κόστος ταξιδιού. Η λειτουργία νέφους καλύπτει κοινά όρια ρυθμού, εκτέλεση λειτουργιών σε μηχανή που έχει εγκατεστημένα μόνο το CLI και το curl, και ομάδες που εκδίδουν ήδη κλειδιά API. Οι πράκτορες μπορούν επίσης να καλέσουν την ίδια βάση μέσω MCP στο /mcp ή μέσω της δεξιότητας στο dist/skills/pdf-toolbox/SKILL.md. Ευρετήρια ανακάλυψης όπως το /llms.txt βοηθούν τους πράκτορες προγραμματισμού να βρουν σημεία API· δεν αποτελούν σήμα κατάταξης για τη Google.

Για ασφαλείς επαναλήψεις μεταλλακτικών POST στο API, στείλτε Idempotency-Key (δείτε το Idempotency-Key: ασφαλείς επαναλήψεις για εργασίες PDF). Η διαδρομή νέφους του CLI παραμένει ένα αίτημα HTTP ανά κλήση· χρησιμοποιήστε την κεφαλίδα όταν το περιτύλιγμά σας επαναλαμβάνει.

Πώς να διαλέξετε λειτουργία στην πράξη

Χρησιμοποιήστε την τοπική λειτουργία όταν τα αρχεία πρέπει να μείνουν στον εκτελεστή, όταν το εκτελέσιμο pdfx και οι εγγενείς εξαρτήσεις υπάρχουν ήδη σε εκείνη τη μηχανή και όταν η καθυστέρηση κυριαρχείται από τη λειτουργία και όχι από τη μεταφόρτωση. Χρησιμοποιήστε το νέφος όταν οι βαριές εξαρτήσεις βρίσκονται μόνο στον διακομιστή, όταν θέλετε τα ίδια όρια ρυθμού και την ίδια μέτρηση με άλλους πελάτες του API, ή όταν οι πράκτορες έχουν ήδη κλειδί για το https://pdf123.xyz ή για τη δική σας βάση.

Μην ανακατεύετε προσδοκίες: το τοπικό OCR ακολουθεί ακόμη το συμβόλαιο εξόδου Markdown του misc/ocr-pdf· η συμπίεση στο νέφος παραμένει ροές qpdf, όχι υποσύνολα γραμματοσειρών. Η αλλαγή λειτουργίας αλλάζει πού εκτελείται η εργασία, όχι τη σημασία του καταλόγου.

Τι δεν είναι το CLI

Το pdfx δεν είναι γραφικό περιβάλλον για υπολογιστή ούτε βιβλιοθήκη OCR που ενσωματώνεται σε άλλη εφαρμογή. Είναι πελάτης γραμμής εντολών για λειτουργίες PDF: τοπικός εξ ορισμού, HTTP όταν το ζητήσετε. Οι μεμονωμένες εργασίες στον φυλλομετρητή ζουν ακόμη στην πύλη (Συμπίεση, OCR και τα υπόλοιπα του καταλόγου). Η αυτοματοποίηση που προτιμά ένα εκτελέσιμο μπορεί να μείνει στο pdfx.

Συγκρίσεις της ίδιας λειτουργίας σε φυλλομετρητή, curl, MCP και CLI σκιαγραφούνται στο Ίδια λειτουργία, τέσσερις πελάτες. Ξεκινήστε από τους Προγραμματιστές για κλειδιά και OpenAPI, ή από την Αυτο-φιλοξενία αν η βάση του API πρέπει να είναι η δική σας στοίβα Docker Compose.