免费网页搜索 delef/dsh-free-web-search

dsh-free-web-search

DeepSeek Harness 的免费网页搜索插件。不需要 API key，开箱即用，支持 Bing、DuckDuckGo 和 SearXNG。付费引擎（Exa、Tavily、Keenable、Perplexity、DeepSeek Official）可选，填上 key 就会启用。

功能

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

安装

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

如果 pnpm 拦截了构建脚本，把它打印出的 key 加到配置档 pnpm-workspace.yaml 的 allowBuilds 里，然后重试。

引擎

| 引擎 | 费用 | 需要 key |
| 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" # optional, override preferred engine
maxResults: 5

platform_search

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

web_fetch

url: "https://docs.example.com/guide"
maxLength: 50000 # optional, default 50000 chars

抓取单个页面，去掉 HTML，返回纯文本。适合读文章、文档或任意 URL。

free_search_test

测试引擎可用性。不带参数就测试所有引擎。

配置

设置通过网页界面管理（设置 > 插件 > Free Web Search），也可以写在当前配置档的 free-web-search 条目里（DSH 0.2+；更早的版本用 settings.yaml 的 free-search 段）：

- id: free-web-search
name: dsh-free-web-search
config:
provider: bing
bingMarket: en-US
cache: true
cacheTtl: 5
platforms:
- github
- reddit
searxngInstances: # optional, overrides default public instances
- https://your-instance.example.com
Optional API keys
exaApiKey: ""
tavilyApiKey: ""
keenableApiKey: ""
perplexityApiKey: ""
deepseekApiKey: ""

配置档里如果还在用旧的条目 id web-search-free，仍然可以正常工作，但插件会打一条弃用警告，设置卡片上也会显示提示。把条目改名为 free-web-search 即可完成迁移。

要求 DSH >=0.2.0-rc.2（开发时基于 0.2.1-rc.5）。

许可证

Apache-2.0