Masaüstü uygulamayı neden atladık
PDF123 ikinci bir masaüstü arayüzü yayımlamayacak. Çevrimdışı ve özel kullanım Docker Compose üzerinde kalır; onun pdfx-server’ı API’nin sunduğu aynı kataloğu sunar.

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ı taban URL’nize yönelen pdfx CLI, 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.
Kendi makinenizde çalışan bir pdfx-server, GUI’ye hiç ihtiyaç duymamış çevrimdışı toplu işleri karşılayan şeydir: pdfx o tabana yönelir ve curl ile aynı multipart sözleşmesini gönderir. Burada çevrimdışı, sunucunun sizin olması demektir; CLI’nın sunucusuz çalışması değil.
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. Sunucu yolu varsayılan olarak Markdown (text/markdown) döner; Auto ve Force kipleri vardır (Force için ocrType=force-ocr), outputFormat=pdf verildiğinde de Tesseract ile aranabilir bir PDF döner. İki çıktı farklı motorlardan gelir ve dil ayarı ile 50 sayfa üst sınırı gibi sınırları farklıdır. Yalnızca birini kopyalayan bir masaüstü arayüzü API ile sessizce çelişirdi. 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 taban URL’nize karşı 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.