dsh-plugin 1.3.5 → 1.3.7

package/lib/http/routes.js

@@ -12,7 +12,7 @@ import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { homedir, release } from 'node:os';
 import { dirname, join, resolve } from 'node:path';
 import { spawn } from 'node:child_process';
-import { fetchViaCurl, probeUrl, systemProxy } from '../services/probe.js';
+import { fetchViaCurl, gitLsRemote, probeUrl, systemProxy } from '../services/probe.js';
 import { activeTask, cancelTask, dumpLoaderEntries, getTask, githubRepoOf, githubTarget, globalNpmPackagesOf, hasQueuedTarget, installTargetOf, listPendingRestarts, readProfileArg, startPluginMutation, validPackageName } from '../services/install/install.js';
 import { recordInstalledVersion, recordResolvedNpmPackage, readInstalledVersions, removeInstalledVersion } from '../services/profile/installed-versions.js';
 import { resolveNpmPackage } from '../services/install/npm-resolve.js';
@@ -157,13 +157,12 @@ function hostEnv(profile) {
         dshHome: process.env.DSH_HOME ?? join(homedir(), '.dsh'),
     };
 }
-/** 安装/卸载 CLI 的子进程环境：透传宿主环境，并按设置注入 npm 镜像源与 HTTP(S) 代理。
+/** 安装/卸载 CLI 的子进程环境：透传宿主环境，并按设置注入 HTTP(S) 代理。
+ *  npm registry 不再注入 —— 安装完全沿用用户本机 npm 配置（~/.npmrc / 全局配置）。
  *  代理优先级：设置里的代理 → 系统代理（macOS scutil / Windows 注册表）→ 宿主 env 原有值。
  *  使安装通道与诊断使用相同的代理来源。 */
 function mutationEnv(settings) {
     const env = { ...process.env, CI: 'true' };
-    if (settings.npmRegistry !== '')
-        env.npm_config_registry = settings.npmRegistry;
     const proxy = settings.proxy !== '' ? settings.proxy : (systemProxy() ?? '');
     if (proxy !== '') {
         env.HTTP_PROXY = proxy;
@@ -485,14 +484,25 @@ export function mountPluginHubRoutes(webServer, profile, loader) {
                     // 空 body / 非 JSON：视为全量探测
                 }
                 const settings = loadSettings(profile);
+                // npm 通道：设置里配置了镜像源就探测该镜像（安装通道吃同一个 registry）；
+                // 未配置（空串）时探测官方源作为「跟随本机 npm 配置」的基础连通性参考。
                 const registry = settings.npmRegistry.replace(/\/+$/, '') || 'https://registry.npmjs.org';
                 // 连通性自检直接打安装通道真实访问的轻量资源：npm 源拉包元数据、git 通道探
                 // 仓库主页、目录站探 badge 小文件，避免拉取目录全量 JSON。
+                // npm 行 display：配置了镜像就显示镜像地址；未配置置空 —— 客户端显示「未配置（跟随本机 npm 配置）」。
                 const allChecks = [
-                    { key: 'npm', url: `${registry}/dsh-plugin`, display: settings.npmRegistry !== '' ? settings.npmRegistry : 'registry.npmjs.org', cmd: `npm view dsh-plugin version --registry ${registry}` },
-                    { key: 'github', url: 'https://github.com/dshplugin/dsh-plugin-hub', display: 'github.com', cmd: 'git ls-remote https://github.com/dshplugin/dsh-plugin-hub' },
+                    { key: 'npm', url: `${registry}/dsh-plugin`, display: settings.npmRegistry !== '' ? registry : '', cmd: `npm view dsh-plugin version --registry ${registry}` },
+                    // GitHub 行用真实 git 克隆握手（git ls-remote）打 dshplugin/hello-dsh 小仓库：
+                    // 「网页能打开」和「git 能克隆」是两码事，握手成功才算通道通；小仓库秒级完成，不打 17MB 的 dsh-plugin-hub。
+                    { key: 'github', url: 'https://github.com/dshplugin/hello-dsh', display: 'github.com/dshplugin/hello-dsh', cmd: 'git ls-remote https://github.com/dshplugin/hello-dsh', git: true },
                     { key: 'catalog', url: 'https://api.dsh-plugin.org/stats.json', display: 'api.dsh-plugin.org', cmd: 'curl -s https://api.dsh-plugin.org/stats.json' },
                 ];
+                // 配置了 HTTP 代理：追加一行代理诊断 —— 用该代理打 github.com（安装通道真实访问的地址），
+                // 验证「代理能不能把请求带出去」。与安装同口径：curl 子进程注入该代理 env。
+                // 设置里未配置代理时不显示该行（跟随系统代理/直连，无「代理本身」可验证）。
+                if (settings.proxy !== '') {
+                    allChecks.push({ key: 'proxy', url: 'https://github.com', display: settings.proxy, cmd: `curl -s -o /dev/null -x ${settings.proxy} https://github.com`, proxy: settings.proxy });
+                }
                 const checks = onlyKey !== '' ? allChecks.filter((c) => c.key === onlyKey) : allChecks;
                 response.writeHead(200, {
                     'content-type': 'application/x-ndjson; charset=utf-8',
@@ -502,17 +512,22 @@ export function mountPluginHubRoutes(webServer, profile, loader) {
                 // 探测走代理的优先级：设置里的代理 → 系统代理（macOS scutil / Windows 注册表）→ 环境变量 HTTPS_PROXY → 直连。
                 // 与安装通道一致（npm/git 靠 HTTP_PROXY 环境变量走代理），且自动跟随系统代理 ——
                 // 浏览器挂着代理能开、诊断就能测通，不用用户手动把代理填进设置。
+                // proxy 行例外：它验证的正是「设置里配的那个代理」，必须显式用它（而非 effectiveProxy）去探测。
                 const effectiveProxy = settings.proxy !== ''
                     ? settings.proxy
                     : (systemProxy() ?? process.env.HTTPS_PROXY ?? process.env.https_proxy ?? '');
-                const probe = (url) => probeUrl(url, effectiveProxy, 6000);
+                const probe = (url, proxy) => probeUrl(url, proxy ?? effectiveProxy, 6000);
                 // 逐路串行：一条命令一条结果地推送给终端，保持「程序在跑」的真实感
                 const results = [];
                 for (const c of checks) {
                     send({ type: 'probe', key: c.key, cmd: c.cmd, display: c.display });
-                    const r = await probe(c.url);
+                    // git 行走真实克隆握手（gitLsRemote），其余走 curl 探测，两路都带超时兜底
+                    const r = c.git
+                        ? await gitLsRemote(c.url, c.proxy ?? effectiveProxy, 6000)
+                        : await probe(c.url, c.proxy);
                     results.push({ key: c.key, ok: r.ok });
-                    send({ type: r.ok ? 'ok' : 'fail', key: c.key, display: c.display, ms: r.ms, status: r.status });
+                    // git 行的 status 是退出码，客户端 git 行只显示 OK / 不可达，不显示成 HTTP 码
+                    send({ type: r.ok ? 'ok' : 'fail', key: c.key, display: c.display, ms: r.ms, status: c.git ? null : r.status });
                 }
                 send({ type: 'end', at: Date.now() });
                 response.end();
@@ -529,6 +544,39 @@ export function mountPluginHubRoutes(webServer, profile, loader) {
                 });
             },
         }),
+        webServer.register({
+            kind: 'exact',
+            path: '/dsh-plugin-hub/proxy-check',
+            handler: async (request, response) => {
+                if (!requireTrustedPost(request, response))
+                    return;
+                // 代理连通性校验：用待测代理打 dshplugin/hello-dsh 真实仓库页（权威可达目标），
+                // 供设置页输入代理时实时反馈「这个地址通不通」。不通过也允许保存 ——
+                // 用户可能是先填地址后开代理，因此这里只报告探测结果、不拦截保存。
+                let proxy = '';
+                let target = 'https://github.com/dshplugin/hello-dsh';
+                try {
+                    const body = await readJsonBody(request);
+                    if (body !== null && typeof body === 'object') {
+                        const b = body;
+                        if (typeof b.proxy === 'string')
+                            proxy = b.proxy.trim();
+                        if (typeof b.target === 'string' && b.target.trim() !== '')
+                            target = b.target.trim();
+                    }
+                }
+                catch {
+                    // 空 body / 非 JSON：按默认目标探测
+                }
+                if (proxy === '') {
+                    sendJson(response, 200, { ok: false, ms: null, status: null, target, reason: 'empty' });
+                    return;
+                }
+                // 探测走该代理本身（不是 effectiveProxy）：验证的就是用户填的这个地址
+                const r = await probeUrl(target, proxy, 6000);
+                sendJson(response, 200, { ok: r.ok, ms: r.ms, status: r.status, target });
+            },
+        }),
         webServer.register({
             kind: 'exact',
             path: '/dsh-plugin-hub/catalog',
@@ -603,6 +651,10 @@ export function mountPluginHubRoutes(webServer, profile, loader) {
                         ? body.source
                         : '';
                     const settings = loadSettings(profile);
+                    // 界面语言（客户端随请求携带）：错误消息按用户当前语言提示（中文界面给中文，英文界面给英文）
+                    const lang = typeof body === 'object' && body !== null && body.lang === 'en'
+                        ? 'en'
+                        : 'zh';
                     // 全局 npm 安装（官方 README 的 `npm install -g <pkgs>`，如 dsh-tui 的安装命令）：
                     // 直接从命令框输入格式执行全局安装，不进任何 profile、无需宿主重启。
                     // 包列表优先取 body.globalNpm（客户端命令框解析后显式携带）；兜底再从 rawRepo 解析，
@@ -702,6 +754,35 @@ export function mountPluginHubRoutes(webServer, profile, loader) {
                         sendJson(response, 409, { error: `already queued: ${target}` });
                         return;
                     }
+                    // 安装前网络连通性预检：npm 通道探 registry、git 通道探 github.com 连通性。
+                    // 探测目标固定为通道的稳定入口（registry 根 / github.com 主页），不探具体包或仓库
+                    // 页 —— 404 表示「目标不存在」而非网络不通，不该被当成网络故障拦截。
+                    // 仅新安装预检（更新是已信任目标的覆盖重装，跳过）；不通直接 400 拦下并打
+                    // [network] 标记，客户端据此提示「你的网络不通」，而不是把网络失败当成
+                    // 插件侧问题引导去作者仓库提 Issue（issue #10：git fetch 超时被误报为插件问题）。
+                    // 代理口径与诊断一致：设置里的代理 → 系统代理 → 环境变量 → 直连。
+                    if (already === null) {
+                        const effectiveProxy = settings.proxy !== ''
+                            ? settings.proxy
+                            : (systemProxy() ?? process.env.HTTPS_PROXY ?? process.env.https_proxy ?? '');
+                        const isGitChannel = repoTarget !== null && target === repoTarget;
+                        const probeTarget = isGitChannel
+                            ? 'https://github.com/'
+                            : `${(settings.npmRegistry.replace(/\/+$/, '') || 'https://registry.npmjs.org')}/`;
+                        const net = await probeUrl(probeTarget, effectiveProxy, 6000);
+                        if (!net.ok) {
+                            // 错误消息按客户端界面语言提示：中文界面给中文、英文界面给英文，
+                            // 不再写死英文（用户一眼看懂是网络问题，而不是插件问题）
+                            const channelName = isGitChannel
+                                ? (lang === 'zh' ? 'GitHub' : 'github.com')
+                                : (lang === 'zh' ? 'npm 源' : 'the npm registry');
+                            const error = lang === 'zh'
+                                ? `[network] 安装已中止：安装前无法连接到 ${channelName}（${probeTarget}）—— 您的网络似乎不通或被拦截（断网 / DNS 解析失败 / 防火墙 / 代理配置问题）。这不是插件本身的问题，请检查网络连接或代理设置，运行「系统诊断」检测各通道连通性后重试。`
+                                : `[network] install aborted: cannot reach ${channelName} (${probeTarget}) before install — your network connection appears to be down or blocked (DNS / proxy / firewall). This is not a problem with the plugin itself. Check your connection or proxy settings, run the connectivity diagnostic, then retry.`;
+                            sendJson(response, 400, { error, attempts });
+                            return;
+                        }
+                    }
                     // 安装前预检：仅新安装走预检（github 源分发改入口文件缺失时直接拦截）。
                     // 更新是已信任目标的覆盖重装，跳过预检避免重复下载 tarball。
                     // npm 包信任 registry 直接放行；github 源拦截时标记 [packaging] 前缀，

package/lib/services/install/npm-resolve.js

@@ -20,7 +20,9 @@ const REQUEST_TIMEOUT_MS = 8000;
  * 反查 repo（`owner/repo`）对应的官方 npm 包名；未命中、网络异常或超时返回 null。
  * 返回 null 不代表仓库一定没有 npm 包，只代表本次未能确认 —— 调用方应保留
  * 原有错误路径，反查只是额外的一次尝试。
- * @param registry - npm 镜像源地址（空串 = 官方 https://registry.npmjs.org）
+ * registry 参数：npm 镜像源地址，空串 = 官方源；与安装通道吃同一 registry，
+ * 保证「配置了镜像」时反查和安装走同一个源（镜像节点同步完整时结果一致）。
+ * 慢网络下失败不阻塞安装。
  */
 export function resolveNpmPackage(repo, registry = '') {
     const key = repo.toLowerCase();

package/lib/services/probe.js

@@ -123,6 +123,49 @@ export function probeUrl(url, proxy, timeoutMs) {
     }
     return curlProbe(target.href, proxy, timeoutMs);
 }
+/**
+ * git 通道真实克隆握手探测：spawn git ls-remote（https 传输，与 pnpm 克隆前的
+ * ref 握手一致），注入代理 env，GIT_TERMINAL_PROMPT=0 防凭据提示挂起。
+ *
+ * 为什么要真实 git 而非 curl 打网页：网页「能打开」和 git「能克隆」是两码事 ——
+ * 防火墙/代理常按端口与协议区分，HTTP 页可达不代表 git 传输可达。这里测的就是
+ * 克隆握手本身，回答「github:owner/repo 装不装得动」。
+ * 供系统诊断 GitHub 通道使用；探测目标用 dshplugin/hello-dsh 小仓库（秒级完成，
+ * 不打 17MB 的 dsh-plugin-hub 主页）。
+ */
+export function gitLsRemote(url, proxy, timeoutMs) {
+    return new Promise((resolve) => {
+        const started = Date.now();
+        const env = { ...process.env, GIT_TERMINAL_PROMPT: '0' };
+        if (proxy !== '') {
+            env.HTTP_PROXY = proxy;
+            env.HTTPS_PROXY = proxy;
+            env.http_proxy = proxy;
+            env.https_proxy = proxy;
+        }
+        const child = spawn('git', ['ls-remote', '--exit-code', url, 'HEAD'], { env });
+        let out = '';
+        child.stdout.on('data', (c) => { out += c.toString(); });
+        // git 的报错不透传给终端：结果以退出码 + HEAD ref 是否返回为准
+        child.stderr.on('data', () => { });
+        let done = false;
+        const finish = (r) => {
+            if (done)
+                return;
+            done = true;
+            clearTimeout(timer);
+            resolve(r);
+        };
+        child.on('error', () => finish(probeFail()));
+        child.on('close', (code) => {
+            const ok = code === 0 && out.trim() !== '';
+            // status 复用为 git 退出码（0 = 克隆握手成功）；客户端 git 行不把它显示成 HTTP 码
+            finish({ ok, ms: Date.now() - started, status: code });
+        });
+        // 超时兜底：与 curlProbe 同口径，防止 git 挂起
+        const timer = setTimeout(() => { child.kill(); finish(probeFail()); }, timeoutMs + 1000);
+    });
+}
 /**
  * curl 子进程抓取响应体（与 probeUrl 同一套代理 env 注入）。
  * 供服务端 /catalog 代理路由使用：目录/统计数据经此拉到服务端再转给浏览器，

package/lib/services/settings.js

@@ -12,8 +12,8 @@ import { dirname, join } from 'node:path';
 import { profileDirectory } from './profile/profile.js';
 export const DEFAULT_SETTINGS = {
     checkUpdatesOnStart: true,
-    npmRegistry: '',
     proxy: '',
+    npmRegistry: '',
     enableNpmInstall: true,
     enableGitInstall: true,
     enableDshInstall: true,

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

@@ -2,6 +2,8 @@
  * 反查 repo（`owner/repo`）对应的官方 npm 包名；未命中、网络异常或超时返回 null。
  * 返回 null 不代表仓库一定没有 npm 包，只代表本次未能确认 —— 调用方应保留
  * 原有错误路径，反查只是额外的一次尝试。
- * @param registry - npm 镜像源地址（空串 = 官方 https://registry.npmjs.org）
+ * registry 参数：npm 镜像源地址，空串 = 官方源；与安装通道吃同一 registry，
+ * 保证「配置了镜像」时反查和安装走同一个源（镜像节点同步完整时结果一致）。
+ * 慢网络下失败不阻塞安装。
  */
 export declare function resolveNpmPackage(repo: string, registry?: string): Promise<string | null>;

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

@@ -18,6 +18,17 @@ export declare function systemProxy(): string | null;
  * 供系统诊断 /diagnostics 使用；目标 URL 非法返回不可达。
  */
 export declare function probeUrl(url: string, proxy: string, timeoutMs: number): Promise<ProbeResult>;
+/**
+ * git 通道真实克隆握手探测：spawn git ls-remote（https 传输，与 pnpm 克隆前的
+ * ref 握手一致），注入代理 env，GIT_TERMINAL_PROMPT=0 防凭据提示挂起。
+ *
+ * 为什么要真实 git 而非 curl 打网页：网页「能打开」和 git「能克隆」是两码事 ——
+ * 防火墙/代理常按端口与协议区分，HTTP 页可达不代表 git 传输可达。这里测的就是
+ * 克隆握手本身，回答「github:owner/repo 装不装得动」。
+ * 供系统诊断 GitHub 通道使用；探测目标用 dshplugin/hello-dsh 小仓库（秒级完成，
+ * 不打 17MB 的 dsh-plugin-hub 主页）。
+ */
+export declare function gitLsRemote(url: string, proxy: string, timeoutMs: number): Promise<ProbeResult>;
 /**
  * curl 子进程抓取响应体（与 probeUrl 同一套代理 env 注入）。
  * 供服务端 /catalog 代理路由使用：目录/统计数据经此拉到服务端再转给浏览器，

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

@@ -1,10 +1,10 @@
 export interface HubSettings {
     /** 启动时检查目录插件更新，发现可更新时在通知中心提示（安装不自动进行） */
     checkUpdatesOnStart: boolean;
-    /** npm 镜像源 registry 地址（空串 = 官方 https://registry.npmjs.org） */
-    npmRegistry: string;
     /** HTTP(S) 代理地址，用于 npm / git / 目录请求（空串 = 直连） */
     proxy: string;
+    /** npm 镜像源 registry 地址（空串 = 未配置，跟随用户本机 npm 配置，本插件不注入任何 registry） */
+    npmRegistry: string;
     /** 启用命令行安装 NPM 包（默认开；关掉后输入 npm 包名安装被拦截） */
     enableNpmInstall: boolean;
     /** 启用命令行安装 GitHub 源码（默认开；关掉后输入 GitHub 地址安装被拦截） */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin",
-  "version": "1.3.5",
+  "version": "1.3.7",
   "description": "A community plugin marketplace for DeepSeek Harness, built to the official plugin spec — browse, search and install 4000+ human-curated community plugins without leaving the app. · DeepSeek Harness 社区插件市场（遵循官方开发规范）：4000+ 人工精选社区插件，每日更新。",
   "type": "module",
   "main": "lib/index.js",
@@ -44,8 +44,8 @@
     "build:server": "rm -rf lib && tsc -p tsconfig.server.json",
     "build:client": "tsdown && node scripts/tools/normalize-client-banner.mjs",
     "readme:stats": "node scripts/tools/sync-readme-stats.mjs",
-    "reload": "bash scripts/run/reload-dsh.sh",
-    "dev": "bash scripts/run/dev-dsh.sh",
+    "reload": "bash scripts/run/restart-dev.sh",
+    "dev": "bash scripts/run/restart-dev.sh",
     "test": "node --test",
     "test:watch": "node --test --watch",
     "typecheck": "npm run typecheck:client && npm run typecheck:server && npm run typecheck:test",

package/src/client/components/PluginHubSection.tsx

@@ -35,6 +35,7 @@ import type { SectionView } from './layout/SectionTabs.tsx'
 import { InstalledView } from './views/InstalledView.tsx'
 import { CustomInstallView } from './views/CustomInstallView.tsx'
 import { SettingsView } from './views/SettingsView.tsx'
+import type { SettingsSection } from './views/SettingsView.tsx'
 import { CloseIcon, ConfirmIcon } from './ui/icons.tsx'
 import type { InstalledItem } from '../logic/installed.ts'
 import { issueRepoOf, pluginOfItem } from '../logic/installed.ts'
@@ -47,6 +48,27 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
 
   /** 一级导航：插件中心 / 已安装 / 自定义安装 / 设置 */
   const [view, setView] = useState<SectionView>('market')
+  /** 外部跳转设置分组的一次性信号（错误弹窗「去系统诊断」→ 设置 → 系统诊断）：
+   *  传给 SettingsView 消费后即清空，避免下次进设置被强制带跳 */
+  const [settingsSection, setSettingsSection] = useState<SettingsSection | null>(null)
+  /** 网络不通提示的「去系统诊断」直达：关掉所有弹窗（错误/通知/安装确认进度等，
+   *  否则 InstallModal 失败后仍停驻原地盖住设置页）→ 切到设置页 → 切到系统诊断分组（自动跑连通性检测） */
+  const openDiagnostics = () => {
+    setErrorMsg(null)
+    setShowNotifications(false)
+    setConfirmPlugin(null)
+    setConfirmCustomTarget(null)
+    setConfirmGlobalNpm(null)
+    setUninstallPlugin(null)
+    setUninstallItem(null)
+    setDetailItem(null)
+    setShowHubUpdate(false)
+    setShowAbout(false)
+    setIgnoreTarget(null)
+    setShowRestartConfirm(false)
+    setView('settings')
+    setSettingsSection('diagnostics')
+  }
 
   /** 全局反馈 Toast：{id} 用于重复触发时重新走入场动画，kind 决定文案与配色 */
   const [toast, setToast] = useState<ToastState | null>(null)
@@ -106,13 +128,16 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
 
   const queue = useTaskQueue({
     t,
+    // 界面语言带给服务端：网络预检等错误消息按用户语言提示（中文界面给中文，英文界面给英文）
+    langKey,
     refreshInstalled: catalog.refreshInstalled,
-    onInstallDone: (viaModal, repo, needsRestart) => {
+    onInstallDone: (viaModal, repo, needsRestart, update) => {
       setInstallNeedsRestart(needsRestart)
       if (viaModal) setInstallDone(true)
       else setToast({ id: Date.now(), kind: 'done' })
-      // 安装成功也写入通知记录：通知中心里成功与失败都能看到
-      setNotifications(addSuccess({ kind: 'install', repo: repo ?? '' }))
+      // 安装成功也写入通知记录：通知中心里成功与失败都能看到。
+      // action 区分「安装成功」与「更新成功」（更新 = 覆盖重装，同一执行通道）
+      setNotifications(addSuccess({ kind: 'install', action: update ? 'update' : 'install', repo: repo ?? '' }))
     },
     onUninstallDone: (viaModal, repo, needsRestart) => {
       setUninstallNeedsRestart(needsRestart)
@@ -120,13 +145,16 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       else setToast({ id: Date.now(), kind: 'removed' })
       setNotifications(addSuccess({ kind: 'uninstall', repo: repo ?? '' }))
     },
-    onError: (message, repo, kind, command, attempts) => {
+    onError: (message, repo, kind, command, attempts, update) => {
       // 提 Issue 目标先反查仓库身份：npm 包名能在已安装表/目录里反查到 owner/repo 才保留，
-      // 反查不到置 null —— 错误弹窗/通知中心据此不显示「一键提 Issue」按钮（防提到错误仓库）
+      // 反查不到置 null —— 错误弹窗据此不显示「一键提 Issue」按钮（防提到错误仓库）
       const issueRepo = issueRepoOf(repo ?? '', catalog.installedItems, catalog.plugins)
       setErrorMsg({ message, repo: issueRepo, kind, command, attempts })
-      // 失败自动写入通知记录：任务在后台结束时没人盯着也能留痕
-      setNotifications(addFailure({ kind, repo: issueRepo ?? '', message, command, attempts }))
+      // 失败自动写入通知记录：任务在后台结束时没人盯着也能留痕。
+      // 存原始 repo（可能只是裸包名）而非反查结果 —— 反查只服务于提 Issue，
+      // 通知中心的展示反查由 NotificationsModal 做、查不到会回退显示原始值，
+      // 若这里就丢掉原始值，通知里会连名字都看不到；action 区分「安装失败/更新失败」
+      setNotifications(addFailure({ kind, action: update ? 'update' : 'install', repo: repo ?? '', message, command, attempts }))
     },
     installPlugin: confirmPlugin,
     installCustomTarget: confirmCustomTarget,
@@ -458,6 +486,9 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
               doCopy(text)
               setToast({ id: Date.now(), kind: 'copied' })
             },
+            // 网络不通提示「去系统诊断」→ 设置页并切到系统诊断分组（DiagnosticsView 挂载即自动跑探测）
+            openSection: settingsSection,
+            onConsumedOpenSection: () => setSettingsSection(null),
           }),
     // Hub 版本信息弹窗：版本号/徽标点击打开 —— 有更新显示新版本 + 变更记录 + 「直接更新」，
     // 无更新显示当前版本 + 记录 + 「已是最新」。Worker 拉取失败时兜底展示当前版本号。
@@ -517,6 +548,8 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       cancelTask: queue.cancelTask,
       restarting,
       onRestart: () => setShowRestartConfirm(true),
+      // 网络不通记录的「去系统诊断」直达：关通知中心 → 设置 → 系统诊断
+      onRunDiagnostics: openDiagnostics,
       // 失败记录仓库反查：历史记录可能存的是裸 npm 包名，反查成 owner/repo 才显示仓库链接
       // 与提 Issue 按钮；查不到则隐藏（防提到错误仓库）
       resolveRepo: (repo: string) => issueRepoOf(repo, catalog.installedItems, catalog.plugins),
@@ -700,6 +733,8 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
         doCopy(text)
         setToast({ id: Date.now(), kind: 'errCopied' })
       },
+      // 网络不通错误的「去系统诊断」直达：关错误弹窗 → 设置 → 系统诊断
+      onRunDiagnostics: openDiagnostics,
       onClose: () => setErrorMsg(null),
     }),
     // 待重启确认弹窗：已安装列表行内「重启」按钮点击后弹出，稍后重启 / 立即重启

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

@@ -18,7 +18,7 @@ import type { MouseEvent } from 'react'
 import styles from '../../styles/Modal.module.css'
 import type { EnvInfo, Translate } from '../../types.ts'
 import type { NotificationRecord } from '../../logic/failures.ts'
-import { classifyFailure, npmTooLowVersion } from '../../logic/failures.ts'
+import { classifyFailure, npmTooLowVersion, unreachableTargetOf } from '../../logic/failures.ts'
 import type { PendingRestart, QueueTask } from '../../hooks/useTaskQueue.ts'
 import { pluginIssueUrl, pluginSiteUrl } from '../../logic/urls.ts'
 import { CloseIcon } from '../ui/icons.tsx'
@@ -56,7 +56,7 @@ function BadgeGlyph({ ok }: { ok: boolean }) {
     }))
 }
 
-export function NotificationsModal({ records, tasks, pendingRestarts, t, env, onClose, onCopy, onClear, onRemove, onUpdate, onIgnoreUpdate, cancelTask, restarting, onRestart, resolveRepo }: {
+export function NotificationsModal({ records, tasks, pendingRestarts, t, env, onClose, onCopy, onClear, onRemove, onUpdate, onIgnoreUpdate, cancelTask, restarting, onRestart, onRunDiagnostics, resolveRepo }: {
   records: NotificationRecord[]
   /** 进行中的安装/卸载任务（实时进度，与队列弹窗同一数据源） */
   tasks: QueueTask[]
@@ -76,6 +76,8 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
   cancelTask: (id: number) => void
   restarting: boolean
   onRestart: () => void
+  /** 网络不通时的「去系统诊断」直达按钮：跳到设置 → 系统诊断跑连通性检测（由宿主提供） */
+  onRunDiagnostics?: () => void
   /** 失败记录 repo 反查：npm 包名（历史记录存的是裸包名）反查成 owner/repo 再显示/提 Issue；
    *  查不到返回 null，按钮与仓库链接一并隐藏（防提到错误仓库）。不传则按记录原样展示。 */
   resolveRepo?: (repo: string) => string | null
@@ -193,8 +195,12 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                     h('span', {
                       className: r.ok ? styles.noticeTextOk : styles.noticeTextFail,
                     }, r.ok
-                      ? (isUpdate ? t('updateNoticeTitle') : (r.kind === 'install' ? t('installDone') : t('uninstallDone')))
-                      : (r.kind === 'install' ? t('errorTitleInstall') : t('errorTitleUninstall'))),
+                      ? (isUpdate
+                        ? t('updateNoticeTitle')
+                        : (r.action === 'update' ? t('updateDone') : (r.kind === 'install' ? t('installDone') : t('uninstallDone'))))
+                      : (r.action === 'update'
+                        ? t('errorTitleUpdate')
+                        : (r.kind === 'install' ? t('errorTitleInstall') : t('errorTitleUninstall')))),
                     // 更新提醒：新版本号紧随标题展示；repo 为纯文本（整行点击即去更新，不跳官网外链）
                     isUpdate && r.version
                       ? h('span', { className: styles.noticeVersion, title: r.version }, `v${r.version}`)
@@ -211,7 +217,9 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                             rel: 'noopener noreferrer',
                             title: shownRepo,
                           }, shownRepo)
-                          : null)
+                          // 反查不到仓库身份（如命令行安装的裸 npm 包名）：回退显示记录里的原始值，
+                          // 保证通知永不只剩一句「安装/更新成功」没有名字 —— 只是不给官网外链（查不到不敢乱跳）
+                          : h('span', { className: styles.failRepo, title: r.repo }, r.repo))
                       : null,
                     !r.ok && h('button', {
                       className: styles.failCopy,
@@ -258,6 +266,20 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                       return h('div', { className: styles.failPrepareHint },
                         t(v ? 'failNpmTooLowV' : 'failNpmTooLow', v ? { v } : undefined))
                     }
+                    if (kind === 'network') {
+                      // 安装前预检 / 安装日志里的连接失败（[network] / git fetch 超时 / DNS / TLS）：
+                      // 是本机网络不通或代理有问题，不是插件问题 —— 提示检查网络 + 直达「系统诊断」，
+                      // 不引导提 Issue
+                      return h('div', null, [
+                        // 「无法访问 …」醒目行：精准告诉用户具体哪个地址连不上（消息里取不到地址就跳过这行）
+                        (() => { const target = unreachableTargetOf(r.message); return target ? h('div', { className: styles.failNetworkTarget }, t('failNetworkTarget', { url: target })) : null })(),
+                        h('div', { className: styles.failPrepareHint }, t('failNetworkHint')),
+                        onRunDiagnostics ? h('button', {
+                          className: styles.failDiagBtn,
+                          onClick: onRunDiagnostics,
+                        }, t('failNetworkRunDiag')) : null,
+                      ])
+                    }
                     if (kind === 'pluginPrepare' || kind === 'pnpmIgnoredBuild') {
                       // [packaging]（预检/装后校验拦截：git 分发缺产物）与
                       // prepare 构建脚本实际执行失败 / 原生依赖构建被 pnpm 拦截：都是插件打包分发问题 —— 先说明原因，按钮在下方提交

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

@@ -16,7 +16,7 @@ import { CloseIcon, ConfirmIcon, CopyIcon, LinkIcon } from '../ui/icons.tsx'
 import { ProgressView } from './ProgressView.tsx'
 import { installCommandOf } from '../../logic/install-command.ts'
 import { pluginDetailUrl, pluginIssueUrl, pluginSiteUrl } from '../../logic/urls.ts'
-import { classifyFailure, npmTooLowVersion } from '../../logic/failures.ts'
+import { classifyFailure, npmTooLowVersion, unreachableTargetOf } from '../../logic/failures.ts'
 
 /** 完成结果视图：绿色对勾 + 标题/描述；
  *  needsRestart=true（插件需重启才生效）→ 「稍后重启 / 立即重启」按钮对，点稍后重启后
@@ -320,7 +320,7 @@ export function UninstallModal(props: UninstallModalProps) {
 
 /** 预填插件仓库的 GitHub Issue 链接：标题带插件名，正文附完整错误信息，方便用户一键反馈。 */
 /** 安装/卸载失败弹窗：布局与失败记录一致（类型徽标 + 仓库超链接 + 隐蔽复制按钮），报错完整展示，底部一键提交 Issue。 */
-export function ErrorModal({ message, repo, kind, command, attempts, t, env, onCopy, onClose }: {
+export function ErrorModal({ message, repo, kind, command, attempts, t, env, onCopy, onClose, onRunDiagnostics }: {
   message: string
   repo: string | null
   kind: 'install' | 'uninstall'
@@ -331,6 +331,8 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
   env: EnvInfo | null
   onCopy: (text: string) => void
   onClose: () => void
+  /** 网络不通时的「去系统诊断」直达按钮：跳到设置 → 系统诊断跑连通性检测（由宿主提供） */
+  onRunDiagnostics?: () => void
 }) {
   // 失败归类：当前安装通道（npm/git）装不上 = 插件分发/依赖的问题，一律引导提 Issue
   const failureKind = classifyFailure(message)
@@ -385,7 +387,20 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
           failureKind === 'npmTooOld'
             ? h('div', { className: styles.failPrepareHint },
               t(npmVersion ? 'failNpmTooLowV' : 'failNpmTooLow', npmVersion ? { v: npmVersion } : undefined))
-            : failureKind === 'pluginPrepare' || failureKind === 'pnpmIgnoredBuild'
+            : failureKind === 'network'
+              // 安装前预检 / 安装日志里的连接失败（[network] / git fetch 超时 / DNS / TLS）：
+              // 是本机网络不通或代理有问题，不是插件问题 —— 提示检查网络 + 直达「系统诊断」，
+              // 不引导提 Issue
+              ? h('div', null, [
+                // 「无法访问 …」醒目行：精准告诉用户具体哪个地址连不上（消息里取不到地址就跳过这行）
+                (() => { const target = unreachableTargetOf(message); return target ? h('div', { className: styles.failNetworkTarget }, t('failNetworkTarget', { url: target })) : null })(),
+                h('div', { className: styles.failPrepareHint }, t('failNetworkHint')),
+                onRunDiagnostics ? h('button', {
+                  className: styles.failDiagBtn,
+                  onClick: onRunDiagnostics,
+                }, t('failNetworkRunDiag')) : null,
+              ])
+              : failureKind === 'pluginPrepare' || failureKind === 'pnpmIgnoredBuild'
               ? h('div', null, [
                 // [packaging]（预检/装后校验拦截：git 分发缺产物）与
                 // prepare 构建脚本实际执行失败 / 原生依赖构建被 pnpm 拦截：都是插件打包分发问题 —— 先说明原因，按钮在下方提交

package/src/client/components/views/DiagnosticsView.tsx

@@ -15,7 +15,7 @@ import styles from '../../styles/DiagnosticsView.module.css'
 import type { EnvInfo, Translate } from '../../types.ts'
 import { PLUGIN_VERSION } from '../../logic/constants.ts'
 
-type ProbeKey = 'npm' | 'github' | 'catalog'
+type ProbeKey = 'npm' | 'github' | 'catalog' | 'proxy'
 
 /** 系统版本文本：提交 Issue 时粘贴到正文，方便作者复现。 */
 function formatEnv(env: EnvInfo): string {
@@ -40,17 +40,28 @@ interface RowState {
 }
 
 const INITIAL_ROWS: RowState[] = [
-  { key: 'npm', display: 'registry.npmjs.org', nameKey: 'diagNpm', status: 'idle', ms: null, statusCode: null },
-  { key: 'github', display: 'github.com', nameKey: 'diagGithub', status: 'idle', ms: null, statusCode: null },
+  // npm 行 display 初始置空：设置里未配置镜像时显示「未配置（跟随本机）」，探测结果回来再用服务端 display 覆盖
+  { key: 'npm', display: '', nameKey: 'diagNpm', status: 'idle', ms: null, statusCode: null },
+  { key: 'github', display: 'github.com/dshplugin/hello-dsh', nameKey: 'diagGithub', status: 'idle', ms: null, statusCode: null },
   { key: 'catalog', display: 'api.dsh-plugin.org', nameKey: 'diagCatalog', status: 'idle', ms: null, statusCode: null },
 ]
 
-export function DiagnosticsView({ t, env, onCopy }: {
+export function DiagnosticsView({ t, env, proxy, onCopy }: {
   t: Translate
   env: EnvInfo | null
+  /** 设置里配置的 HTTP 代理地址；留空（未配置）不显示代理行 */
+  proxy: string
   onCopy: (text: string) => void
 }) {
-  const [rows, setRows] = useState<RowState[]>(INITIAL_ROWS)
+  // 代理行仅在配置了 HTTP 代理时出现：用该代理探测 github.com，验证「代理能不能把请求带出去」。
+  // 未配置（留空直连）没有可验证的代理，不渲染这一行，避免无意义的诊断项。
+  const [rows, setRows] = useState<RowState[]>(() => {
+    const base = INITIAL_ROWS.map((r) => ({ ...r }))
+    if (proxy.trim() !== '') {
+      base.push({ key: 'proxy', display: proxy.trim(), nameKey: 'diagProxy', status: 'idle', ms: null, statusCode: null })
+    }
+    return base
+  })
   /** 当前探测请求：重测/卸载时 abort 旧请求，避免乱序结果覆盖 */
   const runningRef = useRef<AbortController | null>(null)
 
@@ -87,12 +98,14 @@ export function DiagnosticsView({ t, env, onCopy }: {
             const raw = buf.slice(0, nl).trim()
             buf = buf.slice(nl + 1)
             if (raw !== '') {
-              const ev = JSON.parse(raw) as { type?: string; key?: string; ms?: number | null; status?: number | null }
+              const ev = JSON.parse(raw) as { type?: string; key?: string; ms?: number | null; status?: number | null; display?: string }
               if (ev.type === 'ok' || ev.type === 'fail') {
                 patchRows(ev.key as ProbeKey, {
                   status: ev.type === 'ok' ? 'ok' : 'fail',
                   ms: typeof ev.ms === 'number' ? ev.ms : null,
                   statusCode: typeof ev.status === 'number' ? ev.status : null,
+                  // 服务端带出实际使用的源地址（配置镜像 → 镜像地址；未配置 → 空串）
+                  display: typeof ev.display === 'string' ? ev.display : '',
                 })
               }
             }
@@ -159,7 +172,8 @@ export function DiagnosticsView({ t, env, onCopy }: {
         title: t('diagRecheck'),
       },
         h('span', { className: styles.name }, t(r.nameKey)),
-        h('span', { className: styles.display }, r.display),
+        // npm 行未配置镜像：display 为空 → 显示「未配置（跟随本机）」，不误导成官方源
+        h('span', { className: styles.display }, r.display !== '' ? r.display : t('diagNpmUnset')),
         h('span', { className: styles.meta }, r.status === 'ok' && r.ms !== null ? `${r.ms} ms` : ''),
         badge,
       )