概览

@brilliant751/dsh-web-search-litellm

LiteLLM /v1/search-backed web search provider for the DeepSeek Harness web capability seam (ctx.web). One search is one HTTP request — no model turn.

README / ZH

插件文档

@brilliant751/dsh-web-search-litellm

English | 中文

基于 LiteLLM /v1/search 端点的 DeepSeek Harness（dsh）网页搜索 provider，接入 ctx.web 能力 seam。

一次搜索就是一次发往 LiteLLM 搜索端点的 HTTP 请求——不消耗模型推理，这一点不同于自带的 DeepSeek Anthropic 兼容 provider。它复用你现有的 LiteLLM 网关及其虚拟 key，让聊天与搜索走同一个代理。

安装

dsh plugin --profile web add @brilliant751/dsh-web-search-litellm

重启 dsh web。本包声明了 dsh.bundle.patch，因此 dsh plugin add 会把它追加进 dsh.profile.bundles，从而注册 litellm provider 并将其选为当前搜索后端。

LiteLLM 前置配置

LiteLLM 通过一个具名 search tool 路由搜索。这个名称是网关内的本地标识，并不等于底层 provider 类型。包内默认配置期望存在名为 google 的工具。例如，可以在 LiteLLM 的 config.yaml 中把它映射到 Google PSE：

search_tools:
  - search_tool_name: google
    litellm_params:
      search_provider: google_pse
      api_key: os.environ/GOOGLE_PSE_API_KEY

Google PSE 还要求 LiteLLM 服务端环境中存在 GOOGLE_PSE_ENGINE_ID。其他 search_provider 也可以复用同一个本地工具名。

配置 DSH 前，先确认网关的虚拟 key 能看到该工具：

curl https://your-litellm.example.com/v1/search/tools \
  -H 'Authorization: Bearer YOUR_LITELLM_VIRTUAL_KEY'

响应的 data[].search_tool_name 中必须包含下方配置使用的名称。

工作原理

向 ctx.web 注册一个 id 为 litellm 的 WebSearchProvider。
调用 POST {baseURL}/search，请求体为 { query, search_tool_name }，带 Authorization: Bearer <key> 头。
把 LiteLLM 返回的 results[]（title / url / snippet / date）映射成 seam 规范化的 sources[]。
面向模型的 web_search 工具保持不变（@deepseek-ai/dsh-tool-web），结果保留原生引用卡片。

配置

默认值写在 cordis.patch.yml 中：

键	默认值	含义
`baseURL`	`https://your-litellm.example.com/v1`	LiteLLM 基础地址；`/search` 会被追加。这是 OpenAI 兼容基础地址，不是 Anthropic passthrough。
`apiKeyEnv`	`DEEPSEEK_API_KEY`	凭证引用，每次搜索时通过 `ctx.credentials` 解析（Models 页面写入），然后回退到 DSH 启动环境。
`searchToolName`	`google`	要调用的 LiteLLM 搜索工具（见 `GET {baseURL}/search/tools`）。

本包导出了 Cordis Config schema，因此兼容的 DSH 配置界面可以渲染这些字段，并对字面量 apiKey 做脱敏。bundle patch 仍然是可移植的初始配置来源。

在你自己 profile 的 cordis.patch.yml 或 --patch overlay 中覆盖任意值。注意：patch 会整体替换目标行的 config（不做合并），所以覆盖时必须重写完整配置：

- insert:
    - id: web-search-litellm
      name: '@brilliant751/dsh-web-search-litellm'
      config:
        baseURL: https://your-litellm.example.com/v1
        apiKeyEnv: DEEPSEEK_API_KEY
        searchToolName: google

要切回自带的 DeepSeek provider，把 web.searchProvider 改回 deepseek-official（或卸载本包）。

凭证解析顺序

配置中的字面量 apiKey（不推荐——优先用凭证存储）。
ctx.credentials 解析 apiKeyEnv（Web UI 的 Models/Web-search 卡片会写入 $DSH_HOME/.credentials.yaml）。
DSH 启动环境快照：继承的进程环境变量、项目 .env，再到 Harness home 下的 .env。

兼容性

0.1.1 支持 0.1.0-rc.6 至 0.1.2-rc.1 的 DSH web seam 预发布版本，并要求 Node.js 20 或更高版本。

排障

**已配置的 provider 不可用：**检查 baseURL 是否为绝对 URL、 searchToolName 是否非空，以及凭证存储或启动环境能否解析 apiKeyEnv。
**HTTP 401/403：**虚拟 key 必须被授权调用所选 LiteLLM search tool；该权限与聊天模型权限相互独立。
**找不到 search tool/model：**调用 GET {baseURL}/search/tools，把准确的 search_tool_name 填入插件配置。
**搜索响应无效：**确认目标路由是 LiteLLM Search API，且网关返回 results 数组。

安全说明

安装本插件即意味着以你的权限运行其代码。它只会把你的 LiteLLM key 发送给配置的 baseURL。请只把 baseURL 指向你信任的网关。

许可证

MIT

@brilliant751/dsh-web-search-litellm