@konbakuyomu/smart-search-linux-x64 0.1.28 → 0.1.30-beta.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@konbakuyomu/smart-search-linux-x64",
-  "version": "0.1.28",
+  "version": "0.1.30-beta.1",
   "description": "Self-contained Smart Search CLI for linux/x64",
   "license": "MIT",
   "repository": {

package/runtime/smart-search/_internal/certifi/cacert.pem

@@ -2005,29 +2005,6 @@ RQuQ+q7hv53yrlc8pa6yVvSLZUDp/TGBLPQ5Cdjua6e0ph0VpZj3AYHYhX3zUVxx
 iN66zB+Afko=
 -----END CERTIFICATE-----
 
-# Issuer: CN=emSign ECC Root CA - G3 O=eMudhra Technologies Limited OU=emSign PKI
-# Subject: CN=emSign ECC Root CA - G3 O=eMudhra Technologies Limited OU=emSign PKI
-# Label: "emSign ECC Root CA - G3"
-# Serial: 287880440101571086945156
-# MD5 Fingerprint: ce:0b:72:d1:9f:88:8e:d0:50:03:e8:e3:b8:8b:67:40
-# SHA1 Fingerprint: 30:43:fa:4f:f2:57:dc:a0:c3:80:ee:2e:58:ea:78:b2:3f:e6:bb:c1
-# SHA256 Fingerprint: 86:a1:ec:ba:08:9c:4a:8d:3b:be:27:34:c6:12:ba:34:1d:81:3e:04:3c:f9:e8:a8:62:cd:5c:57:a3:6b:be:6b
------BEGIN CERTIFICATE-----
-MIICTjCCAdOgAwIBAgIKPPYHqWhwDtqLhDAKBggqhkjOPQQDAzBrMQswCQYDVQQG
-EwJJTjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNo
-bm9sb2dpZXMgTGltaXRlZDEgMB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0g
-RzMwHhcNMTgwMjE4MTgzMDAwWhcNNDMwMjE4MTgzMDAwWjBrMQswCQYDVQQGEwJJ
-TjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNobm9s
-b2dpZXMgTGltaXRlZDEgMB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0gRzMw
-djAQBgcqhkjOPQIBBgUrgQQAIgNiAAQjpQy4LRL1KPOxst3iAhKAnjlfSU2fySU0
-WXTsuwYc58Byr+iuL+FBVIcUqEqy6HyC5ltqtdyzdc6LBtCGI79G1Y4PPwT01xyS
-fvalY8L1X44uT6EYGQIrMgqCZH0Wk9GjQjBAMB0GA1UdDgQWBBR8XQKEE9TMipuB
-zhccLikenEhjQjAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAKBggq
-hkjOPQQDAwNpADBmAjEAvvNhzwIQHWSVB7gYboiFBS+DCBeQyh+KTOgNG3qxrdWB
-CUfvO6wIBHxcmbHtRwfSAjEAnbpV/KlK6O3t5nYBQnvI+GDZjVGLVTv7jHvrZQnD
-+JbNR6iC8hZVdyR+EhCVBCyj
------END CERTIFICATE-----
-
 # Issuer: CN=emSign Root CA - C1 O=eMudhra Inc OU=emSign PKI
 # Subject: CN=emSign Root CA - C1 O=eMudhra Inc OU=emSign PKI
 # Label: "emSign Root CA - C1"

package/runtime/smart-search/_internal/smart_search/assets/i18n/messages.json

@@ -17858,5 +17858,169 @@
   "{0} 另外，联网搜索能力检查未通过：{1}。OpenAI-compatible 不会发送搜索工具；如果该模型只能通过 Responses 的 web_search 工具联网，请把 XAI_API_URL、XAI_API_KEY、XAI_MODEL 指向支持 /v1/responses 的中转站。": [
     "{0} 另外，联网搜索能力检查未通过：{1}。OpenAI-compatible 不会发送搜索工具；如果该模型只能通过 Responses 的 web_search 工具联网，请把 XAI_API_URL、XAI_API_KEY、XAI_MODEL 指向支持 /v1/responses 的中转站。",
     "{0} Also, the web search capability check did not pass: {1}. OpenAI-compatible sends no search tool; if this model can only search through the Responses web_search tool, point XAI_API_URL, XAI_API_KEY and XAI_MODEL at a relay that supports /v1/responses."
+  ],
+  "DeepSeek search response is not a JSON object": [
+    "DeepSeek 搜索响应不是 JSON 对象",
+    "DeepSeek search response is not a JSON object"
+  ],
+  "DeepSeek search response is missing results": [
+    "DeepSeek 搜索响应缺少 results",
+    "DeepSeek search response is missing results"
+  ],
+  "DeepSeek fetch response is not a JSON object": [
+    "DeepSeek 抓取响应不是 JSON 对象",
+    "DeepSeek fetch response is not a JSON object"
+  ],
+  "DeepSeek fetch content is not text": [
+    "DeepSeek 抓取内容不是文本",
+    "DeepSeek fetch content is not text"
+  ],
+  "DeepSeek search: {0}": [
+    "DeepSeek 搜索：{0}",
+    "DeepSeek search: {0}"
+  ],
+  "DeepSeek fetch: {0}": [
+    "DeepSeek 抓取：{0}",
+    "DeepSeek fetch: {0}"
+  ],
+  "DeepSeek fetch returned no content for {0}": [
+    "DeepSeek 抓取 {0} 没有返回正文",
+    "DeepSeek fetch returned no content for {0}"
+  ],
+  "DEEPSEEK_API_KEY is not set. DeepSeek search and fetch are unavailable.": [
+    "DEEPSEEK_API_KEY 未设置，DeepSeek 搜索与抓取不可用",
+    "DEEPSEEK_API_KEY is not set. DeepSeek search and fetch are unavailable."
+  ],
+  "DEEPSEEK_API_KEY 未设置，DeepSeek 搜索与抓取不可用": [
+    "DEEPSEEK_API_KEY 未设置，DeepSeek 搜索与抓取不可用",
+    "DEEPSEEK_API_KEY is not set. DeepSeek search and fetch are unavailable."
+  ],
+  "Both DeepSeek search and fetch APIs are available": [
+    "DeepSeek 搜索与抓取 API 均可用",
+    "Both DeepSeek search and fetch APIs are available"
+  ],
+  "DeepSeek 搜索与抓取 API 均可用": [
+    "DeepSeek 搜索与抓取 API 均可用",
+    "Both DeepSeek search and fetch APIs are available"
+  ],
+  "DeepSeek API request timed out": [
+    "DeepSeek API 请求超时",
+    "DeepSeek API request timed out"
+  ],
+  "DeepSeek API 请求超时": [
+    "DeepSeek API 请求超时",
+    "DeepSeek API request timed out"
+  ],
+  "Save DEEPSEEK_API_KEY.": [
+    "保存 DEEPSEEK_API_KEY。",
+    "Save DEEPSEEK_API_KEY."
+  ],
+  "Save DEEPSEEK_API_URL.": [
+    "保存 DEEPSEEK_API_URL。",
+    "Save DEEPSEEK_API_URL."
+  ],
+  "Save DEEPSEEK_TIMEOUT_SECONDS.": [
+    "保存 DEEPSEEK_TIMEOUT_SECONDS。",
+    "Save DEEPSEEK_TIMEOUT_SECONDS."
+  ],
+  "没有找到 WSL 发行版。": [
+    "没有找到 WSL 发行版。",
+    "No WSL distribution was found."
+  ],
+  "没有在 WSL 中找到 smart-search。请先在 WSL 中安装 CLI，并确认 bash 能直接运行 smart-search。": [
+    "没有在 WSL 中找到 smart-search。请先在 WSL 中安装 CLI，并确认 bash 能直接运行 smart-search。",
+    "smart-search was not found in WSL. Install the CLI in WSL first and make sure bash can run smart-search directly."
+  ],
+  "旧版": [
+    "旧版",
+    "old version"
+  ],
+  "当前连接的是 WSL 中的 CLI，只观察它自己的配置目录。": [
+    "当前连接的是 WSL 中的 CLI，只观察它自己的配置目录。",
+    "Connected to a CLI in WSL; only its own configuration directory is observed."
+  ],
+  "这是 WSL 中的目录。需要更换时，在 WSL 中设置 SMART_SEARCH_CONFIG_DIR。": [
+    "这是 WSL 中的目录。需要更换时，在 WSL 中设置 SMART_SEARCH_CONFIG_DIR。",
+    "This directory is inside WSL. To use another one, set SMART_SEARCH_CONFIG_DIR in WSL."
+  ],
+  "WSL 中的 CLI 使用该发行版自己的配置和 Skills。未运行的发行版不会自动启动。": [
+    "WSL 中的 CLI 使用该发行版自己的配置和 Skills。未运行的发行版不会自动启动。",
+    "A CLI in WSL uses that distribution's own configuration and Skills. Stopped distributions are not started automatically."
+  ],
+  "未运行：{0}。“检测 WSL”会启动这些发行版并查找 CLI。": [
+    "未运行：{0}。“检测 WSL”会启动这些发行版并查找 CLI。",
+    "Not running: {0}. Detect WSL starts them to look for the CLI."
+  ],
+  "检测 WSL": [
+    "检测 WSL",
+    "Detect WSL"
+  ],
+  "{0} · 需要更新": [
+    "{0} · 需要更新",
+    "{0} · update needed"
+  ],
+  "位于 WSL {0}，使用该发行版中的配置和 Skills。": [
+    "位于 WSL {0}，使用该发行版中的配置和 Skills。",
+    "Installed in WSL {0}; it uses that distribution's configuration and Skills."
+  ],
+  "WSL {0} 中的 CLI 版本过旧，App 无法连接。": [
+    "WSL {0} 中的 CLI 版本过旧，App 无法连接。",
+    "The CLI in WSL {0} is too old for the App to connect."
+  ],
+  "此 CLI 由 mise 管理，请在 WSL 终端更新：mise use -g npm:@konbakuyomu/smart-search@latest": [
+    "此 CLI 由 mise 管理，请在 WSL 终端更新：mise use -g npm:@konbakuyomu/smart-search@latest",
+    "mise manages this CLI. Update it from a WSL terminal: mise use -g npm:@konbakuyomu/smart-search@latest"
+  ],
+  "npm 全局目录需要管理员权限，请在 WSL 终端更新：sudo npm install -g @konbakuyomu/smart-search@latest": [
+    "npm 全局目录需要管理员权限，请在 WSL 终端更新：sudo npm install -g @konbakuyomu/smart-search@latest",
+    "Its npm global directory needs administrator rights. Update it from a WSL terminal: sudo npm install -g @konbakuyomu/smart-search@latest"
+  ],
+  "App 无法确定它的安装方式，请在 WSL 终端用原安装方式更新。": [
+    "App 无法确定它的安装方式，请在 WSL 终端用原安装方式更新。",
+    "The App cannot tell how it was installed. Update it from a WSL terminal with the tool you installed it with."
+  ],
+  "WSL {0} 的 npm 全局目录需要管理员权限，App 不使用 sudo。请在 WSL 终端运行：sudo npm install -g @konbakuyomu/smart-search@latest": [
+    "WSL {0} 的 npm 全局目录需要管理员权限，App 不使用 sudo。请在 WSL 终端运行：sudo npm install -g @konbakuyomu/smart-search@latest",
+    "The npm global directory in WSL {0} needs administrator rights, and the App does not use sudo. In a WSL terminal, run: sudo npm install -g @konbakuyomu/smart-search@latest"
+  ],
+  "WSL {0} 中的 Node.js 没有配套的 npm。请重新安装 Node.js，再点击“检测 WSL”。": [
+    "WSL {0} 中的 Node.js 没有配套的 npm。请重新安装 Node.js，再点击“检测 WSL”。",
+    "Node.js in WSL {0} has no matching npm. Reinstall Node.js, then click Detect WSL."
+  ],
+  "WSL {0} 中没有找到 Node.js 18 或更新版本。请先在 WSL 中安装 Node.js，再点击“检测 WSL”。": [
+    "WSL {0} 中没有找到 Node.js 18 或更新版本。请先在 WSL 中安装 Node.js，再点击“检测 WSL”。",
+    "No Node.js 18 or later was found in WSL {0}. Install Node.js in WSL, then click Detect WSL."
+  ],
+  "{0} 中的 CLI 已安装或更新为 {1}。": [
+    "{0} 中的 CLI 已安装或更新为 {1}。",
+    "The CLI in {0} is now {1}."
+  ],
+  "更新 {0} 中的 CLI": [
+    "更新 {0} 中的 CLI",
+    "Update the CLI in {0}"
+  ],
+  "这些环境还没有 Smart Search CLI。安装使用该环境自己的 npm，不会改动其他环境。": [
+    "这些环境还没有 Smart Search CLI。安装使用该环境自己的 npm，不会改动其他环境。",
+    "These environments have no Smart Search CLI yet. Installing uses that environment's own npm and leaves the others unchanged."
+  ],
+  "安装到 {0}": [
+    "安装到 {0}",
+    "Install in {0}"
+  ],
+  "在 WSL 中安装 Node.js": [
+    "在 WSL 中安装 Node.js",
+    "Install Node.js in WSL"
+  ],
+  "未安装 CLI 的环境": [
+    "未安装 CLI 的环境",
+    "Environments without the CLI"
+  ],
+  "WSL {0} · npm {1} · {2}": [
+    "WSL {0} · npm {1} · {2}",
+    "WSL {0} · npm {1} · {2}"
+  ],
+  "正在卸载 CLI…": [
+    "正在卸载 CLI…",
+    "Removing the CLI…"
   ]
 }

package/runtime/smart-search/_internal/smart_search/assets/skills/smart-search-cli/references/cli-core.md

@@ -48,7 +48,7 @@
 - `smart-search map URL [--instructions TEXT] [--max-depth N] [--max-breadth N] [--limit N] [--timeout SECONDS] [--format json|markdown|content] [--output PATH]`
 - `smart-search doctor [--format json|markdown|content] [--output PATH]`
 - `smart-search diagnose openai-compatible [--timeout SECONDS] [--format json|markdown] [--output PATH]`
-- `smart-search setup [--lang zh|en] [--advanced] [--non-interactive] [--skip-skills] [--install-skills CSV] [--skills-root PATH] [--xai-api-url URL] [--xai-api-key KEY] [--xai-model ID] [--xai-tools-explicit CSV] [--openai-compatible-api-url URL] [--openai-compatible-api-key KEY] [--openai-compatible-model ID] [--openai-compatible-fallback-models CSV] [--openai-compatible-api-mode chat-completions|responses] [--openai-compatible-stream true|false] [--validation-level fast|balanced|strict] [--fallback-mode auto|off] [--minimum-profile standard|off] [--intent-router jev|local] [--search-timeout SECONDS] [--provider-cooldown SECONDS] [--provider-failure-threshold N] [--exa-key KEY] [--context7-key KEY] [--zhipu-key KEY] [--zhipu-api-url URL] [--zhipu-search-engine ENGINE] [--zhipu-mcp-key KEY] [--zhipu-mcp-search-api-url URL] [--zhipu-mcp-reader-api-url URL] [--zhipu-mcp-zread-api-url URL] [--zhipu-mcp-timeout SECONDS] [--jina-key KEY] [--jina-reader-api-url URL] [--jina-respond-with MODE] [--jina-timeout SECONDS] [--tavily-api-url URL] [--tavily-key KEY] [--firecrawl-api-url URL] [--firecrawl-key KEY] [--tinyfish-key KEY] [--tinyfish-search-api-url URL] [--tinyfish-fetch-api-url URL] [--tinyfish-timeout SECONDS] [--anysearch-api-url URL] [--anysearch-key KEY] [--anysearch-timeout SECONDS] [--sciverse-api-url URL] [--sciverse-token TOKEN] [--sciverse-timeout SECONDS] [--format json|markdown|content] [--output PATH]`
+- `smart-search setup [--lang zh|en] [--advanced] [--non-interactive] [--skip-skills] [--install-skills CSV] [--skills-root PATH] [--xai-api-url URL] [--xai-api-key KEY] [--xai-model ID] [--xai-tools-explicit CSV] [--openai-compatible-api-url URL] [--openai-compatible-api-key KEY] [--openai-compatible-model ID] [--openai-compatible-fallback-models CSV] [--openai-compatible-api-mode chat-completions|responses] [--openai-compatible-stream true|false] [--validation-level fast|balanced|strict] [--fallback-mode auto|off] [--minimum-profile standard|off] [--intent-router jev|local] [--search-timeout SECONDS] [--provider-cooldown SECONDS] [--provider-failure-threshold N] [--exa-key KEY] [--context7-key KEY] [--zhipu-key KEY] [--zhipu-api-url URL] [--zhipu-search-engine ENGINE] [--zhipu-mcp-key KEY] [--zhipu-mcp-search-api-url URL] [--zhipu-mcp-reader-api-url URL] [--zhipu-mcp-zread-api-url URL] [--zhipu-mcp-timeout SECONDS] [--jina-key KEY] [--jina-reader-api-url URL] [--jina-respond-with MODE] [--jina-timeout SECONDS] [--tavily-api-url URL] [--tavily-key KEY] [--firecrawl-api-url URL] [--firecrawl-key KEY] [--tinyfish-key KEY] [--tinyfish-search-api-url URL] [--tinyfish-fetch-api-url URL] [--tinyfish-timeout SECONDS] [--deepseek-key KEY] [--deepseek-api-url URL] [--deepseek-timeout SECONDS] [--anysearch-api-url URL] [--anysearch-key KEY] [--anysearch-timeout SECONDS] [--sciverse-api-url URL] [--sciverse-token TOKEN] [--sciverse-timeout SECONDS] [--format json|markdown|content] [--output PATH]`
 - `smart-search config path|list|set|unset ... [--format json|markdown|content] [--output PATH]`
 - `smart-search model set MODEL [--format json|markdown|content] [--output PATH]`
 - `smart-search model current [--format json|markdown|content] [--output PATH]`

package/runtime/smart-search/_internal/smart_search/assets/skills/smart-search-cli/references/command-patterns.md

@@ -96,6 +96,8 @@ smart-search config set FIRECRAWL_API_URL "https://api.firecrawl.dev/v2" --forma
 smart-search config set TINYFISH_API_KEY "key" --format json
 smart-search config set TINYFISH_SEARCH_API_URL "https://api.search.tinyfish.ai" --format json
 smart-search config set TINYFISH_FETCH_API_URL "https://api.fetch.tinyfish.ai" --format json
+smart-search config set DEEPSEEK_API_KEY "key" --format json
+smart-search config set DEEPSEEK_API_URL "https://api.deepseek.com" --format json
 smart-search model current --format json
 smart-search doctor --format json
 smart-search doctor --format markdown

package/runtime/smart-search/_internal/smart_search/assets/skills/smart-search-cli/references/provider-routing.md

@@ -32,11 +32,11 @@ For research, `SMART_SEARCH_JEV_SYNTHESIZE` accepts `true`, `false`, and `auto`.
 - Jina Reader is `web_fetch` only, not a general search provider. `JINA_API_KEY` is required before Jina satisfies the standard minimum profile; anonymous `r.jina.ai` is explicit/experimental fetch behavior.
 - Same-capability fallback is allowed; model answers and web search are mutual fallbacks in ordinary search. Context7 is not used for unrelated broad web queries, and page extraction providers are not used as docs search providers.
 - `TAVILY_ENABLED=false` removes Tavily from registered `web_search` and `web_fetch` routes even when its key is present. Direct Tavily search/extract calls, `map`, `doctor`, and smoke must make no Tavily network request; `map` reports a local configuration error. Firecrawl remains independently configured and all fallback stays within its capability.
-- In Jev mode, Jev chooses among allowed capabilities and providers for the question; there is no mandatory main-model call or fixed global provider order. Local routing prioritizes suitable capabilities and configured preferences.
-- `main_search` contains xAI Responses and OpenAI-compatible model channels; `web_search` contains Zhipu REST/MCP, Tavily, Firecrawl and TinyFish; `docs_search` contains Context7 and Exa. Failure fallback stays within the selected capability family; model answers and web search are mutual fallbacks in ordinary search.
+- In Jev mode, Jev chooses among allowed capabilities and providers for the question; there is no mandatory main-model call or fixed global provider order. Local routing prioritizes suitable capabilities and configured preferences; a docs question with no docs channel configured uses web search instead of no channel.
+- `main_search` contains xAI Responses and OpenAI-compatible model channels; `web_search` contains Zhipu REST/MCP, Tavily, Firecrawl, TinyFish and DeepSeek; `docs_search` contains Context7 and Exa. Failure fallback stays within the selected capability family; model answers and web search are mutual fallbacks in ordinary search.
 - Ordinary Context7 uses the first library in Context7's ranked candidates, without a second Jev call. Research may use Jev to select the matching library, using the first candidate if Jev fails or no score reaches its threshold. Empty results may fall through to same-capability Exa; explicit Context7 commands remain unchanged.
 - `--extra-sources N` controls the selected channel's result count. It does not add channels, split a budget between providers, or make Tavily/Firecrawl a required extra stage. A known-URL search follows the configured Jev/local routing; local routing prefers page reading.
-- `fetch` tries Tavily first, then Jina with `JINA_API_KEY`, then Zhipu Coding Plan MCP Reader, then Firecrawl, then TinyFish.
+- `fetch` tries Tavily first, then Jina with `JINA_API_KEY`, then Zhipu Coding Plan MCP Reader, then Firecrawl, then TinyFish, then DeepSeek.
 
 TinyFish:
 
@@ -47,6 +47,14 @@ TinyFish:
 - Fetch reads `results[0].text`; `errors[]` entries are surfaced as `provider_error` with the upstream message. A payload with neither results nor errors is `provider_error`, and a non-object payload is `parse_error`.
 - Challenge pages such as `Checking if the site connection is secure` are reported as `quality_error` so same-capability fallback can continue.
 - `401`/403 map to `auth_error`, `408` to `timeout`, `429` to `rate_limited`, `5xx` to `network_error`, and `400`/422 to `parameter_error`.
+DeepSeek:
+
+- `DEEPSEEK_API_KEY` is optional and registers DeepSeek for both `web_search` and `web_fetch`; it is the same key as the DeepSeek model API. It never satisfies `main_search` or `docs_search`. Jev may select it directly; the direct `fetch` fallback order remains as listed above.
+- `DEEPSEEK_API_URL` defaults to `https://api.deepseek.com`; search calls `POST /v1/tools/search` with `{"query", "count"}` and fetch calls `POST /v1/tools/fetch` with `{"url"}`, both with `Authorization: Bearer`. A trailing `/v1` in the base URL is accepted. Never log or echo the key.
+- DeepSeek accepts queries of at most 128 characters, so longer queries are shortened at a word boundary. `site:`, `-site:`, `lang:`, `after:`/`before:` and quoted phrases in the query pass through unchanged.
+- Search results normalize `summary` (falling back to `snippet`) to `description`, `site_name` to `source`, and `date` to `published_date`. Summaries are not page text: fetch a key page before citing it. An empty result set is a successful empty response.
+- Fetch returns the page Markdown. HTTP 403 (URL refused by DeepSeek's safety policy) and 404 (no usable page content, which currently includes PDF links and private network addresses) mean that page has nothing to read: the attempt is `empty`, fallback continues, and the provider is not cooled down. `401` maps to `auth_error`, `402` (insufficient balance) to `provider_error`, `429` to `rate_limited`, `5xx` to `network_error`.
+- DeepSeek bills each successful search or fetch request. `doctor` and `providers test deepseek` send one real request to each.
 - `map` currently uses Tavily only.
 - `exa-search` and `exa-similar` use Exa only.
 - `context7-library` and `context7-docs` use Context7 only.

package/runtime/smart-search/_internal/smart_search/assets/skills/smart-search-cli/references/setup-config.md

@@ -98,6 +98,8 @@
 - Use `smart-search setup --non-interactive --tinyfish-key "key"` to add TinyFish to `web_search` and `web_fetch`. It never satisfies `main_search` or `docs_search`; Jev can select it among the allowed channels.
 - `TINYFISH_SEARCH_API_URL` defaults to `https://api.search.tinyfish.ai`, and `TINYFISH_FETCH_API_URL` defaults to `https://api.fetch.tinyfish.ai`. Both authenticate with the `X-API-Key` header, not a bearer token.
 - `TINYFISH_TIMEOUT_SECONDS` defaults to `60` and covers both TinyFish search and fetch reads.
+- Use `smart-search setup --non-interactive --deepseek-key "key"` to add DeepSeek to `web_search` and `web_fetch` with the same key as the DeepSeek model API. It never satisfies `main_search` or `docs_search`; Jev can select it among the allowed channels.
+- `DEEPSEEK_API_URL` defaults to `https://api.deepseek.com`, and `DEEPSEEK_TIMEOUT_SECONDS` defaults to `60` and covers both DeepSeek search and fetch reads. Each successful DeepSeek request is billed.
 
 ## Provider Failure Cooldown
 

package/runtime/smart-search/_internal/smart_search/assets/ui/index.html

@@ -691,7 +691,7 @@ details.more[open] > summary::before { content: "▾ "; }
     { capability: "docs_search", title: "stepDocs",
       providers: ["context7", "exa"] },
     { capability: "web_fetch", title: "stepFetch",
-      providers: ["tavily", "jina", "zhipu-mcp-reader", "zhipu-mcp", "firecrawl"] }
+      providers: ["tavily", "jina", "zhipu-mcp-reader", "zhipu-mcp", "firecrawl", "deepseek"] }
   ];
 
   function viewGettingStarted() {

package/runtime/smart-search/_internal/smart_search/cli.py

@@ -627,6 +627,7 @@ def _format_doctor_markdown(data: dict[str, Any]) -> str:
         ("jina", data.get("jina_connection_test") or {}),
         ("firecrawl", data.get("firecrawl_connection_test") or {}),
         ("tinyfish", data.get("tinyfish_connection_test") or {}),
+        ("deepseek", data.get("deepseek_connection_test") or {}),
         ("zhipu", data.get("zhipu_connection_test") or {}),
         ("zhipu-mcp", data.get("zhipu_mcp_connection_test") or {}),
         ("context7", data.get("context7_connection_test") or {}),
@@ -1478,6 +1479,7 @@ def _display_provider(provider: str, lang: str) -> str:
         "tavily": "Tavily",
         "firecrawl": "Firecrawl",
         "tinyfish": "TinyFish",
+        "deepseek": "DeepSeek",
         "anysearch": "AnySearch",
         "sciverse": "Sciverse",
     }
@@ -2078,7 +2080,7 @@ def _prompt_web_fetch(values: dict[str, str], current: dict[str, str], lang: str
             "选择 web_fetch provider",
             "Choose web_fetch providers",
         ),
-        ["tavily", "jina", "firecrawl", "tinyfish"],
+        ["tavily", "jina", "firecrawl", "tinyfish", "deepseek"],
         default_selected,
         lang,
     )
@@ -2110,6 +2112,13 @@ def _prompt_web_fetch(values: dict[str, str], current: dict[str, str], lang: str
             current.get("TINYFISH_API_KEY", ""),
             lang=lang,
         )
+    if "deepseek" in selected:
+        values["DEEPSEEK_API_KEY"] = _prompt_value(
+            "DEEPSEEK_API_KEY",
+            "DeepSeek API key",
+            current.get("DEEPSEEK_API_KEY", ""),
+            lang=lang,
+        )
 
 
 def _prompt_optional_enhancements(values: dict[str, str], current: dict[str, str], lang: str) -> None:
@@ -2347,6 +2356,9 @@ def _run_advanced_setup_prompts(values: dict[str, str], current: dict[str, str],
         ("TINYFISH_SEARCH_API_URL", "TinyFish Search API URL", True),
         ("TINYFISH_FETCH_API_URL", "TinyFish Fetch API URL", True),
         ("TINYFISH_TIMEOUT_SECONDS", "TinyFish timeout seconds", True),
+        ("DEEPSEEK_API_KEY", "DeepSeek API key", True),
+        ("DEEPSEEK_API_URL", "DeepSeek API URL", True),
+        ("DEEPSEEK_TIMEOUT_SECONDS", "DeepSeek timeout seconds", True),
         ("ANYSEARCH_API_URL", "AnySearch MCP API URL", True),
         ("ANYSEARCH_API_KEY", "AnySearch API key", True),
         ("ANYSEARCH_TIMEOUT_SECONDS", "AnySearch timeout seconds", True),
@@ -2370,7 +2382,7 @@ def _run_advanced_setup_prompts(values: dict[str, str], current: dict[str, str],
             value = _normalize_custom_base_url(value)
         elif key == "SCIVERSE_API_URL":
             value = _normalize_custom_base_url(value)
-        elif key in {"TINYFISH_SEARCH_API_URL", "TINYFISH_FETCH_API_URL"}:
+        elif key in {"TINYFISH_SEARCH_API_URL", "TINYFISH_FETCH_API_URL", "DEEPSEEK_API_URL"}:
             value = _normalize_custom_base_url(value)
         values[key] = value
 
@@ -2775,6 +2787,9 @@ def _run_setup(args: argparse.Namespace) -> int:
         "TINYFISH_SEARCH_API_URL": _normalize_custom_base_url(args.tinyfish_search_api_url),
         "TINYFISH_FETCH_API_URL": _normalize_custom_base_url(args.tinyfish_fetch_api_url),
         "TINYFISH_TIMEOUT_SECONDS": args.tinyfish_timeout,
+        "DEEPSEEK_API_KEY": args.deepseek_key,
+        "DEEPSEEK_API_URL": _normalize_custom_base_url(args.deepseek_api_url),
+        "DEEPSEEK_TIMEOUT_SECONDS": args.deepseek_timeout,
         "ANYSEARCH_API_URL": _normalize_custom_base_url(args.anysearch_api_url),
         "ANYSEARCH_API_KEY": args.anysearch_key,
         "ANYSEARCH_TIMEOUT_SECONDS": args.anysearch_timeout,
@@ -2885,6 +2900,7 @@ def _run_regression() -> int:
         "tests/test_jina_provider.py",
         "tests/test_tinyfish_provider.py",
         "tests/test_tinyfish_service.py",
+        "tests/test_deepseek_provider.py",
         "tests/test_zhipu_mcp_provider.py",
         "tests/test_smoke.py",
         "tests/test_intent_router.py",
@@ -3484,6 +3500,9 @@ def build_parser() -> argparse.ArgumentParser:
     setup_parser.add_argument("--tinyfish-search-api-url", default="", help="Save TINYFISH_SEARCH_API_URL.")
     setup_parser.add_argument("--tinyfish-fetch-api-url", default="", help="Save TINYFISH_FETCH_API_URL.")
     setup_parser.add_argument("--tinyfish-timeout", default="", help="Save TINYFISH_TIMEOUT_SECONDS.")
+    setup_parser.add_argument("--deepseek-key", default="", help="Save DEEPSEEK_API_KEY.")
+    setup_parser.add_argument("--deepseek-api-url", default="", help="Save DEEPSEEK_API_URL.")
+    setup_parser.add_argument("--deepseek-timeout", default="", help="Save DEEPSEEK_TIMEOUT_SECONDS.")
     setup_parser.add_argument("--anysearch-api-url", default="", help="Save ANYSEARCH_API_URL.")
     setup_parser.add_argument("--anysearch-key", default="", help="Save ANYSEARCH_API_KEY.")
     setup_parser.add_argument("--anysearch-timeout", default="", help="Save ANYSEARCH_TIMEOUT_SECONDS.")
@@ -3562,6 +3581,18 @@ def _main(argv: list[str] | None = None) -> int:
         return EXIT_RUNTIME_ERROR
 
 
+def _desktop_launch_command() -> list[str]:
+    """Argv that starts this same CLI without a shell, e.g. inside WSL from the Windows App."""
+    package_root = os.environ.get("SMART_SEARCH_PACKAGE_ROOT", "")
+    node = os.environ.get("SMART_SEARCH_NODE_PATH", "")
+    wrapper = Path(package_root) / "npm" / "bin" / "smart-search.js"
+    if package_root and node and wrapper.is_file():
+        return [node, str(wrapper)]
+    if getattr(sys, "frozen", False):
+        return [sys.executable]
+    return [sys.executable, "-m", "smart_search.cli"]
+
+
 def main(argv: list[str] | None = None) -> int:
     arguments = list(sys.argv[1:] if argv is None else argv)
     if arguments == ["--desktop-backend"]:
@@ -3569,7 +3600,8 @@ def main(argv: list[str] | None = None) -> int:
         return desktop_main()
     if arguments == ["--desktop-capabilities"]:
         print(json.dumps({"product": "smart-search", "version": _get_version(), "activity_protocol_version": 1,
-                          "desktop_protocol_version": 1, "skills_protocol_version": 1}))
+                          "desktop_protocol_version": 1, "skills_protocol_version": 1,
+                          "launch_command": _desktop_launch_command()}))
         return EXIT_OK
     try:
         arguments, language, warning = _command_language(arguments)

package/runtime/smart-search/_internal/smart_search/config.py

@@ -58,6 +58,7 @@ class Config:
         "tavily": "TAVILY_ENABLED",
         "firecrawl": "FIRECRAWL_ENABLED",
         "tinyfish": "TINYFISH_ENABLED",
+        "deepseek": "DEEPSEEK_ENABLED",
         "jina": "JINA_ENABLED",
         "anysearch": "ANYSEARCH_ENABLED",
         "sciverse": "SCIVERSE_ENABLED",
@@ -122,6 +123,9 @@ class Config:
         "TINYFISH_SEARCH_API_URL",
         "TINYFISH_FETCH_API_URL",
         "TINYFISH_TIMEOUT_SECONDS",
+        "DEEPSEEK_API_KEY",
+        "DEEPSEEK_API_URL",
+        "DEEPSEEK_TIMEOUT_SECONDS",
         "ANYSEARCH_API_KEY",
         "ANYSEARCH_API_URL",
         "ANYSEARCH_TIMEOUT_SECONDS",
@@ -712,7 +716,7 @@ class Config:
         if key in JEV_DEFAULTS:
             validate_jev_value(key, value)
             return
-        if key in {"SMART_SEARCH_TIMEOUT_SECONDS", "TINYFISH_TIMEOUT_SECONDS"}:
+        if key in {"SMART_SEARCH_TIMEOUT_SECONDS", "TINYFISH_TIMEOUT_SECONDS", "DEEPSEEK_TIMEOUT_SECONDS"}:
             self._parse_positive_float_value(key, value)
             return
         if key == "SMART_SEARCH_PROVIDER_COOLDOWN_SECONDS":
@@ -970,6 +974,18 @@ class Config:
     def tinyfish_timeout(self) -> float:
         return self._parse_positive_float_value("TINYFISH_TIMEOUT_SECONDS", self._get_config_value("TINYFISH_TIMEOUT_SECONDS", "150") or "150")
 
+    @property
+    def deepseek_api_key(self) -> str | None:
+        return self._get_config_value("DEEPSEEK_API_KEY")
+
+    @property
+    def deepseek_api_url(self) -> str:
+        return self._get_config_value("DEEPSEEK_API_URL", "https://api.deepseek.com") or "https://api.deepseek.com"
+
+    @property
+    def deepseek_timeout(self) -> float:
+        return self._parse_positive_float_value("DEEPSEEK_TIMEOUT_SECONDS", self._get_config_value("DEEPSEEK_TIMEOUT_SECONDS", "60") or "60")
+
     @property
     def anysearch_api_url(self) -> str:
         return self._get_config_value("ANYSEARCH_API_URL", "https://api.anysearch.com/mcp") or "https://api.anysearch.com/mcp"
@@ -1253,6 +1269,9 @@ class Config:
             "TINYFISH_FETCH_API_URL": self.tinyfish_fetch_api_url,
             "TINYFISH_API_KEY": self._mask_api_key(self.tinyfish_api_key) if self.tinyfish_api_key else tr('未配置'),
             "TINYFISH_TIMEOUT_SECONDS": self.tinyfish_timeout,
+            "DEEPSEEK_API_URL": self.deepseek_api_url,
+            "DEEPSEEK_API_KEY": self._mask_api_key(self.deepseek_api_key) if self.deepseek_api_key else tr('未配置'),
+            "DEEPSEEK_TIMEOUT_SECONDS": self.deepseek_timeout,
             "ANYSEARCH_API_URL": self.anysearch_api_url,
             "ANYSEARCH_API_KEY": self._mask_api_key(self.anysearch_api_key) if self.anysearch_api_key else tr('未配置'),
             "ANYSEARCH_TIMEOUT_SECONDS": self.anysearch_timeout,

package/runtime/smart-search/_internal/smart_search/jev_search.py

@@ -89,9 +89,13 @@ def fallback_channels(svc: Any, query: str, candidates: list[dict], limit: int,
         if reading:
             order = svc._research_fetch_order(query, reading[0]["url"])
             return sorted(reading, key=lambda item: order.index(item["provider"]) if item["provider"] in order else len(order))[:limit]
+    allowed = []
     if rule.docs_intent:
         allowed = [item for item in candidates if item["operation"] == "search" and item["capability"] == "docs_search"]
-    else:
+    # With no docs channel configured, a docs question still gets general web
+    # discovery instead of no channel at all. Failure fallback passes only
+    # same-family candidates, so this cannot cross a capability boundary.
+    if not allowed:
         allowed = [item for item in candidates if item["operation"] == "search" and
                    (item["capability"] in {"main_search", "web_search"} or item["provider"] == "exa" or
                     item["capability"] in rule.required_capabilities)]
@@ -162,6 +166,8 @@ class ChannelExecutor:
                 content = _check_data(await svc.zhipu_mcp_reader(url)).get("content")
             elif provider == "tinyfish":
                 content = _check_data(await svc.call_tinyfish_fetch(url)).get("content")
+            elif provider == "deepseek":
+                content = await svc.call_deepseek_fetch(url)
             else:
                 raise ProviderCallError("parameter_error", source_message('Unsupported fetch channel'))
             results = [{"url": url, "content": content}]
@@ -177,6 +183,8 @@ class ChannelExecutor:
             results = await svc.call_firecrawl_search(query, self.count) or []
         elif provider == "tinyfish":
             results = await svc.call_tinyfish_search(query, self.count) or []
+        elif provider == "deepseek":
+            results = await svc.call_deepseek_search(query, self.count) or []
         elif provider == "anysearch":
             results = _check_data(await svc.anysearch_search(query, max_results=self.count)).get("results", [])
         elif provider == "context7":

package/runtime/smart-search/_internal/smart_search/provider_descriptions.py

@@ -113,6 +113,20 @@ PROVIDER_DESCRIPTIONS: dict[str, dict[str, dict[str, str]]] = {
             "guidance_zh": "擅长读取已找到的页面；不适合发现新来源或执行浏览器自动化。",
         },
     },
+    "deepseek": {
+        "search": {
+            "en": "Searches the web with DeepSeek's own search engine and returns linked results with long query-focused summaries.",
+            "zh": "通过 DeepSeek 自研搜索引擎检索网页，返回链接和与问题相关的长摘要。",
+            "guidance_en": "Best for broad web and Chinese-language source discovery; summaries are not full page text, so read key pages before citing them. Queries longer than 128 characters are shortened.",
+            "guidance_zh": "擅长广泛发现网页和中文来源；摘要不是网页全文，引用关键结论前应读取原页。超过 128 个字符的查询会被截短。",
+        },
+        "fetch": {
+            "en": "Fetches a known URL as markdown through DeepSeek Fetch.",
+            "zh": "通过 DeepSeek Fetch 将已知链接读取为 Markdown。",
+            "guidance_en": "Best for reading public web pages already found; unsuitable for source discovery, PDF files, login-only pages or private network addresses.",
+            "guidance_zh": "擅长读取已找到的公开网页；不适合发现新来源，也读不了 PDF、需登录的页面或内网地址。",
+        },
+    },
     "anysearch": {
         "search": {
             "en": "Searches AnySearch's available domains with a plain query.",

package/runtime/smart-search/_internal/smart_search/providers/__init__.py

@@ -1,6 +1,7 @@
 from .base import BaseSearchProvider, SearchResult
 from .anysearch import AnySearchProvider
 from .context7 import Context7Provider
+from .deepseek import DeepSeekToolsProvider
 from .openai_compatible import OpenAICompatibleSearchProvider
 from .xai_responses import XAIResponsesSearchProvider
 from .exa import ExaSearchProvider
@@ -15,6 +16,7 @@ __all__ = [
     "SearchResult",
     "AnySearchProvider",
     "Context7Provider",
+    "DeepSeekToolsProvider",
     "OpenAICompatibleSearchProvider",
     "XAIResponsesSearchProvider",
     "ExaSearchProvider",

package/runtime/smart-search/_internal/smart_search/providers/deepseek.py

@@ -0,0 +1,110 @@
+"""DeepSeek web search and page fetch.
+
+Both tools live under the DeepSeek API host (`/v1/tools/search` and
+`/v1/tools/fetch`) and use the same Bearer key as the DeepSeek chat API.
+"""
+from ..i18n import source_message
+
+from typing import Any
+
+import httpx
+
+from ..provider_errors import ProviderCallError, provider_call_error
+
+
+MAX_QUERY_CHARS = 128
+MAX_COUNT = 50
+# Fetch answers 403 when its safety policy refuses a URL and 404 when the page
+# has no usable Markdown. Both describe that one page, not the key or the
+# service, so they read as "no content" and leave provider health alone.
+PAGE_UNAVAILABLE_STATUSES = frozenset({403, 404})
+
+
+def tools_endpoint(api_url: str, tool: str) -> str:
+    base = api_url.rstrip("/")
+    # The chat API documents both https://api.deepseek.com and .../v1 as its base.
+    if base.endswith("/v1"):
+        base = base[: -len("/v1")]
+    return f"{base}/v1/tools/{tool}"
+
+
+def search_query(query: str) -> str:
+    """Fit a query into the 128-character limit, preferring a word boundary."""
+    text = " ".join(query.split())
+    if len(text) <= MAX_QUERY_CHARS:
+        return text
+    cut = text[:MAX_QUERY_CHARS]
+    space = cut.rfind(" ")
+    return cut[:space] if space >= MAX_QUERY_CHARS // 2 else cut
+
+
+def _normalize_search_result(item: dict[str, Any]) -> dict[str, Any]:
+    out: dict[str, Any] = {
+        "title": item.get("title") or "",
+        "url": item.get("url") or "",
+        # summary is the longer, query-focused excerpt DeepSeek writes for models.
+        "description": item.get("summary") or item.get("snippet") or "",
+        "provider": "deepseek",
+    }
+    site_name = item.get("site_name") or ""
+    if site_name:
+        out["source"] = site_name
+    published = item.get("date") or ""
+    if published:
+        out["published_date"] = published
+    return out
+
+
+class DeepSeekToolsProvider:
+    def __init__(self, api_url: str, api_key: str, timeout: float = 60.0):
+        self.api_url = api_url
+        self.api_key = api_key or ""
+        self.timeout = timeout
+
+    def get_provider_name(self) -> str:
+        return "deepseek"
+
+    async def _post(self, tool: str, body: dict[str, Any]) -> httpx.Response:
+        headers = {
+            "Authorization": f"Bearer {self.api_key}",
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+        }
+        timeout = httpx.Timeout(connect=6.0, read=self.timeout, write=10.0, pool=None)
+        async with httpx.AsyncClient(timeout=timeout, follow_redirects=True) as client:
+            return await client.post(tools_endpoint(self.api_url, tool), headers=headers, json=body)
+
+    async def search(self, query: str, max_results: int = 5) -> list[dict[str, Any]]:
+        """Return normalized results; an empty list means DeepSeek found nothing."""
+        body = {"query": search_query(query), "count": max(1, min(int(max_results), MAX_COUNT))}
+        try:
+            response = await self._post("search", body)
+            response.raise_for_status()
+            payload = response.json()
+            if not isinstance(payload, dict):
+                raise ProviderCallError("parse_error", source_message('DeepSeek search response is not a JSON object'))
+            results = payload.get("results")
+            if not isinstance(results, list):
+                raise ProviderCallError("parse_error", source_message('DeepSeek search response is missing results'))
+        except Exception as exc:
+            raise provider_call_error(exc, additional_secrets=(self.api_key,)) from exc
+        return [_normalize_search_result(item) for item in results[:max_results] if isinstance(item, dict)]
+
+    async def fetch(self, url: str) -> dict[str, str] | None:
+        """Return {title, content}, or None when DeepSeek has no usable text for this page."""
+        try:
+            response = await self._post("fetch", {"url": url})
+            if response.status_code in PAGE_UNAVAILABLE_STATUSES:
+                return None
+            response.raise_for_status()
+            payload = response.json()
+            if not isinstance(payload, dict):
+                raise ProviderCallError("parse_error", source_message('DeepSeek fetch response is not a JSON object'))
+            content = payload.get("content")
+            if not isinstance(content, str):
+                raise ProviderCallError("parse_error", source_message('DeepSeek fetch content is not text'))
+        except Exception as exc:
+            raise provider_call_error(exc, additional_secrets=(self.api_key,)) from exc
+        if not content.strip():
+            return None
+        return {"title": str(payload.get("title") or ""), "content": content}