github-repo-stats

name: github-repo-stats description: Query a GitHub repository's star count and lines of code. Use when the user asks for repo stars, stargazers, LOC, code lines, or repository statistics for a given GitHub repo.

GitHub 仓库统计查询

在用户需要查询某个 GitHub 仓库的 star 数量和代码行数时，按下列方式执行。

1. Star 数量

使用 GitHub REST API（无需 token 即可查询公开仓库）：

• 接口: GET https://api.github.com/repos/{owner}/{repo}
• 字段: 响应 JSON 中的 stargazers_count 即为 star 数。

示例（将 owner/repo 换成实际仓库，如 vllm-project/vllm）：

curl -s "https://api.github.com/repos/owner/repo" | jq '.stargazers_count'

或在代码中请求同一 URL，解析 JSON 取 stargazers_count。若请求受限可设置 User-Agent 头（如 User-Agent: curl）。

2. 代码行数

GitHub API 不直接提供“总代码行数”，常用做法是克隆仓库后本地统计。

方式 A：使用 cloc（推荐）

git clone --depth 1 https://github.com/owner/repo.git /tmp/repo-stat && cloc /tmp/repo-stat --json

安装：sudo apt install cloc 或 pip install cloc（若有）。从输出 JSON 中取 SUM 的 code 作为代码行数，并清理临时目录。

3. 输出格式

回复用户时建议包含：

• 仓库: owner/repo
• Stars: 数字
• 代码行数: 数字（并注明统计方式，如 cloc/tokei/近似）

若克隆或统计失败，说明原因并给出可替代方式（例如仅提供 star 数，或提供仓库语言占比链接）。