@deepseek-ai/dsh-client-ui-plugin-manager 0.1.7-alpha.2 → 0.1.7-rc.1

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/client/ui-plugin-manager/README.md
-README.md: a7e212adfc0b0ee03e4e8aa77fdf12cfa52205bf
-README.zh.md: be30b1af3624e6c5fa40fa6caf98f6d3e5bee323
+README.md: ae6bae12c8fead7ba4a4f3529a16b8a5225f9e3b
+README.zh.md: 4ee4871f69dbcf4e14cdaa931c041631780a6e38

package/README.md

@@ -25,7 +25,7 @@ Use the **Plugins** entry in the Web sidebar to manage the profile's installed b
 <a id="use-this-package"></a>
 ## Use this package
 
-Select **Plugins** in the sidebar. The page reads the inventory and the bundles through `api-remotes` when first opened; a Host without a managed profile shows the page as unavailable. **Official** comes first and lists the bundles the installation ships for switching on — off until switched on, without an uninstall, and tagged **Beta** where the feature is one — followed by the official plugins that registered a configuration page; **Installed** lists the bundles the profile holds. Cards are listed by name, so switching a bundle on or off does not move its card. A dependency without a bundle patch is not a plugin and is not listed unless the profile selects it, in which case it carries a problem tag. Global configuration remains in the Settings **Plugins** section.
+Select **Plugins** in the sidebar. The page reads the inventory and the bundles through `api-remotes` when first opened; a Host without a managed profile shows the page as unavailable. **Official** comes first and lists the bundles the installation ships for switching on — off until switched on, without an uninstall, and tagged **Experimental** for experimental features — followed by the official plugins that registered a configuration page; **Installed** lists the bundles the profile holds. Cards are listed by name, so switching a bundle on or off does not move its card. A dependency without a bundle patch is not a plugin and is not listed unless the profile selects it, in which case it carries a problem tag. Global configuration remains in the Settings **Plugins** section.
 
 Installed bundles and their plugin rows display their own title and description in the current UI language on cards and detail pages. Each field falls back from exported locale `meta` to the accessible `package.json` at that plugin address; the final title is the full package or module name, with no package description when both sources omit it. See [Plugin display metadata](../../../docs/cookbook/adding-a-package.md#plugin-display-metadata) for the author format. Bundle cards, details, and component rows display the image declared by their own `package.json.icon`; absent or undecodable images retain the default artwork. Installation previews still use registry or manifest information.
 
@@ -39,6 +39,8 @@ The Host sends GET requests to `https://registry.npmjs.org/-/ping` and `https://
 
 During preparation and download, **Cancel install** asks the Host to stop the run and waits for confirmation. Loading the bundle cannot be cancelled. Closing with ×, Escape, or the backdrop hides the dialog immediately and requests cancellation when possible. **View installation** reopens the same task with its output; another installation cannot start while its outcome is pending or unconfirmed. Confirmed cancellation returns to the spec and shows a toast; the manifest and lockfile are restored, while downloaded files can remain. A lost installation response triggers a request to recover the result; **Check installation status** and reconnect retry that request. If the Host has no active request, **Installation result unavailable** allows returning to editing after checking the plugin list. A cancellation sent before acceptance waits and retries automatically; a failed cancellation can be retried manually. Hidden tasks report their outcome through toasts without reopening the dialog.
 
+When the Host attributes a network failure or timeout to a GitHub address and offers npmmirror, the dialog says **Cannot access GitHub**, or **GitHub connection timed out** for a timeout, and offers **Use mainland China mirror** or **Cancel**. Choosing the mirror returns to an empty package-name field and remembers the selected registry without starting another installation. Other failures retain their existing diagnostics and actions. The mirror supplies registry packages and dependencies, not the GitHub repository itself.
+
 ### Switching a bundle
 
 A bundle's page shows its full package name under the title, the spec that installs it elsewhere. A bundle's switch changes its layer selection. A profile with HMR recomposes before the operation completes; one without HMR, and a bundle a higher layer overrides, say so in a toast. A bundle the Host cannot read carries a problem tag and its reason on its page and cannot be switched on; one that provides the management components stays locked. The Host answers with error codes, which the page's dictionary words; pnpm's and the Loader's own diagnostics are shown as they are. The page excludes built-in profile bundles from cards and counts even when the profile holds them as dependencies or the Host reports an error. The Host inventory remains complete; the Settings Plugins section's Plugin list tab inspects their plugins.
@@ -63,7 +65,7 @@ The bundle's patch must declare the row under that id, and the registration exis
 
 ### Detail page extension points
 
-A plugin with something to say about a bundle, a row, or an official plugin it does not own contributes to that object's page through three list slots the page declares: `plugins.detail.actions` for a control at the head of the page, before the page's own switch and uninstall; `plugins.detail.badge` for a tag beside the title, after the version, beta, and problem tags; and `plugins.detail.section` for a section under the page's own content — after the rows on a bundle's page, after the configuration on a row's or an official plugin's page. Every entry is rendered with the page's `subject`: `{ kind: 'bundle', pkg }`, `{ kind: 'row', pkg, row }`, or `{ kind: 'item', id }`, where `pkg` and `row` carry the name, version, installed and enabled facts, and the row list a contribution decides on. An entry renders null for a subject it has nothing for and draws its own section chrome; the page orders entries by `order`.
+A plugin with something to say about a bundle, a row, or an official plugin it does not own contributes to that object's page through three list slots the page declares: `plugins.detail.actions` for a control at the head of the page, before the page's own switch and uninstall; `plugins.detail.badge` for a tag beside the title, after the version, experimental, and problem tags; and `plugins.detail.section` for a section under the page's own content — after the rows on a bundle's page, after the configuration on a row's or an official plugin's page. Every entry is rendered with the page's `subject`: `{ kind: 'bundle', pkg }`, `{ kind: 'row', pkg, row }`, or `{ kind: 'item', id }`, where `pkg` and `row` carry the name, version, installed and enabled facts, and the row list a contribution decides on. An entry renders null for a subject it has nothing for and draws its own section chrome; the page orders entries by `order`.
 
 ```tsx ignore-check
 ctx.slots.inject('plugins.detail.section', () => ctx.slots.register({
@@ -99,7 +101,7 @@ The browser plugin registers the `plugins` sidebar entry and its `main` panel th
 
 Custom item pages use the Host entry id as their registration id; row pages use the bundle package and row id. The page owner supplies `form.state` and `form.mutate(operations, expectedRevision)` when the entry exposes editable Config fields. A custom page owns its draft and validation display, and may reuse `ConfigField` from ui-primitives. Bundle-wide pages can contain several entries and have no single form.
 
-The page's `main` registration declares `plugins.item`, `plugins.bundle.config`, and `plugins.row.config` as its children, so the slots exist while the page does and a registrant's `ctx.slots.inject` waits for them. `configLedgerSource` projects the three ledgers into one observable — the official items in ledger order with their labels resolved in the active locale, and the bundle and row keys — cached until a ledger or the locale moves; the page binds it as `useConfigLedger` beside the store and never names a configurable plugin itself. Which page is open is page-local state: the cards, a bundle, an official plugin, or a row of a bundle. A registration lives with the browser half that made it. `dsh-client-modules` attaches a package's browser half to the Loader row whose specifier is the bare package name, so every page a bundle registers, for itself or for any of its rows, goes away when that row is switched off; a sub-plugin whose page must outlive the other rows ships as its own package. Official packages whose names begin with `@deepseek-ai/dsh-experimental-` display the Beta marker.
+The page's `main` registration declares `plugins.item`, `plugins.bundle.config`, and `plugins.row.config` as its children, so the slots exist while the page does and a registrant's `ctx.slots.inject` waits for them. `configLedgerSource` projects the three ledgers into one observable — the official items in ledger order with their labels resolved in the active locale, and the bundle and row keys — cached until a ledger or the locale moves; the page binds it as `useConfigLedger` beside the store and never names a configurable plugin itself. Which page is open is page-local state: the cards, a bundle, an official plugin, or a row of a bundle. A registration lives with the browser half that made it. `dsh-client-modules` attaches a package's browser half to the Loader row whose specifier is the bare package name, so every page a bundle registers, for itself or for any of its rows, goes away when that row is switched off; a sub-plugin whose page must outlive the other rows ships as its own package. Official packages whose names begin with `@deepseek-ai/dsh-experimental-` display the Experimental marker.
 
 `plugins.bundle.config` supplies bundle detail configuration, keyed by npm package name. `plugins.bundle.activation` offers bundle-owned guidance after explicit enablement from the list, with callbacks to dismiss it or open the bundle details. It does not appear merely because an enabled bundle was listed.
 

package/README.zh.md

@@ -25,7 +25,7 @@ kind: "package-reference"
 <a id="use-this-package"></a>
 ## 使用本包
 
-在侧栏选择**插件**。页面首次打开时通过 `api-remotes` 读取清单与组合包；没有受管 profile 的 Host 上页面显示为不可用。**官方**排在前面，列出安装随附、供开启的组合包——开启前保持关闭、没有卸载、属于 beta 功能的带 **Beta** 标签——其后是注册了配置页的官方插件；**已安装**列出 profile 持有的组合包。卡片按名称排序，启停组合包不会挪动它的卡片。没有组合包 patch 的依赖不是插件，除非 profile 选中了它才会带异常标签列出。全局配置仍在设置的**插件**分区中编辑。
+在侧栏选择**插件**。页面首次打开时通过 `api-remotes` 读取清单与组合包；没有受管 profile 的 Host 上页面显示为不可用。**官方**排在前面，列出安装随附、供开启的组合包——开启前保持关闭、没有卸载、属于实验性功能的带**实验性**标签——其后是注册了配置页的官方插件；**已安装**列出 profile 持有的组合包。卡片按名称排序，启停组合包不会挪动它的卡片。没有组合包 patch 的依赖不是插件，除非 profile 选中了它才会带异常标签列出。全局配置仍在设置的**插件**分区中编辑。
 
 已安装的组合包及其插件行在卡片和详情页中，按当前界面语言显示各自的标题与描述。每个字段先读取导出的 locale `meta`，缺失时回退到该插件地址下可访问的 `package.json`；标题最终使用完整包名或模块名，两处都没有描述时不提供包描述。作者格式见[插件展示元信息](../../../docs/cookbook/adding-a-package.zh.md#plugin-display-metadata)。组合包卡片、详情和组件行显示各自 `package.json.icon` 声明的图片；未声明或无法解码时保留默认插画。安装预览仍使用注册表或 manifest 信息。
 
@@ -39,6 +39,8 @@ Host 通过普通 fetch 代理向 `https://registry.npmjs.org/-/ping` 和 `https
 
 准备和下载期间，**取消安装**会请求 Host 停止运行并等待确认。加载组合包的阶段不可取消。点击 ×、按 Escape 或点击遮罩会立即隐藏对话框，并在可以取消时请求取消。**查看安装任务**会重新打开同一任务并保留输出；结果待定或尚未确认时不能发起另一项安装。确认取消后回到 spec 输入界面并显示 toast；manifest 与 lockfile 已恢复，已下载文件可能保留。安装响应丢失后会请求恢复结果；**核对安装状态**和重连会重试该请求。Host 已无活动请求时，**未能获取安装结果**允许检查插件列表后返回编辑。早于接收确认的取消请求会等待并自动重试；取消失败可手动重试。隐藏的任务通过 toast 通知结果，不会重新弹出对话框。
 
+Host 将网络失败或超时归因于 GitHub 地址，且提供 npmmirror 时，对话框显示**无法访问 GitHub**，超时时显示**连接 GitHub 超时**，提供**改用国内镜像**和**取消**。选择镜像后回到空的包名输入框，记住所选安装源，不自动开始下一次安装。其他失败保留原有诊断和操作。镜像提供注册表中的包及依赖，不代替 GitHub 仓库下载。
+
 ### 切换一个组合包
 
 组合包页面在标题下方显示完整包名，也就是在别处安装它所需的 spec。组合包开关改变其层选择。启用了 HMR 的 profile 在操作完成前重组；没有 HMR 的 profile，以及被更高层覆盖的组合包，会以 toast 说明。Host 读不了的组合包带异常标签，其页面给出原因，且不能打开；提供管理组件的组合包保持锁定。Host 以错误码作答，由页面字典措辞；pnpm 与 Loader 自己的诊断原样显示。页面从卡片与数量中排除内置 profile 组合包，即使 profile 将它们列为依赖或 Host 报告了异常。Host 清单仍保留完整数据；设置中「插件」分区的「插件列表」标签页负责查看它们的插件。
@@ -63,7 +65,7 @@ ctx.slots.inject('plugins.row.config', () => ctx.slots.register({
 
 ### 详情页扩展点
 
-对某个不属于自己的组合包、行或官方插件有话要说的插件，通过本页声明的三个 list slot 向该对象的页面贡献内容：`plugins.detail.actions` 在页头放一个控件，位于页面自己的开关和卸载之前；`plugins.detail.badge` 在标题旁放一个标签，位于版本、Beta 和异常标签之后；`plugins.detail.section` 在页面自身内容之下放一个区块——组合包页在组件列表之后，行页和官方插件页在配置之后。每个条目都以页面的 `subject` 渲染：`{ kind: 'bundle', pkg }`、`{ kind: 'row', pkg, row }` 或 `{ kind: 'item', id }`，其中 `pkg` 与 `row` 携带包名、版本、是否已安装、是否启用以及行列表这些供贡献者判断的事实。条目对无话可说的 subject 返回 null，自绘区块外观；页面按 `order` 排列条目。
+对某个不属于自己的组合包、行或官方插件有话要说的插件，通过本页声明的三个 list slot 向该对象的页面贡献内容：`plugins.detail.actions` 在页头放一个控件，位于页面自己的开关和卸载之前；`plugins.detail.badge` 在标题旁放一个标签，位于版本、实验性和异常标签之后；`plugins.detail.section` 在页面自身内容之下放一个区块——组合包页在组件列表之后，行页和官方插件页在配置之后。每个条目都以页面的 `subject` 渲染：`{ kind: 'bundle', pkg }`、`{ kind: 'row', pkg, row }` 或 `{ kind: 'item', id }`，其中 `pkg` 与 `row` 携带包名、版本、是否已安装、是否启用以及行列表这些供贡献者判断的事实。条目对无话可说的 subject 返回 null，自绘区块外观；页面按 `order` 排列条目。
 
 ```tsx ignore-check
 ctx.slots.inject('plugins.detail.section', () => ctx.slots.register({
@@ -99,7 +101,7 @@ Host 入口通过生成的 Remote 接口暴露 `pluginRegistryProbe.fastest()`
 
 自定义条目页以 Host 条目 id 作为注册 id；行页面使用 bundle 包名和行 id。当条目提供可编辑 Config 字段时，页面宿主传入 `form.state` 和 `form.mutate(operations, expectedRevision)`。自定义页面负责草稿和校验提示，并可复用 ui-primitives 的 `ConfigField`。整个 bundle 的页面可以包含多个条目，因此没有单一表单。
 
-页面的 `main` 注册把 `plugins.item`、`plugins.bundle.config` 与 `plugins.row.config` 声明为子 slot，因此它们与页面同生，注册方的 `ctx.slots.inject` 会等到它们出现。`configLedgerSource` 把三份账本投影成一个可观察对象——按账本顺序排列、标签按当前语言解析的官方条目，以及组合包与行的键——在账本或语言变化前保持缓存；页面把它作为 `useConfigLedger` 绑在 store 旁边，自身从不点名任何可配置插件。打开的是哪一页是页面本地状态：卡片、某个组合包、某个官方插件，或组合包的某一行。注册与做出它的浏览器半侧同生共死。`dsh-client-modules` 只把一个包的浏览器半侧挂在说明符恰为包名的那一行 Loader 行上，所以组合包为自己或任一行注册的页面，都会在那一行被关闭时一起消失；需要在其他行关闭时仍保留页面的子插件，应作为独立的包发布。 名称以 `@deepseek-ai/dsh-experimental-` 开头的官方包显示 Beta 标记。
+页面的 `main` 注册把 `plugins.item`、`plugins.bundle.config` 与 `plugins.row.config` 声明为子 slot，因此它们与页面同生，注册方的 `ctx.slots.inject` 会等到它们出现。`configLedgerSource` 把三份账本投影成一个可观察对象——按账本顺序排列、标签按当前语言解析的官方条目，以及组合包与行的键——在账本或语言变化前保持缓存；页面把它作为 `useConfigLedger` 绑在 store 旁边，自身从不点名任何可配置插件。打开的是哪一页是页面本地状态：卡片、某个组合包、某个官方插件，或组合包的某一行。注册与做出它的浏览器半侧同生共死。`dsh-client-modules` 只把一个包的浏览器半侧挂在说明符恰为包名的那一行 Loader 行上，所以组合包为自己或任一行注册的页面，都会在那一行被关闭时一起消失；需要在其他行关闭时仍保留页面的子插件，应作为独立的包发布。 名称以 `@deepseek-ai/dsh-experimental-` 开头的官方包显示实验性标记。
 
 `plugins.bundle.config` 以 npm 包名为 key，提供 Bundle 详情配置。`plugins.bundle.activation` 在用户从列表显式启用后提供 Bundle 自有引导，并传入关闭引导和打开详情的回调。仅列出已启用的 Bundle 不会触发引导。
 

package/lib/client.js

@@ -152,6 +152,7 @@ window.__ModuleLoader__.load({
 			"stop-profile": "reasonStopProfile",
 			"bundle-in-use": "reasonBundleInUse",
 			"stale-approval": "reasonStaleApproval",
+			"incompatible-version": "reasonIncompatibleVersionUnnamed",
 			"operation-error": "reasonOperationError"
 		};
 		/** The sentence a failed action opens with, by what was being done. */
@@ -163,13 +164,18 @@ window.__ModuleLoader__.load({
 			rowDisable: "failedRowDisable"
 		};
 		/**
-		* What a management error reads as: the code's sentence, or, for an
-		* operation error, the Host's diagnostic as it is.
-		* @param error - the Host's code and its diagnostic, when it has one.
+		* What a management error reads as: the code's sentence, one sentence per
+		* package an incompatibility names, or, for an operation error, the Host's diagnostic as it is.
+		* @param error - the Host's code, its diagnostic, and the packages an incompatibility names.
 		* @param t - the manager's translate seat.
 		* @returns the sentence.
 		*/
 		function managementText(error, t) {
+			if (error.code === "incompatible-version" && error.incompatible !== void 0 && error.incompatible.length > 0) return error.incompatible.map((plugin) => t("reasonIncompatibleVersion", {
+				plugin: `${plugin.name}@${plugin.version}`,
+				runtime: plugin.runtimeVersion,
+				peers: Object.entries(plugin.peers).map(([name, range]) => `${name} ${range}`).join(", ")
+			})).join(" ");
 			if (error.code !== "operation-error") return t(CODE_KEYS[error.code]);
 			return error.diagnostic === void 0 || error.diagnostic === "" ? t("reasonOperationError") : error.diagnostic;
 		}
@@ -227,7 +233,8 @@ window.__ModuleLoader__.load({
 				case "failed": {
 					const reason = notice.code === void 0 ? notice.reason : managementText({
 						code: notice.code,
-						diagnostic: notice.reason
+						diagnostic: notice.reason,
+						...notice.incompatible === void 0 ? {} : { incompatible: notice.incompatible }
 					}, t);
 					return t(FAILED_KEYS[notice.action], { reason: reason === "" ? t("reasonOperationError") : reason });
 				}
@@ -265,14 +272,27 @@ window.__ModuleLoader__.load({
 		function isInstallPending(phase) {
 			return phase === "starting" || phase === "running" || phase === "cancelling" || phase === "applying" || phase === "unconfirmed";
 		}
+		/**
+		* Offer the configured mainland mirror after a confirmed GitHub connection failure.
+		* @param install - the installation and the Host's failure attribution.
+		* @returns the offered mirror URL, or undefined when this recovery does not apply.
+		*/
+		function githubRecoveryRegistry(install) {
+			if (install.phase !== "failed" || install.failure?.failedAt !== "spec-host" || install.failure.kind !== "network" && install.failure.kind !== "timeout") return void 0;
+			const host = install.subject?.host?.toLowerCase().split(":")[0];
+			if (host !== "github.com" && !host?.endsWith(".github.com")) return void 0;
+			return offeredRegistries(install.registries).find((registry) => registry !== null && new URL(registry).hostname === "registry.npmmirror.com");
+		}
 		/** A refused answer or a change the Host could not apply, carrying what it said and, for a refusal, its code. */
 		var RemoteAnswerError = class extends Error {
 			reason;
 			code;
-			constructor(reason, code) {
+			incompatible;
+			constructor(reason, code, incompatible) {
 				super(reason);
 				this.reason = reason;
 				this.code = code;
+				this.incompatible = incompatible;
 				this.name = "RemoteAnswerError";
 			}
 		};
@@ -281,6 +301,7 @@ window.__ModuleLoader__.load({
 			return {
 				reason: error?.diagnostic ?? "",
 				...error === void 0 ? {} : { code: error.code },
+				...error?.incompatible === void 0 ? {} : { incompatible: error.incompatible },
 				...kind === void 0 ? {} : { kind },
 				...failedAt === void 0 ? {} : { failedAt },
 				...pendingBuilds === void 0 || pendingBuilds.length === 0 ? {} : { pendingBuilds }
@@ -289,10 +310,12 @@ window.__ModuleLoader__.load({
 		/** The notice a thrown failure becomes: a refusal keeps its code, anything else its words. */
 		function failedNotice(error, subject, seq) {
 			const code = error instanceof RemoteAnswerError ? error.code : void 0;
+			const incompatible = error instanceof RemoteAnswerError ? error.incompatible : void 0;
 			return {
 				kind: "failed",
 				reason: reasonOf(error),
 				...code === void 0 ? {} : { code },
+				...incompatible === void 0 ? {} : { incompatible },
 				...subject,
 				seq
 			};
@@ -374,13 +397,14 @@ window.__ModuleLoader__.load({
 		};
 		/** The dialog back at its spec: the run and its outcome forgotten, the spec and the registries kept. */
 		function specAgain(install) {
-			const { open, spec, registries, registry } = install;
+			const { open, spec, registries, registry, mirrorRecovery } = install;
 			return {
 				...IDLE_INSTALL,
 				open,
 				spec,
 				registries,
-				registry
+				registry,
+				...mirrorRecovery === void 0 ? {} : { mirrorRecovery }
 			};
 		}
 		/**
@@ -530,6 +554,22 @@ window.__ModuleLoader__.load({
 							registryOpen: true
 						} });
 					},
+					useGithubMirror: () => {
+						const install = this.getSnapshot().install;
+						const mirror = githubRecoveryRegistry(install);
+						if (mirror === void 0) return;
+						const registry = {
+							kind: "offered",
+							registry: mirror
+						};
+						this.registryMemory.set(registry);
+						this.patch({ install: {
+							...specAgain(install),
+							spec: "",
+							mirrorRecovery: true,
+							registry
+						} });
+					},
 					approveBuildsAndRetry: () => {
 						this.approveBuildsAndRetry();
 					},
@@ -1074,7 +1114,7 @@ window.__ModuleLoader__.load({
 				if (!answer.ok) throw new RemoteAnswerError(answer.error.message);
 				const result = answer.value;
 				switch (result.application) {
-					case "failed": throw new RemoteAnswerError(result.error?.diagnostic ?? "", result.error?.code);
+					case "failed": throw new RemoteAnswerError(result.error?.diagnostic ?? "", result.error?.code, result.error?.incompatible);
 					case "cancelled":
 						this.patch({ notice: {
 							kind: "cancelled",
@@ -1996,6 +2036,10 @@ window.__ModuleLoader__.load({
 		*/
 		function failureText(failure, t, install) {
 			if (failure === null) return t("installFailureGeneric");
+			if (failure.code === "incompatible-version") return managementText({
+				code: failure.code,
+				...failure.incompatible === void 0 ? {} : { incompatible: failure.incompatible }
+			}, t);
 			if (failure.kind === "build-blocked" && !failure.pendingBuilds?.length) return t("installFailureBuildBlockedManual");
 			const host = install?.subject?.host;
 			if (failure.failedAt === "spec-host" && host !== void 0) return t("installFailureNetworkHost", { host });
@@ -2037,7 +2081,7 @@ window.__ModuleLoader__.load({
 		* and failed screens over the same subject card. A failed run that left
 		* install scripts undecided shows them for approval in place of plain retry.
 		*/
-		function InstallDialog({ install, t, onClose, onEditSpec, onRun, onCancel, onReconcile, onToggleDetails, onEnableNow, onApproveBuilds, onToggleRegistry, onChooseRegistry, onChangeRegistry }) {
+		function InstallDialog({ install, t, onClose, onEditSpec, onRun, onCancel, onReconcile, onToggleDetails, onEnableNow, onApproveBuilds, onToggleRegistry, onChooseRegistry, onChangeRegistry, onUseGithubMirror }) {
 			const errorId = (0, react.useId)();
 			const guideId = (0, react.useId)();
 			const approvalId = (0, react.useId)();
@@ -2069,6 +2113,23 @@ window.__ModuleLoader__.load({
 					document.removeEventListener("keydown", onKeyDown, true);
 				};
 			}, [registryShown, onToggleRegistry]);
+			if (githubRecoveryRegistry(install) !== void 0) return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Modal, {
+				open: install.open,
+				onClose,
+				title: t(install.failure?.kind === "timeout" ? "installGithubTimeoutTitle" : "installGithubFailedTitle"),
+				closeLabel: t("close"),
+				description: t("installGithubFailedDescription"),
+				footer: (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+					variant: "outline",
+					onClick: onClose,
+					children: t("cancel")
+				}), (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+					variant: "primary",
+					autoFocus: true,
+					onClick: onUseGithubMirror,
+					children: t("installUseGithubMirror")
+				})] })
+			});
 			if (phase === "idle" || phase === "checking") {
 				const checking = phase === "checking";
 				const empty = install.spec.trim() === "";
@@ -2083,7 +2144,7 @@ window.__ModuleLoader__.load({
 					onClose,
 					title: t("installTitle"),
 					closeLabel: t("close"),
-					description: t("installDescription"),
+					...install.mirrorRecovery ? {} : { description: t("installDescription") },
 					className: PluginManagerPage_module_css_default.installDialog,
 					contentClassName: PluginManagerPage_module_css_default.installContent,
 					footer: (0, react_jsx_runtime.jsxs)(_deepseek_ai_dsh_client_ui_primitives.Button, {
@@ -2101,10 +2162,11 @@ window.__ModuleLoader__.load({
 								className: PluginManagerPage_module_css_default.installField,
 								children: (0, react_jsx_runtime.jsx)("input", {
 									type: "text",
+									autoFocus: install.mirrorRecovery === true,
 									value: install.spec,
 									placeholder: t("installSpecPlaceholder"),
 									disabled: checking,
-									"aria-label": t("installSpecLabel"),
+									"aria-label": t(install.mirrorRecovery ? "installPackageLabel" : "installSpecLabel"),
 									"aria-invalid": install.inputError !== null,
 									"aria-describedby": install.inputError === null ? void 0 : errorId,
 									onChange: (event) => {
@@ -2824,7 +2886,8 @@ window.__ModuleLoader__.load({
 						onApproveBuilds: props.approveBuildsAndRetry,
 						onToggleRegistry: props.toggleRegistryOptions,
 						onChooseRegistry: props.chooseRegistry,
-						onChangeRegistry: props.changeRegistry
+						onChangeRegistry: props.changeRegistry,
+						onUseGithubMirror: props.useGithubMirror
 					}),
 					state.confirm === null ? null : (0, react_jsx_runtime.jsx)(ConfirmDialog, {
 						name: packageText(state.packages.find((pkg) => pkg.name === state.confirm?.packageName) ?? { name: state.confirm.packageName }, resolveText).title,
@@ -2865,7 +2928,7 @@ window.__ModuleLoader__.load({
 			bundlesTitle: "已安装",
 			officialTitle: "官方",
 			statusProblem: "异常",
-			statusBeta: "Beta",
+			statusBeta: "实验性",
 			reasonLabel: "原因",
 			metadataError: "包元信息错误：{error}",
 			versionTag: "v{version}",
@@ -2935,6 +2998,11 @@ window.__ModuleLoader__.load({
 			installingTitle: "插件安装中…",
 			installedTitle: "已安装",
 			installFailedTitle: "插件安装失败",
+			installGithubFailedTitle: "无法访问 GitHub",
+			installGithubTimeoutTitle: "连接 GitHub 超时",
+			installGithubFailedDescription: "请尝试其他安装来源。",
+			installUseGithubMirror: "改用国内镜像",
+			installPackageLabel: "插件包名",
 			installEdit: "编辑",
 			installEditAria: "返回编辑",
 			installCancelAndEdit: "取消安装并返回编辑",
@@ -3026,6 +3094,8 @@ window.__ModuleLoader__.load({
 			reasonStopProfile: "这个 profile 没有启用 HMR，正在使用的包要停止后用 dsh plugin 卸载",
 			reasonBundleInUse: "其他配置仍在使用这个组合包的组件，请先停用它们",
 			reasonStaleApproval: "待允许的安装脚本列表已变化，请重新安装以刷新",
+			reasonIncompatibleVersion: "{plugin} 与 DSH {runtime} 不兼容（要求 {peers}），运行它可能导致崩溃或数据丢失。请安装与当前 DSH 兼容的插件版本。",
+			reasonIncompatibleVersionUnnamed: "这个插件与当前 DSH 版本不兼容，运行它可能导致崩溃或数据丢失",
 			reasonOperationError: "Host 报告了一个错误"
 		};
 		/** English dictionary checked against the Chinese key set. */
@@ -3045,7 +3115,7 @@ window.__ModuleLoader__.load({
 			bundlesTitle: "Installed",
 			officialTitle: "Official",
 			statusProblem: "Problem",
-			statusBeta: "Beta",
+			statusBeta: "Experimental",
 			reasonLabel: "Reason",
 			metadataError: "Package metadata error: {error}",
 			versionTag: "v{version}",
@@ -3115,6 +3185,11 @@ window.__ModuleLoader__.load({
 			installingTitle: "Installing the plugin…",
 			installedTitle: "Installed",
 			installFailedTitle: "The plugin could not be installed",
+			installGithubFailedTitle: "Cannot access GitHub",
+			installGithubTimeoutTitle: "GitHub connection timed out",
+			installGithubFailedDescription: "Try another installation source.",
+			installUseGithubMirror: "Use mainland China mirror",
+			installPackageLabel: "Plugin package name",
 			installEdit: "Edit",
 			installEditAria: "Back to editing",
 			installCancelAndEdit: "Cancel installation and return to editing",
@@ -3206,6 +3281,8 @@ window.__ModuleLoader__.load({
 			reasonStopProfile: "This profile runs without HMR; stop it and uninstall the package with dsh plugin.",
 			reasonBundleInUse: "Other configuration still uses this bundle's components; switch them off first.",
 			reasonStaleApproval: "The pending script approvals changed; install again to refresh them.",
+			reasonIncompatibleVersion: "{plugin} is incompatible with DSH {runtime} (requires {peers}); running it may cause crashes or data loss. Install a plugin version compatible with this DSH.",
+			reasonIncompatibleVersionUnnamed: "This plugin is incompatible with the running DSH version; running it may cause crashes or data loss.",
 			reasonOperationError: "The Host reported an error."
 		};
 		//#endregion

package/lib/types/client/locales.d.ts

@@ -86,6 +86,11 @@ export declare const zh: {
     installingTitle: string;
     installedTitle: string;
     installFailedTitle: string;
+    installGithubFailedTitle: string;
+    installGithubTimeoutTitle: string;
+    installGithubFailedDescription: string;
+    installUseGithubMirror: string;
+    installPackageLabel: string;
     installEdit: string;
     installEditAria: string;
     installCancelAndEdit: string;
@@ -177,6 +182,8 @@ export declare const zh: {
     reasonStopProfile: string;
     reasonBundleInUse: string;
     reasonStaleApproval: string;
+    reasonIncompatibleVersion: string;
+    reasonIncompatibleVersionUnnamed: string;
     reasonOperationError: string;
 };
 /** Plugin manager locale key union. */
@@ -268,6 +275,11 @@ export declare const en: {
     installingTitle: string;
     installedTitle: string;
     installFailedTitle: string;
+    installGithubFailedTitle: string;
+    installGithubTimeoutTitle: string;
+    installGithubFailedDescription: string;
+    installUseGithubMirror: string;
+    installPackageLabel: string;
     installEdit: string;
     installEditAria: string;
     installCancelAndEdit: string;
@@ -359,6 +371,8 @@ export declare const en: {
     reasonStopProfile: string;
     reasonBundleInUse: string;
     reasonStaleApproval: string;
+    reasonIncompatibleVersion: string;
+    reasonIncompatibleVersionUnnamed: string;
     reasonOperationError: string;
 };
 //# sourceMappingURL=locales.d.ts.map

package/lib/types/client/manager-store.d.ts

@@ -6,7 +6,7 @@
  * change made on another surface shows here without a manual refresh.
  */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
-import type { BundleInfo, ManagementError, PluginEntryId, PluginInfo, PluginInspectProblem, PluginInstallFailureKind, PluginInstallLogChunk, PluginInstallProgress, PluginInstallRequestId, PluginRegistries, PluginSpecInspection, ReadOnlyReason, Registry } from '@deepseek-ai/dsh-api-remotes/client';
+import type { BundleInfo, IncompatiblePlugin, ManagementError, PluginEntryId, PluginInfo, PluginInspectProblem, PluginInstallFailureKind, PluginInstallLogChunk, PluginInstallProgress, PluginInstallRequestId, PluginRegistries, PluginSpecInspection, ReadOnlyReason, Registry } from '@deepseek-ai/dsh-api-remotes/client';
 import { type SnapshotStore } from '@deepseek-ai/dsh-client-store';
 import type { HostObservable } from '@deepseek-ai/dsh-client-ui-slots';
 import type { LocalizedText, PluginLocalizedMeta } from '@deepseek-ai/dsh-package-manifest';
@@ -38,6 +38,8 @@ export type ManagerNotice = {
     readonly code?: ManagementError['code'];
     /** The Host's diagnostic or the transport's words, shown verbatim; empty when the code says it all. */
     readonly reason: string;
+    /** The packages an `incompatible-version` refusal names. */
+    readonly incompatible?: readonly IncompatiblePlugin[];
     readonly packageName?: string;
     readonly seq: number;
 };
@@ -127,6 +129,8 @@ export interface InstallState {
     readonly open: boolean;
     /** The package spec as typed. */
     readonly spec: string;
+    /** The spec form was reopened after switching away from a failed GitHub address. */
+    readonly mirrorRecovery?: boolean;
     /** The registries the Host configured, read when the dialog opens; null until the Host answered. */
     readonly registries: PluginRegistries | null;
     /** The registry this install asks first: the one last used, else the Host's first. */
@@ -166,6 +170,8 @@ export interface InstallState {
     readonly failure: {
         readonly reason: string;
         readonly code?: ManagementError['code'];
+        /** The packages an `incompatible-version` refusal names. */
+        readonly incompatible?: readonly IncompatiblePlugin[];
         readonly kind?: PluginInstallFailureKind;
         /** What the last failed run could not reach, as the Host attributed it: the registry, or the spec's own host. */
         readonly failedAt?: 'registry' | 'spec-host';
@@ -183,6 +189,12 @@ export interface InstallState {
  * @returns true while a Host result or a check for an active request is outstanding.
  */
 export declare function isInstallPending(phase: InstallState['phase']): boolean;
+/**
+ * Offer the configured mainland mirror after a confirmed GitHub connection failure.
+ * @param install - the installation and the Host's failure attribution.
+ * @returns the offered mirror URL, or undefined when this recovery does not apply.
+ */
+export declare function githubRecoveryRegistry(install: InstallState): string | undefined;
 /** A destructive action waiting for the user's confirmation: a package's uninstall. */
 export interface ConfirmState {
     readonly action: 'uninstall';
@@ -231,6 +243,8 @@ export interface PluginManagerFace {
     chooseRegistry: (choice: RegistryChoice) => void;
     /** From the failed screen: back to the spec with the registry options unfolded. */
     changeRegistry: () => void;
+    /** Return from a GitHub connection failure to an empty spec with the offered mainland mirror selected. */
+    useGithubMirror: () => void;
     /** Allow the install scripts the failed run left pending, saved for this profile, and run the same spec again. */
     approveBuildsAndRetry: () => void;
     /** Leave the check or the failed screen for the spec, or ask the Host to stop the run and wait for its cleanup. */

package/lib/types/client/presentation.d.ts

@@ -1,5 +1,5 @@
 /** Display labels and toast sentences for global plugin management. */
-import type { ManagementError, Registry } from '@deepseek-ai/dsh-api-remotes/client';
+import type { IncompatiblePlugin, ManagementError, Registry } from '@deepseek-ai/dsh-api-remotes/client';
 import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { ManagerNotice, PackageRow, PackageView, PluginManagerFace } from './manager-store.ts';
 /** The translate seat of the manager's dictionary. */
@@ -17,15 +17,16 @@ export declare function registryText(registry: Registry, t: Translate, resolved:
     host: string;
 };
 /**
- * What a management error reads as: the code's sentence, or, for an
- * operation error, the Host's diagnostic as it is.
- * @param error - the Host's code and its diagnostic, when it has one.
+ * What a management error reads as: the code's sentence, one sentence per
+ * package an incompatibility names, or, for an operation error, the Host's diagnostic as it is.
+ * @param error - the Host's code, its diagnostic, and the packages an incompatibility names.
  * @param t - the manager's translate seat.
  * @returns the sentence.
  */
 export declare function managementText(error: {
     readonly code: ManagementError['code'];
     readonly diagnostic?: string;
+    readonly incompatible?: readonly IncompatiblePlugin[];
 }, t: Translate): string;
 /**
  * Compact a package name to what a person calls it.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-plugin-manager",
   "description": "Plugin management for the dsh web client: the sidebar Plugins panel installs, enables, disables, retries, and composes installed plugin packages",
-  "version": "0.1.7-alpha.2",
+  "version": "0.1.7-rc.1",
   "publishConfig": {
     "access": "public"
   },
@@ -56,19 +56,19 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-api-remotes": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-store": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-layout": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-package-manifest": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-util-crypto": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-plugin-manager": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-alpha.2"
+    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-api-remotes": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-store": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-layout": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-package-manifest": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-util-crypto": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-plugin-manager": "0.1.7-rc.1"
   },
   "files": [
     "lib/index.js",
@@ -81,9 +81,9 @@
   ],
   "dependencies": {
     "zod": "^4.4.3",
-    "@deepseek-ai/dsh-timeout": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-timeout": "0.1.7-rc.1",
     "@deepseek-ai/schemastery": "~3.18.4",
-    "@deepseek-ai/dsh-typert-protocol": "0.1.7-alpha.2"
+    "@deepseek-ai/dsh-typert-protocol": "0.1.7-rc.1"
   },
   "scripts": {
     "bundle": "tsdown",