dsh-exa-search：DeepSeek Harness 的 Exa 深度網頁搜索插件

前言¶

DeepSeek Harness (DSH) 通過插件機制擴展能力。內置的 web_search 工具適合快速查找，但面對需要詳細來源、標題、鏈接及摘要的檢索需求時，往往顯得單薄。dsh-exa-search 插件通過接入 Exa 搜索 API，提供了更詳細的網頁搜索能力，適合技術調研和學術資料發現。

插件介紹¶

這是一個由 Kev-ZJY 維護的聯網工具插件。它註冊了 exa_search 工具，利用 Exa 的搜索能力，爲模型提供更詳細的網頁檢索結果。該插件不綁定特定模型或 GPU 運行時。

核心功能¶

1. 使用 Exa /search API，支持 auto、fast、instant、deep-lite、deep 和 deep-reasoning 搜索類型。
2. 支持模型傳入 query、numResults 和 type 參數。
3. 對查詢內容、結果數量、響應體大小以及模型可見輸出設置上限。
4. 支持請求取消和超時設置。
5. API 密鑰不會寫入請求日誌，配置項會被標記爲敏感信息。
6. 返回穩定的錯誤代碼，便於日誌分析和上層處理。

安裝與啓用¶

通過以下命令安裝：

# 從 npm 安裝
dsh plugin --profile web add dsh-exa-search

# 從 GitHub 安裝
dsh plugin --profile web add github:Kev-ZJY/dsh-exa-search

# 從本地構建的包安裝
dsh plugin --profile web add ./dsh-exa-search-0.1.0.tgz

配置¶

推薦使用環境變量配置 API 密鑰：

export EXA_API_KEY="你的 Exa API 密鑰"

也可以在 DSH 插件配置中填寫 apiKey。插件配置優先級高於環境變量；密鑰爲空時纔會回退到 EXA_API_KEY。

插件提供以下配置項（可通過 DSH 設置界面或 bundle patch 覆蓋，修改後需重啓對應 profile）：

典型用法¶

模型調用工具時傳入以下參數：

{
  "query": "DeepSeek Harness plugin development requirements",
  "numResults": 8,
  "type": "deep"
}

參數限制：
* query 不能爲空
* numResults 必須是整數，且不能超過 maxNumResults

適用場景與注意¶

• 適用場景：需要深入研究、技術調研或學術資料發現；需要一次檢索更多來源並保留標題、鏈接、作者、日期和摘要。
• 注意事項：
  • 請勿把真實密鑰提交到倉庫、配置補丁或日誌中。
  • 修改配置後需要重啓對應的 DSH profile，確保工具描述中的默認值和限制同步更新。
  • 許可證：MIT

總結¶

dsh-exa-search 補強了 DSH 的聯網能力，適合對搜索深度和結果質量有要求的場景。更多詳情可參考 DSH 插件目錄 或 GitHub 倉庫。