Free Search
为 DeepSeek Harness 提供多引擎网页搜索、自动回退、平台与垂直领域搜索、视频搜索、网页抓取和研究工具。可从免 key 引擎开始，也可配置自己的 API 服务。
开始使用
安装内容为 dsh-free-search@0.9.23。在 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。真实桌面激活尚未验证。
引擎与配置
| 需求 |
可选方式 |
| 免 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 时插件会接管；其他自定义搜索 provider 不会被强行替换。fetchProviderTakeover: false 可保留显式 HTTP 抓取配置。
停用或卸载前，检查宿主配置中是否仍引用这两个插件 provider。按宿主支持的方法移除或改回可用 provider，只处理与本插件有关的引用，保留其他自定义设置；否则宿主可能保留失效引用，导致搜索或抓取不可用。
常见问题
- 引擎无结果或超时： 单独运行引擎测试，检查网络、地区、key、额度和自有实例；需要时选择其他已启用引擎。
- 配置保存后仍不生效： 确认已保存正确组件，按宿主提示重载，再检查当前引擎和启用列表。
- API key 报错： 核对对应服务和账户权限，不把某一服务的 key 用在另一引擎。
- 缓存没有结果： 缓存仅覆盖此前抓取的正文，且受保留期和本机 SQLite 可用性限制。
- 禁用后不能搜索： 检查宿主是否仍指向插件的 search/fetch provider，按上节处理引用。
MIT 许可证。第三方服务的使用条件、配额和可用性由各服务决定。
更新与 X 搜索
通过宿主插件页面检查更新。X 平台搜索需要本机 Grok Build CLI 和相应登录；未配置时该功能不可用。
提示词与工具
设置页可选择内置中英文提示词或自定义页面；空白页面不会注入提示词。可分别关闭插件工具。设置页分区提供可复制的直接链接。