pdfx CLI: Ndani Kwanza, Wingu Unapohitaji

PDF123 ni jina la bidhaa. pdfx ni CLI fupi inayozungumza na operesheni zile zile. Njia ya chaguo-msingi ni ya ndani: soma faili, endesha operesheni kupitia pdf-core, andika tokeo. Hakuna akaunti, hakuna funguo ya API, hakuna upakiaji.

Ndani kwanza humaanisha faili haiondoki kamwe

Mwito wa kawaida huonekana kama pdfx merge a.pdf b.pdf -o merged.pdf au pdfx compress input.pdf. Usindikaji huendeshwa pale programu inapoendeshwa. Hiyo hufaa kazi za CI kwenye kiondoa cha kibinafsi, hati za maandishi kando ya kundi la ankara, na kesi yoyote ambapo kupakia kwa mtu wa tatu ni jibu lisilofaa.

Hali ya ndani si kifuniko chembamba kinachotuma baiti mahali pengine kwa siri. CLI hushiriki rejista hiyo hiyo ya operesheni na seva (pdf_core::ops::run). Kama unataka njia ya mtandao, unajiunga nayo kwa --cloud.

Amri ndogo zilizojengwa ndani hushughulikia operesheni za kawaida: merge, gawanya, bana, zungusha, chimbua, OCR, badilisha muundo, linda, fungua, muhuri wa maji, na kazi zinazohusiana. Tokeo la ndani hupakiwa kwa chaguo-msingi kwenye faili kwa -o / --output; - huandika kwenye matokeo ya kawaida.

--cloud ni katalogi hiyo hiyo kupitia HTTP

Unapohitaji API iliyopangishwa (au pdfx-server yako mwenyewe), tuma --cloud pamoja na --api-base na --api-key (au PDFX_API_KEY). Hali ya wingu huhitaji curl chini ya kifuniko na hushindwa kama hakuna funguo ya API iliyowekwa. Mfano kutoka kwa ujuzi uliochapishwa:

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

--api-base huchukua https://pdf123.xyz kama chaguo-msingi, yaani API iliyopangishwa. Kwa mrundikano wa Docker Compose wa ndani, ielekeze kwa http://127.0.0.1:8080. CLI hujigeuza kuwa mteja wa uso wa REST ulioelezwa kwenye Watengenezaji; majina ya operesheni hulingana na zana za jukwaa na OpenAPI (/v1/openapi.json).

Hali ya wingu haibadilishi operesheni inamaanisha nini. Kubana bado ni ubanaji wa mitiririko wa qpdf; OCR bado hurudisha maandishi ya Markdown kutoka njia ya Rust, si tabaka la PDF linaloweza kutafutwa. Vibendera vya CLI vilivyobaki vinavyoelekea vigezo vya OCR vya enzi ya Java vinavyopuuzwa (kwa mfano sehemu ya languages) havibadilishi mkataba huo.

Kwa nini hali mbili zipo

Ndani hushughulikia uaminifu wa nje ya mtandao na gharama ya sifuri ya safari. Wingu hushughulikia vikomo vya maombi vinavyoshirikiwa, kuendesha operesheni kwenye mashine iliyo na CLI na curl pekee, na timu ambazo tayari hutoa funguo za API. Ajenti wanaweza pia kuita URL hiyo hiyo ya msingi kupitia MCP kwenye /mcp au ujuzi ulio kwenye dist/skills/pdf-toolbox/SKILL.md. Faharasa za ugunduzi kama /llms.txt huwasaidia ajenti wa programu kupata vituo; si ishara ya nafasi kwenye Google.

Kwa majaribio ya pili salama ya POST zinazobadilisha dhidi ya API, tuma Idempotency-Key (ona Idempotency-Key: Majaribio Salama kwa Kazi za PDF). Njia ya wingu ya CLI bado ni ombi moja la HTTP kwa kila mwito; tumia kichwa hicho wakati kifuniko chako kinajaribu tena.

Kuchagua hali kwa vitendo

Tumia ndani wakati faili zinapaswa kubaki kwenye kiondoa, wakati tayari unayo programu ya pdfx na vitegemezi vya asili kwenye mashine hiyo, na wakati ucheleweshaji unasababishwa zaidi na operesheni kuliko upakiaji. Tumia wingu wakati vitegemezi vizito viko kwenye seva pekee, unapotaka vikomo sawa vya maombi na upimaji kama wateja wengine wa API, au wakati ajenti tayari wanayo funguo ya API ya https://pdf123.xyz au ya URL yako ya kujipangisha.

Usichanganye matarajio: OCR ya ndani bado hufuata mkataba wa tokeo la Markdown wa misc/ocr-pdf; ubanaji wa wingu bado ni mitiririko ya qpdf, si upunguzaji wa fonti. Kubadilisha hali hubadilisha pale operesheni inaendeshwa, si maana ya katalogi.

Kile CLI isivyo

pdfx si GUI ya mezani wala maktaba ya OCR inayoweza kupachikwa unayoiunganisha kwenye programu nyingine. Ni mteja wa mstari wa amri kwa operesheni za PDF: ndani kwa chaguo-msingi, HTTP unapoomba. Kazi moja za kivinjari bado zipo kwenye jukwaa (Bana, OCR na katalogi iliyobaki). Uendeshaji wa kiotomatiki unaopendelea program inaweza kubaki kwenye pdfx.

Ulinganisho wa operesheni moja kwa kivinjari, curl, MCP na CLI umeelezwa kwa ufupi katika Operesheni moja, wateja wanne. Anza kwenye Watengenezaji kwa funguo na OpenAPI, au Kujipangisha kama URL ya msingi inapaswa kuwa mrundikano wako wa Docker Compose.