godchen520/dsh-web-search-bing

dsh-web-search-bing

面向 DeepSeek Harness (DSH) 的免费 Bing 搜索 provider。无需 API Key，不消耗模型额度。

特点

• 完全免费：走 Bing 公共 HTML 搜索页面，无需 API Key、无需注册
• 国内可达：默认 cn.bing.com，中国大陆可直连（DuckDuckGo 在此不可达）
• 零配额消耗：不消耗 DeepSeek 或任何 LLM 的搜索配额
• 可配置：搜索端点、中英文结果、单页结果数，且设置热生效（改完不用重载插件）
• 适配 DSH 0.2.x：使用新版 schema 驱动的设置模型（导出 Config，由 host 自动生成设置表单）

与内置 DeepSeek 搜索的区别

内置的是「用模型额度换高质量检索」，本插件是「用网页抓取换零成本」。两者可共存，通过 web.searchProvider 选择。

安装

# 1. 从 npm 安装（推荐）
cd $DSH_HOME/profiles/web
pnpm add @godchen520/dsh-web-search-bing

#    也可以从 GitHub 安装（跟随最新提交）：
#    pnpm add github:godchen520/dsh-web-search-bing

# 2. package.json 的 dependencies 会自动出现：
#    "@godchen520/dsh-web-search-bing": "^1.2.2"

# 3. package.json 的 dsh.profile.bundles 里加上 "@godchen520/dsh-web-search-bing"

# 4. 重启
dsh web

注意：只加进 dependencies 而不加进 dsh.profile.bundles 的话，插件的 cordis.patch.yml 不会被应用——插件是「装了但没启用」，搜索仍走内置 provider。

配置

设置项由 host 从插件导出的 Config schema 自动生成，出现在 设置 → Plugins 页面 （注意：专属的「网页搜索」设置页是内置 DeepSeek provider 的，本插件不在那里）。

四个字段都是 .volatile()，保存后下一次搜索即时生效：

工作原理

双通道：RSS 优先，HTML 兜底。

web_search 工具 → ctx.web.search() → bing-free provider
   │
   ├─ 1) GET cn.bing.com/search?q=...&ensearch=0&format=rss   ← 默认主路径
   │     结构化 XML：<title> / <link> / <description> / <pubDate>
   │     有 <item> → 直接映射（含 publishedAt），完成
   │     无 <item> / 非 feed / 请求失败 ↓
   │
   └─ 2) GET cn.bing.com/search?q=...&ensearch=0              ← 兜底
         解析 <li class="b_algo"> → {url, title, snippet}

其他行为：

• 带浏览器 UA（Bing 会拒绝裸 Node/undici agent）。
• 命中 captcha/风控页时抛结构化 WEB_PROVIDER_ERROR，不会伪装成「无结果」。
• 支持 AbortSignal 取消，且取消不会被兜底吞掉。
• &count= 对两种通道都无效，Bing 每页固定约 10 条。

兼容性

本插件只 import 两个包：@deepseek-ai/schemastery、@deepseek-ai/dsh-web。 不再依赖 @deepseek-ai/dsh-settings（新版已移除 settingsNamespace / installSettingsSection）。

测试

npm install        # 首次：安装官方包（测试需要 import 真实的 lib/index.js）
npm test           # 离线测试：40 + 41 项，确定性，可进 CI
npm run test:live  # 额外真实请求 cn.bing.com（+7 项，需要网络）

端到端覆盖的关键行为：

• RSS 优先：默认只发一次请求且带 format=rss；publishedAt 正确映射（含中文 pubDate）
• HTML 兜底：preferRss: false 时强制走 HTML，且不请求 RSS
• 回退触发：RSS 返回非 feed、返回 HTTP 500 —— 都要回退到 HTML
• 取消不被吞：AbortSignal 取消后抛 WEB_ABORTED，不继续回退
• 空 query / captcha 页：抛结构化 WEB_PROVIDER_ERROR，不伪装成「无结果」
• maxResults 截断

License

MIT