✨ 功能预览

🚀 特性
- 可视化报告:将用户的 GitHub 活动数据渲染成一张清晰、美观的图片。
- “内卷”得分:根据非工作时间、午夜和周末的活动计算出一个有趣的“内卷得分”。
- 活动统计:展示总事件数、非工作时间活动、活跃天数和周末活动等核心指标。
- 事件类型分析:列出用户最常见的 5 种活动类型(如
PushEvent,IssuesEvent等)。 - 每小时活动分布:通过条形图直观展示用户在一天 24 小时内的活动热力图。
- 高度可配置:你可以自定义工作时间的起止、数据分析的时间范围等。
📦 安装
- 确保你已经成功安装并运行了 AstrBot。
- 将本插件文件夹放入 AstrBot 的
plugins目录下。 - 重启 AstrBot,插件将被自动加载。
⚙️ 配置
在使用前,你需要在 AstrBot 插件配置管理中添加 GitHub Personal Access Token
用于提高 API 请求速率限制。只需 public_repo 权限即可。
重要提示:强烈建议配置 github_token。未经身份验证的 GitHub API 请求有非常严格的速率限制(每小时 60 次),很容易耗尽。
📝 使用方法
在你的聊天工具中,向 AstrBot 发送以下命令:
/gh_analyze [GitHub用户名]
示例:
/gh_analyze Soulter
机器人会稍作等待,然后返回一张分析报告图片。
🙏 致谢
本项目的开发灵感来源于 GeneralK1ng 的 Grind-Checker 项目。我们对原作者的创意和开源贡献表示诚挚的感谢!
同时,感谢 AstrBot 框架提供了强大的插件化能力。
关于所使用的第三方组件的详细许可证信息,请参阅 NOTICE.md 文件。
📜 开源许可
本项目采用 MIT License 开源。