Ranveerrrrr/Github-Insights-Archiver
GitHub: Ranveerrrrr/Github-Insights-Archiver
突破 GitHub 14 天流量数据限制的轻量级归档工具，支持长期存储和本地可视化仓库访问统计。
Stars: 0 | Forks: 0
# GitHub Traffic 归档
一个用于归档 GitHub 仓库流量数据的轻量级工具（突破 14 天的限制）。它允许用户通过定期收集数据并在本地进行可视化，从而构建长期的分析。
## 目的
GitHub 仅提供过去 14 天的流量数据。此工具通过以下方式扩展了该功能：
- 随时间推移存储浏览量和克隆量
- 保留来源和热门内容
- 实现长期趋势分析
## 工作原理
1. 脚本使用个人访问令牌连接到 GitHub API。
2. 它获取仓库流量数据，包括：
- 浏览量
- 克隆量
- 来源
- 热门路径
3. 新数据与现有数据合并以避免重复。
4. 结果存储在 `traffic.json` 中。
5. 仪表板读取此数据并提供可视化。
## 文件夹结构
```
github-traffic-archiver/
|──tracker.py <- Main Script
|──config.json <- Github Token
|──traffic.json <- Traffic Data
|──dashboard/
│──index.html <- Main Dashboard
│──app.js <- Data Logic
│──style.css <- UI Style
```
## 设置
1. 安装所需的包：
```
pip install requests
```
2. 创建一个 `config.json` 文件：
```
{
"token": "YOUR_GITHUB_TOKEN"
}
```
## 用法
运行追踪器脚本：
```
python tracker.py
```
脚本将：
- 获取最新的流量数据
- 将其与现有数据合并
- 更新 `traffic.json`
查看仪表板：
- 在任意浏览器中打开 `dashboard/index.html` 文件
- 查看仓库统计数据
- 使用内置控件应用日期筛选
## 自动化（可选）
为了确保数据不丢失，请使用 cron 作业定期运行脚本：
```
0 0 * * * python3 /path/to/tracker.py
```
建议每天运行一次以保持完整的历史记录。
## 注意事项
- 如果不进行归档，GitHub 流量数据仅保留 14 天
- 需要定期执行以保存数据
- 不需要外部服务器，仪表板在本地运行
标签：CMS安全, JavaScript, Python, Referrers, 个人访问令牌, 克隆数, 前端展示, 可视化大屏, 命令控制, 多模态安全, 开源项目运营, 数字取证, 数据可视化, 数据归档, 数据持久化, 数据采集, 无后门, 热门路径, 自动化脚本, 访问量, 趋势分析, 逆向工具, 长期分析