dsh-plugin 1.2.0 → 1.3.0

package/src/client/components/ui/icons.tsx

@@ -1,5 +1,5 @@
 /**
- * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
@@ -53,6 +53,27 @@ export function LinkIcon() {
     }))
 }
 
+/** 帮助图标：圆圈 + 问号（stroke 继承 currentColor），自定义安装卡片标题旁的「帮助」按钮用。 */
+export function HelpIcon() {
+  return h('svg', {
+    viewBox: '0 0 16 16',
+    width: 13,
+    height: 13,
+    fill: 'none',
+    'aria-hidden': 'true',
+  },
+    h('circle', {
+      cx: 8, cy: 8, r: 6.3,
+      stroke: 'currentColor', strokeWidth: 1.4,
+    }),
+    h('path', {
+      d: 'M6.3 6.5a1.9 1.9 0 1 1 2.7 1.7c-.7.3-1 .8-1 1.4',
+      stroke: 'currentColor', strokeWidth: 1.4, strokeLinecap: 'round',
+    }),
+    h('circle', { cx: 8, cy: 11.6, r: 0.95, fill: 'currentColor' }),
+  )
+}
+
 /** 品牌 logo 图标：蓝紫渐变圆角方块 + 白色拼图块（2x2 错落），标题左侧的品牌标识。 */
 export function LogoIcon() {
   return h('svg', {

package/src/client/components/views/CustomInstallView.tsx

@@ -1,30 +1,32 @@
 /**
- * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
  * Custom install view: a standalone top-level section for manually
  * installing npm packages or GitHub sources outside the catalog. Three
- * installer cards, one per channel — npm package, GitHub source and a raw
- * install command (a `dsh plugin ... add <target>` or the official global
- * `npm install -g <pkgs>`) — each with a placeholder example above the
- * input and its own format check. The cards stay separate so a user never
- * has to guess which format goes where. Finished installs surface in the
- * Installed view, marked as custom.
+ * installer cards, one per channel — npm package (bare name or a full
+ * npm/pnpm install command, including the official global `npm install -g`),
+ * GitHub source and the official `dsh plugin ... add <target>` command —
+ * each with a placeholder example above the input and its own format check.
+ * The cards stay separate so a user never has to guess which format goes
+ * where. Finished installs surface in the Installed view, marked as custom.
  *
  * Pure presentational: owns only the three local input/error states; the
  * actual install (custom source, gated by the security toggles) bubbles up
  * via onInstallCustom.
  */
 import { createElement as h, useState } from 'react'
-import type { FormEvent } from 'react'
+import type { FormEvent, MouseEvent } from 'react'
 import styles from '../../styles/CustomInstallView.module.css'
+import modal from '../../styles/Modal.module.css'
 import type { Translate } from '../../types.ts'
+import { CloseIcon, HelpIcon } from '../ui/icons.tsx'
 
 /* —— 自定义安装输入预检 ——
  * 提交前校验「输入是否符合该通道格式」，识别不了的输入不发请求，就地提示推荐格式。
- * 三个通道严格分开：npm 框只认包名，git 框只认 GitHub 地址，命令框认两种完整命令
- * （`dsh plugin [--profile|-p <p>] add <target>` 与官方全局安装 `npm install -g <pkgs>`）。
+ * 三个通道严格分开：npm 框认裸包名或完整 npm/pnpm 安装命令（含全局 `npm install -g`），
+ * git 框只认 GitHub 地址，命令框只认官方 `dsh plugin --profile <name> add <target>`（--profile 必填，无 -p 简写）。
  * 这里只做格式校验，真正归一化/安装由服务端完成。 */
 
 /** GitHub 地址（带前缀形态）：github:、https://github.com/、git+https://github.com/、git@github.com: */
@@ -34,47 +36,83 @@ 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|-p <p>] add <target>`）—— 提取其中的安装目标；
- * 命令大小写不敏感，支持 `-p` 简写与 `--profile=web` 等号形式，与 server 端 installTargetOf 口径一致。 */
-const DSH_PLUGIN_CMD_RE = /^dsh\s+plugin\s+(?:(?:--profile|-p)(?:=|\s+)\S+\s*)?add\s+(.+)$/i
+/** DSH 命令行前缀（官方唯一形式 `dsh plugin --profile <name> add <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
 
 /** npm 全局安装命令（官方 README 格式，如 `npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui`）——
  * 提取 -g 之后的包列表；任一包名非法返回 null（交给格式错误提示）。与 server 端 globalNpmPackagesOf 口径一致。 */
 const NPM_GLOBAL_CMD_RE = /^npm\s+(?:install|i)\s+(?:-g|--global)\s+(.+)$/i
 
+/** 常规 npm/pnpm 安装命令（装进当前 profile，如 `npm install lodash`、`pnpm add @scope/pkg`）——
+ * 提取命令后的包列表；包列表在 splitPackages 里逐个校验。 */
+const NPM_INSTALL_CMD_RE = /^(?:npm\s+(?:install|i)|pnpm\s+(?:add|i|install))\s+(.+)$/i
+
 function installTargetOf(raw: string): string {
   const input = raw.trim()
   const match = DSH_PLUGIN_CMD_RE.exec(input)
   return match !== null ? match[1].trim() : input
 }
 
-function parseNpmGlobalPackages(raw: string): string[] | null {
-  const input = raw.trim()
-  const match = NPM_GLOBAL_CMD_RE.exec(input)
-  if (match === null) return null
-  const packages = match[1].trim().split(/\s+/).filter((p) => p !== '')
-  // 包名逐个校验 + 拒绝以 - 开头的 token（npm 会把 --xxx 当参数而非包名），与 server 端同口径
+/** 空格分隔的包列表：逐个按 npm 包名语法校验 + 拒绝以 - 开头的 token（npm 会把 --xxx 当参数而非包名），
+ * 任一非法返回 null（交给格式错误提示）。与 server 端 globalNpmPackagesOf 同口径。 */
+function splitPackages(raw: string): string[] | null {
+  const packages = raw.trim().split(/\s+/).filter((p) => p !== '')
   if (packages.length === 0 || packages.some((p) => !NPM_PACKAGE_RE.test(p) || p.startsWith('-'))) return null
   return packages
 }
 
-function isGitHubInput(raw: string): boolean {
+/** NPM 框输入解析结果：
+ * - pkg：裸包名或常规安装命令（npm install / npm i / pnpm add / pnpm i），提取单个安装目标；
+ * - global：官方全局安装命令（npm install -g <pkgs>），提取包列表走全局通道。 */
+type NpmInputParse =
+  | { kind: 'pkg'; target: string }
+  | { kind: 'global'; pkgs: string[] }
+
+function parseNpmInput(raw: string): NpmInputParse | null {
   const input = raw.trim()
-  return GITHUB_URL_RE.test(input) || GITHUB_BARE_RE.test(input)
+  // 裸包名（含 @scope/pkg）
+  if (NPM_PACKAGE_RE.test(input)) return { kind: 'pkg', target: input }
+  // 官方全局安装 npm install -g <pkgs>（装系统级 CLI 工具）
+  const global = NPM_GLOBAL_CMD_RE.exec(input)
+  if (global !== null) {
+    const pkgs = splitPackages(global[1])
+    if (pkgs !== null) return { kind: 'global', pkgs }
+    return null
+  }
+  // 常规安装命令 npm install <pkgs> / pnpm add <pkgs> —— 装进当前 profile，一次一个包
+  const install = NPM_INSTALL_CMD_RE.exec(input)
+  if (install !== null) {
+    const pkgs = splitPackages(install[1])
+    if (pkgs !== null && pkgs.length === 1) return { kind: 'pkg', target: pkgs[0] }
+    return null
+  }
+  return null
 }
 
-function isNpmInput(raw: string): boolean {
-  return NPM_PACKAGE_RE.test(raw.trim())
+function isGitHubInput(raw: string): boolean {
+  const input = raw.trim()
+  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' },
+  git: { titleKey: 'gitInstallLabel', contentKey: 'gitInstallHelp' },
+  cmd: { titleKey: 'dshCmdLabel', contentKey: 'dshCmdHelp' },
+} as const
+
+type HelpTarget = keyof typeof HELP_CARDS
+
 export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, enableDsh, onOpenSettings }: {
   t: Translate
-  /** 命令行安装：输入 npm 包名 / GitHub 地址 / 安装命令（dsh plugin add 或 npm install -g）即装
-   *  （custom 源，受安全设置开关控制）；opts.globalNpm 表示官方 npm 全局安装命令，附带解析出的包列表 */
+  /** 命令行安装：输入 npm 包名 / npm、pnpm 安装命令 / GitHub 地址 / dsh plugin 命令即装
+   *  （custom 源，受安全设置开关控制）；opts.globalNpm 表示官方 npm 全局安装命令（npm install -g），附带解析出的包列表 */
   onInstallCustom: (raw: string, opts?: { globalNpm?: string[] }) => void
   /** 安全信任三通道开关：关掉后对应输入卡片禁用（不提交），并引导去设置打开 */
   enableNpm: boolean
@@ -92,6 +130,8 @@ export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, en
   /** 自定义安装：DSH 命令输入与格式错误（'' = 无错误） */
   const [cmdQuery, setCmdQuery] = useState('')
   const [cmdError, setCmdError] = useState('')
+  /** 卡片标题旁「帮助」弹窗：null = 未打开；'npm' | 'git' | 'cmd' = 打开对应卡片的格式清单 */
+  const [helpFor, setHelpFor] = useState<HelpTarget | null>(null)
 
   /** 通道关闭提示行：开关关掉后替代示例与输入行，引导去设置打开 */
   const channelOffRow = h('div', { className: styles.channelOff },
@@ -104,13 +144,18 @@ export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, en
   )
 
   // 三个通道分开校验 —— 识别不了的输入不发请求，就地提示推荐写法。
-  // NPM / GitHub 框只认各自裸目标；命令框认两种完整命令（dsh plugin add / npm install -g），
-  // 提交时 dsh 命令剥成裸目标发给服务端，npm install -g 解析成包列表走全局安装通道。
+  // NPM 框认裸包名或完整 npm/pnpm 命令（含全局 npm install -g，走 globalNpm 通道）；
+  // 命令框只认官方 dsh plugin 命令，提交时剥成裸目标发给服务端。
   const submitNpm = () => {
-    const target = npmQuery.trim()
-    if (!target) return
-    if (!isNpmInput(target)) { setNpmError(t('npmInstallInvalid')); return }
-    onInstallCustom(target)
+    const raw = npmQuery.trim()
+    if (!raw) return
+    const parsed = parseNpmInput(raw)
+    if (parsed === null) { setNpmError(t('npmInstallInvalid')); return }
+    if (parsed.kind === 'global') {
+      onInstallCustom(raw, { globalNpm: parsed.pkgs })
+    } else {
+      onInstallCustom(parsed.target)
+    }
     setNpmQuery('')
     setNpmError('')
   }
@@ -125,14 +170,6 @@ export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, en
   const submitCmd = () => {
     const raw = cmdQuery.trim()
     if (!raw) return
-    // 官方 npm 全局安装命令（npm install -g <pkgs>）优先识别：解析出包列表走全局安装通道
-    const globalPkgs = parseNpmGlobalPackages(raw)
-    if (globalPkgs !== null) {
-      onInstallCustom(raw, { globalNpm: globalPkgs })
-      setCmdQuery('')
-      setCmdError('')
-      return
-    }
     if (!isDshCommand(raw)) { setCmdError(t('dshCmdInvalid')); return }
     onInstallCustom(installTargetOf(raw))
     setCmdQuery('')
@@ -145,16 +182,25 @@ export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, en
     // 三块卡片（一行一个）：label + 文本框上方示例 + 输入行 + 错误区；
     // 安全信任开关关掉对应通道时，卡片禁用并显示「前往设置」提示行
     h('div', { className: styles.installCards },
-      // NPM 包：输入包名即装
+      // NPM 包：输入包名或原生 npm/pnpm 安装命令即装（含官方全局 npm install -g）
       h('div', { className: enableNpm ? styles.installCard : `${styles.installCard} ${styles.installCardDisabled}` },
         h('div', { className: styles.installCardHead },
           h('span', { className: styles.installLabel }, t('npmInstallLabel')),
+          // 标题旁帮助：点开该卡片的格式清单弹窗
+          h('button', {
+            type: 'button',
+            className: styles.installHelpBtn,
+            title: t('installHelp'),
+            'aria-label': t('installHelp'),
+            onClick: () => setHelpFor('npm'),
+          }, h(HelpIcon)),
         ),
         !enableNpm
           ? channelOffRow
           : [
-            // 文本框上方的示例：告诉用户怎么写
-            h('div', { className: styles.installExample }, t('npmInstallExample')),
+            // 文本框上方的示例：把支持的原生命令模式写清楚（两行）
+            h('div', { className: styles.installExample },
+              t('npmInstallExample'), h('br'), t('npmInstallExample2')),
             h('div', { className: styles.installRow },
               h('input', {
                 className: npmError ? `${styles.installInput} ${styles.installInputError}` : styles.installInput,
@@ -184,6 +230,13 @@ export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, en
       h('div', { className: enableGit ? styles.installCard : `${styles.installCard} ${styles.installCardDisabled}` },
         h('div', { className: styles.installCardHead },
           h('span', { className: styles.installLabel }, t('gitInstallLabel')),
+          h('button', {
+            type: 'button',
+            className: styles.installHelpBtn,
+            title: t('installHelp'),
+            'aria-label': t('installHelp'),
+            onClick: () => setHelpFor('git'),
+          }, h(HelpIcon)),
         ),
         !enableGit
           ? channelOffRow
@@ -212,11 +265,17 @@ export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, en
             gitError ? h('div', { className: styles.installError }, gitError) : null,
           ],
       ),
-      // 命令卡片：粘贴完整安装命令即装 —— 官方全局安装 `npm install -g <pkgs>`（装系统级 CLI 工具）
-      // 或完整 dsh plugin 命令（可含 --profile 段，剥成裸目标安装）
+      // 命令卡片：粘贴官方 dsh plugin 命令即装 —— 只认完整命令（--profile 必填，可含 = 等号，剥成裸目标安装）
       h('div', { className: enableDsh ? styles.installCard : `${styles.installCard} ${styles.installCardDisabled}` },
         h('div', { className: styles.installCardHead },
           h('span', { className: styles.installLabel }, t('dshCmdLabel')),
+          h('button', {
+            type: 'button',
+            className: styles.installHelpBtn,
+            title: t('installHelp'),
+            'aria-label': t('installHelp'),
+            onClick: () => setHelpFor('cmd'),
+          }, h(HelpIcon)),
         ),
         !enableDsh
           ? channelOffRow
@@ -246,5 +305,35 @@ export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, en
           ],
       ),
     ),
+    // 帮助弹窗：点卡片标题旁的问号打开 —— 宽窗（720px）把该通道支持的命令格式整行展示，防止折行
+    helpFor !== null
+      ? h('div', {
+        className: modal.overlay,
+        onClick: (e: MouseEvent<HTMLDivElement>) => { if (e.target === e.currentTarget) setHelpFor(null) },
+      },
+        h('div', { className: `${modal.errorModal} ${modal.helpModal}`, role: 'dialog', 'aria-modal': 'true' },
+          h('div', { className: modal.modalHead },
+            h('div', { className: modal.modalTitle }, `${t(HELP_CARDS[helpFor].titleKey)} · ${t('helpModalTitle')}`),
+            h('button', {
+              className: modal.modalClose,
+              'aria-label': t('errorClose'),
+              onClick: () => setHelpFor(null),
+            }, h(CloseIcon)),
+          ),
+          h('div', { className: modal.modalBody },
+            // 格式清单：一行一条；`命令\t说明` 的说明跟在命令后，纯说明行以 \t 开头
+            h('div', { className: styles.helpBody },
+              t(HELP_CARDS[helpFor].contentKey).split('\n').map((line, i) => {
+                const [cmd, note] = line.split('\t')
+                return h('div', { key: i, className: styles.helpLine },
+                  cmd !== '' ? h('span', { className: styles.helpCmd }, cmd) : null,
+                  note !== undefined ? h('span', { className: styles.helpNote }, note) : null,
+                )
+              }),
+            ),
+          ),
+        ),
+      )
+      : null,
   )
 }

package/src/client/components/views/DiagnosticsView.tsx

@@ -1,5 +1,5 @@
 /**
- * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
@@ -20,7 +20,7 @@ type ProbeKey = 'npm' | 'github' | 'catalog'
 /** 系统版本文本：提交 Issue 时粘贴到正文，方便作者复现。 */
 function formatEnv(env: EnvInfo): string {
   return [
-    `DSH-Plugin Hub ${PLUGIN_VERSION}`,
+    `DSH Plugin Hub ${PLUGIN_VERSION}`,
     `DSH ${env.dshVersion ?? 'unknown'}`,
     `Node ${env.nodeVersion}`,
     `${env.platform} ${env.arch} (${env.release})`,

package/src/client/components/views/InstalledView.tsx

@@ -1,5 +1,5 @@
 /**
- * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *

package/src/client/components/views/LogsView.tsx

@@ -1,5 +1,5 @@
 /**
- * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *

package/src/client/components/views/MarketView.tsx

@@ -1,5 +1,5 @@
 /**
- * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *

package/src/client/components/views/SettingsView.tsx

@@ -1,5 +1,5 @@
 /**
- * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *

package/src/client/data/catalog.ts

@@ -1,5 +1,5 @@
 /**
- * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *

package/src/client/data/host.ts

@@ -1,5 +1,5 @@
 /**
- * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *

package/src/client/data/hub.ts

@@ -1,5 +1,5 @@
 /**
- * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
@@ -10,10 +10,19 @@
 import type { HubAboutInfo, HubUpdateInfo } from '../types.ts'
 import { HUB_ABOUT_URL, HUB_UPDATE_URL } from '../logic/constants.ts'
 
+/** 版本接口是 Pages 静态文件，默认带 CDN 缓存（Cache-Control: public, max-age=43200，
+ *  即 12 小时），客户端 no-store 管不到 CDN 边缘，会拿到旧公告。
+ *  静态资产请求免费且无限，因此所有版本检查一律带时间戳 query：URL 每次不同 →
+ *  CDN 缓存 key 不同 → 强制回源拉到最新公告，无任何配额顾虑。 */
+function busted(url: string): string {
+  const sep = url.includes('?') ? '&' : '?'
+  return `${url}${sep}_t=${Date.now()}`
+}
+
 /** Worker 版本控制中心：最新版本 + Markdown 变更记录；不可用返回 null。 */
 export async function fetchHubUpdate(): Promise<HubUpdateInfo | null> {
   try {
-    const res = await fetch(HUB_UPDATE_URL, { cache: 'no-store' })
+    const res = await fetch(busted(HUB_UPDATE_URL), { cache: 'no-store' })
     if (!res.ok) return null
     const data = await res.json() as HubUpdateInfo | null
     if (!data) return null
@@ -28,7 +37,7 @@ export async function fetchHubUpdate(): Promise<HubUpdateInfo | null> {
 /** Worker「关注我们」内容（平台介绍 + 反馈群二维码，Markdown）；未推送返回 null。 */
 export async function fetchHubAbout(): Promise<HubAboutInfo | null> {
   try {
-    const res = await fetch(HUB_ABOUT_URL, { cache: 'no-store' })
+    const res = await fetch(busted(HUB_ABOUT_URL), { cache: 'no-store' })
     if (!res.ok) return null
     const data = await res.json() as HubAboutInfo | null
     if (!data || data.content === null || data.content === undefined) return null

package/src/client/hooks/useCatalog.ts

@@ -1,5 +1,5 @@
 /**
- * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
@@ -22,7 +22,7 @@ import {
 } from '../logic/installed.ts'
 import type { InstalledItem, InstalledVersionSignal } from '../logic/installed.ts'
 
-/** 插件市场自身仓库：DSH-Plugin Hub 不显示在目录里（自己不进自己的插件列表） */
+/** 插件市场自身仓库：DSH Plugin Hub 不显示在目录里（自己不进自己的插件列表） */
 const SELF_REPO = 'dshplugin/dsh-plugin-hub'
 
 /** 市场各排序的默认方向：全部按倒序（Star/Fork 多、更新/收录近的在前） */
@@ -51,6 +51,19 @@ export function useCatalog(lang: LocaleId) {
     if (key === sort) setSortDir((d) => (d === 'asc' ? 'desc' : 'asc'))
     else { setSort(key); setSortDir(SORT_DEFAULT_DIR[key]) }
   }
+  /**
+   * 强制刷新 Hub 版本与「关注我们」信息：点击头部版本号/徽标时触发。
+   * 挂载期的 useEffect 只在进入/reload 时拉一次，发版后已打开的界面点版本号
+   * 仍显示旧数据；此处重新拉接口中心，最新版本与变更记录点击即见。
+   * 失败静默为 null（弹窗兜底展示当前版本号），与挂载期拉取口径一致。
+   */
+  const refreshHub = async () => {
+    // 版本接口已恒带时间戳绕过 CDN，手动/自动拉取都能拿到最新公告
+    const [info, about] = await Promise.all([fetchHubUpdate(), fetchHubAbout()])
+    setHubUpdateInfo(info)
+    setHubAboutInfo(about)
+  }
+
   /** 当前 profile 已安装插件：npm 包名 -> manifest spec（来自宿主本地路由） */
   const [installed, setInstalled] = useState<Record<string, string>>({})
   /** 安装时记录的目录信号：repo(小写) -> { version, updatedAt }（来自宿主本地路由）；
@@ -74,15 +87,14 @@ export function useCatalog(lang: LocaleId) {
     setHubPlugin(null)
     setStats(null)
     setFailed(false)
-    // 目录数据直拉：hub 自身版本由独立 Worker 版本控制中心管理，不再依赖主站版本号接口；
-    // 数据接口 CDN 缓存 1 小时，发布新数据后最长 1 小时全网生效。
+    // 目录数据直拉：hub 自身版本由独立 Worker 版本控制中心管理，不再依赖主站版本号接口。
     const load = () => Promise.all([fetchCatalog(lang), fetchStats()])
     load()
       .then(([list, stats]) => {
         if (cancelled) return
-        // 插件市场不显示自己：DSH-Plugin Hub 从目录里排除自身条目，
+        // 插件市场不显示自己：DSH Plugin Hub 从目录里排除自身条目，
         // 防止「自己出现在自己的插件列表里、还能自己安装自己」；统计计数同步减 1 保持与列表一致。
-        // 主站数据已同步排除自身，此处为 CDN 缓存期的兜底。
+        // 目录数据已排除自身，此处再兜底过滤一次，防旧快照仍含自身条目。
         const hadSelf = list.some((p) => p.source?.repo === SELF_REPO)
         // 过滤前单独保留 hub 自身条目：它不进目录列表，但「可更新」徽标的直接更新需要它作为重装目标
         setHubPlugin(list.find((p) => p.source?.repo === SELF_REPO) ?? null)
@@ -215,6 +227,7 @@ export function useCatalog(lang: LocaleId) {
     hubHasUpdate,
     hubUpdateInfo,
     hubAboutInfo,
+    refreshHub,
     refreshInstalled,
     category,
     setCategory,

package/src/client/hooks/useIncrementalList.ts

@@ -1,5 +1,5 @@
 /**
- * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *

package/src/client/hooks/useLanguage.ts

@@ -1,5 +1,5 @@
 /**
- * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *

package/src/client/hooks/useSettings.ts

@@ -1,5 +1,5 @@
 /**
- * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *

package/src/client/hooks/useTaskQueue.ts

@@ -1,5 +1,5 @@
 /**
- * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *

package/src/client/index.tsx

@@ -1,5 +1,5 @@
 /**
- * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *