dsh-plugin 1.3.6 → 1.3.7

package/src/client/locales.ts

@@ -110,6 +110,10 @@ export const zh = {
   settingsCheckOnStartDesc: '打开插件中心时检查已安装插件是否有新版，发现更新会提示',
   settingsProxy: 'HTTP 代理',
   settingsProxyDesc: 'npm / git / 目录数据请求统一走该代理；留空直连',
+  // 代理连通性实时探测：输入停笔后提示检测结果（不通仍可保存，先填地址后开代理也合法）
+  proxyCheckChecking: '正在测试该代理地址…',
+  proxyCheckOk: '测试可达，安装与目录请求将统一走该代理',
+  proxyCheckFail: '此地址测试不通，仍可保存；请确认代理已开启、地址与端口无误',
   settingsMirror: 'npm 镜像源',
   settingsMirrorDesc: '默认跟随本机 npm 配置；官方源慢可换国内镜像',
   mirrorNone: '未配置（跟随本机 npm 配置）',
@@ -186,6 +190,7 @@ export const zh = {
   diagNpmUnset: '未配置（跟随本机 npm 配置）',
   diagGithub: 'GitHub',
   diagCatalog: '目录站点',
+  diagProxy: 'HTTP 代理',
   diagOk: 'OK',
   diagChecking: '检测中…',
   diagIdle: '未检测',
@@ -294,10 +299,16 @@ export const zh = {
   // 安装前预检 / 装后校验拦截（[packaging]）：git 分发缺构建产物、入口文件不存在 = 插件未适配官方默认安装方式
   failPackagingHint: '该插件不支持官方默认安装方式：其 git 分发缺少构建产物（package.json 声明的入口文件在仓库中不存在），说明作者未适配官方安装流程。请到作者仓库提交 Issue 反馈，请其提交构建产物或发布 npm 版。',
   // 原生依赖构建脚本被 pnpm 默认拦截（如 node-pty 的 ERR_PNPM_IGNORED_BUILDS）：只影响带原生模块的插件，属插件依赖打包问题，应提 Issue
-  failIgnoredBuild: '该插件依赖了需要编译的原生模块（如 node-pty），pnpm 默认拦截这类构建脚本导致安装失败 —— 其他插件不受影响，属该插件的依赖/打包问题。建议向作者仓库一键反馈，请作者改用预编译版本（如 node-pty-prebuilt-multiarch）。',
+  failIgnoredBuild: '该插件或其依赖需要执行构建脚本，被 pnpm 的安全白名单（allowBuilds）默认拦截导致安装失败（如原生模块 node-pty、或 git 安装时插件的 prepare 脚本）—— 其他插件不受影响，属该插件的依赖/打包问题。建议向作者仓库一键反馈，请作者改用预编译版本（如 node-pty-prebuilt-multiarch）或移除安装期构建。',
   // npm arborist 内部崩溃（edgesOut）＋ 本机 npm 版本过低：npm 自身已知缺陷，不是插件问题，升级 npm 即可
   failNpmTooLow: '怀疑本机 npm 版本过低：npm 解析插件依赖时内部崩溃（这是 npm 自身的已知缺陷，不是插件问题）。请升级 npm 后重试：npm install -g npm@latest',
   failNpmTooLowV: '本机 npm 版本过低（当前 v{v}）：npm 解析插件依赖时内部崩溃（这是 npm 自身的已知缺陷，不是插件问题）。请升级 npm 后重试：npm install -g npm@latest',
+  // 安装前连通性预检 / 安装日志里的连接失败（[network] / git fetch 超时 / DNS / TLS）：本机网络或代理问题，不是插件问题，不引导提 Issue
+  failNetworkHint: '安装前检测到网络不通：无法连接到安装源（可能是断网、DNS 解析失败、被防火墙拦截，或代理配置有问题）。这不是插件本身的问题 —— 请检查网络连接，或到「设置」里确认 HTTP 代理配置，再到「系统诊断」运行一次连通性检测，然后重试。',
+  // 网络失败弹窗里的「无法访问 …」醒目行：直接告诉用户具体哪个地址连不上（{url} 为提取的不可达地址）
+  failNetworkTarget: '无法访问 {url} —— 你的网络连接不通',
+  // 「去系统诊断」直达按钮：网络不通提示下方的品牌实底按钮，跳到设置 → 系统诊断跑连通性检测
+  failNetworkRunDiag: '去系统诊断检测网络',
   reportIssue: '去插件仓库提交 Issue',
   detail: '打开详情',
   noResult: '没有找到匹配的插件',
@@ -445,6 +456,11 @@ export const en = {
   settingsAutoInstallDesc: 'Install detected updates in the background without asking (a host restart applies them)',
   settingsProxy: 'HTTP proxy',
   settingsProxyDesc: 'Route npm, git and catalog requests through this proxy; leave empty to connect directly',
+  // Live proxy reachability probe: reported after the user stops typing (an unreachable
+  // address can still be saved — users may fill it in before actually starting the proxy)
+  proxyCheckChecking: 'Testing this proxy address…',
+  proxyCheckOk: 'Reachable — installs and catalog requests will route through it',
+  proxyCheckFail: 'Unreachable, but you can still save it; make sure the proxy is running and the address and port are correct',
   settingsMirror: 'npm mirror',
   settingsMirrorDesc: 'Unset by default — follows local npm config; pick a domestic mirror if slow',
   mirrorNone: 'Unset (follow local npm config)',
@@ -521,6 +537,7 @@ export const en = {
   diagNpmUnset: 'Unset (follow local npm config)',
   diagGithub: 'GitHub',
   diagCatalog: 'Catalog site',
+  diagProxy: 'HTTP proxy',
   diagOk: 'OK',
   diagChecking: 'Checking…',
   diagIdle: 'Not checked',
@@ -628,9 +645,15 @@ export const en = {
   // Pre-install / post-install guard hit ([packaging]): git distribution lacks build output, entry file missing = not adapted to the official default install method
   failPackagingHint: 'This plugin does not support the official default install method: its git distribution lacks the build output (the entry file declared in package.json is not in the repository), so it has not been adapted to the official install flow. Please file an Issue on the author\'s repo asking for committed build output or an npm release.',
   // native-module build scripts ignored by pnpm by default (e.g. node-pty, ERR_PNPM_IGNORED_BUILDS): only affects plugins with native deps — a dependency/packaging issue of the plugin itself, file an issue
-  failIgnoredBuild: 'This plugin depends on a native module (e.g. node-pty) whose build script pnpm blocks by default, so the install fails — other plugins are unaffected. This is a dependency/packaging issue of the plugin itself. Please report it to the author repository and ask the author to switch to a prebuilt variant (e.g. node-pty-prebuilt-multiarch).',
+  failIgnoredBuild: 'This plugin (or its dependencies) needs to run build scripts, which pnpm blocks by default via its allowBuilds allowlist, so the install fails (e.g. native modules like node-pty, or the plugin\'s own prepare script on git installs) — other plugins are unaffected. This is a dependency/packaging issue of the plugin itself. Please report it to the author repository and ask the author to ship a prebuilt variant (e.g. node-pty-prebuilt-multiarch) or drop install-time builds.',
   failNpmTooLow: 'Your local npm may be too old: npm crashed internally while resolving the plugin\'s dependencies (a known npm bug — not a plugin issue). Please upgrade npm and retry: npm install -g npm@latest',
   failNpmTooLowV: 'Your local npm is too old (v{v}): npm crashed internally while resolving the plugin\'s dependencies (a known npm bug — not a plugin issue). Please upgrade npm and retry: npm install -g npm@latest',
+  // Pre-install connectivity probe / connection failure in the install log ([network] / git fetch timeout / DNS / TLS): a local network or proxy issue, not a plugin issue — no issue link
+  failNetworkHint: 'The network could not be reached before install: the install source is unreachable (offline, DNS failure, firewall block, or a misconfigured proxy). This is not a problem with the plugin itself — please check your connection, confirm the HTTP proxy in Settings, run a connectivity check under System Diagnostics, then retry.',
+  // Prominent "cannot reach …" line in the network-failure dialog: shows the exact unreachable address ({url})
+  failNetworkTarget: 'Cannot reach {url} — your network connection is down',
+  // Diagnostics shortcut button under the network-down hint: jumps to Settings → System Diagnostics
+  failNetworkRunDiag: 'Run a network diagnostic',
   reportIssue: 'Report an Issue to the plugin repo',
   detail: 'Open details',
   noResult: 'No plugins match your search',

package/src/client/logic/failures.ts

@@ -151,18 +151,22 @@ export function removeNotification(id: number): NotificationRecord[] {
   return next
 }
 
-export type FailureKind = 'npmTooOld' | 'pnpmIgnoredBuild' | 'pluginPrepare' | 'repo'
+export type FailureKind = 'npmTooOld' | 'pnpmIgnoredBuild' | 'pluginPrepare' | 'network' | 'repo'
 
 /**
- * 失败归类，四态。无论底层机制如何（pnpm 白名单拦截 / 构建脚本被忽略 / prepare 失败），
+ * 失败归类，五态。无论底层机制如何（pnpm 白名单拦截 / 构建脚本被忽略 / prepare 失败），
  * 对用户而言结果都一样 —— 当前安装通道（npm 或 git）装不上，就是插件分发/依赖的问题，
- * 一律引导提 Issue；唯一例外是本机 npm 自身版本过低导致的内部崩溃（见 npmTooOld）：
+ * 一律引导提 Issue；唯一的两个例外是本机环境问题（npm 版本过低 / 网络不通）：
  * - npmTooOld：失败输出含 npm arborist 的 `edgesOut` 崩溃特征（build-ideal-tree.js 解 peer 依赖时
  *   内部抛错，npm 11.6.0 前必现的已知缺陷，npm/cli#8261、#9787），或服务端已核实本机版本低于
  *   阈值并打了 `[npm-too-low]` 标记 —— 是本机 npm 版本过低/自身缺陷，不是插件问题 → 引导升级 npm
- * - pnpmIgnoredBuild：插件依赖里的原生模块构建脚本被 pnpm 默认拦截（如 node-pty，
- *   `ERR_PNPM_IGNORED_BUILDS`）。只影响带原生模块的插件，其他插件不受影响 —— 差异在
- *   插件的依赖选择，属插件依赖/打包问题 → 引导去仓库提 Issue（建议改用预编译版本）
+ * - network：安装前连通性预检拦截（服务端 `[network]` 标记）或底层连接失败
+ *   （ERR_PNPM_GIT_FETCH_FAILED / ETIMEDOUT / DNS 解析 / TLS 握手 / 代理拒绝）——
+ *   是本机网络不通/被墙/代理有问题，不是插件问题 → 提示检查网络，不引导提 Issue
+ * - pnpmIgnoredBuild：插件自身或依赖的构建脚本被 pnpm 安全白名单（allowBuilds）默认拦截
+ *   （`ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED` / `ERR_PNPM_IGNORED_BUILDS`）。只影响带安装期
+ *   构建的插件，其他插件不受影响 —— 差异在插件的依赖/打包方式，属插件依赖/打包问题
+ *   → 引导去仓库提 Issue（建议改用预编译版本或关闭安装期构建）
  * - pluginPrepare：插件的 prepare/构建脚本实际执行失败（git tarball 常因缺失子模块或
  *   构建产物导致）—— 属插件打包/分发问题，应引导去仓库提 Issue
  * - repo：其余失败（含 git prepare 被 pnpm 白名单拦截等），默认按插件仓库问题引导提 Issue
@@ -172,12 +176,22 @@ export function classifyFailure(message: string): FailureKind {
   // 不是插件问题 —— 必须最先判，否则该报错会被外层 ERR_PNPM_PREPARE_PACKAGE 吞成
   // 「插件打包分发问题」，误导用户去提 Issue
   if (/\[npm-too-low\]|edgesOut/i.test(message)) return 'npmTooOld'
+  // 构建脚本被 pnpm 白名单（allowBuilds）拦截：插件的 prepare 脚本或依赖里的原生模块构建
+  // 被默认拒绝（ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED / ERR_PNPM_IGNORED_BUILDS）。
+  // 这类错误出现即说明 pnpm 已成功 fetch 到 tarball（网络是通的），主因是插件构建脚本
+  // 被拦 —— 必须在 network 判定之前：日志尾部常混着重试残留的连接失败特征
+  // （ETIMEDOUT / Failed to connect 等），若先判网络会把「插件分发问题」误报成
+  // 「你的网络不通」（graph-memory issues #82-#84：PREPARE_NOT_ALLOWED + 尾随超时）。
+  if (/ERR_PNPM_IGNORED_BUILDS|Ignored build scripts:|ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED/i.test(message)) return 'pnpmIgnoredBuild'
+  // 网络问题（服务端 [network] 标记，或安装日志里的连接失败特征：git fetch 失败、
+  // 连接超时/拒绝/重置、DNS 解析失败、TLS/SSL 握手失败）—— 是本机网络/代理问题，
+  // 不是插件问题。必须在 prepare/Command failed 判定之前：git fetch 失败常被
+  // 外层包成 "Command failed: git fetch ..."，先按网络特征归类才不会误判成插件问题。
+  // 404 类「目标不存在」不含这些特征，仍归 repo（那是仓库/包的问题）。
+  if (/\[network\]|ERR_PNPM_GIT_FETCH_FAILED|ETIMEDOUT|ECONNREFUSED|ECONNRESET|ENOTFOUND|EAI_AGAIN|EPIPE|EHOSTUNREACH|ENETUNREACH|getaddrinfo|Could not connect|Could not resolve host|Network unreachable|Failed to connect|socket hang up|CERT_HAS_EXPIRED|SSL certificate problem|\bTLS\b|\bSSL\b/i.test(message)) return 'network'
   // 装后校验拦截（服务端 verifyInstalledEntry 标记）：入口文件缺失 = git 分发缺构建产物，
   // 与 pluginPrepare 同类（插件打包/分发问题），引导去仓库提 Issue
   if (/\[packaging\]|entry file missing/i.test(message)) return 'pluginPrepare'
-  // 原生模块构建被忽略（IGNORED_BUILDS）要在 prepare 判定之前：dsh 尾部固定提示语带
-  // allowBuilds/pnpm-workspace.yaml，不能据此把插件自身问题误判成通用失败
-  if (/ERR_PNPM_IGNORED_BUILDS|Ignored build scripts:/i.test(message)) return 'pnpmIgnoredBuild'
   // 再判 prepare 实际执行失败：只有构建脚本真的跑挂了才是插件问题
   if (/ERR_PNPM_PREPARE_PACKAGE|ELIFECYCLE|Command failed|prepare-guard/i.test(message)) return 'pluginPrepare'
   // 其余失败（含 git prepare 被 pnpm 白名单拦截）：当前通道装不上 = 插件分发/依赖的问题，一律提 Issue
@@ -237,3 +251,18 @@ export function coreErrorCode(message: string): string | null {
   const m = message.match(/\[?ERR_[A-Z_]+\]?/)
   return m ? m[0].replace(/^\[|\]$/g, '') : null
 }
+
+/**
+ * 从网络类失败消息里提取「具体连不上的地址」，供弹窗精准提示（你的网络无法访问什么）。
+ * 优先取服务端 [network] 预检消息括号里的探测地址（中文「（…）」/ 英文「(…)」），
+ * 否则取消息里出现的第一个 URL（git fetch 的仓库地址、registry 域名等）。
+ * 提取不到返回 null —— 调用方据此跳过地址行。
+ */
+export function unreachableTargetOf(message: string): string | null {
+  // [network] 预检消息：`无法连接到 GitHub（https://github.com/）` / `cannot reach the npm registry (https://registry.npmjs.org/)`
+  const paren = message.match(/[（(](https?:\/\/[^\s'"`<>（)+]+)[)）]/)
+  if (paren) return paren[1]
+  // 其余网络失败（git fetch / npm 连接失败）：取第一个 URL，去掉行尾标点
+  const url = message.match(/https?:\/\/[^\s'"`<>（）()]+/)
+  return url ? url[0].replace(/[.,;:）)\]]+$/, '') : null
+}

package/src/client/logic/renderMarkdown.ts

@@ -33,12 +33,12 @@ function inline(s: string): string {
     return `\u0000${codeSpans.length - 1}\u0000`
   })
   // 图片 ![alt](url)：仅放行 http(s)，用于展示反馈群二维码等；limited by CSS
-  // 文件名为 dsh-plugin-user-group-qr- 前缀的视为用户反馈群二维码，固定 250×250 不撑破弹窗。
+  // 文件名为 dsh-plugin-user-group-qr- 前缀的视为用户反馈群二维码，固定 100×100 不撑破弹窗。
   out = out.replace(/!\[([^\]]*)\]\(([^)\s]+)\)/g, (m, alt, url) => {
     const src = String(url)
     if (!/^https?:\/\//i.test(src) || /[\u0000]/.test(src)) return m
     if (/\/dsh-plugin-user-group-qr-[^/]*$/i.test(src)) {
-      return `<img src="${src}" alt="${String(alt)}" width="250" height="250" loading="lazy">`
+      return `<img src="${src}" alt="${String(alt)}" width="100" height="100" loading="lazy">`
     }
     return `<img src="${src}" alt="${String(alt)}" loading="lazy">`
   })

package/src/client/logic/urls.ts

@@ -10,6 +10,7 @@
 import type { EnvInfo, HubPlugin, LocaleId } from '../types.ts'
 import { GITHUB_URL, PLUGIN_VERSION, SITE_URL } from './constants.ts'
 import { MAX_CORE_CHARS, classifyFailure, coreErrorCode, summarizeError } from './failures.ts'
+import type { FailureKind } from './failures.ts'
 
 /** dsh-plugin.org 中文页挂在 /zh/ 前缀下，英文在根路径。 */
 export function langPathOf(lang: LocaleId): string {
@@ -33,18 +34,22 @@ export function pluginSiteUrl(repo: string): string {
   return `${SITE_URL}plugins/${repo}`
 }
 
-/** 根据实际执行的命令判定失败动作标签（安装/更新/卸载）：
- *  命令形如 `dsh plugin --profile web add|update|remove <target>`，
- *  出现 remove/update 动词即对应归类，其余（add、全局 npm 命令、未知）一律算安装。 */
-function actionLabelOf(command: string | undefined): string {
-  if (command && /\s+remove\s+/i.test(command)) return 'Remove'
-  if (command && /\s+update\s+/i.test(command)) return 'Update'
-  return 'Install'
+/** 按失败类型给出简洁的错误原因标题（对外用英文）：
+ *  标题直接点明问题出在哪一侧（构建白名单/分发物/本机 npm/网络/插件侧），
+ *  作者与用户扫一眼列表就能分流 —— 不再用含糊的 Install/Remove 动作词。 */
+function reasonTitleOf(kind: FailureKind): string {
+  switch (kind) {
+    case 'npmTooOld': return 'npm too old to install'
+    case 'pnpmIgnoredBuild': return 'build scripts blocked by pnpm allowlist'
+    case 'pluginPrepare': return 'plugin distribution incomplete'
+    case 'network': return 'network failure on the user side'
+    default: return 'plugin install failed'
+  }
 }
 
 /**
- * 一键反馈 GitHub Issue 的预填链接：标题带「来自 dsh-plugin.org」标识，正文只带
- * 核心信息 —— 原因判定 + 关键错误代码 + 尝试过的安装方式 + 宿主机器环境快照 +
+ * 一键反馈 GitHub Issue 的预填链接：标题带「来自 dsh-plugin.org」标识 + 错误原因，
+ * 正文只带核心信息 —— 原因判定 + 关键错误代码 + 尝试过的安装方式 + 宿主机器环境快照 +
  * 错误核心摘要（完整日志太长，塞进 URL 会被 GitHub 以「request URL too long」拒绝，
  * 故只收集重点）。错误弹窗、失败记录共用此逻辑。
  * env 取不到时为 null，链接照常生成、只是少环境段。
@@ -52,20 +57,21 @@ function actionLabelOf(command: string | undefined): string {
  * 组织 scope 与 GitHub 用户名不一致时也能直接指认正确的 npm 包名。
  */
 export function pluginIssueUrl(repo: string, message: string, env?: EnvInfo | null, command?: string, attempts?: string[]): string {
-  // 标题按实际执行的动作区分（安装/更新/卸载），避免作者误读 —— 旧版固定写死
-  // 「Install/Remove」会让更新失败被当成删除失败。
-  const title = `[dsh-plugin.org | dsh-plugin-hub] ${actionLabelOf(command)} failed: ${repo}`
   // 原因判定：按失败类型归类，便于作者判断问题是否出在插件侧。
   // [packaging]（预检/装后校验拦截）单独列：无论走 npm 还是 git 通道，都是分发物不完整
   // （package.json 声明的入口文件在发布物里缺失），作者照此补齐即可。
   const kind = classifyFailure(message)
+  // 标题 = 错误原因（非动作词），让 issue 列表一眼可分流
+  const title = `[dsh-plugin.org | dsh-plugin-hub] ${reasonTitleOf(kind)}: ${repo}`
   const reason = /\[packaging\]/i.test(message)
     ? 'plugin distribution is incomplete — the entry file declared in package.json is missing from the published package (github tarball or npm package); please commit build output or publish a complete package'
-      : kind === 'pluginPrepare'
-        ? 'plugin prepare/build script failed during install (packaging/distribution issue)'
-        : kind === 'pnpmIgnoredBuild'
-          ? 'plugin depends on a native module whose build script pnpm blocks by default (use a prebuilt variant)'
-          : 'plugin-side install failure'
+      : kind === 'network'
+        ? 'network connectivity issue on the user side (DNS, proxy, firewall, or a blocked connection)'
+        : kind === 'pluginPrepare'
+          ? 'plugin prepare/build script failed during install (packaging/distribution issue)'
+          : kind === 'pnpmIgnoredBuild'
+            ? 'plugin depends on a native module whose build script pnpm blocks by default (use a prebuilt variant)'
+            : 'plugin-side install failure'
   const code = coreErrorCode(message)
   // 按给定核心摘要预算构建完整预填 URL（含 URL 编码）；预算可调，供超长时逐档缩小
   const build = (coreChars: number): string => {
@@ -134,3 +140,4 @@ export function pluginIssueUrl(repo: string, message: string, env?: EnvInfo | nu
   }
   return url
 }
+

package/src/client/styles/Modal.module.css

@@ -1239,6 +1239,47 @@
   border-radius: 6px;
 }
 
+/* 网络不通提示下的「去系统诊断」操作按钮：品牌实底小按钮（区别于红色提 Issue 大按钮） */
+.failDiagBtn {
+  display: block;
+  width: 100%;
+  box-sizing: border-box;
+  margin-top: 8px;
+  padding: 5px 16px;
+  font-size: 13px;
+  line-height: 18px;
+  font-weight: 600;
+  text-align: center;
+  color: var(--hub-text-on-fill);
+  background: var(--hub-btn-fill);
+  border: none;
+  border-radius: 8px;
+  cursor: pointer;
+  user-select: none;
+  transition: background 120ms ease, box-shadow 120ms ease;
+}
+
+.failDiagBtn:hover {
+  background: var(--hub-btn-hover);
+  box-shadow: 0 3px 10px rgba(0, 0, 0, 0.12);
+}
+
+/* 网络类失败弹窗的「无法访问 …」醒目行：红色加粗，直接告诉用户具体哪个地址连不上
+   （URL 较长允许换行断词），与下方琥珀色说明区分主次 */
+.failNetworkTarget {
+  margin-top: 6px;
+  padding: 8px 12px;
+  font-size: 13px;
+  line-height: 20px;
+  font-weight: 700;
+  word-break: break-all;
+  color: var(--hub-danger);
+  background: var(--hub-danger-tint);
+  border: 1px solid var(--hub-danger-border);
+  border-radius: 6px;
+}
+
+
 /* —— 「关注我们」弹窗 —— */
 
 /* 关注弹窗：比普通弹窗略宽，给 Markdown 介绍 + 反馈群二维码留出阅读空间；
@@ -1356,13 +1397,13 @@
 }
 
 /* 用户反馈群二维码（renderMarkdown 对 dsh-plugin-user-group-qr- 前缀图片加了
-   width/height="250"）：固定 250×250 正方形。必须显式覆盖通用 max-height 上限 ——
-   CSS max-height 对 height 有最终裁决权，不覆盖的话高度被压成 220 而宽度保持 250，
-   图片就会变成非正方形（看起来像「250×250 没生效」） */
-.aboutContent img[width="250"] {
-  width: 250px;
-  height: 250px;
-  max-height: 250px;
+   width/height="100"）：固定 100×100 正方形。必须显式覆盖通用 max-height 上限 ——
+   CSS max-height 对 height 有最终裁决权，不覆盖的话高度被 max-height 规则压掉，
+   图片就会变成非正方形（看起来像「尺寸没生效」） */
+.aboutContent img[width="100"] {
+  width: 100px;
+  height: 100px;
+  max-height: 100px;
   object-fit: contain;
 }
 

package/src/client/styles/SettingsView.module.css

@@ -178,6 +178,30 @@
   width: 100%;
 }
 
+/* 代理输入框列布局：输入框 + 连通性探测提示上下排列，整行展开 */
+.proxyControl {
+  width: 100%;
+  display: flex;
+  flex-direction: column;
+  align-items: stretch;
+  gap: 5px;
+}
+
+/* 代理连通性提示：检测中灰字 / 可达绿字 / 不通琥珀字（仍可保存，不阻断输入） */
+.proxyHint {
+  font-size: 11px;
+  line-height: 1.4;
+  color: var(--hub-text-disabled);
+}
+
+.proxyHintOk {
+  color: var(--hub-success);
+}
+
+.proxyHintFail {
+  color: var(--hub-warning);
+}
+
 /* 下拉控件：行内固定宽度，与输入框等高 */
 .controlDropdown {
   min-width: 180px;

package/src/server/http/routes.ts

@@ -13,7 +13,7 @@ import type { IncomingMessage, ServerResponse } from 'node:http'
 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.ts'
+import { fetchViaCurl, gitLsRemote, probeUrl, systemProxy } from '../services/probe.ts'
 import { activeTask, cancelTask, dumpLoaderEntries, getTask, githubRepoOf, githubTarget, globalNpmPackagesOf, hasQueuedTarget, installTargetOf, listPendingRestarts, readProfileArg, startPluginMutation, validPackageName, type LoaderHandle } from '../services/install/install.ts'
 import { recordInstalledVersion, recordResolvedNpmPackage, readInstalledVersions, removeInstalledVersion } from '../services/profile/installed-versions.ts'
 import { resolveNpmPackage } from '../services/install/npm-resolve.ts'
@@ -494,11 +494,19 @@ export function mountPluginHubRoutes(webServer: WebServerService, profile: strin
         // 连通性自检直接打安装通道真实访问的轻量资源：npm 源拉包元数据、git 通道探
         // 仓库主页、目录站探 badge 小文件，避免拉取目录全量 JSON。
         // npm 行 display：配置了镜像就显示镜像地址；未配置置空 —— 客户端显示「未配置（跟随本机 npm 配置）」。
-        const allChecks: Array<{ key: string; url: string; display: string; cmd: string }> = [
+        const allChecks: Array<{ key: string; url: string; display: string; cmd: string; proxy?: string; git?: boolean }> = [
           { 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',
@@ -508,17 +516,22 @@ export function mountPluginHubRoutes(webServer: WebServerService, profile: strin
         // 探测走代理的优先级：设置里的代理 → 系统代理（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: string) => probeUrl(url, effectiveProxy, 6000)
+        const probe = (url: string, proxy?: string) => probeUrl(url, proxy ?? effectiveProxy, 6000)
         // 逐路串行：一条命令一条结果地推送给终端，保持「程序在跑」的真实感
         const results: Array<{ key: string; ok: boolean }> = []
         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()
@@ -535,6 +548,35 @@ export function mountPluginHubRoutes(webServer: WebServerService, profile: strin
         })
       },
     }),
+    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 as { proxy?: unknown; target?: unknown }
+            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 +647,10 @@ export function mountPluginHubRoutes(webServer: WebServerService, profile: strin
             ? (body as { source: string }).source
             : ''
           const settings = loadSettings(profile)
+          // 界面语言（客户端随请求携带）：错误消息按用户当前语言提示（中文界面给中文，英文界面给英文）
+          const lang = typeof body === 'object' && body !== null && (body as { lang?: unknown }).lang === 'en'
+            ? 'en'
+            : 'zh'
           // 全局 npm 安装（官方 README 的 `npm install -g <pkgs>`，如 dsh-tui 的安装命令）：
           // 直接从命令框输入格式执行全局安装，不进任何 profile、无需宿主重启。
           // 包列表优先取 body.globalNpm（客户端命令框解析后显式携带）；兜底再从 rawRepo 解析，
@@ -703,6 +749,35 @@ export function mountPluginHubRoutes(webServer: WebServerService, profile: strin
             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/src/server/services/probe.ts

@@ -124,6 +124,49 @@ export function probeUrl(url: string, proxy: string, timeoutMs: number): Promise
   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: string, proxy: string, timeoutMs: number): Promise<ProbeResult> {
+  return new Promise((resolve) => {
+    const started = Date.now()
+    const env: NodeJS.ProcessEnv = { ...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: Buffer) => { out += c.toString() })
+    // git 的报错不透传给终端：结果以退出码 + HEAD ref 是否返回为准
+    child.stderr.on('data', () => {})
+    let done = false
+    const finish = (r: ProbeResult) => {
+      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 代理路由使用：目录/统计数据经此拉到服务端再转给浏览器，