前言¶

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 插件目录。