Per què vam descartar l'aplicació d'escriptori

Quan els fitxers no han de sortir d'una xarxa privada, la petició següent sol ser un instal·lador de Windows o macOS. Vam rebutjar aquesta forma a propòsit. Una interfície gràfica d'escriptori seria una segona base de codi d'interfície. La divergència de funcions entre «l'aplicació» i /api/v1/ és gairebé inevitable quan aquests dos arbres se separen.

La restricció és el límit, no l'aparença

«Els bytes es queden aquí» se satisfà amb un pdfx-server que executeu vosaltres, no amb WinForms o Electron en concret. Compose més pdfx (local o --cloud contra la vostra URL base) mantenen un sol catàleg d'operacions darrere del navegador, REST, MCP i la CLI.

Com alçar aquesta pila està documentat a Autoallotjament: task docker:build / task docker:up per a Compose (API a :8080, portal a :3000), o el natiu task pdfx:dev al costat del portal per al treball local. Definiu SECURITY_CUSTOMGLOBALAPIKEY quan vulgueu una porta fixa. Aquest article només explica per què aquella pila no s'embolcalla com a producte d'escriptori.

El pdfx local sense --cloud executa el pdf-core a la màquina que té els fitxers. Això ja cobreix les tasques per lots offline que no necessitaven cap interfície gràfica. El mode núvol serveix perquè la mateixa CLI ataqui la vostra base d'API autoallotjada o allotjada amb el mateix contracte multipart que curl.

Quant costaria una bifurcació d'escriptori

Les suites per a consumidors optimitzen l'edició amb llenç, la comparació visual i els instal·ladors de botiga. Mantenir aquella superfície vol dir duplicar cada operació nova (indicadors d'unió, modes d'OCR, valors per defecte de sanitize) en una interfície gràfica que no és el contracte OpenAPI que els agents ja criden.

Els connectors i els canals de botiga multipliquen el suport sense millorar l'MCP ni el comportament d'Idempotency-Key. Cada cicle de revisió d'una botiga i cada avís de permisos del sistema operatiu és temps que no acaba a /v1/openapi.json. Quan l'arbre d'escriptori publica una opció d'unió que l'API no té (o al revés), les automatitzacions i les demostracions discrepen en silenci.

L'OCR és un exemple concret de per què la duplicació fa mal. El camí actual del servidor retorna Markdown (text/markdown) amb modes Auto i Force (ocrType=force-ocr per a Force). Una interfície d'escriptori que encara prometés un «PDF cercable amb capa oculta» mentiria sobre una canalització diferent. Mantenir una sola definició d'operació evita aquesta escissió.

Un catàleg, quatre clients, cap segona interfície

El producte ja té quatre camins cap a les mateixes operacions: el formulari del portal, curl a /api/v1/…, l'MCP a /mcp i pdfx en local o al núvol. Uneix n'és l'exemple concret: combina PDF en l'ordre de càrrega sense rasteritzar les pàgines en imatges, tant si heu clicat Processa com si heu enviat parts fileInput.

Una edició d'escriptori seria un cinquè camí amb un cicle de publicació a part. El mode de fallada que ens preocupa no és «falta una icona a la safata del sistema». És «la pàgina de demostració encara funciona mentre l'script que depenia de la mateixa operació regredeix en silenci».

Què no afirmem

Ometre l'escriptori no inventa una edició interactiva de nivell Acrobat al navegador. Les eines de formulari i les tasques HTTP continuen sent el producte. Els llenços d'edició en línia, la comparació visual i les interfícies de signatura per a consumidors queden fora d'abast a propòsit. Si necessiteu un desplegament privat, engegueu Compose i apunteu els clients a la vostra base d'API. Si necessiteu un editor de píxels, feu servir una suite feta per a això; no espereu cap .exe de PDF123.

El PDF123 allotjat continua sent el camí anònim ràpid. L'autoallotjament és la mateixa caixa d'eines darrere del vostre tallafoc. Cap dels dos camins no és una tercera edició d'escriptori divergent. Per al contrast amb els convertidors que només funcionen al navegador, vegeu Per què autoallotjar una caixa d'eines PDF. Sobre què compreu i què heu d'operar, vegeu Què us aporta realment l'autoallotjament. Per com es mantenen alineats els quatre clients sense escriptori, vegeu La mateixa operació, quatre clients.