Explorer

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
   ...

命令参数

排序选项

• stars - 按 Star 数量（默认，降序）
• forks - 按 Fork 数量
• updated - 按最近更新时间
• created - 按创建时间

热门标签推荐

常见问题

错误：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