dsh-web-search-plugin 0.1.2 → 0.2.0

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 本项目的重要变更都记录在此。格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。
 
+## [0.2.0] - 2026-08-19
+
+### 新增
+
+- **DeepSeek（官方）后端**（`lib/deepseek.js`）。设置项 `provider: deepseek-official` 走 DeepSeek 的 Anthropic 兼容 Messages API（原生 `web_search_20250305` 工具，凭据名 `DEEPSEEK_API_KEY`）。bundle 层顺带禁用内置 `web-search-deepseek` Host 插件，从而移除旧的「插件 → 网页搜索」卡片、避免重复注册 provider。
+- **顶层「设置 → 网页搜索」分区**。配置入口从「设置 → 插件 → 插件配置」里的 keyed 卡片改为 `settings.section`（id `web-search`）——与「插件」分区同级，一张卡内切换 DeepSeek / Tavily / Brave，并各自展开对应配置项（模型、API 版本、max tokens / max uses 等）。
+
+### 变更
+
+- `provider` 取值扩展为 `deepseek-official` / `tavily`（默认）/ `brave`；接缝 id 仍为 `dsh-web-search`。
+- 新增 `lib/deepseek.js`；`package.json` 版本号 bump 到 `0.2.0`，`check` 脚本纳入新文件。
+
 ## [0.1.2] - 2026-08-18
 
 ### 新增
@@ -44,6 +56,7 @@
 - Keyless 模式（`X-Tavily-Access-Mode: keyless`）与 keyed 模式（通过 `TAVILY_API_KEY` 凭据引用发送 Bearer token）。
 - DSH 插件配置页上的浏览器设置卡片。
 
+[0.2.0]: https://github.com/X-C1811/dsh-web-search-plugin/compare/v0.1.2...v0.2.0
 [0.1.2]: https://github.com/X-C1811/dsh-web-search-plugin/compare/v0.1.1...v0.1.2
 [0.1.1]: https://github.com/X-C1811/dsh-web-search-plugin/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/X-C1811/dsh-web-search-plugin/releases/tag/v0.1.0

package/README.md

@@ -1,10 +1,11 @@
 # dsh-web-search-plugin
 
-面向 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) web 能力接缝（`ctx.web`）的 Tavily / [Brave Search](https://brave.com/search/api/) 搜索插件。本包只向接缝注册 **一个** `WebSearchProvider`，稳定 id 为 `dsh-web-search`。在设置卡里切换引擎即可，不必再改 `web.searchProvider`。
+面向 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) web 能力接缝（`ctx.web`）的统一网页搜索插件，内置 **DeepSeek（官方）/ Tavily / [Brave Search](https://brave.com/search/api/) 三个后端**。本包只向接缝注册 **一个** `WebSearchProvider`，稳定 id 为 `dsh-web-search`。在设置卡里切换引擎即可，不必再改 `web.searchProvider`。
 
+- **DeepSeek（官方）** — 走 DeepSeek 的 Anthropic 兼容 Messages API（原生 `web_search_20250305` 工具，凭据名 `DEEPSEEK_API_KEY`），一次搜索消耗一个模型轮次。
 - **Tavily（默认）** — `keyless`（免费、限流、无需账号）或 `keyed`（`TAVILY_API_KEY`，Bearer token）。
 - **Brave Search** — `GET https://api.search.brave.com/res/v1/web/search`，请求头 `X-Subscription-Token`（凭据名 `BRAVE_API_KEY`）。一次搜索就是一次 HTTP 请求，不走模型轮次。
-- **不写自定义 session 事件** — 独立 Brave 插件每次调用都会写入 `web/brave-search-request`。该类型不在 DSH 的 `KNOWN_SESSION_EVENT_TYPES` 里，且 `Session.append` 无法加上 `ignorable: true`，冷加载会整段拒绝会话。本插件不会写这类信封。
+- **不写自定义 session 事件** — 工具结果已经走接缝自己的事件，无需多余信封。
 
 ## 特性
 
@@ -21,7 +22,7 @@
 
 ## 安装
 
-本包是 **bundle**：`dsh.bundle.patch` + `cordis.patch.yml` 会插入 Host 行，并把 `web.searchProvider` 设为 `dsh-web-search`。没有这一声明时，`dsh plugin add` 只写入依赖，插件不会挂载。
+本包是 **bundle**：`dsh.bundle.patch` + `cordis.patch.yml` 会插入 Host 行、把 `web.searchProvider` 设为 `dsh-web-search`，并**禁用内置 `web-search-deepseek` Host 插件**（本插件已自行托管 DeepSeek 后端，禁用它能移除旧的「插件 → 网页搜索」卡片、避免重复注册 provider）。没有这一声明时，`dsh plugin add` 只写入依赖，插件不会挂载。
 
 ### 从 npm 安装
 
@@ -52,7 +53,7 @@ dsh plugin --profile web add "path/to/dsh-web-search-plugin"
 dsh plugin --profile web remove @dsh-ltctfer/dsh-web-search-brave
 ```
 
-然后在「设置 → 插件 → 插件配置 → 网页搜索」里把引擎切到 Brave，即可继续使用已有的 `BRAVE_API_KEY`。
+然后在 **设置 → 网页搜索** 里把引擎切到想要的提供方，即可继续使用对应的 API key。
 
 > **关于 `file:`（本地）安装** — pnpm 会把 `file:path` 依赖做成快照。改完本仓库后，需要再执行一次 `dsh plugin --profile web add "path/to/dsh-web-search-plugin"` 并重启。
 
@@ -62,15 +63,22 @@ dsh plugin --profile web remove @dsh-ltctfer/dsh-web-search-brave
 
 | 键 | 默认值 | 含义 |
 |---|---|---|
-| `provider` | `tavily` | `tavily` 或 `brave` |
+| `provider` | `tavily` | `tavily`、`brave` 或 `deepseek-official` |
 | `mode` | `keyless` | 仅 Tavily：`keyless` 或 `keyed` |
 | `apiKey` | — | Tavily API key 字面量（走凭据域，不会回显） |
 | `apiKeyEnv` | `TAVILY_API_KEY` | keyed Tavily 使用的凭据/环境变量名 |
 | `baseURL` | `https://api.tavily.com` | Tavily REST 基址；会再拼 `/search` |
-| `maxResults` | `8` | 每次搜索返回的源数量（1–20），两个引擎共用 |
+| `maxResults` | `8` | 每次搜索返回的源数量（1–20），三个后端共用 |
 | `searchDepth` | `basic` | 仅 Tavily：`basic` 或 `advanced` |
 | `includeAnswer` | `true` | 仅 Tavily：请求生成摘要，写入结果 `content` |
 | `topic` | `general` | 仅 Tavily：`general` 或 `news` |
+| `deepseekApiKey` | — | DeepSeek API key 字面量（走凭据域） |
+| `deepseekApiKeyEnv` | `DEEPSEEK_API_KEY` | DeepSeek 使用的凭据/环境变量名 |
+| `deepseekBaseURL` | `https://api.deepseek.com/anthropic/v1` | DeepSeek Anthropic 兼容 Messages 基址；再拼 `/messages` |
+| `model` | `deepseek-v4-flash` | Anthropic 格式模型名 |
+| `apiVersion` | `2023-06-01` | `anthropic-version` 请求头 |
+| `maxTokens` | `4096` | Messages 请求生成 token 上限 |
+| `maxUses` | `5` | 每次请求 `web_search` 工具的最大调用次数 |
 | `braveApiKey` | — | Brave 订阅 token 字面量（走凭据域） |
 | `braveApiKeyEnv` | `BRAVE_API_KEY` | Brave 使用的凭据/环境变量名 |
 | `braveBaseURL` | `https://api.search.brave.com/res/v1/web/search` | Brave 网页搜索接口 |
@@ -81,12 +89,13 @@ dsh plugin --profile web remove @dsh-ltctfer/dsh-web-search-brave
 
 环境变量：启动时 `DSH_WEB_SEARCH_PROVIDER=dsh-web-search` 会选中本接缝 id。未设置 `baseURL` 时，Tavily 基址回退 `$TAVILY_BASE_URL`。
 
-## 切回内置搜索
+## 切回内置 DeepSeek
 
-在 profile 的 patch 里把 `searchProvider` 改回 `deepseek-official`。本插件可以继续挂着，只是不会被选中。
+DeepSeek 已并入本插件（`provider: deepseek-official`），无需切回。若确要恢复 DSH 内置的 DeepSeek host 插件，请在 profile patch 里去掉对 `web-search-deepseek` 的 `disabled` 并把 `searchProvider` 设回 `deepseek-official`；本插件可以继续挂着，只是不会被选中。
 
 ## 工作方式
 
+- **DeepSeek** — `POST {deepseekBaseURL}/messages`，请求头 `x-api-key` / `authorization: Bearer`，工具 `web_search_20250305`。
 - **Tavily** — `POST {baseURL}/search`。keyless 发送 `x-tavily-access-mode: keyless`；keyed 发送 `authorization: Bearer <key>`。
 - **Brave** — `GET {braveBaseURL}?q=&count=`，请求头 `x-subscription-token`。不向 session 追加自定义事件。
 - 非 2xx 映射为 `WEB_PROVIDER_ERROR`；调用方取消映射为 `WEB_ABORTED`。
@@ -95,11 +104,12 @@ dsh plugin --profile web remove @dsh-ltctfer/dsh-web-search-brave
 
 ```
 lib/index.js       Host 插件：Config、分发提供方、设置段
+lib/deepseek.js    DeepSeek 后端（Anthropic Messages + web_search_20250305）
 lib/tavily.js      Tavily 后端
 lib/brave.js       Brave 后端（不写自定义 session 事件）
 lib/shared.js      中止 / 凭据解析辅助
-lib/client.js      浏览器 bundle：引擎切换 + 配置卡片
-cordis.patch.yml   Bundle patch：插入 Host 行，并把 searchProvider 设为 dsh-web-search
+lib/client.js      浏览器 bundle：顶层「网页搜索」分区 + 引擎切换表单
+cordis.patch.yml   Bundle patch：插入 Host 行、设 searchProvider、禁用内置 deepseek
 ```
 
 ## 开发
@@ -108,19 +118,19 @@ cordis.patch.yml   Bundle patch：插入 Host 行，并把 searchProvider 设为
 npm run check
 ```
 
-客户端 bundle 必须保持 `window.__ModuleLoader__.load({ id, factory })` 线格式 — 由 `dsh-client-modules` 加载，不是打包器。必须同时导出 `apply` 和 `inject`（`slots`、`locale`、`connection`、`remote`、`settingsScope`），并以带 `key` 的方式把卡片注册进 keyed 的 `settings.plugin.item` slot。
+客户端 bundle 必须保持 `window.__ModuleLoader__.load({ id, factory })` 线格式 — 由 `dsh-client-modules` 加载，不是打包器。必须同时导出 `apply` 和 `inject`（`slots`、`locale`、`connection`、`remote`、`settingsScope`），并把分区注册进 `settings.section`（`id: "web-search"`）。
 
 ## 发布
 
-发布由 GitHub Actions（`.github/workflows/publish.yml`）自动完成：**推送 `v*` 标签**（例如 `v0.1.2`）会带 provenance 发到 npm。向 `main` 的普通推送不会发布。
+发布由 GitHub Actions（`.github/workflows/publish.yml`）自动完成：**推送 `v*` 标签**（例如 `v0.2.0`）会带 provenance 发到 npm。向 `main` 的普通推送不会发布。
 
-1. 确认 `package.json` 的 `version` 与即将推送的标签一致（例如 `0.1.2` → `v0.1.2`）。
+1. 确认 `package.json` 的 `version` 与即将推送的标签一致（例如 `0.2.0` → `v0.2.0`）。
 2. 在 GitHub **Settings → Secrets and variables → Actions** 里配置有 publish 权限的 npm automation token（仓库密钥 `NPM_TOKEN`），并允许 Actions 运行。
 3. 打标签并推送：
 
    ```powershell
-   git tag v0.1.2
-   git push origin v0.1.2
+   git tag v0.2.0
+   git push origin v0.2.0
    ```
 
 工作流会先核对标签与 `package.json` 的 `version`，再执行 `npm publish --provenance --access public`。

package/cordis.patch.yml

@@ -5,13 +5,19 @@
 #
 # `searchProvider` is restated in full because a Cordis patch replaces the
 # targeted row's whole `config`. The profile's own cordis.patch.yml still
-# wins if it later overrides `web`. The seam id is `dsh-web-search`; Tavily
-# vs Brave is the plugin's own `provider` setting, not a second web patch.
+# wins if it later overrides `web`. The seam id is `dsh-web-search`; the
+# backend (DeepSeek / Tavily / Brave) is the plugin's own `provider` setting.
 - id: web
   name: '@deepseek-ai/dsh-web'
   config:
     searchProvider: dsh-web-search
 
+# This plugin re-hosts the DeepSeek backend, so the in-box DeepSeek host
+# plugin is redundant: disabling it removes its `deepseek-official` provider
+# (no duplicate) and hides the legacy "Plugins → web search" card.
+- id: web-search-deepseek
+  disabled: true
+
 - insert:
     - id: dsh-web-search-plugin
       name: dsh-web-search-plugin

package/lib/client.js

@@ -1,9 +1,9 @@
 /**
- * Browser half of `dsh-web-search-plugin`: a plugin card under the
- * "settings → Plugins → Plugin configuration" surface that edits the
- * `dsh-web-search-plugin` settings namespace. The card switches the
- * Tavily / Brave backend and writes each engine's credential through the
- * credentials domain (`TAVILY_API_KEY` / `BRAVE_API_KEY` by default).
+ * Browser half of `dsh-web-search-plugin`: a top-level "Web search" settings
+ * section (settings → Web search) that edits the `dsh-web-search-plugin`
+ * settings namespace. The card switches the DeepSeek / Tavily / Brave backend
+ * and writes each engine's credential through the credentials domain
+ * (`DEEPSEEK_API_KEY` / `TAVILY_API_KEY` / `BRAVE_API_KEY` by default).
  *
  * This bundle is a self-contained hand-written module in the exact wire format
  * the client module system expects: one `window.__ModuleLoader__.load` call
@@ -29,11 +29,15 @@ window.__ModuleLoader__.load({
 		const DEFAULT_TAVILY_KEY_REF = "TAVILY_API_KEY";
 		/** Credential reference Brave resolves when the section names none. */
 		const DEFAULT_BRAVE_KEY_REF = "BRAVE_API_KEY";
+		/** Credential reference DeepSeek resolves when the section names none. */
+		const DEFAULT_DEEPSEEK_KEY_REF = "DEEPSEEK_API_KEY";
 		/** Form field the Tavily write-only credential control stages under. */
 		const TAVILY_API_KEY_FIELD = "apiKey";
 		/** Form field the Brave write-only credential control stages under. */
 		const BRAVE_API_KEY_FIELD = "braveApiKey";
-		const SECRET_FIELDS = new Set([TAVILY_API_KEY_FIELD, BRAVE_API_KEY_FIELD]);
+		/** Form field the DeepSeek write-only credential control stages under. */
+		const DEEPSEEK_API_KEY_FIELD = "deepseekApiKey";
+		const SECRET_FIELDS = new Set([TAVILY_API_KEY_FIELD, BRAVE_API_KEY_FIELD, DEEPSEEK_API_KEY_FIELD]);
 
 		/** Locale bundles for the card. */
 		const en = {
@@ -42,6 +46,7 @@ window.__ModuleLoader__.load({
 			provider: "Search engine",
 			providerTavily: "Tavily",
 			providerBrave: "Brave Search",
+			providerDeepseek: "DeepSeek (official)",
 			mode: "Auth mode",
 			modeKeyless: "Keyless (free, rate-limited)",
 			modeKeyed: "API key",
@@ -79,6 +84,18 @@ window.__ModuleLoader__.load({
 			freshnessYear: "Past year",
 			proxy: "Proxy",
 			proxyHint: "HTTP(S) proxy URL. Leave blank to use HTTPS_PROXY / HTTP_PROXY.",
+			deepseekApiKeyEnv: "Credential reference",
+			deepseekApiKeyEnvHint: "Name of the credential/env var resolved for DeepSeek search.",
+			deepseekBaseURL: "Endpoint",
+			deepseekBaseURLHint: "Leave blank to use the DeepSeek Anthropic-compatible API default.",
+			model: "Model",
+			modelHint: "Anthropic-format model name for the search request.",
+			apiVersion: "API version",
+			apiVersionHint: "anthropic-version header value.",
+			maxTokens: "Max tokens",
+			maxTokensHint: "Upper bound on generated tokens for the search request.",
+			maxUses: "Max uses",
+			maxUsesHint: "Maximum web_search server-tool uses per request.",
 			expand: "Show settings",
 			collapse: "Hide settings",
 			save: "Save",
@@ -96,6 +113,7 @@ window.__ModuleLoader__.load({
 			provider: "搜索引擎",
 			providerTavily: "Tavily",
 			providerBrave: "Brave Search",
+			providerDeepseek: "DeepSeek（官方）",
 			mode: "认证模式",
 			modeKeyless: "Keyless（免费、限流）",
 			modeKeyed: "API key",
@@ -133,6 +151,18 @@ window.__ModuleLoader__.load({
 			freshnessYear: "过去一年",
 			proxy: "代理",
 			proxyHint: "HTTP(S) 代理 URL。留空则使用 HTTPS_PROXY / HTTP_PROXY。",
+			deepseekApiKeyEnv: "凭据引用名",
+			deepseekApiKeyEnvHint: "DeepSeek 搜索解析的凭据/环境变量名。",
+			deepseekBaseURL: "接口地址",
+			deepseekBaseURLHint: "留空则使用 DeepSeek Anthropic 兼容 API 默认地址。",
+			model: "模型",
+			modelHint: "搜索请求使用的 Anthropic 格式模型名。",
+			apiVersion: "API 版本",
+			apiVersionHint: "anthropic-version 请求头值。",
+			maxTokens: "最大 token",
+			maxTokensHint: "搜索请求生成 token 的上限。",
+			maxUses: "最大调用次数",
+			maxUsesHint: "每次请求 web_search 服务端工具的最大调用次数。",
 			expand: "展开设置",
 			collapse: "收起设置",
 			save: "保存",
@@ -208,7 +238,13 @@ window.__ModuleLoader__.load({
 					textField("country"),
 					textField("searchLang"),
 					choiceField("freshness"),
-					textField("proxy")
+					textField("proxy"),
+					textField("deepseekApiKeyEnv"),
+					textField("deepseekBaseURL"),
+					textField("model"),
+					textField("apiVersion"),
+					numberField("maxTokens"),
+					numberField("maxUses")
 				].map((spec) => [spec.field, spec]));
 				this.staged = new Map();
 				this.saving = false;
@@ -351,7 +387,7 @@ window.__ModuleLoader__.load({
 				const staged = this.staged.get("provider");
 				if (staged !== void 0 && !staged.clear && staged.text.trim() !== "") return staged.text.trim();
 				const declared = this.sectionValue("provider");
-				return declared === "brave" ? "brave" : "tavily";
+				return declared === "brave" || declared === "deepseek-official" ? declared : "tavily";
 			}
 			tavilyRef() {
 				const declared = this.sectionValue("apiKeyEnv");
@@ -361,9 +397,14 @@ window.__ModuleLoader__.load({
 				const declared = this.sectionValue("braveApiKeyEnv");
 				return declared !== void 0 && declared.length > 0 ? declared : DEFAULT_BRAVE_KEY_REF;
 			}
+			deepseekRef() {
+				const declared = this.sectionValue("deepseekApiKeyEnv");
+				return declared !== void 0 && declared.length > 0 ? declared : DEFAULT_DEEPSEEK_KEY_REF;
+			}
 			/** The credential reference the currently visible engine uses. */
 			refOf() {
-				return this.providerOf() === "brave" ? this.braveRef() : this.tavilyRef();
+				const provider = this.providerOf();
+				return provider === "brave" ? this.braveRef() : provider === "deepseek-official" ? this.deepseekRef() : this.tavilyRef();
 			}
 			async readCredential() {
 				const ref = this.refOf();
@@ -393,7 +434,7 @@ window.__ModuleLoader__.load({
 				this.readCredential();
 			}
 			async writeKey(field, value) {
-				const ref = field === BRAVE_API_KEY_FIELD ? this.braveRef() : this.tavilyRef();
+				const ref = field === BRAVE_API_KEY_FIELD ? this.braveRef() : field === DEEPSEEK_API_KEY_FIELD ? this.deepseekRef() : this.tavilyRef();
 				try {
 					await this.api.credentials.set({ ref, value });
 				} catch (_credentialWriteFailure) {}
@@ -432,6 +473,13 @@ window.__ModuleLoader__.load({
 					searchLang: this.form.field("searchLang"),
 					freshness: this.form.field("freshness"),
 					proxy: this.form.field("proxy"),
+					deepseekApiKey: this.form.field(DEEPSEEK_API_KEY_FIELD),
+					deepseekApiKeyEnv: this.form.field("deepseekApiKeyEnv"),
+					deepseekBaseURL: this.form.field("deepseekBaseURL"),
+					model: this.form.field("model"),
+					apiVersion: this.form.field("apiVersion"),
+					maxTokens: this.form.field("maxTokens"),
+					maxUses: this.form.field("maxUses"),
 					apiKeyConfigured: this.form.credential.configured,
 					apiKeyWritable: this.form.credential.writable
 				};
@@ -454,63 +502,84 @@ window.__ModuleLoader__.load({
 		const selectInput = (props) => react.createElement("select", { style: { border: "1px solid var(--dsw-alias-border-l2)", background: "var(--dsw-alias-bg-layer-3)", height: "34px", font: "inherit", color: "var(--dsw-alias-label-primary)", borderRadius: "8px", padding: "0 12px", fontSize: "13px", lineHeight: "1.5" }, ...props });
 		const checkboxInput = (props) => react.createElement("input", { type: "checkbox", style: { width: "16px", height: "16px", accentColor: "var(--dsw-alias-brand-primary)" }, ...props });
 
-		/** Render one plugin card: engine switch plus the engine-specific form. */
-		function SearchCard(props) {
-			const { t } = props;
-			const state = props.usePluginSearchCard((snapshot) => snapshot);
-			const [open, setOpen] = react.useState(false);
+		/** Render the provider selector plus the backend-specific staged form. */
+		function WebSearchCard(props) {
+			const { t, state, actions } = props;
 			if (!state.available) return null;
 			const disabled = !state.writable;
 			const blocked = !state.dirty || state.invalid || state.saving;
-			const brave = state.provider.text === "brave";
+			const provider = state.provider.text === "brave" ? "brave" : state.provider.text === "deepseek-official" ? "deepseek-official" : "tavily";
+			const brave = provider === "brave";
+			const deepseek = provider === "deepseek-official";
 			const keyed = state.mode.text === "keyed";
-			return react.createElement("li", { style: { border: "1px solid var(--dsw-alias-border-l2)", background: "var(--dsw-alias-bg-layer-3)", borderRadius: "12px", listStyle: "none" } },
-				react.createElement("button", { type: "button", "aria-expanded": open, onClick: () => setOpen(!open), style: { appearance: "none", width: "100%", font: "inherit", color: "inherit", textAlign: "left", cursor: "pointer", background: "0 0", border: "0", borderRadius: "12px", alignItems: "center", gap: "12px", padding: "14px 16px", display: "flex" } },
-					react.createElement("span", { style: { flexDirection: "column", flex: 1, gap: "4px", minWidth: 0, display: "flex" } },
-						react.createElement("span", { style: { color: "var(--dsw-alias-label-primary)", fontSize: "15px", fontWeight: 600, lineHeight: "1.4" } }, t("nav")),
-						react.createElement("span", { style: { color: "var(--dsw-alias-label-tertiary)", fontSize: "13px", lineHeight: "1.5" } }, t("description"))),
-					state.dirty ? react.createElement("span", { style: { whiteSpace: "nowrap", background: "var(--dsw-alias-bg-module-platform)", color: "var(--dsw-alias-label-secondary)", borderRadius: "999px", flex: "none", padding: "1px 8px", fontSize: "11px", fontWeight: 500, lineHeight: "17px" } }, t("unsaved")) : null,
-					react.createElement("span", { style: { color: "var(--dsw-alias-label-tertiary)", flex: "none" } }, open ? "▾" : "▸")),
-				open ? react.createElement("div", { style: { borderTop: "1px solid var(--dsw-alias-border-l2)", margin: "0 16px", paddingBottom: "8px" } },
-					!state.writable ? react.createElement("p", { style: { color: "var(--dsw-alias-label-tertiary)", margin: "12px 0 0", fontSize: "12px", lineHeight: "1.5" } }, t("readOnly")) : null,
-					fieldRow(t("provider"), null, selectInput({ id: "plugin-config-web-search-provider", value: brave ? "brave" : "tavily", disabled, onChange: (e) => props.edit("provider", e.target.value), children: [
-						react.createElement("option", { value: "tavily", key: "tavily" }, t("providerTavily")),
-						react.createElement("option", { value: "brave", key: "brave" }, t("providerBrave"))
-					] })),
-					brave ? null : fieldRow(t("mode"), null, selectInput({ id: "plugin-config-web-search-mode", value: state.mode.text, disabled, onChange: (e) => props.edit("mode", e.target.value), children: [
-						react.createElement("option", { value: "keyless", key: "keyless" }, t("modeKeyless")),
-						react.createElement("option", { value: "keyed", key: "keyed" }, t("modeKeyed"))
-					] })),
-					(!brave && keyed) || brave ? fieldRow(t("apiKey"), t("apiKeyHint"), secretInput({ id: "plugin-config-web-search-key", value: brave ? state.braveApiKey.text : state.apiKey.text, disabled: !state.apiKeyWritable, placeholder: state.apiKeyConfigured ? t("apiKeySet") : t("apiKeyUnset"), onChange: (e) => props.edit(brave ? BRAVE_API_KEY_FIELD : TAVILY_API_KEY_FIELD, e.target.value) })) : null,
-					(!brave && keyed) || brave ? fieldRow(brave ? t("braveApiKeyEnv") : t("apiKeyEnv"), brave ? t("braveApiKeyEnvHint") : t("apiKeyEnvHint"), textInput({ id: "plugin-config-web-search-keyref", value: brave ? state.braveApiKeyEnv.text : state.apiKeyEnv.text, disabled, onChange: (e) => props.edit(brave ? "braveApiKeyEnv" : "apiKeyEnv", e.target.value), onReset: () => props.resetField(brave ? "braveApiKeyEnv" : "apiKeyEnv") })) : null,
-					brave ? fieldRow(t("braveBaseURL"), t("braveBaseURLHint"), textInput({ id: "plugin-config-web-search-brave-base", value: state.braveBaseURL.text, disabled, onChange: (e) => props.edit("braveBaseURL", e.target.value), onReset: () => props.resetField("braveBaseURL") })) : fieldRow(t("baseURL"), t("baseURLHint"), textInput({ id: "plugin-config-web-search-base", value: state.baseURL.text, disabled, onChange: (e) => props.edit("baseURL", e.target.value), onReset: () => props.resetField("baseURL") })),
-					brave ? null : fieldRow(t("searchDepth"), null, selectInput({ id: "plugin-config-web-search-depth", value: state.searchDepth.text, disabled, onChange: (e) => props.edit("searchDepth", e.target.value), children: [
-						react.createElement("option", { value: "basic", key: "basic" }, t("searchDepthBasic")),
-						react.createElement("option", { value: "advanced", key: "advanced" }, t("searchDepthAdvanced"))
-					] })),
-					brave ? null : fieldRow(t("topic"), null, selectInput({ id: "plugin-config-web-search-topic", value: state.topic.text, disabled, onChange: (e) => props.edit("topic", e.target.value), children: [
-						react.createElement("option", { value: "general", key: "general" }, t("topicGeneral")),
-						react.createElement("option", { value: "news", key: "news" }, t("topicNews"))
-					] })),
-					brave ? null : fieldRow(t("includeAnswer"), t("includeAnswerHint"), checkboxInput({ id: "plugin-config-web-search-answer", checked: state.includeAnswer.text === "true", disabled, onChange: (e) => props.edit("includeAnswer", e.target.checked ? "true" : "") })),
-					brave ? fieldRow(t("country"), t("countryHint"), textInput({ id: "plugin-config-web-search-country", value: state.country.text, disabled, onChange: (e) => props.edit("country", e.target.value), onReset: () => props.resetField("country") })) : null,
-					brave ? fieldRow(t("searchLang"), t("searchLangHint"), textInput({ id: "plugin-config-web-search-lang", value: state.searchLang.text, disabled, onChange: (e) => props.edit("searchLang", e.target.value), onReset: () => props.resetField("searchLang") })) : null,
-					brave ? fieldRow(t("freshness"), null, selectInput({ id: "plugin-config-web-search-freshness", value: state.freshness.text, disabled, onChange: (e) => props.edit("freshness", e.target.value), children: [
-						react.createElement("option", { value: "", key: "any" }, t("freshnessAny")),
-						react.createElement("option", { value: "pd", key: "pd" }, t("freshnessDay")),
-						react.createElement("option", { value: "pw", key: "pw" }, t("freshnessWeek")),
-						react.createElement("option", { value: "pm", key: "pm" }, t("freshnessMonth")),
-						react.createElement("option", { value: "py", key: "py" }, t("freshnessYear"))
-					] })) : null,
-					brave ? fieldRow(t("proxy"), t("proxyHint"), textInput({ id: "plugin-config-web-search-proxy", value: state.proxy.text, disabled, onChange: (e) => props.edit("proxy", e.target.value), onReset: () => props.resetField("proxy") })) : null,
-					fieldRow(t("maxResults"), t("maxResultsHint"), textInput({ id: "plugin-config-web-search-max", numeric: true, value: state.maxResults.text, disabled, onChange: (e) => props.edit("maxResults", e.target.value), onReset: () => props.resetField("maxResults") })),
-					react.createElement("div", { style: { borderTop: "1px solid var(--dsw-alias-border-l2)", justifyContent: "flex-end", alignItems: "center", gap: "8px", padding: "12px 0 4px", display: "flex" } },
-						state.failed ? react.createElement("p", { role: "status", style: { minWidth: 0, color: "var(--dsw-alias-label-error)", flex: 1, margin: 0, fontSize: "12px", lineHeight: "1.5" } }, t("saveFailed")) : null,
-						react.createElement("button", { type: "button", disabled: !state.dirty || state.saving, onClick: props.discard, style: { appearance: "none", font: "inherit", cursor: "pointer", border: "1px solid var(--dsw-alias-border-l2)", borderRadius: "8px", padding: "5px 14px", fontSize: "13px", lineHeight: "1.5", color: "var(--dsw-alias-label-secondary)", background: "0 0" } }, t("discard")),
-						react.createElement("button", { type: "button", disabled: blocked, onClick: props.save, style: { appearance: "none", font: "inherit", cursor: "pointer", border: "1px solid transparent", borderRadius: "8px", padding: "5px 14px", fontSize: "13px", lineHeight: "1.5", color: "var(--dsw-alias-label-on-brand)", background: "var(--dsw-alias-bg-brand-solid)" } }, t(state.saving ? "saving" : "save")))) : null);
+			return react.createElement("div", { style: { display: "flex", flexDirection: "column", gap: "4px" } },
+				!state.writable ? react.createElement("p", { style: { color: "var(--dsw-alias-label-tertiary)", margin: "0", fontSize: "12px", lineHeight: "1.5" } }, t("readOnly")) : null,
+				fieldRow(t("provider"), null, selectInput({ id: "ws-provider", value: provider, disabled, onChange: (e) => actions.edit("provider", e.target.value), children: [
+					react.createElement("option", { value: "tavily", key: "tavily" }, t("providerTavily")),
+					react.createElement("option", { value: "brave", key: "brave" }, t("providerBrave")),
+					react.createElement("option", { value: "deepseek-official", key: "deepseek-official" }, t("providerDeepseek"))
+				] })),
+				deepseek ? null : brave ? null : fieldRow(t("mode"), null, selectInput({ id: "ws-mode", value: state.mode.text, disabled, onChange: (e) => actions.edit("mode", e.target.value), children: [
+					react.createElement("option", { value: "keyless", key: "keyless" }, t("modeKeyless")),
+					react.createElement("option", { value: "keyed", key: "keyed" }, t("modeKeyed"))
+				] })),
+				// API key + credential reference for the visible backend.
+				deepseek ? fieldRow(t("apiKey"), t("apiKeyHint"), secretInput({ id: "ws-deepseek-key", value: state.deepseekApiKey.text, disabled: !state.apiKeyWritable, placeholder: state.apiKeyConfigured ? t("apiKeySet") : t("apiKeyUnset"), onChange: (e) => actions.edit(DEEPSEEK_API_KEY_FIELD, e.target.value) })) : null,
+				deepseek ? fieldRow(t("deepseekApiKeyEnv"), t("deepseekApiKeyEnvHint"), textInput({ id: "ws-deepseek-keyref", value: state.deepseekApiKeyEnv.text, disabled, onChange: (e) => actions.edit("deepseekApiKeyEnv", e.target.value), onReset: () => actions.resetField("deepseekApiKeyEnv") })) : null,
+				brave ? fieldRow(t("apiKey"), t("apiKeyHint"), secretInput({ id: "ws-brave-key", value: state.braveApiKey.text, disabled: !state.apiKeyWritable, placeholder: state.apiKeyConfigured ? t("apiKeySet") : t("apiKeyUnset"), onChange: (e) => actions.edit(BRAVE_API_KEY_FIELD, e.target.value) })) : null,
+				brave ? fieldRow(t("braveApiKeyEnv"), t("braveApiKeyEnvHint"), textInput({ id: "ws-brave-keyref", value: state.braveApiKeyEnv.text, disabled, onChange: (e) => actions.edit("braveApiKeyEnv", e.target.value), onReset: () => actions.resetField("braveApiKeyEnv") })) : null,
+				(!brave && !deepseek && keyed) ? fieldRow(t("apiKey"), t("apiKeyHint"), secretInput({ id: "ws-tavily-key", value: state.apiKey.text, disabled: !state.apiKeyWritable, placeholder: state.apiKeyConfigured ? t("apiKeySet") : t("apiKeyUnset"), onChange: (e) => actions.edit(TAVILY_API_KEY_FIELD, e.target.value) })) : null,
+				(!brave && !deepseek && keyed) ? fieldRow(t("apiKeyEnv"), t("apiKeyEnvHint"), textInput({ id: "ws-tavily-keyref", value: state.apiKeyEnv.text, disabled, onChange: (e) => actions.edit("apiKeyEnv", e.target.value), onReset: () => actions.resetField("apiKeyEnv") })) : null,
+				// Endpoint.
+				deepseek ? fieldRow(t("deepseekBaseURL"), t("deepseekBaseURLHint"), textInput({ id: "ws-deepseek-base", value: state.deepseekBaseURL.text, disabled, onChange: (e) => actions.edit("deepseekBaseURL", e.target.value), onReset: () => actions.resetField("deepseekBaseURL") })) : null,
+				brave ? fieldRow(t("braveBaseURL"), t("braveBaseURLHint"), textInput({ id: "ws-brave-base", value: state.braveBaseURL.text, disabled, onChange: (e) => actions.edit("braveBaseURL", e.target.value), onReset: () => actions.resetField("braveBaseURL") })) : null,
+				(!brave && !deepseek) ? fieldRow(t("baseURL"), t("baseURLHint"), textInput({ id: "ws-tavily-base", value: state.baseURL.text, disabled, onChange: (e) => actions.edit("baseURL", e.target.value), onReset: () => actions.resetField("baseURL") })) : null,
+				// DeepSeek options.
+				deepseek ? fieldRow(t("model"), t("modelHint"), textInput({ id: "ws-model", value: state.model.text, disabled, onChange: (e) => actions.edit("model", e.target.value), onReset: () => actions.resetField("model") })) : null,
+				deepseek ? fieldRow(t("apiVersion"), t("apiVersionHint"), textInput({ id: "ws-apiversion", value: state.apiVersion.text, disabled, onChange: (e) => actions.edit("apiVersion", e.target.value), onReset: () => actions.resetField("apiVersion") })) : null,
+				deepseek ? fieldRow(t("maxTokens"), t("maxTokensHint"), textInput({ id: "ws-maxtokens", numeric: true, value: state.maxTokens.text, disabled, onChange: (e) => actions.edit("maxTokens", e.target.value), onReset: () => actions.resetField("maxTokens") })) : null,
+				deepseek ? fieldRow(t("maxUses"), t("maxUsesHint"), textInput({ id: "ws-maxuses", numeric: true, value: state.maxUses.text, disabled, onChange: (e) => actions.edit("maxUses", e.target.value), onReset: () => actions.resetField("maxUses") })) : null,
+				// Tavily options.
+				(!brave && !deepseek) ? fieldRow(t("searchDepth"), null, selectInput({ id: "ws-depth", value: state.searchDepth.text, disabled, onChange: (e) => actions.edit("searchDepth", e.target.value), children: [
+					react.createElement("option", { value: "basic", key: "basic" }, t("searchDepthBasic")),
+					react.createElement("option", { value: "advanced", key: "advanced" }, t("searchDepthAdvanced"))
+				] })) : null,
+				(!brave && !deepseek) ? fieldRow(t("topic"), null, selectInput({ id: "ws-topic", value: state.topic.text, disabled, onChange: (e) => actions.edit("topic", e.target.value), children: [
+					react.createElement("option", { value: "general", key: "general" }, t("topicGeneral")),
+					react.createElement("option", { value: "news", key: "news" }, t("topicNews"))
+				] })) : null,
+				(!brave && !deepseek) ? fieldRow(t("includeAnswer"), t("includeAnswerHint"), checkboxInput({ id: "ws-answer", checked: state.includeAnswer.text === "true", disabled, onChange: (e) => actions.edit("includeAnswer", e.target.checked ? "true" : "") })) : null,
+				// Brave options.
+				brave ? fieldRow(t("country"), t("countryHint"), textInput({ id: "ws-country", value: state.country.text, disabled, onChange: (e) => actions.edit("country", e.target.value), onReset: () => actions.resetField("country") })) : null,
+				brave ? fieldRow(t("searchLang"), t("searchLangHint"), textInput({ id: "ws-lang", value: state.searchLang.text, disabled, onChange: (e) => actions.edit("searchLang", e.target.value), onReset: () => actions.resetField("searchLang") })) : null,
+				brave ? fieldRow(t("freshness"), null, selectInput({ id: "ws-freshness", value: state.freshness.text, disabled, onChange: (e) => actions.edit("freshness", e.target.value), children: [
+					react.createElement("option", { value: "", key: "any" }, t("freshnessAny")),
+					react.createElement("option", { value: "pd", key: "pd" }, t("freshnessDay")),
+					react.createElement("option", { value: "pw", key: "pw" }, t("freshnessWeek")),
+					react.createElement("option", { value: "pm", key: "pm" }, t("freshnessMonth")),
+					react.createElement("option", { value: "py", key: "py" }, t("freshnessYear"))
+				] })) : null,
+				brave ? fieldRow(t("proxy"), t("proxyHint"), textInput({ id: "ws-proxy", value: state.proxy.text, disabled, onChange: (e) => actions.edit("proxy", e.target.value), onReset: () => actions.resetField("proxy") })) : null,
+				fieldRow(t("maxResults"), t("maxResultsHint"), textInput({ id: "ws-max", numeric: true, value: state.maxResults.text, disabled, onChange: (e) => actions.edit("maxResults", e.target.value), onReset: () => actions.resetField("maxResults") })),
+				react.createElement("div", { style: { borderTop: "1px solid var(--dsw-alias-border-l2)", justifyContent: "flex-end", alignItems: "center", gap: "8px", padding: "12px 0 4px", display: "flex" } },
+					state.failed ? react.createElement("p", { role: "status", style: { minWidth: 0, color: "var(--dsw-alias-label-error)", flex: 1, margin: 0, fontSize: "12px", lineHeight: "1.5" } }, t("saveFailed")) : null,
+					react.createElement("button", { type: "button", disabled: !state.dirty || state.saving, onClick: actions.discard, style: { appearance: "none", font: "inherit", cursor: "pointer", border: "1px solid var(--dsw-alias-border-l2)", borderRadius: "8px", padding: "5px 14px", fontSize: "13px", lineHeight: "1.5", color: "var(--dsw-alias-label-secondary)", background: "0 0" } }, t("discard")),
+					react.createElement("button", { type: "button", disabled: blocked, onClick: actions.save, style: { appearance: "none", font: "inherit", cursor: "pointer", border: "1px solid transparent", borderRadius: "8px", padding: "5px 14px", fontSize: "13px", lineHeight: "1.5", color: "var(--dsw-alias-label-on-brand)", background: "var(--dsw-alias-bg-brand-solid)" } }, t(state.saving ? "saving" : "save"))));
+		}
+
+		/** Section component: the "Web search" page body, driven by useSyncExternalStore. */
+		function makeSection(ctx, controller) {
+			return function WebSearchSection() {
+				const state = react.useSyncExternalStore(controller.store.subscribe, controller.store.getSnapshot);
+				const t = ctx.locale.bind(NS);
+				if (!state.available) return react.createElement("p", { style: { padding: "16px" } }, t("readOnly"));
+				return react.createElement("div", { style: { padding: "16px" } },
+					react.createElement("div", { style: { border: "1px solid var(--dsw-alias-border-l2)", background: "var(--dsw-alias-bg-layer-3)", borderRadius: "12px", padding: "4px 16px" } },
+						react.createElement(WebSearchCard, { t: t, state: state, actions: controller.form.actions() })));
+			};
 		}
 
-		/** Mount the card into the plugin configuration surface. */
+		/** Mount the top-level "Web search" settings section. */
 		function apply(ctx) {
 			const { api } = ctx.get("connection");
 			const t = ctx.locale.bind(NS);
@@ -519,14 +588,13 @@ window.__ModuleLoader__.load({
 			ctx.effect(() => ctx.remote.$on("credentials/updated", (ref) => {
 				controller.form.refreshCredential(ref);
 			}), "dsh-web-search-plugin: credential invalidations");
-			ctx.slots.inject("settings.plugin.item", function* () {
-				yield ctx.slots.register({
-					name: "settings.plugin.item",
-					key: "dsh-web-search-plugin",
-					locale: NS,
-					inject: () => controller.inject()
-				}, SearchCard);
-			});
+			ctx.slots.inject("settings.section", () => ctx.slots.register({
+				name: "settings.section",
+				id: "web-search",
+				order: 10,
+				label: () => t("nav"),
+				locale: NS
+			}, makeSection(ctx, controller)));
 		}
 
 		const inject = ["slots", "locale", "connection", "remote", "settingsScope"];

package/lib/deepseek.js

@@ -0,0 +1,148 @@
+/**
+ * DeepSeek search backend: the Anthropic-compatible Messages API with the
+ * native `web_search_20250305` server tool. Each search costs a model turn
+ * and returns structured `web_search_tool_result` blocks; absence of those
+ * blocks is an error rather than a prose-scraping fallback.
+ *
+ * This plugin re-hosts the `deepseek-official` provider so the DeepSeek
+ * configuration can sit beside Tavily and Brave. The bundle patch disables
+ * the in-box `web-search-deepseek` host plugin (its namespace feed the legacy
+ * "plugins → web search" card, and re-registering its provider would collide).
+ *
+ * @module dsh-web-search-plugin/deepseek
+ */
+import { WebError } from "@deepseek-ai/dsh-web";
+import { launchEnvironmentOf } from "@deepseek-ai/dsh-launch-environment";
+import { MAX_RESULTS_CAP, USER_AGENT, isAbortError, resolveApiKey, resolveSecret, searchAborted, throwIfSearchAborted } from "./shared.js";
+
+/** Default endpoint: DeepSeek's Anthropic-compatible API (`/messages` appended). */
+export const DEEPSEEK_DEFAULT_BASE_URL = "https://api.deepseek.com/anthropic/v1";
+/** Default credential reference for this backend. */
+export const DEEPSEEK_DEFAULT_API_KEY_ENV = "DEEPSEEK_API_KEY";
+/** Environment variable naming this backend's endpoint override. */
+const DEEPSEEK_SEARCH_BASE_URL_ENV = "DEEPSEEK_SEARCH_BASE_URL";
+const DEFAULT_MODEL = "deepseek-v4-flash";
+const DEFAULT_API_VERSION = "2023-06-01";
+const DEFAULT_MAX_TOKENS = 4096;
+const DEFAULT_MAX_USES = 5;
+
+/**
+ * Build a `url → cited_text` map from `text` blocks' `citations[]` (the snippet
+ * source for Anthropic `web_search_result` items, which carry url/title but no
+ * inline excerpt).
+ */
+function citationSnippets(blocks) {
+	const map = /* @__PURE__ */ new Map();
+	for (const block of blocks) {
+		if (block.type !== "text") continue;
+		for (const cite of block.citations ?? []) if (cite.url != null && cite.url.length > 0 && cite.cited_text != null && cite.cited_text.length > 0 && !map.has(cite.url)) map.set(cite.url, cite.cited_text);
+	}
+	return map;
+}
+
+/** Map an Anthropic Messages response to a normalized search result. */
+function mapAnthropicResponse(response) {
+	const blocks = response.content ?? [];
+	const resultBlocks = blocks.filter((block) => block.type === "web_search_tool_result");
+	if (resultBlocks.length === 0) throw new WebError("DeepSeek returned no web_search_tool_result blocks; the request may not have triggered native web search", "WEB_PROVIDER_ERROR");
+	const snippets = citationSnippets(blocks);
+	const seen = /* @__PURE__ */ new Set();
+	const sources = [];
+	for (const block of resultBlocks) for (const item of block.content ?? []) {
+		if (item.type !== "web_search_result" || typeof item.url !== "string" || item.url.length === 0 || seen.has(item.url)) continue;
+		seen.add(item.url);
+		const snippet = snippets.get(item.url);
+		sources.push({
+			url: item.url,
+			...typeof item.title === "string" && item.title.length > 0 ? { title: item.title } : {},
+			...snippet !== void 0 ? { snippet } : {},
+			...typeof item.page_age === "string" && item.page_age.length > 0 ? { publishedAt: item.page_age } : {}
+		});
+	}
+	return { sources, truncated: false };
+}
+
+/** The DeepSeek-backed search backend; HTTP redirects fail as `WEB_PROVIDER_ERROR`. */
+export class DeepSeekSearchProvider {
+	constructor(resolveOptions) {
+		this.resolveOptions = resolveOptions;
+	}
+
+	available() {
+		const options = this.resolveOptions();
+		return ((options.apiKey?.length ?? 0) > 0 || options.resolveApiKey !== void 0)
+			&& URL.canParse(options.baseURL)
+			&& Number.isInteger(options.maxTokens) && options.maxTokens > 0
+			&& Number.isInteger(options.maxUses) && options.maxUses > 0;
+	}
+
+	async search(request, signal) {
+		const options = this.resolveOptions();
+		const apiKey = await resolveApiKey(options, signal, `DeepSeek search has no API key for "${options.apiKeyEnv ?? DEEPSEEK_DEFAULT_API_KEY_ENV}"; store it through the credentials service, export it in the launching environment, or set a literal "deepseekApiKey" in the dsh-web-search-plugin config`);
+		throwIfSearchAborted(signal);
+		const endpoint = `${options.baseURL.replace(/\/+$/u, "")}/messages`;
+		const body = {
+			model: options.model,
+			max_tokens: options.maxTokens,
+			messages: [{
+				role: "user",
+				content: [{ type: "text", text: `Perform a web search for the query: ${request.query}` }]
+			}],
+			tools: [{ type: "web_search_20250305", name: "web_search", max_uses: options.maxUses }]
+		};
+		throwIfSearchAborted(signal);
+		let response;
+		try {
+			response = await fetch(endpoint, {
+				method: "POST",
+				redirect: "error",
+				headers: {
+					"x-api-key": apiKey,
+					"authorization": `Bearer ${apiKey}`,
+					"anthropic-version": options.apiVersion,
+					"content-type": "application/json",
+					"accept": "application/json",
+					"user-agent": USER_AGENT
+				},
+				body: JSON.stringify(body),
+				...signal !== void 0 ? { signal } : {}
+			});
+		} catch (error) {
+			if (signal?.aborted === true || isAbortError(error)) throw searchAborted(signal, error);
+			throw new WebError(`DeepSeek search request failed: ${String(error)}`, "WEB_PROVIDER_ERROR", { cause: error });
+		}
+		if (!response.ok) {
+			let message = `DeepSeek API error (HTTP ${response.status})`;
+			try {
+				const parsed = await response.json();
+				const detail = typeof parsed.error === "string" ? parsed.error : parsed.error?.message ?? parsed.message;
+				if (typeof detail === "string" && detail.length > 0) message = detail;
+			} catch {
+				/* non-JSON error body — keep the status-line message */
+			}
+			throw new WebError(message, "WEB_PROVIDER_ERROR");
+		}
+		try {
+			return mapAnthropicResponse(await response.json());
+		} catch (error) {
+			if (signal?.aborted === true || isAbortError(error)) throw searchAborted(signal, error);
+			if (error instanceof WebError) throw error;
+			throw new WebError(`DeepSeek returned an unprocessable response body: ${String(error)}`, "WEB_PROVIDER_ERROR", { cause: error });
+		}
+	}
+}
+
+/** Project the plugin section into DeepSeek backend options. */
+export function resolveDeepseekOptions(ctx, config) {
+	return {
+		...resolveSecret(ctx, {
+			literal: config.deepseekApiKey,
+			envName: config.deepseekApiKeyEnv ?? DEEPSEEK_DEFAULT_API_KEY_ENV
+		}),
+		baseURL: config.deepseekBaseURL ?? launchEnvironmentOf(ctx).get(DEEPSEEK_SEARCH_BASE_URL_ENV)?.value ?? DEEPSEEK_DEFAULT_BASE_URL,
+		model: config.model ?? DEFAULT_MODEL,
+		apiVersion: config.apiVersion ?? DEFAULT_API_VERSION,
+		maxTokens: config.maxTokens ?? DEFAULT_MAX_TOKENS,
+		maxUses: config.maxUses ?? DEFAULT_MAX_USES
+	};
+}

package/lib/index.js

@@ -1,17 +1,18 @@
 /**
  * Web-search provider plugin for the DeepSeek Harness web capability seam
  * (`ctx.web`). Registers a single `WebSearchProvider` under the stable id
- * `dsh-web-search` and dispatches each search to Tavily or Brave according
- * to the `provider` setting — so switching backends does not require a
- * `web.searchProvider` patch change.
+ * `dsh-web-search` and dispatches each search to DeepSeek (official), Tavily,
+ * or Brave according to the `provider` setting — so switching backends does
+ * not require a `web.searchProvider` patch change.
  *
- * Tavily supports `keyless` (free, rate-limited) and `keyed` modes.
- * Brave always needs a subscription token (`BRAVE_API_KEY` by default).
+ * Tavily supports `keyless` (free, rate-limited) and `keyed` modes. Brave
+ * always needs a subscription token (`BRAVE_API_KEY` by default). DeepSeek
+ * uses the Anthropic-compatible Messages API native `web_search_20250305`
+ * tool and reuses `DEEPSEEK_API_KEY` (the in-box `web-search-deepseek` host
+ * plugin is disabled by the bundle patch).
  *
- * Neither backend writes custom session events. The community Brave plugin
- * used to append `web/brave-search-request`, which is outside DSH's known
- * event vocabulary and cannot be marked `ignorable`, so a cold load refused
- * the conversation. Tool results already go through the seam's own events.
+ * No backend writes custom session events; tool results already go through
+ * the seam's own events.
  *
  * @module dsh-web-search-plugin
  */
@@ -20,6 +21,7 @@ import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-sett
 import { MAX_RESULTS_CAP } from "./shared.js";
 import { TAVILY_DEFAULT_API_KEY_ENV, TAVILY_DEFAULT_BASE_URL, TavilySearchProvider, resolveTavilyOptions } from "./tavily.js";
 import { BRAVE_DEFAULT_API_KEY_ENV, BRAVE_DEFAULT_BASE_URL, BraveSearchProvider, resolveBraveOptions } from "./brave.js";
+import { DEEPSEEK_DEFAULT_API_KEY_ENV, DEEPSEEK_DEFAULT_BASE_URL, DeepSeekSearchProvider, resolveDeepseekOptions } from "./deepseek.js";
 
 /** Stable id this plugin registers under on `ctx.web`. */
 const SEARCH_PROVIDER_ID = "dsh-web-search";
@@ -31,7 +33,7 @@ const inject = ["web"];
 
 /** Plugin config (all optional — `apply` fills defaults). */
 const Config = z.object({
-	/** Active backend: `tavily` (default) or `brave`. */
+	/** Active backend: `deepseek-official`, `tavily` (default), or `brave`. */
 	provider: z.string().default("tavily"),
 	/** Tavily auth mode: `keyless` (default) or `keyed`. */
 	mode: z.string().default("keyless"),
@@ -62,7 +64,21 @@ const Config = z.object({
 	/** Optional Brave `freshness` (`pd` / `pw` / `pm` / `py`). */
 	freshness: z.string().default(""),
 	/** Optional HTTP(S) proxy URL for Brave (falls back to HTTPS_PROXY / HTTP_PROXY). */
-	proxy: z.string().default("")
+	proxy: z.string().default(""),
+	/** Literal DeepSeek API key; prefer {@link deepseekApiKeyEnv}. */
+	deepseekApiKey: z.string().role("secret").default(""),
+	/** Credential reference for DeepSeek search. */
+	deepseekApiKeyEnv: z.string().role("credential-ref").default(DEEPSEEK_DEFAULT_API_KEY_ENV),
+	/** DeepSeek Anthropic-compatible Messages base URL. `/messages` is appended. */
+	deepseekBaseURL: z.string().default(DEEPSEEK_DEFAULT_BASE_URL),
+	/** Anthropic-format model name for the Messages request. */
+	model: z.string().default("deepseek-v4-flash"),
+	/** `anthropic-version` header value. */
+	apiVersion: z.string().default("2023-06-01"),
+	/** Upper bound on generated tokens for the Messages request. */
+	maxTokens: z.number().step(1).min(1).default(4096),
+	/** Maximum `web_search` server-tool uses per request. */
+	maxUses: z.number().step(1).min(1).default(5)
 });
 
 /** Settings namespace carrying this plugin's backend switch and options. */
@@ -80,6 +96,7 @@ class PluginSearchProvider {
 
 	constructor(resolveOptions) {
 		this.resolveOptions = resolveOptions;
+		this.deepseek = new DeepSeekSearchProvider(() => this.resolveOptions().deepseek);
 		this.tavily = new TavilySearchProvider(() => this.resolveOptions().tavily);
 		this.brave = new BraveSearchProvider(() => this.resolveOptions().brave);
 	}
@@ -93,14 +110,19 @@ class PluginSearchProvider {
 	}
 
 	backend() {
-		return this.resolveOptions().provider === "brave" ? this.brave : this.tavily;
+		const provider = this.resolveOptions().provider;
+		if (provider === "brave") return this.brave;
+		if (provider === "deepseek-official") return this.deepseek;
+		return this.tavily;
 	}
 }
 
-/** Project one resolved section into options for both backends. */
+/** Project one resolved section into options for each backend. */
 function resolveOptions(ctx, config) {
+	const provider = config.provider === "brave" || config.provider === "deepseek-official" ? config.provider : "tavily";
 	return {
-		provider: config.provider === "brave" ? "brave" : "tavily",
+		provider,
+		deepseek: resolveDeepseekOptions(ctx, config),
 		tavily: resolveTavilyOptions(ctx, config),
 		brave: resolveBraveOptions(ctx, config)
 	};
@@ -123,6 +145,9 @@ export {
 	BRAVE_DEFAULT_BASE_URL,
 	BraveSearchProvider,
 	Config,
+	DEEPSEEK_DEFAULT_API_KEY_ENV,
+	DEEPSEEK_DEFAULT_BASE_URL,
+	DeepSeekSearchProvider,
 	SEARCH_PROVIDER_ID,
 	TAVILY_DEFAULT_API_KEY_ENV,
 	TAVILY_DEFAULT_BASE_URL,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-web-search-plugin",
-  "version": "0.1.2",
-  "description": "Tavily and Brave Search providers for the DeepSeek Harness web capability seam (ctx.web): switch engines from the settings card without a custom session event",
+  "version": "0.2.0",
+  "description": "Unified web search for the DeepSeek Harness seam (ctx.web): DeepSeek (official), Tavily, and Brave backends with an in-browser selector",
   "keywords": [
     "dsh-plugin",
     "deepseek-harness",
@@ -53,7 +53,7 @@
     }
   },
   "scripts": {
-    "check": "node --check lib/index.js && node --check lib/client.js && node --check lib/shared.js && node --check lib/tavily.js && node --check lib/brave.js"
+    "check": "node --check lib/index.js && node --check lib/client.js && node --check lib/shared.js && node --check lib/tavily.js && node --check lib/brave.js && node --check lib/deepseek.js"
   },
   "dependencies": {
     "undici": "^6.21.0"