无密钥网页搜索 Elmeis/dsh-web-search-duckduckgo

@local/dsh-web-search-duckduckgo — DeepSeek Harness 的无密钥 DuckDuckGo 搜索服务商

把 DuckDuckGo 搜索服务商注册进 harness 的 web 能力接缝（ctx.web），让内置的 web_search 工具无需 API key、无需任何基础设施就能用：插件直接请求 DuckDuckGo 的公开 HTML 页面和 Lite 结果页并解析，这也是久经考验的抓取客户端采用的做法。

与 @local/dsh-web-search-searxng 搭配使用：DuckDuckGo 什么都不用跑（最佳默认选择），而自托管的 SearXNG 在自动化密集的场景下更稳。改配置档补丁里的一行就能在两者之间切换。

如何接入

实现标准的服务商接口（id、轻量的 available()、search(request, signal) → { sources[], truncated }）：

- 两种端点：html 页面（表单 POST）和 lite 页面（GET）；endpoint: "auto" 先试 html，失败或解析为空时回落到 lite；
- 标题和摘要会去掉标签、解码实体；/l/?uddg=… 跳转包装会还原成目标 URL；结果按排名顺序去重；
- 查询选项随请求一起发出：kl 地区、kp 安全搜索（0/1/2 → -2/-1/1）、df 时间范围（day/month/year）；
- 请求自带的 maxResults 和配置的上限都会生效；取消会以接缝稳定的 WEB_ABORTED 暴露出来。

如实说明一个限制：这里读的是渲染后的页面，不是有契约的 API。从桌面 IP 访问很可靠；如果 DuckDuckGo 限流或改版，失败会以 WEB_PROVIDER_ERROR 暴露，并带上出错的端点名——这类负载请改用 SearXNG。

安装 / 更新

源码在这里；安装后的副本放进共享配置档目录树：

cp -R lib package.json ~/.dsh/profiles/node_modules/@local/dsh-web-search-duckduckgo/

注册写进 ~/.dsh/profiles/web/cordis.patch.yml：

- insert:
- id: web-search-duckduckgo
name: '@local/dsh-web-search-duckduckgo'

Select it for the search capability (replaces the whole web row config,
whose only owned key is searchProvider):
- id: web
config:
searchProvider: duckduckgo

然后重启 dsh web。把值改成 "searxng" 或 "deepseek-official"，搜索就会走别处。

配置

| 字段 | 默认值 | 含义 |
| endpoint | auto | auto / html / lite |
| language | "" | DDG 地区，例如 ru-ru、en-us；空 = 全部 |
| safesearch | 1 | 0 关闭 · 1 适中 · 2 严格 |
| timeRange | "" | day / month / year；空 = 不限 |
| maxResults | 20 | 服务商侧来源上限 |
| requestTimeoutMs | 15000 | 每个请求的兜底计时器 |
| userAgent | 类似 Chrome 的 UA 字符串 | DuckDuckGo 对通用客户端限流更严 |
| acceptLanguage | "" | 例如 ru,en |

可在 harness 设置界面的 web-search-duckduckgo 命名空间下实时编辑；每次搜索都会对当前配置段做快照。

检查

node test/smoke.mjs # helpers, parsing, auto-fallback, caps, failures, abort

（测试会在配置档目录树中存在 node_modules 时为其建立符号链接，这样插件的 @deepseek-ai/* 导入在安装位置之外也能解析。）