dsh-mcp-connector 0.2.114 → 0.2.115

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.
Files changed (32) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/README.en.md +8 -8
  3. package/README.md +8 -8
  4. package/docs/PLUGIN-UPDATE.md +16 -4
  5. package/docs/SESSION-TOOL-INJECTION.md +13 -7
  6. package/docs/USER-GUIDE.md +1 -1
  7. package/docs/screenshots/01-market-overview.jpg +0 -0
  8. package/docs/screenshots/02-connector-detail.jpg +0 -0
  9. package/docs/screenshots/03-tool-discovery.jpg +0 -0
  10. package/docs/screenshots/04-json-import.jpg +0 -0
  11. package/docs/screenshots/05-unified-tool-search.png +0 -0
  12. package/docs/screenshots/06-tool-parameters.png +0 -0
  13. package/docs/screenshots/07-connection-diagnostics.png +0 -0
  14. package/docs/screenshots/08-ten-recommendations.jpg +0 -0
  15. package/docs/screenshots/README.md +1 -1
  16. package/docs/screenshots/assets.json +19 -19
  17. package/docs/screenshots/en/01-market-overview.jpg +0 -0
  18. package/docs/screenshots/en/02-connector-detail.jpg +0 -0
  19. package/docs/screenshots/en/03-tool-discovery.jpg +0 -0
  20. package/docs/screenshots/en/04-json-import.jpg +0 -0
  21. package/docs/screenshots/en/05-unified-tool-search.png +0 -0
  22. package/docs/screenshots/en/06-tool-parameters.png +0 -0
  23. package/docs/screenshots/en/07-connection-diagnostics.png +0 -0
  24. package/docs/screenshots/en/08-ten-recommendations.jpg +0 -0
  25. package/docs/screenshots/en/assets.json +19 -19
  26. package/docs/screenshots/en/demo.gif +0 -0
  27. package/docs/tutorials/FIRST-SUCCESS-SCENARIOS.md +1 -1
  28. package/lib/client.js +224 -43
  29. package/lib/i18n/locales/en/client.js +16 -0
  30. package/lib/index.js +11 -5
  31. package/lib/version-status.js +2 -0
  32. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,26 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.2.115 - 2026-11-19
4
+
5
+ 打开「MCP 连接器」后,面板会自动检查插件版本。发现新版时,标题旁会同时显示当前版本和可更新的版本。首次检查失败时,可以点击「重新检查」。
6
+
7
+ ### Windows 和 macOS 桌面版
8
+
9
+ 发现新版后,点击 **「前往更新」**,即可打开 DeepSeek Harness 的插件详情页。在详情页点击「更新到…」并确认,安装进度和重启提示都会在那里显示。正常更新无需复制命令。
10
+
11
+ 如果详情页打不开,面板会收起「前往更新」,直接显示手动进入的路径:打开侧栏 **「插件」→「已安装」→ `dsh-mcp-connector`**。如果之前已经发现新版,后来重新检查失败,面板会保留上次发现的版本并标明情况,你仍可前往详情页查看当前可用的更新。
12
+
13
+ ### Web 版
14
+
15
+ 发现新版后,如果当前环境支持直接更新,点击 **「更新到…」** 即可在面板内开始更新。需要手动升级时,点击 **「查看升级方式」**,再按展开的说明操作。
16
+
17
+ 已经发现新版后,退出面板再从默认侧栏打开,「更新到…」按钮会留在原位。重新检查期间按钮暂时变淡、不可点击;确认新版仍可安装后,按钮会在原位恢复。
18
+
19
+ ### 连接器市场与下载统计
20
+
21
+ - **市场目录刷新更及时。** 修复了手动刷新后仍可能看到旧目录的问题。使用默认目录时,点击市场工具栏的刷新按钮,会优先获取最新卡片;如果最新目录暂时无法访问,会自动尝试备用来源。这项修复覆盖了权大师等新卡片已上架、刷新后却仍然找不到的情况。
22
+ - **下载趋势图已更新至 2026 年 11 月 17 日。** 11 月 17 日当天新增 2,091 次 npm 下载,图示统计区间内累计 85,898 次。统计包含重复安装、升级和自动化下载。
23
+
3
24
  ## 0.2.114 - 2026-11-19
4
25
 
5
26
  - 修复厂商 `type: "sse"` 配置导入后被改成 Streamable HTTP、连接返回 HTTP 405 的问题。JSON 导入、手动配置、目录卡片、编辑及脱敏分享保留旧版 HTTP + SSE 协议。
package/README.en.md CHANGED
@@ -14,7 +14,7 @@
14
14
  | [企业数据](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/CONNECTOR-DIRECTORY.md#%E4%BC%81%E4%B8%9A%E6%95%B0%E6%8D%AE) | 2 | [企查查·企业工商](https://github.com/duhu2000/dsh-mcp-connector/blob/main/catalog/catalog.json)、[企查查·招投标](https://github.com/duhu2000/dsh-mcp-connector/blob/main/catalog/catalog.json) |
15
15
  | [金融投资](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/CONNECTOR-DIRECTORY.md#%E9%87%91%E8%9E%8D%E6%8A%95%E8%B5%84) | 14 | [Wind·股票数据](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/wind-stock-data.json)、[TuShare](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/tushare.json)、[AKShare](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/akshare.json) 等 |
16
16
  | [法律合规](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/CONNECTOR-DIRECTORY.md#%E6%B3%95%E5%BE%8B%E5%90%88%E8%A7%84) | 5 | [企查查·法律数据](https://github.com/duhu2000/dsh-mcp-connector/blob/main/catalog/catalog.json)、[北大法宝·法律检索](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/pkulaw-legal.json)、[巴西参议院开放数据](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/brazil-senate-open-data.json) 等 |
17
- | [调研分析](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/CONNECTOR-DIRECTORY.md#%E8%B0%83%E7%A0%94%E5%88%86%E6%9E%90) | 43 | [飞常准航空数据](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/variflight-aviation-data.json)、[智慧芽专利与文献](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/patsnap.json)、[OpenAlex 全球学术研究](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/openalex-research-catalog.json) 等 |
17
+ | [调研分析](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/CONNECTOR-DIRECTORY.md#%E8%B0%83%E7%A0%94%E5%88%86%E6%9E%90) | 44 | [飞常准航空数据](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/variflight-aviation-data.json)、[智慧芽专利与文献](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/patsnap.json)、[OpenAlex 全球学术研究](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/openalex-research-catalog.json) 等 |
18
18
  | [办公协作](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/CONNECTOR-DIRECTORY.md#%E5%8A%9E%E5%85%AC%E5%8D%8F%E4%BD%9C) | 17 | [腾讯文档](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/tencent-docs.json)、[飞书开放平台](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/feishu.json)、[Notion](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/notion.json) 等 |
19
19
  | [开发工具](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/CONNECTOR-DIRECTORY.md#%E5%BC%80%E5%8F%91%E5%B7%A5%E5%85%B7) | 23 | [GitHub](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/github.json)、[Playwright](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/playwright.json)、[Chrome DevTools](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/chrome-devtools.json) 等 |
20
20
  | [设计创意](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/CONNECTOR-DIRECTORY.md#%E8%AE%BE%E8%AE%A1%E5%88%9B%E6%84%8F) | 10 | [Canva 可画](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/canva.json)、[draw.io](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/drawio.json)、[可灵 AI(AceDataCloud)](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/kling.json) 等 |
@@ -48,11 +48,11 @@ Results identify their source and last successful cache time. A cached tool is n
48
48
 
49
49
  Tool browsing does not execute target tools. Parameter summaries may omit complex rules; the original-schema view contains the sanitized, size-limited cached schema, not an untouched server response. See the [Chinese tool-workspace guide](docs/USER-GUIDE.md#51-工具工作台统一查找工具).
50
50
 
51
- ### QCC smart loading (development preview; unreleased)
51
+ ### QCC smart loading
52
52
 
53
- Normal startup on verified Native Host `0.2.2-rc.1` can expose Smart tools for the configured account's six enterprise services under one unambiguous grant. Compatibility remains the default. One preview/confirmation enables smart loading for new sessions; existing sessions keep their mode, without changing six separate injection settings.
53
+ Smart loading has shipped since plugin version `0.2.111`. Compatibility mode is the default. The verified host is DSH Native Host `0.2.2-rc.1`. The feature covers the configured account's six QCC enterprise data services under a single grant. Preview the scope in **Smart tools** and confirm to enable smart loading for new sessions. Existing sessions keep their mode.
54
54
 
55
- Preparation still requires an independently verified read-only record bound to the complete definition fingerprint; deduplication requires separately approved equivalence relations. This branch creates neither approval automatically. Production installation and real provider benefit remain unverified. See the [scope and rollback guide](docs/SESSION-TOOL-INJECTION.md#development-preview-english).
55
+ Preparing a real tool requires an independent read-only review and trusted signed evidence bound to its full definition fingerprint. Combining duplicate sources requires a separate equivalence review. An administrator must provision the trust keys and review evidence for the target environment. Token savings on real model requests still need to be measured. [Enablement, evidence delivery and rollback](docs/SESSION-TOOL-INJECTION.md#qcc-enterprise-smart-loading)
56
56
 
57
57
  [Chinese user guide](docs/USER-GUIDE.md) · [Connector onboarding](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/ONBOARDING.md) · [First contribution](docs/FIRST-CONTRIBUTION.md) · [Contributing](CONTRIBUTING.md) · [Issues](https://github.com/duhu2000/dsh-mcp-connector/issues)
58
58
 
@@ -144,11 +144,11 @@ If the plugin helps you connect an MCP server faster, consider [starring the rep
144
144
  - Explainable diagnostics report only observed evidence. Unchecked or Host-unobservable connections remain `unknown`, with a failure stage, stable code, suggested action, check time, and process-local last-success time.
145
145
  - Built-in, remote, and local catalogs with `published` and `featured` controls.
146
146
  - A standalone remote Registry, allowing new marketplace cards to appear after refresh without publishing a new npm version.
147
- - 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.
147
+ - When Desktop detects a newer plugin version on Windows or macOS, select **Go to update** and confirm the installation on the host’s plugin details page. If the host cannot open the page directly, the panel shows how to reach it from the sidebar. When navigation is unavailable, expand **View manual upgrade command** for the CLI alternative. On Web, a compatible Update Provider offers in-panel updates, progress, and rollback when available. [Plugin update guide](docs/PLUGIN-UPDATE.md)
148
148
  - 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.
149
149
 
150
150
  <!-- catalog-stats:start -->
151
- As of 2026-11-18, the public Registry publishes 119 connector descriptors. After merging and deduplicating them with the 4 bundled Qichacha cards, the Marketplace exposes 123 cards across 9 business categories. Homepage recommendations follow the installed plugin version, not the Registry featured count. The Registry evolves independently; the badge shown after a client refresh and the live badges above are the authoritative current counts.
151
+ As of 2026-11-19, the public Registry publishes 120 connector descriptors. After merging and deduplicating them with the 4 bundled Qichacha cards, the Marketplace exposes 124 cards across 9 business categories. Homepage recommendations follow the installed plugin version, not the Registry featured count. The Registry evolves independently; the badge shown after a client refresh and the live badges above are the authoritative current counts.
152
152
  <!-- catalog-stats:end -->
153
153
 
154
154
  ## Interface and demo
@@ -163,7 +163,7 @@ As of 2026-11-18, the public Registry publishes 119 connector descriptors. After
163
163
  | Connection diagnostics and last-success cache | |
164
164
  | ![Connection diagnostics](https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/main/docs/screenshots/en/07-connection-diagnostics.png) | |
165
165
 
166
- <!-- generated:media -->English UI screenshots and GIF were captured from v0.2.114 (2026-11-19), 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 -->
166
+ <!-- generated:media -->English UI screenshots and GIF were captured from v0.2.115 (2026-11-19), 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 -->
167
167
 
168
168
  ## Installation
169
169
 
@@ -305,7 +305,7 @@ npm run dev:ui
305
305
 
306
306
  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.
307
307
 
308
- <!-- generated:version -->The current public version is [`dsh-mcp-connector@0.2.114`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.114](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.114).<!-- /generated:version -->
308
+ <!-- generated:version -->The current public version is [`dsh-mcp-connector@0.2.115`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.115](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.115).<!-- /generated:version -->
309
309
 
310
310
  See [CHANGELOG.md](CHANGELOG.md) for version history and [docs/DESKTOP-E2E.md](docs/DESKTOP-E2E.md) for the Desktop release checklist.
311
311
 
package/README.md CHANGED
@@ -14,7 +14,7 @@
14
14
  | [企业数据](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/CONNECTOR-DIRECTORY.md#%E4%BC%81%E4%B8%9A%E6%95%B0%E6%8D%AE) | 2 | [企查查·企业工商](https://github.com/duhu2000/dsh-mcp-connector/blob/main/catalog/catalog.json)、[企查查·招投标](https://github.com/duhu2000/dsh-mcp-connector/blob/main/catalog/catalog.json) |
15
15
  | [金融投资](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/CONNECTOR-DIRECTORY.md#%E9%87%91%E8%9E%8D%E6%8A%95%E8%B5%84) | 14 | [Wind·股票数据](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/wind-stock-data.json)、[TuShare](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/tushare.json)、[AKShare](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/akshare.json) 等 |
16
16
  | [法律合规](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/CONNECTOR-DIRECTORY.md#%E6%B3%95%E5%BE%8B%E5%90%88%E8%A7%84) | 5 | [企查查·法律数据](https://github.com/duhu2000/dsh-mcp-connector/blob/main/catalog/catalog.json)、[北大法宝·法律检索](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/pkulaw-legal.json)、[巴西参议院开放数据](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/brazil-senate-open-data.json) 等 |
17
- | [调研分析](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/CONNECTOR-DIRECTORY.md#%E8%B0%83%E7%A0%94%E5%88%86%E6%9E%90) | 43 | [飞常准航空数据](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/variflight-aviation-data.json)、[智慧芽专利与文献](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/patsnap.json)、[OpenAlex 全球学术研究](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/openalex-research-catalog.json) 等 |
17
+ | [调研分析](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/CONNECTOR-DIRECTORY.md#%E8%B0%83%E7%A0%94%E5%88%86%E6%9E%90) | 44 | [飞常准航空数据](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/variflight-aviation-data.json)、[智慧芽专利与文献](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/patsnap.json)、[OpenAlex 全球学术研究](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/openalex-research-catalog.json) 等 |
18
18
  | [办公协作](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/CONNECTOR-DIRECTORY.md#%E5%8A%9E%E5%85%AC%E5%8D%8F%E4%BD%9C) | 17 | [腾讯文档](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/tencent-docs.json)、[飞书开放平台](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/feishu.json)、[Notion](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/notion.json) 等 |
19
19
  | [开发工具](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/CONNECTOR-DIRECTORY.md#%E5%BC%80%E5%8F%91%E5%B7%A5%E5%85%B7) | 23 | [GitHub](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/github.json)、[Playwright](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/playwright.json)、[Chrome DevTools](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/chrome-devtools.json) 等 |
20
20
  | [设计创意](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/CONNECTOR-DIRECTORY.md#%E8%AE%BE%E8%AE%A1%E5%88%9B%E6%84%8F) | 10 | [Canva 可画](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/canva.json)、[draw.io](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/drawio.json)、[可灵 AI(AceDataCloud)](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/connectors/kling.json) 等 |
@@ -60,11 +60,11 @@ Install into the profile loaded by your host: use `--profile desktop` with the D
60
60
 
61
61
  详见[工具工作台教程](docs/USER-GUIDE.md#51-工具工作台统一查找工具)。工具页用于发现与诊断,不执行目标工具;参数摘要与原始安全缓存均有裁剪边界。
62
62
 
63
- ### 企查查智能按需模式(开发分支预览,尚未发布)
63
+ ### 企查查智能按需模式
64
64
 
65
- 在已验证的 Native Host `0.2.2-rc.1` 上,正常插件启动可自动提供“智能工具”入口。首期只识别当前配置账号、单个明确授权下的企业数据六个服务;默认保持兼容模式,一次预览确认即可为新会话启用按需模式,已有会话保留原模式。无需逐服务修改注入配置。
65
+ 插件自 `0.2.111` 起提供智能按需模式,默认使用兼容模式。已验证的宿主为 DSH Native Host `0.2.2-rc.1`,首期范围是当前配置账号在同一授权下的六个企查查企业数据服务。在“智能工具”中预览范围并确认后,按需模式对新会话生效,已有会话保留原模式。
66
66
 
67
- 真实工具仍须完整定义指纹绑定的独立只读核验,来源合并仍须独立等价核验;本分支不自动生成这些批准,未核验时 prepare 会拒绝。生产安装与真实收益尚待验收。支持边界、恢复和回退见[按会话工具注入说明](docs/SESSION-TOOL-INJECTION.md#企查查企业数据智能按需模式开发分支预览)。
67
+ 真实工具的按需加载需要与完整工具定义指纹绑定的独立只读核验及受信签名证据,合并重复来源还需要单独的等价核验。管理员须为目标环境配置信任公钥并交付审核证据。真实模型的 Token 节省效果仍待实测。[启用条件、证据交付与回退](docs/SESSION-TOOL-INJECTION.md#企查查企业数据智能按需模式)
68
68
 
69
69
  [用户手册](docs/USER-GUIDE.md) · [第三方连接器上架指南](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/ONBOARDING.md) · [首次贡献](docs/FIRST-CONTRIBUTION.md) · [参与贡献](CONTRIBUTING.md) · [问题反馈](https://github.com/duhu2000/dsh-mcp-connector/issues)
70
70
 
@@ -156,13 +156,13 @@ Desktop 需要完全退出并重新启动应用;Web 需要停止原 `dsh web`
156
156
  - 可解释诊断:只报告实际观察结果;未检查或 Host 状态不可见时显示“状态未知”,并提供失败阶段、稳定错误码、建议动作、检查时间和进程内最近成功时间。
157
157
  - 目录运营:内置目录、远程 registry、本地覆盖,支持 `published` 上下架与 `featured` 精选。
158
158
  - 独立远程 Registry:新市场卡片合并后客户端刷新即可见,无需重新发布 npm;远程不可用时自动回退内置目录。
159
- - 插件版本与一键更新:版本发现独立于安装来源;页面通过 Update Provider 适配层探测安全更新能力。DSH Market API v1 是首个适配器,支持进度、稳定失败码、回滚及按宿主能力提供的重启/刷新操作;无可用 Provider 时回退到当前插件市场或 npm。
159
+ - Windows 和 macOS 桌面版检测到插件新版本时,点击“前往更新”,在宿主的插件详情页确认安装。若宿主无法打开详情,面板会显示从侧栏进入的步骤。跳转不可用时可展开“查看手动升级命令”。Web 版可通过兼容的 Update Provider 在面板内完成更新,并查看进度及可用的回滚操作。[插件更新说明](docs/PLUGIN-UPDATE.md)
160
160
  - Registry 工具链:Schema/唯一性/密钥审计、MCP/OAuth 无凭据探针、每周健康巡检。
161
161
  - 旧企查查 OAuth 插件迁移:扫描并复制工商、法律授权。已迁移的客户可以从市场的“连接异常”或已安装行查看冲突插件、残留条目和恢复步骤。
162
162
  - 对话工具:`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 工具。
163
163
 
164
164
  <!-- catalog-stats:start -->
165
- 截至 2026-11-18,公共 Registry 已发布 119 条连接器描述;与随包的 4 张企查查卡片合并去重后,市场页可浏览 123 张卡片,覆盖企业数据、金融投资、法律合规、开发工具、办公协作、调研分析、设计创意、效率工具、其他 9 类。首页推荐由当前插件版本的推荐规则决定,不以 Registry featured 数量代表首页推荐数量。Registry 可独立持续更新,实际数量以客户端刷新后的市场页签徽标和上方实时统计徽标为准。
165
+ 截至 2026-11-19,公共 Registry 已发布 120 条连接器描述;与随包的 4 张企查查卡片合并去重后,市场页可浏览 124 张卡片,覆盖企业数据、金融投资、法律合规、开发工具、办公协作、调研分析、设计创意、效率工具、其他 9 类。首页推荐由当前插件版本的推荐规则决定,不以 Registry featured 数量代表首页推荐数量。Registry 可独立持续更新,实际数量以客户端刷新后的市场页签徽标和上方实时统计徽标为准。
166
166
  <!-- catalog-stats:end -->
167
167
 
168
168
  ## 界面与演示
@@ -177,7 +177,7 @@ Desktop 需要完全退出并重新启动应用;Web 需要停止原 `dsh web`
177
177
  | 连接诊断与最后成功缓存 | |
178
178
  | ![连接诊断](https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/main/docs/screenshots/07-connection-diagnostics.png) | |
179
179
 
180
- <!-- generated:media -->截图与 GIF 采集自 v0.2.114(2026-11-19)无凭据 Mock 页面,展示界面而非真实业务验收;市场数量是测试夹具。来源与更新方法见 [素材说明](docs/screenshots/README.md)。<!-- /generated:media -->
180
+ <!-- generated:media -->截图与 GIF 采集自 v0.2.115(2026-11-19)无凭据 Mock 页面,展示界面而非真实业务验收;市场数量是测试夹具。来源与更新方法见 [素材说明](docs/screenshots/README.md)。<!-- /generated:media -->
181
181
 
182
182
  ## 安装
183
183
 
@@ -312,7 +312,7 @@ npm run dev:ui
312
312
 
313
313
  公共 Registry 每次合并后会生成 `catalog-stats.json`;本仓库的定时工作流每小时同步中英文介绍和统计快照。npm 页面中的静态正文随版本发布更新,上方动态统计徽标则直接读取 Registry,可在不发布新 npm 版本时保持实时数量一致。
314
314
 
315
- <!-- generated:version -->当前公开版本为 [`dsh-mcp-connector@0.2.114`](https://www.npmjs.com/package/dsh-mcp-connector),对应 [GitHub Release v0.2.114](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.114)。<!-- /generated:version -->
315
+ <!-- generated:version -->当前公开版本为 [`dsh-mcp-connector@0.2.115`](https://www.npmjs.com/package/dsh-mcp-connector),对应 [GitHub Release v0.2.115](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.115)。<!-- /generated:version -->
316
316
 
317
317
  版本能力与变更记录见 [CHANGELOG.md](CHANGELOG.md)。
318
318
  Desktop 发版回归见 [docs/DESKTOP-E2E.md](docs/DESKTOP-E2E.md)。
@@ -1,6 +1,14 @@
1
1
  # MCP连接器插件更新协议
2
2
 
3
- MCP连接器把“刷新连接器目录”和“升级插件代码”视为两个独立动作:前者只重新拉取 Registry 卡片,后者必须由当前 DSH 宿主中可用的安全 Update Provider 执行。
3
+ “检查更新”检查 MCP连接器插件的版本。市场页的刷新按钮用于重新加载 Registry 中的连接器卡片。
4
+
5
+ ## 在 Windows 和 macOS 桌面版更新
6
+
7
+ 1. 打开 MCP连接器后会自动检查更新。首次检查失败时,点击“重新检查”。发现新版后,点击“前往更新”。
8
+ 2. 在宿主的插件详情页确认包名 `dsh-mcp-connector` 和目标版本,点击“更新到…”。如果宿主无法直接打开详情,按连接器面板中的指引打开侧栏“插件” → “已安装” → `dsh-mcp-connector`,再点击更新。这里的“已安装”位于宿主的“插件”页面。
9
+ 3. 按宿主提示完成更新。若提示重启,完全退出并重新打开 DeepSeek Harness,再到 MCP连接器标题旁确认正在运行的版本。
10
+
11
+ 桌面入口面向通过宿主桥接协议 v1 识别到的 Windows 和 macOS 客户端。连接器通过宿主提供的可选 `pluginNavigation.openBundle` 打开插件详情,用户在详情页确认安装。未提供直达入口或跳转失败时,页头直接显示侧栏路径和“查看手动升级命令”。
4
12
 
5
13
  ## 分层与 Provider 适配
6
14
 
@@ -14,9 +22,9 @@ MCP连接器把“刷新连接器目录”和“升级插件代码”视为两
14
22
 
15
23
  每个 Provider 适配器只硬编码自己的 capabilities 入口,其余更新、任务、回滚和重启端点均从能力响应中读取。客户端只接受当前 DSH 页面的相对同源端点,拒绝跨域 URL、协议不匹配、缺少必要端点或未声明 `features.update` 的 Provider。
16
24
 
17
- DSH Market 适配器从 `GET /dsh-market/api/v1/capabilities` 开始,要求 `schema: dsh-market/update-api/v1` 与 `apiVersion: 1`。未安装任何可用 Provider、接口返回 404、协议不兼容或检查失败时,页面进入下述手动升级流程,不会尝试私有更新路由。已有 Provider 的失败流程仍可通过“查看更新方式”打开宿主插件市场或 npm 页面。
25
+ DSH Market 适配器从 `GET /dsh-market/api/v1/capabilities` 开始,要求 `schema: dsh-market/update-api/v1` 与 `apiVersion: 1`。在 Web 等使用此适配器的宿主上,接口不可用、协议不兼容或检查失败时,页面提供下述手动升级方式。已有 Provider 的失败流程仍可通过“查看更新方式”打开宿主插件市场或 npm 页面。
18
26
 
19
- ## 更新流程
27
+ ## 通过 Update Provider 更新
20
28
 
21
29
  1. 插件自己的服务端缓存检查 npm `latest` 与 GitHub Release,只在 npm 已有可安装新版本时提示升级。
22
30
  2. 选中的 Provider 再检查本 profile 中 `dsh-mcp-connector` 的实际安装版本和目标版本。
@@ -29,7 +37,11 @@ Provider 读取的是 profile 中已经落盘的插件版本,标题版本来
29
37
 
30
38
  失败结果使用稳定代码区分正在运行的 Agent、其他安装任务占用、发布安全等待、镜像同步、版本未变化、超时和权限拒绝,以及 `DOWNGRADE_DETECTED`、`RESOLVED_VERSION_MISMATCH`、`INVALID_UPDATE_RESULT` 三类完整性故障。`RELEASE_TOO_FRESH` 明确显示为约 24 小时的发布安全等待期,并提供“立即更新(跳过等待)”;真正的镜像同步故障保留独立提示,不再混用同一文案。
31
39
 
32
- 当 DSH Desktop 或其他宿主没有兼容 Update Provider 时,标题区展示绑定 npm 精确版本和当前 profile 的 CLI 命令,并提供复制按钮与 npm 页面入口。服务端每次请求只读取一次可选的 `profileContext.name`。`versionStatus.detail.profileName` 继续只返回可安全生成命令的名称或 `null`;新增的 `profileInfo` 只包含实际读取到的字符串 `detectedName`(或 `null`)和固定的 `status`,不包含本机目录、环境变量或异常原文。客户端不会根据窗口类型、网址或插件目录猜测 profile。
40
+ ## 手动升级
41
+
42
+ Windows 和 macOS 桌面版在无法直达详情页时可展开“查看手动升级命令”。Web 版打开面板就会自动检查。有可安装的版本时显示“更新到 v目标版本”,点击后由当前环境的更新服务执行。只有 npm 查到新版时显示“查看升级方式”,展开后可按当前安装环境查看和复制命令。已是最新版时只显示当前版本。首次检查失败时,点击“重新检查”即可再次查询。
43
+
44
+ 命令绑定 npm 精确版本和当前 profile,并提供复制按钮与 npm 页面入口。服务端每次请求只读取一次可选的 `profileContext.name`。`versionStatus.detail.profileName` 只返回可安全生成命令的名称或 `null`。`profileInfo` 只包含实际读取到的字符串 `detectedName`(或 `null`)和固定的 `status`。自定义 profile 仍使用宿主提供的名称。
33
45
 
34
46
  | `profileInfo.status` | 含义与界面行为 |
35
47
  | --- | --- |
@@ -50,9 +50,11 @@ Host 已观察到
50
50
 
51
51
  更底层的状态机、威胁模型和后续阶段见 [Issue #111 设计文档](https://github.com/duhu2000/dsh-mcp-connector/blob/main/docs/DESIGN-SESSION-DYNAMIC-TOOL-INJECTION.md)。
52
52
 
53
- ## 企查查企业数据智能按需模式(开发分支预览)
53
+ <a name="企查查企业数据智能按需模式开发分支预览"></a>
54
54
 
55
- 本节说明尚未发布的 QMCP-4963 生产接入。上文的手动按会话激活功能继续保留,两者不互相替代。
55
+ ## 企查查企业数据智能按需模式
56
+
57
+ 智能按需模式自插件 `0.2.111` 起随包交付,默认使用兼容模式。上文所述的手动按会话激活功能也可继续使用。
56
58
 
57
59
  正常启动仅在以下条件全部具备时显示“智能工具”:已验证的 Host `0.2.2-rc.1`、Native 执行器、浏览器 owner 身份、真实 profile/Workspace/Session 服务,以及当前配置账号的单个明确 grant 下六条官方企业连接:`qcc-company`、`qcc-risk`、`qcc-ipr`、`qcc-operation`、`qcc-history`、`qcc-executive`。不合并多个账号或 grant;不覆盖法律、法宝和其他连接。缺少依赖、未知版本或全局 `compactManagementTools=true` 时保留现有兼容行为。
58
60
 
@@ -64,9 +66,11 @@ Host 已观察到
64
66
 
65
67
  **回退:**“新会话使用兼容模式”只改变后续会话的默认值;“停用智能层”恢复当前进程的原有工具视图并释放加载状态,仍保留原有权限限制和模式记录。若需重启后也保持兼容,请先确认兼容默认,再停用智能层。运行中的会话或在途操作会阻止不安全的启停;写入默认模式失败时撤回本次新挂载。
66
68
 
67
- 本分支尚未批准真实来源关系或只读定义,也未完成真实模型 A/B。完成生产接入代码不代表现在可以启用生产智能模式。
69
+ 生产启用需要目标环境的授权和独立审核。真实模型请求的 Token 用量和任务效果仍待对照实测。
70
+
71
+ <a name="可信只读证据交付尚未发布"></a>
68
72
 
69
- ### 可信只读证据交付(尚未发布)
73
+ ### 可信只读证据交付
70
74
 
71
75
  管理员先完成独立业务核验,再向目标 profile 的 `smart-mode-evidence/` 目录交付两个本地文件。该目录属于插件交付约定,不新增或修改 DSH 配置项。没有文件、签名不可信或校验失败时保持未核验;不存在模型工具或网页 API 可安装信任公钥、上传包或签发证据。
72
76
 
@@ -88,9 +92,11 @@ Host 已观察到
88
92
 
89
93
  证据读取有大小/条数/文件类型上限,缺失、损坏、写盘失败均拒绝;接受没有内存专用回退。推理和派发边界同步复核,文件监控及 1 秒轮询同步收窄空闲 lookup 视图,拒绝派发时也刷新 schema/lookup;不承诺撤销已经入站的在途调用。存储要求与原 smart domain 相同:本地原子硬链接文件系统;Windows 不承诺整机断电耐久性。版本下限基于仍完整的本地接收记录,不能对整个 profile/信任根被人为回退或同进程恶意代码作隔离保证。
90
94
 
91
- ## Development preview (English)
95
+ <a name="development-preview-english"></a>
96
+
97
+ ## QCC enterprise smart loading
92
98
 
93
- The unreleased smart adapter supports the configured account's six QCC enterprise connections under one unambiguous grant on verified Native Host `0.2.2-rc.1`. It requires real profile, Workspace, Session and authenticated browser-owner services. Other accounts, legal/Fabao services, unknown Hosts and global compact management mode retain existing behavior.
99
+ Plugin version `0.2.111` introduced smart loading for the configured account's six QCC enterprise connections under one unambiguous grant on verified Native Host `0.2.2-rc.1`. It requires real profile, Workspace, Session and authenticated browser-owner services. Other accounts, legal/Fabao services, unknown Hosts and global compact management mode retain existing behavior.
94
100
 
95
101
  Compatibility is the default. Use Smart tools, preview the six-service scope and confirm once; normal DSH new-session and conversation entry points then work without six per-connection changes. The control page also delegates creation and recovery to Host services. Select a workspace only when its context cannot be inferred.
96
102
 
@@ -98,6 +104,6 @@ Existing and pre-enablement blank sessions retain their mode. Forks/subagents in
98
104
 
99
105
  For persistent rollback, first confirm Compatibility for new sessions, then disable the smart layer to restore current-process tool views. Disabling alone does not erase the saved smart default. Busy sessions block unsafe mount/unmount; a failed policy write rolls back a newly mounted layer. Real approvals and provider A/B acceptance remain pending.
100
106
 
101
- Trusted read-only delivery is now wired in this development branch. An administrator provisions scoped Ed25519 public keys in `<profile>/smart-mode-evidence/trust.json` and atomically delivers an independently signed full snapshot as `bundle.json`. The table above defines the strict v1 protocol; `readOnlyEvidenceSigningBytes(payload)` is the public canonical-byte helper for an external signer. No private key, signing endpoint, trust installation API, remote download or schema/sample storage is provided.
107
+ An administrator provisions scoped Ed25519 public keys in `<profile>/smart-mode-evidence/trust.json` and atomically delivers an independently signed full snapshot as `bundle.json`. The table above defines the strict v1 protocol; `readOnlyEvidenceSigningBytes(payload)` is the public canonical-byte helper for an external signer. No private key, signing endpoint, trust installation API, remote download or schema/sample storage is provided.
102
108
 
103
109
  Verified records automatically feed preparation; local manual withdrawals override them. Every inference/dispatch admission rechecks evidence, expiry and the durable revision floor. File watching and a one-second fallback narrow idle lookup views. Withdrawals cannot cancel already-admitted calls. Missing or invalid evidence and receipt-write failures deny preparation. Higher signed revisions replace the entire approval snapshot; older revisions or changed content at the same revision cannot regain authority after restart while the local receipts remain intact. Real review dossiers, production trust provisioning and actual read-only/source approvals remain pending.
@@ -68,7 +68,7 @@ dsh web
68
68
  - **已安装**:查看已经保存到本机的连接,页签徽标显示连接数。
69
69
  - **搜索**:按名称、服务商、简介和标签查找。
70
70
  - **添加连接**:导入 JSON、手动配置 HTTP/stdio,或从市场描述 URL 安装。
71
- - **版本与更新提示**:标题旁显示当前插件版本,版本检查不依赖安装所用的插件市场。检测到 npm 有新版本且当前宿主存在兼容 Update Provider 时,可在当前页面一键更新并查看进度、失败原因和可用回滚。DSH Market API v1 是当前首个 Provider;无可用 Provider 时显示“查看更新方式”,宿主没有插件市场分区时会打开 npm 安装说明。
71
+ - **更新插件**。标题旁显示当前运行的版本。Windows 和 macOS 桌面版在打开面板时自动检查,发现新版后点击“前往更新”,在宿主的插件详情页点击“更新到…”。如果未能跳转,从侧栏打开“插件” → “已安装” → `dsh-mcp-connector`。Web 版有兼容更新服务时,可在连接器面板内更新并查看进度。[插件更新说明](PLUGIN-UPDATE.md)
72
72
  - **刷新连接器目录**:重新拉取 Registry 卡片,并更新连接健康状态;该操作不会升级 MCP连接器插件本身。
73
73
 
74
74
  ## 3. 浏览市场与分类
Binary file
@@ -1,6 +1,6 @@
1
1
  # 产品截图与演示的来源及更新
2
2
 
3
- <!-- generated:media -->本组 8 张截图和 GIF 均从 v0.2.114 于 2026-11-19 重新采集,未修改截图中的版本文字。<!-- /generated:media -->
3
+ <!-- generated:media -->本组 8 张截图和 GIF 均从 v0.2.115 于 2026-11-19 重新采集,未修改截图中的版本文字。<!-- /generated:media -->
4
4
 
5
5
  前七张素材由真实产品 UI 的无凭据 Mock harness 渲染:1280×720 浏览器视口、800px 产品面板、桌面两列卡片。顶部保留“无凭据 Mock”标识;目录数、连接数与工具数是演示夹具,不代表生产统计或真实授权、业务验收。不会读取用户 profile、调用服务商或上传业务数据。
6
6
 
@@ -3,7 +3,7 @@
3
3
  "capture": {
4
4
  "locale": "zh-CN",
5
5
  "capturedOn": "2026-11-19",
6
- "sourceVersion": "0.2.114",
6
+ "sourceVersion": "0.2.115",
7
7
  "sourceFingerprint": "e59bccf7afa9c5fde7b87e2f68c8eda78e02037bda47c01758b70b43633ba3ba",
8
8
  "browserViewport": {
9
9
  "width": 1280,
@@ -17,63 +17,63 @@
17
17
  "screenshots": [
18
18
  {
19
19
  "path": "docs/screenshots/01-market-overview.jpg",
20
- "sha256": "fdfe6890d922e5c501c004af350487a19866f5808bbb16cf7741e049a96f1172",
20
+ "sha256": "fce8d326c49ee94fcbfbd6419ff9ee74311b818c8f3d62965a189aca3c1a66ea",
21
21
  "width": 1280,
22
22
  "height": 720,
23
23
  "capturedOn": "2026-11-19",
24
- "sourceVersion": "0.2.114"
24
+ "sourceVersion": "0.2.115"
25
25
  },
26
26
  {
27
27
  "path": "docs/screenshots/02-connector-detail.jpg",
28
- "sha256": "74147cb32ecdfaa2f000ab161762529e7cd484360a2a410ff385dbd1e39ae3a1",
28
+ "sha256": "e4916f156086c40e071251d9c90161f3c05bb21744ecec7416103154af70d9fa",
29
29
  "width": 1280,
30
30
  "height": 720,
31
31
  "capturedOn": "2026-11-19",
32
- "sourceVersion": "0.2.114"
32
+ "sourceVersion": "0.2.115"
33
33
  },
34
34
  {
35
35
  "path": "docs/screenshots/03-tool-discovery.jpg",
36
- "sha256": "96bfa256e9ad3f9f4967de20e84301eeb3bea3b86e36c27fb2ac06e9f065c2c6",
36
+ "sha256": "e9ff7f9f7fda1c52bf32551ea1cbe5106dd7e5bec73b36254cc42bac801b90ff",
37
37
  "width": 1280,
38
38
  "height": 720,
39
39
  "capturedOn": "2026-11-19",
40
- "sourceVersion": "0.2.114"
40
+ "sourceVersion": "0.2.115"
41
41
  },
42
42
  {
43
43
  "path": "docs/screenshots/04-json-import.jpg",
44
- "sha256": "a5a70daadea124eb5c42f91a86d36386245c0c45ad3b97226dc7932f7786388a",
44
+ "sha256": "b592671fd21ec7334c3658083b1e4ff5213bb02c67bd5fdc284a07bbbde24b74",
45
45
  "width": 1280,
46
46
  "height": 720,
47
47
  "capturedOn": "2026-11-19",
48
- "sourceVersion": "0.2.114"
48
+ "sourceVersion": "0.2.115"
49
49
  },
50
50
  {
51
51
  "path": "docs/screenshots/05-unified-tool-search.png",
52
- "sha256": "ee5ff5a19ea905a1fa6c78dc089e96d6d4f3a7474196066b9064f7b30a4011af",
52
+ "sha256": "f3a7d7e2ff00ab458c7def796d11ed04e9d0ca2c39d25cc171a008d46b4dc30e",
53
53
  "width": 1280,
54
54
  "height": 720,
55
55
  "capturedOn": "2026-11-19",
56
- "sourceVersion": "0.2.114"
56
+ "sourceVersion": "0.2.115"
57
57
  },
58
58
  {
59
59
  "path": "docs/screenshots/06-tool-parameters.png",
60
- "sha256": "65410d5da653a3c634973700f223b33b6d5faea6e8296bd8a4e14a2f465c090d",
60
+ "sha256": "6fd38c60b8e9ae3896f287f61c87eec4c688746c763a0d99f2fc30239f152d73",
61
61
  "width": 1280,
62
62
  "height": 720,
63
63
  "capturedOn": "2026-11-19",
64
- "sourceVersion": "0.2.114"
64
+ "sourceVersion": "0.2.115"
65
65
  },
66
66
  {
67
67
  "path": "docs/screenshots/07-connection-diagnostics.png",
68
- "sha256": "09d9a9ed669f5defa9ac35a11d043b0fdbc549b583b23f3a6425b4a0af60818a",
68
+ "sha256": "c1bc0d6eb50480f81191f8bad759fa46696345bdc5e406906047c14990c9f4a7",
69
69
  "width": 1280,
70
70
  "height": 720,
71
71
  "capturedOn": "2026-11-19",
72
- "sourceVersion": "0.2.114"
72
+ "sourceVersion": "0.2.115"
73
73
  },
74
74
  {
75
75
  "path": "docs/screenshots/08-ten-recommendations.jpg",
76
- "sha256": "4ccb125ca449bf2da9390ca268c7b3011769dce846016983a6e0a42828e92ee8",
76
+ "sha256": "79b66c49ee627966298d77e4fa9a548b66d8793505b00aab8eada81107ed9bbe",
77
77
  "width": 1280,
78
78
  "height": 1400,
79
79
  "browserViewport": {
@@ -82,16 +82,16 @@
82
82
  },
83
83
  "panelHeight": 1280,
84
84
  "capturedOn": "2026-11-19",
85
- "sourceVersion": "0.2.114"
85
+ "sourceVersion": "0.2.115"
86
86
  }
87
87
  ],
88
88
  "demo": {
89
89
  "path": "docs/demo.gif",
90
- "sha256": "396f9035e736829f601567ec0a8fdc0b1d73c0f635433226d3e4dfb18ee1dda0",
90
+ "sha256": "0c0cc3acc353d23da02ae09da5668fd29429111933b2e3ab1af853361e118428",
91
91
  "width": 960,
92
92
  "height": 540,
93
93
  "capturedOn": "2026-11-19",
94
- "sourceVersion": "0.2.114",
94
+ "sourceVersion": "0.2.115",
95
95
  "durationSeconds": 36
96
96
  }
97
97
  }
@@ -3,7 +3,7 @@
3
3
  "capture": {
4
4
  "locale": "en",
5
5
  "capturedOn": "2026-11-19",
6
- "sourceVersion": "0.2.114",
6
+ "sourceVersion": "0.2.115",
7
7
  "sourceFingerprint": "e59bccf7afa9c5fde7b87e2f68c8eda78e02037bda47c01758b70b43633ba3ba",
8
8
  "browserViewport": {
9
9
  "width": 1280,
@@ -17,63 +17,63 @@
17
17
  "screenshots": [
18
18
  {
19
19
  "path": "docs/screenshots/en/01-market-overview.jpg",
20
- "sha256": "c9af21df2d1d317661c7e114cc15f0d7facbc0878717345adf57d97d65dfa63f",
20
+ "sha256": "bd49377f91e3ec28d30c21ff0037a7ac44ab39ef26ce673cf762294302fc4298",
21
21
  "width": 1280,
22
22
  "height": 720,
23
23
  "capturedOn": "2026-11-19",
24
- "sourceVersion": "0.2.114"
24
+ "sourceVersion": "0.2.115"
25
25
  },
26
26
  {
27
27
  "path": "docs/screenshots/en/02-connector-detail.jpg",
28
- "sha256": "d06e85e7e054cafd9288ad7a71f021c3fc85d9c1a5e04f6f5d4e6e43777a9fed",
28
+ "sha256": "7bee0ed0a01c59b6bec9733349b0a01a329db5610c8433931a5121d41b59403a",
29
29
  "width": 1280,
30
30
  "height": 720,
31
31
  "capturedOn": "2026-11-19",
32
- "sourceVersion": "0.2.114"
32
+ "sourceVersion": "0.2.115"
33
33
  },
34
34
  {
35
35
  "path": "docs/screenshots/en/03-tool-discovery.jpg",
36
- "sha256": "69cf73157b6c60e44aa261e368831c2cade3e53a9d447712a28bb8497ea245d1",
36
+ "sha256": "1ab517e2fae693a448b841f8534d59e44db3d1c68c6642e8fb5d02c84a7848a0",
37
37
  "width": 1280,
38
38
  "height": 720,
39
39
  "capturedOn": "2026-11-19",
40
- "sourceVersion": "0.2.114"
40
+ "sourceVersion": "0.2.115"
41
41
  },
42
42
  {
43
43
  "path": "docs/screenshots/en/04-json-import.jpg",
44
- "sha256": "121a0104c9c615d2885250c24a037b7425669a86a62409cde3ee5a8fe95c1996",
44
+ "sha256": "ed78625cac603bc5bbb6b7f23f1ac5526a7639faeb540bb0b696f8d0c5cf684c",
45
45
  "width": 1280,
46
46
  "height": 720,
47
47
  "capturedOn": "2026-11-19",
48
- "sourceVersion": "0.2.114"
48
+ "sourceVersion": "0.2.115"
49
49
  },
50
50
  {
51
51
  "path": "docs/screenshots/en/05-unified-tool-search.png",
52
- "sha256": "b858f7a08031a436b5d196a967201c6923085066572cfce3f91f592f30f9df7b",
52
+ "sha256": "fbec6ec1daef84f4074823186d0c8f02f5beff567349e4f237c379ad7f9112dc",
53
53
  "width": 1280,
54
54
  "height": 720,
55
55
  "capturedOn": "2026-11-19",
56
- "sourceVersion": "0.2.114"
56
+ "sourceVersion": "0.2.115"
57
57
  },
58
58
  {
59
59
  "path": "docs/screenshots/en/06-tool-parameters.png",
60
- "sha256": "8b666208531153ffd788557c238c6ca57ae032f73888e3a63243ff49d845f4d1",
60
+ "sha256": "cebd97cd53ee1b67b79e19eeae8111dacdc90a27fef0400770f8e7084e4fd23d",
61
61
  "width": 1280,
62
62
  "height": 720,
63
63
  "capturedOn": "2026-11-19",
64
- "sourceVersion": "0.2.114"
64
+ "sourceVersion": "0.2.115"
65
65
  },
66
66
  {
67
67
  "path": "docs/screenshots/en/07-connection-diagnostics.png",
68
- "sha256": "4423217971f7e98ca56e98fd7cf68acaaa3be36c04e29d4c99acddb0806db87f",
68
+ "sha256": "9acda276dfb24fa337db482dcb21b84ca49370530b6d8c6d06a657373dc5eec7",
69
69
  "width": 1280,
70
70
  "height": 720,
71
71
  "capturedOn": "2026-11-19",
72
- "sourceVersion": "0.2.114"
72
+ "sourceVersion": "0.2.115"
73
73
  },
74
74
  {
75
75
  "path": "docs/screenshots/en/08-ten-recommendations.jpg",
76
- "sha256": "ee788e2b40e02df0a52f2c72e15bb79f99a73b41856950ba89f0dc8060c58625",
76
+ "sha256": "18eb233bab59bf6f2dad9546855e1fb698f1c6b392a17f7ee6c73de14733c38d",
77
77
  "width": 1280,
78
78
  "height": 1400,
79
79
  "browserViewport": {
@@ -82,16 +82,16 @@
82
82
  },
83
83
  "panelHeight": 1280,
84
84
  "capturedOn": "2026-11-19",
85
- "sourceVersion": "0.2.114"
85
+ "sourceVersion": "0.2.115"
86
86
  }
87
87
  ],
88
88
  "demo": {
89
89
  "path": "docs/screenshots/en/demo.gif",
90
- "sha256": "4e4b44a5a02067d8174be24eb391b044a6857954bdfb3517c52efec959e7e884",
90
+ "sha256": "10bf5b87214c2686f8a6b21687fd9534c7b9abba260de5d1db358a7ebda2c7e1",
91
91
  "width": 960,
92
92
  "height": 540,
93
93
  "capturedOn": "2026-11-19",
94
- "sourceVersion": "0.2.114",
94
+ "sourceVersion": "0.2.115",
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.114`<!-- /generated:version -->;当前 Workspace;企查查 OAuth 可用;测试账号具有目标企业数据权限 |
11
+ | 前提 | <!-- generated:version -->正式 `dsh-mcp-connector@0.2.115`<!-- /generated:version -->;当前 Workspace;企查查 OAuth 可用;测试账号具有目标企业数据权限 |
12
12
  | 权限/管理员 | 账号权限、组织授权和可见字段由服务商控制;企业组织可能需要管理员开通,当前文档不能替代审批 |
13
13
  | 费用 | 可能受套餐、次数或字段权限影响;MCP连接器无法确认本次费用,调用前在服务商侧核对 |
14
14
  | 运行/数据去向 | 远程 MCP Server;企业名称、查询参数和调用结果经 DSH Host 发送到/返回自 `agent.qcc.com` |
package/lib/client.js CHANGED
@@ -91,6 +91,18 @@ window.__ModuleLoader__.load({
91
91
  "重试更新": "Retry update",
92
92
  "检测到异常版本,正在自动回滚…": "An unexpected version was detected. Rolling back automatically…",
93
93
  "查看更新方式": "See update options",
94
+ "当前版本 v{current},发现新版本 v{target}": "Current version v{current}, new version v{target}",
95
+ "暂时无法确认 MCP 连接器是否有新版本。": "Could not check whether a new MCP Connector version is available.",
96
+ "重新检查失败,显示上次发现的版本。": "The check failed. Showing the previously found version.",
97
+ "重新检查": "Check again",
98
+ "查看手动升级命令": "View manual upgrade command",
99
+ "前往更新": "Go to update",
100
+
101
+ "npm 尚未确认此版本,暂时无法提供升级命令。": "An upgrade command will be available once npm confirms this version.",
102
+ "从插件页更新": "Update from the plugin page",
103
+ "请打开侧栏“插件” → “已安装” → dsh-mcp-connector,查看当前可用的更新。": "Open Plugins in the sidebar, select Installed, and choose dsh-mcp-connector to see available updates.",
104
+ "未能打开插件详情页。": "Could not open the plugin details page. ",
105
+ "请打开侧栏“插件” → “已安装” → dsh-mcp-connector,然后点击“更新到 v{version}”。": "Open Plugins in the sidebar, select Installed, choose dsh-mcp-connector, then click Update to v{version}.",
94
106
  "已回滚": "Rolled back",
95
107
  "已阻止异常版本并回滚": "Blocked the unexpected version and rolled back",
96
108
  "已安装 v{version}": "Installed v{version}",
@@ -109,6 +121,10 @@ window.__ModuleLoader__.load({
109
121
  "正在准备更新…": "Preparing the update…",
110
122
  "由 {provider} 安全更新到 v{version}": "Update safely to v{version} via {provider}",
111
123
  "更新服务": "the update service",
124
+ "更新到 v{version}": "Update to v{version}",
125
+ "使用 Web 启动时的终端": "Use the terminal where you started the Web app",
126
+ "查看升级方式": "View upgrade methods",
127
+ "收起升级方式": "Hide upgrade methods",
112
128
  "一键更新到 v{version}": "Update to v{version}",
113
129
  "v{version} 已安装,重启后生效": "v{version} is installed and takes effect after a restart",
114
130
  "已复制": "Copied",
@@ -437,6 +453,30 @@ window.__ModuleLoader__.load({
437
453
  min-width: 0;
438
454
  flex: 1 1 360px;
439
455
  }
456
+ .mcpConnectorUpdateGroup, .mcpConnectorUpdateFallback {
457
+ display: inline-flex;
458
+ align-items: center;
459
+ gap: 8px;
460
+ max-width: 100%;
461
+ min-width: 0;
462
+ }
463
+ .mcpConnectorUpdateGroup .mcpConnectorVersion { overflow-wrap: anywhere; min-width: 0; }
464
+ .mcpConnectorUpdateGroup > button { flex-shrink: 0; }
465
+ .mcpConnectorUpdateFallback {
466
+ align-items: flex-start;
467
+ flex-direction: column;
468
+ align-self: stretch;
469
+ max-height: 35%;
470
+ overflow: auto;
471
+ margin: 8px 16px;
472
+ padding: 8px 12px;
473
+ border-inline-start: 3px solid #a5a8e8;
474
+ background: rgba(120, 120, 155, 0.08);
475
+ font-size: 13px;
476
+ }
477
+ .mcpConnectorUpdateFallback .mcpConnectorManualUpdate { flex: initial; }
478
+ .mcpConnectorUpdateButton.mcpConnectorUpdatePrimary { color: white; background: #5143ce; border-color: #5143ce; }
479
+ .mcpConnectorUpdateLink { font: inherit; color: inherit; background: none; border: 0; text-decoration: underline; cursor: pointer; }
440
480
  .mcpConnectorUpdateHint {
441
481
  flex-basis: 100%;
442
482
  font-size: 12px;
@@ -1662,6 +1702,8 @@ window.__ModuleLoader__.load({
1662
1702
  actions,
1663
1703
  presentation = "modal",
1664
1704
  closePanel = null,
1705
+ getUpdateNavigation,
1706
+ sidebarUpdateMemory,
1665
1707
  startPromptSession: launchPromptSession,
1666
1708
  workspaceContext = () => null,
1667
1709
  workspaceOptions = () => [],
@@ -1677,7 +1719,7 @@ window.__ModuleLoader__.load({
1677
1719
  const [versionStatus, setVersionStatus] = (0, react.useState)(null);
1678
1720
  const [updateProviderState, setUpdateProviderState] = (0, react.useState)("checking");
1679
1721
  const [updateProviderSelection, setUpdateProviderSelection] = (0, react.useState)(null);
1680
- const [providerUpdateCheck, setProviderUpdateCheck] = (0, react.useState)(null);
1722
+ const [providerUpdateCheck, setProviderUpdateCheck] = (0, react.useState)(sidebarUpdateMemory?.offer ?? null);
1681
1723
  const [expectedUpdateVersion, setExpectedUpdateVersion] = (0, react.useState)(null);
1682
1724
  const [updateOperation, setUpdateOperation] = (0, react.useState)(null);
1683
1725
  const [updateError, setUpdateError] = (0, react.useState)(null);
@@ -1690,20 +1732,35 @@ window.__ModuleLoader__.load({
1690
1732
  const [versionCheckBusy, setVersionCheckBusy] = (0, react.useState)(false);
1691
1733
  const [versionCheckFailed, setVersionCheckFailed] = (0, react.useState)(false);
1692
1734
  const [manualProfileChoice, setManualProfileChoice] = (0, react.useState)(null);
1735
+ const [otherMethodsOpen, setOtherMethodsOpen] = (0, react.useState)(false);
1736
+ const [showNavigationHint, setShowNavigationHint] = (0, react.useState)(false);
1693
1737
  const frameRef = (0, react.useRef)(null);
1694
1738
  const closeRef = (0, react.useRef)(null);
1695
1739
  const profileInfo = clientProfileInfo(versionStatus);
1696
- const manualProfileContext = JSON.stringify([open, versionStatus?.latestVersion, profileInfo]);
1740
+ const desktopUpdate = window.dshDesktop?.protocolVersion === 1
1741
+ && ["win32", "darwin"].includes(document.documentElement?.dataset?.platform);
1742
+ const webUpdate = !window.dshDesktop;
1743
+ const compactHeader = desktopUpdate || webUpdate;
1744
+ const npmTarget = versionStatus?.latestVersion;
1745
+ const providerTarget = desktopUpdate && providerUpdateCheck?.updateAvailable
1746
+ ? parseClientVersion(providerUpdateCheck.latestVersion)?.normalized : null;
1747
+ const providerAhead = providerTarget && (!versionStatus?.updateAvailable || compareClientVersions(providerTarget, npmTarget) > 0);
1748
+ const targetVersion = webUpdate && providerUpdateCheck?.updateAvailable
1749
+ ? providerUpdateCheck.latestVersion
1750
+ : providerAhead ? providerTarget : npmTarget;
1751
+ // The native page rechecks its own offer. Only copy a CLI target confirmed by npm.
1752
+ const manualTarget = desktopUpdate && (providerAhead || versionCheckFailed || !versionStatus?.updateAvailable) ? null : npmTarget;
1753
+ const manualProfileContext = JSON.stringify([open, targetVersion, profileInfo]);
1697
1754
  const needsManualProfileChoice = ["unavailable", "read-error", "invalid-value"].includes(profileInfo.status);
1698
1755
  const selectedProfile = manualProfileChoice?.context === manualProfileContext ? manualProfileChoice.name : null;
1699
1756
  const commandProfile = profileInfo.status === "ready" ? profileInfo.detectedName
1700
1757
  : needsManualProfileChoice ? selectedProfile : null;
1701
- const manualCommandKey = JSON.stringify([manualProfileContext, selectedProfile]);
1758
+ const manualCommandKey = JSON.stringify([manualProfileContext, selectedProfile, manualTarget]);
1702
1759
  const manualCommandRef = (0, react.useRef)(null);
1703
1760
  if (manualCommandRef.current?.key !== manualCommandKey) {
1704
1761
  manualCommandRef.current = {
1705
1762
  key: manualCommandKey,
1706
- command: open ? manualUpgradeCommand(versionStatus?.latestVersion, commandProfile) : null
1763
+ command: open ? manualUpgradeCommand(manualTarget, commandProfile) : null
1707
1764
  };
1708
1765
  }
1709
1766
  const manualCommandState = manualCommandRef.current;
@@ -1766,7 +1823,12 @@ window.__ModuleLoader__.load({
1766
1823
  setVersionCheckBusy(true);
1767
1824
  fetchVersionStatus(force).then((status) => {
1768
1825
  if (disposed) return;
1769
- setVersionStatus(status);
1826
+ setVersionStatus(previous => {
1827
+ if (status.sources?.npm?.ok || status.lastConfirmedUpdateVersion
1828
+ || previous?.installedVersion !== status.installedVersion) return status;
1829
+ const lastTarget = previous?.updateAvailable ? previous.latestVersion : previous?.lastConfirmedUpdateVersion;
1830
+ return lastTarget ? { ...status, lastConfirmedUpdateVersion: lastTarget } : status;
1831
+ });
1770
1832
  setVersionCheckBusy(status.checking === true);
1771
1833
  setVersionCheckFailed(!status.checking && status.sources?.npm?.ok !== true ? "npm" : false);
1772
1834
  if (status.checking) {
@@ -1797,7 +1859,12 @@ window.__ModuleLoader__.load({
1797
1859
  }, [open, versionCheckRequest]);
1798
1860
  (0, react.useEffect)(() => {
1799
1861
  setManualProfileChoice(null);
1862
+ setOtherMethodsOpen(false);
1800
1863
  }, [manualProfileContext]);
1864
+ (0, react.useEffect)(() => {
1865
+ // All versions use the same bundle details page. Retry navigation on the next visit.
1866
+ setShowNavigationHint(false);
1867
+ }, [open]);
1801
1868
  (0, react.useEffect)(() => {
1802
1869
  setManualCommandCopied(false);
1803
1870
  setManualCommandVisible(false);
@@ -1826,6 +1893,16 @@ window.__ModuleLoader__.load({
1826
1893
  });
1827
1894
  return () => { disposed = true; };
1828
1895
  }, [open, versionCheckRequest]);
1896
+ (0, react.useEffect)(() => {
1897
+ if (!sidebarUpdateMemory || updateProviderState === "checking") return;
1898
+ sidebarUpdateMemory.offer = updateProviderState === "ready" && providerUpdateCheck?.updateAvailable && !updateStarting && !updateOperation
1899
+ ? {
1900
+ updateAvailable: true,
1901
+ installedVersion: versionStatus?.installedVersion ?? providerUpdateCheck.installedVersion,
1902
+ latestVersion: providerUpdateCheck.latestVersion
1903
+ }
1904
+ : null;
1905
+ }, [sidebarUpdateMemory, updateProviderState, providerUpdateCheck, versionStatus?.installedVersion, updateStarting, updateOperation]);
1829
1906
  (0, react.useEffect)(() => {
1830
1907
  const operationId = updateOperation?.operationId;
1831
1908
  const provider = updateProviderSelection?.provider;
@@ -1965,16 +2042,28 @@ window.__ModuleLoader__.load({
1965
2042
  setUpdateError(error instanceof Error ? error.message : String(error));
1966
2043
  });
1967
2044
  };
2045
+ const activationPendingVersion = pendingActivationVersion(versionStatus, providerUpdateCheck);
2046
+ const hasOffer = versionStatus?.updateAvailable || providerUpdateCheck?.updateAvailable;
2047
+ // Keep a previously offered Web action in place while the provider revalidates it.
2048
+ const refreshingWebOffer = webUpdate && updateProviderState === "checking" && providerUpdateCheck?.updateAvailable === true;
2049
+ const previousTarget = versionStatus?.lastConfirmedUpdateVersion;
2050
+ const badgeTarget = compactHeader && !activationPendingVersion && !updateOperation
2051
+ ? parseClientVersion(hasOffer ? targetVersion : previousTarget)?.normalized : null;
2052
+ const checking = versionCheckBusy || (!versionStatus && !versionCheckFailed)
2053
+ || (webUpdate && updateProviderState === "checking");
2054
+ const invalidOffer = hasOffer && !parseClientVersion(targetVersion);
2055
+ const showCheckError = (versionCheckFailed || invalidOffer) && !checking && !activationPendingVersion
2056
+ && !providerUpdateCheck?.updateAvailable && !updateOperation;
2057
+ const drawerId = "mcp-connector-upgrade-details-" + presentation;
1968
2058
  const renderUpdateControls = () => {
1969
- const activationPendingVersion = updateProviderState === "ready"
1970
- ? pendingActivationVersion(versionStatus, providerUpdateCheck)
1971
- : null;
1972
2059
  if (!versionStatus?.updateAvailable
2060
+ && !(desktopUpdate && badgeTarget)
2061
+ && !refreshingWebOffer
1973
2062
  && !(updateProviderState === "ready" && providerUpdateCheck?.updateAvailable === true)
1974
2063
  && activationPendingVersion === null
1975
- && updateOperation === null && updateError === null) return null;
2064
+ && updateOperation === null && updateError === null) return {};
1976
2065
  if (updateRunning) {
1977
- return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
2066
+ return { action: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
1978
2067
  className: "mcpConnectorUpdateControls",
1979
2068
  children: [
1980
2069
  /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
@@ -1990,11 +2079,11 @@ window.__ModuleLoader__.load({
1990
2079
  children: t("暂时无法读取进度,正在重试")
1991
2080
  })
1992
2081
  ]
1993
- });
2082
+ }) };
1994
2083
  }
1995
2084
  if (updateOperation?.state === "failed") {
1996
2085
  const force = ["RELEASE_TOO_FRESH", "VERSION_UNCHANGED"].includes(updateOperation.failure?.code);
1997
- return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
2086
+ return { action: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
1998
2087
  className: "mcpConnectorUpdateControls",
1999
2088
  children: [
2000
2089
  /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
@@ -2022,14 +2111,14 @@ window.__ModuleLoader__.load({
2022
2111
  children: t("查看更新方式")
2023
2112
  })
2024
2113
  ]
2025
- });
2114
+ }) };
2026
2115
  }
2027
2116
  if (["succeeded", "rolled-back"].includes(updateOperation?.state)) {
2028
2117
  const rolledBack = updateOperation.state === "rolled-back";
2029
2118
  const restartRequired = updateOperation.outcome?.restartRequired === true;
2030
2119
  const refreshRequired = updateOperation.outcome?.refreshRequired === true;
2031
2120
  const rollbackFailed = updateOperation.outcome?.rollback?.state === "failed";
2032
- return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
2121
+ return { action: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
2033
2122
  className: "mcpConnectorUpdateControls",
2034
2123
  children: [
2035
2124
  /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
@@ -2046,7 +2135,7 @@ window.__ModuleLoader__.load({
2046
2135
  }),
2047
2136
  restartRequired && updateProviderSelection?.capabilities?.restart?.supported === true && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
2048
2137
  type: "button",
2049
- className: "mcpConnectorUpdateButton",
2138
+ className: compactHeader ? "mcpConnectorUpdateButton mcpConnectorUpdatePrimary" : "mcpConnectorUpdateButton",
2050
2139
  disabled: restarting,
2051
2140
  onClick: restartHost,
2052
2141
  children: restarting ? t("正在重启…") : t("立即重启")
@@ -2070,10 +2159,10 @@ window.__ModuleLoader__.load({
2070
2159
  children: rollbackRunning ? t("正在回滚…") : rollbackFailed ? t("重试回滚") : t("回滚")
2071
2160
  })
2072
2161
  ]
2073
- });
2162
+ }) };
2074
2163
  }
2075
2164
  if (updateError !== null) {
2076
- return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
2165
+ return { action: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
2077
2166
  className: "mcpConnectorUpdateControls",
2078
2167
  children: [
2079
2168
  /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
@@ -2089,31 +2178,34 @@ window.__ModuleLoader__.load({
2089
2178
  children: t("查看更新方式")
2090
2179
  })
2091
2180
  ]
2092
- });
2181
+ }) };
2093
2182
  }
2094
- if (updateProviderState === "checking") {
2095
- return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
2183
+ if (!desktopUpdate && updateProviderState === "checking" && !refreshingWebOffer && !activationPendingVersion) {
2184
+ if (webUpdate) return {};
2185
+ return { action: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
2096
2186
  type: "button",
2097
2187
  className: "mcpConnectorUpdateButton",
2098
2188
  disabled: true,
2099
2189
  children: t("正在准备更新…")
2100
- });
2190
+ }) };
2101
2191
  }
2102
- if (updateProviderState === "ready" && providerUpdateCheck?.updateAvailable === true) {
2103
- return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
2192
+ if (refreshingWebOffer || (!desktopUpdate && updateProviderState === "ready" && providerUpdateCheck?.updateAvailable === true)) {
2193
+ return { action: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
2104
2194
  type: "button",
2105
- className: "mcpConnectorUpdateButton",
2195
+ className: webUpdate ? "mcpConnectorUpdateButton mcpConnectorUpdatePrimary" : "mcpConnectorUpdateButton",
2196
+ disabled: refreshingWebOffer,
2106
2197
  title: t("由 {provider} 安全更新到 v{version}", {
2107
2198
  provider: updateProviderSelection?.provider?.label ?? t("更新服务"),
2108
2199
  version: providerUpdateCheck.latestVersion
2109
2200
  }),
2110
2201
  onClick: () => startUpdate(false),
2111
- children: t("一键更新到 v{version}", { version: providerUpdateCheck.latestVersion })
2112
- });
2202
+ children: webUpdate ? t("更新到 v{version}", { version: providerUpdateCheck.latestVersion })
2203
+ : t("一键更新到 v{version}", { version: providerUpdateCheck.latestVersion })
2204
+ }) };
2113
2205
  }
2114
2206
  if (activationPendingVersion !== null) {
2115
2207
  const canRestart = updateProviderSelection?.capabilities?.restart?.supported === true;
2116
- return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
2208
+ return { action: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
2117
2209
  className: "mcpConnectorUpdateControls",
2118
2210
  children: [
2119
2211
  /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
@@ -2126,7 +2218,7 @@ window.__ModuleLoader__.load({
2126
2218
  canRestart
2127
2219
  ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
2128
2220
  type: "button",
2129
- className: "mcpConnectorUpdateButton",
2221
+ className: compactHeader ? "mcpConnectorUpdateButton mcpConnectorUpdatePrimary" : "mcpConnectorUpdateButton",
2130
2222
  disabled: restarting,
2131
2223
  onClick: restartHost,
2132
2224
  children: restarting ? t("正在重启…") : t("立即重启")
@@ -2139,12 +2231,13 @@ window.__ModuleLoader__.load({
2139
2231
  : t("请重启 DSH")
2140
2232
  })
2141
2233
  ]
2142
- });
2234
+ }) };
2143
2235
  }
2144
2236
  const command = manualCommandState.command;
2145
- const validTarget = parseClientVersion(versionStatus?.latestVersion) !== null;
2237
+ const parsedTarget = parseClientVersion(desktopUpdate ? badgeTarget : targetVersion);
2238
+ const validTarget = parseClientVersion(manualTarget) !== null;
2146
2239
  const showDiagnosis = !validTarget || profileInfo.status !== "ready";
2147
- return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
2240
+ const manualControls = (0, react_jsx_runtime.jsxs)("div", {
2148
2241
  className: "mcpConnectorManualUpdate",
2149
2242
  children: [
2150
2243
  validTarget && profileInfo.status !== "ready" && profileInfo.detectedName !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
@@ -2153,7 +2246,9 @@ window.__ModuleLoader__.load({
2153
2246
  }),
2154
2247
  showDiagnosis && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
2155
2248
  className: "mcpConnectorUpdateHint",
2156
- children: validTarget ? profileFailureLabel(profileInfo) : t("未取得有效的目标版本,请点击“检查更新”后重试")
2249
+ children: validTarget ? profileFailureLabel(profileInfo) : desktopUpdate
2250
+ ? t("npm 尚未确认此版本,暂时无法提供升级命令。")
2251
+ : t("未取得有效的目标版本,请点击“检查更新”后重试")
2157
2252
  }),
2158
2253
  validTarget && needsManualProfileChoice && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
2159
2254
  className: "mcpConnectorProfileChoice",
@@ -2216,7 +2311,83 @@ window.__ModuleLoader__.load({
2216
2311
  })
2217
2312
  ]
2218
2313
  });
2314
+ if (compactHeader && parsedTarget === null) return {};
2315
+ if (!compactHeader) return { action: manualControls };
2316
+ if (webUpdate) {
2317
+ return {
2318
+ action: (0, react_jsx_runtime.jsx)("button", {
2319
+ type: "button", className: "mcpConnectorUpdateLink",
2320
+ "aria-expanded": otherMethodsOpen, "aria-controls": drawerId,
2321
+ onClick: () => setOtherMethodsOpen(value => !value),
2322
+ children: otherMethodsOpen ? t("收起升级方式") : t("查看升级方式")
2323
+ }),
2324
+ drawer: otherMethodsOpen && (0, react_jsx_runtime.jsxs)("section", {
2325
+ id: drawerId, className: "mcpConnectorUpdateFallback", "aria-label": t("查看升级方式"),
2326
+ children: [(0, react_jsx_runtime.jsx)("span", { children: t("使用 Web 启动时的终端") }), manualControls]
2327
+ })
2328
+ };
2329
+ }
2330
+ const navigation = getUpdateNavigation?.();
2331
+ if (navigation && !showNavigationHint) {
2332
+ return { action: (0, react_jsx_runtime.jsx)("button", {
2333
+ type: "button",
2334
+ className: "mcpConnectorUpdateButton mcpConnectorUpdatePrimary",
2335
+ onClick: async () => {
2336
+ try {
2337
+ await getUpdateNavigation().openBundle(PLUGIN_PACKAGE_NAME);
2338
+ } catch {
2339
+ setShowNavigationHint(true);
2340
+ return;
2341
+ }
2342
+ if (presentation !== "panel") actions.close();
2343
+ },
2344
+ children: t("前往更新")
2345
+ }) };
2346
+ }
2347
+ return { drawer: (0, react_jsx_runtime.jsxs)("section", {
2348
+ className: "mcpConnectorUpdateFallback", "aria-label": t("从插件页更新"),
2349
+ children: [
2350
+ (0, react_jsx_runtime.jsx)("span", {
2351
+ role: "status",
2352
+ children: (showNavigationHint ? t("未能打开插件详情页。") : "") + (versionCheckFailed && !providerTarget
2353
+ ? t("请打开侧栏“插件” → “已安装” → dsh-mcp-connector,查看当前可用的更新。")
2354
+ : t("请打开侧栏“插件” → “已安装” → dsh-mcp-connector,然后点击“更新到 v{version}”。", { version: parsedTarget.normalized }))
2355
+ }),
2356
+ (0, react_jsx_runtime.jsx)("button", {
2357
+ type: "button", className: "mcpConnectorUpdateLink",
2358
+ "aria-expanded": otherMethodsOpen, "aria-controls": drawerId,
2359
+ onClick: () => setOtherMethodsOpen(value => !value),
2360
+ children: t("查看手动升级命令")
2361
+ }),
2362
+ otherMethodsOpen && (0, react_jsx_runtime.jsx)("div", { id: drawerId, children: manualControls })
2363
+ ]
2364
+ }) };
2219
2365
  };
2366
+ const { action: updateAction, drawer: updateDrawer } = renderUpdateControls();
2367
+ const runningVersion = versionStatus?.installedVersion ?? providerUpdateCheck?.installedVersion;
2368
+ const versionLabel = badgeTarget && runningVersion
2369
+ ? t("当前版本 v{current},发现新版本 v{target}", { current: runningVersion, target: badgeTarget })
2370
+ : runningVersion ? t("当前版本 v{version}", { version: runningVersion }) : t("正在检查插件版本");
2371
+ const versionBadge = (0, react_jsx_runtime.jsx)("span", {
2372
+ className: "mcpConnectorVersion", title: versionLabel, "aria-label": versionLabel,
2373
+ children: badgeTarget && runningVersion ? `v${runningVersion} → v${badgeTarget}`
2374
+ : runningVersion ? `v${runningVersion}` : "v…"
2375
+ });
2376
+ const checkFeedback = checking && !activationPendingVersion && !updateOperation
2377
+ ? (0, react_jsx_runtime.jsx)("span", { role: "status", children: t("正在检查更新…") })
2378
+ : showCheckError && (0, react_jsx_runtime.jsxs)("div", {
2379
+ className: "mcpConnectorUpdateControls",
2380
+ children: [
2381
+ (0, react_jsx_runtime.jsx)("span", {
2382
+ role: "status", title: typeof versionCheckFailed === "string" && versionCheckFailed !== "npm" ? versionCheckFailed : undefined,
2383
+ children: badgeTarget ? t("重新检查失败,显示上次发现的版本。") : t("暂时无法确认 MCP 连接器是否有新版本。")
2384
+ }),
2385
+ (0, react_jsx_runtime.jsx)("button", {
2386
+ type: "button", className: "mcpConnectorUpdateLink",
2387
+ onClick: () => setVersionCheckRequest(value => value + 1), children: t("重新检查")
2388
+ })
2389
+ ]
2390
+ });
2220
2391
  // `iframeLocale` 可以是取值函数:语言服务晚于 apply() 就绪时,
2221
2392
  // 这里每次渲染都能读到最新语言,而不是注册时的快照。
2222
2393
  const src = marketIframeSrc(typeof iframeLocale === "function" ? iframeLocale() : iframeLocale);
@@ -2271,15 +2442,12 @@ window.__ModuleLoader__.load({
2271
2442
  })
2272
2443
  }),
2273
2444
  /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { id: titleId, className: "mcpConnectorMarketTitle", style: { fontSize: 18, fontWeight: 600 }, children: t("MCP连接器") }),
2274
- /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
2275
- className: "mcpConnectorVersion",
2276
- title: versionStatus === null
2277
- ? t("正在检查插件版本")
2278
- : t("当前版本 v{version}", { version: versionStatus.installedVersion }),
2279
- children: versionStatus === null ? "v…" : `v${versionStatus.installedVersion}`
2280
- }),
2281
- renderUpdateControls(),
2282
- /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
2445
+ compactHeader ? (0, react_jsx_runtime.jsxs)("div", {
2446
+ className: "mcpConnectorUpdateGroup",
2447
+ children: [versionBadge, updateAction]
2448
+ }) : versionBadge,
2449
+ !compactHeader && updateAction,
2450
+ compactHeader ? checkFeedback : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
2283
2451
  type: "button",
2284
2452
  className: "mcpConnectorUpdateButton",
2285
2453
  disabled: versionCheckBusy || updateRunning,
@@ -2289,12 +2457,12 @@ window.__ModuleLoader__.load({
2289
2457
  onClick: () => setVersionCheckRequest((value) => value + 1),
2290
2458
  children: versionCheckBusy ? t("正在检查更新…") : t("检查更新")
2291
2459
  }),
2292
- versionCheckFailed && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
2460
+ !compactHeader && versionCheckFailed && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
2293
2461
  className: "mcpConnectorUpdateStatus",
2294
2462
  "data-tone": "error",
2295
2463
  children: typeof versionCheckFailed === "string" && versionCheckFailed !== "npm" ? versionCheckFailed : t("暂时无法确认 npm 最新版本,请重试")
2296
2464
  }),
2297
- versionStatus?.releasePending && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
2465
+ versionStatus?.releasePending && (!compactHeader || (!badgeTarget && !activationPendingVersion && !updateOperation)) && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
2298
2466
  className: "mcpConnectorVersion",
2299
2467
  title: t("GitHub Release 已发布,等待 npm 同步后即可更新"),
2300
2468
  children: t("v{version} 正在同步", { version: versionStatus.release.version })
@@ -2320,6 +2488,7 @@ window.__ModuleLoader__.load({
2320
2488
  })
2321
2489
  ]
2322
2490
  }),
2491
+ updateDrawer,
2323
2492
  /* @__PURE__ */ (0, react_jsx_runtime.jsx)("iframe", {
2324
2493
  ref: frameRef,
2325
2494
  src,
@@ -2460,6 +2629,14 @@ window.__ModuleLoader__.load({
2460
2629
  */
2461
2630
  function marketRuntimeProps(ctx) {
2462
2631
  return {
2632
+ getUpdateNavigation: () => {
2633
+ try {
2634
+ const navigation = ctx.get?.("pluginNavigation");
2635
+ return typeof navigation?.openBundle === "function" ? navigation : null;
2636
+ } catch {
2637
+ return null;
2638
+ }
2639
+ },
2463
2640
  startPromptSession: (promptText) => startPromptSession(ctx, promptText),
2464
2641
  workspaceContext: () => currentWorkspaceContext(ctx),
2465
2642
  workspaceOptions: () => availableWorkspaceContexts(ctx),
@@ -2472,6 +2649,9 @@ window.__ModuleLoader__.load({
2472
2649
  * DSH 0.1.x footer/Portal 兼容适配器。席位可以延迟声明,因此状态不依赖 DOM 探测。
2473
2650
  */
2474
2651
  function installSidebarSlots(ctx, marketView) {
2652
+ // The host unmounts main on exit. Remember display data for the next Web
2653
+ // mount; only a fresh provider selection can enable the update button.
2654
+ const sidebarUpdateMemory = window.dshDesktop ? null : { offer: null };
2475
2655
  let mainReady = false;
2476
2656
  let panelListReady = false;
2477
2657
  let footerReady = false;
@@ -2550,6 +2730,7 @@ window.__ModuleLoader__.load({
2550
2730
  store: marketView,
2551
2731
  inject: () => ({
2552
2732
  ...marketRuntimeProps(ctx),
2733
+ sidebarUpdateMemory,
2553
2734
  presentation: "panel",
2554
2735
  closePanel: () => layout()?.selectPanel?.(null)
2555
2736
  })
@@ -71,6 +71,18 @@ export default {
71
71
  "重试更新": "Retry update",
72
72
  "检测到异常版本,正在自动回滚…": "An unexpected version was detected. Rolling back automatically…",
73
73
  "查看更新方式": "See update options",
74
+ "当前版本 v{current},发现新版本 v{target}": "Current version v{current}, new version v{target}",
75
+ "暂时无法确认 MCP 连接器是否有新版本。": "Could not check whether a new MCP Connector version is available.",
76
+ "重新检查失败,显示上次发现的版本。": "The check failed. Showing the previously found version.",
77
+ "重新检查": "Check again",
78
+ "查看手动升级命令": "View manual upgrade command",
79
+ "前往更新": "Go to update",
80
+
81
+ "npm 尚未确认此版本,暂时无法提供升级命令。": "An upgrade command will be available once npm confirms this version.",
82
+ "从插件页更新": "Update from the plugin page",
83
+ "请打开侧栏“插件” → “已安装” → dsh-mcp-connector,查看当前可用的更新。": "Open Plugins in the sidebar, select Installed, and choose dsh-mcp-connector to see available updates.",
84
+ "未能打开插件详情页。": "Could not open the plugin details page. ",
85
+ "请打开侧栏“插件” → “已安装” → dsh-mcp-connector,然后点击“更新到 v{version}”。": "Open Plugins in the sidebar, select Installed, choose dsh-mcp-connector, then click Update to v{version}.",
74
86
  "已回滚": "Rolled back",
75
87
  "已阻止异常版本并回滚": "Blocked the unexpected version and rolled back",
76
88
  "已安装 v{version}": "Installed v{version}",
@@ -89,6 +101,10 @@ export default {
89
101
  "正在准备更新…": "Preparing the update…",
90
102
  "由 {provider} 安全更新到 v{version}": "Update safely to v{version} via {provider}",
91
103
  "更新服务": "the update service",
104
+ "更新到 v{version}": "Update to v{version}",
105
+ "使用 Web 启动时的终端": "Use the terminal where you started the Web app",
106
+ "查看升级方式": "View upgrade methods",
107
+ "收起升级方式": "Hide upgrade methods",
92
108
  "一键更新到 v{version}": "Update to v{version}",
93
109
  "v{version} 已安装,重启后生效": "v{version} is installed and takes effect after a restart",
94
110
  "已复制": "Copied",
package/lib/index.js CHANGED
@@ -352,13 +352,19 @@ export async function apply(ctx, config) {
352
352
  let catalogDisposed = false;
353
353
  let catalogWrite = Promise.resolve();
354
354
 
355
- async function updateRemoteCatalog(cached) {
355
+ async function updateRemoteCatalog(cached, { preferOrigin = false } = {}) {
356
356
  catalogController?.abort();
357
357
  const controller = new AbortController();
358
358
  catalogController = controller;
359
- const fetched = await fetchRemoteCatalogWithFallback(config.catalogUrl, catalogFallbackUrls(), {
359
+ // Explicit refresh must not accept a stale-but-successful CDN response first.
360
+ // Only the built-in registry has a trusted origin; custom URLs stay unchanged.
361
+ const fallbacks = catalogFallbackUrls();
362
+ const originFirst = preferOrigin && fallbacks.length > 0;
363
+ const primaryUrl = originFirst ? fallbacks[0] : config.catalogUrl;
364
+ const otherUrls = originFirst ? [...fallbacks.slice(1), config.catalogUrl] : fallbacks;
365
+ const fetched = await fetchRemoteCatalogWithFallback(primaryUrl, otherUrls, {
360
366
  requestTimeoutMs: config.requestTimeoutMs,
361
- etag: cached?.etag,
367
+ etag: originFirst ? undefined : cached?.etag,
362
368
  signal: controller.signal,
363
369
  onSourceError: warnCatalogSourceFailure,
364
370
  });
@@ -370,7 +376,7 @@ export async function apply(ctx, config) {
370
376
  // A 304 also renews the cache freshness timestamp.
371
377
  catalogWrite = catalogWrite.then(async () => {
372
378
  if (catalogDisposed || controller.signal.aborted) return;
373
- await catalogStore.putRemote({ catalogUrl: config.catalogUrl, etag: fetched.notModified ? cached.etag : fetched.etag, connectors });
379
+ await catalogStore.putRemote({ catalogUrl: config.catalogUrl, etag: originFirst ? undefined : fetched.notModified ? cached.etag : fetched.etag, connectors });
374
380
  }).catch(() => {});
375
381
  await catalogWrite;
376
382
  }
@@ -3408,7 +3414,7 @@ export async function apply(ctx, config) {
3408
3414
  }
3409
3415
  try {
3410
3416
  clearTimeout(catalogTimer);
3411
- await updateRemoteCatalog();
3417
+ await updateRemoteCatalog(undefined, { preferOrigin: true });
3412
3418
  const visibleCount = listCatalog(state.merged, { publishedOnly: true }).length;
3413
3419
  return { ok: true, message: t(`市场已刷新,共 {count} 个连接器`, { count: visibleCount }) };
3414
3420
  } catch (error) {
@@ -161,7 +161,9 @@ export function createVersionStatusService({
161
161
  // npm is authoritative for an actionable update. A GitHub-only failure must not
162
162
  // turn into a five-minute retry loop against the unauthenticated GitHub API.
163
163
  const resultTtlMs = npmOk ? cacheTtlMs : failureTtlMs;
164
+ const previousOffer = cached?.updateAvailable ? cached.latestVersion : cached?.lastConfirmedUpdateVersion;
164
165
  const result = {
166
+ ...(!npmOk && previousOffer ? { lastConfirmedUpdateVersion: previousOffer } : {}),
165
167
  installedVersion,
166
168
  latestVersion: npmVersion ?? null,
167
169
  updateAvailable,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-mcp-connector",
3
- "version": "0.2.114",
3
+ "version": "0.2.115",
4
4
  "description": "MCP Connector for DeepSeek Harness: a data marketplace connecting enterprise, financial, legal, patent and research data. Manage authorization, search tools and troubleshoot MCP connections. Supports OAuth, API keys and HTTP/stdio.",
5
5
  "type": "module",
6
6
  "main": "lib/index.js",