bug-huntter/web-search-advanced

@lp181818/web-search-advanced

适用于 DeepSeek Harness（DSH）的高级网页搜索插件，同时支持原生
DeepSeek 搜索和 OpenAI 兼容的“Custom”搜索提供商。

功能特性

- 提供商选择器：deepseek（原生）或 custom（OpenAI 兼容，例如 OpenRouter）
- 设置区域：提供商选择、端点 URL、模型、API 密钥、最大搜索次数
- 两种搜索后端：原生 DeepSeek web_search_20250305 或 OpenAI 兼容的网页插件
- 自动重试（v0.1.4）：瞬时故障（HTTP 429 / 5xx / 网络
错误）会以指数退避方式重试，并遵循服务器的
Retry-After 响应头（可配置的 maxRetries，默认 3）
- 保存前测试（v0.1.4）：设置卡片会在保存前使用
当前草稿值探测已配置的端点（Custom 为 /chat/completions，DeepSeek 为 /messages）；
真实的配置错误（错误的端点/模型/密钥）
会阻止保存，瞬时的 429/5xx 仅发出警告

DSH 兼容性

| DSH 版本 | 兼容性 |
| --- | --- |
| 0.1.2-rc.1 及当前 0.1.2 rc | 通过当前 settings/LLM 服务注册并暴露设置命名空间 |
| 0.1.0-rc.7 至 pre-0.1.2-alpha | 使用共享的 settings.register/installSection 服务 API；理论上兼容 |
| 0.1.0-rc.7 之前 / 0.0.x | 不支持；这些 DSH 版本缺少 settings/section 机制 |

当前源码不再导入已移除的 settingsNamespace、
installSettingsSection 或 @deepseek-ai/dsh-client-runtime API。

在 DSH 中启用此提供商

安装此包会自动将 DSH 的 web 服务路由到
web-search-advanced；无需手动编辑 cordis.patch.yml。安装
后，重启 dsh web 并在 Web Search
设置区域中配置此包。

仅需提供商、API 密钥和模型。端点是可选的：
DeepSeek 使用 https://api.deepseek.com/anthropic/v1，而 Custom 在端点留空时
使用 https://openrouter.ai/api/v1。在
web-search-advanced 设置命名空间内：

- searchProvider: deepseek 使用此插件的 DeepSeek 分支。
- searchProvider: custom 使用已配置的 OpenAI 兼容
baseURL / model，例如 OpenRouter。
- maxRetries: 3（可选）——针对瞬时
故障（429 / 5xx / 网络）的指数退避重试，默认 3。

设置会持久保存在 ~/.dsh/settings.yaml 中的 web-search-advanced
命名空间下，并在 DSH 重启后保留，直到被删除。

该包补丁还会选择内置的 http 获取提供商，以便无需额外更改配置文件
即可打开搜索结果。

构建

此仓库包含 DSH 技能
中心验证所需的预构建 lib/ 产物。直接从 GitHub 安装时也有一个 prepare 脚本可以
重新构建它们。

DSH 将 @deepseek-ai/* 包解析为运行时对等依赖，因此本地安装
不应让 npm 解析它们：

npm install --legacy-peer-deps
npm run build

构建输出：
- lib/index.js - DSH 宿主/插件部分
- lib/client.js - DSH Web 客户端打包文件

构建完成后，同步到已安装的 DSH 配置文件中：

npm run sync

如果还没有任何配置文件安装了该包，请先安装它：

dsh plugin --profile web add github:bug-huntter/web-search-advanced

然后重启 DSH 并应用配置文件补丁：

dsh web

该插件通过 ctx.web 注册其提供程序，注册
web-search-advanced 设置命名空间，并通过可配置提供程序注册表将该命名空间暴露给
Web 客户端。