데스크톱 앱을 만들지 않은 이유
PDF123은 두 번째 데스크톱 UI를 내놓지 않습니다. 오프라인과 사내 사용은 Docker Compose와 pdfx에 그대로 남겨, 카탈로그가 API 표면에서 어긋날 수 없게 합니다.
파일이 사설 네트워크를 벗어나면 안 될 때 다음 요청은 대개 Windows나 macOS 설치 프로그램입니다. 우리는 그 형태를 의도적으로 거절했습니다. 데스크톱 GUI는 두 번째 UI 코드베이스가 됩니다. “앱”과 /api/v1/이 갈라지면 기능 드리프트는 거의 피할 수 없습니다.
제약은 경계이지 겉포장이 아닙니다
“바이트가 여기에 남는다”는 WinForms나 Electron이 아니라 직접 운영하는 pdfx-server로 충족됩니다. Compose와 pdfx(로컬, 또는 base URL을 향한 --cloud)가 브라우저와 REST, MCP, CLI 뒤에 하나의 연산 카탈로그를 유지합니다.
그 스택을 세우는 방법은 자체 호스팅에 있습니다. Compose는 task docker:build / task docker:up(API :8080, 포털 :3000), 로컬 작업은 포털 옆에서 네이티브 task pdfx:dev를 씁니다. 고정 게이트를 원하면 SECURITY_CUSTOMGLOBALAPIKEY를 설정하세요. 이 글은 그 스택을 데스크톱 제품으로 감싸지 않은 이유만 다룹니다.
--cloud 없이 쓰는 로컬 pdfx는 파일이 있는 머신에서 pdf-core를 돌립니다. GUI가 전혀 필요 없던 오프라인 배치 작업은 그것으로 이미 충분합니다. 클라우드 모드는 같은 CLI가 자체 호스팅 또는 호스팅 API base를 curl과 같은 multipart 계약으로 칠 때 씁니다.
데스크톱 포크의 대가
소비자용 제품군은 캔버스 편집과 시각 비교, 스토어 설치 프로그램을 최적화합니다. 그 표면을 유지한다는 것은 새 op(병합 플래그, OCR 모드, 정리 기본값)가 나올 때마다 에이전트가 이미 호출하는 OpenAPI 계약이 아닌 GUI에도 똑같이 구현해야 한다는 뜻입니다.
플러그인과 스토어 채널은 MCP나 Idempotency-Key 동작을 개선하지 않으면서 지원 비용만 늘립니다. 스토어 심사 주기와 OS 권한 팝업에 쓰는 시간은 /v1/openapi.json에 남지 않습니다. 데스크톱 트리가 API에 없는 병합 옵션을 내놓거나 그 반대가 되면, 자동화와 데모가 조용히 어긋납니다.
OCR은 중복이 왜 해로운지 보여 주는 구체적인 예입니다. 현재 서버 경로는 Markdown(text/markdown)을 반환하고, Auto와 Force 두 모드가 있습니다(Force는 ocrType=force-ocr). “숨은 레이어가 있는 검색 가능 PDF”를 여전히 약속하는 데스크톱 UI가 있다면 다른 파이프라인을 설명하는 셈이라 거짓말이 됩니다. op 정의를 하나로 유지하면 이런 분기가 생기지 않습니다.
하나의 카탈로그, 네 개의 클라이언트, 두 번째 UI는 없음
제품에는 이미 같은 op에 대한 손잡이가 넷 있습니다. 포털 폼, /api/v1/…를 치는 curl, /mcp의 MCP, 그리고 로컬이나 클라우드 모드의 pdfx입니다. PDF 병합가 구체적인 예입니다. Process를 눌렀든 fileInput 파트를 POST했든, 페이지를 이미지로 래스터화하지 않고 업로드 순서대로 PDF를 합칩니다.
데스크톱 에디션은 별도 릴리스 주기를 가진 다섯 번째 손잡이가 됩니다. 우리가 신경 쓰는 실패 모드는 “트레이 아이콘이 없다”가 아니라 “데모 페이지는 잘 돌아가는데 같은 op에 의존하던 스크립트는 조용히 퇴행한다”입니다.
우리가 주장하지 않는 것
데스크톱을 건너뛴다고 브라우저에 Acrobat급 대화형 편집이 생기지 않습니다. 폼 도구와 HTTP 작업이 제품으로 남습니다. 온라인 편집 캔버스와 시각 비교, 소비자용 서명 UI는 의도적으로 범위 밖입니다. 사설 배포가 필요하면 Compose를 띄우고 클라이언트를 내 API base로 향하게 하세요. 픽셀 편집기가 필요하면 그 목적에 맞게 만들어진 제품군을 쓰세요. PDF123 .exe를 기다리지는 마세요.
호스팅 PDF123은 빠른 익명 경로로 남습니다. 자체 호스팅은 같은 툴킷을 방화벽 뒤로 옮긴 것입니다. 어느 쪽도 세 번째로 갈라지는 데스크톱 에디션이 아닙니다. 브라우저 전용 변환기와의 대비는 PDF 툴킷을 자체 호스팅하는 이유를 보세요. 무엇을 사고 무엇을 운영하는지는 자체 호스팅이 실제로 사 주는 것을 보세요. 데스크톱이 아닌 네 클라이언트가 어떻게 정렬되는지는 같은 연산, 네 개의 클라이언트를 보세요.