前言¶
在 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 智能体在信息获取上的稳定性问题。其模块化的通道设计和基于配置文件的设置机制，为开发者提供了灵活的搜索策略控制能力。
