前言¶

在 DSH 里做智能体工作流时，网页搜索通常要挂到具体提供方。如果你的搜索后端想走 OpenAI Responses API 的服务端检索，又不想改 dsh 源码，下面介绍一个 DSH 插件：flg1217/dsh-web-search-openai。

这是什么¶

dsh-web-search-openai 是 flg1217 维护的一个 DSH 插件，用于给 dsh 的 ctx.web 注册一个由 OpenAI Responses API 驱动的 web_search 提供方。它把 OpenAI Responses API 的 web_search 工具接入 DSH 网页搜索通道，提供搜索和可引用来源；许可证为 MIT。

核心功能¶

先列已核实的几项能力：

• 向 ctx.web 注册 OpenAI Responses API 驱动的搜索提供方。
• 服务端检索：每次搜索调用 POST /responses，携带原生 web_search 工具。
• 可引用来源：web_search_call.search_results[] 结构化结果，或消息级 url_citation 注解兜底，统一归一化为可引用来源。
• Web 设置卡片：可配置端点、模型、API Key、最大输出 tokens、检索上下文；API Key 只写不回显。
• 热插拔装配：通过 profile bundle patch、registerSearchProvider 和客户端 slot 接入，不修改 dsh 源码。

安装与启用¶

先确认版本要求：

dsh >= 0.1.0-rc.6

仓库已提交 lib/，无需本地构建。按下面命令把插件装配进 web profile：

dsh plugin --profile web add <本仓库目录>

装配完成后，重启 dsh web，bundle 层才会加载插件。

典型用法¶

启用后，先准备配置，再切换提供方。

1. 打开 dsh Web 设置，进入 搜索 下的 Web 搜索 卡片。
2. 填写端点、模型、API Key；也可以不填 API Key，让插件读取环境变量 OPENAI_API_KEY。
3. 把 web 通道的 searchProvider 切到 openai。可以在 profile 的 cordis.patch.yml 里设置 web.searchProvider，也可以在设置面板切换。

默认值如下：

经过上面的步骤，dsh 的网页搜索就可以走 OpenAI Responses API 的 web_search 工具，并把返回来源归一化为可引用来源。

适用场景与注意¶

适合在 DSH 插件化搜索链路中，希望把某个 web 通道的搜索后端切到 OpenAI Responses API 的开发者。

使用注意：

• 该插件以当前 dsh 进程权限运行。安装前建议检查源码和许可证。
• API Key 在设置卡片里只写不回显。
• 如果设置卡片保存失败，检查端点可达性和 API Key 有效性。
• 如果搜索报 WEB_PROVIDER_ERROR，表示 OpenAI 网关返回非 2xx。
• 如果设置卡片不出现，确认 bundle 层已加载，并重启 dsh web。

结尾¶

dsh-web-search-openai 的价值很具体：不改 dsh 源码，给 DSH 网页搜索加一个可配置的 OpenAI Responses API web_search 提供方，并处理来源引用和设置卡片。目录页和源码入口如下：

• 社区目录：https://www.skillhub.cn/plugins/flg1217/dsh-web-search-openai
• GitHub：https://github.com/flg1217/dsh-web-search-openai