kreuzberg

kreuzberg 技能總覽

kreuzberg 的用途

kreuzberg skill 可協助你用 Kreuzberg 從 91 種以上的文件格式中擷取文字、表格、後設資料、圖片，以及由 OCR 支援的內容，並原生支援 Python、Node.js/TypeScript、Rust 與 CLI。它特別適合需要可靠文件處理程式碼的人，而不只是丟一段提示詞、讓模型猜怎麼解析。

誰適合安裝

如果你的工作是把 PDF、Office 檔、圖片、HTML、電子郵件、壓縮檔，或學術文件轉成結構化輸出，就很適合安裝 kreuzberg，尤其是在你很在意掃描品質、批次執行，或語言特定的 OCR 時。它很適合用在資料匯入流程、文件搜尋、RAG 前處理，以及擷取工具鏈。

為什麼它不一樣

kreuzberg skill 的主要價值在於它是以實作為導向：涵蓋安裝路徑、擷取模式、設定、批次處理、錯誤處理，以及跨多種 runtime 的外掛。當你需要的是能實際執行的程式碼，而不是一個籠統的「幫我分析這份文件」提示詞時，它會比一般做法更有用。

如何使用 kreuzberg skill

先安裝並確認目標 runtime

若要快速完成 kreuzberg install，請從你實際要交付的 runtime 開始：

pip install kreuzberg
npm install @kreuzberg/node
cargo install kreuzberg-cli

接著先讀對應的 API 參考文件：references/python-api.md、references/nodejs-api.md，或 references/rust-api.md。如果你用的是 CLI，則先看 references/cli-reference.md。這個 skill 最有效的方式，是先選定一個 runtime 和一種文件類型，而不是一開始就要求包山包海。

把粗略需求改寫成可用提示

一個好的 kreuzberg usage 提示詞，會明確寫出檔案類型、擷取目標、runtime 與限制。比如說：「用 Python 的 kreuzberg 擷取掃描版 PDF 的發票文字、表格與 OCR 內容，保留換行，並回傳可供下游解析的 JSON。」這比「擷取 PDF 資料」更好，因為它能告訴 skill 要優先優化表格、OCR，還是乾淨文字。

先讀這些檔案

要做實際的 kreuzberg guide 工作，建議依序閱讀：SKILL.md、references/configuration.md、對應 runtime 的 API 檔，以及 references/supported-formats.md。若你需要外掛、OCR 調校或批次行為，再打開 references/advanced-features.md。這個順序能先浮現最影響採用的決策：安裝方式、支援的輸入，以及設定預設值。

依照你的工作型態選流程

如果你只處理單一檔案，可以先用簡單的 extract_file 或 CLI extract，只有在輸出不對時才再加 MIME 提示或設定。如果你要處理很多檔案，就應該提早確認批次輔助工具與錯誤處理。對於 kreuzberg for PDF Processing 而言，OCR 設定與輸出格式通常比基本擷取呼叫更重要，所以在擴大規模前，先驗證這兩項。

kreuzberg skill 常見問題

kreuzberg 只能用來處理 PDF 嗎？

不是。PDF 當然是主要使用情境之一，但這個 skill 也涵蓋 Office 文件、圖片、HTML、電子郵件、壓縮檔，以及學術格式。如果你的工作負載是混合格式匯入，kreuzberg 會比只支援 PDF 的工具更合適。

使用這個 skill 前一定要先懂 library 嗎？

不用，但你需要知道目標 runtime 和輸出目標。只要你能描述文件類型、是否需要 OCR，以及你要的是純文字、markdown、JSON，還是結構化後設資料，kreuzberg skill 就算對初學者也算友善。

什麼情況下不適合用 kreuzberg？

如果你的任務主要是語意摘要而不是擷取，或你只需要針對單一文件做一次性的人工提示、且不需要程式碼輸出，那就可以跳過 kreuzberg。如果你的流程不需要 OCR、表格，或多格式支援，它也可能太重。

它跟一般提示詞有什麼不同？

一般提示詞可以描述任務，但 kreuzberg usage 重點在於取得正確的安裝方式、API 呼叫、設定，以及文件擷取時的錯誤處理。當輸出品質取決於 runtime 設定、OCR 後端選擇，或批次處理細節時，它就會更有優勢。

如何改進 kreuzberg skill

先把輸入形態說清楚

最好的 kreuzberg skill 結果，通常來自明確指定檔案類型、來源品質與目標輸出。請加入像「掃描版 PDF」、「數位 PDF」、「發票表格」、「電子郵件附件」或「保留標題」這類細節。這些資訊會直接影響預設應該用 OCR、分段處理，還是直接擷取純文字。

指出你想避免的失敗模式

如果第一次輸出不理想，直接告訴 skill 哪裡出問題：表格不見了、換行被打亂、OCR 太慢、語言偵測錯誤，或圖片雜訊太多。對 kreuzberg for PDF Processing 來說，這能幫助縮小是要調整 OCR 後端、設定，還是輸出格式，而不是整個流程重寫。

用具體範例反覆調整

更有效的改進方式，是貼上一個失敗的檔案描述，再加上一個目標結果，例如：「這份掃描版發票應該輸出發票號碼、總金額、供應商和明細列，格式為 JSON。」這比單純說「請提高準確度」更有用，因為 skill 可以依照實際 schema 與文件類型來調整擷取建議。

先從小範圍開始，再逐步擴充

先從一個 runtime、一種格式、以及一種擷取模式開始。等基礎的 kreuzberg install 和擷取流程都能正常運作後，再加入批次處理、外掛，或進階設定。這樣可以減少混亂，也更容易判斷問題到底出在安裝、OCR，還是下游解析。