dsh-free-search-lite: Lightweight Web Search and Content Extraction without API Keys

前言

在 DeepSeek Harness(dsh)里让模型查公网资料,常见做法是接 MCP、Python 子进程或带 Key 的搜索 API。部署和维护成本不低,预设里还可能和内置工具叠在一起。社区插件 dsh-free-search-lite(维护者 ayakadaisuki,分类:联网工具)走另一条路:纯 Node 插件、两个原生工具、零配置,不启动浏览器、Python 或 MCP 子进程。下面介绍它是什么、装好后能做什么,以及安装与试用方式。

这是什么

dsh-free-search-lite 是为 dsh 提供的社区插件,不是 DeepSeek 官方产品,也与 npm 上已有的 dsh-free-search 不是同一个项目。定位是 Key-free 的中英文公网搜索,以及静态网页正文抽取;安装并启用后,工具由 dsh 自动发现,不要求单独选专用预设。

安装后得到什么

插件注册两个工具:

工具 作用
free_search 中英文公网搜索,返回标题、原始网址、摘要、来源和引擎状态
free_search_fetch 读取 HTML/文本页面正文,长内容按字符分页,尽量保留代码块

搜索侧:360 与 Bing RSS 并行查询,结果不足时回退 DuckDuckGo;去重、合并来源并丢弃明显离题条目。运行时不需要 Python、虚拟环境、浏览器、Playwright、MCP 子进程、管理网页、数据库或 API Key。无需配置文件——启用即可。

与本插件无关的旧链路:它不是旧 Python MCP 免费搜索服务的启动器;不会改写默认模型、预设或已有 MCP。原有 free-search 预设可继续用,新工具会与旧工具并存;确认本插件可用后,可按需手动停用旧 mcp-free-search,避免重复。若某预设限制了工具列表,需在该预设中允许 free_search 与 free_search_fetch。

兼容版本

README 写明已在 DeepSeek Harness 0.2.1-rc.3、Node.js 24.21.0、Windows x64 上验证;最低 Node.js 24.14.0。package.json 中 engines.dsh 与该预览版精确匹配——其他 dsh 版本需重新验证后再用,不能靠跳过兼容性检查强行安装。项目仅有 Node 代码、无平台原生依赖;macOS/Linux 尚未在资料中宣称实测。

安装与启用

仓库保留预构建的 lib/,一般无需本地构建。可选预构建包:v0.1.1 / dsh-free-search-lite-0.1.1.tgz。

dsh 桌面端(desktop profile)

在官方桌面端打开 插件 → 添加插件,使用 GitHub 仓库地址:

https://github.com/ayakadaisuki/dsh-free-search-lite

也可选择上述 dsh-free-search-lite-0.1.1.tgz。确认安装来源并启用「轻量免费搜索」;若界面提示重启,按提示操作。README 强调:desktop profile 应通过桌面界面安装,不要用外部 CLI 改它。

CLI 管理的 Web profile

dsh plugin --profile web add github:ayakadaisuki/dsh-free-search-lite

项目不依赖 npm 发布;README 未宣称已被插件市场收录,收录以市场维护者结果为准。

典型用法

README 给出的试用思路:先用 free_search 搜索 DeepSeek Harness 官方 GitHub 仓库,再用 free_search_fetch 打开结果中的官方介绍页,用两句话摘要并附上原始链接。

工具参数(摘自 README):

free_search

参数 说明
query(必填) 1–500 字符
count(可选) 1–15,默认 8
refresh(可选) 绕过缓存

free_search_fetch

参数 说明
url(必填) 公网 HTTP(S)
start(可选) 起始字符,默认 0
length(可选) 1000–20000,默认 12000
refresh(可选) 重新抓取

分页:将上次返回的 nextStart 作为下次的 start;nextStart: null 表示缓存内正文已读完。正文最多保留 200000 字符,超出时 sourceTruncated: true。返回中的时间字段是抓取时间,不是网页发布日期。

适用场景与注意

适合谁

  • 希望在 dsh 里做中英文联网检索、读静态页正文,又不想维护 MCP/Python/浏览器栈的开发者。
  • 已在使用 dsh 0.2.1-rc.3 且 Node ≥ 24.14.0 的环境(资料中 Windows 已验证;其他系统需自行验证)。

能力与边界(资料原文要点)

  • 搜索词会发往 360、Bing,必要时 DuckDuckGo;抓取 URL 会访问对应站点;结果可能进入模型上下文。零 API Key 不等于离线或完全本地。
  • 无遥测、登录、Cookie 持久化;缓存在插件进程内存中约 5 分钟,卸载或重启即清空(cacheScope: process)。
  • 仅公网 HTTP(S) 与标准端口;内网、回环、含账号密码的 URL 会被拒绝;不执行 JavaScript,不替代登录态 SPA、PDF/Office 等。
  • 搜索引擎接口非稳定官方 API,失败或 no_reliable_results 不能理解为「信息不存在」。
  • 插件在 dsh 宿主进程执行,不等于工作区沙箱;调用仍走 dsh 工具策略。安装前应阅读源码与 MIT 许可证;搜索适配思路部分移植自 sweetcornna/free-search-mcp 0.13.1,其余能力未移植。

DeepSeek Harness 生态强调「一切皆插件」;SkillHub 等社区目录是独立站点,与 DeepSeek / 幻方无官方从属关系。

结尾

dsh-free-search-lite 用两个原生工具把「搜」和「读页」收进 dsh 插件进程:无 Key、无 MCP 子进程、安装后零配置。若你的 dsh 版本与 README 声明一致,可从桌面端或 Web profile 的上述命令安装,再按 README 试用 free_search 与 free_search_fetch。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye