前言¶
在 DeepSeek Harness（DSH）裏跑智能體，聯網檢索往往是瓶頸：內置 web_search / web_fetch 能力有限，單引擎結果不穩定，時效性強的信息容易漏檢；要查 X（Twitter）內容，還得自己拼接口或寫降級邏輯。社區裏也有獨立的搜索 MCP，但和 DSH 的內置工具鏈、引用卡片並不天然對齊。
下面介紹 dsh-search-boost——由維護者 Mr-remon219 發佈的 DSH bundle 插件（GitHub 12 stars，SkillHub 分類：模型推理）。它以 npm 包形式接入，升級內置搜索與抓取後端，並註冊融合檢索、X 搜索、深度研究等一整套工具，同時保留 DSH 原生的引用展示方式。
這是什麼¶
dsh-search-boost 是面向 DeepSeek Harness 的 bundle 插件（當前版本 0.1.3，MIT 許可）。它通過 cordis.patch.yml 自動 patch DSH 配置：註冊 WebSearchProvider 與 WebFetchProvider，讓內置 web_search / web_fetch 的 UI 與引用卡片不變，後端改走插件的多引擎鏈路與 Jina 優先的頁面讀取。
插件同時暴露 fused_search、x_search、fetch_page、deep_research、research_parallel 等獨立工具，並在 systemPrompt.section 注入主動搜索守則（例如時效事實需檢索、X 內容走 x_search）。
該插件屬於 Mr-remon219 的 search-boost 系列中與 DSH 對應的發行版；同系列還有面向 Cursor / MCP 的 search-boost 與面向 pi 的 pi-search-boost。
核心功能¶
雙搜索層：free 與 api¶
運行時用 /web_change 切換搜索層，選擇持久化到 ~/.dsh-search-boost-layer.json：
| 層 | 調用的引擎 | 適用場景 |
|---|---|---|
free |
Bing、DuckDuckGo、Yahoo、Exa MCP（exa-free），全部無 API key，並行探活 | 反覆研究、零成本、不想消耗付費額度 |
api（默認） |
上述無 key 引擎，加上本機可用的 Antigravity CLI（agy），以及已配置 key 的 Tavily / Brave / Exa |
需要更高召回、願意使用付費 API |
無 key 引擎並行運行，單個失敗不會導致整次檢索空手而歸。融合排序包含跨引擎共現加分與半衰期時效衰減。維護者在 2026-08 的基準測試中，free 層 Bing / DDG / Yahoo / exa-free 成功率均爲 100%，fused_search 約 1.3–3.0s 返回 5 條結果。
常用切換命令：
/web_change free # 僅無 key 引擎池
/web_change api # 完整引擎池（默認）
/web_change show # 查看當前層與各引擎可用性
內置工具升級¶
插件 patch 後，DSH 原有的 web_search 與 web_fetch 調用方式不變，後端替換爲插件引擎鏈與 Jina Reader 優先的抓取邏輯。對現有工作流來說，這是最低遷移成本的接入路徑。
fused_search：多引擎融合檢索¶
fused_search 提供複雜度分檔、Grok 風格查詢預處理（site:、OR、引號）、域名過濾、跨引擎打分與 6 小時 TTL 緩存。搜索層由 /web_change 控制，單次調用也可通過 layer 參數覆蓋。
x_search：X / Twitter 即時檢索¶
x_search 支持帖文、用戶、線程檢索：
- 有憑據（通過
/x-login導入）：託管 xAI 工具與多引擎（限site:x.com）並行，結果合併去重。 - 無憑據：多引擎 + oEmbed 全文（約 2s）、guest GraphQL 用戶資料、oEmbed 線程；維護者基準中無憑據路徑可檢索 @NASA 用戶資料。
憑據管理：
/x-login # 從 ~/.grok/auth.json 導入
/x-login -k <XAI_API_KEY> # 使用 console.x.ai API key
/x-login status # 查看憑據鏈
/x-logout # 移除憑據，回退到免憑據鏈
~/.grok/auth.json 不會被自動讀取；未執行 /x-login 且無 XAI_API_KEY 時，只走免憑據降級鏈。
頁面抓取與研究工具¶
| 工具 | 作用 |
|---|---|
fetch_page |
Jina Reader + 本地 HTML 回退 + focus 定向提取 + 24h 緩存 |
deep_research |
step 模式深度研究：複雜融合檢索、覆蓋度分析、缺口識別、建議查詢，由主 agent 多輪驅動 |
research_parallel |
子查詢分解 → DSH 原生 subagent 並行執行 → 來源合併 |
search_stats |
緩存、分檔、引擎可用性與 x_search 憑據審計 |
安裝與啓用¶
推薦通過 npm 以 bundle 方式安裝。--profile web 爲必填參數（web 是常用的 Web UI 配置檔）；DSH 通過 pnpm 拉包並自動應用 dsh.bundle.patch，無需手改配置文件。
dsh plugin --profile web add dsh-search-boost # 安裝最新版
dsh plugin --profile web add dsh-search-boost@0.1.3 # 指定版本
dsh plugin --profile web update dsh-search-boost # 更新
安裝完成後重啓 DSH：
dsh --profile web
驗證插件是否生效：
dsh --profile web --dump-config # web.searchProvider 應爲 dsh-search-boost
若本機沒有全局 dsh 命令（例如只用 npx @deepseek-ai/dsh web 啓動），可先全局安裝，或直接用 npx 執行插件命令：
npm install -g @deepseek-ai/dsh
# 或：
npx --yes @deepseek-ai/dsh plugin --profile web add dsh-search-boost
dsh plugin 依賴 pnpm（npm install -g pnpm 或通過 corepack 啓用）。插件要求 Node >= 22.13。
從源碼安裝（開發場景）：
dsh plugin --profile web add github:Mr-remon219/dsh-search-boost
Linux / macOS 也可使用倉庫內 ./install.sh（Windows 爲 .\install.ps1），腳本會依次做語法檢查、key 配置提示、安裝與驗證。
典型用法¶
零配置起步（free 層）¶
free 層不需要 API key。安裝並重啓後，直接在 DSH 對話中讓 agent 檢索即可——內置 web_search 已走 Bing / DDG / Yahoo / Exa-free 並行鏈。若要顯式限制成本，先切換層：
/web_change free
/web_change show
配置付費 API（api 層）¶
發佈包不含密鑰。在 ~/.dsh-search-boost-keys.json 或項目目錄 ./.search-boost-keys.json 中寫入：
{ "tavily": "tvly-...", "exa": "...", "brave": "..." }
也可通過環境變量 TAVILY_API_KEY、EXA_API_KEY、BRAVE_API_KEY 提供。缺 key 的引擎會自動從並行列表剔除；配一個 key 即可工作，文檔建議配齊三個以獲得最佳融合效果。
切換回完整引擎池：
/web_change api
深度研究與並行調研¶
在對話中讓 agent 調用 deep_research 做分步深研，或調用 research_parallel 將複雜問題拆成子查詢後並行檢索再合併來源。search_stats 可查看當前緩存、引擎分檔與 x_search 憑據狀態。
適用場景與注意¶
適合誰：
- 在 DSH 中頻繁做聯網調研、需要比單引擎更穩定召回的開發者。
- 希望保留內置
web_search/web_fetch引用卡片，又想要多引擎融合、X 搜索、深度研究能力的團隊。 - 想先用
free層零成本驗證，再按需接入 Tavily / Brave / Exa 等付費 API 的用戶。
使用前請注意：
- 插件以 當前 dsh 進程的權限 運行，會發起外部 HTTP 請求、讀取本地憑據文件（如
~/.dsh-search-boost-keys.json）。安裝前應閱讀源碼與 MIT 許可證，確認網絡出口與密鑰存放策略符合你的環境要求。 - SkillHub（目錄頁）是社區插件目錄，與 DeepSeek / 幻方無官方從屬關係；DSH 本身遵循「一切皆插件」理念，具體能力以所選插件爲準。
- 倉庫還提供會話級動態插件
plugin-host.js，適合單次會話試用，不替換內置web_search；部署級集成仍推薦上面的 bundle 方式。 - 維護者記錄了 SSRF 防護行爲：字面量
198.18.0.0/15會被攔截；使用 Clash TUN fake-ip 時可通過DSH_SEARCH_ALLOW_TUN_FAKEIP=0關閉相關放行。
結尾¶
dsh-search-boost 把多引擎融合搜索、頁面抓取、X 檢索與深度研究封裝成 DSH 可直接消費的 bundle 插件，並用 /web_change 在零成本 free 層與完整 api 層之間切換。若你正在 DSH 裏做需要穩定聯網能力的智能體開發，可以按本文步驟安裝驗證。
- SkillHub 目錄頁：https://www.skillhub.cn/plugins/Mr-remon219/dsh-search-boost
- GitHub 倉庫：https://github.com/Mr-remon219/dsh-search-boost
