GitHub Star 追踪更新 (GitHub Star Tracker)
简介
专注于 GitHub Star 项目的更新追踪与同步工具。自动检测您 Star 的项目是否有新版本、新 Release、重要 Commit 变化，并生成结构化的更新报告。
核心特色: 提供 HTML 可视化 Dashboard，快速浏览所有 Star 项目。
何时使用
本技能在以下场景下触发：
-
用户需要追踪 GitHub Star 项目的更新
-
用户需要监控依赖库的版本发布
-
用户需要查看项目活跃度和健康度
-
用户需要管理大量 starred 仓库
-
用户需要快速浏览和筛选 Star 项目
-
用户需要生成项目的可视化报告
核心功能
- 更新追踪
-
版本检测：检测项目的新 Release 和 Tag
-
活跃度监控：追踪最近的 Commit 活跃度
-
变更摘要：使用 AI 总结版本变更内容
- 智能分析
-
项目摘要：自动生成项目核心功能说明
-
价值评估：分析项目与您的关注领域匹配度（高/中/低）
-
健康度指标：项目维护状态、Stars 增长趋势
- HTML 可视化 Dashboard
-
信息密集卡片：一屏展示更多项目
-
颜色编码状态：活跃/近期更新/长期未更一目了然
-
筛选与搜索：按状态、价值、关键词过滤
-
展开详情：点击卡片查看更多信息
依赖
系统依赖
依赖 安装方式
Python 3.8+ macOS: brew install python3 Linux: sudo apt-get install python3
Python 包
包名 用途 安装命令
requests
HTTP 请求，调用 GitHub API pip install requests
python-dotenv
从 .env 文件加载配置 pip install python-dotenv
openai
AI 摘要生成（可选） pip install openai
依赖包文件
pip install -r assets/requirements.txt
使用方法
- 环境准备
方式 1：使用 .env 配置文件（推荐）
1. 复制示例配置文件
cp .env.example .env
2. 编辑 .env 文件，填入你的 API 密钥
GITHUB_PAT=ghp_xxxxxxxxxxxxxxxxx
OPENAI_API_KEY=sk-xxxxxxxxxxxx
3. 安装依赖
pip install -r requirements.txt
方式 2：环境变量
直接设置环境变量
export GITHUB_PAT="你的_github_pat_token" export OPENAI_API_KEY="你的_openai_api_key"
如何获取 GitHub PAT
-
点击 "Generate new token (classic)"
-
选择权限：
-
public_repo （访问公开仓库）
-
如果需要访问私有 Star，勾选 repo
-
生成后复制 token（只显示一次！）
Token 作用：
-
无 Token：60 次/小时请求限制
-
有 Token：5000 次/小时请求限制
- 启动 Dashboard（推荐）
导出数据并打开 Dashboard
python scripts/main.py --export --user 你的用户名 && open dashboard.html
首次使用说明: 如果 dashboard.html 不存在，系统会自动从 assets/dashboard.example.html 复制一份。
Dashboard 功能：
-
📊 总览：总项目数、本周活跃数、新版本数
-
🔍 筛选：按状态（活跃/近期更新/长期未更）、价值（高/中）过滤
-
🔎 搜索：按项目名、描述、标签搜索
-
📦 卡片：显示项目名、描述、语言、标签、Stars、更新时间、价值评估
-
🖱️ 点击卡片：展开详细信息（创建时间、Forks、Issues、收藏理由）
-
🔗 快速跳转：点击 GitHub 图标直达项目
- 首次同步（建立基准）
python scripts/main.py --init --user 你的用户名 --limit 50
首次运行会保存所有 Star 的快照作为后续对比基准。
- 检查更新
python scripts/main.py --check --user 你的用户名
对比上次快照，生成更新报告。
- 生成完整报告
python scripts/main.py --report --user 你的用户名 --days 7
生成包含项目摘要和更新状态的完整报告。
- 定期运行（推荐）
每周检查一次
python scripts/main.py --check --user 你的用户名 --weekly
配置与自定义
配置文件
本技能使用以下配置文件：
文件 用途
assets/categories.yaml
分类定义和关键词规则
assets/tags.json
标签管理和别名配置
assets/.env.example
环境变量模板
首次运行时，配置文件会自动复制到 ~/.github-star-tracker/ 目录。
适用场景
-
开发者：及时了解依赖库的版本更新
-
技术爱好者：跟踪 AI/开源领域的最新动态
-
项目经理：监控竞品或相关项目的进展
与其他技能的区别
功能 github-star-tracker repo-research
焦点 已 Star 项目的更新 单个仓库的深度研究
输出 Dashboard + 变更摘要 架构分析、代码解读
用途 日常订阅更新 一次性深度调研
参考文档
-
SKILL-GUIDE.md - 技能开发指南
-
AGENTS.md - 项目协作规范