# github-discover-cli

**Repository Path**: codlogs/github-discover-cli

## Basic Information

- **Project Name**: github-discover-cli
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-01
- **Last Updated**: 2026-07-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# github-discover-cli

中文 | [English](./README.md)

一个轻量级命令行工具，帮助你发现 GitHub 上**新创建且快速增长**的开源仓库和热门话题。

通过 GitHub Search API，按日 / 周 / 月 / 年维度筛选高星仓库、追踪增长趋势、洞察技术热点。

## 功能亮点

- **增长趋势** (`trending`) — 基于「日均星标数」智能排序，突出真正快速崛起的项目
- **热门仓库** (`popular`) — 指定时间段内新创建的高星仓库，按星标数排序
- **话题洞察** (`topic`) — 热门仓库中的高频话题，综合频率与星标数评分排名
- 支持按**编程语言**过滤，输出**终端表格**或 **JSON**

## 安装

需要 [Node.js](https://nodejs.org/) **18+**

```bash
git clone https://github.com/coderyi/github-discover-cli.git
cd github-discover-cli
npm install && npm run build
```

## 使用方法

### `trending` — 增长趋势

使用「日均星标数」（带平滑因子）衡量增长速度，区别于简单的星标排序。

```bash
github-discover trending                         # 近期增长最快的仓库
github-discover trending -p monthly -l Python    # 月度，限定 Python
```

### `popular` — 热门新仓库

```bash
github-discover popular                          # 过去一天的热门仓库
github-discover popular -p weekly -l Rust        # 过去一周，限定 Rust
github-discover popular -p monthly -n 10 --json  # 月度，前 10 个，JSON 输出
```

### `topic` — 话题洞察

统计热门仓库中的高频话题标签，综合出现次数和关联星标总数评分。

```bash
github-discover topic                            # 近期热门话题
github-discover topic -p yearly -n 20            # 年度，前 20 个
```

## 命令参考

所有子命令均支持以下选项：

| 选项 | 简写 | 说明 | 默认值 |
| --- | --- | --- | --- |
| `--period <period>` | `-p` | 时间维度：`daily` \| `weekly` \| `monthly` \| `yearly` | `daily` |
| `--limit <number>` | `-n` | 返回结果数量（1–100） | `50`（topic 为 `30`） |
| `--language <lang>` | `-l` | 编程语言过滤 | 不限 |
| `--min-stars <number>` | `-s` | 最低星标数阈值 | 按时间维度自动设定 \* |
| `--json` | — | 以 JSON 格式输出 | `false` |

\* `--min-stars` 默认值：daily `60` · weekly `500` · monthly `4000` · yearly `10000`

## 输出示例

**表格模式（默认）：**

| Name         | Stars | Lang       | Created    | URL                             | Description |
| ------------ | ----- | ---------- | ---------- | ------------------------------- | ----------- |
| owner1/repo1 | 1234  | TypeScript | 2026-03-09 | https://github.com/owner1/repo1 | description |

**JSON 模式** 可配合 `jq` 做进一步处理：

```bash
github-discover trending --json | jq '.[].full_name'
```


## 许可证

MIT