dsh-mcp-connector 0.2.102 → 0.2.104
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 +14 -0
- package/README.en.md +28 -9
- package/README.md +29 -10
- package/docs/PLUGIN-UPDATE.md +36 -2
- package/docs/USER-GUIDE.md +11 -1
- package/docs/screenshots/01-market-overview.jpg +0 -0
- package/docs/screenshots/02-connector-detail.jpg +0 -0
- package/docs/screenshots/03-tool-discovery.jpg +0 -0
- package/docs/screenshots/04-json-import.jpg +0 -0
- package/docs/screenshots/05-unified-tool-search.png +0 -0
- package/docs/screenshots/06-tool-parameters.png +0 -0
- package/docs/screenshots/07-connection-diagnostics.png +0 -0
- package/docs/screenshots/08-ten-recommendations.jpg +0 -0
- package/docs/screenshots/README.md +1 -1
- package/docs/screenshots/assets.json +29 -29
- 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 +29 -29
- 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 +428 -115
- package/lib/i18n/locales/en/client.js +20 -0
- package/lib/index.js +17 -3
- package/lib/settings.js +123 -0
- package/lib/version-status.js +23 -0
- package/package.json +3 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,19 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.2.104 - 2026-11-13
|
|
4
|
+
|
|
5
|
+
- 升级命令使用宿主提供的实际 profile,支持 Desktop、Web 和自定义名称;无法确认时显示更新指引,不再默认使用 `web`。
|
|
6
|
+
- 同步中英文升级提示和安装文档;手动升级命令旁不常驻展示 Desktop 专用长说明。
|
|
7
|
+
- 未取得 profile 名称时显示具体原因,客户选择默认 Web 或 Desktop 后才展示一条候选命令;已读取但不受支持的名称仅作文本展示,目标版本无效时单独说明版本问题。
|
|
8
|
+
- 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.
|
|
9
|
+
|
|
10
|
+
## 0.2.103
|
|
11
|
+
|
|
12
|
+
- npm 简介中的下载趋势图移到产品介绍之后;图表改为中文累计下载次数,保留真实统计区间和口径说明。
|
|
13
|
+
- 自动刷新图表时安装中文字体,保持中文单曲线展示。
|
|
14
|
+
- 包含已合并的插件入口位置设置与恢复默认行为优化(#227)。
|
|
15
|
+
- 重新生成本版本中英文产品截图与演示素材。
|
|
16
|
+
|
|
3
17
|
## 0.2.102
|
|
4
18
|
|
|
5
19
|
- 修复新版 DSH 中「试试这样用」发送失败的问题,按当前工作区准备会话草稿并跳转(#231,#232)。
|
package/README.en.md
CHANGED
|
@@ -1,9 +1,6 @@
|
|
|
1
1
|
# MCP Connector: a Specialist Data Marketplace for DeepSeek Harness
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
[](https://github.com/duhu2000/dsh-mcp-connector/blob/main/docs/metrics/npm-downloads.json)
|
|
5
|
-
npm downloads include upgrades, repeat installs and automation; they are not unique users or successful installs. The chart shows its UTC cutoff. [Install](#get-started) · [First successful connection](https://github.com/duhu2000/dsh-mcp-connector/blob/main/docs/tutorials/FIRST-SUCCESS-SCENARIOS.md)
|
|
6
|
-
<!-- npm-download-trend:end -->
|
|
3
|
+
|
|
7
4
|
|
|
8
5
|
> MCP Connector for DeepSeek Harness: a data marketplace connecting specialist providers and open data sources. Browse 100+ connectors, manage authorization, search tools and troubleshoot MCP connections.
|
|
9
6
|
|
|
@@ -43,14 +40,27 @@ Tool browsing does not execute target tools. Parameter summaries may omit comple
|
|
|
43
40
|
[](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/catalog-stats.json)
|
|
44
41
|
[](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/catalog-stats.json)
|
|
45
42
|
|
|
43
|
+
<!-- npm-download-trend:start -->
|
|
44
|
+
[](https://github.com/duhu2000/dsh-mcp-connector/blob/main/docs/metrics/npm-downloads.json)
|
|
45
|
+
npm downloads include upgrades, repeat installs and automation; they are not unique users or successful installs. The chart shows its UTC cutoff. [Install](#get-started) · [First successful connection](https://github.com/duhu2000/dsh-mcp-connector/blob/main/docs/tutorials/FIRST-SUCCESS-SCENARIOS.md)
|
|
46
|
+
<!-- npm-download-trend:end -->
|
|
47
|
+
|
|
46
48
|
## Get started
|
|
47
49
|
|
|
48
|
-
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:
|
|
49
57
|
|
|
50
58
|
```bash
|
|
51
59
|
dsh plugin --profile web add dsh-mcp-connector
|
|
52
60
|
```
|
|
53
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
|
+
|
|
54
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**.
|
|
55
65
|
|
|
56
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.
|
|
@@ -119,17 +129,22 @@ As of 2026-10-24, the public Registry publishes 112 connector descriptors. After
|
|
|
119
129
|
| Connection diagnostics and last-success cache | |
|
|
120
130
|
|  | |
|
|
121
131
|
|
|
122
|
-
<!-- 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.104 (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 -->
|
|
123
133
|
|
|
124
134
|
## Installation
|
|
125
135
|
|
|
126
136
|
Requirements: DeepSeek Harness Desktop or web profile, and Node.js 20 or later.
|
|
127
137
|
|
|
138
|
+
Desktop requires its own CLI and must be initialized and fully quit before installation. Default Web uses `web`:
|
|
139
|
+
|
|
128
140
|
```bash
|
|
141
|
+
# Desktop-provided CLI
|
|
142
|
+
dsh plugin --profile desktop add dsh-mcp-connector
|
|
143
|
+
# Default Web
|
|
129
144
|
dsh plugin --profile web add dsh-mcp-connector
|
|
130
145
|
```
|
|
131
146
|
|
|
132
|
-
|
|
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):
|
|
133
148
|
|
|
134
149
|
```bash
|
|
135
150
|
bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/main/install.sh)
|
|
@@ -198,7 +213,11 @@ Remote catalog requests (including the fallback source) honor `HTTP_PROXY`, `HTT
|
|
|
198
213
|
|
|
199
214
|
The proxy variables must be present in the running DSH process. After changing them, fully exit and restart DSH Desktop or launch `dsh web` from a shell with those variables set; changing Windows user environment variables does not update an already-running process. The connector does not read OS proxy settings or infer a local proxy address.
|
|
200
215
|
|
|
201
|
-
`
|
|
216
|
+
`entryLocation` controls where the entry appears: `both` (default — the sidebar icon and the Settings quick-open button both work), `sidebar` (sidebar icon only; Settings does not offer an open button), or `settings` (hide the sidebar icon and enter from Settings only). Every value keeps at least one entry so the panel never becomes unreachable. Invalid values passed to the plugin configuration are rejected by the schema rather than silently accepted.
|
|
217
|
+
|
|
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.
|
|
219
|
+
|
|
220
|
+
`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.
|
|
202
221
|
|
|
203
222
|
`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:
|
|
204
223
|
|
|
@@ -250,7 +269,7 @@ npm run dev:ui
|
|
|
250
269
|
|
|
251
270
|
Every Registry merge regenerates `catalog-stats.json`; an hourly workflow in this repository synchronizes the Chinese and English product copy plus a local stats snapshot. The static npm README updates with package releases, while the live badges above read the Registry directly and therefore stay current without another npm release.
|
|
252
271
|
|
|
253
|
-
<!-- generated:version -->The current public version is [`dsh-mcp-connector@0.2.
|
|
272
|
+
<!-- generated:version -->The current public version is [`dsh-mcp-connector@0.2.104`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.104](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.104).<!-- /generated:version -->
|
|
254
273
|
|
|
255
274
|
See [CHANGELOG.md](CHANGELOG.md) for version history and [docs/DESKTOP-E2E.md](docs/DESKTOP-E2E.md) for the Desktop release checklist.
|
|
256
275
|
|
package/README.md
CHANGED
|
@@ -1,9 +1,6 @@
|
|
|
1
1
|
# MCP连接器:DeepSeek Harness 的专业数据源市场
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
[](https://github.com/duhu2000/dsh-mcp-connector/blob/main/docs/metrics/npm-downloads.json)
|
|
5
|
-
npm 下载次数包含升级、重复安装及自动化下载,不等于独立用户数或成功安装数;数据截止日期见图中 UTC 标注。[安装使用](#开始使用) · [首次成功教程](docs/tutorials/FIRST-SUCCESS-SCENARIOS.md)
|
|
6
|
-
<!-- npm-download-trend:end -->
|
|
3
|
+
|
|
7
4
|
|
|
8
5
|
> DeepSeek Harness 的 MCP 数据市场:汇聚各类垂直领域数据厂商与开放数据源,通过超百个 MCP连接器接入 MCP Server,统一授权、查找工具与连接排障。
|
|
9
6
|
|
|
@@ -19,7 +16,7 @@ OAuth 是否可用取决于服务商的客户端注册、账号权限与授权
|
|
|
19
16
|
|
|
20
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.
|
|
21
18
|
|
|
22
|
-
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.
|
|
23
20
|
|
|
24
21
|

|
|
25
22
|
|
|
@@ -55,14 +52,27 @@ Install with `dsh plugin --profile web add dsh-mcp-connector`, then select **EN*
|
|
|
55
52
|
[](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/catalog-stats.json)
|
|
56
53
|
[](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/catalog-stats.json)
|
|
57
54
|
|
|
55
|
+
<!-- npm-download-trend:start -->
|
|
56
|
+
[](https://github.com/duhu2000/dsh-mcp-connector/blob/main/docs/metrics/npm-downloads.json)
|
|
57
|
+
npm 下载次数包含升级、重复安装及自动化下载,不等于独立用户数或成功安装数;数据截止日期见图中 UTC 标注。[安装使用](#开始使用) · [首次成功教程](docs/tutorials/FIRST-SUCCESS-SCENARIOS.md)
|
|
58
|
+
<!-- npm-download-trend:end -->
|
|
59
|
+
|
|
58
60
|
## 开始使用
|
|
59
61
|
|
|
60
|
-
在插件市场搜索完整包名 **`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 使用:
|
|
61
69
|
|
|
62
70
|
```bash
|
|
63
71
|
dsh plugin --profile web add dsh-mcp-connector
|
|
64
72
|
```
|
|
65
73
|
|
|
74
|
+
自定义部署请替换 profile 名称;设置了 `DSH_HOME` 时,终端须沿用与宿主相同的值。npm 安装的 CLI 可能拒绝管理 `desktop`,此时应使用 Desktop 配套 CLI。
|
|
75
|
+
|
|
66
76
|
安装或升级后完全重启 DeepSeek Harness Desktop 或 `dsh web`,然后打开左侧「MCP连接器」;也可从“设置 → 插件 → 插件配置 → MCP连接器”直接打开。
|
|
67
77
|
|
|
68
78
|
Desktop 需要完全退出并重新启动应用;Web 需要停止原 `dsh web` 进程再启动,只刷新网页不会重新加载后端插件。
|
|
@@ -133,17 +143,22 @@ Desktop 需要完全退出并重新启动应用;Web 需要停止原 `dsh web`
|
|
|
133
143
|
| 连接诊断与最后成功缓存 | |
|
|
134
144
|
|  | |
|
|
135
145
|
|
|
136
|
-
<!-- generated:media -->截图与 GIF 采集自 v0.2.
|
|
146
|
+
<!-- generated:media -->截图与 GIF 采集自 v0.2.104(2026-11-13)无凭据 Mock 页面,展示界面而非真实业务验收;市场数量是测试夹具。来源与更新方法见 [素材说明](docs/screenshots/README.md)。<!-- /generated:media -->
|
|
137
147
|
|
|
138
148
|
## 安装
|
|
139
149
|
|
|
140
150
|
要求:DeepSeek Harness Desktop/web profile,Node.js 20 或更高版本。
|
|
141
151
|
|
|
152
|
+
Desktop 使用配套 CLI,初始化后完全退出应用再安装;默认 Web 使用 `web`:
|
|
153
|
+
|
|
142
154
|
```bash
|
|
155
|
+
# Desktop 配套 CLI
|
|
156
|
+
dsh plugin --profile desktop add dsh-mcp-connector
|
|
157
|
+
# 默认 Web
|
|
143
158
|
dsh plugin --profile web add dsh-mcp-connector
|
|
144
159
|
```
|
|
145
160
|
|
|
146
|
-
|
|
161
|
+
自定义部署以实际 profile 为准,并在终端沿用宿主的 `DSH_HOME`。默认 Web 也可使用安装脚本(其他 profile 需设置 `DSH_PROFILE`):
|
|
147
162
|
|
|
148
163
|
```bash
|
|
149
164
|
bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-mcp-connector/main/install.sh)
|
|
@@ -206,7 +221,11 @@ Bundle 默认配置位于 `cordis.patch.yml`:
|
|
|
206
221
|
|
|
207
222
|
代理变量必须存在于正在运行的 DSH 进程中。修改后请完全退出并重启 DSH Desktop,或从已设置变量的终端启动 `dsh web`;修改 Windows 用户环境变量不会更新已有进程。连接器不会读取系统代理设置,也不会猜测本机代理地址。
|
|
208
223
|
|
|
209
|
-
`
|
|
224
|
+
`entryLocation` 控制入口出现在哪里,取值为 `both`(默认:侧栏图标与设置页的快捷打开按钮都可用)、`sidebar`(只保留侧栏图标,设置页不提供打开按钮)、或 `settings`(隐藏侧栏图标,只从设置页进入)。三档都至少保留一处入口,避免面板变得无法打开。传给插件配置的非法值会被 schema 拒绝,而不是静默接受。
|
|
225
|
+
|
|
226
|
+
从旧版升级时,若设置文档里只有 `showSidebarEntry` 而没有 `entryLocation`,插件按旧字段的实际行为翻译:`true` → `both`(旧版侧栏可见、设置页也有打开按钮),`false` → `settings`。这样升级既不会悄悄删掉既有入口,也不会让隐藏过的侧栏重新出现。分层解析中用户自己的覆盖优先于部署基线;「恢复默认」会同时清掉新字段与旧的布尔覆盖。
|
|
227
|
+
|
|
228
|
+
`showSidebarEntry` 默认为 `true`,为兼容既有配置保留;一旦显式设置 `entryLocation`,它不再影响界面。关闭入口只隐藏快捷方式,不停用连接器、已连接 MCP Server 或工具。
|
|
210
229
|
|
|
211
230
|
`compactManagementTools` 默认为 `false`,兼容原有对话管理工具。希望降低管理工具上下文开销时,可在插件配置中设为 `true` 并重载插件(必要时重启 DSH),下一次推理使用新工具集:
|
|
212
231
|
|
|
@@ -257,7 +276,7 @@ npm run dev:ui
|
|
|
257
276
|
|
|
258
277
|
公共 Registry 每次合并后会生成 `catalog-stats.json`;本仓库的定时工作流每小时同步中英文介绍和统计快照。npm 页面中的静态正文随版本发布更新,上方动态统计徽标则直接读取 Registry,可在不发布新 npm 版本时保持实时数量一致。
|
|
259
278
|
|
|
260
|
-
<!-- generated:version -->当前公开版本为 [`dsh-mcp-connector@0.2.
|
|
279
|
+
<!-- generated:version -->当前公开版本为 [`dsh-mcp-connector@0.2.104`](https://www.npmjs.com/package/dsh-mcp-connector),对应 [GitHub Release v0.2.104](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.104)。<!-- /generated:version -->
|
|
261
280
|
|
|
262
281
|
版本能力与变更记录见 [CHANGELOG.md](CHANGELOG.md)。
|
|
263
282
|
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)
|
|
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.104 于 2026-11-13 重新采集,未修改截图中的版本文字。<!-- /generated:media -->
|
|
4
4
|
|
|
5
5
|
前七张素材由真实产品 UI 的无凭据 Mock harness 渲染:1280×720 浏览器视口、800px 产品面板、桌面两列卡片。顶部保留“无凭据 Mock”标识;目录数、连接数与工具数是演示夹具,不代表生产统计或真实授权、业务验收。不会读取用户 profile、调用服务商或上传业务数据。
|
|
6
6
|
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
"schemaVersion": 1,
|
|
3
3
|
"capture": {
|
|
4
4
|
"locale": "zh-CN",
|
|
5
|
-
"capturedOn": "2026-11-
|
|
6
|
-
"sourceVersion": "0.2.
|
|
5
|
+
"capturedOn": "2026-11-13",
|
|
6
|
+
"sourceVersion": "0.2.104",
|
|
7
7
|
"sourceFingerprint": "4d8135cd206dcb890002f8dee5b64bd1664806d68b1b9e5393743d47b1a5aa8b",
|
|
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": "
|
|
20
|
+
"sha256": "c140d1e3ffb0b2bfe71801c5ff12320aec7c47f651c21cb669c6cacd52ce1fe3",
|
|
21
21
|
"width": 1280,
|
|
22
22
|
"height": 720,
|
|
23
|
-
"capturedOn": "2026-11-
|
|
24
|
-
"sourceVersion": "0.2.
|
|
23
|
+
"capturedOn": "2026-11-13",
|
|
24
|
+
"sourceVersion": "0.2.104"
|
|
25
25
|
},
|
|
26
26
|
{
|
|
27
27
|
"path": "docs/screenshots/02-connector-detail.jpg",
|
|
28
|
-
"sha256": "
|
|
28
|
+
"sha256": "06e789c5c44a5973a59df7f1b9176738b1a7e291120b006b2aca80cdc110435f",
|
|
29
29
|
"width": 1280,
|
|
30
30
|
"height": 720,
|
|
31
|
-
"capturedOn": "2026-11-
|
|
32
|
-
"sourceVersion": "0.2.
|
|
31
|
+
"capturedOn": "2026-11-13",
|
|
32
|
+
"sourceVersion": "0.2.104"
|
|
33
33
|
},
|
|
34
34
|
{
|
|
35
35
|
"path": "docs/screenshots/03-tool-discovery.jpg",
|
|
36
|
-
"sha256": "
|
|
36
|
+
"sha256": "a425170deb947873d9a6811e6367e0b016c5f9eec357902cda420c987cc908d9",
|
|
37
37
|
"width": 1280,
|
|
38
38
|
"height": 720,
|
|
39
|
-
"capturedOn": "2026-11-
|
|
40
|
-
"sourceVersion": "0.2.
|
|
39
|
+
"capturedOn": "2026-11-13",
|
|
40
|
+
"sourceVersion": "0.2.104"
|
|
41
41
|
},
|
|
42
42
|
{
|
|
43
43
|
"path": "docs/screenshots/04-json-import.jpg",
|
|
44
|
-
"sha256": "
|
|
44
|
+
"sha256": "8e90bc1cbe338ebac2d227456f4cd7fdc15a5e4545966335faf4cecd916fe47f",
|
|
45
45
|
"width": 1280,
|
|
46
46
|
"height": 720,
|
|
47
|
-
"capturedOn": "2026-11-
|
|
48
|
-
"sourceVersion": "0.2.
|
|
47
|
+
"capturedOn": "2026-11-13",
|
|
48
|
+
"sourceVersion": "0.2.104"
|
|
49
49
|
},
|
|
50
50
|
{
|
|
51
51
|
"path": "docs/screenshots/05-unified-tool-search.png",
|
|
52
|
-
"sha256": "
|
|
52
|
+
"sha256": "1b22923925f1d8d564cb0c4f449caddcc2010efdb80bdae9da20906217d07945",
|
|
53
53
|
"width": 1280,
|
|
54
54
|
"height": 720,
|
|
55
|
-
"capturedOn": "2026-11-
|
|
56
|
-
"sourceVersion": "0.2.
|
|
55
|
+
"capturedOn": "2026-11-13",
|
|
56
|
+
"sourceVersion": "0.2.104"
|
|
57
57
|
},
|
|
58
58
|
{
|
|
59
59
|
"path": "docs/screenshots/06-tool-parameters.png",
|
|
60
|
-
"sha256": "
|
|
60
|
+
"sha256": "20dcb0804c161a9cb5bacbf6fab5b5541d4f883530871eb5196660d990931c1e",
|
|
61
61
|
"width": 1280,
|
|
62
62
|
"height": 720,
|
|
63
|
-
"capturedOn": "2026-11-
|
|
64
|
-
"sourceVersion": "0.2.
|
|
63
|
+
"capturedOn": "2026-11-13",
|
|
64
|
+
"sourceVersion": "0.2.104"
|
|
65
65
|
},
|
|
66
66
|
{
|
|
67
67
|
"path": "docs/screenshots/07-connection-diagnostics.png",
|
|
68
|
-
"sha256": "
|
|
68
|
+
"sha256": "9fa6338cf3b3a92c9159d3de5aa5f7ad7e203c4851f7fc68e6801de48f00f920",
|
|
69
69
|
"width": 1280,
|
|
70
70
|
"height": 720,
|
|
71
|
-
"capturedOn": "2026-11-
|
|
72
|
-
"sourceVersion": "0.2.
|
|
71
|
+
"capturedOn": "2026-11-13",
|
|
72
|
+
"sourceVersion": "0.2.104"
|
|
73
73
|
},
|
|
74
74
|
{
|
|
75
75
|
"path": "docs/screenshots/08-ten-recommendations.jpg",
|
|
76
|
-
"sha256": "
|
|
76
|
+
"sha256": "25d5ec342c5d62952eab03412737d3535d284f597f0276efa25cb2046b6452d5",
|
|
77
77
|
"width": 1280,
|
|
78
78
|
"height": 1400,
|
|
79
79
|
"browserViewport": {
|
|
@@ -81,17 +81,17 @@
|
|
|
81
81
|
"height": 1400
|
|
82
82
|
},
|
|
83
83
|
"panelHeight": 1280,
|
|
84
|
-
"capturedOn": "2026-11-
|
|
85
|
-
"sourceVersion": "0.2.
|
|
84
|
+
"capturedOn": "2026-11-13",
|
|
85
|
+
"sourceVersion": "0.2.104"
|
|
86
86
|
}
|
|
87
87
|
],
|
|
88
88
|
"demo": {
|
|
89
89
|
"path": "docs/demo.gif",
|
|
90
|
-
"sha256": "
|
|
90
|
+
"sha256": "57c9c582b34357e3ae458b61ed7b66fb6a239e9561feb24ab718d9c29721bfe7",
|
|
91
91
|
"width": 960,
|
|
92
92
|
"height": 540,
|
|
93
|
-
"capturedOn": "2026-11-
|
|
94
|
-
"sourceVersion": "0.2.
|
|
93
|
+
"capturedOn": "2026-11-13",
|
|
94
|
+
"sourceVersion": "0.2.104",
|
|
95
95
|
"durationSeconds": 36
|
|
96
96
|
}
|
|
97
97
|
}
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
"schemaVersion": 1,
|
|
3
3
|
"capture": {
|
|
4
4
|
"locale": "en",
|
|
5
|
-
"capturedOn": "2026-11-
|
|
6
|
-
"sourceVersion": "0.2.
|
|
5
|
+
"capturedOn": "2026-11-13",
|
|
6
|
+
"sourceVersion": "0.2.104",
|
|
7
7
|
"sourceFingerprint": "4d8135cd206dcb890002f8dee5b64bd1664806d68b1b9e5393743d47b1a5aa8b",
|
|
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": "
|
|
20
|
+
"sha256": "5001a3d0c903645769eebe65a411153a8fa29ae71968011facf18df393661768",
|
|
21
21
|
"width": 1280,
|
|
22
22
|
"height": 720,
|
|
23
|
-
"capturedOn": "2026-11-
|
|
24
|
-
"sourceVersion": "0.2.
|
|
23
|
+
"capturedOn": "2026-11-13",
|
|
24
|
+
"sourceVersion": "0.2.104"
|
|
25
25
|
},
|
|
26
26
|
{
|
|
27
27
|
"path": "docs/screenshots/en/02-connector-detail.jpg",
|
|
28
|
-
"sha256": "
|
|
28
|
+
"sha256": "bd3f15cbc57989a6b3cc575b8e0be395870ccff6a0895f20d29b92f9351b46a1",
|
|
29
29
|
"width": 1280,
|
|
30
30
|
"height": 720,
|
|
31
|
-
"capturedOn": "2026-11-
|
|
32
|
-
"sourceVersion": "0.2.
|
|
31
|
+
"capturedOn": "2026-11-13",
|
|
32
|
+
"sourceVersion": "0.2.104"
|
|
33
33
|
},
|
|
34
34
|
{
|
|
35
35
|
"path": "docs/screenshots/en/03-tool-discovery.jpg",
|
|
36
|
-
"sha256": "
|
|
36
|
+
"sha256": "b3fa8dfd2e13e09c8b5e316e907cb9ce7c52043bb273d9c46db9465f06a5eed3",
|
|
37
37
|
"width": 1280,
|
|
38
38
|
"height": 720,
|
|
39
|
-
"capturedOn": "2026-11-
|
|
40
|
-
"sourceVersion": "0.2.
|
|
39
|
+
"capturedOn": "2026-11-13",
|
|
40
|
+
"sourceVersion": "0.2.104"
|
|
41
41
|
},
|
|
42
42
|
{
|
|
43
43
|
"path": "docs/screenshots/en/04-json-import.jpg",
|
|
44
|
-
"sha256": "
|
|
44
|
+
"sha256": "c51464f0a99f9cd861bb85f0af9f48c2e44ea5fb7dedb5c9aa55edf97a2ae40a",
|
|
45
45
|
"width": 1280,
|
|
46
46
|
"height": 720,
|
|
47
|
-
"capturedOn": "2026-11-
|
|
48
|
-
"sourceVersion": "0.2.
|
|
47
|
+
"capturedOn": "2026-11-13",
|
|
48
|
+
"sourceVersion": "0.2.104"
|
|
49
49
|
},
|
|
50
50
|
{
|
|
51
51
|
"path": "docs/screenshots/en/05-unified-tool-search.png",
|
|
52
|
-
"sha256": "
|
|
52
|
+
"sha256": "1837a356d4fa1c8db03ea3665b38518c263c629d1c15315137e785189debdf69",
|
|
53
53
|
"width": 1280,
|
|
54
54
|
"height": 720,
|
|
55
|
-
"capturedOn": "2026-11-
|
|
56
|
-
"sourceVersion": "0.2.
|
|
55
|
+
"capturedOn": "2026-11-13",
|
|
56
|
+
"sourceVersion": "0.2.104"
|
|
57
57
|
},
|
|
58
58
|
{
|
|
59
59
|
"path": "docs/screenshots/en/06-tool-parameters.png",
|
|
60
|
-
"sha256": "
|
|
60
|
+
"sha256": "8637812369a3fc1e0af445fd8604d72e3367ec37b939d83684224b48b78b1407",
|
|
61
61
|
"width": 1280,
|
|
62
62
|
"height": 720,
|
|
63
|
-
"capturedOn": "2026-11-
|
|
64
|
-
"sourceVersion": "0.2.
|
|
63
|
+
"capturedOn": "2026-11-13",
|
|
64
|
+
"sourceVersion": "0.2.104"
|
|
65
65
|
},
|
|
66
66
|
{
|
|
67
67
|
"path": "docs/screenshots/en/07-connection-diagnostics.png",
|
|
68
|
-
"sha256": "
|
|
68
|
+
"sha256": "b2f601c2d6d83b575da7a046a4acc49f73182c05dfd157a2562115f6e7f84c8c",
|
|
69
69
|
"width": 1280,
|
|
70
70
|
"height": 720,
|
|
71
|
-
"capturedOn": "2026-11-
|
|
72
|
-
"sourceVersion": "0.2.
|
|
71
|
+
"capturedOn": "2026-11-13",
|
|
72
|
+
"sourceVersion": "0.2.104"
|
|
73
73
|
},
|
|
74
74
|
{
|
|
75
75
|
"path": "docs/screenshots/en/08-ten-recommendations.jpg",
|
|
76
|
-
"sha256": "
|
|
76
|
+
"sha256": "dc27a1c85c01774b34d7d2840cb41d14046f5bfb1d28a487d5896e006ad63bfb",
|
|
77
77
|
"width": 1280,
|
|
78
78
|
"height": 1400,
|
|
79
79
|
"browserViewport": {
|
|
@@ -81,17 +81,17 @@
|
|
|
81
81
|
"height": 1400
|
|
82
82
|
},
|
|
83
83
|
"panelHeight": 1280,
|
|
84
|
-
"capturedOn": "2026-11-
|
|
85
|
-
"sourceVersion": "0.2.
|
|
84
|
+
"capturedOn": "2026-11-13",
|
|
85
|
+
"sourceVersion": "0.2.104"
|
|
86
86
|
}
|
|
87
87
|
],
|
|
88
88
|
"demo": {
|
|
89
89
|
"path": "docs/screenshots/en/demo.gif",
|
|
90
|
-
"sha256": "
|
|
90
|
+
"sha256": "df36467aaa4b9d0fe4e1bbb96a4dcdfad1e37fa701f0f8e6d0287c9c90c923a7",
|
|
91
91
|
"width": 960,
|
|
92
92
|
"height": 540,
|
|
93
|
-
"capturedOn": "2026-11-
|
|
94
|
-
"sourceVersion": "0.2.
|
|
93
|
+
"capturedOn": "2026-11-13",
|
|
94
|
+
"sourceVersion": "0.2.104",
|
|
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.104`<!-- /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. 只选一条连接路径
|