Skip to content

Latest commit

 

History

History
181 lines (126 loc) · 4.4 KB

File metadata and controls

181 lines (126 loc) · 4.4 KB

GitHub 趋势

发现和分析热门 GitHub 仓库,拥有美观现代的界面。

MIT License Node.js React

在线演示 · 报告问题 · 功能建议

English | 中文


概述

一个现代化的 Web 应用程序,用于发现 GitHub 热门仓库。支持实时数据获取、多视图模式、导出功能,以及精美的深色主题界面。

核心功能

功能 描述
实时数据 通过 GitHub API 实时获取热门仓库
双视图模式 表格视图用于数据分析,卡片视图用于可视化浏览
智能筛选 按分类、关键词和 20+ 属性进行筛选
导出选项 下载为 CSV、JSON 或复制到剪贴板
深色主题 现代毛玻璃设计,流畅动画效果
双语支持 完整的英文和中文语言支持

快速开始

环境要求

安装

# 克隆仓库
git clone https://github.com/encoreshao/github-trending.git
cd github-trending

# 安装依赖
npm install

# 启动开发服务器
npm run dev

在浏览器中打开 http://localhost:5173

使用方法

  1. 导航到 实时演示/demo
  2. 在设置面板中输入您的 GitHub 令牌
  3. 选择要显示的字段
  4. 点击 获取数据 加载热门仓库
  5. 在表格和卡片视图之间切换
  6. 根据需要导出数据

页面

路由 描述
/ 主页,展示功能亮点
/demo 交互式仓库分析工具
/subscribe 基于分类的订阅设置

技术栈

  • 前端: React 18、Vite、Ant Design 5
  • 样式: CSS3 毛玻璃效果
  • 接口: GitHub REST API
  • 数据: axios、papaparse、file-saver

项目结构

src/
├── api/           # GitHub API 集成
├── components/    # 可复用 UI 组件
│   ├── Header     # 导航栏
│   ├── Footer     # 页脚
│   ├── RepoTable  # 表格视图组件
│   ├── RepoCard   # 卡片视图组件
│   └── Settings   # 配置面板
├── pages/         # 路由页面
│   ├── HomePage
│   ├── DemoPage
│   └── SubscriptionPage
├── locales/       # 国际化翻译
└── utils/         # 工具函数

CLI 脚本(可选)

用于自动化数据收集:

# 设置环境变量
echo "GITHUB_TOKEN=your_token" > .env

# 运行脚本
node index.js

输出文件保存到 docs/YYYY/MM/,格式为 Markdown、JSON 和 CSV。

使用 Cron 自动化

# 每天上午 9 点执行
0 9 * * * cd /path/to/github-trending && node index.js

配置

Web 应用设置

设置自动保存在 localStorage 中:

  • GitHub 令牌 - 您的个人访问令牌(本地存储)
  • 显示字段 - 从 20+ 个仓库属性中选择
  • 每页数量 - 每页仓库数(1-100)
  • 语言 - 英文或中文

可用字段

基本信息 URL 日期 统计
名称 HTML URL 创建时间 星标
所有者 Git URL 更新时间 分支
头像 SSH URL 推送时间 问题
描述 Clone URL 大小
主题 SVN URL 语言
许可证 主页

故障排除

问题 解决方案
超出速率限制 确保 GitHub 令牌有效且具有 public_repo 权限
没有返回数据 验证令牌和网络连接
构建错误 运行 rm -rf node_modules && npm install

贡献

  1. Fork 仓库
  2. 创建功能分支(git checkout -b feature/amazing-feature
  3. 提交更改(git commit -m 'Add amazing feature'
  4. 推送到分支(git push origin feature/amazing-feature
  5. 发起 Pull Request

许可证

MIT 许可证 - 详见 LICENSE


RanBOT Labs 用 ❤️ 制作