前言¶
在 DeepSeek Harness (DSH) 開發智能體時，搜索能力的穩定性和可控性往往是個難題。現有的方案要麼依賴動態加載（在定義智能體作用域時不可靠），要麼缺乏統一的配置入口。dsh-search-hub 插件提供了一套持久化、智能體可見的多通道搜索方案，解決了智能體在執行任務時無法穩定獲取外部信息的問題。
插件介紹¶
dsh-search-hub 是一個爲 DeepSeek Harness (DSH) 設計的插件，由開發者 FuLuTang 維護，採用 MIT 許可證。它是一個 Host-only bundle，通過 dsh.bundle.patch 機制在安裝時掛載配置服務，爲智能體提供多通道網絡搜索能力。
核心功能¶
該插件提供以下核心能力：
* 多通道搜索：支持 Exa 語義搜索、DuckDuckGo Lite 回退以及 xAI Grok 集成。
* 併發執行：通過 multi_search 工具同時運行選定的搜索通道。
* 持久化配置：搜索通道配置基於配置文件作用域管理。
* 智能體可見性：工具通過持久化的 agent-preset 組成，確保模型可見。
安裝與啓用¶
插件安裝需要通過 DSH 的插件命令進行。
- 安裝插件
在終端執行以下命令安裝插件：
dsh plugin add dsh-search-hub
- 配置 Agent Preset
由於 DSH rc.6 動態 Cordis 工具在定義智能體作用域中不可靠，實際可用的搜索工具通過持久化的 agent-preset 提供。安裝後，需要將插件打包中的preset/模板複製到指定目錄：
# 複製模板到 DSH 的 agent-preset 目錄
cp -r <plugin_dir>/preset/* ${DSH_HOME:-$HOME/.dsh}/.agent-presets/search-hub/
- 驗證與重啓
安裝完成後，需要重啓 DSH，然後在新的智能體會話中選擇 Search Hub 預設。啓動後，使用search_channels命令驗證模型可見的工具目錄。
典型用法¶
插件提供了以下主要工具，用於管理和執行搜索任務：
-
search_channels
用於查看可用的搜索渠道及其當前配置。輸出內容包含渠道名稱、角色（如語義搜索、回退）以及成本/密鑰要求。這是安裝後驗證配置的第一步。 -
multi_search
運行選定的搜索通道。該工具接受一個或多個渠道名稱作爲參數，並在進程內併發執行搜索請求。默認情況下，它會使用免費的exa-anon和ddg渠道。 -
configure_key
用於存儲 xAI API 密鑰。該命令通過 DSH 憑據服務將密鑰存儲在環境變量XAI_API_KEY下，且不會在終端回顯密鑰明文。 -
check_balance
用於檢查 xAI 密鑰及配置狀態。由於 xAI 不提供穩定的公共餘額端點，該工具僅能通過觀察 Grok 請求的執行情況來判斷狀態，不會虛構賬戶餘額。
適用場景與注意¶
適用場景：
* 需要 X/Twitter 或長尾內容覆蓋時，使用 grok 渠道。
* 需要結構化 URL 和引用摘要的語義搜索時，使用 exa-anon。
注意事項：
* 網絡路由：該插件沒有代理 UI 和代理覆蓋功能。網絡路由直接遵循機器上 curl.exe 的連接能力。如果本地無法訪問某些渠道，需要手動配置 Clash 或系統代理（如 TUN 規則）。
* xAI 集成：目前不存在獨立的 xAI 搜索端點，Grok 的搜索功能依賴於 xAI 的 Web Search 和 X Search 工具，其調用成本約爲 $5/1k 次搜索。
* 配置安全：不要在 YAML 文件、Git 倉庫或聊天記錄中明文存儲 API 密鑰，必須通過 configure_key 或 DSH 的憑據設置界面進行管理。
* 僅主機包：當前版本爲 Host-only bundle，完整的渠道設置頁面仍需等待 Web profile 集成完成。
結語¶
dsh-search-hub 通過將搜索能力封裝爲持久化的工具集，解決了 DSH 智能體在信息獲取上的穩定性問題。其模塊化的通道設計和基於配置文件的設置機制，爲開發者提供了靈活的搜索策略控制能力。
