deepseekplugins

DeepSeek Harness plugin

dsh-web-search-openai

OpenAI Responses API-backed web search provider for dsh: registers into ctx.web (web_search tool with server-side retrieval), plus a Web settings card for endpoint/model/key. Hot-pluggable — mounted

Docs & Rendering
Jump to install

Source facts

Repository
flg1217/dsh-web-search-openai
Latest update
Aug 18, 2026
Category
Docs & Rendering
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/flg1217/dsh-web-search-openai
Plugin: dsh-web-search-openai
Author: flg1217

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-web-search-openai

> OpenAI Responses API 网页搜索插件 — DeepSeek Harness (dsh) 的 web_search 提供方 > 把 OpenAI Responses API 的原生 web_search 服务端检索能力接入 dsh 的网页搜索通道：搜索、出题、带来源引用。开箱即用，零源码改动。

一、这是什么

dsh-web-search-openai 是面向 DeepSeek Harness（dsh）的开源插件，向 ctx.web 注册一个 OpenAI Responses API 驱动的搜索提供方：

能力说明
服务端检索每次搜索调用 POST /responses，携带原生 web_search 工具，由服务端完成检索并生成回答
可引用来源web_search_call.search_results[] 结构化结果（或消息级 url_citation 注解兜底）归一化为可引用来源
Web 设置卡片dsh 设置 → 搜索 → "Web 搜索" 卡片：端点、模型、API Key（只写不回显）、max tokens、检索上下文

插件严格遵循 dsh 官方扩展机制（profile bundle patch / registerSearchProvider / 客户端 slot），不修改 dsh 任何源码，可随 dsh 平滑升级。

二、安装（装配进 profile）

要求：dsh >= 0.1.0-rc.6。lib/ 已随仓库提交，无需构建。

方式一（推荐，等价于 dsh plugin add）：

node scripts/link-profile.mjs            # 默认装配进 web profile
# 或指定 profile:
node scripts/link-profile.mjs --profile headless

方式二（手工）：

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

完成后重启 dsh web，bundle 层才会加载。

三、使用

1. 在 dsh Web 设置 → 搜索 → Web 搜索 卡片里填好端点 / 模型 / API Key（或让插件读环境变量 OPENAI_API_KEY）。 2. 把 web 通道的 searchProvider 切到 openai（profile 的 cordis.patch.yml 里 web.searchProvider，或设置面板切换）。

默认值：

项默认
端点https://api.openai.com/v1（/responses 自动追加）
模型gpt-5.6-luna
最大输出 tokens2048
检索上下文medium
API Key插件 config apiKey → 环境变量 OPENAI_API_KEY → 不可用

四、工作原理

插件为双面结构，由 dsh 官方扩展机制装配：

┌─────────────── 宿主进程(node 半)──────────────────┐
│ src/index.ts   插件入口:settings 命名空间 + 注册提供方 │
│ src/provider.ts OpenAiSearchProvider — fetch /responses│
│                web_search 工具 + 来源/回答归一化      │
└──────────────────────────────────────────────────┘
┌─────────────── 浏览器(web 半)──────────────────────┐
│ src/client/index.tsx 设置面板 "Web 搜索" 卡片        │
│                settings.section slot,写只回显密钥     │
└──────────────────────────────────────────────────┘
  • dsh.bundle.patch → cordis.patch.yml：把插件行插入 profile 名单（bundle 层）。
  • dsh.client.inject → 浏览器半在 Web GUI 加载（/plugins/web-search-openai/client.js）。

五、开发

pnpm install        # 安装 typescript + esbuild
pnpm build          # 服务端 tsc → lib/；客户端 esbuild → lib/client.js(ModuleLoader 封装)
pnpm typecheck      # tsc --noEmit

lib/ 必须提交（用户免构建装配）。

六、诊断

  • 设置卡片保存失败：检查端点可达性 / API Key 有效性。
  • 搜索报 WEB_PROVIDER_ERROR：OpenAI 网关返回非 2xx（错误详情透传）。
  • 设置卡片不出现：确认 bundle 层已加载（dsh plugin list），重启 dsh web。

七、许可

MIT

Back to searchOpen GitHub repository

More related plugins

View category