czl9707/gh-space-shooter

这是什么？

核心功能

• 01将贡献图格子渲染为敌人，强度随贡献量变化。
• 02导出 GIF 或 WebP 动画。
• 03提供 column、row、random 三种敌人攻击模式。
• 04可作为定时 GitHub Action 每日自动更新文件。
• 05支持将贡献数据保存为 JSON 并重新加载，减少 API 调用。
• 06帧率和帧数可调。

适用场景

• 在 GitHub 个人主页 README 中展示动态贡献图。
• 通过每日定时工作流自动刷新个人主页动画。
• 无需安装，通过网页端生成一次性可分享的动画。
• 基于已保存的 JSON 数据离线调整渲染参数。

快速上手

1. 1

   从 PyPI 安装

   pip install gh-space-shooter
2. 2

   创建带 read:user 权限的 GitHub 令牌并导出

   export GH_TOKEN=your_token_here
3. 3

   为指定用户名生成动画

   gh-space-shooter <username>

使用前须知

• !需要 GitHub 个人访问令牌才能获取贡献数据。

标签

常见问题

gh-space-shooter 是什么？

把 GitHub 贡献图变成类似 Galaga 的太空射击游戏动画，可嵌入个人主页。 gh-space-shooter 读取 GitHub 用户的贡献日历，并将其渲染为一段太空射击动画：每个贡献格子变成一个敌人，贡献越多敌人越强，飞船则穿过这段贡献历史进行战斗。输出为 GIF 或 WebP 文件，可以直接显示在个人主页 README 或任何 Markdown 页面中。

gh-space-shooter 可以免费使用吗？用的什么许可证？

gh-space-shooter 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

gh-space-shooter 还在维护吗？

活跃维护中。gh-space-shooter 最近一次提交是在 2026年10月10日。

gh-space-shooter 适合用来做什么？

在 GitHub 个人主页 README 中展示动态贡献图。 通过每日定时工作流自动刷新个人主页动画。 无需安装，通过网页端生成一次性可分享的动画。 基于已保存的 JSON 数据离线调整渲染参数。

gh-space-shooter 怎么安装和运行？

从 PyPI 安装: pip install gh-space-shooter 创建带 read:user 权限的 GitHub 令牌并导出: export GH_TOKEN=your_token_here 为指定用户名生成动画: gh-space-shooter <username>

在哪里获取 gh-space-shooter？

源代码和安装说明在 GitHub 上：https://github.com/czl9707/gh-space-shooter