MIT 协议的 DeepSeek Harness 插件，通过多个后端（DuckDuckGo、Bing、SearXNG……）为 agent 提供免费、免 key 的网页搜索，具备统一引擎回退、时间范围过滤、结果缓存与 `/free-search-engine` 切换器——让 agent 在没有 DeepSeek API key 的情况下也能回答实时问题。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-08-29
许可证
MIT
01它能帮你完成什么？
给 DeepSeek Harness agent 加上免费、免 key 的网页搜索，使其能回答时事与检索类问题
通过内置 `web_search` 工具返回搜索结果，并在结果顶部注明实际生效的引擎
没有 `DEEPSEEK_API_KEY`，或运行在 OpenAI 兼容网关（如 opencode-go，其端点不支持 `web_search`）上的 DeepSeek Harness 用户
不离开对话即可切换搜索引擎并测试连通性
设置页 + `/free-search-engine` 弹出命令用于切换引擎、配置 API key，并运行 `free_search_test` 一次性测试所有引擎
想挑选后端（DuckDuckGo / Bing / SearXNG / Exa / Tavily 等）或验证连通性的使用者
02如何接入 DeepSeek Harness？
作者未说明
03DSH 适配与能力边界
原生 dsh 插件，向 dsh 的 `ctx.web` seam 注册多引擎搜索 provider；内置 `web_search` 工具自动选用，无需 DeepSeek API key
免费多引擎网页搜索
自然语言网页查询（可附带时间过滤）→通过内置 `web_search` 工具返回排序后的网页结果；DuckDuckGo / Bing / SearXNG 等免费引擎无需 key
统一引擎回退
首选引擎失败的查询→自动尝试回退链中的下一个引擎；结果注明实际生效的引擎
引擎切换与测试
对话命令或设置页交互→通过 `/free-search-engine` 切换并保存当前引擎，或运行 `free_search_test` 一次性测试所有引擎
高级时间范围搜索
查询 + `timeRange` 参数→通过 `advanced_search` 按时间收窄结果——固定档、自定义相对值或绝对日期三种形式
网页抓取（web_fetch）
一个 URL→供 agent 读取的网页内容
平台搜索（platform_search）
限定平台的查询→来自 GitHub / V2EX / B站 / Reddit / Hacker News / Stack Overflow 等平台的结果
04适合谁？何时不该用？
适合
- 没有 `DEEPSEEK_API_KEY`，或运行在 OpenAI 兼容网关（如 opencode-go，其端点不支持 `web_search`）上的 DeepSeek Harness 用户
- 想挑选后端（DuckDuckGo / Bing / SearXNG / Exa / Tavily 等）或验证连通性的使用者
不适合
- 付费引擎（Exa / Tavily / Keenable / Perplexity / DeepSeek 官方）需要在设置页配置 API key。没有 key 时直测会明确报错；设置页用橙色 `API KEY` 徽章标记付费引擎。
05兼容性、维护与安全提示
- 免费引擎会向第三方后端发起实时查询，因此结果需要出网访问。免费引擎在高负载下可能限流；5 分钟 LRU 结果缓存可缓解（设置页可配 0–5 分钟，0 关闭）。
- 付费引擎（Exa / Tavily / Keenable / Perplexity / DeepSeek 官方）需要在设置页配置 API key。没有 key 时直测会明确报错；设置页用橙色 `API KEY` 徽章标记付费引擎。
- 依赖 DeepSeek Harness（dsh）：插件替换了默认、依赖 `DEEPSEEK_API_KEY` 的搜索 provider。在既没有 DeepSeek key、也没有支持 `web_search` 的 OpenAI 兼容网关时，内置搜索会失败，直到启用本插件。
MIT · 活跃维护中（最新版本 v0.4.17，2026-08-28）
06常见问题
用 dsh-free-search 需要 DeepSeek API key 吗？
不需要。免费引擎（DuckDuckGo、Bing、SearXNG 等）既不需要 key 也不需要注册。本插件正是为没有 `DEEPSEEK_API_KEY`，或运行在不支持 `web_search` 的 OpenAI 兼容网关上的用户而做。付费引擎（Exa、Tavily、Keenable、Perplexity、DeepSeek）可在设置页选择性配置 key。
怎么切换搜索引擎？
打开设置页切换引擎并配置 API key，或在聊天框输入 `/free-search-engine` 弹出引擎选择窗口——点选即切换并保存。你也可以运行 `free_search_test` 工具一次性测试所有引擎。
某个搜索引擎失败会怎样？
搜索永不直接失败。任何引擎失败（缺 key、401、限流、网络）都会在统一回退链中自动尝试下一个引擎，结果顶部会注明实际生效的引擎（例如 `Note: perplexity unavailable or failed, using exa.`）。
能按时间过滤结果吗？
可以。`advanced_search` 工具支持 `timeRange`，有三种形式——固定档、自定义相对值、绝对日期——可将结果收窄到近期内容。
它会缓存结果吗？
会。相同查询（含引擎与时间过滤参数）默认命中 50 条 LRU 缓存 5 分钟，防止免费引擎限流并节省付费额度。缓存时长可在设置页配 0–5 分钟（0 关闭）。
07相关的 DSH 工作流
archify
作者 tt-a1i
为编码智能体生成美观可验证的架构图、时序图与数据流图，输出自包含 HTML，支持动效与清晰导出。
openviking
作者 volcengine
为 AI 智能体打造的自进化上下文数据库，统一智能体记忆、知识 RAG 与技能。
nocobase
作者 nocobase
开源的 AI + 无代码应用搭建平台：AI 在久经生产验证的底层基础设施与所见即所得的无代码界面之上工作，帮你快速构建 CRM、ERP 等业务系统，兼顾速度与可靠性。
learn-harness-engineering
作者 walkinglabs
Harness 工程新手教程，从 0 到 1 系统学习智能体工作流框架。
08数据与来源
一个给 DeepSeek Harness (dsh) 添加多引擎搜索 provider 的插件，注册进 `ctx.web` seam。
**DeepSeek Harness 免费搜索插件 —— 无需 API key，零成本，多引擎可切换。**
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-08-29。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。