前言¶

在 DeepSeek Harness（DSH）里做带联网能力的智能体时，web profile 需要一条明确的搜索后端：要么走订阅里各模型自带的搜索工具，要么走与 OpenAI Responses API 兼容的网关。若网关地址、凭据和模型名分散在环境变量或脚本里，换环境或换模型时容易对不上。下面介绍社区插件 dsh-openai-responses-web-search（维护者 vb2250158，分类：模型推理），它把 Responses 类服务的 baseURL、API Key 环境变量名和模型 ID 收进 profile 配置，并与 DSH 0.2 的 model-native 搜索路由配合使用。

这是什么¶

dsh-openai-responses-web-search 是可配置的 OpenAI Responses API 提供者，供 DSH 的联网搜索（web search）使用。插件通过兼容 OpenAI Responses API 的服务为 DSH 提供联网搜索能力。

列表展示名随 DSH 界面语言切换：英文 Responses web search，中文 Responses 联网搜索（见仓库 locale/en.json、locale/zh.json）。当前 npm 包版本为 0.1.5，许可证 MIT。GitHub 星标为 0（以目录页信息为准）。

本 release 要求 DSH 0.2.1-alpha.1 或兼容的 0.2 系列；细节见仓库文档 docs/dsh-0.2-compatibility.md。

核心功能¶

Responses 后端¶

在 profile 中为插件 id openai-responses-web-search 配置：

• baseURL：Responses 兼容服务的根地址（示例中为 https://api.example.test/v1）
• apiKeyEnv：读取 API Key 的环境变量名（示例为 OPENAI_API_KEY）
• model：请求使用的模型 ID

上述字段写在私有 profile 配置中；公开 README 与示例不包含真实地址或凭据。

与 web profile 的 searchProvider 配合¶

在 id 为 web 的配置块里设置 searchProvider：

• model-native（README 中的推荐用法）：按当前发起工具调用的会话选择服务。对 codex、grok、claude 路由，使用 Subscriptions 0.7.16 提供的原生搜索，采用当前模型 ID 与对应订阅登录；其他路由、或未关联会话的调用，则使用上面明确配置的 Responses 服务。
• openai-responses：固定走 Responses 后端，不走路由原生搜索。

可选 nativeProviders 指定哪些订阅路由参与原生搜索，默认三者（codex、grok、claude）均启用。缺少原生服务或未登录时会明确失败，不会自动回退到网关。

HTTP 错误会保留服务地址与状态码；502 时 README 提示检查搜索网关的上游连通性及是否支持 web_search。Grok、Claude 原生协议分别可参考 xAI Web Search 与 Claude Web Search。

安装与启用¶

锁定公开仓库的提交后，通过 DSH 官方入口安装（命令来自仓库 README，请将 <commit> 替换为实际提交哈希）：

pnpm dsh plugin --profile web add github:vb2250158/dsh-openai-responses-web-search#<commit>

安装前建议阅读仓库源码与 LICENSE，确认插件将以当前 dsh 进程权限 运行，且配置中的 apiKeyEnv 指向你信任的环境变量。

典型配置示例¶

先在私有 profile 中写入 Responses 提供者，再为 web profile 指定搜索策略。下面片段与 README 一致，仅作结构参考：

- id: openai-responses-web-search
  config:
    baseURL: https://api.example.test/v1
    apiKeyEnv: OPENAI_API_KEY
    model: your-model

- id: web
  config:
    searchProvider: model-native

若希望始终使用 Responses 网关，将 searchProvider 改为 openai-responses 即可。

验证与发布检查¶

维护者在仓库内用以下命令做基础验证（与 README 一致）：

pnpm test
npm pack --dry-run

插件测试脚本为 node --test tests/*.test.mjs（见 package.json）。

适用场景与注意¶

适合谁： 已在 DSH 0.2.x 使用 web profile、并具备 OpenAI Responses 兼容搜索网关（或计划与 codex/grok/claude 原生搜索混用）的开发者。

注意：

1. 依赖 DSH 0.2.1-alpha.1+（或兼容 0.2），与旧版 Harness 不保证兼容。
2. model-native 下原生路径依赖 Subscriptions 0.7.16 与对应登录；失败时不静默切换后端。
3. 社区插件目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；安装来源以 GitHub 仓库与上述安装命令为准。

结尾¶

dsh-openai-responses-web-search 把 Responses 联网搜索的配置收敛到 profile，并与 model-native 路由分工，减少「同一套 web 工具、多套后端」的手动切换。需要细节时可查阅目录页与仓库 README。

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