dsh-plugin 1.3.4 → 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' },
                 ];
@@ -727,7 +729,9 @@ export function mountPluginHubRoutes(webServer, profile, loader) {
                     }
                     // 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/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/install/task-queue.js

@@ -142,6 +142,14 @@ function stopChild(child) {
     }
     child.kill('SIGKILL');
 }
+/** 系统日志类别：安装/卸载/更新三分，针对性地判断「哪一步不兼容」。 */
+function mutationCategory(action) {
+    return action === 'remove' ? 'uninstall' : action === 'update' ? 'update' : 'install';
+}
+/** 系统日志动作词：开始安装/开始卸载/开始更新。 */
+function mutationVerb(action) {
+    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.
@@ -161,14 +169,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;
@@ -184,16 +192,17 @@ function pumpQueue() {
     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') {
@@ -202,7 +211,7 @@ function pumpQueue() {
                 level: 'error',
                 category,
                 event: `${category}.fail`,
-                message: `${task.action === 'add' ? '安装失败' : '卸载失败'} ${show}`,
+                message: `${verb('失败')} ${show}`,
             });
         }
         else if (task.status === 'cancelled') {
@@ -236,17 +245,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);
     }
@@ -413,10 +426,10 @@ function spawnMutation(options) {
                             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 ?? '?'}]`);
@@ -482,7 +495,7 @@ function ignoredBuildKeys(output) {
  *  前端据此展示「本机 npm 版本过低」的准确原因 —— 避免该报错被外层 ERR_PNPM_PREPARE_PACKAGE
  *  误判成插件打包/分发问题、误导用户提 Issue。检测逻辑在独立的 npm-check.ts（本机 npm 环境职责）。 */
 function annotateNpmTooLow(result, options) {
-    if (options.action !== 'add' || result.exitCode === 0 || result.timedOut)
+    if (options.action === 'remove' || result.exitCode === 0 || result.timedOut)
         return result;
     const line = npmTooLowMarker(`${result.stderr}\n${result.stdout}`, options.env);
     if (line === null)
@@ -504,7 +517,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')) {
@@ -544,7 +558,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/lib/services/profile/profile.js

@@ -27,16 +27,17 @@ export function githubTarget(repo) {
     return `git+https://github.com/${repo}.git`;
 }
 /**
- * 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) {
     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;
 }
 /**
  * npm 全局安装命令（官方 README 的 `npm install -g <pkgs>`，如 dsh-tui 的安装命令）——

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/install-types.d.ts

@@ -25,7 +25,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;
@@ -48,7 +48,7 @@ export interface Invocation {
 export interface QueueItem {
     task: InstallTask;
     options: {
-        action: 'add' | 'remove';
+        action: 'add' | 'remove' | 'update';
         profile: string;
         target: string;
         timeoutMs?: number;

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

@@ -5,7 +5,7 @@ export declare 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[];
@@ -37,7 +37,7 @@ export declare function cancelTask(id: number): boolean;
  * Progress is visible through `getTask(id)` / `activeTask()` until done.
  */
 export declare function startPluginMutation(options: {
-    action: 'add' | 'remove';
+    action: 'add' | 'remove' | 'update';
     profile: string;
     target: string;
     timeoutMs?: number;
@@ -73,7 +73,7 @@ export declare function verifyInstalledEntry(profile: string, target: string): {
  * Other failures fall through to the single-spawn result.
  */
 export declare function runPluginMutation(options: {
-    action: 'add' | 'remove';
+    action: 'add' | 'remove' | 'update';
     profile: string;
     target: string;
     timeoutMs?: number;

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.4",
+  "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,
@@ -427,6 +431,8 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
               enableGit: hubSettings.enableGitInstall,
               enableDsh: hubSettings.enableDshInstall,
               onOpenSettings: () => setView('settings'),
+              // 当前 profile：一键插入的 Hub 更新命令用它拼 --profile
+              profile: env?.profile ?? 'web',
               onInstallCustom: (raw, opts) => {
                 const target = raw.trim()
                 if (!target) return

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/CustomInstallView.tsx

@@ -26,7 +26,8 @@ import { CloseIcon, HelpIcon } from '../ui/icons.tsx'
 /* —— 自定义安装输入预检 ——
  * 提交前校验「输入是否符合该通道格式」，识别不了的输入不发请求，就地提示推荐格式。
  * 三个通道严格分开：npm 框认裸包名或完整 npm/pnpm 安装命令（含全局 `npm install -g`），
- * git 框只认 GitHub 地址，命令框只认官方 `dsh plugin --profile <name> add <target>`（--profile 必填，无 -p 简写）。
+ * git 框只认 GitHub 地址，命令框只认官方 `dsh plugin --profile <name> <add|update> <target>`
+ * （--profile 必填，无 -p 简写；update = 更新已安装目标到最新）。
  * 这里只做格式校验，真正归一化/安装由服务端完成。 */
 
 /** GitHub 地址（带前缀形态）：github:、https://github.com/、git+https://github.com/、git@github.com: */
@@ -36,10 +37,12 @@ const GITHUB_BARE_RE = /^[A-Za-z0-9._-]+\/[A-Za-z0-9._-]+$/
 /** npm 包名（含 @scope/pkg） */
 const NPM_PACKAGE_RE = /^(?:@[a-z0-9._-]+\/)?[a-z0-9._-]+$/
 
-/** DSH 命令行前缀（官方唯一形式 `dsh plugin --profile <name> add <target>`）—— 提取其中的安装目标。
+/** DSH 命令行前缀（官方唯一形式 `dsh plugin --profile <name> <add|update> <target>`）—— 提取其中的动作与目标。
  * 官方 CLI（apps/cli/src/args.ts，commander）：--profile 为必填长选项（无 -p 简写，省略即报错），
- * 支持 `--profile=<name>` 等号形式；命令大小写不敏感。与 server 端 installTargetOf 口径一致。 */
-const DSH_PLUGIN_CMD_RE = /^dsh\s+plugin\s+--profile(?:\s+|=)\S+\s+add\s+(.+)$/i
+ * 支持 `--profile=<name>` 等号形式；命令大小写不敏感。update = 已安装目标覆盖更新到最新；
+ * remove 不走这里（卸载由「已安装」列表的卸载按钮执行，命令框不认卸载动词）。
+ * 与 server 端 installTargetOf 口径一致。 */
+const DSH_PLUGIN_CMD_RE = /^dsh\s+plugin\s+--profile(?:\s+|=)\S+\s+(add|update)\s+(.+)$/i
 
 /** npm 全局安装命令（官方 README 格式，如 `npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui`）——
  * 提取 -g 之后的包列表；任一包名非法返回 null（交给格式错误提示）。与 server 端 globalNpmPackagesOf 口径一致。 */
@@ -49,10 +52,12 @@ const NPM_GLOBAL_CMD_RE = /^npm\s+(?:install|i)\s+(?:-g|--global)\s+(.+)$/i
  * 提取命令后的包列表；包列表在 splitPackages 里逐个校验。 */
 const NPM_INSTALL_CMD_RE = /^(?:npm\s+(?:install|i)|pnpm\s+(?:add|i|install))\s+(.+)$/i
 
-function installTargetOf(raw: string): string {
+/** 解析 DSH 命令：返回 { action, target }；非官方命令返回 null（交给格式错误提示）。 */
+function parseDshCommand(raw: string): { action: 'add' | 'update'; target: string } | null {
   const input = raw.trim()
   const match = DSH_PLUGIN_CMD_RE.exec(input)
-  return match !== null ? match[1].trim() : input
+  if (match === null) return null
+  return { action: match[1].toLowerCase() as 'add' | 'update', target: match[2].trim() }
 }
 
 /** 空格分隔的包列表：逐个按 npm 包名语法校验 + 拒绝以 - 开头的 token（npm 会把 --xxx 当参数而非包名），
@@ -96,10 +101,6 @@ function isGitHubInput(raw: string): boolean {
   return GITHUB_URL_RE.test(input) || GITHUB_BARE_RE.test(input)
 }
 
-function isDshCommand(raw: string): boolean {
-  return DSH_PLUGIN_CMD_RE.test(raw.trim())
-}
-
 /** 卡片标题旁的「帮助」弹窗：三块卡片各自的标题与格式清单语言包 key。 */
 const HELP_CARDS = {
   npm: { titleKey: 'npmInstallLabel', contentKey: 'npmInstallHelp' },
@@ -109,7 +110,7 @@ const HELP_CARDS = {
 
 type HelpTarget = keyof typeof HELP_CARDS
 
-export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, enableDsh, onOpenSettings }: {
+export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, enableDsh, onOpenSettings, profile }: {
   t: Translate
   /** 命令行安装：输入 npm 包名 / npm、pnpm 安装命令 / GitHub 地址 / dsh plugin 命令即装
    *  （custom 源，受安全设置开关控制）；opts.globalNpm 表示官方 npm 全局安装命令（npm install -g），附带解析出的包列表 */
@@ -120,6 +121,8 @@ export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, en
   enableDsh: boolean
   /** 引导去「设置 → 安全信任」打开被关闭的通道开关 */
   onOpenSettings: () => void
+  /** 当前 dsh profile 名（宿主 /env 快照）：一键插入的更新命令用它拼 --profile */
+  profile: string
 }) {
   /** 自定义安装：NPM 包输入与格式错误（'' = 无错误） */
   const [npmQuery, setNpmQuery] = useState('')
@@ -170,11 +173,19 @@ export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, en
   const submitCmd = () => {
     const raw = cmdQuery.trim()
     if (!raw) return
-    if (!isDshCommand(raw)) { setCmdError(t('dshCmdInvalid')); return }
-    onInstallCustom(installTargetOf(raw))
+    const parsed = parseDshCommand(raw)
+    if (parsed === null) { setCmdError(t('dshCmdInvalid')); return }
+    // add / update 统一走安装流程：目标已安装时弹窗自动转「更新」覆盖重装（服务端 mode=update 放行），
+    // 未安装时即为普通安装 —— 粘贴 `dsh plugin --profile web update dsh-plugin` 这类命令即可更新到最新
+    onInstallCustom(parsed.target)
     setCmdQuery('')
     setCmdError('')
   }
+  /** 一键插入 DSH Plugin Hub 自身的更新命令：按当前 profile 拼官方命令填进输入框，用户确认后提交 */
+  const insertHubUpdate = () => {
+    setCmdQuery(`dsh plugin --profile ${profile} update dsh-plugin`)
+    setCmdError('')
+  }
 
   return h('div', { className: styles.root },
     // 页面说明：独立一级导航，交代「装完去哪看」
@@ -265,7 +276,8 @@ export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, en
             gitError ? h('div', { className: styles.installError }, gitError) : null,
           ],
       ),
-      // 命令卡片：粘贴官方 dsh plugin 命令即装 —— 只认完整命令（--profile 必填，可含 = 等号，剥成裸目标安装）
+      // 命令卡片：粘贴官方 dsh plugin 命令即装/即更新 —— 只认完整命令
+      // （--profile 必填，可含 = 等号，动词 add/update，剥成裸目标走安装流程）
       h('div', { className: enableDsh ? styles.installCard : `${styles.installCard} ${styles.installCardDisabled}` },
         h('div', { className: styles.installCardHead },
           h('span', { className: styles.installLabel }, t('dshCmdLabel')),
@@ -276,6 +288,15 @@ export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, en
             'aria-label': t('installHelp'),
             onClick: () => setHelpFor('cmd'),
           }, h(HelpIcon)),
+          // 一键插入 Hub 自身的更新命令：按当前 profile 拼 `dsh plugin --profile <p> update dsh-plugin`
+          // 填入输入框（命令卡片被安全开关禁用时不显示，插入后也提交不了）
+          enableDsh
+            ? h('button', {
+              type: 'button',
+              className: styles.installInsertBtn,
+              onClick: insertHubUpdate,
+            }, t('dshCmdInsertHubUpdate'))
+            : null,
         ),
         !enableDsh
           ? channelOffRow

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}`,
       }),
     }),
     // 代理地址：文本框独占一行，整行输入，便于粘贴长代理地址