dsh-mcp-connector 0.2.34 → 0.2.36

package/CHANGELOG.md

@@ -4,6 +4,33 @@
 
 ## [Unreleased]
 
+## [0.2.36] - 2026-09-06
+
+### Changed
+
+- “企查查·文档报告”更名为“企查查·智能文档解析”，产品说明、搜索标签、官网入口和示例 Prompt 调整为 OCR、文档结构化解析及 Markdown 输出场景。
+- 智能文档解析卡片改为一次录入完整 Authorization，同时配置远程在线链接 `qcc-document` 和本机文件 `qcc-document-mcp` 两个入口。
+
+### Fixed
+
+- 市场目录会比较已安装连接与卡片声明的 Server；旧版本仅安装远程入口时显示“补充本地解析”，凭据失效时显示“重新配置凭据”，不再误报完整连接或提示 OAuth 重新授权。
+- 配置页明确区分智能文档解析 API Key 与旧版企查查 OAuth 登录令牌，避免本地上传网关返回 `200215` 身份认证失败。
+
+### Verification
+
+- 196 项自动测试、lint、版本/营销元数据/商店截图门禁和 npm 发布包白名单/敏感内容扫描全部通过。
+- 远端 `qcc-document` 已用公开 PDF 完成真实解析；本地 `qcc-document-mcp` 已完成 stdio 启动和工具注册验证，并确认旧 OAuth Token 会被上传网关按预期拒绝，必须改用智能文档解析 API Key。
+
+## [0.2.35] - 2026-09-05
+
+### Fixed
+
+- 市场详情内完成免密连接、凭据配置或 OAuth 重新授权后，现在会原地重新读取连接状态与工具清单，并同步启用 Prompt 和试用按钮；用户在刷新期间主动关闭或切换详情时不会被强制重新打开。
+
+### Verification
+
+- 195 项自动测试、lint、版本/营销元数据/商店截图门禁和 npm 发布包白名单/敏感内容扫描全部通过。
+
 ## [0.2.34] - 2026-09-04
 
 ### Added
@@ -538,7 +565,9 @@
 - 外部 URL 与导入 Header 执行安全校验。
 - iframe 消息校验同源和消息来源。
 
-[Unreleased]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.34...HEAD
+[Unreleased]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.36...HEAD
+[0.2.36]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.35...v0.2.36
+[0.2.35]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.34...v0.2.35
 [0.2.34]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.33...v0.2.34
 [0.2.33]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.32...v0.2.33
 [0.2.32]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.31...v0.2.32

package/README.en.md

@@ -66,7 +66,7 @@ If the plugin helps you connect an MCP server faster, consider [starring the rep
 - Explicit, non-destructive migration from the two earlier Qichacha OAuth plugins, plus active-plugin conflict detection that blocks duplicate server management and credential overwrites.
 
 <!-- catalog-stats:start -->
-As of 2026-09-02, the public Registry publishes 101 connector descriptors. After merging and deduplicating them with the 4 bundled Qichacha cards, the Marketplace exposes 105 cards across 9 business categories. Recommendations remain limited to the four Qichacha cards, PKULaw, and Wind, for 6 featured cards in total. The Registry evolves independently; the badge shown after a client refresh and the live badges above are the authoritative current counts.
+As of 2026-09-05, the public Registry publishes 105 connector descriptors. After merging and deduplicating them with the 4 bundled Qichacha cards, the Marketplace exposes 109 cards across 9 business categories. Recommendations remain limited to the four Qichacha cards, PKULaw, and Wind, for 6 featured cards in total. The Registry evolves independently; the badge shown after a client refresh and the live badges above are the authoritative current counts.
 <!-- catalog-stats:end -->
 
 ## Interface and demo
@@ -171,7 +171,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.34`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.34](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.34).
+The current public version is [`dsh-mcp-connector@0.2.36`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.36](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.36).
 
 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

@@ -68,7 +68,7 @@ dsh plugin --profile web add dsh-mcp-connector
 - 对话工具：`mcp_connector_catalog`、`connect`、`configure`、`import_json`、`export_config`、`snapshot`、`install_from_url`、`status`、`scope`、`health_check`、`policy`、`set_enabled`、`disconnect`、`refresh_catalog`、`publish`、`tools_list`。
 
 <!-- catalog-stats:start -->
-截至 2026-09-02，公共 Registry 已发布 101 条连接器描述；与随包的 4 张企查查卡片合并去重后，市场页可浏览 105 张卡片，覆盖企业数据、金融投资、法律合规、开发工具、办公协作、调研分析、设计创意、效率工具、其他 9 类。推荐位严格保留 4 张企查查卡片、北大法宝和 Wind，共 6 张；其他连接器按业务分类展示。Registry 可独立持续更新，实际数量以客户端刷新后的市场页签徽标和上方实时统计徽标为准。
+截至 2026-09-05，公共 Registry 已发布 105 条连接器描述；与随包的 4 张企查查卡片合并去重后，市场页可浏览 109 张卡片，覆盖企业数据、金融投资、法律合规、开发工具、办公协作、调研分析、设计创意、效率工具、其他 9 类。推荐位严格保留 4 张企查查卡片、北大法宝和 Wind，共 6 张；其他连接器按业务分类展示。Registry 可独立持续更新，实际数量以客户端刷新后的市场页签徽标和上方实时统计徽标为准。
 <!-- catalog-stats:end -->
 
 ## 界面与演示
@@ -167,7 +167,7 @@ npm run dev:ui
 
 公共 Registry 每次合并后会生成 `catalog-stats.json`；本仓库的定时工作流每小时同步中英文介绍和统计快照。npm 页面中的静态正文随版本发布更新，上方动态统计徽标则直接读取 Registry，可在不发布新 npm 版本时保持实时数量一致。
 
-当前公开版本为 [`dsh-mcp-connector@0.2.34`](https://www.npmjs.com/package/dsh-mcp-connector)，对应 [GitHub Release v0.2.34](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.34)。
+当前公开版本为 [`dsh-mcp-connector@0.2.36`](https://www.npmjs.com/package/dsh-mcp-connector)，对应 [GitHub Release v0.2.36](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.36)。
 
 版本能力与变更记录见 [CHANGELOG.md](CHANGELOG.md)。
 Desktop 发版回归见 [docs/DESKTOP-E2E.md](docs/DESKTOP-E2E.md)。

package/catalog/catalog.json

@@ -131,34 +131,50 @@
     },
     {
       "id": "qcc-document",
-      "name": "企查查·文档报告",
+      "name": "企查查·智能文档解析",
       "vendor": "企查查 Qichacha",
       "icon": "/mcp-connector/ui/assets/qcc-logo.svg",
       "category": "效率工具",
-      "summary": "企业报告生成 / 文档分析",
-      "description": "基于企业数据自动生成分析报告、尽职调查文档，支持文档结构化解析与内容提取。",
-      "tags": ["文档", "报告", "分析"],
+      "summary": "本机文件 / 在线链接 · OCR 与结构化解析",
+      "description": "智能解析 PDF、图片等文档：远程入口处理公网可访问的在线链接，本地入口读取对话中上传、粘贴或指定路径的本机文件并自动提交解析，输出 Markdown 与结构化内容。本地入口需 Node.js 20+。",
+      "tags": ["智能文档解析", "OCR", "本机文件", "在线文档", "PDF", "图片", "Markdown"],
       "published": true,
       "featured": true,
-      "homepage": "https://open.qcc.com",
-      "promptVariables": [
-        { "name": "company", "label": "企业名称", "default": "小米科技有限责任公司", "placeholder": "例如：小米科技有限责任公司", "required": true }
-      ],
+      "homepage": "https://agent.qcc.com/doc",
       "auth": {
-        "mode": "oauth2-pkce",
-        "issuer": "https://agent.qcc.com",
-        "scope": "mcp:tools",
-        "clientName": "DeepSeek Harness - MCP 连接器",
-        "tokenEndpointAuthMethod": "none",
-        "grantSharing": "issuer"
+        "mode": "api-key",
+        "apiKeyHeader": "Authorization",
+        "credentialName": "智能文档解析 API Key Authorization",
+        "credentialPlaceholder": "Bearer YOUR_API_KEY",
+        "credentialDescription": "请输入智能文档解析产品签发的完整 Authorization 值（Bearer + 空格 + API Key），不是企查查 OAuth 登录令牌。一次配置后，远程在线链接与本地文件解析共用此凭据。",
+        "credentialHelpLabel": "前往企查查智能文档解析获取 API Key",
+        "credentialFields": [
+          {
+            "key": "authorization",
+            "label": "Authorization",
+            "placeholder": "Bearer YOUR_API_KEY",
+            "description": "格式为 Bearer + 空格 + 智能文档解析 API Key；OAuth 登录令牌不能用于本地文件上传。凭据仅保存在 DSH 本机。",
+            "helpLabel": "前往企查查智能文档解析获取 API Key",
+            "required": true,
+            "secret": true
+          }
+        ]
       },
       "servers": [
-        { "serverKey": "document", "url": "https://agent.qcc.com/mcp/document/stream", "serverName": "qcc-document", "transport": "streamable-http", "headers": {} }
+        { "serverKey": "document", "url": "https://agent.qcc.com/mcp/document/stream", "serverName": "qcc-document", "transport": "streamable-http", "headers": {} },
+        {
+          "serverKey": "document-local",
+          "serverName": "qcc-document-mcp",
+          "transport": "stdio",
+          "command": "npx",
+          "args": ["-y", "qcc-document-mcp"],
+          "credentialBindings": { "QCC_DOCUMENT_AUTHORIZATION": "authorization" }
+        }
       ],
       "prompts": [
-        { "title": "企业尽调报告", "text": "为 {{company}} 生成一份企业尽职调查报告", "server": "document" },
-        { "title": "企业风险报告", "text": "为 {{company}} 生成一份企业风险分析报告", "server": "document" },
-        { "title": "工商信息摘要", "text": "整理 {{company}} 的工商与股权信息摘要", "server": "document" }
+        { "title": "解析在线文档", "text": "解析这份在线文档：请把公网可访问的 PDF 或图片 URL 粘贴到这里，并输出 Markdown 与关键字段。", "server": "document" },
+        { "title": "解析上传文件", "text": "解析我在对话中上传或粘贴的这份 PDF 或图片，提取正文、表格和关键字段。", "server": "document-local" },
+        { "title": "解析本机文件", "text": "解析本机文件：请把文件路径替换为 ~/Desktop/example.pdf，并输出 Markdown 与结构化摘要。", "server": "document-local" }
       ]
     },
     {

package/docs/USER-GUIDE.md

@@ -75,6 +75,15 @@ Bearer/API Key 连接器会先执行 MCP `initialize` 验证。所有 Server 通
 
 stdio 市场卡片也可能显示一个或多个凭据字段，例如 API Token、区域或租户标识。卡片目录只声明字段名称及其环境变量映射；提交后，真实值仅保存到 DSH 本机连接记录，并由插件注入该 stdio 进程的 `env`。市场、状态页和日志不会返回这些值。插件会等待 Host 完成首次 MCP 初始化与工具同步后再保存连接；失败或超时不会增加已安装数量，卡片也不会提前显示“已连接”。
 
+“企查查·智能文档解析”会一次配置两个互不冲突的入口，并共用同一份完整 `Authorization` 值（格式为 `Bearer YOUR_API_KEY`）：
+
+- `qcc-document`：远程 Agent，解析公网可访问的在线文档或图片 URL。
+- `qcc-document-mcp`：本地 Agent，通过 `npx -y qcc-document-mcp` 读取对话中上传、粘贴或指定路径的本机文件，自动上传并提交解析；要求 Node.js 20+。
+
+这里必须使用智能文档解析产品签发的 API Key，不是企查查 OAuth 登录令牌。旧版远程 `qcc-document` 的 OAuth 授权可以继续访问远程 MCP，但不能直接充当 `QCC_DOCUMENT_AUTHORIZATION`；本地上传网关会拒绝这种令牌。请从卡片的“前往企查查智能文档解析获取 API Key”入口取得凭据，且不要把真实值粘贴到对话、日志或截图中。
+
+旧版本只配置过远程入口时，卡片会显示“补充本地解析”，不会把单入口误报为完整连接。重新录入一次 Authorization 后，插件先验证两个 Server，再原子保存；任一入口失败都不会留下半套配置。
+
 OAuth 一键连接要求服务商支持标准 OAuth 2.1/PKCE 和公开元数据发现。动态客户端注册既支持无需客户端密钥的 `none`，也支持服务商签发密钥的 `client_secret_post` 与 `client_secret_basic`。客户端密钥仅与 OAuth Grant 一同保存在 DSH 本机，用于换取、刷新和撤销 Token；插件不会要求用户把 OAuth Token 或客户端密钥复制到聊天中。如服务商在动态客户端注册阶段返回 HTTP 403，页面会明确提示“客户端注册被拒绝、尚未进入浏览器授权”；这通常需要服务商审核或登记客户端，重试用户授权无法绕过。
 
 当市场描述声明 `grantSharing: "issuer"` 时，同一账号下相同 issuer、scope 和客户端鉴权方式的卡片共享一组 Grant。首次授权仍只启用用户点击的卡片；之后连接同组卡片会直接复用现有授权，不再重复打开 OAuth 页面。升级时会验证并自动归并旧版本留下的同 issuer 多份 Grant；Desktop 与 `dsh web` 并发时，插件使用跨进程锁串行轮换，并从每 Grant 独立原子日志读取最新 Token，避免 DSH 整文件 storage 的旧进程快照覆盖新凭据。网络、OAuth 元数据发现或服务端 5xx 等暂时故障只进入“自动重试中”；确认 journal 中也没有更新 Token，且明确收到 Refresh Token/客户端失效错误时，才进入“需重新授权”。

package/lib/index.js

@@ -1709,6 +1709,13 @@ export async function apply(ctx, config) {
         const visibleRecords = workspaceId
           ? connectorRecords.filter((record) => connectionVisibleInWorkspace(connectionScopes.binding(record.key), workspaceId))
           : connectorRecords;
+        const missingServers = (d.servers ?? []).filter((server) => !visibleRecords.some((record) => (
+          record.serverKey === server.serverKey || record.serverName === server.serverName
+        ))).map((server) => ({
+          serverKey: server.serverKey,
+          serverName: server.serverName,
+          transport: server.transport,
+        }));
         return ({
         id: d.id,
         name: d.name,
@@ -1734,6 +1741,8 @@ export async function apply(ctx, config) {
         probeReportUrl: d.probeReportUrl,
         toolsSnapshot: d.toolsSnapshot ?? [],
         connected: visibleRecords.map((record) => record.key),
+        connectionComplete: missingServers.length === 0,
+        missingServers,
         connectedScopes: connectorRecords.map((record) => ({ key: record.key, ...scopeDetail(record, workspaceId) })),
         connectionState: health.connectionState,
         connectionLabel: health.label,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mcp-connector",
-  "version": "0.2.34",
+  "version": "0.2.36",
   "description": "DeepSeek Harness MCP Connector and MCP Server marketplace with over one hundred MCP connectors, continuously updated. Discover, authorize, and manage connections in one place; supports OAuth 2.0 PKCE, API keys, stdio/HTTP, mcpServers JSON import, and tool and prompt discovery. Maintained by Qichacha/QCC.",
   "type": "module",
   "main": "lib/index.js",

package/ui/index.html

@@ -521,7 +521,7 @@
     reauthorize: '需重新授权', recovering: '自动重试中', connectionError: '连接异常', partialError: '部分异常', disabled: '已停用',
     send: '发送', fillSend: '填写并发送', connectToUse: '连接后使用', try: '💬 去试试',
     connectTry: '🔗 连接后试用', configureConnect: '🔑 录入凭据并连接',
-    reconfigureCredential: '🔑 重新配置凭据', loading: '加载中…',
+    reconfigureCredential: '🔑 重新配置凭据', completeSetup: '补充本地解析', loading: '加载中…',
   };
   const t = (key) => LABELS[key] || key;
   const MCP_JSON_EXAMPLE = JSON.stringify({
@@ -696,6 +696,18 @@
     setDetailOpen(false);
   }
 
+  function isDetailOpenFor(connectorId) {
+    return detailConnector?.id === connectorId && $('#detail-overlay').classList.contains('active');
+  }
+
+  async function refreshConnectionUi(connectorId) {
+    const reloadOpenDetail = isDetailOpenFor(connectorId);
+    const openDetailLoadId = detailLoadId;
+    await refresh();
+    if (!reloadOpenDetail || detailLoadId !== openDetailLoadId || !isDetailOpenFor(connectorId)) return;
+    await window.__mcp.showDetail(connectorId);
+  }
+
   function promptVariableNames(text) {
     const names = [];
     const seen = new Set();
@@ -1047,13 +1059,21 @@
   function actionHtml(d) {
     const id = esc(d.id);
     const configured = d.connected?.length > 0;
+    const incomplete = configured && d.connectionComplete === false;
     const state = d.connectionState || (configured ? 'configured' : 'disconnected');
+    if (incomplete && ['bearer', 'api-key'].includes(d.authMode)) {
+      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.openConfig('${id}')">${t('completeSetup')}</button>`;
+    }
     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 === 'unknown') return `<button class="btn ghost" type="button" onclick="event.stopPropagation();window.__mcp.showDetail('${id}')">${t('details')}</button><button class="btn ghost" type="button" onclick="event.stopPropagation();window.__mcp.showDetail('${id}')">${t('unknown')}</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 === 'reauth') {
+        const credentialAuth = ['bearer', 'api-key'].includes(d.authMode);
+        const action = credentialAuth ? `window.__mcp.openConfig('${id}')` : `window.__mcp.showDetail('${id}')`;
+        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();${action}">${credentialAuth ? t('reconfigureCredential') : t('reauthorize')}</button>`;
+      }
       if (state === 'recovering') 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('recovering')}</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>`;
@@ -1178,15 +1198,18 @@
         ? `<label for="cfg-token">${esc(credentialName)}（必填）</label><input id="cfg-token" type="password" autocomplete="off" placeholder="${esc(credentialPlaceholder)}" /><div class="field-help">${esc(credentialDescription)}</div>`
         : `<div class="form-row"><div><label for="cfg-key-header">API Key Header</label><input id="cfg-key-header" value="${esc(preset.apiKeyHeader || 'X-Api-Key')}" /></div><div><label for="cfg-key-value">${esc(credentialName)}（必填）</label><input id="cfg-key-value" type="password" autocomplete="off" placeholder="${esc(credentialPlaceholder)}" /></div></div><div class="field-help">${esc(credentialDescription)}</div>`;
     const serverPreview = servers.map((server) => {
+      const modeLabel = server.transport === 'stdio' ? '本地 Agent · 本机文件' : '远程 Agent · 在线链接文档';
       const endpoint = server.transport === 'stdio'
         ? `stdio · ${server.command || ''} ${(server.args || []).join(' ')}`.trim()
         : server.url;
-      return `<div>${esc(server.serverName)} · ${esc(endpoint)}</div>`;
+      return `<div><strong>${esc(modeLabel)}</strong><br>${esc(server.serverName)} · ${esc(endpoint)}</div>`;
     }).join('');
+    const mixedDocumentModes = usesStdio && servers.some((server) => server.transport !== 'stdio');
     openModal(`配置 ${preset.name}`, `
       <input id="cfg-connector-id" type="hidden" value="${esc(preset.id)}" />
       <input id="cfg-auth" type="hidden" value="${esc(authMode)}" />
       <div class="form-note"><strong>一次配置 ${servers.length} 个 MCP Server</strong>以下 Server 共用同一份 ${esc(credentialName)}；凭据仅保存在本机，不会写入市场目录。</div>
+      ${mixedDocumentModes ? '<div class="form-note"><strong>在线链接 + 本机文件同时启用</strong>远程入口解析公网可访问的 URL；本地入口读取对话中上传、粘贴或指定路径的文件并自动提交解析，需 Node.js 20+。</div>' : ''}
       <div class="server-preview">${serverPreview}</div>
       ${scopeFieldHtml()}
       ${credentialFields}
@@ -1337,7 +1360,7 @@
         markCommunityCtaEligible();
         closeModal();
         await call('healthCheck', { connectorId });
-        await refresh();
+        await refreshConnectionUi(connectorId);
       }
     },
     confirmConnect() {
@@ -1484,11 +1507,9 @@
         });
         setModalBusy(false);
         if (!r.ok) { showModalError(r.message); return; }
-        const configuredFromDetail = detailConnector?.id === connectorId && $('#detail-overlay').classList.contains('active');
         closeModal();
-        if (configuredFromDetail) closeDetail();
         markCommunityCtaEligible();
-        showToast(r.message, true); await refresh();
+        showToast(r.message, true); await refreshConnectionUi(connectorId);
         return;
       }
       const name = $('#cfg-name').value.trim();
@@ -1581,14 +1602,17 @@
       const d = marketItems[connectorId];
       if (!d) return;
       detailConnector = d;
-      detailFailureState = d.connectionState || '';
-      detailNeedsReconfigure = ['reauth', 'recovering', 'unavailable'].includes(detailFailureState);
+      const incomplete = d.connected?.length > 0 && d.connectionComplete === false;
+      detailFailureState = incomplete ? 'incomplete' : (d.connectionState || '');
+      detailNeedsReconfigure = incomplete || ['reauth', 'recovering', '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 || '';
-      const initialStateLabel = d.connectionLabel || (d.connected?.length ? '已配置' : '未连接');
+      const initialStateLabel = incomplete
+        ? `待补充 ${d.missingServers?.length || 1} 个服务`
+        : (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);
@@ -1606,7 +1630,7 @@
       $('#detail-disconnect-btn').style.display = d.connected?.length > 0 ? 'block' : 'none';
       const needsCredential = ['bearer', 'api-key'].includes(d.authMode);
       $('#detail-try-btn').textContent = detailNeedsReconfigure
-        ? d.authMode === 'oauth2-pkce' && detailFailureState === 'reauth' ? '🔐 重新授权' : needsCredential && detailFailureState === 'reauth' ? t('reconfigureCredential') : '🔄 重新检查'
+        ? detailFailureState === 'incomplete' ? t('completeSetup') : d.authMode === 'oauth2-pkce' && detailFailureState === 'reauth' ? '🔐 重新授权' : needsCredential && detailFailureState === 'reauth' ? t('reconfigureCredential') : '🔄 重新检查'
         : d.connected?.length > 0 ? t('try') : needsCredential ? t('configureConnect') : t('connectTry');
       if (!d.connected?.length && !d.toolsSnapshot?.length) {
         $('#tools-summary').textContent = '连接后查看工具';
@@ -1647,10 +1671,13 @@
         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');
+      detailFailureState = incomplete ? 'incomplete' : (toolsResult.detail?.connectionState || 'healthy');
+      detailNeedsReconfigure = incomplete;
+      const connectedLabel = incomplete
+        ? `待补充 ${d.missingServers?.length || 1} 个服务`
+        : `${detailFailureState === 'degraded' ? '部分服务可用' : '已连接'} ${d.connected?.length || 0} 个服务`;
+      $('#detail-vendor').textContent = d.vendor ? `${d.vendor} · ${connectedLabel}` : connectedLabel;
+      $('#detail-try-btn').textContent = incomplete ? t('completeSetup') : t('try');
       renderPromptPage();
       detailToolServers = toolsResult.detail?.servers || [];
       updateToolsSummary();
@@ -1738,6 +1765,10 @@
   });
   $('#detail-try-btn').addEventListener('click', async () => {
     if (detailNeedsReconfigure) {
+      if (detailFailureState === 'incomplete' && ['bearer', 'api-key'].includes(detailConnector?.authMode)) {
+        openAddConnection('manual', detailConnector);
+        return;
+      }
       if (detailFailureState === 'reauth' && ['bearer', 'api-key'].includes(detailConnector?.authMode)) {
         openAddConnection('manual', detailConnector);
         return;
@@ -1749,8 +1780,7 @@
         if (r.ok) {
           markCommunityCtaEligible();
           await call('healthCheck', { connectorId: id });
-          closeDetail();
-          await refresh();
+          await refreshConnectionUi(id);
         }
         return;
       }