Brave 搜索后端 BuffMcBigHuge/dsh-brave-search

dsh-brave-search

为 DeepSeek Harness 提供 Brave Search 服务商。

一个后端，只做一件事：把查询发给 Brave 的 Web Search API，再通过 ctx.web 把结果交回来。没有设置卡片，没有多后端分发，没有状态。如果你一直希望 web_search 就是 Brave，那这个插件正是如此。

- 只发一次 fetch 到 https://api.search.brave.com/res/v1/web/search
- 密钥解析顺序：凭据服务 → $DSH_HOME/.credentials.yaml → 环境变量
- 支持 maxResults 和 harness 的 recency 过滤；上限为 Brave 的 count=20
- 失败信息清晰：缺少密钥、非 2xx 响应、429 免费额度上限

要求

- 带 web 服务的 DeepSeek Harness（任何挂载了 @deepseek-ai/dsh-web 的配置档）
- Brave Search API 密钥 —— 免费额度每月 2,000 次查询：<https://api-dashboard.search.brave.com/>

安装

dsh plugin --profile web add github:BuffMcBigHuge/dsh-brave-search

这个包自带 bundle 补丁，所以服务商会自动挂载。

让 web_search 用它

把下面这段加进你的配置档补丁（$DSH_HOME/profiles/<profile>/cordis.patch.yml）：

- id: web
name: "@deepseek-ai/dsh-web"
config:
searchProvider: brave

注意： 补丁条目的 config 会替换该条目的配置对象，而不是合并进去。如果你的配置档已经设置了 fetchProvider（或 web 上的其他任何配置），要在同一个块里重复写一遍 —— 漏掉就会丢掉这项设置，然后你会看到 multiple usable web providers are registered。

保存密钥

通过凭据存储手动写入：

$DSH_HOME/.credentials.yaml
version: 1
refs:
BRAVE_API_KEY: your-key-here

把这个文件保持在 chmod 600 —— 凭据服务商拒绝加载除所有者之外可读的文档。用环境变量也可以：

BRAVE_API_KEY=… dsh web

验证

发起一次搜索。不会打印遥测行；结果本身就是信号。密钥配错会显示 brave: HTTP 401，密钥缺失会显示 brave: no BRAVE_API_KEY found — …。

与多后端插件的区别

它只注册一个服务商（brave），所以一旦设好 searchProvider，服务商选择就没有歧义。没有回退：Brave 宕机或被限流时，搜索会失败，而不是悄悄换另一个引擎回答。

开发

node --test test/

许可证

MIT