dsh-plugin 1.6.4 → 1.6.6

package/lib/services/install/task-queue.js

@@ -41,12 +41,30 @@ export function activeTask() {
     for (const item of queue) {
         const task = item.task;
         if (task.status === 'pending') {
-            found.push({ id: task.id, target: show(task), action: task.action, status: 'pending', progress: task.progress, lines: task.lines.slice(0, MAX_TASK_LINES), attempts: task.attempts, installChannel: task.installChannel });
+            found.push({
+                id: task.id,
+                target: show(task),
+                action: task.action,
+                status: 'pending',
+                progress: task.progress,
+                lines: task.lines.slice(0, MAX_TASK_LINES),
+                attempts: task.attempts,
+                installChannel: task.installChannel,
+            });
         }
     }
     tasks.forEach((task) => {
         if (task.status === 'running') {
-            found.unshift({ id: task.id, target: show(task), action: task.action, status: 'running', progress: task.progress, lines: task.lines.slice(0, MAX_TASK_LINES), attempts: task.attempts, installChannel: task.installChannel });
+            found.unshift({
+                id: task.id,
+                target: show(task),
+                action: task.action,
+                status: 'running',
+                progress: task.progress,
+                lines: task.lines.slice(0, MAX_TASK_LINES),
+                attempts: task.attempts,
+                installChannel: task.installChannel,
+            });
         }
     });
     return found;
@@ -117,7 +135,7 @@ function cliInvocation(profile) {
     if (entry !== undefined) {
         // 打包桌面端（Electron）：宿主入口在 app.asar 内，机器上根本没有 `dsh` 可执行文件
         //（Windows 那条 dsh.cmd shim 只存在于宿主进程自己的 PATH 里），直接回退 PATH 必然
-        // 报 [dsh-missing]（见 issue #71）。这里改用应用自己的 CLI 引导脚本调起同一份打包
+        // 报 [dsh-missing]。这里改用应用自己的 CLI 引导脚本调起同一份打包
         // CLI：Electron 可执行文件 + --expose-internals + desktop-cli.js，与内置终端、
         // 官方插件页安装完全同一条路径 —— desktop profile 由应用独占管理的授权也在其中。
         const bootstrap = desktopCliBootstrap(entry);
@@ -172,9 +190,8 @@ export function desktopCliBootstrap(entry) {
 }
 /**
  * dsh 命令存在性探测：which/where 找 PATH 里的 dsh。
- * Windows shell 模式命令缺失时 cmd 只输出 GBK 乱码「不是内部或外部命令」（UTF-8 解码后
- * 无法匹配），POSIX 非 shell 模式才会抛 spawn dsh ENOENT —— 两种形态都不可靠，统一在
- * spawn 前用 which/where 探测，命令不存在则直接失败并打 ASCII 标记 [dsh-missing]（乱码免疫）。
+ * 命令缺失时各平台报错形态不同（Windows shell 只回 GBK 乱码、POSIX 才抛 spawn ENOENT），
+ * 统一在 spawn 前用 which/where 探测，命令不存在则直接失败并打 ASCII 标记 [dsh-missing]（乱码免疫）。
  * 探测自身异常（which/where 不可用等）不拦截安装，交给装后校验兜底。
  */
 function dshOnPath(env) {
@@ -233,7 +250,22 @@ export function startPluginMutation(options) {
     // 卸载入队时先快照「该包是否带客户端 UI」：卸载完成后包已从磁盘删除，读不到 package.json，
     // 只能在此刻取；卸载成功且曾存活时据此决定是否要刷新页面摘除插件面板
     const hadClientUi = options.action === 'remove' ? hasClientUi(options.profile, options.target) : undefined;
-    const task = { id: nextTaskId, target: options.target, displayTarget: options.displayTarget, globalNpm: options.globalNpm, action: options.action, status: 'pending', timedOut: false, exitCode: null, progress: 0, lines: [], attempts: options.attempts ?? [], needsRestart: false, hadClientUi, installChannel: options.installChannel };
+    const task = {
+        id: nextTaskId,
+        target: options.target,
+        displayTarget: options.displayTarget,
+        globalNpm: options.globalNpm,
+        action: options.action,
+        status: 'pending',
+        timedOut: false,
+        exitCode: null,
+        progress: 0,
+        lines: [],
+        attempts: options.attempts ?? [],
+        needsRestart: false,
+        hadClientUi,
+        installChannel: options.installChannel,
+    };
     nextTaskId = nextTaskId >= Number.MAX_SAFE_INTEGER ? 1 : nextTaskId + 1;
     tasks.set(task.id, task);
     if (tasks.size > MAX_TASKS) {
@@ -367,8 +399,8 @@ function spawnMutation(options) {
         let child;
         try {
             // 独立 CLI 场景（file: 'dsh'，宿主加载器走 node bin 不经过这里）：先探测 dsh 是否在 PATH。
-            // 命令不存在时 Windows shell 模式只回传 GBK 乱码、POSIX 才抛 spawn dsh ENOENT —— 统一前置
-            // 拦截并打 ASCII 标记 [dsh-missing]，前端据此精准提示「dsh 未加入 PATH」而不是笼统的插件失败。
+            // 命令缺失时各平台报错形态不同（GBK 乱码 / spawn ENOENT），统一前置拦截并打 ASCII 标记
+            // [dsh-missing]，前端据此精准提示「dsh 未加入 PATH」而不是笼统的插件失败。
             if (invocation.file === 'dsh' && !dshOnPath(env)) {
                 const detail = '[dsh-missing] the dsh CLI was not found on this machine (DeepSeek Harness not installed, or dsh not on the PATH)';
                 if (task) {
@@ -494,12 +526,9 @@ function spawnMutation(options) {
     });
     return (async () => {
         let result = await spawnOnce(args);
-        // npm 11 的 arborist peer-set bug（`Cannot read properties of null (reading 'children')`）：
-        // 某些包的 peerDependencies 用「双段 prerelease 范围」（如 dsh-tui@0.9.0 的 `^0.1.0-rc.6 || ^0.1.1-rc.1`，
-        // 26 个必需 peer 全是这种形状）会让 `npm install -g` 在解析阶段直接崩溃 —— 退出码 1、什么都没装，
-        // 与是不是从我们界面发起无关（终端里同样复现）。首次失败后自动带 `--legacy-peer-deps` 重试一次：
-        // 跳过 peer 自动解析即可绕过该 bug（peer 通常由同装的 @deepseek-ai/dsh 依赖树天然提供）。
-        // 二次尝试仍失败则保留其错误信息，不掩盖真正的原因。
+        // npm 11 的 arborist peer-set bug（`Cannot read properties of null (reading 'children')`）
+        // 会让 `npm install -g` 在解析阶段直接崩溃。首次失败后自动带 `--legacy-peer-deps` 重试一次：
+        // 跳过 peer 自动解析即可绕过该 bug；二次尝试仍失败则保留其错误信息，不掩盖真正的原因。
         if (isGlobalNpm && result.exitCode !== 0 && !result.timedOut && task?.status !== 'cancelled') {
             const retryArgs = ['install', '-g', '--legacy-peer-deps', ...(globalNpm ?? [])];
             const retryExecuted = `npm install -g --legacy-peer-deps ${(globalNpm ?? []).join(' ')}`;
@@ -611,7 +640,7 @@ function ignoredBuildKeys(output) {
 }
 /** npm arborist edgesOut 崩溃 + 本机 npm 版本过低 → 把 [npm-too-low] 标记追加到任务输出，
  *  前端据此展示「本机 npm 版本过低」的准确原因 —— 避免该报错被外层 ERR_PNPM_PREPARE_PACKAGE
- *  误判成插件打包/分发问题、误导用户提 Issue。检测逻辑在独立的 npm-check.ts（本机 npm 环境职责）。 */
+ *  误判成插件打包/分发问题。检测逻辑在独立的 npm-check.ts（本机 npm 环境职责）。 */
 function annotateNpmTooLow(result, options) {
     if (options.action === 'remove' || result.exitCode === 0 || result.timedOut)
         return result;

package/lib/services/probe.js

@@ -140,7 +140,7 @@ function runCurl(args, env, timeoutMs) {
  *  若本机 curl 不认这个参数（curl < 7.70）则去掉参数重跑一次，保证老版本不因此直接失败；
  *  降级后仍被吊销检查拦死（CRYPT_E_NO_REVOCATION_CHECK）时，再用 --ssl-no-revoke
  *  彻底关掉吊销检查跑一次 —— 该参数 curl ≥ 7.19 即存在，覆盖面比降级参数更广，
- *  否则「能上网但取不到 CRL」的 Windows 机器会把所有通道误报成不可达（见 issue #71）。
+ *  否则「能上网但取不到 CRL」的 Windows 机器会把所有通道误报成不可达。
  *  吊销检查只影响本次探测自身的信任判断，不改变系统 TLS 配置。 */
 async function curlWithTlsFallback(args, env, timeoutMs) {
     const tlsArgs = curlTlsArgs();
@@ -235,6 +235,23 @@ export function gitLsRemote(url, proxy, timeoutMs) {
         const timer = setTimeout(() => { child.kill(); finish(probeFail()); }, timeoutMs + 1000);
     });
 }
+/**
+ * 请求一个 URL 并返回重定向后的最终地址（curl -I -L -w %{url_effective}）。
+ * 供 GitHub 仓库改名解析使用：对已改名仓库 GitHub 回 301，跟随跳转后的最终地址
+ * 即规范地址。与其它 GitHub 访问同口径 —— curl 子进程注入代理 env（Node 内置
+ * http(s) 读不到系统代理，直连在部分网络下不可达）。
+ * 未发生跳转（200/404）、网络失败或 curl 不可用都返回 null，调用方保留原始地址。
+ */
+export async function finalUrl(url, proxy, timeoutMs) {
+    const discard = process.platform === 'win32' ? 'NUL' : '/dev/null';
+    const r = await curlWithTlsFallback([
+        '-sS', '-I', '-L', '-o', discard, '-w', '%{url_effective}',
+        '--max-time', String(Math.max(1, Math.round(timeoutMs / 1000))),
+        url,
+    ], proxyEnv(proxy), timeoutMs);
+    const final = r.stdout.trim();
+    return r.code === 0 && final !== '' ? final : null;
+}
 /**
  * curl 子进程抓取响应体（与 probeUrl 同一套代理 env 注入与 TLS 参数兜底）。
  * 供服务端 /catalog 代理路由使用：目录/统计数据经此拉到服务端再转给浏览器，

package/lib/types/http/catalog.d.ts

@@ -0,0 +1,10 @@
+import { type WebRoute, type WebServerService } from './shared.ts';
+export declare function profileDirectory(profile: string): string;
+/** Read non-official dependencies installed into one profile. */
+export declare function readInstalled(profile: string): Record<string, string>;
+/** 读已装依赖实际落在磁盘上的仓库身份（`owner/repo`）：解析 node_modules/<name>/package.json
+ *  的 repository 字段。已装 spec 可能是纯版本号（丢了仓库身份），但真实包元数据仍指向来源仓库，
+ *  据此可区分「同名依赖其实是同一仓库的残留（应转 update）」还是「跨仓库包名冲突（应报错）」。
+ *  读不到 / 解析不出返回 null（交给调用方按冲突处理）。 */
+export declare function installedRepoOf(profile: string, name: string): string | null;
+export declare function registerCatalogRoutes(webServer: WebServerService, profile: string): WebRoute[];

package/lib/types/http/diagnostics.d.ts

@@ -0,0 +1,4 @@
+import { type WebRoute, type WebServerService } from './shared.ts';
+/** 宿主环境快照：提交 bug 时随 issue 附上，便于作者复现（前端 /env 端点返回）。 */
+export declare function hostEnv(profile: string): Record<string, string | null>;
+export declare function registerDiagnosticsRoutes(webServer: WebServerService, profile: string): WebRoute[];

package/lib/types/http/install.d.ts

@@ -0,0 +1,11 @@
+/**
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * Install/uninstall routes: validate the target and spawn the official dsh CLI
+ * (see services/install/install.ts), reporting the captured result back.
+ */
+import { type LoaderHandle } from '../services/install/install.ts';
+import { type WebRoute, type WebServerService } from './shared.ts';
+export declare function registerInstallRoutes(webServer: WebServerService, profile: string, loader: LoaderHandle | undefined): WebRoute[];

package/lib/types/http/logs.d.ts

@@ -0,0 +1,2 @@
+import { type WebRoute, type WebServerService } from './shared.ts';
+export declare function registerLogsRoutes(webServer: WebServerService, profile: string): WebRoute[];

package/lib/types/http/routes.d.ts

@@ -1,24 +1,15 @@
-import type { IncomingMessage, ServerResponse } from 'node:http';
-import { readProfileArg, type LoaderHandle } from '../services/install/install.ts';
 /**
- * 宿主是否由桌面应用壳托管（`ELECTRON_RUN_AS_NODE=1`：壳用 Electron 二进制以 Node 模式跑宿主）。
- * 桌面端的宿主归应用壳管，插件重启不了它，也不该去 kill —— 详见 /restart 路由。
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * Local HTTP routes exposing real installs to the in-app Plugin Hub UI.
+ * The client fetches the same-origin `/dsh-plugin-hub/*` endpoints; the
+ * install handler validates the target, then spawns the official dsh CLI
+ * (see services/install/install.ts) and reports the captured result back.
  */
-export declare function isDesktopHost(): boolean;
-export interface WebRoute {
-    kind: 'exact';
-    path: string;
-    handler: (request: IncomingMessage, response: ServerResponse) => void | Promise<void>;
-}
-/** The subset of the host web-server service this plugin touches. */
-export interface WebServerService {
-    register(route: WebRoute): () => void;
-}
-/** Read non-official dependencies installed into one profile. */
-export declare function readInstalled(profile: string): Record<string, string>;
-/** POST mutations are only accepted from the local web server origin or the desktop host page.
- *  Exported for tests (tests/routes.test.ts) — the origin check is the whole CSRF defence. */
-export declare function isSameOrigin(request: IncomingMessage): boolean;
+import { type LoaderHandle } from '../services/install/install.ts';
+import { type WebServerService } from './shared.ts';
 /**
  * Register the Plugin Hub API on the host web server and return a disposer.
  * @param webServer - DSH web server service.
@@ -28,4 +19,8 @@ export declare function isSameOrigin(request: IncomingMessage): boolean;
  */
 export declare function mountPluginHubRoutes(webServer: WebServerService, profile: string, loader?: LoaderHandle): () => void;
 /** Profile resolution shared with the client route docs. */
-export { readProfileArg };
+export { readProfileArg } from '../services/install/install.ts';
+/** Re-exported so the host entry (index.ts) keeps importing it from this module. */
+export type { WebServerService } from './shared.ts';
+/** Re-exported so tests/routes.test.ts keeps importing these from this module. */
+export { isDesktopHost, isSameOrigin } from './shared.ts';

package/lib/types/http/settings.d.ts

@@ -0,0 +1,2 @@
+import { type WebRoute, type WebServerService } from './shared.ts';
+export declare function registerSettingsRoutes(webServer: WebServerService, profile: string): WebRoute[];

package/lib/types/http/shared.d.ts

@@ -0,0 +1,44 @@
+/**
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * Shared HTTP utilities: route/service types, request validation helpers and
+ * the same-origin check guarding every POST mutation. Imported by the other
+ * route modules in this directory.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+/**
+ * 跨平台宿主重启脚本（以 `node -e` 运行，独立于宿主进程）。
+ * 不用 `/bin/sh -c`：Windows 无 /bin/sh，且 lsof/nohup 仅 POSIX 存在。
+ * 由 `spawn(process.execPath, ['-e', SCRIPT, port], { detached, stdio:'ignore' })` 孵化，
+ * 宿主进程被 kill 后仍能完成「停旧 → 等端口释放 → 拉起新 dsh web」。
+ * 端口探测不到监听进程时不再假装重启（记一行日志后退出，见脚本内注释）。
+ */
+export declare const HOST_RESTART_SCRIPT: string;
+/**
+ * 宿主是否由桌面应用壳托管（`ELECTRON_RUN_AS_NODE=1`：壳用 Electron 二进制以 Node 模式跑宿主）。
+ * 桌面端的宿主归应用壳管，插件重启不了它，也不该去 kill —— 详见 /restart 路由。
+ */
+export declare function isDesktopHost(): boolean;
+export interface WebRoute {
+    kind: 'exact';
+    path: string;
+    handler: (request: IncomingMessage, response: ServerResponse) => void | Promise<void>;
+}
+/** The subset of the host web-server service this plugin touches. */
+export interface WebServerService {
+    register(route: WebRoute): () => void;
+}
+export declare const PROFILE_RE: RegExp;
+export declare const COMMAND_TIMEOUT_MS: number;
+/** 目录/统计数据代理的本地缓存时长：1 小时内重复打开插件市场直接读盘，
+ *  不重复走 curl 拉远程 —— 重启宿主后首次打开同样秒开（缓存跨重启存活）。 */
+export declare const CATALOG_CACHE_TTL_MS: number;
+export declare function sendJson(response: ServerResponse, status: number, value: unknown): void;
+/** POST mutations are only accepted from the local web server origin or the desktop host page.
+ *  Exported for tests (tests/routes.test.ts) — the origin check is the whole CSRF defence. */
+export declare function isSameOrigin(request: IncomingMessage): boolean;
+export declare function requireMethod(request: IncomingMessage, response: ServerResponse, method: 'GET' | 'POST'): boolean;
+export declare function requireTrustedPost(request: IncomingMessage, response: ServerResponse): boolean;
+export declare function readJsonBody(request: IncomingMessage): Promise<unknown>;

package/lib/types/http/task.d.ts

@@ -0,0 +1,3 @@
+import { type LoaderHandle } from '../services/install/install.ts';
+import { type WebRoute, type WebServerService } from './shared.ts';
+export declare function registerTaskRoutes(webServer: WebServerService, profile: string, loader: LoaderHandle | undefined): WebRoute[];

package/lib/types/services/install/install.d.ts

@@ -18,5 +18,5 @@ export type { InstallResult, InstallTask, Invocation, PendingRestart, QueueItem
 export type { LoaderHandle } from '../loader.ts';
 export { addPendingRestart, clearPendingRestart, listPendingRestarts } from '../profile/pending-restart.ts';
 export { dumpLoaderEntries, removeLoadedEntry } from '../loader.ts';
-export { addAllowBuildsKey, githubRefOf, githubRepoOf, githubTarget, globalNpmPackagesOf, installTargetOf, parseAllowBuildsKey, readProfileArg, validPackageName } from '../profile/profile.ts';
+export { addAllowBuildsKey, githubRefOf, githubRepoOf, githubTarget, globalNpmPackagesOf, installTargetOf, parseAllowBuildsKey, readProfileArg, validPackageName, } from '../profile/profile.ts';
 export { activeTask, cancelTask, getTask, hasQueuedTarget, hasRunningTask, runPluginMutation, startPluginMutation } from './task-queue.ts';

package/lib/types/services/install/npm-resolve.d.ts

@@ -6,9 +6,10 @@
  * 安装仍会重试反查，避免一次瞬时故障把整个会话锁死在 git 通道。
  * registry 参数：npm 镜像源地址，空串 = 官方源；与安装通道吃同一 registry，
  * 保证「配置了镜像」时反查和安装走同一个源（镜像节点同步完整时结果一致）。
+ * proxy 参数：GitHub 改名跳转探测走的代理（与安装/诊断同一口径）。
  * 慢网络下失败不阻塞安装。
  */
-export declare function resolveNpmPackage(repo: string, registry?: string): Promise<string | null>;
+export declare function resolveNpmPackage(repo: string, registry?: string, proxy?: string): Promise<string | null>;
 type NpmSearchPackage = {
     name?: unknown;
     keywords?: unknown;
@@ -22,6 +23,6 @@ type NpmSearchObject = {
     package?: NpmSearchPackage;
 };
 export declare function isDshPackageMetadataForRepo(pkg: NpmSearchPackage, repo: string): boolean;
-export declare function isDshNpmPackageForRepo(packageName: string, repo: string, registry?: string): Promise<boolean>;
+export declare function isDshNpmPackageForRepo(packageName: string, repo: string, registry?: string, proxy?: string): Promise<boolean>;
 export declare function selectNpmPackageForRepo(objects: NpmSearchObject[], repo: string): string | null;
 export {};

package/lib/types/services/probe.d.ts

@@ -59,6 +59,14 @@ export declare function probeUrl(url: string, proxy: string, timeoutMs: number):
  * 不打 17MB 的 dsh-plugin-hub 主页）。
  */
 export declare function gitLsRemote(url: string, proxy: string, timeoutMs: number): Promise<ProbeResult>;
+/**
+ * 请求一个 URL 并返回重定向后的最终地址（curl -I -L -w %{url_effective}）。
+ * 供 GitHub 仓库改名解析使用：对已改名仓库 GitHub 回 301，跟随跳转后的最终地址
+ * 即规范地址。与其它 GitHub 访问同口径 —— curl 子进程注入代理 env（Node 内置
+ * http(s) 读不到系统代理，直连在部分网络下不可达）。
+ * 未发生跳转（200/404）、网络失败或 curl 不可用都返回 null，调用方保留原始地址。
+ */
+export declare function finalUrl(url: string, proxy: string, timeoutMs: number): Promise<string | null>;
 /**
  * curl 子进程抓取响应体（与 probeUrl 同一套代理 env 注入与 TLS 参数兜底）。
  * 供服务端 /catalog 代理路由使用：目录/统计数据经此拉到服务端再转给浏览器，

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin",
-  "version": "1.6.4",
+  "version": "1.6.6",
   "description": "A community plugin marketplace for DeepSeek Harness, built to the official plugin spec — browse, search and install 10000+ human-curated community plugins without leaving the app. · DeepSeek Harness 社区插件市场（遵循官方开发规范）：10000+ 人工精选社区插件，每日更新。",
   "type": "module",
   "main": "lib/index.js",

package/src/client/components/PluginHubSection.tsx

@@ -460,6 +460,9 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
             // 支持系统文件管理器定位的平台（macOS / Linux）上，行内「打开详情」替换为
             // 打开安装目录按钮（行点击本身即打开详情弹窗）；Windows 不支持则按钮不显示
             platform: env?.platform ?? '',
+            // 待重启列表（owner/repo）：用于区分「待重启」与「已重启仍加载失败」，
+            // 后者不再无限显示「重启」，改为「未激活」灰点
+            pendingRestarts: queue.pendingRestarts.map((p) => p.target),
             // 行点击 / 详情按钮：打开已安装详情弹窗（完整元数据 + 运行时信息）
             onOpenDetail: (item) => setDetailItem(item),
             onReveal: (item) => { void revealFolder(item) },
@@ -533,12 +536,14 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
             onConsumedOpenSection: () => setSettingsSection(null),
           }),
     // Hub 版本信息弹窗：版本号/徽标点击打开 —— 有更新显示新版本 + 变更记录 + 「直接更新」，
-    // 无更新显示当前版本 + 记录 + 「已是最新」。Worker 拉取失败时兜底展示当前版本号。
+    // 暂缓提示显示同一标题但只给「稍后再说」，无更新显示当前版本 + 记录 + 「已是最新」。
+    // 版本号与本机版本一律由 hubUpdateState / hubCurrentVersion 决定，不用远端版号冒充本机。
     showHubUpdate && h(HubUpdateModal, {
       info: catalog.hubUpdateInfo ?? { version: PLUGIN_VERSION },
+      state: catalog.hubUpdateState,
+      currentVersion: catalog.hubCurrentVersion,
       lang,
       t,
-      hasUpdate: catalog.hubHasUpdate,
       onClose: () => setShowHubUpdate(false),
       onProceed: () => {
         setShowHubUpdate(false)

package/src/client/components/modals/HubUpdateModal.tsx

@@ -4,30 +4,39 @@
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
  * Hub 版本信息 / 自我更新说明弹窗：
- *  - 有更新（hasUpdate=true）：标题「有新版本」，展示新版本号、发布时间与 Worker 下发的
+ *  - 有更新（state='available'）：标题「有新版本」，展示新版本号、发布时间与 Worker 下发的
  *    Markdown 变更记录（renderMarkdown 渲染，双语言按界面语言取 {zh,en} 对象），
  *    按钮「稍后再说 / 直接更新」，确认后进入安装弹窗执行覆盖重装。
- *  - 无更新（hasUpdate=false）：标题「当前版本」，展示当前版本信息与更新记录，已是最新。
+ *  - 暂缓提示（state='pending'）：远端确有新版本，但发布未满供应链安全门槛，pnpm 此时会
+ *    静默回退到旧版本 —— 仍按「有新版本」展示，只给「稍后再说」，并说明稍后会自动提示。
+ *  - 无更新 / 信息缺失（state='latest' / 'none'）：标题「当前版本」，版本号与本机版本取自
+ *    currentVersion（构建注入的 PLUGIN_VERSION），**不得**用远端最新版号冒充本机版本。
  * 点击头部版本号（或「可更新」徽标）打开 —— 无论有无更新都能看到更新内容。
  */
 import { createElement as h } from 'react'
 import type { MouseEvent } from 'react'
 import styles from '../../styles/Modal.module.css'
-import type { HubUpdateInfo } from '../../types.ts'
+import type { HubUpdateInfo, HubUpdateState } from '../../types.ts'
 import type { LocaleId, Translate } from '../../types.ts'
 import { renderMarkdown } from '../../logic/renderMarkdown.ts'
 import { CloseIcon } from '../ui/icons.tsx'
 
-export function HubUpdateModal({ info, lang, t, hasUpdate, onProceed, onClose }: {
+export function HubUpdateModal({ info, state, currentVersion, lang, t, onProceed, onClose }: {
   info: HubUpdateInfo
   lang: LocaleId
   t: Translate
-  /** 是否有可用更新：有则显示「直接更新」，无则显示「已是最新」 */
-  hasUpdate: boolean
+  /** Hub 自我更新状态（见 types.ts）：决定标题 / 正文 / meta 版本号 / 按钮 */
+  state: HubUpdateState
+  /** 本机实际运行的版本 —— 「当前版本」与「暂缓提示」的版本号一律用它 */
+  currentVersion: string
   /** 点「直接更新」：关闭本弹窗，进入安装弹窗的更新流程 */
   onProceed: () => void
   onClose: () => void
 }) {
+  const hasUpdate = state === 'available'
+  const pending = state === 'pending'
+  // 展示的版本号：提示更新/暂缓提示时是远端新版本；否则是本机当前版本
+  const shownVersion = hasUpdate || pending ? info.version : currentVersion || info.version
   // 变更记录：字符串直接使用；{zh,en} 对象按界面语言取，缺哪种补哪种，全缺则不出记录区
   const notesRaw = typeof info.notes === 'string'
     ? info.notes
@@ -54,7 +63,7 @@ export function HubUpdateModal({ info, lang, t, hasUpdate, onProceed, onClose }:
   },
     h('div', { className: `${styles.modal} ${styles.hubUpdateModal}`, role: 'dialog', 'aria-modal': 'true' },
       h('div', { className: styles.modalHead },
-        h('div', { className: styles.modalTitle }, t(hasUpdate ? 'hubUpdateTitle' : 'hubCurrentTitle')),
+        h('div', { className: styles.modalTitle }, t(hasUpdate || pending ? 'hubUpdateTitle' : 'hubCurrentTitle')),
         h('button', {
           className: styles.modalClose,
           'aria-label': t('confirmCancel'),
@@ -62,9 +71,9 @@ export function HubUpdateModal({ info, lang, t, hasUpdate, onProceed, onClose }:
         }, h(CloseIcon)),
       ),
       h('div', { className: styles.modalDesc },
-        t(hasUpdate ? 'hubUpdateDesc' : 'hubCurrentDesc', { version: info.version })),
+        t(hasUpdate ? 'hubUpdateDesc' : pending ? 'hubPendingDesc' : 'hubCurrentDesc', { version: shownVersion })),
       h('div', { className: styles.hubUpdateMeta },
-        h('span', { className: styles.hubUpdateMetaItem }, `${t('version')} ${info.version}`),
+        h('span', { className: styles.hubUpdateMetaItem }, `${t('version')} ${shownVersion}`),
         published
           ? h('span', { className: styles.hubUpdateMetaItem }, `${t('hubUpdatePublished')} ${published}`)
           : null,
@@ -81,7 +90,7 @@ export function HubUpdateModal({ info, lang, t, hasUpdate, onProceed, onClose }:
             h('button', { className: styles.restartLater, onClick: onClose }, t('hubUpdateLater')),
             h('button', { className: styles.modalInstall, onClick: onProceed }, t('updateNow')),
           ]
-          : h('button', { className: styles.modalInstall, onClick: onClose }, t('hubUpToDate')),
+          : h('button', { className: styles.modalInstall, onClick: onClose }, t(pending ? 'hubUpdateLater' : 'hubUpToDate')),
       ),
     ),
   )

package/src/client/components/modals/NotificationsModal.tsx

@@ -20,7 +20,7 @@ import type { EnvInfo, Translate } from '../../types.ts'
 import type { NotificationRecord } from '../../logic/failures.ts'
 import { classifyFailure, missingRegistryPackageOf, npmTooLowVersion, pnpmPolicyHintOf, pnpmPolicyHintParams, unreachableTargetOf, registryHostOf } from '../../logic/failures.ts'
 import type { PendingRestart, QueueTask } from '../../hooks/useTaskQueue.ts'
-import { pluginIssueUrl, pluginSiteUrl } from '../../logic/urls.ts'
+import { pluginIssueUrl, pluginSiteUrl, hubIssueUrl } from '../../logic/urls.ts'
 import { CloseIcon } from '../ui/icons.tsx'
 import { ConfirmDialog } from './ConfirmDialog.tsx'
 
@@ -263,13 +263,13 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                         t(v ? 'failNpmTooLowV' : 'failNpmTooLow', v ? { v } : undefined))
                     }
                     if (kind === 'dshMissing') {
-                      // 找不到 dsh 命令（Win「不是内部或外部命令」/ POSIX「command not found」/ spawn ENOENT）：
-                      // 本机 DeepSeek Harness 未正确安装或 dsh 不在 PATH，不是插件问题 —— 直接给环境修复指引，不引导提 Issue
+                      // 找不到 dsh 命令：本机 DeepSeek Harness 未正确安装或 dsh 不在 PATH，
+                      // 不是插件问题 —— 直接给环境修复指引，不引导提 Issue
                       return h('div', { className: styles.failPrepareHint }, t('failDshMissingHint'))
                     }
                     if (kind === 'gitMissing') {
-                      // 找不到 git 命令（Win「'git' is not recognized」/ POSIX「git: command not found」/ spawn ENOENT）：
-                      // 本机 Git 未安装或不在 PATH，不是插件问题 —— 直接给环境修复指引，不引导提 Issue
+                      // 找不到 git 命令：本机 Git 未安装或不在 PATH，不是插件问题 ——
+                      // 直接给环境修复指引，不引导提 Issue
                       return h('div', { className: styles.failPrepareHint }, t('failGitMissingHint'))
                     }
                     if (kind === 'pnpmMissing') {
@@ -314,13 +314,25 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                         h('div', { className: styles.failPrepareHint }, t('failPnpmMissingDepHint')),
                       ])
                     }
+                    if (kind === 'registryVersionStale') {
+                      // 要装的版本在「实际执行安装的那个源」里查不到（ERR_PNPM_NO_MATCHING_VERSION / ETARGET）：
+                      // 常见于镜像滞后 —— 反查包名走设置里的 npmRegistry，实际安装沿用本机 ~/.npmrc 的源；
+                      // 也可能只是版本号写错。与插件作者无关 —— 给对齐源 / 显式走官方源 / 离线包指引，不引导提 Issue
+                      return h('div', { className: styles.failPrepareHint }, t('failRegistryVersionStaleHint'))
+                    }
+                    if (kind === 'pnpmLinkedDirMissing') {
+                      // profile 里留着指向不存在目录的本地依赖（ERR_PNPM_LINKED_PKG_DIR_NOT_FOUND）：
+                      // 常见于 link:/本地路径装过开发中的插件、之后目录被删；与本次要装的插件无关
+                      // —— 给删除悬空条目的指引，不引导提 Issue
+                      return h('div', { className: styles.failPrepareHint }, t('failPnpmLinkedDirMissingHint'))
+                    }
                     if (kind === 'fileLocked') {
                       // profile 里的文件被其他进程占用（Windows os error 32）：通常是宿主或杀毒软件
                       // 持有句柄 —— 给出完全退出宿主的指引，不引导提 Issue
                       return h('div', { className: styles.failPrepareHint }, t('failFileLockedHint'))
                     }
                     if (kind === 'accessDenied') {
-                      // profile 里的文件被系统拒绝写入（Windows os error 5「拒绝访问」/ EPERM / EACCES）：
+                      // profile 里的文件被系统拒绝写入（os error 5 / EPERM / EACCES）：
                       // 占用、只读属性、目录 ACL 或杀软拦截 —— 给退出宿主 + 检查权限的指引，不引导提 Issue
                       return h('div', { className: styles.failPrepareHint }, t('failAccessDeniedHint'))
                     }
@@ -351,13 +363,11 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                         }, t('failNetworkRunDiag')) : null,
                       ])
                     }
-                    if (kind === 'pluginPrepare' || kind === 'pnpmIgnoredBuild') {
+                    if (kind === 'pluginPrepare') {
                       // [packaging]（预检/装后校验拦截：git 分发缺产物）与
-                      // prepare 构建脚本实际执行失败 / 原生依赖构建被 pnpm 拦截：都是插件打包分发问题 —— 先说明原因，按钮在下方提交
+                      // prepare 构建脚本实际执行失败：唯一确有证据的插件打包分发问题 —— 引导到插件仓库提 Issue
                       return h('div', null, [
-                        h('div', { className: styles.failPrepareHint }, kind === 'pnpmIgnoredBuild'
-                          ? t('failIgnoredBuild')
-                          : /\[packaging\]/i.test(r.message) ? t('failPackagingHint') : t('failPrepareHint')),
+                        h('div', { className: styles.failPrepareHint }, /\[packaging\]/i.test(r.message) ? t('failPackagingHint') : t('failPrepareHint')),
                         r.repo && shownRepo ? h('a', {
                           className: styles.failBigIssue,
                           href: pluginIssueUrl(shownRepo, r.message, env, r.command, r.attempts),
@@ -367,13 +377,19 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                         }, t('failIssueBig')) : null,
                       ])
                     }
-                    return r.repo && shownRepo ? h('a', {
-                      className: styles.failBigIssue,
-                      href: pluginIssueUrl(shownRepo, r.message, env, r.command, r.attempts),
-                      target: '_blank',
-                      rel: 'noopener noreferrer',
-                      title: t('failIssueHint'),
-                    }, t('failIssueBig')) : null
+                    // pnpm allowBuilds 拦截与未知失败：不归到插件作者，改为引导到插件中心仓库排查
+                    return h('div', null, [
+                      kind === 'pnpmIgnoredBuild'
+                        ? h('div', { className: styles.failPrepareHint }, t('failIgnoredBuild'))
+                        : h('div', { className: styles.failPrepareHint }, t('failUnclassifiedHint')),
+                      h('a', {
+                        className: styles.failBigIssue,
+                        href: hubIssueUrl(shownRepo || r.repo, r.message, env, r.command, r.attempts),
+                        target: '_blank',
+                        rel: 'noopener noreferrer',
+                        title: t('failHubIssueHint'),
+                      }, t('failHubIssueBig')),
+                    ])
                   })(),
                 ),
               ),