dsh-search-enhance

配置

启动 DSH 后，打开：

设置 → 插件 → 插件配置 → dsh-search-enhance

第一次使用时，优先完成 Grok 搜索配置；其他选项可以先保持默认。

1. 配置 Grok 搜索

至少确认以下三项：

配置项	说明
接口地址	xAI 官方地址或第三方 Grok 服务地址
模型	该服务实际支持的 Grok 模型名称
Grok 密钥	在页面的“凭据”区域填写

页面还可以选择请求协议、思考等级和超时时间。请求协议需要与所使用的服务保持一致：

• completions：使用聊天补全接口；
• responses：使用 Responses 接口。

默认的 Grok 密钥名称是 SEARCH_API_KEY。密钥值只填写在“凭据”区域，不要写进接口地址或普通配置项。

2. 配置补充来源

这些服务不是完成主搜索的必要条件，可以按需要配置：

服务	用途	默认密钥名称
Context7	查找库和框架文档	CONTEXT7_API_KEY
Exa	补充文档和网页结果	EXA_API_KEY
Tavily	补充搜索、读取网页和发现站点页面	TAVILY_API_KEY
Firecrawl	补充搜索和读取网页	FIRECRAWL_API_KEY

在“补充 Provider”中填写服务地址，在“凭据”中填写对应密钥。没有配置的服务会被跳过，不影响已经配置好的搜索来源。

3. 配置搜索方式

页面可以设置默认搜索类型和搜索深度：

• compact：结果更简短；
• normal：信息量适中；
• deep：适合需要更多来源的问题。

不确定时保持默认值即可，也可以在单次搜索中临时选择其他设置。

“工具披露模式”建议保持 progressive，让工具按任务需要逐步出现；只有明确希望一开始显示全部搜索工具时才选择 all。

4. 配置网页代理

代理设置位于：

补充 Provider → 高级 Provider 设置 → 网页提取代理

smart_direct 和 direct 可以分别填写代理地址，例如：

http://127.0.0.1:7890

留空表示不使用该项代理。这里只支持不带账号密码的 http:// 地址，不支持 HTTPS 或 SOCKS 代理，也不会自动读取 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY。

direct 使用代理时需要 Node.js 24.5 或更高版本。

5. 保存并重启

点击“保存配置”后重启 DSH：

dsh web

重启后，新配置才会用于搜索。

1. 配置 Grok 搜索

至少确认以下三项：

配置项	说明
接口地址	xAI 官方地址或第三方 Grok 服务地址
模型	该服务实际支持的 Grok 模型名称
Grok 密钥	在页面的“凭据”区域填写

页面还可以选择请求协议、思考等级和超时时间。请求协议需要与所使用的服务保持一致：

• completions：使用聊天补全接口；
• responses：使用 Responses 接口。

默认的 Grok 密钥名称是 SEARCH_API_KEY。密钥值只填写在“凭据”区域，不要写进接口地址或普通配置项。

2. 配置补充来源

这些服务不是完成主搜索的必要条件，可以按需要配置：

服务	用途	默认密钥名称
Context7	查找库和框架文档	CONTEXT7_API_KEY
Exa	补充文档和网页结果	EXA_API_KEY
Tavily	补充搜索、读取网页和发现站点页面	TAVILY_API_KEY
Firecrawl	补充搜索和读取网页	FIRECRAWL_API_KEY

在“补充 Provider”中填写服务地址，在“凭据”中填写对应密钥。没有配置的服务会被跳过，不影响已经配置好的搜索来源。

3. 配置搜索方式

页面可以设置默认搜索类型和搜索深度：

• compact：结果更简短；
• normal：信息量适中；
• deep：适合需要更多来源的问题。

不确定时保持默认值即可，也可以在单次搜索中临时选择其他设置。

“工具披露模式”建议保持 progressive，让工具按任务需要逐步出现；只有明确希望一开始显示全部搜索工具时才选择 all。

4. 配置网页代理

代理设置位于：

补充 Provider → 高级 Provider 设置 → 网页提取代理

smart_direct 和 direct 可以分别填写代理地址，例如：

http://127.0.0.1:7890

留空表示不使用该项代理。这里只支持不带账号密码的 http:// 地址，不支持 HTTPS 或 SOCKS 代理，也不会自动读取 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY。

direct 使用代理时需要 Node.js 24.5 或更高版本。

使用

安装并配置完成后，直接在 DSH 中描述需求即可，例如：

搜索最近的相关信息，并列出来源。

查找这个库当前版本的官方 API 用法。

读取并总结 https://example.com/page 的正文。

对这个问题做多来源核对，并说明各来源是否一致。

使用提示

• 网页正文读取不会执行页面 JavaScript，也不能处理登录、验证码或浏览器会话。
• 网页读取可以访问 DSH 所在机器能够访问的地址；在敏感网络中只处理可信链接，并配合网络访问限制。
• 如果配置页面没有出现，先用 dsh plugin --profile web list --depth 0 确认 npm 包已经安装，然后重启 DSH 并强制刷新浏览器。