English | 中文
> This is a maintenance fork of [godchen520/dsh-web-search-bing](https://github.com/godchen520/dsh-web-search-bing), compatible with DSH `>=0.1.5-rc.1 <0.3.0` (including `0.2.0-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 The configuration UI depends on the DSH version: - **DSH >= 0.1.6**: the plugin detail page under Settings → Plugins provides a config form (endpoint URL, parse limit, result language). Saving takes effect immediately — all three fields are volatile and hot-reloaded, no restart needed. - **DSH <= 0.1.5**: the plugin auto-generates a settings section via `settings.installSection`. You can also edit `~/.dsh/settings.yaml` directly (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 (must be a valid URL, otherwise the provider reports unavailable) | | `maxResults` | `20` | Max results parsed per search (positive integer, min 1) | | `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. Errors are `WebError`s (code `WEB_PROVIDER_ERROR` / `WEB_ABORTED`) whose messages include recovery guidance. If the error mentions a captcha/anti-bot gate, Bing has triggered human verification — retry later or temporarily switch back to the official search. ## Restoring the default search This plugin switches the `web` row's `searchProvider` to `bing-free` (the provider id). To restore: change `searchProvider` in this plugin's patch back to `deepseek-official` (or remove this package from `bundles`) and restart. > [!WARNING] > The bundled `cordis.patch.yml` **replaces the whole `web` row**, so it must restate `fetchProvider: http`. If you customize the patch and only write `searchProvider` without `fetchProvider`, you will lose the default fetch configuration. ## How It Works Queries `cn.bing.com/search` (with a desktop Chrome UA and `accept-language: zh-CN`) → parses HTML result blocks (`