dsh-plugin 1.1.0 → 1.1.1

package/lib/services/loader.js

@@ -44,13 +44,15 @@ function nameMatches(entryName, target) {
     return false;
 }
 /**
- * 卸载成功后从运行中 loader 停用指定包的条目，使卸载立即生效（刷新页面不再
- * 加载已卸载的 client bundle，也无需重启）。做法：按 name 扫描
+ * 卸载成功后从运行中 loader 停用指定包的条目。做法：按 name 扫描
  * `loader.entries()`（含嵌套子树），对每个匹配条目
  * `entry.update({ disabled: true })` 做 live-disable —— fiber 被 dispose，
  * client-modules 对账后不再把它写进 `__DSH_BOOT__`，页面刷新即恢复。
- * 返回 true = 无需重启（条目已停用，或本就没加载过）；false = 未能停用，
- * 需登记「待重启清理」兜底。宿主关键包（@deepseek-ai/* 与本插件自身）一律跳过。
+ * 返回 true = 无需重启（仅当宿主从未加载过它：磁盘已干净）；
+ * 其余一律 false = 需要重启：要么 disable 失败需「待重启清理」兜底，
+ * 要么 disable 成功但该插件曾在 loader 中存活——带 UI 的插件（侧边栏面板等
+ * 宿主启动时渲染的槽位）disable 后不会主动摘除，不重启面板一直残留。
+ * 宿主关键包（@deepseek-ai/* 与本插件自身）一律跳过。
  */
 export async function removeLoadedEntry(loader, name) {
     if (name === 'dsh-plugin' || name.startsWith('@deepseek-ai/'))
@@ -83,8 +85,13 @@ export async function removeLoadedEntry(loader, name) {
         if (!found) {
             // 运行中 loader 无该条目：宿主从未加载过它（装完未重启），磁盘已干净，无需重启
             console.log(`[hub-uninstall] no live entry for ${name}; nothing to disable`);
+            return true;
         }
-        return true;
+        // 找到并停用了 live entry：逻辑层已卸载（刷新页面不再加载其 client bundle），
+        // 但带 UI 的插件（侧边栏面板等）是宿主启动时渲染的槽位，disable 不会主动摘除，
+        // 不重启面板会一直残留 → 返回「需要重启」，弹窗给出「立即重启」，面板立即消失
+        console.log(`[hub-uninstall] disabled live entry for ${name}; UI may persist until restart`);
+        return false;
     })();
     const result = await Promise.race([
         removal.catch((error) => {

package/lib/services/task-queue.js

@@ -142,7 +142,7 @@ function stopChild(child) {
  * Progress is visible through `getTask(id)` / `activeTask()` until done.
  */
 export function startPluginMutation(options) {
-    const task = { id: nextTaskId, target: options.target, displayTarget: options.displayTarget, action: options.action, status: 'pending', timedOut: false, exitCode: null, progress: 0, lines: [], attempts: options.attempts ?? [] };
+    const task = { id: nextTaskId, target: options.target, displayTarget: options.displayTarget, action: options.action, status: 'pending', timedOut: false, exitCode: null, progress: 0, lines: [], attempts: options.attempts ?? [], needsRestart: false };
     nextTaskId = nextTaskId >= Number.MAX_SAFE_INTEGER ? 1 : nextTaskId + 1;
     tasks.set(task.id, task);
     if (tasks.size > MAX_TASKS) {
@@ -316,9 +316,13 @@ function spawnMutation(options) {
                         if (task.status === 'done') {
                             task.progress = 100;
                             if (action === 'remove' && uninstallLoader) {
-                                // 卸载成功 → 主动从运行中 loader 移除该包条目，立即生效、无需重启；
-                                // 移除失败（或从未加载过但 loader 不可用）才登记「待重启清理」兜底
+                                // 卸载成功 → 主动从运行中 loader 停用该包条目；
+                                // 仅当宿主从未加载过它（磁盘已干净）才判「无需重启」；
+                                // 只要曾在 loader 中存活（停用过 live entry）就仍要求重启——
+                                // 带 UI 的插件（侧边栏面板等宿主启动时渲染的槽位）disable 后不会
+                                // 主动消失，重启才能立即摘除面板
                                 const removed = await removeLoadedEntry(uninstallLoader, target);
+                                task.needsRestart = !removed;
                                 if (removed)
                                     clearPendingRestart(displayTarget ?? target);
                                 else
@@ -327,6 +331,7 @@ function spawnMutation(options) {
                             else {
                                 // 安装成功（或卸载但无 loader 引用）→ 登记待重启：
                                 // 插件要宿主重启才会挂载/卸载干净，重启前一直提醒；展示目标用 displayTarget（owner/repo）
+                                task.needsRestart = true;
                                 addPendingRestart(displayTarget ?? target, action === 'add' ? 'install' : 'uninstall');
                             }
                         }

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

@@ -26,6 +26,8 @@ export interface InstallTask {
     progress: number;
     /** Newest output lines first (consumer shows the tail). */
     lines: string[];
+    /** 完成后是否仍需宿主重启才生效：卸载时 loader 已即时移除 → false；否则 true（弹窗据此给重启选项） */
+    needsRestart: boolean;
 }
 /** 子进程启动参数（复用宿主 dsh 入口，或回退到 PATH 上的 `dsh`）。 */
 export interface Invocation {

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

@@ -32,12 +32,14 @@ export declare function dumpLoaderEntries(loader: LoaderHandle | undefined): Arr
     name?: string;
 }>;
 /**
- * 卸载成功后从运行中 loader 停用指定包的条目，使卸载立即生效（刷新页面不再
- * 加载已卸载的 client bundle，也无需重启）。做法：按 name 扫描
+ * 卸载成功后从运行中 loader 停用指定包的条目。做法：按 name 扫描
  * `loader.entries()`（含嵌套子树），对每个匹配条目
  * `entry.update({ disabled: true })` 做 live-disable —— fiber 被 dispose，
  * client-modules 对账后不再把它写进 `__DSH_BOOT__`，页面刷新即恢复。
- * 返回 true = 无需重启（条目已停用，或本就没加载过）；false = 未能停用，
- * 需登记「待重启清理」兜底。宿主关键包（@deepseek-ai/* 与本插件自身）一律跳过。
+ * 返回 true = 无需重启（仅当宿主从未加载过它：磁盘已干净）；
+ * 其余一律 false = 需要重启：要么 disable 失败需「待重启清理」兜底，
+ * 要么 disable 成功但该插件曾在 loader 中存活——带 UI 的插件（侧边栏面板等
+ * 宿主启动时渲染的槽位）disable 后不会主动摘除，不重启面板一直残留。
+ * 宿主关键包（@deepseek-ai/* 与本插件自身）一律跳过。
  */
 export declare function removeLoadedEntry(loader: LoaderHandle, name: string): Promise<boolean>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "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/AboutModal.tsx

@@ -0,0 +1,72 @@
+/**
+ * 头部「关注我们」弹窗：介绍 DSH-Plugin Hub 是干什么的 + 用户反馈群二维码。
+ * 内容以 Markdown 形式由 dsh-update Worker 的 /about 接口下发（key = hub:about），
+ * 作者想怎么写就怎么写、随写随推，客户端只负责渲染 —— 非写死。
+ * 图片（反馈群二维码）经 renderMarkdown 的 ![](url) 语法嵌入，居中、最大高度受控。
+ */
+import { createElement as h } from 'react'
+import type { MouseEvent } from 'react'
+import styles from '../styles/Modal.module.css'
+import type { HubAboutInfo } from '../lib/catalog.ts'
+import type { LocaleId, Translate } from '../types.ts'
+import { renderMarkdown } from '../lib/renderMarkdown.ts'
+import { CloseIcon } from './icons.tsx'
+
+export function AboutModal({ info, lang, t, onClose }: {
+  info: HubAboutInfo | null
+  lang: LocaleId
+  t: Translate
+  onClose: () => void
+}) {
+  // 内容：字符串直接使用；{zh,en} 对象按界面语言取，缺哪种补哪种，全缺则展示兜底文案。
+  // Worker 未推送（info 为 null / content 为空）时弹窗仍能打开，显示「暂未发布」而非报错。
+  const contentRaw = info
+    ? typeof info.content === 'string'
+      ? info.content
+      : info.content && typeof info.content === 'object'
+        ? lang === 'en'
+          ? (info.content.en ?? info.content.zh ?? '')
+          : (info.content.zh ?? info.content.en ?? '')
+        : ''
+    : ''
+  const contentHtml = contentRaw.trim() ? renderMarkdown(contentRaw) : null
+  // 更新时间：ISO 字符串转本地可读格式；非法值静默隐藏
+  let updated: string | null = null
+  if (info?.updatedAt) {
+    const d = new Date(info.updatedAt)
+    if (!Number.isNaN(d.getTime())) {
+      updated = 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.aboutModal}`, role: 'dialog', 'aria-modal': 'true' },
+      h('div', { className: styles.modalHead },
+        h('div', { className: styles.modalTitle }, t('aboutTitle')),
+        h('button', {
+          className: styles.modalClose,
+          'aria-label': t('confirmCancel'),
+          onClick: () => onClose(),
+        }, h(CloseIcon)),
+      ),
+      h('div', { className: styles.modalDesc }, t('aboutDesc')),
+      contentHtml
+        ? h('div', {
+          className: styles.aboutContent,
+          dangerouslySetInnerHTML: { __html: contentHtml },
+        })
+        : h('div', { className: styles.aboutContent }, t('aboutEmpty')),
+      updated
+        ? h('div', { className: styles.aboutMeta }, `${t('aboutUpdated')} ${updated}`)
+        : null,
+      h('div', { className: styles.modalActions },
+        h('button', { className: styles.modalInstall, onClick: onClose }, t('doneBtn')),
+      ),
+    ),
+  )
+}

package/src/client/components/CatalogHeader.tsx

@@ -8,12 +8,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 +34,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 +60,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/HubUpdateModal.tsx

@@ -0,0 +1,84 @@
+/**
+ * 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

@@ -156,7 +156,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 +185,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 +231,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

@@ -84,6 +84,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

@@ -8,11 +8,13 @@ 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 +50,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 +81,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 +109,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 +218,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 +229,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 +294,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 +331,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 +349,7 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       langPath,
       restarting,
       submitting: queue.submitting,
+      needsRestart: uninstallNeedsRestart,
       onClose: () => {
         setUninstallDone(false)
         setUninstallPlugin(null)