dsh-plugin 1.1.0 → 1.1.2

package/src/client/components/CatalogHeader.tsx

@@ -1,4 +1,8 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * Section header: brand title row (H1 + open-site button) + tagline, followed
  * by the purple ad banner that promotes the catalog stats.
  */
@@ -8,12 +12,18 @@ import type { Translate } from '../types.ts'
 import { GITHUB_URL, PLUGIN_VERSION, SITE_URL } from '../lib/catalog.ts'
 import { GitHubIcon, LogoIcon } from './icons.tsx'
 
-export function CatalogHeader({ t, langPath, statsTotal, statsVerified, onToggleLang }: {
+export function CatalogHeader({ t, langPath, statsTotal, statsVerified, onToggleLang, hubUpdate, onVersionClick, onAboutClick }: {
   t: Translate
   langPath: string
   statsTotal: number
   statsVerified: number
   onToggleLang: () => void
+  /** Hub 自身是否有可用更新：有则版本号后紧跟红色「可更新」徽标（整体一个可点入口） */
+  hubUpdate: boolean
+  /** 点击版本号（含红色徽标，同一入口）：无论有无更新都打开更新记录弹窗 */
+  onVersionClick: () => void
+  /** 点击「关注我们」：打开平台介绍 + 用户反馈群二维码弹窗 */
+  onAboutClick: () => void
 }) {
   return h(Fragment, null,
     h('div', { className: styles.header },
@@ -28,10 +38,20 @@ export function CatalogHeader({ t, langPath, statsTotal, statsVerified, onToggle
           'aria-label': t('openHint'),
         },
           h(LogoIcon),
-          h('h1', { className: styles.title },
-            t('title'),
-            h('span', { className: styles.version }, ` v${PLUGIN_VERSION}`),
-          ),
+          h('h1', { className: styles.title }, t('title')),
+        ),
+        // 版本号：紧跟标题「DSH-Plugin Hub」之后，常驻可点入口（<a> 内不能嵌套按钮，故从官网链接里移出放在旁边）。
+        // 点击打开更新记录弹窗 —— 有更新看新版本内容，无更新看当前版本内容。
+        // 有更新时版本号后直接跟一个红色「可更新」徽标（同一按钮内，不分开成两个元素），静态显示不闪烁。
+        h('button', {
+          className: styles.versionBtn,
+          type: 'button',
+          onClick: onVersionClick,
+          title: t(hubUpdate ? 'hubUpdateHint' : 'versionHint'),
+          'aria-label': t(hubUpdate ? 'hubUpdateHint' : 'versionHint'),
+        },
+          `v${PLUGIN_VERSION}`,
+          hubUpdate && h('span', { className: styles.hubUpdateBadge }, t('update')),
         ),
         // 右侧控件组：语言切换 + GitHub 源码图标（独立链接，brandTitle 是官网 <a> 不能嵌套），
         // 一起 space-between 顶到标题行最右
@@ -44,6 +64,15 @@ export function CatalogHeader({ t, langPath, statsTotal, statsVerified, onToggle
             title: t('toggleLangHint'),
             'aria-label': t('toggleLangHint'),
           }, langPath === 'zh/' ? 'EN' : '中文'),
+          // 「关注我们」：点击打开平台介绍 + 用户反馈群二维码弹窗
+          h('button', {
+            className: styles.aboutBtn,
+            type: 'button',
+            onClick: onAboutClick,
+            title: t('aboutDesc'),
+            'aria-label': t('aboutTitle'),
+          }, t('followUs')),
+          // GitHub 源码图标：独立链接（brandTitle 是官网 <a> 不能嵌套），放在控件组最后
           h('a', {
             className: styles.githubLink,
             href: GITHUB_URL,

package/src/client/components/CatalogList.tsx

@@ -1,4 +1,8 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * Catalog list: the scrollable container with the loading / failed / empty
  * states, the plugin cards, and the count footer. Resets scroll position when
  * the category or install-status filter changes so the replaced content is

package/src/client/components/CategoryTabs.tsx

@@ -1,4 +1,8 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * Category tabs: an "all" chip followed by one chip per catalog category.
  * The "all" chip carries the total plugin count; the per-category chips
  * carry no counts so their widths stay uniform.

package/src/client/components/Dropdown.tsx

@@ -1,4 +1,8 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * Custom dropdown (native <select> replacement).
  *
  * macOS/浏览器原生下拉无法跟随宿主主题，这里自绘：触发器按钮 + 绝对定位面板，

package/src/client/components/HubUpdateModal.tsx

@@ -0,0 +1,88 @@
+/**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * Hub 版本信息 / 自我更新说明弹窗：
+ *  - 有更新（hasUpdate=true）：标题「有新版本」，展示新版本号、发布时间与 Worker 下发的
+ *    Markdown 变更记录（renderMarkdown 渲染，双语言按界面语言取 {zh,en} 对象），
+ *    按钮「稍后再说 / 直接更新」，确认后进入安装弹窗执行覆盖重装。
+ *  - 无更新（hasUpdate=false）：标题「当前版本」，展示当前版本信息与更新记录，已是最新。
+ * 点击头部版本号（或「可更新」徽标）打开 —— 无论有无更新都能看到更新内容。
+ */
+import { createElement as h } from 'react'
+import type { MouseEvent } from 'react'
+import styles from '../styles/Modal.module.css'
+import type { HubUpdateInfo } from '../lib/catalog.ts'
+import type { LocaleId, Translate } from '../types.ts'
+import { renderMarkdown } from '../lib/renderMarkdown.ts'
+import { CloseIcon } from './icons.tsx'
+
+export function HubUpdateModal({ info, lang, t, hasUpdate, onProceed, onClose }: {
+  info: HubUpdateInfo
+  lang: LocaleId
+  t: Translate
+  /** 是否有可用更新：有则显示「直接更新」，无则显示「已是最新」 */
+  hasUpdate: boolean
+  /** 点「直接更新」：关闭本弹窗，进入安装弹窗的更新流程 */
+  onProceed: () => void
+  onClose: () => void
+}) {
+  // 变更记录：字符串直接使用；{zh,en} 对象按界面语言取，缺哪种补哪种，全缺则不出记录区
+  const notesRaw = typeof info.notes === 'string'
+    ? info.notes
+    : info.notes && typeof info.notes === 'object'
+      ? lang === 'en'
+        ? (info.notes.en ?? info.notes.zh ?? '')
+        : (info.notes.zh ?? info.notes.en ?? '')
+      : ''
+  const notesHtml = notesRaw.trim() ? renderMarkdown(notesRaw) : null
+  // 发布时间：ISO 字符串转本地可读格式；非法值静默隐藏
+  let published: string | null = null
+  if (info.publishedAt) {
+    const d = new Date(info.publishedAt)
+    if (!Number.isNaN(d.getTime())) {
+      published = d.toLocaleString(lang === 'en' ? 'en-US' : 'zh-CN')
+    }
+  }
+
+  return h('div', {
+    className: styles.overlay,
+    onClick: (e: MouseEvent<HTMLDivElement>) => {
+      if (e.target === e.currentTarget) onClose()
+    },
+  },
+    h('div', { className: `${styles.modal} ${styles.hubUpdateModal}`, role: 'dialog', 'aria-modal': 'true' },
+      h('div', { className: styles.modalHead },
+        h('div', { className: styles.modalTitle }, t(hasUpdate ? 'hubUpdateTitle' : 'hubCurrentTitle')),
+        h('button', {
+          className: styles.modalClose,
+          'aria-label': t('confirmCancel'),
+          onClick: () => onClose(),
+        }, h(CloseIcon)),
+      ),
+      h('div', { className: styles.modalDesc },
+        t(hasUpdate ? 'hubUpdateDesc' : 'hubCurrentDesc', { version: info.version })),
+      h('div', { className: styles.hubUpdateMeta },
+        h('span', { className: styles.hubUpdateMetaItem }, `${t('version')} ${info.version}`),
+        published
+          ? h('span', { className: styles.hubUpdateMetaItem }, `${t('hubUpdatePublished')} ${published}`)
+          : null,
+      ),
+      notesHtml
+        ? h('div', {
+          className: styles.hubUpdateNotes,
+          dangerouslySetInnerHTML: { __html: notesHtml },
+        })
+        : null,
+      h('div', { className: styles.modalActions },
+        hasUpdate
+          ? [
+            h('button', { className: styles.restartLater, onClick: onClose }, t('hubUpdateLater')),
+            h('button', { className: styles.modalInstall, onClick: onProceed }, t('updateNow')),
+          ]
+          : h('button', { className: styles.modalInstall, onClick: onClose }, t('hubUpToDate')),
+      ),
+    ),
+  )
+}

package/src/client/components/NotificationsModal.tsx

@@ -1,4 +1,8 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * Notification-center dialog: a persistent log of every settled install /
  * remove task — successes and failures alike.
  *
@@ -156,7 +160,10 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
           ? h('div', { className: styles.failEmpty }, t('notificationsEmpty'))
           : h('div', { className: styles.noticeList },
             records.map((r) => {
-              return h('div', { key: r.id, className: styles.noticeRow },
+              return h('div', {
+                key: r.id,
+                className: r.ok ? `${styles.noticeRow} ${styles.noticeRowOk}` : styles.noticeRow,
+              },
               h('div', { className: styles.noticeRowMain },
                 h('div', {
                   className: r.ok ? styles.noticeBadgeOk : styles.noticeBadgeFail,
@@ -182,6 +189,14 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                       className: styles.failCopy,
                       onClick: () => onCopy(r.message),
                     }, t('failCopy')),
+                    // 成功通知：时间戳并入本行右侧，与图标/文字垂直居中 ——
+                    // 不再单独占底部一行，卡片只有一行内容，图标文字整体居中不顶头
+                    r.ok
+                      ? h('span', {
+                        className: styles.noticeTime,
+                        title: new Date(r.at).toLocaleString(),
+                      }, fmtTime(r.at))
+                      : null,
                     // 每条通知右侧的删除按钮：单独移除这一条
                     h('button', {
                       className: styles.noticeRemove,
@@ -220,13 +235,15 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                   })(),
                 ),
               ),
-              // 每条通知右下角：完整年月日时分秒时间戳（独立一行，不参与徽标垂直居中）
-              h('div', { className: styles.noticeFoot },
-                h('span', {
-                  className: styles.noticeTime,
-                  title: new Date(r.at).toLocaleString(),
-                }, fmtTime(r.at)),
-              ),
+              // 失败通知：时间戳保留独立底部行（右下角）；成功通知已并入头部行右侧
+              !r.ok
+                ? h('div', { className: styles.noticeFoot },
+                  h('span', {
+                    className: styles.noticeTime,
+                    title: new Date(r.at).toLocaleString(),
+                  }, fmtTime(r.at)),
+                )
+                : null,
             )
             }),
           ),

package/src/client/components/PluginCard.tsx

@@ -1,4 +1,8 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * One plugin card in the catalog list: name/category/verified badge,
  * description + topics, star/fork/date stats, and the detail/install/
  * uninstall actions.
@@ -65,7 +69,7 @@ export function PluginCard({ plugin: p, copied, installedName, installedVersion,
           // 查看详情：未安装/已安装都始终显示，跳转官网详情页
           h('a', {
             className: styles.detailBtn,
-            // 两级路径：/plugins/{ownerSlug}/{slug}；旧数据缺 ownerSlug 时从 repo 推导
+            // 两级路径：/plugins/{ownerSlug}/{slug}；缺 ownerSlug 时从 repo 推导
             href: pluginDetailUrl(p, langPath),
             target: '_blank',
             rel: 'noopener noreferrer',
@@ -84,6 +88,9 @@ export function PluginCard({ plugin: p, copied, installedName, installedVersion,
                 disabled: true,
                 title: t('installed'),
               }, t('installed')))
+            // 未安装：按钮恒为「安装」，点击先弹信任确认；AI 识别为「可能需要命令行辅助」
+            // 的插件（webInstallable=false）不拦截，允许尝试一键安装，弹窗内会给出提示与
+            // 复制命令通道，安装失败时引导去 dsh 终端手动执行
             : h('button', {
               className: isCopied ? styles.installBtnCopied : styles.installBtn,
               // 文字恒定避免按钮宽度变化导致卡片跳动；点击先弹信任确认，

package/src/client/components/PluginHubSection.tsx

@@ -1,18 +1,24 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * Plugin Hub section: wires the catalog data pipeline, the background task
  * queue and the feedback state together. Data/queue logic lives in hooks/,
  * rendering is delegated to the small presentational components in this
- * folder; only the dialogs/toast and the section-level copy actions remain.
+ * folder; it hosts the dialogs/toast and the section-level copy actions.
  */
 import { createElement as h, useEffect, 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 } from '../lib/catalog.ts'
+import { langPathOf, installCommandOf, HUB_REPO, PLUGIN_VERSION } from '../lib/catalog.ts'
 import { getEnv } from '../lib/env.ts'
 import { useCatalog } from '../hooks/useCatalog.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'
@@ -48,11 +54,19 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
   const [confirmPlugin, setConfirmPlugin] = useState<HubPlugin | null>(null)
   /** 弹窗动作是否为「更新」：已安装插件点「更新」→ 走同一条 add 命令原位覆盖重装，文案区分安装/更新 */
   const [confirmIsUpdate, setConfirmIsUpdate] = useState(false)
+  /** Hub 自我更新说明弹窗：点「可更新」徽标先展示版本 + Markdown 变更记录，确认后再进安装弹窗 */
+  const [showHubUpdate, setShowHubUpdate] = useState(false)
+  /** 「关注我们」弹窗：GitHub 图标后按钮点击打开，展示平台介绍 + 用户反馈群二维码（Worker /about 推送） */
+  const [showAbout, setShowAbout] = useState(false)
   /** 卸载确认弹窗：记录待卸载的插件 */
   const [uninstallPlugin, setUninstallPlugin] = useState<HubPlugin | null>(null)
   /** 安装/卸载完成后的结果视图：停留弹窗内，点「完成」关闭 */
   const [installDone, setInstallDone] = useState(false)
   const [uninstallDone, setUninstallDone] = useState(false)
+  /** 结果视图是否给「立即重启」：服务端任务终态带出（卸载时 loader 已即时移除 → false 只给「完成」；
+   *  true 时通知中心待重启条目同步常驻，直到用户点「立即重启」真正重启后才消失） */
+  const [installNeedsRestart, setInstallNeedsRestart] = useState(true)
+  const [uninstallNeedsRestart, setUninstallNeedsRestart] = useState(true)
   /** 结果视图「立即重启」：请求宿主重启后进入等待，服务回来后整页刷新 */
   const [restarting, setRestarting] = useState(false)
   /** 操作失败完整信息 + 所属插件仓库 + 失败类型（决定弹窗标题「安装失败/卸载失败」）+ 实际执行的安装命令 + 尝试过的安装方式（issue 预填用） */
@@ -71,13 +85,15 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
   const queue = useTaskQueue({
     t,
     refreshInstalled: catalog.refreshInstalled,
-    onInstallDone: (viaModal, repo) => {
+    onInstallDone: (viaModal, repo, needsRestart) => {
+      setInstallNeedsRestart(needsRestart)
       if (viaModal) setInstallDone(true)
       else setToast({ id: Date.now(), kind: 'done' })
       // 安装成功也写入通知记录：通知中心里成功与失败都能看到
       setNotifications(addSuccess({ kind: 'install', repo: repo ?? '' }))
     },
-    onUninstallDone: (viaModal, repo) => {
+    onUninstallDone: (viaModal, repo, needsRestart) => {
+      setUninstallNeedsRestart(needsRestart)
       if (viaModal) setUninstallDone(true)
       else setToast({ id: Date.now(), kind: 'removed' })
       setNotifications(addSuccess({ kind: 'uninstall', repo: repo ?? '' }))
@@ -97,20 +113,22 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
     },
   })
 
-  // 信任/卸载/通知记录弹窗打开时按 Esc 关闭；任务进入后台队列后可随时关闭（任务继续）
+  // 信任/卸载/更新说明/通知记录弹窗打开时按 Esc 关闭；任务进入后台队列后可随时关闭（任务继续）
   useEffect(() => {
-    if (!confirmPlugin && !uninstallPlugin && !showNotifications) return
+    if (!confirmPlugin && !uninstallPlugin && !showNotifications && !showHubUpdate && !showAbout) return
     const onKey = (e: KeyboardEvent) => {
       if (e.key === 'Escape') {
         setConfirmPlugin(null)
         setUninstallPlugin(null)
         setUninstallDone(false)
+        setShowHubUpdate(false)
+        setShowAbout(false)
         setShowNotifications(false)
       }
     }
     window.addEventListener('keydown', onKey)
     return () => window.removeEventListener('keydown', onKey)
-  }, [confirmPlugin, uninstallPlugin, showNotifications])
+  }, [confirmPlugin, uninstallPlugin, showNotifications, showHubUpdate, showAbout])
 
   // Toast 统一自动消失
   useEffect(() => {
@@ -204,6 +222,10 @@ 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
+
   return h('div', { className: styles.root },
     h(CatalogHeader, {
       t,
@@ -211,6 +233,12 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       statsTotal,
       statsVerified,
       onToggleLang: () => setManualLang(lang === 'en' ? 'zh' : 'en'),
+      // Hub 自身版本信息入口：版本号常驻可点（无更新也看得到当前版本更新内容），
+      // 有可用更新时版本号后紧跟红色「可更新」徽标（同一入口），点击都打开同一个更新说明弹窗。
+      // 有更新弹窗显示新版本 + Markdown 变更记录，点「直接更新」进安装弹窗覆盖重装。
+      hubUpdate: catalog.hubHasUpdate,
+      onVersionClick: () => setShowHubUpdate(true),
+      onAboutClick: () => setShowAbout(true),
     }),
     h(CategoryTabs, {
       category: catalog.category,
@@ -270,6 +298,34 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
         setUninstallPlugin(p)
       },
     }),
+    // Hub 版本信息弹窗：版本号/徽标点击打开 —— 有更新显示新版本 + 变更记录 + 「直接更新」，
+    // 无更新显示当前版本 + 记录 + 「已是最新」。Worker 拉取失败时兜底展示当前版本号。
+    showHubUpdate && h(HubUpdateModal, {
+      info: catalog.hubUpdateInfo ?? { version: PLUGIN_VERSION },
+      lang,
+      t,
+      hasUpdate: catalog.hubHasUpdate,
+      onClose: () => setShowHubUpdate(false),
+      onProceed: () => {
+        setShowHubUpdate(false)
+        // 与列表内更新同一流程：覆盖重装 dsh-plugin + 结果视图「立即重启」
+        if (hubEntry) {
+          setInstallDone(false)
+          setConfirmIsUpdate(true)
+          queue.clearModalTask()
+          setConfirmPlugin(hubEntry)
+        }
+      },
+    }),
+    // 「关注我们」弹窗：GitHub 图标后按钮点击打开 —— 平台介绍 + 用户反馈群二维码，
+    // 内容由 dsh-update Worker 的 /about 接口以 Markdown 形式推送，作者随时可改，非写死。
+    // Worker 未推送（info 为 null）时弹窗仍能打开并展示兜底文案，不影响其他功能。
+    showAbout && h(AboutModal, {
+      info: catalog.hubAboutInfo ?? null,
+      lang,
+      t,
+      onClose: () => setShowAbout(false),
+    }),
     // 安装确认弹窗：锁定/进度/结果视图逻辑收敛在 modals.tsx；更新与安装同入口，仅标记 update
     confirmPlugin && h(InstallModal, {
       plugin: confirmPlugin,
@@ -279,7 +335,10 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       langPath,
       restarting,
       update: confirmIsUpdate,
+      // 仅命令行插件（webInstallable=false）：弹窗只展示命令供复制，不提供一键安装
+      cliOnly: confirmPlugin.install?.webInstallable === false,
       submitting: queue.submitting,
+      needsRestart: installNeedsRestart,
       onClose: () => setConfirmPlugin(null),
       onCopy: () => copyCommand(confirmPlugin),
       onInstall: () => queue.installNow(confirmPlugin, confirmIsUpdate ? { update: true } : undefined),
@@ -294,6 +353,7 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       langPath,
       restarting,
       submitting: queue.submitting,
+      needsRestart: uninstallNeedsRestart,
       onClose: () => {
         setUninstallDone(false)
         setUninstallPlugin(null)

package/src/client/components/ProgressView.tsx

@@ -1,4 +1,8 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * Inline progress block shared by the install and uninstall dialogs:
  * a real percentage bar (server-estimated, client-polled). No live terminal
  * window — pnpm emits nothing during git clone/build, so a log pane would be

package/src/client/components/icons.tsx

@@ -1,4 +1,8 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * Inline SVG icons used across the client. Icons inherit currentColor so
  * they adapt to themes and disabled states automatically.
  */

package/src/client/components/modals.tsx

@@ -1,4 +1,8 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * Dialog layer for the Plugin Hub: the install-confirm dialog, the uninstall
  * dialog and the global toast. Both dialogs lock themselves while a mutation
  * or restart is running, then switch to a result view offering an immediate
@@ -13,14 +17,18 @@ import { ProgressView } from './ProgressView.tsx'
 import { installCommandOf, pluginDetailUrl, pluginIssueUrl, pluginSiteUrl } from '../lib/catalog.ts'
 import { classifyFailure } from '../lib/failures.ts'
 
-/** 完成结果视图：绿色对勾 + 标题/描述 + 「稍后重启 / 立即重启」按钮对（部分插件需重启后才会挂载） */
+/** 完成结果视图：绿色对勾 + 标题/描述；
+ *  needsRestart=true（插件需重启才生效）→ 「稍后重启 / 立即重启」按钮对，点稍后重启后
+ *  通知中心待重启条目常驻（服务端登记，内存态），直到用户点「立即重启」真正重启后才消失；
+ *  needsRestart=false（卸载已即时生效）→ 仅「完成」关闭。 */
 function ResultView({
-  title, desc, t, restarting, onRestart, onClose,
+  title, desc, t, restarting, needsRestart, onRestart, onClose,
 }: {
   title: string
   desc: string
   t: Translate
   restarting: boolean
+  needsRestart: boolean
   onRestart: () => void
   onClose: () => void
 }) {
@@ -43,12 +51,17 @@ function ResultView({
     ),
     h('div', { className: styles.resultTitle }, title),
     desc ? h('div', { className: styles.resultDesc }, desc) : null,
-    h('div', { className: styles.resultRestarting }, restarting ? t('restarting') : t('restartHint')),
-    h('div', { className: styles.modalActions },
-      h('button', { className: styles.restartLater, onClick: onClose, disabled: restarting }, t('restartLater')),
-      h('button', { className: styles.restartNow, onClick: onRestart, disabled: restarting },
-        restarting ? t('restarting') : t('restartNow')),
-    ),
+    needsRestart
+      ? h('div', null, [
+        h('div', { className: styles.resultRestarting }, restarting ? t('restarting') : t('restartHint')),
+        h('div', { className: styles.modalActions },
+          h('button', { className: styles.restartLater, onClick: onClose, disabled: restarting }, t('restartLater')),
+          h('button', { className: styles.restartNow, onClick: onRestart, disabled: restarting },
+            restarting ? t('restarting') : t('restartNow')),
+        ),
+      ])
+      : h('div', { className: styles.modalActions },
+        h('button', { className: styles.restartNow, onClick: onClose }, t('done'))),
   )
 }
 
@@ -61,8 +74,12 @@ export interface InstallModalProps {
   restarting: boolean
   /** 已安装插件的覆盖更新（走同一条 add 命令原位重装，文案区分安装/更新） */
   update: boolean
+  /** 仅命令行插件（webInstallable=false）：不提供一键安装，只展示命令供复制到 dsh 终端 */
+  cliOnly: boolean
   /** 安装请求在途（fetch 等待响应）：此时任务尚未入队，需禁用确认按钮防止二次点击 */
   submitting: boolean
+  /** 完成结果是否需重启才生效：true → 「稍后重启 / 立即重启」；false → 仅「完成」 */
+  needsRestart: boolean
   onClose: () => void
   onCopy: () => void
   onInstall: () => void
@@ -74,7 +91,7 @@ export interface InstallModalProps {
  * 只在本任务执行中展示实时进度；完成后切换为结果视图，与卸载一致。
  */
 export function InstallModal(props: InstallModalProps) {
-  const { plugin, done, task, t, langPath, restarting, submitting, update, onClose, onCopy, onInstall, onRestart } = props
+  const { plugin, done, task, t, langPath, restarting, submitting, update, cliOnly, needsRestart, onClose, onCopy, onInstall, onRestart } = props
   const busy = submitting || (task !== null && (task.status === 'pending' || task.status === 'running'))
   // 进行中标题带上插件名（中文「XX 插件安装中」；英文状态词在前更自然），并用状态色区分
   const name = plugin.displayName ?? plugin.slug
@@ -112,6 +129,7 @@ export function InstallModal(props: InstallModalProps) {
           desc: update ? t('updateResultDesc') : t('installResultDesc'),
           t,
           restarting,
+          needsRestart,
           onRestart,
           onClose,
         })
@@ -145,8 +163,12 @@ export function InstallModal(props: InstallModalProps) {
             h('span', { className: styles.modalCmdText }, installCommandOf(plugin)),
             h('span', { className: styles.modalCmdCopy }, h(CopyIcon), t('copyCmdLabel')),
           ),
+          // AI 识别可能需要命令行辅助的插件（webInstallable=false）：提示但不拦截，仍允许尝试一键安装
+          cliOnly ? h('div', { className: styles.cliOnlyHint }, t('cliOnlyHint')) : null,
           task && task.status === 'pending' ? h('div', { className: styles.queuedHint }, t('queuedHint')) : null,
           task ? h(ProgressView, { task }) : null,
+          // 安装失败：引导用户复制上方命令到 dsh 终端手动安装（如 node-pty 等原生依赖构建脚本需人工放行）
+          task && task.status === 'failed' ? h('div', { className: styles.failedCopyHint }, t('failedCopyHint')) : null,
           h('div', { className: styles.modalActions },
             h('button', {
               className: styles.modalCopy,
@@ -177,6 +199,8 @@ export interface UninstallModalProps {
   restarting: boolean
   /** 卸载请求在途（fetch 等待响应）：此时任务尚未入队，需禁用确认按钮防止二次点击 */
   submitting: boolean
+  /** 完成结果是否需重启才生效：true → 「稍后重启 / 立即重启」；false（loader 已即时移除）→ 仅「完成」 */
+  needsRestart: boolean
   onClose: () => void
   onCancel: () => void
   onCopyCommand: () => void
@@ -186,7 +210,7 @@ export interface UninstallModalProps {
 
 /** 卸载确认弹窗：确认/进行中（后台队列，可关闭）；完成后切换为结果视图（成功即生效，仅「完成」关闭）。 */
 export function UninstallModal(props: UninstallModalProps) {
-  const { plugin, done, task, t, langPath, restarting, submitting, onClose, onCancel, onCopyCommand, onConfirm, onRestart } = props
+  const { plugin, done, task, t, langPath, restarting, submitting, needsRestart, onClose, onCancel, onCopyCommand, onConfirm, onRestart } = props
   const busy = submitting || (task !== null && (task.status === 'pending' || task.status === 'running'))
   // 进行中标题带上插件名，与安装弹窗一致，并用状态色区分
   const name = plugin.displayName ?? plugin.slug
@@ -221,6 +245,7 @@ export function UninstallModal(props: UninstallModalProps) {
           desc: t('uninstallResultDesc'),
           t,
           restarting,
+          needsRestart,
           onRestart,
           onClose,
         })