dsh-mcp-connector 0.2.103 → 0.2.105

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 (34) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/README.en.md +19 -4
  3. package/README.md +20 -5
  4. package/docs/PLUGIN-UPDATE.md +36 -2
  5. package/docs/USER-GUIDE.md +12 -2
  6. package/docs/screenshots/01-market-overview.jpg +0 -0
  7. package/docs/screenshots/02-connector-detail.jpg +0 -0
  8. package/docs/screenshots/03-tool-discovery.jpg +0 -0
  9. package/docs/screenshots/04-json-import.jpg +0 -0
  10. package/docs/screenshots/05-unified-tool-search.png +0 -0
  11. package/docs/screenshots/06-tool-parameters.png +0 -0
  12. package/docs/screenshots/07-connection-diagnostics.png +0 -0
  13. package/docs/screenshots/08-ten-recommendations.jpg +0 -0
  14. package/docs/screenshots/README.md +1 -1
  15. package/docs/screenshots/assets.json +20 -20
  16. package/docs/screenshots/en/01-market-overview.jpg +0 -0
  17. package/docs/screenshots/en/02-connector-detail.jpg +0 -0
  18. package/docs/screenshots/en/03-tool-discovery.jpg +0 -0
  19. package/docs/screenshots/en/04-json-import.jpg +0 -0
  20. package/docs/screenshots/en/05-unified-tool-search.png +0 -0
  21. package/docs/screenshots/en/06-tool-parameters.png +0 -0
  22. package/docs/screenshots/en/07-connection-diagnostics.png +0 -0
  23. package/docs/screenshots/en/08-ten-recommendations.jpg +0 -0
  24. package/docs/screenshots/en/assets.json +20 -20
  25. package/docs/screenshots/en/demo.gif +0 -0
  26. package/docs/tutorials/FIRST-SUCCESS-SCENARIOS.md +1 -1
  27. package/docs/tutorials/README.md +11 -1
  28. package/lib/client.js +242 -103
  29. package/lib/i18n/locales/en/client.js +14 -0
  30. package/lib/index.js +36 -12
  31. package/lib/settings.js +12 -8
  32. package/lib/version-status.js +23 -0
  33. package/package.json +3 -2
  34. package/ui/index.html +168 -64
package/CHANGELOG.md CHANGED
@@ -1,5 +1,18 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.2.105 - 2026-11-13
4
+
5
+ - 修复使用 configForms 的 DSH Desktop 上的连接器入口设置,支持切换入口位置和恢复默认设置(#236)。
6
+ - 工具详情按当前连接器内的原始工具名去重。企查查的全量入口与分类入口共用的工具只显示一次,搜索和分页使用相同计数。可切换服务入口查看参数或调整策略(#242)。
7
+ - Desktop hosts using configForms can save and reset the connector entry location. Tool details count each name once across a connector’s endpoints, and parameter views and policy changes use the selected endpoint.
8
+
9
+ ## 0.2.104 - 2026-11-13
10
+
11
+ - 升级命令使用宿主提供的实际 profile,支持 Desktop、Web 和自定义名称;无法确认时显示更新指引,不再默认使用 `web`。
12
+ - 同步中英文升级提示和安装文档;手动升级命令旁不常驻展示 Desktop 专用长说明。
13
+ - 未取得 profile 名称时显示具体原因,客户选择默认 Web 或 Desktop 后才展示一条候选命令;已读取但不受支持的名称仅作文本展示,目标版本无效时单独说明版本问题。
14
+ - Manual upgrade commands now target the host's actual profile. When the name is unavailable, explain the cause and show one default candidate only after the user chooses Web or Desktop. Display unsupported names as text, diagnose invalid target versions separately, and reset choices and copy feedback as the context changes.
15
+
3
16
  ## 0.2.103
4
17
 
5
18
  - npm 简介中的下载趋势图移到产品介绍之后;图表改为中文累计下载次数,保留真实统计区间和口径说明。
package/README.en.md CHANGED
@@ -47,12 +47,20 @@ npm downloads include upgrades, repeat installs and automation; they are not uni
47
47
 
48
48
  ## Get started
49
49
 
50
- Search for **`dsh-mcp-connector`** in your plugin marketplace, or run the command below. Default Desktop and Web installations both use the `web` profile; custom deployments should use the profile actually loaded by their host.
50
+ Search for **`dsh-mcp-connector`** in your plugin marketplace, or install into the profile actually loaded by your host. For Desktop, launch the app once to initialize it, register or repair its CLI through the app menu's **Manage dsh Command…**, then fully quit the app and run in a new terminal:
51
+
52
+ ```bash
53
+ dsh plugin --profile desktop add dsh-mcp-connector
54
+ ```
55
+
56
+ For default Web:
51
57
 
52
58
  ```bash
53
59
  dsh plugin --profile web add dsh-mcp-connector
54
60
  ```
55
61
 
62
+ For custom deployments, replace the profile name and use the same `DSH_HOME` as the host. The npm-installed CLI may reject management of `desktop`; use the Desktop-provided CLI in that case.
63
+
56
64
  Fully restart DeepSeek Harness Desktop or `dsh web` after installation or upgrade, then open **MCP Connector** in the primary sidebar, or open it directly from **Settings → Plugins → Plugin Configuration → MCP Connector**.
57
65
 
58
66
  For Desktop, fully quit and relaunch the application. For Web, stop the existing `dsh web` process and start it again; refreshing the browser does not reload backend plugins.
@@ -121,17 +129,22 @@ As of 2026-10-24, the public Registry publishes 112 connector descriptors. After
121
129
  | Connection diagnostics and last-success cache | |
122
130
  | ![Connection diagnostics](https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/main/docs/screenshots/en/07-connection-diagnostics.png) | |
123
131
 
124
- <!-- generated:media -->English UI screenshots and GIF were captured from v0.2.103 (2026-11-13), 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 -->
132
+ <!-- generated:media -->English UI screenshots and GIF were captured from v0.2.105 (2026-11-13), 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 -->
125
133
 
126
134
  ## Installation
127
135
 
128
136
  Requirements: DeepSeek Harness Desktop or web profile, and Node.js 20 or later.
129
137
 
138
+ Desktop requires its own CLI and must be initialized and fully quit before installation. Default Web uses `web`:
139
+
130
140
  ```bash
141
+ # Desktop-provided CLI
142
+ dsh plugin --profile desktop add dsh-mcp-connector
143
+ # Default Web
131
144
  dsh plugin --profile web add dsh-mcp-connector
132
145
  ```
133
146
 
134
- Or use the installer:
147
+ For custom deployments, use the actual profile name and the host's `DSH_HOME`. Default Web can also use the installer (set `DSH_PROFILE` for other profiles):
135
148
 
136
149
  ```bash
137
150
  bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/main/install.sh)
@@ -204,6 +217,8 @@ The proxy variables must be present in the running DSH process. After changing t
204
217
 
205
218
  When upgrading from a document that still holds only `showSidebarEntry`, the legacy boolean is translated by its actual behaviour: `true` → `both` (the old sidebar-visible state also offered the Settings open button), `false` → `settings`. That keeps an upgrade from silently dropping an existing entry point or re-revealing a hidden sidebar. In layered resolution a user override wins over the deployment base, and Restore defaults clears both the new field and any legacy boolean override.
206
219
 
220
+ Open **Settings → MCP Connector** to change the entry location or restore the default. Current Desktop hosts save the preference to the active profile through `configForms`. Older hosts use `settingsScope`. If neither service is available, or Settings has nowhere to display the card, use the sidebar to open the connector. To change the entry location, open the same profile with a host that provides the settings service and page.
221
+
207
222
  `showSidebarEntry` defaults to `true` and is kept for configuration compatibility; once `entryLocation` is set explicitly it no longer affects the UI. Hiding the entry only hides the shortcut; connectors, connected MCP servers and tools keep working.
208
223
 
209
224
  `compactManagementTools` defaults to `false` for backward compatibility. Set it to `true` in the plugin configuration and reload the plugin (or restart DSH) to expose only two management tools at the next inference boundary:
@@ -256,7 +271,7 @@ npm run dev:ui
256
271
 
257
272
  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.
258
273
 
259
- <!-- generated:version -->The current public version is [`dsh-mcp-connector@0.2.103`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.103](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.103).<!-- /generated:version -->
274
+ <!-- generated:version -->The current public version is [`dsh-mcp-connector@0.2.105`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.105](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.105).<!-- /generated:version -->
260
275
 
261
276
  See [CHANGELOG.md](CHANGELOG.md) for version history and [docs/DESKTOP-E2E.md](docs/DESKTOP-E2E.md) for the Desktop release checklist.
262
277
 
package/README.md CHANGED
@@ -16,7 +16,7 @@ OAuth 是否可用取决于服务商的客户端注册、账号权限与授权
16
16
 
17
17
  **MCP Connector for DeepSeek Harness** is a specialist data marketplace connecting data providers and open data sources, with authorization, cross-connection tool search and troubleshooting in one panel. Browse a continuously updated catalog of 100+ connectors; connect through OAuth 2.0 PKCE, API keys, Streamable HTTP/stdio or `mcpServers` JSON import.
18
18
 
19
- Install with `dsh plugin --profile web add dsh-mcp-connector`, then select **EN** in the toolbar. The interface supports Chinese and English; provider descriptions and user content keep their original language. Provider accounts, permissions and any provider fees are separate from this plugin. Saving a connection or discovering tools does not guarantee a successful business call.
19
+ Install into the profile loaded by your host: use `--profile desktop` with the Desktop-provided CLI, or `--profile web` for default Web. See [installation](#安装), then select **EN** in the toolbar. The interface supports Chinese and English; provider descriptions and user content keep their original language. Provider accounts, permissions and any provider fees are separate from this plugin. Saving a connection or discovering tools does not guarantee a successful business call.
20
20
 
21
21
  ![MCP Connector — English interface](https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/main/docs/screenshots/en/01-market-overview.jpg)
22
22
 
@@ -59,12 +59,20 @@ npm 下载次数包含升级、重复安装及自动化下载,不等于独立
59
59
 
60
60
  ## 开始使用
61
61
 
62
- 在插件市场搜索完整包名 **`dsh-mcp-connector`**,或在本机终端运行下方命令。当前默认 Desktop 和 Web 都使用 `web` profile;自定义部署请以宿主实际加载的 profile 为准。
62
+ 在插件市场搜索完整包名 **`dsh-mcp-connector`**,或按当前宿主实际加载的 profile 安装。Desktop 先启动应用完成初始化,通过应用菜单“管理 dsh 命令…”注册或修复配套 CLI,完全退出应用后在新终端执行:
63
+
64
+ ```bash
65
+ dsh plugin --profile desktop add dsh-mcp-connector
66
+ ```
67
+
68
+ 默认 Web 使用:
63
69
 
64
70
  ```bash
65
71
  dsh plugin --profile web add dsh-mcp-connector
66
72
  ```
67
73
 
74
+ 自定义部署请替换 profile 名称;设置了 `DSH_HOME` 时,终端须沿用与宿主相同的值。npm 安装的 CLI 可能拒绝管理 `desktop`,此时应使用 Desktop 配套 CLI。
75
+
68
76
  安装或升级后完全重启 DeepSeek Harness Desktop 或 `dsh web`,然后打开左侧「MCP连接器」;也可从“设置 → 插件 → 插件配置 → MCP连接器”直接打开。
69
77
 
70
78
  Desktop 需要完全退出并重新启动应用;Web 需要停止原 `dsh web` 进程再启动,只刷新网页不会重新加载后端插件。
@@ -135,17 +143,22 @@ Desktop 需要完全退出并重新启动应用;Web 需要停止原 `dsh web`
135
143
  | 连接诊断与最后成功缓存 | |
136
144
  | ![连接诊断](https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/main/docs/screenshots/07-connection-diagnostics.png) | |
137
145
 
138
- <!-- generated:media -->截图与 GIF 采集自 v0.2.103(2026-11-13)无凭据 Mock 页面,展示界面而非真实业务验收;市场数量是测试夹具。来源与更新方法见 [素材说明](docs/screenshots/README.md)。<!-- /generated:media -->
146
+ <!-- generated:media -->截图与 GIF 采集自 v0.2.105(2026-11-13)无凭据 Mock 页面,展示界面而非真实业务验收;市场数量是测试夹具。来源与更新方法见 [素材说明](docs/screenshots/README.md)。<!-- /generated:media -->
139
147
 
140
148
  ## 安装
141
149
 
142
150
  要求:DeepSeek Harness Desktop/web profile,Node.js 20 或更高版本。
143
151
 
152
+ Desktop 使用配套 CLI,初始化后完全退出应用再安装;默认 Web 使用 `web`:
153
+
144
154
  ```bash
155
+ # Desktop 配套 CLI
156
+ dsh plugin --profile desktop add dsh-mcp-connector
157
+ # 默认 Web
145
158
  dsh plugin --profile web add dsh-mcp-connector
146
159
  ```
147
160
 
148
- 也可使用安装脚本:
161
+ 自定义部署以实际 profile 为准,并在终端沿用宿主的 `DSH_HOME`。默认 Web 也可使用安装脚本(其他 profile 需设置 `DSH_PROFILE`):
149
162
 
150
163
  ```bash
151
164
  bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/main/install.sh)
@@ -212,6 +225,8 @@ Bundle 默认配置位于 `cordis.patch.yml`:
212
225
 
213
226
  从旧版升级时,若设置文档里只有 `showSidebarEntry` 而没有 `entryLocation`,插件按旧字段的实际行为翻译:`true` → `both`(旧版侧栏可见、设置页也有打开按钮),`false` → `settings`。这样升级既不会悄悄删掉既有入口,也不会让隐藏过的侧栏重新出现。分层解析中用户自己的覆盖优先于部署基线;「恢复默认」会同时清掉新字段与旧的布尔覆盖。
214
227
 
228
+ 在 **设置 → MCP连接器** 中可以切换入口位置或恢复默认。当前 Desktop 通过 `configForms` 将偏好写入当前 profile;旧版宿主通过 `settingsScope` 保存。若宿主未提供这两种服务,或未提供放置卡片的设置页入口,仍可从侧栏打开连接器。要更改入口位置,请在启用了设置服务和设置页的宿主中打开同一 profile。
229
+
215
230
  `showSidebarEntry` 默认为 `true`,为兼容既有配置保留;一旦显式设置 `entryLocation`,它不再影响界面。关闭入口只隐藏快捷方式,不停用连接器、已连接 MCP Server 或工具。
216
231
 
217
232
  `compactManagementTools` 默认为 `false`,兼容原有对话管理工具。希望降低管理工具上下文开销时,可在插件配置中设为 `true` 并重载插件(必要时重启 DSH),下一次推理使用新工具集:
@@ -263,7 +278,7 @@ npm run dev:ui
263
278
 
264
279
  公共 Registry 每次合并后会生成 `catalog-stats.json`;本仓库的定时工作流每小时同步中英文介绍和统计快照。npm 页面中的静态正文随版本发布更新,上方动态统计徽标则直接读取 Registry,可在不发布新 npm 版本时保持实时数量一致。
265
280
 
266
- <!-- generated:version -->当前公开版本为 [`dsh-mcp-connector@0.2.103`](https://www.npmjs.com/package/dsh-mcp-connector),对应 [GitHub Release v0.2.103](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.103)。<!-- /generated:version -->
281
+ <!-- generated:version -->当前公开版本为 [`dsh-mcp-connector@0.2.105`](https://www.npmjs.com/package/dsh-mcp-connector),对应 [GitHub Release v0.2.105](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.105)。<!-- /generated:version -->
267
282
 
268
283
  版本能力与变更记录见 [CHANGELOG.md](CHANGELOG.md)。
269
284
  Desktop 发版回归见 [docs/DESKTOP-E2E.md](docs/DESKTOP-E2E.md)。
@@ -14,7 +14,7 @@ MCP连接器把“刷新连接器目录”和“升级插件代码”视为两
14
14
 
15
15
  每个 Provider 适配器只硬编码自己的 capabilities 入口,其余更新、任务、回滚和重启端点均从能力响应中读取。客户端只接受当前 DSH 页面的相对同源端点,拒绝跨域 URL、协议不匹配、缺少必要端点或未声明 `features.update` 的 Provider。
16
16
 
17
- DSH Market 适配器从 `GET /dsh-market/api/v1/capabilities` 开始,要求 `schema: dsh-market/update-api/v1` 与 `apiVersion: 1`。未安装任何可用 Provider、接口返回 404、协议不兼容或检查失败时,页面不会尝试私有更新路由,而是显示“查看更新方式”。页面会先尝试打开当前宿主的插件市场;设置入口不可用,或 DSH Desktop 设置中实际没有插件市场分区时,打开 npm 包页面与安装命令说明。
17
+ DSH Market 适配器从 `GET /dsh-market/api/v1/capabilities` 开始,要求 `schema: dsh-market/update-api/v1` 与 `apiVersion: 1`。未安装任何可用 Provider、接口返回 404、协议不兼容或检查失败时,页面进入下述手动升级流程,不会尝试私有更新路由。已有 Provider 的失败流程仍可通过“查看更新方式”打开宿主插件市场或 npm 页面。
18
18
 
19
19
  ## 更新流程
20
20
 
@@ -29,7 +29,41 @@ Provider 读取的是 profile 中已经落盘的插件版本,标题版本来
29
29
 
30
30
  失败结果使用稳定代码区分正在运行的 Agent、其他安装任务占用、发布安全等待、镜像同步、版本未变化、超时和权限拒绝,以及 `DOWNGRADE_DETECTED`、`RESOLVED_VERSION_MISMATCH`、`INVALID_UPDATE_RESULT` 三类完整性故障。`RELEASE_TOO_FRESH` 明确显示为约 24 小时的发布安全等待期,并提供“立即更新(跳过等待)”;真正的镜像同步故障保留独立提示,不再混用同一文案。
31
31
 
32
- 当 DSH Desktop 或其他宿主没有兼容 Update Provider 时,标题区直接展示绑定 npm 精确版本的 CLI 命令,例如 `dsh plugin --profile web add --config.minimumReleaseAge=0 dsh-mcp-connector@<目标版本>`,并提供复制按钮与 npm 页面入口。运行时会把 `<目标版本>` 替换为 npm 已发布的确切版本;命令中的单次覆盖只用于用户主动跳过本次发布安全等待。Connector 仍不自行执行包管理器命令。
32
+ 当 DSH Desktop 或其他宿主没有兼容 Update Provider 时,标题区展示绑定 npm 精确版本和当前 profile 的 CLI 命令,并提供复制按钮与 npm 页面入口。服务端每次请求只读取一次可选的 `profileContext.name`。`versionStatus.detail.profileName` 继续只返回可安全生成命令的名称或 `null`;新增的 `profileInfo` 只包含实际读取到的字符串 `detectedName`(或 `null`)和固定的 `status`,不包含本机目录、环境变量或异常原文。客户端不会根据窗口类型、网址或插件目录猜测 profile。
33
+
34
+ | `profileInfo.status` | 含义与界面行为 |
35
+ | --- | --- |
36
+ | `ready` | 已取得可安全生成命令的名称,沿用现有命令与复制按钮,不增加常驻说明 |
37
+ | `unavailable` | 宿主没有提供读取入口或 profile 服务,显示“宿主未提供 profile 信息” |
38
+ | `read-error` | 读取服务或名称发生异常,显示“读取当前 profile 失败” |
39
+ | `invalid-value` | 服务存在,但名称缺失、为空或不是字符串,显示“宿主未返回有效的 profile 名称” |
40
+ | `unsupported-name` | 已取得名称,但不符合自动生成命令的规则;显示名称及保留名称、首尾空白或字符规则原因,不提供默认候选命令 |
41
+
42
+ 未取得有效名称时,客户可以通过“默认安装方式”选择“默认 Web(web)”或“默认 Desktop(desktop)”。初始不预选,也不显示命令;选择后才显示一条对应的候选命令与复制按钮,并注明“仅适用于默认安装;自定义部署请使用实际 profile”。这是客户选择的默认候选,不代表程序已识别当前 profile;不要依次执行两种命令。
43
+
44
+ Desktop 配套 CLI 示例:
45
+
46
+ ```bash
47
+ dsh plugin --profile desktop add --config.minimumReleaseAge=0 dsh-mcp-connector@<目标版本>
48
+ ```
49
+
50
+ 默认 Web 示例:
51
+
52
+ ```bash
53
+ dsh plugin --profile web add --config.minimumReleaseAge=0 dsh-mcp-connector@<目标版本>
54
+ ```
55
+
56
+ 运行时将 `<目标版本>` 替换为 npm 已发布的确切版本。自动识别的 profile 名称须满足 `^[A-Za-z0-9][A-Za-z0-9._-]*$`,且不能是保留名称 `node_modules`;不受支持的名称只作为普通文本展示,空白和控制字符使用可见转义,不能进入命令。旧接口只有 `profileName` 时仍由客户端校验;缺失时按未取得信息处理。
57
+
58
+ 未取得有效目标版本时,显示“未取得有效的目标版本,请点击‘检查更新’后重试”,不归因于 profile,也不显示命令或默认安装方式选择。手动升级诊断区保留“查看更新说明”和“查看 npm”;“查看更新说明”打开本文,不是查询客户 profile 的入口。
59
+
60
+ 默认安装方式选择仅用于当前面板,不修改宿主配置。面板关闭、目标版本或诊断信息变化时清除选择;命令变化时清除“已复制”和复制失败提示,忽略旧命令迟到的复制结果。命令展示与复制使用同一字符串。
61
+
62
+ English: When the host cannot supply a usable profile name, the panel explains whether the information is unavailable, could not be read, or has an invalid value. No installation type is preselected. Choose **Default Web (web)** or **Default Desktop (desktop)** to reveal one candidate command for a default installation; custom deployments must use their actual profile. A detected but unsupported name is displayed as text with its reason and is never inserted into a command. Invalid target versions show a version-specific message. **View update instructions** opens this document; it does not look up the local profile. Closing the panel or changing the version or diagnostics clears the choice and copy feedback.
63
+
64
+ Desktop:先启动应用完成初始化,通过应用菜单“管理 dsh 命令…”注册或修复 Desktop 配套 CLI,然后完全退出应用,在新终端执行命令,完成后重新打开。[官方命令运行时说明](https://github.com/deepseek-ai/deepseek-harness/blob/HEAD/apps/desktop/README.zh.md#bundled-command-runtime)。npm 安装的 CLI 可能拒绝管理 `desktop`,不要改用 `web` 绕过限制。关闭窗口可能只会隐藏应用,请从应用或托盘菜单退出。设置了 `DSH_HOME` 时,终端必须沿用与宿主相同的值。
65
+
66
+ 命令中的单次覆盖只用于用户主动跳过本次发布安全等待。Connector 仍不自行执行包管理器命令。
33
67
 
34
68
  ## 安全边界
35
69
 
@@ -17,11 +17,21 @@
17
17
 
18
18
  要求:DSH Desktop 或 `web` profile,Node.js 20 或更高版本。
19
19
 
20
+ Desktop:启动应用完成初始化,通过应用菜单“管理 dsh 命令…”注册或修复配套 CLI,再完全退出应用,在新终端执行:
21
+
22
+ ```bash
23
+ dsh plugin --profile desktop add dsh-mcp-connector
24
+ ```
25
+
26
+ 默认 Web:
27
+
20
28
  ```bash
21
29
  dsh plugin --profile web add dsh-mcp-connector
22
30
  ```
23
31
 
24
- 也可以运行一键安装脚本:
32
+ 自定义部署以宿主实际加载的 profile 为准;设置了 `DSH_HOME` 时,终端须沿用相同值。npm 安装的 CLI 可能拒绝管理 `desktop`,此时请使用 Desktop 配套 CLI,不要改用 `web`。
33
+
34
+ 默认 Web 也可以运行一键安装脚本(其他 profile 需设置 `DSH_PROFILE`):
25
35
 
26
36
  ```bash
27
37
  bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/main/install.sh)
@@ -110,7 +120,7 @@ OAuth 一键连接要求服务商支持标准 OAuth 2.1/PKCE 和公开元数据
110
120
 
111
121
  1. 阅读服务说明、鉴权方式、数据范围与可能产生的费用或副作用。
112
122
  2. 在“试试这样用”中选择示例 Prompt;带变量的模板会先要求补齐查询主体等信息。
113
- 3. 展开“工具详情”查看 Server 数量、工具名称与描述,并可搜索工具;点击“参数详情”可按需查看输入 schema;连接后还可按 Connection、Server、Tool 设置治理规则。
123
+ 3. 展开“工具详情”查看工具总数和服务入口数。同一连接器内,名称完全相同的工具在总数、默认列表及搜索结果中只算一次。选择服务入口可查看它提供的工具。一个工具有多个入口时,选择所需入口后再查看参数或调整该入口的工具策略。
114
124
  4. 点击“去试试”或 Prompt 的发送按钮,在当前工作区创建或复用空白会话并写入草稿。如果已有未发送文字或附件,会保留原草稿并另建会话。插件只带入草稿,核对后再自行发送。
115
125
 
116
126
  连接成功后,工具按 `mcp__<serverName>__*` 前缀提供给模型。工具清单来自服务端,实际数量会随服务商权限和版本变化。成功发现后,插件会在当前 profile 保存一份安全裁剪的工具元数据;实时发现失败时仍显示这份“最后成功缓存”,但保持连接失败/未知状态并标注缓存时间,超过 24 小时还会显示陈旧提示。详情与“已安装”列表会展示最近一次诊断的阶段、稳定错误码、说明、建议动作和最近成功时间。
Binary file
@@ -1,6 +1,6 @@
1
1
  # 产品截图与演示的来源及更新
2
2
 
3
- <!-- generated:media -->本组 8 张截图和 GIF 均从 v0.2.103 于 2026-11-13 重新采集,未修改截图中的版本文字。<!-- /generated:media -->
3
+ <!-- generated:media -->本组 8 张截图和 GIF 均从 v0.2.105 于 2026-11-13 重新采集,未修改截图中的版本文字。<!-- /generated:media -->
4
4
 
5
5
  前七张素材由真实产品 UI 的无凭据 Mock harness 渲染:1280×720 浏览器视口、800px 产品面板、桌面两列卡片。顶部保留“无凭据 Mock”标识;目录数、连接数与工具数是演示夹具,不代表生产统计或真实授权、业务验收。不会读取用户 profile、调用服务商或上传业务数据。
6
6
 
@@ -3,8 +3,8 @@
3
3
  "capture": {
4
4
  "locale": "zh-CN",
5
5
  "capturedOn": "2026-11-13",
6
- "sourceVersion": "0.2.103",
7
- "sourceFingerprint": "4d8135cd206dcb890002f8dee5b64bd1664806d68b1b9e5393743d47b1a5aa8b",
6
+ "sourceVersion": "0.2.105",
7
+ "sourceFingerprint": "45f634fcb74fbca16beec3844c151912635e859098ebc5d4e64e720734c46a64",
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": "f22d9cd4672a546ecb3da94cadb8e3fa00c25d0c57a7ae0200bef2975e2e4b2e",
20
+ "sha256": "ea047c103f94aa0a99c8b8a16083aca48b43837aafd59207037c2b6945b08259",
21
21
  "width": 1280,
22
22
  "height": 720,
23
23
  "capturedOn": "2026-11-13",
24
- "sourceVersion": "0.2.103"
24
+ "sourceVersion": "0.2.105"
25
25
  },
26
26
  {
27
27
  "path": "docs/screenshots/02-connector-detail.jpg",
28
- "sha256": "997525769d07ae9c91ac423d6c977fef629306c5dea0451fc38782d7bef4c7bb",
28
+ "sha256": "b2ebd4c1a0cdd8a21cabff6bde3ad3d8c5f9c36b0013663565f3efb6b61c19de",
29
29
  "width": 1280,
30
30
  "height": 720,
31
31
  "capturedOn": "2026-11-13",
32
- "sourceVersion": "0.2.103"
32
+ "sourceVersion": "0.2.105"
33
33
  },
34
34
  {
35
35
  "path": "docs/screenshots/03-tool-discovery.jpg",
36
- "sha256": "a7a75386f4f3f14c6ef6e8c9caa87f98267cb3b4dcddf870ac2618d1fa1f43db",
36
+ "sha256": "c1e9460c98121b4a2997740697c111b53ec78e6727616cecc22c8d26170874e1",
37
37
  "width": 1280,
38
38
  "height": 720,
39
39
  "capturedOn": "2026-11-13",
40
- "sourceVersion": "0.2.103"
40
+ "sourceVersion": "0.2.105"
41
41
  },
42
42
  {
43
43
  "path": "docs/screenshots/04-json-import.jpg",
44
- "sha256": "ca6bcb14de279320a03dc60d3a857f3b15a93d5bba52bf82c12a443906fb8a5d",
44
+ "sha256": "b1681985fe6e9f352bd4f14fa50712af14aed5a38a801b382435ffebaaf35fd6",
45
45
  "width": 1280,
46
46
  "height": 720,
47
47
  "capturedOn": "2026-11-13",
48
- "sourceVersion": "0.2.103"
48
+ "sourceVersion": "0.2.105"
49
49
  },
50
50
  {
51
51
  "path": "docs/screenshots/05-unified-tool-search.png",
52
- "sha256": "52db1a99be0616d3b567cb3659fa534c65f1d5b1328508010675d682220d32c5",
52
+ "sha256": "414820be2afc9d414e21f4d89c136dc26abe47a6a5c45e1ac042af6b2476fbe6",
53
53
  "width": 1280,
54
54
  "height": 720,
55
55
  "capturedOn": "2026-11-13",
56
- "sourceVersion": "0.2.103"
56
+ "sourceVersion": "0.2.105"
57
57
  },
58
58
  {
59
59
  "path": "docs/screenshots/06-tool-parameters.png",
60
- "sha256": "c21df32d1c5401582c7a2d9612ee402564acf43e2cb1416402f969e28d4eb5a8",
60
+ "sha256": "ae5d7a613caf80cbc81d80e2d29d405039073f4d166d6e3e57221d691d49dd24",
61
61
  "width": 1280,
62
62
  "height": 720,
63
63
  "capturedOn": "2026-11-13",
64
- "sourceVersion": "0.2.103"
64
+ "sourceVersion": "0.2.105"
65
65
  },
66
66
  {
67
67
  "path": "docs/screenshots/07-connection-diagnostics.png",
68
- "sha256": "6a5aa4f1af68cd6b5801a473d83ea587a3450927dba43e9c55f520cdbe3dda70",
68
+ "sha256": "3e8bac1647881baf0bc3794f9ac3b2472f6aca8542dd3208cdfab677d9d4ac96",
69
69
  "width": 1280,
70
70
  "height": 720,
71
71
  "capturedOn": "2026-11-13",
72
- "sourceVersion": "0.2.103"
72
+ "sourceVersion": "0.2.105"
73
73
  },
74
74
  {
75
75
  "path": "docs/screenshots/08-ten-recommendations.jpg",
76
- "sha256": "81dd2b27489d0a2d2585f82c75083b95080a54103c162982e45644f62bcec170",
76
+ "sha256": "0f94c5118818d605416abe38f3ec8e23e51ee02adc1a96bf790e9a5924be08d4",
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-13",
85
- "sourceVersion": "0.2.103"
85
+ "sourceVersion": "0.2.105"
86
86
  }
87
87
  ],
88
88
  "demo": {
89
89
  "path": "docs/demo.gif",
90
- "sha256": "3780a4f1b1e1f3332a19759cbbce9f42b32cc26ca593ea79d6dbea2588205e2e",
90
+ "sha256": "b2ea6c0724b2be7ac73e77f0d671d208550bb9471f834f669eb899c345828791",
91
91
  "width": 960,
92
92
  "height": 540,
93
93
  "capturedOn": "2026-11-13",
94
- "sourceVersion": "0.2.103",
94
+ "sourceVersion": "0.2.105",
95
95
  "durationSeconds": 36
96
96
  }
97
97
  }
@@ -3,8 +3,8 @@
3
3
  "capture": {
4
4
  "locale": "en",
5
5
  "capturedOn": "2026-11-13",
6
- "sourceVersion": "0.2.103",
7
- "sourceFingerprint": "4d8135cd206dcb890002f8dee5b64bd1664806d68b1b9e5393743d47b1a5aa8b",
6
+ "sourceVersion": "0.2.105",
7
+ "sourceFingerprint": "45f634fcb74fbca16beec3844c151912635e859098ebc5d4e64e720734c46a64",
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": "46fb2808073c13dafbf594223762d435b637d5d5f4851e2acfa22766944466b7",
20
+ "sha256": "23f6b72f9bf0f53a349e6729d88baa24218588fd7a2f3e1696c67b90e3f2910c",
21
21
  "width": 1280,
22
22
  "height": 720,
23
23
  "capturedOn": "2026-11-13",
24
- "sourceVersion": "0.2.103"
24
+ "sourceVersion": "0.2.105"
25
25
  },
26
26
  {
27
27
  "path": "docs/screenshots/en/02-connector-detail.jpg",
28
- "sha256": "53d0a89e1031b8471ffa97a658a342b2e9fcf90fe316cab42d362d52d63ebf16",
28
+ "sha256": "910eca28003c05a98676ed2c8a19e1282fd40bb116c5a6207830bc8eadf73b16",
29
29
  "width": 1280,
30
30
  "height": 720,
31
31
  "capturedOn": "2026-11-13",
32
- "sourceVersion": "0.2.103"
32
+ "sourceVersion": "0.2.105"
33
33
  },
34
34
  {
35
35
  "path": "docs/screenshots/en/03-tool-discovery.jpg",
36
- "sha256": "6e7fca632bee65d5be82c54f18e16bae7069463a45b4846aa93904031e86d4aa",
36
+ "sha256": "08b81045ed750b8533f1d13f1f4333c9164f460242bad46a9e914e3ab00fe5e3",
37
37
  "width": 1280,
38
38
  "height": 720,
39
39
  "capturedOn": "2026-11-13",
40
- "sourceVersion": "0.2.103"
40
+ "sourceVersion": "0.2.105"
41
41
  },
42
42
  {
43
43
  "path": "docs/screenshots/en/04-json-import.jpg",
44
- "sha256": "644e1b471da734e02a8267af0db3e8a8c2848d96475559485c9a08ac9baf492b",
44
+ "sha256": "74bf69299db8b0e44903aa9f74004ae20793d6ab172ce255d8282f1c7715e4b0",
45
45
  "width": 1280,
46
46
  "height": 720,
47
47
  "capturedOn": "2026-11-13",
48
- "sourceVersion": "0.2.103"
48
+ "sourceVersion": "0.2.105"
49
49
  },
50
50
  {
51
51
  "path": "docs/screenshots/en/05-unified-tool-search.png",
52
- "sha256": "654515ab33ada49225e7452eeb6b6013e1c4dabc4831e88690fec767328caf88",
52
+ "sha256": "0157d19dd4172e5273a75ce3684de332aa7d78c784677f091f565717cc650d74",
53
53
  "width": 1280,
54
54
  "height": 720,
55
55
  "capturedOn": "2026-11-13",
56
- "sourceVersion": "0.2.103"
56
+ "sourceVersion": "0.2.105"
57
57
  },
58
58
  {
59
59
  "path": "docs/screenshots/en/06-tool-parameters.png",
60
- "sha256": "9433906d7106c63d51ad972f8f49a7cafd20c0b85fd048591d9d90e0c25d9047",
60
+ "sha256": "1d2b87f00802ca875fbeb32fe50153c4e1c508325cf29255995c336fdedac52f",
61
61
  "width": 1280,
62
62
  "height": 720,
63
63
  "capturedOn": "2026-11-13",
64
- "sourceVersion": "0.2.103"
64
+ "sourceVersion": "0.2.105"
65
65
  },
66
66
  {
67
67
  "path": "docs/screenshots/en/07-connection-diagnostics.png",
68
- "sha256": "274e7fd19d08ab22b7503a3cd1e836d1b6b079c6d582a33c626926e78fa7a32a",
68
+ "sha256": "3256ff9f499817061cdeae00de49be7134baa6507c7a2f25e143d5d4311b8081",
69
69
  "width": 1280,
70
70
  "height": 720,
71
71
  "capturedOn": "2026-11-13",
72
- "sourceVersion": "0.2.103"
72
+ "sourceVersion": "0.2.105"
73
73
  },
74
74
  {
75
75
  "path": "docs/screenshots/en/08-ten-recommendations.jpg",
76
- "sha256": "023a9ce77f0c457fc160f716feb31434e3897e9e178d3ab73263bd5d0538d1b2",
76
+ "sha256": "0ef802c1b93347d4326c09cb17dfbd93a99c2080cd4fe08b3e07b6a5e73cdd58",
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-13",
85
- "sourceVersion": "0.2.103"
85
+ "sourceVersion": "0.2.105"
86
86
  }
87
87
  ],
88
88
  "demo": {
89
89
  "path": "docs/screenshots/en/demo.gif",
90
- "sha256": "aa3fd6e40ea133111b9f6c17be68e12bd96415b76fdd8f6becf36a895c3ca5a9",
90
+ "sha256": "2a6665295a05f7fa46712f8596780fab311d9abfc942d7d0bff521a7e1c06178",
91
91
  "width": 960,
92
92
  "height": 540,
93
93
  "capturedOn": "2026-11-13",
94
- "sourceVersion": "0.2.103",
94
+ "sourceVersion": "0.2.105",
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.103`<!-- /generated:version -->;当前 Workspace;企查查 OAuth 可用;测试账号具有目标企业数据权限 |
11
+ | 前提 | <!-- generated:version -->正式 `dsh-mcp-connector@0.2.105`<!-- /generated:version -->;当前 Workspace;企查查 OAuth 可用;测试账号具有目标企业数据权限 |
12
12
  | 权限/管理员 | 账号权限、组织授权和可见字段由服务商控制;企业组织可能需要管理员开通,当前文档不能替代审批 |
13
13
  | 费用 | 可能受套餐、次数或字段权限影响;MCP连接器无法确认本次费用,调用前在服务商侧核对 |
14
14
  | 运行/数据去向 | 远程 MCP Server;企业名称、查询参数和调用结果经 DSH Host 发送到/返回自 `agent.qcc.com` |
@@ -23,12 +23,22 @@
23
23
 
24
24
  ## 1. 安装并重启正确的 profile
25
25
 
26
- 当前默认安装布局中,DSH Desktop 和 `dsh web` 都从本机 `web` profile 加载插件,因此两种宿主都使用同一条安装命令;不要因为使用 Desktop 就把命令改成 `--profile desktop`。
26
+ 使用宿主实际加载的 profile。当前 Desktop 配套 CLI 使用 `desktop`,默认 `dsh web` 使用 `web`;自定义部署以宿主配置为准。
27
+
28
+ Desktop:先启动应用完成初始化,通过应用菜单“管理 dsh 命令…”注册或修复 Desktop 配套 CLI,再完全退出应用,在新终端执行:
29
+
30
+ ```bash
31
+ dsh plugin --profile desktop add dsh-mcp-connector
32
+ ```
33
+
34
+ 默认 Web:
27
35
 
28
36
  ```bash
29
37
  dsh plugin --profile web add dsh-mcp-connector
30
38
  ```
31
39
 
40
+ 自定义 profile 请替换命令中的名称。设置了 `DSH_HOME` 时,终端须沿用与宿主相同的值。npm 安装的 CLI 可能拒绝管理 `desktop`,此时应使用 Desktop 配套 CLI;不要改用其他 profile。
41
+
32
42
  安装或升级后,只重启你正在使用的宿主:DSH Desktop 需完全退出应用后重新打开;`dsh web` 需停止原进程后重新启动。打开左侧“MCP连接器”;若侧边栏入口已隐藏,从“设置 → 插件 → 插件配置 → MCP连接器”点击“打开 MCP连接器”。自定义过 profile 布局的部署应以其宿主配置为准。
33
43
 
34
44
  ## 2. 只选一条连接路径