dsh-deepseek-search

2. 使用

安装并重启后，正常和模型聊天即可。例如：

• “帮我查一下 DeepSeek Harness 最近有哪些值得装的插件，列出来源。”
• “用 web_research 调研一下 2026 年国产大模型 Agent 框架的差异，deep 深度。”
• “把这三篇文章的正文抓下来对比：https://… https://… https://…”

模型会自己选择：

工具	用途
web_search（原生）	普通搜索，返回标题、URL、摘要；现在由本插件的多引擎链提供结果
web_fetch（原生）	打开单个 URL，DSH 自带，带 SSRF 防护与正文转换
web_research	多查询、多引擎搜索 + 抓取前 N 页正文 + 汇总；适合调研
web_collect	批量抓取指定 URL 的正文；适合已有链接
web_engines	查看引擎是否可用、配置路径、当前参数

web_research 参数

参数	说明
query	必填，主题/问题，建议关键词
queries	可选，额外的查询角度，最多 4 组
depth	quick（3 页）/ standard（6 页）/ deep（10 页）
maxPages	可选，1–10，覆盖 depth 的页数
engines	可选，指定引擎 id，如 ["bing","baidu"]

web_collect 参数

参数	说明
urls	必填，1–10 个 http(s) URL
maxCharsPerPage	每页正文上限，1000–50000
includeLinks	是否附带页面内链接

小技巧

• 问“最新/今天/价格/版本号”这类问题时，明确要求“用 web_research 查并给出来源链接”。
• 需要更全的中文资料时，在设置页同时打开百度、搜狗、360。
• 需要英文/技术资料时，填 Tavily 或 Exa 的 Key 并启用；它们的结果通常比网页解析稳定。
• 单页读不到正文时，先试 web_fetch；仍不行再用 web_collect 或换 URL。

---

4. 引擎与配置

引擎

id	名称	类型	默认	说明
bing	必应 Bing	免费	开	默认走 cn.bing.com，可改地址
baidu	百度	免费	开	中文覆盖好；结果条数受反爬影响
sogou	搜狗	免费	开	公众号内容多；跳转壳会自动解析
so360	360 搜索	免费	开	作为中文补充
duckduckgo	DuckDuckGo	免费	关	大陆通常需代理
searxng	SearXNG	自建	关	填实例地址；需实例开启 JSON 输出
tavily	Tavily	API	关	需 TAVILY_API_KEY 或设置页 Key
exa	Exa	API	关	需 EXA_API_KEY
firecrawl	Firecrawl	API	关	需 FIRECRAWL_API_KEY
brave	Brave Search	API	关	需 BRAVE_API_KEY
serper	Serper (Google)	API	关	需 SERPER_API_KEY

配置文件

默认路径：

C:\Users\\.dsh\deepseek-search\config.json

• 也可用环境变量 DSH_DEEPSEEK_SEARCH_CONFIG 指定其他路径。
• API Key 也可以放在环境变量里（配置留空时读取）：TAVILY_API_KEY、EXA_API_KEY、FIRECRAWL_API_KEY、BRAVE_API_KEY、SERPER_API_KEY。
• 参考 config.example.json。修改后可在设置页点“保存”，或直接重启 DSH。

关键字段

{
  "engines": {
    "bing": { "enabled": true, "baseURL": "https://cn.bing.com", "weight": 1 },
    "tavily": { "enabled": true, "apiKey": "", "weight": 1.1 }
  },
  "search": {
    "resultsPerEngine": 10,
    "engineTimeoutMs": 15000,
    "totalTimeoutMs": 30000,
    "maxEnginesPerQuery": 6,
    "cacheTtlMs": 180000
  },
  "fetch": {
    "maxCharsPerPage": 12000,
    "researchMaxPages": 6,
    "concurrency": 3,
    "readerBaseURL": ""
  }
}

• weight 影响 RRF 排序权重，默认必应 1、百度 0.95、搜狗 0.85、360 0.8，API 引擎略高。
• readerBaseURL 可选：正文过短时调用第三方阅读器，支持 {url} 占位符，例如 https://r.jina.ai/{url}。默认关闭。

---

配置文件

默认路径：

C:\Users\\.dsh\deepseek-search\config.json

• 也可用环境变量 DSH_DEEPSEEK_SEARCH_CONFIG 指定其他路径。
• API Key 也可以放在环境变量里（配置留空时读取）：TAVILY_API_KEY、EXA_API_KEY、FIRECRAWL_API_KEY、BRAVE_API_KEY、SERPER_API_KEY。
• 参考 config.example.json。修改后可在设置页点“保存”，或直接重启 DSH。

CI 同款离线测试：解析器、配置、正文提取、输出格式化

node test/offline.test.mjs