GitHub Sentinel 是一款开源的 AI Agent 工具，专为开发者和项目管理人员设计。它能够定期（每日/每周）自动获取并汇总订阅的 GitHub 仓库最新动态，通过 DeepSeek AI 生成结构化的中文摘要报告，帮助团队高效跟踪项目进展。
- 订阅管理：灵活添加、删除、查看订阅的 GitHub 仓库
- 更新获取：自动抓取 Releases、Issues、Pull Requests、Commits
- 报告生成：调用 DeepSeek AI 对原始数据进行智能摘要，输出 Markdown 格式报告
- 通知系统：将报告保存为本地文件，支持扩展为邮件/Webhook 推送
- 定时调度：支持每日或每周定时自动执行
- Web UI：基于 Gradio 的可视化界面，支持订阅管理、手动触发、历史报告浏览和调度控制
Github-Sentinel/
├── app.py # Gradio Web UI 入口
├── main.py # 交互式 REPL 入口
├── requirements.txt # Python 依赖
├── .gitignore
├── config/
│ ├── settings.yaml # 主配置（调度频率、模型、报告路径等）
│ ├── subscriptions.json # 订阅仓库列表
│ ├── .env.example # 环境变量模板
│ ├── config_loader.py # 配置加载器（合并 YAML 与环境变量）
│ └── __init__.py
├── subscription/
│ ├── manager.py # 订阅增删查管理
│ └── __init__.py
├── github_client/
│ ├── client.py # GitHub REST API 封装
│ └── __init__.py
├── llm/
│ ├── reporter.py # DeepSeek AI 报告生成
│ └── __init__.py
├── notifier/
│ ├── file_notifier.py # 本地 Markdown 文件输出
│ └── __init__.py
└── scheduler/
├── scheduler.py # APScheduler 定时调度
└── __init__.py
pip install -r requirements.txt在系统中设置以下环境变量：
GITHUB_TOKEN=your_github_token_here
DEEPSEEK_API_KEY=your_deepseek_api_key_here- GITHUB_TOKEN：在 GitHub Settings → Tokens 创建，需要
repo读取权限 - DEEPSEEK_API_KEY：在 DeepSeek 开放平台 获取
编辑 config/settings.yaml：
llm:
model: "deepseek-chat" # 使用的 DeepSeek 模型
max_tokens: 4096
scheduler:
interval: "daily" # daily（每天）或 weekly（每周）
time: "08:00" # 执行时间（24小时制）
report:
output_dir: "reports" # 报告输出目录python app.py浏览器会自动打开 http://localhost:7860，提供 4 个功能页面：
- 订阅管理：添加/移除仓库，查看当前订阅列表
- 立即运行：点击按钮触发抓取，实时查看进度日志和 AI 生成报告
- 历史报告：浏览和查看已生成的历史报告文件
- 定时调度：启动/停止后台定时任务
python main.py进入 REPL 后，输入 help 查看所有可用命令：
>>> help
可用命令：
run 立即抓取所有订阅仓库并生成 AI 摘要报告
schedule 在后台启动定时调度（按 settings.yaml 中的时间执行）
list 查看当前订阅列表
add <owner/repo> 添加仓库订阅，例如：add microsoft/vscode
remove <owner/repo> 移除仓库订阅，例如：remove microsoft/vscode
help 显示帮助信息
exit / quit 退出程序
# 查看当前订阅列表
>>> list
# 添加仓库订阅（支持 owner/repo 或完整 GitHub URL）
>>> add microsoft/vscode
>>> add https://github.com/anthropics/anthropic-sdk-python
# 移除仓库订阅
>>> remove microsoft/vscode
# 立即执行一次（抓取数据 + 生成报告）
>>> run
# 在后台启动定时调度模式
>>> schedule
生成的报告保存在 reports/ 目录下，文件名格式为 report_YYYYMMDD_HHMMSS.md。
| 组件 | 技术 |
|---|---|
| 语言 | Python 3.10+ |
| Web UI | Gradio |
| AI 报告 | DeepSeek API（通过 openai 兼容接口调用） |
| GitHub 数据 | GitHub REST API v2022-11-28 |
| 定时调度 | APScheduler |
| 配置管理 | PyYAML |
在 notifier/ 目录下新建通知类，实现 send(content: str) -> str 方法，然后在 main.py 中注册即可。例如邮件通知、Slack Webhook、钉钉/飞书等。
在 config/subscriptions.json 中，每个仓库可单独配置跟踪项：
{
"owner": "microsoft",
"repo": "vscode",
"label": "VS Code",
"track": ["releases", "issues", "pull_requests", "commits"]
}MIT