dsh-mcp-connector 0.2.100 → 0.2.101
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +7 -0
- package/README.en.md +3 -3
- package/README.md +4 -4
- package/docs/DESKTOP-E2E.md +1 -1
- package/docs/USER-GUIDE.md +8 -1
- package/docs/screenshots/01-market-overview.jpg +0 -0
- package/docs/screenshots/02-connector-detail.jpg +0 -0
- package/docs/screenshots/03-tool-discovery.jpg +0 -0
- package/docs/screenshots/04-json-import.jpg +0 -0
- package/docs/screenshots/05-unified-tool-search.png +0 -0
- package/docs/screenshots/06-tool-parameters.png +0 -0
- package/docs/screenshots/07-connection-diagnostics.png +0 -0
- package/docs/screenshots/08-ten-recommendations.jpg +0 -0
- package/docs/screenshots/README.md +1 -1
- package/docs/screenshots/assets.json +30 -30
- package/docs/screenshots/en/01-market-overview.jpg +0 -0
- package/docs/screenshots/en/02-connector-detail.jpg +0 -0
- package/docs/screenshots/en/03-tool-discovery.jpg +0 -0
- package/docs/screenshots/en/04-json-import.jpg +0 -0
- package/docs/screenshots/en/05-unified-tool-search.png +0 -0
- package/docs/screenshots/en/06-tool-parameters.png +0 -0
- package/docs/screenshots/en/07-connection-diagnostics.png +0 -0
- package/docs/screenshots/en/08-ten-recommendations.jpg +0 -0
- package/docs/screenshots/en/assets.json +30 -30
- package/docs/screenshots/en/demo.gif +0 -0
- package/docs/tutorials/FIRST-SUCCESS-SCENARIOS.md +1 -1
- package/lib/diagnostics.js +5 -3
- package/lib/i18n/locales/en/diagnostics.js +1 -1
- package/lib/i18n/locales/en/host.js +8 -2
- package/lib/index.js +301 -132
- package/lib/legacy-plugin-conflict.js +99 -0
- package/lib/migration.js +11 -6
- package/lib/schema.js +5 -0
- package/package.json +1 -1
- package/ui/index.html +119 -16
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.2.101
|
|
4
|
+
|
|
5
|
+
- 企查查旧授权迁移后看到红色“连接异常”时,点击市场卡片上的状态,或在 MCP连接器“已安装”中点“查看处理步骤”。已完成迁移的连接也能重新打开指引。
|
|
6
|
+
- 在 **DSH → 插件 → 已安装** 中,按指引停用仍启用的旧插件。工商安装包为 `qcc-dsh-mcp-oauth`(条目 ID `qcc-mcp-oauth`),法律安装包为 `qcc-dsh-mcp-legal-oauth`(条目 ID `qcc-legal-mcp-oauth`)。请使用插件开关。旧插件的“断开授权”会尝试撤销凭据。
|
|
7
|
+
- 若指引列出仍在运行的旧服务,按完整条目 ID 和服务名核对、停用,再完整退出并重启 DSH。回到 **MCP连接器 → 已安装** 检查结果。显示“需重新授权”时,打开对应卡片授权。使用仅内存模式时,重启后再次扫描并复制旧授权。
|
|
8
|
+
- Qichacha migration now identifies active legacy plugins and leftover service entries. Open the red status on the marketplace card or **View recovery steps** under **Installed**, including for connections migrated before this update. Use the DSH plugin switch to disable the named plugin and preserve its OAuth grant. If the guide lists leftover entries, match their full IDs and service names before disabling them. Fully quit and restart DSH, then check **MCP Connector → Installed**. [Customer migration guide](docs/USER-GUIDE.md#企查查旧插件迁移后显示连接异常)
|
|
9
|
+
|
|
3
10
|
## 0.2.100
|
|
4
11
|
|
|
5
12
|
- Publish the npm download trend chart in the package README, sharing the maintained chart with GitHub and the connector registry.
|
package/README.en.md
CHANGED
|
@@ -101,7 +101,7 @@ If the plugin helps you connect an MCP server faster, consider [starring the rep
|
|
|
101
101
|
- Built-in, remote, and local catalogs with `published` and `featured` controls.
|
|
102
102
|
- A standalone remote Registry, allowing new marketplace cards to appear after refresh without publishing a new npm version.
|
|
103
103
|
- Plugin version and one-click updates: version discovery is independent of the installation source, while an Update Provider adapter layer negotiates safe mutation capabilities. DSH Market API v1 is the first adapter and supports progress, normalized failures, rollback, and capability-gated restart/refresh actions. Without a compatible provider the UI offers update instructions; if Desktop has no plugin-market section, it opens the npm package page instead of leaving the user on generic Settings.
|
|
104
|
-
-
|
|
104
|
+
- The two legacy Qichacha OAuth plugins support explicit authorization migration. For an affected connection, select **Connection error** in the marketplace or **View recovery steps** under Installed to see which DSH plugin or remaining service entry to disable. After a full DSH restart, MCP Connector takes over the authorization, or prompts for authorization again if it has expired.
|
|
105
105
|
|
|
106
106
|
<!-- catalog-stats:start -->
|
|
107
107
|
As of 2026-10-24, the public Registry publishes 112 connector descriptors. After merging and deduplicating them with the 4 bundled Qichacha cards, the Marketplace exposes 116 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.
|
|
@@ -119,7 +119,7 @@ As of 2026-10-24, the public Registry publishes 112 connector descriptors. After
|
|
|
119
119
|
| Connection diagnostics and last-success cache | |
|
|
120
120
|
|  | |
|
|
121
121
|
|
|
122
|
-
<!-- generated:media -->English UI screenshots and GIF were captured from v0.2.
|
|
122
|
+
<!-- generated:media -->English UI screenshots and GIF were captured from v0.2.101 (2026-11-11), using the credential-free Mock harness. Provider content retains its original language. They demonstrate UI, not real business acceptance; counts are fixtures. See [asset provenance](docs/screenshots/README.md).<!-- /generated:media -->
|
|
123
123
|
|
|
124
124
|
## Installation
|
|
125
125
|
|
|
@@ -250,7 +250,7 @@ npm run dev:ui
|
|
|
250
250
|
|
|
251
251
|
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.
|
|
252
252
|
|
|
253
|
-
<!-- generated:version -->The current public version is [`dsh-mcp-connector@0.2.
|
|
253
|
+
<!-- generated:version -->The current public version is [`dsh-mcp-connector@0.2.101`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.101](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.101).<!-- /generated:version -->
|
|
254
254
|
|
|
255
255
|
See [CHANGELOG.md](CHANGELOG.md) for version history and [docs/DESKTOP-E2E.md](docs/DESKTOP-E2E.md) for the Desktop release checklist.
|
|
256
256
|
|
package/README.md
CHANGED
|
@@ -114,7 +114,7 @@ Desktop 需要完全退出并重新启动应用;Web 需要停止原 `dsh web`
|
|
|
114
114
|
- 独立远程 Registry:新市场卡片合并后客户端刷新即可见,无需重新发布 npm;远程不可用时自动回退内置目录。
|
|
115
115
|
- 插件版本与一键更新:版本发现独立于安装来源;页面通过 Update Provider 适配层探测安全更新能力。DSH Market API v1 是首个适配器,支持进度、稳定失败码、回滚及按宿主能力提供的重启/刷新操作;无可用 Provider 时回退到当前插件市场或 npm。
|
|
116
116
|
- Registry 工具链:Schema/唯一性/密钥审计、MCP/OAuth 无凭据探针、每周健康巡检。
|
|
117
|
-
-
|
|
117
|
+
- 旧企查查 OAuth 插件迁移:扫描并复制工商、法律授权。已迁移的客户可以从市场的“连接异常”或已安装行查看冲突插件、残留条目和恢复步骤。
|
|
118
118
|
- 对话工具:`mcp_connector_catalog`、`connect`、`configure`、`import_json`、`export_config`、`snapshot`、`install_from_url`、`status`、`scope`、`health_check`、`policy`、`set_enabled`、`session_tools`、`disconnect`、`refresh_catalog`、`publish`、`tools_list`、`tool_search`、`tool_detail`。搜索/详情只做渐进式能力发现,不执行目标 MCP 工具。
|
|
119
119
|
|
|
120
120
|
<!-- catalog-stats:start -->
|
|
@@ -133,7 +133,7 @@ Desktop 需要完全退出并重新启动应用;Web 需要停止原 `dsh web`
|
|
|
133
133
|
| 连接诊断与最后成功缓存 | |
|
|
134
134
|
|  | |
|
|
135
135
|
|
|
136
|
-
<!-- generated:media -->截图与 GIF 采集自 v0.2.
|
|
136
|
+
<!-- generated:media -->截图与 GIF 采集自 v0.2.101(2026-11-11)无凭据 Mock 页面,展示界面而非真实业务验收;市场数量是测试夹具。来源与更新方法见 [素材说明](docs/screenshots/README.md)。<!-- /generated:media -->
|
|
137
137
|
|
|
138
138
|
## 安装
|
|
139
139
|
|
|
@@ -257,7 +257,7 @@ npm run dev:ui
|
|
|
257
257
|
|
|
258
258
|
公共 Registry 每次合并后会生成 `catalog-stats.json`;本仓库的定时工作流每小时同步中英文介绍和统计快照。npm 页面中的静态正文随版本发布更新,上方动态统计徽标则直接读取 Registry,可在不发布新 npm 版本时保持实时数量一致。
|
|
259
259
|
|
|
260
|
-
<!-- generated:version -->当前公开版本为 [`dsh-mcp-connector@0.2.
|
|
260
|
+
<!-- generated:version -->当前公开版本为 [`dsh-mcp-connector@0.2.101`](https://www.npmjs.com/package/dsh-mcp-connector),对应 [GitHub Release v0.2.101](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.101)。<!-- /generated:version -->
|
|
261
261
|
|
|
262
262
|
版本能力与变更记录见 [CHANGELOG.md](CHANGELOG.md)。
|
|
263
263
|
Desktop 发版回归见 [docs/DESKTOP-E2E.md](docs/DESKTOP-E2E.md)。
|
|
@@ -280,7 +280,7 @@ stdio 传输的架构、透传边界与安全约束见 [docs/STDIO-SUPPORT.md](d
|
|
|
280
280
|
- OAuth 连接失败会标明资源发现、服务发现、客户端注册、授权回调或 Token 换取阶段;DCR HTTP 403 表示服务商拒绝未准入客户端,不是用户未点击授权。
|
|
281
281
|
- 脱敏导出把 Token/API Key、静态 Header/env 值、stdio 参数、本地目录及带查询参数的 URL 替换为占位符;OAuth 只保留重新授权引用。快照中的完整配置仍只在当前 profile 的 storage domain 内。
|
|
282
282
|
- 顶部入口通过 DSH 稳定 `data-slot` 定位并使用 React Portal;DSH 若移除该标记,入口会回退到底部,不影响连接器功能。
|
|
283
|
-
-
|
|
283
|
+
- 企查查旧授权经确认后复制。遇到迁移冲突,按指引停用相应旧插件或残留服务条目并完整重启 DSH。授权失效时需要重新授权。[客户处理步骤](docs/USER-GUIDE.md#企查查旧插件迁移后显示连接异常)
|
|
284
284
|
- project/global 作用域仅在当前 DSH profile 内生效;不会跨 profile 同步。删除 Workspace 后,原 project-only 绑定保持 fail closed,需手动移动到其他项目或全局。
|
|
285
285
|
- 当前没有工具试运行;治理与作用域都由 DSH Host 正式工具执行链强制应用。试运行已完成官方 API 复核,但在 out-of-turn 审批编排和 MCP 副作用元数据缺口补齐前保持 design blocked。快照不能恢复服务端已撤销的 OAuth Grant。
|
|
286
286
|
|
package/docs/DESKTOP-E2E.md
CHANGED
|
@@ -19,7 +19,7 @@ npm run dev:ui
|
|
|
19
19
|
6. Bearer/API Key 型市场卡片先填错误凭据:弹框内应显示鉴权/网络分类错误,不得进入「已安装」;再填正确凭据,只有卡片下所有 Server 均通过 initialize 校验后才批量安装。
|
|
20
20
|
7. 参数化 Prompt 填写企业/人员/主题后,发送到当前工作区新会话草稿;重复点击和超时有提示。
|
|
21
21
|
8. OAuth:授权回调、重启恢复、停用/启用、断开撤销;二级弹框蒙层与关闭按钮清晰。
|
|
22
|
-
9.
|
|
22
|
+
9. 企查查迁移应同时覆盖工商与法律。先复制授权并关闭弹框,再从市场的“连接异常”、已安装行和再次扫描进入指引。按命中的插件或残留条目处理,完整重启后确认工具在宿主中注册。[客户操作说明](USER-GUIDE.md#企查查旧插件迁移后显示连接异常)随包提供。真实旧包和隔离 profile 的详细验收记录在源码仓库的 `docs/acceptance/PLUGIN-CONFLICT-MIGRATION-2026-11-11.md`。
|
|
23
23
|
|
|
24
24
|
## 专项验收与人工确认边界
|
|
25
25
|
|
package/docs/USER-GUIDE.md
CHANGED
|
@@ -200,7 +200,7 @@ stdio 进程由 `@deepseek-ai/dsh-mcp-client` 管理,插件透传 `command`、
|
|
|
200
200
|
- 重新授权 OAuth,或重新录入 Token/API Key;
|
|
201
201
|
- 执行健康检查;
|
|
202
202
|
- 重新连接:重建 Host 侧条目并复检,用于“状态未知”或 Host 已放弃重连的连接;它不修改配置、凭据、范围或启停状态;
|
|
203
|
-
-
|
|
203
|
+
- **检测企查查旧授权**可扫描并复制旧工商、法律插件的本机授权。已经迁移后遇到红色**连接异常**,直接点击市场卡片,或在“已安装”的对应连接点**查看处理步骤**。
|
|
204
204
|
- 断开连接并删除该连接的本机配置。
|
|
205
205
|
|
|
206
206
|
OAuth 断开时,插件会尽力调用服务商的撤销端点;无撤销端点时仍会删除 DSH 本机授权记录。连接状态发生变化后,可点击“刷新连接器目录”重新检查。
|
|
@@ -211,6 +211,13 @@ OAuth 断开时,插件会尽力调用服务商的撤销端点;无撤销端
|
|
|
211
211
|
|
|
212
212
|
启用中的连接点击“保存并重连”后会先验证新配置、创建快照,再原子更新 Host 与本机记录;任何校验、启动或持久化失败都会保留原连接。停用连接可以保存配置但仍保持停用。连接范围和启停状态均不会被 JSON 静默改变。市场/OAuth 连接继续使用卡片的“配置”或“重新授权”流程。
|
|
213
213
|
|
|
214
|
+
### 企查查旧插件迁移后显示连接异常
|
|
215
|
+
|
|
216
|
+
1. 点击异常卡片,查看这条连接实际命中的插件或旧服务条目。工商插件的安装包名为 `qcc-dsh-mcp-oauth`,条目 ID 为 `qcc-mcp-oauth`。法律插件的安装包名为 `qcc-dsh-mcp-legal-oauth`,条目 ID 为 `qcc-legal-mcp-oauth`。
|
|
217
|
+
2. 如果提示插件仍启用,进入 **DSH 主界面 → 插件 → 已安装**,按安装包名找到提示的插件,关闭插件开关。旧版 DSH 可从**设置 → 插件市场**进入。请保留旧授权,旧插件的“断开授权”会尝试撤销凭据。
|
|
218
|
+
3. 如果提示旧插件已经停用、仍有旧服务条目启用,请在宿主插件配置中按弹框列出的完整条目 ID 核对并停用对应旧条目。如果界面没有条目开关,请把列出的 ID 交给管理员处理。法律连接的新旧条目可能使用相同的短 ID,请一并核对服务名称。
|
|
219
|
+
4. 完全退出 DSH 并重新启动;回到 **MCP连接器 → 已安装** 确认状态。若提示**需重新授权**,从对应卡片重新授权。若使用仅内存模式,重启后需在“检测企查查旧授权”中重新复制,或重新授权。
|
|
220
|
+
|
|
214
221
|
### 7.1 配置备份与恢复
|
|
215
222
|
|
|
216
223
|
“已安装”页的“配置备份”提供两种互补能力:
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# 产品截图与演示的来源及更新
|
|
2
2
|
|
|
3
|
-
<!-- generated:media -->本组 8 张截图和 GIF 均从 v0.2.
|
|
3
|
+
<!-- generated:media -->本组 8 张截图和 GIF 均从 v0.2.101 于 2026-11-11 重新采集,未修改截图中的版本文字。<!-- /generated:media -->
|
|
4
4
|
|
|
5
5
|
前七张素材由真实产品 UI 的无凭据 Mock harness 渲染:1280×720 浏览器视口、800px 产品面板、桌面两列卡片。顶部保留“无凭据 Mock”标识;目录数、连接数与工具数是演示夹具,不代表生产统计或真实授权、业务验收。不会读取用户 profile、调用服务商或上传业务数据。
|
|
6
6
|
|
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
"schemaVersion": 1,
|
|
3
3
|
"capture": {
|
|
4
4
|
"locale": "zh-CN",
|
|
5
|
-
"capturedOn": "2026-11-
|
|
6
|
-
"sourceVersion": "0.2.
|
|
7
|
-
"sourceFingerprint": "
|
|
5
|
+
"capturedOn": "2026-11-11",
|
|
6
|
+
"sourceVersion": "0.2.101",
|
|
7
|
+
"sourceFingerprint": "d8cee78aaccc0f493892a840b2f8cd6a1df66f137330096bdda907668a68c9f9",
|
|
8
8
|
"browserViewport": {
|
|
9
9
|
"width": 1280,
|
|
10
10
|
"height": 720
|
|
@@ -17,63 +17,63 @@
|
|
|
17
17
|
"screenshots": [
|
|
18
18
|
{
|
|
19
19
|
"path": "docs/screenshots/01-market-overview.jpg",
|
|
20
|
-
"sha256": "
|
|
20
|
+
"sha256": "ea937659c000a502b132e3ecc77633578fd57c377bd7d7cc63bc35614051f941",
|
|
21
21
|
"width": 1280,
|
|
22
22
|
"height": 720,
|
|
23
|
-
"capturedOn": "2026-11-
|
|
24
|
-
"sourceVersion": "0.2.
|
|
23
|
+
"capturedOn": "2026-11-11",
|
|
24
|
+
"sourceVersion": "0.2.101"
|
|
25
25
|
},
|
|
26
26
|
{
|
|
27
27
|
"path": "docs/screenshots/02-connector-detail.jpg",
|
|
28
|
-
"sha256": "
|
|
28
|
+
"sha256": "0caadb709188e76a32e122bd6c557e1d777a31aa387adf2cf8e5e0e4384c9218",
|
|
29
29
|
"width": 1280,
|
|
30
30
|
"height": 720,
|
|
31
|
-
"capturedOn": "2026-11-
|
|
32
|
-
"sourceVersion": "0.2.
|
|
31
|
+
"capturedOn": "2026-11-11",
|
|
32
|
+
"sourceVersion": "0.2.101"
|
|
33
33
|
},
|
|
34
34
|
{
|
|
35
35
|
"path": "docs/screenshots/03-tool-discovery.jpg",
|
|
36
|
-
"sha256": "
|
|
36
|
+
"sha256": "b59313086cb153d88fc013fab15877acd90ec89a4c9e64a84f6a96ec3f4387db",
|
|
37
37
|
"width": 1280,
|
|
38
38
|
"height": 720,
|
|
39
|
-
"capturedOn": "2026-11-
|
|
40
|
-
"sourceVersion": "0.2.
|
|
39
|
+
"capturedOn": "2026-11-11",
|
|
40
|
+
"sourceVersion": "0.2.101"
|
|
41
41
|
},
|
|
42
42
|
{
|
|
43
43
|
"path": "docs/screenshots/04-json-import.jpg",
|
|
44
|
-
"sha256": "
|
|
44
|
+
"sha256": "df06b106dfc2475cefe1ed28608da174f65b9a833de0a7f25260246ac6fd7400",
|
|
45
45
|
"width": 1280,
|
|
46
46
|
"height": 720,
|
|
47
|
-
"capturedOn": "2026-11-
|
|
48
|
-
"sourceVersion": "0.2.
|
|
47
|
+
"capturedOn": "2026-11-11",
|
|
48
|
+
"sourceVersion": "0.2.101"
|
|
49
49
|
},
|
|
50
50
|
{
|
|
51
51
|
"path": "docs/screenshots/05-unified-tool-search.png",
|
|
52
|
-
"sha256": "
|
|
52
|
+
"sha256": "c3b52bddd7c70803309fc5d934f9f7631e436976c7d1879f241da088120911b7",
|
|
53
53
|
"width": 1280,
|
|
54
54
|
"height": 720,
|
|
55
|
-
"capturedOn": "2026-11-
|
|
56
|
-
"sourceVersion": "0.2.
|
|
55
|
+
"capturedOn": "2026-11-11",
|
|
56
|
+
"sourceVersion": "0.2.101"
|
|
57
57
|
},
|
|
58
58
|
{
|
|
59
59
|
"path": "docs/screenshots/06-tool-parameters.png",
|
|
60
|
-
"sha256": "
|
|
60
|
+
"sha256": "8133e9808e4b5631ffa0114a403df81a505630e88da54f51e6173e62509fabc0",
|
|
61
61
|
"width": 1280,
|
|
62
62
|
"height": 720,
|
|
63
|
-
"capturedOn": "2026-11-
|
|
64
|
-
"sourceVersion": "0.2.
|
|
63
|
+
"capturedOn": "2026-11-11",
|
|
64
|
+
"sourceVersion": "0.2.101"
|
|
65
65
|
},
|
|
66
66
|
{
|
|
67
67
|
"path": "docs/screenshots/07-connection-diagnostics.png",
|
|
68
|
-
"sha256": "
|
|
68
|
+
"sha256": "699d46c8be937627b6c6fc1890f1ee36b1a4186486e462721cc1d5094bcb1bc7",
|
|
69
69
|
"width": 1280,
|
|
70
70
|
"height": 720,
|
|
71
|
-
"capturedOn": "2026-11-
|
|
72
|
-
"sourceVersion": "0.2.
|
|
71
|
+
"capturedOn": "2026-11-11",
|
|
72
|
+
"sourceVersion": "0.2.101"
|
|
73
73
|
},
|
|
74
74
|
{
|
|
75
75
|
"path": "docs/screenshots/08-ten-recommendations.jpg",
|
|
76
|
-
"sha256": "
|
|
76
|
+
"sha256": "cf2b60d4084bf028c47ed07f70f910ef9935844e60a109a28a04d35a0129eb50",
|
|
77
77
|
"width": 1280,
|
|
78
78
|
"height": 1400,
|
|
79
79
|
"browserViewport": {
|
|
@@ -81,17 +81,17 @@
|
|
|
81
81
|
"height": 1400
|
|
82
82
|
},
|
|
83
83
|
"panelHeight": 1280,
|
|
84
|
-
"capturedOn": "2026-11-
|
|
85
|
-
"sourceVersion": "0.2.
|
|
84
|
+
"capturedOn": "2026-11-11",
|
|
85
|
+
"sourceVersion": "0.2.101"
|
|
86
86
|
}
|
|
87
87
|
],
|
|
88
88
|
"demo": {
|
|
89
89
|
"path": "docs/demo.gif",
|
|
90
|
-
"sha256": "
|
|
90
|
+
"sha256": "762facb18a45773cfeb34fb93eebb071804eb7ba62c7d17114ea522e845f645b",
|
|
91
91
|
"width": 960,
|
|
92
92
|
"height": 540,
|
|
93
|
-
"capturedOn": "2026-11-
|
|
94
|
-
"sourceVersion": "0.2.
|
|
93
|
+
"capturedOn": "2026-11-11",
|
|
94
|
+
"sourceVersion": "0.2.101",
|
|
95
95
|
"durationSeconds": 36
|
|
96
96
|
}
|
|
97
97
|
}
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
"schemaVersion": 1,
|
|
3
3
|
"capture": {
|
|
4
4
|
"locale": "en",
|
|
5
|
-
"capturedOn": "2026-11-
|
|
6
|
-
"sourceVersion": "0.2.
|
|
7
|
-
"sourceFingerprint": "
|
|
5
|
+
"capturedOn": "2026-11-11",
|
|
6
|
+
"sourceVersion": "0.2.101",
|
|
7
|
+
"sourceFingerprint": "d8cee78aaccc0f493892a840b2f8cd6a1df66f137330096bdda907668a68c9f9",
|
|
8
8
|
"browserViewport": {
|
|
9
9
|
"width": 1280,
|
|
10
10
|
"height": 720
|
|
@@ -17,63 +17,63 @@
|
|
|
17
17
|
"screenshots": [
|
|
18
18
|
{
|
|
19
19
|
"path": "docs/screenshots/en/01-market-overview.jpg",
|
|
20
|
-
"sha256": "
|
|
20
|
+
"sha256": "39cda6fd891098fd1f0e6b9f98a30a17df01119726da4c07d2ae12b854cf7135",
|
|
21
21
|
"width": 1280,
|
|
22
22
|
"height": 720,
|
|
23
|
-
"capturedOn": "2026-11-
|
|
24
|
-
"sourceVersion": "0.2.
|
|
23
|
+
"capturedOn": "2026-11-11",
|
|
24
|
+
"sourceVersion": "0.2.101"
|
|
25
25
|
},
|
|
26
26
|
{
|
|
27
27
|
"path": "docs/screenshots/en/02-connector-detail.jpg",
|
|
28
|
-
"sha256": "
|
|
28
|
+
"sha256": "501ce3bdb5cf275b169f89d2d1cffd6977e469e07b4c269f48daae2d088cbf73",
|
|
29
29
|
"width": 1280,
|
|
30
30
|
"height": 720,
|
|
31
|
-
"capturedOn": "2026-11-
|
|
32
|
-
"sourceVersion": "0.2.
|
|
31
|
+
"capturedOn": "2026-11-11",
|
|
32
|
+
"sourceVersion": "0.2.101"
|
|
33
33
|
},
|
|
34
34
|
{
|
|
35
35
|
"path": "docs/screenshots/en/03-tool-discovery.jpg",
|
|
36
|
-
"sha256": "
|
|
36
|
+
"sha256": "ebaca4131388f24b7faba268511d4977a401ff31b47cf970d51363f2ce29f9ce",
|
|
37
37
|
"width": 1280,
|
|
38
38
|
"height": 720,
|
|
39
|
-
"capturedOn": "2026-11-
|
|
40
|
-
"sourceVersion": "0.2.
|
|
39
|
+
"capturedOn": "2026-11-11",
|
|
40
|
+
"sourceVersion": "0.2.101"
|
|
41
41
|
},
|
|
42
42
|
{
|
|
43
43
|
"path": "docs/screenshots/en/04-json-import.jpg",
|
|
44
|
-
"sha256": "
|
|
44
|
+
"sha256": "103bb913f5f10d2f5d5606147912010ebcb70f065ca15cc84330709cc34fba6c",
|
|
45
45
|
"width": 1280,
|
|
46
46
|
"height": 720,
|
|
47
|
-
"capturedOn": "2026-11-
|
|
48
|
-
"sourceVersion": "0.2.
|
|
47
|
+
"capturedOn": "2026-11-11",
|
|
48
|
+
"sourceVersion": "0.2.101"
|
|
49
49
|
},
|
|
50
50
|
{
|
|
51
51
|
"path": "docs/screenshots/en/05-unified-tool-search.png",
|
|
52
|
-
"sha256": "
|
|
52
|
+
"sha256": "76c43064c639a644b8b98e0c63dab26478234fecead75bb5d725da8e4ba587cc",
|
|
53
53
|
"width": 1280,
|
|
54
54
|
"height": 720,
|
|
55
|
-
"capturedOn": "2026-11-
|
|
56
|
-
"sourceVersion": "0.2.
|
|
55
|
+
"capturedOn": "2026-11-11",
|
|
56
|
+
"sourceVersion": "0.2.101"
|
|
57
57
|
},
|
|
58
58
|
{
|
|
59
59
|
"path": "docs/screenshots/en/06-tool-parameters.png",
|
|
60
|
-
"sha256": "
|
|
60
|
+
"sha256": "3c5ec0e2cc9d4ebb1c06375cd6b6d35d70576f8f9ac40e01734e5d060a55b17c",
|
|
61
61
|
"width": 1280,
|
|
62
62
|
"height": 720,
|
|
63
|
-
"capturedOn": "2026-11-
|
|
64
|
-
"sourceVersion": "0.2.
|
|
63
|
+
"capturedOn": "2026-11-11",
|
|
64
|
+
"sourceVersion": "0.2.101"
|
|
65
65
|
},
|
|
66
66
|
{
|
|
67
67
|
"path": "docs/screenshots/en/07-connection-diagnostics.png",
|
|
68
|
-
"sha256": "
|
|
68
|
+
"sha256": "3e02a0727dba8747631eaed6f1ef0f37a818ab3883e6670c38f8d135b8256771",
|
|
69
69
|
"width": 1280,
|
|
70
70
|
"height": 720,
|
|
71
|
-
"capturedOn": "2026-11-
|
|
72
|
-
"sourceVersion": "0.2.
|
|
71
|
+
"capturedOn": "2026-11-11",
|
|
72
|
+
"sourceVersion": "0.2.101"
|
|
73
73
|
},
|
|
74
74
|
{
|
|
75
75
|
"path": "docs/screenshots/en/08-ten-recommendations.jpg",
|
|
76
|
-
"sha256": "
|
|
76
|
+
"sha256": "f380e306604bc60ad9cff6dae098f5c4e1cb2ff5c2a6ca68c184bfb4b100e667",
|
|
77
77
|
"width": 1280,
|
|
78
78
|
"height": 1400,
|
|
79
79
|
"browserViewport": {
|
|
@@ -81,17 +81,17 @@
|
|
|
81
81
|
"height": 1400
|
|
82
82
|
},
|
|
83
83
|
"panelHeight": 1280,
|
|
84
|
-
"capturedOn": "2026-11-
|
|
85
|
-
"sourceVersion": "0.2.
|
|
84
|
+
"capturedOn": "2026-11-11",
|
|
85
|
+
"sourceVersion": "0.2.101"
|
|
86
86
|
}
|
|
87
87
|
],
|
|
88
88
|
"demo": {
|
|
89
89
|
"path": "docs/screenshots/en/demo.gif",
|
|
90
|
-
"sha256": "
|
|
90
|
+
"sha256": "5307c26f505110c03c0c3eb93f04fda02f39ec07998906dc55161cd920c69727",
|
|
91
91
|
"width": 960,
|
|
92
92
|
"height": 540,
|
|
93
|
-
"capturedOn": "2026-11-
|
|
94
|
-
"sourceVersion": "0.2.
|
|
93
|
+
"capturedOn": "2026-11-11",
|
|
94
|
+
"sourceVersion": "0.2.101",
|
|
95
95
|
"durationSeconds": 36
|
|
96
96
|
}
|
|
97
97
|
}
|
|
Binary file
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
| 项目 | 验收要求 |
|
|
10
10
|
|---|---|
|
|
11
|
-
| 前提 | <!-- generated:version -->正式 `dsh-mcp-connector@0.2.
|
|
11
|
+
| 前提 | <!-- generated:version -->正式 `dsh-mcp-connector@0.2.101`<!-- /generated:version -->;当前 Workspace;企查查 OAuth 可用;测试账号具有目标企业数据权限 |
|
|
12
12
|
| 权限/管理员 | 账号权限、组织授权和可见字段由服务商控制;企业组织可能需要管理员开通,当前文档不能替代审批 |
|
|
13
13
|
| 费用 | 可能受套餐、次数或字段权限影响;MCP连接器无法确认本次费用,调用前在服务商侧核对 |
|
|
14
14
|
| 运行/数据去向 | 远程 MCP Server;企业名称、查询参数和调用结果经 DSH Host 发送到/返回自 `agent.qcc.com` |
|
package/lib/diagnostics.js
CHANGED
|
@@ -36,7 +36,7 @@ const STAGE_MSGIDS = Object.freeze({
|
|
|
36
36
|
const FAILURE_GUIDANCE = Object.freeze({
|
|
37
37
|
auth: ['authentication', '重新授权或更新凭据,然后再次运行健康检查'],
|
|
38
38
|
refresh: ['authentication', '等待自动重试;若持续失败,请检查网络和 OAuth 服务状态'],
|
|
39
|
-
conflict: ['configuration', '
|
|
39
|
+
conflict: ['configuration', '点击连接异常查看冲突条目及恢复步骤'],
|
|
40
40
|
'rate-limit': ['transport', '等待服务端限流窗口结束后重试'],
|
|
41
41
|
dns: ['transport', '检查 DNS、代理和当前网络后重试'],
|
|
42
42
|
tls: ['transport', '检查证书、VPN/专线和来源 IP 白名单后重试'],
|
|
@@ -154,6 +154,7 @@ function resultDiagnostic(t, result, checkedAt, previous) {
|
|
|
154
154
|
stageLabel: stageLabel(t, stage),
|
|
155
155
|
code,
|
|
156
156
|
message: result.message || t('连接检查未通过'),
|
|
157
|
+
...(result.legacyConflict ? { legacyConflict: result.legacyConflict } : {}),
|
|
157
158
|
action: t(action),
|
|
158
159
|
checkedAt,
|
|
159
160
|
lastSuccessfulAt: earlier?.lastSuccessfulAt ?? null,
|
|
@@ -205,7 +206,7 @@ export function buildHealthSummary({
|
|
|
205
206
|
|
|
206
207
|
let connectionState = 'unknown';
|
|
207
208
|
if (records.length === 0) connectionState = 'disconnected';
|
|
208
|
-
else if (enabledRecords.length === 0) connectionState = 'disabled';
|
|
209
|
+
else if (enabledRecords.length === 0 && !authFailures && !normalizedResults.some((result) => result.legacyConflict)) connectionState = 'disabled';
|
|
209
210
|
else if (failedServers === 0 && pendingServers === 0 && availableServers > 0) connectionState = 'healthy';
|
|
210
211
|
else if (availableServers > 0 && (failedServers > 0 || pendingServers > 0)) connectionState = 'degraded';
|
|
211
212
|
else if (pendingServers > 0 && failedServers === 0) connectionState = 'unknown';
|
|
@@ -220,7 +221,8 @@ export function buildHealthSummary({
|
|
|
220
221
|
} else if (connectionState === 'healthy') {
|
|
221
222
|
diagnostic = { ...normalizedResults[0].diagnostic, state: 'healthy', lastSuccessfulAt };
|
|
222
223
|
} else {
|
|
223
|
-
const representative = normalizedResults.find((result) =>
|
|
224
|
+
const representative = normalizedResults.find((result) => result.legacyConflict)
|
|
225
|
+
|| normalizedResults.find((result) => !result.ok)
|
|
224
226
|
|| normalizedResults.find((result) => result.kind === 'managed')
|
|
225
227
|
|| normalizedResults[0];
|
|
226
228
|
diagnostic = {
|
|
@@ -28,7 +28,7 @@ export default {
|
|
|
28
28
|
"可用性确认": "Availability confirmation",
|
|
29
29
|
"重新授权或更新凭据,然后再次运行健康检查": "Reauthorize or update the credentials, then run the health check again",
|
|
30
30
|
"等待自动重试;若持续失败,请检查网络和 OAuth 服务状态": "Wait for the automatic retry; if it keeps failing, check the network and the OAuth service status",
|
|
31
|
-
"
|
|
31
|
+
"点击连接异常查看冲突条目及恢复步骤": "Select the connection error to see the conflicting entries and recovery steps",
|
|
32
32
|
"等待服务端限流窗口结束后重试": "Wait for the server rate-limit window to end, then retry",
|
|
33
33
|
"检查 DNS、代理和当前网络后重试": "Check DNS, the proxy, and the current network, then retry",
|
|
34
34
|
"检查证书、VPN/专线和来源 IP 白名单后重试": "Check certificates, VPN/dedicated lines, and the source IP allowlist, then retry",
|
|
@@ -73,6 +73,8 @@ export default {
|
|
|
73
73
|
'本地参数仅支持无凭据的市场 stdio 连接,不可覆盖授权配置': 'Local overrides only apply to credential-free marketplace stdio connections and cannot override authorization settings',
|
|
74
74
|
'本地参数更新失败,已尝试恢复原配置;请检查本机 Host 日志与连接状态': 'Updating local overrides failed and the original configuration was restored; check the local Host logs and connection status',
|
|
75
75
|
'检测到旧插件 {id} 仍处于启用状态;它会与 MCP连接器重复管理企查查 Server': 'Legacy plugin {id} is still enabled; it and MCP Connector would both manage the Qichacha servers',
|
|
76
|
+
'旧插件 {pluginId} 仍在管理企查查授权;请停用旧插件并重启 DSH': 'The legacy plugin {pluginId} still manages the Qichacha authorization. Disable the legacy plugin and restart DSH.',
|
|
77
|
+
'旧服务条目 {entryIds} 仍启用;请停用这些条目并完整重启 DSH': 'The legacy service entries {entryIds} are still enabled. Disable these entries, fully quit DSH, and restart it.',
|
|
76
78
|
'检测到旧插件 {pluginId} 仍在管理同名服务 {serverName};为避免凭据覆盖,请停用旧插件并重启 DSH 后再连接': 'Legacy plugin {pluginId} still manages a server named {serverName}. To avoid overwriting credentials, disable the legacy plugin, restart DSH, and connect again',
|
|
77
79
|
'检测到旧插件 {pluginId} 仍在管理同名服务 {serverName};请停用旧插件并重启 DSH': 'Legacy plugin {pluginId} still manages a server named {serverName}; disable the legacy plugin and restart DSH',
|
|
78
80
|
'治理策略 revision={revision},{count} 条规则;{precedence}': 'Governance policy revision={revision}, {count} rules; {precedence}',
|
|
@@ -124,7 +126,6 @@ export default {
|
|
|
124
126
|
'mode 必须为 always 或 session': 'mode must be always or session',
|
|
125
127
|
'project-only 仅当前 Workspace 可见;global 由所有 Workspace 继承': 'project-only is visible only in the current Workspace; global is inherited by every Workspace',
|
|
126
128
|
'{connectorName}(已迁移)': '{connectorName} (already migrated)',
|
|
127
|
-
'{message};授权已复制,重启后将由 MCP连接器恢复': '{message}; the authorization was copied and MCP Connector will restore it after a restart',
|
|
128
129
|
'{sourcePlugin}(未匹配当前目录)': '{sourcePlugin} (no match in the current catalog)',
|
|
129
130
|
'作用域回滚预览:将影响 {serverCount} 个 Server、{toolCount} 个已知工具;凭据不受影响': 'Scope rollback preview: affects {serverCount} Servers and {toolCount} known tools; credentials are unaffected',
|
|
130
131
|
'作用域回滚预览:当前已是目标 revision': 'Scope rollback preview: already at the target revision',
|
|
@@ -145,7 +146,12 @@ export default {
|
|
|
145
146
|
'已保留启用前配置,请修正后重试': 'The pre-enable configuration was kept; fix the problem and try again',
|
|
146
147
|
'已保留恢复前配置,请修正后重试': 'The pre-restore configuration was kept; fix the problem and try again',
|
|
147
148
|
'已保留连接配置,但 Host 条目可能仍停用;请检查后重新连接': 'The connection configuration was kept, but the Host entry may still be disabled; check it and reconnect',
|
|
148
|
-
'已复制 {count}
|
|
149
|
+
'已复制 {count} 组旧授权;原插件与原凭据均保留': 'Copied {count} legacy authorizations; the old plugin and its credentials are preserved',
|
|
150
|
+
'旧授权已复制。请处理 {plugins} 的迁移冲突,然后完整重启 DSH。': 'The legacy authorization was copied. Resolve the migration conflict for {plugins}, then fully restart DSH.',
|
|
151
|
+
'旧授权等待交接,请完整退出并重启 DSH': 'The legacy authorization is waiting to be transferred. Fully quit and restart DSH.',
|
|
152
|
+
'当前仅在内存中保存授权。完整重启 DSH 后,请再次检测并复制旧授权。': 'Authorizations are stored in memory only. After fully restarting DSH, scan and copy the legacy authorization again.',
|
|
153
|
+
'旧授权已失效,请在市场中重新授权。': 'The legacy authorization is no longer valid. Reauthorize the connection in the marketplace.',
|
|
154
|
+
'已断开 "{name}",旧插件的授权已保留': 'Disconnected "{name}" and preserved the legacy plugin authorization',
|
|
149
155
|
'已将 "{name}" 设为始终注入': 'Set "{name}" to always inject',
|
|
150
156
|
'已将 "{name}" 设为按会话启用;连接保持在线,业务工具默认隐藏': 'Set "{name}" to enable per session; the connection stays online and business tools are hidden by default',
|
|
151
157
|
'已恢复 revision={rollbackRevision} 的作用域绑定,新 revision={revision}': 'Restored the scope bindings of revision={rollbackRevision}; new revision={revision}',
|