dsh-openai-responses-web-search

This release requires DSH 0.2.1-alpha.1 or a compatible 0.2 release. See compatibility details.

通过兼容 OpenAI Responses API 的服务为 DSH 提供联网搜索。

安装

锁定公开仓库的提交后，通过 DSH 官方入口安装：

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

配置

地址、凭据环境变量名和模型保存在私有 profile 配置中：

- 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

model-native 根据当前发起工具调用的会话请求选择服务：codex、grok、claude 调用 Subscriptions 0.7.16 提供的原生搜索，使用当前模型 ID 和对应订阅登录；其他路由、没有发起会话的调用使用上述明确配置的 Responses 服务。模型名称不代表其聊天路由具有同一家搜索服务的凭据；例如第三方路由上的 DeepSeek 模型不会自动使用 DeepSeek 账号搜索。nativeProviders 可配置参与原生搜索的订阅路由，默认三者都启用。保留 searchProvider: openai-responses 可继续固定使用 Responses 后端。

可按顺序配置备用订阅搜索，模型名须受对应订阅支持，账号须已登录：

    fallbackSearches:
      - provider: codex
        model: your-supported-codex-model
      - provider: grok
        model: your-supported-grok-model

默认备用列表为空。首选服务返回结构化搜索错误时，依次尝试配置的备用服务，同一提供方只调用一次；取消和未分类程序错误立即停止。每次尝试的协作式超时由 attemptTimeoutMs 控制，默认 25000 毫秒；工具层的总超时仍会取消整次搜索。所有尝试失败时报告失败，并保留各次错误作为 cause。启用备用服务会将相同查询发送给备用提供方。

HTTP 错误保留服务地址与状态码；502 提示检查搜索网关的上游连通性及 web_search 支持。原生 Grok 与 Claude 协议分别见 xAI Web Search 和 Claude Web Search。源码和公开示例不保存真实地址或凭据。

验证

pnpm test
npm pack --dry-run

许可证

MIT

Plugin display metadata

The plugin list shows Responses web search in English and Responses 联网搜索 in Chinese, following the DSH interface language. locale/en.json and locale/zh.json provide the title and description; icon.svg supplies self-contained artwork. The package exports and publishes these resources. The icon is adapted from Lucide; see ICON_LICENSE.txt.

The icon uses a centered 36 × 36 viewBox to leave more space around the artwork inside the plugin icon frame.