GitHub AI Trends

核心用法

github-ai-trends 是一个命令行工具，通过GitHub API抓取人工智能、机器学习、大语言模型领域的热门仓库数据，生成响应式暗色主题HTML排行榜。支持按日、周、月三个时间维度筛选，输出包含排名、描述、编程语言、Star数、Fork数及标签的完整报告。

典型调用示例：

python3 scripts/fetch_trends.py --period weekly --limit 30 -o ai-trends.html

也可通过OpenClaw定时任务自动化生成，如：Generate this week's GitHub AI trends report using the github-ai-trends skill.

显著优点

• 零依赖设计：仅使用Python标准库（urllib），无需pip安装任何包，部署极简
• 自包含输出：生成的HTML内置所有CSS样式，无外部资源依赖，离线可查看
• API友好：支持GitHub Token提升限流（30 req/min vs 无Token的10 req/min）
• 智能筛选：基于关键词+话题标签组合搜索，自动去重并按Star排序
• 多格式输出：可选同时输出原始JSON数据，便于二次分析

潜在局限

• 数据源单一：仅依赖GitHub平台，无法覆盖GitLab、Hugging Face等其他AI社区
• 排名维度单一：以Star增长为核心指标，未纳入代码活跃度、Issue响应、实际采用率等深度指标
• 关键词硬编码：AI/ML/LLM的匹配规则需手动维护，可能遗漏新兴细分领域项目
• 无历史对比：单次报告不展示趋势变化曲线，需人工保存多期数据对比

适合人群

• AI从业者快速了解技术风向
• 投资人/分析师追踪开源生态热度
• 技术布道者制作周报/月报素材
• 开发者寻找可借鉴的优质项目

常规风险

• API限流风险：无Token时10次/分钟限制，大规模抓取可能触发封禁
• Token泄露风险：建议通过环境变量GITHUB_TOKEN注入，避免硬编码
• 数据时效性：GitHub API存在缓存延迟，极端热门项目可能有数小时滞后
• 主题误判：关键词匹配可能混入边缘项目，需人工复核关键排名

核心用法

github-ai-trends 是一款轻量级 CLI 工具，用于抓取 GitHub 上 AI/ML/LLM 相关的热门仓库并生成可视化 HTML 报告。用户通过命令行参数指定时间维度（daily/weekly/monthly）、榜单长度及输出路径，即可一键获取带星级排名的趋势数据。脚本通过 GitHub Search API 按关键词+主题筛选仓库，按 star 数去重排序后渲染为暗色主题响应式网页。

显著优点

1. 零依赖架构：仅使用 Python 标准库（urllib），无需 pip 安装，部署极简，彻底规避供应链攻击风险。
2. 安全设计：敏感信息（GITHUB_TOKEN）通过环境变量或参数传入，无硬编码密钥；HTTPS 加密传输，仅访问官方 API。
3. 输出自包含：生成的 HTML 内嵌所有样式，无需外部 CDN 资源，离线可浏览。
4. 自动化友好：支持 OpenClaw 定时任务调度，适合作为周报/月报的自动化数据源。

潜在局限

• API 速率限制：无 Token 时 10 req/min，有 Token 时 30 req/min，大规模抓取需控制频率。
• 数据维度单一：仅基于 star 数排序，未纳入 PR 活跃度、issue 响应速度等工程健康度指标。
• 关键词匹配粗糙：依赖 GitHub 的文本搜索，可能混入边缘项目或遗漏新兴小众仓库。

适合人群

• AI 投资人/研究员：快速扫描赛道热度变化
• 开发者社区运营：定期生成趋势报告用于内容运营
• 技术雷达团队：追踪开源 AI 技术演进

常规风险

用户需自行保管 GITHUB_TOKEN，避免使用权限过高的 token；输出路径建议显式指定，防止意外覆盖现有文件。