@dsh-ltctfer/dsh-web-search-brave

v0.2.4 · 3 天前发布

Brave Search API-backed search provider for the DeepSeek Harness web capability seam (ctx.web). One search is one HTTP request - no model turn.

deepseek-harnessdshdsh-plugincordisweb-searchbrave-search

README

@dsh-ltctfer/dsh-web-search-brave

DeepSeek Harness（DSH）的 Brave Search API 网络搜索提供方插件，挂载到官方 web 能力接缝（ctx.web）。一次搜索就是一次 HTTP 请求——不需要模型参与，比 DeepSeek 官方提供方（每次搜索消耗一次完整模型轮次）更轻、更快。

调用 Brave 官方搜索端点 https://api.search.brave.com/res/v1/web/search，把结构化 web.results[] 映射为接缝规范化的 WebSearchResult，模型看到的仍是稳定的 web_search 工具。

特性

纯检索端点：一次搜索 = 一次 HTTP 请求，无模型轮次开销；

结构化映射：来源严格来自 web.results[]，绝不从模型文本中抓取 URL；

完整错误语义：HTTP 失败、凭据缺失、调用方取消分别映射为 WEB_PROVIDER_ERROR / WEB_PROVIDER_CREDENTIAL_MISSING / WEB_ABORTED；

支持取消（AbortSignal）、按调用方 maxResults 自动收敛请求条数、按 URL 去重；

可选 country / search_lang / freshness 参数；

自定义 API key 三选一：设置页直接填 apiKey（最简单）、导出环境变量（默认 BRAVE_API_KEY，可改名）、或写入 DSH 凭据文件 —— 把插件分享给别人时，对方只需填入

查看完整 README →

版本兼容矩阵

DSH 版本	状态	说明
`dsh@0.1.0-rc.6`	✅ 兼容	cordis patch ✅
`dsh@0.1.0`	✅ 兼容	标准 patch ✅
`dsh@0.2.0`	⚠️ 待验证	待实测（API 可能在变）
`dsh@0.3.0+`	❓ 未知	尚未发布

💡 兼容矩阵每周末自动跑实测，欢迎 PR 修正

元数据

License: MIT
npm: @dsh-ltctfer/dsh-web-search-brave
Repo: git+https://github.com/LTctfer/dsh-web-search-brave.git
Engines: {"node":">=20"}
Weekly DL: 0
Monthly DL: 0
dsh.bundle: {"client":{"inject":["slots"],"platform":"web"}}