dsh-mcp-connector 0.2.69 → 0.2.71

package/CHANGELOG.md

@@ -2,7 +2,38 @@
 
 本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)；首个公开版本从 `0.1.0` 开始。
 
-## [Unreleased]
+## [0.2.71] - 2026-10-14
+
+### Added
+
+- 目录新增 HTTP Server 的 `servers[].oauthResource`：MCP URL 需要携带查询参数（如 `?tools=`）时，OAuth 的 `resource` 授权参数、`grant.authorizedResources` 与刷新参数改用规范资源标识，实际请求仍使用带查询参数的 `url`，避免刷新被授权服务器按 `invalid_target` 拒绝。仅 `oauth2-pkce` 卡片可声明，且必须与 `url` 同源。
+- Registry 种子新增“Exa·网络搜索”第三方卡片（`registry/connectors/exa-search.json`）：OAuth 一键授权接入 Exa 官方远程 MCP，覆盖语义搜索、全文抓取、高级检索与多步研究 Agent。
+
+### Fixed
+
+- 修复 Windows 钉钉 CLI 包 bin 字段带 ./ 前缀时无法发现原生程序；精确匹配的旧受管桥接命令在运行时更新到 0.2.71，不覆盖自定义参数。
+- 原生确认框改为页面内对话框，取消默认聚焦且 Enter 尊重焦点，避免误确认和桌面失焦。
+- 已安装列表状态刷新保留滚动位置，回归测试抽取失败时显式报错。
+- 远程目录请求支持 HTTP_PROXY / HTTPS_PROXY / NO_PROXY，不修改宿主全局代理。
+- 桌面嵌入 CSP 允许显式配置可信祖先源，默认仍为 self。
+- 重连与同一连接的停用、删除、修改串行执行；多 Server 注册等待并行，失败明确区分保留配置与 Host 状态。
+
+- `normalizeConnectorDescriptor` 不再静默丢弃 HTTP Server 上的 `oauthResource` / `oauthTokenEnv`：前者现在生效，后者由目录审计显式拒绝，描述文件作者不会在无任何报错的情况下被忽略。
+- 「已安装」页为未处于“已连接”的连接提供「重新连接」：重建 Host 侧条目并在有界时间内等待 stdio 工具重新注册，不修改配置、凭据、范围或注入模式；对话工具同步新增 `mcp_connector_reconnect`。
+
+### Changed
+
+- 「检测旧插件」改名为「检测企查查旧授权」，并说明扫描范围与“不会删除旧插件或原凭据”。
+
+- 桌面宿主（Electron 内嵌 DSH）下启动 stdio 连接不再必然失败：以 `process.execPath` 启动守卫时注入 `ELECTRON_RUN_AS_NODE`，守卫再把该变量从真实 server 的子进程环境中移除（0.2.70 的 #130 只覆盖了 CLI 宿主）。
+
+## [0.2.70] - 2026-10-08
+
+### Fixed
+
+- Windows 启动恢复保护采用 cross-spawn 解析 PATH/PATHEXT 与 npm .cmd shim，修复 npx 连接手动成功但重启失败的问题（#130）。
+- 命令缺失时返回不含命令、参数或凭据的 ENOENT 与 PATH 检查提示。
+- 新增 Windows 真实 .cmd 子进程回归，覆盖带空格路径与特殊字符参数。
 
 ## [0.2.69] - 2026-10-08
 

package/README.en.md

@@ -167,12 +167,25 @@ The default bundle configuration is in `cordis.patch.yml`:
     refreshSkewMs: 300000
     openBrowser: true
     showSidebarEntry: true
+    frameAncestors: ['self']
 ```
 
 Set `catalogUrl` to an empty string for an explicitly offline/private setup. A custom non-default URL is used as-is and does not fall back to the public registry.
 
+Remote catalog requests (including the fallback source) honor `HTTP_PROXY`, `HTTPS_PROXY`, and `NO_PROXY`, as well as their lowercase forms. A lowercase variable takes precedence when both forms are present; HTTPS uses `HTTP_PROXY` when `HTTPS_PROXY` is absent. Use an HTTP(S) proxy URL and configure `NO_PROXY` for destinations that should connect directly (for example, `localhost,127.0.0.1`). This works on Node.js 20+ without `--use-env-proxy` and does not change the Host's global fetch dispatcher or MCP transport settings.
+
+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.
+
 `showSidebarEntry` defaults to `true`. Users can override it from the DSH plugin configuration page; turning it off hides only the shortcut and does not disable the connector, connected MCP servers, or tools.
 
+`frameAncestors` defaults to `['self']`: the CSP of the panel page (`/mcp-connector/ui/`) only allows same-origin embedding, which is the existing behaviour and is not relaxed by default. When a desktop shell (Tauri/Electron) embeds the panel, the ancestor origin differs from the panel origin, so the browser blocks it with `Framing '...' violates the following Content Security Policy directive: "frame-ancestors 'self'"` and the panel renders blank. Deployers must opt in explicitly:
+
+```yaml
+frameAncestors: ['self', 'http://tauri.localhost', 'tauri://localhost']
+```
+
+This is a deliberate security trade-off, not an oversight: `frame-ancestors` cannot verify who owns the embedding origin, so the plugin never hardcodes a shell origin such as Tauri — listing one lets any page served from that origin frame the local panel. Accepted values are CSP keywords (`self` / `none` / `*`) and host-sources (`https://*.example.com`, `127.0.0.1:3080`, `tauri://localhost`, `http://tauri.localhost:1420`, optionally with scheme, port, and path). Values containing `;`, commas, spaces, or non-host-source keywords such as `'unsafe-inline'` are dropped entirely to prevent CSP header injection; if nothing valid remains the list falls back to `['self']` rather than allowing every origin. Only add origins you trust.
+
 ## Compatibility and responsibility boundary
 
 | Area | Current boundary |
@@ -202,7 +215,7 @@ npm run dev:ui
 
 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.
 
-The current public version is [`dsh-mcp-connector@0.2.69`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.69](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.69).
+The current public version is [`dsh-mcp-connector@0.2.71`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.71](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.71).
 
 See [CHANGELOG.md](CHANGELOG.md) for version history and [docs/DESKTOP-E2E.md](docs/DESKTOP-E2E.md) for the Desktop release checklist.
 

package/README.md

@@ -162,12 +162,25 @@ Bundle 默认配置位于 `cordis.patch.yml`：
     refreshSkewMs: 300000
     openBrowser: true
     showSidebarEntry: true
+    frameAncestors: ['self']
 ```
 
 `catalogUrl` 默认通过 jsDelivr CDN 读取公共 [dsh-mcp-connector-registry](https://github.com/duhu2000/dsh-mcp-connector-registry)，支持 ETag/TTL 缓存；主源失败时自动尝试 GitHub raw 备用源，再回退到上次缓存或随包内置目录。jsDelivr 的分支 URL 可能存在缓存延迟，因此 Registry 合并后的新卡片不保证秒级出现。需要离线/私有模式时可将 `catalogUrl` 显式设为空字符串；显式配置其他目录 URL 时不会自动切换到公共备用源。
 
+远程目录请求（包括备用源）支持 `HTTP_PROXY`、`HTTPS_PROXY`、`NO_PROXY` 及其小写形式；同时存在时小写变量优先，未设置 `HTTPS_PROXY` 时 HTTPS 请求使用 `HTTP_PROXY`。代理地址须为 HTTP(S) URL；需要直连的目标可加入 `NO_PROXY`（例如 `localhost,127.0.0.1`）。Node.js 20+ 无需添加 `--use-env-proxy`；此行为不会修改 Host 的全局 fetch dispatcher 或 MCP 传输配置。
+
+代理变量必须存在于正在运行的 DSH 进程中。修改后请完全退出并重启 DSH Desktop，或从已设置变量的终端启动 `dsh web`；修改 Windows 用户环境变量不会更新已有进程。连接器不会读取系统代理设置，也不会猜测本机代理地址。
+
 `showSidebarEntry` 默认为 `true`。用户可在 DSH 插件配置页覆盖该值；关闭后只隐藏侧边栏快捷入口，不停用连接器、已连接 MCP Server 或工具。
 
+`frameAncestors` 默认为 `['self']`，即面板页面（`/mcp-connector/ui/`）的 CSP 只允许同源页面内嵌，是既有行为，不做任何放宽。在桌面壳（Tauri/Electron）里把面板嵌进壳窗口时，祖先源与面板自身不同源，浏览器会以 `Framing '...' violates the following Content Security Policy directive: "frame-ancestors 'self'"` 拦截并导致面板白屏；此时需要由部署方/用户显式追加外壳源：
+
+```yaml
+frameAncestors: ['self', 'http://tauri.localhost', 'tauri://localhost']
+```
+
+这是有意的安全取舍，不是遗漏：`frame-ancestors` 无法验证嵌入方到底是谁，所以插件不会默认把 Tauri 之类的外壳源硬编码进去——写进白名单就等于允许任何跑在该源上的页面内嵌本机面板。取值只接受 CSP 关键字（`self` / `none` / `*`）与 host-source（`https://*.example.com`、`127.0.0.1:3080`、`tauri://localhost`、`http://tauri.localhost:1420` 等，可带 scheme、端口与路径）；含 `;`、逗号、空格或 `'unsafe-inline'` 一类非 host-source 关键字的值会被整条丢弃（避免 CSP 头注入），过滤后为空则回退 `['self']`，而不是放行任意源。请只填自己信任的源。
+
 ## 兼容性与责任边界
 
 | 项目 | 当前边界 |
@@ -197,7 +210,7 @@ npm run dev:ui
 
 公共 Registry 每次合并后会生成 `catalog-stats.json`；本仓库的定时工作流每小时同步中英文介绍和统计快照。npm 页面中的静态正文随版本发布更新，上方动态统计徽标则直接读取 Registry，可在不发布新 npm 版本时保持实时数量一致。
 
-当前公开版本为 [`dsh-mcp-connector@0.2.69`](https://www.npmjs.com/package/dsh-mcp-connector)，对应 [GitHub Release v0.2.69](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.69)。
+当前公开版本为 [`dsh-mcp-connector@0.2.71`](https://www.npmjs.com/package/dsh-mcp-connector)，对应 [GitHub Release v0.2.71](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.71)。
 
 版本能力与变更记录见 [CHANGELOG.md](CHANGELOG.md)。
 Desktop 发版回归见 [docs/DESKTOP-E2E.md](docs/DESKTOP-E2E.md)。

package/cordis.patch.yml

@@ -11,3 +11,7 @@
         refreshSkewMs: 300000
         openBrowser: true
         showSidebarEntry: true
+        # 面板 CSP frame-ancestors 白名单：默认仅同源可嵌入。
+        # 桌面壳（Tauri/Electron）内嵌面板时需显式追加外壳源，
+        # 例如 ['self', 'http://tauri.localhost', 'tauri://localhost']。
+        frameAncestors: ['self']

package/docs/CLI-PROVIDERS.md

@@ -34,7 +34,7 @@ MCP 连接器原生支持 Streamable HTTP 和 stdio MCP。对于钉钉 `dws` 这
         "-y",
         "--legacy-peer-deps",
         "--package",
-        "dsh-mcp-connector@0.2.55",
+        "dsh-mcp-connector@0.2.71",
         "--package",
         "dingtalk-workspace-cli@1.0.61",
         "dsh-mcp-cli-bridge",
@@ -50,7 +50,7 @@ MCP 连接器原生支持 Streamable HTTP 和 stdio MCP。对于钉钉 `dws` 这
 
 Windows 从 DSH 进程 PATH 中的全局 npm 或 npx `.bin` 位置查找官方包，直接运行包内 `vendor/dws.exe`；不执行 `.cmd`/`.bat`/`.ps1`，不启用 shell。也可在启动 DSH 的环境中设置 `DSH_MCP_DINGTALK_DWS_BIN` 为原生 exe 的绝对路径（允许空格），随后重启 DSH。无需复制 exe 到 npm 前缀；复制品可能在 CLI 升级后过期。缺失程序不等于 OAuth 未登录。
 
-升级主插件并重启后，标准受管钉钉 0.2.48/0.2.49 桥接参数会在加载时迁移到 0.2.55；自定义命令和参数不自动修改，需自行更新固定桥接版本。授权信息和环境配置保持不变。
+升级主插件并重启后，标准受管钉钉 0.2.48/0.2.49/0.2.55 桥接参数会在加载时迁移到 0.2.71；自定义命令和参数不自动修改，需自行更新固定桥接版本。授权信息和环境配置保持不变。
 
 - 当前用户、通讯录搜索与用户详情
 - 日程列表与日程详情

package/docs/MARKET-REGISTRATION.md

@@ -54,6 +54,37 @@ DCR 返回的 `client_secret` 由插件与 Access/Refresh Token 一同保存在
 
 插件优先读取 RFC 8414 Authorization Server Metadata；若动态注册或撤销端点缺失，会再读取 OIDC Discovery 并仅补齐缺失字段。OAuth 元数据中的授权、Token 等标准端点始终优先。
 
+### 5.1 MCP URL 带查询参数时的 OAuth 资源标识
+
+MCP URL 需要携带查询参数（`?tools=`、`?tenant=` 等）时，OAuth 的 `resource` 参数**不能**跟着带上查询串：RFC 8707 允许授权服务器以 `invalid_target` 拒绝与原始授权不一致的 `resource`，一旦查询串被写进 `authorizedResources`，刷新就会失败，用户会被反复要求重新授权。
+
+因此 OAuth 卡片用 `servers[].oauthResource` 显式声明规范资源标识，`url` 保留查询参数：
+
+```json
+{
+  "servers": [{
+    "serverKey": "search",
+    "url": "https://mcp.example.com/mcp?tools=web_search_exa,agent_run",
+    "oauthResource": "https://mcp.example.com/mcp",
+    "serverName": "vendor-search",
+    "transport": "streamable-http"
+  }]
+}
+```
+
+约束：
+
+- 只有 `auth.mode: "oauth2-pkce"` 的卡片可以声明，其他鉴权模式声明会被目录审计拒绝；
+- `oauthResource` 必须与 `url` **同源**，且通过 HTTPS / 回环 HTTP 检查，防止描述文件把 Token 引到其他域；
+- 实际请求仍使用 `url`（含查询参数），`resource` 授权参数、Token 校验、`grant.authorizedResources` 与刷新参数使用 `oauthResource`；
+- 不声明时行为与旧版完全一致（直接用 `url` 匹配）。
+
+为什么这个字段是必需的（2026-10-10 实测）：部分授权服务器签发的 access token **不带 `resource` claim**（Exa 只有 `aud: ["https://mcp.exa.ai", "https://api.exa.ai", "https://mcp.exa.ai/mcp"]`，无 `resource`），此时插件不按 token claim 过滤，而是直接采用 `servers[].oauthResource ?? url`。因此对这类厂商，**是否声明 `oauthResource` 就决定了 `authorizedResources` 是规范值还是带查询串的 URL**；带查询串的值会在每次刷新时作为 `resource` 发给授权服务器。
+
+> 复现提示：卡片一旦被旧版插件安装过，本机 `catalog.dynamic` 里存的就是**已削掉 `oauthResource` 的副本**，仅升级插件不会修复它（连接仍可用，只是 `authorizedResources` 继续走 `url`）。升级后需要**重新安装该卡片**（重新走一次描述 URL 安装）才会带上新字段。
+
+已知边界：`grantSharing: "issuer"` 的卡片在启动时归并历史共享授权（`consolidatePersistedSharedGrants`）按连接记录的 `url` 比较资源。查询参数场景下 `url` 与规范 `authorizedResources` 不再相等，该归并优化会被跳过——不影响连接、刷新与撤销，只是历史多 Grant 不会被自动合并。
+
 符合上述条件的最小描述：
 
 ```json
@@ -83,7 +114,7 @@ DCR 返回的 `client_secret` 由插件与 Access/Refresh Token 一同保存在
 }
 ```
 
-### 5.1 需要本机环境变量的 stdio 卡片
+### 5.2 需要本机环境变量的 stdio 卡片
 
 目录只声明字段和映射，示例见 `registry/connectors/stdio-credential.sample.json`：
 
@@ -210,3 +241,35 @@ QVeris Hosted MCP 提供单一 Streamable HTTP 端点 `https://mcp.qveris.ai/mcp
 - https://mcp.bazhuayu.com/.well-known/oauth-protected-resource
 - https://identity.bazhuayu.com/.well-known/oauth-authorization-server
 - https://identity.bazhuayu.com/.well-known/openid-configuration
+
+## 10. Exa 网络搜索适配结论
+
+Exa 官方远程 MCP 为 `https://mcp.exa.ai/mcp`（Streamable HTTP；`initialize` 返回 serverInfo `exa-search-server`，版本 3.4.2），同时支持无凭据（默认工具）、API Key（`x-api-key` 或 `Authorization: Bearer`）与 OAuth 2.0。
+
+2026-10-09 无凭据实测：
+
+- Protected Resource Metadata：`resource=https://mcp.exa.ai/mcp`，授权服务器 `https://auth.exa.ai`，scope `mcp:tools`，`bearer_methods_supported: ["header"]`；
+- Authorization Server Metadata（RFC 8414）：issuer 与声明值精确相等，`code_challenge_methods_supported: ["S256"]`，`token_endpoint_auth_methods_supported: ["none"]`，并发布**动态客户端注册**与**撤销**端点；
+- 用本机 loopback 回调按插件同款报文发起 DCR，返回 `201` 与 `client_id`，满足第 5 节"OAuth 一键授权"的全部门槛；
+- `tools/list` 在未鉴权时可用；`tools/call` 无凭据走 IP 级免费额度（官方公布 3 QPS / 150 次每日），额度用尽返回 429。
+
+工具面与本卡片的 `?tools=` 参数（2026-10-10 用真实密钥只读 `tools/list` 复测）：
+
+- 无凭据：默认 2 个工具（`web_search_exa`、`web_fetch_exa`）；
+- **有凭据**：纯 URL 自动变成 3 个工具——`agent_run` 是"鉴权即白送"，并不需要写进 `tools=`；写成 `?tools=` 精确列表后，**凭据不会向列表追加工具**（只列 2 个就恰好 2 个）；
+- 卡片 URL `?tools=web_search_exa,web_fetch_exa,web_search_advanced_exa,agent_run` 鉴权后列出 4 个工具，相对纯 URL 的**净增益只有 `web_search_advanced_exa`**（带筛选/域名/日期/摘要/子页抓取）；
+- `tools=` 是**精确替换**语义（不是追加），未知名称会被丢弃；若整份列表都不可识别会静默回落到默认 2 个，因此该列表是硬编码白名单——Exa 新增默认工具不会自动出现在卡片里，工具改名需要按第 3 节更新 Registry（不需要重新发布 npm）；
+- 列表含 `agent_run` 时，`initialize` 阶段就要求凭据，因此该 URL 的匿名 `initialize` 返回 401——这是预期行为，公开探针仍判可达且 `oauth: pass`；若只想暴露高级检索而完全不暴露计费工具，可改用 `?tools=web_search_exa,web_fetch_exa,web_search_advanced_exa`（3 个工具，且匿名 `initialize` 可 200）；
+- 因为 MCP URL 带查询参数，卡片必须用 `servers[].oauthResource` 声明规范资源标识（见第 5.1 节），否则带查询串的 URL 会被写进 `authorizedResources`，刷新时 `resource` 参数不一致，可能被授权服务器按 `invalid_target` 拒绝。
+
+计费与配额：搜索按请求计费（instant $4/1k、fast/auto $7/1k），`agent_run` 每次 $0.012–$1.00 或按量计费（默认上限 $5 auto / $20 ultra），余额耗尽返回 402。卡片保持 `featured: false`：保留 `agent_run`（多步研究是该分类的差异化能力），并以示例 Prompt 强制"先确认研究范围、effort 档位与金额上限"而不是把它从工具面移除。工具 schema 不随插件版本固定，`web_search_exa` 当前要求同时提供 `query` 与 `objective`。
+
+参考：
+
+- https://exa.ai/docs/get-started/exa-mcp
+- https://github.com/exa-labs/exa-mcp-server
+- https://mcp.exa.ai/.well-known/oauth-protected-resource
+- https://auth.exa.ai/.well-known/oauth-authorization-server
+- https://exa.ai/docs/admin/pricing
+- https://dashboard.exa.ai/api-keys
+

package/docs/STDIO-SUPPORT.md

@@ -1,5 +1,7 @@
 # stdio 传输支持 —— 设计文档 & 开发实现
 
+> **Windows 命令兼容（0.2.70）**：启动恢复保护使用 cross-spawn 解析 PATH/PATHEXT 中的命令，支持 npx 等 .cmd shim；通常无需将已有配置改成 cmd /c。uvx 需要先安装并位于 DSH 进程的 PATH 中。命令不存在时显示 ENOENT 与 PATH 检查提示，不输出参数或凭据。
+
 > 目标：补齐 stdio（本地进程）传输方式，达到与 WorkBuddy / TraeWork / Qwen Code 三家大厂传输方式全覆盖。
 > 结论：**低成本补齐**——`@deepseek-ai/dsh-mcp-client` 已原生支持 stdio，我们只需在 schema + provisioning 两层「开闸透传」。
 

package/docs/USER-GUIDE.md

@@ -83,7 +83,7 @@ dsh web
 | `配置` | 需要 Bearer Token 或 API Key | 录入服务商签发的凭据并验证 |
 | `需重新授权` | OAuth 授权过期、被撤销或不可用 | 点击后重新完成 OAuth 授权 |
 | `自动重试中` | OAuth Token 刷新遇到网络或服务端暂时故障 | 无需重新授权；保持 DSH 运行，插件会按退避策略自动恢复 |
-| `状态未知` | 本机已有配置，但本进程尚未观察到可用性检查结果；不代表健康或异常 | 点击“刷新连接器目录”或进入详情检查 |
+| `状态未知` | 本机已有配置，但本进程尚未观察到可用性检查结果；不代表健康或异常 | 点击“刷新连接器目录”，或在该连接上点“重新连接” |
 | `已连接` | 最近一次健康检查通过 | 可直接在会话中使用对应 MCP 工具 |
 | `部分异常` / `连接异常` | 一个或多个 Server 未通过检查 | 打开详情查看提示，核对网络、权限和服务状态 |
 
@@ -199,6 +199,8 @@ stdio 进程由 `@deepseek-ai/dsh-mcp-client` 管理，插件透传 `command`、
 - 启用或停用连接；
 - 重新授权 OAuth，或重新录入 Token/API Key；
 - 执行健康检查；
+- 重新连接：重建 Host 侧条目并复检，用于“状态未知”或 Host 已放弃重连的连接；它不修改配置、凭据、范围或启停状态；
+- 检测企查查旧授权：扫描两个已退役的企查查 OAuth 插件（`qcc-dsh-mcp-oauth`、`qcc-dsh-mcp-legal-oauth`）遗留的本机授权，确认后可复制到 MCP连接器；不会删除旧插件或原凭据；
 - 断开连接并删除该连接的本机配置。
 
 OAuth 断开时，插件会尽力调用服务商的撤销端点；无撤销端点时仍会删除 DSH 本机授权记录。连接状态发生变化后，可点击“刷新连接器目录”重新检查。
@@ -315,7 +317,7 @@ OAuth 断开时，插件会尽力调用服务商的撤销端点；无撤销端
 
 ### stdio 启动失败
 
-页面会在有限时间内结束等待，并区分命令不存在、进程退出、初始化失败或启动超时。先在终端确认命令本身可执行、软件包可信、Node/运行时版本满足要求，并检查 `cwd`、参数和环境变量；随后查看 Host 日志并点击“重新检查”。不要把本机凭据写入公开 Registry descriptor。
+页面会在有限时间内结束等待，并区分命令不存在、进程退出、初始化失败或启动超时。先在终端确认命令本身可执行、软件包可信、Node/运行时版本满足要求，并检查 `cwd`、参数和环境变量；随后查看 Host 日志，并在该连接上点击“重新连接”（Host 放弃重连后不会自发恢复）。不要把本机凭据写入公开 Registry descriptor。
 
 #### 1. 确认命令与运行环境
 
@@ -384,7 +386,7 @@ Windows 下 `.cmd` / `.bat` 是脚本包装器，不等同于可直接启动的
 
 ### 为什么显示“状态未知”
 
-这表示插件没有足够证据确认健康或失败，常见于 DSH 刚重启、尚未执行健康检查，或当前 Host 无法读取 stdio 工具注册状态。点击“刷新连接器目录”或进入详情重新检查；若仍为未知，根据诊断的 `code` 和建议查看 Host 日志或升级 Host。不要把“状态未知”理解为“已连接”。
+这表示插件没有足够证据确认健康或失败，常见于 DSH 刚重启、尚未执行健康检查，或当前 Host 无法读取 stdio 工具注册状态。先点击“刷新连接器目录”；若仍为未知，在该连接（或详情页）点“重新连接”重建 Host 侧条目——Host 的 mcp-client 在连续重连失败后会注销工具且不再自发重试，只有重建条目才能恢复。若重建后依旧未知，再根据诊断的 `code` 和建议查看 Host 日志或升级 Host。不要把“状态未知”理解为“已连接”。
 
 ### 如何按诊断代码排查
 

package/lib/catalog.js

@@ -3,6 +3,7 @@
  * 合并键为 id，优先级：本地覆盖 > config.connectors > 远程 registry > 内置目录。
  */
 import { readFileSync } from 'node:fs';
+import { EnvHttpProxyAgent } from 'undici';
 import { normalizeConnectorDescriptor } from './schema.js';
 import { assertSafeUrl, assertSafeHeaderName } from './util.js';
 
@@ -46,7 +47,7 @@ export function auditDescriptor(descriptor) {
   const oauthHttpResources = new Set(
     descriptor.servers
       .filter((server) => server.transport === 'streamable-http')
-      .map((server) => server.url),
+      .map((server) => server.oauthResource ?? server.url),
   );
   const credentialFields = descriptor.auth.credentialFields ?? [];
   const credentialKeys = new Set();
@@ -106,6 +107,20 @@ export function auditDescriptor(descriptor) {
       continue;
     }
     assertSafeUrl(server.url);
+    // HTTP Server 可声明 oauthResource：实际请求仍用 url（允许带查询参数，如 `?tools=`），
+    // 但 OAuth resource 标识、authorizedResources 与刷新参数使用该规范值。
+    if (server.oauthResource) {
+      if (descriptor.auth.mode !== 'oauth2-pkce') {
+        throw new Error(`connector "${descriptor.id}" 只有 oauth2-pkce 卡片可声明 oauthResource: ${server.oauthResource}`);
+      }
+      assertSafeUrl(server.oauthResource);
+      if (new URL(server.oauthResource).origin !== new URL(server.url).origin) {
+        throw new Error(`connector "${descriptor.id}" oauthResource 必须与 server.url 同源: ${server.oauthResource}`);
+      }
+    }
+    if (server.oauthTokenEnv) {
+      throw new Error(`connector "${descriptor.id}" 只有 OAuth stdio server 可声明 oauthTokenEnv`);
+    }
     for (const name of Object.keys(server.headers ?? {})) {
       assertSafeHeaderName(name);
       if (/authorization|token|secret|api[-_]?key/i.test(name)) {
@@ -143,12 +158,22 @@ export async function readLimitedJson(response, maxBytes = MAX_CATALOG_BYTES) {
 /** 拉取远程 registry（HTTPS + TTL 缓存 + 可选 ETag） */
 export async function fetchRemoteCatalog(catalogUrl, { requestTimeoutMs, etag } = {}) {
   assertSafeUrl(catalogUrl);
+  // Node 20+ does not consistently enable environment proxies for global fetch.
+  // Scope the dispatcher to this request rather than changing the DSH Host's
+  // global dispatcher. Undici handles HTTPS fallback and NO_PROXY matching.
+  const httpProxy = process.env.http_proxy ?? process.env.HTTP_PROXY;
+  const httpsProxy = process.env.https_proxy ?? process.env.HTTPS_PROXY;
+  const dispatcher = httpProxy || httpsProxy ? new EnvHttpProxyAgent() : undefined;
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(new Error('timeout')), requestTimeoutMs ?? 15_000);
   try {
     const headers = {};
     if (etag) headers['If-None-Match'] = etag;
-    const response = await fetch(catalogUrl, { headers, signal: controller.signal });
+    const response = await fetch(catalogUrl, {
+      headers,
+      signal: controller.signal,
+      ...(dispatcher ? { dispatcher } : {}),
+    });
     assertSafeUrl(response.url || catalogUrl);
     if (response.status === 304) return { notModified: true };
     if (!response.ok) throw new Error(`catalog fetch HTTP ${response.status}`);
@@ -158,6 +183,9 @@ export async function fetchRemoteCatalog(catalogUrl, { requestTimeoutMs, etag }
     return { notModified: false, etag: response.headers.get('etag') ?? undefined, connectors };
   } finally {
     clearTimeout(timer);
+    // Destroy also releases unread error/oversize bodies; close could wait for
+    // those bodies indefinitely. Never destroy a dispatcher owned by the Host.
+    await dispatcher?.destroy();
   }
 }
 

package/lib/cli-providers.js

@@ -314,7 +314,9 @@ export function resolveCliExecutable(command, options = {}) {
       if (!existsSync(path.join(root, 'package.json'))) continue;
       try {
         const pkg = JSON.parse(readFileSync(path.join(root, 'package.json'), 'utf8'));
-        if (pkg.name !== 'dingtalk-workspace-cli' || pkg.bin?.dws !== 'bin/dws.js') continue;
+        // npm tarballs preserve "./", while registry metadata can omit it.
+        // Accept only these two canonical entries; do not normalize traversal.
+        if (pkg.name !== 'dingtalk-workspace-cli' || !['bin/dws.js', './bin/dws.js'].includes(pkg.bin?.dws)) continue;
         const realRoot = realpathSync(root);
         const binary = realpathSync(path.join(root, 'vendor', 'dws.exe'));
         const relative = path.relative(realRoot, binary);
@@ -443,12 +445,12 @@ export function cliBridgeArgs(record) {
   const args = record.args ?? [];
   if (!legacy[3] || record.connectorId !== 'dingtalk' || record.command !== 'npx'
     || JSON.stringify(args) !== JSON.stringify(legacy)) return args;
-  return args.map((arg) => arg === legacy[3] ? 'dsh-mcp-connector@0.2.55' : arg);
+  return args.map((arg) => arg === legacy[3] ? 'dsh-mcp-connector@0.2.71' : arg);
 }
 
 function argsVersion(record) {
   const value = record.args?.[3];
-  return ['dsh-mcp-connector@0.2.48', 'dsh-mcp-connector@0.2.49'].includes(value) ? value : null;
+  return ['dsh-mcp-connector@0.2.48', 'dsh-mcp-connector@0.2.49', 'dsh-mcp-connector@0.2.55'].includes(value) ? value : null;
 }
 
 export async function handleCliBridgeRequest(message, options = {}) {

package/lib/client.js

@@ -631,13 +631,19 @@ window.__ModuleLoader__.load({
 			return `dsh plugin --profile web add --config.minimumReleaseAge=0 ${PLUGIN_PACKAGE_NAME}@${parsed.normalized}`;
 		}
 
+		/** 尝试写入剪贴板；失败时调用方把命令展示在页面内，不退回原生 prompt。 */
 		async function copyManualUpgradeCommand(command) {
-			if (typeof window.navigator?.clipboard?.writeText === "function") {
-				await window.navigator.clipboard.writeText(command);
+			const clipboard = window.navigator?.clipboard;
+			if (typeof clipboard?.writeText !== "function") return false;
+			try {
+				await clipboard.writeText(command);
 				return true;
+			} catch (error) {
+				// 桌面壳里原生弹窗关闭后不会把键盘焦点还给页面，所以这里只记录失败，
+				// 由调用方改用页面内提示 + 可一键选中的命令。
+				console.warn("[mcp-connector] clipboard write failed:", error);
+				return false;
 			}
-			window.prompt?.("请复制以下升级命令", command);
-			return false;
 		}
 
 		function parseClientVersion(value) {
@@ -1120,6 +1126,7 @@ window.__ModuleLoader__.load({
 			const [rollbackRunning, setRollbackRunning] = (0, react.useState)(false);
 			const [restarting, setRestarting] = (0, react.useState)(false);
 			const [manualCommandCopied, setManualCommandCopied] = (0, react.useState)(false);
+			const [manualCommandVisible, setManualCommandVisible] = (0, react.useState)(false);
 			const [versionCheckRequest, setVersionCheckRequest] = (0, react.useState)(0);
 			const [versionCheckBusy, setVersionCheckBusy] = (0, react.useState)(false);
 			const [versionCheckFailed, setVersionCheckFailed] = (0, react.useState)(false);
@@ -1553,6 +1560,8 @@ window.__ModuleLoader__.load({
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", {
 								className: "mcpConnectorManualCommand",
 								title: command,
+								// 点击即全选，方便手动复制（剪贴板不可用时的回退路径）。
+								onClick: (event) => window.getSelection?.()?.selectAllChildren?.(event.currentTarget),
 								children: command
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
@@ -1560,14 +1569,20 @@ window.__ModuleLoader__.load({
 								className: "mcpConnectorUpdateButton",
 								onClick: () => {
 									copyManualUpgradeCommand(command).then((copied) => {
-										if (copied) setManualCommandCopied(true);
-									}, (error) => {
-										console.warn("[mcp-connector] copy upgrade command failed:", error);
-										window.prompt?.("请复制以下升级命令", command);
+										// 剪贴板不可用时给出页面内提示，让用户直接选中上面的命令，
+										// 不再退回原生 prompt：桌面壳里原生弹窗关闭后不会把键盘
+										// 焦点还给页面。成功时顺带撤掉失败提示，避免留在界面上。
+										setManualCommandCopied(copied);
+										setManualCommandVisible(!copied);
 									});
 								},
 								children: manualCommandCopied ? "已复制" : "复制升级命令"
 							}),
+							manualCommandVisible && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "mcpConnectorUpdateStatus",
+								"data-tone": "error",
+								children: "无法写入剪贴板，请点击上方命令全选后手动复制"
+							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 								type: "button",
 								className: "mcpConnectorUpdateButton mcpConnectorUpdateSecondary",

package/lib/index.js

@@ -125,6 +125,17 @@ export const Config = z.object({
   account: z.string().default(DEFAULT_ACCOUNT),
   /** 是否在 DSH 主侧边栏显示 MCP连接器快捷入口 */
   showSidebarEntry: z.boolean().default(true),
+  /**
+   * 图形化市场面板（/mcp-connector/ui/）的 CSP `frame-ancestors` 白名单。
+   *
+   * 默认 `['self']`：只有同源页面能内嵌面板，保持既有行为不变。
+   * 桌面壳（Tauri/Electron）内嵌面板时，祖先源与面板自身不同源，浏览器会以
+   * `violates ... "frame-ancestors 'self'"` 拦截并导致面板白屏；此时需显式追加
+   * 外壳源，例如 `frameAncestors: ['self', 'http://tauri.localhost', 'tauri://localhost']`。
+   * 注意这是有意的安全取舍：加入白名单的源都能内嵌本面板，请只填你自己信任的源。
+   * 非法值（含 `;`/空格等注入尝试、非 host-source 关键字）会被丢弃，全部非法则回退 `['self']`。
+   */
+  frameAncestors: z.array(z.string()).default(['self']),
 });
 
 export async function apply(ctx, config) {
@@ -1015,6 +1026,21 @@ export async function apply(ctx, config) {
     }
   }
 
+  /**
+   * 等待 Host 侧注册这个 stdio server 的工具。
+   * 重建条目后 mcp-client 需要重新 spawn 并完成 initialize/tools-list；在此期间
+   * "没有工具" 与 "启动失败" 无法区分，所以这里只做有界的轮询，不把它当作失败。
+   */
+  async function waitForStdioToolRegistration(record, timeoutMs = 5_000) {
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+      const registered = registeredStdioTools(record);
+      if (registered.tools.length > 0) return registered.tools.length;
+      if (Date.now() >= deadline) return 0;
+      await new Promise((resolve) => { setTimeout(resolve, 250).unref?.(); });
+    }
+  }
+
   async function cacheLastSuccessfulTools(record, tools) {
     // A request may finish after disconnect/reconfigure. Never resurrect old metadata.
     if (state.connections.get(record.key) !== record || record.enabled === false) return null;
@@ -2650,6 +2676,69 @@ export async function apply(ctx, config) {
       return { ok: true, message: `已停用 "${next.name}"`, detail: { snapshotId: snapshot?.key ?? null } };
     },
 
+    /**
+     * 重新建立一条已启用连接的 Host 条目，并复检它的连接状态。
+     *
+     * Host 的 mcp-client 连续重连失败后会注销工具且不再自发重试（日志：giving up after
+     * 10 consecutive failed reconnect attempts），此前只有停用/启用或重启 Host 能恢复。
+     * 这里用与停用/启用相同的 loader 序列触发一次真正的重连，并在有界时间内等待 stdio
+     * 工具重新注册；不修改连接记录、凭据、范围或注入模式。
+     */
+    async reconnect(key) {
+      const record = state.connections.get(key);
+      if (!record) return { ok: false, message: `连接 "${key}" 不存在` };
+      if (record.enabled === false) return { ok: false, message: `连接 "${record.name}" 已停用；请先启用再重新连接` };
+      const failure = grantFailure(record);
+      if (failure) return { ok: false, message: failure.message };
+      try {
+        await disable(ctx, config, record);
+        if (state.connections.get(key) !== record) return { ok: false, message: '连接配置已变化，请重新检查后重试' };
+        await provision(ctx, config, record, grantMap(), { failOnStartupError: false });
+      } catch (error) {
+        return connectionSetupFailure(error, '重新连接失败', '已保留连接配置，但 Host 条目可能仍停用；请检查后重新连接');
+      }
+      const records = [...state.connections.values()].filter((item) => item.connectorId === record.connectorId);
+      const enabledRecords = records.filter((item) => item.enabled !== false);
+      const stdioRecords = enabledRecords.filter((item) => item.transport === 'stdio');
+      const counts = await Promise.all(stdioRecords.map((item) => waitForStdioToolRegistration(item)));
+      const registeredTools = counts.reduce((total, count) => total + count, 0);
+      if (state.connections.get(key) !== record) return { ok: false, message: '连接配置已变化，请重新检查状态' };
+      const results = stdioRecords.map((item) => {
+        const registered = registeredStdioTools(item);
+        if (registered.tools.length > 0) {
+          return { ok: true, kind: 'connected', serverKey: item.serverKey, serverName: item.serverName, toolCount: registered.tools.length, message: `Host 已注册 ${registered.tools.length} 个工具` };
+        }
+        return {
+          ok: true,
+          kind: 'managed',
+          code: registered.error ? 'host-status-error' : registered.supported ? 'host-tools-pending' : 'host-status-unavailable',
+          serverKey: item.serverKey,
+          serverName: item.serverName,
+          message: registered.error
+            ? 'Host 工具注册状态读取失败'
+            : registered.supported ? 'Host 尚未注册该 stdio Server 的工具' : '当前 Host 无法读取 stdio 工具注册状态',
+        };
+      });
+      const checkable = enabledRecords.filter((item) => item.transport !== 'stdio');
+      if (checkable.length > 0) {
+        const validation = await validateConnectionRecords(checkable, {
+          timeoutMs: Math.min(config.requestTimeoutMs, 5_000),
+          concurrency: 4,
+          grants: grantMap(),
+        });
+        results.push(...validation.detail.results);
+      }
+      const summary = cacheHealth(record.connectorId, records, results);
+      const healthy = summary.connectionState === 'healthy';
+      return {
+        ok: healthy,
+        message: healthy
+          ? `已重新连接 "${record.name}"${registeredTools > 0 ? `：Host 已注册 ${registeredTools} 个工具` : ''}`
+          : `已重建 "${record.name}" 的 Host 条目，但当前仍为${summary.label}：${summary.diagnostic?.message ?? '请稍后重试'}`,
+        detail: { connectorId: record.connectorId, key: record.key, connectionState: summary.connectionState, registeredTools },
+      };
+    },
+
     async setInjectionMode(key, mode) {
       const record = state.connections.get(key);
       if (!record) return { ok: false, message: `连接 "${key}" 不存在` };
@@ -3323,7 +3412,21 @@ export async function apply(ctx, config) {
     discoveryTimer = setTimeout(() => { discoveryTimer = null; void discoverTools(); }, 100);
     discoveryTimer.unref?.();
   }
-  const discoveryMutations = new Set(['connect', 'configure', 'importJson', 'installFromUrl', 'reconfigureConnection', 'setEnabled', 'restoreSnapshot', 'migrateLegacy']);
+  // Serialize same-record actions: a delayed reconnect must never reactivate a
+  // connection the user has subsequently disabled or disconnected.
+  const connectionActions = new Set(['reconnect', 'setEnabled', 'disconnect', 'reconfigureConnection', 'renameConnection', 'setInjectionMode']);
+  const connectionQueues = new Map();
+  for (const name of connectionActions) {
+    const action = api[name];
+    api[name] = async (key, ...args) => {
+      const previous = connectionQueues.get(key) ?? Promise.resolve();
+      const pending = previous.catch(() => {}).then(() => action.call(api, key, ...args));
+      connectionQueues.set(key, pending);
+      try { return await pending; }
+      finally { if (connectionQueues.get(key) === pending) connectionQueues.delete(key); }
+    };
+  }
+  const discoveryMutations = new Set(['connect', 'configure', 'importJson', 'installFromUrl', 'reconfigureConnection', 'setEnabled', 'reconnect', 'restoreSnapshot', 'migrateLegacy']);
   const discoveryApi = new Proxy(api, { get(target, property) {
     const value = target[property];
     if (!discoveryMutations.has(property)) return value;
@@ -3347,7 +3450,11 @@ export async function apply(ctx, config) {
   if (typeof ctx.inject === 'function') {
     try {
       ctx.inject(['webServer', 'webRuntime'], (wctx) => {
-        disposeWeb = mountWebRoutes(wctx, observableApi, { logger, eventHub: statusEvents });
+        disposeWeb = mountWebRoutes(wctx, observableApi, {
+          logger,
+          eventHub: statusEvents,
+          frameAncestors: config.frameAncestors,
+        });
         logger.info('mcp-connector web UI mounted at /mcp-connector/ui/');
       });
     } catch (error) {

package/lib/mcp-provision.js

@@ -8,6 +8,15 @@ import { fileURLToPath } from 'node:url';
 
 const STDIO_STARTUP_GUARD = fileURLToPath(new URL('./stdio-startup-guard.js', import.meta.url));
 
+/**
+ * 桌面宿主（Electron 内嵌 DSH）的 `process.execPath` 是可执行文件本体：只有带上
+ * `ELECTRON_RUN_AS_NODE` 才会作为 Node 运行 guard 脚本；CLI 宿主（node 进程）不需要。
+ * 该变量只服务于 guard 自身，guard 启动真实 server 前会把它移除。
+ */
+function isElectronRuntime() {
+  return typeof process.versions?.electron === 'string';
+}
+
 export function entryIdFor(config, record) {
   return `${config.entryPrefix}-${record.key}`;
 }
@@ -46,7 +55,7 @@ export function buildEntryConfig(record, grants, { failOnStartupError = false, s
       serverName: record.serverName,
       command: guarded ? process.execPath : record.command,
       args: guarded ? [STDIO_STARTUP_GUARD, '--timeout-ms', String(startupRequestTimeoutMs), '--', record.command, ...args] : args,
-      env,
+      env: guarded && isElectronRuntime() ? { ...env, ELECTRON_RUN_AS_NODE: '1' } : env,
       cwd: record.cwd || process.cwd(),
       failOnStartupError,
     };

package/lib/schema.js

@@ -265,8 +265,11 @@ export function normalizeConnectorDescriptor(raw) {
       args: transport === 'stdio' ? (s.args ?? []) : undefined,
       env: transport === 'stdio' ? (s.env ?? {}) : undefined,
       credentialBindings: transport === 'stdio' ? (s.credentialBindings ?? {}) : undefined,
-      oauthResource: transport === 'stdio' ? s.oauthResource : undefined,
-      oauthTokenEnv: transport === 'stdio' ? s.oauthTokenEnv : undefined,
+      // OAuth 资源标识对 HTTP 与 stdio 都有效：HTTP 用它解耦「实际请求 URL（可带查询参数）」
+      // 与「OAuth resource 标识」，避免把 `?tools=` 之类的查询串写进 authorizedResources。
+      // oauthTokenEnv 仅 stdio 有意义，这里不做静默丢弃，交给 auditDescriptor 显式报错。
+      oauthResource: s.oauthResource,
+      oauthTokenEnv: s.oauthTokenEnv,
       cwd: transport === 'stdio' ? (s.cwd ?? '') : undefined,
       serverName: s.serverName,
       transport,