前言¶

DeepSeek Harness (DSH) 提供了 ctx.web 接口，用於在智能體中實現聯網能力。開發者在使用 DSH 時，通常需要將 web.searchProvider 切換到具體的搜索後端。dsh-web-search-serper 是一個基於 Serper.dev API 的搜索提供程序插件，它解決了將 DSH 默認搜索能力替換爲 Google 搜索索引的問題。

插件介紹¶

該插件由 Dingpenghui-good 維護，屬於 DSH 生態中的“聯網工具”類別。它的核心作用是爲 DSH 的 Web 能力接縫提供一個名爲 serper 的搜索提供程序。通過該插件，開發者可以在 DSH 配置中指定使用 Serper 進行搜索，從而獲得更結構化、更快速的搜索結果。

核心功能¶

• 快速搜索：利用 Google 的真實索引，響應時間通常在 1-2 秒。
• 結構化結果：返回 JSON 格式數據，便於解析和處理。
• 隱私友好：不進行用戶追蹤，也不收集 Cookie。
• 慷慨免費層級：每月提供 2,500 次免費查詢額度，無需信用卡。
• 全球多語言：支持來自全球各地區/國家的搜索結果。
• 開箱即用：作爲 Bundle 安裝時，會自動接管 web.searchProvider。
• 自動回退：當 Serper 不可用時，插件內部會將請求轉交給另一個可用的搜索提供程序，而不是直接報錯。

安裝與啓用¶

使用 DSH 的插件管理工具安裝該插件：

dsh plugin --profile web add @dingpenghui/dsh-web-search-serper

配置說明¶

作爲 Bundle 安裝（推薦）：如果通過上述命令安裝爲 Bundle，插件自帶的 cordis.patch.yml 會自動生效，無需手動配置即可接管 web.searchProvider。

手動配置：如果不使用 Bundle 機制，需手動將插件配置注入到 cordis.patch.yml 中。需要同時添加接管配置和插件聲明：

- id: web
  name: '@deepseek-ai/dsh-web'
  config:
    searchProvider: serper     # 覆蓋 dsh-base 的默認 provider
    fetchProvider: http
- insert:
    - id: web-search-serper
      name: '@dingpenghui/dsh-web-search-serper'

API Key 的解析順序爲：配置中的 apiKey -> 環境變量 SERPER_API_KEY -> 憑據存儲中的引用 SERPER_API_KEY。配置項（如 gl、cr、numResults）可以按需添加。

典型用法¶

安裝並配置完成後，直接使用 DSH 的 Web 接口進行搜索：

// 使用 ctx.web.search 調用 Serper 後端
const result = await ctx.web.search({
  query: 'latest AI developments 2026',
  maxResults: 5,
})

// 結果爲結構化數據
console.log(result.sources)
// [
//   { url: '...', title: '...', snippet: '...' },
//   ...
// ]

注意事項與適用場景¶

• 僅限 Google 搜索：該插件僅支持 Google 搜索，不支持 Bing、Baidu 或其他搜索引擎。
• 無生成答案：插件僅返回原始搜索結果，不提供 AI 生成的摘要或答案。
• 免費層級限制：免費層級每月限制 2,500 次查詢，超出後需使用付費計劃。
• 手動配置要求：如果不作爲 Bundle 安裝，必須手動進行配置補丁，否則插件不會生效。
• 回退機制：DSH 網絡接縫本身不具備回退邏輯，回退由該插件內部處理。
• 權限與許可：安裝前請檢查源碼與許可證（MIT）。該插件在 DSH 進程權限下運行。

結語¶

dsh-web-search-serper 爲 DSH 提供了一個穩定且結構化的 Google 搜索後端。它通過自動接管和內部回退機制，降低了集成難度。如需瞭解更多詳情或查看源碼，可訪問其 GitHub 倉庫或 SkillHub 插件目錄。