dsh-web-search-plugin 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 本项目的重要变更都记录在此。格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。
 
+## [0.3.1] - 2026-08-30
+
+### 修复
+
+- **Tavily keyless 模式失效**：通用 REST 后端不再在 keyless 模式下强制解析 API key；无 key 时只发送 `x-tavily-access-mode: keyless`，可正常使用免费额度。
+- **POST 类 provider 的 count 参数类型错误**：Tavily `max_results`、Serper `num`、Exa `num_results`、Firecrawl `limit` 等在 JSON body 中恢复为数字，不再被强转字符串。
+- **Scavio / Firecrawl 设置卡严重卡死**：补齐浏览器端缺失的 `scavioApiKeyEnv` / `scavioBaseURL` / `firecrawlApiKeyEnv` / `firecrawlBaseURL` 表单字段与投影，修复切换后输入框无法输入、引擎无法切换的问题。
+- **Scavio / Firecrawl 默认凭据名错误**：未显式填写 keyEnv 时分别回退到 `SCAVIO_API_KEY` / `FIRECRAWL_API_KEY`，不再错误使用 `EXA_API_KEY`。
+- **Brave 环境代理回退丢失**：恢复 `HTTPS_PROXY` / `HTTP_PROXY` 环境变量回退，未显式配置 `proxy` 时也能按环境代理请求。
+- `User-Agent` 更新为 `0.3.1`。
+
+### 优化
+
+- 内置 REST 渠道（Serper / SerpApi / Exa / SearXNG / Scavio / Firecrawl）的 Base URL 默认值预填到设置卡，切换渠道后不再是空 URL。
+
 ## [0.3.0] - 2026-08-25
 
 ### 新增

package/lib/client.js

@@ -27,12 +27,12 @@ window.__ModuleLoader__.load({
 		const NS = "dsh-web-search-plugin";
 		/** Built-in REST providers (mirrors `lib/providers.js`; browser bundle is self-contained). */
 		const BUILTIN_REST_PROVIDERS = [
-			{ id: "serper", name: "Serper", officialUrl: "https://serper.dev/", keyRequired: true, keyField: "serperApiKey", keyEnvField: "serperApiKeyEnv", baseURLField: "serperBaseURL" },
-			{ id: "serpapi", name: "SerpApi", officialUrl: "https://serpapi.com/", keyRequired: true, keyField: "serpapiApiKey", keyEnvField: "serpapiApiKeyEnv", baseURLField: "serpapiBaseURL" },
-			{ id: "exa", name: "Exa", officialUrl: "https://dashboard.exa.ai/", keyRequired: true, keyField: "exaApiKey", keyEnvField: "exaApiKeyEnv", baseURLField: "exaBaseURL" },
-			{ id: "searxng", name: "SearXNG", officialUrl: "https://docs.searxng.org/", keyRequired: false, keyField: "", keyEnvField: "", baseURLField: "searxngBaseURL" },
-			{ id: "scavio", name: "Scavio", officialUrl: "https://scavio.dev/", keyRequired: true, keyField: "scavioApiKey", keyEnvField: "scavioApiKeyEnv", baseURLField: "scavioBaseURL" },
-			{ id: "firecrawl", name: "Firecrawl", officialUrl: "https://firecrawl.dev/", keyRequired: true, keyField: "firecrawlApiKey", keyEnvField: "firecrawlApiKeyEnv", baseURLField: "firecrawlBaseURL" }
+			{ id: "serper", name: "Serper", officialUrl: "https://serper.dev/", defaultBaseURL: "https://google.serper.dev", keyRequired: true, keyField: "serperApiKey", keyEnvField: "serperApiKeyEnv", baseURLField: "serperBaseURL" },
+			{ id: "serpapi", name: "SerpApi", officialUrl: "https://serpapi.com/", defaultBaseURL: "https://serpapi.com", keyRequired: true, keyField: "serpapiApiKey", keyEnvField: "serpapiApiKeyEnv", baseURLField: "serpapiBaseURL" },
+			{ id: "exa", name: "Exa", officialUrl: "https://dashboard.exa.ai/", defaultBaseURL: "https://api.exa.ai", keyRequired: true, keyField: "exaApiKey", keyEnvField: "exaApiKeyEnv", baseURLField: "exaBaseURL" },
+			{ id: "searxng", name: "SearXNG", officialUrl: "https://docs.searxng.org/", defaultBaseURL: "https://searx.be", keyRequired: false, keyField: "", keyEnvField: "", baseURLField: "searxngBaseURL" },
+			{ id: "scavio", name: "Scavio", officialUrl: "https://scavio.dev/", defaultBaseURL: "https://api.scavio.dev", keyRequired: true, keyField: "scavioApiKey", keyEnvField: "scavioApiKeyEnv", baseURLField: "scavioBaseURL" },
+			{ id: "firecrawl", name: "Firecrawl", officialUrl: "https://firecrawl.dev/", defaultBaseURL: "https://api.firecrawl.dev", keyRequired: true, keyField: "firecrawlApiKey", keyEnvField: "firecrawlApiKeyEnv", baseURLField: "firecrawlBaseURL" }
 		];
 		/** Find a built-in REST provider by id. */
 		function builtinRest(id) {
@@ -364,7 +364,11 @@ window.__ModuleLoader__.load({
 					textField("serpapiBaseURL"),
 					textField("exaApiKeyEnv"),
 					textField("exaBaseURL"),
-					textField("searxngBaseURL")
+					textField("searxngBaseURL"),
+					textField("scavioApiKeyEnv"),
+					textField("scavioBaseURL"),
+					textField("firecrawlApiKeyEnv"),
+					textField("firecrawlBaseURL")
 				].map((spec) => [spec.field, spec]));
 				this.staged = new Map();
 				this.saving = false;
@@ -577,7 +581,7 @@ window.__ModuleLoader__.load({
 			restKeyRef(rest) {
 				const declared = this.sectionValue(rest.keyEnvField);
 				if (declared !== void 0 && declared.length > 0) return declared;
-				return rest.id === "serper" ? "SERPER_API_KEY" : rest.id === "serpapi" ? "SERPAPI_API_KEY" : "EXA_API_KEY";
+				return rest.id === "serper" ? "SERPER_API_KEY" : rest.id === "serpapi" ? "SERPAPI_API_KEY" : rest.id === "exa" ? "EXA_API_KEY" : rest.id === "scavio" ? "SCAVIO_API_KEY" : "FIRECRAWL_API_KEY";
 			}
 			async readCredential() {
 				const ref = this.refOf();
@@ -669,6 +673,12 @@ window.__ModuleLoader__.load({
 					exaApiKeyEnv: this.form.field("exaApiKeyEnv"),
 					exaBaseURL: this.form.field("exaBaseURL"),
 					searxngBaseURL: this.form.field("searxngBaseURL"),
+					scavioApiKey: this.form.field("scavioApiKey"),
+					scavioApiKeyEnv: this.form.field("scavioApiKeyEnv"),
+					scavioBaseURL: this.form.field("scavioBaseURL"),
+					firecrawlApiKey: this.form.field("firecrawlApiKey"),
+					firecrawlApiKeyEnv: this.form.field("firecrawlApiKeyEnv"),
+					firecrawlBaseURL: this.form.field("firecrawlBaseURL"),
 					apiKeyConfigured: this.form.credential.configured,
 					apiKeyWritable: this.form.credential.writable,
 					toastKey: this.form.toastKey
@@ -1075,7 +1085,7 @@ window.__ModuleLoader__.load({
 						fieldRow(t("apiKey"), keyHint, secretInput({ id: "ws-" + restMeta.id + "-key", value: state[restMeta.keyField]?.text ?? "", disabled: !state.apiKeyWritable, placeholder: state.apiKeyConfigured ? t("apiKeySet") : t("apiKeyUnset"), onChange: (e) => actions.edit(restMeta.keyField, e.target.value) })),
 						row(restMeta.keyEnvField, t("apiKeyEnv"), t("apiKeyEnvHint"), textInput({ id: "ws-" + restMeta.id + "-keyref", value: state[restMeta.keyEnvField]?.text ?? "", disabled, onChange: (e) => actions.edit(restMeta.keyEnvField, e.target.value) }))
 					) : null,
-					row(restMeta.baseURLField, t("baseURL"), t("baseURLHint"), textInput({ id: "ws-" + restMeta.id + "-base", value: state[restMeta.baseURLField]?.text ?? "", disabled, onChange: (e) => actions.edit(restMeta.baseURLField, e.target.value) })),
+					row(restMeta.baseURLField, t("baseURL"), t("baseURLHint"), textInput({ id: "ws-" + restMeta.id + "-base", value: state[restMeta.baseURLField]?.text || restMeta.defaultBaseURL || "", disabled, onChange: (e) => actions.edit(restMeta.baseURLField, e.target.value) })),
 					maxResultsRow
 				) : null,
 				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" } },

package/lib/index.js

@@ -18,6 +18,7 @@
  */
 import z from "@deepseek-ai/schemastery";
 import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
+import { launchEnvironmentOf } from "@deepseek-ai/dsh-launch-environment";
 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";
@@ -73,33 +74,33 @@ const Config = z.object({
 	/** Credential reference for Serper search. */
 	serperApiKeyEnv: z.string().role("credential-ref").default("SERPER_API_KEY"),
 	/** Serper endpoint base. `/search` is appended. */
-	serperBaseURL: z.string().default(""),
+	serperBaseURL: z.string().default("https://google.serper.dev"),
 	/** Literal SerpApi API key; prefer {@link serpapiApiKeyEnv}. */
 	serpapiApiKey: z.string().role("secret").default(""),
 	/** Credential reference for SerpApi search. */
 	serpapiApiKeyEnv: z.string().role("credential-ref").default("SERPAPI_API_KEY"),
 	/** SerpApi endpoint base. `/search.json` is appended. */
-	serpapiBaseURL: z.string().default(""),
+	serpapiBaseURL: z.string().default("https://serpapi.com"),
 	/** Literal Exa API key; prefer {@link exaApiKeyEnv}. */
 	exaApiKey: z.string().role("secret").default(""),
 	/** Credential reference for Exa search. */
 	exaApiKeyEnv: z.string().role("credential-ref").default("EXA_API_KEY"),
 	/** Exa endpoint base. `/search` is appended. */
-	exaBaseURL: z.string().default(""),
+	exaBaseURL: z.string().default("https://api.exa.ai"),
 	/** Optional SearXNG instance base URL (self-hosted). `/search` is appended. */
-	searxngBaseURL: z.string().default(""),
+	searxngBaseURL: z.string().default("https://searx.be"),
 	/** Literal Scavio API key; prefer {@link scavioApiKeyEnv}. */
 	scavioApiKey: z.string().role("secret").default(""),
 	/** Credential reference for Scavio search. */
 	scavioApiKeyEnv: z.string().role("credential-ref").default("SCAVIO_API_KEY"),
 	/** Scavio endpoint base. `/api/v2/google` is appended. */
-	scavioBaseURL: z.string().default(""),
+	scavioBaseURL: z.string().default("https://api.scavio.dev"),
 	/** Literal Firecrawl API key; prefer {@link firecrawlApiKeyEnv}. */
 	firecrawlApiKey: z.string().role("secret").default(""),
 	/** Credential reference for Firecrawl search. */
 	firecrawlApiKeyEnv: z.string().role("credential-ref").default("FIRECRAWL_API_KEY"),
 	/** Firecrawl endpoint base. `/v2/search` is appended. */
-	firecrawlBaseURL: z.string().default(""),
+	firecrawlBaseURL: z.string().default("https://api.firecrawl.dev"),
 	/** Literal DeepSeek API key; prefer {@link deepseekApiKeyEnv}. */
 	deepseekApiKey: z.string().role("secret").default(""),
 	/** Credential reference for DeepSeek search. */
@@ -176,7 +177,7 @@ function resolveOptions(ctx, config) {
 	// metadata row's default is not enough (self-hosted SearXNG, proxied
 	// providers, custom key refs).
 	const keySourceByProvider = {
-		brave: { literal: config.braveApiKey, envName: config.braveApiKeyEnv ?? BRAVE_DEFAULT_API_KEY_ENV, baseURL: config.braveBaseURL ?? "", proxy: config.proxy },
+		brave: { literal: config.braveApiKey, envName: config.braveApiKeyEnv ?? BRAVE_DEFAULT_API_KEY_ENV, baseURL: config.braveBaseURL ?? "", proxy: config.proxy || launchEnvironmentOf(ctx).get("HTTPS_PROXY")?.value || launchEnvironmentOf(ctx).get("HTTP_PROXY")?.value || "" },
 		tavily: { literal: config.apiKey, envName: config.apiKeyEnv ?? TAVILY_DEFAULT_API_KEY_ENV, baseURL: config.baseURL ?? "" },
 		serper: { literal: config.serperApiKey, envName: config.serperApiKeyEnv ?? "SERPER_API_KEY", baseURL: config.serperBaseURL ?? "" },
 		serpapi: { literal: config.serpapiApiKey, envName: config.serpapiApiKeyEnv ?? "SERPAPI_API_KEY", baseURL: config.serpapiBaseURL ?? "" },

package/lib/rest.js

@@ -188,7 +188,7 @@ export class RestSearchProvider {
 		const query = {
 			[queryParam]: request.query
 		};
-		if (countParam !== "") query[countParam] = String(count);
+		if (countParam !== "") query[countParam] = queryIn === "query" ? String(count) : count;
 		const keyed = options.keyed === true;
 		for (const param of options.params ?? []) {
 			const resolved = resolveParam(param, { keyed, ...options.settings ?? {} });
@@ -295,8 +295,12 @@ export class RestSearchProvider {
  */
 export function resolveRestProvider(ctx, row, opts) {
 	const { config, settings } = opts;
-	const auth = row.auth ?? { type: "none" };
+	let auth = row.auth ?? { type: "none" };
 	const keyed = opts.keyed === true;
+	// A provider can be keyless by default (e.g. Tavily keyless mode); when no
+	// key is expected, drop the auth template so the generic backend does not
+	// demand a credential before the request.
+	if (row.keyRequired === false && keyed !== true) auth = { type: "none" };
 	const base = {
 		baseURL: row.baseURL,
 		method: row.method ?? "POST",

package/lib/shared.js

@@ -7,7 +7,7 @@ import { launchEnvironmentOf } from "@deepseek-ai/dsh-launch-environment";
 import { WebError } from "@deepseek-ai/dsh-web";
 
 /** Attribution header sent on every request. */
-export const USER_AGENT = "dsh-web-search-plugin/0.2.1";
+export const USER_AGENT = "dsh-web-search-plugin/0.3.1";
 /** Shared cap: Tavily `max_results` and Brave `count` both accept 1..20. */
 export const MAX_RESULTS_CAP = 20;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-web-search-plugin",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Unified web search for the DeepSeek Harness seam (ctx.web): DeepSeek (official), Tavily, Brave, Serper, SerpApi, Exa, SearXNG, Scavio, and Firecrawl backends",
   "keywords": [
     "dsh-plugin",