GitHub Trending 技能
何时使用
当用户需要以下任意信息时,请使用本技能:
- 查看 GitHub 当前热门项目(今日/本周/本月)
- 按编程语言筛选热门项目(如 Python、JavaScript、Go 等)
- 按文档口语筛选(如只显示中文文档的项目)
- 查看热门开发者(developers)而非仓库
- 获取趋势项目列表供学习、选型或参考
核心能力
- 构造并返回 GitHub Trending 页面链接,便于用户直接访问
- 解释筛选参数,帮助用户理解如何自定义查询
- 提供常用筛选值参考,降低用户使用门槛
基础 URL 结构
- 仓库 Trending:
https://github.com/trending - 开发者 Trending:
https://github.com/trending/developers
筛选参数
GitHub Trending 页面通过 URL 查询参数进行筛选。所有参数均为可选,不指定时使用默认值。
1. l - 编程语言(Language)
根据项目主要使用的编程语言筛选。
| 参数 | 说明 |
|---|---|
l | 语言标识符,小写。如 python、javascript、typescript、go、rust 等 |
示例:只显示 Python 项目 → ?l=python
常用语言值(见 references/languages.md):
python- Pythonjavascript- JavaScripttypescript- TypeScriptgo- Gorust- Rustjava- Javac- Ccpp- C++csharp- C#ruby- Rubyphp- PHPkotlin- Kotlinswift- Swift
2. since - 日期范围(Date range)
根据时间窗口筛选,统计该时间段内的热度。
| 参数值 | 含义 |
|---|---|
daily | 今日(Today) |
weekly | 本周(This week) |
monthly | 本月(This month) |
示例:查看本周热门 → ?since=weekly
3. spoken_language_code - 口语/文档语言
根据项目 README/文档的主要口语筛选,用于找到特定语言文档的项目。
| 参数 | 说明 |
|---|---|
spoken_language_code | ISO 639-1 语言代码,如 en、zh、ja 等 |
示例:只显示中文文档项目 → ?spoken_language_code=zh
常用口语代码(见 references/spoken-languages.md):
en- 英语(English)zh- 中文(Chinese)ja- 日语(Japanese)ko- 韩语(Korean)es- 西班牙语(Spanish)fr- 法语(French)de- 德语(German)ru- 俄语(Russian)pt- 葡萄牙语(Portuguese)
组合使用示例
多个参数用 & 连接:
-
本周 Python 热门项目
https://github.com/trending?l=python&since=weekly -
本月中文文档的 JavaScript 项目
https://github.com/trending?l=javascript&since=monthly&spoken_language_code=zh -
今日 Rust 热门
https://github.com/trending?l=rust&since=daily -
本周热门开发者
https://github.com/trending/developers?since=weekly
执行步骤
当用户请求 GitHub Trending 相关信息时:
- 解析用户意图:确定需要的类型(仓库/开发者)、时间范围、编程语言、口语筛选。
- 选择合适的参数:根据用户需求选择
l、since、spoken_language_code的值。 - 构造完整 URL:按
https://github.com/trending[?参数]或https://github.com/trending/developers[?参数]格式拼接。 - 返回结果:给出可点击的链接,并简要说明当前筛选条件。
- 可选:如需更丰富的筛选值,可参考
references/目录下的文件。
注意事项
- GitHub 官方不提供 Trending 的 REST API,本技能通过构造网页 URL 实现访问。
- 编程语言值需与 GitHub 语言列表一致,一般为小写英文,部分语言可能使用特殊标识(如
c%23表示 C#,需 URL 编码)。 - 若用户提供的语言名称不明确,可给出常见匹配建议(如 "js" →
javascript,"ts" →typescript)。
参考资料
- GitHub Trending 页面:https://github.com/trending
- 编程语言完整列表:
references/languages.md - 口语语言代码列表:
references/spoken-languages.md