前言¶
DeepSeek Harness（DSH）在聊天裏通過 web_search 完成聯網檢索。若你希望改用 xAI Grok 作爲主搜索，並在 Grok 或單一供應商不可用時自動嘗試 Tavily、Exa 等補充來源，通常需要單獨維護 MCP 後端與配置文件。dsh-grok-search 把 grok-search-rs 接到 DSH 插件體系裏：仍在原聊天裏搜索，不必再裝第二個搜索插件，也不必手改 cordis.patch.yml。
下面介紹該插件的定位、能力、安裝步驟與使用注意。事實以 GitHub 倉庫 README 與 Releases 爲準。
這是什麼¶
dsh-grok-search 由 Lain-in-coding 維護，歸類爲聯網工具，當前插件版本 0.1.1（MIT 許可證）。它以 Episkey-G 開發的 grok-search-rs 爲 MCP 核心後端，爲 DSH 原有的 web_search 提供 Grok 主搜索與 補充來源自動回退。
文中 grok-search-rs 指本機運行的 MCP 搜索後端程序；Grok 主搜索指使用 xAI Grok 模型的搜索服務，兩者不是同一概念。插件已驗證的 grok-search-rs 程序版本爲 0.1.26（指程序版本，不是 Grok 模型版本）。
核心功能¶
搜索路由與回退¶
- 按你在界面裏設定的順序嘗試備用來源；也可關閉 Grok 主搜索，僅使用 Tavily、Exa、TinyFish、Firecrawl 等補充來源。
- Grok 主搜索失敗但補充來源有結果時，界面會顯示「已靜默回退」。關閉 Grok 時，從排列好的補充來源依次嘗試；拿到第一份有效結果即停止，不會在正常搜索裏爲「測完」而調用全部供應商。
- 全部候選失敗或總預算耗盡時會明確報錯，不會自動回到 DeepSeek 官方搜索。
可視化配置¶
插件詳情頁提供「搜索路由」卡片：DSH 與 grok-search-rs 程序節點橫向相連，各搜索來源縱向排列。點擊 Grok Search RS 中間節點或任一來源即可配置。
| 來源 | 用途 | 可配置內容（摘要） |
|---|---|---|
| Grok | xAI Grok 主搜索 | 接口協議、Base URL、API Key、模型、網頁/X 搜索 |
| Tavily | 補充搜索 | Base URL、多個 API Key |
| Exa、Firecrawl | 補充搜索 | Base URL、API Key |
| TinyFish | 補充搜索 | 搜索與抓取 Base URL、API Key |
| GitHub | 鏈接解析與認證檢測 | Token；不參與補充搜索排序 |
補充來源可拖動排序（或聚焦後 Alt+↑/↓）。「補充來源數」「回退來源數」指結果條數，不是啓用的供應商數量。
程序與共享配置¶
- 自動發現本機已有 grok-search-rs 與配置；若無程序，可下載經驗證版本到插件緩存，無需手填路徑。
- 直接讀寫與 grok-search-rs 同一份共享配置，已有 Key 與順序不必重填。
- 用 DSH 插件開關接管或恢復原有搜索；宿主開啓熱重載時一般無需重啓。
測試搜索¶
「測試搜索 → 開始測試」會逐個檢查全部已開啓的來源和 Tavily 的每個 Key，不會因某一來源成功而跳過其餘項。GitHub 單獨檢測認證或匿名訪問。測試與搜索可能消耗供應商額度；grok-search-rs 執行 Grok 主搜索時可能預取補充來源，取消操作也不保證撤回已發出的請求。
支持範圍¶
| 系統 | 入口 | 本版本兼容 DSH |
|---|---|---|
| Windows x64 | Desktop | 0.2.1-rc.2 ～ 0.2.1-rc.5 |
| macOS Apple Silicon | Desktop | 同上 |
| Linux x64（WSL Ubuntu 22.04） | CLI/Web | 同上 |
所有組合共用一個安裝包。Windows/macOS 的獨立 CLI/Web 不在本次支持範圍；原生 Linux（非 WSL）完整安裝鏈路驗證有限。Node 要求 >=22.0.0。作者已在 Windows 上用真實 Key 實測 Grok 主搜索；macOS 與 Linux 尚未做真實付費接口驗收。升級前可覈對倉庫中的 support-matrix.json。
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前應自行查看源碼與 MIT 許可證，並理解聯網 Key 的費用歸屬（Grok API 或兼容網關費用另計，不能等同於聊天訂閱或網頁免費使用）。
方式一：在 DSH 中按名稱安裝¶
- 打開 DeepSeek Harness，進入左側 「插件」。
- 點擊 「添加插件」，在 「包名或地址」 輸入：
dsh-grok-search
- 確認拼寫，閱讀來源提示，點擊 「安裝」，等待 「已安裝」。
方式二：Release 壓縮包本地導入¶
- 在 GitHub Releases 下載
dsh-grok-search-<版本>.tgz（不要下載 Source code 歸檔）。 - 解壓後進入內層
package目錄（需能看到package.json、cordis.patch.yml、src）。 - 在 「包名或地址」 填寫
file:加該目錄絕對路徑，例如：
file:C:\DSH-Plugins\dsh-grok-search\package
目錄前的 file: 不要省略，否則可能缺少依賴導致插件無法加載。也可直接填寫已下載 .tgz 的絕對路徑。
CLI/Web¶
在 CLI/Web 環境可執行：
dsh plugin --profile web add dsh-grok-search
下載 grok-search-rs 與調用搜索服務仍需聯網；鏡像未同步時可改選 npm 官方源或使用 Release 本地導入。
首次配置¶
- 「立即啓用」 或打開插件開關，進入詳情，確認「搜索路由」卡片與 grok-search-rs 運行中。
- 只用補充來源： 關閉 Grok 主搜索，爲 Tavily、Exa 等填寫 Key 並開啓，可拖動排序。
- 使用 Grok 主搜索： 點擊 Grok 行填寫 API Key；兼容網關時按服務商填寫協議、地址、Key 與模型。
- 「測試搜索 → 開始測試」 確認連通性後，在 DSH 聊天中直接提需要聯網的問題。
不必爲每個來源都準備 Key；開啓 Grok 時也可保留補充來源作備用。
典型用法¶
日常用法即：安裝並啓用插件 → 在路由界面配置至少一個來源 → 測試通過後照常聊天。需要調整策略時：
- 將 Exa 拖到 Tavily 前並關閉 Grok 主搜索（非關閉整個插件），補充來源會按新順序接管。
- 某來源額度用盡時，在剩餘請求預算內由下一來源完成搜索；Tavily 支持多 Key，特定錯誤時會嘗試同來源下一把 Key。
適用場景與注意¶
適合： 已在用 DSH 0.2.1-rc.2～rc.5，希望用 Grok 或多供應商回退增強 web_search，且願意在插件 UI 裏管理 Key 與順序的開發者。
注意：
- 插件與 grok-search-rs 優先複用兼容的已有程序，不升級全局安裝，也不自動採用未經驗證的新版 grok-search-rs。
- 社區目錄 SkillHub 插件頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；安裝源以 DSH 內提示與 npm / Release 爲準。
- 表外平臺、入口與新版本 DSH 不作兼容承諾；Desktop 與 CLI/Web 是不同入口，請按自己的環境對照支持矩陣。
結尾¶
dsh-grok-search 把 grok-search-rs 的多來源搜索與靜默回退收進 DSH 插件詳情頁：一個包名安裝、一份共享配置、插件開關即可接管或恢復原有網頁搜索。進一步瞭解界面與 FAQ 見倉庫 README。
- 目錄頁：https://www.skillhub.cn/plugins/Lain-in-coding/dsh-grok-search
- GitHub：https://github.com/Lain-in-coding/dsh-grok-search
