dsh-plugin 1.3.6 → 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';
@@ -492,9 +492,17 @@ export function mountPluginHubRoutes(webServer, profile, loader) {
                 // npm 行 display：配置了镜像就显示镜像地址；未配置置空 —— 客户端显示「未配置（跟随本机 npm 配置）」。
                 const allChecks = [
                     { key: 'npm', url: `${registry}/dsh-plugin`, display: settings.npmRegistry !== '' ? registry : '', 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' },
+                    // 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',
@@ -504,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();
@@ -531,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',
@@ -605,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 解析，
@@ -704,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/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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin",
-  "version": "1.3.6",
+  "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,6 +128,8 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
 
   const queue = useTaskQueue({
     t,
+    // 界面语言带给服务端：网络预检等错误消息按用户语言提示（中文界面给中文，英文界面给英文）
+    langKey,
     refreshInstalled: catalog.refreshInstalled,
     onInstallDone: (viaModal, repo, needsRestart, update) => {
       setInstallNeedsRestart(needsRestart)
@@ -462,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 拉取失败时兜底展示当前版本号。
@@ -521,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),
@@ -704,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
@@ -264,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 {
@@ -42,16 +42,26 @@ interface RowState {
 const INITIAL_ROWS: RowState[] = [
   // npm 行 display 初始置空：设置里未配置镜像时显示「未配置（跟随本机）」，探测结果回来再用服务端 display 覆盖
   { key: 'npm', display: '', nameKey: 'diagNpm', status: 'idle', ms: null, statusCode: null },
-  { key: 'github', display: 'github.com', nameKey: 'diagGithub', 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)
 

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

@@ -15,7 +15,7 @@
  *   Diagnostics       — live connectivity probe + environment snapshot
  *   Logs              — system log viewer + storage location
  */
-import { createElement as h, useState } from 'react'
+import { createElement as h, useEffect, useRef, useState } from 'react'
 import type { ChangeEvent, MouseEvent, ReactNode } from 'react'
 import styles from '../../styles/SettingsView.module.css'
 import dropdownStyles from '../../styles/Dropdown.module.css'
@@ -30,7 +30,8 @@ import {
 import type { EnvInfo, Translate } from '../../types.ts'
 import type { HubSettings } from '../../hooks/useSettings.ts'
 
-type SettingsSection = 'updates' | 'security' | 'diagnostics' | 'logs' | 'reset'
+/** 设置分组导航 key：顺序即展示顺序。导出供外部（如错误弹窗「去系统诊断」）跳转指定分组。 */
+export type SettingsSection = 'updates' | 'security' | 'diagnostics' | 'logs' | 'reset'
 
 /** npm 镜像源预设：空串 = 未配置（跟随用户本机 npm 配置，本插件不注入任何 registry）。
  *  只提供常见国内顶级镜像下拉，不做自定义输入 —— 想用其它镜像直接在 ~/.npmrc 配置即可。 */
@@ -67,20 +68,70 @@ function SettingRow({ title, desc, children, stack = false }: {
   )
 }
 
-export function SettingsView({ t, settings, update, reset, env, onCopy }: {
+export function SettingsView({ t, settings, update, reset, env, onCopy, openSection, onConsumedOpenSection }: {
   t: Translate
   settings: HubSettings
   update: (patch: Partial<HubSettings>) => void
   reset: () => void
   env: EnvInfo | null
   onCopy: (text: string) => void
+  /** 外部跳转信号（如错误弹窗「去系统诊断」）：非空时切到对应分组，消费后通过 onConsumedOpenSection 清空 */
+  openSection?: SettingsSection | null
+  onConsumedOpenSection?: () => void
 }) {
   /** 当前激活的分组：左侧导航点击切换，右侧只渲染这一组 */
   const [section, setSection] = useState<SettingsSection>('updates')
   /** 恢复默认确认弹窗：点按钮先弹窗询问，确认后才真正 reset（不做两段式按钮） */
   const [resetConfirm, setResetConfirm] = useState(false)
 
-  const onProxyChange = (e: ChangeEvent<HTMLInputElement>) => update({ proxy: e.target.value })
+  // 外部跳转（错误弹窗「去系统诊断」→ 设置 → 系统诊断）：切到对应分组并清空信号，避免下次进入设置被强制带跳
+  useEffect(() => {
+    if (!openSection) return
+    setSection(openSection)
+    onConsumedOpenSection?.()
+  }, [openSection, onConsumedOpenSection])
+
+  // —— HTTP 代理连通性：输入停笔后防抖实时探测（服务端 /proxy-check 用该代理打 github.com）。
+  // 结果只作提示、绝不阻断保存 —— 用户可能是先填地址后开代理，保存后再去开代理完全合法。
+  const [proxyProbe, setProxyProbe] = useState<'idle' | 'checking' | 'ok' | 'fail'>('idle')
+  const proxyProbeTimer = useRef<number | null>(null)
+  const proxyProbeSeq = useRef(0)
+  // 卸载时清掉未触发的防抖计时器，避免卸载后 setState
+  useEffect(() => () => {
+    if (proxyProbeTimer.current !== null) window.clearTimeout(proxyProbeTimer.current)
+    proxyProbeSeq.current += 1
+  }, [])
+  // 设置被外部重置（恢复默认/清空代理）时同步清掉探测状态，避免残留过期的「不通」提示
+  useEffect(() => {
+    if (settings.proxy === '') setProxyProbe('idle')
+  }, [settings.proxy])
+
+  const probeProxyNow = (value: string) => {
+    const v = value.trim()
+    if (v === '') { setProxyProbe('idle'); return }
+    const seq = ++proxyProbeSeq.current
+    setProxyProbe('checking')
+    void fetch('/dsh-plugin-hub/proxy-check', {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ proxy: v }),
+      cache: 'no-store',
+    }).then((res) => res.json())
+      .then((data: { ok?: boolean }) => {
+        if (seq !== proxyProbeSeq.current) return
+        setProxyProbe(data.ok ? 'ok' : 'fail')
+      })
+      .catch(() => { if (seq === proxyProbeSeq.current) setProxyProbe('fail') })
+  }
+
+  const onProxyChange = (e: ChangeEvent<HTMLInputElement>) => {
+    const value = e.target.value
+    // 保存照常：留空直连、填了就走该代理（先填后开代理也允许，仅提示不通）
+    update({ proxy: value })
+    if (proxyProbeTimer.current !== null) window.clearTimeout(proxyProbeTimer.current)
+    // 停笔 700ms 再探测，避免每敲一个字符都发请求
+    proxyProbeTimer.current = window.setTimeout(() => probeProxyNow(value), 700)
+  }
   const onMirrorChange = (value: string) => update({ npmRegistry: value })
 
   /** 每个分组的页面副标题（导航标题之上再补一句说明，保持桌面设置质感） */
@@ -120,19 +171,29 @@ export function SettingsView({ t, settings, update, reset, env, onCopy }: {
         className: `${styles.controlDropdown} ${dropdownStyles.dropdownFill}`,
       }),
     }),
-    // 代理地址：文本框独占一行，整行输入，便于粘贴长代理地址
+    // 代理地址：文本框独占一行，整行输入，便于粘贴长代理地址；停笔后实时探测连通性，
+    // 不通仅提示（可保存）—— 用户可能先填地址后开代理
     h(SettingRow, {
       title: t('settingsProxy'),
       desc: t('settingsProxyDesc'),
       stack: true,
-      children: h('input', {
-        className: styles.textInput,
-        type: 'text',
-        value: settings.proxy,
-        placeholder: 'http://127.0.0.1:7890',
-        spellCheck: false,
-        onChange: onProxyChange,
-      }),
+      children: h('div', { className: styles.proxyControl },
+        h('input', {
+          className: styles.textInput,
+          type: 'text',
+          value: settings.proxy,
+          placeholder: 'http://127.0.0.1:7890',
+          spellCheck: false,
+          onChange: onProxyChange,
+        }),
+        proxyProbe === 'checking'
+          ? h('div', { className: styles.proxyHint }, t('proxyCheckChecking'))
+          : proxyProbe === 'ok'
+            ? h('div', { className: `${styles.proxyHint} ${styles.proxyHintOk}` }, t('proxyCheckOk'))
+            : proxyProbe === 'fail'
+              ? h('div', { className: `${styles.proxyHint} ${styles.proxyHintFail}` }, t('proxyCheckFail'))
+              : null,
+      ),
     }),
   )
 
@@ -172,7 +233,7 @@ export function SettingsView({ t, settings, update, reset, env, onCopy }: {
 
   const diagnosticsCard = h('div', { className: styles.card },
     // 系统版本（最顶部）+ 通道状态列表：进入页面自动探测一轮，整行可点击重测单项，实时反馈
-    h(DiagnosticsView, { t, env, onCopy }),
+    h(DiagnosticsView, { t, env, proxy: settings.proxy, onCopy }),
   )
 
   const logsCard = h('div', { className: styles.card },

package/src/client/hooks/useTaskQueue.ts

@@ -10,7 +10,7 @@
  * uninstall, cancel) plus the modal task lookups used by the dialogs.
  */
 import { useEffect, useRef, useState } from 'react'
-import type { HubPlugin, Translate } from '../types.ts'
+import type { HubPlugin, LocaleId, Translate } from '../types.ts'
 import { installCommandOf, installTargetOf, repoFromInstallTarget } from '../logic/install-command.ts'
 import type { InstalledItem } from '../logic/installed.ts'
 
@@ -64,6 +64,8 @@ export interface PendingRestart {
 
 export interface TaskQueueOptions {
   t: Translate
+  /** 界面语言（zh/en）：随安装请求带给服务端，网络预检等错误消息按用户语言提示 */
+  langKey?: LocaleId
   refreshInstalled: () => void
   /** 任务成功完成：viaModal 表示任务对应当前打开弹窗（弹窗切结果视图），否则走 Toast；repo 供成功通知记录；
    *  needsRestart 表示该任务完成后是否仍需宿主重启（结果视图据此给「重启 / 仅完成」）。
@@ -89,7 +91,7 @@ export interface TaskQueueOptions {
 
 export function useTaskQueue(opts: TaskQueueOptions) {
   const {
-    t, refreshInstalled, onInstallDone, onUninstallDone, onError,
+    t, langKey, refreshInstalled, onInstallDone, onUninstallDone, onError,
     installPlugin, installCustomTarget, installGlobalTarget, uninstallPlugin, uninstallName, installedName, resolvePending,
   } = opts
   const [queue, setQueue] = useState<QueueTask[]>([])
@@ -442,6 +444,8 @@ export function useTaskQueue(opts: TaskQueueOptions) {
           display: input.repo,
           source: input.source,
           mode: input.update ? 'update' : undefined,
+          // 界面语言带给服务端：网络预检等错误消息按用户当前语言返回（中文界面给中文，英文界面给英文）
+          ...(langKey ? { lang: langKey } : {}),
           ...(input.globalNpm && input.globalNpm.length > 0 ? { globalNpm: input.globalNpm } : {}),
         }),
         signal: controller.signal,