線上 PDF 修復與「Recovery Toolbox」搜尋：PDF123 實際做了什麼
「PDF recovery toolbox」搜尋多指結構修復。PDF123 修復 PDF 是免費線上工具與 API，不是桌面產品 Recovery Toolbox for PDF。
PDF 打不開時，搜尋結果常把兩件不同的事混在一起：修復損壞檔案的結構，以及品牌化的桌面「復原」軟體。PDF123（pdf123.xyz）以 PDF Toolbox 之名發布，提供的是前者：一個免費線上工具，加上一組修復 PDF API。它不是以 Recovery Toolbox for PDF 為名販售的那款 Windows 產品。
對損壞的 PDF，「修復」指的是什麼
拋出「檔案已損壞」或乾脆拒絕打開的 PDF，通常是內部對照表壞了（交叉參照或物件串流出問題），而不是缺了你可以手工重畫的頁面圖片。修復 PDF（POST /api/v1/misc/repair）的做法，是用 qpdf 從仍然有效的位元組重寫檔案，藉此重建這份結構。復原成功時，檢視器可以重新打開檔案，而頁面內容的本意不變。
這和下面幾種情況不同：
- OCR／掃描清理：檔案能打開，但文字只是一張影像（本站 OCR 回傳 Markdown，不是隱藏文字層）
- 密碼解鎖：檔案已加密，而你已經知道密碼（解鎖）
- 桌面復原套件：裝在本機、針對深度鑑識復原的可安裝應用程式
- 壓縮／轉換：處理體積與格式的工具，前提是先有一份可解析的 PDF
線上工具箱與桌面「Recovery Toolbox」查詢
| 需求 | PDF123 修復 PDF | 典型桌面復原產品 |
|---|---|---|
| 怎麼執行 | 瀏覽器上傳，或用 HTTP API | 在 PC 上安裝後執行 |
| 這裡的主要工作 | 結構修復，讓 PDF 能打開 | 各廠商特定的復原流程（因產品而異） |
| 自動化 | 修復 PDF API，即 POST /api/v1/misc/repair |
通常是 GUI 或本機批次，不是我們的 OpenAPI |
| 帳號 | 目錄工具不需要 | 取決於廠商 |
我們不主張與 Recovery Toolbox for PDF 在功能、價格或版本細節上對等，那是另一款產品。這張表只澄清通路與意圖：線上 API 修復，和人們可能打進 Google 的桌面復原品牌，不是同一回事。
動手修復前先做預檢
取得資訊 會回傳一份 JSON 預檢（FileSize、PageCount、Encrypted、Info 欄位、版本）。用它判斷解析器能否載入檔案，以及是不是加密擋住了其他編輯。修復不會移除密碼。「檔案打不開」的逐步決策樹見檔案打不開：先 Get Info、再 Repair，然後停止猜測。
什麼時候用 Repair，什麼時候用 OCR
- 檢視器完全打不開檔案 → 先試 修復 PDF。
- 檔案能打開，但掃描頁上的文字無法選取或搜尋 → 用 OCR／掃描清理 取得 Markdown 文字；如果體積重要，再另外壓縮（掃描包工作流程）。
- 需要在腳本或 Agent 裡做同樣的修復 → 呼叫修復 PDF API；金鑰與 OpenAPI 見開發者。重試時優先帶上
Idempotency-Key（Idempotency-Key）。
成功是什麼樣子
修復之後，只要殘留的物件夠多，檢視器就應該能打開檔案，不再出現「PDF 已損壞」的錯誤。結構乾淨復原時，取得資訊 給出的頁數應該符合你對原件的預期。如果檔案仍然打不開，再多的壓縮／OCR／轉換也變不出缺失的位元組；此時請停手，並依政策要求把原件留給本目錄以外的鑑識工具。
試一下
在 修復 PDF 上傳損壞的檔案，或帶上 API Key 呼叫 POST /api/v1/misc/repair。任何修復產物的旁邊，都請保留損壞的原件。面向 Agent 的存取方式（MCP、pipeline、OpenAPI）請從開發者起步。