dsh-mcp-connector 0.2.3 → 0.2.4

package/CHANGELOG.md

@@ -4,6 +4,23 @@
 
 ## [Unreleased]
 
+## [0.2.4] - 2026-08-21
+
+### Added
+
+- 新增主动连接健康检查，支持 OAuth grant、Bearer/API Key 与无鉴权 MCP initialize 握手，并以 4 并发、5 秒单连接上限避免刷新风暴。
+- 新增 `mcp_connector_health_check` 对话工具和同源 Web API，可检查单个或全部已配置连接器。
+
+### Changed
+
+- 市场卡片和“已安装”列表不再把“本机存在配置”等同于“当前可用”，改为展示已配置、已连接、需重新授权、部分异常、连接异常或已停用。
+- 首次打开市场会在后台执行一次限流健康检查；用户点击“刷新”时同步刷新目录和连接状态。
+
+### Fixed
+
+- OAuth 过期/缺失或历史 Key 失效后，不再继续显示“已连接”；详情页会暂停 Prompt 发送并提供重新授权/重新配置入口。
+- 网络、DNS、TLS 或服务端异常与凭据异常分开呈现，避免误导用户重复录入 Key。
+
 ## [0.2.3] - 2026-08-21
 
 ### Added
@@ -102,7 +119,8 @@
 - 外部 URL 与导入 Header 执行安全校验。
 - iframe 消息校验同源和消息来源。
 
-[Unreleased]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.3...HEAD
+[Unreleased]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.4...HEAD
+[0.2.4]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.3...v0.2.4
 [0.2.3]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.2...v0.2.3
 [0.2.2]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.1...v0.2.2
 [0.2.1]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.0...v0.2.1

package/README.en.md

@@ -13,7 +13,7 @@ Browse and install MCP connectors from different providers in DeepSeek Harness D
 ## Features
 
 - A primary sidebar entry below New Conversation and above workspaces/conversations, with a public footer-slot fallback for incompatible DSH DOM versions.
-- Searchable Marketplace and Installed views with connection status and catalog refresh.
+- Searchable Marketplace and Installed views with catalog refresh and active health checks that distinguish Configured, Connected, Reauthorization Required, Partially Unavailable, and Connection Error states.
 - OAuth 2.0 Authorization Code with PKCE, API key/Bearer/unauthenticated URL configuration, and `mcpServers` JSON import.
 - Installation from a credential-free connector descriptor URL.
 - Credential and MCP initialize validation before API-key connectors are saved as installed.
@@ -97,7 +97,7 @@ npm run dev:ui
 
 `npm run check` performs syntax checks, automated tests, and an npm package allowlist/sensitive-content audit. Tags matching `v*` trigger GitHub Actions; the tag must match `package.json`. npm releases use Trusted Publishing through GitHub OIDC and do not require a long-lived `NPM_TOKEN`.
 
-The current public version is [`dsh-mcp-connector@0.2.2`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.2](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.2).
+The current public version is [`dsh-mcp-connector@0.2.4`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.4](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.4).
 
 See [CHANGELOG.md](CHANGELOG.md) for version history and [docs/DESKTOP-E2E.md](docs/DESKTOP-E2E.md) for the Desktop release checklist.
 

package/README.md

@@ -13,7 +13,7 @@
 ## 功能
 
 - 左侧主导航入口：目标位置为“新会话”下方、“工作区/会话列表”上方；若 DSH DOM 结构不兼容，自动回退到底部公开插槽。
-- 图形化市场：市场/已安装、搜索、连接状态与刷新。
+- 图形化市场：市场/已安装、搜索、刷新与主动健康检查；区分“已配置”、“已连接”、“需重新授权”、“部分异常”和“连接异常”。
 - 图形化添加：手动 URL/鉴权、`mcpServers` JSON、连接器描述 URL 三种入口，失败时保留表单并给出修复建议。
 - 连接器详情：精选 Prompt 优先展示，点击可带入 DSH 新会话；工具按 Server 分组，支持描述、搜索和独立滚动。
 - Prompt 模板：使用 `{{company}}` 等变量，发送前填写真实查询主体。
@@ -24,7 +24,7 @@
 - 独立远程 Registry：新市场卡片合并后客户端刷新即可见，无需重新发布 npm；远程不可用时自动回退内置目录。
 - Registry 工具链：Schema/唯一性/密钥审计、MCP/OAuth 无凭据探针、每周健康巡检。
 - 平滑迁移：显式扫描并复制两个旧企查查 OAuth 插件授权；不删除原插件或原凭据。
-- 对话工具：`mcp_connector_catalog`、`connect`、`configure`、`import_json`、`install_from_url`、`status`、`set_enabled`、`disconnect`、`refresh_catalog`、`publish`、`tools_list`。
+- 对话工具：`mcp_connector_catalog`、`connect`、`configure`、`import_json`、`install_from_url`、`status`、`health_check`、`set_enabled`、`disconnect`、`refresh_catalog`、`publish`、`tools_list`。
 
 当前市场前 4 张为企查查连接器，第 5 张为“北大法宝·法律检索”，第 6 张为“Wind·股票数据”；插件架构不限定厂商。
 
@@ -93,7 +93,7 @@ npm run dev:ui
 
 `check` 执行语法检查、自动测试和 npm 发布包白名单校验；`dev:ui` 启动不含真实凭据的本地 mock 市场。CI 使用 `--legacy-peer-deps` 安装显式测试依赖，DSH 运行期 peer 仍由 Host 提供。`v*` Tag 会触发 GitHub Actions；Tag 必须与 `package.json` 版本一致。Release 通过 npm Trusted Publishing (GitHub OIDC) 发布，不依赖长期 `NPM_TOKEN`。
 
-当前公开版本为 [`dsh-mcp-connector@0.2.2`](https://www.npmjs.com/package/dsh-mcp-connector)，对应 [GitHub Release v0.2.2](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.2)。
+当前公开版本为 [`dsh-mcp-connector@0.2.4`](https://www.npmjs.com/package/dsh-mcp-connector)，对应 [GitHub Release v0.2.4](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.4)。
 
 版本能力与变更记录见 [CHANGELOG.md](CHANGELOG.md)。
 Desktop 发版回归见 [docs/DESKTOP-E2E.md](docs/DESKTOP-E2E.md)。

package/lib/index.js

@@ -77,6 +77,7 @@ export async function apply(ctx, config) {
     overrides: new Map(),       // id -> { published?, featured? }
     connections: new Map(),     // key -> ConnectionRecord
     grants: new Map(),          // grantKey -> { grant, timer, refreshPromise, needsReauth }
+    health: new Map(),          // connectorId -> 最近一次主动连通性检查摘要（不持久化）
   };
 
   /* ───────────────────────── 目录加载 ───────────────────────── */
@@ -195,6 +196,7 @@ export async function apply(ctx, config) {
 
   async function persistRecord(record) {
     state.connections.set(record.key, record);
+    if (record.connectorId) state.health.delete(record.connectorId);
     if (config.persistSecrets) await connectionStore.put(record);
   }
 
@@ -206,11 +208,73 @@ export async function apply(ctx, config) {
     return merged;
   }
 
+  function grantFailure(record) {
+    if (record.auth?.mode !== 'oauth') return null;
+    const grantKey = record.auth.grantKey;
+    const entry = grantKey ? state.grants.get(grantKey) : null;
+    if (!entry) return { ok: false, kind: 'auth', serverKey: record.serverKey, serverName: record.serverName, message: 'OAuth 授权缺失，请重新授权' };
+    if (entry.needsReauth || entry.grant.accessTokenExpiresAt <= Date.now()) {
+      return { ok: false, kind: 'auth', serverKey: record.serverKey, serverName: record.serverName, message: 'OAuth 授权已过期或刷新失败，请重新授权' };
+    }
+    return null;
+  }
+
+  function healthSummary(connectorId, records, results, checkedAt = Date.now()) {
+    const enabledRecords = records.filter((record) => record.enabled !== false);
+    const availableServers = results.filter((result) => result.ok).length;
+    const failedServers = results.length - availableServers;
+    const authFailures = results.filter((result) => !result.ok && result.kind === 'auth').length;
+    let connectionState = 'configured';
+    if (records.length === 0) connectionState = 'disconnected';
+    else if (enabledRecords.length === 0) connectionState = 'disabled';
+    else if (failedServers === 0 && availableServers > 0) connectionState = 'healthy';
+    else if (availableServers > 0) connectionState = 'degraded';
+    else if (authFailures > 0) connectionState = 'reauth';
+    else if (failedServers > 0) connectionState = 'unavailable';
+    const labels = {
+      disconnected: '未连接', configured: '已配置', disabled: '已停用', healthy: '已连接',
+      degraded: '部分异常', reauth: '需重新授权', unavailable: '连接异常',
+    };
+    return {
+      connectorId,
+      connectionState,
+      label: labels[connectionState],
+      configuredServers: records.length,
+      enabledServers: enabledRecords.length,
+      availableServers,
+      failedServers,
+      checkedAt,
+      results,
+    };
+  }
+
+  function connectorHealth(connectorId) {
+    const records = [...state.connections.values()].filter((record) => record.connectorId === connectorId);
+    if (records.length === 0) return healthSummary(connectorId, records, [], null);
+    if (records.every((record) => record.enabled === false)) return healthSummary(connectorId, records, [], null);
+    const immediateFailures = records.filter((record) => record.enabled !== false).map(grantFailure).filter(Boolean);
+    if (immediateFailures.length > 0) return healthSummary(connectorId, records, immediateFailures, Date.now());
+    const cached = state.health.get(connectorId);
+    return cached ?? {
+      ...healthSummary(connectorId, records, [], null),
+      connectionState: 'configured',
+      label: '已配置',
+    };
+  }
+
+  function cacheHealth(connectorId, records, results) {
+    const summary = healthSummary(connectorId, records, results);
+    state.health.set(connectorId, summary);
+    return summary;
+  }
+
   /* ───────────────────────── api 门面 ───────────────────────── */
 
   const api = {
     async catalog({ category, keyword } = {}) {
-      const items = listCatalog(state.merged, { category, keyword, publishedOnly: true }).map((d) => ({
+      const items = listCatalog(state.merged, { category, keyword, publishedOnly: true }).map((d) => {
+        const health = connectorHealth(d.id);
+        return ({
         id: d.id,
         name: d.name,
         vendor: d.vendor,
@@ -234,13 +298,19 @@ export async function apply(ctx, config) {
         probeReportUrl: d.probeReportUrl,
         toolsSnapshot: d.toolsSnapshot ?? [],
         connected: [...state.connections.values()].filter((r) => r.connectorId === d.id).map((r) => r.key),
+        connectionState: health.connectionState,
+        connectionLabel: health.label,
+        healthCheckedAt: health.checkedAt,
+        availableServers: health.availableServers,
+        failedServers: health.failedServers,
         servers: (d.servers ?? []).map((s) => ({
           serverKey: s.serverKey,
           url: s.url,
           transport: s.transport,
           serverName: s.serverName,
         })),
-      }));
+        });
+      });
       return {
         ok: true,
         message: `共 ${items.length} 个已上架连接器`,
@@ -374,6 +444,7 @@ export async function apply(ctx, config) {
             await upsertRecord(record);
             created.push(record.key);
           }
+          cacheHealth(connector.id, records, validation.detail.results);
           return {
             ok: true,
             message: `已配置并连接 "${connector.name}"（${created.length} 个 MCP Server）`,
@@ -435,6 +506,8 @@ export async function apply(ctx, config) {
     async status() {
       const items = [];
       for (const [key, record] of state.connections) {
+        const health = record.connectorId ? connectorHealth(record.connectorId) : null;
+        const recordHealth = health?.results?.find((result) => result.serverKey === record.serverKey || result.serverName === record.serverName);
         let grantInfo = null;
         if (record.auth?.grantKey) {
           const g = state.grants.get(record.auth.grantKey);
@@ -457,11 +530,57 @@ export async function apply(ctx, config) {
           authMode: record.auth?.mode ?? 'none',
           grant: grantInfo,
           lastError: record.lastError ?? null,
+          connectionState: recordHealth?.ok ? 'healthy' : recordHealth ? health.connectionState : health?.connectionState ?? 'configured',
+          healthCheckedAt: health?.checkedAt ?? null,
+          healthMessage: recordHealth?.message ?? null,
         });
       }
       return { ok: true, message: `共 ${items.length} 条连接`, detail: { items } };
     },
 
+    async healthCheck(connectorId) {
+      const targetIds = connectorId
+        ? [String(connectorId)]
+        : [...new Set([...state.connections.values()].map((record) => record.connectorId).filter(Boolean))];
+      const summaries = [];
+      for (const id of targetIds) {
+        const records = [...state.connections.values()].filter((record) => record.connectorId === id);
+        const enabledRecords = records.filter((record) => record.enabled !== false);
+        if (records.length === 0 || enabledRecords.length === 0) {
+          const summary = healthSummary(id, records, [], Date.now());
+          state.health.set(id, summary);
+          summaries.push(summary);
+          continue;
+        }
+        const immediateResults = [];
+        const checkable = [];
+        for (const record of enabledRecords) {
+          const failure = grantFailure(record);
+          if (failure) immediateResults.push(failure);
+          else checkable.push(record);
+        }
+        let checkedResults = [];
+        if (checkable.length > 0) {
+          const validation = await validateConnectionRecords(checkable, {
+            timeoutMs: Math.min(config.requestTimeoutMs, 5_000),
+            concurrency: 4,
+            grants: grantMap(),
+          });
+          checkedResults = validation.detail.results;
+        }
+        summaries.push(cacheHealth(id, records, [...immediateResults, ...checkedResults]));
+      }
+      const healthy = summaries.filter((item) => item.connectionState === 'healthy').length;
+      const attention = summaries.filter((item) => ['reauth', 'degraded', 'unavailable'].includes(item.connectionState)).length;
+      return {
+        ok: true,
+        message: targetIds.length === 0
+          ? '暂无已配置连接'
+          : `已检查 ${summaries.length} 个连接器：${healthy} 个正常${attention ? `，${attention} 个需处理` : ''}`,
+        detail: { items: summaries, healthy, attention },
+      };
+    },
+
     async migrationPreview({ scanStored = false } = {}) {
       const { candidates, warnings } = await readLegacyGrantCandidates(ctx.storageDomain, { openClosed: scanStored });
       const plans = planLegacyMigration(candidates, state.merged, state.connections);
@@ -533,6 +652,7 @@ export async function apply(ctx, config) {
       if (record.auth?.grantKey) {
         await remove(ctx, config, record);
         state.connections.delete(key);
+        if (record.connectorId) state.health.delete(record.connectorId);
         if (config.persistSecrets) await connectionStore.delete(key).catch(() => {});
         const stillUsed = [...state.connections.values()].some((r) => r.auth?.grantKey === record.auth.grantKey);
         if (!stillUsed) {
@@ -558,6 +678,7 @@ export async function apply(ctx, config) {
 
       await remove(ctx, config, record);
       state.connections.delete(key);
+      if (record.connectorId) state.health.delete(record.connectorId);
       if (config.persistSecrets) await connectionStore.delete(key).catch(() => {});
       return { ok: true, message: `已断开 "${record.name}"` };
     },
@@ -640,7 +761,14 @@ export async function apply(ctx, config) {
             const error = response.status === 401 || response.status === 403
               ? `凭据无效、已过期或权限不足（HTTP ${response.status}）`
               : `HTTP ${response.status}`;
-            servers.push({ serverKey: record.serverKey || record.name, serverName: record.serverName, ok: false, error, tools: [] });
+            servers.push({
+              serverKey: record.serverKey || record.name,
+              serverName: record.serverName,
+              ok: false,
+              error,
+              errorKind: response.status === 401 || response.status === 403 ? 'auth' : 'http',
+              tools: [],
+            });
             continue;
           }
 
@@ -682,6 +810,9 @@ export async function apply(ctx, config) {
       const totalTools = servers.reduce((sum, s) => sum + (s.tools?.length || 0), 0);
       const availableServers = servers.filter((server) => server.ok).length;
       const failedServers = servers.length - availableServers;
+      const health = cacheHealth(connectorId, records, servers.map((server) => server.ok
+        ? { ok: true, kind: 'connected', serverKey: server.serverKey, serverName: server.serverName }
+        : { ok: false, kind: server.errorKind ?? 'network', serverKey: server.serverKey, serverName: server.serverName, message: server.error }));
       const failureSummary = servers.filter((server) => !server.ok).slice(0, 3)
         .map((server) => `${server.serverName || server.serverKey}：${server.error}`).join('；');
       return {
@@ -689,7 +820,7 @@ export async function apply(ctx, config) {
         message: failedServers > 0
           ? `工具加载失败：${failureSummary}${failedServers > 3 ? `；另有 ${failedServers - 3} 个 Server 不可用` : ''}${availableServers > 0 ? `；${availableServers} 个 Server 仍可用` : ''}`
           : `共 ${servers.length} 个 server，${totalTools} 个工具`,
-        detail: { connectorId, servers, totalTools, availableServers, failedServers },
+        detail: { connectorId, servers, totalTools, availableServers, failedServers, connectionState: health.connectionState },
       };
     },
   };

package/lib/mcp-validation.js

@@ -82,7 +82,7 @@ function failed(record, kind, message, extra = {}) {
   };
 }
 
-export async function validateConnectionRecord(record, { timeoutMs = 15_000, fetchImpl = fetch } = {}) {
+export async function validateConnectionRecord(record, { timeoutMs = 15_000, fetchImpl = fetch, grants = new Map() } = {}) {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(new Error('timeout')), timeoutMs);
   try {
@@ -91,7 +91,7 @@ export async function validateConnectionRecord(record, { timeoutMs = 15_000, fet
       headers: {
         'Content-Type': 'application/json',
         Accept: 'application/json, text/event-stream',
-        ...authHeaders(record, new Map()),
+        ...authHeaders(record, grants),
       },
       body: JSON.stringify({
         jsonrpc: '2.0',
@@ -153,7 +153,18 @@ export async function validateConnectionRecord(record, { timeoutMs = 15_000, fet
 }
 
 export async function validateConnectionRecords(records, options = {}) {
-  const results = await Promise.all(records.map((record) => validateConnectionRecord(record, options)));
+  const concurrency = Math.max(1, Math.min(Number(options.concurrency) || records.length || 1, records.length || 1));
+  const results = new Array(records.length);
+  let cursor = 0;
+  const workers = Array.from({ length: concurrency }, async () => {
+    for (;;) {
+      const index = cursor;
+      cursor += 1;
+      if (index >= records.length) return;
+      results[index] = await validateConnectionRecord(records[index], options);
+    }
+  });
+  await Promise.all(workers);
   const failures = results.filter((result) => !result.ok);
   if (failures.length === 0) {
     return { ok: true, message: `已验证 ${results.length} 个 MCP Server`, detail: { results } };

package/lib/tools.js

@@ -29,7 +29,7 @@ const catalogOutput = {
       lines.push('');
       for (const it of items) {
         const star = it.featured ? '⭐ ' : '';
-        const connected = it.connected?.length ? `（已连接 ${it.connected.length}）` : '';
+        const connected = it.connected?.length ? `（${it.connectionLabel || '已配置'} ${it.connected.length}）` : '';
         const summary = it.summary ? ` — ${it.summary}` : '';
         lines.push(`- ${star}[${it.id}] ${it.name} · ${it.category} · ${it.authMode}${connected}${summary}`);
       }
@@ -47,7 +47,8 @@ const statusOutput = {
     if (items.length) {
       lines.push('');
       for (const it of items) {
-        const state = it.enabled ? '启用' : '停用';
+        const stateLabels = { healthy: '已连接', configured: '已配置', reauth: '需重新授权', degraded: '部分异常', unavailable: '连接异常', disabled: '已停用' };
+        const state = it.enabled ? (stateLabels[it.connectionState] || '已配置') : '停用';
         const auth = it.authMode === 'oauth'
           ? it.grant?.needsReauth ? 'oauth(需重新授权)' : it.grant?.missing ? 'oauth(授权缺失)' : 'oauth'
           : it.authMode;
@@ -180,6 +181,23 @@ export function registerTools(ctx, api) {
     },
   });
 
+  reg({
+    name: 'mcp_connector_health_check',
+    description: '主动检查已配置 MCP 连接的 initialize 握手、凭据和网络状态。可指定 connectorId，留空则检查全部已配置连接器。',
+    parameters: {
+      type: 'object',
+      properties: {
+        connectorId: { type: 'string', description: '连接器 id（可选）' },
+      },
+      additionalProperties: false,
+    },
+    output: resultOutput,
+    timeoutMs: 120_000,
+    async execute(args) {
+      return api.healthCheck(args?.connectorId);
+    },
+  });
+
   reg({
     name: 'mcp_connector_migration_preview',
     description:

package/lib/web.js

@@ -19,6 +19,7 @@ const UI_DIR = join(dirname(fileURLToPath(import.meta.url)), '..', 'ui');
 const API_WHITELIST = new Map([
   ['catalog', (api, p) => api.catalog(p ?? {})],
   ['status', (api) => api.status()],
+  ['healthCheck', (api, p) => api.healthCheck(p?.connectorId)],
   ['migrationPreview', (api, p) => api.migrationPreview(p ?? {})],
   ['migrateLegacy', (api, p) => api.migrateLegacy(p?.candidateIds ?? [])],
   ['connect', (api, p) => api.connect(p?.connectorId, p?.serverKey)],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mcp-connector",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "General-purpose MCP Connector Marketplace for DeepSeek Harness with OAuth 2.0 PKCE, API key/URL, JSON import, tool discovery, prompt templates, and connection management.",
   "type": "module",
   "main": "lib/index.js",

package/scripts/ui-harness.mjs

@@ -11,6 +11,7 @@ const catalog = JSON.parse(await readFile(join(root, 'catalog/catalog.json'), 'u
   .filter((item) => item.published !== false)
   .map(normalizeConnectorDescriptor);
 const connected = new Set(['qcc-company']);
+const healthStates = new Map();
 const bundledAssets = new Map([
   ['qcc-logo.svg', 'image/svg+xml'],
   ['pkulaw-logo.png', 'image/png'],
@@ -47,13 +48,21 @@ const server = createServer(async (req, res) => {
       credentialDescription: item.auth.credentialDescription,
       credentialHelpLabel: item.auth.credentialHelpLabel,
       connected: connected.has(item.id) ? [`${item.id}-main`] : [],
+      connectionState: connected.has(item.id) ? (healthStates.get(item.id) ?? 'configured') : 'disconnected',
+      connectionLabel: healthStates.get(item.id) === 'healthy' ? '已连接' : connected.has(item.id) ? '已配置' : '未连接',
     })) } }); return;
   }
   if (method === 'status') { json(res, { ok: true, detail: { items: [] } }); return; }
   if (method === 'migrationPreview') { json(res, { ok: true, detail: { pendingCount: 0, items: [] } }); return; }
   if (method === 'toolsList') {
     const tools = Array.from({ length: 125 }, (_, index) => ({ name: `tool_${String(index + 1).padStart(3, '0')}`, title: `工具 ${index + 1}`, description: `用于验证分批渲染与搜索的第 ${index + 1} 个工具。` }));
-    json(res, { ok: true, detail: { totalTools: tools.length, servers: [{ serverKey: 'company', serverName: 'qcc-company', ok: true, tools }] } }); return;
+    healthStates.set(params.connectorId, 'healthy');
+    json(res, { ok: true, detail: { totalTools: tools.length, connectionState: 'healthy', servers: [{ serverKey: 'company', serverName: 'qcc-company', ok: true, tools }] } }); return;
+  }
+  if (method === 'healthCheck') {
+    const ids = params.connectorId ? [params.connectorId] : [...connected];
+    ids.forEach((id) => healthStates.set(id, 'healthy'));
+    json(res, { ok: true, message: `已检查 ${ids.length} 个连接器：${ids.length} 个正常`, detail: { items: ids.map((connectorId) => ({ connectorId, connectionState: 'healthy' })) } }); return;
   }
   if (method === 'connect') { connected.add(params.connectorId); json(res, { ok: true, message: 'Mock 连接成功' }); return; }
   if (method === 'configure') {

package/ui/index.html

@@ -146,6 +146,10 @@
   .btn.ghost:hover { border-color: var(--accent); color: var(--accent); }
   .btn.danger { background: transparent; border: 1px solid #fecaca; color: var(--bad); }
   .btn.danger:hover { border-color: var(--bad); background: var(--bad-bg); }
+  .btn.status-warning { background: var(--warn-bg); border: 1px solid #fde68a; color: #92400e; }
+  .btn.status-warning:hover { background: #fef3c7; border-color: var(--warn); }
+  .btn.status-bad { background: var(--bad-bg); border: 1px solid #fecaca; color: var(--bad); }
+  .btn.status-bad:hover { background: #fee2e2; border-color: var(--bad); }
   .btn:disabled { opacity: .5; cursor: not-allowed; }
 
   /* Installed rows */
@@ -423,7 +427,8 @@
   const toast = $('#toast');
   const searchInput = $('#search');
   const LABELS = {
-    details: '详情', connect: '连接', connected: '已连接', configure: '配置',
+    details: '详情', connect: '连接', connected: '已连接', configured: '已配置', configure: '配置',
+    reauthorize: '需重新授权', connectionError: '连接异常', partialError: '部分异常', disabled: '已停用',
     send: '发送', fillSend: '填写并发送', connectToUse: '连接后使用', try: '💬 去试试',
     connectTry: '🔗 连接后试用', configureConnect: '🔑 录入凭据并连接',
     reconfigureCredential: '🔑 重新配置凭据', loading: '加载中…',
@@ -448,6 +453,7 @@
   let detailConnector = null;
   let detailToolServers = [];
   let detailNeedsReconfigure = false;
+  let detailFailureState = '';
   let toolRenderLimit = 50;
   let detailLoadId = 0;
   let catalogRenderLimit = 60;
@@ -457,6 +463,7 @@
   const PROMPT_RESULT_TYPE = 'mcp-connector:start-session-result';
   let promptRequestId = null;
   let promptRequestTimer = null;
+  let initialHealthCheckStarted = false;
 
   async function call(method, params) {
     try {
@@ -658,7 +665,7 @@
       || (d.tags || []).some(t => t.toLowerCase().includes(q));
   }
 
-  async function loadMarket() {
+  async function loadMarket({ checkHealth = true } = {}) {
     main.innerHTML = '<div class="empty">加载中…</div>';
     const r = await call('catalog', {});
     if (!r.ok) { main.innerHTML = `<div class="empty">${esc(r.message)}</div>`; return; }
@@ -670,14 +677,19 @@
     const count = filtered.length;
     const visible = filtered.slice(0, catalogRenderLimit);
     main.innerHTML = `<div class="stats"><span class="count">共 <strong>${count}</strong> 个连接器${searchQuery ? ` · 搜索「${esc(searchQuery)}」` : ''} · 点击卡片查看能力，点击「连接」完成授权</span></div><div class="grid">${visible.map(cardHtml).join('')}</div>${visible.length < count ? `<button class="tools-more" id="catalog-more" type="button">再显示 ${Math.min(60, count - visible.length)} 个（剩余 ${count - visible.length}）</button>` : ''}`;
+    if (checkHealth && !initialHealthCheckStarted && items.some((item) => item.connected?.length > 0)) {
+      initialHealthCheckStarted = true;
+      call('healthCheck', {}).then(() => {
+        if (view === 'market') loadMarket({ checkHealth: false });
+      });
+    }
   }
 
   function cardHtml(d) {
-    const connected = d.connected?.length > 0;
     const icon = isImageIcon(d.icon)
       ? `<img src="${esc(d.icon)}" alt="" onerror="this.parentElement.innerHTML='🔌';" />`
       : `<span>${esc(d.icon || '🔌')}</span>`;
-    const actions = actionHtml(d, connected);
+    const actions = actionHtml(d);
     const probe = d.probeStatus && d.probeStatus !== 'unverified' ? `<span class="badge ${esc(d.probeStatus)}">${d.probeStatus}</span>` : '';
     return `<div class="card ${d.featured ? 'featured' : ''}" data-id="${esc(d.id)}" role="button" tabindex="0" aria-label="查看 ${esc(d.name)} 详情" onclick="window.__mcp.showDetail('${esc(d.id)}')" onkeydown="if(event.key==='Enter'||event.key===' '){event.preventDefault();window.__mcp.showDetail('${esc(d.id)}')}">
       <div class="icon">${icon}</div>
@@ -689,17 +701,24 @@
     </div>`;
   }
 
-  function actionHtml(d, connected) {
+  function actionHtml(d) {
     const id = esc(d.id);
+    const configured = d.connected?.length > 0;
+    const state = d.connectionState || (configured ? 'configured' : 'disconnected');
+    if (configured) {
+      if (state === 'healthy') return `<button class="btn ghost" type="button" onclick="event.stopPropagation();window.__mcp.showDetail('${id}')">${t('details')}</button><button class="btn ghost" disabled>${t('connected')}</button>`;
+      if (state === 'configured') return `<button class="btn ghost" type="button" onclick="event.stopPropagation();window.__mcp.showDetail('${id}')">${t('details')}</button><button class="btn ghost" disabled>${t('configured')}</button>`;
+      if (state === 'disabled') return `<button class="btn ghost" type="button" onclick="event.stopPropagation();window.__mcp.showDetail('${id}')">${t('details')}</button><button class="btn ghost" disabled>${t('disabled')}</button>`;
+      if (state === 'reauth') return `<button class="btn ghost" type="button" onclick="event.stopPropagation();window.__mcp.showDetail('${id}')">${t('details')}</button><button class="btn status-warning" type="button" onclick="event.stopPropagation();window.__mcp.showDetail('${id}')">${t('reauthorize')}</button>`;
+      if (state === 'degraded') return `<button class="btn ghost" type="button" onclick="event.stopPropagation();window.__mcp.showDetail('${id}')">${t('details')}</button><button class="btn status-warning" type="button" onclick="event.stopPropagation();window.__mcp.showDetail('${id}')">${t('partialError')}</button>`;
+      if (state === 'unavailable') return `<button class="btn ghost" type="button" onclick="event.stopPropagation();window.__mcp.showDetail('${id}')">${t('details')}</button><button class="btn status-bad" type="button" onclick="event.stopPropagation();window.__mcp.showDetail('${id}')">${t('connectionError')}</button>`;
+    }
     if (d.authMode === 'oauth2-pkce') {
-      if (connected) return `<button class="btn ghost" type="button" onclick="event.stopPropagation();window.__mcp.showDetail('${id}')">${t('details')}</button><button class="btn ghost" disabled>${t('connected')}</button>`;
       return `<button class="btn ghost" type="button" onclick="event.stopPropagation();window.__mcp.showDetail('${id}')">${t('details')}</button><button class="btn" type="button" onclick="event.stopPropagation();window.__mcp.connect('${id}')">${t('connect')}</button>`;
     }
     if (d.authMode === 'none') {
-      if (connected) return `<button class="btn ghost" type="button" onclick="event.stopPropagation();window.__mcp.showDetail('${id}')">${t('details')}</button><button class="btn ghost" disabled>${t('connected')}</button>`;
       return `<button class="btn ghost" type="button" onclick="event.stopPropagation();window.__mcp.showDetail('${id}')">${t('details')}</button><button class="btn" type="button" onclick="event.stopPropagation();window.__mcp.connect('${id}')">${t('connect')}</button>`;
     }
-    if (connected) return `<button class="btn ghost" type="button" onclick="event.stopPropagation();window.__mcp.showDetail('${id}')">${t('details')}</button><button class="btn ghost" disabled>${t('connected')}</button>`;
     return `<button class="btn ghost" type="button" onclick="event.stopPropagation();window.__mcp.showDetail('${id}')">${t('details')}</button><button class="btn" type="button" onclick="event.stopPropagation();window.__mcp.openConfig('${id}')">${t('configure')}</button>`;
   }
 
@@ -718,10 +737,13 @@
   function rowHtml(r) {
     const key = esc(r.key);
     const authMode = r.authMode === 'oauth' ? '<span class="badge auth-oauth">OAuth</span>' : `<span class="badge">${esc(r.authMode || 'manual')}</span>`;
+    const healthLabels = { healthy: '已连接', configured: '已配置', reauth: '需重新授权', degraded: '部分异常', unavailable: '连接异常', disabled: '已停用' };
+    const healthClass = r.connectionState === 'healthy' ? 'pass' : ['reauth', 'degraded'].includes(r.connectionState) ? 'partial' : r.connectionState === 'unavailable' ? 'fail' : '';
+    const healthBadge = `<span class="badge ${healthClass}">${esc(healthLabels[r.connectionState] || '已配置')}</span>`;
     const enabled = r.enabled !== false;
     return `<div class="row" data-key="${key}">
       <div class="info">
-        <div class="rname">${esc(r.name)} ${authMode}</div>
+        <div class="rname">${esc(r.name)} ${authMode} ${healthBadge}</div>
         <div class="rmeta">${esc(r.serverName || '')} · ${esc(r.url || '')}</div>
       </div>
       <label class="switch" title="${enabled ? '停用' : '启用'}" aria-label="${enabled ? '停用' : '启用'} ${esc(r.name)}">
@@ -867,7 +889,10 @@
     async connect(connectorId) {
       const r = await call('connect', { connectorId });
       showToast(r.message, r.ok);
-      if (r.ok) await refresh();
+      if (r.ok) {
+        await call('healthCheck', { connectorId });
+        await refresh();
+      }
     },
     toggle(key, enabled) {
       call('setEnabled', { key, enabled }).then((r) => showToast(r.message, r.ok));
@@ -984,13 +1009,15 @@
       const d = marketItems[connectorId];
       if (!d) return;
       detailConnector = d;
-      detailNeedsReconfigure = false;
+      detailFailureState = d.connectionState || '';
+      detailNeedsReconfigure = ['reauth', 'unavailable'].includes(detailFailureState);
       const loadId = ++detailLoadId;
       $('#detail-icon').innerHTML = isImageIcon(d.icon)
         ? `<img src="${esc(d.icon)}" alt="" onerror="this.parentElement.innerHTML='🔌';" />`
         : `<span style="font-size:24px;">${esc(d.icon || '')}</span>`;
       $('#detail-name').textContent = d.name || '';
-      $('#detail-vendor').textContent = d.vendor ? `${d.vendor} · 已连接 ${d.connected?.length || 0} 个服务` : `已连接 ${d.connected?.length || 0} 个服务`;
+      const initialStateLabel = d.connectionLabel || (d.connected?.length ? '已配置' : '未连接');
+      $('#detail-vendor').textContent = d.vendor ? `${d.vendor} · ${initialStateLabel} ${d.connected?.length || 0} 个服务` : `${initialStateLabel} ${d.connected?.length || 0} 个服务`;
       $('#detail-desc').textContent = d.description || d.summary || '';
       detailPrompts = (d.prompts || []).filter((prompt) => prompt?.text || prompt?.title);
       promptPage = 0;
@@ -1004,20 +1031,29 @@
       setDetailOpen(true);
       $('#detail-disconnect-btn').style.display = d.connected?.length > 0 ? 'block' : 'none';
       const needsCredential = ['bearer', 'api-key'].includes(d.authMode);
-      $('#detail-try-btn').textContent = d.connected?.length > 0 ? t('try') : needsCredential ? t('configureConnect') : t('connectTry');
+      $('#detail-try-btn').textContent = detailNeedsReconfigure
+        ? d.authMode === 'oauth2-pkce' && detailFailureState === 'reauth' ? '🔐 重新授权' : needsCredential && detailFailureState === 'reauth' ? t('reconfigureCredential') : '🔄 重新检查'
+        : d.connected?.length > 0 ? t('try') : needsCredential ? t('configureConnect') : t('connectTry');
       const toolsResult = await call('toolsList', { connectorId });
       if (loadId !== detailLoadId || !$('#detail-overlay').classList.contains('active')) return;
       if (!toolsResult.ok) {
+        detailFailureState = toolsResult.detail?.connectionState || detailFailureState || 'unavailable';
+        detailNeedsReconfigure = true;
         $('#tools-summary').textContent = '工具加载失败';
         $('#detail-tools').innerHTML = `<div class="tools-error">${esc(toolsResult.message)}</div>`;
-        if (needsCredential && d.connected?.length > 0) {
-          detailNeedsReconfigure = true;
-          $('#detail-vendor').textContent = d.vendor ? `${d.vendor} · 当前连接不可用` : '当前连接不可用';
-          $('#detail-try-btn').textContent = t('reconfigureCredential');
-          renderPromptPage();
-        }
+        const failureLabel = detailFailureState === 'reauth' ? (d.authMode === 'oauth2-pkce' ? '授权已失效' : '凭据已失效') : '当前连接异常';
+        $('#detail-vendor').textContent = d.vendor ? `${d.vendor} · ${failureLabel}` : failureLabel;
+        $('#detail-try-btn').textContent = d.authMode === 'oauth2-pkce' && detailFailureState === 'reauth'
+          ? '🔐 重新授权'
+          : needsCredential && detailFailureState === 'reauth' ? t('reconfigureCredential') : '🔄 重新检查';
+        renderPromptPage();
         return;
       }
+      detailFailureState = toolsResult.detail?.connectionState || 'healthy';
+      detailNeedsReconfigure = false;
+      $('#detail-vendor').textContent = d.vendor ? `${d.vendor} · ${detailFailureState === 'degraded' ? '部分服务可用' : '已连接'} ${d.connected?.length || 0} 个服务` : `${detailFailureState === 'degraded' ? '部分服务可用' : '已连接'} ${d.connected?.length || 0} 个服务`;
+      $('#detail-try-btn').textContent = t('try');
+      renderPromptPage();
       detailToolServers = toolsResult.detail?.servers || [];
       updateToolsSummary();
       renderTools();
@@ -1097,8 +1133,24 @@
     renderTools();
   });
   $('#detail-try-btn').addEventListener('click', async () => {
-    if (detailNeedsReconfigure && ['bearer', 'api-key'].includes(detailConnector?.authMode)) {
-      openAddConnection('manual', detailConnector);
+    if (detailNeedsReconfigure) {
+      if (detailFailureState === 'reauth' && ['bearer', 'api-key'].includes(detailConnector?.authMode)) {
+        openAddConnection('manual', detailConnector);
+        return;
+      }
+      if (detailFailureState === 'reauth' && detailConnector?.authMode === 'oauth2-pkce') {
+        const id = detailConnector.id;
+        const r = await call('connect', { connectorId: id });
+        showToast(r.message, r.ok);
+        if (r.ok) {
+          await call('healthCheck', { connectorId: id });
+          closeDetail();
+          await refresh();
+        }
+        return;
+      }
+      const id = detailConnector?.id;
+      if (id) await window.__mcp.showDetail(id);
       return;
     }
     if (!detailConnector?.connected?.length) {
@@ -1154,6 +1206,10 @@
   $('#refresh').addEventListener('click', async () => {
     const r = await call('refreshCatalog', {});
     showToast(r.message, r.ok);
+    if (r.ok) {
+      const health = await call('healthCheck', {});
+      showToast(`${r.message}；${health.message}`, health.ok);
+    }
     await refresh();
   });