前言¶

在 DeepSeek Harness（DSH）里做带联网的智能体，常见矛盾是：模型侧已有 web_search、web_fetch 等原生工具名，但官方搜索往往走单一提供方，且一次检索可能占用辅助模型回合与 token；中文场景又希望必应、百度、搜狗等多源交叉，并能把「搜到链接 → 读正文 → 汇总出处」收成一步。

社区插件 dsh-deepseek-search（维护者 a2042798096-debug）面向上述需求：在桌面端注册 deepseek-search 提供方，默认并行免费 HTML 引擎，可选 Tavily/Exa 等 API，并扩展 web_research、web_collect、web_engines。下文按「是什么 → 能做什么 → 怎么装 → 怎么用」说明，事实以仓库 README 与包元数据为准。

这是什么¶

DeepSeek 搜索是 DSH 的「联网工具」类插件，仓库 a2042798096-debug/dsh-deepseek-search，许可证 MIT，当前包版本 1.1.0（见 package.json）。安装后通过 cordis.patch.yml 将 web.searchProvider 切到 deepseek-search，web_search 工具名与参数不变，背后改为多引擎搜索链；网页抓取仍走 DSH 的 ctx.web.fetch()，默认固定 http 提供方。

与原版 DSH 网页搜索相比：原版多为 deepseek-official 或 deepseek-search-api 单一来源；本插件聚合多引擎、免费路径默认不消耗 DeepSeek 模型 token（直接 HTTP），并支持失败隔离与直连失败时回退到 ctx.web.fetch()。

插件目录页：SkillHub - dsh-deepseek-search。

核心功能¶

原生工具兼容¶

• web_search：自动使用本插件的多引擎链，已有提示词、技能、工作流无需改工具名。
• web_fetch：仍由 DSH 提供，带 SSRF 防护与正文转换；本插件不替换其对外接口。

扩展工具¶

搜索引擎¶

默认开启国内可直连的 必应、百度、搜狗、360；Tavily、Exa、Firecrawl、Brave、Serper 需 API Key；DuckDuckGo、SearXNG 默认关闭。README 说明：部分大陆网络下 Google、DuckDuckGo、Brave、SearXNG 公共实例可能超时，故未设为默认。

合并策略：并行请求已启用引擎，按 URL 去重，加权 Reciprocal Rank Fusion（RRF）排序；多引擎共同命中会加分。搜狗/360 等 /link 跳转壳会解析为真实地址。

成本与隐私取向¶

• 默认四个免费引擎发 HTTP，不走「辅助模型回合」；仅你启用的 API 引擎消耗对应服务商额度。
• 查询发往你启用的引擎/API，README 写明不发往作者服务器、无遥测；Key 存本机配置或环境变量。
• 设置页可单独关引擎，并提示数据流向。

中文设置页¶

路径：设置 → DeepSeek 搜索。可开关引擎、填写 API Key、调整超时与正文上限、使用已保存配置做「试搜」。

安装与启用¶

插件以当前 DSH 进程权限运行，安装前建议阅读仓库源码与 MIT 许可证。README 要求 Node >= 20（包 engines 字段）。

同一时间只建议用一种安装方式；重复安装前先卸载。

方式 A：安装脚本（README 推荐）¶

1. 将插件目录放到本机（例如从 GitHub Releases 或目录页提供的获取方式得到源码目录）。
2. 完全退出 DeepSeek Harness（退出进程，非仅最小化到托盘）。
3. 双击目录下的 安装.cmd，或在 PowerShell 中执行：

powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1

4. 脚本以 link: 方式装入 desktop profile 并打印验证结果。
5. 重新启动 DSH，打开 设置 → DeepSeek 搜索，点「试搜」确认引擎可用。

方式 B：手动 link 安装¶

按实际路径修改后执行：

$dsh = "D:\deepseekharness\resources\runtime\cli\bin\dsh.cmd"
$plugin = "C:\path\to\dsh-deepseek-search"
& $dsh plugin --profile desktop add "link:$($plugin -replace '\\','/')"

DSH 安装位置不同时，将 $dsh 改为本机 resources\runtime\cli\bin\dsh.cmd 路径。

方式 C：DSH 插件页本地安装¶

1. 打开 设置 → 插件。
2. 选择「从本地目录安装 / 安装本地插件」。
3. 选中插件目录，安装后重启。

安装完成后，profile 的 package.json 会加入 dsh-deepseek-search 依赖与 bundle；插件内补丁会切换 web.searchProvider。

若设置里没有「DeepSeek 搜索」：确认已重启、插件已启用，并检查 profile 中是否包含该包（README 故障排查节有进一步说明）。

典型用法¶

安装并重启后，在对话中直接描述需求即可，模型会选用合适工具。README 示例：

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

需要更可控的调研时，可点名 web_research 并了解主要参数：

web_collect：urls 必填（1–10）；maxCharsPerPage 1000–50000；includeLinks 控制是否附带页内链接。

小技巧（来自 README）：问「最新/今天/价格/版本号」时可要求「用 web_research 查并给来源链接」；中文资料可在设置页同时开百度、搜狗、360；英文/技术向可启用 Tavily 或 Exa。

配置要点¶

默认配置文件路径：

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。

设置页「抓取与结果设置」可调：每引擎结果数、单引擎/整次搜索超时、每页正文上限、深度收集默认页数、缓存时间等。readerBaseURL 可选，正文过短时可调用第三方阅读器（支持 {url} 占位符），默认关闭。

适用场景与注意¶

更适合：

• 需要中文多源结果与交叉验证；
• 希望免费引擎路径少占模型 token，或模型无稳定官方搜索额度；
• 需要一次读多页、调研并输出带出处的材料；
• 愿意用 Tavily/Exa 等 API 换更稳的英文/技术检索。

仍宜用原版 DSH 网页搜索的情况（README 对照表）：

• 要求查询只到 DeepSeek、不接受第三方搜索引擎；
• 已稳定使用官方 API 额度并信任官方结构化结果；
• 只需单页 web_fetch，不需批量收集；
• 不愿依赖免费 HTML 解析稳定性，也不想配置 API 引擎。

安全与边界： 搜索与抓取受你启用的第三方与 DSH ctx.web.fetch() 策略约束；工具输出会标注外部网页不可信。插件不执行网页脚本，不解析 PDF/压缩包/音视频。引擎可能因反爬、改版或网络失败；可在 web_engines 查看「最近错误」。

DSH 生态强调「一切皆插件」；SkillHub 为社区目录，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-deepseek-search 在保留 web_search / web_fetch 的前提下，把联网做成可配置的多引擎搜索链，并用 web_research、web_collect 把「查 + 读 + 汇总」收成少量工具调用。若你正在 DSH 桌面端做中文调研或想降低搜索侧的模型 token 消耗，可从设置页试搜起步，再按场景启用 API 引擎。

• 目录页：https://www.skillhub.cn/plugins/a2042798096-debug/dsh-deepseek-search
• GitHub：https://github.com/a2042798096-debug/dsh-deepseek-search