@240xu/dsh-websearch 2.2.0 → 2.3.0

package/README.md

@@ -31,6 +31,18 @@ DSH（[DeepSeek Harness](https://github.com/deepseek-ai/dsh)）原生插件：
 
 **Default enabled set**: `["exa", "parallel", "ddg", "searxng"]` — all keyless. The key-gated backends only join when their `available()` returns true (key present + baseURL reachable).
 
+### SearXNG 实例 | Public instances
+
+SearXNG 默认指向 `https://searx.be`；公共实例可用性随网络环境波动，失败时错误信息会提示换源。
+在设置面板修改 `searxngBaseURL` 即可切换，常见候选：
+
+| 实例 | 备注 |
+|---|---|
+| https://searx.be | 官方默认，部分地区不可达 |
+| https://searx.tiekoetter.com | 稳定性较好 |
+| https://priv.au | 隐私友好 |
+| 自托管 | 最可靠，支持 API Key（`searxngApiKeyEnv`） |
+
 ## Install | 安装
 
 ### 方式一：作为 profile 依赖安装（推荐，规范做法）
@@ -81,6 +93,9 @@ pnpm install
 
 **v2.1 结果策略**：设置面板新增「结果策略」分区。时间/语言过滤按各后端能力自动映射——Brave `freshness/country/search_lang`、Tavily `time_range`、Serper `tbs/hl/gl`（Google 日期语法）、SearXNG `time_range/language`、DDG `df`；不支持的后端自动忽略对应维度。内部超时以真实原因失败（backend "<id>" timed out after Nms），不再被静默降级为取消；Mojeek 的 API Key 改走 Authorization 头，不再出现在 URL 中。
 
+**结果健康遥测（默认开）**：每次搜索的 `content` 尾部附一行 `[websearch backends] exa ✓5ms/3 · ddg ✗30000ms`，
+模型可据此自诊断并建议用户调整设置；设置面板「结果策略」可关闭（`resultTelemetry`）。
+
 **11 个后端开关**：`enableExa` / `enableParallel` / `enableDdg` / `enableSearxng`（默认开）；`enableBrave` / `enableTavily` / `enableSerper` / `enableMojeek` / `enableDeepseek` / `enableAnthropic` / `enableOpenai`（默认关）
 
 **API Key 授权**（credential-ref，填环境变量名，实际 key 存于 credentials 服务或环境变量）：

package/lib/backends/searxng.js

@@ -66,7 +66,8 @@ export const searxngBackend = {
       });
     } catch (error) {
       if (signal?.aborted === true || isAbortError(error)) throw searchAborted(signal, error);
-      throw new WebError("SearXNG request failed: " + error, "WEB_PROVIDER_ERROR", { cause: error });
+      throw new WebError("SearXNG request failed: " + error +
+        " (instance unreachable? point searxngBaseURL at another public instance)", "WEB_PROVIDER_ERROR", { cause: error });
     }
 
     if (!response.ok) {

package/lib/client.js

@@ -31,7 +31,7 @@ window.__ModuleLoader__.load({
 			dedupStrategy: ["url", "url+title"],
 		};
 		/** Boolean settings staged as "true"/"false" strings by the selects. */
-		const BOOLEAN_FIELDS = ["rerank", "safeSearch"];
+		const BOOLEAN_FIELDS = ["rerank", "safeSearch", "resultTelemetry"];
 		const KEYLESS = BACKENDS.filter((b) => !b.keyEnv);
 		const KEYED = BACKENDS.filter((b) => b.keyEnv);
 
@@ -89,6 +89,7 @@ window.__ModuleLoader__.load({
 			dedupTitle: "链接 + 标题（合并转载）",
 			langPlaceholder: "如 en、zh-CN，留空为默认",
 						envProvided: "环境变量提供",			readOnly: "只读，无需填写",			conflict: "设置已在其他端被修改，请重试",			keyFailed: "该 Key 保存失败",
+			telemetryLabel: "结果健康遥测",
 		};
 		const en = {
 			nav: "Web Search",
@@ -136,6 +137,7 @@ window.__ModuleLoader__.load({
 			readOnly: "read-only, nothing to fill",
 			conflict: "Changed elsewhere - please retry",
 			keyFailed: "failed to save this key",
+			telemetryLabel: "Result health telemetry",
 		};
 
 		//#region styles
@@ -465,6 +467,12 @@ window.__ModuleLoader__.load({
 						options: boolOptions,
 						onChange: (v) => card.edit("safeSearch", v),
 					}),
+					react_jsx_runtime.jsx(SelectField, {
+						label: props.t("telemetryLabel"),
+						value: selVal("resultTelemetry", "true"),
+						options: boolOptions,
+						onChange: (v) => card.edit("resultTelemetry", v),
+					}),
 				] }),
 				react_jsx_runtime.jsx("h4", { className: "wsc-sectionTitle", children: props.t("keysTitle") }),
 				react_jsx_runtime.jsx("div", { className: "wsc-grid", children: BACKENDS.filter((b) => b.keyEnv).map((b) =>

package/lib/index.js

@@ -141,6 +141,8 @@ export const Config = z.object({
     .description("去重策略：url 仅按链接；url+title 额外合并同标题的转载镜像"),
   rerank: z.boolean().default(false)
     .description("按查询词相关性重排序（确定性、并列时保持后端优先级）"),
+  resultTelemetry: z.boolean().default(true)
+    .description("在搜索结果尾部附一行后端健康遥测（状态+耗时），模型可据此自诊断"),
 
   // Enable toggles (one per backend)
   enableExa: z.boolean().default(true).description(DEFAULT_LABELS.exa),
@@ -265,6 +267,7 @@ export function resolveOptions(ctx, config) {
     // v2.1 shaping options consumed by the provider merge pipeline.
     dedupStrategy: config?.dedupStrategy === "url+title" ? "url+title" : "url",
     rerank: config?.rerank === true,
+    resultTelemetry: config?.resultTelemetry !== false,
     filters: {
       recency: typeof config?.recency === "string" && config.recency !== "any" ? config.recency : undefined,
       lang: language.length > 0 ? language : undefined,

package/lib/provider.js

@@ -119,6 +119,7 @@ export function createUnifiedSearchProvider({ ctx, resolveOptions, backends }) {
       const effectiveRequest =
         Object.keys(filters).length > 0 ? { ...request, filters } : request;
 
+      const telemetry = [];
       // Concurrency limiter
       const limit = createLimiter(opts.concurrency ?? 6);
 
@@ -128,6 +129,7 @@ export function createUnifiedSearchProvider({ ctx, resolveOptions, backends }) {
       // reclassified as WEB_PROVIDER_ERROR so timeouts surface as real
       // failures instead of being silently demoted like user cancellations.
       const runBackend = ({ id, backend, beOpts, hooks }) => {
+        const startedAtMs = Date.now();
         const controller = new AbortController();
         const mergedSignal = signal
           ? AbortSignal.any([signal, controller.signal])
@@ -135,6 +137,16 @@ export function createUnifiedSearchProvider({ ctx, resolveOptions, backends }) {
         const timeoutId = setTimeout(() => controller.abort(), backendTimeoutMs);
         return backend
           .search(effectiveRequest, mergedSignal, beOpts, hooks)
+          .then(
+            (value) => {
+              telemetry.push({ id, ok: true, ms: Date.now() - startedAtMs, count: value?.sources?.length ?? 0 });
+              return value;
+            },
+            (err) => {
+              telemetry.push({ id, ok: false, ms: Date.now() - startedAtMs, error: String(err instanceof Error ? err.message : err).slice(0, 80) });
+              throw err;
+            },
+          )
           .catch((err) => {
             if (controller.signal.aborted && !(signal && signal.aborted)) {
               throw new WebError(
@@ -211,9 +223,16 @@ export function createUnifiedSearchProvider({ ctx, resolveOptions, backends }) {
       // If we got ANY sources, return them even if some backends failed.
       if (ordered.length > 0) {
         const sources = ordered.slice(0, maxResults);
+        let outContent = mergedContent;
+        if (opts.resultTelemetry !== false && telemetry.length > 0) {
+          const line = "[websearch backends] " + telemetry
+            .map((t) => t.id + (t.ok ? " ✓" : " ✗") + t.ms + "ms" + (t.ok ? "/" + t.count : ""))
+            .join(" · ");
+          outContent = outContent === undefined ? line : outContent + "\n\n" + line;
+        }
         return {
           sources,
-          ...(mergedContent !== undefined ? { content: mergedContent } : {}),
+          ...(outContent !== undefined ? { content: outContent } : {}),
           truncated: ordered.length > maxResults,
         };
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@240xu/dsh-websearch",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Unified web search provider for DeepSeek Harness (ctx.web): 11 backends \u2014 Exa + Parallel + DDG + SearXNG (keyless), DeepSeek + Anthropic + OpenAI + Brave + Tavily + Serper + Mojeek (key-gated via Settings credentials). Registers provider id \"unified\" for zero-config web_search tool.",
   "type": "module",
   "main": "lib/index.js",