dsh-plugin 1.3.5 → 1.3.6

package/lib/http/routes.js

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

package/lib/services/install/npm-resolve.js

@@ -20,7 +20,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, registry = '') {
     const key = repo.toLowerCase();

package/lib/services/settings.js

@@ -12,8 +12,8 @@ import { dirname, join } from 'node:path';
 import { profileDirectory } from './profile/profile.js';
 export const DEFAULT_SETTINGS = {
     checkUpdatesOnStart: true,
-    npmRegistry: '',
     proxy: '',
+    npmRegistry: '',
     enableNpmInstall: true,
     enableGitInstall: true,
     enableDshInstall: true,

package/lib/types/services/install/npm-resolve.d.ts

@@ -2,6 +2,8 @@
  * 反查 repo（`owner/repo`）对应的官方 npm 包名；未命中、网络异常或超时返回 null。
  * 返回 null 不代表仓库一定没有 npm 包，只代表本次未能确认 —— 调用方应保留
  * 原有错误路径，反查只是额外的一次尝试。
- * @param registry - npm 镜像源地址（空串 = 官方 https://registry.npmjs.org）
+ * registry 参数：npm 镜像源地址，空串 = 官方源；与安装通道吃同一 registry，
+ * 保证「配置了镜像」时反查和安装走同一个源（镜像节点同步完整时结果一致）。
+ * 慢网络下失败不阻塞安装。
  */
 export declare function resolveNpmPackage(repo: string, registry?: string): Promise<string | null>;

package/lib/types/services/settings.d.ts

@@ -1,10 +1,10 @@
 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 地址安装被拦截） */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin",
-  "version": "1.3.5",
+  "version": "1.3.6",
   "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",

package/src/client/components/PluginHubSection.tsx

@@ -107,12 +107,13 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
   const queue = useTaskQueue({
     t,
     refreshInstalled: catalog.refreshInstalled,
-    onInstallDone: (viaModal, repo, needsRestart) => {
+    onInstallDone: (viaModal, repo, needsRestart, update) => {
       setInstallNeedsRestart(needsRestart)
       if (viaModal) setInstallDone(true)
       else setToast({ id: Date.now(), kind: 'done' })
-      // 安装成功也写入通知记录：通知中心里成功与失败都能看到
-      setNotifications(addSuccess({ kind: 'install', repo: repo ?? '' }))
+      // 安装成功也写入通知记录：通知中心里成功与失败都能看到。
+      // action 区分「安装成功」与「更新成功」（更新 = 覆盖重装，同一执行通道）
+      setNotifications(addSuccess({ kind: 'install', action: update ? 'update' : 'install', repo: repo ?? '' }))
     },
     onUninstallDone: (viaModal, repo, needsRestart) => {
       setUninstallNeedsRestart(needsRestart)
@@ -120,13 +121,16 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       else setToast({ id: Date.now(), kind: 'removed' })
       setNotifications(addSuccess({ kind: 'uninstall', repo: repo ?? '' }))
     },
-    onError: (message, repo, kind, command, attempts) => {
+    onError: (message, repo, kind, command, attempts, update) => {
       // 提 Issue 目标先反查仓库身份：npm 包名能在已安装表/目录里反查到 owner/repo 才保留，
-      // 反查不到置 null —— 错误弹窗/通知中心据此不显示「一键提 Issue」按钮（防提到错误仓库）
+      // 反查不到置 null —— 错误弹窗据此不显示「一键提 Issue」按钮（防提到错误仓库）
       const issueRepo = issueRepoOf(repo ?? '', catalog.installedItems, catalog.plugins)
       setErrorMsg({ message, repo: issueRepo, kind, command, attempts })
-      // 失败自动写入通知记录：任务在后台结束时没人盯着也能留痕
-      setNotifications(addFailure({ kind, repo: issueRepo ?? '', message, command, attempts }))
+      // 失败自动写入通知记录：任务在后台结束时没人盯着也能留痕。
+      // 存原始 repo（可能只是裸包名）而非反查结果 —— 反查只服务于提 Issue，
+      // 通知中心的展示反查由 NotificationsModal 做、查不到会回退显示原始值，
+      // 若这里就丢掉原始值，通知里会连名字都看不到；action 区分「安装失败/更新失败」
+      setNotifications(addFailure({ kind, action: update ? 'update' : 'install', repo: repo ?? '', message, command, attempts }))
     },
     installPlugin: confirmPlugin,
     installCustomTarget: confirmCustomTarget,

package/src/client/components/modals/NotificationsModal.tsx

@@ -193,8 +193,12 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                     h('span', {
                       className: r.ok ? styles.noticeTextOk : styles.noticeTextFail,
                     }, r.ok
-                      ? (isUpdate ? t('updateNoticeTitle') : (r.kind === 'install' ? t('installDone') : t('uninstallDone')))
-                      : (r.kind === 'install' ? t('errorTitleInstall') : t('errorTitleUninstall'))),
+                      ? (isUpdate
+                        ? t('updateNoticeTitle')
+                        : (r.action === 'update' ? t('updateDone') : (r.kind === 'install' ? t('installDone') : t('uninstallDone'))))
+                      : (r.action === 'update'
+                        ? t('errorTitleUpdate')
+                        : (r.kind === 'install' ? t('errorTitleInstall') : t('errorTitleUninstall')))),
                     // 更新提醒：新版本号紧随标题展示；repo 为纯文本（整行点击即去更新，不跳官网外链）
                     isUpdate && r.version
                       ? h('span', { className: styles.noticeVersion, title: r.version }, `v${r.version}`)
@@ -211,7 +215,9 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                             rel: 'noopener noreferrer',
                             title: shownRepo,
                           }, shownRepo)
-                          : null)
+                          // 反查不到仓库身份（如命令行安装的裸 npm 包名）：回退显示记录里的原始值，
+                          // 保证通知永不只剩一句「安装/更新成功」没有名字 —— 只是不给官网外链（查不到不敢乱跳）
+                          : h('span', { className: styles.failRepo, title: r.repo }, r.repo))
                       : null,
                     !r.ok && h('button', {
                       className: styles.failCopy,

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

@@ -40,7 +40,8 @@ interface RowState {
 }
 
 const INITIAL_ROWS: RowState[] = [
-  { key: 'npm', display: 'registry.npmjs.org', nameKey: 'diagNpm', status: 'idle', ms: null, statusCode: null },
+  // 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: 'catalog', display: 'api.dsh-plugin.org', nameKey: 'diagCatalog', status: 'idle', ms: null, statusCode: null },
 ]
@@ -87,12 +88,14 @@ export function DiagnosticsView({ t, env, onCopy }: {
             const raw = buf.slice(0, nl).trim()
             buf = buf.slice(nl + 1)
             if (raw !== '') {
-              const ev = JSON.parse(raw) as { type?: string; key?: string; ms?: number | null; status?: number | null }
+              const ev = JSON.parse(raw) as { type?: string; key?: string; ms?: number | null; status?: number | null; display?: string }
               if (ev.type === 'ok' || ev.type === 'fail') {
                 patchRows(ev.key as ProbeKey, {
                   status: ev.type === 'ok' ? 'ok' : 'fail',
                   ms: typeof ev.ms === 'number' ? ev.ms : null,
                   statusCode: typeof ev.status === 'number' ? ev.status : null,
+                  // 服务端带出实际使用的源地址（配置镜像 → 镜像地址；未配置 → 空串）
+                  display: typeof ev.display === 'string' ? ev.display : '',
                 })
               }
             }
@@ -159,7 +162,8 @@ export function DiagnosticsView({ t, env, onCopy }: {
         title: t('diagRecheck'),
       },
         h('span', { className: styles.name }, t(r.nameKey)),
-        h('span', { className: styles.display }, r.display),
+        // npm 行未配置镜像：display 为空 → 显示「未配置（跟随本机）」，不误导成官方源
+        h('span', { className: styles.display }, r.display !== '' ? r.display : t('diagNpmUnset')),
         h('span', { className: styles.meta }, r.status === 'ok' && r.ms !== null ? `${r.ms} ms` : ''),
         badge,
       )

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

@@ -18,9 +18,10 @@
 import { createElement as h, 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 {
@@ -31,6 +32,16 @@ import type { HubSettings } from '../../hooks/useSettings.ts'
 
 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> }> = [
   { key: 'updates', labelKey: 'settingsUpdate', icon: UpdatesIcon },
@@ -40,13 +51,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
@@ -76,13 +80,8 @@ export function SettingsView({ t, settings, update, reset, env, onCopy }: {
   /** 恢复默认确认弹窗：点按钮先弹窗询问，确认后才真正 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 })
-  }
-  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,31 +105,19 @@ 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,
-      }),
-    }),
-    // 自定义镜像源：下拉选中「自定义」或已存非预设值时，追加一行输入框（文本框独占一行）
-    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,
+        className: `${styles.controlDropdown} ${dropdownStyles.dropdownFill}`,
       }),
     }),
     // 代理地址：文本框独占一行，整行输入，便于粘贴长代理地址

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

@@ -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
@@ -63,11 +66,12 @@ export interface TaskQueueOptions {
   t: Translate
   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 安装任务。 */
@@ -195,14 +199,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 +371,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 +426,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,
     }])

package/src/client/locales.ts

@@ -108,14 +108,15 @@ export const zh = {
   settingsUpdateDesc: '更新检查方式与安装走到的网络通道',
   settingsCheckOnStart: '启动时检查更新',
   settingsCheckOnStartDesc: '打开插件中心时检查已安装插件是否有新版，发现更新会提示',
+  settingsProxy: 'HTTP 代理',
+  settingsProxyDesc: 'npm / git / 目录数据请求统一走该代理；留空直连',
   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,6 +182,8 @@ export const zh = {
   settingsDiagFail: '不可达',
   // 系统诊断通道列表：一键全量诊断 + 一行一个，可点重测
   diagNpm: 'npm 源',
+  // 诊断页 npm 行：未配置镜像时的展示（探测目标仍为官方源，代表本机无配置时的回退）
+  diagNpmUnset: '未配置（跟随本机 npm 配置）',
   diagGithub: 'GitHub',
   diagCatalog: '目录站点',
   diagOk: 'OK',
@@ -231,6 +234,8 @@ export const zh = {
   installNow: '直接安装',
   installing: '安装中…',
   installDone: '安装成功',
+  // 更新成功（通知中心区分安装/更新）：更新 = 已安装目标覆盖重装到最新，与首次安装不同语义
+  updateDone: '更新成功',
   installResultTitle: '插件安装成功',
   installResultDesc: '',
   // 更新语义：已安装插件点「更新」走同一条 add 命令原位覆盖重装，弹窗文案区分安装/更新
@@ -275,6 +280,8 @@ export const zh = {
   errorTitle: '操作失败',
   errorTitleInstall: '安装失败',
   errorTitleUninstall: '卸载失败',
+  // 更新失败（通知中心区分安装/更新）：更新目标覆盖重装失败，与首次安装失败不同语义
+  errorTitleUpdate: '更新失败',
   errorPlugin: '插件',
   errorClose: '知道了',
   errorCopy: '复制错误信息',
@@ -436,14 +443,15 @@ 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',
+  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,6 +517,8 @@ 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',
   diagOk: 'OK',
@@ -559,6 +569,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 +614,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',

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
   /** 更新提醒：目录里的新版本号（展示用；其余通知省略） */

package/src/client/logic/urls.ts

@@ -33,6 +33,15 @@ 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'
+}
+
 /**
  * 一键反馈 GitHub Issue 的预填链接：标题带「来自 dsh-plugin.org」标识，正文只带
  * 核心信息 —— 原因判定 + 关键错误代码 + 尝试过的安装方式 + 宿主机器环境快照 +
@@ -43,7 +52,9 @@ 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}`
+  // 标题按实际执行的动作区分（安装/更新/卸载），避免作者误读 —— 旧版固定写死
+  // 「Install/Remove」会让更新失败被当成删除失败。
+  const title = `[dsh-plugin.org | dsh-plugin-hub] ${actionLabelOf(command)} failed: ${repo}`
   // 原因判定：按失败类型归类，便于作者判断问题是否出在插件侧。
   // [packaging]（预检/装后校验拦截）单独列：无论走 npm 还是 git 通道，都是分发物不完整
   // （package.json 声明的入口文件在发布物里缺失），作者照此补齐即可。

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

@@ -1355,6 +1355,17 @@
   box-shadow: 0 2px 8px rgba(0, 0, 0, 0.12);
 }
 
+/* 用户反馈群二维码（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;
+  object-fit: contain;
+}
+
 /* 更新时间小字：弱化展示在内容区下方 */
 .aboutMeta {
   font-size: 11px;

package/src/server/http/routes.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,11 +488,14 @@ 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。
+        // npm 行 display：配置了镜像就显示镜像地址；未配置置空 —— 客户端显示「未配置（跟随本机 npm 配置）」。
         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: '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' },
           { 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' },
         ]

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/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,