前言¶
DeepSeek Harness (DSH) 採用插件化架構，允許開發者通過組合不同插件構建複雜服務。在實際開發中，單一搜索源往往無法滿足所有場景，多源回退與統一策略管理是常見需求。dsh-subscription-search 旨在解決這一問題，它爲 DSH 提供了一個可配置的搜索鏈服務，支持在多個搜索引擎之間自動回退與調用。
這是什麼¶
這是一個 Search-only 插件（dsh-subscription-search@1.3.1），由用戶 shaomingbo 維護。它保持了倉庫/包的身份識別，並使用 DSH Web 提供者 ID subscription-search。與傳統的 OAuth 或憑據管理插件不同，該插件不負責 OAuth 流程、憑據存儲、訂閱用量、模型路由、配額 UI 或 API Key 的錄入，這些職能由 DSH 原生或賬戶插件承擔。
核心功能¶
該插件提供了以下核心能力：
- 搜索鏈服務：提供
searchChain服務，實現協議search-chain/v1。 - 默認搜索鏈：內置默認搜索鏈順序：ChatGPT → Grok → Ollama → Exa → DeepSeek。
- 內置適配器：支持 Exa、DeepSeek 和 Ollama 的內置適配器，通過 DSH 憑證引用解析 API Key。
- 動態註冊：ChatGPT 和 Grok 爲可選適配器，由賬戶插件動態註冊，插件本身可獨立啓動和搜索。
- 鏈管理：管理搜索鏈的排序、啓用標誌、截止時間、回退機制、取消邏輯及診斷信息。
安裝與啓用¶
安裝前請確保運行環境滿足依賴要求。
npx --yes --ignore-scripts github:shaomingbo/dsh-subscription-search#v1.3.3
該命令會將插件安裝到 web 配置文件中。安裝過程需要運行環境中存在精確的 DSH 版本：0.1.2-alpha.3、0.1.2-rc.1 或 0.1.5-rc.1。安裝完成後，需手動重啓 DSH 並強制刷新 Web GUI。
典型用法¶
安裝後，可以通過 CLI 對插件進行操作：
- 查看狀態：
npx --yes --ignore-scripts github:shaomingbo/dsh-subscription-search#v1.3.3 status
- 卸載插件：
npx --yes --ignore-scripts github:shaomingbo/dsh-subscription-search#v1.3.3 uninstall
- 安裝到特定 Profile：
npx --yes --ignore-scripts github:shaomingbo/dsh-subscription-search#v1.3.3 install --profile web
- 本地開發安裝：
若需進行本地開發，可通過環境變量指定源：
DSH_SUBSCRIPTION_SEARCH_SOURCE="link:$PWD" node ./bin/install.js install --profile web
適用場景與注意¶
- 版本要求：必須使用精確的 DSH 版本（
0.1.2-alpha.3、0.1.2-rc.1或0.1.5-rc.1），不兼容其他版本。 - Ollama 適配器：Ollama 適配器需要配置
OLLAMA_API_KEY才能工作，否則該節點將報告不可用並跳過。 - 可選組件：ChatGPT 和 Grok 適配器並非必須，若未安裝對應賬戶插件，插件仍可正常運行。
- 許可證：插件採用 MIT 許可證。
該插件適用於需要構建多源搜索策略的開發者。其設計理念符合 DSH“一切皆插件”的生態，搜索設置僅管理鏈策略與狀態，憑據管理請前往 Accounts & Usage。
