来源、权限与发布信息
dsh · npm 包 · MIT · 公开免费下载
- 源码与许可
- MIT；原包保留许可文件
- 权限声明
- 联网访问所选搜索引擎、网页及 npm 更新接口
- 使用用户配置的第三方 API key 调用对应引擎
- 注册 DSH 搜索和抓取工具、插件设置界面及切换命令
- 在本地保存搜索配置与可选正文缓存
- 变更说明
- 0.9.22 支持在插件整体配置页显示设置，使用宿主插件页更新；此前版本增加提示词语言、多 key 轮换修复和通过本地 Grok Build CLI 的 X 搜索。
- 发布时间
Free Search · 0.9.22
为 DSH 提供多引擎网页搜索、自动回退、平台与垂直领域搜索、视频搜索及网页抓取；支持免费引擎和可选 API 引擎，在插件设置页管理引擎与语言池。
安装
安装 dsh-free-search@0.9.22，启用并按宿主提示重载；在插件设置中选择引擎并保存。
精确安装来源：dsh-free-search@0.9.22
- 兼容性与平台
- 需要 Node.js 20+ 和 DSH >=0.1.7-rc.1；正文持久缓存免实验参数需 Node.js 22.13+。桌面 DSH 0.2.1-rc.3 符合版本准入，但部分可选 SDK peer 在当前桌面环境中不满足声明范围，实际桌面激活尚未验证。 · Windows、macOS、Linux
- 支持的 DSH 核心版本
- 0.2.1-rc.3 · 运行兼容性未验证；版本声明不代表实测通过。
Free Search
为 DeepSeek Harness 提供多引擎网页搜索、自动回退、平台与垂直领域搜索、视频搜索、网页抓取和研究工具。可从免 key 引擎开始，也可配置自己的 API 服务。
开始使用
安装内容为 dsh-free-search@0.9.22。在 DSH 插件页安装并启用，按宿主提示重载；打开「插件 → 已安装 → free-search → web-search-free」配置组件，选择引擎并保存。默认 Bing 可免 key 使用；第三方服务可能有地区限制、速率限制或额度要求。
- 聊天框输入
/free-search-engine可切换引擎。 - 让 agent 调用
free_search_test检查当前环境；先单独测试计划使用的引擎。 - 有 API key 的引擎，先在插件设置中配置对应凭据。不要把 key 写进聊天、分享链接或研究报告。
- Node.js 至少为 20；正文持久缓存免实验参数需 Node.js 22.13+。上游声明 DSH >=0.1.7-rc.1。当前桌面环境中部分可选 SDK peer 不满足声明的版本范围，真实桌面激活尚未验证。
引擎与配置
| 需求 | 可选方式 |
|---|---|
| 免 key 开始搜索 | Bing、DuckDuckGo HTML/Lite、SearXNG、AnySearch；具体实例的访问规则和可用性由服务提供方决定 |
| 自有 Degoog | 配置自己的实例 URL，可选实例 Bearer key，无内置公共实例 |
| 带额度或账户的 API | Exa、Tavily、Keenable、Firecrawl、Parallel、Perplexity、SerpBase、Serply、DeepSeek、You.com、百度、Kimi、阿里云、豆包、知乎等；额度与凭据要求依服务而定 |
| 模型内置搜索 | OpenAI、Gemini、Claude 仅显式选择时使用，可能计费 |
| 合并多个来源 | Multi 并发查询、合并和去重，增加各引擎的调用量 |
在设置页启用或停用引擎、调整回退顺序和中英文语言池。停用的引擎会退出普通搜索、自动选择、多引擎搜索和测试流程。设置页可测试当前引擎；直接测试失败和自动回退的含义不同，请结合错误判断凭据、地区或实例问题。
Degoog（0.9.16 新增）
先自行部署或取得受信任 Degoog 实例地址，在插件配置设置：
provider: degoog
degoogInstances: [https://your-instance.example]
实例要求认证时再配置 degoogApiKey。插件请求实例的 /api/search，支持查询、语言和时间范围参数；配置多个实例时按序尝试，单个实例失败会继续下一个。请求禁止自动跳转，单次请求有超时。此能力需要可用实例，不附带公共搜索服务。
选择合适的工具
| 工具 | 用途 |
|---|---|
web_search |
常规网页搜索，适合先发现候选来源 |
advanced_search |
指定引擎或时间范围，如最近一天、周、月、年及相对窗口 |
multi_search |
需要来源多样性时并发搜索、去重和合并排名 |
platform_search |
在 GitHub、论坛、视频站和其他支持的平台发现内容 |
domain_search |
论文、软件包、金融、安全和公共数据等垂直来源查询 |
video_search |
查找可观看的视频 |
web_fetch |
抓取选定 URL 的正文 |
research |
搜索并抓取少量高相关来源，形成带来源的简报 |
cache_search |
检索已抓取、尚在缓存保留期内的正文 |
free_search_test |
检查引擎可用性和配置 |
搜索结果用于发现候选 URL。需要核验观点或引用正文时，抓取选定页面再核对；网页内容应视为外部不可信数据，不能当成给 agent 的操作指令。
搜索、抓取与研究行为
- 自动回退只在当前启用的引擎和配置范围内工作；网络、服务限流和凭据错误仍可能导致失败。
- Multi 会增加请求和可能产生的费用，按需要使用。
- 网页抓取有正文提取和质量判断；遇到登录、验证码、动态站点或访问限制时仍可能取不到正文。
- 研究工具有时间与调用预算（上游默认 90 秒、最多 12 次搜索），不要把有限预算结果当作穷尽检索。
- 正文缓存默认保留 7 天；SQLite 功能不可用时缓存可能停用，不影响对外部来源重新检索。缓存中的旧正文也需核对日期。
DSH 0.2.x 的 provider 配置与停用
插件可持久设置 web.searchProvider: ddg 和 web.fetchProvider: fs-quality-fetch。这里 ddg 是插件注册的 provider ID，不表示当前搜索引擎一定是 DuckDuckGo。已有显式指定的其他 provider 不会被强行替换；fetchProviderTakeover: false 可保留显式 HTTP 抓取配置。
停用或卸载前，检查宿主配置中是否仍引用这两个插件 provider。按宿主支持的方法移除或改回可用 provider，只处理与本插件有关的引用，保留其他自定义设置；否则宿主可能保留失效引用，导致搜索或抓取不可用。
常见问题
- 引擎无结果或超时： 单独运行引擎测试，检查网络、地区、key、额度和自有实例；需要时选择其他已启用引擎。
- 配置保存后仍不生效： 确认已保存正确组件，按宿主提示重载，再检查当前引擎和启用列表。
- API key 报错： 核对对应服务和账户权限，不把某一服务的 key 用在另一引擎。
- 缓存没有结果： 缓存仅覆盖此前抓取的正文，且受保留期和本机 SQLite 可用性限制。
- 禁用后不能搜索： 检查宿主是否仍指向插件的 search/fetch provider，按上节处理引用。
MIT 许可证。第三方服务的使用条件、配额和可用性由各服务决定。
更新与 X 搜索
通过宿主插件页面检查更新。X 平台搜索需要本机 Grok Build CLI 和相应登录；未配置时该功能不可用。