github-visitor-counter

GitHub Visitor Counter 是一款开源工具，可在您的 GitHub 个人资料 README 中显示访问者的国家旗帜。它作为一个部署在 Vercel 上的 serverless API 运行，无需维护或账号注册。 ## 概览 用户只需在 GitHub 个人资料中添加一个 markdown 图像标签，即可显示访问者的来源地。该服务集成了 Flag Counter API，并提供四种显示模式：Top Countries、Flag Map、Flags From (US/CA) 和 Mini Counter。 ## 核心特性 - **单行集成**：在任何 GitHub 个人资料 README 中添加一行 markdown 即可 - **无需注册**：仅需 GitHub 用户名即可立即使用 - **四种显示模式**：热门国家列表、旗帜地图可视化、位置过滤旗帜以及紧凑型 Mini Counter - **多种主题**：Default、Dark、GitHub、GitHub Dark 和 Transparent - **单仓库计数器**：可分别追踪单个仓库的访问量 - **兼容官方 ID**：支持现有的 Flag Counter ID 以进行仪表盘集成 - **实时配置工具**：具有实时预览功能的交互式 Web 仪表盘 - **快捷键与配置导入/导出**：为高级用户提供便捷操作 ## 显示模式 1. **Top Countries**：按访问量排序的旗帜网格 2. **Flag Map**：访问者位置的地理地图可视化 3. **Flags From**：过滤后的旗帜，仅显示来自指定国家（美国或加拿大）的访问者 4. **Mini Counter**：显示旗帜数量或页面浏览量的紧凑型显示 ## 技术栈 基于 Next.js 15, React 19, TypeScript, Tailwind CSS 构建，并部署在 Vercel 上，利用全球 CDN 缓存。 ## 使用方法 添加到您的 GitHub 个人资料 README 中： ```  ``` 可选参数包括 `displayMode`、`theme`、`columns`、`maxflags`、`label`、自定义颜色等。单仓库追踪使用 `repo` 或 `username/repo` 组合格式。现有的 Flag Counter 用户可以传递 `counterId` 参数。 ## 自托管 该项目采用 MIT 许可证，可以通过 Vercel 部署或使用 `npm run dev` 进行本地开发来实现自托管。所有源代码均在仓库中提供。