GitHub 项目探索器

发现并分析 GitHub 上热门的开源项目，支持多维度搜索与筛选。

功能特性

• 🏷️ 多标签筛选 — 支持一个或多个项目主题/标签
• ⭐ 星标数筛选 — 按最低星标数量进行过滤
• 📅 时间范围 — 筛选最近 N 天内创建的项目
• 🔤 编程语言 — 按特定编程语言进行筛选
• 📊 智能排序 — 支持按星标数、Fork 数或更新时间排序

前提条件

可选：配置 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

按星标数筛选

# 查找星标数 > 1000 的 Python 项目
python3 scripts/github_projects.py --topic python --stars 1000

# 查找星标数 > 10000 的 AI 项目
python3 scripts/github_projects.py --topic ai --stars 10000

按时间范围筛选（最近 N 天）

# 最近 30 天创建的 Python 项目
python3 scripts/github_projects.py --topic python --days 30

# 最近 7 天创建、星标数 > 100 的高星标 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、星标数 > 500
python3 scripts/github_projects.py 
  --topic ai --topic python 
  --stars 500 
  --days 30

# Rust 工具类项目：高星标、最近 90 天
python3 scripts/github_projects.py 
  --topic rust 
  --stars 5000 
  --days 90 
  --limit 50

# 前端框架：JavaScript、星标数 > 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 — 按星标数排序（默认，降序）
• forks — 按 Fork 数排序
• updated — 按最近更新时间排序
• created — 按创建时间排序

推荐热门标签

常见问题（FAQ）

错误：API 调用频率超限
→ 设置 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 搜索 API：references/github_api.md
• GitHub 官方文档：https://docs.github.com/en/rest/search