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.
- package/CHANGELOG.md +13 -0
- package/README.en.md +19 -4
- package/README.md +20 -5
- package/docs/PLUGIN-UPDATE.md +36 -2
- package/docs/USER-GUIDE.md +12 -2
- package/docs/screenshots/01-market-overview.jpg +0 -0
- package/docs/screenshots/02-connector-detail.jpg +0 -0
- package/docs/screenshots/03-tool-discovery.jpg +0 -0
- package/docs/screenshots/04-json-import.jpg +0 -0
- package/docs/screenshots/05-unified-tool-search.png +0 -0
- package/docs/screenshots/06-tool-parameters.png +0 -0
- package/docs/screenshots/07-connection-diagnostics.png +0 -0
- package/docs/screenshots/08-ten-recommendations.jpg +0 -0
- package/docs/screenshots/README.md +1 -1
- package/docs/screenshots/assets.json +20 -20
- package/docs/screenshots/en/01-market-overview.jpg +0 -0
- package/docs/screenshots/en/02-connector-detail.jpg +0 -0
- package/docs/screenshots/en/03-tool-discovery.jpg +0 -0
- package/docs/screenshots/en/04-json-import.jpg +0 -0
- package/docs/screenshots/en/05-unified-tool-search.png +0 -0
- package/docs/screenshots/en/06-tool-parameters.png +0 -0
- package/docs/screenshots/en/07-connection-diagnostics.png +0 -0
- package/docs/screenshots/en/08-ten-recommendations.jpg +0 -0
- package/docs/screenshots/en/assets.json +20 -20
- package/docs/screenshots/en/demo.gif +0 -0
- package/docs/tutorials/FIRST-SUCCESS-SCENARIOS.md +1 -1
- package/docs/tutorials/README.md +11 -1
- package/lib/client.js +242 -103
- package/lib/i18n/locales/en/client.js +14 -0
- package/lib/index.js +36 -12
- package/lib/settings.js +12 -8
- package/lib/version-status.js +23 -0
- package/package.json +3 -2
- 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
|
|
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
|
|  | |
|
|
123
131
|
|
|
124
|
-
<!-- generated:media -->English UI screenshots and GIF were captured from v0.2.
|
|
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
|
-
|
|
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.
|
|
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
|
|
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
|

|
|
22
22
|
|
|
@@ -59,12 +59,20 @@ npm 下载次数包含升级、重复安装及自动化下载,不等于独立
|
|
|
59
59
|
|
|
60
60
|
## 开始使用
|
|
61
61
|
|
|
62
|
-
在插件市场搜索完整包名 **`dsh-mcp-connector
|
|
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
|
|  | |
|
|
137
145
|
|
|
138
|
-
<!-- generated:media -->截图与 GIF 采集自 v0.2.
|
|
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.
|
|
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)。
|
package/docs/PLUGIN-UPDATE.md
CHANGED
|
@@ -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
|
|
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
|
|
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
|
|
package/docs/USER-GUIDE.md
CHANGED
|
@@ -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.
|
|
123
|
+
3. 展开“工具详情”查看工具总数和服务入口数。同一连接器内,名称完全相同的工具在总数、默认列表及搜索结果中只算一次。选择服务入口可查看它提供的工具。一个工具有多个入口时,选择所需入口后再查看参数或调整该入口的工具策略。
|
|
114
124
|
4. 点击“去试试”或 Prompt 的发送按钮,在当前工作区创建或复用空白会话并写入草稿。如果已有未发送文字或附件,会保留原草稿并另建会话。插件只带入草稿,核对后再自行发送。
|
|
115
125
|
|
|
116
126
|
连接成功后,工具按 `mcp__<serverName>__*` 前缀提供给模型。工具清单来自服务端,实际数量会随服务商权限和版本变化。成功发现后,插件会在当前 profile 保存一份安全裁剪的工具元数据;实时发现失败时仍显示这份“最后成功缓存”,但保持连接失败/未知状态并标注缓存时间,超过 24 小时还会显示陈旧提示。详情与“已安装”列表会展示最近一次诊断的阶段、稳定错误码、说明、建议动作和最近成功时间。
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# 产品截图与演示的来源及更新
|
|
2
2
|
|
|
3
|
-
<!-- generated:media -->本组 8 张截图和 GIF 均从 v0.2.
|
|
3
|
+
<!-- generated:media -->本组 8 张截图和 GIF 均从 v0.2.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.
|
|
7
|
-
"sourceFingerprint": "
|
|
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": "
|
|
20
|
+
"sha256": "ea047c103f94aa0a99c8b8a16083aca48b43837aafd59207037c2b6945b08259",
|
|
21
21
|
"width": 1280,
|
|
22
22
|
"height": 720,
|
|
23
23
|
"capturedOn": "2026-11-13",
|
|
24
|
-
"sourceVersion": "0.2.
|
|
24
|
+
"sourceVersion": "0.2.105"
|
|
25
25
|
},
|
|
26
26
|
{
|
|
27
27
|
"path": "docs/screenshots/02-connector-detail.jpg",
|
|
28
|
-
"sha256": "
|
|
28
|
+
"sha256": "b2ebd4c1a0cdd8a21cabff6bde3ad3d8c5f9c36b0013663565f3efb6b61c19de",
|
|
29
29
|
"width": 1280,
|
|
30
30
|
"height": 720,
|
|
31
31
|
"capturedOn": "2026-11-13",
|
|
32
|
-
"sourceVersion": "0.2.
|
|
32
|
+
"sourceVersion": "0.2.105"
|
|
33
33
|
},
|
|
34
34
|
{
|
|
35
35
|
"path": "docs/screenshots/03-tool-discovery.jpg",
|
|
36
|
-
"sha256": "
|
|
36
|
+
"sha256": "c1e9460c98121b4a2997740697c111b53ec78e6727616cecc22c8d26170874e1",
|
|
37
37
|
"width": 1280,
|
|
38
38
|
"height": 720,
|
|
39
39
|
"capturedOn": "2026-11-13",
|
|
40
|
-
"sourceVersion": "0.2.
|
|
40
|
+
"sourceVersion": "0.2.105"
|
|
41
41
|
},
|
|
42
42
|
{
|
|
43
43
|
"path": "docs/screenshots/04-json-import.jpg",
|
|
44
|
-
"sha256": "
|
|
44
|
+
"sha256": "b1681985fe6e9f352bd4f14fa50712af14aed5a38a801b382435ffebaaf35fd6",
|
|
45
45
|
"width": 1280,
|
|
46
46
|
"height": 720,
|
|
47
47
|
"capturedOn": "2026-11-13",
|
|
48
|
-
"sourceVersion": "0.2.
|
|
48
|
+
"sourceVersion": "0.2.105"
|
|
49
49
|
},
|
|
50
50
|
{
|
|
51
51
|
"path": "docs/screenshots/05-unified-tool-search.png",
|
|
52
|
-
"sha256": "
|
|
52
|
+
"sha256": "414820be2afc9d414e21f4d89c136dc26abe47a6a5c45e1ac042af6b2476fbe6",
|
|
53
53
|
"width": 1280,
|
|
54
54
|
"height": 720,
|
|
55
55
|
"capturedOn": "2026-11-13",
|
|
56
|
-
"sourceVersion": "0.2.
|
|
56
|
+
"sourceVersion": "0.2.105"
|
|
57
57
|
},
|
|
58
58
|
{
|
|
59
59
|
"path": "docs/screenshots/06-tool-parameters.png",
|
|
60
|
-
"sha256": "
|
|
60
|
+
"sha256": "ae5d7a613caf80cbc81d80e2d29d405039073f4d166d6e3e57221d691d49dd24",
|
|
61
61
|
"width": 1280,
|
|
62
62
|
"height": 720,
|
|
63
63
|
"capturedOn": "2026-11-13",
|
|
64
|
-
"sourceVersion": "0.2.
|
|
64
|
+
"sourceVersion": "0.2.105"
|
|
65
65
|
},
|
|
66
66
|
{
|
|
67
67
|
"path": "docs/screenshots/07-connection-diagnostics.png",
|
|
68
|
-
"sha256": "
|
|
68
|
+
"sha256": "3e8bac1647881baf0bc3794f9ac3b2472f6aca8542dd3208cdfab677d9d4ac96",
|
|
69
69
|
"width": 1280,
|
|
70
70
|
"height": 720,
|
|
71
71
|
"capturedOn": "2026-11-13",
|
|
72
|
-
"sourceVersion": "0.2.
|
|
72
|
+
"sourceVersion": "0.2.105"
|
|
73
73
|
},
|
|
74
74
|
{
|
|
75
75
|
"path": "docs/screenshots/08-ten-recommendations.jpg",
|
|
76
|
-
"sha256": "
|
|
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.
|
|
85
|
+
"sourceVersion": "0.2.105"
|
|
86
86
|
}
|
|
87
87
|
],
|
|
88
88
|
"demo": {
|
|
89
89
|
"path": "docs/demo.gif",
|
|
90
|
-
"sha256": "
|
|
90
|
+
"sha256": "b2ea6c0724b2be7ac73e77f0d671d208550bb9471f834f669eb899c345828791",
|
|
91
91
|
"width": 960,
|
|
92
92
|
"height": 540,
|
|
93
93
|
"capturedOn": "2026-11-13",
|
|
94
|
-
"sourceVersion": "0.2.
|
|
94
|
+
"sourceVersion": "0.2.105",
|
|
95
95
|
"durationSeconds": 36
|
|
96
96
|
}
|
|
97
97
|
}
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
@@ -3,8 +3,8 @@
|
|
|
3
3
|
"capture": {
|
|
4
4
|
"locale": "en",
|
|
5
5
|
"capturedOn": "2026-11-13",
|
|
6
|
-
"sourceVersion": "0.2.
|
|
7
|
-
"sourceFingerprint": "
|
|
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": "
|
|
20
|
+
"sha256": "23f6b72f9bf0f53a349e6729d88baa24218588fd7a2f3e1696c67b90e3f2910c",
|
|
21
21
|
"width": 1280,
|
|
22
22
|
"height": 720,
|
|
23
23
|
"capturedOn": "2026-11-13",
|
|
24
|
-
"sourceVersion": "0.2.
|
|
24
|
+
"sourceVersion": "0.2.105"
|
|
25
25
|
},
|
|
26
26
|
{
|
|
27
27
|
"path": "docs/screenshots/en/02-connector-detail.jpg",
|
|
28
|
-
"sha256": "
|
|
28
|
+
"sha256": "910eca28003c05a98676ed2c8a19e1282fd40bb116c5a6207830bc8eadf73b16",
|
|
29
29
|
"width": 1280,
|
|
30
30
|
"height": 720,
|
|
31
31
|
"capturedOn": "2026-11-13",
|
|
32
|
-
"sourceVersion": "0.2.
|
|
32
|
+
"sourceVersion": "0.2.105"
|
|
33
33
|
},
|
|
34
34
|
{
|
|
35
35
|
"path": "docs/screenshots/en/03-tool-discovery.jpg",
|
|
36
|
-
"sha256": "
|
|
36
|
+
"sha256": "08b81045ed750b8533f1d13f1f4333c9164f460242bad46a9e914e3ab00fe5e3",
|
|
37
37
|
"width": 1280,
|
|
38
38
|
"height": 720,
|
|
39
39
|
"capturedOn": "2026-11-13",
|
|
40
|
-
"sourceVersion": "0.2.
|
|
40
|
+
"sourceVersion": "0.2.105"
|
|
41
41
|
},
|
|
42
42
|
{
|
|
43
43
|
"path": "docs/screenshots/en/04-json-import.jpg",
|
|
44
|
-
"sha256": "
|
|
44
|
+
"sha256": "74bf69299db8b0e44903aa9f74004ae20793d6ab172ce255d8282f1c7715e4b0",
|
|
45
45
|
"width": 1280,
|
|
46
46
|
"height": 720,
|
|
47
47
|
"capturedOn": "2026-11-13",
|
|
48
|
-
"sourceVersion": "0.2.
|
|
48
|
+
"sourceVersion": "0.2.105"
|
|
49
49
|
},
|
|
50
50
|
{
|
|
51
51
|
"path": "docs/screenshots/en/05-unified-tool-search.png",
|
|
52
|
-
"sha256": "
|
|
52
|
+
"sha256": "0157d19dd4172e5273a75ce3684de332aa7d78c784677f091f565717cc650d74",
|
|
53
53
|
"width": 1280,
|
|
54
54
|
"height": 720,
|
|
55
55
|
"capturedOn": "2026-11-13",
|
|
56
|
-
"sourceVersion": "0.2.
|
|
56
|
+
"sourceVersion": "0.2.105"
|
|
57
57
|
},
|
|
58
58
|
{
|
|
59
59
|
"path": "docs/screenshots/en/06-tool-parameters.png",
|
|
60
|
-
"sha256": "
|
|
60
|
+
"sha256": "1d2b87f00802ca875fbeb32fe50153c4e1c508325cf29255995c336fdedac52f",
|
|
61
61
|
"width": 1280,
|
|
62
62
|
"height": 720,
|
|
63
63
|
"capturedOn": "2026-11-13",
|
|
64
|
-
"sourceVersion": "0.2.
|
|
64
|
+
"sourceVersion": "0.2.105"
|
|
65
65
|
},
|
|
66
66
|
{
|
|
67
67
|
"path": "docs/screenshots/en/07-connection-diagnostics.png",
|
|
68
|
-
"sha256": "
|
|
68
|
+
"sha256": "3256ff9f499817061cdeae00de49be7134baa6507c7a2f25e143d5d4311b8081",
|
|
69
69
|
"width": 1280,
|
|
70
70
|
"height": 720,
|
|
71
71
|
"capturedOn": "2026-11-13",
|
|
72
|
-
"sourceVersion": "0.2.
|
|
72
|
+
"sourceVersion": "0.2.105"
|
|
73
73
|
},
|
|
74
74
|
{
|
|
75
75
|
"path": "docs/screenshots/en/08-ten-recommendations.jpg",
|
|
76
|
-
"sha256": "
|
|
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.
|
|
85
|
+
"sourceVersion": "0.2.105"
|
|
86
86
|
}
|
|
87
87
|
],
|
|
88
88
|
"demo": {
|
|
89
89
|
"path": "docs/screenshots/en/demo.gif",
|
|
90
|
-
"sha256": "
|
|
90
|
+
"sha256": "2a6665295a05f7fa46712f8596780fab311d9abfc942d7d0bff521a7e1c06178",
|
|
91
91
|
"width": 960,
|
|
92
92
|
"height": 540,
|
|
93
93
|
"capturedOn": "2026-11-13",
|
|
94
|
-
"sourceVersion": "0.2.
|
|
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.
|
|
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` |
|
package/docs/tutorials/README.md
CHANGED
|
@@ -23,12 +23,22 @@
|
|
|
23
23
|
|
|
24
24
|
## 1. 安装并重启正确的 profile
|
|
25
25
|
|
|
26
|
-
|
|
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. 只选一条连接路径
|