用途:为应用添加版本可见性,在页眉或页脚放置一个始终可见的版本徽章(如 v1.43.0 | 004ddd9),悬停或键盘聚焦时弹出工具提示,展示构建信息与最近变更。
主要能力:工具提示包含版本号、完整提交 SHA、构建时间、分支,以及从 CHANGELOG.md 解析出的最近若干版本的变更条目(按 feat、fix、perf、breaking、refactor、docs 分类并配图标)。组件具备键盘可导航与无障碍标签。
使用方式:提供 scripts/parse-changelog.mjs 解析 CHANGELOG.md,输出 JSON 数组;在构建配置(如 next.config.mjs)中读取 package.json 版本、git 提交与分支,生成 NEXT_PUBLIC_BUILD_INFO 与 NEXT_PUBLIC_CHANGELOG 环境变量;组件从环境变量读取并渲染。资料给出 React + Tailwind + shadcn/ui 实现,Vue 3、Svelte 与纯 CSS 实现及无障碍清单见 REFERENCE.md。不同框架环境变量前缀不同:Next.js 用 NEXT_PUBLIC_,Nuxt 用 NUXT_PUBLIC_,Vite 用 VITE_,SvelteKit 用 PUBLIC_,CRA 用 REACT_APP_。
适用场景:需要向用户或开发者展示当前部署版本与近期改动的前端应用。
限制:资料未提供具体安装命令、依赖版本、收费或价格信息;当版本为 dev 或缺失时组件返回空。