dsh-plugin 1.3.5 → 1.3.7

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

@@ -15,12 +15,13 @@
  *   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'
 import modalStyles from '../../styles/Modal.module.css'
-import { Dropdown } from '../ui/Dropdown.tsx'
 import { Toggle } from '../ui/Toggle.tsx'
+import { Dropdown } from '../ui/Dropdown.tsx'
 import { DiagnosticsView } from './DiagnosticsView.tsx'
 import { LogsView } from './LogsView.tsx'
 import {
@@ -29,7 +30,18 @@ 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 配置即可。 */
+const MIRROR_PRESETS: Array<{ value: string; labelKey: string }> = [
+  { value: '', labelKey: 'mirrorNone' },
+  { value: 'https://registry.npmjs.org', labelKey: 'mirrorOfficial' },
+  { value: 'https://registry.npmmirror.com', labelKey: 'mirrorNpmmirror' },
+  { value: 'https://mirrors.cloud.tencent.com/npm/', labelKey: 'mirrorTencent' },
+  { value: 'https://mirrors.tuna.tsinghua.edu.cn/npm/', labelKey: 'mirrorTsinghua' },
+]
 
 /** 左侧导航：顺序即展示顺序；labelKey 是分组标题，icon 是行内小图标。 */
 const NAV: Array<{ key: SettingsSection; labelKey: string; icon: () => ReturnType<typeof h> }> = [
@@ -40,13 +52,6 @@ const NAV: Array<{ key: SettingsSection; labelKey: string; icon: () => ReturnTyp
   { key: 'reset', labelKey: 'settingsReset', icon: ResetIcon },
 ]
 
-/** npm 镜像源预设：空串 = 官方源；值相等即视为选中对应预设，其余进入「自定义」输入。 */
-const MIRROR_PRESETS: Array<{ value: string; labelKey: string }> = [
-  { value: '', labelKey: 'mirrorOfficial' },
-  { value: 'https://registry.npmmirror.com', labelKey: 'mirrorNpmmirror' },
-  { value: 'https://mirrors.cloud.tencent.com/npm/', labelKey: 'mirrorTencent' },
-]
-
 /** 设置行：默认标签左控件右；stack=true 时控件独占一行（文本框整行显示），hairline 分隔。 */
 function SettingRow({ title, desc, children, stack = false }: {
   title: string
@@ -63,26 +68,71 @@ 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 mirrorCustom = !MIRROR_PRESETS.some((p) => p.value === settings.npmRegistry)
-  const onMirrorChange = (value: string) => {
-    if (value === 'custom') return // 进入自定义输入：保持当前值，下方出现输入框
-    update({ npmRegistry: 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 onMirrorInput = (e: ChangeEvent<HTMLInputElement>) => update({ npmRegistry: e.target.value })
-  const onProxyChange = (e: ChangeEvent<HTMLInputElement>) => update({ proxy: e.target.value })
+  const onMirrorChange = (value: string) => update({ npmRegistry: value })
 
   /** 每个分组的页面副标题（导航标题之上再补一句说明，保持桌面设置质感） */
   const pageDesc: Record<SettingsSection, string> = {
@@ -106,46 +156,44 @@ export function SettingsView({ t, settings, update, reset, env, onCopy }: {
         title: t('settingsCheckOnStart'),
       }),
     }),
+    // npm 镜像源：预设下拉（默认未配置跟随本机），选国内顶级镜像可加速安装；
+    // 不做自定义输入，其它镜像写在 ~/.npmrc 即可被天然尊重。
+    // 独占一行（同代理文本框）：标签在上、下拉在下整行展开，长描述不会挤压控件
     h(SettingRow, {
       title: t('settingsMirror'),
       desc: t('settingsMirrorDesc'),
+      stack: true,
       children: h(Dropdown, {
-        value: mirrorCustom ? 'custom' : settings.npmRegistry,
-        options: [
-          ...MIRROR_PRESETS.map((p) => ({ value: p.value, label: t(p.labelKey) })),
-          { value: 'custom', label: t('mirrorCustom') },
-        ],
+        value: settings.npmRegistry,
+        options: MIRROR_PRESETS.map((m) => ({ value: m.value, label: t(m.labelKey) })),
         onChange: onMirrorChange,
         title: t('settingsMirror'),
-        className: styles.controlDropdown,
+        className: `${styles.controlDropdown} ${dropdownStyles.dropdownFill}`,
       }),
     }),
-    // 自定义镜像源：下拉选中「自定义」或已存非预设值时，追加一行输入框（文本框独占一行）
-    mirrorCustom && h(SettingRow, {
-      title: t('mirrorCustom'),
-      stack: true,
-      children: h('input', {
-        className: styles.textInput,
-        type: 'url',
-        value: settings.npmRegistry,
-        placeholder: 'https://registry.npmjs.org',
-        spellCheck: false,
-        onChange: onMirrorInput,
-      }),
-    }),
-    // 代理地址：文本框独占一行，整行输入，便于粘贴长代理地址
+    // 代理地址：文本框独占一行，整行输入，便于粘贴长代理地址；停笔后实时探测连通性，
+    // 不通仅提示（可保存）—— 用户可能先填地址后开代理
     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,
+      ),
     }),
   )
 
@@ -185,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/useSettings.ts

@@ -14,10 +14,10 @@ import { useCallback, useEffect, useState } from 'react'
 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 包（默认开） */
   enableNpmInstall: boolean
   /** 启用命令行安装 GitHub 源码（默认开） */
@@ -30,8 +30,8 @@ export interface HubSettings {
 
 export const DEFAULT_SETTINGS: HubSettings = {
   checkUpdatesOnStart: true,
-  npmRegistry: '',
   proxy: '',
+  npmRegistry: '',
   enableNpmInstall: true,
   enableGitInstall: true,
   enableDshInstall: true,

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'
 
@@ -28,6 +28,9 @@ export interface QueueTask {
   desc?: string
   /** 所属插件仓库（owner/repo）：失败时错误弹窗据此提供「去仓库反馈」入口；卸载为 null */
   repo: string | null
+  /** 实际动作（add/update/remove）：成功通知据此区分「安装成功」与「更新成功」。
+   *  服务端 /active 带回真实动作；本地乐观入队按 update 标记推断。 */
+  action?: 'add' | 'update' | 'remove'
   /** 安装时的目录信号快照（版本 + 仓库更新时间）：任务成功后在本地记录，供「有更新」比对 */
   version?: string
   updatedAt?: string
@@ -61,13 +64,16 @@ export interface PendingRestart {
 
 export interface TaskQueueOptions {
   t: Translate
+  /** 界面语言（zh/en）：随安装请求带给服务端，网络预检等错误消息按用户语言提示 */
+  langKey?: LocaleId
   refreshInstalled: () => void
   /** 任务成功完成：viaModal 表示任务对应当前打开弹窗（弹窗切结果视图），否则走 Toast；repo 供成功通知记录；
-   *  needsRestart 表示该任务完成后是否仍需宿主重启（结果视图据此给「重启 / 仅完成」）。 */
-  onInstallDone: (viaModal: boolean, repo: string | null, needsRestart: boolean) => void
+   *  needsRestart 表示该任务完成后是否仍需宿主重启（结果视图据此给「重启 / 仅完成」）。
+   *  update 表示实际执行的是更新（覆盖重装）而非首次安装：通知中心据此显示「更新成功」而非「安装成功」。 */
+  onInstallDone: (viaModal: boolean, repo: string | null, needsRestart: boolean, update?: boolean) => void
   onUninstallDone: (viaModal: boolean, repo: string | null, needsRestart: boolean) => void
-  /** 任务失败：完整输出或兜底文案 + 所属插件仓库 + 操作类型（安装/卸载）+ 实际执行的安装命令（issue 预填用，可缺省）+ 尝试过的安装方式（npm 反查/执行命令，可缺省）。 */
-  onError: (message: string, repo: string | null, kind: 'install' | 'uninstall', command?: string, attempts?: string[]) => void
+  /** 任务失败：完整输出或兜底文案 + 所属插件仓库 + 操作类型（安装/卸载）+ 实际执行的安装命令（issue 预填用，可缺省）+ 尝试过的安装方式（npm 反查/执行命令，可缺省）+ 是否更新。 */
+  onError: (message: string, repo: string | null, kind: 'install' | 'uninstall', command?: string, attempts?: string[], update?: boolean) => void
   /** 当前打开的安装/卸载弹窗插件：用于在弹窗内匹配进行中的任务。 */
   installPlugin: HubPlugin | null
   /** 当前打开的自定义安装（命令行）确认弹窗目标：与应用商店同一弹窗机制，匹配进行中的 custom 安装任务。 */
@@ -85,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[]>([])
@@ -195,14 +201,14 @@ export function useTaskQueue(opts: TaskQueueOptions) {
         // 同时缓存展示信息，待重启列表（服务端已登记）合并时直接补齐简介/版本
         void syncInstalledVersion(q.repo, q.version, q.updatedAt)
         pendingInfoRef.current.set(q.target, { desc: q.desc, version: q.version })
-        onInstallDone(modalTaskRef.current === q.id, q.repo, q.needsRestart)
+        onInstallDone(modalTaskRef.current === q.id, q.repo, q.needsRestart, q.action === 'update')
       }
     } else {
       // 失败：完整展示全部输出行（最新在前，逆序为日志阅读顺序），不裁剪
       const detail = lines.length > 0
         ? [...lines].reverse().join('\n')
         : q.kind === 'uninstall' ? t('uninstallFail') : t('installFail')
-      onError(detail, q.repo, q.kind, q.command, q.attempts)
+      onError(detail, q.repo, q.kind, q.command, q.attempts, q.action === 'update')
     }
     maybeStopPoll()
   }
@@ -367,6 +373,7 @@ export function useTaskQueue(opts: TaskQueueOptions) {
               kind: (isRemove ? 'uninstall' : 'install') as 'install' | 'uninstall',
               target: isRemove ? fallback : (display || fallback),
               repo: isRemove ? null : (display || fallback),
+              action: (a.action === 'add' || a.action === 'update' || a.action === 'remove') ? a.action : 'add',
               status: a.status === 'running' ? 'running' : 'pending',
               progress: typeof a.progress === 'number' ? a.progress : 0,
               lines: Array.isArray(a.lines) ? (a.lines as string[]) : [],
@@ -421,6 +428,7 @@ export function useTaskQueue(opts: TaskQueueOptions) {
       version: input.version, updatedAt: input.updatedAt,
       status: 'running', progress: 0, lines: [], optimistic: true,
       command: input.command,
+      action: input.update ? 'update' : 'add',
       // 服务端登记后 /active 会带回真实尝试记录（npm 反查 + 执行命令），先占位空列表
       attempts: [], needsRestart: true,
     }])
@@ -436,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,

package/src/client/locales.ts

@@ -108,14 +108,19 @@ export const zh = {
   settingsUpdateDesc: '更新检查方式与安装走到的网络通道',
   settingsCheckOnStart: '启动时检查更新',
   settingsCheckOnStartDesc: '打开插件中心时检查已安装插件是否有新版，发现更新会提示',
+  settingsProxy: 'HTTP 代理',
+  settingsProxyDesc: 'npm / git / 目录数据请求统一走该代理；留空直连',
+  // 代理连通性实时探测：输入停笔后提示检测结果（不通仍可保存，先填地址后开代理也合法）
+  proxyCheckChecking: '正在测试该代理地址…',
+  proxyCheckOk: '测试可达，安装与目录请求将统一走该代理',
+  proxyCheckFail: '此地址测试不通，仍可保存；请确认代理已开启、地址与端口无误',
   settingsMirror: 'npm 镜像源',
-  settingsMirrorDesc: 'npm 安装与版本反查走自定义镜像，网络不佳时更稳定；留空使用官方源',
+  settingsMirrorDesc: '默认跟随本机 npm 配置；官方源慢可换国内镜像',
+  mirrorNone: '未配置（跟随本机 npm 配置）',
   mirrorOfficial: '官方源 registry.npmjs.org',
   mirrorNpmmirror: '阿里云 npmmirror',
   mirrorTencent: '腾讯云镜像',
-  mirrorCustom: '自定义镜像源',
-  settingsProxy: 'HTTP 代理',
-  settingsProxyDesc: 'npm / git / 目录数据请求统一走该代理；留空直连',
+  mirrorTsinghua: '清华大学 TUNA 镜像',
   settingsSecurity: '安全信任',
   settingsSecurityDesc: '命令行安装的三个通道开关：NPM 包、GitHub 源码与 DSH 命令',
   settingsEnableNpm: '启用 NPM 安装',
@@ -181,8 +186,11 @@ export const zh = {
   settingsDiagFail: '不可达',
   // 系统诊断通道列表：一键全量诊断 + 一行一个，可点重测
   diagNpm: 'npm 源',
+  // 诊断页 npm 行：未配置镜像时的展示（探测目标仍为官方源，代表本机无配置时的回退）
+  diagNpmUnset: '未配置（跟随本机 npm 配置）',
   diagGithub: 'GitHub',
   diagCatalog: '目录站点',
+  diagProxy: 'HTTP 代理',
   diagOk: 'OK',
   diagChecking: '检测中…',
   diagIdle: '未检测',
@@ -231,6 +239,8 @@ export const zh = {
   installNow: '直接安装',
   installing: '安装中…',
   installDone: '安装成功',
+  // 更新成功（通知中心区分安装/更新）：更新 = 已安装目标覆盖重装到最新，与首次安装不同语义
+  updateDone: '更新成功',
   installResultTitle: '插件安装成功',
   installResultDesc: '',
   // 更新语义：已安装插件点「更新」走同一条 add 命令原位覆盖重装，弹窗文案区分安装/更新
@@ -275,6 +285,8 @@ export const zh = {
   errorTitle: '操作失败',
   errorTitleInstall: '安装失败',
   errorTitleUninstall: '卸载失败',
+  // 更新失败（通知中心区分安装/更新）：更新目标覆盖重装失败，与首次安装失败不同语义
+  errorTitleUpdate: '更新失败',
   errorPlugin: '插件',
   errorClose: '知道了',
   errorCopy: '复制错误信息',
@@ -287,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: '没有找到匹配的插件',
@@ -436,14 +454,20 @@ export const en = {
   settingsCheckOnStartDesc: 'Check installed plugins for new versions when the hub opens; you will be notified when updates are found',
   settingsAutoInstall: 'Auto-install updates',
   settingsAutoInstallDesc: 'Install detected updates in the background without asking (a host restart applies them)',
-  settingsMirror: 'npm registry mirror',
-  settingsMirrorDesc: 'Route npm installs and lookups through a mirror for unstable networks; leave empty for the official registry',
+  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)',
   mirrorOfficial: 'Official registry.npmjs.org',
   mirrorNpmmirror: 'Alibaba npmmirror',
   mirrorTencent: 'Tencent Cloud mirror',
-  mirrorCustom: 'Custom mirror',
-  settingsProxy: 'HTTP proxy',
-  settingsProxyDesc: 'Route npm, git and catalog requests through this proxy; leave empty to connect directly',
+  mirrorTsinghua: 'Tsinghua TUNA mirror',
   settingsSecurity: 'Security & Trust',
   settingsSecurityDesc: 'Toggles for the three command-line install channels: npm packages, GitHub sources and DSH commands',
   settingsEnableNpm: 'Enable npm installs',
@@ -509,8 +533,11 @@ export const en = {
   settingsDiagFail: 'Unreachable',
   // System diagnostics channel list: one-click full check + one row per channel, click to re-probe
   diagNpm: 'npm registry',
+  // Diagnostics npm row: shown when no mirror is configured (probe still targets the official registry, the fallback)
+  diagNpmUnset: 'Unset (follow local npm config)',
   diagGithub: 'GitHub',
   diagCatalog: 'Catalog site',
+  diagProxy: 'HTTP proxy',
   diagOk: 'OK',
   diagChecking: 'Checking…',
   diagIdle: 'Not checked',
@@ -559,6 +586,8 @@ export const en = {
   installNow: 'Install',
   installing: 'Installing…',
   installDone: 'Installed',
+  // Updated (notification center distinguishes install/update): update = in-place reinstall to latest
+  updateDone: 'Updated',
   installResultTitle: 'Plugin installed successfully',
   installResultDesc: '',
   // Update semantics: the "update" action re-runs add in place — copy differentiates install vs update
@@ -602,6 +631,8 @@ export const en = {
   errorTitle: 'Operation failed',
   errorTitleInstall: 'Install failed',
   errorTitleUninstall: 'Removal failed',
+  // Update failed (notification center distinguishes install/update): update target reinstall failed
+  errorTitleUpdate: 'Update failed',
   errorPlugin: 'Plugin',
   errorClose: 'Got it',
   errorCopy: 'Copy error',
@@ -614,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

@@ -18,6 +18,9 @@ export interface NotificationRecord {
   ok: boolean
   /** owner/repo（可能为空：请求层失败但拿不到仓库时） */
   repo: string
+  /** 实际动作（install/update/uninstall）：成功/失败通知据此区分「安装成功」与「更新成功」。
+   *  缺省按 kind 兜底（历史记录可能没有该字段）。更新提醒（kind='update'）不用此字段。 */
+  action?: 'install' | 'update' | 'uninstall'
   /** 失败时的完整错误日志；成功记录为空串 */
   message: string
   /** 更新提醒：目录里的新版本号（展示用；其余通知省略） */
@@ -148,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
@@ -169,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
@@ -234,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">`
   })