dsh-mcp-connector 0.2.28 → 0.2.29

package/CHANGELOG.md

@@ -4,6 +4,13 @@
 
 ## [Unreleased]
 
+## [0.2.29] - 2026-08-30
+
+### Fixed
+
+- 更新服务返回 `RELEASE_TOO_FRESH` 时明确提示“发布安全等待期”，不再误写为镜像同步；主动跳过等待的操作也改为“立即更新（跳过等待）”。
+- DSH Desktop 或其他无兼容 Update Provider 的宿主直接展示精确版本升级命令，并支持一键复制与打开 npm 页面，不再只给出泛化的“查看更新方式”。
+
 ## [0.2.28] - 2026-08-29
 
 ### Documentation
@@ -449,7 +456,8 @@
 - 外部 URL 与导入 Header 执行安全校验。
 - iframe 消息校验同源和消息来源。
 
-[Unreleased]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.28...HEAD
+[Unreleased]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.29...HEAD
+[0.2.29]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.28...v0.2.29
 [0.2.28]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.27...v0.2.28
 [0.2.27]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.26...v0.2.27
 [0.2.26]: https://github.com/duhu2000/dsh-mcp-connector/compare/v0.2.25...v0.2.26

package/README.en.md

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

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

package/docs/PLUGIN-UPDATE.md

@@ -25,7 +25,9 @@ DSH Market 适配器从 `GET /dsh-market/api/v1/capabilities` 开始，要求 `s
 5. 完整性校验通过后，按 Provider 返回的激活结论展示“刷新生效”或重启提示。Web 且 Provider 明确允许进程重启时才展示“立即重启”；Desktop 等由外壳管理生命周期的宿主只提示用户重启，不自行杀进程。
 6. Provider 保留恢复点时展示“回滚”。回滚仍由 Provider 执行，MCP连接器不直接修改 profile、lockfile 或 `node_modules`。
 
-失败结果使用稳定代码区分正在运行的 Agent、其他安装任务占用、镜像同步、版本未变化、超时和权限拒绝，以及 `DOWNGRADE_DETECTED`、`RESOLVED_VERSION_MISMATCH`、`INVALID_UPDATE_RESULT` 三类完整性故障。可重试失败保留重试操作；Registry 刚发布但镜像仍未同步时，用户可在看到明确提示后选择强制重试。
+失败结果使用稳定代码区分正在运行的 Agent、其他安装任务占用、发布安全等待、镜像同步、版本未变化、超时和权限拒绝，以及 `DOWNGRADE_DETECTED`、`RESOLVED_VERSION_MISMATCH`、`INVALID_UPDATE_RESULT` 三类完整性故障。`RELEASE_TOO_FRESH` 明确显示为约 24 小时的发布安全等待期，并提供“立即更新（跳过等待）”；真正的镜像同步故障保留独立提示，不再混用同一文案。
+
+当 DSH Desktop 或其他宿主没有兼容 Update Provider 时，标题区直接展示绑定 npm 精确版本的 CLI 命令，例如 `dsh plugin --profile web add --config.minimumReleaseAge=0 dsh-mcp-connector@<目标版本>`，并提供复制按钮与 npm 页面入口。运行时会把 `<目标版本>` 替换为 npm 已发布的确切版本；命令中的单次覆盖只用于用户主动跳过本次发布安全等待。Connector 仍不自行执行包管理器命令。
 
 ## 安全边界
 

package/docs/screenshots/README.md

@@ -0,0 +1,27 @@
+# UI 素材说明
+
+本目录用于保存 `dsh-mcp-connector` 的公开界面截图。素材于 2026-08-24
+从本机 DSH `web` + `dsh-mcp-connector@0.2.18`（0.2.19 未改动市场 UI）验收环境采集；
+远程 Registry 为当日 `main` 的 61 条描述，和 4 张随包卡片合并后市场显示 65 张。画面只展示
+公开市场元数据、示例 Prompt 和工具名称/说明，不包含 OAuth Token、API Key、本机路径、
+用户会话或查询结果。
+
+仓库根目录的 [`screenshots.json`](../../screenshots.json) 按市场总览、连接器详情、工具发现、
+JSON 导入的顺序声明这 4 张图片，供 awesome-dsh-plugin 和 DSH Market 的 App Store 风格详情页
+直接采集。`npm run storefront:check` 会校验数量、相对路径、格式、重复项与文件存在性；
+`npm run check` 已包含该门禁。
+
+| 文件 | 展示内容 |
+|---|---|
+| `01-market-overview.jpg` | 65 张合并市场卡片（61 条 Registry + 4 张随包卡片）、推荐章节、9 分类和固定分类栏 |
+| `02-connector-detail.jpg` | Seedream 第三方服务说明、精选 Prompt 和未连接状态 |
+| `03-tool-discovery.jpg` | 北大法宝多 Server 工具数量、描述、搜索和独立滚动区 |
+| `04-json-import.jpg` | Streamable HTTP / stdio JSON 导入与本机凭据提示 |
+
+`../demo.gif` 由以上 4 个状态生成，时长 16 秒，分辨率 960×540。更新 UI 后应使用 1280×720
+浏览器视口重新采集，并检查画面不包含凭据、本机路径、真实会话、查询结果或其他
+不应公开的内容。若使用实机已安装连接器采集，只能展示公开工具名称/说明，不得展示
+输入表单中的真实凭据或工具调用结果。
+
+截图中的“已安装”数量和连接状态来自采集时的本机验收环境，仅用于展示交互，会因用户
+安装情况、授权有效期和服务可用性而不同。

package/lib/client.js

@@ -135,6 +135,29 @@ window.__ModuleLoader__.load({
 	gap: 6px;
 	min-width: 0;
 }
+.mcpConnectorManualUpdate {
+	display: flex;
+	align-items: center;
+	gap: 6px;
+	min-width: 0;
+	flex: 1 1 360px;
+}
+.mcpConnectorManualCommand {
+	box-sizing: border-box;
+	min-width: 0;
+	max-width: 430px;
+	overflow-x: auto;
+	padding: 5px 8px;
+	color: #374151;
+	background: #f9fafb;
+	border: 1px solid #d1d5db;
+	border-radius: 8px;
+	font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+	font-size: 11px;
+	line-height: 1.35;
+	white-space: nowrap;
+	user-select: text;
+}
 .mcpConnectorUpdateStatus {
 	max-width: 240px;
 	overflow: hidden;
@@ -175,6 +198,7 @@ window.__ModuleLoader__.load({
 	.mcpConnectorUpdateButton:focus-visible { background: #3730a3; }
 	.mcpConnectorUpdateStatus { color: #bbf7d0; background: #14532d; }
 	.mcpConnectorUpdateStatus[data-tone="error"] { color: #fecaca; background: #7f1d1d; }
+	.mcpConnectorManualCommand { color: #e5e7eb; background: #111827; border-color: #4b5563; }
 	.mcpConnectorUpdateSecondary { color: #d1d5db; background: transparent; border-color: #4b5563; }
 	.mcpConnectorMarketClose { color: #c4c8d0; }
 	.mcpConnectorMarketClose:hover,
@@ -361,7 +385,8 @@ window.__ModuleLoader__.load({
 			const labels = {
 				AGENTS_RUNNING: "有任务正在运行，请结束后重试",
 				OPERATION_BUSY: "插件市场正在处理其他任务",
-				RELEASE_TOO_FRESH: "新版本仍在镜像同步",
+				RELEASE_TOO_FRESH: "新版本处于发布安全等待期（约 24 小时）",
+				MIRROR_SYNC_PENDING: "镜像尚未同步完整安装包",
 				VERSION_UNCHANGED: "下载后版本未变化",
 				DOWNGRADE_DETECTED: "已阻止版本降级",
 				RESOLVED_VERSION_MISMATCH: "下载版本与预期不一致",
@@ -373,6 +398,21 @@ window.__ModuleLoader__.load({
 			return labels[failure?.code] ?? failure?.message ?? "更新失败";
 		}
 
+		function manualUpgradeCommand(version) {
+			const parsed = parseClientVersion(version);
+			if (parsed === null) return null;
+			return `dsh plugin --profile web add --config.minimumReleaseAge=0 ${PLUGIN_PACKAGE_NAME}@${parsed.normalized}`;
+		}
+
+		async function copyManualUpgradeCommand(command) {
+			if (typeof window.navigator?.clipboard?.writeText === "function") {
+				await window.navigator.clipboard.writeText(command);
+				return true;
+			}
+			window.prompt?.("请复制以下升级命令", command);
+			return false;
+		}
+
 		function parseClientVersion(value) {
 			if (typeof value !== "string") return null;
 			const normalized = value.trim().replace(/^v/i, "");
@@ -530,6 +570,7 @@ window.__ModuleLoader__.load({
 			const [updateStarting, setUpdateStarting] = (0, react.useState)(false);
 			const [rollbackRunning, setRollbackRunning] = (0, react.useState)(false);
 			const [restarting, setRestarting] = (0, react.useState)(false);
+			const [manualCommandCopied, setManualCommandCopied] = (0, react.useState)(false);
 			const frameRef = (0, react.useRef)(null);
 			const closeRef = (0, react.useRef)(null);
 			(0, react.useEffect)(() => {
@@ -600,6 +641,9 @@ window.__ModuleLoader__.load({
 					window.clearTimeout(pollTimer);
 				};
 			}, [open]);
+			(0, react.useEffect)(() => {
+				if (open) setManualCommandCopied(false);
+			}, [open, versionStatus?.latestVersion]);
 			(0, react.useEffect)(() => {
 				if (!open) return void 0;
 				let disposed = false;
@@ -788,7 +832,7 @@ window.__ModuleLoader__.load({
 								type: "button",
 								className: "mcpConnectorUpdateButton",
 								onClick: () => startUpdate(force),
-								children: force ? "强制重试" : "重试更新"
+								children: updateOperation.failure?.code === "RELEASE_TOO_FRESH" ? "立即更新（跳过等待）" : force ? "强制重试" : "重试更新"
 							}),
 							rollbackRunning && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								className: "mcpConnectorUpdateStatus",
@@ -887,12 +931,43 @@ window.__ModuleLoader__.load({
 						children: `一键更新到 v${providerUpdateCheck.latestVersion}`
 					});
 				}
+				const command = manualUpgradeCommand(versionStatus?.latestVersion);
+				if (command !== null) {
+					return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "mcpConnectorManualUpdate",
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", {
+								className: "mcpConnectorManualCommand",
+								title: command,
+								children: command
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "mcpConnectorUpdateButton",
+								onClick: () => {
+									copyManualUpgradeCommand(command).then((copied) => {
+										if (copied) setManualCommandCopied(true);
+									}, (error) => {
+										console.warn("[mcp-connector] copy upgrade command failed:", error);
+										window.prompt?.("请复制以下升级命令", command);
+									});
+								},
+								children: manualCommandCopied ? "已复制" : "复制升级命令"
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "mcpConnectorUpdateButton mcpConnectorUpdateSecondary",
+								onClick: () => window.open(NPM_PACKAGE_URL, "_blank", "noopener,noreferrer"),
+								children: "查看 npm"
+							})
+						]
+					});
+				}
 				return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 					type: "button",
 					className: "mcpConnectorUpdateButton",
-					title: `npm 已发布 v${versionStatus?.latestVersion}`,
 					onClick: () => openDshPluginMarket(actions),
-					children: `查看 v${versionStatus?.latestVersion} 更新方式`
+					children: "查看更新方式"
 				});
 			};
 			const src = window.location.origin + "/mcp-connector/ui/";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mcp-connector",
-  "version": "0.2.28",
+  "version": "0.2.29",
   "description": "Connect and manage MCP servers in DeepSeek Harness — a universal MCP connector and marketplace with OAuth 2.0 PKCE, API keys, stdio/HTTP, mcpServers JSON import, tools, and prompts. Maintained by Qichacha/QCC.",
   "type": "module",
   "main": "lib/index.js",
@@ -22,9 +22,11 @@
     "docs/PLUGIN-UPDATE.md",
     "docs/STDIO-SUPPORT.md",
     "docs/USER-GUIDE.md",
+    "docs/screenshots",
     "cordis.patch.yml",
     "README.md",
     "README.en.md",
+    "screenshots.json",
     "CONTRIBUTING.md",
     "CHANGELOG.md",
     "LICENSE",
@@ -35,15 +37,16 @@
   ],
   "scripts": {
     "test": "node --test",
-    "lint": "node --check lib/index.js && node --check lib/web.js && node --check lib/client.js && node --check lib/version-status.js && node --check lib/schema.js && node --check lib/catalog.js && node --check lib/prompts.js && node --check lib/probe.js && node --check lib/mcp-validation.js && node --check lib/mcp-http.js && node --check lib/migration.js && node --check lib/stores.js && node --check lib/grant-journal.js && node --check lib/oauth.js && node --check lib/grant-lifecycle.js && node --check lib/callback-server.js && node --check lib/mcp-provision.js && node --check lib/util.js && node --check lib/constants.js && node --check lib/tools.js && node --check lib/connectors/oauth-connector.js && node --check lib/connectors/manual-connector.js && node --check lib/connectors/json-connector.js && node --check scripts/probe-connector.mjs && node --check scripts/build-registry.mjs && node --check scripts/ui-harness.mjs && node --check scripts/check-market-registration.mjs && node --check scripts/check-readme-version.mjs && node --check scripts/sync-registry-stats.mjs",
+    "lint": "node --check lib/index.js && node --check lib/web.js && node --check lib/client.js && node --check lib/version-status.js && node --check lib/schema.js && node --check lib/catalog.js && node --check lib/prompts.js && node --check lib/probe.js && node --check lib/mcp-validation.js && node --check lib/mcp-http.js && node --check lib/migration.js && node --check lib/stores.js && node --check lib/grant-journal.js && node --check lib/oauth.js && node --check lib/grant-lifecycle.js && node --check lib/callback-server.js && node --check lib/mcp-provision.js && node --check lib/util.js && node --check lib/constants.js && node --check lib/tools.js && node --check lib/connectors/oauth-connector.js && node --check lib/connectors/manual-connector.js && node --check lib/connectors/json-connector.js && node --check scripts/probe-connector.mjs && node --check scripts/build-registry.mjs && node --check scripts/ui-harness.mjs && node --check scripts/check-market-registration.mjs && node --check scripts/check-readme-version.mjs && node --check scripts/check-storefront-screenshots.mjs && node --check scripts/sync-registry-stats.mjs",
     "registry:build": "node scripts/build-registry.mjs",
     "registry:validate": "node scripts/probe-connector.mjs catalog/catalog.json --validate-only",
     "dev:ui": "node scripts/ui-harness.mjs",
     "market:check": "node scripts/check-market-registration.mjs",
     "registry:stats:sync": "node scripts/sync-registry-stats.mjs",
     "docs:check": "node scripts/check-readme-version.mjs",
+    "storefront:check": "node scripts/check-storefront-screenshots.mjs",
     "verify-pack": "node scripts/verify-pack.mjs",
-    "check": "npm run lint && npm run docs:check && npm test && npm run verify-pack",
+    "check": "npm run lint && npm run docs:check && npm run storefront:check && npm test && npm run verify-pack",
     "prepublishOnly": "npm run check"
   },
   "keywords": [

package/screenshots.json

@@ -0,0 +1,6 @@
+[
+  "docs/screenshots/01-market-overview.jpg",
+  "docs/screenshots/02-connector-detail.jpg",
+  "docs/screenshots/03-tool-discovery.jpg",
+  "docs/screenshots/04-json-import.jpg"
+]