dsh-plugin 1.3.5 → 1.3.7

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,9 +34,22 @@ export function pluginSiteUrl(repo: string): string {
   return `${SITE_URL}plugins/${repo}`
 }
 
+/** 按失败类型给出简洁的错误原因标题（对外用英文）：
+ *  标题直接点明问题出在哪一侧（构建白名单/分发物/本机 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，链接照常生成、只是少环境段。
@@ -43,18 +57,21 @@ export function pluginSiteUrl(repo: string): string {
  * 组织 scope 与 GitHub 用户名不一致时也能直接指认正确的 npm 包名。
  */
 export function pluginIssueUrl(repo: string, message: string, env?: EnvInfo | null, command?: string, attempts?: string[]): string {
-  const title = `[dsh-plugin.org | dsh-plugin-hub] Install/Remove 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 => {
@@ -123,3 +140,4 @@ export function pluginIssueUrl(repo: string, message: string, env?: EnvInfo | nu
   }
   return url
 }
+

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

@@ -12,6 +12,16 @@
   flex-shrink: 0;
 }
 
+/* 全宽变体：设置页「独占一行」的下拉与文本框同宽，按钮铺满整行 */
+.dropdownFill {
+  width: 100%;
+}
+
+.dropdownFill > .dropdownBtn {
+  width: 100%;
+  justify-content: space-between;
+}
+
 /* 触发器：工具栏按钮风格 —— 细边框 + 次级灰底，与通知入口按钮同一视觉语言，
    只占一个按钮位，给工具栏后续新增按钮留空间 */
 .dropdownBtn {

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 介绍 + 反馈群二维码留出阅读空间；
@@ -1355,6 +1396,17 @@
   box-shadow: 0 2px 8px rgba(0, 0, 0, 0.12);
 }
 
+/* 用户反馈群二维码（renderMarkdown 对 dsh-plugin-user-group-qr- 前缀图片加了
+   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;
+}
+
 /* 更新时间小字：弱化展示在内容区下方 */
 .aboutMeta {
   font-size: 11px;

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'
@@ -184,12 +184,12 @@ function hostEnv(profile: string): Record<string, string | null> {
   }
 }
 
-/** 安装/卸载 CLI 的子进程环境：透传宿主环境，并按设置注入 npm 镜像源与 HTTP(S) 代理。
+/** 安装/卸载 CLI 的子进程环境：透传宿主环境，并按设置注入 HTTP(S) 代理。
+ *  npm registry 不再注入 —— 安装完全沿用用户本机 npm 配置（~/.npmrc / 全局配置）。
  *  代理优先级：设置里的代理 → 系统代理（macOS scutil / Windows 注册表）→ 宿主 env 原有值。
  *  使安装通道与诊断使用相同的代理来源。 */
 function mutationEnv(settings: HubSettings): NodeJS.ProcessEnv {
   const env: NodeJS.ProcessEnv = { ...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
@@ -488,14 +488,25 @@ export function mountPluginHubRoutes(webServer: WebServerService, profile: strin
           // 空 body / 非 JSON：视为全量探测
         }
         const settings = loadSettings(profile)
+        // npm 通道：设置里配置了镜像源就探测该镜像（安装通道吃同一个 registry）；
+        // 未配置（空串）时探测官方源作为「跟随本机 npm 配置」的基础连通性参考。
         const registry = settings.npmRegistry.replace(/\/+$/, '') || 'https://registry.npmjs.org'
         // 连通性自检直接打安装通道真实访问的轻量资源：npm 源拉包元数据、git 通道探
         // 仓库主页、目录站探 badge 小文件，避免拉取目录全量 JSON。
-        const allChecks: Array<{ key: string; url: string; display: string; cmd: string }> = [
-          { 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' },
+        // npm 行 display：配置了镜像就显示镜像地址；未配置置空 —— 客户端显示「未配置（跟随本机 npm 配置）」。
+        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}` },
+          // 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',
@@ -505,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()
@@ -532,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',
@@ -602,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 解析，
@@ -700,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/install/npm-resolve.ts

@@ -23,7 +23,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: string, registry = ''): Promise<string | null> {
   const key = repo.toLowerCase()

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 代理路由使用：目录/统计数据经此拉到服务端再转给浏览器，

package/src/server/services/settings.ts

@@ -14,10 +14,10 @@ import { profileDirectory } from './profile/profile.ts'
 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 地址安装被拦截） */
@@ -30,8 +30,8 @@ export interface HubSettings {
 
 export const DEFAULT_SETTINGS: HubSettings = {
   checkUpdatesOnStart: true,
-  npmRegistry: '',
   proxy: '',
+  npmRegistry: '',
   enableNpmInstall: true,
   enableGitInstall: true,
   enableDshInstall: true,