dsh-plugin 1.3.6 → 1.3.8

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