Lain-in-coding/dsh-grok-search

dsh-grok-search 是 DeepSeek Harness（DSH）的可视化搜索插件，以 Episkey-G 开发的 grok-search-rs 为 MCP 核心后端，接入 DSH 原有的 web_search。照常在聊天里提问，由插件提供 Grok 主搜索与补充来源回退，安装一个 DSH 插件即可。

• 来源自己选：Grok 主搜索可开可关，Tavily、Exa、TinyFish、Firecrawl 按顺序回退。
• 配置直接填：在界面填写 Base URL 和 API Key，自动发现已有程序，缺少时下载经验证的版本。
• 已有设置接着用：共用 grok-search-rs 配置，Key 可查看、修改，升级后继续保留。
• 搜索过程看得见：查看实际结果来源、搜索日志、链路回放与账户额度。
• 一个开关启停：接管或恢复原搜索，保留网页抓取设置与普通聊天；宿主开启热重载时即时生效。

界面一览

DeepSeek Harness 与「Grok Search Rs」横向相连，搜索来源在右侧纵向排列。每行只有图标、名称和开关，点击图标或名称即可配置。

本页图片与录屏保留真实的 0.2.0 版本标注，不作为 0.2.1 实录。安装流程仍适用，具体界面与行为以安装版本及文字说明为准。

_{深色界面效果图 · 点击查看大图}

浅色主题 · 点击查看大图	深色主题 · 点击查看大图

图中查询、耗时、测试结果和账户额度用于演示界面，不作为性能、免费额度或实测通过的承诺。

准备工作

• DSH：0.2.1-rc.2 ～ 0.2.1-rc.5 或 0.2.2-rc.1，系统与入口见支持范围。
• 至少一个搜索 Key：Grok 或任一补充来源的 API Key；无需全部配置。
• 网络连接：首次安装要下载依赖；没有兼容的 grok-search-rs 时，插件会自动准备程序。

快速开始

当前版本为 0.2.1，可从 npm 或 GitHub Release 安装。两种方式任选其一；已安装的用户可直接看更新已有版本。

方式一：在 DSH 中按名称安装

1. 打开 「插件 → 添加插件」。

2. 在 「包名或地址」 填写下面的名称，阅读来源提示后点击 「安装」：

   dsh-grok-search
   

3. 等待显示 「已安装」，确认包名后进入首次配置。下载进度可在「查看安装详情」中查看。

按完整包名即可定位安装，无需从搜索结果中挑选。若提示已经安装，返回已安装列表打开详情。

安装指定版本： 从 npm 发布列表选择所需版本，填写 dsh-grok-search@版本号，将“版本号”替换成实际已发布的号码。新版本刚发布时，DSH 的安全等待策略可能让裸包名安装到较早版本；下方录屏以 dsh-grok-search@0.2.0 演示，安装后请核对版本，无需关闭安全策略。

_{Windows Desktop 0.2.2-rc.1 · 已发布插件 0.2.0 · 约 13 秒，下载等待标注 ×8，安装成功即结束。
点击动态图观看 1920 像素宽高清 MP4。}

方式二：下载 Release 压缩包后本地导入

适合安装指定版本或安装源尚未同步的情况，直接导入 .tgz 即可，无需解压。

1. 打开 GitHub Releases，在所需版本的 Assets（附件） 下载 dsh-grok-search-<版本>.tgz。请选择插件包，Source code 是源码归档。

2. 复制下载文件的绝对路径。

3. 打开 「插件 → 添加插件」，在 「包名或地址」 粘贴该路径，不加引号。路径格式如下，<版本> 必须换成下载文件的实际版本：

   C:\DSH-Plugins\dsh-grok-search-<版本>.tgz
   

4. 点击 「安装」，看到 「已安装」 后继续首次配置。

_{Windows Desktop rc.5 · 0.2.0 候选包本地导入实录 · 约 15 秒，下载等待标注 ×8，安装成功即结束。
点击动态图观看 1920 像素宽高清 MP4；这是本地安装演示，不是 npm 按名称安装或 Release 下载实录。}

file:C:\DSH-Plugins\dsh-grok-search\package

首次配置

1. 点击 「立即启用」，或打开已安装列表中的插件开关，再进入插件详情。等待 grok-search-rs 程序就绪；已有共享配置会自动读取，没有 Key 时显示「等待配置」。

2. 按需配置来源，填好后保存并开启：

   使用方式	操作
   只用补充来源	关闭 Grok，点击 Tavily、Exa、TinyFish 或 Firecrawl，填写对应 API Key
   使用 Grok 主搜索	点击 Grok，填写 API Key；官方接口可保留默认地址，兼容网关按服务商要求选择协议并填写 Base URL 和模型

3. 点击 「测试搜索 → 开始测试」，检查已开启来源的连通性。

4. 确认接管：回到聊天，发起一个需要联网的问题。出现 web_search 后展开搜索步骤，查看「由 dsh-grok-search 执行 · 实际来源」；回到插件详情，还能看到对应的「最近搜索」记录。无需一直开着设置页，也无需在提问时点名插件。

是否发起 web_search 由 DSH 的对话与工具调用决定；普通聊天没有触发搜索时，不会产生搜索记录。诊断测试也不写入最近搜索。保存前请了解共享配置的影响。

dsh plugin --profile web add dsh-grok-search

更新已有版本

正常更新不用重填 Key、不用清缓存，也不用重新安装兼容的 grok-search-rs。 配置和程序缓存与插件包分开保存；请继续使用原来的 DSH 配置环境，不要清空应用数据。

准备升级到 DSH 0.2.2-rc.1？先选择已发布且声明支持该宿主的插件版本，再更新 DSH。 插件 0.2.0 已加入该宿主支持；旧插件 0.1.1 不支持。若已经更新 DSH，直接安装兼容版本，不要通过忽略版本检查强行启用。

DSH 0.2.2-rc.1：优先在插件面板内更新。 从 npm 按包名安装的用户：

1. 打开 「插件 → 已安装 → dsh-grok-search」，「版本」 区域会自动检查；需要时点击 「重新检查」。
2. 选择兼容版本，点击 「更新到 …」，等待更新完成；不需要手动卸载再安装。
3. 确认显示的新版本、原有配置和开关；仅在 DSH 提示需要重启时重启。

查不到新版本时，先核对安装源及发布等待提示；不要清缓存或强行忽略兼容检查。本地目录、Git 或 .tgz 来源不一定具备此更新入口，可用下面的方式。

更新失败时，DSH 0.2.2-rc.1 会尝试恢复旧包，但恢复本身也可能失败。先查看更新结果，必要时用兼容当前宿主的已发布 .tgz 恢复；不要删除配置或缓存。

Windows Desktop 0.2.2-rc.1 已在隔离测试源验证 0.2.0 → 0.2.1 面板更新，无需重启；原开关状态、Key 配置和程序缓存保留，下载校验失败、启动失败及下载取消后可恢复旧版。0.2.1-rc.5 的 0.1.1 → 0.2.1 原地导入、重启与配置保留也已验证。这些测试不保证所有网络故障下都能恢复。新版插件包需要下载，已有兼容的搜索程序继续复用。

支持范围

下表列出兼容范围与累计宿主证据；不表示每个候选安装包都已在所有组合重新实测。各版本的验证依据与未覆盖环境见支持矩阵。

• 共用一个安装包。rc.4 Desktop 的关键宿主源码与已测 rc.3 / rc.5 一致，未单独实测官方 rc.4 桌面发行包。
• 版本分别看：DSH、DSH Plugin Hub 和 dsh-grok-search 各自独立编号。插件 0.1.1 不支持 DSH 0.2.2-rc.1；插件 0.2.0 同时支持表中旧宿主与新宿主。真正的 DSH 0.1.0 不在本项目支持范围，新旧版本不会自动互相兼容。
• 区分入口：Windows/macOS 的独立 CLI/Web 不在本次支持范围；Linux 使用 WSL 验证，macOS 使用自动化测试环境。
• 操作系统版本：Windows 11 x64、macOS 15 Apple Silicon、WSL Ubuntu 22.04 是现有验证环境；DSH 版本兼容不等于所有操作系统版本已实测。Windows 10 与原生 Linux 桌面的文件打开尚无实机验证。
• 运行时要求：DSH 0.2.2-rc.1 需要 Node.js ≥ 24.9；Desktop 自带运行时，CLI/Web 用户须自行满足此要求。插件没有自动升级全局 Node.js。
• 复用已有后端：已验证 grok-search-rs 程序版本为 0.1.26；优先复用兼容安装，缺少时准备私有缓存，不升级全局程序或自动采用未经验证的版本。
• 升级 DSH 前核对支持矩阵。超出范围时宿主可能跳过插件、按原设置搜索；表外平台与版本不作兼容承诺。

原生 Linux、真实付费服务等验证边界见常见问题。

来源与排序

每行只保留图标、名称和开关，点击图标或名称打开配置弹窗。

拖动补充来源调整顺序，也支持聚焦后按 Alt+↑/↓。「补充来源数」「回退来源数」指结果条数，不是供应商数量；设为 4 不表示调用四家。

静默回退

例如 Tavily → Exa → TinyFish → Firecrawl：Tavily 报错、Exa 返回结果，本次搜索便由 Exa 完成。Tavily 有多个 Key 时，遇认证、限流等特定错误还会尝试下一把 Key。回退由故障触发，不主动探测余额，也不会永久跳过某个来源。

_{0.2.0 旧版离线示意：展示异常与路由动效，不作为实际搜索回退的证据 · 点击观看高清 MP4。}

测试搜索

「测试搜索」会逐个检查全部已开启且已配置的来源和 Tavily 的每个 Key，不会因为某个来源成功就跳过其余来源。GitHub 仅在已填写 Token 且开启检测时单独检查认证，不参与补充搜索。

Grok 单项测试不额外调用补充来源，也不修改共享配置；上游未提供明确错误状态时，可能补发一次限时的 Grok 诊断请求。测试显示各来源是否可用； 只有真实搜索发生回退时，才显示「已静默回退」。

测试时显示已完成项、当前来源和等待秒数，可随时点击「停止测试」。每个独立请求遵守共享超时配置和插件预算，整轮逐项测试可能超过两分钟；空结果会明确标注，不当作 Key 失效。

真实搜索共用一次总预算（默认 120 秒，含排队与回收）。有可用备用来源时会预留回退时间，慢来源不会独占插件直接管理的回退窗口；全部未返回可用结果时明确结束，不无限重试，也不自动切到官方付费搜索。上游内部预取仍由 grok-search-rs 管理。

图标点亮表示已配置并开启，Key 可用性以测试结果为准。右上角图标与小圆点显示最近一次测试；出错来源短暂红边、轻颤，并显示简短原因，如 403 · 访问被拒绝。

日常搜索拿到有效结果就停止；测试搜索会逐项检查。 两者都可能消耗供应商额度，见隐私与费用。

最近搜索与账户额度

最近搜索：看清结果来自哪里

插件启用后自动记录当前 DSH profile 的搜索。一个查询一条日志，最多显示最近 20 条；同一次 web_search 中的多个查询分别展示。

• 摘要展示时间、搜索内容、结果、耗时和来源链路；展开查看「服务、调用、结果、消耗」。
• 按成功、回退、失败筛选；点眼睛隐藏内容，点「清空记录」清除。
• 切换页面保留，停用插件或退出 DSH 后清空，仅存在内存中，不写入磁盘。
• 聊天搜索步骤也会标出实际来源。过期、已清空或无法关联的调用显示「本次来源未记录」。

_{来源、结果与消耗放在同一条记录中；示例数据不代表真实账户或测试结论。}

链路回放：重新看一遍搜索路径

点击已完成记录的 「回放」，上方路由图会重现结果链路。回放只播放动画，不重新搜索、不消耗额度、不修改配置或 Key 状态。

内部回退依据 grok-search-rs 返回的标签展示实际供应商和官方图标；多来源结果分别展示，缺少标签时显示「来源未报告」。动画表达已知的结果路径，不还原原始网络时序，也不据此推算调用次数、使用的 Key 或费用。

_{回放结束后恢复当前配置，可点击「返回该条日志」继续查看明细。}

账户额度：打开弹窗自动查询

打开已配置的供应商弹窗即自动查询，30 秒内重开复用同一账户缓存，过期后自动刷新；也可以手动刷新。

自定义 Base URL 同样尝试查询；失败时显示原因和已获得的 HTTP 状态，可点击重试，刷新失败时保留并标明上次结果。当前表单的 Base URL 和 Key 无需先保存即可查询，查询不写配置，取消不会保存草稿。「服务控制台」始终打开对应供应商的官方控制台，自定义服务的余额以该服务提供方为准。

账户额度可能含其他应用的调用，不等于本次搜索消耗。 日志只展示接口实际报告的消耗，缺失显示「未报告」，说明收在旁边的圆形提示图标中，不按余额差值推算。

_{已用与剩余并列展示；图中 126 / 874 credits 为演示数据，实际额度以服务商返回为准。}

共享配置

本插件与 grok-search-rs 读写同一份配置文件，不另存第二份 DSH Key 配置。

• 位置：默认在用户目录的 .config/grok-search-rs/config.toml，也可由 GROK_SEARCH_CONFIG 指定。页底「Grok 共享配置」显示实际位置，支持打开文件、所在文件夹或复制路径。
• 影响范围：保存 Key、补充来源顺序和开关会修改共享文件。Grok 主搜索与 GitHub 检测开关只对当前 DSH 生效，关闭不删除凭据。
• 生效时机：保存通常在下一次搜索生效，在途请求保持原配置。正常退出、重开和升级保留已保存的 Key；未保存草稿不写入。其他 MCP 客户端按各自机制重读配置。

共享文件的修改也会影响使用它的其他 MCP 客户端。 配置历史与凭据保护见隐私与费用。

启停与排错

日常请只使用 DSH 已安装列表里的插件开关：关闭即恢复原搜索设置，重新开启由 dsh-grok-search 按当前来源设置接管。宿主没有启用热重载时，会提示需要重启。

DSH 的插件开关与详情中的组件开关是两层独立设置。若插件已启用，但组件被单独关闭，请手动将组件重新打开；卸载重装不会清除这条组件设置。

隐私与费用

配置历史可能包含明文 Key/Token。 grok-search/config-history/ 保存修改前的完整配置，删除当前 Key 不会擦除历史中的旧值。请保护配置与历史文件，不要提交到 Git、上传公开网盘或附在问题反馈中。

• 查询去向：搜索内容会发送给实际使用的服务或自定义网关；回退时，同一查询可能依次发给多家。
• 设置页访问：搜索正文、账户额度和明文 Key 仅经已认证的本机直连或 HTTPS 读取。远程 HTTP 只展示脱敏配置，禁止查看、复制、提交明文 Key 或修改服务地址。
• 额度查询：只请求对应配置地址，不跟随重定向，也不把自定义服务的 Key 转发给官方。
• 费用：搜索和诊断均可能消耗额度。Grok API 或兼容网关按各自规则计费，聊天订阅不等于免费 API。主搜索可能预取补充来源；失败、超时或取消仍可能产生费用。

常见问题

开发与反馈

开发建议 Node.js ≥ 24.9，与最新支持宿主一致。按锁文件安装依赖，再构建、测试和打包：

npm ci --ignore-scripts --legacy-peer-deps
npm run build:client
npm run test:all
npm run pack:release

pack:release 使用 npm pack --ignore-scripts，不会触发 prepack，因此构建和测试需要单独执行。产物与校验回执位于 artifacts/release-package/<运行编号>/；打包不等于发布。文档图片和录制脚本不随 npm 插件包分发。

反馈时请附系统、DSH 与插件版本、grok-search-rs 程序版本、模型名称（如有）、错误码及复现步骤；不要附 Key、完整配置或未脱敏路径。

提交问题 · 版本说明 · MIT 许可证

用着还行？欢迎点个 Star，或通过 Issue 分享建议。

致谢

感谢 Episkey-G 创建并维护 grok-search-rs（MIT 许可证）。这个 Rust 编写的 MCP 搜索后端是本插件 Grok 主搜索能力的基础；我们在其之上提供 DSH 原工具接入、可视化配置、多来源回退和进程管理。

如果你也想在其他 MCP 客户端使用这些能力，欢迎阅读 grok-search-rs 的使用说明，了解上游的功能与更新。两个项目独立维护。

感谢 LINUX DO 提供技术交流与开源分享的社区空间。