dsh-mcp-connector 0.2.60 → 0.2.61

package/CHANGELOG.md

@@ -4,6 +4,12 @@
 
 ## [Unreleased]
 
+## [0.2.61] - 2026-09-29
+
+### Fixed
+
+- 健康探针展开 Node.js `fetch` 的嵌套错误原因，将 DNS、TLS、超时、连接重置和拒绝连接输出为稳定且不回显端点参数或凭据的诊断，避免报告只显示无法操作的 `fetch failed`。
+
 ## [0.2.60] - 2026-09-29
 
 ### Fixed

package/README.en.md

@@ -198,7 +198,7 @@ npm run dev:ui
 
 Every Registry merge regenerates `catalog-stats.json`; an hourly workflow in this repository synchronizes the Chinese and English product copy plus a local stats snapshot. The static npm README updates with package releases, while the live badges above read the Registry directly and therefore stay current without another npm release.
 
-The current public version is [`dsh-mcp-connector@0.2.60`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.60](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.60).
+The current public version is [`dsh-mcp-connector@0.2.61`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.61](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.61).
 
 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

@@ -193,7 +193,7 @@ npm run dev:ui
 
 公共 Registry 每次合并后会生成 `catalog-stats.json`；本仓库的定时工作流每小时同步中英文介绍和统计快照。npm 页面中的静态正文随版本发布更新，上方动态统计徽标则直接读取 Registry，可在不发布新 npm 版本时保持实时数量一致。
 
-当前公开版本为 [`dsh-mcp-connector@0.2.60`](https://www.npmjs.com/package/dsh-mcp-connector)，对应 [GitHub Release v0.2.60](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.60)。
+当前公开版本为 [`dsh-mcp-connector@0.2.61`](https://www.npmjs.com/package/dsh-mcp-connector)，对应 [GitHub Release v0.2.61](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.61)。
 
 版本能力与变更记录见 [CHANGELOG.md](CHANGELOG.md)。
 Desktop 发版回归见 [docs/DESKTOP-E2E.md](docs/DESKTOP-E2E.md)。

package/lib/probe.js

@@ -29,6 +29,51 @@ function parseMcpPayload(text, contentType) {
   try { return JSON.parse(text); } catch { return undefined; }
 }
 
+function probeErrorChain(error) {
+  const entries = [];
+  let current = error;
+  for (let depth = 0; current && depth < 8; depth += 1) {
+    entries.push({
+      code: typeof current.code === 'string' ? current.code.toUpperCase() : '',
+      name: typeof current.name === 'string' ? current.name : '',
+      message: typeof current.message === 'string' ? current.message : '',
+    });
+    current = current.cause;
+  }
+  return entries;
+}
+
+/**
+ * 将 fetch/undici 的嵌套错误转换为不包含端点参数或凭据的稳定诊断。
+ * 健康报告只公开错误类别和允许列表内的系统错误码。
+ */
+export function classifyProbeError(error) {
+  const entries = probeErrorChain(error);
+  const text = entries.flatMap((entry) => [entry.code, entry.name, entry.message]).join(' ');
+  const code = entries.map((entry) => entry.code).find((value) => [
+    'ENOTFOUND', 'EAI_AGAIN', 'ETIMEDOUT', 'ECONNRESET', 'ECONNREFUSED',
+    'CERT_HAS_EXPIRED', 'DEPTH_ZERO_SELF_SIGNED_CERT', 'SELF_SIGNED_CERT_IN_CHAIN',
+    'UNABLE_TO_VERIFY_LEAF_SIGNATURE', 'ERR_TLS_CERT_ALTNAME_INVALID',
+  ].includes(value));
+
+  if (/AbortError|timeout|timed out|ETIMEDOUT/i.test(text)) {
+    return { kind: 'timeout', ...(code ? { code } : {}), message: code ? `Request timed out (${code})` : 'Request timed out' };
+  }
+  if (/ENOTFOUND|EAI_AGAIN|getaddrinfo/i.test(text)) {
+    return { kind: 'dns', ...(code ? { code } : {}), message: code ? `DNS lookup failed (${code})` : 'DNS lookup failed' };
+  }
+  if (/CERT_|certificate|self signed|ERR_TLS|TLS|SSL/i.test(text)) {
+    return { kind: 'tls', ...(code ? { code } : {}), message: code ? `TLS validation failed (${code})` : 'TLS validation failed' };
+  }
+  if (/ECONNRESET|socket disconnected|connection reset/i.test(text)) {
+    return { kind: 'connection-reset', ...(code ? { code } : {}), message: code ? `Connection reset (${code})` : 'Connection reset' };
+  }
+  if (/ECONNREFUSED/i.test(text)) {
+    return { kind: 'connection-refused', ...(code ? { code } : {}), message: code ? `Connection refused (${code})` : 'Connection refused' };
+  }
+  return { kind: 'network', message: 'Network request failed' };
+}
+
 async function probeServer(server, authMode, timeoutMs) {
   const startedAt = Date.now();
   if (server.transport === 'stdio') {
@@ -76,7 +121,10 @@ async function probeServer(server, authMode, timeoutMs) {
       || payload?.jsonrpc === '2.0' || !!payload?.result?.protocolVersion || !!payload?.error;
     if (payload?.result?.tools) result.tools = payload.result.tools;
   } catch (error) {
-    result.error = error instanceof Error ? error.message : String(error);
+    const diagnostic = classifyProbeError(error);
+    result.error = diagnostic.message;
+    result.errorKind = diagnostic.kind;
+    if (diagnostic.code) result.errorCode = diagnostic.code;
   }
 
   if (authMode === 'oauth2-pkce' && result.reachable) {
@@ -114,7 +162,13 @@ async function probeIcon(icon, timeoutMs) {
     }
     return { ok: response.ok, status: response.status };
   } catch (error) {
-    return { ok: false, error: error instanceof Error ? error.message : String(error) };
+    const diagnostic = classifyProbeError(error);
+    return {
+      ok: false,
+      error: diagnostic.message,
+      errorKind: diagnostic.kind,
+      ...(diagnostic.code ? { errorCode: diagnostic.code } : {}),
+    };
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mcp-connector",
-  "version": "0.2.60",
+  "version": "0.2.61",
   "description": "DeepSeek Harness MCP Connector: connect servers, search tools across active connections, and troubleshoot discovery. Includes a continuously updated catalog; supports OAuth 2.0 PKCE, API keys, Streamable HTTP/stdio, and mcpServers JSON import.",
   "type": "module",
   "main": "lib/index.js",