RailgunHamster/dsh-web-search

dsh-web-search

用于选择和路由 DeepSeek Harness web_search 后端的 Host 和 Web 客户端插件。

英文

功能说明

Host 部分注册一个名为 dsh-web-search-selected 的 ctx.web 提供程序。持久化的 web-search 设置用于选择当前生效的后端。Web 客户端添加了一个专用的 设置 → Web 搜索 部分，并通过 Host 设置作用域保存所选内容。

请求路径：

web_search
-> ctx.web
-> dsh-web-search-selected
-> selected backend

内置后端：

| ID | 行为 |
|---|---|
| openai-responses | 使用原生 web_search 工具的 OpenAI Responses API |
| deepseek-official | DeepSeek 原生 Web 搜索协议 |

该插件的身份是路由器，而不是任何单一模型或供应商。

安装

dsh plugin --profile web add github:RailgunHamster/dsh-web-search
dsh plugin --profile web install

重启 Web 配置文件：

dsh web

或者手动将其添加到 Web 配置文件的 package.json 中：

{
"dependencies": {
"dsh-web-search": "git+https://github.com/RailgunHamster/dsh-web-search.git"
},
"dsh": {
"profile": {
"bundles": [
"dsh-web-search"
]
}
}
}

cd "$env:USERPROFILE\.dsh\profiles\web"
pnpm install
dsh web

随后，捆绑的 cordis.patch.yml 会：

1. 禁用随附的 web-search-deepseek 提供程序。
2. 将 @deepseek-ai/dsh-web 的 searchProvider 指向 dsh-web-search-selected。
3. 将 dsh-web-search 插入当前组合中。

配置

插件配置（以及设置命名空间 web-search）接受：

| 键 | 默认值 | 含义 |
|---|---|---|
| provider | openai-responses | 选定的后端 |
| responsesApiKeyEnv | OPENAI_API_KEY | Responses 搜索的凭据 / 环境变量名 |
| responsesBaseURL | https://api.openai.com/v1 | Responses API 基础 URL |
| responsesModel | gpt-4o | 暴露 tools: [{ type: "web_search" }] 的模型 |
| responsesMaxTokens | 1024 | Responses 搜索的 max_output_tokens |
| deepseekApiKeyEnv | DEEPSEEK_API_KEY | DeepSeek 搜索的凭据 / 环境变量名 |
| deepseekBaseURL | https://api.deepseek.com/anthropic/v1 | DeepSeek Anthropic 兼容基础 URL |
| deepseekModel | deepseek-v4-flash | DeepSeek 搜索模型 |
| deepseekApiVersion | 2023-06-01 | anthropic-version 请求头 |
| deepseekMaxTokens | 4096 | DeepSeek max_tokens |
| deepseekMaxUses | 5 | DeepSeek web_search 的 max_uses |

请通过 DSH 凭据或启动环境提供密钥。不要将真实密钥放入 Git、settings.yaml 或本 README 中。

插件行示例：

- id: web-search
config:
provider: openai-responses
responsesApiKeyEnv: OPENAI_API_KEY
responsesBaseURL: https://api.openai.com/v1
responsesModel: gpt-4o

在 设置 → Web 搜索 中切换后端会立即保存，并应用于后续的 web_search 调用。该切换不需要重启 DSH。

验证
dsh --profile web --dump-config | Select-String -Pattern 'searchProvider|web-search-deepseek|web-search'

预期输出：

searchProvider: dsh-web-search-selected
web-search-deepseek: disabled: true
web-search: dsh-web-search

然后运行一次普通的 web_search。默认的 Responses 后端会发送：

POST {responsesBaseURL}/responses
tools: [{ "type": "web_search" }]

插件会将返回的文本和 url_citation 注解映射到 Harness 的 content 和 sources。

开发

Host 或 cordis.patch.yml 的更改需要完全重启 DSH Web，然后刷新浏览器。只有在 profile 的 Web watcher 正在运行时，客户端更改才会热重载。

不要提交：

- node_modules/
- .dsh/
- settings.yaml
- 凭据文件
- .env 文件
- API 密钥、私钥或会话数据

许可证

MIT

中文

功能

Host 侧注册一个名为 dsh-web-search-selected 的 ctx.web provider。持久化的 web-search 设置决定当前搜索后端。Web 客户端提供独立的 设置 → 联网搜索 页面，选择会通过 Host settings scope 自动保存。

请求路径：

web_search
-> ctx.web
-> dsh-web-search-selected
-> 当前选中的 backend

内置 backend：

| ID | 行为 |
|---|---|
| openai-responses | 调用 OpenAI Responses API 的原生 web_search 工具 |
| deepseek-official | 使用 DeepSeek 原生 web search 协议 |

插件本身是路由器，不绑定某个模型或厂商。

安装

dsh plugin --profile web add github:RailgunHamster/dsh-web-search
dsh plugin --profile web install

然后重启 Web profile：

dsh web

也可以手动改 Web profile 的 package.json：

{
"dependencies": {
"dsh-web-search": "git+https://github.com/RailgunHamster/dsh-web-search.git"
},
"dsh": {
"profile": {
"bundles": [
"dsh-web-search"
]
}
}
}

cd "$env:USERPROFILE\.dsh\profiles\web"
pnpm install
dsh web

插件自带的 cordis.patch.yml 会：

1. 禁用 shipped 的 web-search-deepseek provider。
2. 将 @deepseek-ai/dsh-web 的 searchProvider 指向 dsh-web-search-selected。
3. 把 dsh-web-search 插入当前 composition。

配置

插件配置（以及 settings namespace web-search）支持：

| 字段 | 默认值 | 含义 |
|---|---|---|
| provider | openai-responses | 当前 backend |
| responsesApiKeyEnv | OPENAI_API_KEY | Responses 搜索使用的凭据 / 环境变量名 |
| responsesBaseURL | https://api.openai.com/v1 | Responses API 根地址 |
| responsesModel | gpt-4o | 支持 tools: [{ type: "web_search" }] 的模型 |
| responsesMaxTokens | 1024 | Responses 搜索的 max_output_tokens |
| deepseekApiKeyEnv | DEEPSEEK_API_KEY | DeepSeek 搜索使用的凭据 / 环境变量名 |
| deepseekBaseURL | https://api.deepseek.com/anthropic/v1 | DeepSeek Anthropic 兼容根地址 |
| deepseekModel | deepseek-v4-flash | DeepSeek 搜索模型 |
| deepseekApiVersion | 2023-06-01 | anthropic-version 请求头 |
| deepseekMaxTokens | 4096 | DeepSeek max_tokens |
| deepseekMaxUses | 5 | DeepSeek web_search 的 max_uses |

密钥只能放在 DSH credentials 或启动环境里，不要写入 Git、settings.yaml 或本文。

插件行示例：

- id: web-search
config:
provider: openai-responses
responsesApiKeyEnv: OPENAI_API_KEY
responsesBaseURL: https://api.openai.com/v1
responsesModel: gpt-4o

在 设置 → 联网搜索 里切换 backend 会立刻保存，并作用于之后的 web_search，不必为了切换而重启 DSH。

验证

dsh --profile web --dump-config | Select-String -Pattern 'searchProvider|web-search-deepseek|web-search'

预期看到：

searchProvider: dsh-web-search-selected
web-search-deepseek: disabled: true
web-search: dsh-web-search

然后发一次普通 web_search。默认 Responses backend 会请求：

POST {responsesBaseURL}/responses
tools: [{ "type": "web_search" }]

插件把返回文本和 url_citation 映射为 Harness 的 content 与 sources。

开发

Host 代码或 cordis.patch.yml 改动后需要完整重启 DSH Web，再刷新浏览器。只有 profile 的 Web watcher 在跑时，Client 改动才会热更新。

不要提交：

- node_modules/
- .dsh/
- settings.yaml
- credentials 文件
- .env 文件
- API key、私钥或 session 数据

许可证

MIT