前言¶

DeepSeek Harness（dsh）采用插件化架构，将各种能力以插件形式挂载到 ctx.web 之上。在开发或使用 DSH 时，如果需要从全网检索信息或抓取网页正文，通常会用到内置的 search 与 fetch provider。官方计费的 deepseek-official 搜索在成本控制上并不友好，而许多第三方免费插件在多引擎支持、结果过滤与抓取噪声处理上又各有限制。

wsjb114514/dsh-plugin-free-web 是一个免编译、零依赖的本地预编译插件，直接打包好 dist/index.js 与自动接管配置 cordis.patch.yml，安装一次后即可自动接管 ctx.web.search 与 ctx.web.fetch，将搜索与抓取能力切换为免费、多引擎并行、带噪声过滤的方案。

是什么¶

这是一个为 DeepSeek Harness 打包好的本地插件，包含预编译的 dist/index.js 与自动覆盖配置 cordis.patch.yml。安装后，插件会自动禁用官方计费的 deepseek-official 搜索，并将 searchProvider 设为 free-search-pfw、将 fetchProvider 设为 free-fetch-pfw。这两个 provider 的 ID 带有 -pfw 后缀，可与其它使用相同 free-search/free-fetch 注册名的免费 web 插件共存，不会触发 WEB_DUPLICATE_PROVIDER。

插件提供两种核心能力：多引擎并行竞速搜索与增强型免费网页抓取。

核心功能¶

多引擎并行竞速搜索（free-search-pfw）¶

• 支持的搜索引擎：
• 360 搜索：中文查询精度较高，作为中文首选。
• Bing：英文/全球查询首选，使用 www.bing.com 并设置 setlang=en，可命中 GitHub、官方文档等原始资料。
• DuckDuckGo：作为兜底，因本机常被限流，默认排在最后。
• 语言自动分流：
• 中文查询优先走 360，英文查询优先走 Bing。
• 任一引擎失败时自动切换到另一个，互为兜底。
• 并行竞速与提前返回：
• 多个引擎同时发起请求，拿到优质结果后立即返回，不等待慢引擎超时。
• 相关性闸门：
• 搜索引擎偶尔会对某些 IP 返回与查询无关的「串号」结果（HTTP 200、结构正常）。
• 当结果集的相关性低于阈值时，判定该引擎失效，切换到下一个引擎，不把垃圾结果交给模型。
• 引擎熔断：
• 对连续失败的引擎（如被限流的 DuckDuckGo）进行短期跳过，避免每次搜索都等待超时。

增强型免费网页抓取（free-fetch-pfw）¶

• 默认使用 Jina Reader（r.jina.ai）将网页提取为干净的 Markdown 正文。
• Jina 不可用时回退原生 HTTP，并自动将 HTML 转为纯文本，避免把大量标签噪声交给模型。
• 导航噪声剥离：
• GitHub 等站点的导航菜单可能占用页面 90% 以上的字符。
• 插件会剥离导航噪声，只保留正文内容（实测 GitHub 仓库页 100000 字符 → 约 5000 字符正文）。
• 内置校验与容错：
• 拒绝空 URL、非 http(s) URL 以及包含内嵌账号密码的 URL。
• 对网络瞬时故障进行重试。
• 对 Unicode 码点进行安全截断，避免截断后产生乱码。

安装与启用¶

安装方式任选其一。

方式 A：从 GitHub 一键安装（推荐）¶

在 DeepSeek Harness 聊天框中发送：

请调用 plugin_manager 工具（action: install_bundle）帮我安装这个 GitHub 插件：github:wsjb114514/dsh-plugin-free-web

DeepSeek Harness 会自动克隆、安装并挂载，刷新页面即可永久生效。

方式 B：聊天框本地安装¶

1. 从本仓库下载源码（Code → Download ZIP）并解压到固定文件夹。
2. 在 DeepSeek Harness 聊天框中发送（将路径替换为你的实际路径）：

请调用 plugin_manager 工具（action: install_bundle）帮我安装这个本地插件：<你解压后的文件夹绝对路径>

方式 C：双击一键安装脚本¶

1. 下载源码并解压到固定目录。
2. Windows 用户：双击运行 双击安装插件_Windows.bat。
3. Mac 用户：双击运行 双击安装插件_Mac.command。
4. 看到“✅ 安装完成”提示后重启一次 DeepSeek Harness 即可。

典型用法¶

安装完成后，在 DSH 的 ctx.web 中调用 search 与 fetch 时，即可直接使用 free-search-pfw 与 free-fetch-pfw。

• 搜索示例（伪代码）：

const result = await ctx.web.search({
  query: 'DeepSeek Harness 插件开发',
  provider: 'free-search-pfw'
});

• 抓取示例（伪代码）：

const content = await ctx.web.fetch({
  url: 'https://github.com/wsjb114514/dsh-plugin-free-web',
  provider: 'free-fetch-pfw'
});

适用场景与注意¶

• 适合需要零成本、多引擎并行检索与网页正文抓取的场景，特别是对 GitHub 等外国站点的检索需求。
• 本插件以当前 dsh 进程的权限运行，请确保来源可信。
• 安装前建议检查源码与许可证（MIT）。
• 插件依赖第三方公开搜索接口（360、Bing、DuckDuckGo）与 Jina Reader、GitHub 社区镜像，这些服务的可用性与反爬策略不受本仓库控制。
• 搜索结果准确性取决于搜索引擎；插件内置相关性闸门过滤明显无关的结果，但不保证内容完全可靠。
• 请遵守目标网站的服务条款，勿用于高频爬取。

结尾¶

该插件在免费方案中提供了多引擎并行搜索与增强型网页抓取能力，能够满足本地开发与使用中的基础需求。更多细节可参考：

• 插件目录页：https://www.skillhub.cn/plugins/wsjb114513/dsh-plugin-free-web
• GitHub 仓库：https://github.com/wsjb114514/dsh-plugin-free-web