前言¶

DeepSeek Harness（下稱 DSH）裏的 web 能力通過 ctx.web 這條 seam 暴露，內置 web_search 工具可以接入不同的搜索後端。如果你的目標是在 DSH 中把 web 搜索請求路由到 Brave Search Web API，並且希望保持插件化配置，可以關注 dsh-web-search-brave。

DSH 的插件生態按“一切皆插件”組織，社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不應把它理解成官方應用商店。

這是什麼¶

dsh-web-search-brave 是一個 Brave Search-backed WebSearchProvider，用於 DSH 的 web seam（ctx.web）。它的作用是爲 DSH 的 ctx.web / web_search 提供 Brave Search 後端。

該插件由 cnChenKai 維護，許可證爲 MIT。engines 要求 Node.js >=22。

核心功能¶

下面只列已覈實的插件能力：

• 爲 DSH 的 ctx.web / web_search 提供 Brave Search 後端。
• text_decorations 默認 false，搜索片段不帶高亮標記。
• page_age（ISO 8601）映射到 seam 的 publishedAt。
• 需要 BRAVE_API_KEY；Brave 沒有 keyless 模式，免費額度爲 2,000 queries/month。

安裝與啓用¶

先確認 DSH 運行環境滿足 node >=22，然後按下面步驟安裝並啓用。

1、安裝插件¶

在目標 DSH profile 下運行安裝命令：

dsh plugin --profile web add dsh-web-search-brave

這條命令會把 dsh-web-search-brave 添加到 web profile 的插件集合中。

2、配置 API Key¶

在 DSH credential store 中設置 BRAVE_API_KEY，或者在啓動 dsh web 的環境中導出該變量。credential store 示例如下：

# ~/.dsh/.credentials.yaml
BRAVE_API_KEY: BSA...

上面使用佔位值，實際值應替換爲你自己的 Brave Search API key。

3、選擇 Brave 搜索提供方¶

在 profile 的 cordis.patch.yml 中，將 web 配置的 searchProvider 設爲 brave：

# your profile's cordis.patch.yml
- id: web
  name: '@deepseek-ai/dsh-web'
  config:
    searchProvider: brave

經過上面的步驟後，DSH 的 web_search 會使用 Brave Search 作爲搜索後端。

依賴與許可¶

該插件聲明瞭以下 peerDependencies：

@deepseek-ai/dsh-credentials
@deepseek-ai/dsh-launch-environment
@deepseek-ai/dsh-web
@deepseek-ai/schemastery

許可證爲 MIT。engines 要求 Node.js >=22。

適用場景與注意¶

適合的場景：

• 你正在 DSH 中使用 ctx.web / web_search，並希望切換到 Brave Search。
• 你可以管理 BRAVE_API_KEY，並且用量在免費額度內即可滿足需求。
• 你希望通過 DSH profile 和 cordis.patch.yml 做聲明式配置。

注意事項：

• 該插件需要 Brave Search API key，Brave 沒有 keyless 模式。
• 免費額度爲 2,000 queries/month，生產或高頻使用需自行評估配額。
• 插件會以當前 dsh 進程權限運行。安裝前請檢查源碼、依賴和許可證是否符合你的使用要求。
• 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。

鏈接¶

• 社區目錄：https://www.skillhub.cn/plugins/cnChenKai/dsh-web-search-brave
• GitHub：https://github.com/cnChenKai/dsh-web-search-brave