dvcrn GitHub Projects Explorer
发现并分析 GitHub 上的热门开源项目，支持多维度搜索和筛选。
发现并分析 GitHub 上的热门开源项目，支持多维度搜索和筛选。
功能特性
- 🏷️ 多标签筛选 - 支持一个或多个项目标签
- ⭐ Star 数量过滤 - 按最低 Star 数筛选
- 📅 时间范围 - 筛选最近 N 天内创建的项目
- 🔤 编程语言 - 按编程语言筛选
- 📊 智能排序 - 支持 Stars/Forks/更新时间排序
前提条件
可选：配置 GitHub Token
GitHub API 有请求限制（未认证 60次/小时，认证 5000次/小时）。
# 获取 Token: https://github.com/settings/tokens
export GITHUB_TOKEN="your_github_token"
添加到 ~/.zshrc：
echo 'export GITHUB_TOKEN="your-token"' >> ~/.zshrc
source ~/.zshrc
使用方法
基础搜索
按标签搜索：
python3 scripts/github_projects.py --topic python
多个标签（与关系）：
python3 scripts/github_projects.py --topic python --topic machine-learning
按 Star 数量筛选
# 查找 Star > 1000 的 Python 项目
python3 scripts/github_projects.py --topic python --stars 1000
# 查找 Star > 10000 的 AI 项目
python3 scripts/github_projects.py --topic ai --stars 10000
按时间筛选（最近 N 天）
# 最近 30 天内创建的 Python 项目
python3 scripts/github_projects.py --topic python --days 30
# 最近 7 天内创建的高 Star AI 项目
python3 scripts/github_projects.py --topic ai --stars 100 --days 7
按编程语言筛选
# Rust 语言的项目
python3 scripts/github_projects.py --lang rust --stars 1000
# Go 语言的项目
python3 scripts/github_projects.py --lang go --stars 500 --days 30
# TypeScript 项目
python3 scripts/github_projects.py --lang typescript --topic react --stars 500
综合示例
# AI 项目：最近30天、Python、Star>500
python3 scripts/github_projects.py \
--topic ai --topic python \
--stars 500 \
--days 30
# Rust 工具：高 Star、最近90天
python3 scripts/github_projects.py \
--topic rust \
--stars 5000 \
--days 90 \
--limit 50
# 前端框架：JavaScript、Star>1000
python3 scripts/github_projects.py \
--topic frontend \
--lang javascript \
--stars 1000 \
--sort updated
输出格式
示例输出：
🔥 找到 30 个热门项目:
1. 🌟 facebook/react
📝 A declarative, efficient, and flexible JavaScript library...
🔗 https://github.com/facebook/react
📊 Stars: 220,000 | Forks: 45,000 | Language: JavaScript
🏷️ Tags: react, frontend, javascript
📅 Created: 2013-05-24 | Updated: 2024-02-03
2. ⭐ microsoft/vscode
📝 Visual Studio Code
🔗 https://github.com/microsoft/vscode
📊 Stars: 150,000 | Forks: 30,000 | Language: TypeScript
...
命令参数
| 参数 | 简写 | 说明 | 示例 |
|---|---|---|---|
--topic |
-t |
项目标签（可多次使用） | -t python -t ai |
--stars |
-s |
最少 Star 数量 | --stars 1000 |
--days |
-d |
最近 N 天内创建 | --days 30 |
--lang |
-l |
编程语言 | --lang rust |
--limit |
- | 返回数量（默认30） | --limit 50 |
--sort |
- | 排序方式 | --sort stars |
排序选项
stars- 按 Star 数量（默认，降序）forks- 按 Fork 数量updated- 按最近更新时间created- 按创建时间
热门标签推荐
| 领域 | 推荐标签 |
|---|---|
| AI/ML | ai, machine-learning, deep-learning, nlp, computer-vision |
| 前端 | frontend, react, vue, angular, javascript, typescript |
| 后端 | backend, api, microservices, nodejs, python |
| 移动开发 | mobile, ios, android, flutter, react-native |
| DevOps | devops, docker, kubernetes, ci-cd, terraform |
| 数据 | database, big-data, analytics, sql, nosql |
| 安全 | security, cybersecurity, penetration-testing |
| 工具 | cli, tools, productivity, automation |
常见问题
错误：API 请求限制 reached → 设置 GITHUB_TOKEN 提高限制：
export GITHUB_TOKEN="your-token"
没有返回结果 → 尝试放宽条件：
- 降低
--stars数值 - 增加
--days天数 - 减少
--topic标签数量
搜索结果不准确 → 使用更具体的标签：
- 用
machine-learning而不是ml - 用
natural-language-processing而不是nlp
使用场景
场景1：追踪新兴技术
# 最近30天的热门 AI 项目
python3 scripts/github_projects.py --topic ai --stars 100 --days 30 --limit 50
场景2：学习优秀项目
# 高星 Python 项目
python3 scripts/github_projects.py --topic python --stars 10000 --limit 20
场景3：发现新工具
# 最近7天的开发者工具
python3 scripts/github_projects.py --topic developer-tools --topic cli --days 7 --stars 50
场景4：技术调研
# 对比不同语言的 Web 框架
python3 scripts/github_projects.py --topic web-framework --lang rust --stars 1000
python3 scripts/github_projects.py --topic web-framework --lang go --stars 1000
参考
- GitHub Search API: references/github_api.md
- GitHub 官方文档: https://docs.github.com/en/rest/search