explorer

# GitHub Projects Explorer

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

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

## 功能特性

- 🏷️ **多标签筛选** - 支持一个或多个项目标签
- ⭐ **Star 数量过滤** - 按最低 Star 数筛选
- 📅 **时间范围** - 筛选最近 N 天内创建的项目
- 🔤 **编程语言** - 按编程语言筛选
- 📊 **智能排序** - 支持 Stars/Forks/更新时间排序

## 前提条件

### 可选：配置 GitHub Token

GitHub API 有请求限制（未认证 60次/小时，认证 5000次/小时）。

```bash
# 获取 Token: https://github.com/settings/tokens
export GITHUB_TOKEN="your_github_token"
```

添加到 `~/.zshrc`：
```bash
echo 'export GITHUB_TOKEN="your-token"' >> ~/.zshrc
source ~/.zshrc
```

## 使用方法

### 基础搜索

**按标签搜索：**
```bash
python3 scripts/github_projects.py --topic python
```

**多个标签（与关系）：**
```bash
python3 scripts/github_projects.py --topic python --topic machine-learning
```

### 按 Star 数量筛选

```bash
# 查找 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 天）

```bash
# 最近 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
```

### 按编程语言筛选

```bash
# 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
```

### 综合示例

```bash
# 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...