klarkxy 的 DSH 插件

网页搜索

@klarkxy/dsh-web-search-manager
插件 模型与联网 含 Web 界面

在一个设置页管理和排序联网搜索与网页读取（抓取）服务，内置 DuckDuckGo、Exa、Tavily 等，并整合其他插件的搜索源，为模型提供 web_search 与 web_fetch。

安装

 dsh plugin --profile web add @klarkxy/dsh-web-search-manager

这个插件依赖 插件共享库，安装时会自动一起装上。

把 web 换成你在用的 profile。装完重启 profile，插件会出现在「设置 → 插件」里。

说明

以下内容来自 docs/README.zh-CN.md（0.3.4）。

在一个设置页里选择由哪个服务回答模型的网络搜索、设置请求限制，并让模型读取公开网页。搜索服务、网页读取、请求限制各占一个页签。

安装

dsh plugin --profile web add @klarkxy/dsh-web-search-manager

把 web 换成你的 profile 名。重启 DSH Web 后打开「设置 → 网页搜索」。更新插件后同样重启 profile，以加载新版搜索代码。

配置搜索

DuckDuckGo 开箱即用。要用 DeepSeek 搜索、Exa、Brave、博查、Serper、Firecrawl、Tavily、Perplexity 或 You.com，填写对应 API Key。拖拽列表调整顺序：每次搜索使用第一个就绪的服务。其他插件提供的搜索服务（例如知乎）也在同一列表中，手动开启后即可参与排序。

「设置」页签设置结果条数、每次调用的查询数、总超时和网页正文长度上限。

读取网页

打开「网页读取」，选择参与的服务，拖拽或用上下方向键调整优先级。每次读取使用第一个已配置且可用的服务。其他插件接入的读取服务也会出现在列表中，手动开启后加入优先列表；暂时未加载的服务保留原有选择和顺序。

原先选中的读取服务保留在首位。内置「网页读取」走免费的 Jina Reader，失败时改为直接请求一次；宿主或其他插件的服务按各自方式读取。

也可开启 Firecrawl 读取 Markdown 网页，与 Firecrawl 搜索共用 API Key；搜索与网页读取分别计费。Perplexity 使用 Search API 直接返回搜索结果；You.com 直接返回网页与新闻摘要。

让模型使用

在所用 agent.cordis.yml 的插件列表中加入：

- name: '@klarkxy/dsh-web-search-manager/tools'

搜索和网页读取开启时，模型获得 web_search 与 web_fetch 工具。

限制

  • 付费服务可能按次收费，实际账单以服务商账户为准。
  • 内置 Jina Reader 会把网址发送给 Jina，请仅用于不含私密令牌的公开链接。
  • Firecrawl 网页读取要求服务返回网页状态码和最终网址，正文可能来自服务缓存。网址会发送给所选服务。
  • 每次搜索或网页读取仅请求当前排在首位的就绪服务。
  • 取消与超时会请求当前服务停止并等待其完成清理。忽略取消的第三方服务可能延迟结果返回和插件卸载，DSH 进程内的代码通过协作方式停止。

许可证

SATA License 2.1