前言¶

DeepSeek Harness（DSH）可以通过插件扩展工具能力。对于联网场景，开发者可能需要多搜索源自动回退、无密钥兜底，以及把网页正文提取为可读文本。haibinwang9/dsh-web-search 就是用于补齐这类联网能力的插件。下面介绍它的功能、安装、配置和注意事项。

这是什么¶

dsh-web-search 由 haibinwang9 维护，许可证为 MIT。它围绕 DSH 的联网能力提供两件事：

• 搜索：驱动内置 web_search 工具，按 SearXNG → Tavily → Brave → DuckDuckGo 顺序回退。
• 抓取：提供 get_search_content 工具，用于抓取 URL 并提取可读正文。

插件还会补齐 fetch seam，注册搜索和抓取两个 provider，使内置 web_fetch 恢复可用。

核心功能¶

多引擎搜索自动回退¶

在插件回退链中，已配置的搜索引擎按顺序使用，未配置的搜索引擎会自动跳过。若没有配置 SearXNG、Tavily、Brave，DuckDuckGo 可以作为零配置兜底。

URL 正文提取¶

get_search_content 用于抓取指定 URL，并将网页内容转换为可读纯文本。经过上面的配置后，可以先用 web_search 找到页面，再用 get_search_content 读取正文。

设置页切换默认搜索引擎¶

设置页提供默认搜索引擎开关：

• 开启：使用 dsh-web-search 的回退链。
• 关闭：委托官方 DeepSeek 搜索。

补齐 fetch seam¶

插件注册搜索 provider 和抓取 provider。这样，内置 web_fetch 可以恢复可用。

配置集中到设置页¶

SearXNG、Tavily、Brave 的密钥可以写入 credentials 服务。取值优先级为：环境变量优先，其次为 harness credentials 服务；也可以写入 ~/.dsh/.credentials.yaml。

安装与启用¶

版本与依赖¶

package.json 中声明版本为 0.1.2，运行环境要求 node >=20。peerDependencies 要求：

@deepseek-ai/dsh-tools ^0.1.0-rc.6
@deepseek-ai/dsh-credentials ^0.1.0-rc.6
@deepseek-ai/dsh-web-search-deepseek ^0.1.0-rc.6

先确认当前 DSH 环境满足上述 peer 依赖，再执行安装。

安装命令¶

使用插件安装命令：

dsh plugin --profile web add dsh-web-search

如果从源码安装，先获取仓库，再安装本地目录：

git clone https://github.com/haibinwang9/dsh-web-search.git
cd dsh-web-search && dsh plugin --profile web add .

启用配置¶

安装后重启 DSH，然后进入：

设置 → 插件 → Web access

在设置页配置开关和密钥。相关配置项包括：

PIWA_SEARCH_ENABLED
SEARXNG_BASE_URL
TAVILY_API_KEY
BRAVE_API_KEY

其中 PIWA_SEARCH_ENABLED 控制是否使用插件回退链；其余三项分别对应 SearXNG、Tavily、Brave 的地址或密钥。

典型用法¶

下面是一条基本使用路径：

1、执行安装命令，安装 dsh-web-search。
2、重启 DSH。
3、在 设置 → 插件 → Web access 中开启 PIWA_SEARCH_ENABLED。
4、按需填写 SEARXNG_BASE_URL、TAVILY_API_KEY、BRAVE_API_KEY；未填写的引擎会自动跳过。
5、在 DSH 中使用 web_search 进行搜索，需要读取具体页面时使用 get_search_content。

适用场景与注意¶

适合以下场景：

• 需要多个搜索引擎自动回退。
• 希望在没有配置密钥时仍有 DuckDuckGo 兜底。
• 需要把 URL 正文提取为可读文本，供后续阅读或处理。

注意：

• 插件以当前 DSH 进程权限运行。安装前建议检查源码、许可证和依赖关系。
• 搜索引擎密钥会用于网络访问，配置前确认来源和权限范围。
• 许可证为 MIT。搜索与正文提取逻辑改编自 nicobailon/pi-web-access（MIT）。
• package.json 版本为 0.1.2；如 DSH 侧 peer 依赖不满足，应先确认环境版本。

获取信息¶

• GitHub：https://github.com/haibinwang9/dsh-web-search
• 目录页：https://www.skillhub.cn/plugins/haibinwang9/dsh-web-search