dsh-free-search 0.8.2 → 0.8.3

package/lib/client.js

@@ -73,7 +73,12 @@ window.__ModuleLoader__.load({
         ".dshfs-priorityHandle:active{cursor:grabbing}",
         ".dshfs-priorityKey{flex:1;min-width:110px;max-width:200px;height:26px;padding:0 8px;font-size:12px;border:1px solid rgba(0,0,0,.12);border-radius:8px;background:transparent;color:inherit}",
         "@media (prefers-color-scheme: dark){.dshfs-priorityKey{border-color:rgba(255,255,255,.14)}}",
-        ".dshfs-priorityKey::placeholder{color:#8e8e93}",
+        ".dshfs-priorityKey::placeholder{color:#8e8e93}",
+        ".dshfs-keyStatus{flex:none;width:8px;height:8px;border-radius:50%;display:inline-block}",
+        ".dshfs-keyStatus-ok{background:#34c759}",
+        ".dshfs-keyStatus-miss{background:#ff9500}",
+        ".dshfs-keyStatus-opt{background:#c7c7cc}",
+        "@media (prefers-color-scheme: dark){.dshfs-keyStatus-opt{background:#48484a}}",
       ".dshfs-priorityRow[draggable='true']{cursor:grab}",
       ".dshfs-priorityRowDragging{opacity:.45;border-style:dashed}",
       "@media (prefers-color-scheme: dark){.dshfs-platform input{accent-color:#0a84ff}}",
@@ -162,8 +167,13 @@ window.__ModuleLoader__.load({
         geminiPh: (c) => c ? "Gemini 密钥（已配置）" : "Gemini 密钥（GEMINI_API_KEY / GOOGLE_API_KEY，按次计费，仅显式选用）",
         claudePh: (c) => c ? "Claude 密钥（已配置）" : "Anthropic 密钥（ANTHROPIC_API_KEY，按次计费，仅显式选用）",
         zhihuPh: (c) => c ? "知乎密钥（已配置）" : "知乎密钥（ZHIHU_API_KEY，知乎全网/站内共用）",
+        tinyfishPh: (c) => c ? "TinyFish 密钥（已配置）" : "TinyFish 密钥（TINYFISH_API_KEY，免费 12000 次/天）",
+        jinaPh: (c) => c ? "Jina 密钥（已配置）" : "Jina 密钥（JINA_API_KEY）",
         billedLabel: "按次计费",
         billedHint: "模型内置搜索（OpenAI/Gemini/Claude）：每次调用按量计费，仅在显式选中时运行，不参与自动回退。",
+        keyStatusConfigured: "密钥已配置",
+        keyStatusMissing: "缺少必需密钥",
+        keyStatusOptional: "密钥可选（未配置也可用）",
         keysHint: "密钥读取优先级：.credentials.yaml 凭据中心 > 这里 > 环境变量。推荐把 key 写进凭据中心（与官方 LLM 一致，一处管理）。",
         keyStorage: "Key 存储位置",
         keyStorageCred: "凭据中心（推荐）",
@@ -263,8 +273,13 @@ window.__ModuleLoader__.load({
         geminiPh: (c) => c ? "Gemini key (configured)" : "Gemini key (GEMINI_API_KEY / GOOGLE_API_KEY, billed per search, explicit use only)",
         claudePh: (c) => c ? "Claude key (configured)" : "Anthropic key (ANTHROPIC_API_KEY, billed per search, explicit use only)",
         zhihuPh: (c) => c ? "Zhihu key (configured)" : "Zhihu key (ZHIHU_API_KEY, shared by Zhihu web-wide/site)",
+        tinyfishPh: (c) => c ? "TinyFish key (configured)" : "TinyFish key (TINYFISH_API_KEY, 12000 free/day)",
+        jinaPh: (c) => c ? "Jina key (configured)" : "Jina key (JINA_API_KEY)",
         billedLabel: "Per-search billing",
         billedHint: "Model-based search (OpenAI/Gemini/Claude): billed per call, runs only when explicitly selected, never in automatic fallback.",
+        keyStatusConfigured: "Key configured",
+        keyStatusMissing: "Required key missing",
+        keyStatusOptional: "Key optional (works without)",
         keysHint: "Key resolution: .credentials.yaml credential center > here > environment variables. Recommended: store keys in the credential center (same as official LLM providers, one place for all).",
         keyStorage: "Key storage",
         keyStorageCred: "Credential center (recommended)",
@@ -340,7 +355,7 @@ window.__ModuleLoader__.load({
     };
     const tt = (lang) => I18N[lang === "en" ? "en" : "zh"];
     // 当前插件版本（与 lib/index.js 的 PLUGIN_VERSION 保持一致；跟随上游 v0.7.5）
-    const PLUGIN_VERSION = "0.8.2";
+    const PLUGIN_VERSION = "0.8.3";
     const ENGINES = [
       { id: "auto", label: "Auto · 智能路由", badge: "AUTO", link: null },
       { id: "multi", label: "Multi Search · 多引擎", badge: "MULTI", link: null },
@@ -363,6 +378,8 @@ window.__ModuleLoader__.load({
       { id: "kimi", label: "Kimi · Moonshot", badge: "API KEY", link: "https://platform.moonshot.cn" },
       { id: "aliyun", label: "Aliyun · 百炼", badge: "API KEY", link: "https://bailian.console.aliyun.com" },
       { id: "doubao", label: "Doubao · 豆包搜索", badge: "API KEY", link: "https://console.volcengine.com/search-infinity/web-search" },
+      { id: "tinyfish", label: "TinyFish", badge: "API KEY", link: "https://agent.tinyfish.ai/api-keys" },
+      { id: "jina", label: "Jina · 搜索", badge: "API KEY", link: "https://jina.ai/" },
       { id: "zhihu_global", label: "Zhihu · 知乎全网", badge: "API KEY", link: "https://developer.zhihu.com" },
       { id: "zhihu_site", label: "Zhihu · 知乎站内", badge: "API KEY", link: "https://developer.zhihu.com" },
       { id: "openai", label: "OpenAI · 内置搜索", badge: "API KEY", link: "https://platform.openai.com/api-keys" },
@@ -373,7 +390,7 @@ window.__ModuleLoader__.load({
     // 与 lib/index.js 的 EXPLICIT_ONLY_ENGINES 同源：按次计费、只在显式选中时运行，因此不提供入池候选。
     const EXPLICIT_ONLY_ENGINES = ["openai", "gemini", "claude"];
     const MODEL_ENGINES = ENGINES.filter((engine) => EXPLICIT_ONLY_ENGINES.includes(engine.id));
-    const DEFAULT_FALLBACK_ORDER = ["exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "serpbase", "serply", "deepseek-official", "you", "baidu", "kimi", "aliyun", "doubao", "bing", "anysearch", "ddg", "ddg-lite", "searxng", "zhihu_global", "zhihu_site"];
+    const DEFAULT_FALLBACK_ORDER = ["exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "serpbase", "serply", "deepseek-official", "you", "baidu", "kimi", "aliyun", "doubao", "tinyfish", "jina", "bing", "anysearch", "ddg", "ddg-lite", "searxng", "zhihu_global", "zhihu_site"];
     const normalizeFallbackOrder = (value) => {
       const configured = Array.isArray(value) ? value.filter((id) => ENGINE_IDS.includes(id)) : [];
       return [...new Set([...configured, ...DEFAULT_FALLBACK_ORDER, ...ENGINE_IDS.filter((id) => !EXPLICIT_ONLY_ENGINES.includes(id))])].filter((id) => !EXPLICIT_ONLY_ENGINES.includes(id));
@@ -524,6 +541,8 @@ window.__ModuleLoader__.load({
       const [geminiKey, setGeminiKey] = react.useState("");
       const [claudeKey, setClaudeKey] = react.useState("");
       const [zhihuKey, setZhihuKey] = react.useState("");
+      const [tinyfishKey, setTinyfishKey] = react.useState("");
+      const [jinaKey, setJinaKey] = react.useState("");
       const [platforms, setPlatforms] = react.useState(["github", "v2ex", "bilibili", "reddit", "hn", "stackoverflow", "wikipedia", "npm", "youtube", "vimeo"]);
       const [cacheTtl, setCacheTtl] = react.useState(5);
       const [keysConfigured, setKeysConfigured] = react.useState({});
@@ -559,12 +578,34 @@ window.__ModuleLoader__.load({
         kimi: [kimiKey, setKimiKey],
         aliyun: [aliyunKey, setAliyunKey],
         doubao: [doubaoKey, setDoubaoKey],
+        tinyfish: [tinyfishKey, setTinyfishKey],
+        jina: [jinaKey, setJinaKey],
         zhihu_global: [zhihuKey, setZhihuKey],
         zhihu_site: [zhihuKey, setZhihuKey],
         openai: [openaiKey, setOpenaiKey],
         gemini: [geminiKey, setGeminiKey],
         claude: [claudeKey, setClaudeKey],
       };
+      // #68 密钥状态可视化：引擎 id → 配置中心键名（少数引擎不同名），三态：已配置/可选/缺失
+      const CONFIGURED_KEY_ID = { "deepseek-official": "deepseek", you: "youcom", zhihu_global: "zhihu", zhihu_site: "zhihu" };
+      const NO_KEY_ENGINES = ["ddg", "ddg-lite", "bing", "searxng"];
+      const OPTIONAL_KEY_ENGINES = ["anysearch", "exa", "tavily", "keenable", "firecrawl", "parallel"];
+      const hasConfiguredKey = (id) => {
+        const k = CONFIGURED_KEY_ID[id] ?? id;
+        return Boolean(keysConfigured[k] || credConfigured[k]);
+      };
+      const renderKeyStatus = (id) => {
+        if (NO_KEY_ENGINES.includes(id)) return null;
+        const configured = hasConfiguredKey(id);
+        const optional = OPTIONAL_KEY_ENGINES.includes(id);
+        const state = configured ? "ok" : optional ? "opt" : "miss";
+        const title = configured ? t.keyStatusConfigured : optional ? t.keyStatusOptional : t.keyStatusMissing;
+        return react_jsx_runtime.jsx("span", {
+          className: "dshfs-keyStatus dshfs-keyStatus-" + state,
+          title,
+          "aria-label": title,
+        });
+      };
 
       const load = react.useCallback(async () => {
         try {
@@ -605,6 +646,8 @@ window.__ModuleLoader__.load({
               setGeminiKey(v.geminiApiKey ?? "");
               setClaudeKey(v.claudeApiKey ?? "");
               setZhihuKey(v.zhihuApiKey ?? "");
+              setTinyfishKey(v.tinyfishApiKey ?? "");
+              setJinaKey(v.jinaApiKey ?? "");
               setPlatforms(Array.isArray(v.platforms) && v.platforms.length > 0 ? v.platforms : ["github", "v2ex", "bilibili", "reddit", "hn", "stackoverflow", "wikipedia", "npm", "youtube", "vimeo"]);
               setCacheTtl(v.cacheTtl === undefined ? 5 : Math.min(Math.max(Number(v.cacheTtl) ?? 5, 0), 5));
               // secrets 字段标记哪些 key 已配置（值被脱敏，仅显示"已配置"）
@@ -631,6 +674,8 @@ window.__ModuleLoader__.load({
                   if (path === "geminiApiKey") configured.gemini = true;
                   if (path === "claudeApiKey") configured.claude = true;
                   if (path === "zhihuApiKey") configured.zhihu = true;
+                  if (path === "tinyfishApiKey") configured.tinyfish = true;
+                  if (path === "jinaApiKey") configured.jina = true;
                 }
               }
               setKeysConfigured(configured);
@@ -642,7 +687,7 @@ window.__ModuleLoader__.load({
                 const cred = await bridgeCredentialsStatus();
                 if (cred.ok) {
                   const cc = {};
-                  const map = { anysearchApiKey: "anysearch", exaApiKey: "exa", tavilyApiKey: "tavily", keenableApiKey: "keenable", firecrawlApiKey: "firecrawl", parallelApiKey: "parallel", perplexityApiKey: "perplexity", deepseekApiKey: "deepseek", serpbaseApiKey: "serpbase", serplyApiKey: "serply", youcomApiKey: "youcom", baiduApiKey: "baidu", kimiApiKey: "kimi", aliyunApiKey: "aliyun", doubaoApiKey: "doubao", openaiApiKey: "openai", geminiApiKey: "gemini", claudeApiKey: "claude", zhihuApiKey: "zhihu" };
+                  const map = { anysearchApiKey: "anysearch", exaApiKey: "exa", tavilyApiKey: "tavily", keenableApiKey: "keenable", firecrawlApiKey: "firecrawl", parallelApiKey: "parallel", perplexityApiKey: "perplexity", deepseekApiKey: "deepseek", serpbaseApiKey: "serpbase", serplyApiKey: "serply", youcomApiKey: "youcom", baiduApiKey: "baidu", kimiApiKey: "kimi", aliyunApiKey: "aliyun", doubaoApiKey: "doubao", openaiApiKey: "openai", geminiApiKey: "gemini", claudeApiKey: "claude", zhihuApiKey: "zhihu", tinyfishApiKey: "tinyfish", jinaApiKey: "jina" };
                   for (const [k, v] of Object.entries(cred.value.configured ?? {})) {
                     if (map[k]) cc[map[k]] = v;
                   }
@@ -698,6 +743,8 @@ window.__ModuleLoader__.load({
             ["geminiApiKey", geminiKey],
             ["claudeApiKey", claudeKey],
             ["zhihuApiKey", zhihuKey],
+            ["tinyfishApiKey", tinyfishKey],
+            ["jinaApiKey", jinaKey],
           ];
           if (keyStorage === "credentials") {
             for (const [field, value] of keyFields) {
@@ -1159,6 +1206,7 @@ react_jsx_runtime.jsx("div", {
                                 className: "dshfs-priorityName",
                                 children: `${engine.label} (${engine.badge})${isDisabled ? " · " + t.priorityDisabled : ""}`,
                               }),
+                              renderKeyStatus(engineId),
                               (() => {
                                 const k = KEY_INPUTS[engineId];
                                 if (!k) return null;
@@ -1228,6 +1276,7 @@ react_jsx_runtime.jsx("div", {
                               className: "dshfs-priorityName",
                               children: `${engine.label} (${engine.badge})`,
                             }),
+                            renderKeyStatus(engine.id),
                             k
                               ? react_jsx_runtime.jsx("input", {
                                   className: "dshfs-priorityKey",

package/lib/index.js

@@ -44,6 +44,8 @@ const KEENABLE_MCP_URL = "https://api.keenable.ai/mcp";
 const SERPBASE_URL = "https://api.serpbase.dev/google/search";
 const SERPLY_URL = "https://api.serply.io/v1/search";
 const YOUCOM_URL = "https://ydc-index.io/v1/search";
+const TINYFISH_URL = "https://api.search.tinyfish.ai";
+const JINA_URL = "https://s.jina.ai/";
 const DOUBAO_SEARCH_URL = "https://open.feedcoopapi.com/search_api/web_search";
 const ZHIHU_MCP_URL = "https://developer.zhihu.com/api/mcp/v1";
 const USER_AGENT =
@@ -84,7 +86,7 @@ const FREE_SEARCH_NS = "web-search-free";
 const BRIDGE_PREFIX = "/api/dsh-free-search-settings";
 // 意见 A：zhihu_global / zhihu_site 需要 ZHIHU_API_KEY，不属于免 key 引擎（不得进入 FREE_ENGINES）
 const FREE_ENGINES = ["ddg", "ddg-lite", "bing", "searxng", "anysearch"];
-const ALL_ENGINES = ["ddg", "ddg-lite", "bing", "searxng", "anysearch", "exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "serpbase", "serply", "deepseek-official", "you", "baidu", "kimi", "aliyun", "doubao", "zhihu_global", "zhihu_site", "openai", "gemini", "claude"];
+const ALL_ENGINES = ["ddg", "ddg-lite", "bing", "searxng", "anysearch", "exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "serpbase", "serply", "deepseek-official", "you", "baidu", "kimi", "aliyun", "doubao", "tinyfish", "jina", "zhihu_global", "zhihu_site", "openai", "gemini", "claude"];
 
 // 模型内置搜索（按次计费）：只在你显式选中该引擎时使用；自动回退链与 auto 路由都不会兜底到它们。
 const EXPLICIT_ONLY_ENGINES = ["openai", "gemini", "claude"];
@@ -160,12 +162,12 @@ const FAILURE_CLASS_LABELS = {
 
 
 // 支持 time_range 过滤的引擎（zhihu_global：global_search 的 filter 支持 publish_time>=unix秒，已实测；zhihu_site 未验证，不加）
-const TIME_ENGINES = ["tavily", "exa", "keenable", "firecrawl", "parallel", "searxng", "ddg", "ddg-lite", "baidu", "doubao", "zhihu_global"];
+const TIME_ENGINES = ["tavily", "exa", "keenable", "firecrawl", "parallel", "searxng", "ddg", "ddg-lite", "baidu", "doubao", "tinyfish", "zhihu_global"];
 
 // 虚拟搜索模式：不是单个引擎，而是 provider.search 内部的路由/并发策略
 const SEARCH_MODES = ["auto", "multi"];
 
-const DEFAULT_FALLBACK_ORDER = ["exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "serpbase", "serply", "deepseek-official", "you", "baidu", "kimi", "aliyun", "doubao", "bing", "anysearch", "ddg", "ddg-lite", "searxng", "zhihu_global", "zhihu_site"];
+const DEFAULT_FALLBACK_ORDER = ["exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "serpbase", "serply", "deepseek-official", "you", "baidu", "kimi", "aliyun", "doubao", "tinyfish", "jina", "bing", "anysearch", "ddg", "ddg-lite", "searxng", "zhihu_global", "zhihu_site"];
 
 function normalizeDisabledEngines(value) {
   if (!Array.isArray(value)) return [];
@@ -238,7 +240,7 @@ function routeEngines(query, { timeRange, disabledEngines = [], fallbackOrder =
 }
 
 // 当前插件版本（发布时与 package.json 同步；跟随上游 v0.7.5，不在 PR 里 bump）
-const PLUGIN_VERSION = "0.8.2";
+const PLUGIN_VERSION = "0.8.3";
 // 检查更新的 npm registry 元数据地址（dsh-free-search 是 npmjs 上的公开包）
 const NPM_REGISTRY_URL = "https://registry.npmjs.org/dsh-free-search/latest";
 const PLUGIN_NPM_URL = "https://www.npmjs.com/package/dsh-free-search";
@@ -1918,6 +1920,86 @@ async function searchYoucom(query, maxResults, apiKey, signal) {
   return { sources: uniqueSources(sources, maxResults ?? 10), truncated: false };
 }
 
+// TinyFish Search（api.search.tinyfish.ai）：GET + X-API-Key；免费 12000 请求/天。
+// 支持 after_date / before_date（YYYY-MM-DD）时间过滤。
+async function searchTinyfish(query, maxResults, apiKey, timeRange, signal) {
+  if (!apiKey) throw new Error("TinyFish search requires TINYFISH_API_KEY");
+  const params = new URLSearchParams({ query });
+  if (timeRange) {
+    if (timeRange.after) {
+      params.set("after_date", timeRange.after);
+    } else if (timeRange.days !== undefined) {
+      params.set("after_date", new Date(Date.now() - timeRange.days * 86400000).toISOString().slice(0, 10));
+    }
+  }
+  const response = await fetch(`${TINYFISH_URL}?${params}`, {
+    method: "GET",
+    redirect: "error",
+    headers: {
+      "X-API-Key": apiKey,
+      accept: "application/json",
+      "user-agent": "deepseek-harness/free-search",
+    },
+    signal: AbortSignal.any([...(signal !== undefined ? [signal] : []), AbortSignal.timeout(15000)]),
+  });
+  if (!response.ok) {
+    const detail = await response.text().catch(() => "");
+    if (response.status === 401 || response.status === 403) {
+      throw new Error(`TinyFish API key is invalid (HTTP ${response.status}) - update it in Settings > Plugins > Free Search`);
+    }
+    if (response.status === 429) {
+      throw new Error("TinyFish rate limit exceeded (HTTP 429) - free tier is 30 req/min, 500 req/hour");
+    }
+    throw new Error(`TinyFish API error (HTTP ${response.status}): ${detail.slice(0, 200)}`);
+  }
+  const data = await response.json();
+  // 响应：{ query, results: [ { position, site_name, title, snippet, url } ], total_results, page }
+  const sources = (data.results ?? [])
+    .filter((r) => r.url)
+    .map((r) => ({
+      url: r.url,
+      ...(r.title ? { title: String(r.title) } : {}),
+      ...(r.snippet ? { snippet: String(r.snippet).slice(0, 300) } : {}),
+    }));
+  return { sources: uniqueSources(sources, maxResults ?? 10), truncated: false };
+}
+
+// Jina Search（s.jina.ai）：GET + Bearer；需 JINA_API_KEY。
+async function searchJina(query, maxResults, apiKey, signal) {
+  if (!apiKey) throw new Error("Jina search requires JINA_API_KEY");
+  const params = new URLSearchParams({ q: query });
+  const response = await fetch(`${JINA_URL}?${params}`, {
+    method: "GET",
+    redirect: "error",
+    headers: {
+      authorization: `Bearer ${apiKey}`,
+      accept: "application/json",
+      "user-agent": "deepseek-harness/free-search",
+    },
+    signal: AbortSignal.any([...(signal !== undefined ? [signal] : []), AbortSignal.timeout(20000)]),
+  });
+  if (!response.ok) {
+    const detail = await response.text().catch(() => "");
+    if (response.status === 401 || response.status === 403) {
+      throw new Error(`Jina API key is invalid (HTTP ${response.status}) - update it in Settings > Plugins > Free Search`);
+    }
+    if (response.status === 429) {
+      throw new Error("Jina rate limit exceeded (HTTP 429) - check your plan at jina.ai");
+    }
+    throw new Error(`Jina API error (HTTP ${response.status}): ${detail.slice(0, 200)}`);
+  }
+  const data = await response.json();
+  // 响应：{ code, status, data: [ { title, url, description, content } ] }
+  const sources = (data.data ?? [])
+    .filter((r) => r.url)
+    .map((r) => ({
+      url: r.url,
+      ...(r.title ? { title: String(r.title) } : {}),
+      ...(r.description ? { snippet: String(r.description).slice(0, 300) } : {}),
+    }));
+  return { sources: uniqueSources(sources, maxResults ?? 10), truncated: false };
+}
+
 // 百度千帆 AI 搜索（v2/ai_search/web_search）
 // key = 环境变量 BAIDU_API_KEY
 async function searchBaidu(query, maxResults, apiKey, timeRange, signal) {
@@ -2949,6 +3031,8 @@ const KEY_REF_MAP = {
   kimiApiKey: "MOONSHOT_API_KEY",
   aliyunApiKey: "DASHSCOPE_API_KEY",
   doubaoApiKey: "DOUBAO_SEARCH_API_KEY",
+  tinyfishApiKey: "TINYFISH_API_KEY",
+  jinaApiKey: "JINA_API_KEY",
   zhihuApiKey: "ZHIHU_API_KEY",
   openaiApiKey: "OPENAI_API_KEY",
   geminiApiKey: "GEMINI_API_KEY",
@@ -2988,6 +3072,8 @@ const Config = z.object({
   kimiApiKey: z.string().role("secret").volatile(),
   aliyunApiKey: z.string().role("secret").volatile(),
   doubaoApiKey: z.string().role("secret").volatile(),
+  tinyfishApiKey: z.string().role("secret").volatile(),
+  jinaApiKey: z.string().role("secret").volatile(),
   zhihuApiKey: z.string().role("secret").volatile(),
   // 语言分池（评审意见 B）：auto 的 routeHead 与 multi 的并发池按查询语言二选一；未配置用默认两组
   zhPool: z.array(z.string()).volatile(),
@@ -3042,6 +3128,8 @@ const LEGACY_MIGRATABLE_KEYS = [
   "kimiApiKey",
   "aliyunApiKey",
   "doubaoApiKey",
+  "tinyfishApiKey",
+  "jinaApiKey",
   "openaiApiKey",
   "geminiApiKey",
   "claudeApiKey",
@@ -3413,6 +3501,26 @@ function apply(ctx, config) {
               continue; // 无 key 跳过
             }
             result = await searchYoucom(request.query, request.maxResults, key, effSignal);
+          } else if (engine === "tinyfish") {
+            // tinyfish：必须配置 TINYFISH_API_KEY（无 key 跳过）；免费 12000 请求/天
+            const key = await resolveApiKey("TINYFISH_API_KEY", "tinyfishApiKey");
+            if (!key) {
+              lastError = new Error("TinyFish requires TINYFISH_API_KEY (get one at agent.tinyfish.ai/api-keys)");
+              if (engine === preferred) preferredFailure = "TINYFISH_API_KEY is not configured";
+              logger.warn(`free-search: engine "${engine}" skipped (no key), trying next engine`);
+              continue; // 无 key 跳过
+            }
+            result = await searchTinyfish(request.query, request.maxResults, key, timeRange, effSignal);
+          } else if (engine === "jina") {
+            // jina：必须配置 JINA_API_KEY（无 key 跳过）
+            const key = await resolveApiKey("JINA_API_KEY", "jinaApiKey");
+            if (!key) {
+              lastError = new Error("Jina requires JINA_API_KEY (get one at jina.ai)");
+              if (engine === preferred) preferredFailure = "JINA_API_KEY is not configured";
+              logger.warn(`free-search: engine "${engine}" skipped (no key), trying next engine`);
+              continue; // 无 key 跳过
+            }
+            result = await searchJina(request.query, request.maxResults, key, effSignal);
           } else if (engine === "baidu") {
             const key = await resolveApiKey("BAIDU_API_KEY", "baiduApiKey");
             if (!key) {
@@ -3720,6 +3828,16 @@ function apply(ctx, config) {
           if (!key) return { ok: false, error: "SERPLY_API_KEY not configured" };
           return await searchSerply(q, n, key, cfg);
         }
+        case "tinyfish": {
+          const key = await resolveApiKey("TINYFISH_API_KEY", "tinyfishApiKey");
+          if (!key) return { ok: false, error: "TINYFISH_API_KEY not configured" };
+          return await searchTinyfish(q, n, key, tr);
+        }
+        case "jina": {
+          const key = await resolveApiKey("JINA_API_KEY", "jinaApiKey");
+          if (!key) return { ok: false, error: "JINA_API_KEY not configured" };
+          return await searchJina(q, n, key);
+        }
         case "baidu": {
           const key = await resolveApiKey("BAIDU_API_KEY", "baiduApiKey");
           if (!key) return { ok: false, error: "BAIDU_API_KEY not configured" };
@@ -3935,7 +4053,7 @@ function apply(ctx, config) {
           parameters: {
             engines: {
               type: "array",
-              description: "Which engines to test (default: all enabled engines). Options: ddg, ddg-lite, bing, searxng, anysearch, exa, tavily, keenable, firecrawl, parallel, perplexity, serpbase, serply, deepseek-official, you, baidu, kimi, aliyun, doubao, zhihu_global, zhihu_site, openai, gemini, claude; zhihu_global (web-wide, supports time filter) and zhihu_site (Zhihu-only) need ZHIHU_API_KEY. The virtual modes auto and multi are also accepted and run the real routing/concurrent path. openai/gemini/claude are model-based and bill per search, so they are only used when explicitly named.",
+              description: "Which engines to test (default: all enabled engines). Options: ddg, ddg-lite, bing, searxng, anysearch, exa, tavily, keenable, firecrawl, parallel, perplexity, serpbase, serply, deepseek-official, you, baidu, kimi, aliyun, doubao, tinyfish, jina, zhihu_global, zhihu_site, openai, gemini, claude; zhihu_global (web-wide, supports time filter) and zhihu_site (Zhihu-only) need ZHIHU_API_KEY. The virtual modes auto and multi are also accepted and run the real routing/concurrent path. openai/gemini/claude are model-based and bill per search, so they are only used when explicitly named.",
               items: { type: "string" },
             },
             query: {
@@ -4260,7 +4378,7 @@ function apply(ctx, config) {
             },
             engine: {
               type: "string",
-              description: "Optional search mode/engine: multi (parallel full language-pool merge), auto, ddg, ddg-lite, bing, searxng, anysearch, exa, tavily, keenable, firecrawl, parallel, perplexity, serpbase, serply, deepseek-official, you, baidu, kimi, aliyun, doubao, zhihu_global, zhihu_site, openai, gemini, claude (model-based; explicit selection only).",
+              description: "Optional search mode/engine: multi (parallel full language-pool merge), auto, ddg, ddg-lite, bing, searxng, anysearch, exa, tavily, keenable, firecrawl, parallel, perplexity, serpbase, serply, deepseek-official, you, baidu, kimi, aliyun, doubao, tinyfish, jina, zhihu_global, zhihu_site, openai, gemini, claude (model-based; explicit selection only).",
             },
           },
           output: {
@@ -4520,6 +4638,8 @@ export {
   searchSearxng,
   searchSerpbase,
   searchSerply,
+  searchTinyfish,
+  searchJina,
   searchYoucom,
   searchZhihuGlobal,
   searchZhihuSite,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-free-search",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "description": "Free web search for DeepSeek Harness: 24 engines (Bing/DuckDuckGo/AnySearch/SearXNG/Exa/Tavily/Keenable/Firecrawl/Parallel keyless; Zhihu global/site via MCP and Perplexity/SerpBase/DeepSeek/You.com/Baidu/Kimi/Aliyun/Doubao with key; OpenAI/Gemini/Claude model built-in search, explicit-only) + auto smart routing + global engine enable/disable & fallback priority + editable zh/en language pools + multi mode (parallel full language-pool merge) + multi_search cross-source tool + failure-aware fallback (quota/auth cooldown, transient retry, fallbackOn) + time filtering + platform search + web_fetch, with web settings UI.",
   "type": "module",
   "main": "lib/index.js",