前言¶
DeepSeek Harness（下稱 DSH）的 web 能力通過接縫 ctx.web 暴露。若要在智能體工作流裏接入網頁搜索，通常需要同時處理不同搜索引擎的後端、憑據、設置項，甚至修改 web.searchProvider。
dsh-web-search-plugin 把多個搜索後端收斂到同一個插件裏：它向 ctx.web 註冊一個 WebSearchProvider，穩定 id 爲 dsh-web-search。安裝後可以在“設置 → 網頁搜索”裏切換引擎，不必再改 web.searchProvider。
這是什麼¶
下面介紹它的位置、邊界和適合的使用方式。
定位¶
dsh-web-search-plugin 是面向 DeepSeek Harness web 能力接縫的統一網頁搜索插件。它內置 DeepSeek（官方，默認）、Tavily、Brave Search、Serper、SerpApi、Exa、SearXNG、Scavio、Firecrawl 九個後端。
插件由 X-C1811 維護，許可證爲 MIT。
邊界¶
- 不內置 TinyFish、Google CSE、SERPJET、DuckDuckGo 獨立後端。
- 不寫自定義 session 事件。
- 瀏覽器側額度查詢走插件提供的只讀接口，不直打上游。
核心功能¶
統一 provider¶
插件只註冊一個 WebSearchProvider，穩定 id 爲：
dsh-web-search
啓動時可以通過環境變量選中這個 id：
DSH_WEB_SEARCH_PROVIDER=dsh-web-search
設置內切換引擎¶
安裝後，在 DSH 的：
設置 → 網頁搜索
裏切換引擎即可。
頂層設置分區支持兩列布局、未保存草稿、保存 toast。結果數量爲 1–20 下拉。
憑據與跳轉¶
需要 key 的內置 provider 在設置卡提供官方 API key 跳轉；SearXNG 與 Tavily keyless 不渲染該跳轉。
配置鍵如：
apiKey
deepseekApiKey
braveApiKey
等走憑據域，不會回顯。
結果與錯誤¶
各引擎結果會被規範化爲接縫的 WebSearchResult，並按 URL 去重。
錯誤會映射爲：
WEB_PROVIDER_ERROR
WEB_ABORTED
WEB_PROVIDER_CREDENTIAL_MISSING
額度展示¶
Tavily keyed 與 Brave 在設置卡展示額度進度條；DeepSeek 官方與 Tavily keyless 不展示。
Tavily keyless 爲免費、限流、無需賬號。Tavily keyed 需要：
TAVILY_API_KEY
Brave 需要：
BRAVE_API_KEY
這是 Brave 訂閱 token。
Brave 沒有 usage / 花費接口，計費 credits 只能查看 Brave API 控制檯。
安裝與啓用¶
運行要求¶
- DeepSeek Harness
0.1.2-alpha.4（最新 main）或更新。 pnpm，用於通過dsh plugin把插件裝進 profile。
從 npm 安裝¶
先確認 DSH profile 可用，再執行：
dsh plugin --profile web add dsh-web-search-plugin
本包是 bundle。它會通過 cordis.patch.yml 設置：
web.searchProvider = dsh-web-search
並禁用內置 web-search-deepseek Host 插件，以避免重複註冊 provider 和舊卡片。
沒有 bundle 聲明時，dsh plugin add 只寫入依賴，插件不會掛載。
啓動時指定¶
如果希望本次啓動直接選中該接縫 id，可設置：
DSH_WEB_SEARCH_PROVIDER=dsh-web-search
經過上面的步驟後，插件會在 DSH 的 web 能力接縫下生效，並提供“設置 → 網頁搜索”入口。
典型用法¶
安裝後切換引擎¶
1、安裝插件。
2、打開 DSH 的“設置 → 網頁搜索”。
3、選擇內置引擎之一，例如 DeepSeek（官方，默認）、Tavily、Brave Search、Serper、SerpApi、Exa、SearXNG、Scavio 或 Firecrawl。
4、如需使用 Tavily keyless，可直接進入 keyless 模式；若使用 Tavily keyed，再配置 TAVILY_API_KEY。
5、保存設置，執行搜索。
Tavily 基址¶
未設置 baseURL 時，Tavily 基址回退：
$TAVILY_BASE_URL
瀏覽器側額度查詢¶
瀏覽器只讀：
GET /dsh-web-search/usage
不直打上游。
Tavily keyed 對賬¶
Tavily keyed 會請求：
include_usage
並用：
GET /usage
對賬額度。
Brave 計費¶
Brave 的計費 credits 只能查看 Brave API 控制檯。
本地安裝注意¶
如果你從本地源碼安裝，注意 dsh plugin add 的路徑行爲。
Windows 跨盤安裝不要使用 dsh plugin add 絕對路徑；應快照到與 profile 同盤後用 file:。
適用場景與注意¶
適合需要在 DSH 中統一接入多個網頁搜索後端的開發者。它適合把搜索切換、結果規範化、憑據跳轉和額度展示放在同一設置分區裏維護的場景。
安裝前應檢查源碼與許可證。該插件以當前 dsh 進程權限運行，會讀取配置、調用搜索服務並查詢額度。使用前請確認 DSH 版本滿足要求，並確認所選後端、key 和代理環境符合你的安全邊界。
結尾¶
dsh-web-search-plugin 的價值在於把多個搜索後端收進同一個 DSH web 接縫裏：一個穩定 id、一個設置分區、一套結果規範。
倉庫地址：
https://github.com/X-C1811/dsh-web-search-plugin
如果所在環境使用 DSH 社區目錄，請把它理解爲獨立站點，而不是官方應用商店；與 DeepSeek、幻方無官方從屬關係。
