前言¶

DeepSeek Harness（DSH）内置 web_search、web_fetch 工具，实际检索与抓取由 ctx.web 上的 provider 完成。默认的 web-search-deepseek 依赖上游实现 Anthropic 的 web_search_20250305 服务端搜索工具，并返回 web_search_tool_result 块。

9router 是 OpenAI 兼容网关：它把该工具定义以普通 function 形式交给模型，而不是在服务端执行搜索，因此无法单独提供与默认 provider 相同形态的「原生搜索」。若你在 DSH 里把模型路由到 9router，仍希望 Agent 能联网搜索、抓取页面，就需要把 DSH 的 web 能力接到 9router 自带的 /v1/search 与 /v1/web/fetch。

下面介绍社区插件 dsh-web-search-9router（维护者 rebron1900，仓库 rebron1900/dsh-web-search-9router）。它在 DSH 的 web seam 上注册 provider 9router，直接调用上述端点，并把响应映射为 DSH 期望的 WebSource 与 WebFetchBody 类型。

这是什么¶

dsh-web-search-9router 是面向 DSH >=0.2.0-rc.2 的 ESM 插件（当前发布版本 0.2.4，MIT 许可证）。它不引入额外构建步骤，纯 JavaScript 实现。

数据流可以概括为：

 web_search / web_fetch (DSH 原生工具)
            │
            ▼
        ctx.web seam
            │  provider = "9router"
            ▼
  dsh-web-search-9router
   ├── search  → POST {baseURL}/search      → WebSource[]
   └── fetch   → POST {baseURL}/web/fetch   → WebFetchBody
            │
            ▼
      9router 网关

与默认方案的对比如下（依据仓库 README）：

核心功能¶

搜索 provider¶

DSH 调用原生 web_search 时，插件向 9router 的 search 端点发起请求，返回经去重处理的 WebSource 列表（含 title、snippet、published date 等字段）。

抓取 provider¶

web_fetch 经插件转发到 9router 的 web fetch 端点，返回整理后的文本或 markdown 正文（WebFetchBody）。

配置与凭据¶

插件在 bundle 详情页提供表单：可配置 base URL、搜索/抓取模型名、结果上限、超时等。API Key 通过 DSH credentials 服务写入，默认凭据引用为 NINE_ROUTER_API_KEY；密钥不会写入插件 settings 明文配置。

错误行为¶

失败以可路由的 WebError 码暴露（如 WEB_PROVIDER_ERROR、WEB_PROVIDER_CREDENTIAL_MISSING、WEB_ABORTED）。fetch 的非 2xx 响应作为结果返回，而不是静默抛错。

环境要求¶

• DSH：>=0.2.0-rc.2
• Node.js：>=20

安装与启用¶

1、安装插件¶

在 README 给出的命令中，profile 为 web：

npx @deepseek-ai/dsh plugin --profile web add github:rebron1900/dsh-web-search-9router

若需固定版本，可在 GitHub 源后追加 release 标签，例如：

npx @deepseek-ai/dsh plugin --profile web add github:rebron1900/dsh-web-search-9router#v0.2.4

2、启用 bundle¶

安装并启用 bundle 后，search 与 fetch 会自动选用 provider 9router。在 Plugins 中关闭整个 bundle 时，会恢复由其余配置层选择的 provider（通常为 deepseek-official 与 http）。

若你曾在 profile、home 配置或 launch 覆盖里显式指定过 web provider，更高优先级的选择仍会生效。要让 bundle 启用主导 provider，需移除旧的 id: web provider 配置覆盖。

3、填写配置¶

重启 DSH 并刷新浏览器。打开 Plugins，进入 dsh-web-search-9router 的 bundle 详情页完成配置。填写 API Key 时，内容存入 DSH credentials，对应你选择的 credential reference。

配置项说明¶

典型用法¶

启用并配置完成后，无需在 Agent 侧单独调用插件 API：DSH 会话里使用内置 web_search、web_fetch 即可，底层由 provider 9router 转发到网关。

开发仓库中，维护者用以下命令跑测试（供二次开发参考，非终端用户必做步骤）：

pnpm install
pnpm test

入口与布局见仓库：src/index.js（search + fetch providers）、client.js（bundle 设置表单）、cordis.patch.yml（bundle 注册）。

适用场景与注意¶

适合谁： 已在 DSH 中使用或计划使用 9router 作为 OpenAI 兼容网关，且希望保留 DSH 原生联网工具语义、又不想依赖 web-search-deepseek 所要求的服务端 Anthropic 搜索工具实现。

分发与版本： GitHub 仓库为唯一分发源；稳定版以 v<version> 形式的 GitHub Releases 发布。插件也收录于社区列表 awesome-dsh-plugin。SkillHub 等目录页为社区索引，与 DeepSeek / 幻方无官方从属关系。

安全： 插件在当前 DSH 进程权限下运行，会向配置的 9router 端点发送搜索与抓取请求。安装前请阅读源码与 MIT 许可证，确认 base URL、凭据引用与网络策略符合你的环境。

结尾¶

dsh-web-search-9router 把 DSH 的 web_search、web_fetch 接到 9router 的 /v1/search 与 /v1/web/fetch，填补「网关不执行默认 deepseek 搜索工具、但仍需联网」这一组合下的能力缺口。

• 目录页：skillhub.cn/plugins/rebron1900/dsh-web-search-9router
• 源码与文档：github.com/rebron1900/dsh-web-search-9router