dsh-mcp-connector 0.2.73 → 0.2.74
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 +16 -0
- package/README.en.md +1 -1
- package/README.md +1 -1
- package/docs/FIRST-CONTRIBUTION.md +23 -0
- package/docs/screenshots/01-market-overview.jpg +0 -0
- package/docs/screenshots/02-connector-detail.jpg +0 -0
- package/docs/screenshots/04-json-import.jpg +0 -0
- package/docs/screenshots/07-connection-diagnostics.png +0 -0
- package/docs/screenshots/README.md +8 -7
- package/docs/screenshots/assets.json +22 -14
- package/docs/tutorials/JSON-MIGRATION.md +18 -1
- package/docs/tutorials/OAUTH-DIAGNOSTICS.md +13 -4
- package/docs/tutorials/README.md +15 -0
- package/docs/tutorials/TOOL-SEARCH-RECOVERY.md +14 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,22 @@
|
|
|
2
2
|
|
|
3
3
|
本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/);首个公开版本从 `0.1.0` 开始。
|
|
4
4
|
|
|
5
|
+
## [0.2.74] - 2026-10-16
|
|
6
|
+
|
|
7
|
+
### Added
|
|
8
|
+
|
|
9
|
+
- 加强 JSON 迁移、OAuth 首次成功和工具恢复教程:补充授权/费用/数据去向边界、三层成功判据、发布准备包与等长窗口复盘方法,并建立无需凭据的当前新手任务 #156。
|
|
10
|
+
- 增加当前发现缓存生命周期集成证据,覆盖同名工具 Schema 增删改、失败保留最后成功记录、恢复后重新发现及敏感默认值清理;该证据不宣称实现 #105 变更提醒,也不替代真实 Host UI 验收。
|
|
11
|
+
|
|
12
|
+
### Changed
|
|
13
|
+
|
|
14
|
+
- 从 0.2.73 隔离无凭据 harness 重采市场、OAuth 详情、JSON 导入和连接诊断素材,逐项登记版本、Mock 来源、尺寸与哈希;历史截图和 GIF 继续保留明确版本标识。
|
|
15
|
+
- 收窄 P3 数据源复核口径:协议初始化、工具枚举或元数据工具成功不再表述为业务数据验收;未验证结果字段、来源、时间范围、单位或缺失值的候选统一保持 `DEFERRED`,且本版本不新增 Registry 卡片。
|
|
16
|
+
|
|
17
|
+
### Verification
|
|
18
|
+
|
|
19
|
+
- 发布候选需通过 Node 20/22/24、Windows、Zod 4.1.8、PR 安装包、完整 `npm run check` 和发布文件白名单检查后,才允许创建 `v0.2.74` 标签。
|
|
20
|
+
|
|
5
21
|
## [0.2.73] - 2026-10-15
|
|
6
22
|
|
|
7
23
|
### Fixed
|
package/README.en.md
CHANGED
|
@@ -215,7 +215,7 @@ npm run dev:ui
|
|
|
215
215
|
|
|
216
216
|
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.
|
|
217
217
|
|
|
218
|
-
The current public version is [`dsh-mcp-connector@0.2.
|
|
218
|
+
The current public version is [`dsh-mcp-connector@0.2.74`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.74](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.74).
|
|
219
219
|
|
|
220
220
|
See [CHANGELOG.md](CHANGELOG.md) for version history and [docs/DESKTOP-E2E.md](docs/DESKTOP-E2E.md) for the Desktop release checklist.
|
|
221
221
|
|
package/README.md
CHANGED
|
@@ -210,7 +210,7 @@ npm run dev:ui
|
|
|
210
210
|
|
|
211
211
|
公共 Registry 每次合并后会生成 `catalog-stats.json`;本仓库的定时工作流每小时同步中英文介绍和统计快照。npm 页面中的静态正文随版本发布更新,上方动态统计徽标则直接读取 Registry,可在不发布新 npm 版本时保持实时数量一致。
|
|
212
212
|
|
|
213
|
-
当前公开版本为 [`dsh-mcp-connector@0.2.
|
|
213
|
+
当前公开版本为 [`dsh-mcp-connector@0.2.74`](https://www.npmjs.com/package/dsh-mcp-connector),对应 [GitHub Release v0.2.74](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.74)。
|
|
214
214
|
|
|
215
215
|
版本能力与变更记录见 [CHANGELOG.md](CHANGELOG.md)。
|
|
216
216
|
Desktop 发版回归见 [docs/DESKTOP-E2E.md](docs/DESKTOP-E2E.md)。
|
|
@@ -4,6 +4,8 @@
|
|
|
4
4
|
|
|
5
5
|
Welcome! Start with an unassigned [`good first issue`](https://github.com/duhu2000/dsh-mcp-connector/labels/good%20first%20issue). Leave a short comment before working on it so contributors do not duplicate effort.
|
|
6
6
|
|
|
7
|
+
> 2026-10-16 复核:原新手任务 [#29](https://github.com/duhu2000/dsh-mcp-connector/issues/29) 已完成并关闭;当前可认领任务是 [#156](https://github.com/duhu2000/dsh-mcp-connector/issues/156)。请以上面的动态标签页为准,并在 Issue 留言后再开始。
|
|
8
|
+
|
|
7
9
|
## 适合第一次参与的范围
|
|
8
10
|
|
|
9
11
|
- 中英文文档示例、安装或故障排查说明。
|
|
@@ -13,6 +15,27 @@ Welcome! Start with an unassigned [`good first issue`](https://github.com/duhu20
|
|
|
13
15
|
|
|
14
16
|
新的公共连接器描述不提交到本仓库,请改走独立 Registry 的[连接器上架指南](https://github.com/duhu2000/dsh-mcp-connector-registry/blob/main/docs/ONBOARDING.md)。
|
|
15
17
|
|
|
18
|
+
## 当前可认领的新手任务
|
|
19
|
+
|
|
20
|
+
**Issue [#156](https://github.com/duhu2000/dsh-mcp-connector/issues/156)**:`docs: 增加首次成功教程的本地链接校验`
|
|
21
|
+
|
|
22
|
+
背景:`docs/tutorials/*.md` 已经形成安装、JSON 迁移、OAuth、工具恢复和场景验收网络,但目前的文档门禁主要检查关键文案,还不会统一报告失效的本地 Markdown 链接。这个任务不需要 DSH、网络、真实连接器或凭据。
|
|
23
|
+
|
|
24
|
+
建议修改文件:
|
|
25
|
+
|
|
26
|
+
- 新增 `scripts/check-tutorial-links.mjs`,检查 `docs/tutorials/*.md` 中的相对文件链接。
|
|
27
|
+
- 在 `package.json` 增加独立命令,并把它接入 `npm run check`。
|
|
28
|
+
- 新增一个无网络测试,至少覆盖“有效相对链接”与“失效目标显示源文件和目标”。
|
|
29
|
+
|
|
30
|
+
验收标准:
|
|
31
|
+
|
|
32
|
+
- [ ] 只检查本地相对文件链接;忽略 `https://`、`mailto:` 和纯页内锚点,不发起网络请求。
|
|
33
|
+
- [ ] 正确处理 URL 编码、`#fragment` 和相对于源文件的路径。
|
|
34
|
+
- [ ] 失败信息精确到 `源文件 -> 目标`,方便首次贡献者修复。
|
|
35
|
+
- [ ] `npm run check` 通过,且不引入新的运行时依赖。
|
|
36
|
+
|
|
37
|
+
该 Issue 已带 `documentation` 和 `good first issue` 标签;不要求新手发版或修改 Registry。
|
|
38
|
+
|
|
16
39
|
## 从 Issue 到 PR
|
|
17
40
|
|
|
18
41
|
```bash
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
@@ -2,10 +2,11 @@
|
|
|
2
2
|
|
|
3
3
|
本目录保存 `dsh-mcp-connector` 的公开界面截图。所有素材均来自无凭据 UI harness:外层浏览器视口为 1280×720,harness 复刻 `lib/client.js` 中定义的 800px 产品面板,因此桌面端稳定为一行 2 张卡片。画面只展示公开目录元数据、示例 Prompt 和明确标识为 Mock 的工具数据,不包含 OAuth Token、API Key、本机路径、用户会话或查询结果。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
素材分为三组,避免把历史截图误写成当前版本:
|
|
6
6
|
|
|
7
|
-
- `01
|
|
8
|
-
- `
|
|
7
|
+
- `01`、`02`、`04` 和 `07` 是 2026-10-16 从 `v0.2.73` 隔离 UI harness 采集的当前 Mock 素材,分别展示市场、OAuth 连接器详情、JSON 导入和故障诊断。
|
|
8
|
+
- `03` 是 2026-09-06 从 `v0.2.37` 采集的历史工具发现快照。
|
|
9
|
+
- `05`、`06` 和 `../demo.gif` 是 2026-09-14 从 `v0.2.46` UI harness 采集的历史工具搜索、参数和演示素材。harness 中的目录数量、连接数量和工具数量属于测试夹具,不代表生产市场统计。
|
|
9
10
|
|
|
10
11
|
旧素材曾直接以 1280px 打开内部 iframe,绕过真实产品的 800px 宿主面板,因此触发 `auto-fill/minmax(300px)` 的 3 列布局;这是采集 harness/视口过期,不是产品 CSS 漂移。当前全部登记素材都从浏览器中的真实页面状态直接截取,没有后期重排卡片或修改连接状态。
|
|
11
12
|
|
|
@@ -13,13 +14,13 @@
|
|
|
13
14
|
|
|
14
15
|
| 文件 | 展示内容 |
|
|
15
16
|
|---|---|
|
|
16
|
-
| `01-market-overview.jpg` | `v0.2.
|
|
17
|
-
| `02-connector-detail.jpg` | `v0.2.
|
|
17
|
+
| `01-market-overview.jpg` | `v0.2.73` 当前 Mock 市场:800px 面板、桌面两列、推荐章节和 9 分类;未连接企查查卡片显示“连接” |
|
|
18
|
+
| `02-connector-detail.jpg` | `v0.2.73` 当前 Mock OAuth 连接器详情:权限边界、试用 Prompt 和未连接工具状态 |
|
|
18
19
|
| `03-tool-discovery.jpg` | `v0.2.37` Context7 无凭据 Mock 健康状态、Mock 工具数量/描述、搜索和独立滚动区 |
|
|
19
|
-
| `04-json-import.jpg` | `v0.2.
|
|
20
|
+
| `04-json-import.jpg` | `v0.2.73` 当前 Mock Streamable HTTP / stdio JSON 导入、格式化、作用域和本机凭据提示 |
|
|
20
21
|
| `05-unified-tool-search.png` | `v0.2.46` 统一工具搜索:跨连接结果、来源、发现失败和最后成功缓存 |
|
|
21
22
|
| `06-tool-parameters.png` | `v0.2.46` 参数详情:必填、类型、枚举、嵌套结构和原始安全 Schema |
|
|
22
|
-
| `07-connection-diagnostics.png` | `v0.2.
|
|
23
|
+
| `07-connection-diagnostics.png` | `v0.2.73` 当前 Mock 连接诊断:成功缓存、模拟网络与传输失败、建议、“检查连接”和“重新发现工具” |
|
|
23
24
|
|
|
24
25
|
`../demo.gif` 由 6 个真实浏览器状态顺序编码:市场、连接器详情、工具详情、统一搜索、参数 Schema、连接诊断。时长 43 秒,分辨率 960×540;编码只做等比例缩放和 GIF 调色,不改变布局或状态。
|
|
25
26
|
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 1,
|
|
3
3
|
"capture": {
|
|
4
|
-
"capturedOn": "2026-
|
|
5
|
-
"sourceVersion": "0.2.
|
|
4
|
+
"capturedOn": "2026-10-16",
|
|
5
|
+
"sourceVersion": "0.2.73",
|
|
6
6
|
"browserViewport": {
|
|
7
7
|
"width": 1280,
|
|
8
8
|
"height": 720
|
|
@@ -10,33 +10,41 @@
|
|
|
10
10
|
"productPanelWidth": 800,
|
|
11
11
|
"desktopCardColumns": 2,
|
|
12
12
|
"state": "credential-free-mock",
|
|
13
|
-
"preservedLegacyScreenshots":
|
|
14
|
-
"notes": "01
|
|
13
|
+
"preservedLegacyScreenshots": 1,
|
|
14
|
+
"notes": "01, 02, 04 and 07 were captured from the v0.2.73 credential-free UI harness on 2026-10-16; 03 preserves the 2026-09-06 v0.2.37 snapshot; 05, 06 and demo.gif preserve the 2026-09-14 v0.2.46 harness capture."
|
|
15
15
|
},
|
|
16
16
|
"screenshots": [
|
|
17
17
|
{
|
|
18
18
|
"path": "docs/screenshots/01-market-overview.jpg",
|
|
19
|
-
"sha256": "
|
|
19
|
+
"sha256": "2f681896cf8a6af274483d8e3a1b422062830d25373d088296641d7c65710900",
|
|
20
20
|
"width": 1280,
|
|
21
|
-
"height": 720
|
|
21
|
+
"height": 720,
|
|
22
|
+
"capturedOn": "2026-10-16",
|
|
23
|
+
"sourceVersion": "0.2.73"
|
|
22
24
|
},
|
|
23
25
|
{
|
|
24
26
|
"path": "docs/screenshots/02-connector-detail.jpg",
|
|
25
|
-
"sha256": "
|
|
27
|
+
"sha256": "388090d0aecbfde81973b4841401ab31c73c36d67b8939a2476ba59cf99b11b2",
|
|
26
28
|
"width": 1280,
|
|
27
|
-
"height": 720
|
|
29
|
+
"height": 720,
|
|
30
|
+
"capturedOn": "2026-10-16",
|
|
31
|
+
"sourceVersion": "0.2.73"
|
|
28
32
|
},
|
|
29
33
|
{
|
|
30
34
|
"path": "docs/screenshots/03-tool-discovery.jpg",
|
|
31
35
|
"sha256": "5eeb896db75a5f141a8463f128f7733ffe89af6a447cecb2d1b19f8287a3e1ec",
|
|
32
36
|
"width": 1280,
|
|
33
|
-
"height": 720
|
|
37
|
+
"height": 720,
|
|
38
|
+
"capturedOn": "2026-09-06",
|
|
39
|
+
"sourceVersion": "0.2.37"
|
|
34
40
|
},
|
|
35
41
|
{
|
|
36
42
|
"path": "docs/screenshots/04-json-import.jpg",
|
|
37
|
-
"sha256": "
|
|
43
|
+
"sha256": "72634174da158d39bdf796466cf3852b1fc4445fad1c17e2ee23e98a44ccaf1f",
|
|
38
44
|
"width": 1280,
|
|
39
|
-
"height": 720
|
|
45
|
+
"height": 720,
|
|
46
|
+
"capturedOn": "2026-10-16",
|
|
47
|
+
"sourceVersion": "0.2.73"
|
|
40
48
|
},
|
|
41
49
|
{
|
|
42
50
|
"path": "docs/screenshots/05-unified-tool-search.png",
|
|
@@ -56,11 +64,11 @@
|
|
|
56
64
|
},
|
|
57
65
|
{
|
|
58
66
|
"path": "docs/screenshots/07-connection-diagnostics.png",
|
|
59
|
-
"sha256": "
|
|
67
|
+
"sha256": "810ea245b4f41a850b99a6cd302b9f03b10bdb50498401635fdb16befe8d07e8",
|
|
60
68
|
"width": 1280,
|
|
61
69
|
"height": 720,
|
|
62
|
-
"capturedOn": "2026-
|
|
63
|
-
"sourceVersion": "0.2.
|
|
70
|
+
"capturedOn": "2026-10-16",
|
|
71
|
+
"sourceVersion": "0.2.73"
|
|
64
72
|
}
|
|
65
73
|
],
|
|
66
74
|
"demo": {
|
|
@@ -11,6 +11,15 @@
|
|
|
11
11
|
3. 对每个连接决定“当前项目”或“所有项目(全局)”。全局仅指当前 DSH profile,并非跨 profile 共享。
|
|
12
12
|
4. 在本机保存原配置的安全备份。不要把含 Token、API Key、Cookie 或本机路径的原文发到 Issue、聊天或公开仓库。
|
|
13
13
|
|
|
14
|
+
## 授权前提、费用与数据去向
|
|
15
|
+
|
|
16
|
+
| 连接类型 | 授权前提 | 费用确认 | 数据去向 |
|
|
17
|
+
|---|---|---|---|
|
|
18
|
+
| Streamable HTTP | 服务商要求的 Header/OAuth、账号权限和组织开通 | 在首次调用前查服务商套餐、配额和按次计费;插件无法代替服务商确认 | 工具参数发送到该 HTTP 端点,结果返回 DSH Host;以服务商隐私说明为准 |
|
|
19
|
+
| stdio | DSH 所在机器可运行可信 `command`,并具备该进程需要的本机权限/环境变量 | 本地进程本身可能免费,但它调用的上游服务仍可能计费 | 参数先进入本机进程;该进程是否继续上传必须查其自身文档,不得因 `stdio` 推断为纯离线 |
|
|
20
|
+
|
|
21
|
+
如任一项未确认,就在验收卡写“未知/待服务商确认”,不将真实业务数据用于试错。
|
|
22
|
+
|
|
14
23
|
## 导入一个最小示例
|
|
15
24
|
|
|
16
25
|
打开左侧“MCP连接器”(或“设置 → 插件 → 插件配置 → MCP连接器 → 打开 MCP连接器”),点击“+ 添加连接 → 导入 JSON”,在本机粘贴:
|
|
@@ -37,7 +46,13 @@
|
|
|
37
46
|
|
|
38
47
|
提交前确认目标范围,提交后在“已安装”查看连接。导入和启动失败时先看诊断;不要仅凭“列表里出现配置”判断可用。自定义 HTTP 会在保存前校验 MCP `initialize`;stdio 会等待 Host 首次初始化和工具同步。
|
|
39
48
|
|
|
40
|
-
##
|
|
49
|
+
## 可复现步骤与成功判据
|
|
50
|
+
|
|
51
|
+
1. 复制原配置的脱敏备份,记录迁移前的连接名、`serverName`、类型和预期工具;备份不入库。
|
|
52
|
+
2. 只导入一条受信连接,选定当前项目/全局范围并提交。预期:“已安装”出现同名连接,范围与启停状态正确。
|
|
53
|
+
3. 在“工具”页按连接筛选,核对预期工具、Server 和最近成功时间。预期:至少一个预期工具出现;如果仅有旧缓存,先按恢复教程重新发现。
|
|
54
|
+
4. 在正常 DSH 会话中经 Host 审批链调用一个已获准的只读工具。预期:返回与测试输入可辨认对应的结果,且未进行写入、发布、删除或未批准付费。
|
|
55
|
+
5. 记录三层结果、时间、插件版本与脱敏错误 code;不记录凭据和真实业务结果。
|
|
41
56
|
|
|
42
57
|
| 验收点 | 在哪里看 | 通过条件 |
|
|
43
58
|
|---|---|---|
|
|
@@ -47,6 +62,8 @@
|
|
|
47
62
|
|
|
48
63
|
前两项不能替代第三项;工具缓存可查也不证明服务此刻能调用。涉及付费、写入、删除等操作时,不要用它们做首次验收。
|
|
49
64
|
|
|
65
|
+
只有三层都通过,才能记录这条迁移的“首次成功”。任一层没有证据就保留“无数据/待验收”。
|
|
66
|
+
|
|
50
67
|
## 迁移后的维护与回退
|
|
51
68
|
|
|
52
69
|
- 在“已安装 → 编辑配置”可修改**自定义或 JSON 导入**连接的标准化单连接 JSON,并保存重连。这里不会恢复原 JSON 的排版/注释,也不能改 connection key 或 `serverName`。敏感值以 `<KEEP_EXISTING>` 表示本机保留,不要把真实值复制到聊天。
|
|
@@ -4,6 +4,12 @@
|
|
|
4
4
|
|
|
5
5
|
适用场景:市场卡片要求 OAuth 2.0 PKCE,但按钮显示“自动重试中”“需重新授权”或连接异常。OAuth 接入能力依赖服务商公开元数据、客户端注册、账号权限与网络条件;插件支持 OAuth 流程,不等于每个市场连接器都已对任意账号开放。
|
|
6
6
|
|
|
7
|
+
## 授权前提、费用与数据去向
|
|
8
|
+
|
|
9
|
+
授权前先核对:服务商是否允许公开客户端注册,是否要求企业套餐/管理员批准,本次 scope 是否仅覆盖验收所需的只读权限。记录服务商公布的免费额度或套餐;插件不能确认单次调用的实际费用时,写“未知/待服务商确认”。
|
|
10
|
+
|
|
11
|
+
授权时,浏览器会与服务商的授权端点通信;后续工具参数和结果会经 DSH Host 与目标 MCP Server 交换。不要因为回调在本机完成就宣称数据不出本机;具体保留和下游处理以服务商文档为准。
|
|
12
|
+
|
|
7
13
|
## 先看状态,而不是反复点击授权
|
|
8
14
|
|
|
9
15
|
1. 在“市场”或“已安装”找到对应连接,记录服务商名称、插件版本和按钮状态,不记录 Token/授权码。
|
|
@@ -23,11 +29,14 @@
|
|
|
23
29
|
|
|
24
30
|
只有页面明确显示“客户端注册被拒绝、尚未进入浏览器授权”时,才将问题定位到服务商注册政策;这不是用户 OAuth 登录失败。服务商可能要求登记客户端,不能靠重复尝试用户登录绕过。
|
|
25
31
|
|
|
26
|
-
##
|
|
32
|
+
## 可复现步骤与成功判据
|
|
27
33
|
|
|
28
|
-
1.
|
|
29
|
-
2.
|
|
30
|
-
3.
|
|
34
|
+
1. 在“市场”打开目标连接器,记录插件版本、连接器名、预期 scope 和开始时间,不记录 Token/授权码。
|
|
35
|
+
2. 发起一次授权,在服务商页面核对账号、组织和 scope 后确认。若没有进入浏览器而立即显示客户端注册 403,停止并按服务商政策处理。
|
|
36
|
+
3. 回到 DSH,检查连接诊断与最近观察时间。预期:不再是 `auth`/`refresh` 失败;多 Server 卡片没有未解决的“部分异常”。
|
|
37
|
+
4. 在当前工作区打开“工具”,确认对应连接/服务的预期只读工具被发现;若未选择 Workspace,只会显示全局连接。最后成功缓存可帮助定位,但不代表当前可调用。
|
|
38
|
+
5. 在正常 DSH 会话里,经 Host 审批链执行一个服务商许可的只读任务。预期:得到可辨认结果,且无写入、删除、发布或未批准付费。页面里的“检查连接/重新发现工具”不会执行目标工具。
|
|
39
|
+
6. 记录“授权”“工具注册”“业务调用”三个独立结果和时间;任一层缺证据就写“无数据/待验收”。
|
|
31
40
|
|
|
32
41
|
授权成功、工具注册成功和业务调用成功是三个不同结果。只有全部完成,才可说“首次使用通过”。不要用含真实业务数据、付费或有副作用的调用做公开演示。
|
|
33
42
|
|
package/docs/tutorials/README.md
CHANGED
|
@@ -4,6 +4,21 @@
|
|
|
4
4
|
|
|
5
5
|
需要可直接执行的验收任务时,选择[企业信息只读查询、本地智能文档解析、授权办公文档或日程查询](FIRST-SUCCESS-SCENARIOS.md)中的一个场景;记录状态时使用[可信状态文案规范](TRUSTED-STATUS-COPY.md),缺少账号、组织、费用或调用证据就明确写“未知/待验收”。
|
|
6
6
|
|
|
7
|
+
## 开始前先填一张验收卡
|
|
8
|
+
|
|
9
|
+
把下列内容记在本地工作笔记中,不要粘贴真实 Token、Cookie、授权码或客户数据。无法确认的字段保留“未知/待服务商确认”,不用推测补齐。
|
|
10
|
+
|
|
11
|
+
| 字段 | 要记录的内容 |
|
|
12
|
+
|---|---|
|
|
13
|
+
| 连接与范围 | 连接名、`serverName`、当前项目/全局、插件版本 |
|
|
14
|
+
| 授权前提 | 账号/组织资格、管理员批准、OAuth scope 或 API Key 权限 |
|
|
15
|
+
| 费用 | 免费额度、套餐/按次计费或“未知/待服务商确认” |
|
|
16
|
+
| 数据去向 | 仅本机进程,还是会向哪个远程服务发送哪些参数/文件 |
|
|
17
|
+
| 首次任务 | 一个已获准、只读、无敏感数据的具体任务 |
|
|
18
|
+
| 通过证据 | 配置、发现/注册、业务调用三层的独立结果与时间 |
|
|
19
|
+
|
|
20
|
+
三条任务教程都按这张卡验收:[JSON 迁移](JSON-MIGRATION.md)、[OAuth 首次成功](OAUTH-DIAGNOSTICS.md)、[工具发现与连接恢复](TOOL-SEARCH-RECOVERY.md)。
|
|
21
|
+
|
|
7
22
|
## 1. 安装并重启正确的 profile
|
|
8
23
|
|
|
9
24
|
当前默认安装布局中,DSH Desktop 和 `dsh web` 都从本机 `web` profile 加载插件,因此两种宿主都使用同一条安装命令;不要因为使用 Desktop 就把命令改成 `--profile desktop`。
|
|
@@ -4,6 +4,12 @@
|
|
|
4
4
|
|
|
5
5
|
适用场景:你已连接多个 MCP Server,想按任务找工具、看参数;或某条连接的最近发现失败,但仍需要判断工具曾经有哪些。本文不演示执行真实业务工具。
|
|
6
6
|
|
|
7
|
+
## 授权前提、费用与数据去向
|
|
8
|
+
|
|
9
|
+
工具搜索和筛选只读取当前范围的本机安全缓存,不执行目标工具,通常不会产生服务商调用费用。“检查连接”和“重新发现工具”会联系对应 MCP Server,需要有效的 OAuth/API Key/本地进程权限,并可能计入服务商请求配额。
|
|
10
|
+
|
|
11
|
+
搜索关键词、安全 Schema 缓存和诊断摘要保留在本机 DSH profile;检查/重新发现时会向目标 MCP Server 发送协议请求。真正工具调用的参数与数据去向另由该工具和服务商决定,必须在首次调用前单独确认。
|
|
12
|
+
|
|
7
13
|
## 先定位正确的工具
|
|
8
14
|
|
|
9
15
|
1. 在 DSH 选中目标 Workspace,再打开“MCP连接器 → 工具”。未选 Workspace 时仅能看到全局连接;项目连接不会越界显示。
|
|
@@ -23,7 +29,14 @@
|
|
|
23
29
|
|
|
24
30
|
后台发现最多并行处理两条连接。健康连接是**五分钟后到期**,不是精确每五分钟或永久实时轮询;普通失败指数退避,鉴权失败暂停自动重试。页面状态通知不等于持续健康探针。
|
|
25
31
|
|
|
26
|
-
##
|
|
32
|
+
## 可复现步骤与成功判据
|
|
33
|
+
|
|
34
|
+
1. 选择正确 Workspace,记录连接名、范围、预期工具名/关键词和开始时间。
|
|
35
|
+
2. 在“工具”页清空筛选后搜索,再依次加上连接、服务和发现状态筛选。预期:可解释结果是如何缩小的,且每条结果来源正确。
|
|
36
|
+
3. 打开参数详情,核对必填、类型、枚举和嵌套摘要。预期:能组成一个不含敏感数据的最小只读输入;缓存陈旧则先恢复。
|
|
37
|
+
4. 对异常连接先记录阶段/code/最后成功时间,再只执行页面建议的一个动作。预期:状态更新为当前时间,或给出可复核的稳定错误;不连续点击绕过限流。
|
|
38
|
+
5. 恢复发现后,回到正常 DSH 会话,经 Host 审批链执行最小只读调用。预期:得到与测试输入可辨认对应的结果,无写入、删除、发布或未批准付费。
|
|
39
|
+
6. 记录下表三层结果。只有调用层也通过才是“首次成功”;其余情况写“无数据/待验收”。
|
|
27
40
|
|
|
28
41
|
| 层次 | 你应看到什么 |
|
|
29
42
|
|---|---|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-mcp-connector",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.74",
|
|
4
4
|
"description": "DeepSeek Harness MCP Connector: connect servers, search tools across active connections, and troubleshoot discovery. Includes a continuously updated catalog; supports OAuth 2.0 PKCE, API keys, Streamable HTTP/stdio, and mcpServers JSON import.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "lib/index.js",
|