dsh-plugin 1.3.4 → 1.3.6

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

@@ -56,13 +56,14 @@ export const zh = {
   gitInstallInvalid: '请输入 GitHub 仓库地址，例如：owner/repo 或 https://github.com/owner/repo',
   dshCmdLabel: 'DeepSeek Harness 命令',
   dshCmdPlaceholder: '粘贴官方 dsh plugin 命令',
-  dshCmdExample: '例如：dsh plugin --profile web add github:owner/repo',
-  dshCmdInvalid: '请输入官方 dsh plugin 安装命令（--profile 必填）。例如：dsh plugin --profile web add github:owner/repo',
+  dshCmdInsertHubUpdate: '插入更新命令',
+  dshCmdExample: '例如：dsh plugin --profile web add github:owner/repo，或 dsh plugin --profile web update dsh-plugin',
+  dshCmdInvalid: '请输入官方 dsh plugin 命令（--profile 必填，支持 add / update）。例如：dsh plugin --profile web update dsh-plugin',
   installHelp: '帮助',
   helpModalTitle: '支持的命令格式',
   npmInstallHelp: 'lodash、@scope/pkg\t直接输入包名\nnpm install lodash\nnpm i lodash\npnpm add @scope/pkg\npnpm i @scope/pkg\nnpm install -g @scope/cli\t全局安装 CLI 工具，不进「已安装」列表',
   gitInstallHelp: 'owner/repo\nhttps://github.com/owner/repo\ngithub:owner/repo\ngit+https://github.com/owner/repo.git\ngit@github.com:owner/repo.git',
-  dshCmdHelp: 'dsh plugin --profile web add <目标>\ndsh plugin --profile=web add <目标>\n\t--profile 必填，官方 CLI 无 -p 简写；<目标> 可为 npm 包名或 github:owner/repo',
+  dshCmdHelp: 'dsh plugin --profile web add <目标>\t安装\ndsh plugin --profile web update <目标>\t更新已安装目标到最新版本\ndsh plugin --profile=web add <目标>\ndsh plugin --profile=web update <目标>\n\t--profile 必填，官方 CLI 无 -p 简写；<目标> 可为 npm 包名或 github:owner/repo；卸载请用「已安装」列表',
   globalNpmHint: '将全局安装 CLI 工具（npm install -g），不会出现在「已安装」列表，无需重启宿主',
   installCliBtn: '安装',
   // 安装通道关闭（安全信任开关关掉后，对应卡片禁用并引导去设置打开）
@@ -107,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 安装',
@@ -180,6 +182,8 @@ export const zh = {
   settingsDiagFail: '不可达',
   // 系统诊断通道列表：一键全量诊断 + 一行一个，可点重测
   diagNpm: 'npm 源',
+  // 诊断页 npm 行：未配置镜像时的展示（探测目标仍为官方源，代表本机无配置时的回退）
+  diagNpmUnset: '未配置（跟随本机 npm 配置）',
   diagGithub: 'GitHub',
   diagCatalog: '目录站点',
   diagOk: 'OK',
@@ -230,6 +234,8 @@ export const zh = {
   installNow: '直接安装',
   installing: '安装中…',
   installDone: '安装成功',
+  // 更新成功（通知中心区分安装/更新）：更新 = 已安装目标覆盖重装到最新，与首次安装不同语义
+  updateDone: '更新成功',
   installResultTitle: '插件安装成功',
   installResultDesc: '',
   // 更新语义：已安装插件点「更新」走同一条 add 命令原位覆盖重装，弹窗文案区分安装/更新
@@ -274,6 +280,8 @@ export const zh = {
   errorTitle: '操作失败',
   errorTitleInstall: '安装失败',
   errorTitleUninstall: '卸载失败',
+  // 更新失败（通知中心区分安装/更新）：更新目标覆盖重装失败，与首次安装失败不同语义
+  errorTitleUpdate: '更新失败',
   errorPlugin: '插件',
   errorClose: '知道了',
   errorCopy: '复制错误信息',
@@ -381,13 +389,14 @@ export const en = {
   gitInstallInvalid: 'Enter a GitHub repository address, e.g. owner/repo or https://github.com/owner/repo',
   dshCmdLabel: 'DeepSeek Harness command',
   dshCmdPlaceholder: 'Paste an official dsh plugin command',
-  dshCmdExample: 'e.g. dsh plugin --profile web add github:owner/repo',
-  dshCmdInvalid: 'Paste an official dsh plugin install command (--profile required), e.g. dsh plugin --profile web add github:owner/repo',
+  dshCmdInsertHubUpdate: 'Insert update command',
+  dshCmdExample: 'e.g. dsh plugin --profile web add github:owner/repo, or dsh plugin --profile web update dsh-plugin',
+  dshCmdInvalid: 'Paste an official dsh plugin command (--profile required, add / update), e.g. dsh plugin --profile web update dsh-plugin',
   installHelp: 'Help',
   helpModalTitle: 'Supported command formats',
   npmInstallHelp: 'lodash or @scope/pkg\tjust type the package name\nnpm install lodash\nnpm i lodash\npnpm add @scope/pkg\npnpm i @scope/pkg\nnpm install -g @scope/cli\tinstalls the CLI globally, not shown in Installed',
   gitInstallHelp: 'owner/repo\nhttps://github.com/owner/repo\ngithub:owner/repo\ngit+https://github.com/owner/repo.git\ngit@github.com:owner/repo.git',
-  dshCmdHelp: 'dsh plugin --profile web add <target>\ndsh plugin --profile=web add <target>\n\t--profile is required and there is no -p shorthand; <target> can be an npm package or github:owner/repo',
+  dshCmdHelp: 'dsh plugin --profile web add <target>\tinstall\ndsh plugin --profile web update <target>\tupdate an installed target to the latest version\ndsh plugin --profile=web add <target>\ndsh plugin --profile=web update <target>\n\t--profile is required and there is no -p shorthand; <target> can be an npm package or github:owner/repo; uninstall from the Installed list',
   globalNpmHint: 'This installs CLI tools globally (npm install -g). They won\'t appear in Installed and no host restart is needed.',
   installCliBtn: 'Install',
   // Install channel disabled (security-trust toggle off → card disabled, guides to settings)
@@ -434,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',
@@ -507,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',
@@ -557,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
@@ -600,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/renderMarkdown.ts

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

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/CustomInstallView.module.css

@@ -84,6 +84,31 @@
   border-color: var(--hub-brand-border-soft);
 }
 
+/* 命令卡片标题旁的「一键插入更新命令」：右对齐小号描边按钮，弱化但可点，hover 提亮品牌色 */
+.installInsertBtn {
+  flex-shrink: 0;
+  margin-left: auto;
+  font-family: inherit;
+  font-size: 11px;
+  line-height: 16px;
+  font-weight: 500;
+  color: var(--hub-text-secondary);
+  background: transparent;
+  border: 1px solid var(--hub-border-2);
+  border-radius: 6px;
+  padding: 2px 9px;
+  cursor: pointer;
+  white-space: nowrap;
+  user-select: none;
+  transition: color 120ms ease, border-color 120ms ease, background 120ms ease;
+}
+
+.installInsertBtn:hover {
+  color: var(--hub-brand);
+  border-color: var(--hub-brand-border-soft);
+  background: var(--hub-brand-tint);
+}
+
 /* 文本框上方的示例：灰字小字，告诉用户该通道的推荐写法 */
 .installExample {
   font-size: 11px;

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' },
         ]
@@ -725,7 +728,9 @@ export function mountPluginHubRoutes(webServer: WebServerService, profile: strin
           }
           // Kick off the CLI in the background; the client polls /status for progress
           const task = startPluginMutation({
-            action: 'add',
+            // mode=update（已安装目标的覆盖更新）以 update 动作入队：
+            // 日志按 update 类别落盘（update.start/done/fail），实际 CLI 执行仍是 add <target>@latest
+            action: mode === 'update' ? 'update' : 'add',
             profile,
             target,
             // npm 安装时 target 是包名：displayTarget 固定展示仓库名，待重启行/前端恢复不受通道变化影响

package/src/server/services/install/install-types.ts

@@ -27,7 +27,7 @@ export interface InstallTask {
   attempts: string[]
   /** 全局 npm 安装（官方 `npm install -g <pkgs>`）：非空时任务执行全局 npm 安装，不进任何 profile */
   globalNpm?: string[]
-  action: 'add' | 'remove'
+  action: 'add' | 'remove' | 'update'
   /** 队列语义：pending 排队中 / running 执行中 / done / failed / cancelled（用户取消） */
   status: 'pending' | 'running' | 'done' | 'failed' | 'cancelled'
   timedOut: boolean
@@ -51,7 +51,7 @@ export interface Invocation {
 /** 排队中的变更任务及其启动参数。 */
 export interface QueueItem {
   task: InstallTask
-  options: { action: 'add' | 'remove'; profile: string; target: string; timeoutMs?: number; env?: NodeJS.ProcessEnv; globalNpm?: string[] }
+  options: { action: 'add' | 'remove' | 'update'; profile: string; target: string; timeoutMs?: number; env?: NodeJS.ProcessEnv; globalNpm?: string[] }
 }
 
 /**

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/install/task-queue.ts

@@ -38,7 +38,7 @@ export function getTask(id: number): InstallTask | undefined {
 export interface ActiveTaskInfo {
   id: number
   target: string
-  action: 'add' | 'remove'
+  action: 'add' | 'remove' | 'update'
   status: 'pending' | 'running'
   progress: number
   lines: string[]
@@ -158,13 +158,23 @@ function stopChild(child: ReturnType<typeof spawn>): void {
   child.kill('SIGKILL')
 }
 
+/** 系统日志类别：安装/卸载/更新三分，针对性地判断「哪一步不兼容」。 */
+function mutationCategory(action: 'add' | 'remove' | 'update'): 'install' | 'uninstall' | 'update' {
+  return action === 'remove' ? 'uninstall' : action === 'update' ? 'update' : 'install'
+}
+
+/** 系统日志动作词：开始安装/开始卸载/开始更新。 */
+function mutationVerb(action: 'add' | 'remove' | 'update'): string {
+  return action === 'remove' ? '开始卸载' : action === 'update' ? '开始更新' : '开始安装'
+}
+
 /**
  * Enqueue a plugin mutation and return its task. Tasks run strictly serially:
  * the queue worker starts the next one only after the previous finishes.
  * Progress is visible through `getTask(id)` / `activeTask()` until done.
  */
 export function startPluginMutation(options: {
-  action: 'add' | 'remove'
+  action: 'add' | 'remove' | 'update'
   profile: string
   target: string
   timeoutMs?: number
@@ -193,14 +203,14 @@ export function startPluginMutation(options: {
     })
   }
   queue.push({ task, options: { ...options } })
-  // 系统日志：记录任务入队（安装/卸载开始）
-  const category = options.action === 'add' ? 'install' : 'uninstall'
+  // 系统日志：记录任务入队（安装/卸载/更新开始）
+  const category = mutationCategory(options.action)
   appendLog(options.profile, {
     at: Date.now(),
     level: 'info',
     category,
     event: `${category}.start`,
-    message: `${options.action === 'add' ? '开始安装' : '开始卸载'} ${options.displayTarget ?? options.target}`,
+    message: `${mutationVerb(options.action)} ${options.displayTarget ?? options.target}`,
   })
   pumpQueue()
   return task
@@ -215,16 +225,17 @@ function pumpQueue(): void {
   task.status = 'running'
   void runPluginMutation({ ...options, task }).finally(() => {
     runningChildren.delete(task.id)
-    // 系统日志：任务终态（成功/失败/取消），按动作归类安装/卸载日志
+    // 系统日志：任务终态（成功/失败/取消），按动作归类安装/卸载/更新日志
     const show = task.displayTarget ?? task.target
-    const category = task.action === 'add' ? 'install' : 'uninstall'
+    const category = mutationCategory(task.action)
+    const verb = (v: '成功' | '失败') => task.action === 'remove' ? `卸载${v}` : task.action === 'update' ? `更新${v}` : `安装${v}`
     if (task.status === 'done') {
       appendLog(options.profile, {
         at: Date.now(),
         level: 'success',
         category,
         event: `${category}.done`,
-        message: `${task.action === 'add' ? '安装成功' : '卸载成功'} ${show}${task.needsRestart ? '（待重启生效）' : ''}`,
+        message: `${verb('成功')} ${show}${task.needsRestart ? '（待重启生效）' : ''}`,
       })
     } else if (task.status === 'failed') {
       appendLog(options.profile, {
@@ -232,7 +243,7 @@ function pumpQueue(): void {
         level: 'error',
         category,
         event: `${category}.fail`,
-        message: `${task.action === 'add' ? '安装失败' : '卸载失败'} ${show}`,
+        message: `${verb('失败')} ${show}`,
       })
     } else if (task.status === 'cancelled') {
       appendLog(options.profile, {
@@ -256,7 +267,7 @@ function pumpQueue(): void {
  * Never rejects; failures surface through the result / task state.
  */
 function spawnMutation(options: {
-  action: 'add' | 'remove'
+  action: 'add' | 'remove' | 'update'
   profile: string
   target: string
   timeoutMs?: number
@@ -280,17 +291,21 @@ function spawnMutation(options: {
   // 更新已安装的 npm 包：显式指定 @latest。pnpm add <pkg>（无版本）对已存在依赖
   // （尤其精确 spec 如 "1.3.0"）是幂等的 —— 输出 "Already up to date" 且不改 package.json，
   // 导致「更新成功」但实际仍停留在旧版本；git 地址与全局安装不受此影响。
-  const npmUpdateTarget = updateNpm && !isGlobalNpm && githubRepoOf(target) === null
+  // update 动作实际执行 `add <target>@latest`（pnpm 对已存在依赖带显式版本即原位覆盖升级），
+  // CLI 动词仍透传 add —— 不执行官方 update 动词，避免与既有覆盖重装机制分叉。
+  const isUpdate = action === 'update' || updateNpm === true
+  const cliAction = action === 'update' ? 'add' : action
+  const npmUpdateTarget = isUpdate && !isGlobalNpm && githubRepoOf(target) === null
     ? `${target}@latest`
     : target
   const args = isGlobalNpm
     ? ['install', '-g', ...(globalNpm ?? [])]
-    : [...invocation.prefixArgs, 'plugin', '--profile', profile, action, npmUpdateTarget]
+    : [...invocation.prefixArgs, 'plugin', '--profile', profile, cliAction, npmUpdateTarget]
   // 记录实际执行的命令（npm 通道显示包名，git 通道显示 HTTPS 源），
   // 失败提 Issue 时作为「已尝试的安装方式」随附
   const executed = isGlobalNpm
     ? `npm install -g ${(globalNpm ?? []).join(' ')}`
-    : `dsh plugin --profile ${profile} ${action} ${npmUpdateTarget}`
+    : `dsh plugin --profile ${profile} ${cliAction} ${npmUpdateTarget}`
   if (task && !task.attempts.includes(executed)) {
     task.attempts.push(executed)
   }
@@ -443,10 +458,10 @@ function spawnMutation(options: {
             if (removed) clearPendingRestart(displayTarget ?? target)
             else addPendingRestart(displayTarget ?? target, 'uninstall')
           } else {
-            // 安装成功（或卸载但无 loader 引用）→ 登记待重启：
+            // 安装/更新成功（或卸载但无 loader 引用）→ 登记待重启：
             // 插件要宿主重启才会挂载/卸载干净，重启前一直提醒；展示目标用 displayTarget（owner/repo）
             task.needsRestart = true
-            addPendingRestart(displayTarget ?? target, action === 'add' ? 'install' : 'uninstall')
+            addPendingRestart(displayTarget ?? target, action === 'remove' ? 'uninstall' : 'install')
           }
         }
         pushLine(task, result.timedOut ? '[timed out]' : `[exit ${result.exitCode ?? '?'}]`)
@@ -513,11 +528,11 @@ function ignoredBuildKeys(output: string): string[] {
  *  前端据此展示「本机 npm 版本过低」的准确原因 —— 避免该报错被外层 ERR_PNPM_PREPARE_PACKAGE
  *  误判成插件打包/分发问题、误导用户提 Issue。检测逻辑在独立的 npm-check.ts（本机 npm 环境职责）。 */
 function annotateNpmTooLow(result: InstallResult, options: {
-  action: 'add' | 'remove'
+  action: 'add' | 'remove' | 'update'
   task?: InstallTask
   env?: NodeJS.ProcessEnv
 }): InstallResult {
-  if (options.action !== 'add' || result.exitCode === 0 || result.timedOut) return result
+  if (options.action === 'remove' || result.exitCode === 0 || result.timedOut) return result
   const line = npmTooLowMarker(`${result.stderr}\n${result.stdout}`, options.env)
   if (line === null) return result
   if (options.task && options.task.status !== 'cancelled') pushLine(options.task, line)
@@ -534,7 +549,7 @@ function annotateNpmTooLow(result: InstallResult, options: {
  * Other failures fall through to the single-spawn result.
  */
 export async function runPluginMutation(options: {
-  action: 'add' | 'remove'
+  action: 'add' | 'remove' | 'update'
   profile: string
   target: string
   timeoutMs?: number
@@ -550,7 +565,8 @@ export async function runPluginMutation(options: {
   let result = await spawnMutation(options)
   // allowBuilds 放行 / 装后入口校验都是 profile 专属（pnpm 装进 profile 的场景）；
   // 全局 npm 安装直接走 npm，无 pnpm allowBuilds 拦截、也不进 profile，跳过这两类恢复
-  if (options.action === 'add' && result.exitCode !== 0 && !result.timedOut && (options.globalNpm ?? []).length === 0) {
+  // 安装与更新（同为 add 通道执行）共享同一套恢复路径；卸载不适用
+  if (options.action !== 'remove' && result.exitCode !== 0 && !result.timedOut && (options.globalNpm ?? []).length === 0) {
     const output = `${result.stderr}\n${result.stdout}`
     // git 源：pnpm 打印的 key@url 提示
     if (output.includes('ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED')) {
@@ -588,7 +604,7 @@ export async function runPluginMutation(options: {
   // pnpm 安装本身成功，但目标包入口文件缺失（git 分发缺构建产物）→ 判为失败：
   // 撤销刚登记的待重启，避免用户重启时宿主加载残缺包直接崩溃。
   // 全局 npm 安装不进 profile（profile deps 里没有这些包），跳过入口校验
-  if (options.action === 'add' && result.exitCode === 0 && !result.timedOut && (options.globalNpm ?? []).length === 0) {
+  if (options.action !== 'remove' && result.exitCode === 0 && !result.timedOut && (options.globalNpm ?? []).length === 0) {
     const verified = verifyInstalledEntry(options.profile, options.target)
     if (verified.name !== null && verified.missing !== null) {
       clearPendingRestart(options.displayTarget ?? options.target)

package/src/server/services/profile/profile.ts

@@ -30,17 +30,18 @@ export function githubTarget(repo: string): string | null {
 }
 
 /**
- * DSH 命令行前缀（官方唯一形式 `dsh plugin --profile <name> add <target>`）—— 提取其中的安装目标；
+ * DSH 命令行前缀（官方唯一形式 `dsh plugin --profile <name> <add|update> <target>`）—— 提取其中的安装目标；
  * 非命令输入原样返回。兼容「直接粘贴完整命令」（防用户输错）：--profile 必填且只有长选项
  * （官方 CLI 无 -p 简写，省略即报错），支持 `--profile=<name>` 等号形式，命令大小写不敏感。
+ * update = 更新已安装目标到最新；remove 不在此列（卸载走 /uninstall 路由，按已装包名直卸）。
  * 与客户端 CustomInstallView 口径一致。
  */
-const DSH_PLUGIN_CMD_RE = /^dsh\s+plugin\s+--profile(?:\s+|=)\S+\s+add\s+(.+)$/i
+const DSH_PLUGIN_CMD_RE = /^dsh\s+plugin\s+--profile(?:\s+|=)\S+\s+(add|update)\s+(.+)$/i
 
 export function installTargetOf(value: string): string {
   const input = typeof value === 'string' ? value.trim() : ''
   const match = DSH_PLUGIN_CMD_RE.exec(input)
-  return match !== null ? match[1].trim() : input
+  return match !== null ? match[2].trim() : input
 }
 
 /**