dsh-bing-search 1.1.3

package/CHANGELOG.md

@@ -0,0 +1,55 @@
+# Changelog
+
+## [1.1.3] - 2026-09-13
+
+### Changed
+- 包名、GitHub 仓库、本地目录统一为 `dsh-bing-search`（无作用域、不带 `@cwsong/`）。`dsh-websearch-bing` 被 npm 判定与已占用的 `dsh-web-search-bing` 过于相似。
+
+## [1.1.2] - 2026-09-11
+
+### Changed
+- npm 包名改为 `@cwsong/dsh-websearch-bing`（无作用域名被判定与已占用的 `dsh-web-search-bing` 过于相似）
+
+## [1.1.1] - 2026-09-11
+
+### Changed
+- 包名、GitHub 仓库、loader 行和设置节统一为 `dsh-websearch-bing` / `websearch-bing`（npm 上的 `dsh-web-search-bing` 已被占用）
+
+## [1.1.0] - 2026-09-11
+
+### Fixed
+- 适配 DSH `0.1.5-rc.1`：peerDependencies 从 `^0.1.0-rc.6` 升级到 `>=0.1.5-rc.1 <0.2.0-0`（旧的 prerelease 区间不匹配 0.1.5-rc.x，导致安装/启动报错）
+- `cordis.patch.yml` 补回 `fetchProvider: http`：补丁是整段替换 `web` 行配置，只写 `searchProvider` 会丢掉 base 层显式设置的 fetch provider
+- 清理从 duckduckgo 版本遗留的注释/模块名（`web-search-duckduckgo`、`@module dsh-web-search-duckduckgo`）
+- 修复 README_EN.md 的 emoji 乱码
+
+### Changed
+- 设置节注册改用电官方同款 `ctx.inject(["settings"])` + `settings.installSection(...)` 模式，命名空间改为普通字符串常量
+- provider 改为「单实例 + resolveOptions thunk」模式（对齐官方 `@deepseek-ai/dsh-web-search-deepseek`），每次搜索快照一次配置，不再每次 new 实例
+- `available()` 现在校验 endpoint 是合法 URL 且 maxResults 为正整数
+- provider 错误信息附带端点恢复指引（对齐官方错误风格）
+- `@deepseek-ai/schemastery` 从 peerDependencies 移到 dependencies（对齐官方插件结构）
+- 移除未被代码引用的 `@deepseek-ai/dsh-agent` peer 依赖
+- User-Agent 更新到 Chrome/131
+- HTML 实体解码补充 `&ensp;` `&emsp;` `&thinsp;` `&ndash;` `&mdash;` `&hellip;`
+
+## [1.0.2] - 2026-08-18
+
+### Changed
+- 重命名为 dsh-web-search-bing（从 dsh-web-search-duckduckgo 迁移）
+- 更新 README 和文档
+
+## [1.0.1] - 2026-08-18
+
+### Changed
+- 从 DuckDuckGo 切换到 Bing（cn.bing.com，国内可达）
+- 更新 HTML 解析逻辑适配 Bing 页面结构
+- 添加 ensearch 参数支持中英文搜索切换
+- 添加 accept-language 头部
+
+## [1.0.0] - 2026-08-18
+
+### Added
+- 初始版本：DuckDuckGo 免费搜索 provider
+- 无需 API Key，不消耗 DeepSeek 搜索配额
+- 支持 DSH web 能力接缝注册

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 dsh-web-search-duckduckgo contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,93 @@
+# dsh-bing-search
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![DSH Compatible](https://img.shields.io/badge/DSH-0.1.5--rc.1-brightgreen)](https://github.com/deepseek-ai/deepseek-harness)
+[![npm](https://img.shields.io/npm/v/dsh-bing-search.svg)](https://www.npmjs.com/package/dsh-bing-search)
+
+> DeepSeek Harness (DSH) 的免费 Bing 搜索 provider。无需 API Key，不消耗模型搜索配额。
+
+<p align="right">
+  <a href="README_EN.md">English</a> | <b>中文</b>
+</p>
+
+> 本仓库是 [godchen520/dsh-web-search-bing](https://github.com/godchen520/dsh-web-search-bing) 的维护 fork，已适配 DSH `0.1.5-rc.1`。包名用 `dsh-bing-search`，因为 `dsh-web-search-bing` 已被占用，`dsh-websearch-bing` 又被 npm 判定过于相似。
+
+## 特点
+
+- **完全免费**：使用 Bing 公共 HTML 搜索页面，无需 API Key
+- **国内可达**：默认使用 cn.bing.com，中国大陆可直接访问
+- **零配额消耗**：不消耗 DeepSeek 或任何 LLM 的搜索配额
+- **即插即用**：安装后自动把 `web_search` 切到 `bing-free`
+- **可配置**：支持切换搜索端点、中英文结果、结果数量
+
+## 安装
+
+npm：
+
+```sh
+dsh plugin --profile desktop add dsh-bing-search
+```
+
+GitHub：
+
+```sh
+dsh plugin --profile desktop add github:whiteS18/dsh-bing-search
+```
+
+网页版 profile 把 `desktop` 换成 `web`。装完重启 DSH。
+
+也可以在 profile 目录手动安装：
+
+```sh
+cd $DSH_HOME/profiles/desktop   # 桌面版通常为 ~/.dsh/profiles/desktop
+pnpm add dsh-bing-search
+```
+
+然后把 `"dsh-bing-search"` 加入 `dsh.profile.bundles`（放在 `@deepseek-ai/dsh-web-app` 之后），重启 DSH。
+
+**注意：** `node_modules` 里的目录名必须等于 `package.json` 的 `name`。不要用旧名 `dsh-web-search-bing` 去 link 这个目录，否则桌面端会报 `profile package identity is invalid`。
+
+## 配置
+
+当前版本没有设置页卡片。改 `~/.dsh/settings.yaml`（热加载）：
+
+```yaml
+bing-search:
+  endpoint: https://cn.bing.com/search
+  maxResults: 20
+  ensearch: 0
+```
+
+或改 profile 的 `cordis.patch.yml` 后重启：
+
+```yaml
+- id: bing-search
+  config:
+    endpoint: https://cn.bing.com/search
+    maxResults: 15
+    ensearch: 0
+```
+
+| 参数 | 默认值 | 说明 |
+|------|--------|------|
+| `endpoint` | `https://cn.bing.com/search` | 搜索端点 |
+| `maxResults` | `20` | 每次搜索最大结果数 |
+| `ensearch` | `0` | 0=中文结果，1=英文结果 |
+
+设置 → 插件 → 插件配置 里的 **Web Search** 卡片属于官方 `web-search-deepseek`，不是本插件。
+
+## 如何确认走的是 Bing
+
+把 endpoint 临时改成无效地址后再搜一次。如果报错包含 `bing-search` 和你写的 endpoint，就是本 provider。测完改回去。
+
+## 恢复默认搜索
+
+把本插件 patch 中的 `searchProvider` 改回 `deepseek-official`（或从 bundles 移除本包），重启即可。
+
+## 工作原理
+
+调用 `cn.bing.com/search` → 解析 HTML 搜索结果（`<li class="b_algo">` 块）→ 提取标题/URL/摘要 → 返回给 DSH 的 `web_search` 工具。
+
+## License
+
+[MIT](LICENSE)

package/README_EN.md

@@ -0,0 +1,93 @@
+# dsh-bing-search
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![DSH Compatible](https://img.shields.io/badge/DSH-0.1.5--rc.1-brightgreen)](https://github.com/deepseek-ai/deepseek-harness)
+[![npm](https://img.shields.io/npm/v/dsh-bing-search.svg)](https://www.npmjs.com/package/dsh-bing-search)
+
+> Free Bing-backed web search provider for DeepSeek Harness (DSH). No API key needed, no search quota consumed.
+
+<p align="right">
+  <b>English</b> | <a href="README.md">中文</a>
+</p>
+
+> This is a maintenance fork of [godchen520/dsh-web-search-bing](https://github.com/godchen520/dsh-web-search-bing), updated for DSH `0.1.5-rc.1`. The package is `dsh-bing-search` because `dsh-web-search-bing` is taken on npm and `dsh-websearch-bing` was rejected as too similar.
+
+## Features
+
+- **Completely Free** — Uses Bing's public HTML search page, no API key required
+- **China Accessible** — Defaults to `cn.bing.com`, works in mainland China
+- **Zero Quota** — Doesn't consume DeepSeek or any LLM search quota
+- **Plug & Play** — Switches `web_search` to `bing-free` after install
+- **Configurable** — Switch endpoints, language, and result count
+
+## Installation
+
+npm:
+
+```sh
+dsh plugin --profile desktop add dsh-bing-search
+```
+
+GitHub:
+
+```sh
+dsh plugin --profile desktop add github:whiteS18/dsh-bing-search
+```
+
+Use `web` instead of `desktop` for the web profile. Restart DSH after install.
+
+Or install by hand in the profile directory:
+
+```sh
+cd $DSH_HOME/profiles/desktop   # usually ~/.dsh/profiles/desktop for the desktop app
+pnpm add dsh-bing-search
+```
+
+Then add `"dsh-bing-search"` to `dsh.profile.bundles` (after `@deepseek-ai/dsh-web-app`) and restart DSH.
+
+**Note:** the directory name under `node_modules` must equal `package.json` `name`. Do not link this package as `dsh-web-search-bing`, or the desktop app will fail with `profile package identity is invalid`.
+
+## Configuration
+
+This version has no Settings card. Edit `~/.dsh/settings.yaml` (hot-reloaded):
+
+```yaml
+bing-search:
+  endpoint: https://cn.bing.com/search
+  maxResults: 20
+  ensearch: 0
+```
+
+Or override in the profile `cordis.patch.yml` and restart:
+
+```yaml
+- id: bing-search
+  config:
+    endpoint: https://cn.bing.com/search
+    maxResults: 15
+    ensearch: 0
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `endpoint` | `https://cn.bing.com/search` | Search endpoint |
+| `maxResults` | `20` | Max results parsed per search |
+| `ensearch` | `0` | `0` = Chinese results, `1` = English |
+
+The **Web Search** card under Settings → Plugins → Plugin configuration belongs to official `web-search-deepseek`, not this plugin.
+
+## How to confirm Bing is in use
+
+Temporarily set `endpoint` to an invalid URL and search again. If the error names `bing-search` and the endpoint you set, this provider handled the request. Restore the endpoint afterwards.
+
+## Restoring the default search
+
+Change `searchProvider` in this plugin's patch back to `deepseek-official` (or remove this package from `bundles`) and restart.
+
+## How It Works
+
+Queries `cn.bing.com/search` → parses HTML result blocks (`<li class="b_algo">`) → extracts title/URL/snippet → returns to DSH's `web_search` tool.
+
+## License
+
+[MIT](LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,32 @@
+# dsh-bing-search profile patch layer.
+#
+# Two effects, both in the HOST composition (`ctx.web` is host-plane):
+#
+# 1. Insert one loader row for this plugin package, which registers the
+#    `bing-free` search provider via `ctx.web.registerSearchProvider(...)`.
+#    It runs after dsh-web-app's own patch layer because this bundle is listed
+#    after `@deepseek-ai/dsh-web-app` in the profile's `dsh.profile.bundles`.
+#
+# 2. Override the base `web` row's provider selection from `deepseek-official`
+#    (which spends a DeepSeek model turn per search) to `bing-free` (which is
+#    a free public HTML query via cn.bing.com, accessible from mainland China).
+#
+# A patch REPLACES the targeted row's whole `config` rather than merging into
+# it, so this layer must restate every key the base row carries: dropping
+# `fetchProvider: http` here would silently undo the base's explicit fetch
+# selection. Keep the two keys in sync with dsh-base's `web` row when
+# upgrading.
+#
+# Because `bing-free` is explicitly configured, the seam never hits
+# WEB_PROVIDER_AMBIGUOUS even though `deepseek-official` may also be registered
+# and available. To fall back to DeepSeek search later, change
+# `searchProvider` below back to `deepseek-official` (and optionally remove this
+# insert row).
+- id: web
+  config:
+    searchProvider: bing-free
+    fetchProvider: http
+
+- insert:
+    - id: bing-search
+      name: 'dsh-bing-search'

package/lib/index.js

@@ -0,0 +1,326 @@
+import z from "@deepseek-ai/schemastery";
+import { WebError } from "@deepseek-ai/dsh-web";
+
+//#region provider
+/**
+ * Bing-backed free web search provider for the `ctx.web` seam.
+ *
+ * This provider performs a plain HTTPS GET against Bing's public HTML search
+ * page (cn.bing.com for Chinese results, or any Bing endpoint you configure)
+ * and parses the result blocks it returns. It needs NO API key and makes NO
+ * model call, so the `web_search` tool works here without spending DeepSeek
+ * (or any LLM) search quota.
+ *
+ * cn.bing.com is accessible from mainland China, making this a practical
+ * default for domestic DSH deployments where DuckDuckGo is blocked.
+ *
+ * The endpoint is fully configurable via the `bing-search` settings
+ * section or the cordis config, so you can switch to any search engine that
+ * serves an HTML results page.
+ * @module dsh-bing-search/provider
+ */
+
+/** Stable id this provider registers under. */
+const PROVIDER_ID = "bing-free";
+
+/** Default endpoint: Bing China, Chinese results. `q=` is appended at call time. */
+const DEFAULT_ENDPOINT = "https://cn.bing.com/search";
+
+/** Default `ensearch` param: `0` = Chinese results, `1` = English. */
+const DEFAULT_ENSEARCH = 0;
+
+/** Default upper bound on results parsed per page. */
+const DEFAULT_MAX_RESULTS = 20;
+
+/**
+ * Browser-ish User-Agent. Bing may reject bare Node/undici agents; a
+ * conservative desktop UA keeps it serving normal result pages.
+ */
+const USER_AGENT =
+  "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36";
+
+/**
+ * HTML-decode an attribute/value minus markup. Bing escapes `&`, `<`
+ * etc. and may include `&#xNN;` or `&#NNN;` entities; decoding keeps titles
+ * and snippets human-readable.
+ *
+ * @param {string | null | undefined} value - the raw string to decode.
+ * @returns {string} the decoded string.
+ */
+function decodeHtml(value) {
+  if (value == null) return "";
+  return value
+    .replace(/&#x([0-9a-fA-F]+);/g, (_m, hex) => String.fromCodePoint(parseInt(hex, 16)))
+    .replace(/&#(\d+);/g, (_m, dec) => String.fromCodePoint(parseInt(dec, 10)))
+    .replace(/"/g, '"')
+    .replace(/'/g, "'")
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
+    .replace(/&amp;/g, "&")
+    .replace(/&nbsp;/g, " ")
+    .replace(/&ensp;/g, " ")
+    .replace(/&emsp;/g, " ")
+    .replace(/&thinsp;/g, " ")
+    .replace(/&ndash;/g, "–")
+    .replace(/&mdash;/g, "—")
+    .replace(/&hellip;/g, "…")
+    .replace(/<[^>]*>/g, "")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+/**
+ * Parse one `<li class="b_algo">` block from Bing's HTML into a source.
+ *
+ * @param {string} blockHtml - the inner HTML of one result `<li>`.
+ * @returns {{ url: string, title: string, snippet: string } | null} the parsed
+ *   fields, or `null` when the block has no usable link.
+ */
+function parseBingResultBlock(blockHtml) {
+  // Title + URL: <h2><a href="URL" ...>Title</a></h2>
+  const titleMatch = /<h2[^>]*>\s*<a[^>]*href\s*=\s*["']([^"']+)["'][^>]*>([\s\S]*?)<\/a>/i.exec(blockHtml);
+  if (titleMatch == null) return null;
+  const href = decodeHtml(titleMatch[1].trim());
+  const title = decodeHtml(titleMatch[2]);
+  // Resolve URL — Bing sometimes uses relative or redirect URLs.
+  let url;
+  try {
+    if (href.startsWith("//")) url = `https:${href}`;
+    else if (href.startsWith("/")) url = `https://cn.bing.com${href}`;
+    else url = new URL(href).href;
+  } catch {
+    url = href;
+  }
+  if (!(url.startsWith("https://") || url.startsWith("http://"))) return null;
+  // Snippet: try multiple selectors Bing uses across versions.
+  let snippet = "";
+  const snippetPatterns = [
+    /<p[^>]*class\s*=\s*["'][^"']*\bb_lineclamp[^"']*["'][^>]*>([\s\S]*?)<\/p>/i,
+    /<div[^>]*class\s*=\s*["'][^"']*\bcaption\b[^"']*["'][^>]*>\s*<p[^>]*>([\s\S]*?)<\/p>/i,
+    /<p[^>]*class\s*=\s*["'][^"']*\bb_algoSlug\b[^"']*["'][^>]*>([\s\S]*?)<\/p>/i,
+    /<div[^>]*>\s*<p[^>]*>([\s\S]*?)<\/p>\s*<\/div>/i
+  ];
+  for (const pat of snippetPatterns) {
+    const m = pat.exec(blockHtml);
+    if (m != null && m[1].length > snippet.length) snippet = decodeHtml(m[1]);
+  }
+  return { url, title, snippet };
+}
+
+/**
+ * Parse Bing's HTML results page into source objects.
+ *
+ * Bing renders organic results as `<li class="b_algo">` inside an `<ol>`.
+ * Parsing is tolerant: it extracts every `<li class="b_algo">` block,
+ * parses title + URL + snippet from each, and dedupes by URL.
+ *
+ * @param {string} html - the raw result page body.
+ * @param {number | undefined} maxResults - parsed source cap; unset means parse the whole page.
+ * @returns {Array<{ url: string, title?: string, snippet?: string }>} the normalized sources.
+ */
+function parseBingHtml(html, maxResults) {
+  const sources = [];
+  const seen = new Set();
+  // Split on <li class="b_algo"> boundaries — each block is one result.
+  const blocks = html.split(/<li\s+class\s*=\s*["']?\s*b_algo\b/i);
+  // Skip the first element (everything before the first result).
+  for (let i = 1; i < blocks.length && (maxResults == null || sources.length < maxResults); i++) {
+    // Trim to the next </li> to avoid parsing across blocks.
+    const block = blocks[i].split(/<\/li>/i)[0] ?? blocks[i];
+    const parsed = parseBingResultBlock(block);
+    if (parsed == null || seen.has(parsed.url)) continue;
+    seen.add(parsed.url);
+    sources.push({
+      url: parsed.url,
+      ...(parsed.title.length > 0 ? { title: parsed.title } : {}),
+      ...(parsed.snippet.length > 0 ? { snippet: parsed.snippet } : {})
+    });
+  }
+  return sources;
+}
+
+/**
+ * True when an otherwise-2xx Bing page is actually a captcha/bot gate.
+ *
+ * @param {string} html - the response body.
+ * @returns {boolean} whether the page looks like a block/captcha gate.
+ */
+function looksBlocked(html) {
+  const lower = html.slice(0, 20000).toLowerCase();
+  return /(captcha|verify you are human|are you a robot|unusual traffic|access denied|challenge-platform)/.test(lower);
+}
+
+/**
+ * Build a fetch error that the seam surfaces as a structured provider failure.
+ * The endpoint is named so configuration mistakes are recoverable from the
+ * error text alone.
+ *
+ * @param {string} endpoint - the endpoint the request used.
+ * @param {string} message - the human-readable failure.
+ * @param {unknown} [cause] - the underlying error, when any.
+ * @returns {WebError} a {@link WebError} with code `WEB_PROVIDER_ERROR`.
+ */
+function providerError(endpoint, message, cause) {
+  return new WebError(
+    `${message}\n\nThe web search request used endpoint ${JSON.stringify(endpoint)}. If that endpoint is not intended, set bing-search.endpoint in ~/.dsh/settings.yaml, or set the endpoint key of the bing-search cordis config. Only the user should choose or change the endpoint.`,
+    "WEB_PROVIDER_ERROR",
+    cause === undefined ? undefined : { cause }
+  );
+}
+
+/** Throw the provider's stable cancellation error when the caller already aborted. */
+function throwIfSearchAborted(signal) {
+  if (signal?.aborted === true) throw searchAborted(signal);
+}
+
+/** Build the provider's stable cancellation error while retaining the caller's reason. */
+function searchAborted(signal, fallback) {
+  return new WebError("Bing free search aborted", "WEB_ABORTED", { cause: signal?.aborted === true ? signal.reason : fallback });
+}
+
+/** True for a fetch/`AbortSignal` abort, surfaced as `WEB_ABORTED`. */
+function isAbortError(error) {
+  return error instanceof DOMException && error.name === "AbortError";
+}
+
+/**
+ * The Bing-backed free search provider.
+ *
+ * `available()` reports whether the configured endpoint is a parseable URL:
+ * the provider needs no key, credential, or environment setup, so a valid
+ * endpoint is the only precondition.
+ */
+class BingFreeSearchProvider {
+  id = PROVIDER_ID;
+
+  /**
+   * @param {() => { endpoint: string, maxResults: number, ensearch: number }} resolveOptions -
+   *   the options for the NEXT operation, snapshotted once at each operation's
+   *   entry so one search never mixes two sections. A thunk rather than a value
+   *   because the plugin's settings section can change between searches, and
+   *   re-registering the provider to carry a new endpoint would make the seam's
+   *   selection observable to the user as a flicker.
+   */
+  constructor(resolveOptions) {
+    this.resolveOptions = resolveOptions;
+  }
+
+  available() {
+    const options = this.resolveOptions();
+    return URL.canParse(options.endpoint) && Number.isInteger(options.maxResults) && options.maxResults > 0;
+  }
+
+  async search(request, signal) {
+    const options = this.resolveOptions();
+    const query = (request.query ?? "").trim();
+    if (query.length === 0) throw providerError(options.endpoint, "Bing free search requires a non-empty query");
+    throwIfSearchAborted(signal);
+    const params = new URLSearchParams({ q: query, ensearch: String(options.ensearch) });
+    const url = `${options.endpoint}?${params.toString()}`;
+    let response;
+    try {
+      response = await fetch(url, {
+        method: "GET",
+        redirect: "follow",
+        headers: {
+          "user-agent": USER_AGENT,
+          accept: "text/html,application/xhtml+xml",
+          "accept-language": "zh-CN,zh;q=0.9,en;q=0.8"
+        },
+        ...(signal !== undefined ? { signal } : {})
+      });
+    } catch (error) {
+      if (signal?.aborted === true || isAbortError(error)) throw searchAborted(signal, error);
+      throw providerError(options.endpoint, `Bing free search request failed: ${String(error)}`, error);
+    }
+    if (!response.ok) {
+      throw providerError(options.endpoint, `Bing search returned HTTP ${response.status}`);
+    }
+    let html;
+    try {
+      html = await response.text();
+    } catch (error) {
+      if (signal?.aborted === true || isAbortError(error)) throw searchAborted(signal, error);
+      throw providerError(options.endpoint, `Bing returned an unreadable response body: ${String(error)}`, error);
+    }
+    if (looksBlocked(html)) {
+      throw providerError(
+        options.endpoint,
+        "Bing answered with a captcha/gate instead of results. Retry later, or switch the searchProvider to another backend."
+      );
+    }
+    const sources = parseBingHtml(html, options.maxResults);
+    return { sources, truncated: false };
+  }
+}
+//#endregion
+
+//#region index
+/**
+ * Register a free Bing-backed provider in `ctx.web`. It calls Bing's public
+ * HTML endpoint and needs no API key, so `web_search` runs without any
+ * DeepSeek/model search quota. The provider id is `bing-free`; the bundle's
+ * `cordis.patch.yml` sets `web.searchProvider` to it.
+ *
+ * Optional settings expose the endpoint, language mode, and parse cap for
+ * deployments that need a different mirror, language, or page budget.
+ * @module dsh-bing-search
+ */
+
+/** Cordis plugin name used by loader diagnostics. */
+const name = "bing-search";
+
+/** The web seam this provider registers into. */
+const inject = ["web"];
+
+const Config = z.object({
+  endpoint: z.string().default(DEFAULT_ENDPOINT),
+  maxResults: z.number().step(1).min(1).default(DEFAULT_MAX_RESULTS),
+  ensearch: z.number().step(1).min(0).max(1).default(DEFAULT_ENSEARCH)
+});
+
+/** Settings namespace carrying this provider's endpoint and parse cap. */
+const WEB_SEARCH_BING_SETTINGS_NAMESPACE = "bing-search";
+
+/**
+ * Project one resolved section into the options the provider serves its next
+ * search with: every value it reads is already fully defaulted.
+ *
+ * @param {unknown} config - the currently authoritative section.
+ * @returns {{ endpoint: string, maxResults: number, ensearch: number }} options for one search.
+ */
+function resolveOptions(config) {
+  return {
+    endpoint: config?.endpoint ?? DEFAULT_ENDPOINT,
+    maxResults: config?.maxResults ?? DEFAULT_MAX_RESULTS,
+    ensearch: config?.ensearch ?? DEFAULT_ENSEARCH
+  };
+}
+
+/** Register the free Bing search provider with `ctx.web`. */
+function apply(ctx, config) {
+  let current = () => config;
+  ctx.inject(["settings"], (settingsCtx) => {
+    settingsCtx.settings.installSection(ctx, WEB_SEARCH_BING_SETTINGS_NAMESPACE, Config, config, {
+      setSource: (source) => {
+        current = source;
+      },
+      onChange: () => {}
+    });
+  });
+  ctx.web.registerSearchProvider(new BingFreeSearchProvider(() => resolveOptions(current())));
+}
+
+export {
+  Config,
+  DEFAULT_ENDPOINT,
+  DEFAULT_ENSEARCH,
+  DEFAULT_MAX_RESULTS,
+  PROVIDER_ID,
+  BingFreeSearchProvider,
+  WEB_SEARCH_BING_SETTINGS_NAMESPACE,
+  apply,
+  inject,
+  name
+};
+//#endregion

package/lib/types/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Types for the Bing-backed free web search provider bundle.
+ * @module dsh-bing-search
+ */
+
+/** One normalized search hit returned by a provider. */
+export interface WebSource {
+    url: string;
+    title?: string;
+    snippet?: string;
+    publishedAt?: string;
+}
+/** The request the web seam forwards to a search provider. */
+export interface WebSearchRequest {
+    query: string;
+    maxResults?: number;
+}
+/** The normalized result a search provider resolves with. */
+export interface WebSearchResult {
+    sources: WebSource[];
+    truncated: boolean;
+}
+/** The provider contract `ctx.web.registerSearchProvider` accepts. */
+export interface WebSearchProvider {
+    readonly id: string;
+    available(): boolean;
+    search(request: WebSearchRequest, signal?: AbortSignal): Promise<WebSearchResult>;
+}
+/** Fully-defaulted options one search executes with. */
+export interface BingFreeSearchOptions {
+    endpoint: string;
+    maxResults: number;
+    ensearch: number;
+}
+/** Stable provider id (bing-free). */
+export declare const PROVIDER_ID: string;
+/** Default public HTML search endpoint (cn.bing.com/search). */
+export declare const DEFAULT_ENDPOINT: string;
+/** Default ensearch param (0 = Chinese results). */
+export declare const DEFAULT_ENSEARCH: number;
+/** Default upper bound on parsed results per page. */
+export declare const DEFAULT_MAX_RESULTS: number;
+/** Settings namespace for this provider (`bing-search`). */
+export declare const WEB_SEARCH_BING_SETTINGS_NAMESPACE: string;
+/**
+ * The Bing-backed free provider, satisfying {@link WebSearchProvider}.
+ * `available()` reports whether the configured endpoint is a parseable URL —
+ * no key, credential, or environment setup is required.
+ */
+export declare class BingFreeSearchProvider implements WebSearchProvider {
+    readonly id: string;
+    constructor(resolveOptions: () => BingFreeSearchOptions);
+    available(): boolean;
+    search(request: WebSearchRequest, signal?: AbortSignal): Promise<WebSearchResult>;
+}
+/** Cordis plugin name. */
+export declare const name: string;
+/** Services injected by this plugin. */
+export declare const inject: string[];
+/** Schema for the config / settings section. */
+export declare const Config: unknown;
+/** Cordis plugin apply entry: registers the provider with `ctx.web`. */
+export declare function apply(ctx: any, config: any): void;

package/package.json

@@ -0,0 +1,61 @@
+{
+    "name": "dsh-bing-search",
+    "description": "Free Bing-backed web search provider for DeepSeek Harness (DSH). No API key needed, uses cn.bing.com for mainland China accessibility.",
+    "version": "1.1.3",
+    "license": "MIT",
+    "type": "module",
+    "main": "lib/index.js",
+    "types": "lib/types/index.d.ts",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/whiteS18/dsh-bing-search.git"
+    },
+    "bugs": {
+        "url": "https://github.com/whiteS18/dsh-bing-search/issues"
+    },
+    "homepage": "https://github.com/whiteS18/dsh-bing-search#readme",
+    "exports": {
+        ".": {
+            "types": "./lib/types/index.d.ts",
+            "default": "./lib/index.js"
+        },
+        "./cordis.patch.yml": "./cordis.patch.yml",
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "lib/index.js",
+        "lib/types",
+        "cordis.patch.yml",
+        "README.md",
+        "README_EN.md",
+        "LICENSE",
+        "CHANGELOG.md"
+    ],
+    "engines": {
+        "node": ">=18"
+    },
+    "dsh": {
+        "bundle": {
+            "patch": "./cordis.patch.yml"
+        }
+    },
+    "peerDependencies": {
+        "@deepseek-ai/dsh-settings": ">=0.1.5-rc.1 <0.2.0-0",
+        "@deepseek-ai/dsh-web": ">=0.1.5-rc.1 <0.2.0-0",
+        "@deepseek-ai/cordis": "^4.0.2"
+    },
+    "dependencies": {
+        "@deepseek-ai/schemastery": "^3.18.2"
+    },
+    "keywords": [
+        "deepseek-harness",
+        "dsh",
+        "dsh-plugin",
+        "plugin",
+        "search",
+        "web-search",
+        "bing",
+        "free",
+        "cn-bing"
+    ]
+}