argo-search 2.9.7 → 2.9.8

package/packages/dsh-plugin/dsh/client.js

@@ -46,6 +46,26 @@ window.__ModuleLoader__.load({
         tabKeys: '密钥',
         tabResearch: '研究',
         tabAdvanced: '高级',
+        tabDashboard: '看板',
+        dashboardTitle: '运行监控与健康态看板',
+        dashboardHint: '实时监控常驻 MCP 连接池、上游搜索源拓扑与额度状态，提供一键预设与快速调优。',
+        poolTitle: '常驻 MCP 连接池监控',
+        poolStatusHealthy: '就绪（正常）',
+        presetTitle: '工作流快速预设',
+        presetHint: '一键对齐常用工作场景的并发与引擎策略，免去逐项手动调优。',
+        presetFast: '极速日常',
+        presetFastDesc: '免密免费源优先，关闭 TF-IDF 重排与数值交叉比对，超低延迟',
+        presetStandard: '平衡生产（推荐）',
+        presetStandardDesc: '开启 TF-IDF 重排、数值交叉核验、主流付费源，标准超时',
+        presetDeep: '深度调研',
+        presetDeepDesc: '激活更多取证工具、对冲自适应宽限、语义证据层、更大并发',
+        presetApplied: '已应用预设：',
+        matrixTitle: '核心引擎拓扑与覆盖全景',
+        matrixHint: '当前可用引擎的接入层级与角色分工。带免密标识的引擎无需密钥即可直接使用。',
+        matrixConfigured: '密钥已就绪',
+        matrixKeyless: '免密层可用',
+        matrixPending: '待配密钥',
+        searchFilterPlaceholder: '输入关键词快速筛选...',
         summary: 'Argo · web_search {search} · web_fetch {fetch} · 原生工具 {tools} 个 · 研究 {workers}/{max}',
         accessTitle: '接入方式',
         searchSeam: '宿主 web_search 走 argo',
@@ -109,6 +129,8 @@ window.__ModuleLoader__.load({
         groupNet: '网络出口',
         groupLocal: '本机检索',
         groupMisc: '其他',
+        groupPaid: '额度与预算',
+        groupPaidHint: '免费与付费源统一管理：金额计费的源设月度预算，按次数限额的源设日/月次数上限；0=不限制。额度或预算用尽后该源自动跳过并回落免费源。改动对下一次新建连接生效。',
         envDefault: '默认',
         envRange: '需在 {min}–{max} 之间',
         keySourceFile: '凭证库',
@@ -139,6 +161,26 @@ window.__ModuleLoader__.load({
         tabKeys: 'Keys',
         tabResearch: 'Research',
         tabAdvanced: 'Advanced',
+        tabDashboard: 'Dashboard',
+        dashboardTitle: 'Runtime Monitoring & Health Dashboard',
+        dashboardHint: 'Real-time overview of the resident MCP connection pool, upstream search engine matrix, and quick workflow presets.',
+        poolTitle: 'Resident MCP Pool Monitoring',
+        poolStatusHealthy: 'Ready (Healthy)',
+        presetTitle: 'Workflow Presets',
+        presetHint: 'One-click presets tailored for common research and search workflows.',
+        presetFast: 'Fast & Free',
+        presetFastDesc: 'Keyless & free sources, disable rerank & crosscheck for lowest latency',
+        presetStandard: 'Balanced (Recommended)',
+        presetStandardDesc: 'TF-IDF rerank, numeric crosscheck, mainstream paid sources, standard timeouts',
+        presetDeep: 'Deep Research',
+        presetDeepDesc: 'Full forensic tools, adaptive hedge grace, semantic evidence layer, max concurrency',
+        presetApplied: 'Preset applied:',
+        matrixTitle: 'Core Engine Topology & Coverage',
+        matrixHint: 'Access tiers and roles of available engines. Keyless engines work without an API key.',
+        matrixConfigured: 'Key Ready',
+        matrixKeyless: 'Keyless Ready',
+        matrixPending: 'Key Required',
+        searchFilterPlaceholder: 'Filter by keyword or engine...',
         summary: 'Argo · web_search {search} · web_fetch {fetch} · {tools} native tools · research {workers}/{max}',
         accessTitle: 'Access',
         searchSeam: 'Route host web_search to argo',
@@ -202,6 +244,8 @@ window.__ModuleLoader__.load({
         groupNet: 'Network',
         groupLocal: 'Local search',
         groupMisc: 'Misc',
+        groupPaid: 'Quotas & budgets',
+        groupPaidHint: 'Free and paid sources share one manager: money-metered sources take a monthly budget, count-capped sources take daily/monthly call caps; 0 = unlimited. When a budget or cap is exhausted, that source is skipped and free fallbacks take over. Changes apply to the next new connection.',
         envDefault: 'default',
         envRange: 'must be between {min} and {max}',
         keySourceFile: 'credential store',
@@ -238,6 +282,7 @@ window.__ModuleLoader__.load({
 
     const KEYS = [
       { ref: 'DEEPSEEK_API_KEY', common: true, zh: 'DeepSeek 官方搜索', en: 'DeepSeek official search' },
+      { ref: 'ARGO_YUANBAO_API_KEY', common: true, zh: '腾讯元宝搜索', en: 'Tencent Yuanbao' },
       { ref: 'TAVILY_API_KEY', common: true, zh: 'Tavily', en: 'Tavily' },
       { ref: 'EXA_API_KEY', common: true, zh: 'Exa', en: 'Exa' },
       { ref: 'BOCHA_API_KEY', common: true, zh: '博查', en: 'Bocha' },
@@ -261,12 +306,25 @@ window.__ModuleLoader__.load({
       { ref: 'UNPAYWALL_EMAIL', zh: 'Unpaywall 邮箱（非密钥）', en: 'Unpaywall email (not secret)' },
     ];
 
+    const CORE_ENGINES = [
+      { id: 'deepseek', nameZh: 'DeepSeek 搜索', nameEn: 'DeepSeek Search', roleZh: '通用搜索 / 官方对齐', roleEn: 'General / Official Seam', ref: 'DEEPSEEK_API_KEY', keyless: false },
+      { id: 'yuanbao', nameZh: '腾讯元宝', nameEn: 'Tencent Yuanbao', roleZh: '中文对冲主力', roleEn: 'Chinese General Primary', ref: 'ARGO_YUANBAO_API_KEY', keyless: false },
+      { id: 'tavily', nameZh: 'Tavily Search', nameEn: 'Tavily Search', roleZh: 'AI 知识增强检索', roleEn: 'AI Knowledge Retrieval', ref: 'TAVILY_API_KEY', keyless: false },
+      { id: 'exa', nameZh: 'Exa Neural', nameEn: 'Exa Neural', roleZh: '神经语义精准搜索', roleEn: 'Neural Semantic Search', ref: 'EXA_API_KEY', keyless: false },
+      { id: 'brave', nameZh: 'Brave Search', nameEn: 'Brave Search', roleZh: '独立全球 Web 索引', roleEn: 'Independent Global Index', ref: 'BRAVE_API_KEY', keyless: true },
+      { id: 'bocha', nameZh: '博查 Bocha', nameEn: 'Bocha', roleZh: '垂直多源聚合', roleEn: 'Vertical Multi-source', ref: 'BOCHA_API_KEY', keyless: false },
+      { id: 'jina', nameZh: 'Jina Reader', nameEn: 'Jina Reader', roleZh: '正文高保真提取', roleEn: 'Article Text Extraction', ref: '', keyless: true },
+      { id: 'tinyfish', nameZh: 'TinyFish', nameEn: 'TinyFish', roleZh: '无头渲染抓取兜底', roleEn: 'Headless Render Fallback', ref: 'TINYFISH_API_KEY', keyless: true },
+      { id: 'zhihu', nameZh: '知乎 Zhihu', nameEn: 'Zhihu', roleZh: '中文专业问答舆情', roleEn: 'Professional Q&A / Social', ref: 'ZHIHU_ACCESS_SECRET', keyless: true },
+    ];
+
     // argo 引擎开关（argoEnv 的 KEY=VALUE 行）。与 index.js 的 ARGO_ENV_SPECS
     // 同一份名单，由 test/client.test.js 的漂移门禁核对；kind 决定控件：
-    // bool=开关（invert 语义反转，如 NO_CACHE 是「关缓存」）、num=数字、
-    // str=文本、list=名单。def 仅作「未配置时显示什么」，缺省即不写该行。
+    // bool=开关、num=数字、str=文本、list=名单。def 仅作「未配置时显示什么」，
+    // 缺省即不写该行。开关文案写正向行为或明确的关闭动作，不再用 invert 反转
+    // （历史 bug 见 index.js 注释）。
     const ENGINE_TOGGLES = [
-      { name: 'ARGO_NO_CACHE', kind: 'bool', invert: true, group: 'cache', def: false, zh: '关闭搜索结果缓存', en: 'Disable result cache', hintZh: 'argo 默认缓存 1 小时；调试期关掉缓存看实时结果', hintEn: 'argo caches results for 1h by default; turn off to see live results' },
+      { name: 'ARGO_NO_CACHE', kind: 'bool', group: 'cache', def: false, zh: '测试模式（关闭结果缓存）', en: 'Test mode (disable result cache)', hintZh: '日常保持关闭：结果缓存 1 小时。改进 Skill/插件、需要看实时结果时再打开', hintEn: 'Off by default: results are cached for 1h. Enable only when developing the skill/plugin' },
       { name: 'ARGO_TFIDF_RERANK', kind: 'bool', group: 'cache', def: true, zh: 'TF-IDF 重排', en: 'TF-IDF rerank', hintZh: '多引擎结果融合前的相关性重排，默认开', hintEn: 'Relevance rerank before fusion, on by default' },
       { name: 'ARGO_NUMBER_CROSSCHECK', kind: 'bool', group: 'cache', def: true, zh: '数值交叉校验', en: 'Number cross-check', hintZh: '对查询里的数值主张做跨源核对，默认开', hintEn: 'Cross-check numeric claims across sources, on by default' },
       { name: 'ARGO_MINHASH_DEDUPE', kind: 'bool', group: 'cache', def: true, zh: 'MinHash 去重', en: 'MinHash dedupe', hintZh: '近重复结果合并，默认开', hintEn: 'Merge near-duplicate results, on by default' },
@@ -289,7 +347,14 @@ window.__ModuleLoader__.load({
       { name: 'ARGO_LOCAL_SEEK_PATH', kind: 'str', group: 'local', zh: 'seek.py 绝对路径', en: 'seek.py path', hintZh: '显式指定 seek.py，优先于根目录候选', hintEn: 'Explicit seek.py, wins over root candidates' },
       { name: 'ARGO_LOCAL_READ_DIRS', kind: 'list', group: 'local', zh: '本机读取白名单', en: 'Local read allowlist', hintZh: '逗号分隔；不配置则 local_read 一律不放行', hintEn: 'Comma-separated; empty means local_read allows nothing' },
       { name: 'ARGO_TEXT_LEXICON', kind: 'str', group: 'local', zh: '词表 JSON 路径', en: 'Lexicon JSON path', hintZh: '文本处理词表覆盖，默认用打包词表', hintEn: 'Text lexicon override; default uses the bundled one' },
-      { name: 'ARGO_NO_PREWARM', kind: 'bool', invert: true, group: 'misc', def: false, zh: '关闭连接预热', en: 'Disable prewarm', hintZh: 'MCP 握手后预热引擎注册表，默认开', hintEn: 'Prewarm the engine registry after handshake, on by default' },
+      { name: 'ARGO_PAID_SEARCH', kind: 'str', group: 'paid', def: 'auto', zh: '付费源策略', en: 'Paid source policy', hintZh: 'auto=优势域自动使用付费源；off=只用免费源。额度见下方', hintEn: 'auto = use paid sources in proven domains; off = free sources only. See quotas below' },
+      { name: 'ARGO_BUDGET_DEEPSEEK_SEARCH', kind: 'num', group: 'paid', def: 5, min: 0, max: 1000, step: 1, zh: 'DeepSeek 月度预算（元）', en: 'DeepSeek monthly budget (CNY)', hintZh: '0=关闭；¥5≈1000次成功调用（¥0.005/次）', hintEn: '0 = off; CNY 5 ≈ 1000 successful calls (CNY 0.005 each)' },
+      { name: 'ARGO_BUDGET_EXA', kind: 'num', group: 'paid', def: 10, min: 0, max: 10000, step: 1, zh: 'Exa 每月预算（美元）', en: 'Exa monthly budget (USD)', hintZh: '默认 $10/月（约 1000 次）；0=关闭自动使用。按成功调用计费', hintEn: 'Default $10/month (~1000 calls); 0 = off. Billed per successful call' },
+      { name: 'ARGO_QUOTA_ANYSEARCH_LIMIT', kind: 'num', group: 'paid', def: 1000, min: 0, max: 1000000, step: 1, zh: 'AnySearch 每日次数上限', en: 'AnySearch daily call cap', hintZh: '默认 1000/日；0=不限制。改动对下一次新建连接生效', hintEn: 'Default 1000/day; 0 = unlimited. Applies to new connections' },
+      { name: 'ARGO_QUOTA_ZHIHU_LIMIT', kind: 'num', group: 'paid', def: 5000, min: 0, max: 1000000, step: 1, zh: '知乎 每日次数上限', en: 'Zhihu daily call cap', hintZh: '默认 5000/日；0=不限制。改动对下一次新建连接生效', hintEn: 'Default 5000/day; 0 = unlimited. Applies to new connections' },
+      { name: 'ARGO_QUOTA_YUANBAO_LIMIT', kind: 'num', group: 'paid', def: 2000, min: 0, max: 1000000, step: 1, zh: '元宝 每月次数上限', en: 'Yuanbao monthly call cap', hintZh: '默认 2000/月；0=不限制。改动对下一次新建连接生效', hintEn: 'Default 2000/month; 0 = unlimited. Applies to new connections' },
+      { name: 'ARGO_QUOTA_TAVILY_LIMIT', kind: 'num', group: 'paid', def: 1000, min: 0, max: 1000000, step: 1, zh: 'Tavily 每月次数上限', en: 'Tavily monthly call cap', hintZh: '默认 1000/月；0=不限制。改动对下一次新建连接生效', hintEn: 'Default 1000/month; 0 = unlimited. Applies to new connections' },
+      { name: 'ARGO_NO_PREWARM', kind: 'bool', group: 'misc', def: false, zh: '关闭连接预热', en: 'Disable prewarm', hintZh: 'MCP 握手后预热引擎注册表，默认开；开启本项即关闭预热', hintEn: 'Prewarm the engine registry after handshake, on by default; enable this to turn it off' },
       { name: 'ARGO_USAGE_LOG', kind: 'bool', group: 'misc', def: true, zh: '使用日志', en: 'Usage log', hintZh: 'argo 侧 JSONL 使用账本，默认开', hintEn: 'argo JSONL usage ledger, on by default' },
       { name: 'ARGO_ENGINE_HTTP_CLIENT', kind: 'bool', group: 'misc', def: true, zh: 'HttpClient 连接池', en: 'HttpClient pool', hintZh: '引擎 HTTP 走连接池，默认开；=0 回退 urllib（诊断用）', hintEn: 'Pooled engine HTTP, on by default; =0 falls back to urllib' },
       { name: 'ARGO_ADMISSION_TTL_S', kind: 'num', group: 'misc', def: 1, min: 0, max: 60, step: 0.5, zh: '准入记忆 TTL（秒）', en: 'Admission memo TTL (s)', hintZh: '引擎准入状态记忆时长，默认 1；0 每次现查', hintEn: 'Admission memo window, default 1; 0 = always fresh' },
@@ -391,6 +456,43 @@ window.__ModuleLoader__.load({
       actions: { display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap' },
       switchWrap: { display: 'flex', alignItems: 'center', gap: 8 },
       divider: { height: '.5px', background: 'var(--dsw-alias-border-l2, #eee)', margin: '2px 0' },
+      metricGrid: { display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(170px, 1fr))', gap: 10 },
+      metricCard: {
+        display: 'flex', flexDirection: 'column', gap: 6, padding: '12px 14px',
+        borderRadius: 10, border: '.5px solid var(--dsw-alias-border-l3, #e5e7eb)',
+        background: 'var(--dsw-alias-bg-layer-2, #f8fafc)',
+      },
+      metricLabel: { fontSize: 11, fontWeight: 500, color: 'var(--dsw-alias-label-tertiary, #7b818b)', textTransform: 'uppercase', letterSpacing: '0.04em' },
+      metricValue: { fontSize: 18, fontWeight: 600, lineHeight: '22px', color: 'var(--dsw-alias-label-primary, #1f2328)' },
+      metricSub: { fontSize: 11, lineHeight: '16px', color: 'var(--dsw-alias-label-secondary, #4b5563)' },
+      presetGrid: { display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(220px, 1fr))', gap: 10 },
+      presetCard: (active) => ({
+        display: 'flex', flexDirection: 'column', gap: 6, padding: '12px 14px',
+        borderRadius: 10, cursor: 'pointer', textAlign: 'left',
+        border: active ? '1.5px solid var(--dsw-alias-state-business-primary, #3b6ef6)' : '.5px solid var(--dsw-alias-border-l3, #e5e7eb)',
+        background: active ? 'var(--dsw-alias-bg-layer-1, #fff)' : 'var(--dsw-alias-settings-card-fill, #fff)',
+        boxShadow: active ? '0 1px 3px rgba(59, 110, 246, 0.12)' : 'none',
+      }),
+      matrixGrid: { display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(220px, 1fr))', gap: 8 },
+      matrixCard: {
+        display: 'flex', flexDirection: 'column', gap: 4, padding: '10px 12px',
+        borderRadius: 8, border: '.5px solid var(--dsw-alias-border-l3, #e5e7eb)',
+        background: 'var(--dsw-alias-bg-layer-1, #fff)',
+      },
+      badge: (color) => ({
+        display: 'inline-flex', alignItems: 'center', gap: 4, padding: '2px 8px',
+        borderRadius: 999, fontSize: 10, fontWeight: 500, lineHeight: '14px',
+        background: color === 'green' ? 'rgba(46, 160, 67, 0.12)' : (color === 'blue' ? 'rgba(59, 110, 246, 0.12)' : 'rgba(100, 116, 139, 0.12)'),
+        color: color === 'green' ? '#2da44e' : (color === 'blue' ? '#3b6ef6' : '#64748b'),
+        border: '.5px solid ' + (color === 'green' ? '#2da44e' : (color === 'blue' ? '#3b6ef6' : '#64748b')),
+      }),
+      filterInput: {
+        width: '100%', boxSizing: 'border-box', font: 'inherit', fontSize: 12, lineHeight: '18px',
+        padding: '6px 10px', borderRadius: 8,
+        border: '.5px solid var(--dsw-alias-border-l4, #d0d7de)',
+        background: 'var(--dsw-alias-bg-layer-1, #fff)', color: 'inherit',
+        marginBottom: 8,
+      },
     };
 
     function asString(value, fallback) {
@@ -499,7 +601,7 @@ window.__ModuleLoader__.load({
       const initialLang = locale && locale.getSnapshot && locale.getSnapshot().active === 'en' ? 'en' : 'zh';
       const [lang, setLang] = useState(initialLang);
 
-      const [tab, setTab] = useState('access');
+      const [tab, setTab] = useState('dashboard');
       const [draft, setDraft] = useState(() => toDraft(value));
       const [busy, setBusy] = useState('');
       const [message, setMessage] = useState('');
@@ -513,6 +615,8 @@ window.__ModuleLoader__.load({
       // argoEnv 引擎开关：bool 类即时写；num/str/list 类走草稿 + 分组保存。
       const [envDraft, setEnvDraft] = useState({});
       const [envBusy, setEnvBusy] = useState('');
+      const [engineFilter, setEngineFilter] = useState('');
+      const [keyFilter, setKeyFilter] = useState('');
 
       const dirty = useRef(new Set());
       // 读-改-写共享配置字段（keyRefs / nativeTools / argoEnv）时读实时快照，
@@ -737,8 +841,9 @@ window.__ModuleLoader__.load({
       const ENV_FALSY = ['', '0', 'false', 'no', 'off', 'n', 'disable', 'disabled', 'none'];
       const envBoolState = (spec, map) => {
         const raw = map[spec.name];
-        const on = raw === undefined ? spec.def === true : !ENV_FALSY.includes(String(raw).trim().toLowerCase());
-        return spec.invert ? !on : on;
+        return raw === undefined
+          ? spec.def === true
+          : !ENV_FALSY.includes(String(raw).trim().toLowerCase());
       };
       const writeEnvLines = async (updates) => {
         const map = envMap();
@@ -754,9 +859,8 @@ window.__ModuleLoader__.load({
       };
       const toggleEnv = (spec, on) => {
         if (disabled) return;
-        // invert 语义反转：UI「开」对 invert 开关意味着 env 取 falsy
-        // （缓存开 → ARGO_NO_CACHE=0；关 → =1）。
-        const value = on === (spec.invert === true) ? '0' : '1';
+        // 开关状态直接落 0/1：文案与 env 同向（开=1，关=0），不做反转。
+        const value = on ? '1' : '0';
         void writeEnvLines({ [spec.name]: value })
           .then((ok) => report(ok, ok ? t('saved') : t('refused')))
           .catch((cause) => report(false, cause && cause.message ? cause.message : String(cause)));
@@ -795,6 +899,54 @@ window.__ModuleLoader__.load({
         }
       };
 
+      const applyPreset = async (type) => {
+        if (disabled) return;
+        setBusy('preset');
+        try {
+          const map = envMap();
+          const ops = [];
+          if (type === 'fast') {
+            map.ARGO_TFIDF_RERANK = '0';
+            map.ARGO_NUMBER_CROSSCHECK = '0';
+            map.ARGO_PAID_SEARCH = 'off';
+            map.ARGO_ADAPTIVE_GRACE = '1';
+            map.ARGO_SERIAL_STAGGER_S = '0.5';
+            ops.push({ op: 'set', path: ['searchTimeoutMs'], value: 15000 });
+            ops.push({ op: 'set', path: ['fetchTimeoutMs'], value: 15000 });
+          } else if (type === 'standard') {
+            map.ARGO_TFIDF_RERANK = '1';
+            map.ARGO_NUMBER_CROSSCHECK = '1';
+            map.ARGO_MINHASH_DEDUPE = '1';
+            map.ARGO_PAID_SEARCH = 'auto';
+            map.ARGO_ADAPTIVE_GRACE = '1';
+            map.ARGO_SERIAL_STAGGER_S = '0.8';
+            ops.push({ op: 'set', path: ['searchTimeoutMs'], value: 30000 });
+            ops.push({ op: 'set', path: ['fetchTimeoutMs'], value: 25000 });
+          } else if (type === 'deep') {
+            map.ARGO_TFIDF_RERANK = '1';
+            map.ARGO_NUMBER_CROSSCHECK = '1';
+            map.ARGO_MINHASH_DEDUPE = '1';
+            map.ARGO_SEMANTIC_EVIDENCE = '1';
+            map.ARGO_ADAPTIVE_GRACE = '1';
+            map.ARGO_PAID_SEARCH = 'auto';
+            ops.push({ op: 'set', path: ['searchTimeoutMs'], value: 45000 });
+            ops.push({ op: 'set', path: ['fetchTimeoutMs'], value: 35000 });
+            ops.push({ op: 'set', path: ['nativeTimeoutMs'], value: 60000 });
+          }
+          const envLines = Object.keys(map)
+            .filter((name) => ENV_NAMES.has(name))
+            .map((name) => `${name}=${map[name]}`);
+          ops.push({ op: 'set', path: ['argoEnv'], value: envLines });
+          const ok = await props.mutate(ops);
+          const presetName = type === 'fast' ? t('presetFast') : (type === 'standard' ? t('presetStandard') : t('presetDeep'));
+          report(ok, ok ? `${t('presetApplied')} ${presetName}` : t('refused'));
+        } catch (cause) {
+          report(false, cause && cause.message ? cause.message : String(cause));
+        } finally {
+          setBusy('');
+        }
+      };
+
       if (props.view === 'summary') {
         const summary = t('summary')
           .replace('{search}', value.searchProviderEnabled !== false ? t('on') : t('off'))
@@ -913,6 +1065,95 @@ window.__ModuleLoader__.load({
 
       const panel = [];
 
+      if (tab === 'dashboard') {
+        const configuredKeyCount = Object.values(credentials).filter((c) => c && c.configured).length;
+        const keylessEngineCount = CORE_ENGINES.filter((e) => e.keyless).length;
+        const seamSearchOn = value.searchProviderEnabled !== false;
+        const seamFetchOn = value.fetchProviderEnabled !== false;
+        const activeToolCount = asArray(value.nativeTools).length;
+        const poolConcurrency = asNumber(value.searchConcurrency, DEFAULTS.searchConcurrency);
+        const poolIdleMs = asNumber(value.searchIdleMs, DEFAULTS.searchIdleMs);
+
+        panel.push(h('div', { key: 'metrics', style: S.metricGrid }, [
+          h('div', { key: 'pool', style: S.metricCard }, [
+            h('span', { key: 'l', style: S.metricLabel }, t('poolTitle')),
+            h('div', { key: 'v', style: { display: 'flex', alignItems: 'center', gap: 6 } }, [
+              h('span', { key: 'dot', style: S.dot(true) }),
+              h('span', { key: 'val', style: S.metricValue }, `${poolConcurrency} 并发`),
+            ]),
+            h('span', { key: 's', style: S.metricSub }, `${t('poolStatusHealthy')} · 保活 ${poolIdleMs / 1000}s`),
+          ]),
+          h('div', { key: 'seam', style: S.metricCard }, [
+            h('span', { key: 'l', style: S.metricLabel }, t('accessTitle')),
+            h('span', { key: 'val', style: S.metricValue }, seamSearchOn && seamFetchOn ? '双路接管' : (seamSearchOn || seamFetchOn ? '单路接管' : '未接管')),
+            h('span', { key: 's', style: S.metricSub }, `Search: ${seamSearchOn ? 'ON' : 'OFF'} · Fetch: ${seamFetchOn ? 'ON' : 'OFF'}`),
+          ]),
+          h('div', { key: 'tools', style: S.metricCard }, [
+            h('span', { key: 'l', style: S.metricLabel }, t('toolsTitle')),
+            h('span', { key: 'val', style: S.metricValue }, `${activeToolCount} / ${TOOLS.length}`),
+            h('span', { key: 's', style: S.metricSub }, '已就绪原生 MCP 工具'),
+          ]),
+          h('div', { key: 'keys', style: S.metricCard }, [
+            h('span', { key: 'l', style: S.metricLabel }, t('keysTitle')),
+            h('span', { key: 'val', style: S.metricValue }, `${configuredKeyCount} 配置 · ${keylessEngineCount} 免密`),
+            h('span', { key: 's', style: S.metricSub }, '覆盖全局多源引擎'),
+          ]),
+        ]));
+
+        panel.push(h(Card, { key: 'presets', title: t('presetTitle'), hint: t('presetHint') }, [
+          h('div', { key: 'grid', style: S.presetGrid }, [
+            h('div', {
+              key: 'fast',
+              style: S.presetCard(false),
+              onClick: () => { void applyPreset('fast'); },
+            }, [
+              h('div', { key: 't', style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between' } }, [
+                h('span', { key: 'title', style: S.label }, t('presetFast')),
+                h('span', { key: 'badge', style: S.badge('blue') }, '15s 超时'),
+              ]),
+              h('span', { key: 'd', style: S.sub }, t('presetFastDesc')),
+            ]),
+            h('div', {
+              key: 'standard',
+              style: S.presetCard(true),
+              onClick: () => { void applyPreset('standard'); },
+            }, [
+              h('div', { key: 't', style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between' } }, [
+                h('span', { key: 'title', style: S.label }, t('presetStandard')),
+                h('span', { key: 'badge', style: S.badge('green') }, '标准生产'),
+              ]),
+              h('span', { key: 'd', style: S.sub }, t('presetStandardDesc')),
+            ]),
+            h('div', {
+              key: 'deep',
+              style: S.presetCard(false),
+              onClick: () => { void applyPreset('deep'); },
+            }, [
+              h('div', { key: 't', style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between' } }, [
+                h('span', { key: 'title', style: S.label }, t('presetDeep')),
+                h('span', { key: 'badge', style: S.badge('blue') }, '深度核验'),
+              ]),
+              h('span', { key: 'd', style: S.sub }, t('presetDeepDesc')),
+            ]),
+          ]),
+        ]));
+
+        panel.push(h(Card, { key: 'matrix', title: t('matrixTitle'), hint: t('matrixHint') }, [
+          h('div', { key: 'grid', style: S.matrixGrid }, CORE_ENGINES.map((engine) => {
+            const hasKey = engine.ref && credentials[engine.ref] && credentials[engine.ref].configured;
+            const badgeType = hasKey ? 'green' : (engine.keyless ? 'blue' : 'gray');
+            const badgeText = hasKey ? t('matrixConfigured') : (engine.keyless ? t('matrixKeyless') : t('matrixPending'));
+            return h('div', { key: engine.id, style: S.matrixCard }, [
+              h('div', { key: 'h', style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: 6 } }, [
+                h('span', { key: 'n', style: S.label }, lang === 'en' ? engine.nameEn : engine.nameZh),
+                h('span', { key: 'b', style: S.badge(badgeType) }, badgeText),
+              ]),
+              h('span', { key: 'r', style: S.sub }, lang === 'en' ? engine.roleEn : engine.roleZh),
+            ]);
+          })),
+        ]));
+      }
+
       if (tab === 'access') {
         panel.push(h(Card, { key: 'seam', title: t('accessTitle') }, [
           h(Switch, {
@@ -1007,15 +1248,50 @@ window.__ModuleLoader__.load({
 
       if (tab === 'engines') {
         const map = envMap();
-        const groups = ['cache', 'fetch', 'semantic', 'engines', 'net', 'local', 'misc'];
+        // 渲染顺序即面板顺序。**不是**从 ENGINE_TOGGLES 去重推导——那样分组
+        // 顺序会随白名单增删而漂移，用户每次升级都看到重排的面板。
+        //
+        // 历史 bug（2026-10-21 定位）：`paid` 一度不在这个清单里，于是
+        // ARGO_PAID_SEARCH 与 ARGO_BUDGET_DEEPSEEK_SEARCH 两条开关在
+        // index.js 白名单、client.js ENGINE_TOGGLES、双语文案三处都齐全，
+        // 却在面板上完全不显示——用户配好了预算却找不到入口，还以为是插件
+        // 没装。漂移门禁只核对「两边名单同集合、字段一致」，核对不到「这个
+        // 分组到底渲不渲染」；已由 test/client.test.js 的「engines tab renders
+        // a control for every ENGINE_TOGGLES switch」补上（见该测试注释）。
+        const groups = ['cache', 'fetch', 'semantic', 'engines', 'net', 'local', 'paid', 'misc'];
         const groupTitle = (group) => t('group' + group.charAt(0).toUpperCase() + group.slice(1));
         panel.push(h('p', { key: 'hint', style: S.hint }, t('enginesHint')));
+        panel.push(h('input', {
+          key: 'filter',
+          type: 'text',
+          style: S.filterInput,
+          placeholder: t('searchFilterPlaceholder'),
+          value: engineFilter,
+          onChange: (event) => setEngineFilter(event.target.value),
+        }));
+        const query = engineFilter.trim().toLowerCase();
         for (const group of groups) {
-          const specs = ENGINE_TOGGLES.filter((spec) => spec.group === group);
+          let specs = ENGINE_TOGGLES.filter((spec) => spec.group === group);
+          if (query) {
+            const groupNameMatch = group.toLowerCase().includes(query) || groupTitle(group).toLowerCase().includes(query);
+            if (!groupNameMatch) {
+              specs = specs.filter((spec) => {
+                const name = spec.name.toLowerCase();
+                const zh = (spec.zh || '').toLowerCase();
+                const en = (spec.en || '').toLowerCase();
+                const hintZh = (spec.hintZh || '').toLowerCase();
+                const hintEn = (spec.hintEn || '').toLowerCase();
+                return name.includes(query) || zh.includes(query) || en.includes(query) || hintZh.includes(query) || hintEn.includes(query);
+              });
+            }
+          }
           if (specs.length === 0) continue;
           const bools = specs.filter((spec) => spec.kind === 'bool');
           const fields = specs.filter((spec) => spec.kind !== 'bool');
           const children = [];
+          if (group === 'paid') {
+            children.push(h('p', { key: 'groupHint', style: S.hint }, t('groupPaidHint')));
+          }
           for (const spec of bools) {
             // 未配置时显示 argo 默认态并标注「默认」，配置过的显示自定义值，
             // 让「这一行到底生不生效」在面板上一眼可辨。
@@ -1078,10 +1354,22 @@ window.__ModuleLoader__.load({
       }
 
       if (tab === 'keys') {
+        const query = keyFilter.trim().toLowerCase();
+        const displayKeys = query
+          ? KEYS.filter((entry) => entry.ref.toLowerCase().includes(query) || (entry.zh && entry.zh.toLowerCase().includes(query)) || (entry.en && entry.en.toLowerCase().includes(query)))
+          : visibleKeys;
         panel.push(h(Card, { key: 'keys', title: t('keysTitle'), hint: t('keysHint') }, [
-          h('span', { key: 'l', style: S.label }, t('commonKeys')),
-          ...visibleKeys.map(keyRow),
-          h('div', { key: 'a', style: S.actions }, [
+          h('input', {
+            key: 'filter',
+            type: 'text',
+            style: S.filterInput,
+            placeholder: t('searchFilterPlaceholder'),
+            value: keyFilter,
+            onChange: (event) => setKeyFilter(event.target.value),
+          }),
+          h('span', { key: 'l', style: S.label }, query ? t('keysTitle') : t('commonKeys')),
+          ...displayKeys.map(keyRow),
+          query ? null : h('div', { key: 'a', style: S.actions }, [
             h('button', {
               key: 'more',
               type: 'button',
@@ -1178,6 +1466,7 @@ window.__ModuleLoader__.load({
           h('p', { key: 'i', style: S.hint }, t('intro')),
         ]),
         h('div', { key: 'tabs', style: S.tabs }, [
+          tabButton('dashboard', t('tabDashboard')),
           tabButton('access', t('tabAccess')),
           tabButton('tools', t('tabTools')),
           tabButton('engines', t('tabEngines')),

package/packages/dsh-plugin/dsh/diagnostics.js

@@ -0,0 +1,54 @@
+/*
+ * diagnostics.js — argo-dsh 运行时监控与连接池只读诊断
+ *
+ * 为设置面板、外部插件或排查脚本提供只读状态自省能力，
+ * 避免状态探查逻辑与核心检索逻辑耦合。
+ */
+
+/**
+ * 获取当前常驻 MCP 连接池的运行时指标。
+ *
+ * @param {Array} pool - MCP 连接池实例数组
+ * @returns {Object} 包含连接数、当前负载以及各连接健康状态的快照
+ */
+export function getMcpPoolStats(pool = []) {
+  const connections = pool.map((conn, index) => ({
+    index,
+    load: typeof conn.load === 'function' ? conn.load() : 0,
+    hasProcess: Boolean(conn.proc ?? true),
+  }))
+
+  const totalLoad = connections.reduce((sum, item) => sum + item.load, 0)
+
+  return {
+    poolSize: pool.length,
+    activeConnections: pool.filter(conn => typeof conn.load === 'function' && conn.load() > 0).length,
+    totalLoad,
+    connections,
+    timestamp: Date.now(),
+  }
+}
+
+/**
+ * 诊断并重置 MCP 连接池。
+ *
+ * @param {Array} pool - MCP 连接池实例数组
+ * @param {Function} disposeFn - 释放函数
+ * @returns {Object} 重置结果摘要
+ */
+export function resetMcpPool(pool = [], disposeFn) {
+  const beforeCount = pool.length
+  if (typeof disposeFn === 'function') {
+    disposeFn()
+  } else {
+    for (const conn of [...pool]) {
+      try { conn.close?.() } catch { /* ignore */ }
+    }
+    pool.length = 0
+  }
+  return {
+    evictedCount: beforeCount,
+    poolSizeNow: pool.length,
+    success: true,
+  }
+}