必应免费搜索 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 搜索的区别

| | 内置 dsh-web-search-deepseek（deepseek-official） | 本插件（bing-free） |
| 原理 | 调 DeepSeek Messages API + 原生 web_search 工具，每次搜索是一次 LLM 请求 | GET cn.bing.com/search，解析 HTML |
| 凭证 | 需 API Key | 零凭证 |
| 配额 | 消耗 DeepSeek 模型额度 | 不消耗任何额度 |
| 设置项 | key / endpoint / model / maxTokens / maxUses | endpoint / maxResults / ensearch |

内置的是「用模型额度换高质量检索」，本插件是「用网页抓取换零成本」。两者可共存，通过 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()，保存后下一次搜索即时生效：

| 参数 | 默认值 | 说明 |
| endpoint | https://cn.bing.com/search | 搜索端点（可换镜像/代理） |
| maxResults | 10 | 单页解析结果上限（seam 还会按 searchMaxResults 再截断） |
| ensearch | 0 | 0=中文结果，1=英文 |
| preferRss | true | 优先走 RSS；设 false 强制走 HTML 抓取 |

工作原理

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

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

| | RSS 通道（主） | HTML 通道（兜底） |
| 体积 | ~4 KB | ~100 KB |
| 摘要 | 完整段落 | 被 lineclamp 截断 + 需清 UI 尾巴 |
| publishedAt | ✅ 有（<pubDate>） | ❌ 无 |
| 抗变化 | 标准 RSS 字段 | 依赖 b_algo / b_lineclamp* class 名 |
| 相关性 | — 两者完全相同（同一批结果、同一顺序） | — |

其他行为：

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

兼容性

| DSH 版本 | 状态 |
| 0.2.x（如 0.2.0-rc.2） | ✅ 支持（当前版本） |
| 0.1.7 ~ 0.1.x | ✅ 支持（readField 同时兼容 .get() 访问器与纯值） |
| ≤ 0.1.6 | ❌ 不支持（那时用 installSettingsSection 手写注册，API 已移除） |

本插件只 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 项，需要网络）

| 文件 | 内容 |
| tests/parse.smoke.test.cjs | 40 项纯解析：HTML 解析 / 命名实体 / UI 尾巴清理 / RSS feed / 本地化 pubDate。自包含，不依赖官方包 |
| tests/e2e.provider.test.mjs | 41 项端到端：直接 import 真实的 BingFreeSearchProvider（不复制逻辑），用桩 fetch 驱动两种传输 |

端到端覆盖的关键行为：

- 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