dsh-plugin 0.1.0 → 1.0.0

package/src/client/lib/failures.ts

@@ -0,0 +1,153 @@
+/**
+ * Persistent install/remove notifications.
+ *
+ * Every settled task — success or failure — is appended to localStorage the
+ * moment the backend reports it, so a result is never lost even when the
+ * dialog was dismissed or nobody was watching the progress strip. Newest
+ * first, capped at MAX entries. Failures keep their full output for the
+ * issue-filing flow; successes are lightweight (no log).
+ */
+export interface NotificationRecord {
+  id: number
+  kind: 'install' | 'uninstall'
+  /** true = 成功（轻量记录）；false = 失败（message 携带完整错误日志） */
+  ok: boolean
+  /** owner/repo（可能为空：请求层失败但拿不到仓库时） */
+  repo: string
+  /** 失败时的完整错误日志；成功记录为空串 */
+  message: string
+  /** 结束时间（epoch ms） */
+  at: number
+}
+
+const KEY = 'gro.ngilp-hsd.failure-records'
+const MAX = 50
+
+export type FailureKind = 'pnpmIgnoredBuild' | 'pluginPrepare' | 'repo'
+
+/**
+ * 失败归类，三态。无论底层机制如何（pnpm 白名单拦截 / 构建脚本被忽略 / prepare 失败），
+ * 对用户而言结果都一样 —— 用官方默认安装方式装不上，就是插件仓库的问题，一律引导提 Issue：
+ * - pnpmIgnoredBuild：插件依赖里的原生模块构建脚本被 pnpm 默认拦截（如 node-pty，
+ *   `ERR_PNPM_IGNORED_BUILDS`）。只影响带原生模块的插件，其他插件不受影响 —— 差异在
+ *   插件的依赖选择，属插件依赖/打包问题 → 引导去仓库提 Issue（建议改用预编译版本）
+ * - pluginPrepare：插件的 prepare/构建脚本实际执行失败（git tarball 常因缺失子模块或
+ *   构建产物导致）—— 属插件打包/分发问题，应引导去仓库提 Issue
+ * - repo：其余失败（含 git prepare 被 pnpm 白名单拦截等），默认按插件仓库问题引导提 Issue
+ */
+export function classifyFailure(message: string): FailureKind {
+  // 装后校验拦截（服务端 verifyInstalledEntry 标记）：入口文件缺失 = git 分发缺构建产物，
+  // 与 pluginPrepare 同类（插件打包/分发问题），引导去仓库提 Issue
+  if (/\[packaging\]|entry file missing/i.test(message)) return 'pluginPrepare'
+  // 原生模块构建被忽略（IGNORED_BUILDS）要在 prepare 判定之前：dsh 尾部固定提示语带
+  // allowBuilds/pnpm-workspace.yaml，不能据此把插件自身问题误判成通用失败
+  if (/ERR_PNPM_IGNORED_BUILDS|Ignored build scripts:/i.test(message)) return 'pnpmIgnoredBuild'
+  // 再判 prepare 实际执行失败：只有构建脚本真的跑挂了才是插件问题
+  if (/ERR_PNPM_PREPARE_PACKAGE|ELIFECYCLE|Command failed|prepare-guard/i.test(message)) return 'pluginPrepare'
+  // 其余失败（含 git prepare 被 pnpm 白名单拦截）：官方方式装不上 = 插件仓库的问题，一律提 Issue
+  return 'repo'
+}
+
+/** 核心行特征：错误代码 / 生命周期脚本失败 / prepare 失败 / 描述性报错（子模块缺失、找不到等）/ 退出与宿主提示信息。 */
+const CORE_LINE_RE = /ERR_[A-Z_]+|ELIFECYCLE|Command failed|prepare-guard|Failed to prepare|exit code|\bprepare\b|pnpm failed in profile|git-hosted plugins build|submodule|not found|cannot find|no such|unable to|fatal|missing|error/i
+/** 提交 issue 时正文里错误摘要的上限字符数。GitHub 请求行上限 8192 字节，
+ * 固定模板与 URL 编码开销约 1~2K，核心错误（以 ASCII 日志为主）可安全带到 ~5K；
+ * 仍超长时 pluginIssueUrl 会逐档缩小核心预算，最终 URL 不会超限。 */
+export const MAX_CORE_CHARS = 5000
+/** 摘要里单行上限：允许构建 key 等长行也被截短。 */
+const MAX_LINE_CHARS = 400
+
+/**
+ * 核心错误收集器：从完整安装输出里挑出真正说明问题的行（错误代码、构建脚本失败、
+ * 退出与宿主提示），去重后拼接，单行与总量都截断 —— 只把「重点 + 原因」带进 issue 正文，
+ * 避免完整日志塞进 URL 导致请求过长。无关键行时退化为「头部 + 尾部」快照。
+ * maxChars 可由调用方按最终 URL 长度收紧（pluginIssueUrl 超限时逐档缩小）。
+ */
+export function summarizeError(message: string, maxChars: number = MAX_CORE_CHARS): string {
+  const seen = new Set<string>()
+  const core: string[] = []
+  for (const raw of message.split(/\r?\n/)) {
+    const line = raw.trim()
+    if (!line || !CORE_LINE_RE.test(line)) continue
+    const short = line.length > MAX_LINE_CHARS ? `${line.slice(0, MAX_LINE_CHARS)}…` : line
+    if (!seen.has(short)) {
+      seen.add(short)
+      core.push(short)
+    }
+  }
+  let out: string
+  if (core.length === 0) {
+    // 无关键行时退化为「头部 + 尾部」快照：优先保尾部完整，头部按预算压缩，总长不超上限
+    const tail = message.trimEnd().slice(-1000)
+    const sep = '\n…\n'
+    const headBudget = Math.max(maxChars - tail.length - sep.length, 0)
+    const head = message.slice(0, 500).trim()
+    out = `${head.length > headBudget ? head.slice(0, headBudget) : head}${sep}${tail}`
+  } else {
+    out = core.join('\n')
+  }
+  return out.length > maxChars ? `${out.slice(0, maxChars)}\n… (truncated)` : out
+}
+
+/** 提取首个错误代码（如 ERR_PNPM_PREPARE_PACKAGE），无则 null。 */
+export function coreErrorCode(message: string): string | null {
+  const m = message.match(/\[?ERR_[A-Z_]+\]?/)
+  return m ? m[0].replace(/^\[|\]$/g, '') : null
+}
+
+/** 运行时 localStorage 访问：类型上不依赖 DOM lib（Node 测试环境也能编译），浏览器里取 window。 */
+const storage = (): Storage | undefined =>
+  (globalThis as { localStorage?: Storage }).localStorage
+
+/** 读取本地通知记录（损坏/不可用时返回空列表，不抛错）。列表最新在前，全部保留，只由「清空」按钮手动移除。 */
+export function loadNotifications(): NotificationRecord[] {
+  try {
+    const raw = storage()?.getItem(KEY)
+    if (!raw) return []
+    const list = JSON.parse(raw) as unknown
+    if (!Array.isArray(list)) return []
+    return list
+      .filter((r): r is NotificationRecord =>
+        !!r && typeof r === 'object' && typeof (r as { message?: unknown }).message === 'string')
+      // 历史失败记录没有 ok 字段：缺省按失败渲染，保证旧数据照常可查
+      .map((r) => ({ ...r, ok: r.ok === true }))
+  } catch {
+    return []
+  }
+}
+
+function save(list: NotificationRecord[]): void {
+  try {
+    storage()?.setItem(KEY, JSON.stringify(list))
+  } catch {
+    /* storage full / unavailable：仅保留内存态，界面仍可查看 */
+  }
+}
+
+/** 追加一条通知记录并持久化，返回更新后的完整列表（最新在前，超上限裁剪）。
+ *  每次成功/失败都各自留痕：同一插件的安装/卸载记录都完整保留、只由「清空」按钮手动移除，
+ *  不会因后续操作被自动覆盖清除。 */
+export function addNotification(record: Omit<NotificationRecord, 'id' | 'at'>): NotificationRecord[] {
+  const prev = loadNotifications()
+  let id = Date.now()
+  while (prev.some((r) => r.id === id)) id += 1
+  const next = [{ ...record, id, at: id }, ...prev].slice(0, MAX)
+  save(next)
+  return next
+}
+
+/** 记录一次失败：携带完整错误日志，供通知中心查看/复制/提 Issue。 */
+export function addFailure(record: Omit<NotificationRecord, 'id' | 'at' | 'ok'>): NotificationRecord[] {
+  return addNotification({ ...record, ok: false })
+}
+
+/** 记录一次成功：轻量记录，不带日志。 */
+export function addSuccess(record: Omit<NotificationRecord, 'id' | 'at' | 'ok' | 'message'>): NotificationRecord[] {
+  return addNotification({ ...record, ok: true, message: '' })
+}
+
+/** 清空全部通知记录，返回空列表。 */
+export function clearNotifications(): NotificationRecord[] {
+  save([])
+  return []
+}

package/src/client/lib/format.ts

@@ -0,0 +1,22 @@
+/**
+ * Presentation formatters shared across the catalog list and the cards.
+ */
+import type { Translate } from '../types.ts'
+
+/** 星数/分支数的紧凑展示：<1k 原样；千级 1.2k；十万级取整。 */
+export function fmtStars(count?: number): string {
+  if (!count || count <= 0) return '0'
+  if (count < 1000) return String(count)
+  const k = count / 1000
+  return `${k >= 100 ? Math.round(k) : k.toFixed(1).replace(/\.0$/, '')}k`
+}
+
+/** 相对时间：今天 / N 天前 / N 个月前 / N 年前。 */
+export function relTime(iso: string | undefined, t: Translate): string {
+  if (!iso) return ''
+  const days = Math.floor((Date.now() - new Date(iso).getTime()) / 86400000)
+  if (days <= 0) return t('today')
+  if (days < 30) return t('daysAgo', { days })
+  if (days < 365) return t('monthsAgo', { months: Math.floor(days / 30) })
+  return t('yearsAgo', { years: Math.floor(days / 365) })
+}

package/src/client/locales.ts

@@ -1,27 +1,106 @@
 /** zh/en dictionaries for the DSH-Plugin Hub settings section. */
 export const zh = {
   nav: '插件中心',
-  title: 'DSH-Plugin Hub for DeepSeek Harness',
+  title: 'DSH-Plugin Hub',
   // 收录/精选数量由组件从官网 /api/stats.json 实时拉取填充（{total}/{verified}），不写死
-  tagline: 'DSH plugin 插件中心：收录 {total} 个 DeepSeek Harness 插件，人工精选验证 {verified}，每日更新 · 免费安装',
+  tagline: 'DSH-Plugin 插件中心：面向 DeepSeek Harness 插件收录平台，人工审验、来源可溯，免费安装',
   adBadge: '推荐',
-  ad: 'DSH-Plugin 插件中心：收录 {total} 个 DeepSeek Harness 插件，其中 {verified} 人工精选验证，每日更新，免费按分类浏览、搜索、下载与安装，人工验证、来源可溯',
+  // 紫色广告横幅：突出数量（显眼）+ 更新节奏，与 tagline 职责分开、不重复
+  ad: 'DSH-Plugin 插件中心：收录 {total} 款插件，{verified} 款人工精选验证，每日更新',
   search: '搜索插件名称、描述、标签…',
   all: '全部',
   sortStars: 'Star 最多',
+  sortForks: 'Fork 最多',
   sortUpdated: '最近更新',
   sortNewest: '最新收录',
-  open: '在浏览器中打开',
   openHint: '打开 dsh-plugin.org',
-  openBtn: 'DSH-Plugin 官网',
-  toEn: 'Switch to English',
+  toggleLangHint: '切换界面语言',
   fork: 'Fork',
   loading: '正在加载插件数据…',
   failed: '插件数据加载失败',
   failedDesc: '请稍后重试，或点击右上角按钮在浏览器中打开插件中心。',
   retry: '重试',
-  copy: '复制安装命令',
+  install: '安装',
   toastCopied: '安装命令已复制，去 dsh 终端粘贴即可安装',
+  installed: '已安装',
+  notInstalled: '未安装',
+  filterAllHint: '显示全部插件',
+  filterInstalledHint: '筛选当前分类下的已安装插件',
+  filterNotInstalledHint: '筛选当前分类下的未安装插件',
+  filterInstalledNone: '当前分类下没有已安装插件',
+  filterNotInstalledNone: '当前分类下没有未安装插件',
+  uninstall: '卸载',
+  uninstalling: '卸载中…',
+  uninstallTitle: '确认卸载',
+  uninstallDesc: '将从当前环境卸载该插件。',
+  uninstallDone: '卸载成功',
+  uninstallFail: '卸载失败，请稍后重试',
+  uninstallResultTitle: '卸载完成',
+  uninstallResultDesc: '插件已从当前环境移除。',
+  confirmTitle: '确认安装',
+  confirmDesc: '安装前请前往插件仓库仔细阅读源码，确认可信后再安装',
+  confirmPlugin: '插件',
+  confirmSource: '来源',
+  confirmCommand: '安装命令',
+  copyInstallCommand: '复制安装命令',
+  copyCmdLabel: '复制',
+  copyUninstallCommand: '复制卸载命令',
+  installNow: '直接安装',
+  installing: '安装中…',
+  installDone: '安装成功',
+  installResultTitle: '安装完成',
+  installResultDesc: '插件已安装。',
+  // 更新语义：已安装插件点「更新」走同一条 add 命令原位覆盖重装，弹窗文案区分安装/更新
+  confirmUpdateTitle: '确认更新',
+  updateNow: '直接更新',
+  updating: '更新中…',
+  queuedUpdateTitle: '已加入更新排队',
+  updateResultTitle: '更新完成',
+  updateResultDesc: '插件已更新到最新版本。',
+  installFail: '安装失败',
+  confirmCancel: '取消',
+  doneBtn: '完成',
+  // 结果视图：部分插件需重启后才挂载，提供「立即重启 / 稍后重启」选择
+  restartNow: '立即重启',
+  restartLater: '稍后重启',
+  restarting: '正在重启…',
+  restartHint: '部分插件（如插件市场、顶层 bundle）需重启后才会生效。',
+  // 待重启：装完没重启的插件常驻提醒，直到宿主真正重启
+  restartPendingHint: '安装成功，重启后生效',
+  restartPendingHintUninstall: '卸载成功，重启后移除',
+  sectionPendingRestart: '待重启',
+  sectionInProgress: '进行中',
+  // 串行队列：安装/卸载弹窗内可后台关闭，排队任务自动串行执行
+  queuedTitle: '已加入安装排队',
+  queuedUninstallTitle: '已加入卸载排队',
+  queuedHint: '已加入排队，前序任务完成后将自动开始，可关闭本窗口继续浏览。',
+  cancelTask: '取消任务',
+  cancelling: '正在取消…',
+  errorTitle: '操作失败',
+  errorTitleInstall: '安装失败',
+  errorTitleUninstall: '卸载失败',
+  errorPlugin: '插件',
+  errorClose: '知道了',
+  errorCopy: '复制错误信息',
+  errCopied: '错误信息已复制',
+  // 任务通知中心：安装/卸载的成败自动落盘，随时可回来查看
+  notifications: '通知',
+  // 通知入口按钮文字：工具栏空间有限，与弹窗标题（notifications）区分，短文案不截断
+  notificationsBtn: '通知',
+  notificationsHint: '查看安装/卸载通知（含失败记录）',
+  notificationsDesc: '安装、卸载任务的成败都会记录在这里，即使错过提示也能随时回来查看。',
+  notificationsEmpty: '暂无通知记录',
+  notificationsClear: '清空通知',
+  failCopy: '复制完整错误信息',
+  failIssueHint: '带着错误日志去作者仓库一键提交 Issue（正文含官网收录链接）',
+  failIssueBig: '一键提交 BUG 到 GitHub Issue 为开源作贡献',
+  // prepare 构建脚本实际执行失败（git 分发缺子模块/构建产物）：插件打包分发问题，应提 Issue
+  failPrepareHint: '该插件安装时的构建脚本执行失败（git 分发常缺失子模块或构建产物），属插件打包分发问题。请向作者仓库提交 Issue 反馈。',
+  // 安装前预检 / 装后校验拦截（[packaging]）：git 分发缺构建产物、入口文件不存在 = 插件未适配官方默认安装方式
+  failPackagingHint: '该插件不支持官方默认安装方式：其 git 分发缺少构建产物（package.json 声明的入口文件在仓库中不存在），说明作者未适配官方安装流程。请到作者仓库提交 Issue 反馈，请其提交构建产物或发布 npm 版。',
+  // 原生依赖构建脚本被 pnpm 默认拦截（如 node-pty 的 ERR_PNPM_IGNORED_BUILDS）：只影响带原生模块的插件，属插件依赖打包问题，应提 Issue
+  failIgnoredBuild: '该插件依赖了需要编译的原生模块（如 node-pty），pnpm 默认拦截这类构建脚本导致安装失败 —— 其他插件不受影响，属该插件的依赖/打包问题。建议向作者仓库一键反馈，请作者改用预编译版本（如 node-pty-prebuilt-multiarch）。',
+  reportIssue: '去插件仓库提交 Issue',
   detail: '打开详情',
   noResult: '没有找到匹配的插件',
   noResultDesc: '换个关键词试试，或前往网站浏览全部插件。',
@@ -29,38 +108,121 @@ export const zh = {
   daysAgo: '更新于 {days} 天前',
   monthsAgo: '更新于 {months} 个月前',
   yearsAgo: '更新于 {years} 年前',
-  pluginsTotal: '共 {n} 个插件',
-  filteredCount: '匹配 {n} 个',
+  pluginsTotal: '结果 {n} 条插件',
+  // 分类按钮不带数量，选中分类后在列表头部显示筛选结果数
+  filterResults: '结果 {n} 条插件',
   more: '还有 {n} 个插件，去网站查看全部',
   browseAll: '浏览全部 {n} 个插件',
   verified: '已验证',
+  // 版本与更新：有 release 比版本号；无 release 的仓库比仓库最近更新时间（有新提交即提示更新）
+  version: '版本',
+  update: '可更新',
+  updateAvailable: '有更新',
+  updateAvailableHint: '检测到更新：有版本号的仓库比对版本号，无版本号的仓库比对仓库最近更新时间',
   empty: '该分类暂无插件',
   dataFrom: '数据源 dsh-plugin.org · 每日人工更新',
 }
 
 export const en = {
   nav: 'Plugin Hub',
-  title: 'DSH-Plugin Hub for DeepSeek Harness',
+  title: 'DSH-Plugin Hub',
   // Plugin counts are filled from the live /api/stats.json ({total}/{verified}), never hardcoded
-  tagline: 'DSH plugin marketplace · {total} DeepSeek Harness plugins indexed · {verified} human-verified · updated daily · free to install',
+  tagline: 'DSH-Plugin Hub: a human-verified, free marketplace for DeepSeek Harness plugins',
   adBadge: 'Featured',
-  ad: 'DSH-Plugin Hub: {total} DeepSeek Harness plugins indexed, {verified} of which are human-verified. Updated daily — browse, search & install for free.',
+  ad: 'DSH-Plugin Hub: {total} plugins indexed, {verified} human-verified, updated daily',
   search: 'Search plugins by name, description, tags…',
   all: 'All',
   sortStars: 'Most stars',
+  sortForks: 'Most forks',
   sortUpdated: 'Recently updated',
   sortNewest: 'Newest added',
-  open: 'Open in browser',
   openHint: 'Open dsh-plugin.org',
-  openBtn: 'dsh-plugin.org',
-  toZh: 'Switch to Chinese',
+  toggleLangHint: 'Switch language',
+  githubHint: 'View source on GitHub',
   fork: 'Fork',
   loading: 'Loading plugin data…',
   failed: 'Failed to load plugin data',
   failedDesc: 'Please retry, or open the hub in your browser with the button above.',
   retry: 'Retry',
-  copy: 'Copy install command',
+  install: 'Install',
   toastCopied: 'Install command copied — paste it in your dsh terminal',
+  installed: 'Installed',
+  notInstalled: 'Not installed',
+  filterAllHint: 'Show all plugins',
+  filterInstalledHint: 'Filter to installed plugins in this category',
+  filterNotInstalledHint: 'Filter to uninstalled plugins in this category',
+  filterInstalledNone: 'No installed plugins in this category',
+  filterNotInstalledNone: 'No uninstalled plugins in this category',
+  uninstall: 'Uninstall',
+  uninstalling: 'Removing…',
+  uninstallTitle: 'Confirm uninstall',
+  uninstallDesc: 'The plugin will be removed from this environment.',
+  uninstallDone: 'Uninstalled',
+  uninstallFail: 'Removal failed — try again',
+  uninstallResultTitle: 'Removed',
+  uninstallResultDesc: 'The plugin has been removed from this environment.',
+  confirmTitle: 'Confirm install',
+  confirmDesc: 'Review the plugin repository source code carefully before installing.',
+  confirmPlugin: 'Plugin',
+  confirmSource: 'Source',
+  confirmCommand: 'Command',
+  copyInstallCommand: 'Copy install command',
+  copyCmdLabel: 'Copy',
+  copyUninstallCommand: 'Copy uninstall command',
+  installNow: 'Install',
+  installing: 'Installing…',
+  installDone: 'Installed',
+  installResultTitle: 'Installed',
+  installResultDesc: 'The plugin has been installed.',
+  // Update semantics: the "update" action re-runs add in place — copy differentiates install vs update
+  confirmUpdateTitle: 'Confirm update',
+  updateNow: 'Update',
+  updating: 'Updating…',
+  queuedUpdateTitle: 'Queued for update…',
+  updateResultTitle: 'Updated',
+  updateResultDesc: 'The plugin has been updated to the latest version.',
+  installFail: 'Install failed — copy the command instead',
+  confirmCancel: 'Cancel',
+  doneBtn: 'Done',
+  // Result view: some plugins need a restart to mount — offer restart now / later
+  restartNow: 'Restart now',
+  restartLater: 'Later',
+  restarting: 'Restarting…',
+  restartHint: 'Some plugins (such as plugin markets / top-level bundles) only take effect after a restart.',
+  restartPendingHint: 'Installed — takes effect after restart',
+  restartPendingHintUninstall: 'Removed — cleaned up after restart',
+  sectionPendingRestart: 'Pending restart',
+  sectionInProgress: 'In progress',
+  queuedTitle: 'Queued…',
+  queuedUninstallTitle: 'Queued for removal…',
+  queuedHint: 'Queued — starts automatically after earlier tasks finish. You may close this window.',
+  cancelTask: 'Cancel task',
+  cancelling: 'Cancelling…',
+  errorTitle: 'Operation failed',
+  errorTitleInstall: 'Install failed',
+  errorTitleUninstall: 'Removal failed',
+  errorPlugin: 'Plugin',
+  errorClose: 'Got it',
+  errorCopy: 'Copy error',
+  errCopied: 'Error copied',
+  // Task notification center: install/remove results are auto-logged, viewable later
+  notifications: 'Notifications',
+  // Entry button label: toolbar space is tight, keep it short so it never truncates; the modal title stays full
+  notificationsBtn: 'Notice',
+  notificationsHint: 'View install/remove notifications (including failures)',
+  notificationsDesc: 'Every install and remove result is logged here — even if you missed the prompt, you can always check back.',
+  notificationsEmpty: 'No notifications yet',
+  notificationsClear: 'Clear notifications',
+  failCopy: 'Copy full log',
+  failIssueHint: 'Open a pre-filled issue on the author repo with this error log (includes catalog links)',
+  failIssueBig: 'Report this bug to GitHub — contribute to open source',
+  // prepare script actually failed (git tarball misses submodules/build output): a packaging issue of the plugin itself — file an issue
+  failPrepareHint: 'This plugin failed while running its build scripts during install (git tarballs often miss submodules or build output). This is a packaging issue of the plugin itself — please report it to the author repository.',
+  // Pre-install / post-install guard hit ([packaging]): git distribution lacks build output, entry file missing = not adapted to the official default install method
+  failPackagingHint: 'This plugin does not support the official default install method: its git distribution lacks the build output (the entry file declared in package.json is not in the repository), so it has not been adapted to the official install flow. Please file an Issue on the author\'s repo asking for committed build output or an npm release.',
+  // native-module build scripts ignored by pnpm by default (e.g. node-pty, ERR_PNPM_IGNORED_BUILDS): only affects plugins with native deps — a dependency/packaging issue of the plugin itself, file an issue
+  failIgnoredBuild: 'This plugin depends on a native module (e.g. node-pty) whose build script pnpm blocks by default, so the install fails — other plugins are unaffected. This is a dependency/packaging issue of the plugin itself. Please report it to the author repository and ask the author to switch to a prebuilt variant (e.g. node-pty-prebuilt-multiarch).',
+  reportIssue: 'Report an Issue to the plugin repo',
   detail: 'Open details',
   noResult: 'No plugins match your search',
   noResultDesc: 'Try another keyword, or browse all plugins on the website.',
@@ -68,11 +230,17 @@ export const en = {
   daysAgo: 'updated {days}d ago',
   monthsAgo: 'updated {months}mo ago',
   yearsAgo: 'updated {years}y ago',
-  pluginsTotal: '{n} plugins',
-  filteredCount: '{n} matched',
+  pluginsTotal: 'Results: {n} plugins',
+  // Category chips carry no counts; the filtered result count shows in the list header
+  filterResults: 'Results: {n} plugins',
   more: '{n} more on the website',
   browseAll: 'Browse all {n} plugins',
   verified: 'Verified',
+  // Version & updates: repos with a release are compared by tag; repos without one by last push time (new commits → update)
+  version: 'Version',
+  update: 'Update',
+  updateAvailable: 'Update available',
+  updateAvailableHint: 'An update was detected: repos with a release are compared by tag, repos without one by last push time',
   empty: 'No plugins in this category yet',
   dataFrom: 'Data from dsh-plugin.org · curated daily',
 }

package/src/client/styles/Dropdown.module.css

@@ -0,0 +1,123 @@
+/* 自绘下拉（替换原生 <select>）。颜色跟随宿主主题：经 --hub-* 设计令牌解析，
+ * 与 Header 的控件（排序/分段）保持一致的无边框 + 圆角语言。 */
+.dropdown {
+  position: relative;
+  display: inline-flex;
+  flex-shrink: 0;
+}
+
+.dropdownBtn {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  height: 24px;
+  padding: 0 8px;
+  font-size: 12px;
+  line-height: 22px;
+  color: var(--hub-text-primary);
+  background: transparent;
+  border: none;
+  border-radius: 6px;
+  cursor: pointer;
+  user-select: none;
+  white-space: nowrap;
+  transition: background 120ms ease;
+}
+
+.dropdownBtn:hover {
+  background: var(--hub-bg-hover);
+}
+
+.dropdownLabel {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.dropdownArrow,
+.dropdownArrowOpen {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  color: var(--hub-text-tertiary);
+  transition: transform 120ms ease;
+}
+
+.dropdownArrowOpen {
+  transform: rotate(180deg);
+}
+
+.dropdownPanel {
+  position: absolute;
+  top: calc(100% + 4px);
+  left: 0;
+  z-index: 50;
+  min-width: 100%;
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  padding: 4px;
+  background: var(--hub-bg-1);
+  border: 1px solid var(--hub-border-2);
+  border-radius: 8px;
+  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.14);
+}
+
+.dropdownItem,
+.dropdownItemActive {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 10px;
+  font-size: 12px;
+  line-height: 18px;
+  border: none;
+  border-radius: 6px;
+  padding: 4px 9px;
+  cursor: pointer;
+  user-select: none;
+  white-space: nowrap;
+  text-align: left;
+  transition: background 120ms ease, color 120ms ease;
+}
+
+.dropdownItem {
+  color: var(--hub-text-primary);
+  background: transparent;
+}
+
+/* 悬浮选项：明显加重底色，保证「看得见、点得准」。 */
+.dropdownItem:hover {
+  background: var(--hub-bg-hover);
+}
+
+.dropdownItemActive {
+  color: var(--hub-text-on-fill);
+  background: var(--hub-btn-fill);
+}
+
+.dropdownItemLabel {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.dropdownCount,
+.dropdownCountActive {
+  font-size: 10px;
+  line-height: 14px;
+  border-radius: 999px;
+  padding: 0 6px;
+  min-width: 16px;
+  text-align: center;
+}
+
+.dropdownCount {
+  color: var(--hub-text-tertiary);
+  background: var(--hub-bg-btn);
+}
+
+.dropdownItemActive .dropdownCountActive {
+  color: var(--hub-text-on-fill);
+  background: var(--hub-bg-on-fill);
+}