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：<title> / <link> / <description> / <pubDate>
   │     有 <item> → 直接映射（含 publishedAt），完成
   │     无 <item> / 非 feed / 请求失败 ↓
   │
   └─ 2) GET cn.bing.com/search?q=...&ensearch=0              ← 兜底
         解析 <li class="b_algo"> → {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

dsh-web-search-bing

Install

Source

Tags

Creators

Readme

dsh-web-search-bing

特点

与内置 DeepSeek 搜索的区别

安装

配置

工作原理

兼容性

测试

License