dsh-free-search

DeepSeek Harness 免费搜索插件 —— 无需 API key，零成本。

一个给 DeepSeek Harness (dsh) 添加 DuckDuckGo 搜索 provider 的插件，注册进 ctx.web seam。内置 web_search 工具自动选用。零配置、零成本、零 key。

English | 中文

为什么需要它

dsh 默认的搜索 provider 依赖 DeepSeek 官方 API key（DEEPSEEK_API_KEY）。如果你：

• 没有（或不想用）DeepSeek 官方 key，
• 用的是 opencode-go 这类网关（其 OpenAI 兼容端点不支持 web_search 工具），

……那么内置搜索必然失败，agent 会告诉你"无法联网"。

这个插件用免费的 DuckDuckGo HTML 搜索端点解决这个问题。

特性

• 零成本 —— 4 个免费搜索源，无需 key、无需注册
• 4 个引擎可选：DuckDuckGo（html/lite）、Bing、Mojeek
• 零配置 —— 安装即自动注册全部引擎
• 随时切换 —— 通过 web.searchProvider 选择引擎
• 区域支持 —— 每个引擎可配区域/市场参数
• 干净集成 —— 实现官方 WebSearchProvider seam 接口
• 可组合 —— 与其他 provider（exa / perplexity / deepseek-official）共存

引擎

id	引擎	说明
ddg	DuckDuckGo (html)	默认。支持 region 区域参数
ddg-lite	DuckDuckGo (lite)	轻量页面，不支持区域
bing	Bing	支持 bingMarket（默认 zh-CN）
mojeek	Mojeek	隐私友好，偏英文

默认全部启用。在插件 config 里用 engines.: false 可关闭任意引擎。

安装

git clone https://github.com//dsh-free-search.git
dsh plugin --profile web add /path/to/dsh-free-search

然后重启：

dsh web

设为默认 provider

在 profile 的 cordis.patch.yml（如 ~/.dsh/profiles/web/cordis.patch.yml）里加：

- id: web
  config:
    searchProvider: ddg   # 或：ddg-lite | bing | mojeek

或设置环境变量 DSH_WEB_SEARCH_PROVIDER=ddg。

国内用户注意：DuckDuckGo 需要代理才能访问，而 Node.js 的 默认不走系统代理。需要给 dsh 进程设置（Node 24+）：