本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-free-search

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-free-search

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 没有（或不想用）DeepSeek 官方 key，
• 用的是 opencode-go 这类网关（其 OpenAI 兼容端点不支持 web_search 工具），
• 零成本 —— 多个免费引擎，无需 key、无需注册
• 多引擎可选：DuckDuckGo（html/lite）、Bing、SearXNG（元搜索，支持自定义实例）、AnySearch、Exa、Tavily、Keenable、Perplexity、DeepSeek 官方
• 网页设置页 —— 引擎切换 + API key 配置（UI 中 key 脱敏显示"已配置"）+ 中英文切换

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后还需要配置 API key 吗？

不需要。默认引擎是免费的 Bing，安装后即可联网搜索。Exa/Tavily/Keenable 即使无 key 也能走匿名额度，Perplexity 和 DeepSeek 官方是付费引擎需要 key。

想换搜索引擎在哪里切换？

两种方式：在网页设置页 Settings → 插件 → 可配置 → Free Search 卡片下拉切换；或在聊天框输入 /free-search-engine 弹出引擎选择窗口点选。

一个引擎搜不到结果会怎样？

插件走统一回退链：首选引擎失败后自动按顺序尝试其他引擎（已配 key 的付费引擎 → 仍走 keyless 的 Exa/Tavily/Keenable → 剩余免费引擎），结果里会注明实际生效的引擎。

怎么搜"最近一周的新闻"或"7 月以来的更新"？

让 agent 描述需求（如"搜最近 3 天的新闻"），agent 会调用 advanced_search 工具并附带 timeRange 参数（如 3d、2mo、2026-07-01 等）。

web_fetch 工具可以直接读网页内容吗？

可以。插件启用官方 dsh-web-fetch-http provider，自动跟随重定向并把 HTML 转为纯文本。注意它无 SSRF 防护，agent 理论上可访问内网地址。

国内用需要配代理吗？

DuckDuckGo 等引擎可能需要代理。Node 24+ 上需设置 NODE_USE_ENV_PROXY=1 和 HTTPS_PROXY/HTTP_PROXY 环境变量，否则 fetch 不走系统代理。

怎么卸载？

在 DSH 配置目录移除该插件条目，然后重启 dsh web 即可。设置页所有 key 写在 ~/.dsh/settings.yaml 的 free-search 命名空间下。

跟官方 web_search 是什么关系？

插件实现了官方 WebSearchProvider 接口，并把宿主 web.searchProvider 重定向到本插件的 provider（id=ddg），所以 DSH 自带的 web_search 工具会自动使用本插件的多引擎逻辑。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.6
• Node: >=20

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则