Masaüstü uygulamayı neden atladık

Dosyalar özel bir ağdan çıkmamalıysa sıradaki talep çoğu zaman bir Windows veya macOS kurulumudur. Bu biçimi bilinçli olarak reddettik. Bir masaüstü GUI’si ikinci bir arayüz kod tabanı olurdu. “Uygulama” ile /api/v1/ arasındaki özellik kayması, bu ağaçlar ayrıştığında neredeyse kaçınılmazdır.

Kısıt sınırın kendisidir, süsleme değil

“Baytlar burada kalsın” koşulunu WinForms veya Electron değil, çalıştırdığınız bir pdfx-server karşılar. Compose artı pdfx (yerel ya da taban URL’nize karşı --cloud), tarayıcı, REST, MCP ve CLI arkasında tek bir işlem kataloğu tutar.

Bu yığını nasıl ayağa kaldıracağınız Self-host sayfasında belgelenmiştir: Compose için task docker:build / task docker:up (API :8080, portal :3000), yerel çalışma için portalın yanında yerel task pdfx:dev. Sabit bir kapı istediğinizde SECURITY_CUSTOMGLOBALAPIKEY ayarlayın. Bu yazı yalnızca o yığının neden bir masaüstü ürünü olarak paketlenmediğiyle ilgilidir.

--cloud olmadan yerel pdfx, pdf-core’u dosyaların bulunduğu makinede çalıştırır. Bu, hiç GUI’ye ihtiyaç duymamış çevrimdışı toplu işleri zaten karşılar. Bulut kipi, aynı CLI’nın curl ile aynı çok parçalı sözleşmeyi kullanarak kendi barındırdığınız veya barındırılan API tabanınıza istek atması gerektiği durum içindir.

Masaüstü bir çatalın maliyeti ne olurdu

Tüketici paketleri tuval düzenlemeyi, görsel karşılaştırmayı ve mağaza kurulumlarını optimize eder. O yüzeyi sürdürmek, her yeni işlemi (birleştirme bayrakları, OCR kipleri, sanitize varsayılanları) ajanların zaten çağırdığı OpenAPI sözleşmesi olmayan bir GUI’de çoğaltmak demektir.

Eklentiler ve mağaza kanalları, MCP veya Idempotency-Key davranışını iyileştirmeden desteği katlar. Her mağaza inceleme döngüsü ve işletim sistemi izin istemi, /v1/openapi.json dosyasına inmeyen zamandır. Masaüstü ağacı API’de olmayan bir birleştirme seçeneği yayımladığında (ya da tersi), otomasyonlar ve demolalar sessizce ayrışır.

OCR, çoğaltmanın neden zararlı olduğunun somut bir örneğidir. Mevcut sunucu yolu, Auto ve Force kipleriyle (Force için ocrType=force-ocr) Markdown (text/markdown) döner. Hâlâ “gizli katmanlı aranabilir PDF” vaat eden bir masaüstü arayüzü, farklı bir ardışık düzen hakkında yalan söylüyor olurdu. Tek bir işlem tanımını korumak bu ayrışmayı önler.

Tek katalog, dört istemci, ikinci arayüz yok

Ürünün aynı işlemler üzerinde zaten dört tutamağı var: portal formu, /api/v1/… adresine curl, /mcp adresinde MCP ve yerel ya da bulut pdfx. Merge somut örnektir: İşle’ye tıklamışsınız ya da fileInput parçalarını göndermişsiniz fark etmeksizin, sayfaları görüntülere rasterize etmeden PDF’leri yükleme sırasında birleştirin.

Bir masaüstü sürümü, ayrı bir sürüm treni olan beşinci bir tutamak olurdu. Önemsediğimiz başarısızlık biçimi “tepsi simgesinin olmaması” değil. “Demo sayfası hâlâ çalışırken aynı işleme bağlı betiğin sessizce gerilemesi”dir.

İddia etmediğimiz şeyler

Masaüstünü atlamak, tarayıcıda Acrobat sınıfı etkileşimli düzenleme yaratmaz. Ürün form araçları ve HTTP işleri olarak kalır. Çevrimiçi Düzenle tuvalleri, görsel karşılaştırma ve tüketiciye dönük İmza arayüzleri bilinçli olarak kapsam dışıdır. Özel bir kurulum gerekiyorsa compose’u ayağa kaldırıp istemcileri API tabanınıza yöneltin. Piksel düzenleyici gerekiyorsa, bunun için kurulmuş bir paket kullanın; bir PDF123 .exe’si beklemeyin.

Barındırılan PDF123 hızlı anonim yol olarak kalır. Self-host, güvenlik duvarınızın arkasındaki aynı araç setidir. İki yol da üçüncü, ayrışan bir masaüstü sürümü değildir. Yalnızca tarayıcı dönüştürücüleriyle karşıtlık için Neden bir PDF araç setini kendi sunucunuzda barındırmalısınız yazısına bakın. Neyi satın alıp neyi işlettiğiniz için Kendi sunucunuzda barındırmak size gerçekte ne kazandırır yazısına bakın. Dört masaüstü dışı istemcinin nasıl hizalı kaldığı için Aynı işlem, dört istemci yazısına bakın.