thomasly/dsh-web-search-brave ↗★ 0

dsh-web-search-brave

Brave Search provider for DeepSeek Harness (dsh): one model-agnostic provider on the official ctx.web seam, using your own Brave subscription key.

パッケージ
dsh-web-search-brave
互換性
未検証
バージョン
1.0.0
ライセンス
MIT
最終更新
2026/11/02

同名パッケージの別リポジトリ

インストール

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:thomasly/dsh-web-search-brave

ドキュメント

README 全文を読む ↗

启用(一行配置)

不管用哪种方式装,最后都要让 dsh 选中这个 provider。在 ~/.dsh/profiles/web/cordis.patch.yml 里加:

- id: web
  config:
    searchProvider: brave-search
    fetchProvider: http

fetchProvider: http 保持 web_fetch 走 dsh 内置的本地 HTTP 抓取,不额外花钱。

配置参考

配置写在 cordis.patch.yml 的 web-search-brave-local 行(bundle 自带的插入行)下面, 全部可选:

- insert:
    - id: web-search-brave-local
      name: dsh-web-search-brave
      config:
        providerId: brave-search
        apiKeyEnv: BRAVE_API_KEY
        count: 10
        safesearch: moderate
字段默认值说明
providerIdbrave-search注册进 ctx.web 的 id,必须与 searchProvider 一致;改这里时两边一起改
apiKey空字面量 key。会写进配置文件,不推荐;设置了就优先于凭据库
apiKeyEnvBRAVE_API_KEY凭据库里的引用名(refs.),也是环境变量名
baseURLhttps://api.search.brave.com/res/v1/web/search接口地址;走代理或镜像时改这里
count10单次最多要几条,Brave 上限 20,下限 1
country空两位国家码(如 CN、US)或 ALL;空则不传
searchLang空如 zh-hans、en;空则不传
freshness空pd/pw/pm/py,或 2026-01-01to2026-01-31
safesearchmoderateoff / moderate / strict
extraSnippetstrue是否请求额外摘要片段并并入 snippet
timeoutMs20000单次请求超时(毫秒)
minIntervalMs1100两次请求的最小间隔;Brave 免费档约 1 次/秒

freshness 是整个 provider 级的设置,不是每个 query 单独设的。dsh 的 web_search 入参只有 queries,所以想让「最新」类查询默认只看最近一周,可以在 profile 里配 freshness: pw,或者另建一个 profile 专门跑时效性任务。