dsh-search-picker
DeepSeek Harness 的侧边栏搜索提供商选择器：从桌面侧边栏在 DeepSeek Messages、DeepSeek Search API、OpenCode Go、Tavily 和 Exa 之间切换 ctx.web。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:xiaoxiaosrm/dsh-search-picker#9251dcd98795301221bf19d91738d7641a048e3cSearch Picker 以 dsh-search-picker 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
A DeepSeek Harness (DSH) bundle plugin that puts a “Search: …” button at the
bottom of the desktop sidebar (right above the Settings row) and switches
ctx.web's search backend with one click.
The picker writes the official web settings namespace's searchProvider
field — the exact same field edited by Plugins › Web search in the DSH
settings UI. Therefore:
| id | Engine | Credential | Notes |
|---|---|---|---|
deepseek-official | DeepSeek official Messages | DEEPSEEK_API_KEY | Built in. Anthropic Messages + web_search_20250305; each search consumes model tokens |
deepseek-search-api | DeepSeek official Search API | DEEPSEEK_API_KEY | Built in. Direct retrieval endpoint; no model tokens |
opencode-go | OpenCode Go | OPENCODE_GO_API_KEY | Provided by this plugin. Anthropic Messages + x-opencode-session header; ≈ $0.01 per search |
tavily | Tavily | TAVILY_API_KEY | Provided by this plugin; greyed out until a key is configured |
exa | Exa | EXA_API_KEY | Provided by this plugin; greyed out until a key is configured |
Engines without credentials are greyed out in the menu. Selecting an
unregistered/unavailable provider directly in the settings page makes
web_search return an explicit WEB_PROVIDER_* error instead of silently
falling back to another engine.
dsh-search-picker menu in the DSH desktop sidebar
The button sits at the bottom of the sidebar, right above the Settings row. The
menu is a position: fixed popover: its width follows the sidebar content width
(sidebar defaults to 280 px, draggable 264–420 px → menu 240–396 px) and updates
live while dragging, so it is never clipped by the sidebar column's
overflow: hidden. When the sidebar collapses to the 56 px icon rail, the menu
pops out at 280 px to the right.
The menu background is opaque: white in the light theme, dark grey in the dark
theme (--dsw-alias-bg-layer-1, theme-aware), with the official popover
hairline stroke and soft elevation shadow (--dsw-elevation-panel). The
official menu material (--dsw-specific-menu + backdrop-filter blur) is
intentionally not used: that surface is only 58 % opaque and relies on the blur
to look right, so without the blur the sidebar text bleeds through.
Clone the repo to a fixed location:
git clone https://github.com/xiaoxiaosrm/dsh-search-picker.git D:\tools\dsh-search-picker
Edit %DSH_HOME%\profiles\desktop\package.json
(POSIX: $DSH_HOME/profiles/desktop/package.json):
"dsh-search-picker": "file:D:/tools/dsh-search-picker";"dsh-search-picker" to dsh.profile.bundles.In %DSH_HOME%\profiles\desktop, run pnpm install.
Fully quit and reopen the DSH desktop app. The loader scans profile bundles only at startup, and the client half is read into memory at startup too — so a page refresh is not enough after updating the plugin.
If the file: dependency fails to resolve, copy this directory into
%DSH_HOME%\profiles\desktop\node_modules\dsh-search-picker and add the package
name to dsh.profile.bundles instead.
The bundle ships a default patch entry (cordis.patch.yml). Every field is
optional; omitted fields fall back to the defaults below.
- insert:
- id: search-picker
name: dsh-search-picker
config:
opencodeGo:
baseURL: https://opencode.ai/inference/go/anthropic/v1
model: deepseek-v4.1-flash
maxTokens: 4096
maxUses: 5
tavily:
baseURL: https://api.tavily.com
apiKeyEnv: TAVILY_API_KEY
exa:
baseURL: https://api.exa.ai
apiKeyEnv: EXA_API_KEY
Override any value by targeting the same entry id from your profile's
cordis.patch.yml.
This plugin never reads or writes the credentials file directly. At search time
it resolves the credential reference named by apiKeyEnv through
ctx.credentials, falling back to the process environment. A missing credential
raises WEB_PROVIDER_CREDENTIAL_MISSING, and the message names the referenced
variable.
deepseek-official in the menu (or use the official
Plugins › Web search page).dsh-search-picker from the profile package.json dependencies and
from dsh.profile.bundles, run pnpm install, restart the desktop app.deepseek-official returns 404: check that neither the profile patch nor
another plugin overrides web-search-deepseek.baseURL. It must stay on the
built-in default (https://api.deepseek.com/anthropic/v1); pointing it at a
search provider's host breaks the provider.ResizeObserver; after profile/bundle changes, restart the desktop app
to reload the client bundle.npm run check # node --check on all three entry files
npm test # node --test test/engines.test.mjs
node test/engines.test.mjs # single-process fallback
The single-process fallback exists for Windows sandboxes that block
child-process pipes (spawn EPERM).
apiKeyEnv
is remapped to another credential name, the greyed-out state still checks the
default reference name.web.searchProvider at runtime
(dsh-free-search, dsh-web-search-free, …). Do not install them together.opencode-go's x-opencode-session uses a random in-process UUID when the
current session id is unavailable (the Go relay only needs it to be opaque and
stable).0.2.1-rc.2 (declared in package.json → dsh.compatibility).web platform and injects
@deepseek-ai/dsh-api-remotes, @deepseek-ai/dsh-client-locale,
@deepseek-ai/dsh-client-ui-settings.MIT © 2026 xiaoxiaosrm