dsh-plugin 1.1.2 → 1.2.0

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

@@ -0,0 +1,24 @@
+export interface HubSettings {
+    /** 启动时检查目录插件更新，发现可更新时在通知中心提示（安装不自动进行） */
+    checkUpdatesOnStart: boolean;
+    /** npm 镜像源 registry 地址（空串 = 官方 https://registry.npmjs.org） */
+    npmRegistry: string;
+    /** HTTP(S) 代理地址，用于 npm / git / 目录请求（空串 = 直连） */
+    proxy: string;
+    /** 启用命令行安装 NPM 包（默认开；关掉后输入 npm 包名安装被拦截） */
+    enableNpmInstall: boolean;
+    /** 启用命令行安装 GitHub 源码（默认开；关掉后输入 GitHub 地址安装被拦截） */
+    enableGitInstall: boolean;
+    /** 启用命令行粘贴 dsh plugin 命令安装（默认开；关掉后命令输入被禁用） */
+    enableDshInstall: boolean;
+    /** 日志存放位置覆盖（空串 = 默认 ~/.dsh/profiles/<profile>/hub.log；可填目录或 .log 文件路径） */
+    logPath: string;
+}
+export declare const DEFAULT_SETTINGS: HubSettings;
+export declare function settingsFile(profile: string): string;
+/** 读取当前 profile 的设置；文件缺失/损坏时回退默认值（只读路径绝不抛错）。 */
+export declare function loadSettings(profile: string): HubSettings;
+/** 合并并持久化设置（部分更新），返回合并后的完整设置。 */
+export declare function saveSettings(profile: string, patch: Partial<HubSettings>): HubSettings;
+/** 重置为默认设置：删除设置文件，下次读取全部回退默认值（陈旧/白名单外键一并清除）。 */
+export declare function resetSettings(profile: string): HubSettings;

package/package.json

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

@@ -8,43 +8,41 @@
  * rendering is delegated to the small presentational components in this
  * folder; it hosts the dialogs/toast and the section-level copy actions.
  */
-import { createElement as h, useEffect, useState } from 'react'
+import { createElement as h, useEffect, useRef, useState } from 'react'
 import styles from '../styles/Header.module.css'
-import { en, zh } from '../locales.ts'
-import type { EnvInfo, HubPlugin, LocaleId, SectionProps, ToastState } from '../types.ts'
-import { langPathOf, installCommandOf, HUB_REPO, PLUGIN_VERSION } from '../lib/catalog.ts'
-import { getEnv } from '../lib/env.ts'
+import type { EnvInfo, HubPlugin, SectionProps, ToastState } from '../types.ts'
+import { installCommandOf, repoFromInstallTarget } from '../logic/install-command.ts'
+import { PLUGIN_VERSION } from '../logic/constants.ts'
+import { getEnv, revealInstallFolder } from '../data/host.ts'
 import { useCatalog } from '../hooks/useCatalog.ts'
+import { useLanguage } from '../hooks/useLanguage.ts'
+import { useSettings } from '../hooks/useSettings.ts'
 import { useTaskQueue } from '../hooks/useTaskQueue.ts'
-import { ErrorModal, InstallModal, UninstallModal, Toast } from './modals.tsx'
-import { AboutModal } from './AboutModal.tsx'
-import { HubUpdateModal } from './HubUpdateModal.tsx'
-import { NotificationsModal } from './NotificationsModal.tsx'
-import { addFailure, addSuccess, clearNotifications, loadNotifications, removeNotification } from '../lib/failures.ts'
-import type { NotificationRecord } from '../lib/failures.ts'
-import { CatalogHeader } from './CatalogHeader.tsx'
-import { CategoryTabs } from './CategoryTabs.tsx'
-import { CatalogControls } from './CatalogControls.tsx'
-import { CatalogList } from './CatalogList.tsx'
+import { ErrorModal, InstallModal, RestartConfirmModal, UninstallModal, Toast } from './modals/modals.tsx'
+import { AboutModal } from './modals/AboutModal.tsx'
+import { HubUpdateModal } from './modals/HubUpdateModal.tsx'
+import { InstalledDetailModal } from './modals/InstalledDetailModal.tsx'
+import { NotificationsModal } from './modals/NotificationsModal.tsx'
+import { addFailure, addSuccess, addUpdateNotice, clearNotifications, loadNotifications, removeNotification } from '../logic/failures.ts'
+import type { NotificationRecord } from '../logic/failures.ts'
+import { CatalogHeader } from './layout/CatalogHeader.tsx'
+import { MarketView } from './views/MarketView.tsx'
+import { SectionTabs } from './layout/SectionTabs.tsx'
+import type { SectionView } from './layout/SectionTabs.tsx'
+import { InstalledView } from './views/InstalledView.tsx'
+import { CustomInstallView } from './views/CustomInstallView.tsx'
+import { SettingsView } from './views/SettingsView.tsx'
+import type { InstalledItem } from '../logic/installed.ts'
+import { pluginOfItem } from '../logic/installed.ts'
 
 export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
-  /** 界面语言：默认跟随宿主（系统）语言；右上角按钮可手动切换，切换后以手动选择为准 */
-  const [manualLang, setManualLang] = useState<LocaleId | null>(null)
-  const lang: LocaleId = manualLang ?? locale.getSnapshot().active
-  const langKey: LocaleId = lang === 'en' ? 'en' : 'zh'
-  // dsh-plugin.org keeps zh pages under the /zh/ prefix; en is the root.
-  const langPath = langPathOf(lang)
-
-  // 界面语言跟随宿主（系统）locale 自动切换；宿主的 t() 绑定宿主 locale，
-  // 这里基于本地字典自建翻译函数，与宿主 locale 保持一致。
-  // （settings.section 的导航 label 仍在 apply 里用宿主 t()，跟随宿主语言。）
-  const dict: Record<string, string> = langKey === 'en' ? en : zh
-  const t = (key: string, params?: Record<string, string | number>): string => {
-    const raw = dict[key] ?? key
-    return params ? raw.replace(/\{(\w+)\}/g, (_, k) => String(params[k] ?? '')) : raw
-  }
-
+  const { lang, langKey, langPath, t, toggleLang } = useLanguage(locale)
   const catalog = useCatalog(lang)
+  /** 设置状态：服务端 hub-settings.json 持久化，本地乐观更新即时生效 */
+  const { settings: hubSettings, ready: settingsReady, update: updateSettings, reset: resetSettings } = useSettings()
+
+  /** 一级导航：插件中心 / 已安装 / 自定义安装 / 设置 */
+  const [view, setView] = useState<SectionView>('market')
 
   /** 全局反馈 Toast：{id} 用于重复触发时重新走入场动画，kind 决定文案与配色 */
   const [toast, setToast] = useState<ToastState | null>(null)
@@ -54,12 +52,25 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
   const [confirmPlugin, setConfirmPlugin] = useState<HubPlugin | null>(null)
   /** 弹窗动作是否为「更新」：已安装插件点「更新」→ 走同一条 add 命令原位覆盖重装，文案区分安装/更新 */
   const [confirmIsUpdate, setConfirmIsUpdate] = useState(false)
+  /** 命令行安装确认弹窗：记录待安装的裸目标（npm 包名 / GitHub 地址，DSH 命令已剥成裸目标）——
+   *  与应用商店同一套确认/进度/结果弹窗，提供时 plugin 传 null 走 customTarget 模式 */
+  const [confirmCustomTarget, setConfirmCustomTarget] = useState<string | null>(null)
+  /** 全局 npm 安装确认弹窗（官方 `npm install -g <pkgs>`）：记录原始命令 + 解析出的包列表，
+   *  走与应用商店同一套确认/进度/结果弹窗（plugin 传 null，InstallModal 走 globalNpm 模式） */
+  const [confirmGlobalNpm, setConfirmGlobalNpm] = useState<{ raw: string; pkgs: string[] } | null>(null)
   /** Hub 自我更新说明弹窗：点「可更新」徽标先展示版本 + Markdown 变更记录，确认后再进安装弹窗 */
   const [showHubUpdate, setShowHubUpdate] = useState(false)
   /** 「关注我们」弹窗：GitHub 图标后按钮点击打开，展示平台介绍 + 用户反馈群二维码（Worker /about 推送） */
   const [showAbout, setShowAbout] = useState(false)
-  /** 卸载确认弹窗：记录待卸载的插件 */
+  /** 卸载确认弹窗：记录待卸载的插件（目录内） */
   const [uninstallPlugin, setUninstallPlugin] = useState<HubPlugin | null>(null)
+  /** 卸载确认弹窗：记录待卸载的已安装项（自定义安装无目录数据，按包名直卸） */
+  const [uninstallItem, setUninstallItem] = useState<InstalledItem | null>(null)
+  /** 已安装详情弹窗：记录当前查看的已安装项（行点击 / 详情按钮打开） */
+  const [detailItem, setDetailItem] = useState<InstalledItem | null>(null)
+  /** 待重启确认弹窗：已安装列表行内「重启」先弹「立即重启 / 稍后重启」确认（与通知中心一致），
+   *  确认后才真正触发宿主重启，避免误触 */
+  const [showRestartConfirm, setShowRestartConfirm] = useState(false)
   /** 安装/卸载完成后的结果视图：停留弹窗内，点「完成」关闭 */
   const [installDone, setInstallDone] = useState(false)
   const [uninstallDone, setUninstallDone] = useState(false)
@@ -71,8 +82,9 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
   const [restarting, setRestarting] = useState(false)
   /** 操作失败完整信息 + 所属插件仓库 + 失败类型（决定弹窗标题「安装失败/卸载失败」）+ 实际执行的安装命令 + 尝试过的安装方式（issue 预填用） */
   const [errorMsg, setErrorMsg] = useState<{ message: string; repo: string | null; kind: 'install' | 'uninstall'; command?: string; attempts?: string[] } | null>(null)
-  /** 安装/卸载任务通知记录：localStorage 持久化，成败即落盘，即使错过弹窗也能回来查看 */
+  /** 通知中心记录：localStorage 持久化，每次安装/卸载任务成败都留痕（启动时读回） */
   const [notifications, setNotifications] = useState<NotificationRecord[]>(() => loadNotifications())
+  /** 通知中心弹窗：一级导航「设置」tab 后边的铃铛入口按钮打开 */
   const [showNotifications, setShowNotifications] = useState(false)
   /** 宿主机器环境快照：提交 bug 的 issue 正文附带；取不到为 null（链接少环境段，不阻塞） */
   const [env, setEnv] = useState<EnvInfo | null>(null)
@@ -104,7 +116,10 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       setNotifications(addFailure({ kind, repo: repo ?? '', message, command, attempts }))
     },
     installPlugin: confirmPlugin,
+    installCustomTarget: confirmCustomTarget,
+    installGlobalTarget: confirmGlobalNpm ? confirmGlobalNpm.pkgs.join(' ') : null,
     uninstallPlugin,
+    uninstallName: uninstallItem ? uninstallItem.name : null,
     installedName: catalog.installedName,
     // 待重启项展示信息补齐：从目录按 owner/repo 解析插件简介/版本（找不到返回 null，行内只显示仓库名）
     resolvePending: (repo) => {
@@ -113,13 +128,36 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
     },
   })
 
-  // 信任/卸载/更新说明/通知记录弹窗打开时按 Esc 关闭；任务进入后台队列后可随时关闭（任务继续）
+  // 启动更新策略：目录数据与设置都就绪后触发一次 —— 开启「启动时检查更新」→ 发现可更新插件
+  // 即写入通知中心（每条一条，点击可去更新），toast 同步提示已入通知。
+  // 绝不自动安装：是否更新完全由用户决定。
+  // ref 守卫保证只跑一次，后续目录刷新/设置变化不会重复打扰。
+  const startupCheckedRef = useRef(false)
+  useEffect(() => {
+    if (startupCheckedRef.current) return
+    if (!settingsReady || catalog.plugins === null || catalog.failed) return
+    startupCheckedRef.current = true
+    if (!hubSettings.checkUpdatesOnStart) return
+    const updatable = catalog.installedItems.filter((i) => i.hasUpdate && i.plugin)
+    if (updatable.length === 0) return
+    for (const item of updatable) {
+      if (item.repo) addUpdateNotice({ kind: 'update', repo: item.repo, version: item.catalogVersion ?? undefined })
+    }
+    setNotifications(loadNotifications())
+    setToast({ id: Date.now(), kind: 'updates', n: updatable.length })
+  }, [settingsReady, hubSettings, catalog.plugins, catalog.failed, catalog.installedItems, queue])
+
+  // 信任/卸载/更新说明弹窗打开时按 Esc 关闭；任务进入后台队列后可随时关闭（任务继续）
   useEffect(() => {
-    if (!confirmPlugin && !uninstallPlugin && !showNotifications && !showHubUpdate && !showAbout) return
+    if (!confirmPlugin && !confirmCustomTarget && !confirmGlobalNpm && !uninstallPlugin && !uninstallItem && !detailItem && !showHubUpdate && !showAbout && !showNotifications) return
     const onKey = (e: KeyboardEvent) => {
       if (e.key === 'Escape') {
         setConfirmPlugin(null)
+        setConfirmCustomTarget(null)
+        setConfirmGlobalNpm(null)
         setUninstallPlugin(null)
+        setUninstallItem(null)
+        setDetailItem(null)
         setUninstallDone(false)
         setShowHubUpdate(false)
         setShowAbout(false)
@@ -128,7 +166,7 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
     }
     window.addEventListener('keydown', onKey)
     return () => window.removeEventListener('keydown', onKey)
-  }, [confirmPlugin, uninstallPlugin, showNotifications, showHubUpdate, showAbout])
+  }, [confirmPlugin, confirmCustomTarget, uninstallPlugin, uninstallItem, detailItem, showHubUpdate, showAbout, showNotifications])
 
   // Toast 统一自动消失
   useEffect(() => {
@@ -162,6 +200,23 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
     }
   }
 
+  /** 命令行安装目标是否已安装（与服务端 already 判定同口径）：GitHub 地址按仓库身份匹配
+   *  （归一化后比对已装项的 repo/spec），npm 包名按依赖 key 直查。命中 → 弹窗转「更新」语义
+   *  （mode=update 放行覆盖重装），避免重复点击撞 409 报错。 */
+  const customTargetInstalled = (raw: string): boolean => {
+    const target = raw.trim()
+    if (!target) return false
+    const repo = repoFromInstallTarget(target)
+    const isRepo = /^[A-Za-z0-9._-]+\/[A-Za-z0-9._-]+$/.test(repo)
+    if (isRepo) {
+      const needle = repo.toLowerCase()
+      return catalog.installedItems.some((i) =>
+        (i.repo !== null && i.repo.toLowerCase() === needle) ||
+        repoFromInstallTarget(i.spec).toLowerCase() === needle)
+    }
+    return catalog.installedItems.some((i) => i.name === target)
+  }
+
   /** 弹窗动作一：复制安装命令到剪贴板，引导去终端粘贴执行（npm 通道显示包名命令）。 */
   const copyCommand = async (p: HubPlugin) => {
     const repo = p.source?.repo ?? ''
@@ -174,14 +229,21 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
     setConfirmPlugin(null)
   }
 
-  /** 卸载弹窗动作：复制卸载命令，万一直接卸载失败可去终端手动执行。 */
+  /** 卸载弹窗动作：复制卸载命令，万一直接卸载失败可去终端手动执行。
+   *  自定义安装（无目录数据）按已安装项包名直卸，同样给复制通道。 */
   const copyUninstallCommand = async () => {
-    const name = uninstallPlugin ? catalog.installedName(uninstallPlugin) : null
+    const name = uninstallItem ? uninstallItem.name : (uninstallPlugin ? catalog.installedName(uninstallPlugin) : null)
     if (!name) return
     const ok = await doCopy(`dsh plugin remove ${name}`)
     if (ok) setToast({ id: Date.now(), kind: 'copied' })
   }
 
+  /** 详情弹窗动作：在系统文件管理器里定位安装目录；服务端失败给 toast 提示。 */
+  const revealFolder = async (item: InstalledItem) => {
+    const ok = await revealInstallFolder(item.name)
+    if (!ok) setToast({ id: Date.now(), kind: 'revealFail' })
+  }
+
   /** 「立即重启」：POST 同源 /restart，宿主进程自杀重启；随后轮询服务恢复后整页刷新。 */
   const requestRestart = async () => {
     if (restarting) return
@@ -223,8 +285,8 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
   const count = catalog.visible.length
 
   // Hub 自身条目（目录数据里的 dshplugin/dsh-plugin-hub）：头部「可更新」徽标的更新目标。
-  // 目录可能尚未加载（此时 hubEntry 为 null，徽标不渲染，加载完成后自然出现）。
-  const hubEntry = catalog.plugins?.find((p) => p.source?.repo === HUB_REPO) ?? null
+  // useCatalog 在过滤目录（自身不进插件列表）前单独保留该条目；目录可能尚未加载（此时为 null，徽标不渲染）。
+  const hubEntry = catalog.hubPlugin
 
   return h('div', { className: styles.root },
     h(CatalogHeader, {
@@ -232,7 +294,7 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       langPath,
       statsTotal,
       statsVerified,
-      onToggleLang: () => setManualLang(lang === 'en' ? 'zh' : 'en'),
+      onToggleLang: toggleLang,
       // Hub 自身版本信息入口：版本号常驻可点（无更新也看得到当前版本更新内容），
       // 有可用更新时版本号后紧跟红色「可更新」徽标（同一入口），点击都打开同一个更新说明弹窗。
       // 有更新弹窗显示新版本 + Markdown 变更记录，点「直接更新」进安装弹窗覆盖重装。
@@ -240,64 +302,117 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       onVersionClick: () => setShowHubUpdate(true),
       onAboutClick: () => setShowAbout(true),
     }),
-    h(CategoryTabs, {
-      category: catalog.category,
-      setCategory: catalog.setCategory,
-      allLabel: t('all'),
-      totalCount: catalog.total,
-      langKey,
-    }),
-    h(CatalogControls, {
-      query: catalog.query,
-      setQuery: catalog.setQuery,
-      sort: catalog.sort,
-      setSort: catalog.setSort,
-      installedFilter: catalog.installedFilter,
-      setInstalledFilter: catalog.setInstalledFilter,
-      // 已安装/未安装按钮计数跟随当前分类：切到某分类即显示该分类下的已装/未装数量
-      installedCount: catalog.installedCountInCategory,
-      notInstalledCount: catalog.notInstalledCountInCategory,
-      t,
-      // 列表头部「筛选出 N 条」：分类/搜索/安装状态筛选后的结果数；全部视图且未筛选时显示总数
-      resultText: catalog.plugins === null || catalog.failed
-        ? null
-        : catalog.category === 'all' && count === total
-          ? t('pluginsTotal', { n: count })
-          : t('filterResults', { n: count }),
-      // 通知入口计数：历史通知记录数 + 进行中任务数 + 待重启数 ——
-      // 待重启不可清除，装完等重启时必须持续亮着提示「必须重启」，不能因为队列空了就归零
-      // 红圈白字数字（进行中的任务见通知中心「进行中」分区，待重启见「待重启」分区）
-      noticeCount: notifications.length + queue.queue.length + queue.pendingRestarts.length,
-      onOpenNotifications: () => setShowNotifications(true),
-    }),
-    h(CatalogList, {
-      plugins: catalog.plugins,
-      failed: catalog.failed,
-      visible: catalog.visible,
-      total,
-      t,
-      langPath,
-      reload: catalog.reload,
-      category: catalog.category,
-      installedFilter: catalog.installedFilter,
-      copied,
-      installedName,
-      installedVersion,
-      hasUpdate,
-      langKey,
-      onInstall: (p, opts) => {
-        setInstallDone(false)
-        setConfirmIsUpdate(opts?.update ?? false)
-        // 与卸载一致：重置弹窗关联任务，避免新弹窗误匹配到进行中的任务而禁用安装按钮
-        queue.clearModalTask()
-        setConfirmPlugin(p)
-      },
-      onUninstall: (p) => {
-        setUninstallDone(false)
-        queue.clearModalTask()
-        setUninstallPlugin(p)
-      },
-    }),
+    // 一级导航行：tab 占满左侧，通知入口靠右（「设置」tab 后边，右对齐）
+    h('div', { className: styles.tabsRow },
+      // 「已安装」徽标 = 目录插件 + 自定义安装总数（installedItems 已排除 hub 自身）
+      h(SectionTabs, {
+        view,
+        setView,
+        installedCount: catalog.installedItems.length,
+        t,
+        // 通知中心入口：红圈徽标 = 记录数 + 进行中任务 + 待重启（有动静才醒目）
+        noticeCount: notifications.length + queue.queue.length + queue.pendingRestarts.length,
+        onOpenNotifications: () => setShowNotifications(true),
+      }),
+    ),
+    view === 'market'
+      ? h(MarketView, {
+          catalog,
+          t,
+          langPath,
+          langKey,
+          copied,
+          // 列表头部「筛选出 N 条」：分类/搜索/安装状态筛选后的结果数；全部视图且未筛选时显示总数
+          resultText: catalog.plugins === null || catalog.failed
+            ? null
+            : catalog.category === 'all' && count === total
+              ? t('pluginsTotal', { n: count })
+              : t('filterResults', { n: count }),
+          onInstall: (p, opts) => {
+            setInstallDone(false)
+            setConfirmIsUpdate(opts?.update ?? false)
+            // 与卸载一致：重置弹窗关联任务，避免新弹窗误匹配到进行中的任务而禁用安装按钮
+            queue.clearModalTask()
+            setConfirmPlugin(p)
+          },
+          onUninstall: (p) => {
+            setUninstallDone(false)
+            queue.clearModalTask()
+            setUninstallPlugin(p)
+          },
+        })
+      : view === 'installed'
+        ? h(InstalledView, {
+            items: catalog.installedItems,
+            langKey,
+            t,
+            // 支持系统文件管理器定位的平台（macOS / Linux）上，行内「打开详情」替换为
+            // 打开安装目录按钮（行点击本身即打开详情弹窗）；Windows 不支持则按钮不显示
+            platform: env?.platform ?? '',
+            // 行点击 / 详情按钮：打开已安装详情弹窗（完整元数据 + 运行时信息）
+            onOpenDetail: (item) => setDetailItem(item),
+            onReveal: (item) => { void revealFolder(item) },
+            // 更新：已安装视图的「更新」= 目录插件覆盖重装，与市场列表内更新同一流程
+            onUpdate: (item) => {
+              if (!item.plugin) return
+              setDetailItem(null)
+              setInstallDone(false)
+              setConfirmIsUpdate(true)
+              queue.clearModalTask()
+              setConfirmPlugin(item.plugin)
+            },
+            // 卸载：目录插件与自定义安装统一按已安装项走卸载确认弹窗（自定义无目录数据，按包名直卸）
+            onUninstall: (item) => {
+              setDetailItem(null)
+              setUninstallDone(false)
+              queue.clearModalTask()
+              setUninstallItem(item)
+            },
+            // 重启：待重启条目行内按钮 → 先弹「立即重启 / 稍后重启」确认（与通知中心一致），确认后才触发宿主重启
+            onRestart: () => setShowRestartConfirm(true),
+          })
+        : view === 'custom'
+          ? h(CustomInstallView, {
+              t,
+              // 命令行安装：与应用商店同一套确认/进度/结果弹窗 —— 输入 npm 包名 / GitHub 地址 /
+              // dsh plugin 命令即装（custom 源，受安全设置三开关控制）。点安装先弹确认窗，
+              // 确认后走队列安装（实时进度 + 成功结果视图）；目标已安装 → 弹窗转「更新」覆盖重装，
+              // 不再撞「already installed」报错（第一次安装没有反馈才导致用户重复点击）。
+              // 安全信任开关关掉对应通道 → 卡片禁用并提示去设置打开（onOpenSettings 跳到设置页）。
+              enableNpm: hubSettings.enableNpmInstall,
+              enableGit: hubSettings.enableGitInstall,
+              enableDsh: hubSettings.enableDshInstall,
+              onOpenSettings: () => setView('settings'),
+              onInstallCustom: (raw, opts) => {
+                const target = raw.trim()
+                if (!target) return
+                setInstallDone(false)
+                // 与目录安装一致：重置弹窗关联任务，避免新弹窗误匹配到进行中的任务
+                queue.clearModalTask()
+                // 官方全局 npm 安装（npm install -g <pkgs>）：弹窗走 globalNpm 模式（系统级 CLI 工具，
+                // 不进插件列表，不做「已安装→更新」判定 —— npm install -g 对已装包是原位覆盖更新，天然幂等）
+                if (opts?.globalNpm && opts.globalNpm.length > 0) {
+                  setConfirmCustomTarget(null)
+                  setConfirmIsUpdate(false)
+                  setConfirmGlobalNpm({ raw, pkgs: opts.globalNpm })
+                  return
+                }
+                setConfirmGlobalNpm(null)
+                setConfirmIsUpdate(customTargetInstalled(target))
+                setConfirmCustomTarget(target)
+              },
+            })
+          : h(SettingsView, {
+            t,
+            settings: hubSettings,
+            update: updateSettings,
+            reset: resetSettings,
+            env,
+            onCopy: (text: string) => {
+              doCopy(text)
+              setToast({ id: Date.now(), kind: 'copied' })
+            },
+          }),
     // Hub 版本信息弹窗：版本号/徽标点击打开 —— 有更新显示新版本 + 变更记录 + 「直接更新」，
     // 无更新显示当前版本 + 记录 + 「已是最新」。Worker 拉取失败时兜底展示当前版本号。
     showHubUpdate && h(HubUpdateModal, {
@@ -326,6 +441,35 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       t,
       onClose: () => setShowAbout(false),
     }),
+    // 安装/卸载任务通知中心：本地持久化的成败清单，随时可回来查看/复制/清空；
+    // 进行中的任务（实时进度）与待重启插件也一并展示，关掉任务弹窗后仍可盯着
+    showNotifications && h(NotificationsModal, {
+      records: notifications,
+      tasks: queue.queue,
+      pendingRestarts: queue.pendingRestarts,
+      t,
+      env,
+      onClose: () => setShowNotifications(false),
+      onCopy: (text) => {
+        doCopy(text)
+        setToast({ id: Date.now(), kind: 'errCopied' })
+      },
+      onClear: () => setNotifications(clearNotifications()),
+      onRemove: (id: number) => setNotifications(removeNotification(id)),
+      // 更新提醒通知：点击直接进该插件的更新确认弹窗（与已安装列表「更新」同一流程）
+      onUpdate: (repo: string) => {
+        const plugin = catalog.installedItems.find((i) => i.repo === repo)?.plugin
+        if (!plugin) return
+        setShowNotifications(false)
+        setInstallDone(false)
+        setConfirmIsUpdate(true)
+        queue.clearModalTask()
+        setConfirmPlugin(plugin)
+      },
+      cancelTask: queue.cancelTask,
+      restarting,
+      onRestart: () => { void requestRestart() },
+    }),
     // 安装确认弹窗：锁定/进度/结果视图逻辑收敛在 modals.tsx；更新与安装同入口，仅标记 update
     confirmPlugin && h(InstallModal, {
       plugin: confirmPlugin,
@@ -344,9 +488,61 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       onInstall: () => queue.installNow(confirmPlugin, confirmIsUpdate ? { update: true } : undefined),
       onRestart: () => { void requestRestart() },
     }),
-    // 卸载确认弹窗：确认/进度/结果视图逻辑收敛在 modals.tsx
-    uninstallPlugin && h(UninstallModal, {
-      plugin: uninstallPlugin,
+    // 命令行安装确认弹窗：与目录安装同一套确认/进度/结果流程（plugin 传 null 走 customTarget 模式）。
+    // 已安装目标 → update 标记，确认后走覆盖重装（服务端 mode=update 放行），不再 409 报错。
+    confirmCustomTarget && h(InstallModal, {
+      plugin: null,
+      customTarget: confirmCustomTarget,
+      done: installDone,
+      task: queue.installModalTask,
+      t,
+      langPath,
+      restarting,
+      update: confirmIsUpdate,
+      cliOnly: false,
+      submitting: queue.submitting,
+      needsRestart: installNeedsRestart,
+      onClose: () => {
+        setInstallDone(false)
+        setConfirmCustomTarget(null)
+      },
+      onCopy: () => {
+        doCopy(`pnpm add ${confirmCustomTarget}`)
+        setToast({ id: Date.now(), kind: 'copied' })
+      },
+      onInstall: () => void queue.installCustom(confirmCustomTarget, confirmIsUpdate ? { update: true } : undefined),
+      onRestart: () => { void requestRestart() },
+    }),
+    // 全局 npm 安装确认弹窗（官方 `npm install -g <pkgs>`）：与应用商店同一套确认/进度/结果流程。
+    // 装的是系统级 CLI 工具（如 @deepseek-ai/dsh），不进任何 profile、无需宿主重启；
+    // 服务端任务终态 needsRestart=false → 结果视图仅「完成」。
+    confirmGlobalNpm && h(InstallModal, {
+      plugin: null,
+      globalNpm: confirmGlobalNpm.pkgs,
+      done: installDone,
+      task: queue.installModalTask,
+      t,
+      langPath,
+      restarting,
+      update: false,
+      cliOnly: false,
+      submitting: queue.submitting,
+      needsRestart: installNeedsRestart,
+      onClose: () => {
+        setInstallDone(false)
+        setConfirmGlobalNpm(null)
+      },
+      onCopy: () => {
+        doCopy(`npm install -g ${confirmGlobalNpm.pkgs.join(' ')}`)
+        setToast({ id: Date.now(), kind: 'copied' })
+      },
+      onInstall: () => void queue.installGlobalNpm(confirmGlobalNpm.pkgs),
+      onRestart: () => { void requestRestart() },
+    }),
+    // 卸载确认弹窗：确认/进度/结果视图逻辑收敛在 modals.tsx。
+    // 已安装视图的自定义安装（目录外）没有完整目录数据，按已安装项伪插件适配后走同一弹窗
+    (uninstallPlugin || uninstallItem) && h(UninstallModal, {
+      plugin: uninstallPlugin ?? pluginOfItem(uninstallItem!),
       done: uninstallDone,
       task: queue.uninstallModalTask,
       t,
@@ -357,12 +553,46 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       onClose: () => {
         setUninstallDone(false)
         setUninstallPlugin(null)
+        setUninstallItem(null)
+      },
+      onCancel: () => {
+        setUninstallPlugin(null)
+        setUninstallItem(null)
       },
-      onCancel: () => setUninstallPlugin(null),
       onCopyCommand: copyUninstallCommand,
-      onConfirm: () => queue.uninstallNow(uninstallPlugin),
+      onConfirm: () => {
+        if (uninstallItem) void queue.uninstallItem(uninstallItem)
+        else if (uninstallPlugin) void queue.uninstallNow(uninstallPlugin)
+      },
       onRestart: () => { void requestRestart() },
     }),
+    // 已安装详情弹窗：目录元数据 + 宿主运行时信息的完整展示，操作（更新/卸载/复制路径）由此发起
+    detailItem && h(InstalledDetailModal, {
+      item: detailItem,
+      t,
+      lang: langKey,
+      langPath,
+      onClose: () => setDetailItem(null),
+      onUpdate: (item) => {
+        if (!item.plugin) return
+        setDetailItem(null)
+        setInstallDone(false)
+        setConfirmIsUpdate(true)
+        queue.clearModalTask()
+        setConfirmPlugin(item.plugin)
+      },
+      onUninstall: (item) => {
+        setDetailItem(null)
+        setUninstallDone(false)
+        queue.clearModalTask()
+        setUninstallItem(item)
+      },
+      onCopyPath: (path) => {
+        doCopy(path)
+        setToast({ id: Date.now(), kind: 'copied' })
+      },
+      onReveal: (item) => { void revealFolder(item) },
+    }),
     toast && h(Toast, { toast, t }),
     // 操作失败：完整错误弹窗（重复安装、CLI 失败、请求错误等），可复制并去插件仓库反馈
     errorMsg && h(ErrorModal, {
@@ -379,24 +609,15 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       },
       onClose: () => setErrorMsg(null),
     }),
-    // 安装/卸载任务通知记录：本地持久化的成败清单，随时可回来查看/复制/清空；
-    // 进行中的任务（实时进度）与待重启插件也一并展示，关掉任务弹窗后仍可盯着
-    showNotifications && h(NotificationsModal, {
-      records: notifications,
-      tasks: queue.queue,
-      pendingRestarts: queue.pendingRestarts,
+    // 待重启确认弹窗：已安装列表行内「重启」按钮点击后弹出，稍后重启 / 立即重启
+    showRestartConfirm && h(RestartConfirmModal, {
       t,
-      env,
-      onClose: () => setShowNotifications(false),
-      onCopy: (text) => {
-        doCopy(text)
-        setToast({ id: Date.now(), kind: 'errCopied' })
-      },
-      onClear: () => setNotifications(clearNotifications()),
-      onRemove: (id: number) => setNotifications(removeNotification(id)),
-      cancelTask: queue.cancelTask,
       restarting,
-      onRestart: () => { void requestRestart() },
+      onClose: () => setShowRestartConfirm(false),
+      onRestartNow: () => {
+        setShowRestartConfirm(false)
+        void requestRestart()
+      },
     }),
   )
 }