@konbakuyomu/smart-search-linux-x64 0.1.25 → 0.1.26

package/package.json

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

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

@@ -230,7 +230,7 @@ class Invocation:
             return
         self._finished = True
         self._stop.set()
-        status = status or ("finished" if exit_code == 0 else "failed")
+        status = status or ("cancelled" if self._error_type == "cancelled" else "finished" if exit_code == 0 else "failed")
         if self._enabled:
             self._try(self.store.finish, self.run_id, exit_code, status, error_type=self._error_type,
                       sources_count=self._sources_count)

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

@@ -3243,9 +3243,9 @@
     "号池地址填服务商给你的域名或 URL，例如 https://pool.example.com 或 https://pool.example.com/mcp；setup 会保存为 https://pool.example.com/api/tavily。\n",
     "For pooled endpoints, paste the provider domain or URL, for example https://pool.example.com or https://pool.example.com/mcp; setup saves it as https://pool.example.com/api/tavily.\n"
   ],
-  "Force stream=false for OpenAI-compatible main search.": [
-    "强制 OpenAI 兼容主搜索使用 stream=false。",
-    "Force stream=false for OpenAI-compatible main search."
+  "Force stream=false for xAI Responses or OpenAI-compatible main search.": [
+    "强制 xAI Responses 或 OpenAI 兼容主搜索使用 stream=false。",
+    "Force stream=false for xAI Responses or OpenAI-compatible main search."
   ],
   "Full page URL, including http:// or https://.": [
     "完整网页地址，需带 http:// 或 https://。",
@@ -7435,6 +7435,10 @@
     "最高项",
     "Top"
   ],
+  "Total fetch budget in seconds; overrides SMART_SEARCH_TIMEOUT_SECONDS.": [
+    "抓取总时间预算，单位秒；覆盖 SMART_SEARCH_TIMEOUT_SECONDS。",
+    "Total fetch budget in seconds; overrides SMART_SEARCH_TIMEOUT_SECONDS."
+  ],
   "Total search budget in seconds; overrides SMART_SEARCH_TIMEOUT_SECONDS.": [
     "搜索总时间预算，单位秒；覆盖 SMART_SEARCH_TIMEOUT_SECONDS。",
     "Total search budget in seconds; overrides SMART_SEARCH_TIMEOUT_SECONDS."
@@ -7659,9 +7663,9 @@
     "使用内置后端",
     "Use bundled backend"
   ],
-  "Use stream=true for OpenAI-compatible main search.": [
-    "为 OpenAI 兼容主搜索使用 stream=true。",
-    "Use stream=true for OpenAI-compatible main search."
+  "Use stream=true for xAI Responses or OpenAI-compatible main search.": [
+    "为 xAI Responses 或 OpenAI 兼容主搜索使用 stream=true。",
+    "Use stream=true for xAI Responses or OpenAI-compatible main search."
   ],
   "Use the Smart Search skill to run the following command and report the actual version. Do not only inspect files, and do not search the web yet:\n": [
     "请使用 Smart Search 技能，先运行以下命令并告诉我实际版本，不要仅检查文件，也先不要发起联网搜索：\n",
@@ -8579,13 +8583,13 @@
     "source_types 的值必须为 {0} 之一",
     "source_types values must be one of {0}"
   ],
-  "standard refuses to run when any of the three required capabilities is missing.": [
-    "standard 会在三类必需能力缺一时直接报错。关掉之后出问题更难查。",
-    "standard refuses to run when any of the three required capabilities is missing."
+  "standard requires at least one configured and enabled retrieval channel; Jev is optional.": [
+    "standard 要求至少一个已配置并启用的检索渠道；Jev 可选。",
+    "standard requires at least one configured and enabled retrieval channel; Jev is optional."
   ],
-  "standard 会在三类必需能力缺一时直接报错。关掉之后出问题更难查。": [
-    "standard 会在三类必需能力缺一时直接报错。关掉之后出问题更难查。",
-    "standard refuses to run when any of the three required capabilities is missing."
+  "standard 要求至少一个已配置并启用的检索渠道；Jev 可选。": [
+    "standard 要求至少一个已配置并启用的检索渠道；Jev 可选。",
+    "standard requires at least one configured and enabled retrieval channel; Jev is optional."
   ],
   "strict checks harder and runs slower.": [
     "strict 查得更严也更慢。",
@@ -8683,6 +8687,22 @@
     "xAI 联网工具",
     "xAI Responses tools"
   ],
+  "xAI reasoning effort": [
+    "xAI 推理强度",
+    "xAI reasoning effort"
+  ],
+  "xAI 推理强度": [
+    "xAI 推理强度",
+    "xAI reasoning effort"
+  ],
+  "Optional; when set, sends reasoning.effort in xAI Responses requests; omitted by default.": [
+    "可选；设置后在 xAI Responses 请求中发送 reasoning.effort，默认不发送。",
+    "Optional; when set, sends reasoning.effort in xAI Responses requests; omitted by default."
+  ],
+  "可选；设置后在 xAI Responses 请求中发送 reasoning.effort，默认不发送。": [
+    "可选；设置后在 xAI Responses 请求中发送 reasoning.effort，默认不发送。",
+    "Optional; when set, sends reasoning.effort in xAI Responses requests; omitted by default."
+  ],
   "xAI Responses 模型": [
     "xAI Responses 模型",
     "xAI Responses model"
@@ -9179,9 +9199,9 @@
     "中文",
     "中文"
   ],
-  "为 OpenAI 兼容主搜索使用 stream=true。": [
-    "为 OpenAI 兼容主搜索使用 stream=true。",
-    "Use stream=true for OpenAI-compatible main search."
+  "为 xAI Responses 或 OpenAI 兼容主搜索使用 stream=true。": [
+    "为 xAI Responses 或 OpenAI 兼容主搜索使用 stream=true。",
+    "Use stream=true for xAI Responses or OpenAI-compatible main search."
   ],
   "主搜索": [
     "主搜索",
@@ -11099,9 +11119,9 @@
     "引擎：`{0}`",
     "Engines: `{0}`"
   ],
-  "强制 OpenAI 兼容主搜索使用 stream=false。": [
-    "强制 OpenAI 兼容主搜索使用 stream=false。",
-    "Force stream=false for OpenAI-compatible main search."
+  "强制 xAI Responses 或 OpenAI 兼容主搜索使用 stream=false。": [
+    "强制 xAI Responses 或 OpenAI 兼容主搜索使用 stream=false。",
+    "Force stream=false for xAI Responses or OpenAI-compatible main search."
   ],
   "归档包含特殊设备文件。": [
     "归档包含特殊设备文件。",
@@ -13597,7 +13617,7 @@
   ],
   "结果数量": [
     "结果数量",
-    "Number of results"
+    "Result count"
   ],
   "结果核验的严格程度，越严越慢。": [
     "结果核验的严格程度，越严越慢。",
@@ -17690,5 +17710,149 @@
   "错误详情": [
     "错误详情",
     "Error details"
+  ],
+  "Configure at least one enabled retrieval channel.": [
+    "至少配置一个已启用的检索渠道。",
+    "Configure at least one enabled retrieval channel."
+  ],
+  "Embedding/classifier routing is retired. Use route for a local preview or route --remote for Jev diagnostics.": [
+    "旧向量/分类路由已退役。使用 route 本地预览，或显式 route --remote 检查 Jev。",
+    "Embedding/classifier routing is retired. Use route for a local preview or route --remote for Jev diagnostics."
+  ],
+  "Legacy embedding calibration is retired and calls no model.": [
+    "旧向量路由校准已退役，不调用模型。",
+    "Legacy embedding calibration is retired and calls no model."
+  ],
+  "Local routing": [
+    "本地路由",
+    "Local routing"
+  ],
+  "Result count": [
+    "结果数量",
+    "Result count"
+  ],
+  "Results requested from the selected channel in this round; does not add channels.": [
+    "本轮向选中渠道请求的结果条数，不增加检索渠道。",
+    "Results requested from the selected channel in this round; does not add channels."
+  ],
+  "Retired compatibility command; no remote calibration is performed.": [
+    "已退役的兼容命令；不执行远程校准。",
+    "Retired compatibility command; no remote calibration is performed."
+  ],
+  "Retrieve from one suitable channel and return results with sources. Ordinary search runs one round.": [
+    "选择一个合适渠道检索，返回结果和来源；普通搜索只运行一轮。",
+    "Retrieve from one suitable channel and return results with sources. Ordinary search runs one round."
+  ],
+  "Run single-pass retrieval through one selected channel.": [
+    "通过一个选中的渠道执行单轮检索。",
+    "Run single-pass retrieval through one selected channel."
+  ],
+  "Search can use a retrieval channel without a main model.": [
+    "搜索可直接使用检索渠道，无需主模型。",
+    "Search can use a retrieval channel without a main model."
+  ],
+  "Search selects once; research follows evidence gaps. Without Jev, routing stays local.": [
+    "普通搜索只选路一次；深入搜索按证据缺口继续。未配置 Jev 时使用本地路由。",
+    "Search selects once; research follows evidence gaps. Without Jev, routing stays local."
+  ],
+  "Source requirement": [
+    "来源要求",
+    "Source requirement"
+  ],
+  "Strict requires source evidence; ordinary search does not add follow-up or sufficiency judgments.": [
+    "strict 要求来源证据；普通搜索不会因此自动补搜或判断充分性。",
+    "Strict requires source evidence; ordinary search does not add follow-up or sufficiency judgments."
+  ],
+  "Using local routing; no Jev probe was sent.": [
+    "使用本地路由，未发送 Jev 探测请求。",
+    "Using local routing; no Jev probe was sent."
+  ],
+  "strict 要求来源证据；普通搜索不会因此自动补搜或判断充分性。": [
+    "strict 要求来源证据；普通搜索不会因此自动补搜或判断充分性。",
+    "Strict requires source evidence; ordinary search does not add follow-up or sufficiency judgments."
+  ],
+  "使用本地路由，未发送 Jev 探测请求。": [
+    "使用本地路由，未发送 Jev 探测请求。",
+    "Using local routing; no Jev probe was sent."
+  ],
+  "已退役的兼容命令；不执行远程校准。": [
+    "已退役的兼容命令；不执行远程校准。",
+    "Retired compatibility command; no remote calibration is performed."
+  ],
+  "搜索可直接使用检索渠道，无需主模型。": [
+    "搜索可直接使用检索渠道，无需主模型。",
+    "Search can use a retrieval channel without a main model."
+  ],
+  "旧向量/分类路由已退役。使用 route 本地预览，或显式 route --remote 检查 Jev。": [
+    "旧向量/分类路由已退役。使用 route 本地预览，或显式 route --remote 检查 Jev。",
+    "Embedding/classifier routing is retired. Use route for a local preview or route --remote for Jev diagnostics."
+  ],
+  "旧向量路由校准已退役，不调用模型。": [
+    "旧向量路由校准已退役，不调用模型。",
+    "Legacy embedding calibration is retired and calls no model."
+  ],
+  "普通搜索只选路一次；深入搜索按证据缺口继续。未配置 Jev 时使用本地路由。": [
+    "普通搜索只选路一次；深入搜索按证据缺口继续。未配置 Jev 时使用本地路由。",
+    "Search selects once; research follows evidence gaps. Without Jev, routing stays local."
+  ],
+  "本地路由": [
+    "本地路由",
+    "Local routing"
+  ],
+  "本轮向选中渠道请求的结果条数，不增加检索渠道。": [
+    "本轮向选中渠道请求的结果条数，不增加检索渠道。",
+    "Results requested from the selected channel in this round; does not add channels."
+  ],
+  "来源要求": [
+    "来源要求",
+    "Source requirement"
+  ],
+  "至少配置一个已启用的检索渠道。": [
+    "至少配置一个已启用的检索渠道。",
+    "Configure at least one enabled retrieval channel."
+  ],
+  "选择一个合适渠道检索，返回结果和来源；普通搜索只运行一轮。": [
+    "选择一个合适渠道检索，返回结果和来源；普通搜索只运行一轮。",
+    "Retrieve from one suitable channel and return results with sources. Ordinary search runs one round."
+  ],
+  "通过一个选中的渠道执行单轮检索。": [
+    "通过一个选中的渠道执行单轮检索。",
+    "Run single-pass retrieval through one selected channel."
+  ],
+  "研究预算上限；达到目标后会提前停止。": [
+    "研究预算上限；达到目标后会提前停止。",
+    "Research budget ceiling; stops early when the goal is reached."
+  ],
+  "离线计划的建议深度，不执行检索或消耗请求额度。": [
+    "离线计划的建议深度，不执行检索或消耗请求额度。",
+    "Suggested depth for the offline plan; it runs no retrieval and uses no request quota."
+  ],
+  "auto 允许故障兜底和后续检索；off 关闭这些行为，但保留已发现来源的必要正文读取。": [
+    "auto 允许故障兜底和后续检索；off 关闭这些行为，但保留已发现来源的必要正文读取。",
+    "auto allows failure fallback and follow-up searches; off disables both but permits necessary reading of discovered sources."
+  ],
+  "Invalid {0}: expected chat-completions or responses.": [
+    "无效的 {0}：应为 chat-completions 或 responses。",
+    "Invalid {0}: expected chat-completions or responses."
+  ],
+  "Invalid {0}: expected an HTTP(S) base URL without credentials or query parameters.": [
+    "无效的 {0}：需要不含凭据和查询参数的 HTTP(S) 基础地址。",
+    "Invalid {0}: expected an HTTP(S) base URL without credentials or query parameters."
+  ],
+  "Jev synthesis requires API URL, API key, and model when dedicated synthesis is configured.": [
+    "配置独立 Jev 汇总时，必须同时填写 API 地址、Key 和模型名。",
+    "Jev synthesis requires API URL, API key, and model when dedicated synthesis is configured."
+  ],
+  "Jev synthesis requires an allowed configured synthesis model": [
+    "Jev 结果汇总需要配置允许使用的独立汇总模型",
+    "Jev synthesis requires an allowed configured synthesis model"
+  ],
+  "Jev synthesis is disabled": [
+    "Jev 结果汇总已关闭",
+    "Jev synthesis is disabled"
+  ],
+  "Jev synthesis model is not configured": [
+    "尚未配置 Jev 独立汇总模型",
+    "Jev synthesis model is not configured"
   ]
 }

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

@@ -29,16 +29,16 @@ Use the local `smart-search` command as the default execution layer for web rese
 7. Use `smart-search smoke --mock --format json` after CLI/provider architecture changes. Use `--live` only when real keys are available and the user expects live checks.
 8. Treat `TAVILY_ENABLED=false` as an intentional no-network boundary: do not work around it with direct Tavily or `map` calls. Check `doctor` and live smoke for disabled/skipped Tavily state; Firecrawl remains independently configured.
 9. If a result reports a degraded provider in `provider_notices`, or a provider attempt is `skipped`, run `smart-search providers status --format json`. The channel is on a persisted failure cooldown; fix the credential or run `smart-search providers reset PROVIDER` instead of retrying the same failing provider.
-10. Preserve command lines and source URLs in your answer. Prefer citing fetched pages or `primary_sources`; treat `extra_sources` as follow-up candidates until fetched.
+10. Preserve command lines and source URLs in your answer. Prefer citing fetched pages; treat model citations and unread search sources as discovery candidates.
 
 ## Routing
 
-- `search`: first hop for realtime, broad exploration, community signals, multi-source summaries, and routing metadata.
+- `search`: single-pass retrieval: Jev or local rules select one suitable channel, which returns results and sources; no automatic assessment, follow-up, filtering, or synthesis.
 - `route`: explain capability routing locally without executing providers; `--router-mode jev --remote` explicitly opts into a potentially billable TypeSafe judgment.
-- `research`: live Deep Research executor for end-to-end plan, discovery, fetch/read, gap check, and evidence-only synthesis.
+- `research`: shared bounded loop with Jev or local routing for complementary discovery, fetch/read, evidence gaps, and optional synthesis.
 - `deep`: offline Deep Research planner; it does not run providers, fetch pages, or replace default `search`.
 - `zhipu-search`: Chinese-language, domestic China, policy/regulatory, announcements, current news, or China-local source discovery.
-- `context7-library` / `context7-docs`: library, SDK, API, framework, or documentation intent. Automatic routes select Context7 only when a query subject overlaps a candidate title/id; otherwise use same-capability Exa fallback. Explicit commands retain the candidate list and supplied library id.
+- `context7-library` / `context7-docs`: library, SDK, API, framework, or documentation intent. Ordinary search uses the first library in Context7's ranked candidates; research may ask Jev to choose a candidate, using the first candidate if Jev fails or no score reaches its threshold. Unresolved libraries allow same-capability fallback. Explicit commands retain the candidate list and supplied library id.
 - `exa-search`: official domains, papers, product pages, trusted pages, date/domain-filtered low-noise discovery, and adjacent source discovery through `exa-similar`.
 - `fetch`: user-provided URLs or any claim that depends on page content.
 - `map`: documentation site or domain structure before fetching many pages from one site.
@@ -52,8 +52,8 @@ Use the local `smart-search` command as the default execution layer for web rese
 - `smart-search` should resolve from the user's PATH.
 - Private API keys should be saved with `smart-search setup` or `smart-search config set`; environment variables remain supported for CI and advanced users.
 - In sandboxed runtimes, set `SMART_SEARCH_CONFIG_DIR` to an absolute writable path when the default config directory is unavailable or must be pinned.
-- The standard minimum profile requires one configured provider in each of `main_search`, `docs_search`, and fetch capability. Missing required capabilities are hard configuration failures.
-- Fallback must remain same-capability only. Do not use Context7 for broad news/web facts or page-extraction providers as documentation search replacements.
+- The standard minimum profile requires at least one enabled retrieval channel. Jev and a main model are optional; the requested operation still needs a capable channel.
+- Fallback stays within the same capability family; model answers and web search are mutual fallbacks in ordinary search. Do not use Context7 for broad news/web facts or page-extraction providers as documentation search replacements.
 - xAI Responses and OpenAI-compatible are peer `main_search` providers. Do not reuse one provider's URL/key to fabricate the other provider as fallback.
 - For current-news, policy, finance, health, and other high-risk facts, do not answer from broad `search.content` alone. Fetch key pages and summarize only what fetched text supports.
 - Native `web_search` is disabled in this CLI-first workflow unless the user explicitly configures another approved route; do not silently fall back to another web-search route.

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

@@ -21,7 +21,7 @@
 ## Commands
 
 - `smart-search search QUERY [--platform NAME] [--model ID] [--extra-sources N] [--validation fast|balanced|strict] [--fallback auto|off] [--providers auto|CSV] [--stream|--no-stream] [--timeout SECONDS] [--format json|markdown|content] [--output PATH]` (`--timeout` overrides the persisted `SMART_SEARCH_TIMEOUT_SECONDS` total budget)
-- `smart-search route QUERY [--validation fast|balanced|strict] [--router-mode hybrid|rules|off] [--format json|markdown|content] [--output PATH]`
+- `smart-search route QUERY [--validation fast|balanced|strict] [--router-mode jev|local] [--remote] [--format json|markdown|content] [--output PATH]`
 - `smart-search fetch URL [--format json|markdown|content] [--output PATH]`
 - `smart-search exa-search QUERY [--num-results N] [--search-type neural|keyword|auto] [--include-text] [--include-highlights] [--start-published-date YYYY-MM-DD] [--include-domains DOMAIN...] [--exclude-domains DOMAIN...] [--category NAME] [--format json|markdown|content] [--output PATH]`
 - `smart-search exa-similar URL [--num-results N] [--format json|markdown|content] [--output PATH]`
@@ -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 hybrid|rules|off] [--search-timeout SECONDS] [--intent-embedding-api-url URL] [--intent-embedding-api-key KEY] [--intent-embedding-model ID] [--intent-embedding-threshold FLOAT] [--intent-embedding-margin FLOAT] [--intent-classifier-api-url URL] [--intent-classifier-api-key KEY] [--intent-classifier-model ID] [--intent-router-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] [--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]`
@@ -69,8 +69,8 @@ Nested aliases: `config path`/`cfg p`, `config list`/`cfg ls`/`cfg l`, `config s
 - `--format markdown` is the human-readable report format. `route --format markdown`, `route-calibrate --format markdown`, `doctor --format markdown`, and `diagnose openai-compatible --format markdown` must render useful reports rather than raw JSON dumps.
 - `--format content` prints only the `content` field for content-bearing commands such as `search`, `fetch`, `context7-docs`, and `research`. Commands without a `content` field, including `route`, `route-calibrate`, `doctor`, `smoke`, `config`, `model`, and `providers`, must print a compact non-empty text summary.
 - Successful search output includes `ok`, `query`, `primary_api_mode`, `content`, `sources`, `sources_count`, `primary_sources`, `primary_sources_count`, `extra_sources`, `extra_sources_count`, `source_warning`, `routing_decision`, `providers_used`, `provider_attempts`, `provider_notices`, `fallback_used`, `validation_level`, `timeout_seconds`, `timeout_phase`, `phase_attempts`, deadline elapsed/remaining milliseconds, `partial_success`, and `elapsed_ms`. Phase telemetry is scheduler-level and additive; provider attempts remain provider-level records.
-- Route diagnostic output includes `ok`, `query`, `executed_search=false`, `provider_selection=not_executed`, backward-compatible fields `docs_intent`, `zh_current_intent`, `web_current_intent`, `fetch_intent`, `supplemental_paths`, and unified intent-router fields `intent_router_mode`, `required_capabilities`, `intent_signals`, `confidence`, `router_engines_used`, `degraded`, `degraded_reason`, `reasons`, `embedding_model`, `embedding_threshold`, `embedding_margin`, `embedding_threshold_source`, and `embedding_margin_source`. `smart-search route` must not call search/docs/fetch providers.
-- Route calibration output includes `ok`, `metric`, `primary_metric=semantic_macro_f1`, `full_route_metric_role=validation`, `models`, `model_results`, `dataset_size`, `dataset_counts`, `capabilities`, `recommended_model`, `recommended_threshold`, `recommended_margin`, and `failed_models`.
+- Route diagnostic output includes `ok`, `intent_router_mode`, `required_capabilities`, `available_channels`, `selected_channels`, and `executed_search=false`. Default preview is offline; `--remote` explicitly enables Jev judgment.
+- `route-calibrate` returns `deprecated=true`, `executed_remote=false`, and `error_type=parameter_error`; no model calibration is performed.
 - Fetch output includes `ok`, `url`, `provider`, `content`, `provider_attempts`, `provider_notices`, `fallback_used`, and `elapsed_ms`.
 - Exa search output includes `ok`, `query`, `search_type`, `results`, `total`, and `elapsed_ms`. Exa similar output includes `ok`, `url`, `results`, `total`, and `elapsed_ms`.
 - Zhipu search output includes `ok`, `query`, `provider`, `search_engine`, `results`, `total`, and `elapsed_ms`.
@@ -84,7 +84,7 @@ Nested aliases: `config path`/`cfg p`, `config list`/`cfg ls`/`cfg l`, `config s
 - Diagnostic output masks keys and reports config paths, Windows legacy config metadata, provider timeout values, `capability_status`, `minimum_profile_ok`, `intent_router_status`, `provider_health`, `main_search_connection_tests`, and provider connectivity checks. A successful `doctor` probe also clears that provider's failure cooldown. OpenAI-compatible health must use the endpoint selected by `OPENAI_COMPATIBLE_API_MODE`; `/models` is supplementary metadata.
 - Provider health output includes `ok`, `enabled`, `cooldown_seconds`, `failure_threshold`, `store_path`, `providers`, and `cooldown_providers`; each provider entry carries `provider`, `configured`, `state` (`closed` or `cooldown`), `consecutive_failures`, `error_type`, `error`, `cooldown_remaining_seconds`, and `hard_failure`. `providers reset` output includes `ok`, `cleared`, and `known_providers`, and returns `parameter_error` for an unknown provider id.
 - `provider_notices` is one deduplicated entry per degraded optional provider with `provider`, `capability`, `status` (`failed` or `cooldown`), `error_type`, `error`, `cooldown_remaining_seconds`, and `hint`. Markdown output prints a steady `cooldown` notice only when the command itself failed; JSON always carries it.
-- Smoke output includes `ok`, `mode`, `status` (`healthy`, `degraded`, or `failed`), `failed_cases`, `degraded_cases`, `skipped_cases`, `cases`, `provider_attempts`, and `elapsed_ms`. Healthy and degraded smoke preserve `ok: true` and exit code `0`; failed smoke is non-zero. Live smoke uses skipped cases for unavailable optional checks instead of treating them as failed, but failure of every configured main-search route remains critical.
+- Smoke output includes `ok`, `mode`, `status` (`healthy`, `degraded`, or `failed`), `failed_cases`, `degraded_cases`, `skipped_cases`, `cases`, `provider_attempts`, and `elapsed_ms`. Healthy and degraded smoke preserve `ok: true` and exit code `0`; failed smoke is non-zero. Live smoke skips unavailable optional checks; overall failure follows the reported critical cases, while optional failures with an available same-capability alternative are degraded.
 
 ## Exit Codes
 

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

@@ -16,7 +16,7 @@ For claim-level evidence, prefer this order:
 
 1. Discover candidate URLs with source-focused `search`, `zhipu-search` for Chinese/current/domestic topics, Context7 for docs/API/library topics, or `exa-search` for official/trusted domains and papers.
 2. Fetch the exact pages that matter.
-3. Use broad `search` only as synthesis or discovery, and mark claims as unverified when only `extra_sources` are available.
+3. Build claim-level conclusions from fetched pages, or use `research` for automatic multi-source work. Ordinary `search` returns one selected channel and performs no post-retrieval synthesis. Unread sources remain unverified; `extra_sources` is an empty compatibility field.
 
 Deep Research planner output uses an explicit `--evidence-dir` when supplied, otherwise a generated `smart-search-evidence` directory under `tempfile.gettempdir()`. Preserve the CLI's planned `--output` path and `output_path` match; do not rewrite evidence contracts unless a separate docs/runtime fix is in scope. Hard-coded paths such as `C:\tmp\smart-search-evidence\...` should be treated as user-chosen explicit output locations.
 
@@ -70,6 +70,8 @@ smart-search config list --format markdown
 smart-search config set XAI_API_KEY "key" --format json
 smart-search config set XAI_MODEL "grok-4-fast" --format json
 smart-search config set XAI_TOOLS "web_search,x_search" --format json
+smart-search config set XAI_REASONING_EFFORT "high" --format json
+smart-search search "Latest Grok news" --providers xai-responses --stream --format json
 smart-search config set OPENAI_COMPATIBLE_API_URL "https://api.openai.com/v1" --format json
 smart-search config set OPENAI_COMPATIBLE_API_KEY "key" --format json
 smart-search config set OPENAI_COMPATIBLE_MODEL "model-id" --format json
@@ -81,17 +83,7 @@ smart-search config set ANYSEARCH_API_URL "https://api.anysearch.com/mcp" --form
 smart-search config set SCIVERSE_API_TOKEN "key" --format json
 smart-search config set ANYSEARCH_API_KEY "key" --format json
 smart-search config set ANYSEARCH_TIMEOUT_SECONDS "30" --format json
-smart-search config set SMART_SEARCH_INTENT_ROUTER "hybrid" --format json
-smart-search config set INTENT_EMBEDDING_API_URL "https://api.siliconflow.cn/v1/embeddings" --format json
-smart-search config set INTENT_EMBEDDING_API_KEY "key" --format json
-smart-search config set INTENT_EMBEDDING_MODEL "Qwen/Qwen3-Embedding-8B" --format json
-smart-search config set INTENT_EMBEDDING_THRESHOLD "0.475" --format json
-smart-search config set INTENT_EMBEDDING_MARGIN "0.053" --format json
-smart-search route-calibrate --models "Qwen/Qwen3-Embedding-8B" --format json
-smart-search config set INTENT_CLASSIFIER_API_URL "https://api.openai.com/v1/chat/completions" --format json
-smart-search config set INTENT_CLASSIFIER_API_KEY "key" --format json
-smart-search config set INTENT_CLASSIFIER_MODEL "gpt-4.1-mini" --format json
-smart-search config set INTENT_ROUTER_TIMEOUT_SECONDS "8" --format json
+smart-search config set SMART_SEARCH_INTENT_ROUTER "jev" --format json
 smart-search config set EXA_API_KEY "key" --format json
 smart-search config set CONTEXT7_API_KEY "key" --format json
 smart-search config set ZHIPU_API_KEY "key" --format json
@@ -147,27 +139,25 @@ When a search succeeds but `provider_notices` reports a degraded optional provid
 
 ## Timeout Retry Policy
 
-When `smart-search search` returns `ok: false` with `error_type: "timeout"`, treat it as a retryable terminal main-search deadline, not as a terminal research failure. Inspect `timeout_phase` and `phase_attempts` first: optional-phase timeout with `partial_success=true` already retains usable primary content.
+When `smart-search search` returns `ok: false` with `error_type: "timeout"`, inspect `timeout_phase` and `provider_attempts` first. Partial results can remain in `content`; ordinary search has no automatic optional source phase.
 
-1. Retry up to 3 total attempts with `--timeout 300`, waiting about 5 seconds between attempts.
-2. Use `--format json` and `--output PATH` for each attempt; after each attempt, inspect the saved JSON and stop on the first `"ok": true`.
-3. Use `--extra-sources 1` during retry attempts to keep Tavily/Firecrawl overhead small.
-4. `SMART_SEARCH_TIMEOUT_SECONDS` supplies the persistent 300-second default; use the CLI's `--timeout` only for an explicit one-call override. Do not wrap `smart-search` in a shell-level `timeout` command because shell termination can prevent structured failure JSON.
-5. Do not rely on `SMART_SEARCH_RETRY_*` settings; search command timeouts are surfaced by the CLI result contract and should be handled by the agent workflow.
-6. If all attempts time out, fall back to source-first evidence:
+1. Retry the same search at most once, adding `--extra-sources 1` to limit the selected channel result count.
+2. Use `--format json` and `--output PATH` for each attempt; inspect the saved JSON and stop on `"ok": true`.
+3. Set the agent's command execution timeout at least 30 seconds longer than the smart-search total budget, or run the command in the background. With the default 300-second budget, the agent timeout must be at least 330 seconds; otherwise the agent can kill smart-search before it returns structured results. `SMART_SEARCH_TIMEOUT_SECONDS` supplies the default; `--timeout` overrides one call.
+4. If the retry also times out, switch to source-first evidence:
    - Run `exa-search` with the original query.
    - Run `exa-search --include-domains` when likely official domains are known.
    - `fetch` the top 1-2 relevant URLs before making claim-level statements.
-   - Mark the final answer as `source_mode: "fallback"` or clearly state that the answer was assembled from fetched sources rather than generated by `search`.
+   - Mark the final answer as `source_mode: "fallback"` or state that it was assembled from fetched sources after the original search failed.
 
-Agent timeout handling contract: `smart-search search ... --timeout 300 --extra-sources 1 --format json --output PATH` is the retry shape; it is not a shell-level `timeout` wrapper. `SMART_SEARCH_RETRY_*` settings are not the contract for this path. After repeated main-search timeout failures, switch to source-first fallback with `exa-search`, `exa-search --include-domains`, and fetched evidence. Final answers assembled through that fallback should explicitly label the evidence mode, for example `source_mode: "fallback"` or equivalent prose.
+Agent timeout handling contract: on `error_type: "timeout"`, inspect `timeout_phase` and `provider_attempts`, then retry the same search at most once with `--extra-sources 1`, for example `smart-search search ... --timeout 300 --extra-sources 1 --format json --output PATH`. Set the agent's command execution timeout at least 30 seconds above the smart-search total budget (at least 330 seconds for the default 300 seconds), or run it in the background, so the agent does not kill it before structured results return. If the retry also times out, switch to source-first fallback with `exa-search`, `exa-search --include-domains`, and fetched evidence, and label the evidence mode as `source_mode: "fallback"` or equivalent prose.
 
 ## Guardrails
 
 - Prefer JSON for agent parsing and markdown for fetched page text intended for reading.
 - Use `--output` for multi-source work, long pages, or anything the answer may need to cite later.
 - Keep `--extra-sources` small (`1` to `3`) unless the user asks for broad coverage.
-- Do not cite `extra_sources` as proof for a sentence in `content`; fetch the URL first or cite it only as a candidate source.
+- Do not cite unread `sources` or model `primary_sources` as proof for a sentence in `content`; fetch the URL first. `extra_sources` remains an empty compatibility list.
 - Prefer `exa-search --include-domains` for official documentation when likely domains are known.
 - Do not expose API keys. Treat `doctor` output as safe only because it is expected to mask secrets.
 - In this CLI-first workflow, native `web_search` is disabled unless the user explicitly configures another approved route.

package/runtime/smart-search/_internal/smart_search/assets/skills/smart-search-cli/references/deep-research-mode.md

@@ -28,16 +28,16 @@ Use Deep Research Mode when the user asks for `深度搜索`, `深度调研`, `
 
 Do not select a fixed topic recipe. Market, product, technical docs, news, policy, claim-checking, and URL-first prompts are examples of user language, not schema modes. Deep Research must not require fixed topic recipe ids such as `current_market_research`, `product_comparison_research`, `technical_docs_research`, `news_or_policy_research`, `claim_verification_research`, or `url_first_research`; fixed topic recipe ids are not required schema.
 
-Deep Research does not change default `smart-search search` behavior and does not depend on an MCP session. It must not change default `smart-search search` behavior.
+Deep Research does not change default `smart-search search` behavior and does not depend on an MCP session.
 
 ## Offline Planner And Live Executor
 
 - `smart-search deep` is the public offline planner command and a public planner entrypoint, not an executor. It does not call providers, run `doctor`, or fetch pages by default.
-- `smart-search research` is the public live executor command and public live executor entrypoint. It executes plan -> discover -> fetch/read -> gap check -> evidence-only synthesis.
+- `smart-search research` is the public live executor. It uses the plan's question candidates, then selects and executes actions in a bounded loop with Jev or local routing; it does not execute the offline `steps[].command` list. The default returns evidence; optional model synthesis is controlled separately.
 - Before manual execution, run `smart-search deep "question" --format json` and use the returned `research_plan` as your planning artifact.
 - Use `smart-search research "question" --format json` when the user wants the CLI to run live Deep Research end to end instead of only planning.
 
-Default orchestration:
+Optional manual orchestration (use `research` directly for automatic execution):
 
 1. Run `smart-search doctor --format json` as preflight when configuration is uncertain.
 2. Call `smart-search deep "question" --format json` to create an offline `research_plan`.
@@ -47,7 +47,7 @@ Default orchestration:
 6. Use `fetch` on key URLs before making claim-level statements.
 7. Run `gap_check`: if an important claim lacks fetched evidence, fetch another source or mark the claim/source as unverified.
 
-Default evidence policy is `fetch_before_claim`: key claims in the final answer must be supported by fetched page text. Treat `primary_sources` and `extra_sources` as discovery candidates until the relevant URL has been fetched. Final answers should include fetched evidence, unverified candidate sources, and key commands used.
+Default evidence policy is `fetch_before_claim`: key claims in the final answer must be supported by fetched page text. Treat unread `sources` and model `primary_sources` as discovery candidates until fetched; `extra_sources` is an empty compatibility list. Final answers should include fetched evidence, unverified candidate sources, and key commands used.
 
 ## Planner Shape
 
@@ -145,12 +145,12 @@ Prefer PowerShell-safe quoted commands in generated plans because Windows users
 
 ## Capability Boundaries
 
-- `search`: broad discovery and synthesis through `main_search`; use returned `routing_decision`, `provider_attempts`, `fallback_used`, and `source_warning` as orchestration signals, not as claim proof.
+- `search`: one selected retrieval channel; use returned `routing_decision`, `provider_attempts`, `fallback_used`, and `source_warning` as orchestration signals, not as claim proof.
 - `zhipu-search`: Chinese, domestic, current, policy/regulatory, announcement, and China-local source discovery.
 - `context7-library` and `context7-docs`: library, SDK, API, framework, and documentation intent. Prefer Context7 before Exa for docs/API questions.
 - `exa-search`: low-noise source discovery for official domains, papers, product pages, known domains, and trusted pages. Do not treat Exa as the universal second hop for every high-risk or verification task.
 - `exa-similar`: adjacent-source discovery when a known reliable URL is available.
-- `search --extra-sources N`: Tavily/Firecrawl horizontal candidate collection for breadth. Treat those candidates as discovery until fetched.
+- `search --extra-sources N`: result count for the single selected ordinary-search channel (maximum 20); it does not add channels.
 - `anysearch-domains` and `anysearch-search`: experimental vertical search. Inspect domains first, then search a selected domain; do not insert it into the default fallback chain.
 - `sciverse-catalog`, `sciverse-search`, `sciverse-semantic`, `sciverse-read`, and `sciverse-relations`: explicit experimental academic commands. Use them directly when the task needs Sciverse academic fields, semantic paper hits, document chunks, or citation/reference relations; do not insert Sciverse into default Deep Research fallback.
 - `fetch`: page-content evidence. Key claims require fetched page text under `fetch_before_claim`.
@@ -164,9 +164,9 @@ Use this form when the user wants the CLI to execute the live workflow directly:
 smart-search research "question" --budget deep --fallback auto --evidence-dir "<evidence-dir>" --format json --output "research.json"
 ```
 
-`research --fallback auto` permits same-capability fallback inside selected routes. `research --fallback off` tries only the first selected provider in each capability route and is for debugging or provider comparison. Dynamic routing may reorder providers only inside the same capability. Every attempt must record capability, provider, status, error type, latency, and result count.
+`research --fallback auto` permits local outage fallback and follow-up searches. `research --fallback off` disables both, while allowing reads of initially discovered URLs. Jev may choose complementary capabilities, but each provider remains limited to its supported operations. Every attempt records capability, provider, status, error type, latency, and result count.
 
-Research output includes `final_answer`, `citations`, `evidence_items`, `gap_check`, `provider_attempts`, `fallback_used`, `degraded`, `route_policy_version`, and `evidence_dir`. The synthesis is evidence-only. It may cite fetched/read evidence, but it must not cite unfetched discovery candidates as proof. If providers are exhausted or evidence cannot close, return the degraded gaps rather than inventing missing claims.
+Research output includes `final_answer`, `citations`, `evidence_items`, `gap_check`, `provider_attempts`, `fallback_used`, `degraded`, `route_policy_version`, and `evidence_dir`. The default report contains evidence excerpts; optional model synthesis uses that same read evidence. Unfetched discovery candidates cannot support citations. If providers are exhausted or evidence cannot close, return the gaps rather than inventing missing claims.
 
 Research provider advantage routing: