前言¶
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：聊天框本地安装¶
- 从本仓库下载源码（Code → Download ZIP）并解压到固定文件夹。
- 在 DeepSeek Harness 聊天框中发送（将路径替换为你的实际路径）：
请调用
plugin_manager工具（action: install_bundle）帮我安装这个本地插件：<你解压后的文件夹绝对路径>
方式 C：双击一键安装脚本¶
- 下载源码并解压到固定目录。
- Windows 用户：双击运行
双击安装插件_Windows.bat。 - Mac 用户：双击运行
双击安装插件_Mac.command。 - 看到“✅ 安装完成”提示后重启一次 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
