前言¶
在 DeepSeek Harness（DSH）裏，智能體常用內置的 web_search 做聯網檢索。多個後端可以並存，但優先級、API 密鑰和各家參數往往分散在環境變量或不同插件裏，改順序或換源時要動配置、重啓或查文檔。維護者 Breeze-04 的 dsh-search-order 屬於社區目錄中的「聯網工具」類插件：在 DSH 設置裏用可視化面板管理 web_search 的搜索源列表、從上到下的嘗試順序，以及各源的密鑰與端點；某一源失敗時自動嘗試下一個。下面介紹它的定位、能力與安裝用法。
這是什麼¶
dsh-search-order 是 DSH 官方 web_search 工具的可視化配置面板。你在界面裏增刪、拖拽排序搜索源，用齒輪按鈕填寫各源的 API key、endpoint 和專有參數；改動即時保存，下一次搜索即生效。內置源包括 DeepSeek 官方搜索、DeepSeek Messages、Exa、Tavily、Perplexity、Brave Search；已安裝的其他搜索類插件提供的源也可以加入列表。插件當前版本爲 0.1.0，採用 MIT 許可證；GitHub 倉庫：https://github.com/Breeze-04/dsh-search-order，目錄頁：https://www.skillhub.cn/plugins/Breeze-04/dsh-search-order。
核心功能¶
順序與失敗切換¶
在面板中把搜索源按優先級從上到下排列。執行 web_search 時按序調用；當前源失敗則自動嘗試列表中的下一個。默認順序爲 DeepSeek 官方搜索 → DeepSeek Messages（可在面板中修改）。
密鑰與參數¶
各源通過面板內的齒輪配置 API key、endpoint 及源特有參數。密鑰由 DSH 的 credential store 管理；也支持各源對應的環境變量。DeepSeek Messages 可使用 DSH 賬號登錄，無需單獨填 key。
DeepSeek 官方搜索的文本深度¶
對 DeepSeek 官方搜索可選取返回文本深度：
- Default：短摘要片段
- +summary：較長摘要
- +content：頁面正文
擴展其他插件源¶
除上述六種內置源外，可將本機已安裝的其他搜索插件所註冊的源加入同一列表，與內置源一起排序與 fallback。
安裝與啓用¶
環境要求（來自倉庫說明）：DSH 版本 >=0.2.0-rc.1 且 <0.3.0，且 dsh、pnpm 已在 PATH 中。該插件面向 web profile 客戶端注入設置界面。
從 GitHub 直接安裝：
dsh plugin --profile web add github:Breeze-04/dsh-search-order
若使用本地解壓目錄或 checkout 路徑（勿在介紹流程中依賴 git clone 作爲讀者必做步驟），可改爲：
dsh plugin --profile web add <absolute-path-to-plugin-directory>
安裝完成後，在 DSH 中打開 Settings → Plugins → dsh-search-order 即可進入配置面板。
典型用法¶
- 打開 Settings → Plugins → dsh-search-order。
- 添加需要的搜索源，並從上到下拖成期望的優先級順序。
- 點擊每個源旁的齒輪，填寫該源的 key、endpoint 及參數（未配置的源可能在運行時失敗並被跳過）。
- 若使用 DeepSeek 官方搜索，在對應項中選擇 Default、+summary 或 +content。
- 保存後無需額外步驟；下一次 Agent 調用
web_search即按新順序與配置執行。
API 密鑰優先走 DSH 憑證存儲；與文檔一致的環境變量方式仍可用作補充。
適用場景與注意¶
適合誰： 需要在 DSH 裏統一編排多個聯網搜索後端、希望失敗自動換源、且不想手改多份環境變量的開發者與 Agent 配置者。
運行與信任： 插件隨 DSH 進程以當前用戶權限運行，會參與 web_search 的路由與密鑰讀寫。安裝前建議在 GitHub 查看源碼與 MIT 許可證，確認 credential 用法符合你的安全策略。
版本邊界： package.json 中 engines.dsh 限定爲 >=0.2.0-rc.1 <0.3.0，升級 DSH 大版本前請覈對插件是否仍兼容。
生態說明： DSH 採用「一切皆插件」的擴展方式；SkillHub 等社區目錄由社區維護，與 DeepSeek / 幻方無官方從屬關係，本文所述安裝命令與能力均以倉庫 README 爲準。
結尾¶
dsh-search-order 把 DSH 原生 web_search 的多源搜索收斂到一個可排序、可配密鑰的設置面板，並內置 DeepSeek 官方搜索到 Brave 等常見後端及失敗切換邏輯。需要試用或查看更新時，可訪問目錄頁 https://www.skillhub.cn/plugins/Breeze-04/dsh-search-order 與倉庫 https://github.com/Breeze-04/dsh-search-order。
