前言¶
DeepSeek Harness（DSH）在聊天里通过 web_search 完成联网检索。若你希望改用 xAI Grok 作为主搜索，并在 Grok 或单一供应商不可用时自动尝试 Tavily、Exa 等补充来源，通常需要单独维护 MCP 后端与配置文件。dsh-grok-search 把 grok-search-rs 接到 DSH 插件体系里：仍在原聊天里搜索，不必再装第二个搜索插件，也不必手改 cordis.patch.yml。
下面介绍该插件的定位、能力、安装步骤与使用注意。事实以 GitHub 仓库 README 与 Releases 为准。
这是什么¶
dsh-grok-search 由 Lain-in-coding 维护，归类为联网工具，当前插件版本 0.1.1（MIT 许可证）。它以 Episkey-G 开发的 grok-search-rs 为 MCP 核心后端，为 DSH 原有的 web_search 提供 Grok 主搜索与 补充来源自动回退。
文中 grok-search-rs 指本机运行的 MCP 搜索后端程序；Grok 主搜索指使用 xAI Grok 模型的搜索服务，两者不是同一概念。插件已验证的 grok-search-rs 程序版本为 0.1.26（指程序版本，不是 Grok 模型版本）。
核心功能¶
搜索路由与回退¶
- 按你在界面里设定的顺序尝试备用来源；也可关闭 Grok 主搜索，仅使用 Tavily、Exa、TinyFish、Firecrawl 等补充来源。
- Grok 主搜索失败但补充来源有结果时，界面会显示「已静默回退」。关闭 Grok 时，从排列好的补充来源依次尝试；拿到第一份有效结果即停止，不会在正常搜索里为「测完」而调用全部供应商。
- 全部候选失败或总预算耗尽时会明确报错，不会自动回到 DeepSeek 官方搜索。
可视化配置¶
插件详情页提供「搜索路由」卡片：DSH 与 grok-search-rs 程序节点横向相连，各搜索来源纵向排列。点击 Grok Search RS 中间节点或任一来源即可配置。
| 来源 | 用途 | 可配置内容（摘要） |
|---|---|---|
| Grok | xAI Grok 主搜索 | 接口协议、Base URL、API Key、模型、网页/X 搜索 |
| Tavily | 补充搜索 | Base URL、多个 API Key |
| Exa、Firecrawl | 补充搜索 | Base URL、API Key |
| TinyFish | 补充搜索 | 搜索与抓取 Base URL、API Key |
| GitHub | 链接解析与认证检测 | Token；不参与补充搜索排序 |
补充来源可拖动排序（或聚焦后 Alt+↑/↓）。「补充来源数」「回退来源数」指结果条数，不是启用的供应商数量。
程序与共享配置¶
- 自动发现本机已有 grok-search-rs 与配置；若无程序，可下载经验证版本到插件缓存，无需手填路径。
- 直接读写与 grok-search-rs 同一份共享配置，已有 Key 与顺序不必重填。
- 用 DSH 插件开关接管或恢复原有搜索；宿主开启热重载时一般无需重启。
测试搜索¶
「测试搜索 → 开始测试」会逐个检查全部已开启的来源和 Tavily 的每个 Key，不会因某一来源成功而跳过其余项。GitHub 单独检测认证或匿名访问。测试与搜索可能消耗供应商额度；grok-search-rs 执行 Grok 主搜索时可能预取补充来源，取消操作也不保证撤回已发出的请求。
支持范围¶
| 系统 | 入口 | 本版本兼容 DSH |
|---|---|---|
| Windows x64 | Desktop | 0.2.1-rc.2 ～ 0.2.1-rc.5 |
| macOS Apple Silicon | Desktop | 同上 |
| Linux x64（WSL Ubuntu 22.04） | CLI/Web | 同上 |
所有组合共用一个安装包。Windows/macOS 的独立 CLI/Web 不在本次支持范围；原生 Linux（非 WSL）完整安装链路验证有限。Node 要求 >=22.0.0。作者已在 Windows 上用真实 Key 实测 Grok 主搜索；macOS 与 Linux 尚未做真实付费接口验收。升级前可核对仓库中的 support-matrix.json。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前应自行查看源码与 MIT 许可证，并理解联网 Key 的费用归属（Grok API 或兼容网关费用另计，不能等同于聊天订阅或网页免费使用）。
方式一：在 DSH 中按名称安装¶
- 打开 DeepSeek Harness，进入左侧 「插件」。
- 点击 「添加插件」，在 「包名或地址」 输入：
dsh-grok-search
- 确认拼写，阅读来源提示，点击 「安装」，等待 「已安装」。
方式二：Release 压缩包本地导入¶
- 在 GitHub Releases 下载
dsh-grok-search-<版本>.tgz（不要下载 Source code 归档）。 - 解压后进入内层
package目录（需能看到package.json、cordis.patch.yml、src）。 - 在 「包名或地址」 填写
file:加该目录绝对路径，例如：
file:C:\DSH-Plugins\dsh-grok-search\package
目录前的 file: 不要省略，否则可能缺少依赖导致插件无法加载。也可直接填写已下载 .tgz 的绝对路径。
CLI/Web¶
在 CLI/Web 环境可执行：
dsh plugin --profile web add dsh-grok-search
下载 grok-search-rs 与调用搜索服务仍需联网；镜像未同步时可改选 npm 官方源或使用 Release 本地导入。
首次配置¶
- 「立即启用」 或打开插件开关，进入详情，确认「搜索路由」卡片与 grok-search-rs 运行中。
- 只用补充来源： 关闭 Grok 主搜索，为 Tavily、Exa 等填写 Key 并开启，可拖动排序。
- 使用 Grok 主搜索： 点击 Grok 行填写 API Key；兼容网关时按服务商填写协议、地址、Key 与模型。
- 「测试搜索 → 开始测试」 确认连通性后，在 DSH 聊天中直接提需要联网的问题。
不必为每个来源都准备 Key；开启 Grok 时也可保留补充来源作备用。
典型用法¶
日常用法即：安装并启用插件 → 在路由界面配置至少一个来源 → 测试通过后照常聊天。需要调整策略时：
- 将 Exa 拖到 Tavily 前并关闭 Grok 主搜索（非关闭整个插件），补充来源会按新顺序接管。
- 某来源额度用尽时，在剩余请求预算内由下一来源完成搜索；Tavily 支持多 Key，特定错误时会尝试同来源下一把 Key。
适用场景与注意¶
适合： 已在用 DSH 0.2.1-rc.2～rc.5，希望用 Grok 或多供应商回退增强 web_search，且愿意在插件 UI 里管理 Key 与顺序的开发者。
注意：
- 插件与 grok-search-rs 优先复用兼容的已有程序，不升级全局安装，也不自动采用未经验证的新版 grok-search-rs。
- 社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系；安装源以 DSH 内提示与 npm / Release 为准。
- 表外平台、入口与新版本 DSH 不作兼容承诺；Desktop 与 CLI/Web 是不同入口，请按自己的环境对照支持矩阵。
结尾¶
dsh-grok-search 把 grok-search-rs 的多来源搜索与静默回退收进 DSH 插件详情页：一个包名安装、一份共享配置、插件开关即可接管或恢复原有网页搜索。进一步了解界面与 FAQ 见仓库 README。
- 目录页：https://www.skillhub.cn/plugins/Lain-in-coding/dsh-grok-search
- GitHub：https://github.com/Lain-in-coding/dsh-grok-search
