跳到正文
  • 首页
  • 插件说明
  • dsh-free-search

DDDMUC/dsh-free-search

31最近提交 2026年8月16日

dsh-free-search DSH 插件

dsh-free-search 为 DeepSeek Harness 添加了可配置的网页搜索 provider，支持 Bing、DuckDuckGo、SearXNG 等多个免费引擎。它提供网页设置页用于切换引擎和管理 API 密钥，免费引擎之间自动回退，还附带 web_fetch 和 platform_search 工具。适合没有 DeepSeek API 密钥的用户。

browser-webdeveloper-tools

如何安装 dsh-free-search DSH 插件

dsh plugin --profile web add /path/to/dsh-free-search

复制不会执行命令。安装 dsh-free-search DSH 插件前请核对仓库和版本。

dsh-free-search DSH 插件数据来源

dsh-free-search DSH 插件快照日期：2026年8月16日

discovered

dsh-free-search DSH 插件能做什么

  • 多引擎网页搜索，自动回退（支持 Bing、DuckDuckGo、SearXNG、Exa 等）
  • 网页设置页面，可切换引擎和配置 API 密钥
  • 附加工具：web_fetch（抓取网页内容）和 platform_search（搜索 GitHub、V2EX、B站）
  • 引擎测试工具（free_search_test），一键测试所有引擎可用性

dsh-free-search DSH 插件适合哪些场景

  • 没有 DeepSeek API 密钥的用户需要 agent 联网搜索
  • 需要稳定搜索，单个引擎限流时自动切换到其他引擎
  • 开发者希望 agent 直接搜索 GitHub 仓库、V2EX 主题或 B站视频
  • 需要 agent 读取网页全文内容

dsh-free-search DSH 插件适合谁

  • 不想使用 DeepSeek 官方 API 密钥的 DeepSeek Harness 用户
  • 需要多引擎搜索和平台特定搜索的开发者或研究者

dsh-free-search DSH 插件的限制

  • DuckDuckGo 引擎可能遇到限流（反爬挑战）
  • web_fetch 无 SSRF 防护，agent 理论上可访问内网地址
  • 部分免费引擎在国内可能需要代理才能访问

dsh-free-search DSH 插件的仓库 README 摘录

以下文字摘自 dsh-free-search DSH 插件的上游仓库 DDDMUC/dsh-free-search 的 README，版权归原作者，仅作引用。

**DeepSeek Harness 免费搜索插件 —— 无需 API key，零成本，多引擎可切换。** 一个给 DeepSeek Harness (dsh) 添加多引擎搜索 provider 的插件，注册进 `ctx.web` seam。内置 `web_search` 工具自动选用，支持网页设置页切换引擎、配置 API key、一键测试所有引擎。 [English](./README.en.md) | 中文 ## 为什么需要它 dsh 默认的搜索 provider 依赖 DeepSeek 官方 API key（`DEEPSEEK_API_KEY`）。如果你： - 没有（或不想用）DeepSeek 官方 key， - 用的是 opencode-go 这类网关（其 OpenAI 兼容端点不支持 `web_search` 工具）， ……那么内置搜索必然失败，agent 会告诉你"无法联网"。 这个插件提供多个免费引擎 + 自动回退，彻底摆脱 DeepSeek 官方 key 的依赖。 ## 特性 - **零成本** —— 多个免费引擎，无需 key、无需注册 - **多引擎可选**：DuckDuckGo（html/lite）、Bing、SearXNG（元搜索，支持自定义实例）、Exa、Perplexity、DeepSeek 官方 - **网页设置页** —— 引擎切换 + API key 配置（UI 中 key 脱敏显示"已配置"） - **引擎测试工具** —— `free_search_test`，让 agent 一键测试所有引擎可用性 - **自动回退** —— 免费引擎失败/限流时自动切换到下一个可用引擎 - **系统提示词注入** —— agent 知道当前用哪个引擎、哪些需要 key - **免费标注** —— 设置页中免费引擎带绿色 `FREE` 徽章，付费引擎带橙色 `API KEY` 徽章 - **网页抓取（web_fetch）** —— 让 agent 抓取网页内容（官方 `dsh-web-fetch-http` provider，纯 JS，零额外依赖） - **平台搜索（platform_search）** —— 搜 GitHub / V2EX / B站（公开 API，零依赖） - **干净集成** —— 实现官方 `WebSearchProvider` seam 接口，与官方插件共存 ## 引擎列表 | id | 引擎 | 费用 | 说明 | |---|---|---|---| | `ddg` | DuckDuckGo HTML | 免费 | 偶发限流（反爬），解封自动恢复 | | `ddg-lite` | DuckDuckGo Lite | 免费 | 轻量版，同上 | | `bing` | Bing | 免费 | *

阅读完整 README仓库许可: MIT

dsh-free-search DSH 插件常见问题

如何安装 dsh-free-search？

克隆仓库后运行 `dsh plugin --profile web add /path/to/dsh-free-search`，然后重启 `dsh web` 即可。插件会立即生效。

需要使用 API 密钥吗？

不需要。默认引擎 Bing 无需密钥即可使用，其他免费引擎如 DuckDuckGo、SearXNG、Exa（匿名额度）也无需密钥。付费引擎（Perplexity、DeepSeek 官方）才需要，但可以不配置。

如何切换搜索引擎？

打开设置 → 插件 → 可配置标签页，找到 Free Search 卡片，从下拉框选择新引擎，保存后重启 `dsh web`。也可以直接编辑 `~/.dsh/settings.yaml` 文件。

搜索失败怎么办？

先检查当前引擎是否被限流（DuckDuckGo 常见），或是否需要代理。插件会自动回退到其他免费引擎，你也可以运行 `free_search_test` 工具查看哪些引擎可用。

能通过代理使用吗？

可以。在启动 `dsh web` 之前设置环境变量 `NODE_USE_ENV_PROXY=1`、`HTTPS_PROXY=http://127.0.0.1:7897`（替换为你的代理地址）。国内用户使用 DuckDuckGo 等引擎时需要此配置。