delef/dsh-free-web-search

dsh-free-web-search

适用于 DeepSeek Harness 的免费网页搜索插件。无需 API 密钥——开箱即用，支持 Bing、DuckDuckGo 和 SearXNG。可选的付费引擎（Exa、Tavily、Keenable、Perplexity、DeepSeek Official）在添加密钥后即可启用。

功能特性

- 10 个搜索引擎，支持自动回退——如果一个失败，下一个会接替
- 时间过滤搜索，通过 advanced_search 工具实现（最近一天/一周/一月/一年，或自定义范围如 3d、2mo、2026-07-01）
- 平台搜索——通过 platform_search 工具搜索 GitHub 仓库和 Reddit 帖子
- 引擎诊断——free_search_test 工具用于检查哪些引擎可用
- Web 设置界面——引擎选择、API 密钥管理、缓存 TTL 配置
- 结果缓存——LRU 缓存（50 条，TTL 可配置，最长 5 分钟）以减少速率限制

安装

dsh plugin --profile web add github:delef/dsh-free-web-search

如果 pnpm 阻止了构建脚本，请将其打印的密钥添加到你的配置文件的 pnpm-workspace.yaml 中的 allowBuilds，然后重试。

引擎

| 引擎 | 费用 | 需要密钥 |
|--------|------|-------------|
| Bing | 免费 | 否 |
| DuckDuckGo (HTML / Lite) | 免费 | 否 |
| SearXNG | 免费 | 否 |
| AnySearch AI | 免费 | 否 |
| Exa | 免费额度 / 付费 | 可选 |
| Tavily | 免费额度 / 付费 | 可选 |
| Keenable | 免费额度 / 付费 | 可选 |
| Perplexity | 付费 | 是 |
| DeepSeek Official | 付费 | 是 |

默认引擎：Bing（最稳定）。可在 设置 > 插件 > Free Web Search 中更改，或在聊天中输入 /free-search-engine。

工具

web_search（内置，由本插件提供支持）

标准 harness 网页搜索。使用已配置的引擎并支持自动回退。

advanced_search

query: "rust async runtime"
timeRange: "week"        # day | week | month | year | 3d | 2mo | 1y | 2026-07-01
engine: "exa"            # 可选，覆盖首选引擎
maxResults: 5

platform_search

platform: "github"       # github | reddit
query: "deepseek harness plugins"
maxResults: 5

web_fetch

url: "https://docs.example.com/guide"
maxLength: 50000                       # 可选，默认 50000 字符

抓取单个页面，剥离 HTML，返回纯文本。用于阅读文章、文档或任何 URL。

free_search_test

测试引擎可用性。无参数时测试所有引擎。

配置

设置通过 Web 界面（设置 > 插件 > Free Web Search）或 settings.yaml 管理：

free-search:
provider: bing
bingMarket: en-US
cache: true
cacheTtl: 5
platforms:
- github
- reddit
searxngInstances:          # 可选，覆盖默认公共实例
- https://your-instance.example.com
可选 API 密钥
exaApiKey: ""
tavilyApiKey: ""
keenableApiKey: ""
perplexityApiKey: ""
deepseekApiKey: ""

许可证

Apache-2.0