Back to Details

github-star-manager

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

GitHub Star 管理器 (GitHub Star Manager)

GitHub Star Manager

简介

Introduction

专注于 GitHub Star 项目的更新追踪与同步工具。自动检测您 Star 的项目是否有新版本、新 Release、重要 Commit 变化，并生成结构化的更新报告。
核心特色: 提供 HTML 可视化 Dashboard，快速浏览所有 Star 项目。
A synchronization tool focused on update tracking for GitHub Star projects. It automatically detects whether your starred projects have new versions, new Releases, or important Commit changes, and generates structured update reports.
Core Features: Provides HTML visual Dashboard for quick browsing of all Star projects.

何时使用

When to Use

本技能在以下场景下触发：
  • 用户需要从内容中自动发现并 Star GitHub 项目
  • 用户需要追踪 GitHub Star 项目的更新
  • 用户需要监控依赖库的版本发布
  • 用户需要查看项目活跃度和健康度
  • 用户需要管理大量 starred 仓库
  • 用户需要快速浏览和筛选 Star 项目
  • 用户需要生成项目的可视化报告
This skill is triggered in the following scenarios:
  • Users need to automatically discover and star GitHub projects from content
  • Users need to track updates of GitHub Star projects
  • Users need to monitor version releases of dependent libraries
  • Users need to view project activity and health
  • Users need to manage a large number of starred repositories
  • Users need to quickly browse and filter Star projects
  • Users need to generate visual reports for projects

模块说明

Module Description

本技能包含两个模块：
模块触发方式功能
对话模块对话触发从内容提取项目并 Star
脚本模块命令行/定时任务同步、Dashboard、追踪、批量管理
This skill includes two modules:
ModuleTrigger MethodFunction
Conversation ModuleConversation triggerExtract projects from content and star them
Script ModuleCommand line/scheduled taskSynchronization, Dashboard, tracking, batch management

核心功能

Core Functions

1. 对话模块：自动发现并 Star

1. Conversation Module: Automatic Discovery and Starring

从各种内容来源中自动提取 GitHub 仓库引用，并在你的 GitHub 账户上 star 它们。
支持的触发方式：
  • "分析这篇文章并 star 里面的项目"
  • "从这张截图里找 GitHub 项目并 star"
  • "Star [内容] 中提到的所有 GitHub 项目"
工作流程：
  1. 内容提取与上下文分析
    • 文字/URL：使用 WebFetch 获取文章内容，解析 GitHub URL
    • 截图/图片：使用图片分析 MCP 提取文字并识别项目引用
  2. 仓库发现与智能匹配
    • 直接匹配：内容中找到的完整 GitHub URL
    • 按名称搜索：当只有项目名时使用 
      gh search repos
    • 上下文相关性验证：检查 topics、description、技术栈是否匹配
  3. 检查是否已 Star
    bash
    gh api user/starred/owner/repo 2>/dev/null
  4. Star 仓库
    bash
    gh repo star owner/repo
  5. 生成报告
    • 新 star 的仓库列表
    • 已 star 的仓库（跳过）
    • 需人工确认的仓库
Automatically extract GitHub repository references from various content sources and star them on your GitHub account.
Supported trigger methods:
  • "Analyze this article and star the projects in it"
  • "Find GitHub projects from this screenshot and star them"
  • "Star all GitHub projects mentioned in [content]"
Workflow:
  1. Content Extraction and Context Analysis
    • Text/URL: Use WebFetch to get article content and parse GitHub URLs
    • Screenshot/image: Use image analysis MCP to extract text and identify project references
  2. Repository Discovery and Intelligent Matching
    • Direct matching: Complete GitHub URLs found in the content
    • Search by name: Use 
      gh search repos
      when only the project name is available
    • Context relevance verification: Check whether topics, description, and technology stack match
  3. Check if already starred
    bash
    gh api user/starred/owner/repo 2>/dev/null
  4. Star the repository
    bash
    gh repo star owner/repo
  5. Generate report
    • List of newly starred repositories
    • Already starred repositories (skipped)
    • Repositories requiring manual confirmation

2. 更新追踪

2. Update Tracking

  • 版本检测：检测项目的新 Release 和 Tag
  • 活跃度监控：追踪最近的 Commit 活跃度
  • 变更摘要：使用 AI 总结版本变更内容
  • Version detection: Detect new Releases and Tags of projects
  • Activity monitoring: Track recent Commit activity
  • Change summary: Use AI to summarize version change content

4. 智能分析

4. Intelligent Analysis

  • 项目摘要：自动生成项目核心功能说明
  • 价值评估：分析项目与您的关注领域匹配度（高/中/低）
  • 健康度指标：项目维护状态、Stars 增长趋势
  • Project summary: Automatically generate description of core functions of the project
  • Value assessment: Analyze the matching degree of the project with your areas of interest (high/medium/low)
  • Health indicators: Project maintenance status, Stars growth trend

5. HTML 可视化 Dashboard

5. HTML Visual Dashboard

  • 信息密集卡片：一屏展示更多项目
  • 颜色编码状态：活跃/近期更新/长期未更一目了然
  • 筛选与搜索：按状态、价值、关键词过滤
  • 展开详情：点击卡片查看更多信息
  • Information-dense cards: Display more projects on one screen
  • Color-coded status: Active/recently updated/not updated for a long time at a glance
  • Filter and search: Filter by status, value, keywords
  • Expand details: Click the card to view more information

依赖

Dependencies

系统依赖

System Dependencies

依赖安装方式
Python 3.8+macOS: 
brew install python3
<br>Linux: 
sudo apt-get install python3
DependencyInstallation Method
Python 3.8+macOS: 
brew install python3
<br>Linux: 
sudo apt-get install python3

Python 包

Python Packages

包名用途安装命令
requests
HTTP 请求，调用 GitHub API
pip install requests
python-dotenv
从 .env 文件加载配置
pip install python-dotenv
openai
AI 摘要生成（可选）
pip install openai
Package NamePurposeInstallation Command
requests
HTTP requests, call GitHub API
pip install requests
python-dotenv
Load configuration from .env file
pip install python-dotenv
openai
AI summary generation (optional)
pip install openai

依赖包文件

Dependency Package File

bash
pip install -r assets/requirements.txt
bash
pip install -r assets/requirements.txt

使用方法

Usage

1. 环境准备

1. Environment Preparation

方式 1：使用 .env 配置文件（推荐）

Method 1: Use .env configuration file (recommended)

bash
undefined
bash
undefined

1. 复制示例配置文件

1. Copy the sample configuration file

cp .env.example .env
cp .env.example .env

2. 编辑 .env 文件，填入你的 API 密钥

2. Edit the .env file and fill in your API keys

GITHUB_PAT=ghp_xxxxxxxxxxxxxxxxx

GITHUB_PAT=ghp_xxxxxxxxxxxxxxxxx

OPENAI_API_KEY=sk-xxxxxxxxxxxx

OPENAI_API_KEY=sk-xxxxxxxxxxxx

3. 安装依赖

3. Install dependencies

pip install -r requirements.txt
undefined
pip install -r requirements.txt
undefined

方式 2：环境变量

Method 2: Environment Variables

bash
undefined
bash
undefined

直接设置环境变量

Set environment variables directly

export GITHUB_PAT="你的_github_pat_token" export OPENAI_API_KEY="你的_openai_api_key"
undefined
export GITHUB_PAT="your_github_pat_token" export OPENAI_API_KEY="your_openai_api_key"
undefined

如何获取 GitHub PAT

How to Get GitHub PAT

  1. 访问 https://github.com/settings/tokens
  2. 点击 "Generate new token (classic)"
  3. 选择权限： 
    • public_repo
      （访问公开仓库）
    • 如果需要访问私有 Star，勾选 
      repo
  4. 生成后复制 token（只显示一次！）
Token 作用：
  • 无 Token：60 次/小时请求限制
  • 有 Token：5000 次/小时请求限制
  1. Visit https://github.com/settings/tokens
  2. Click "Generate new token (classic)"
  3. Select permissions: 
    • public_repo
      (access public repositories)
    • If you need to access private Stars, check 
      repo
  4. Copy the token after generation (it will only be displayed once!)
Token Role:
  • No Token: 60 requests/hour limit
  • With Token: 5000 requests/hour limit

2. 启动 Dashboard（推荐）

2. Start Dashboard (recommended)

bash
undefined
bash
undefined

导出数据并打开 Dashboard

Export data and open 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 --export --user your_username && open dashboard.html

**First use instructions**: If `dashboard.html` does not exist, the system will automatically copy a copy from `assets/dashboard.example.html`.

Dashboard functions:
- 📊 Overview: Total number of projects, active projects this week, number of new versions
- 🔍 Filter: Filter by status (active/recently updated/not updated for a long time), value (high/medium)
- 🔎 Search: Search by project name, description, tags
- 📦 Card: Display project name, description, language, tags, Stars, update time, value assessment
- 🖱️ Click the card: Expand detailed information (creation time, Forks, Issues, collection reason)
- 🔗 Quick jump: Click the GitHub icon to go directly to the project

3. 首次同步（建立基准）

3. First synchronization (establish baseline)

bash
python scripts/main.py --init --user 你的用户名 --limit 50
首次运行会保存所有 Star 的快照作为后续对比基准。
bash
python scripts/main.py --init --user your_username --limit 50
The first run will save a snapshot of all Stars as a baseline for subsequent comparisons.

4. 检查更新

4. Check for updates

bash
python scripts/main.py --check --user 你的用户名
对比上次快照，生成更新报告。
bash
python scripts/main.py --check --user your_username
Compare with the last snapshot and generate an update report.

5. 生成完整报告

5. Generate full report

bash
python scripts/main.py --report --user 你的用户名 --days 7
生成包含项目摘要和更新状态的完整报告。
bash
python scripts/main.py --report --user your_username --days 7
Generate a full report including project summary and update status.

6. 定期运行（推荐）

6. Run regularly (recommended)

bash
undefined
bash
undefined

每周检查一次

Check once a week

python scripts/main.py --check --user 你的用户名 --weekly
undefined
python scripts/main.py --check --user your_username --weekly
undefined

配置与自定义

Configuration and Customization

配置文件

Configuration File

本技能使用以下配置文件：
文件用途
assets/categories.yaml
分类定义和关键词规则
assets/tags.json
标签管理和别名配置
assets/.env.example
环境变量模板
首次运行时，配置文件会自动复制到 
~/.github-star-tracker/
目录。
This skill uses the following configuration files:
FilePurpose
assets/categories.yaml
Category definition and keyword rules
assets/tags.json
Tag management and alias configuration
assets/.env.example
Environment variable template
When running for the first time, the configuration files will be automatically copied to the 
~/.github-star-tracker/
directory.

适用场景

Applicable Scenarios

  • 开发者：及时了解依赖库的版本更新
  • 技术爱好者：跟踪 AI/开源领域的最新动态
  • 项目经理：监控竞品或相关项目的进展
  • Developers: Timely understand version updates of dependent libraries
  • Technology enthusiasts: Track the latest trends in the AI/open source field
  • Project managers: Monitor the progress of competitors or related projects

与其他技能的区别

Differences from Other Skills

功能github-star-managerrepo-research
焦点Star 项目发现 + 管理 + 追踪单个仓库的深度研究
输出Dashboard + 变更摘要架构分析、代码解读
用途日常订阅更新一次性深度调研
Functiongithub-star-managerrepo-research
FocusStar project discovery + management + trackingIn-depth research on a single repository
OutputDashboard + change summaryArchitecture analysis, code interpretation
PurposeDaily subscription updatesOne-time in-depth research

参考文档

Reference Documents

  • SKILL-GUIDE.md - 技能开发指南
  • AGENTS.md - 项目协作规范
  • SKILL-GUIDE.md - Skill development guide
  • AGENTS.md - Project collaboration specifications