dsh-serper-provider
DSH 插件 dsh-serper-provider
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-serper-provider@1.0.1DSH 插件 dsh-serper-provider
Serper Provider 以 dsh-serper-provider 发布，当前版本为 1.0.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →
dsh-serper-provider)A Cordis bundle that registers a Serper backend into the Harness web capability
seam (ctx.web), following the shape of the official
@deepseek-ai/dsh-web-search-deepseek provider: name / inject / Config /
apply, a provider object with id, a cheap available(), and
search(request, signal). It owns only transport and mapping — the model-facing
web_search schema stays with @deepseek-ai/dsh-tool-web — and it also registers
its own serper_search tool (see below). The browser half is the settings form the
Plugins page renders for this bundle's row.
Registers under provider id serper.
The patch does not pin searchProvider. With the profile's existing
DeepSeek provider also registered and usable, an un-pinned search reports
WEB_PROVIDER_AMBIGUOUS; to route searches to Serper, add to the profile patch:
- id: include:web
config:
searchProvider: serper
POST https://google.serper.dev/search with header X-API-KEY and body:
{ "q": "<query>", "gl": "us", "hl": "en", "num": 10, "page": 1 }
num follows the caller's maxResults when that is smaller than the configured
page size. The seam enforces the final cap, so truncated is never set here.
organic[] → sources[] (link → url, title, snippet, date → publishedAt),
deduped by URL.answerBox.answer / answerBox.snippet → the optional provider content.redirect: "error"), as in the official provider.web-search-serper)| Field | Default | Meaning |
|---|---|---|
apiKey | — | literal key, role: secret (prefer the credentials service) |
apiKeyEnv | SERPER_API_KEY | credential reference resolved per search |
endpoint | https://google.serper.dev/search | Serper Search API endpoint (SERPER_SEARCH_ENDPOINT env fallback) |
gl / hl | us / en | Serper locale parameters |
num | 10 (1–100) | results per page |
page | 1 | result page |
includeAnswerBox | true | surface Serper's answer box as the provider answer |
tool | true | register this plugin's own serper_search tool |
toolMaxResults | 8 (1–100) | source cap the tool enforces on its own result |
toolTimeoutMs | 30000 | the tool's cooperative timeout budget (ToolDefinition.timeoutMs) |
Settings namespace: web-search-serper (the row id), which is what the Plugin
Manager resolves as props.form for the row. The plugins.row.config slot key is
dsh-serper-provider#web-search-serper (<package name>#<row id>), and
client.js registers the form there. The official Settings → Web search page is
bound to the web-search-deepseek namespace, so it never shows Serper.
serper_search)dsh-tool-web owns the model-facing web_search, and that tool goes through the
seam, so it depends on provider selection. serper_search calls this plugin's
provider object directly, so it works without searchProvider being configured:
{ "query": "deepseek harness", "type": "news", "page": 2, "maxResults": 5 }
query is required; type (organic | news), page (1–10), maxResults,
gl, and hl are optional and fall back to the plugin settings.toolMaxResults cap and reports truncated.card: "web" / kind: "search" view, so the Chat tool
card matches the official web tools.search() implementation; the tool owns schema,
validation, formatting, and presentation only.| Situation | WebError code |
|---|---|
| No key resolves | WEB_PROVIDER_CREDENTIAL_MISSING |
| Serper rejects the key (HTTP 401/403) | WEB_PROVIDER_CREDENTIAL_MISSING |
| Caller cancellation | WEB_ABORTED |
| Transport / provider / unmappable body | WEB_PROVIDER_ERROR (names the endpoint) |
From the DSH 1024Store catalog (the package is published to npm as
dsh-serper-provider):
dsh1024 plugin --profile web add dsh-serper-provider
# or the official command
dsh plugin --profile web add dsh-serper-provider
Or from this directory as a local bundle:
# plugin_manager: action install_bundle, target <absolute path to this directory>
Then restart the profile if the plugin module is already loaded (replacing an installed package needs a fresh JavaScript module generation). The browser half needs only a renderer reload.
apply, and the serper_search tooldsh.clientlocale/en.json, locale/zh.json, icon.svgThe seam request shape carries only query and maxResults; the extra fields the
tool passes (block, page, gl, hl) are provider-private extensions used on
the tool path only.