Skip to content
dsh marketplace

dsh-web-search-ddg

Verified

dsh-web-search-ddg · v0.3.0 · MIT

Zero-token web search for the DeepSeek Harness (DSH) web capability seam (ctx.web) — Bing fetch engine with local headless-browser DuckDuckGo fallback, no API key, no auxiliary model request

Install

dsh plugin add dsh-web-search-ddg

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

dsh-web-search-ddg

English | 中文

为 DeepSeek Harness（DSH）web 能力 seam（ctx.web）提供的零 token 网络搜索提供方。

DSH 自带的搜索路由（deepseek-official）把每次 web_search 执行为一次 deepseek-v4-flash 上的完整计费模型请求——即使你会话模型选的是别的。本插件用两个零成本引擎按序替换它，先成功者胜出：

  1. Bing——纯 fetch 请求 Bing 的 HTML 端点（带 cookie 引导）。不需要浏览器，健康时亚秒级响应。
  2. DuckDuckGo——以 headless 模式驱动本地 Chrome/Edge/Chromium 抓取 DuckDuckGo 的 HTML 端点，解析 dump 出的 DOM。
  • 每次搜索零模型 token——不需要 API key，不产生辅助模型请求
  • 零依赖——只用 Node 内置模块；不下载 Playwright/Puppeteer
  • 引擎回退——一个引擎被封锁或改版时，另一个接棒；只有全部失败才报错
  • 保留自带提供方的注册——切回只需一行配置，不用卸载

环境要求

  • 提供 ctx.web seam 的 DSH 宿主（≥ 0.1.0-rc）
  • DuckDuckGo 引擎需要本地 Chromium 系浏览器：macOS（Chrome、Edge、Chromium）与 Linux（/usr/bin/chromium、/usr/bin/google-chrome）自动探测，可用 chromePath 覆盖。Bing 引擎无需浏览器。
  • Node.js ≥ 18（可用时使用 AbortSignal.any 实现 fetch 超时）

安装

在你的 DSH profile 目录（如 ~/.dsh/profiles/web）中，作为树外插件安装：

pnpm add dsh-web-search-ddg

然后在 profile 的 package.json 中把它声明为 profile bundle，让 DSH 以一等层加载（插件管理器可见、可干净卸载）：

// profile package.json → dsh.profile.bundles
"bundles": [..., "dsh-web-search-ddg"]

接着在 profile 的 cordis.patch.yml 中选择提供方：

# 为面向模型的 web_search 工具选择本提供方。
- id: web
  config:
    searchProvider: ddg-browser

注意：patch 行会整体替换目标行的 config（无深度合并），因此 web 行必须重述其拥有的全部键——自带行只拥有 searchProvider。web-search-ddg 自身的 insert 来自包的 dsh.bundle 补丁层，无需手写。

自带的 web-search-deepseek 行保持不动：其提供方仍注册且可用，切回只需一行（searchProvider: deepseek-official）。DSH 的选择是单一显式 ID，不是优先级链——设计上就没有静默回退。

不启动宿主即可验证组合后的配置树：

dsh --profile web --dump-config | grep -A2 searchProvider

重启宿主后生效（host 侧插件行不热更新）。

配置

所有键均可选；配置写在上面 insert 条目里。

键 默认值 说明
engines ["bing", "duckduckgo"] 引擎执行顺序。支持 "bing"、"duckduckgo"，先成功者胜出
chromePath 第一个探测到的浏览器 Chromium 系可执行文件绝对路径（仅 DuckDuckGo 引擎使用）
timeoutMs 20000 DuckDuckGo 引擎单次尝试的超时预算。超时时已缓冲的 DOM 输出仍算成功（Chrome 的 --dump-dom 进程打印后经常不退出）。每次搜索共两次尝试；保持 2 × timeoutMs 小于 tool-web 的 searchTimeoutMs（DSH 默认 60s）
virtualTimeBudgetMs 8000 Chrome 的 --virtual-time-budget——dump DOM 前页面允许的沉寂时长

行为说明

  • 延迟：Bing 引擎通常亚秒级返回；DuckDuckGo 引擎约 10–20 秒（DOM 很快就绪，但 Chrome 经常不自行退出，结果常在超时兜底时拿到——缓冲输出仍会被采纳）。
  • Bing 的结果质量依赖 cookie。 没有 cookie 会话时，Bing 会返回忽略大部分查询词的降级结果。插件每个会话先访问一次 Bing 首页并复用其 cookie；结果为空时会重新引导一次。
  • 搜索引擎会对激进 IP 限流。 同一台机器高频自动化搜索可能同时被所有引擎掐连接或发挑战页。此时插件会报聚合错误、逐个列出各引擎的失败原因——可切换网络或等待标记解除（数小时），或将 searchProvider 切回 deepseek-official。绝不静默降级。
  • headless UA 被覆盖为普通桌面 Chrome UA——DuckDuckGo 识别 HeadlessChrome 标记并据此拦截。
  • 每次浏览器尝试都在 OS 临时目录下的一次性 --user-data-dir 中运行，进程结束后尽力清理。

工作原理

Bing 引擎——带桌面 Chrome 头和引导 cookie 的 fetch 请求结果页；解析 <li class="b_algo"> 块提取标题与摘要；把结果链接（/ck/a?…&u=a1<base64url>）解包成真实目标 URL。

DuckDuckGo 引擎——对 https://html.duckduckgo.com/html/?q=<query> 以 headless 启动浏览器（--headless --dump-dom --virtual-time-budget，UA 覆盖）；带 kill 兜底地读取序列化 DOM（超时时已缓冲输出仍算成功）；解析 <a class="result__a"> 标题与 <a class="result__snippet"> 摘要，从跳转链接的 uddg 参数解码真实 URL 并按其配对。

两个引擎都通过 seam 返回 { sources: [{ url, title?, snippet? }], truncated: false }——面向模型的 web_search 工具与结果卡片无需任何改动。

故障排查

ddg-browser: all search engines failed (…) 会逐个列出每个引擎的最后错误：

消息片段 含义 处理
connection reset / rate-limited 你的 IP 被该引擎临时标记 切换网络（如手机热点）或等待数小时；标记会自动解除
anomaly/challenge page DuckDuckGo 反爬挑战页 同上；另检查 UA 字符串是否仍匹配当前 Chrome 版本
no parsable results/links 引擎页面结构变更 更新本插件，或提 issue
browser did not finish within Nms 浏览器挂起未产出 DOM 调大 timeoutMs；确认浏览器本身能启动

开发

npm test          # 端到端：注册到 stub ctx.web 并跑一次真实搜索
CHROME_PATH=/path/to/browser npm test
TEST_QUERY="换个查询" npm test

许可证

MIT