前言¶
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。
