dsh-free-search 0.5.6 → 0.6.0

package/README.md

@@ -29,7 +29,7 @@ dsh 默认的搜索 provider 依赖 DeepSeek 官方 API key（`DEEPSEEK_API_KEY`
 ### 特性
 
 - **零成本** —— 多个免费引擎，无需 key、无需注册
-- **多引擎可选**：DuckDuckGo（html/lite）、Bing、SearXNG（元搜索，支持自定义实例）、AnySearch、Exa、Tavily、Keenable、Firecrawl、Parallel、Perplexity、SerpBase、DeepSeek 官方、You.com
+- **多引擎可选**：DuckDuckGo（html/lite）、Bing、SearXNG（元搜索，支持自定义实例）、AnySearch、Exa、Tavily、Keenable、Firecrawl、Parallel、Perplexity、SerpBase、DeepSeek 官方、You.com、百度千帆、Kimi、阿里云百炼、火山联网搜索（豆包搜索）
 - **网页设置页** —— 引擎切换 + API key 配置（UI 中 key 脱敏显示"已配置"）+ 中英文切换；入口在左侧「插件」页的组件行配置（`plugins.row.config`，DSH 0.1.7-rc.1+）
 - **弹出式切换命令** —— 聊天框输入 `/free-search-engine`，弹出引擎选择窗口，点选即切换（等效设置页 + 保存）
 - **引擎测试** —— `free_search_test` 工具让 agent 一键测试所有引擎；设置页也有"测试引擎"按钮（直测当前引擎，不走回退链，付费引擎无 key 会明确报错）
@@ -68,6 +68,7 @@ dsh 默认的搜索 provider 依赖 DeepSeek 官方 API key（`DEEPSEEK_API_KEY`
 | `baidu` | 百度千帆 AI 搜索 | 额度 | 需 `BAIDU_API_KEY`（千帆 AI 搜索，每日赠 50 次，超额按量后付费）；中文全网，支持时间过滤 |
 | `kimi` | Kimi（Moonshot）联网搜索 | 付费 | 需 `MOONSHOT_API_KEY`（basic 约 ￥0.01/次），返回带正文 chunks 的中文结果 |
 | `aliyun` | 阿里云百炼 EnhancedSearch | 付费 | 需 `DASHSCOPE_API_KEY`（MCP search_pro，约 ￥0.03/次，新用户 200 次免费包）；中文全网带来源 hostname |
+| `doubao` | 火山引擎联网搜索（豆包搜索） | 免费额度 | 需 `DOUBAO_SEARCH_API_KEY`（联网搜索控制台开通，**每月 500 次免费**，超出按量付费）；中文时效内容强，支持时间/站点过滤，返回千字级摘要 |
 
 - **默认引擎为 `bing`**（免费且最稳定），安装后开箱即用。
 - **自动回退**：任何引擎失败（免费限流/反爬，付费缺 key/无效/网络错误）都会自动轮流尝试下一个引擎——先试其他已配 key 的付费引擎，再试免费引擎（Bing/AnySearch 等），并在结果中附带回退提示——搜索不会因引擎问题直接失败。
@@ -79,6 +80,7 @@ dsh 默认的搜索 provider 依赖 DeepSeek 官方 API key（`DEEPSEEK_API_KEY`
   - Perplexity：<https://www.perplexity.ai/settings/api>
   - SerpBase：<https://serpbase.dev>
   - DeepSeek：<https://platform.deepseek.com/api_keys>
+  - 豆包搜索（火山联网搜索）：<https://console.volcengine.com/search-infinity/web-search>
   - You.com：<https://you.com/platform/api-keys>
 
 #### 为什么免费引擎不需要 key？
@@ -192,7 +194,7 @@ DSH 0.1.7-rc.1 起，配置跟随 profile 的插件条目保存：设置页与 `
 
 ```yaml
 # profiles/<profile>/cordis.patch.yml 中该条目的 config：
-provider: bing              # ddg / ddg-lite / bing / searxng / anysearch / exa / tavily / keenable / firecrawl / parallel / perplexity / serpbase / deepseek-official / you
+provider: bing              # ddg / ddg-lite / bing / searxng / anysearch / exa / tavily / keenable / firecrawl / parallel / perplexity / serpbase / deepseek-official / you / baidu / kimi / aliyun / doubao
 lang: zh                    # 设置页界面语言（zh / en）
 bingMarket: zh-CN           # Bing 市场
 region: cn-zh               # DuckDuckGo 区域（可选）
@@ -340,7 +342,7 @@ This plugin provides multiple free search engines with automatic fallback, compl
 ### Features
 
 - **Zero Cost** — Multiple free engines with no API key or registration required
-- **Multi-Engine Support** — DuckDuckGo (HTML / Lite), Bing, AnySearch AI, SearXNG (meta-search with custom instances), Exa, Tavily, Keenable, Firecrawl, Parallel, Perplexity, SerpBase, DeepSeek Official, and You.com
+- **Multi-Engine Support** — DuckDuckGo (HTML / Lite), Bing, AnySearch AI, SearXNG (meta-search with custom instances), Exa, Tavily, Keenable, Firecrawl, Parallel, Perplexity, SerpBase, DeepSeek Official, You.com, Baidu Qianfan, Kimi, Aliyun Bailian, and Volcano Doubao
 - **Web Settings UI** — Engine switching, API key configuration (keys masked as "configured" in the UI), and a Chinese/English toggle; the entry is the component-row config (`plugins.row.config`) on the sidebar Plugins page (DSH 0.1.7-rc.1+)
 - **Popup Switch Command** — Type `/free-search-engine` in the chat: a picker opens with all engines; click one to switch (equivalent to the settings page + save)
 - **Engine Testing** — `free_search_test` for the agent to check all engines in one call; the settings UI also has a "Test engine" button that tests the selected engine directly (no fallback chain; paid engines without a key report an explicit error)
@@ -379,6 +381,7 @@ If this plugin has been helpful, a ⭐ on [GitHub](https://github.com/DDDMUC/dsh
 | `baidu` | Baidu Qianfan AI Search | Quota | Requires `BAIDU_API_KEY` (Qianfan AI Search, 50 free calls/day then pay-as-you-go); Chinese web-wide, supports time filtering |
 | `kimi` | Kimi (Moonshot) Web Search | Paid | Requires `MOONSHOT_API_KEY` (basic ~¥0.01/call); returns Chinese results with body chunks |
 | `aliyun` | Aliyun Bailian EnhancedSearch | Paid | Requires `DASHSCOPE_API_KEY` (MCP search_pro, ~¥0.03/call, 200 free calls for new users); Chinese web-wide with source hostnames |
+| `doubao` | Volcano Web Search (Doubao) | Free quota | Requires `DOUBAO_SEARCH_API_KEY` (open it in the Web Search console; **500 free queries/month**, pay-as-you-go beyond); strong for fresh Chinese content, supports time/site filters, returns long summaries |
 
 - **Default engine is `bing`** (free and most stable), ready to use out of the box after installation.
 - **Auto-failover**: any engine failure (rate-limited free engine, or missing/invalid paid key, network error) automatically tries the next engine — the configured engine first, then other engines (exa/tavily/keenable/firecrawl/parallel are tried even without a key because they have built-in keyless quota), then the remaining free engines (Bing/AnySearch etc.) — with a note attached to the results naming the engine that actually served them (e.g. `Note: perplexity unavailable or failed, using exa.`). Search never fails outright because of engine issues.
@@ -390,6 +393,7 @@ If this plugin has been helpful, a ⭐ on [GitHub](https://github.com/DDDMUC/dsh
   - Perplexity: <https://www.perplexity.ai/settings/api>
   - SerpBase: <https://serpbase.dev>
   - DeepSeek: <https://platform.deepseek.com/api_keys>
+  - Doubao / Volcano Web Search: <https://console.volcengine.com/search-infinity/web-search>
   - You.com: <https://you.com/platform/api-keys>
 
 #### Why are some engines free?
@@ -503,7 +507,7 @@ The old `free-search:` section of `~/.dsh/settings.yaml` is **not** imported by
 
 ```yaml
 # config of that entry in profiles/<profile>/cordis.patch.yml:
-provider: bing              # ddg / ddg-lite / bing / searxng / anysearch / exa / tavily / keenable / firecrawl / parallel / perplexity / serpbase / deepseek-official / you
+provider: bing              # ddg / ddg-lite / bing / searxng / anysearch / exa / tavily / keenable / firecrawl / parallel / perplexity / serpbase / deepseek-official / you / baidu / kimi / aliyun / doubao
 lang: zh                    # settings UI language (zh / en)
 bingMarket: zh-CN           # Bing market
 region: cn-zh               # DuckDuckGo region (optional)

package/cordis.patch.yml

@@ -4,7 +4,7 @@
 # The engine is chosen from the sidebar Plugins page -> Free Search row config
 # (plugins.row.config, DSH 0.1.7-rc.1+), from the /free-search-engine command,
 # or directly via this entry's config, e.g.:
-#   provider: bing        # engine id: ddg / bing / baidu / kimi / aliyun / auto / ...
+#   provider: bing        # engine id: ddg / bing / baidu / kimi / aliyun / doubao / auto / ...
 #   region: cn-zh         # DuckDuckGo region
 #   bingMarket: zh-CN     # Bing market
 # A legacy ~/.dsh/settings.yaml "free-search:" section is migrated into this

package/lib/client.js

@@ -137,11 +137,12 @@ window.__ModuleLoader__.load({
         baiduPh: (c) => c ? "Baidu API 密钥（已配置）" : "百度千帆 API 密钥（BAIDU_API_KEY）",
         kimiPh: (c) => c ? "Kimi API 密钥（已配置）" : "Kimi API 密钥（MOONSHOT_API_KEY）",
         aliyunPh: (c) => c ? "Aliyun API 密钥（已配置）" : "阿里云 DashScope 密钥（DASHSCOPE_API_KEY）",
+        doubaoPh: (c) => c ? "豆包搜索密钥（已配置）" : "豆包搜索 / 火山联网搜索密钥（DOUBAO_SEARCH_API_KEY，每月 500 次免费）",
         keysHint: "密钥读取优先级：.credentials.yaml 凭据中心 > 这里 > 环境变量。推荐把 key 写进凭据中心（与官方 LLM 一致，一处管理）。",
         keyStorage: "Key 存储位置",
         keyStorageCred: "凭据中心（推荐）",
         keyStorageSettings: "设置页（兼容）",
-        keyStorageCredHint: (c) => `保存后写入 ~/.dsh/.credentials.yaml（最高优先级）。当前已配置：${["anysearch", "exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "serpbase", "deepseek", "youcom", "baidu", "kimi", "aliyun"].filter((k) => c[k]).map((k) => k.toUpperCase()).join(", ") || "无"}`,
+        keyStorageCredHint: (c) => `保存后写入 ~/.dsh/.credentials.yaml（最高优先级）。当前已配置：${["anysearch", "exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "serpbase", "deepseek", "youcom", "baidu", "kimi", "aliyun", "doubao"].filter((k) => c[k]).map((k) => k.toUpperCase()).join(", ") || "无"}`,
         keyStorageSettingsHint: "保存后写入当前 profile 的插件条目 config（cordis.patch.yml，优先级低于凭据中心）。",
         platformSearch: "平台搜索（platform_search 工具）",
         platformHint: "为 agent 的 platform_search 工具启用平台。禁用的平台会被跳过。",
@@ -210,11 +211,12 @@ window.__ModuleLoader__.load({
         baiduPh: (c) => c ? "Baidu API key (configured)" : "Baidu Qianfan API key (BAIDU_API_KEY)",
         kimiPh: (c) => c ? "Kimi API key (configured)" : "Kimi API key (MOONSHOT_API_KEY)",
         aliyunPh: (c) => c ? "Aliyun API key (configured)" : "Aliyun DashScope API key (DASHSCOPE_API_KEY)",
+        doubaoPh: (c) => c ? "Doubao search key (configured)" : "Doubao / Volcano Web Search key (DOUBAO_SEARCH_API_KEY, 500 free/month)",
         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)",
         keyStorageSettings: "Settings page (legacy)",
-        keyStorageCredHint: (c) => `Saved to ~/.dsh/.credentials.yaml (highest priority). Currently configured: ${["anysearch", "exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "serpbase", "deepseek", "youcom", "baidu", "kimi", "aliyun"].filter((k) => c[k]).map((k) => k.toUpperCase()).join(", ") || "none"}`,
+        keyStorageCredHint: (c) => `Saved to ~/.dsh/.credentials.yaml (highest priority). Currently configured: ${["anysearch", "exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "serpbase", "deepseek", "youcom", "baidu", "kimi", "aliyun", "doubao"].filter((k) => c[k]).map((k) => k.toUpperCase()).join(", ") || "none"}`,
         keyStorageSettingsHint: "Saved to the active profile plugin entry config (cordis.patch.yml; lower priority than the credential center).",
         platformSearch: "Platform search (platform_search tool)",
         platformHint: "Enable platforms for the agent's platform_search tool. Disabled platforms are skipped.",
@@ -265,7 +267,7 @@ window.__ModuleLoader__.load({
     };
     const tt = (lang) => I18N[lang === "en" ? "en" : "zh"];
     // 当前插件版本（与 lib/index.js 的 PLUGIN_VERSION 保持一致）
-    const PLUGIN_VERSION = "0.5.6";
+    const PLUGIN_VERSION = "0.6.0";
     const ENGINES = [
       { id: "auto", label: "Auto · 智能路由", badge: "AUTO", link: null },
       { id: "ddg", label: "DuckDuckGo · HTML", badge: "FREE", link: "https://duckduckgo.com" },
@@ -285,6 +287,7 @@ window.__ModuleLoader__.load({
       { id: "baidu", label: "Baidu · 百度千帆", badge: "API KEY", link: "https://console.bce.baidu.com/qianfan" },
       { 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" },
     ];
 
     async function bridgeDescribe() {
@@ -400,6 +403,7 @@ window.__ModuleLoader__.load({
       const [baiduKey, setBaiduKey] = react.useState("");
       const [kimiKey, setKimiKey] = react.useState("");
       const [aliyunKey, setAliyunKey] = react.useState("");
+      const [doubaoKey, setDoubaoKey] = react.useState("");
       const [platforms, setPlatforms] = react.useState(["github", "v2ex", "bilibili", "reddit", "hn", "stackoverflow", "wikipedia", "npm"]);
       const [cacheTtl, setCacheTtl] = react.useState(5);
       const [keysConfigured, setKeysConfigured] = react.useState({});
@@ -443,6 +447,7 @@ window.__ModuleLoader__.load({
               setBaiduKey(v.baiduApiKey ?? "");
               setKimiKey(v.kimiApiKey ?? "");
               setAliyunKey(v.aliyunApiKey ?? "");
+              setDoubaoKey(v.doubaoApiKey ?? "");
               setPlatforms(Array.isArray(v.platforms) && v.platforms.length > 0 ? v.platforms : ["github", "v2ex", "bilibili", "reddit", "hn", "stackoverflow", "wikipedia", "npm"]);
               setCacheTtl(v.cacheTtl === undefined ? 5 : Math.min(Math.max(Number(v.cacheTtl) ?? 5, 0), 5));
               // secrets 字段标记哪些 key 已配置（值被脱敏，仅显示"已配置"）
@@ -463,6 +468,7 @@ window.__ModuleLoader__.load({
                   if (path === "baiduApiKey") configured.baidu = true;
                   if (path === "kimiApiKey") configured.kimi = true;
                   if (path === "aliyunApiKey") configured.aliyun = true;
+                  if (path === "doubaoApiKey") configured.doubao = true;
                 }
               }
               setKeysConfigured(configured);
@@ -474,7 +480,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", youcomApiKey: "youcom", baiduApiKey: "baidu", kimiApiKey: "kimi", aliyunApiKey: "aliyun" };
+                  const map = { anysearchApiKey: "anysearch", exaApiKey: "exa", tavilyApiKey: "tavily", keenableApiKey: "keenable", firecrawlApiKey: "firecrawl", parallelApiKey: "parallel", perplexityApiKey: "perplexity", deepseekApiKey: "deepseek", serpbaseApiKey: "serpbase", youcomApiKey: "youcom", baiduApiKey: "baidu", kimiApiKey: "kimi", aliyunApiKey: "aliyun", doubaoApiKey: "doubao" };
                   for (const [k, v] of Object.entries(cred.value.configured ?? {})) {
                     if (map[k]) cc[map[k]] = v;
                   }
@@ -524,6 +530,7 @@ window.__ModuleLoader__.load({
             ["baiduApiKey", baiduKey],
             ["kimiApiKey", kimiKey],
             ["aliyunApiKey", aliyunKey],
+            ["doubaoApiKey", doubaoKey],
           ];
           if (keyStorage === "credentials") {
             for (const [field, value] of keyFields) {
@@ -982,6 +989,19 @@ react_jsx_runtime.jsx("div", {
                           setSaveError("");
                         },
                       }),
+                      react_jsx_runtime.jsx("input", {
+                        className: "dshfs-input",
+                        type: "password",
+                        placeholder: t.doubaoPh(keysConfigured.doubao),
+                        value: doubaoKey,
+                        disabled: !ready || saving,
+                        onChange: (e) => {
+                          setDoubaoKey(e.target.value);
+                          setDirty(true);
+                          setFailed(false);
+                          setSaveError("");
+                        },
+                      }),
                       react_jsx_runtime.jsx("p", {
                         className: "dshfs-hint",
                         children: t.keysHint,

package/lib/index.js

@@ -17,6 +17,7 @@ const KEENABLE_URL = "https://api.keenable.ai/v1/search";
 const KEENABLE_MCP_URL = "https://api.keenable.ai/mcp";
 const SERPBASE_URL = "https://api.serpbase.dev/google/search";
 const YOUCOM_URL = "https://ydc-index.io/v1/search";
+const DOUBAO_SEARCH_URL = "https://open.feedcoopapi.com/search_api/web_search";
 const USER_AGENT =
   "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0 Safari/537.36";
 const ACCEPT_LANG = "zh-CN,zh;q=0.9,en;q=0.8";
@@ -54,11 +55,11 @@ const MARKET_TO_LANG = {
 const FREE_SEARCH_NS = "web-search-free";
 const BRIDGE_PREFIX = "/api/dsh-free-search-settings";
 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", "deepseek-official", "you", "baidu", "kimi", "aliyun"];
+const ALL_ENGINES = ["ddg", "ddg-lite", "bing", "searxng", "anysearch", "exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "serpbase", "deepseek-official", "you", "baidu", "kimi", "aliyun", "doubao"];
 
 
 // 支持 time_range 过滤的引擎
-const TIME_ENGINES = ["tavily", "exa", "keenable", "firecrawl", "parallel", "searxng", "ddg", "ddg-lite", "baidu"];
+const TIME_ENGINES = ["tavily", "exa", "keenable", "firecrawl", "parallel", "searxng", "ddg", "ddg-lite", "baidu", "doubao"];
 
 // 智能路由（provider=auto 时启用）：纯确定性规则重排引擎顺序，末尾接上其余全部引擎保证回退链完整
 function routeEngines(query, { timeRange } = {}) {
@@ -82,7 +83,7 @@ function routeEngines(query, { timeRange } = {}) {
 }
 
 // 当前插件版本（发布时与 package.json 同步）
-const PLUGIN_VERSION = "0.5.6";
+const PLUGIN_VERSION = "0.6.0";
 // 检查更新的 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";
@@ -212,14 +213,21 @@ function buildCacheKey(query, maxResults, timeRangeLabel, preferred) {
 const SNIPPET_NOISE =
   /\b(sign up|sign in|log in|login|subscribe( to| for)?|member[- ]?only|become a member|create (a )?free account|read more|continue reading|story continues|get started|install (the )?app|view on|medium membership|join \w+ for free|get updates from this writer|stories in your inbox|remember me for|unlock this|free to read|become a patron)\b/gi;
 
-function cleanSnippet(text) {
+function cleanSnippet(text, max = 300) {
   if (!text) return text;
   return String(text)
     .replace(SNIPPET_NOISE, " ")
     .replace(/^\s*(#{1,6}\s*|\[\s*x?\s*\]\s*|-\s*\[\s*x?\s*\]\s*|>\s*)/gm, " ")
     .replace(/\s+/g, " ")
     .trim()
-    .slice(0, 300);
+    .slice(0, max);
+}
+
+// 各引擎的摘要展示上限：豆包搜索返回的是千字级 Summary（实测 1300-1800 字），放宽到 2000；
+// 其余引擎维持 300。该上限同时用于 provider 成功后的清洗与 runEngineTest（喂 multi_search）。
+const SNIPPET_MAX_BY_ENGINE = { doubao: 2000 };
+function snippetCap(engine) {
+  return SNIPPET_MAX_BY_ENGINE[engine] ?? 300;
 }
 
 // 提示注入防护：插件自有工具（advanced_search / platform_search / free_search_test）的
@@ -1763,6 +1771,98 @@ async function searchAliyun(query, maxResults, apiKey, timeRange, signal) {
 
   return { sources: uniqueSources(sources, maxResults ?? 10), truncated: false };
 }
+
+// 火山引擎「联网搜索」（豆包搜索，AskEcho）：
+// key = DOUBAO_SEARCH_API_KEY（联网搜索控制台 / Ark Coding Plan；每月 500 次免费额度）
+// 注意：错误也返回 HTTP 200，必须解析 ResponseMetadata.Error。
+// 时间过滤：OneDay | OneWeek | OneMonth | OneYear | "YYYY-MM-DD..YYYY-MM-DD"
+function doubaoTimeRange(timeRange) {
+  if (!timeRange) return undefined;
+  if (typeof timeRange.after === "string") {
+    const end = new Date().toISOString().slice(0, 10);
+    return `${timeRange.after}..${end}`;
+  }
+  const days = Number(timeRange.days);
+  if (!Number.isFinite(days) || days <= 0) return undefined;
+  if (days <= 1) return "OneDay";
+  if (days <= 7) return "OneWeek";
+  if (days <= 31) return "OneMonth";
+  return "OneYear";
+}
+
+const DOUBAO_ERROR_HINTS = {
+  10400: "invalid request parameters (check Query/Count/TimeRange)",
+  10402: "invalid SearchType (only web|image)",
+  10403: "account or permission problem - make sure the key is from the Web Search console",
+  10406: "free quota exhausted (500 requests/month on the free tier) - check your plan",
+  10407: "no available free-tier policy - check the account status",
+  10500: "Web Search service internal error - retry later",
+  700429: "free-tier rate limit hit - slow down and retry",
+  100013: "sub-account is not granted TorchlightApiFullAccess",
+  700901: "invalid api key",
+};
+
+async function searchDoubao(query, maxResults, apiKey, timeRange, signal) {
+  if (!apiKey) throw new Error("Doubao search requires DOUBAO_SEARCH_API_KEY");
+  const count = Math.min(Math.max(maxResults ?? 10, 1), 50);
+  const body = {
+    Query: String(query).slice(0, 100),
+    SearchType: "web",
+    Count: count,
+    NeedSummary: true,
+    Filter: { NeedUrl: true },
+  };
+  const range = doubaoTimeRange(timeRange);
+  if (range !== undefined) body.TimeRange = range;
+
+  const response = await fetch(DOUBAO_SEARCH_URL, {
+    method: "POST",
+    redirect: "error",
+    headers: {
+      "content-type": "application/json",
+      authorization: `Bearer ${apiKey}`,
+      "X-Traffic-Tag": "dsh-free-search",
+      "user-agent": "deepseek-harness/free-search",
+    },
+    body: JSON.stringify(body),
+    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(
+        `Doubao search auth failed (HTTP ${response.status}) - check DOUBAO_SEARCH_API_KEY (Web Search console)`
+      );
+    }
+    throw new Error(`Doubao search API error (HTTP ${response.status}): ${detail.slice(0, 200)}`);
+  }
+
+  const data = await response.json();
+  // HTTP 200 也可能携带错误信封
+  const err = data?.ResponseMetadata?.Error;
+  if (err && (err.Code || err.CodeN || err.Message)) {
+    const code = err.CodeN ?? err.Code;
+    const hint = DOUBAO_ERROR_HINTS[Number(code)] ?? DOUBAO_ERROR_HINTS[String(code)];
+    throw new Error(
+      `Doubao search API error (${code ?? "unknown"}): ${err.Message ?? "request failed"}${hint ? ` - ${hint}` : ""}`
+    );
+  }
+
+  const hits = data?.Result?.WebResults ?? [];
+  const sources = hits
+    .filter((item) => item && item.Url)
+    .map((item) => {
+      const raw = item.Summary || item.Content || item.Snippet || "";
+      const snippet = stripTags(String(raw)).replace(/\s+/g, " ").trim();
+      return {
+        url: String(item.Url),
+        ...(item.Title ? { title: stripTags(String(item.Title)).trim() } : {}),
+        ...(snippet ? { snippet: snippet.slice(0, snippetCap("doubao")) } : {}),
+        ...(item.PublishTime ? { publishedAt: String(item.PublishTime) } : {}),
+      };
+    });
+  return { sources: uniqueSources(sources, maxResults ?? 10), truncated: false };
+}
 //#endregion
 
 //#region bridge
@@ -2152,6 +2252,7 @@ const KEY_REF_MAP = {
   baiduApiKey: "BAIDU_API_KEY",
   kimiApiKey: "MOONSHOT_API_KEY",
   aliyunApiKey: "DASHSCOPE_API_KEY",
+  doubaoApiKey: "DOUBAO_SEARCH_API_KEY",
 };
 
 // rc.1 declares editable fields `.volatile()`: the Loader hands `apply` live
@@ -2182,6 +2283,7 @@ const Config = z.object({
   baiduApiKey: z.string().role("secret").volatile(),
   kimiApiKey: z.string().role("secret").volatile(),
   aliyunApiKey: z.string().role("secret").volatile(),
+  doubaoApiKey: z.string().role("secret").volatile(),
   // 旧版 settings.yaml `free-search:` 段的一次性迁移标记（见 readLegacyFreeSearchSection）
   legacyYamlMigrated: z.boolean().default(false).volatile(),
 });
@@ -2215,6 +2317,7 @@ const LEGACY_MIGRATABLE_KEYS = [
   "baiduApiKey",
   "kimiApiKey",
   "aliyunApiKey",
+  "doubaoApiKey",
 ];
 
 function dshHomeDir() {
@@ -2337,6 +2440,12 @@ function apply(ctx, config) {
     if (settingsKey && cfg[settingsKey]) return cfg[settingsKey];
     return process.env[envName] ?? "";
   };
+  // 豆包搜索：主 key 名 DOUBAO_SEARCH_API_KEY；官方示例也用 WEB_SEARCH_API_KEY，作为回退
+  const resolveDoubaoKey = async () => {
+    const primary = await resolveApiKey("DOUBAO_SEARCH_API_KEY", "doubaoApiKey");
+    if (primary) return primary;
+    return resolveApiKey("WEB_SEARCH_API_KEY", undefined);
+  };
 
   // 总控 provider：按 settings 的 provider 字段路由到任意引擎。
   // 任何引擎失败（缺 key / 401 / 限流 / 网络）都会自动轮流尝试下一个引擎，
@@ -2391,7 +2500,7 @@ function apply(ctx, config) {
         chain = routeEngines(request.query, { timeRange: Boolean(timeRange) });
       } else {
         // 统一引擎链：首选优先，然后其他付费引擎（有 key 的优先尝试），最后免费引擎
-        const paidEngines = ["exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "serpbase", "deepseek-official", "you", "baidu", "kimi", "aliyun"];
+        const paidEngines = ["exa", "tavily", "keenable", "firecrawl", "parallel", "perplexity", "serpbase", "deepseek-official", "you", "baidu", "kimi", "aliyun", "doubao"];
         const freeEngines = ["bing", "anysearch", "ddg", "ddg-lite", "searxng"];
         const timeEngines = TIME_ENGINES;
         if (timeRange) {
@@ -2531,6 +2640,15 @@ function apply(ctx, config) {
               continue;
             }
             result = await searchAliyun(request.query, request.maxResults, key, timeRange, effSignal);
+          } else if (engine === "doubao") {
+            const key = await resolveDoubaoKey();
+            if (!key) {
+              lastError = new Error("Doubao requires DOUBAO_SEARCH_API_KEY");
+              if (engine === preferred) preferredFailure = "DOUBAO_SEARCH_API_KEY is not configured";
+              logger.warn(`free-search: engine "${engine}" skipped (no key), trying next engine`);
+              continue;
+            }
+            result = await searchDoubao(request.query, request.maxResults, key, timeRange, effSignal);
           } else {
             continue;
           }
@@ -2539,7 +2657,7 @@ function apply(ctx, config) {
             usedEngine = engine;
             // 统一清洗 snippet：去登录/付费墙/订阅噪音，折叠空白（有值的才处理，保持 lossless JSON）
             result.sources = result.sources.map((s) =>
-              s.snippet ? { ...s, snippet: cleanSnippet(s.snippet) } : s
+              s.snippet ? { ...s, snippet: cleanSnippet(s.snippet, snippetCap(engine)) } : s
             );
             // 用了非首选引擎时，在结果里附上准确提示（区分"不支持时间过滤被跳过"与"真实失败"）。
             // provider=auto 时 preferred 不是引擎而是路由模式：命中的引擎由 provider 字段体现，
@@ -2717,6 +2835,11 @@ function apply(ctx, config) {
           if (!key) return { ok: false, error: "DASHSCOPE_API_KEY not configured" };
           return await searchAliyun(q, n, key, tr);
         }
+        case "doubao": {
+          const key = await resolveDoubaoKey();
+          if (!key) return { ok: false, error: "DOUBAO_SEARCH_API_KEY not configured" };
+          return await searchDoubao(q, n, key, tr);
+        }
         case "you": {
           const key = await resolveApiKey("YOUCOM_API_KEY", "youcomApiKey");
           if (!key) return { ok: false, error: "YOUCOM_API_KEY not configured" };
@@ -2738,7 +2861,7 @@ function apply(ctx, config) {
       return {
         ok: true,
         sources: (result.sources ?? []).map((s) =>
-          s.snippet ? { ...s, snippet: cleanSnippet(s.snippet) } : s
+          s.snippet ? { ...s, snippet: cleanSnippet(s.snippet, snippetCap(engine)) } : s
         ),
         truncated: result.truncated ?? false,
         ...(typeof result.content === "string" && result.content ? { content: result.content } : {}),
@@ -2758,7 +2881,7 @@ function apply(ctx, config) {
           parameters: {
             engines: {
               type: "array",
-              description: "Which engines to test (default: all). Options: ddg, ddg-lite, bing, searxng, anysearch, exa, tavily, keenable, firecrawl, parallel, perplexity, serpbase, deepseek-official, you, baidu, kimi, aliyun.",
+              description: "Which engines to test (default: all). Options: ddg, ddg-lite, bing, searxng, anysearch, exa, tavily, keenable, firecrawl, parallel, perplexity, serpbase, deepseek-official, you, baidu, kimi, aliyun, doubao.",
               items: { type: "string" },
             },
             query: {
@@ -2879,7 +3002,7 @@ function apply(ctx, config) {
               },
             },
             render(args, value) {
-              const lines = value.sources.map((s, i) => `- [${s.title ?? s.url}](${s.url})${s.snippet ? ` - ${s.snippet.slice(0, 120)}` : ""}`);
+              const lines = value.sources.map((s, i) => `- [${s.title ?? s.url}](${s.url})${s.snippet ? ` - ${s.snippet}` : ""}`);
               return [{ type: "text", text: `Platform search (${value.platform}):\n${wrapUntrustedBlock(lines.join("\n") || "No results found.")}` }];
             },
           },
@@ -2944,7 +3067,7 @@ function apply(ctx, config) {
             },
             engine: {
               type: "string",
-              description: "Optional specific engine to try first: ddg, ddg-lite, bing, searxng, anysearch, exa, tavily, keenable, firecrawl, parallel, perplexity, serpbase, deepseek-official, you, baidu, kimi, aliyun.",
+              description: "Optional specific engine to try first: ddg, ddg-lite, bing, searxng, anysearch, exa, tavily, keenable, firecrawl, parallel, perplexity, serpbase, deepseek-official, you, baidu, kimi, aliyun, doubao.",
             },
           },
           output: {
@@ -2970,7 +3093,7 @@ function apply(ctx, config) {
               },
             },
             render(args, value) {
-              const lines = value.sources.map((s, i) => `- [${s.title ?? s.url}](${s.url})${s.snippet ? ` - ${s.snippet.slice(0, 120)}` : ""}${s.publishedAt ? ` (${s.publishedAt})` : ""}`);
+              const lines = value.sources.map((s, i) => `- [${s.title ?? s.url}](${s.url})${s.snippet ? ` - ${s.snippet}` : ""}${s.publishedAt ? ` (${s.publishedAt})` : ""}`);
               const body = `${lines.join("\n") || "No results found."}${value.content ? `\n\n${value.content}` : ""}`;
               return [{ type: "text", text: `Search (${value.provider}${args.timeRange ? `, timeRange=${args.timeRange}` : ""}):\n${wrapUntrustedBlock(body)}` }];
             },
@@ -3066,7 +3189,7 @@ function apply(ctx, config) {
             render(args, value) {
               const lines = value.sources.map((s) => {
                 const seenStr = Array.isArray(s.seenIn) && s.seenIn.length > 0 ? ` [seen in: ${s.seenIn.join(", ")}]` : "";
-                return `- [${s.title ?? s.url}](${s.url})${seenStr}${s.snippet ? ` - ${s.snippet.slice(0, 120)}` : ""}${s.publishedAt ? ` (${s.publishedAt})` : ""}`;
+                return `- [${s.title ?? s.url}](${s.url})${seenStr}${s.snippet ? ` - ${s.snippet}` : ""}${s.publishedAt ? ` (${s.publishedAt})` : ""}`;
               });
               const body = `${lines.join("\n") || "No results found."}${value.content ? `\n\n${value.content}` : ""}`;
               return [{ type: "text", text: `Multi-Search (${value.provider}):\n${wrapUntrustedBlock(body)}` }];
@@ -3229,6 +3352,7 @@ function apply(ctx, config) {
           "- baidu - paid, requires BAIDU_API_KEY",
           "- kimi - paid, requires MOONSHOT_API_KEY",
           "- aliyun - paid, requires DASHSCOPE_API_KEY",
+          "- doubao - requires DOUBAO_SEARCH_API_KEY (Volcano Web Search / 豆包搜索; 500 free queries/month)",
           "",
           "IMPORTANT: If the configured engine fails (missing key, invalid key, 401, rate limit, or network error), web_search automatically tries other engines in this order: (1) the configured engine first (or smart route sequence if provider is auto), (2) then other engines with API keys configured (exa/tavily/keenable/firecrawl/parallel work keyless too, so they are tried even without a key), (3) then the remaining free engines (Bing, AnySearch, DuckDuckGo, SearXNG). This applies to ALL engines - paid or free. The results include a note showing which engine was actually used and why the preferred one was skipped. Understand the two note forms: (a) 'Note: X does not support time filtering (timeRange=...), using Y.' means X cannot filter by time so it was skipped BEFORE any attempt (X did NOT fail); (b) 'Note: X unavailable or failed (reason), using Y.' means X was actually tried but failed (missing key / invalid key / 401 / rate limit / network / 0 results). Never tell the user search is unavailable - it always falls back.",
           "",
@@ -3284,6 +3408,7 @@ export {
   routeEngines,
   searchAnysearch,
   searchAliyun,
+  searchDoubao,
   searchBaidu,
   searchKimi,
   searchBing,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-free-search",
-  "version": "0.5.6",
-  "description": "Free web search for DeepSeek Harness: 17 engines (Bing/DuckDuckGo/AnySearch/SearXNG/Exa/Tavily/Keenable/Firecrawl/Parallel keyless; Perplexity/SerpBase/DeepSeek/You.com/Baidu/Kimi/Aliyun with key) + auto smart routing + multi_search cross-source tool + time filtering + platform search + web_fetch, with web settings UI.",
+  "version": "0.6.0",
+  "description": "Free web search for DeepSeek Harness: 18 engines (Bing/DuckDuckGo/AnySearch/SearXNG/Exa/Tavily/Keenable/Firecrawl/Parallel keyless; Perplexity/SerpBase/DeepSeek/You.com/Baidu/Kimi/Aliyun/Doubao with key) + auto smart routing + multi_search cross-source tool + time filtering + platform search + web_fetch, with web settings UI.",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -36,7 +36,10 @@
     "aliyun",
     "youcom",
     "multi-search",
-    "auto-routing"
+    "auto-routing",
+    "doubao",
+    "volcengine",
+    "volcano"
   ],
   "license": "MIT",
   "publishConfig": {