dsh-plugin 1.0.0 → 1.1.1

package/src/client/lib/catalog.ts

@@ -11,6 +11,36 @@ export const SITE_URL = 'https://dsh-plugin.org/'
 /** 插件中心源码仓库：头部右上角 GitHub 图标的跳转地址 */
 export const GITHUB_URL = 'https://github.com/dshplugin/dsh-plugin-hub'
 
+/** Hub 自身在目录数据里的仓库标识：头部版本号旁的「可更新」徽标按它定位自己。 */
+export const HUB_REPO = 'dshplugin/dsh-plugin-hub'
+
+/**
+ * Hub 自我更新版本控制中心（Cloudflare Worker：dsh-update）。
+ * 发新版后向 Worker 管理接口写入最新版本 + Markdown 变更记录（见
+ * dsh-update-worker 的 POST /admin/hub），所有已装用户的「可更新」徽标即时出现，
+ * 不再依赖主站目录数据管道（每日刷新 + 重建站点）。
+ * 响应：{ version: string | null, publishedAt: string | null, notes: string | {zh,en} | null }
+ */
+export const HUB_UPDATE_URL = 'https://hub.dsh-plugin.org/hub'
+
+/** Worker 版本控制中心返回的 Hub 自我更新信息（notes 为 Markdown 变更记录）。 */
+export interface HubUpdateInfo {
+  version: string
+  publishedAt?: string | null
+  /** Markdown 变更记录；可传字符串，或 { zh, en } 双语言对象按界面语言取 */
+  notes?: string | Record<string, string> | null
+}
+
+/** Worker「关注我们」内容接口（同款 Worker，key = hub:about，Markdown 推送非写死）。 */
+export const HUB_ABOUT_URL = 'https://hub.dsh-plugin.org/about'
+
+/** Worker 返回的「关注我们」内容（content 为 Markdown，可字符串或 {zh,en} 双语言对象）。 */
+export interface HubAboutInfo {
+  /** Markdown 平台介绍 + 反馈群二维码；可传字符串，或 { zh, en } 双语言对象按界面语言取 */
+  content?: string | Record<string, string> | null
+  updatedAt?: string | null
+}
+
 /** 构建时由 tsdown 从 package.json 注入的插件版本号（见 tsdown.config.ts define）。 */
 declare const __PLUGIN_VERSION__: string
 
@@ -46,19 +76,21 @@ export function pluginSiteUrl(repo: string): string {
 
 /**
  * 一键反馈 GitHub Issue 的预填链接：标题带「来自 dsh-plugin.org」标识，正文只带
- * 核心信息 —— 原因判定 + 关键错误代码 + 宿主机器环境快照 + 错误核心摘要（完整日志
- * 太长，塞进 URL 会被 GitHub 以「request URL too long」拒绝，故只收集重点）。
- * 错误弹窗、失败记录共用此逻辑。
+ * 核心信息 —— 原因判定 + 关键错误代码 + 尝试过的安装方式 + 宿主机器环境快照 +
+ * 错误核心摘要（完整日志太长，塞进 URL 会被 GitHub 以「request URL too long」拒绝，
+ * 故只收集重点）。错误弹窗、失败记录共用此逻辑。
  * env 取不到时为 null，链接照常生成、只是少环境段。
+ * attempts（尝试过的安装方式，npm 反查 + 实际执行命令）：作者看到我们查过/试过的命令，
+ * 组织 scope 与 GitHub 用户名不一致时也能直接指认正确的 npm 包名。
  */
-export function pluginIssueUrl(repo: string, message: string, env?: EnvInfo | null): string {
+export function pluginIssueUrl(repo: string, message: string, env?: EnvInfo | null, command?: string, attempts?: string[]): string {
   const title = `[dsh-plugin.org | dsh-plugin-hub] Install/Remove failed: ${repo}`
   // 原因判定：让作者一眼知道这是不是自己插件的问题。
-  // [packaging]（预检/装后校验拦截）单独列：点明「不支持官方默认安装方式」，并写清官方默认方式
-  // 是什么（git 直装要求仓库提交构建产物或提供 prepare 脚本），作者照此适配即可。
+  // [packaging]（预检/装后校验拦截）单独列：无论走 npm 还是 git 通道，都是分发物不完整
+  // （package.json 声明的入口文件在发布物里缺失），作者照此补齐即可。
   const kind = classifyFailure(message)
   const reason = /\[packaging\]/i.test(message)
-    ? 'plugin does NOT support the official default install method (dsh plugin add github:owner/repo — requires build output committed to the repo or a prepare script); its git distribution lacks the entry file declared in package.json'
+    ? 'plugin distribution is incomplete — the entry file declared in package.json is missing from the published package (github tarball or npm package); please commit build output or publish a complete package'
       : kind === 'pluginPrepare'
         ? 'plugin prepare/build script failed during install (packaging/distribution issue)'
         : kind === 'pnpmIgnoredBuild'
@@ -72,17 +104,23 @@ export function pluginIssueUrl(repo: string, message: string, env?: EnvInfo | nu
       `- Cause: ${reason}`,
       ...(code ? [`- Key error: \`${code}\``] : []),
       '',
-      // 来源说明：标题（链官网）+ 一句来源（链仓库）+ 实际执行的官方安装命令（含 --profile）与执行结果，链接由常量动态拼接
+      // 来源说明：标题（链官网）+ 一句来源（链仓库）+ 实际执行的安装命令（含 --profile）与执行结果，链接由常量动态拼接
       `## [DSH-Plugin 插件中心](${SITE_URL}) · 安装 Plugin 失败错误信息`,
       `本错误信息由 [dsh-plugin-hub](${GITHUB_URL}) 插件中心的安装程序自动生成，随本次安装失败一并提交。`,
-      `- 使用的安装命令（官方默认安装方式）：\`dsh plugin${env?.profile ? ` --profile ${env.profile}` : ''} add github:${repo}\``,
+      `- 实际执行的安装命令：\`${command ?? `dsh plugin${env?.profile ? ` --profile ${env.profile}` : ''} add github:${repo}`}\``,
       `- 执行结果：安装失败，未能安装该插件。`,
-      // [packaging] 场景：向作者说明官方默认安装方式具体是什么，请其按该方式适配（提交构建产物或提供 prepare 脚本）
+      // 尝试过的安装方式（npm 反查 + 实际执行命令，按先后顺序）：作者据此反推正确的
+      // npm 包名 —— 组织 scope 与 GitHub 用户名不一致时仅凭仓库名猜不到，作者看到我们
+      // 查过/试过的命令就能直接指认
+      ...(attempts && attempts.length > 0
+        ? ['', '## Attempted install channels（已尝试的安装方式）', ...attempts.map((a) => `- ${a}`)]
+        : []),
+      // [packaging] 场景：说明两种官方安装通道（npm 包 / git 直装），当前插件在对应通道下分发不完整
       ...(/\[packaging\]/i.test(message)
         ? [
           '',
-          '## 官方默认安装方式',
-          'DSH 生态的官方默认安装方式是 `dsh plugin add github:owner/repo`（git 直装）：插件仓库需提交构建产物，或在 package.json 提供 `prepare` 脚本让 pnpm 安装时自动构建。当前插件两者皆不具备，因此无法按官方方式安装。',
+          '## 安装方式说明',
+          'DSH 插件支持两种官方安装通道：`dsh plugin add <npm-package>`（npm 分发，需发布完整构建产物）与 `dsh plugin add github:owner/repo`（git 直装，仓库需提交构建产物或在 package.json 提供 `prepare` 脚本）。当前插件的分发物缺少 package.json 声明的入口文件，请按所用通道补齐后重新发布。',
         ]
         : []),
       '',
@@ -156,7 +194,17 @@ export function normalize(raw: Record<string, unknown>): HubPlugin {
       topics: Array.isArray(raw.t) ? (raw.t as string[]) : undefined,
       features: Array.isArray(raw.f) ? (raw.f as string[]) : undefined,
       description: typeof raw.d === 'string' ? raw.d : undefined,
-      source: typeof raw.r === 'string' ? { repo: raw.r } : undefined,
+      // 投影输出两种形态：老数据 source 是 repo 字符串；新数据是 { repo, npmPackage }
+      source: typeof raw.r === 'string'
+        ? { repo: raw.r }
+        : raw.r !== null && typeof raw.r === 'object'
+          ? {
+            repo: typeof (raw.r as { repo?: unknown }).repo === 'string' ? (raw.r as { repo: string }).repo : undefined,
+            npmPackage: typeof (raw.r as { npmPackage?: unknown }).npmPackage === 'string' ? (raw.r as { npmPackage: string }).npmPackage : undefined,
+          }
+          : undefined,
+      // 能否网页一键安装：API 仅在 false 时下发 wi（缺省视为 true），据此禁用一键安装、只提示命令行
+      install: raw.wi === false ? { webInstallable: false } : undefined,
       compatibility: typeof raw.v === 'string' ? { status: raw.v } : undefined,
       dates: {
         repoUpdatedAt: typeof raw.u === 'string' ? raw.u : undefined,
@@ -171,6 +219,26 @@ export function normalize(raw: Record<string, unknown>): HubPlugin {
   return raw as unknown as HubPlugin
 }
 
+/**
+ * 安装通道决策（用户无感知）：目录探测到 npm 包名 → 用 npm 包名安装
+ * （走 npm registry tarball，更快、与 GitHub 网络无关）；无 npm 包名 → git 直装。
+ * 返回值 target 即传给后端 /install 的安装目标（npm 包名 或 owner/repo）。
+ */
+export function installTargetOf(p: HubPlugin): { target: string; via: 'npm' | 'github' } {
+  const pkg = (p.source?.npmPackage ?? '').trim()
+  const repo = (p.source?.repo ?? '').trim()
+  if (pkg && repo) return { target: pkg, via: 'npm' }
+  return { target: repo, via: 'github' }
+}
+
+/** 展示用安装命令（复制/弹窗）：npm 通道显示包名，git 通道显示 github: 源。 */
+export function installCommandOf(p: HubPlugin, withProfile = false): string {
+  const { target, via } = installTargetOf(p)
+  return via === 'npm'
+    ? `dsh plugin${withProfile ? ' --profile web' : ''} add ${target}`
+    : `dsh plugin${withProfile ? ' --profile web' : ''} add github:${target}`
+}
+
 export const CATEGORY_LABELS: Record<string, { zh: string; en: string }> = {
   interface: { zh: '界面与体验', en: 'UI & Experience' },
   session: { zh: '会话与消息', en: 'Sessions & Messages' },

package/src/client/lib/failures.ts

@@ -16,6 +16,10 @@ export interface NotificationRecord {
   repo: string
   /** 失败时的完整错误日志；成功记录为空串 */
   message: string
+  /** 实际执行的安装/卸载命令（issue 预填时如实展示）；历史记录可能缺失 */
+  command?: string
+  /** 尝试过的安装方式（npm registry 反查 + 实际执行命令，按先后顺序）：失败提 Issue 时贴给作者，便于反推正确的 npm 包名 */
+  attempts?: string[]
   /** 结束时间（epoch ms） */
   at: number
 }
@@ -27,7 +31,8 @@ export type FailureKind = 'pnpmIgnoredBuild' | 'pluginPrepare' | 'repo'
 
 /**
  * 失败归类，三态。无论底层机制如何（pnpm 白名单拦截 / 构建脚本被忽略 / prepare 失败），
- * 对用户而言结果都一样 —— 用官方默认安装方式装不上，就是插件仓库的问题，一律引导提 Issue：
+ * 对用户而言结果都一样 —— 当前安装通道（npm 或 git）装不上，就是插件分发/依赖的问题，
+ * 一律引导提 Issue：
  * - pnpmIgnoredBuild：插件依赖里的原生模块构建脚本被 pnpm 默认拦截（如 node-pty，
  *   `ERR_PNPM_IGNORED_BUILDS`）。只影响带原生模块的插件，其他插件不受影响 —— 差异在
  *   插件的依赖选择，属插件依赖/打包问题 → 引导去仓库提 Issue（建议改用预编译版本）
@@ -44,7 +49,7 @@ export function classifyFailure(message: string): FailureKind {
   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
+  // 其余失败（含 git prepare 被 pnpm 白名单拦截）：当前通道装不上 = 插件分发/依赖的问题，一律提 Issue
   return 'repo'
 }
 
@@ -151,3 +156,10 @@ export function clearNotifications(): NotificationRecord[] {
   save([])
   return []
 }
+
+/** 按 id 删除单条通知记录，返回更新后的列表（仅移除该条，不影响其余记录）。 */
+export function removeNotification(id: number): NotificationRecord[] {
+  const next = loadNotifications().filter((r) => r.id !== id)
+  save(next)
+  return next
+}

package/src/client/lib/renderMarkdown.ts

@@ -0,0 +1,116 @@
+/**
+ * 轻量 Markdown 渲染器：仅用于 Hub 自我更新的变更记录（Worker 下发的 notes）。
+ *
+ * 内容由插件作者自己编写、属可信内容，但渲染端仍先整体 HTML 转义，再按
+ * Markdown 语法输出结构，杜绝任何未转义的原始 HTML 注入；链接仅放行 http(s)。
+ *
+ * 支持：标题(#~####)、有序/无序列表、代码块(```)、行内代码、加粗、斜体、
+ * 链接、图片(![alt](url)，如反馈群二维码)、引用(>)、段落；其余语法一律按
+ * 纯文本处理，不引入外部依赖。图片仅放行 http(s)，限定最大宽度不撑破弹窗。
+ */
+
+/** HTML 转义：所有文本先进这里，再进入结构变换，保证输出里没有未转义的用户输入。 */
+function escapeHtml(s: string): string {
+  return s
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#39;')
+}
+
+/** 行内变换：链接 / 加粗 / 斜体 / 行内代码（代码先占位保护，最后还原）。 */
+function inline(s: string): string {
+  let out = escapeHtml(s)
+  // 行内代码先占位：避免其中的 * [ ] 被后续链接/加粗/斜体规则破坏
+  const codeSpans: string[] = []
+  out = out.replace(/`([^`]+)`/g, (_m, code) => {
+    codeSpans.push(String(code))
+    return `\u0000${codeSpans.length - 1}\u0000`
+  })
+  // 图片 ![alt](url)：仅放行 http(s)，用于展示反馈群二维码等；limited by CSS
+  out = out.replace(/!\[([^\]]*)\]\(([^)\s]+)\)/g, (m, alt, url) =>
+    /^https?:\/\//i.test(String(url)) && !/[\u0000]/.test(String(url))
+      ? `<img src="${String(url)}" alt="${String(alt)}" loading="lazy">`
+      : m,
+  )
+  // 链接 [text](url)：仅放行 http(s)，新窗口打开
+  out = out.replace(/\[([^\]]+)\]\(([^)\s]+)\)/g, (m, text, url) =>
+    /^https?:\/\//i.test(String(url)) && !/[\u0000]/.test(String(url))
+      ? `<a href="${String(url)}" target="_blank" rel="noopener noreferrer">${String(text)}</a>`
+      : m,
+  )
+  out = out.replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>')
+  out = out.replace(/(^|[^*])\*([^*]+)\*/g, '$1<em>$2</em>')
+  return out.replace(/\u0000(\d+)\u0000/g, (_m, idx) => `<code>${codeSpans[Number(idx)]}</code>`)
+}
+
+/** 把变更记录 Markdown 渲染为安全的 HTML 字符串（由弹窗用 dangerouslySetInnerHTML 注入）。 */
+export function renderMarkdown(md: string): string {
+  const lines = md.replace(/\r\n?/g, '\n').split('\n')
+  const blocks: string[] = []
+  let i = 0
+  while (i < lines.length) {
+    const line = lines[i]
+    // 围栏代码块
+    if (/^\s*```/.test(line)) {
+      const buf: string[] = []
+      i++
+      while (i < lines.length && !/^\s*```/.test(lines[i])) {
+        buf.push(lines[i])
+        i++
+      }
+      i++ // 跳过闭合围栏
+      blocks.push(`<pre><code>${escapeHtml(buf.join('\n'))}</code></pre>`)
+      continue
+    }
+    // 空行：段落分隔符
+    if (line.trim() === '') {
+      i++
+      continue
+    }
+    // 标题：# 到 #### 映射为 h2~h5（弹窗标题用 modalTitle，不与其冲突）
+    const heading = line.match(/^(#{1,4})\s+(.*)/)
+    if (heading) {
+      const level = heading[1].length + 1
+      blocks.push(`<h${level}>${inline(heading[2])}</h${level}>`)
+      i++
+      continue
+    }
+    // 有序 / 无序列表（连续收集为一个列表块）
+    if (/^\s*[-*+]\s+/.test(line) || /^\s*\d+[.)]\s+/.test(line)) {
+      const ordered = /^\s*\d+[.)]\s+/.test(line)
+      const items: string[] = []
+      while (i < lines.length && (/^\s*[-*+]\s+/.test(lines[i]) || /^\s*\d+[.)]\s+/.test(lines[i]))) {
+        items.push(`<li>${inline(lines[i].replace(/^\s*[-*+]|\s*\d+[.)]\s*/, '').trim())}</li>`)
+        i++
+      }
+      blocks.push(`<${ordered ? 'ol' : 'ul'}>${items.join('')}</${ordered ? 'ol' : 'ul'}>`)
+      continue
+    }
+    // 引用
+    if (/^\s*>\s?/.test(line)) {
+      const buf: string[] = []
+      while (i < lines.length && /^\s*>\s?/.test(lines[i])) {
+        buf.push(inline(lines[i].replace(/^\s*>\s?/, '')))
+        i++
+      }
+      blocks.push(`<blockquote>${buf.join('<br>')}</blockquote>`)
+      continue
+    }
+    // 普通段落：收集连续非空、非特殊开头的行
+    const buf: string[] = []
+    while (
+      i < lines.length
+      && lines[i].trim() !== ''
+      && !/^\s*```/.test(lines[i])
+      && !/^#{1,4}\s+/.test(lines[i])
+      && !/^\s*([-*+]|\d+[.)])\s+/.test(lines[i])
+    ) {
+      buf.push(inline(lines[i]))
+      i++
+    }
+    blocks.push(`<p>${buf.join('<br>')}</p>`)
+  }
+  return blocks.join('')
+}

package/src/client/locales.ts

@@ -21,6 +21,9 @@ export const zh = {
   failedDesc: '请稍后重试，或点击右上角按钮在浏览器中打开插件中心。',
   retry: '重试',
   install: '安装',
+  // AI 识别可能需要命令行辅助的插件（webInstallable=false）：仍可尝试一键安装，失败时复制命令去 dsh 终端
+  cliOnlyHint: '此插件可能需命令行辅助，失败时复制上方命令到 dsh 终端',
+  failedCopyHint: '安装失败。请复制上方安装命令到 dsh 终端手动执行（原生依赖构建脚本可能需要人工放行，如 pnpm approve-builds）',
   toastCopied: '安装命令已复制，去 dsh 终端粘贴即可安装',
   installed: '已安装',
   notInstalled: '未安装',
@@ -48,8 +51,8 @@ export const zh = {
   installNow: '直接安装',
   installing: '安装中…',
   installDone: '安装成功',
-  installResultTitle: '安装完成',
-  installResultDesc: '插件已安装。',
+  installResultTitle: '插件安装成功',
+  installResultDesc: '',
   // 更新语义：已安装插件点「更新」走同一条 add 命令原位覆盖重装，弹窗文案区分安装/更新
   confirmUpdateTitle: '确认更新',
   updateNow: '直接更新',
@@ -65,6 +68,7 @@ export const zh = {
   restartLater: '稍后重启',
   restarting: '正在重启…',
   restartHint: '部分插件（如插件市场、顶层 bundle）需重启后才会生效。',
+  done: '完成',
   // 待重启：装完没重启的插件常驻提醒，直到宿主真正重启
   restartPendingHint: '安装成功，重启后生效',
   restartPendingHintUninstall: '卸载成功，重启后移除',
@@ -91,6 +95,7 @@ export const zh = {
   notificationsDesc: '安装、卸载任务的成败都会记录在这里，即使错过提示也能随时回来查看。',
   notificationsEmpty: '暂无通知记录',
   notificationsClear: '清空通知',
+  removeNotification: '删除这条通知',
   failCopy: '复制完整错误信息',
   failIssueHint: '带着错误日志去作者仓库一键提交 Issue（正文含官网收录链接）',
   failIssueBig: '一键提交 BUG 到 GitHub Issue 为开源作贡献',
@@ -119,6 +124,22 @@ export const zh = {
   update: '可更新',
   updateAvailable: '有更新',
   updateAvailableHint: '检测到更新：有版本号的仓库比对版本号，无版本号的仓库比对仓库最近更新时间',
+  hubUpdateHint: '检测到 DSH-Plugin Hub 新版本，点击查看更新内容并更新',
+  hubUpdateTitle: 'DSH-Plugin Hub 有新版本',
+  hubUpdateDesc: 'v{version} 已发布，点击下方按钮即可更新，完成后需重启宿主生效。',
+  hubUpdatePublished: '发布于',
+  hubUpdateNotes: '更新记录',
+  hubUpdateLater: '稍后再说',
+  versionHint: '查看版本信息与更新记录',
+  hubCurrentTitle: '当前版本',
+  hubCurrentDesc: '你正在使用 v{version}，已是最新版本。',
+  hubUpToDate: '已是最新版本',
+  // 头部「关注我们」弹窗：平台介绍 + 用户反馈群二维码（内容由 Worker /about Markdown 推送，非写死）
+  followUs: '关注我们',
+  aboutTitle: '关注我们',
+  aboutDesc: '了解 DSH-Plugin Hub 是做什么的，加入用户反馈群随时交流。',
+  aboutEmpty: '内容暂未发布，敬请期待。',
+  aboutUpdated: '更新于',
   empty: '该分类暂无插件',
   dataFrom: '数据源 dsh-plugin.org · 每日人工更新',
 }
@@ -145,6 +166,10 @@ export const en = {
   failedDesc: 'Please retry, or open the hub in your browser with the button above.',
   retry: 'Retry',
   install: 'Install',
+  // AI-flagged plugins that may need command-line help (webInstallable=false): one-click install still allowed,
+  // on failure the user is guided to copy the command into the dsh terminal
+  cliOnlyHint: 'This plugin may need command-line help; if it fails, copy the command above and run it in your dsh terminal',
+  failedCopyHint: 'Install failed. Copy the command above and run it manually in your dsh terminal (native build scripts may need manual approval, e.g. pnpm approve-builds)',
   toastCopied: 'Install command copied — paste it in your dsh terminal',
   installed: 'Installed',
   notInstalled: 'Not installed',
@@ -172,8 +197,8 @@ export const en = {
   installNow: 'Install',
   installing: 'Installing…',
   installDone: 'Installed',
-  installResultTitle: 'Installed',
-  installResultDesc: 'The plugin has been installed.',
+  installResultTitle: 'Plugin installed successfully',
+  installResultDesc: '',
   // Update semantics: the "update" action re-runs add in place — copy differentiates install vs update
   confirmUpdateTitle: 'Confirm update',
   updateNow: 'Update',
@@ -189,6 +214,7 @@ export const en = {
   restartLater: 'Later',
   restarting: 'Restarting…',
   restartHint: 'Some plugins (such as plugin markets / top-level bundles) only take effect after a restart.',
+  done: 'Done',
   restartPendingHint: 'Installed — takes effect after restart',
   restartPendingHintUninstall: 'Removed — cleaned up after restart',
   sectionPendingRestart: 'Pending restart',
@@ -213,6 +239,7 @@ export const en = {
   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',
+  removeNotification: 'Remove this notification',
   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',
@@ -241,6 +268,22 @@ export const en = {
   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',
+  hubUpdateHint: 'A new DSH-Plugin Hub version is available — click to view the changelog and update',
+  hubUpdateTitle: 'A new DSH-Plugin Hub version is available',
+  hubUpdateDesc: 'v{version} has been released — click below to update, then restart the host to apply it.',
+  hubUpdatePublished: 'Published',
+  hubUpdateNotes: "What's new",
+  hubUpdateLater: 'Later',
+  versionHint: 'View version info and changelog',
+  hubCurrentTitle: 'Current version',
+  hubCurrentDesc: 'You are on v{version} — this is the latest version.',
+  hubUpToDate: 'Up to date',
+  // Header "Follow us" modal: platform intro + user feedback group QR (content pushed via Worker /about Markdown)
+  followUs: 'Follow us',
+  aboutTitle: 'Follow us',
+  aboutDesc: 'Learn what DSH-Plugin Hub does and join our user feedback group.',
+  aboutEmpty: 'Content not published yet — stay tuned.',
+  aboutUpdated: 'Updated',
   empty: 'No plugins in this category yet',
   dataFrom: 'Data from dsh-plugin.org · curated daily',
 }

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

@@ -20,12 +20,13 @@
   padding: 2px 2px 0;
 }
 
-/* 头部右上角控件组：语言切换 + GitHub 源码图标，右侧一列对齐 */
+/* 头部右上角控件组：语言切换 + GitHub 源码图标，右侧一列对齐，auto 把它顶到标题行最右 */
 .headerRight {
   flex-shrink: 0;
   display: inline-flex;
   align-items: center;
   gap: 2px;
+  margin-left: auto;
 }
 
 /* 语言切换按钮：与 GitHub 图标同风格（次级灰低调、悬浮品牌紫），文字显示目标语言 */
@@ -75,11 +76,36 @@
   display: block;
 }
 
-/* 头部第一行：logo + 标题（官网链接）与 GitHub 图标同行，space-between 把 GitHub 顶到标题行末尾 */
+/* 「关注我们」入口：GitHub 图标后，与语言切换按钮同风格 —— 普通文字、无边框，
+   悬浮才转品牌紫 + 浅紫底，提示可点（打开平台介绍 + 用户反馈群二维码弹窗） */
+.aboutBtn {
+  flex-shrink: 0;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  height: 24px;
+  padding: 0 8px;
+  font-size: 12px;
+  font-weight: 600;
+  line-height: 1;
+  color: var(--hub-text-tertiary);
+  background: transparent;
+  border: none;
+  border-radius: 6px;
+  cursor: pointer;
+  user-select: none;
+  transition: color 0.15s ease, background-color 0.15s ease;
+}
+
+.aboutBtn:hover {
+  color: var(--hub-purple-1);
+  background-color: var(--hub-purple-tint);
+}
+
+/* 头部第一行：logo + 标题（官网链接）紧接着版本号入口，右侧控件组靠 auto 顶到最右 */
 .headerTitleRow {
   display: flex;
   align-items: center;
-  justify-content: space-between;
   gap: 8px;
   min-width: 0;
 }
@@ -117,6 +143,60 @@
   color: var(--hub-text-secondary);
 }
 
+/* 版本号入口按钮：常驻可点（打开版本信息/更新记录弹窗），无边框、字号与标题协调，
+   hover 加品牌色下划线提示可点 —— 无论有无更新都可查看更新内容；
+   有更新时版本号后紧跟红色「可更新」徽标（同一按钮内的 span，不分开成两个元素） */
+.versionBtn {
+  flex-shrink: 0;
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  height: 20px;
+  padding: 0 6px;
+  border: none;
+  border-radius: 5px;
+  font-size: 12px;
+  font-weight: 600;
+  line-height: 1;
+  color: var(--hub-text-secondary);
+  background: transparent;
+  cursor: pointer;
+  user-select: none;
+  transition: color 120ms ease;
+}
+
+/* 悬浮只提示整组可点，但版本号本身颜色保持不变；交互反馈交给「可更新」徽标单独变深红 */
+.versionBtn:hover {
+  color: var(--hub-text-secondary);
+}
+
+/* 版本号旁的「可更新」徽标：默认红底白字（醒目），悬浮轻微加深 + 投影提升一点反馈感，
+   紧跟版本号，提示可查看并直接升级。作为同一按钮内文字，点击由外层按钮统一处理，本身无需独立事件。 */
+.hubUpdateBadge {
+  flex-shrink: 0;
+  display: inline-flex;
+  align-items: center;
+  height: 18px;
+  padding: 0 7px;
+  border-radius: 999px;
+  font-size: 11px;
+  font-weight: 700;
+  line-height: 1;
+  letter-spacing: 0.02em;
+  color: #ffffff;
+  background: var(--hub-danger);
+  box-shadow: 0 1px 4px rgba(209, 36, 47, 0.4);
+  user-select: none;
+  transition: background 120ms ease, box-shadow 120ms ease, transform 120ms ease;
+}
+
+/* 悬浮：轻微变深红 + 一点投影提升，只动徽标本身，版本号不动 */
+.hubUpdateBadge:hover {
+  background: var(--hub-danger-hover);
+  box-shadow: 0 2px 8px rgba(209, 36, 47, 0.5);
+  transform: translateY(-1px);
+}
+
 /* 品牌 logo 图标：与标题文字垂直居中对齐 */
 .logoIcon {
   flex-shrink: 0;

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

@@ -184,7 +184,7 @@
   user-select: none;
 }
 
-/* 可更新：琥珀警示色实底按钮（与 star / 有更新徽标同族），点击直接覆盖安装更新 */
+/* 可更新：琥珀警示色实底按钮（与 star / 有更新徽标同族，与安装绿、卸载红区分），点击直接覆盖安装更新 */
 .installBtnUpdate {
   color: #fff;
   background: var(--hub-warn);
@@ -197,17 +197,17 @@
   background: var(--hub-warn-strong);
 }
 
-/* 卸载：危险色文字按钮，默认无底，悬浮转鲜红实底白字 */
+/* 卸载：危险色按钮 —— 默认浅红底红字（危险但克制），悬浮转深红实底白字 */
 .uninstallBtn {
   color: var(--hub-danger);
-  background: transparent;
+  background: var(--hub-danger-tint);
   border: none;
   user-select: none;
 }
 
 .uninstallBtn:hover {
   color: #ffffff;
-  background: var(--hub-danger);
+  background: var(--hub-danger-hover);
 }
 
 .installBtn {