在 DeepSeek Harness (DSH) 中構建本地智能體或進行模型推理時，經常會遇到需要 AI 閱讀私有文獻的場景。手動上傳 PDF 既繁瑣，又難以進行全文檢索。
下面介紹 dsh-zotero 插件，它通過連接本機 Zotero，對整個文庫中的 PDF 全文建立索引，從而在 DSH 的側邊欄面板或對話中直接檢索並閱讀文獻。
插件簡介¶
dsh-zotero 是一個連接 Zotero 7 的 DSH 插件。它利用 Zotero 自帶的索引能力或直接解析 PDF 文本層，建立文獻全文索引。用戶既可以在側邊欄面板中進行檢索，也可以在對話中直接提問讓 AI 查閱文獻。
- 維護者：H-xie
- 類別：模型推理
- 許可證：MIT
核心功能¶
- 全文索引：優先使用 Zotero 自帶的全文索引；若無索引，則直接讀取 PDF 並解析文本層。純圖片（掃描件）無法解析，但不會影響其他文獻。
- 面板檢索：在 DSH 側邊欄新增「Zotero 文獻」面板。支持配置連接、建立索引、限定分類檢索以及逐塊閱讀全文。
- 對話檢索：在對話中直接提問，AI 會自動調用檢索工具查詢文獻並閱讀相關段落。提及分類名時，會自動限定檢索範圍。
安裝與啓用¶
前置條件¶
在安裝插件前，請確保滿足以下條件：
- 運行 Zotero 7（或更高版本）。
- 開啓本地 API：在 Zotero 中依次點擊
編輯→設置→高級，勾選允許其他應用與 Zotero 通信。
安裝步驟¶
插件以目錄鏈接方式安裝，因此需要先克隆代碼並安裝依賴。
git clone https://github.com/<你的用戶名>/dsh-zotero.git
cd dsh-zotero
npm install # 安裝 PDF 解析依賴（必做）
安裝完成後，在 DSH 界面中：
- 進入「插件」頁面。
- 點擊「安裝插件 / Install bundle」。
- 選擇剛纔解壓的
dsh-zotero文件夾。 - 啓用插件並刷新頁面，左側欄將出現「Zotero 文獻」圖標。
注意：DSH 以目錄鏈接方式安裝插件，不會自動處理插件的 npm 依賴，因此必須手動運行一次
npm install（或pnpm install）。
典型用法¶
- 連接設置：打開左側欄「Zotero 文獻」面板，在「1. 連接設置」中填寫本地服務地址（默認
http://localhost:23119/api），點擊「測試連接」確認成功後點擊「保存設置」。 - 建立索引：在「2. 全文索引」區域點擊「建立 / 更新索引」，等待索引完成（首次可能需要幾分鐘）。
- 面板檢索：在「3. 全文檢索」中輸入關鍵詞，可選擇性填寫「限定分類」（支持子分類），點擊「閱讀全文」逐塊閱讀。
- 對話檢索：直接在對話中說「檢索我的 Zotero 文獻中關於 XXX 的文章」，AI 會自動檢索。如果提及分類名（如「檢索我的 Zotero 文獻中關於 XXX 的文章，限定分類爲 CSS」），檢索範圍會自動限定。
注意事項¶
- 依賴安裝：必須先運行
npm install，否則插件無法正常工作。 - Zotero 版本：建議使用 Zotero 7 或更高版本。
- API 開關：必須確保在 Zotero 設置中勾選了允許其他應用通信。
- 掃描件限制：純圖片格式的文獻（掃描件）無法解析，需要先在 Zotero 中進行 OCR 識別後再更新索引。
- 存儲位置：文獻索引與設置保存在
~/.dsh-zotero/目錄下，更換電腦或端口時需重新配置地址。
結語¶
dsh-zotero 通過將本地 Zotero 庫與 DSH 的 RAG 能力結合，解決了私有文獻快速檢索與閱讀的問題。安裝簡單，檢索精準，適合需要在本地環境中處理大量文獻的開發者。
