dsh-mcp-connector 0.2.39 → 0.2.40

package/CHANGELOG.md

@@ -4,6 +4,21 @@
 
 ## [Unreleased]
 
+## [0.2.40] - 2026-09-09
+
+### Added
+
+- “已安装”页为用户自定义和 JSON 导入的 MCP 连接新增“重命名”，启用状态下也可无中断修改显示名。
+- 新增 `mcp_connector_rename` 对话工具，便于按连接 key 修改显示名。
+
+### Changed
+
+- 重命名只更新本机连接元数据并创建可恢复快照；connection key、`serverName`、工具前缀、连接范围、凭据和 Host 挂载均保持不变。
+
+### Verification
+
+- 209 项自动测试、lint、版本/营销元数据/商店截图门禁和 npm 发布包白名单/敏感内容扫描全部通过；新增覆盖显示名校验、Web API、对话工具、界面入口、启用状态下无重挂载、脱敏导出、快照与重启持久化。
+
 ## [0.2.39] - 2026-09-08
 
 ### Fixed
@@ -607,7 +622,8 @@
 - 外部 URL 与导入 Header 执行安全校验。
 - iframe 消息校验同源和消息来源。
 
-[Unreleased]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.39...HEAD
+[Unreleased]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.40...HEAD
+[0.2.40]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.39...v0.2.40
 [0.2.39]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.38...v0.2.39
 [0.2.38]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.37...v0.2.38
 [0.2.37]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.36...v0.2.37

package/README.en.md

@@ -175,7 +175,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.39`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.39](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.39).
+The current public version is [`dsh-mcp-connector@0.2.40`](https://www.npmjs.com/package/dsh-mcp-connector), with [GitHub Release v0.2.40](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.40).
 
 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

@@ -171,7 +171,7 @@ npm run dev:ui
 
 公共 Registry 每次合并后会生成 `catalog-stats.json`；本仓库的定时工作流每小时同步中英文介绍和统计快照。npm 页面中的静态正文随版本发布更新，上方动态统计徽标则直接读取 Registry，可在不发布新 npm 版本时保持实时数量一致。
 
-当前公开版本为 [`dsh-mcp-connector@0.2.39`](https://www.npmjs.com/package/dsh-mcp-connector)，对应 [GitHub Release v0.2.39](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.39)。
+当前公开版本为 [`dsh-mcp-connector@0.2.40`](https://www.npmjs.com/package/dsh-mcp-connector)，对应 [GitHub Release v0.2.40](https://github.com/duhu2000/dsh-mcp-connector/releases/tag/v0.2.40)。
 
 版本能力与变更记录见 [CHANGELOG.md](CHANGELOG.md)。
 Desktop 发版回归见 [docs/DESKTOP-E2E.md](docs/DESKTOP-E2E.md)。

package/docs/USER-GUIDE.md

@@ -152,6 +152,7 @@ stdio 进程由 `@deepseek-ai/dsh-mcp-client` 管理，插件透传 `command`、
 在“已安装”中可以：
 
 - 查看连接状态和 Server 数量；
+- 修改自定义或 JSON 导入连接的显示名，无需先停用连接；
 - 启用或停用连接；
 - 重新授权 OAuth，或重新录入 Token/API Key；
 - 执行健康检查；
@@ -159,12 +160,14 @@ stdio 进程由 `@deepseek-ai/dsh-mcp-client` 管理，插件透传 `command`、
 
 OAuth 断开时，插件会尽力调用服务商的撤销端点；无撤销端点时仍会删除 DSH 本机授权记录。连接状态发生变化后，可点击“刷新连接器目录”重新检查。
 
+“重命名”只修改用户看到的连接显示名，不会改变 connection key、`serverName`、`mcp__<serverName>__*` 工具前缀、连接范围、凭据或启停状态，也不会重新挂载 MCP Server。市场连接器的名称继续由公共目录维护。
+
 ### 7.1 配置备份与恢复
 
 “已安装”页的“配置备份”提供两种互补能力：
 
 - **脱敏导出**：复制或下载可携带 JSON。Token/API Key、静态 Header/env 值、stdio 参数、本地目录以及可能含凭据的 URL 会变成明确占位符；目标设备导入前必须重填。OAuth 只导出连接引用，必须从市场重新授权。
-- **本机快照**：连接、配置、导入、启停或断开前自动保存变更范围，也可手动创建；最多保留 20 个。恢复前可查看将恢复和移除的 key，恢复过程中任一 Server 或持久化步骤失败会整体回到恢复前状态。
+- **本机快照**：连接、配置、导入、重命名、启停或断开前自动保存变更范围，也可手动创建；最多保留 20 个。恢复前可查看将恢复和移除的 key，恢复过程中任一 Server 或持久化步骤失败会整体回到恢复前状态。
 
 快照可能包含用于原样恢复的本机凭据，因此只保存在当前 profile 的 storage domain，不会通过 Web API、对话工具或日志原样返回。断开并撤销 OAuth 后，快照不能重建服务端 Grant，会明确要求重新授权。完整边界见[配置备份说明](CONFIG-BACKUP.md)。
 

package/lib/index.js

@@ -7,7 +7,7 @@
  *   - 连接记录与 OAuth grant 持久化，重启恢复与跨 Host Token 轮换
  *   - 通过 ctx.loader 动态配置 @deepseek-ai/dsh-mcp-client 条目
  *   - 对话工具：mcp_connector_catalog / connect / configure / import_json /
- *     export_config / snapshots / install_from_url / status / set_enabled /
+ *     export_config / snapshots / install_from_url / status / rename / set_enabled /
  *     disconnect / refresh_catalog / publish
  */
 import { randomUUID } from 'node:crypto';
@@ -22,6 +22,8 @@ import {
   DEFAULT_REFRESH_RETRY_BASE_MS,
   DEFAULT_REFRESH_RETRY_MAX_MS,
   DEFAULT_CATALOG_TTL_MS,
+  CUSTOM_CONNECTOR_ID,
+  JSON_CONNECTOR_ID,
 } from './constants.js';
 import { defineConnectorDomain, ConnectionStore, GrantStore, CatalogStore, SnapshotStore, GovernanceStore, ConnectionScopeStore } from './stores.js';
 import { normalizeConnectorDescriptor, normalizeConnectionRecord } from './schema.js';
@@ -36,7 +38,7 @@ import { listMcpTools, McpHttpError } from './mcp-http.js';
 import { registerTools } from './tools.js';
 import { mountWebRoutes } from './web.js';
 import { createVersionStatusService } from './version-status.js';
-import { assertSafeUrl } from './util.js';
+import { assertSafeUrl, normalizeConnectionDisplayName } from './util.js';
 import { readLegacyGrantCandidates, planLegacyMigration, toConnectorGrant, toConnectionRecords } from './migration.js';
 import { classifyRefreshFailure, refreshRetryDelay } from './grant-lifecycle.js';
 import { buildHealthSummary, diagnosticForRecord } from './diagnostics.js';
@@ -575,6 +577,10 @@ export async function apply(ctx, config) {
     if (record?.connectorId) state.health.delete(record.connectorId);
   }
 
+  function connectionDisplayNameEditable(record) {
+    return [CUSTOM_CONNECTOR_ID, JSON_CONNECTOR_ID].includes(record?.connectorId);
+  }
+
   async function persistRecord(record) {
     // 存储成功后才更新内存，避免落盘失败却在当前进程显示为“已安装”。
     if (config.persistSecrets) await connectionStore.put(record);
@@ -2200,6 +2206,7 @@ export async function apply(ctx, config) {
           name: record.name,
           connectorId: record.connectorId,
           kind: record.kind,
+          canRename: connectionDisplayNameEditable(record),
           serverName: record.serverName,
           url: record.url,
           transport: record.transport,
@@ -2362,6 +2369,50 @@ export async function apply(ctx, config) {
       };
     },
 
+    async renameConnection(key, name) {
+      const record = state.connections.get(key);
+      if (!record) return { ok: false, message: `连接 "${key}" 不存在` };
+      if (!connectionDisplayNameEditable(record)) {
+        return { ok: false, message: '仅用户自定义或 JSON 导入的连接可修改显示名；市场连接器名称由目录维护' };
+      }
+
+      let nextName;
+      try {
+        nextName = normalizeConnectionDisplayName(name);
+      } catch (error) {
+        return { ok: false, message: `重命名失败: ${error.message}` };
+      }
+      if (nextName === record.name) {
+        return {
+          ok: true,
+          message: `连接显示名未变更："${record.name}"`,
+          detail: { key: record.key, name: record.name, serverName: record.serverName, unchanged: true, snapshotId: null },
+        };
+      }
+
+      let snapshot;
+      try {
+        snapshot = await captureConnectionSnapshot('rename', [key]);
+        const next = { ...record, name: nextName, updatedAt: Date.now() };
+        const persisted = config.persistSecrets ? await connectionStore.put(next) : next;
+        state.connections.set(key, persisted);
+        return {
+          ok: true,
+          message: `已将连接显示名修改为 "${persisted.name}"`,
+          detail: {
+            key: persisted.key,
+            name: persisted.name,
+            serverName: persisted.serverName,
+            enabled: persisted.enabled !== false,
+            snapshotId: snapshot?.key ?? null,
+          },
+        };
+      } catch (error) {
+        await discardConnectionSnapshot(snapshot);
+        return { ok: false, message: `重命名失败，已保留原显示名: ${error.message}` };
+      }
+    },
+
     async setEnabled(key, enabled) {
       const record = state.connections.get(key);
       if (!record) return { ok: false, message: `连接 "${key}" 不存在` };

package/lib/tools.js

@@ -469,6 +469,25 @@ export function registerTools(ctx, api) {
     },
   });
 
+  reg({
+    name: 'mcp_connector_rename',
+    description:
+      '修改用户自定义或 JSON 导入 MCP 连接的显示名。不改变 connection key、serverName、工具前缀、运行状态或凭据。',
+    parameters: {
+      type: 'object',
+      properties: {
+        key: { type: 'string', description: '连接 key（来自 mcp_connector_status）' },
+        name: { type: 'string', description: '新的连接显示名，最长 80 个字符' },
+      },
+      required: ['key', 'name'],
+      additionalProperties: false,
+    },
+    output: resultOutput,
+    async execute(args) {
+      return api.renameConnection(args.key, args.name);
+    },
+  });
+
   reg({
     name: 'mcp_connector_disconnect',
     description: '断开并移除一条 MCP 连接；OAuth 连接会按引用计数撤销 refresh_token（无其他连接引用该授权时）。',

package/lib/util.js

@@ -52,6 +52,15 @@ export function slugServerName(input) {
   return slug;
 }
 
+/** 归一化用户可编辑的连接显示名；不用于 serverName / 工具前缀。 */
+export function normalizeConnectionDisplayName(input) {
+  const name = String(input ?? '').trim();
+  if (!name) throw new Error('连接显示名不能为空');
+  if (/[\u0000-\u001f\u007f]/.test(name)) throw new Error('连接显示名不能包含控制字符');
+  if ([...name].length > 80) throw new Error('连接显示名不能超过 80 个字符');
+  return name;
+}
+
 function parseUrl(rawUrl) {
   let url;
   try {

package/lib/web.js

@@ -41,6 +41,7 @@ const API_WHITELIST = new Map([
   ['previewSnapshot', (api, p) => api.previewSnapshot(p?.snapshotId)],
   ['restoreSnapshot', (api, p) => api.restoreSnapshot(p?.snapshotId)],
   ['installFromUrl', (api, p) => api.installFromUrl(p?.url, p ?? {})],
+  ['renameConnection', (api, p) => api.renameConnection(p?.key, p?.name)],
   ['disconnect', (api, p) => api.disconnect(p?.key)],
   ['setEnabled', (api, p) => api.setEnabled(p?.key, p?.enabled !== false)],
   ['refreshCatalog', (api) => api.refreshCatalog()],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mcp-connector",
-  "version": "0.2.39",
+  "version": "0.2.40",
   "description": "DeepSeek Harness MCP Connector and MCP Server marketplace with over one hundred MCP connectors, continuously updated. Discover, authorize, and manage connections in one place; supports OAuth 2.0 PKCE, API keys, stdio/HTTP, mcpServers JSON import, and tool and prompt discovery. Maintained by Qichacha/QCC.",
   "type": "module",
   "main": "lib/index.js",

package/ui/index.html

@@ -1111,6 +1111,7 @@
 
   function rowHtml(r) {
     const key = esc(r.key);
+    const canRename = r.canRename === true;
     const authMode = r.authMode === 'oauth' ? '<span class="badge auth-oauth">OAuth</span>' : `<span class="badge">${esc(r.authMode || 'manual')}</span>`;
     const healthLabels = { healthy: '已连接', unknown: '状态未知', configured: '已配置', reauth: '需重新授权', recovering: '自动重试中', degraded: '部分异常', unavailable: '连接异常', disabled: '已停用' };
     const healthClass = r.connectionState === 'healthy' ? 'pass' : ['reauth', 'recovering', 'degraded'].includes(r.connectionState) ? 'partial' : r.connectionState === 'unavailable' ? 'fail' : '';
@@ -1131,6 +1132,7 @@
         <input type="checkbox" ${enabled ? 'checked' : ''} onchange="window.__mcp.toggle('${key}', this.checked)">
         <span class="slider"></span>
       </label>
+      ${canRename ? `<button class="btn ghost" type="button" onclick="window.__mcp.openRename('${key}')">重命名</button>` : ''}
       <button class="btn ghost" type="button" onclick="window.__mcp.openScope('${key}')">范围</button>
       <button class="btn danger" onclick="window.__mcp.disconnect('${key}')">断开</button>
     </div>`;
@@ -1244,6 +1246,21 @@
       <div class="m-actions"><button class="btn ghost" type="button" onclick="window.__mcp.closeModal()">取消</button><button class="btn" type="button" onclick="window.__mcp.submitScopeChange()">预览并应用</button></div>`);
   }
 
+  function openRenameConnection(key) {
+    const item = installedItems.find((candidate) => candidate.key === key);
+    if (!item) { showToast('连接不存在，请刷新后重试', false); return; }
+    if (item.canRename !== true) {
+      showToast('市场连接器名称由目录维护', false);
+      return;
+    }
+    openModal('修改连接显示名', `
+      <div class="form-note"><strong>只修改页面显示名</strong>当前连接不会中断；<code>serverName</code>、工具前缀、作用范围和凭据均保持不变。</div>
+      <label for="rename-name">连接显示名（必填）</label><input id="rename-name" value="${esc(item.name)}" maxlength="80" autocomplete="off" />
+      <label for="rename-server-name">serverName（工具前缀，不可修改）</label><input id="rename-server-name" value="${esc(item.serverName || '')}" disabled />
+      <div class="inline-error" id="modal-error" tabindex="-1"></div>
+      <div class="m-actions"><button class="btn ghost" type="button" onclick="window.__mcp.closeModal()">取消</button><button class="btn" type="button" onclick="window.__mcp.submitRename('${esc(key)}')">保存显示名</button></div>`);
+  }
+
   function openAddConnection(mode = 'json', preset = {}) {
     const server = (preset.servers || [{}])[0] || {};
     if (mode === 'manual' && preset.id && ['bearer', 'api-key'].includes(preset.authMode)) {
@@ -1371,6 +1388,18 @@
       if (connectorId) return window.__mcp.connect(connectorId);
     },
     openScope(key) { openScopeManager(key); },
+    openRename(key) { openRenameConnection(key); },
+    async submitRename(key) {
+      const name = $('#rename-name')?.value.trim() || '';
+      if (!name) { showModalError('连接显示名不能为空'); return; }
+      setModalBusy(true);
+      const result = await call('renameConnection', { key, name });
+      setModalBusy(false);
+      if (!result.ok) { showModalError(result.message); return; }
+      closeModal();
+      showToast(result.message, true);
+      await loadInstalled();
+    },
     async submitScopeChange() {
       if (!pendingScopeKey) return;
       let target;