DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在構建 AI 智能體時，讓模型直接讀取本地 PDF 文件通常需要編寫額外的解析腳本或調用外部服務。xby-read-pdf 作爲一個 DSH 插件，旨在提供一套標準化的 PDF 處理接口，讓模型能夠直接在 DSH 環境中完成對 PDF 文件的解析、元數據獲取和關鍵詞檢索。
插件定位¶
這是一個由 xby-skill 維護的 MCP 服務器插件，歸類於模型推理。它是一個支持 AI 助手讀取和分析 PDF 文件的工具，主要解決模型無法直接理解本地 PDF 格式文檔的問題。
核心功能¶
該插件提供以下核心能力：
- set_xby_apikey：在對話中設置 API 密鑰，該設置會自動持久化，重啓進程後依然有效。
- read_pdf：讀取並提取 PDF 文件的全文內容，同時返回元數據。
- read_pdf_page：讀取 PDF 的特定頁面或頁碼範圍的內容。
- get_pdf_metadata：獲取 PDF 文件的元數據信息，而不需要讀取全部內容。
- search_pdf：在 PDF 文件中搜索特定的文本關鍵詞。
安裝與啓用¶
安裝時必須指定 --profile web 參數。使用官方提供的 GitHub 安裝命令即可完成部署：
dsh plugin --profile web add github:xby_skill/xby-read-pdf
安裝完成後，需在對話中調用 set_xby_apikey 設置 API 密鑰才能使用相關功能。
典型用法¶
- 全文提取與分析：讓模型讀取並分析一份完整的 PDF 文檔，提取摘要或關鍵信息。
- 局部閱讀：僅提取 PDF 的第 3 頁到第 5 頁內容，用於快速瀏覽特定章節。
- 元數據獲取：在不消耗大量 Token 的情況下獲取 PDF 的作者、創建日期等元數據。
- 關鍵詞檢索：在文檔中快速定位包含特定關鍵詞的段落。
注意事項¶
- 前置條件：使用該插件前，必須通過
set_xby_apikey設置 API 密鑰。 - 權限與安全：該插件以當前 DSH 進程的權限運行。安裝前建議檢查源碼邏輯與許可證（MIT）。
- 生態說明：此插件來自社區目錄，與 DeepSeek 或幻方沒有官方從屬關係。
通過集成 xby-read-pdf，可以在 DSH 生態中快速構建具備文檔分析能力的智能體。更多細節可查閱項目主頁：xby-skill/xby-read-pdf
